On Thursday, 24 January 2013 at 06:26:13 UTC, Andrei Alexandrescu
wrote:
> There's quite a bit of work left to do, but the PDF spec
> already has 386 pages of goodness and starts to look seriously
> cool. Take a peek!
>
This may just be me, but those margins seem just a _little_ bit
excessive.  Can we maybe add something like
\usepackage[margin=3cm]{geometry} % ...or 2 or 3.5 or whatever
looks good
to the top matter? (Though I suppose I can also see the argument
for keeping it at around 75-80cpl for readability.)

On 1/24/13 12:22 PM, Wyatt wrote:
> On Thursday, 24 January 2013 at 06:26:13 UTC, Andrei Alexandrescu wrote:
>> There's quite a bit of work left to do, but the PDF spec already has
>> 386 pages of goodness and starts to look seriously cool. Take a peek!
>>
> This may just be me, but those margins seem just a _little_ bit
> excessive. Can we maybe add something like
> \usepackage[margin=3cm]{geometry} % ...or 2 or 3.5 or whatever looks good
> to the top matter? (Though I suppose I can also see the argument for
> keeping it at around 75-80cpl for readability.)

Yah, the default LaTeX document class is very generous with margins.
I'll adjust them in a future pass.

Andrei

On Thu, Jan 24, 2013 at 5:46 PM, H. S. Teoh <hsteoh@quickfur.ath.cx> wrote:
> On Thu, Jan 24, 2013 at 09:00:54AM +0100, Jacob Carlborg wrote:

>> I know that this is that standard layout/theme of Latex but I don't
>> understand why links need to looks so horrible. A red or cyan square
>> around the text.

> Isn't this be configurable?

Yes, it is. It's just the default for the hyperref package.

Here is what I use for my D template tutorial (here adapted for the spec)

\usepackage[pdftex]{hyperref}

\hypersetup{
pdftitle={D Programming Language Specification},
pdfauthor={D Team},
pdfsubject={D Spec},
pdfkeywords={D} {programming} {specification} {language} {grammar},
urlcolor=darkblue
}

\begin{document}
...

On 2013-01-24 21:59, Philippe Sigaud wrote:
>>> I know that this is that standard layout/theme of Latex but I don't
>>> understand why links need to looks so horrible. A red or cyan square
>>> around the text.
>
>> Isn't this be configurable?
>
> Yes, it is. It's just the default for the hyperref package.

Yeah, the colorlinks option is much better - boxes are distracting and should be
restricted to their main purpose... marking which authors have died. ;)

Other suggestion: a bit smaller margins, so the code won't wrap as much, and
using footnotesize font in listings for same reason.

Now, tables - that's a PITA. I always end up in a cycle where I generate a PDF,
preview it, tweak the tables (adjust column sizes, print the whole table in a
small font, rotate the table or use a longtable), then generate the PDF again,
and so on. I wonder how you approach this problem. Hints inside the
documentation itself, perhaps?

On Thursday, 24 January 2013 at 06:26:13 UTC, Andrei Alexandrescu
wrote:
> There's quite a bit of work left to do, but the PDF spec
> already has 386 pages of goodness and starts to look seriously
> cool. Take a peek!
>
> http://dlang.org/dlangspec.pdf
>
> (still subject to
> http://d.puremagic.com/issues/show_bug.cgi?id=9369, so don't
> mind the absent underscores here and there)
>
>
> Andrei

Great. This is just a cosmetic idea, but you could make the spec
look like TDPL a bit with:

\usepackage[scaled]{beramono}
\usepackage{fourier}

(should be available on all main TeX distributions)

Nicolas

On 1/24/13 3:59 PM, Philippe Sigaud wrote:
> On Thu, Jan 24, 2013 at 5:46 PM, H. S. Teoh<hsteoh@quickfur.ath.cx>  wrote:
>> On Thu, Jan 24, 2013 at 09:00:54AM +0100, Jacob Carlborg wrote:
>
>>> I know that this is that standard layout/theme of Latex but I don't
>>> understand why links need to looks so horrible. A red or cyan square
>>> around the text.
>
>> Isn't this be configurable?
>
> Yes, it is. It's just the default for the hyperref package.
>
> Here is what I use for my D template tutorial (here adapted for the spec)
>
> \usepackage[pdftex]{hyperref}
>
> \hypersetup{
>      pdftitle={D Programming Language Specification},
>      pdfauthor={D Team},
>      pdfsubject={D Spec},
>      pdfkeywords={D} {programming} {specification} {language} {grammar},
>      urlcolor=darkblue
> }
>
> \begin{document}
> ...

I copied that, thanks. The problem I'm having is I can't generate
internal references properly. They look hot but clicking doesn't do
anything. Took the usual precautions of compiling several times, no avail.

I'm using \href for the anchors and \label for the targets. What are you
using?

Thanks,

Andrei

On 2013-01-25 18:26, Andrei Alexandrescu wrote:
> I'm using \href for the anchors and \label for the targets. What are you using?

\href{url}{text} is for URLs, \hyperref[labelname]{text} is for labels.

On Fri, Jan 25, 2013 at 7:31 PM, FG <home@fgda.pl> wrote:
> On 2013-01-25 18:26, Andrei Alexandrescu wrote:
>>
>> I'm using \href for the anchors and \label for the targets. What are you
>> using?
>
>
> \href{url}{text} is for URLs, \hyperref[labelname]{text} is for labels.

I use \href for URLs and \ref or \autoref for internal refs, these
being marked with \label{labelname}.

IIRC, \ref gives a section number, while \autoref gives the 'kind'
("Section 3.2", as opposed to "3.2").

On Thursday, 24 January 2013 at 08:20:04 UTC, kiskami wrote:
> Just my 2c:
> The - in windows\bin resident - d.chm is very good for using as
> a reference, because you have a linked TOC, text and keyword
> search and bookmarks capability all the time on the left.
>
> IMHO the pdf format is more suited for printing or maybe
> userfriendlier to have the TOC links on the bookmarks tab in

I agree, the .chm format is extremely handy for searching and
reference.

On Thursday, 24 January 2013 at 06:26:13 UTC, Andrei Alexandrescu
wrote:
> There's quite a bit of work left to do, but the PDF spec
> already has 386 pages of goodness and starts to look seriously
> cool. Take a peek!
>
> http://dlang.org/dlangspec.pdf
>
> (still subject to
> http://d.puremagic.com/issues/show_bug.cgi?id=9369, so don't
> mind the absent underscores here and there)
>
>
> Andrei

I believe there are some LaTeX errors around pp. 181 ("alias
this", "scope class", \textbf here and there), up to 197, pp. 235
& beyond, p.318, pp.328 & beyond.

Overall a nice work.

1 2 3 4 5