DocBook V4.0 Example Document

Norman Walsh

Abstract

This document demonstrates the new tags in DocBook V4.0.

The focus of this document is to present examples of new elements, minor changes such as the addition of new attribute values are not included.


Chapter 1. Block-level Markup

There's a new simple-alternative for msgentry: simplemsgentry.

The text of a message

An explanation of the message.

The text of a message

An explanation of the message.

Longer descriptions are possible in a revhistory:

Revision History
Revision 2 today nwalsh
Revision 1 yesterday nwalsh

Ordered and itemized lists can have titles:

Itemized List

  • First thing

  • Second thing

  • Third thing

Ordered List

  • First thing

  • Second thing

  • Third thing

Linespecific environments can indicate line numbering:

<!ENTITY % linespecific.attrib
	"format		NOTATION
			(linespecific)	'linespecific'
         linenumbering	(numbered|unnumbered) 	#IMPLIED">

Added classsynopsis for documenting object-oriented programming language classes. Here's one example:

 
public 
TextFileWriter
 extends HandlerBase {

  private  Writer  writer ;
  public  String  writerName  = "MyWriter";
static  public  void  write ( ResultTreeFragment  frag , String  file )     throws SAXException;
}

Chapter 2. Inline markup

The sgmltag element has new class attribute values: xmlpi and emptytag. These produce <?processing instructions?> and <empty-tag/> markup suitable for XML.