Re: [Oorexx-devel] Ad documentation

[Rony G. F. <Ron...@wu...>]

On 30.06.2011 15:00, David Ashley wrote:
> On the first point, I am just as annoyed as you are at they way that
> links position you when you click on them. Unfortunately, after hours
> of experimenting some time ago, it appears this is an artefact of the
> way we produce the PDF using the TEX processor. The fop program
> produces what you and I consider the correct result, but fop has other
> problems which do produce good results for production types of work.
Hmm, thank you for this information!

Do you think it to be possible to come up with some program to do a
post-processing of the PDF-file where the link-targets could be moved to
a "prior paragraph"?
(This would only be feasible, if the sequence of text in the PDF would
match the source sequence. This may not be the case as PDF would allow
one to scatter text all around while giving coordinates that make them
appear in sequence on display.) If so, I could try to assign this task
to a student in the winter semester (which may incur a lot of research,
experiments and work for such a student which would last until the end
of January 2012).

> While I also agree with you on the second point, Rick convinced me
> that the classes should be in the order in which you would want them
> if you were reading the manual for the first time. I still somewhat
> disagree with that but the reference manual has been organized that
> way for some time now. Perhaps you would like to put together a 
> section that would go at the very beginning of the classes chapter
> that lists them alphabetically as links?
This might be a possibility.

However when wording with the PDF-reference, the table of contents is
displayed in the left frame with the classes listed in the sequence they
are found in the PDF. If this list was in alphabetical order, like it is
with e.g. the BIF section, one could locate/find classes as quickly as
BIFs.

---rony