Preface to the DocBook V5.2 Edition
This edition of DocBook 5: The Definitive Guide describes the DocBook V5.2 schema, currently version 5.2.11.
The current O'Reilly edition covers DocBook V5.0, the OASIS Standard.
Summary of Changes in DocBook V5.2
Added a
transform
attribute to theresource
element (as an alternative togrammar
).Removed the
grammar
attribute fromoutput
.Added a
danger
admonition.Added an
otherclass
attribute toarticle
as an alternative to the enumeratedclass
values.Added a
formalgroup
element to contain several formal objects (for example, subfigures in a figure).Relaxed the content model of
abstract
to include non-paragraph block elements.Added
multimediaparam
s toimagedata
.Added a
buildtarget
inline.Allow
fieldsynopsis
,methodsynopsis
, andmethodparam
to contain more than onetype
.Extended the content model of
type
so that it can represent union and intersection types. Added aclass
attribute totype
.Allow numbered sections (
sect1
,sect2
, etc.) to containrefentry
.Added
interface
to the enumerated values in theclass
attribute ofsystemitem
.
Backwards incompatible changes planned for DocBook V6.0
The following backwards incompatible changes are planned for DocBook V6.0:
The linking elements will be removed from the content model of
biblioid
.The common linking attributes will be removed from
indexterm
.The
xml:id
attribute will be made required onstartofrange
indexterm
s.A Schematron constraint will be added to assert that for every
startofrange
indexterm
there is exactly oneendofrange
indexterm
that points to it.The
language
attribute will be removed fromaddress
; usexml:lang
instead.The
arc
andlocator
elements will be dropped; insteadlink
will be allowed inextendedlink
.