From owner-freebsd-doc  Wed Oct  1 18:03:30 1997
Return-Path: <owner-freebsd-doc>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id SAA20498
          for doc-outgoing; Wed, 1 Oct 1997 18:03:30 -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 SAA20490
          for <freebsd-doc@FreeBSD.ORG>; Wed, 1 Oct 1997 18:03:21 -0700 (PDT)
Received: from localhost (jfieber@localhost)
	by fallout.campusview.indiana.edu (8.8.7/8.8.7) with SMTP id UAA28196;
	Wed, 1 Oct 1997 20:03:09 -0500 (EST)
Date: Wed, 1 Oct 1997 20:03:08 -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.971001151418.1555B-100000@andrsn.stanford.edu>
Message-ID: <Pine.BSF.3.96.971001194428.28179A-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 Wed, 1 Oct 1997, Annelise Anderson wrote:

> Thanks, that helps!  I wish the Davenport guide were a single
> document....

I believe the Davenport guides are available as tar files
somewhere on O'Reilly's FTP server....

> > 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>
> 
> Exactly what I was looking for!

-->> Oops, the attribute name should be REMAP, not ROLE.  Sorry! 

> It seems that sometimes a generic closing tag--</>--is acceptable,
> for example after <title>, and other times it's not, e.g., 

Tag omission sometimes causes confusion (not to mention
complicating parsing, which is why you cannot omit and minimize
tags in XML). If the presence of an element in a particular place
can be unambiguously inferred from context, the DTD author can
permit the start and/or the end tags to be omitted.  Omitting the
tags does not omit the element though!  For example, this: 

 <foo>text</foo>

could actually be seen by the parser as:

 <foo><bar>text</bar></foo>

if the <bar> element were manditory as the first element within
<foo>.  But, the minimized form of the close tag, </>, closes the
*current* element, so in: 

 <foo>text</>

the </> actually matches the omitted <bar> and the <foo> element
is missing a close tag.

I'm a bit puzzled about getting errors from the <emphasis>
element though...you might run your file through sgmlnorm (part
of the jade and sp ports) which inserts all omitted tags and
changes minimized tags (<foo/blah/, <abc>xyz</>) to their
un-minimized forms.  That will reveal what the parser REALLY
sees.  :)

-john