In article <41371b3e$1@news.povray.org> , Christian Walther 
<cwa### [at] gmxch>  wrote:

> Two problems that I ran into while TeXing, and that were easily fixed:
>
> o In the section "Photon Tips", there are two nested itemize
> environments, and TeX doesn't seem to like that. That's probably a bug
> in the master source, as it also occurs in the HTML version (but there
> it doesn't cause any problems).

Thanks for pointing this out!

> o The paths for the figures don't match the actual directory structure
> in the downloaded ZIP file. They are like
> "../final/tex/images/reference/gamma" when they should be like
> "images/reference/gamma".

Ah yes, this is an artifact of the documentation creation process which uses
these relative pathes.  I suppose adding a note to the TeX documentation
will have to do for this as it would make the doc building even more complex
when two TeX documents would need to be generated and validated, sorry!

> o There are no PDF bookmarks for the table of contents, and no
> hyperlinks from the table of contents and the index to the text.

We are very well aware of the hyperref package.  As we explicitly state on
the download page, the PDF and PostScript versions of the documentation are
for *printing*.  The printable documentation should obviously not be
cluttered with useless hyperlinks that also destroy the printed version's
layout.

> o I don't like the roman page numbers for the front matter. They're fine
> for printed books, but for on-screen navigation they are a little
> annoying because they make the printed page numbers go out of sync with
> the PDF page numbers.

PDF is a document format designed for printing and not for viewing. As such,
usability problems of Adobe Acrobat Reader and similar products when trying
to use PDFs for on screen viewing should be reported to their developers,
not us.

HTML is a hypertext format and if you desire hypertext navigation you should
be using the HTML version, not the documentation for printing! :-)

> I just downloaded the POV-Ray 3.6.1 PDF documentation, which I prefer
> over the HTML version because it's easier to search,

The Windows and Macintosh HTML documentation is fully searchable by the
respective system help viewers.

    Thorsten

____________________________________________________
Thorsten Froehlich, Duisburg, Germany
e-mail: tho### [at] trfde

Visit POV-Ray on the web: http://mac.povray.org

Post a reply to this message