httpd-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Boyle Owen" <Owen.Bo...@swx.com>
Subject RE: [users@httpd] PDF Documentation
Date Fri, 09 Jun 2006 08:57:15 GMT
> -----Original Message-----
> From: Joost de Heer [mailto:sanguis@xs4all.nl] 
> Sent: Friday, June 09, 2006 10:33 AM
> To: users@httpd.apache.org
> 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@httpd.apache.org
>    "   from the digest: users-digest-unsubscribe@httpd.apache.org
> For additional commands, e-mail: users-help@httpd.apache.org
> 
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@httpd.apache.org
   "   from the digest: users-digest-unsubscribe@httpd.apache.org
For additional commands, e-mail: users-help@httpd.apache.org


Mime
View raw message