address

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

Synopsis

address ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • continuation (enumeration)
    • “continues”
    • “restarts”
  • linenumbering (enumeration)
    • “numbered”
    • “unnumbered”
  • startinglinenumber (integer)
  • language
  • xml:space (enumeration)
    • “preserve”

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.

Attributes

Common attributes and common linking attributes.

continuation

Determines whether line numbering continues from the previous element or restarts.

Enumerated values:
“continues”

Line numbering continues from the immediately preceding element with the same name.

“restarts”

Line numbering restarts (begins at 1, usually).

language

Identifies the language (i.e. programming language) of the verbatim content.

linenumbering

Determines whether lines are numbered.

Enumerated values:
“numbered”

Lines are numbered.

“unnumbered”

Lines are not numbered.

startinglinenumber

Specifies the initial line number.

xml:space

Can be used to indicate explicitly that whitespace in the verbatim environment is preserved. Whitespace must always be preserved in verbatim environments whether this attribute is specified or not.

Enumerated values:
“preserve”

Whitespace must be preserved.

Children

The following elements occur in address: text, alt, anchor, annotation, biblioref, city, country, email, fax, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlinemediaobject, link, olink, otheraddr, personname, phone, phrase (db._phrase), pob, postcode, remark, replaceable, state, street, subscript, superscript, uri, xref.

See Also

city, country, email, fax, otheraddr, phone, pob, postcode, state, street

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example address</title>

<para>An example of a postal mail address in the United States:
<address>
John and Jane Doe
<street>100 Main Street</street>
<city>Anytown</city>, <state>NY</state> <postcode>12345</postcode>
<country>USA</country>
</address>
</para>

</article>

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


John and Jane Doe
100 Main Street
AnytownNY 12345
USA

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example address</title>

<para>An example of a postal mail address in the United States:
<address>
John and Jane Doe
<street>100 Main Street</street>
<city>Anytown</city>, <state>NY</state> <postcode>12345</postcode>
<country>USA</country>
</address>
</para>

</article>

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


John and Jane Doe
100 Main Street
AnytownNY 12345
USA

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example address</title>

<para>An example of a postal mail address in the United States:
<address>
John and Jane Doe
<street>100 Main Street</street>
<city>Anytown</city>, <state>NY</state> <postcode>12345</postcode>
<country>USA</country>
</address>
</para>

</article>

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


John and Jane Doe
100 Main Street
AnytownNY 12345
USA

ChangeLog

This alpha reference page is $Revision: 7120 $ published Sun, 22 Jul 2007.