OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


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.



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC