[PHPDOC] Re: [PHP4BETA] build phpdoc From: Hartmut Holzgraefe (hartmut <email protected>)
Date: 05/25/00

php_list <email protected> wrote:
>
> Hello phpdoc,
>
> I download CVS phpdoc, I want build php manual, but I am newbie, would anyone
> can help me to build it, please give me line by line shell command.
>
> Thanks !!
>
> sorry for my english so poor.
>

well, you need jade, docbook xml, and the modular docbook stylesheets
in place for a paper manual you'll also need jadetex and a tex
installation like TeTeX

for example, on a SuSE 6.x system you'll need at least the following
rpm packages (could be even more, installing all of tex and sgml/doc
categories shouldn't harm)

docbk30
docbkdsl
jade_dsl
jadetex
tetex
te_latex

ohter distributions should have similar packages

(if you are on windows, i fear you are lost ...)

if you have everything installed then command line is easy:

initially and after each cvs update you should call
   "autoconf; ./configure --with-lang=[en|de|it|ja]"

the html version of the manual is created by simply typing
   "make" or "make html"
(this takes some time, ~5-10 minutes)

a postscript version for printer output will be generated by
   "make ps"
(this will take even longer and may produce a lot of warning
messages like 'unknown reference' or 'over-/underfull somewhat"
but should produce a nice manual.ps in the end)

if you want to change manual content, using Emacs or XEmacs and
psgml-mode for editing is strongly recommended 

--
Hartmut Holzgraefe         hartmut <email protected>           http://www.six.de