X-Authentication-Warning: kendall.sfbr.org: jeffw set sender to jeffw AT darwin DOT sfbr DOT org using -f
Date: Mon, 27 Nov 2000 16:22:40 -0600
From: JT Williams <jeffw AT darwin DOT sfbr DOT org>
To: djgpp-workers AT delorie DOT com
Subject: Re: djasm documentation patches
Message-ID: <20001127162240.E19525@kendall.sfbr.org>
Mail-Followup-To: djgpp-workers AT delorie DOT com
References: <20001127095046 DOT A19043 AT kendall DOT sfbr DOT org> <Pine DOT SUN DOT 3 DOT 91 DOT 1001127191419 DOT 19574B AT is>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <Pine.SUN.3.91.1001127191419.19574B@is>; from eliz@is.elta.co.il on Mon, Nov 27, 2000 at 07:18:52PM +0200
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

-: This still leaves the problem of getting djasm.txi converted to an Info 
-: file and being installed into the info/ directory by the build process.

Yes, and this could get complicated.

-: To make this all easier, I suggest either to put djasm.txi into 
-: src/utils, and add an @include to utils.txi.  This should cause djasm's 
-: docs to be part of utils.info.

I've always felt that djasm was (or could be) more than just a `Utility',
which is why I had planned to put it in the `From djdevNNN.zip' section
of the top-level `dir' file (see demo formats below).

But if djasm.txi *is* moved to src/utils/, then I would argue that djasm.y
should be moved as well, and djasm should be given its own home like for
djtar.  But, this breaks the make of djasm.exe in `src/stub/makefile'.

Advice most welcome.
jeff

==================================
Demo format as a 'djdevNNN' entry
==================================
From djdevNNN.zip

* Knowledge Base: (kb).
        The DJGPP Knowledge Base

* djasm: (djasm).
        The DJGPP 16-bit Assembler (limited functionality)

* libc.a: (libc).
        The Standard C Library Reference
* libm.a: (libm).
        The Math Library Reference
==================================

==================================
Demo format as a `Utilities' entry
==================================
* Utilities: (utils).   Miscellaneous utilities that come with DJGPP.
* bin2h: (utils)bin2h.  Convert binary data files to C include files.
* djtar: (utils)djtar.  Extract or list files from (possibly compressed)
                                tar archives, with DOS filename conversion.
* djasm: (djasm).       16-bit assembler (limited functionality)
* [etc]
==================================