January 24, 2013
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.)
January 24, 2013
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
January 24, 2013
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},
    colorlinks=true,
    linkcolor=red,
    urlcolor=darkblue
}

\begin{document}
...
January 24, 2013
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?
January 25, 2013
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
January 25, 2013
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},
>      colorlinks=true,
>      linkcolor=red,
>      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
January 25, 2013
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.

January 25, 2013
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").
January 27, 2013
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 reading on ebook readers, but it would be definitely userfriendlier to have the TOC links on the bookmarks tab in Acrobat Reader. :)

I agree, the .chm format is extremely handy for searching and reference.
January 27, 2013
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.