goba Thu Dec 27 10:48:08 2001 EDT
Modified files:
/phpdoc/howto howto.xml generating.xml
Log:
Adding configure options details, deleting this from howto, and
make CHM TODO clearer
Index: phpdoc/howto/howto.xml
diff -u phpdoc/howto/howto.xml:1.20 phpdoc/howto/howto.xml:1.21
--- phpdoc/howto/howto.xml:1.20 Sat Dec 15 11:49:21 2001
+++ phpdoc/howto/howto.xml Thu Dec 27 10:48:08 2001
@@ -18,10 +18,8 @@
<!-- TODO
- Files to incorporate:
- make_chm.README
-
Sections need to be added:
+ Documentation of the new CHM format generation
How to add a new section/funcref/anything to the docs
Work on Emacs and vi sections
Partical advice for manual writers
@@ -37,7 +35,6 @@
- jade test sample to make sure jade works
- description for SGML_CATALOG_FILES environment variable
(http://docbook.sourceforge.net/projects/dsssl/doc/install.html)
- - explaination for basic configure options like with-dsssl and with-lang
- link to http://docbook.sourceforge.net/
-->
Index: phpdoc/howto/generating.xml
diff -u phpdoc/howto/generating.xml:1.9 phpdoc/howto/generating.xml:1.10
--- phpdoc/howto/generating.xml:1.9 Wed Dec 12 15:50:40 2001
+++ phpdoc/howto/generating.xml Thu Dec 27 10:48:08 2001
@@ -27,10 +27,34 @@
your copy of the <emphasis>phpdoc</emphasis> tree.
</para>
+ <note>
+ <para>
+ If you are using Windows, these commands
+ only work in the Cygwin bash shell.
+ </para>
+ </note>
+
<para>
- Note that if you are using Windows, these commands
- only work in the Cygwin bash shell.
+ Configure has two important options you may use. One is
+ <literal>--with-dsssl</literal>. Using this option, you
+ can specify the path to the DSSSL stylesheets. There are
+ many (more than 15) directories searched for DSSSL style
+ sheets, so you may not worry about this option. You
+ can specify the used manual language with the
+ <literal>--with-lang</literal> option. The default
+ is "en". An example on using this option:
+ <informalexample>
+ <programlisting>
+$ ./configure --with-lang=nl
+ </programlisting>
+ </informalexample>
+ There are some more options. The most important are
+ the <literal>--with-xsl</literal> option to specify
+ the XSL style sheets path, and the
+ <literal>--with-zendapi</literal> to specify the
+ path to the Zend API documentation.
</para>
+
</chapter>
<chapter id="chapter-validating">
