Re: Upgrading to Docbook 4.3

On Wed, 12 May 2004 18:24:08 +0200 Martin Jansen <mj@php.net> wrote: > Hey, > > I'd like to upgrade the PEAR documentation from the terribly outdated > Docbook 3.x to version 4.3. > > Eventhough only very small changes are necessary, I'd be happy if some > of you could give the new stuff a try before I merge the changes into > the source tree. The following steps are necessary: > > 1) Get the new DTD from > http://www.docbook.org/xml/4.3/docbook-xml-4.3.zip. > Done. > 2) Unzip the contents of the ZIP file into the directory peardoc/dbxml. > (I made a backup of the existing dbxml directory before.) Done, replacing all files. > 3) Apply the attached patch. development/peardoc> patch -p0 < peardoc-docbook43.diff patching file manual.xml.in patching file en/chapters/contributing.xml patching file en/chapters/installation.xml patching file en/chapters/intro.xml patching file en/guide/developers/documentation.xml patching file en/guide/developers/intro.xml patching file en/guide/developers/recommendations.xml patching file en/guide/developers/release.xml patching file en/guide/developers/supporting.xml patching file en/package/html/html-form/examples.xml patching file en/package/html/html-form/intro.xml > 4) Run "make test". make test /usr/bin/onsgmls -i lang-en -s ./phpdocxml.dcl manual.xml Configuration: linux (Gentoo) Running configure in peardoc directory. ./configure checking for php... /usr/local/bin/php checking php version... PHP 4.3.3 (cli) (built: Aug 31 2003 10:33:52) Copyright (c) 1997-2003 The PHP Group Zend Engine v1.3.0, Copyright (c) 1998-2003 Zend Technologies ok checking for docbook.dsl... autodetected: /usr/share/sgml/docbook/dsssl-stylesheets-1.77 checking for docbook.xsl... autodetected: /usr/share/sgml/docbook/xsl-stylesheets-1.62.0 I'm running make atm. Everything appears to work well. Arnaud.