[MLton-user] Second try at PDF version of guide

Matthew Fluet fluet@cs.cornell.edu
Mon, 14 Nov 2005 14:15:21 -0500 (EST)


> Here is my second attempt at a PDF version of the Guide (automatically
> generated):
>
> http://www.cs.cmu.edu/~agoode/mlton2.pdf

I think that looks pretty good.

> Bugs:
>  * I could not get the table of contents feature of HTMLDOC to work,
>    it kept generating page numbers off by different amounts!
>  * The "A | B | C | D | ..." on the Index page links instead to the
>    same named anchors in the References page! (Anchor name collision?)
>  * The picture of the developers is too large and gets cut off
>
> Bug #2 above worries me the most, since it means we could have
> collisions in the future between pages in the Wiki. It also means that
> we need to rename the #A #B #C #D ... anchors in References to something
> else (like #Aref #Bref, etc) to work around this bug. (I've held off on
> this for now.) But even with this bug, I think we can ship the PDF along
> with the release (if there's still time).

Changing the names of the anchors on the References page should be quite 
easy.

> As for making changes in the Wiki, I've already added line breaks to
> code in a few pages to make the PDF come out correctly. Long lines were
> being truncated and reported by HTMLDOC as errors. The changes were easy
> enough, there were only around 6 changes needed in the entire Wiki. (I
> can't remember all the pages. Does MoinMoin have a "RecentChanges"
> page?)

Yes, http://www.mlton.org/RecentChanges

The only thing I noticed is that the pretty-printed SML code is coming out 
with strange highlighting.