From: Norman Walsh Date: Tue, 13 Nov 2001 18:31:49 +0000 (+0000) Subject: DocBook 4.2 spec X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=621187648732905da809a2b962195cbe2b0c5a04;p=docbook-dsssl DocBook 4.2 spec --- diff --git a/docbook/spec/.cvsignore b/docbook/spec/.cvsignore new file mode 100644 index 000000000..2d19fc766 --- /dev/null +++ b/docbook/spec/.cvsignore @@ -0,0 +1 @@ +*.html diff --git a/docbook/spec/Makefile b/docbook/spec/Makefile new file mode 100644 index 000000000..2d98c481d --- /dev/null +++ b/docbook/spec/Makefile @@ -0,0 +1,19 @@ +include ../../cvstools/Makefile.incl + +SPECVER= +ifeq ($(SPECVER),) +SPECSEP= +else +SPECSEP=- +endif + +HTMLSTYLE=/projects/oasis/stylesheets/tr.xsl +HTML-CSS=spec.css + +OASIS-LOGO=http://www.oasis-open.org/docbook/oasis.png +BIBLIO=file:///home/ndw/bibliography.xml +XSLPARAM="html.stylesheet=$(HTML-CSS) oasis.logo=$(OASIS-LOGO) bibliography.collection=$(BIBLIO)" + +docbook.html: docbook.xml + $(XJPARSE) $< + $(XSLT) $< $(HTMLSTYLE) docbook$(SPECSEP)$(SPECVER).html $(XSLPARAM) diff --git a/docbook/spec/docbook.xml b/docbook/spec/docbook.xml new file mode 100644 index 000000000..a7cc8b9e3 --- /dev/null +++ b/docbook/spec/docbook.xml @@ -0,0 +1,392 @@ + + + +]> +
+ +The DocBook Document Type Version 4.2b0 +OASIS DocBook Technical Committee + + + NormanWalsh + + Sun + Sun Microsystems, Inc. +
Norman.Walsh@Sun.COM
+ + + +13 Nov 2001 + +$Id$ + +2001 + +The Organization for the Advancement of Structured Information +Standards [OASIS]. All Rights Reserved. + + +This document and translations of it may be copied and furnished to +others, and derivative works that comment on or otherwise explain it +or assist in its implementation may be prepared, copied, published and +distributed, in whole or in part, without restriction of any kind, +provided that the above copyright notice and this paragraph are +included on all such copies and derivative works. However, this +document itself may not be modified in any way, such as by removing +the copyright notice or references to OASIS, except as needed for the +purpose of developing OASIS specifications, in which case the +procedures for copyrights defined in the OASIS Intellectual Property +Rights document must be followed, or as required to translate it into +languages other than English. + +The limited permissions granted above are perpetual and will not be +revoked by OASIS or its successors or assigns. + +This document and the information contained herein is provided +on an AS IS basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE +INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED +WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. + + + +Status of this Document + +This is a working draft constructed by the editor. It is not +an official committee work product and may not reflect the consensus +opinion of the committee. + + + + + +Abstract + +DocBook is general purpose XML and SGML document type +particularly well suited to books and papers about computer hardware +and software (though it is by no means limited to these applications). + + +The Version 4.2 release is a maintainance release. It introduces +no backwards-incompatible changes. + + + + + + Working Draft “Beta 0” + 13 Nov 2001 + + + + +
+Introduction + +DocBook is general purpose XML and SGML document type +particularly well suited to books and papers about computer hardware +and software (though it is by no means limited to these applications). + + +The DocBook +Technical Committee maintains the DocBook schema. DocBook is +officially available as a Document Type Definition (DTD) for +both +XML and +SGML. +It is unofficially available in other forms as well. + +The Version 4.2 release is a maintainance release. It introduces +no backwards-incompatible changes. + +The DocBook Technical Committee welcomes bug reports and +requests for enhancement (RFEs) from the user community. The current list +of outstanding requests is available through the +SourceForge +tracker +interface. This is also the preferred mechanism for submitting new requests. +Old RFEs, from a previous legacy tracking system, are +archived +for reference. + +
+ +
Terminology + +The key words must, must +not, required, +shall, shall not, +should, should not, +recommended, may, and +optional in this &standard; are to be +interpreted as described in . Note that for +reasons of style, these words are not capitalized in this +document. + +
+ +
+Changes from DocBook V4.1 + +Each of the changes made between DocBook V4.1 and DocBook XML V4.1.2 +is summarized here. For complete details, consult the individual RFEs and +the meeting +minutes. + +
+Bug Fixes + + +RFE 434439: +Add language attribute to MethodSynopsis + +RFE 435485: +Parameter entity tbl.table.mdl can't be redefined cleanly + +Expand the content model of the following +elements from smallcptr.char.mix back to +cptr.char.mix: interfacename, +action, database, +filename, hardware, +keycap, option, +parameter, property, and +systemitem (command, +interface, and literal were +never reduced). + + +
+
+Enhancements + + +RFE 417671: +Add recursive section element to Refentry + +RFE 426382: +Allow SimpleSect inside Section + +RFE 431413: +Former RFE 121: Add markup for signals + +RFE 431415: +Former RFE 124: Add markup for host identifiers + +RFE 431418: +Former RFE 128: Typing and linking in FuncDef (partially implemented) + +RFE 431419: +Former RFE 130: Markup protocol, Filesystem type, and partion. + +RFE 435466: +%beginpage.exclusion; not used in dbpool.mod + +RFE 436072: +Need parameter entity for info* content + +RFE 439136: +Allow literallayout in epigraph + +RFE 440597: +Add SVG notation + +RFE 480956: +Add co to userinput, etc. + +Former RFE 133: +Added newsgroup class to systemitem. + +Former RFE 140: +Allow multiple msgexplan inside simplemsgentry. + + + +
+
+ +
+The DocBook Document Type V4.2b0 + +The DocBook document type is distributed for +XML and +SGML +from the +DocBook site at +OASIS + + + + +
+ + +OASIS DocBook Technical Committee + +The following individuals were members of the committee during +the formulation of this &standard;: + + +Dennis Evans +Patricia Gee-Best +Dick Hamilton +Nancy (Paisner) Harrison +Sabine Ocker +Michael Sabrio +Michael Smith +Norman Walsh (Chair,Editor) + + + + +References + +Normative + + + + + + + + + + + + +
diff --git a/docbook/spec/spec.css b/docbook/spec/spec.css new file mode 100644 index 000000000..96bc745a0 --- /dev/null +++ b/docbook/spec/spec.css @@ -0,0 +1,34 @@ +body { + margin-left: 3pc; + } + +h1 { + padding-top: 0in; + color: #523184; + } + +h2 { + color: #523184; + } + +h3 { + color: #523184; + } + +h4 { + color: #523184; + } + +h5 { + color: #523184; + } + +div.section h1.title { + padding-top: 0in; + color: #523184; + } + +div.article h1.title { + padding-top: 0.75in; + color: #523184; + }