phpdoc?
| From: | Kristian Koehntopp | Date: | Thu, 01 Jan 1970 00:00:00 +0000 |
| Subject: | phpdoc? | ||
| Groups: | php.dev | ||
| Request: | Send a blank email to php-dev+get-10865@lists.php.net to get a copy of this message | ||
Starting with a stock Suse 6.2 system and the phpdoc CVS, how
exactly do I convert the phpdoc into something that is actually
useable? I do not know anything about that sp/jade/sgml-stuff
and I find it heavily underdocumented.
Kristian
kris@valiant:~/Source/phpdoc > cvs -z9 update -dAP
...
kris@valiant:~/Source/phpdoc > autoconf
kris@valiant:~/Source/phpdoc > sh configure
--with-source=/home/kris/Source/php3
loading cache ./config.cache
checking for perl... (cached) /usr/bin/perl
checking for docbook.dsl... in /usr/share/sgml/docbkdsl
checking for PHP source path... ../php3
creating ./config.status
creating Makefile
creating version.ent
creating checkdoc
creating howto.dsl
creating html.dsl
creating print.dsl
creating phpweb.dsl
creating php.dsl
kris@valiant:~/Source/phpdoc > rpm -qa | egrep
"(docbk|^sp|jade)"
sp-1.3.2-44
sp_libs-1.0.3-44
docbk30-3.1-8
docbkdsl-1.42-2
docbktls-0.5-12
jade_dsl-1.2.1-44
kris@valiant:~/Source/phpdoc > make 2>&1 | head -15
touch .manual.sgml
jade -d ./html.dsl -V use-output-dir -t sgml ./manual.sgml
jade:./manual.sgml:1:59:W: cannot generate system identifier for
public text "-//Davenport//DTD DocBook V3.0//EN"
jade:./manual.sgml:8:0:E: reference to entity "BOOK" for which
no system identifier could be generated
jade:./manual.sgml:1:0: entity was defined here
jade:./manual.sgml:8:0:E: DTD did not contain element
declaration for document type name
jade:./manual.sgml:10:9:E: there is no attribute "ID"
jade:./manual.sgml:10:17:E: element "BOOK" undefined
jade:./manual.sgml:11:7:E: element "TITLE" undefined
jade:./bookinfo.sgml:2:14:E: there is no attribute "ID"
jade:./bookinfo.sgml:2:24:E: element "BOOKINFO" undefined
jade:./bookinfo.sgml:3:18:E: there is no attribute "ID"
jade:./bookinfo.sgml:3:27:E: element "AUTHORGROUP" undefined
jade:./bookinfo.sgml:5:10:E: element "AUTHOR" undefined
jade:./bookinfo.sgml:6:14:E: element "FIRSTNAME" undefined
kris@valiant:~/Source/phpdoc >