This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
confused about callouts
- From: "Robert P. J. Day" <rpjday at mindspring dot com>
- To: docbook mailing list <docbook at lists dot oasis-open dot org>
- Date: Mon, 25 Nov 2002 18:21:28 -0500 (EST)
- Subject: DOCBOOK: confused about callouts
i have a section of a much larger docbook document, with the following
<screen> element and <co> callout marks:
<screen>
<filename>/etc/passwd</filename> <co id="/etc/passwd"/>
<filename>/etc/shadow</filename> <co id="/etc/shadow"/>
<filename>/etc/group</filename> <co id="/etc/group"/>
<filename>/etc/profile</filename> <co id="/etc/profile"/>
<filename>/etc/profile.d/*.sh</filename> <co id="/etc/profile.d"/>
<filename>~/.bash_profile</filename> <co id="bash_profile"/>
<filename>~/.bashrc</filename> <co id="bashrc"/>
<filename>/etc/bashrc</filename> <co id="/etc/bashrc"/>
</screen>
<calloutlist>
<callout arearefs="/etc/passwd">
<para><filename>/etc/passwd</filename> defines, among other
things, the username, numeric UID and GID of the user, the
home directory and the login shell. For security reasons,
the encrypted password is no longer stored in this file.</para>
</callout>
<callout arearefs="/etc/shadow">
<para><filename>/etc/shadow</filename> represents a more secure
place to store things like the encrypted password, password aging
information and more. (This is the only file in this list of files
that requires root privilege to display.)</para>
</callout>
... etc etc ...
</calloutlist>
the HTML for this section can be viewed at
www.linux-migration.org/ch02s03.html, for which i have a
few questions.
1) trivial issue, but viewing with mozilla and galeon, there is
an apparent line feed between the numbers and the assoc. text
in the callout list itself. using IE, however, it looks
correct -- no mysterious line feed.
2) a <co> element has both an id= and a label= attribute.
clearly, i use the id attribute for the linking -- i'm not
sure what the label attribute is for. the online TDG states
that it "specifies an identifying number or string that may
be used in presentation."
any hints as to what the label attribute is used for?
3) the online TDG also documents that a <callout> has the
arearefs attribute, which is exactly what i use above to
refer back to the appropriate <co>.
however, the documentation for the <callout> element states
that the "arearefs" attribute "must point to one or more Areas
or AreaSets". but mine don't -- they refer to simple
<co> elements.
am i misreading something here?
rday
p.s. i'm sure i'll have more later once this confusion is
cleared up.