goba Sun Apr 3 17:19:07 2005 EDT
Modified files:
/phpdoc/howto tools.xml
Log:
phpdoc-tools is no more :) phpdoc is reported to work well with
openjade/opensp from the cygwin distro, YAY
http://cvs.php.net/diff.php/phpdoc/howto/tools.xml?r1=1.25&r2=1.26&ty=u
Index: phpdoc/howto/tools.xml
diff -u phpdoc/howto/tools.xml:1.25 phpdoc/howto/tools.xml:1.26
--- phpdoc/howto/tools.xml:1.25 Sun Apr 3 12:47:12 2005
+++ phpdoc/howto/tools.xml Sun Apr 3 17:19:06 2005
@@ -224,8 +224,7 @@
<para>
You need the same tools as on Linux. The very basic
- thing is a CVS client. You can find one simple command
- line client here at the <ulink url="&url.cvs-win;">CVSHome.org</ulink>.
+ thing is a command line CVS client, which is included in Cygwin.
Although you can use GUI tools such as WinCVS or TortoiseCVS,
we provided instructions only for command line clients in order
to keep this HOWTO short and simple.
@@ -285,7 +284,8 @@
to Windows, which are not needed for phpdoc. To install the
minimal set of required packages select
<literal>devel/autoconf</literal>, <literal>devel/automake</literal>,
- <literal>devel/make</literal> and <literal>doc/libxml2</literal>
+ <literal>devel/make</literal>, <literal>doc/libxml2</literal>,
+ <literal>text/opensp</literal> and <literal>text/openjade</literal>
along with components, which are selected in setup by
default. You may also want to add <literal>devel/cvs</literal>
to the installation list if you don't have a CVS client yet.
@@ -307,12 +307,23 @@
<warning>
<simpara>
- Do NOT use symlinks with Cygwin, it's buggy. (Jade doesn't
- like them, and the shell doesn't handle them very well either)
+ Do NOT use symlinks with Cygwin, it's buggy.
</simpara>
</warning>
<para>
+ To build and test the manual, you also need a working command
+ line copy of PHP, whose directory should be in the PATH, as it is
+ explained in the PHP Manual.
+ </para>
+
+ <para>
+ If you don't have your phpdoc checkout yet, grab it from CVS. More
+ information about CVS can be found in the
+ <link linkend="chapter-cvs">CVS section</link> of this document.
+ </para>
+
+ <para>
Change to the dir where your phpdoc snapshot is (or where you
want to have it). Use, just like in Windows, the
<literal>cd</literal> command. In Cygwin, the
@@ -323,52 +334,9 @@
<literal>/cygdrive/c</literal> (c: root) directory. From here
use your commands as usual.
</para>
-
- <para>
- If you don't have your snapshot yet, execute CVS (packaged with
- Cygwin). More information about CVS can be found in the
- <link linkend="chapter-cvs">CVS section</link> of this document.
- </para>
-
- <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). Type <literal>mkdir
- phpdoc-tools</literal>, and then unzip Jade to
- <literal>phpdoc-tools/jade</literal>. If you chose openjade,
- place files from <literal>bin/</literal> directory of
- openjade archive to <literal>phpdoc-tools/openjade</literal>.
- </para>
-
- <para>
- You also need a working copy of PHP to build/test the manual, whose
- directory should be in the path, like it's explained in the manual.
- </para>
-
- <para>
- Verify that your directory structure looks like this:
- <informalexample>
- <programlisting>
-+--phpdoc
-| |
-| +--CVS
-| |
-| +--en
-| |
-| \--...
-|
-\--phpdoc-tools
- |
- \--jade
- |
- \--jade.exe (etc)
- </programlisting>
- </informalexample>
- </para>
<para>
- Now go to the <literal>phpdoc</literal> directory, and execute:
+ Now as you are in the <literal>phpdoc</literal> directory, execute:
<informalexample>
<programlisting>
autoconf
