SegmentedList -- A segmented list, a list of sets of elements


Content Model

SegmentedList ::=


Common attributes

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities



A SegmentedList consists of a set of headings (SegTitles) and a list of parallel sets of elements. Every SegListItem contains a set of elements that have a one-to-one correspondence with the headings. Each of these elements is contained in a Seg.

Processing expectations

Segmented lists can be formatted in a number of ways. Two popular formats are tabular and as a list of repeated headings and elements. In a tabular presentation, the SegmentedList is the table. In the list presentation, the SegmentedList surrounds the entire list of blocks of heading/element pairs.

(4.0) Future Changes

In DocBook V4.0, at least two SegTitles will be required.


These elements contain SegmentedList: Answer, Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caption, Caution, Chapter, Colophon, Dedication, entry, Example, Footnote, Glossary, GlossDef, GlossDiv, Highlights, Important, Index, IndexDiv, InformalExample, LegalNotice, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, Section, SetIndex, Sidebar, SimpleSect, Step, TextObject, Tip, Warning.


The following elements occur in SegmentedList: SegListItem, SegTitle, Title, TitleAbbrev.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

See Also

CalloutList, ItemizedList, ListItem, OrderedList, SimpleList, VariableList


<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
The capitals of the states of the United States of America are:

<segmentedlist><title>State Capitals</title>
<seglistitem><seg>Arkansas</seg><seg>Little Rock</seg></seglistitem>


The capitals of the states of the United States of America are:

State Capitals

State: Alabama

Capital: Montgomery

State: Alaska

Capital: Anchorage

State: Arkansas

Capital: Little Rock


Table 1. State Capitals

ArkansasLittle Rock

Copyright © 1999 O'Reilly & Associates, Inc. All rights reserved.