[fpc-devel] Question about PDF & PS documentation layout

[Michael Van Canneyt]

On Tue, 20 Oct 2009, Graeme Geldenhuys wrote:

> Hi,
>
> In the PS or PDF versions of the RTL documentation, and then the
> reference information about the 'SysUtils' unit. In my docs it's
> chapter 37.
>
> The sysutils unit has "related topics" like the "Date and Time
> formatting characters".
>
> I noticed that those related topics appear before the "Used units" and
> "Overview" sections. Is this correct?  Shouldn't the "Used units" and
> "Overview" be first and then "related topics" following?
>
> I'm basing the IPF output on the structure of the PDF documents, and
> just want to be sure which order is preferred for the extra "related
> topics"
>
> In the HTML output the "Uses units" and unit "Overview" comes first,
> then the listing of related topics. And the PDF document is other way
> round...
>
>  http://www.freepascal.org/docs-html/rtl/sysutils/index.html
>
> As far as I can see, the HTML output makes a bit more sense than the
> PDF ordering.

It can be easily changed. I personally have no preference.

Michael.