[PHP-DOC] cvs: phpdoc /howto howto.html.tar.gz tools.xml From: Gabor Hojtsy (gabor <email protected>)
Date: 08/13/02

goba Tue Aug 13 12:23:49 2002 EDT

  Modified files:
    /phpdoc/howto howto.html.tar.gz tools.xml
  Log:
  As we have XSL sheets bundeld, modify docs to reflect this, and
  adding more info on xsltproc usage.
  
  
Index: phpdoc/howto/howto.html.tar.gz
Index: phpdoc/howto/tools.xml
diff -u phpdoc/howto/tools.xml:1.13 phpdoc/howto/tools.xml:1.14
--- phpdoc/howto/tools.xml:1.13 Sun Jul 28 05:47:34 2002
+++ phpdoc/howto/tools.xml Tue Aug 13 12:23:49 2002
@@ -310,41 +310,13 @@
      <link linkend="chapter-cvs">CVS section</link> of this document.
     </para>
     
- <note>
- <simpara>
- If you decide to use another directory in one of the next
- steps, you'll probably need to modify
- <filename>phpdoc/configure.in</filename> manually.
- We do not give any support if you are self-opinionated :)
- In this situation you can specify the DSSSL location
- manually by using the
- <literal>--with-dsssl=C:/path/to/dsssl</literal>
- option with configure.
- </simpara>
- </note>
-
     <para>
      Make sure that you are in the directory where the
      <literal>phpdoc</literal> dir is located. (if you type
      <literal>ls</literal>, you should see
- <literal>phpdoc</literal> listed).
- </para>
-
- <para>
- Type <literal>mkdir phpdoc-tools</literal>, and then unzip:
-
- <itemizedlist>
- <listitem><simpara>Jade to <literal>phpdoc-tools/jade</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 (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.
+ <literal>phpdoc</literal> listed). Type <literal>mkdir
+ phpdoc-tools</literal>, and then unzip Jade to
+ <literal>phpdoc-tools/jade</literal>.
     </para>
 
     <para>
@@ -383,10 +355,6 @@
    | |
    | \--jade.exe (etc)
    |
- +--xsl (OPTIONAL!)
- | |
- | \--docbook (etc)
- |
    \--php.bat
       </programlisting>
      </informalexample>
@@ -424,9 +392,8 @@
   
    <para>
     In order to successfully use the XSL stylesheets
- you must have some XSLT processor and the XSL
- DocBook Stylesheets. This is sufficient for
- generating HTML version of the documentation.
+ you must have some XSLT processor. This is sufficient
+ for generating HTML version of the documentation.
     If you also want to create a version suitable
     for printing, you will additionally need a
     FO processor.
@@ -451,11 +418,19 @@
      but is a promising technology. You do not need
      to setup any tools mentioned here if you would
      not like to play with XSL stylesheets. However
- we plan to use XSLT in the future for HTML
+ we plan to use XSL in the future for HTML
      generation, and possibly PDF generation, if we
      can manage to work out how to do it correctly.
     </para>
    </note>
+
+ <para>
+ The phpdoc <filename>Makefile</filename> has options to
+ generate files using the XSL sheets, but these are currently
+ experimental (and require xsltproc exclusively). After running
+ <filename>./configure</filename> you can run <literal>make
+ html_xsl</literal> to generate HTML files using XSL sheets.
+ </para>
   
    <para>
     XSLT processors:
@@ -472,9 +447,11 @@
      </listitem>
      <listitem>
       <simpara>
- Gnome LibXSLT: <ulink url="&url.xsl.libxslt;">&url.xsl.libxslt;</ulink>,
- also available as Windows binary:
+ Gnome LibXSLT (also known as xsltproc):
+ <ulink url="&url.xsl.libxslt;">&url.xsl.libxslt;</ulink>,
+ available as Windows binary too at:
        <ulink url="&url.xsl.libxslt.win;">&url.xsl.libxslt.win;</ulink>,
+ and also included in current cygwin setups.
       </simpara>
      </listitem>
     </itemizedlist>
@@ -488,10 +465,6 @@
     </para>
    </note>
    
- <para>
- XSL DocBook Stylesheets: <ulink url="&url.xsl.style;">&url.xsl.style;</ulink>
- </para>
-
    <para>
     FO processors:
     <itemizedlist> 

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php