DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

Address

Name

Address -- A real-world address, generally a postal address

Synopsis

Mixed Content Model

Address ::=
(#PCDATA|Honorific|FirstName|Surname|Lineage|OtherName|
 Affiliation|AuthorBlurb|Contrib|Street|POB|Postcode|City|State|
 Country|Phone|Fax|Email|OtherAddr)*

Attributes

Common attributes

Name	Type	Default
Format	Enumerated notation: linespecific	"linespecific"

Tag Minimization

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

Parameter Entities

%admon.mix;	%bibliocomponent.mix;	%bookcomponent.content;
%component.mix;	%divcomponent.mix;	%example.mix;
%figure.mix;	%footnote.mix;	%glossdef.mix;
%indexdivcomponent.mix;	%informal.class;	%para.mix;
%qandaset.mix;	%refcomponent.mix;	%sidebar.mix;

Description

An address is generally a postal address, although it does contain elements for FAX and Email addresses as well as the catch-all OtherAddr.

The linespecific notation on the Format attribute makes line breaks and other spaces significant in an Address.

Processing expectations

Formatted as a displayed block. This element is displayed "verbatim"; whitespace and linebreaks within this element are significant.

Parents

These elements contain Address: Affiliation, Answer, Appendix, ArtHeader, Article, BiblioDiv, BiblioEntry, Bibliography, BiblioMixed, BiblioMSet, BiblioSet, BlockQuote, BookBiblio, BookInfo, Callout, Caution, Chapter, ConfGroup, DocInfo, Example, Figure, Footnote, Glossary, GlossDef, GlossDiv, Important, Index, IndexDiv, InformalExample, InformalFigure, ListItem, MsgExplan, MsgText, Note, ObjectInfo, Para, PartIntro, Preface, Procedure, Publisher, QandADiv, QandASet, Question, RefSect1, RefSect1Info, RefSect2, RefSect2Info, RefSect3, RefSect3Info, RefSynopsisDiv, RefSynopsisDivInfo, Sect1, Sect1Info, Sect2, Sect2Info, Sect3, Sect3Info, Sect4, Sect4Info, Sect5, Sect5Info, Section, SectionInfo, SeriesInfo, SetIndex, SetInfo, Sidebar, SimpleSect, Step, Tip, Warning.

Children

The following elements occur in Address: Affiliation, AuthorBlurb, City, Contrib, Country, Email, Fax, FirstName, Honorific, Lineage, OtherAddr, OtherName, Phone, POB, Postcode, State, Street, Surname.

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

Attributes

Format

The Format attribute applies the linespecific notation to all Addresses. All white space and line breaks must be preserved.

See Also

City, Country, Email, Fax, OtherAddr, Phone, POB, Postcode, State, Street

Examples

<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<para>
An example of a postal mail address in the United States is:
<address>
John and Jane Doe
<street>100 Main Street</street>
<city>Anytown</city>, <state>NY</state> <postcode>12345</postcode>
<country>USA</country>
</address>
</para>

An example of a postal mail address in the United States is:

John and Jane Doe
100 Main Street
Anytown, NY 12345
USA

For additional examples, see also BookInfo, ConfGroup, Publisher.

---

Prev	Home	Next
Action	Up	Affiliation

Back to: DocBook: The Definitive Guide