The DocBook Document Type Version 4.2b0

OASIS DocBook Technical Committee

Working Draft “Beta 0” 13 Nov 2001

This version:
Working Draft “Beta 0”: 13 Nov 2001
Editor:
Norman Walsh <Norman.Walsh@Sun.COM>

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.


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.

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.

Table of Contents

1. Introduction
2. Terminology
3. Changes from DocBook V4.1
3.1. Bug Fixes
3.2. Enhancements
4. The DocBook Document Type V4.2b0

Appendixes

A. OASIS DocBook Technical Committee (Non-Normative)
References

1. 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.

2. 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 [RFC 2119]. Note that for reasons of style, these words are not capitalized in this document.

3. 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.

3.1. 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).

3.2. 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.

4. The DocBook Document Type V4.2b0

The DocBook document type is distributed for XML and SGML from the DocBook site at OASIS

A. OASIS DocBook Technical Committee (Non-Normative)

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

[ISO 8879:1986] JTC 1, SC 34. ISO 8879:1986 Information processing -- Text and office systems -- Standard Generalized Markup Language (SGML). 1986.

[XML 1.0 (Second Edition)] Tim Bray, Jean Paoli, and C. M. Sperberg-McQueen, Eve Maler, editors. Extensible Markup Language (XML) 1.0 Second Edition. World Wide Web Consortium, 2000.

[Namespaces] Tim Bray, Dave Hollander, and Andrew Layman, editors. Namespaces in XML. World Wide Web Consortium, 1999.

[RFC 2119] IETF (Internet Engineering Task Force). RFC 2119: Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. 1997.

[TR 9401] Paul Grosso, editor. OASIS Technical Resolution 9401:1997 (Amendment 2 to TR 9401). OASIS. 1997.

[XML Catalogs] Norman Walsh, editor. XML Catalogs. OASIS. 2001.