This is the mail archive of the binutils@sources.redhat.com mailing list for the binutils project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

[RFA]: Improve gas man page


Hi!

I would like to propose the following changes to improve
the quality of AS man page and doc.  The generated man page
is not perfect (as pointed out by David) and this patch brings
a generated man page with nearly the same quality as before.

I took care of not breaking the DVI/PS/PDF/info quality too.

The changes are the following:

  - Use @option{-xxx} for options (instead of @code{-xxx})
    Rational:	      Gcc convention

  - Use @command{xxx} for commands
    Rational:	      Gcc convention

  - Use @b{-xxx} for options in the usage only
    Rational:	      Necessary for the man pages to show the option
		      in bold (as before, also man page convention).
		      Using @option is ok for man pages but the result
		      in the DVI/PS/PDF is very ugly: the option is quoted
		      ie, [@option{--help}] expands into [`--help']
		      but [@b{--help}] expands into [--help]

  - Use @table gcctabopt for options list
    Rational:	      Gcc convention, also recognized by texi2pod.pl
		      Using @table samp (as in Binutils doc) is ugly in
		      the DVI/PS/PDF.

  - Reorganize the GAS usage to clearly identify target specific options
    Rational:	      Easier to understand which option is target specific

  - Added PDP11 options in the usage.
    Rational:	      It was missing.


Can you approve this patch?

Thanks,
	Stephane

2001-11-02  Stephane Carrez  <Stephane.Carrez@worldnet.fr>

	* doc/Makefile.am (POD2MAN): Use 'GNU Development Tools' for
	the page man title.
	* doc/Makefile.in: Rebuild.
	* doc/as.texinfo: Do not put man SEEALSO in document;
	Use @command for commands, @option for options; Reorganize usage
	to clearly identify target specific options.
Index: Makefile.am
===================================================================
RCS file: /cvs/src/src/gas/doc/Makefile.am,v
retrieving revision 1.14
diff -r1.14 Makefile.am
13c13,14
< POD2MAN = pod2man --center="GNU" --release="binutils-$(VERSION)" --section=1
---
> POD2MAN = pod2man --center="GNU Development Tools" \
> 	--release="binutils-$(VERSION)" --section=1
Index: as.texinfo
===================================================================
RCS file: /cvs/src/src/gas/doc/as.texinfo,v
retrieving revision 1.49
diff -r1.49 as.texinfo
15a16,18
> @macro gcctabopt{body}
> @code{\body\}
> @end macro
159c162
< first (Vax) version of @code{as} for Project @sc{gnu}.
---
> first (Vax) version of @command{as} for Project @sc{gnu}.
195c198
< This file is a user guide to the @sc{gnu} assembler @code{@value{AS}} version
---
> This file is a user guide to the @sc{gnu} assembler @command{@value{AS}} version
198c201
< This version of the file describes @code{@value{AS}} configured to generate
---
> This version of the file describes @command{@value{AS}} configured to generate
225c228
< This manual is a user guide to the @sc{gnu} assembler @code{@value{AS}}.
---
> This manual is a user guide to the @sc{gnu} assembler @command{@value{AS}}.
227c230
< This version of the manual describes @code{@value{AS}} configured to generate
---
> This version of the manual describes @command{@value{AS}} configured to generate
235c238
< Here is a brief summary of how to invoke @code{@value{AS}}.  For details,
---
> Here is a brief summary of how to invoke @command{@value{AS}}.  For details,
239a243
> @ignore
242a247
> @end ignore
248,255c253,264
< @value{AS} [ -a[cdhlns][=file] ] [ -D ]  [ --defsym @var{sym}=@var{val} ]
<  [ -f ] [ --gstabs ] [ --gdwarf2 ] [ --help ] [ -I @var{dir} ] 
<  [ -J ] [ -K ] [ -L ]
<  [ --listing--lhs-width=NUM ][ --listing-lhs-width2=NUM ]
<  [ --listing-rhs-width=NUM ][ --listing-cont-lines=NUM ]
<  [ --keep-locals ] [ -o @var{objfile} ] [ -R ] [ --statistics ] [ -v ]
<  [ -version ] [ --version ] [ -W ] [ --warn ] [ --fatal-warnings ] 
<  [ -w ] [ -x ] [ -Z ] [ --target-help ]
---
> @value{AS} [@b{-a}[@b{cdhlns}][=@var{file}]] [@b{-D}] [@b{--defsym} @var{sym}=@var{val}]
>  [@b{-f}] [@b{--gstabs}] [@b{--gdwarf2}] [@b{--help}] [@b{-I} @var{dir}] 
>  [@b{-J}] [@b{-K}] [@b{-L}]
>  [@b{--listing-lhs-width}=@var{NUM}] [@b{--listing-lhs-width2}=@var{NUM}]
>  [@b{--listing-rhs-width}=@var{NUM}] [@b{--listing-cont-lines}=@var{NUM}]
>  [@b{--keep-locals}] [@b{-o} @var{objfile}] [@b{-R}] [@b{--statistics}] [@b{-v}]
>  [@b{-version}] [@b{--version}] [@b{-W}] [@b{--warn}] [@b{--fatal-warnings}] 
>  [@b{-w}] [@b{-x}] [@b{-Z}] [@b{--target-help}] [@var{target-options}] 
>  [@b{--}|@var{files} @dots{}]
> @c
> @c Target dependent options are listed below.  Keep the list sorted.
> @c Add an empty line for separation. 
260,261c269,272
<  [ -marc[5|6|7|8] ]
<  [ -EB | -EL ]
---
> 
> @emph{Target ARC options:}
>    [@b{-marc[5|6|7|8]}]
>    [@b{-EB}|@b{-EL}]
264,279c275,292
<  [ -m[arm]1 | -m[arm]2 | -m[arm]250 | -m[arm]3 |
<    -m[arm]6 | -m[arm]60 | -m[arm]600 | -m[arm]610 |
<    -m[arm]620 | -m[arm]7[t][[d]m[i]][fe] | -m[arm]70 |
<    -m[arm]700 | -m[arm]710[c] | -m[arm]7100 |
<    -m[arm]7500 | -m[arm]8 | -m[arm]810 | -m[arm]9 |
<    -m[arm]920 | -m[arm]920t | -m[arm]9tdmi |
<    -mstrongarm | -mstrongarm110 | -mstrongarm1100 ]
<  [ -m[arm]v2 | -m[arm]v2a | -m[arm]v3 | -m[arm]v3m |
<    -m[arm]v4 | -m[arm]v4t | -m[arm]v5 | -[arm]v5t |
<    -[arm]v5te ]
<  [ -mthumb | -mall ]
<  [ -mfpa10 | -mfpa11 | -mfpe-old | -mno-fpu ]
<  [ -EB | -EL ]
<  [ -mapcs-32 | -mapcs-26 | -mapcs-float |
<    -mapcs-reentrant ]
<  [ -mthumb-interwork ] [ -moabi ] [ -k ]
---
> 
> @emph{Target ARM options:}
>    [@b{-m[arm]1}|@b{-m[arm]2}|@b{-m[arm]250}|@b{-m[arm]3}|
>     @b{-m[arm]6}|@b{-m[arm]60}|@b{-m[arm]600}|@b{-m[arm]610}|
>     @b{-m[arm]620}|@b{-m[arm]7[t][[d]m[i]][fe]}|@b{-m[arm]70}|
>     @b{-m[arm]700}|@b{-m[arm]710[c]}|@b{-m[arm]7100}|
>     @b{-m[arm]7500}|@b{-m[arm]8}|@b{-m[arm]810}|@b{-m[arm]9}|
>     @b{-m[arm]920}|@b{-m[arm]920t}|@b{-m[arm]9tdmi}|
>     @b{-mstrongarm}|@b{-mstrongarm110}|@b{-mstrongarm1100}]
>    [@b{-m[arm]v2}|@b{-m[arm]v2a}|@b{-m[arm]v3}|@b{-m[arm]v3m}|
>     @b{-m[arm]v4}|@b{-m[arm]v4t}|@b{-m[arm]v5}|@b{-[arm]v5t}|
>     @b{-[arm]v5te}]
>    [@b{-mthumb}|@b{-mall}]
>    [@b{-mfpa10}|@b{-mfpa11}|@b{-mfpe-old}|@b{-mno-fpu}]
>    [@b{-EB}|@b{-EL}]
>    [@b{-mapcs-32}|@b{-mapcs-26}|@b{-mapcs-float}|
>     @b{-mapcs-reentrant}]
>    [@b{-mthumb-interwork}] [@b{-moabi}] [@b{-k}]
282c295,297
<  [ -O ]
---
> 
> @emph{Target D10V options:}
>    [@b{-O}]
285c300,302
<  [ -O | -n | -N ]
---
> 
> @emph{Target D30V options:}
>    [@b{-O}|@b{-n}|@b{-N}]
293,318c310,313
< @ifset PJ
<  [ -mb | -me ]
< @end ifset
< @ifset PPC
<  [ -mpwrx | -mpwr2 | -mpwr | -m601 | -mppc | -mppc32 | -m603 | -m604 |
<    -m403 | -m405 | -mppc64 | -m620 | -mppc64bridge | -mbooke |
<    -mbooke32 | -mbooke64 ]
<  [ -mcom | -many | -maltivec ] [ -memb ]
<  [ -mregnames | -mno-regnames ]
<  [ -mrelocatable | -mrelocatable-lib ]
<  [ -mlittle | -mlittle-endian | -mbig, -mbig-endian ]
<  [ -msolaris | -mno-solaris ]
< @end ifset
< @ifset SPARC
< @c The order here is important.  See c-sparc.texi.
<  [ -Av6 | -Av7 | -Av8 | -Asparclet | -Asparclite
<    -Av8plus | -Av8plusa | -Av9 | -Av9a ]
<  [ -xarch=v8plus | -xarch=v8plusa ] [ -bump ]
<  [ -32 | -64 ]
< @end ifset
< @ifset TIC54X
<  [ -mcpu=54[123589] | -mcpu=54[56]lp ] [ -mfar-mode | -mf ] 
<  [ -merrors-to-file <filename> | -me <filename> ]
< @end ifset
< @ifset Z8000
< @c Z8000 has no machine-dependent assembler options
---
> @ifset I80386
> 
> @emph{Target i386 options:}
>    [@b{--32}|@b{--64}]
320a316,317
> 
> @emph{Target i960 options:}
322,324c319,321
<  [ -ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB |
<    -AKC | -AMC ]
<  [ -b ] [ -no-relax ]
---
>    [@b{-ACA}|@b{-ACA_A}|@b{-ACB}|@b{-ACC}|@b{-AKA}|@b{-AKB}|
>     @b{-AKC}|@b{-AMC}]
>    [@b{-b}] [@b{-no-relax}]
327,328c324,327
<  [ --m32rx | --[no-]warn-explicit-parallel-conflicts |
<    --W[n]p ]
---
> 
> @emph{Target M32R options:}
>    [@b{--m32rx}|@b{--[no-]warn-explicit-parallel-conflicts}|
>     @b{--W[n]p}]
331,335c330,332
<  [ -l ] [ -m68000 | -m68010 | -m68020 | ... ]
< @end ifset
< @ifset MCORE
<  [ -jsri2bsr ] [ -sifilter ] [ -relax ]
<  [ -mcpu=[210|340] ]
---
> 
> @emph{Target M680X0 options:}
>    [@b{-l}] [@b{-m68000}|@b{-m68010}|@b{-m68020}|@dots{}]
338,341c335,346
<  [ -m68hc11 | -m68hc12 ]
<  [ --force-long-branchs ] [ --short-branchs ]
<  [ --strict-direct-mode ] [ --print-insn-syntax ]
<  [ --print-opcodes ] [ --generate-example ]
---
> 
> @emph{Target M68HC11 options:}
>    [@b{-m68hc11}|@b{-m68hc12}]
>    [@b{--force-long-branchs}] [@b{--short-branchs}]
>    [@b{--strict-direct-mode}] [@b{--print-insn-syntax}]
>    [@b{--print-opcodes}] [@b{--generate-example}]
> @end ifset
> @ifset MCORE
> 
> @emph{Target MCORE options:}
>    [@b{-jsri2bsr}] [@b{-sifilter}] [@b{-relax}]
>    [@b{-mcpu=[210|340]}]
344,349c349,356
<  [ -nocpp ] [ -EL ] [ -EB ] [ -G @var{num} ] [ -mcpu=@var{CPU} ]
<  [ -mips1 ] [ -mips2 ] [ -mips3 ] [ -mips4 ] [ -mips5 ]
<  [ -mips32 ] [ -mips64 ]
<  [ -m4650 ] [ -no-m4650 ]
<  [ --trap ] [ --break ] [ -n ]
<  [ --emulation=@var{name} ]
---
> 
> @emph{Target MIPS options:}
>    [@b{-nocpp}] [@b{-EL}] [@b{-EB}] [@b{-G} @var{num}] [@b{-mcpu}=@var{CPU} ]
>    [@b{-mips1}] [@b{-mips2}] [@b{-mips3}] [@b{-mips4}] [@b{-mips5}]
>    [@b{-mips32}] [@b{-mips64}]
>    [@b{-m4650}] [@b{-no-m4650}]
>    [@b{--trap}] [@b{--break}] [@b{-n}]
>    [@b{--emulation}=@var{name} ]
352,354c359,405
<  [ --fixed-special-register-names ] [ --globalize-symbols ]
<  [ --gnu-syntax ] [ --relax ] [ --no-predefined-symbols ]
<  [ --no-expand ] [ --no-merge-gregs ] [ -x ]
---
> 
> @emph{Target MMIX options:}
>    [@b{--fixed-special-register-names}] [@b{--globalize-symbols}]
>    [@b{--gnu-syntax}] [@b{--relax}] [@b{--no-predefined-symbols}]
>    [@b{--no-expand}] [@b{--no-merge-gregs}] [@b{-x}]
> @end ifset
> @ifset PDP11
> 
> @emph{Target PDP11 options:}
>    [@b{-mpic}|@b{-mno-pic}] [@b{-mall}] [@b{-mno-extensions}]
>    [@b{-m}@var{extension}|@b{-mno-}@var{extension}]
>    [@b{-m}@var{cpu}] [@b{-m}@var{machine}]  
> @end ifset
> @ifset PJ
> 
> @emph{Target picoJava options:}
>    [@b{-mb}|@b{-me}]
> @end ifset
> @ifset PPC
> 
> @emph{Target PowerPC options:}
>    [@b{-mpwrx}|@b{-mpwr2}|@b{-mpwr}|@b{-m601}|@b{-mppc}|@b{-mppc32}|@b{-m603}|@b{-m604}|
>     @b{-m403}|@b{-m405}|@b{-mppc64}|@b{-m620}|@b{-mppc64bridge}|@b{-mbooke}|
>     @b{-mbooke32}|@b{-mbooke64}]
>    [@b{-mcom}|@b{-many}|@b{-maltivec}] [@b{-memb}]
>    [@b{-mregnames}|@b{-mno-regnames}]
>    [@b{-mrelocatable}|@b{-mrelocatable-lib}]
>    [@b{-mlittle}|@b{-mlittle-endian}|@b{-mbig}|@b{-mbig-endian}]
>    [@b{-msolaris}|@b{-mno-solaris}]
> @end ifset
> @ifset SPARC
> 
> @emph{Target SPARC options:}
> @c The order here is important.  See c-sparc.texi.
>    [@b{-Av6}|@b{-Av7}|@b{-Av8}|@b{-Asparclet}|@b{-Asparclite}
>     @b{-Av8plus}|@b{-Av8plusa}|@b{-Av9}|@b{-Av9a}]
>    [@b{-xarch=v8plus}|@b{-xarch=v8plusa}] [@b{-bump}]
>    [@b{-32}|@b{-64}]
> @end ifset
> @ifset TIC54X
> 
> @emph{Target TIC54X options:}
>  [@b{-mcpu=54[123589]}|@b{-mcpu=54[56]lp}] [@b{-mfar-mode}|@b{-mf}] 
>  [@b{-merrors-to-file} @var{<filename>}|@b{-me} @var{<filename>}]
> @end ifset
> @ifset Z8000
> @c Z8000 has no machine-dependent assembler options
356d406
<  [ -- | @var{files} @dots{} ]
362c412
< @table @code
---
> @table @gcctabopt
366c416
< @table @code
---
> @table @gcctabopt
461c511
< Name the object-file output from @code{@value{AS}} @var{objfile}.
---
> Name the object-file output from @command{@value{AS}} @var{objfile}.
475c525
< Print the @code{as} version.
---
> Print the @command{as} version.
478c528
< Print the @code{as} version and exit.
---
> Print the @command{as} version and exit.
508c558
< @table @code
---
> @table @gcctabopt
520c570
< @table @code
---
> @table @gcctabopt
544c594
< @table @code
---
> @table @gcctabopt
555c605
< @table @code
---
> @table @gcctabopt
575c625
< @table @code
---
> @table @gcctabopt
593c643
< @table @code
---
> @table @gcctabopt
614c664
< @table @code
---
> @table @gcctabopt
644c694
< @table @code
---
> @table @gcctabopt
647c697
< default is @code{-mpic}.
---
> default is @option{-mpic}.
674c724
< @table @code
---
> @table @gcctabopt
693c743
< @table @code
---
> @table @gcctabopt
720c770
< This option is only useful for testing @code{@value{AS}}.
---
> This option is only useful for testing @command{@value{AS}}.
726c776
< The following options are available when @code{@value{AS}} is configured
---
> The following options are available when @command{@value{AS}} is configured
729c779
< @table @code
---
> @table @gcctabopt
753c803
< @table @code
---
> @table @gcctabopt
769c819
< @table @code
---
> @table @gcctabopt
814c864
< This option causes @code{@value{AS}} to emulate @code{@value{AS}} configured
---
> This option causes @command{@value{AS}} to emulate @command{@value{AS}} configured
827c877
< @code{@value{AS}} is configured for is a MIPS ELF or ECOFF target.
---
> @command{@value{AS}} is configured for is a MIPS ELF or ECOFF target.
838c888
< @code{@value{AS}} ignores this option.  It is accepted for compatibility with
---
> @command{@value{AS}} ignores this option.  It is accepted for compatibility with
853c903
< When this option is used, @code{@value{AS}} will issue a warning every
---
> When this option is used, @command{@value{AS}} will issue a warning every
862c912
< @table @code
---
> @table @gcctabopt
910c960
< @sc{gnu} @code{@value{AS}}.  We cover the syntax expected in source files, including
---
> @sc{gnu} @command{@value{AS}}.  We cover the syntax expected in source files, including
912c962
< @code{@value{AS}} understands; and of course how to invoke @code{@value{AS}}.
---
> @command{@value{AS}} understands; and of course how to invoke @command{@value{AS}}.
916c966
< configuration of @code{@value{AS}}, including assembler directives.
---
> configuration of @command{@value{AS}}, including assembler directives.
962c1012
< @code{@value{AS}} is part of a team of programs that turn a high-level
---
> @command{@value{AS}} is part of a team of programs that turn a high-level
965c1015
< @code{@value{AS}} are used for different kinds of computer.
---
> @command{@value{AS}} are used for different kinds of computer.
982c1032
< @sc{gnu} @code{as} is really a family of assemblers.
---
> @sc{gnu} @command{as} is really a family of assemblers.
984c1034
< This manual describes @code{@value{AS}}, a member of that family which is
---
> This manual describes @command{@value{AS}}, a member of that family which is
994c1044
< @code{@value{AS}} is primarily intended to assemble the output of the
---
> @command{@value{AS}} is primarily intended to assemble the output of the
996c1046
< @code{@value{LD}}.  Nevertheless, we've tried to make @code{@value{AS}}
---
> @code{@value{LD}}.  Nevertheless, we've tried to make @command{@value{AS}}
1005c1055
< This doesn't mean @code{@value{AS}} always uses the same syntax as another
---
> This doesn't mean @command{@value{AS}} always uses the same syntax as another
1012c1062
< Unlike older assemblers, @code{@value{AS}} is designed to assemble a source
---
> Unlike older assemblers, @command{@value{AS}} is designed to assemble a source
1027c1077
< On the @value{TARGET}, @code{@value{AS}} is configured to produce
---
> On the @value{TARGET}, @command{@value{AS}} is configured to produce
1032c1082
< On the @value{TARGET}, @code{@value{AS}} can be configured to produce either
---
> On the @value{TARGET}, @command{@value{AS}} can be configured to produce either
1036c1086
< On the @value{TARGET}, @code{@value{AS}} can be configured to produce either
---
> On the @value{TARGET}, @command{@value{AS}} can be configured to produce either
1040c1090
< On the @value{TARGET}, @code{@value{AS}} can be configured to produce either
---
> On the @value{TARGET}, @command{@value{AS}} can be configured to produce either
1050c1100
< After the program name @code{@value{AS}}, the command line may contain
---
> After the program name @command{@value{AS}}, the command line may contain
1058c1108
< explicitly, as one of the files for @code{@value{AS}} to assemble.
---
> explicitly, as one of the files for @command{@value{AS}} to assemble.
1063c1113
< @code{@value{AS}}.  No option changes the way another option works.  An
---
> @command{@value{AS}}.  No option changes the way another option works.  An
1084c1134
< describe the program input to one run of @code{@value{AS}}.  The program may
---
> describe the program input to one run of @command{@value{AS}}.  The program may
1094c1144
< Each time you run @code{@value{AS}} it assembles exactly one source
---
> Each time you run @command{@value{AS}} it assembles exactly one source
1098c1148
< You give @code{@value{AS}} a command line that has zero or more input file
---
> You give @command{@value{AS}} a command line that has zero or more input file
1103,1105c1153,1155
< If you give @code{@value{AS}} no file names it attempts to read one input file
< from the @code{@value{AS}} standard input, which is normally your terminal.  You
< may have to type @key{ctl-D} to tell @code{@value{AS}} there is no more program
---
> If you give @command{@value{AS}} no file names it attempts to read one input file
> from the @command{@value{AS}} standard input, which is normally your terminal.  You
> may have to type @key{ctl-D} to tell @command{@value{AS}} there is no more program
1111c1161
< If the source is empty, @code{@value{AS}} produces a small, empty object
---
> If the source is empty, @command{@value{AS}} produces a small, empty object
1126c1176
< to @code{@value{AS}}.
---
> to @command{@value{AS}}.
1130,1131c1180,1181
< error messages reflect the original source file, when @code{@value{AS}} source
< is itself synthesized from other files.  @code{@value{AS}} understands the
---
> error messages reflect the original source file, when @command{@value{AS}} source
> is itself synthesized from other files.  @command{@value{AS}} understands the
1142c1192
< Every time you run @code{@value{AS}} it produces an output file, which is
---
> Every time you run @command{@value{AS}} it produces an output file, which is
1152c1202
< @code{b.out} when @code{@value{AS}} is configured for the Intel 80960.
---
> @code{b.out} when @command{@value{AS}} is configured for the Intel 80960.
1154c1204
< You can give it another name by using the @code{-o} option.  Conventionally,
---
> You can give it another name by using the @option{-o} option.  Conventionally,
1178c1228
< @code{@value{AS}} may write warnings and error messages to the standard error
---
> @command{@value{AS}} may write warnings and error messages to the standard error
1180,1181c1230,1231
< runs @code{@value{AS}} automatically.  Warnings report an assumption made so
< that @code{@value{AS}} could keep assembling a flawed program; errors report a
---
> runs @command{@value{AS}} automatically.  Warnings report an assumption made so
> that @command{@value{AS}} could keep assembling a flawed program; errors report a
1238c1288
< If you are invoking @code{@value{AS}} via the @sc{gnu} C compiler (version 2),
---
> If you are invoking @command{@value{AS}} via the @sc{gnu} C compiler (version 2),
1286c1336
< @section Enable Listings: @code{-a[cdhlns]}
---
> @section Enable Listings: @option{-a[cdhlns]}
1335c1385
< @section @code{-D}
---
> @section @option{-D}
1340c1390
< @code{@value{AS}}.
---
> @command{@value{AS}}.
1343c1393
< @section Work Faster: @code{-f}
---
> @section Work Faster: @option{-f}
1347c1397
< @cindex faster processing (@code{-f})
---
> @cindex faster processing (@option{-f})
1356c1406
< preprocessed (if they contain comments, for example), @code{@value{AS}} does
---
> preprocessed (if they contain comments, for example), @command{@value{AS}} does
1361c1411
< @section @code{.include} search path: @code{-I} @var{path}
---
> @section @code{.include} search path: @option{-I} @var{path}
1368,1369c1418,1419
< @code{@value{AS}} searches for files specified in @code{.include}
< directives (@pxref{Include,,@code{.include}}).  You may use @code{-I} as
---
> @command{@value{AS}} searches for files specified in @code{.include}
> directives (@pxref{Include,,@code{.include}}).  You may use @option{-I} as
1371c1421
< working directory is always searched first; after that, @code{@value{AS}}
---
> working directory is always searched first; after that, @command{@value{AS}}
1376c1426
< @section Difference Tables: @code{-K}
---
> @section Difference Tables: @option{-K}
1391c1441
< @code{@value{AS}} sometimes alters the code emitted for directives of the form
---
> @command{@value{AS}} sometimes alters the code emitted for directives of the form
1398c1448
< @section Include Local Labels: @code{-L}
---
> @section Include Local Labels: @option{-L}
1406c1456
< Normally both @code{@value{AS}} and @code{@value{LD}} discard such labels, so you do not
---
> Normally both @command{@value{AS}} and @code{@value{LD}} discard such labels, so you do not
1409c1459
< This option tells @code{@value{AS}} to retain those @samp{L@dots{}} symbols
---
> This option tells @command{@value{AS}} to retain those @samp{L@dots{}} symbols
1420c1470
< @section Configuring listing output: @code{--listing}
---
> @section Configuring listing output: @option{--listing}
1429c1479
< @table @code
---
> @table @gcctabopt
1459c1509
< @section Assemble in MRI Compatibility Mode: @code{-M}
---
> @section Assemble in MRI Compatibility Mode: @option{-M}
1463,1464c1513,1514
< The @code{-M} or @code{--mri} option selects MRI compatibility mode.  This
< changes the syntax and pseudo-op handling of @code{@value{AS}} to make it
---
> The @option{-M} or @option{--mri} option selects MRI compatibility mode.  This
> changes the syntax and pseudo-op handling of @command{@value{AS}} to make it
1470c1520
< assembling existing MRI assembler code using @code{@value{AS}}.
---
> assembling existing MRI assembler code using @command{@value{AS}}.
1481c1531
< Other object file formats do not support this.  @code{@value{AS}} handles
---
> Other object file formats do not support this.  @command{@value{AS}} handles
1496c1546
< instead be specified using the @code{-e} option to the linker, or in a linker
---
> instead be specified using the @option{-e} option to the linker, or in a linker
1507c1557
< address.  This differs from the usual @code{@value{AS}} @code{.org} pseudo-op,
---
> address.  This differs from the usual @command{@value{AS}} @code{.org} pseudo-op,
1514c1564
< @code{@value{AS}}, typically either because they are difficult or because they
---
> @command{@value{AS}}, typically either because they are difficult or because they
1539c1589
< @code{BRL}, and @code{BRW}---are ignored.  @code{@value{AS}} automatically
---
> @code{BRL}, and @code{BRW}---are ignored.  @command{@value{AS}} automatically
1590c1640
< @section Dependency tracking: @code{--MD}
---
> @section Dependency tracking: @option{--MD}
1596c1646
< @code{@value{AS}} can generate a dependency file for the file it creates.  This
---
> @command{@value{AS}} can generate a dependency file for the file it creates.  This
1605c1655
< @section Name the Object File: @code{-o}
---
> @section Name the Object File: @option{-o}
1610c1660
< There is always one object file output when you run @code{@value{AS}}.  By
---
> There is always one object file output when you run @command{@value{AS}}.  By
1631c1681
< Whatever the object file is called, @code{@value{AS}} overwrites any
---
> Whatever the object file is called, @command{@value{AS}} overwrites any
1635c1685
< @section Join Data and Text Sections: @code{-R}
---
> @section Join Data and Text Sections: @option{-R}
1642c1692
< @code{-R} tells @code{@value{AS}} to write the object file as if all
---
> @option{-R} tells @command{@value{AS}} to write the object file as if all
1649c1699
< When you specify @code{-R} it would be possible to generate shorter
---
> When you specify @option{-R} it would be possible to generate shorter
1652c1702
< older versions of @code{@value{AS}}.  In future, @code{-R} may work this way.
---
> older versions of @command{@value{AS}}.  In future, @option{-R} may work this way.
1655c1705
< When @code{@value{AS}} is configured for COFF output,
---
> When @command{@value{AS}} is configured for COFF output,
1661,1662c1711,1712
< @code{-R} is not supported for any of the HPPA targets.  Using
< @code{-R} generates a warning from @code{@value{AS}}.
---
> @option{-R} is not supported for any of the HPPA targets.  Using
> @option{-R} generates a warning from @command{@value{AS}}.
1666c1716
< @section Display Assembly Statistics: @code{--statistics}
---
> @section Display Assembly Statistics: @option{--statistics}
1673c1723
< @code{@value{AS}}: the maximum amount of space allocated during the assembly
---
> @command{@value{AS}}: the maximum amount of space allocated during the assembly
1678c1728
< @section Compatible output: @code{--traditional-format}
---
> @section Compatible output: @option{--traditional-format}
1681c1731
< For some targets, the output of @code{@value{AS}} is different in some ways
---
> For some targets, the output of @command{@value{AS}} is different in some ways
1683c1733
< @code{@value{AS}} to use the traditional format instead.
---
> @command{@value{AS}} to use the traditional format instead.
1686c1736
< @code{@value{AS}} normally does by default on @code{@value{GCC}} output.
---
> @command{@value{AS}} normally does by default on @code{@value{GCC}} output.
1689c1739
< @section Announce Version: @code{-v}
---
> @section Announce Version: @option{-v}
1700c1750
< @section Control Warnings: @code{-W}, @code{--warn}, @code{--no-warn}, @code{--fatal-warnings}
---
> @section Control Warnings: @option{-W}, @option{--warn}, @option{--no-warn}, @option{--fatal-warnings}
1702c1752
< @code{@value{AS}} should never give a warning or error message when
---
> @command{@value{AS}} should never give a warning or error message when
1704c1754
< cause @code{@value{AS}} to give a warning that a particular assumption was
---
> cause @command{@value{AS}} to give a warning that a particular assumption was
1711c1761
< If you use the @code{-W} and @code{--no-warn} options, no warnings are issued.
---
> If you use the @option{-W} and @option{--no-warn} options, no warnings are issued.
1713c1763
< how @code{@value{AS}} assembles your file.  Errors, which stop the assembly,
---
> how @command{@value{AS}} assembles your file.  Errors, which stop the assembly,
1719c1769
< If you use the @code{--fatal-warnings} option, @code{@value{AS}} considers
---
> If you use the @option{--fatal-warnings} option, @command{@value{AS}} considers
1724c1774
< You can switch these options off again by specifying @code{--warn}, which
---
> You can switch these options off again by specifying @option{--warn}, which
1728c1778
< @section Generate Object File in Spite of Errors: @code{-Z}
---
> @section Generate Object File in Spite of Errors: @option{-Z}
1731c1781
< After an error message, @code{@value{AS}} normally produces no output.  If for
---
> After an error message, @command{@value{AS}} normally produces no output.  If for
1733,1734c1783,1784
< @code{@value{AS}} gives an error message on your program, use the @samp{-Z}
< option.  If there are any errors, @code{@value{AS}} continues anyways, and
---
> @command{@value{AS}} gives an error message on your program, use the @samp{-Z}
> option.  If there are any errors, @command{@value{AS}} continues anyways, and
1744c1794
< source file.  @code{@value{AS}} syntax is similar to what many other
---
> source file.  @command{@value{AS}} syntax is similar to what many other
1750c1800
< assembler, except that @code{@value{AS}} does not assemble Vax bit-fields.
---
> assembler, except that @command{@value{AS}} does not assemble Vax bit-fields.
1766c1816
< The @code{@value{AS}} internal preprocessor:
---
> The @command{@value{AS}} internal preprocessor:
1823c1873
< There are two ways of rendering comments to @code{@value{AS}}.  In both
---
> There are two ways of rendering comments to @command{@value{AS}}.  In both
1935c1985
< of @code{@value{AS}}.
---
> of @command{@value{AS}}.
2033c2083
< Different versions of @code{@value{AS}} for different computers
---
> Different versions of @command{@value{AS}} for different computers
2104,2105c2154,2155
< @code{@value{AS}} to interpret the second character literally as a backslash
< (which prevents @code{@value{AS}} from recognizing the second @code{\} as an
---
> @command{@value{AS}} to interpret the second character literally as a backslash
> (which prevents @command{@value{AS}} from recognizing the second @code{\} as an
2188,2189c2238,2239
< interpretation of the following character.  However @code{@value{AS}} has no
< other interpretation, so @code{@value{AS}} knows it is giving you the wrong
---
> interpretation of the following character.  However @command{@value{AS}} has no
> other interpretation, so @command{@value{AS}} knows it is giving you the wrong
2229c2279
< that character.  @code{@value{AS}} assumes your character code is ASCII:
---
> that character.  @command{@value{AS}} assumes your character code is ASCII:
2237c2287
< @code{@value{AS}} distinguishes three kinds of numbers according to how they
---
> @command{@value{AS}} distinguishes three kinds of numbers according to how they
2302c2352
< @code{@value{AS}} to a generic binary floating point number of more than
---
> @command{@value{AS}} to a generic binary floating point number of more than
2305c2355
< portion of @code{@value{AS}} specialized to that computer.
---
> portion of @command{@value{AS}} specialized to that computer.
2316c2366
< A letter, to tell @code{@value{AS}} the rest of the number is a flonum.
---
> A letter, to tell @command{@value{AS}} the rest of the number is a flonum.
2385c2435
< @code{@value{AS}} does all processing using integers.  Flonums are computed
---
> @command{@value{AS}} does all processing using integers.  Flonums are computed
2387c2437
< @code{@value{AS}}.
---
> @command{@value{AS}}.
2405c2455
< @code{@value{AS}} applies a bitwise @sc{and} between @var{mask} and
---
> @command{@value{AS}} applies a bitwise @sc{and} between @var{mask} and
2447c2497
< combines their contents to form a runnable program.  When @code{@value{AS}}
---
> combines their contents to form a runnable program.  When @command{@value{AS}}
2451c2501
< oversimplification, but it suffices to explain how @code{@value{AS}} uses
---
> oversimplification, but it suffices to explain how @command{@value{AS}} uses
2464c2514
< @code{@value{AS}} pads sections if needed to
---
> @command{@value{AS}} pads sections if needed to
2469c2519
< An object file written by @code{@value{AS}} has at least three sections, any
---
> An object file written by @command{@value{AS}} has at least three sections, any
2477c2527
< @code{@value{AS}} can also generate whatever other named sections you specify
---
> @command{@value{AS}} can also generate whatever other named sections you specify
2485c2535
< When @code{@value{AS}} generates SOM or ELF output for the HPPA,
---
> When @command{@value{AS}} generates SOM or ELF output for the HPPA,
2487c2537
< @code{@value{AS}} can also generate whatever other named sections you
---
> @command{@value{AS}} can also generate whatever other named sections you
2494c2544
< Additionally, @code{@value{AS}} uses different names for the standard
---
> Additionally, @command{@value{AS}} uses different names for the standard
2511c2561
< relocated, and how to change that data, @code{@value{AS}} also writes to the
---
> relocated, and how to change that data, @command{@value{AS}} also writes to the
2532c2582
< In fact, every address @code{@value{AS}} ever uses is expressed as
---
> In fact, every address @command{@value{AS}} ever uses is expressed as
2537c2587
< Further, most expressions @code{@value{AS}} computes have this section-relative
---
> Further, most expressions @command{@value{AS}} computes have this section-relative
2573c2623
< use of @code{@value{AS}} and have no meaning except during assembly.
---
> use of @command{@value{AS}} and have no meaning except during assembly.
2592c2642
< These sections hold your program.  @code{@value{AS}} and @code{@value{LD}} treat them as
---
> These sections hold your program.  @command{@value{AS}} and @code{@value{LD}} treat them as
2685c2735
< These sections are meant only for the internal use of @code{@value{AS}}.  They
---
> These sections are meant only for the internal use of @command{@value{AS}}.  They
2687c2737
< sections for most purposes; but they can be mentioned in @code{@value{AS}}
---
> sections for most purposes; but they can be mentioned in @command{@value{AS}}
2689c2739
< meanings to @code{@value{AS}}.  These sections are used to permit the
---
> meanings to @command{@value{AS}}.  These sections are used to permit the
2735c2785
< are not contiguous in the assembler source.  @code{@value{AS}} allows you to
---
> are not contiguous in the assembler source.  @command{@value{AS}} allows you to
2751c2801
< of @code{@value{AS}}.)
---
> of @command{@value{AS}}.)
2813c2863
< restricted to @code{@value{AS}} there is no concept of a subsection location
---
> restricted to @command{@value{AS}} there is no concept of a subsection location
2854c2904
< @emph{Warning:} @code{@value{AS}} does not place symbols in the object file in
---
> @emph{Warning:} @command{@value{AS}} does not place symbols in the object file in
2880c2930
< a single line.  To work around this, the HPPA version of @code{@value{AS}} also
---
> a single line.  To work around this, the HPPA version of @command{@value{AS}} also
2978c3028
< All local labels begin with @samp{L}. Normally both @code{@value{AS}} and
---
> All local labels begin with @samp{L}. Normally both @command{@value{AS}} and
2981c3031
< @samp{-L} option then @code{@value{AS}} retains these symbols in the
---
> @samp{-L} option then @command{@value{AS}} retains these symbols in the
3030c3080
< @code{@value{AS}} is assembling into.  Thus, the expression @samp{melvin:
---
> @command{@value{AS}} is assembling into.  Thus, the expression @samp{melvin:
3055c3105
< If you use a symbol without defining it, @code{@value{AS}} assumes zero for
---
> If you use a symbol without defining it, @command{@value{AS}} assumes zero for
3127c3177
< These symbol attributes appear only when @code{@value{AS}} is configured for
---
> These symbol attributes appear only when @command{@value{AS}} is configured for
3161c3211
< @code{@value{AS}}.
---
> @command{@value{AS}}.
3167c3217
< This is an arbitrary 8-bit value.  It means nothing to @code{@value{AS}}.
---
> This is an arbitrary 8-bit value.  It means nothing to @command{@value{AS}}.
3190c3240
< The @code{@value{AS}} directives @code{.dim}, @code{.line}, @code{.scl},
---
> The @command{@value{AS}} directives @code{.dim}, @code{.line}, @code{.scl},
3221c3271
< enough information when @code{@value{AS}} sees the expression to know its
---
> enough information when @command{@value{AS}} sees the expression to know its
3224c3274
< @code{@value{AS}} aborts with an error message in this situation.
---
> @command{@value{AS}} aborts with an error message in this situation.
3238c3288
< expression, and @code{@value{AS}} assumes a value of (absolute) 0.  This
---
> expression, and @command{@value{AS}} assumes a value of (absolute) 0.  This
3278c3328
< that only the low order 32 bits are used, and @code{@value{AS}} pretends
---
> that only the low order 32 bits are used, and @command{@value{AS}} pretends
3303c3353
< @code{@value{AS}} has the following @dfn{prefix operators}.  They each take
---
> @command{@value{AS}} has the following @dfn{prefix operators}.  They each take
3331c3381
< to right.  Apart from @code{+} or @code{-}, both arguments must be
---
> to right.  Apart from @code{+} or @option{-}, both arguments must be
3618c3668
< of the source quit, it could use this directive tells @code{@value{AS}} to
---
> of the source quit, it could use this directive tells @command{@value{AS}} to
3626c3676
< When producing COFF output, @code{@value{AS}} accepts this directive as a
---
> When producing COFF output, @command{@value{AS}} accepts this directive as a
3630c3680
< When producing @code{b.out} output, @code{@value{AS}} accepts this directive,
---
> When producing @code{b.out} output, @command{@value{AS}} accepts this directive,
3762c3812
< no alignment is specified, @code{@value{AS}} will set the alignment to the
---
> no alignment is specified, @command{@value{AS}} will set the alignment to the
3776c3826
< @code{.data} tells @code{@value{AS}} to assemble the following statements onto the
---
> @code{.data} tells @command{@value{AS}} to assemble the following statements onto the
3792c3842
< This directive is only observed when @code{@value{AS}} is configured for COFF
---
> This directive is only observed when @command{@value{AS}} is configured for COFF
3809c3859
< The @samp{.desc} directive is not available when @code{@value{AS}} is
---
> The @samp{.desc} directive is not available when @command{@value{AS}} is
3811c3861
< object format.  For the sake of compatibility, @code{@value{AS}} accepts
---
> object format.  For the sake of compatibility, @command{@value{AS}} accepts
3829c3879
< @code{@value{AS}} is generating @code{b.out}, it accepts this directive but
---
> @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
3843c3893
< @code{@value{AS}} is configured.  @xref{Machine Dependencies}.
---
> @command{@value{AS}} is configured.  @xref{Machine Dependencies}.
3865c3915
< @code{.else} is part of the @code{@value{AS}} support for conditional
---
> @code{.else} is part of the @command{@value{AS}} support for conditional
3874c3924
< @code{.elseif} is part of the @code{@value{AS}} support for conditional
---
> @code{.elseif} is part of the @command{@value{AS}} support for conditional
3882c3932
< @code{.end} marks the end of the assembly file.  @code{@value{AS}} does not
---
> @code{.end} marks the end of the assembly file.  @command{@value{AS}} does not
3895c3945
< @code{@value{AS}} is configured to generate @code{b.out}, it accepts this
---
> @command{@value{AS}} is configured to generate @code{b.out}, it accepts this
3909c3959
< @code{.endif} is part of the @code{@value{AS}} support for conditional assembly;
---
> @code{.endif} is part of the @command{@value{AS}} support for conditional assembly;
3944,3945c3994,3995
< If @code{@value{AS}} assembles a @code{.err} directive, it will print an error
< message and, unless the @code{-Z} option was used, it will not generate an
---
> If @command{@value{AS}} assembles a @code{.err} directive, it will print an error
> message and, unless the @option{-Z} option was used, it will not generate an
3957c4007
< with other assemblers---but it is ignored.  @code{@value{AS}} treats
---
> with other assemblers---but it is ignored.  @command{@value{AS}} treats
3965,3966c4015,4016
< or more, @code{@value{AS}} will print a warning message.  If the value is less
< than 500, @code{@value{AS}} will print an error message.  The message will
---
> or more, @command{@value{AS}} will print a warning message.  If the value is less
> than 500, @command{@value{AS}} will print an error message.  The message will
3977c4027
< @code{.file} tells @code{@value{AS}} that we are about to start a new logical
---
> @code{.file} tells @command{@value{AS}} that we are about to start a new logical
3982c4032
< old @code{@value{AS}} programs.
---
> old @command{@value{AS}} programs.
3984c4034
< In some configurations of @code{@value{AS}}, @code{.file} has already been
---
> In some configurations of @command{@value{AS}}, @code{.file} has already been
4002c4052
< byte-order of an integer on the computer @code{@value{AS}} is assembling for.
---
> byte-order of an integer on the computer @command{@value{AS}} is assembling for.
4021c4071
< @code{@value{AS}} is configured.
---
> @command{@value{AS}} is configured.
4107c4157
< @code{@value{AS}} simply accepts the directive for source-file
---
> @command{@value{AS}} simply accepts the directive for source-file
4337c4387
< @code{@value{AS}} accepts this directive, for compatibility with other
---
> @command{@value{AS}} accepts this directive, for compatibility with other
4358c4408
< @code{@value{AS}} will no longer support this directive: it is recognized only
---
> @command{@value{AS}} will no longer support this directive: it is recognized only
4371c4421
< @code{b.out} object-code formats, @code{@value{AS}} still recognizes it
---
> @code{b.out} object-code formats, @command{@value{AS}} still recognizes it
4426c4476
< Tell @code{@value{AS}} to change the logical line number.  @var{line-number}
---
> Tell @command{@value{AS}} to change the logical line number.  @var{line-number}
4433c4483
< This directive is accepted, but ignored, when @code{@value{AS}} is
---
> This directive is accepted, but ignored, when @command{@value{AS}} is
4444,4445c4494,4495
< If @var{val} is non-zero, this tells @code{@value{AS}} to enter MRI mode.  If
< @var{val} is zero, this tells @code{@value{AS}} to exit MRI mode.  This change
---
> If @var{val} is non-zero, this tells @command{@value{AS}} to enter MRI mode.  If
> @var{val} is zero, this tells @command{@value{AS}} to exit MRI mode.  This change
4566c4616
< @code{@value{AS}} maintains a counter of how many macros it has
---
> @command{@value{AS}} maintains a counter of how many macros it has
4621c4671
< @code{@value{AS}} issues a warning, then pretends the section of @var{new-lc}
---
> @command{@value{AS}} issues a warning, then pretends the section of @var{new-lc}
4631c4681
< Because @code{@value{AS}} tries to assemble programs in one pass, @var{new-lc}
---
> Because @command{@value{AS}} tries to assemble programs in one pass, @var{new-lc}
4721c4771
< @code{@value{AS}} will print @var{string} on the standard output during
---
> @command{@value{AS}} will print @var{string} on the standard output during
4754c4804
< @code{@value{AS}} generates formfeeds whenever the specified number of
---
> @command{@value{AS}} generates formfeeds whenever the specified number of
4855c4905
< configured to generate @code{b.out} output format, @code{@value{AS}}
---
> configured to generate @code{b.out} output format, @command{@value{AS}}
5035c5085
< @code{@value{AS}} is configured.  @xref{Machine Dependencies}.
---
> @command{@value{AS}} is configured.  @xref{Machine Dependencies}.
5054c5104
< @code{@value{AS}} is generating @code{b.out}, it accepts this directive but
---
> @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
5129c5179
< The symbols are not entered in the @code{@value{AS}} hash table: they
---
> The symbols are not entered in the @command{@value{AS}} hash table: they
5304c5354
< @code{@value{AS}} is generating @code{b.out}, it accepts this directive but
---
> @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
5313c5363
< Tells @code{@value{AS}} to assemble the following statements onto the end of
---
> Tells @command{@value{AS}} to assemble the following statements onto the end of
5340c5390
< @code{@value{AS}} is configured for @code{b.out} output, it accepts this
---
> @command{@value{AS}} is configured for @code{b.out} output, it accepts this
5391c5441
< @samp{.val} is used only for COFF output; when @code{@value{AS}} is
---
> @samp{.val} is used only for COFF output; when @command{@value{AS}} is
5440c5490
< For each expression, @code{@value{AS}} emits a 32-bit number.
---
> For each expression, @command{@value{AS}} emits a 32-bit number.
5443c5493
< For each expression, @code{@value{AS}} emits a 16-bit number.
---
> For each expression, @command{@value{AS}} emits a 16-bit number.
5469c5519
< @code{@value{AS}} occasionally does strange things to @samp{.word} directives.
---
> @command{@value{AS}} occasionally does strange things to @samp{.word} directives.
5471c5521
< compilers as part of jump tables.  Therefore, when @code{@value{AS}} assembles a
---
> compilers as part of jump tables.  Therefore, when @command{@value{AS}} assembles a
5473c5523
< @code{sym1} and @code{sym2} does not fit in 16 bits, @code{@value{AS}}
---
> @code{sym1} and @code{sym2} does not fit in 16 bits, @command{@value{AS}}
5491c5541
< @emph{This feature may be disabled by compiling @code{@value{AS}} with the
---
> @emph{This feature may be disabled by compiling @command{@value{AS}} with the
5516,5517c5566,5567
< each machine where @code{@value{AS}} runs.  Floating point representations
< vary as well, and @code{@value{AS}} often supports a few additional
---
> each machine where @command{@value{AS}} runs.  Floating point representations
> vary as well, and @command{@value{AS}} often supports a few additional
5520c5570
< @code{@value{AS}} support special pseudo-instructions for branch
---
> @command{@value{AS}} support special pseudo-instructions for branch
5641c5691
< chapter describes the specific @code{@value{AS}} features for each
---
> chapter describes the specific @command{@value{AS}} features for each
5763c5813
< Your bug reports play an essential role in making @code{@value{AS}} reliable.
---
> Your bug reports play an essential role in making @command{@value{AS}} reliable.
5767,5768c5817,5818
< entire community by making the next version of @code{@value{AS}} work better.
< Bug reports are your contribution to the maintenance of @code{@value{AS}}.
---
> entire community by making the next version of @command{@value{AS}} work better.
> Bug reports are your contribution to the maintenance of @command{@value{AS}}.
5790c5840
< @code{@value{AS}} bug.  Reliable assemblers never crash.
---
> @command{@value{AS}} bug.  Reliable assemblers never crash.
5794c5844
< If @code{@value{AS}} produces an error message for valid input, that is a bug.
---
> If @command{@value{AS}} produces an error message for valid input, that is a bug.
5798c5848
< If @code{@value{AS}} does not produce an error message for invalid input, that
---
> If @command{@value{AS}} does not produce an error message for invalid input, that
5804c5854
< of @code{@value{AS}} are welcome in any case.
---
> of @command{@value{AS}} are welcome in any case.
5813c5863
< you obtained @code{@value{AS}} from a support organization, we recommend you
---
> you obtained @command{@value{AS}} from a support organization, we recommend you
5820c5870
< In any event, we also recommend that you send bug reports for @code{@value{AS}}
---
> In any event, we also recommend that you send bug reports for @command{@value{AS}}
5850c5900
< The version of @code{@value{AS}}.  @code{@value{AS}} announces it if you start
---
> The version of @command{@value{AS}}.  @command{@value{AS}} announces it if you start
5854c5904
< the bug in the current version of @code{@value{AS}}.
---
> the bug in the current version of @command{@value{AS}}.
5857c5907
< Any patches you may have applied to the @code{@value{AS}} source.
---
> Any patches you may have applied to the @command{@value{AS}} source.
5864c5914
< What compiler (and its version) was used to compile @code{@value{AS}}---e.g.
---
> What compiler (and its version) was used to compile @command{@value{AS}}---e.g.
5882c5932
< @code{@value{AS}} is being run.
---
> @command{@value{AS}} is being run.
5888c5938
< Of course, if the bug is that @code{@value{AS}} gets a fatal signal, then we
---
> Of course, if the bug is that @command{@value{AS}} gets a fatal signal, then we
5895c5945
< @code{@value{AS}} is out of synch, or you have encountered a bug in the C
---
> @command{@value{AS}} is out of synch, or you have encountered a bug in the C
5903c5953
< If you wish to suggest changes to the @code{@value{AS}} source, send us context
---
> If you wish to suggest changes to the @command{@value{AS}} source, send us context
5906c5956
< discuss something in the @code{@value{AS}} source, refer to it by context, not
---
> discuss something in the @command{@value{AS}} source, refer to it by context, not
5944c5994
< Sometimes with a program as complicated as @code{@value{AS}} it is very hard to
---
> Sometimes with a program as complicated as @command{@value{AS}} it is very hard to
5963c6013
< If you have contributed to @code{@value{AS}} and your name isn't listed here,
---
> If you have contributed to @command{@value{AS}} and your name isn't listed here,
6024c6074
< Steve Chamberlain made @code{@value{AS}} able to generate listings.
---
> Steve Chamberlain made @command{@value{AS}} able to generate listings.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]