I created a path file before Philip sent this message using my Windows CVS client for a 3 line addition I tried. Is this anywhere near what I need to be outputting because if so, I might save myself some time if it is ok. But if not, I'll get cygwin and everything set up in the morning (2:30am now).
Is there anyone using native Windows tools to do PHP docs or does everyone just use Linux?
David
Philip Olson wrote:
Nope, there are a few things wrong, such as missing elements and tabulation. Install the tools so you can properly check the format of the docbook. We try to keep the format of the elements as follows:
<element> <element> <element> And so forth. </element> </element> </element>
And instead of sending in complete xml files, you should send us a patch file. You can create a patch file using the cvs diff command, or by using the diff and patch facilities of your OS.
Agreed, be very careful with whitespace. A patch should not contain whitespace changes. And as already mentioned above, show your unified diff instead so we can see what actually changed... diff -u file.xml
Regards,
Philip
Index: en/reference/datetime/functions/localtime.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/datetime/functions/localtime.xml,v
retrieving revision 1.3
diff -u -r1.3 localtime.xml
--- en/reference/datetime/functions/localtime.xml 29 Mar 2003 15:15:45
-0000 1.3
+++ en/reference/datetime/functions/localtime.xml 3 Apr 2005 01:24:29
-0000
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.10 -->
- <refentry id="function.localtime">
+ <refentry id="function.localtime">
<refnamediv>
<refname>localtime</refname>
<refpurpose>Get the local time</refpurpose>
@@ -78,6 +78,11 @@
</simpara>
</listitem>
</itemizedlist>
+ <note>
+ <simpara>
+ Months are from 0 (Jan) to 11 (Dec) and days of the week are from 0
(Sunday) to 6 (Saturday)
+ </simpara>
+ </note>
</para>
</refsect1>
</refentry>
