Re: CVS update: php3/doc

On Mon, 10 May 1999, Jim Winstead wrote: > On May 09, Lars Torben Wilson wrote: > > Actually, yesterday I uninstalled sgmltools just because I wasn't sure > > whether these problems were caused by its unfinished status or what > > (at least, the README says not to expect it to work). I went straight > > to the RPM stuff, installed it, and blammo! Other than a couple of > > quick edits in docbook.dcl to set OMITTAG YES and some length thing, I > > ended up with a fully built doc tree. > > That's what I eventually found, too. Is this what other people > have had to do? In my DocBook installation docbook.dcl is commended out: -- DTDDECL "-//Davenport//DTD DocBook V3.0//EN" "davenport/docbook.dcl" -- > > BTW--good, basic information on DocBook seems hard to find. Good, > > in-depth information abounds, of course ;), but does anybody know what > > the Proper Way to deal with things like project-specific FEATURE > > settings etc is? Asking people to edit system-wide setup files just to > > compile PHP docs seems a bit extreme. > > Well, there's a book on DocBook coming out from O'Reilly in August, > so maybe that will clear up some of the documentation problems. :) http://nwalsh.com/docbook/defguide/index.html > > Perhaps a quick *ahem* run through the PHP doc tree to normalize > > everything would be in order, and setting the emacs local vars to not > > omit tags etc may be a good idea. > > That does seem like it might be the way to go (and not too hard, > since the only "problem" is unclosed SIMPARA tags). If we can at > least work out of the box with one set of tools, we'll have something > to point people at. Even more ideal would be being able to work > with a reasonable Jade/DocBook/stylesheet installation, which means > figuring out the path and FEATURE issues. The DocBook DTD say that SIMPARA end tag can be ommited. It's in dbpool.mod. I have now a Debian 2.1 (slink) box. The Jade/Jadetex/DocBook/DSSSL and Norman Walsh's modular stylesheets works out of the box. To get XEmacs 20.4 to work with DocBook I had only point XEmacs to the catalog file. Options -> Customize -> Emacs -> Programming -> Languages -> Psgml -> Psgml Dtd -> Catalog Files... and make an additional entry with '/usr/lib/sgml/catalog'. My ~/.emacs looks like the following: (custom-set-variables '(sgml-catalog-files (quote ("CATALOG" "/usr/lib/xemacs-20.4/etc/sgml/CATALOG" "/usr/lib/sgml/catalog")))) Now if you read in doc/manual.sgml and click 'DTD -> Parse DTD' the doctype book will be parsed. To see more infos click on 'DTD -> Info -> General DTD info'. The output should be: Doctype: book Element types: 326 Entities: 1171 Parameter entities: 1155 Files used: /usr/lib/sgml/davenport/dbgenent.mod /usr/lib/sgml/davenport/dbhier.mod /usr/lib/sgml/davenport/cals-tbl.dtd /usr/lib/sgml/davenport/dbpool.mod /usr/lib/sgml/entities/ISOtech /usr/lib/sgml/entities/ISOpub /usr/lib/sgml/entities/ISOnum /usr/lib/sgml/entities/ISOlat2 /usr/lib/sgml/entities/ISOlat1 /usr/lib/sgml/entities/ISOgrk4 /usr/lib/sgml/entities/ISOgrk3 /usr/lib/sgml/entities/ISOgrk2 /usr/lib/sgml/entities/ISOgrk1 /usr/lib/sgml/entities/ISOdia /usr/lib/sgml/entities/ISOcyr2 /usr/lib/sgml/entities/ISOcyr1 /usr/lib/sgml/entities/ISObox /usr/lib/sgml/entities/ISOamsr /usr/lib/sgml/entities/ISOamso /usr/lib/sgml/entities/ISOamsn /usr/lib/sgml/entities/ISOamsc /usr/lib/sgml/entities/ISOamsb /usr/lib/sgml/entities/ISOamsa /usr/lib/sgml/davenport/docbook.dtd /usr/local/php3/doc/version.ent /usr/local/php3/doc/chapters.ent /usr/local/php3/doc/global.ent I hope this helps a little bit. -Egon Stephanie, do you have problems? -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net