File: refentry.xml

package info (click to toggle)
docbook-defguide 2.0.17%2Bsvn9912-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, stretch
  • size: 93,428 kB
  • ctags: 299
  • sloc: xml: 396,482; perl: 4,471; python: 879; makefile: 150; sh: 80
file content (69 lines) | stat: -rw-r--r-- 2,133 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<refentry id="otheraddr.element">
<?dbhtml filename="otheraddr.html"?>
<refentryinfo>
<pubdate>$Date$</pubdate>
<releaseinfo>$Revision$</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>otheraddr</secondary></indexterm>
<refentrytitle>otheraddr</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>
<refnamediv>
<refname>otheraddr</refname>
<refpurpose>&otheraddr.purpose;</refpurpose>
</refnamediv>

&otheraddr.synopsis.gen;
<refsect1 condition='ref.description'><title>Description</title>

<para>
Within an <sgmltag>Address</sgmltag>, <sgmltag>OtherAddr</sgmltag> is a wrapper for
parts of an address other than <sgmltag>Street</sgmltag>, <sgmltag>POB</sgmltag>,
<sgmltag>Postcode</sgmltag>, <sgmltag>City</sgmltag>, <sgmltag>State</sgmltag>,
<sgmltag>Country</sgmltag>, <sgmltag>Phone</sgmltag>, <sgmltag>Fax</sgmltag>, and
<sgmltag>Email</sgmltag>, all of which have elements specific to their
content.
</para>

<para>
In early versions of DocBook, <sgmltag>Address</sgmltag> was not allowed to
contain character data (it was a database-like collection of fields).
In that context, a wrapper was necessary for any random pieces of information
that might be required for an address.
With the introduction of character data directly in the <sgmltag>Address</sgmltag> 
element, <sgmltag>OtherAddr</sgmltag> may have lost most of its
<foreignphrase>raison d'&ecirc;tre</foreignphrase>.
</para>

<refsect2><title>Processing expectations</title>
<para>
&format.inline;
This element may inherit the verbatim qualities of an <sgmltag>Address</sgmltag>.
</para>
</refsect2>


&otheraddr.parents.gen;
&otheraddr.children.gen;
</refsect1>
<refsect1 condition='ref.elem.seealso'><title>See Also</title>
&otheraddr.seealso.gen;
</refsect1>

<refsect1><title>Examples</title>

<informalexample role="example-source">
<programlisting>&otheraddr.example.1.txt;</programlisting>
</informalexample>

<anchor id="ex.os.otheraddr.1" role="HACK-ex.out.start"/>
&otheraddr.example.1.gen;
<anchor id="ex.oe.otheraddr.1" role="HACK-ex.out.end"/>

&otheraddr.example.seealso.gen;
</refsect1>
</refentry>