cvs: phpdoc /howto howto.html.tar.gz tools.xml

goba Fri Jul 26 09:49:21 2002 EDT Modified files: /phpdoc/howto howto.html.tar.gz tools.xml Log: Reflecting latest changes in DSSSL integration Index: phpdoc/howto/howto.html.tar.gz Index: phpdoc/howto/tools.xml diff -u phpdoc/howto/tools.xml:1.11 phpdoc/howto/tools.xml:1.12 --- phpdoc/howto/tools.xml:1.11 Wed Jul 17 15:13:36 2002 +++ phpdoc/howto/tools.xml Fri Jul 26 09:49:21 2002 @@ -35,10 +35,9 @@ <ulink url="&url.jade;">Jade</ulink> and <ulink url="&url.nwalsh;">Norman Walsh's Modular DocBook Stylesheets</ulink>. There are other tools used to produce some other formats and files. It is - recommended to set up the style sheets and Jade to be able to - test your contributions. Otherwise you can easily cause - headaches to other team members, or stop the automatic - generation of the manual files. + recommended to set up Jade to be able to test your contributions. + Otherwise you can easily cause headaches to other team members, + or stop the automatic generation of the manual files. </para> <para> @@ -129,7 +128,6 @@ <listitem><simpara>jadetex-2.x-0.src.rpm</simpara></listitem> <listitem><simpara>psgml-1.2.x-1.src.rpm</simpara></listitem> <listitem><simpara>sgml-common-0.1-3.src.rpm</simpara></listitem> - <listitem><simpara>stylesheets-0.10-2.src.rpm</simpara></listitem> </itemizedlist> </para> @@ -146,8 +144,8 @@ enables us to document OO based stuff (currently not used), and we use many new structural elements. So 3.x docbook files are not acceptable. The 4.1.2 DTD is available in the phpdoc - directory, but style sheets needed for output generation are - not there. + directory, and style sheets needed for output generation are + also there. </para> </note> @@ -183,7 +181,6 @@ $ rpm -Uvh jadetex-2.x-0.src.rpm $ rpm -Uvh psgml-1.2.x-1.src.rpm $ rpm -Uvh sgml-common-0.1-3.src.rpm -$ rpm -Uvh stylesheets-0.10-2.src.rpm </programlisting> </informalexample> </para> @@ -250,11 +247,6 @@ <ulink url="&url.openjade;">OpenJade</ulink> </simpara> </listitem> - <listitem> - <simpara> - <ulink url="&url.nwalsh;">Norman Walsh's modular DocBook stylesheets</ulink> - </simpara> - </listitem> </itemizedlist> Note that if you use Cygwin, there is no need to download a CVS client, as Cygwin comes with a CVS client built in. @@ -342,13 +334,13 @@ <itemizedlist> <listitem><simpara>Jade to <literal>phpdoc-tools/jade</literal></simpara></listitem> - <listitem><simpara>Norman Walsh's DSSSL files to <literal>phpdoc-tools/dsssl/docbook</literal></simpara></listitem> </itemizedlist> XSL stylesheets are <emphasis>not necessary</emphasis> to generate the html versions of the manual, the DSSSL style - sheets are used by default. If you think you would like - to test XSL ones, than unzip Norman Walsh's + sheets are used by default (from + <filename>phpdoc/dsssl/docbook</filename>). If you think + you would like to test XSL ones, than unzip Norman Walsh's XSL files to <literal>phpdoc-tools/xsl/docbook</literal>. See <ulink url="&url.nwalsh.xsl;">&url.nwalsh.xsl;</ulink> for more information and downloadable files. @@ -386,11 +378,9 @@ | \--phpdoc-tools | - +--dsssl + +--jade | | - | \--docbook (with docbook.dcl etc) - | - +--jade (with jade.exe etc) + | \--jade.exe (etc) | +--xsl (OPTIONAL!) | |