From: Norman W. <nw...@us...> - 2005-05-05 12:27:01
|
Update of /cvsroot/docbook/docbook/spec In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9364 Modified Files: docbook.xml Log Message: DocBook V4.5b1 Released Index: docbook.xml =================================================================== RCS file: /cvsroot/docbook/docbook/spec/docbook.xml,v retrieving revision 1.27 retrieving revision 1.28 diff -u -U2 -r1.27 -r1.28 --- docbook.xml 27 Jan 2005 14:27:55 -0000 1.27 +++ docbook.xml 5 May 2005 12:26:51 -0000 1.28 @@ -1,6 +1,6 @@ <!DOCTYPE article [ -<!ENTITY name "cd-docbook-docbook"> -<!ENTITY version "4.4"> -<!ENTITY standard "Committee Draft"> +<!ENTITY name "wd-docbook-docbook"> +<!ENTITY version "4.5b1"> +<!ENTITY standard "Working Draft"> <!ENTITY tracker "http://sourceforge.net/tracker"> <!ENTITY RFE "&tracker;/index.php?func=detail&group_id=21935&atid=384107&"> @@ -35,5 +35,5 @@ </authorgroup> -<pubdate>27 Jan 2005</pubdate> +<pubdate>5 May 2005</pubdate> <copyright> @@ -54,9 +54,10 @@ and software (though it is by no means limited to these applications). </para> -<para>The Version 4.4 release is a maintenance release. It introduces +<para>The Version 4.5 release is a maintenance release. It introduces no backwards-incompatible changes.</para> </abstract> <legalnotice role="status"><title>Status</title> +<!-- <para>This &standard; was <ulink url="http://lists.oasis-open.org/archives/docbook/200501/msg00118.html">approved</ulink> @@ -65,10 +66,9 @@ consensus of the committee. </para> +--> -<!-- <para>This &standard; is an editor's draft. It does not necessarily represent the consensus of the committee. </para> ---> <para>Please send comments on this specification to the @@ -100,12 +100,13 @@ It is unofficially available in other forms as well.</para> -<para>The Version 4.4 release is a maintainance release. It introduces -no backwards-incompatible changes. All valid DocBook 4.3 documents are -also valid DocBook 4.4 documents.</para> - -<para>The genesis of this release is a bug in the catalog files for -DocBook V4.3. The Committee decided to produce a 4.4 release, incorporating -a few recent backwards-compatible changes, rather than simply produce -a 4.3.1 release to fix the bugs.</para> +<para>The Version 4.5 release is a maintainance release. It introduces +no backwards-incompatible changes. All valid DocBook 4.4 documents are +also valid DocBook 4.5 documents.</para> + +<para>The Committee decided to produce a DocBook V4.5, incorporating +a few recent backwards-compatible changes, in order to publish DocBook +as a Committee Draft and eventually as an OASIS Standard through +<ulink url="http://www.oasis-open.org/committees/process_2005.03.23.php">the +new process</ulink>.</para> <para>The DocBook Technical Committee welcomes bug reports and @@ -136,5 +137,5 @@ <section id="docbook"> -<title>The DocBook Document Type V4.4</title> +<title>The DocBook Document Type V4.5</title> <para>The DocBook document type is distributed for @@ -149,196 +150,11 @@ </para> -<section id="s.csfinal"> -<title>Changes in DocBook V4.4</title> - -<para>There are no backwards-incompatible changes in this release. No -technical changes have been made between the last Working Draft, -DocBook V4.4CR4 and this Committee Draft.</para> - -</section> - -<section id="s.cscr4"> -<title>Changes in DocBook V4.4CR4</title> - -<para>There are no backwards-incompatible changes in this release. -</para> - -<para>Each of the changes made between DocBook V4.4CR3 and DocBook V4.4CR4 -is summarized here. For complete details, consult the individual RFEs and -the <ulink url="&root;minutes">meeting minutes</ulink>.</para> - -<section id="scr4.bugs"> -<title>Bug Fixes</title> -<itemizedlist spacing="compact"> -<listitem><para>The <sgmltag class="attribute">rowheader</sgmltag> attribute -was accidentally declared twice on <sgmltag>informaltable</sgmltag>. That -bug has been fixed.</para> -</listitem> -</itemizedlist> -</section> - -<section id="scr4.enhancements"> -<title>Enhancements</title> - -<itemizedlist spacing="compact"> -<listitem><para>None. -</para></listitem> -</itemizedlist> -</section> -</section> - -<section id="s.cscr3"> -<title>Changes in DocBook V4.4CR3</title> - -<para>There are no backwards-incompatible changes in this release. -</para> - -<para>Each of the changes made between DocBook V4.4CR2 and DocBook V4.4CR3 -is summarized here. For complete details, consult the individual RFEs and -the <ulink url="&root;minutes">meeting minutes</ulink>.</para> - -<section id="scr3.bugs"> -<title>Bug Fixes</title> -<itemizedlist spacing="compact"> -<listitem><para>Fixed incorrect system identifiers in -the XML version of <filename>docbook.cat</filename>.</para> -</listitem> -</itemizedlist> -</section> - -<section id="scr3.enhancements"> -<title>Enhancements</title> - -<itemizedlist spacing="compact"> -<listitem><para>Added <sgmltag class="attribute">rowheader</sgmltag> attribute -to CALS <sgmltag>table</sgmltag> and <sgmltag>informaltable</sgmltag>. -If <sgmltag class="attribute">rowheader</sgmltag> is -<sgmltag class="attvalue">firstcol</sgmltag>, the first column of each -row is to be treated as a row header. If -<sgmltag class="attvalue">norowheader</sgmltag> is specified, -no special treatment is -given to the first column of each row. -</para></listitem> -</itemizedlist> -</section> -</section> - -<section id="s.cscr2"> -<title>Changes in DocBook V4.4CR2</title> - -<para>There are no backwards-incompatible changes in this release. -</para> - -<para>Each of the changes made between DocBook V4.4CR1 and DocBook V4.4CR2 -is summarized here. For complete details, consult the individual RFEs and -the <ulink url="&root;minutes">meeting minutes</ulink>.</para> - -<section id="scr2.bugs"> -<title>Bug Fixes</title> -<para>None.</para> -</section> - -<section id="scr2.enhancements"> -<title>Enhancements</title> - -<itemizedlist spacing="compact"> -<listitem><para>Added <sgmltag class="attribute">wordsize</sgmltag> as a -global effectivity attribute, per the -<ulink url="&root;minutes/2004-06-16.txt">June, 2004</ulink> -minutes.</para></listitem> -<listitem><para>Added a pointer from the DTD back to this specification. -</para></listitem> -</itemizedlist> -</section> -</section> - -<section id="s.cscr1"> -<title>Changes in DocBook V4.4CR1</title> - -<para>There are no backwards-incompatible changes in this release. -</para> - -<para>Each of the changes made between DocBook V4.4b2 and DocBook V4.4CR1 -is summarized here. For complete details, consult the individual RFEs and -the <ulink url="&root;minutes">meeting minutes</ulink>.</para> - -<section id="scr1.bugs"> -<title>Bug Fixes</title> -<para>None.</para> -</section> - -<section id="scr1.enhancements"> -<title>Enhancements</title> - -<itemizedlist spacing="compact"> -<listitem><para>Added <sgmltag class="attribute">xml:space</sgmltag> to verbatim -environments in the XML schemas. -</para></listitem> -<listitem><para>Added â<literal>protocol</literal>â to the list of class values -allowed on the <sgmltag>systemitem</sgmltag> element. -</para></listitem> -<listitem><para>Added the HTML forms hook to several âmixâ parameter entities so -that HTML forms can occur in more places when the HTML Forms Module is used. -</para></listitem> -</itemizedlist> -</section> -</section> - -<section id="s.csb2"> -<title>Changes in DocBook V4.4b2</title> - -<para>There are no backwards-incompatible changes in this release. -</para> - -<para>Each of the changes made between DocBook V4.4b1 and DocBook V4.4b2 -is summarized here. For complete details, consult the individual RFEs and -the <ulink url="&root;minutes">meeting minutes</ulink>.</para> - -<section id="sb2.bugs"> -<title>Bug Fixes</title> - -<itemizedlist spacing="compact"> -<listitem><para>Version 4.4b2 includes the W3C -<ulink url="http://www.w3.org/2003/entities/">XML Entity Declarations for -Characters</ulink>. These entities are distributed for historical -compatibility and user convenience. The DocBook Technical Committee no -longer attempts to maintain these definitions and will periodically -update them from the W3C site if and as they are updated there. -</para></listitem> -<listitem><para>Removed <sgmltag class="attribute">xml:base</sgmltag> from -the SGML DTD. -</para></listitem> -<listitem><para>Allow HTML tables to nest (allow <sgmltag>table</sgmltag> -and <sgmltag>informaltable</sgmltag> inside <sgmltag>td</sgmltag> and -<sgmltag>th</sgmltag>). -</para></listitem> -<listitem><para>Changed the <sgmltag class="attribute">rules</sgmltag> attribute, -which can appear on HTML tables, from an enumeration to <literal>CDATA</literal>. -This avoids a conflict with the enumerated values on the -<sgmltag class="attribute">frame</sgmltag> attribute on CALS tables. -</para></listitem> -</itemizedlist> -</section> - -<section id="sb2.enhancements"> -<title>Enhancements</title> - -<itemizedlist spacing="compact"> -<listitem><para>Added <sgmltag>bibliolist</sgmltag>. -</para></listitem> -<listitem><para>Added a parameter entity to allow customizers to exclude the -&euro; character entity. -</para></listitem> -</itemizedlist> -</section> -</section> - <section id="s.cs"> -<title>Changes in DocBook V4.4b1</title> +<title>Changes in DocBook V4.5b1</title> <para>There are no backwards-incompatible changes in this release. </para> -<para>Each of the changes made between DocBook V4.3 and DocBook V4.4b1 +<para>Each of the changes made between DocBook V4.4 and DocBook V4.5b1 is summarized here. For complete details, consult the individual RFEs and the <ulink url="&root;minutes">meeting minutes</ulink>.</para> @@ -348,7 +164,6 @@ <itemizedlist spacing="compact"> -<listitem><para>Added the HTML Table Module to the catalog files for -DocBook and DocBook XML. -</para></listitem> +<listitem><para>None.</para> +</listitem> </itemizedlist> </section> @@ -358,32 +173,55 @@ <itemizedlist spacing="compact"> -<listitem><para>Added <sgmltag>package</sgmltag> element per the -<ulink url="http://docbook.org/minutes/2004-02-18.txt">Febuary, 2004</ulink> -meeting. -</para></listitem> -<listitem><para>Allow <sgmltag>imageobjectco</sgmltag> as a child of -<sgmltag>mediaobject</sgmltag> (this effectively makes -<sgmltag>mediaobjectco</sgmltag> unnecessary) per the -<ulink url="http://docbook.org/minutes/2004-02-18.txt">Febuary, 2004</ulink> -meeting. -</para></listitem> +<listitem id="rfe.1055480"> +<para><ulink url="&RFE;aid=1055480">RFE 1055480</ulink>: +Allow <sgmltag>revnumber</sgmltag> to be optional in +<sgmltag>revision</sgmltag> per the +<ulink url="http://docbook.org/minutes/2004-11-22.txt">November, 2004</ulink> +meeting.</para> +</listitem> + +<listitem id="rfe.1070458"> +<para><ulink url="&RFE;aid=1070458">RFE 1070458</ulink>: +Allow <sgmltag>colophon</sgmltag> in <sgmltag>article</sgmltag> per the +<ulink url="http://docbook.org/minutes/2004-11-22.txt">November, 2004</ulink> +meeting.</para> +</listitem> + +<listitem id="rfe.1070770"> +<para><ulink url="&RFE;aid=1070770">RFE 1070770</ulink>: +Allow <sgmltag>procedure</sgmltag> in <sgmltag>example</sgmltag> per the +<ulink url="http://docbook.org/minutes/2004-11-22.txt">November, 2004</ulink> +meeting.</para> +</listitem> + +<listitem id="rfe.1071686"> +<para><ulink url="&RFE;aid=1071686">RFE 1071686</ulink>: +Add <sgmltag class="attvalue">isrn</sgmltag> as a value of +<sgmltag class="attribute">class</sgmltag> attribute on +<sgmltag>biblioid</sgmltag>, +<sgmltag>citebiblioid</sgmltag>, +<sgmltag>bibliosource</sgmltag>, and +<sgmltag>bibliorelation</sgmltag> per the +<ulink url="http://docbook.org/minutes/2004-12-15.txt">December, 2004</ulink> +meeting.</para> +</listitem> -<listitem><para>Added <sgmltag>biblioref</sgmltag> element per the -<ulink url="http://docbook.org/minutes/2004-05-19.txt">May, 2004</ulink> +<listitem><para>Added <sgmltag>mathphrase</sgmltag> +per the +<ulink url="http://docbook.org/minutes/2005-02-16.txt">February, 2005</ulink> meeting. </para></listitem> -<listitem><para>Added <sgmltag class="attribute">spacing</sgmltag> attribute -to <sgmltag>variablelist</sgmltag> per the -<ulink url="http://docbook.org/minutes/2004-04-21.txt">April, 2004</ulink> +<listitem><para>Added <sgmltag>termdef</sgmltag> +per the +<ulink url="http://docbook.org/minutes/2005-03-16.txt">March, 2005</ulink> meeting. </para></listitem> -<listitem><para>Added <sgmltag>superscript</sgmltag> and -<sgmltag>subscript</sgmltag> to the content model of the -<sgmltag>gui<replaceable>*</replaceable></sgmltag> elements +<listitem><para>Allow common attributes on HTML table elements +(<sgmltag>tr</sgmltag>, <sgmltag>td</sgmltag>, etc.) per the -<ulink url="http://docbook.org/minutes/2004-05-19.txt">May, 2004</ulink> +<ulink url="http://docbook.org/minutes/2005-04-20.txt">April, 2005</ulink> meeting. </para></listitem> @@ -403,107 +241,4 @@ </section> -<section id="docbook.v5"> -<title>Changes Proposed for DocBook V5.0</title> - -<para>The following backwards-incompatible changes are proposed for -the DocBook V5.0. Some of these changes were announced in DocBook -V4.0, others were originally scheduled for DocBook V6.0 but are now -being proposed as part of the transition to RELAX NG. -The DocBook Technical Committee anticipates moving to RELAX NG -for DocBook V5.0. This will introduce a broad range of one time -backwards-incompatible changes.</para> - -<itemizedlist spacing="compact"> -<listitem id="rfe.coords"><para>The <sgmltag>coords</sgmltag> -attribute will be removed from <sgmltag>areaset</sgmltag>.</para> -</listitem> - -<listitem id="rfe.biblioentry"> -<para>The <sgmltag>articleinfo</sgmltag> element will be removed from -<sgmltag>biblioentry</sgmltag>.</para> -</listitem> - -<listitem id="rfe.contents"> -<para>The <sgmltag class="attribute">contents</sgmltag> attribute will -be removed from <sgmltag>bookinfo</sgmltag> and <sgmltag>setinfo</sgmltag>. -</para> -</listitem> - -<listitem id="rfe.indexdivcm"> -<para>The content model of indexes will be reduced. -Numbered figures and other elements inappropriate for an -<sgmltag>index</sgmltag> or <sgmltag>setindex</sgmltag> will be -removed.</para> -</listitem> - -<listitem id="rfe.glossterm"> -<para>The <sgmltag>revhistory</sgmltag> element will be removed from -<sgmltag>glossterm</sgmltag>.</para> -</listitem> - -<listitem id="rfe.416415"><para><ulink url="&RFE;aid=416415">RFE 416415</ulink>: -The <literal>constant</literal> <sgmltag class="attribute">class</sgmltag> -will be removed from <sgmltag>systemitem</sgmltag>.</para> -</listitem> - -<listitem id="rfe.graphics"> -<para>The <sgmltag>graphic</sgmltag> and -<sgmltag>inlinegraphic</sgmltag> elements will be removed.</para> -</listitem> - -<listitem id="rfe.412476"><para><ulink url="&RFE;aid=412476">RFE 412476</ulink>: -The <sgmltag class="attribute">class</sgmltag> attribute on -<sgmltag>productname</sgmltag> will no longer have a default value. -</para> -</listitem> -<listitem id="rfe.482810"><para><ulink url="&RFE;aid=482810">RFE 482810</ulink>: -The content model of <sgmltag>msgtext</sgmltag> is far too broad. It will -be reduced. -</para> -</listitem> -<listitem id="rfe.482811"><para><ulink url="&RFE;aid=482811">RFE 482811</ulink>: -The <sgmltag>title</sgmltag> element will be removed from -bibliography elements (use -<sgmltag>citetitle</sgmltag> instead).</para> -</listitem> -<listitem id="rfe.482812"><para><ulink url="&RFE;aid=482812">RFE 482812</ulink>: -The content model of <sgmltag>citetitle</sgmltag> will be reduced from -<sgmltag class="paramentity">para.char.mix</sgmltag> to -<sgmltag class="paramentity">title.char.mix</sgmltag>.</para> -</listitem> -<listitem id="rfe.482815"><para><ulink url="&RFE;aid=482815">RFE 482815</ulink>: -The <sgmltag>synopsis</sgmltag> element will be removed from -<sgmltag class="paramentity">para.char.mix</sgmltag>.</para> -</listitem> -<listitem id="rfe.482818"><para><ulink url="&RFE;aid=482818">RFE 482818</ulink>: -Simplify the content model of <sgmltag>toc</sgmltag>. -</para> -</listitem> -<listitem id="rfe.482819"><para><ulink url="&RFE;aid=482819">RFE 482819</ulink>: -The content models of the bibliography elements will be adjusted so that -it is not possible to mix <sgmltag>biblioset</sgmltag> and -<sgmltag>bibliomset</sgmltag> elements.</para> -</listitem> -<listitem id="rfe.482922"><para><ulink url="&RFE;aid=482922">RFE 482922</ulink>: -The <sgmltag>msgtext</sgmltag> element will be constrained to occur only -inside <sgmltag>msgset</sgmltag>. See also -<ulink url="&RFE;aid=482817">RFE 482817</ulink>. -</para> -</listitem> -<listitem id="rfe.531851"><para><ulink url="&RFE;aid=531851">RFE 531851</ulink>: -Remove inline person name components (<sgmltag>firstname</sgmltag>, -<sgmltag>surname</sgmltag>, etc.) -<ulink url="http://sourceforge.net/docman/display_doc.php?docid=9354&group_id=21935">as -proposed</ulink>. -</para></listitem> -<listitem id="rfe.531855"><para><ulink url="&RFE;aid=531855">RFE 531855</ulink>: -Remove <sgmltag>corpname</sgmltag> -<ulink url="http://sourceforge.net/docman/display_doc.php?docid=9351&group_id=21935">as -proposed</ulink>. -</para></listitem> -</itemizedlist> - -</section> - <appendix id="a.mimetype"> <title>The DocBook Media Type</title> @@ -764,5 +499,5 @@ <title>Intellectual Property Rights</title> -<para>For information on wether any patents have been disclosed that may be +<para>For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section @@ -778,31 +513,7 @@ <para> <revhistory> -<revision role="&root;specs/cd-docbook-docbook-4.4.html"> - <revnumber>Committee Draft</revnumber> - <date>27 Jan 2005</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4CR4.html"> - <revnumber>Working Draft âCandidate Release 4â</revnumber> - <date>22 Dec 2004</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4CR3.html"> - <revnumber>Working Draft âCandidate Release 3â</revnumber> - <date>17 Dec 2004</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4CR2.html"> - <revnumber>Working Draft âCandidate Release 2â</revnumber> - <date>21 Oct 2004</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4CR1.html"> - <revnumber>Working Draft âCandidate Release 1â</revnumber> - <date>16 Sep 2004</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4b2.html"> - <revnumber>Working Draft âBeta 2â</revnumber> - <date>26 Aug 2004</date> -</revision> -<revision role="&root;specs/wd-docbook-docbook-4.4b1.html"> - <revnumber>Working Draft âBeta 1â</revnumber> - <date>09 Jun 2004</date> +<revision role="&root;specs/wd-docbook-docbook-4.5b1.html"> + <revnumber>Working Draft</revnumber> + <date>05 May 2005</date> </revision> </revhistory> |