X-Authentication-Warning: kendall.sfbr.org: jeffw set sender to jeffw AT darwin DOT sfbr DOT org using -f
Date: Thu, 31 May 2001 10:08:38 -0500
From: JT Williams <jeffw AT darwin DOT sfbr DOT org>
To: djgpp-workers AT delorie DOT com
Cc: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
Subject: Re: djgpp: djgpp/src/utils/djasm.txi
Message-ID: <20010531100838.A7495@kendall.sfbr.org>
Mail-Followup-To: djgpp-workers AT delorie DOT com,
	Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
References: <200105301527 DOT LAA03869 AT delorie DOT com> <9003-Wed30May2001204120+0300-eliz AT is DOT elta DOT co DOT il>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <9003-Wed30May2001204120+0300-eliz@is.elta.co.il>; from eliz@is.elta.co.il on Wed, May 30, 2001 at 08:41:22PM +0300
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

-: 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.

I originally expected the correct markup to be something like this:

@acronym{DJGPP}
@acronym{DOS}
@acronym{COFF}
@code{djasm}
@file{djasm.y}

IMHO the @acronym markup is appropriate for DJGPP, DOS, COFF, etc.
But then I had the following exchange with DJ:

-: -: Are there any preferences out there for a
-: -: particular Texinfo markup for djgpp and
-: -: djasm?  E.g.:
-: -: 
-: -: @code{djasm}
-: -: @sc{djasm}
-: -: @acronym{djasm}
-: -: 
-: -: something else?
-:
-: DJGPP and djgpp use no markup.
-: djasm is a file name, and uses whatever markup other file names use.

which I interpreted to mean I shouldn't use @acronym or @sc.
Did I misunderstand you, DJ?


-: >   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.)

This (1)-(2) `list' was intended to be formatted as in-line text;
I broke the line where I did just for convenience.


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

Right, thanks.