Date: Sun, 14 Jan 2001 09:39:15 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
X-Sender: eliz AT is
To: JT Williams <jeffw AT darwin DOT sfbr DOT org>
cc: djgpp-workers AT delorie DOT com
Subject: Re: djasm documentation patch 2/4
In-Reply-To: <20010113112820.D6836@kendall.sfbr.org>
Message-ID: <Pine.SUN.3.91.1010114093614.24890O@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk


On Sat, 13 Jan 2001, JT Williams wrote:

> I wrote djasm.txi as a stand-alone document.  To make it work with the
> other djgpp utility documentation I did this:
> 
> - added the @node line to utils.tex (as is done for the other utilities)
> 
> - added these commands
> 
> @chapter djasm
> @lowersections
> 
> as the first two lines of djasm.txi

IMHO, this is backwards: the @lowersections directive should be in the 
_including_ document, not in the _included_ one.  This is so you could 
easily include the same document in other documents.

Having the @node inside djasm.txi and @lowersections outside it makes 
djasm.txi more independent and easy to move and use in other documents.

However, if this flexibility is not important, then it doesn't matter how 
you do it.