From owner-freebsd-doc  Tue Aug 29 08:13:19 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id IAA08617
          for doc-outgoing; Tue, 29 Aug 1995 08:13:19 -0700
Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id IAA08609
          for <doc@freebsd.org>; Tue, 29 Aug 1995 08:13:11 -0700
Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id KAA12268 for doc@freebsd.org; Tue, 29 Aug 1995 10:12:47 -0500
From: John Fieber <jfieber@indiana.edu>
Message-Id: <199508291512.KAA12268@fieber-john.campusview.indiana.edu>
Subject: <HEADER> tag in sgml documents
To: doc@freebsd.org
Date: Tue, 29 Aug 1995 10:12:47 -0500 (EST)
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Length: 845       
Sender: doc-owner@freebsd.org
Precedence: bulk

I've tracked down the problem with section titles being formatted
strangely and/or truncated.  The problem is fairly simple, but
rather difficult to solve with the current architecture of the
conversion system.  

As such, even though it is valid SGML to omit the
<header>...</header> tags following a <sect> tag, do *not* omit
them.  Furthermore, the close tag (</header>) must be on the same
line as the open tag (<header>).

There is actually an entire class of tags which could be affected
in the same way but I have not gone through to shake them out.
I'd rather spend my time building a new processing system that
doesn't have the bug.  :)

I now return you to your regularly scheduled broadcast.

-john

== jfieber@indiana.edu ===========================================
== http://fieber-john.campusview.indiana.edu/~jfieber ============