Mailing-List: contact users-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: users@httpd.apache.org
Received-SPF: pass (asf.osuosl.org: domain of jslive@gmail.com designates
 66.249.82.203 as permitted sender)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
        s=beta; d=gmail.com;
        h=received:message-id:date:from:sender:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
        b=MwhrdOdoRftE+nF2sw71L0QtHUonCEYdHaaJkwWj5P0rHBpS0ESXC+/yLhOgVJE0fc00fr/Q1J1HX20SA4Ebvg2IK/g4kUJY/E69k6LGJuMPyndjPbjk+e650U7ZfG/j0b0OWPRFSB9o+pmbfTRvRxP89UvvqsqpLqiqXXPf2RY=
Message-ID: <e498c1660606090529w2de4aaaayf65ee852ef13ea75@mail.gmail.com>
Date: Fri, 9 Jun 2006 08:29:45 -0400
From: "Joshua Slive" <joshua@slive.ca>
Sender: jslive@gmail.com
To: users@httpd.apache.org, sanguis@xs4all.nl
In-Reply-To: <21741.194.151.119.137.1149841977.squirrel@webmail.xs4all.nl>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <21741.194.151.119.137.1149841977.squirrel@webmail.xs4all.nl>
Subject: Re: [users@httpd] PDF Documentation

On 6/9/06, Joost de Heer <sanguis@xs4all.nl> wrote:
> Hello,
>
> Is there a specific reason why the 2.2 (or 2.0.58) documentation isn't
> distributed in PDF format anymore?

Because it takes a chunk of time to generate the pdf file and nobody
has gotten around to it.  The difference between the docs for 2.0.54
(which exist in pdf) and 2.0.58 isn't substantial, so there is no real
need for a 2.0.58 version.  It would be nice to have a 2.2 version,
but I'm not only one who seems to have the proper setup to generate
it, and I don't have the time right now.

To respond to some of Owen's comments, the docs are not in html, but
in a custom xml dialect that is roughly a cross between xhtml and
docbook with a bunch of custom markup to represent our directives and
modules.  I convert it into pdf via an xslt script that converts to
latex and then pdflatex to go to pdf.  The process is not perfect,
because there are some xhtml constructs in use that don't map well to
latex.  But it is pretty good.

Of course, if you have an xslt processor and LaTeX, you can generate
the pdf yourself.

Joshua.

---------------------------------------------------------------------
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