RE: [users@httpd] PDF Documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



> -----Original Message-----
> From: Joost de Heer [mailto:sanguis@xxxxxxxxx] 
> Sent: Friday, June 09, 2006 10:33 AM
> To: users@xxxxxxxxxxxxxxxx
> Subject: [users@httpd] PDF Documentation
> 
> Hello,
> 
> Is there a specific reason why the 2.2 (or 2.0.58) documentation isn't
> distributed in PDF format anymore?

My private opinion:

- The docs are written in HTML. HTML is not WISYWIG so is difficult to convert unambiguously to PDF (at least, with an open-source tool). Also, the relationships between the docs are defined by the hyper-links: how do you convert a bunch of small docs into a single PDF? Who or what defines the page/chapter/section order?

- Why? So you can print it? Unless you want a zillion unrelated pages, you'd need a major editing effort to produce a table of contents and index. If you want to read it on a computer, HTML is better. If you want a hard-copy, buy the O'Reilly book.

- The proper way to produce HTML and PDF documentation is to write the docs in word processor (eg, FrameMaker, OpenOffice, Word) and then produce two output versions - HTML and PDF. This ain't the way apache docs are set up.

Rgds,
Owen Boyle
Disclaimer: Any disclaimer attached to this message may be ignored. 

> 
> Joost
> 
> 
> ---------------------------------------------------------------------
> The official User-To-User support forum of the Apache HTTP 
> Server Project.
> See <URL:http://httpd.apache.org/userslist.html> for more info.
> To unsubscribe, e-mail: users-unsubscribe@xxxxxxxxxxxxxxxx
>    "   from the digest: users-digest-unsubscribe@xxxxxxxxxxxxxxxx
> For additional commands, e-mail: users-help@xxxxxxxxxxxxxxxx
> 
Diese E-mail ist eine private und persönliche Kommunikation. Sie hat keinen Bezug zur Börsen- bzw. Geschäftstätigkeit der SWX Gruppe. This e-mail is of a private and personal nature. It is not related to the exchange or business activities of the SWX Group. Le présent e-mail est un message privé et personnel, sans rapport avec l'activité boursière du Groupe SWX.
 
 
This message is for the named person's use only. It may contain confidential, proprietary or legally privileged information. No confidentiality or privilege is waived or lost by any mistransmission. If you receive this message in error, please notify the sender urgently and then immediately delete the message and any copies of it from your system. Please also immediately destroy any hardcopies of the message. You must not, directly or indirectly, use, disclose, distribute, print, or copy any part of this message if you are not the intended recipient. The sender's company reserves the right to monitor all e-mail communications through their networks. Any views expressed in this message are those of the individual sender, except where the message states otherwise and the sender is authorised to state them to be the views of the sender's company.

---------------------------------------------------------------------
The official User-To-User support forum of the Apache HTTP Server Project.
See <URL:http://httpd.apache.org/userslist.html> for more info.
To unsubscribe, e-mail: users-unsubscribe@xxxxxxxxxxxxxxxx
   "   from the digest: users-digest-unsubscribe@xxxxxxxxxxxxxxxx
For additional commands, e-mail: users-help@xxxxxxxxxxxxxxxx



[Index of Archives]     [Open SSH Users]     [Linux ACPI]     [Linux Kernel]     [Linux Laptop]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Squid]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]

  Powered by Linux