Date: Wed, 30 May 2001 20:41:22 +0300
From: "Eli Zaretskii" <eliz AT is DOT elta DOT co DOT il>
Sender: halo1 AT zahav DOT net DOT il
To: djgpp-workers AT delorie DOT com
Message-Id: <9003-Wed30May2001204120+0300-eliz@is.elta.co.il>
X-Mailer: Emacs 20.6 (via feedmail 8.3.emacs20_6 I) and Blat ver 1.8.9
In-reply-to: <200105301527.LAA03869@delorie.com> (cvs@delorie.com)
Subject: Re: djgpp: djgpp/src/utils/djasm.txi
References:  <200105301527 DOT LAA03869 AT delorie DOT com>
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

> Date: Wed, 30 May 2001 11:27:26 -0400
> From: "cvs-jtw AT delorie DOT com" <cvs AT delorie DOT com>
> 
> Update by cvs id: jtw
> Update of /cvs/djgpp/djgpp/src/utils
> 
> Modified Files:
> 	djasm.txi 
> Log Message:
> Minor formatting changes.  Introduce sectioning to be used
> for the description of assembler mnemonics.

Thanks!

I have a few comments and suggestions about these changes.

>   @ifinfo
> ! @code{djasm} is a special-purpose 16-bit assembler used to compile
> ! the 16-bit stub that allows @sc{dos} to run the @code{coff} files
> ! generated by @sc{djgpp}.
>   
>   This is Edition @value{EDITION}
>   of the documentation for @code{djasm},
>   @cite{The DJGPP 16-bit Assembler},
> ! last updated @value{UPDATED},
> ! for @acronym{DJGPP} Version @value{VERSION}.
>   This manual incorporates the information in Bill Currie's
>   LyX documentation for @code{djasm}, dated @value{BC_DJASM_DOC_DATE}.
> --- 41,52 ----
>   
>   @ifinfo
> ! @code{djasm} is a special-purpose 16-bit assembler used to compile the
> ! 16-bit stub that allows DOS to run the COFF files generated by DJGPP.
>   
>   This is Edition @value{EDITION}
>   of the documentation for @code{djasm},
>   @cite{The DJGPP 16-bit Assembler},
> ! last updated @value{UPDATED_MONTH},
> ! for DJGPP version @value{DJGPP_VERSION}.
>   This manual incorporates the information in Bill Currie's
>   LyX documentation for @code{djasm}, dated @value{BC_DJASM_DOC_DATE}.

Not that I care in particular, but I wonder why did you make so many
changes like @sc{djgpp} -> DJGPP, or why you removed @acronym.

>   The stub could have been written to use @sc{nasm}, but
>   (1) @sc{nasm} wasn't around at the time, and
> ! (2) a dedicated 16-bit compiler would make DJGPP independent of
>   any other product.

This will be formatted by both makeinfo and TeX so that the alignment
will be gone.  If you want a real enumerated list, use @enumerate.
(Yes, I know this problem was in the original text.)

>   @item
> ! Finish omf support.

"omf" is an acronym, so it should be either written as OMF or @sc{omf}
or @acronym{OMF}.