Upgrading to Docbook 4.3
| From: | Martin Jansen | Date: | Wed, 12 May 2004 16:24:08 +0000 |
| Subject: | Upgrading to Docbook 4.3 | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-3947@lists.php.net to get a copy of this message | ||
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.
2) Unzip the contents of the ZIP file into the directory peardoc/dbxml.
(I made a backup of the existing dbxml directory before.)
3) Apply the attached patch.
4) Run "make test".
--
- Martin Martin Jansen
http://martinjansen.com/
Index: manual.xml.in =================================================================== RCS file: /repository/peardoc/manual.xml.in,v retrieving revision 1.30 diff -u -r1.30 manual.xml.in --- manual.xml.in 21 Apr 2004 18:04:53 -0000 1.30 +++ manual.xml.in 12 May 2004 16:18:23 -0000 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='@ENCODING@' ?> -<!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V1.7//EN" +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "@srcdir@/dbxml/docbookx.dtd" [ <!ENTITY % language-defs SYSTEM "@srcdir@/@LANGDIR@/language-defs.ent"> Index: en/chapters/contributing.xml =================================================================== RCS file: /repository/peardoc/en/chapters/contributing.xml,v retrieving revision 1.13 diff -u -r1.13 contributing.xml --- en/chapters/contributing.xml 15 Apr 2004 17:25:13 -0000 1.13 +++ en/chapters/contributing.xml 12 May 2004 16:18:24 -0000 @@ -2,7 +2,7 @@ <!-- $Revision: 1.13 $ --> <chapter id="contributing"> - <docinfo> + <chapterinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> @@ -16,7 +16,7 @@ <surname>Convissor</surname> </author> <date>2004-04-15</date> - </docinfo> + </chapterinfo> <title>Contributing</title> <simpara> This chapter describes the different ways in which one could Index: en/chapters/installation.xml =================================================================== RCS file: /repository/peardoc/en/chapters/installation.xml,v retrieving revision 1.17 diff -u -r1.17 installation.xml --- en/chapters/installation.xml 15 Feb 2004 10:54:38 -0000 1.17 +++ en/chapters/installation.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="installation"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>Installation</title> <simpara> This chapter describes, how to install packages from PEAR. Index: en/chapters/intro.xml =================================================================== RCS file: /repository/peardoc/en/chapters/intro.xml,v retrieving revision 1.5 diff -u -r1.5 intro.xml --- en/chapters/intro.xml 19 Oct 2003 10:35:41 -0000 1.5 +++ en/chapters/intro.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="introduction"> - <docinfo> + <chapterinfo> <author> <firstname>Stig</firstname> <surname>Bakken</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>Introduction</title> <subtitle>The PEAR Manifest</subtitle> <simpara> Index: en/guide/developers/documentation.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/documentation.xml,v retrieving revision 1.19 diff -u -r1.19 documentation.xml --- en/guide/developers/documentation.xml 6 May 2004 16:02:09 -0000 1.19 +++ en/guide/developers/documentation.xml 12 May 2004 16:18:24 -0000 @@ -6,7 +6,7 @@ --> <chapter id="developers.documentation"> - <docinfo> + <chapterinfo> <author> <firstname>Daniel</firstname> <surname>Convissor</surname> @@ -15,7 +15,7 @@ <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </chapterinfo> <title>Writing documentation</title> <titleabbrev>Documentation</titleabbrev> Index: en/guide/developers/intro.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/intro.xml,v retrieving revision 1.2 diff -u -r1.2 intro.xml --- en/guide/developers/intro.xml 14 Mar 2004 19:32:55 -0000 1.2 +++ en/guide/developers/intro.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="developers.intro"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-05-27</date> - </docinfo> + </chapterinfo> <title>Introduction</title> <subtitle>A guide to PEAR written for developers by developers.</subtitle> Index: en/guide/developers/recommendations.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/recommendations.xml,v retrieving revision 1.6 diff -u -r1.6 recommendations.xml --- en/guide/developers/recommendations.xml 3 Mar 2004 20:36:48 -0000 1.6 +++ en/guide/developers/recommendations.xml 12 May 2004 16:18:24 -0000 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.6 $ --> <chapter id="developers.recommendations"> - <docinfo> + <chapterinfo> <author> <firstname>Stefan</firstname> <surname>Neufeind</surname> </author> <date>2004-02-29</date> - </docinfo> + </chapterinfo> <title>Recommendations</title> <sect1 id="developers.recommendations.introduction"> Index: en/guide/developers/release.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/release.xml,v retrieving revision 1.14 diff -u -r1.14 release.xml --- en/guide/developers/release.xml 16 Apr 2004 13:03:02 -0000 1.14 +++ en/guide/developers/release.xml 12 May 2004 16:18:25 -0000 @@ -2,13 +2,13 @@ <!-- $Revision: 1.14 $ --> <chapter id="developers.release"> - <docinfo> + <chapterinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> </author> <date>2003-03-20</date> - </docinfo> + </chapterinfo> <title>Releasing A Package</title> <subtitle>The steps required from package maintainers to release a package.</subtitle> Index: en/guide/developers/supporting.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/supporting.xml,v retrieving revision 1.3 diff -u -r1.3 supporting.xml --- en/guide/developers/supporting.xml 30 Aug 2003 06:15:17 -0000 1.3 +++ en/guide/developers/supporting.xml 12 May 2004 16:18:25 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="developers.supporting"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-05-27</date> - </docinfo> + </chapterinfo> <title>Supporting PEAR development</title> <sect1 id="guide.dev.supporting"> Index: en/package/html/html-form/examples.xml =================================================================== RCS file: /repository/peardoc/en/package/html/html-form/examples.xml,v retrieving revision 1.2 diff -u -r1.2 examples.xml --- en/package/html/html-form/examples.xml 22 Jul 2003 18:45:52 -0000 1.2 +++ en/package/html/html-form/examples.xml 12 May 2004 16:18:25 -0000 @@ -1,11 +1,11 @@ <!-- $Revision: 1.2 $ --> <refentry id="package.html.html-form.examples"> - <docinfo> + <refentryinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </refentryinfo> <refnamediv> <refname>Usage examples</refname> Index: en/package/html/html-form/intro.xml =================================================================== RCS file: /repository/peardoc/en/package/html/html-form/intro.xml,v retrieving revision 1.4 diff -u -r1.4 intro.xml --- en/package/html/html-form/intro.xml 28 Jul 2003 12:18:32 -0000 1.4 +++ en/package/html/html-form/intro.xml 12 May 2004 16:18:25 -0000 @@ -1,11 +1,11 @@ <!-- $Revision: 1.4 $ --> <refentry id="package.html.html-form.intro"> - <docinfo> + <refentryinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </refentryinfo> <refnamediv> <refname>Introduction</refname>
Index: manual.xml.in =================================================================== RCS file: /repository/peardoc/manual.xml.in,v retrieving revision 1.30 diff -u -r1.30 manual.xml.in --- manual.xml.in 21 Apr 2004 18:04:53 -0000 1.30 +++ manual.xml.in 12 May 2004 16:18:23 -0000 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='@ENCODING@' ?> -<!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V1.7//EN" +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "@srcdir@/dbxml/docbookx.dtd" [ <!ENTITY % language-defs SYSTEM "@srcdir@/@LANGDIR@/language-defs.ent"> Index: en/chapters/contributing.xml =================================================================== RCS file: /repository/peardoc/en/chapters/contributing.xml,v retrieving revision 1.13 diff -u -r1.13 contributing.xml --- en/chapters/contributing.xml 15 Apr 2004 17:25:13 -0000 1.13 +++ en/chapters/contributing.xml 12 May 2004 16:18:24 -0000 @@ -2,7 +2,7 @@ <!-- $Revision: 1.13 $ --> <chapter id="contributing"> - <docinfo> + <chapterinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> @@ -16,7 +16,7 @@ <surname>Convissor</surname> </author> <date>2004-04-15</date> - </docinfo> + </chapterinfo> <title>Contributing</title> <simpara> This chapter describes the different ways in which one could Index: en/chapters/installation.xml =================================================================== RCS file: /repository/peardoc/en/chapters/installation.xml,v retrieving revision 1.17 diff -u -r1.17 installation.xml --- en/chapters/installation.xml 15 Feb 2004 10:54:38 -0000 1.17 +++ en/chapters/installation.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="installation"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>Installation</title> <simpara> This chapter describes, how to install packages from PEAR. Index: en/chapters/intro.xml =================================================================== RCS file: /repository/peardoc/en/chapters/intro.xml,v retrieving revision 1.5 diff -u -r1.5 intro.xml --- en/chapters/intro.xml 19 Oct 2003 10:35:41 -0000 1.5 +++ en/chapters/intro.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="introduction"> - <docinfo> + <chapterinfo> <author> <firstname>Stig</firstname> <surname>Bakken</surname> </author> <date>2002-02-10</date> - </docinfo> + </chapterinfo> <title>Introduction</title> <subtitle>The PEAR Manifest</subtitle> <simpara> Index: en/guide/developers/documentation.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/documentation.xml,v retrieving revision 1.19 diff -u -r1.19 documentation.xml --- en/guide/developers/documentation.xml 6 May 2004 16:02:09 -0000 1.19 +++ en/guide/developers/documentation.xml 12 May 2004 16:18:24 -0000 @@ -6,7 +6,7 @@ --> <chapter id="developers.documentation"> - <docinfo> + <chapterinfo> <author> <firstname>Daniel</firstname> <surname>Convissor</surname> @@ -15,7 +15,7 @@ <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </chapterinfo> <title>Writing documentation</title> <titleabbrev>Documentation</titleabbrev> Index: en/guide/developers/intro.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/intro.xml,v retrieving revision 1.2 diff -u -r1.2 intro.xml --- en/guide/developers/intro.xml 14 Mar 2004 19:32:55 -0000 1.2 +++ en/guide/developers/intro.xml 12 May 2004 16:18:24 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="developers.intro"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-05-27</date> - </docinfo> + </chapterinfo> <title>Introduction</title> <subtitle>A guide to PEAR written for developers by developers.</subtitle> Index: en/guide/developers/recommendations.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/recommendations.xml,v retrieving revision 1.6 diff -u -r1.6 recommendations.xml --- en/guide/developers/recommendations.xml 3 Mar 2004 20:36:48 -0000 1.6 +++ en/guide/developers/recommendations.xml 12 May 2004 16:18:24 -0000 @@ -1,13 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1" ?> <!-- $Revision: 1.6 $ --> <chapter id="developers.recommendations"> - <docinfo> + <chapterinfo> <author> <firstname>Stefan</firstname> <surname>Neufeind</surname> </author> <date>2004-02-29</date> - </docinfo> + </chapterinfo> <title>Recommendations</title> <sect1 id="developers.recommendations.introduction"> Index: en/guide/developers/release.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/release.xml,v retrieving revision 1.14 diff -u -r1.14 release.xml --- en/guide/developers/release.xml 16 Apr 2004 13:03:02 -0000 1.14 +++ en/guide/developers/release.xml 12 May 2004 16:18:25 -0000 @@ -2,13 +2,13 @@ <!-- $Revision: 1.14 $ --> <chapter id="developers.release"> - <docinfo> + <chapterinfo> <author> <firstname>Tal</firstname> <surname>Peer</surname> </author> <date>2003-03-20</date> - </docinfo> + </chapterinfo> <title>Releasing A Package</title> <subtitle>The steps required from package maintainers to release a package.</subtitle> Index: en/guide/developers/supporting.xml =================================================================== RCS file: /repository/peardoc/en/guide/developers/supporting.xml,v retrieving revision 1.3 diff -u -r1.3 supporting.xml --- en/guide/developers/supporting.xml 30 Aug 2003 06:15:17 -0000 1.3 +++ en/guide/developers/supporting.xml 12 May 2004 16:18:25 -0000 @@ -5,13 +5,13 @@ THIS DOCUMENT YET. --> <chapter id="developers.supporting"> - <docinfo> + <chapterinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> <date>2002-05-27</date> - </docinfo> + </chapterinfo> <title>Supporting PEAR development</title> <sect1 id="guide.dev.supporting"> Index: en/package/html/html-form/examples.xml =================================================================== RCS file: /repository/peardoc/en/package/html/html-form/examples.xml,v retrieving revision 1.2 diff -u -r1.2 examples.xml --- en/package/html/html-form/examples.xml 22 Jul 2003 18:45:52 -0000 1.2 +++ en/package/html/html-form/examples.xml 12 May 2004 16:18:25 -0000 @@ -1,11 +1,11 @@ <!-- $Revision: 1.2 $ --> <refentry id="package.html.html-form.examples"> - <docinfo> + <refentryinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </refentryinfo> <refnamediv> <refname>Usage examples</refname> Index: en/package/html/html-form/intro.xml =================================================================== RCS file: /repository/peardoc/en/package/html/html-form/intro.xml,v retrieving revision 1.4 diff -u -r1.4 intro.xml --- en/package/html/html-form/intro.xml 28 Jul 2003 12:18:32 -0000 1.4 +++ en/package/html/html-form/intro.xml 12 May 2004 16:18:25 -0000 @@ -1,11 +1,11 @@ <!-- $Revision: 1.4 $ --> <refentry id="package.html.html-form.intro"> - <docinfo> + <refentryinfo> <author> <firstname>Martin</firstname> <surname>Jansen</surname> </author> - </docinfo> + </refentryinfo> <refnamediv> <refname>Introduction</refname>