From owner-freebsd-doc  Wed Oct  1 07:38:59 1997
Return-Path: <owner-freebsd-doc>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id HAA17039
          for doc-outgoing; Wed, 1 Oct 1997 07:38:59 -0700 (PDT)
Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id HAA17034
          for <freebsd-doc@freebsd.org>; Wed, 1 Oct 1997 07:38:56 -0700 (PDT)
Received: from localhost (jfieber@localhost)
	by fallout.campusview.indiana.edu (8.8.7/8.8.7) with SMTP id JAA26810;
	Wed, 1 Oct 1997 09:38:44 -0500 (EST)
Date: Wed, 1 Oct 1997 09:38:43 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
To: Annelise Anderson <andrsn@andrsn.stanford.edu>
cc: freebsd-doc@freebsd.org
Subject: Re: Using SGML
In-Reply-To: <Pine.BSF.3.96.970930220243.7383A-100000@andrsn.stanford.edu>
Message-ID: <Pine.BSF.3.96.971001091528.21416N-100000@fallout.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-freebsd-doc@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

On Tue, 30 Sep 1997, Annelise Anderson wrote:

> Is there a source of information for tags that can be used?  

I started a little guide, but I don't think it has everything you
would be after, and the specifics about formatting are a little
out of date, but have a look:

 http://fallout.campusview.indiana.edu/~jfieber/docbook/markupguide.html

The authoritative, and somewhat overwhelming, source is the
Docbook reference, which can be found at either:

 http://www.ora.com/davenport/dbdoc/ref/ 
 http://fallout.campusview.indiana.edu/~jfieber/docbook/doc/ref/

> Basically besides titles of "chapters" this document has text that's
> in bold and text that's underlined (and maybe some bold underlined
> text).  I understand that I'm supposed to classify these various
> bits of text rather than designate how they are to appear....
> although the tag <emphasis> seems usable.  Where would I find others,
> or am I asking for something that doesn't exist?  

To narrow your search through the docbook reference, here is a
list of things you can put "inline" in a paragraph:

  <abbrev>  <acronym>  <action>  <address>  <anchor>
  <application>  <author>  <authorinitials>  <beginpage>  <blockquote>
  <calloutlist>  <caution>  <citation>  <citerefentry>  <citetitle>
  <classname>  <cmdsynopsis>  <command>  <comment>  <computeroutput>
  <corpauthor>  <database>  <email>  <emphasis>  <envar>  <equation>
  <errorcode>  <errorname>  <errortype>  <example>  <figure>  <filename>
  <firstterm>  <footnote>  <footnoteref>  <foreignphrase>  <funcsynopsis>
  <function>  <glosslist>  <glossterm>  <graphic>  <graphicco>  <guibutton>
  <guiicon>  <guilabel>  <guimenu>  <guimenuitem>  <guisubmenu>  <hardware>
  <important>  <indexterm>  <informalequation>  <informalexample>
  <informaltable>  <inlineequation>  <inlinegraphic>  <interface>
  <interfacedefinition>  <itemizedlist>  <keycap>  <keycode>  <keycombo>
  <keysym>  <link>  <literal>  <literallayout>  <markup>  <medialabel>
  <menuchoice>  <modespec>  <mousebutton>  <msgtext>  <note>  <olink>
  <option>  <optional>  <orderedlist>  <othercredit>  <parameter>  <phrase>
  <productname>  <productnumber>  <programlisting>  <programlistingco>
  <prompt>  <property>  <quote>  <replaceable>  <returnvalue>  <revhistory>
  <screen>  <screenco>  <screenshot>  <segmentedlist>  <sgmltag>  <simplelist>
  <structfield>  <structname>  <subscript>  <superscript>  <symbol>
  <synopsis>  <systemitem>  <table>  <tip>  <token>  <trademark>  <type>
  <ulink>  <userinput>  <variablelist>  <warning>  <wordasword>  <xref>

Something you won't find in any documentation is that both
sgmlfmt and my jade stylesheets for docbook handle some special
cases of the <emphasis> element:

 <emphasis role="bf">bold</emphasis>
 <emphasis role="it">italic</emphasis>
 <emphasis role="tt">typewriter</emphasis>

And if you need it, I could see about adding "ul" for underline.
I suppose I should add "bi" for bold-italic too.  However, it is
best to avoid these if possible because it makes your document
dependent on my processing tool, which is what SGML is all about
avoiding!

> P.S. Would it be important to upgrade from sgmlfmt 1.3--I notice
> there are some changes.

The only changes were to linuxdoc processing.

Tell me how it goes...my wife has a large quantity of XyWrite files
kicking around.

-john