I thought I'd provide some notes for my experience with cygwin because it was not straightforward!
- Downloading and installing the default setup.exe from cygwin is not sufficient. It does not come with any of the packages that you need by default. I had to manually install the following:
Devel > autoconf
Devel > automake
Devel > binutils
Devel > cvs
Devel > make
Doc > libxml2
Editors > nano (my preferred editor)
- The step described at http://doc.php.net/php/dochowto/tools-on-windows.php where you have to mkdir phpdoc-tools and then create the php.bat file resulted in a file being created that strangely had incorrect permissions. When running the ./configure command I got this:
checking for php... ../phpdoc-tools/php.bat
checking php version ... ./configure: line 1: ../phpdoc-tools/php.bat: Permission denied
./configure: line 1: ../phpdoc-tools/php.bat: Permission denied
./configure: line 1412: test: yes: unary operator expected
configure: error: PHP version 4.0.0 or newer needed
So I deleted the file through Windows Explorer and then created it using notepad. The it worked fine.
- I have got kind of stuck when it came to doing validation. First I ran make test as suggested in http://doc.php.net/php/dochowto/chapter-validating.php but that output masses of errors about badly formed xml files (which weren't mine). I then tried to run scripts/xml-check.php en/reference/datetime/functions/localtime.xml but nobody said you had to put that through the PHP CLI first! That was solved by running it as:
../phpdoc-tools/php.bat scripts/xml-check.php en/reference/datetime/functions/localtime.xml
Which ran and output an error saying xmlint is not recognised as an internal or external command. Seems I needed another cygwin package - xmllib2.
After that was installed, everything went fine and the script ran without outputting any errors - I assume that is good and my XML is fine.
- Finally, since I have no CVS account I need to generate a CVS diff.
cd en/reference/datetime/functions
cvs diff localtime.xml > localtime.diff
So everything seemed to work ok. I'll mail the CVS diff in a separate e-mail. Might be worth mentioning some of my above points on the docs howto somewhere.
David
Gabor Hojtsy wrote: