Minor tweaks to the MIPS documentation

Eli Zaretskii eliz@gnu.org
Wed Jun 26 02:50:00 GMT 2013


> Date: Tue, 25 Jun 2013 23:15:23 +0100
> From: "Maciej W. Rozycki" <macro@codesourcery.com>
> CC: Eli Zaretskii <eliz@gnu.org>, <binutils@sourceware.org>
> 
> On Sat, 22 Jun 2013, Richard Sandiford wrote:
> 
> > Several small and unexciting changes:
> > 
> > - Consistently use "MIPS" rather than "@sc{mips}".  "@sc{mips}" looks strange
> >   in the PDF output and "MIPS" was already the prevalent form.  Also,
> >   "@sc{mips}" doesn't really look right alongside "microMIPS".
> 
>  Thanks, I think you missed a couple that are not strictly "MIPS" though, 
> a patch follows.  And I think @sc{isa} might fall into the same category 
> (but I haven't touched these).  I also changed one "MIPS3" to "MIPS III" 
> for consistency with "MIPS V" used elsewhere, and replaced some other @sc 
> commands with @samp for consistency with the corresponding part of 
> as.texinfo.  Also I think we should standardise on "MIPS16" rather than 
> "MIPS 16" used in some places, the latter has never been proper usage.
> 
>  Overall perhaps using @acronym{MIPS}, @acronym{microMIPS}, @acronym{ISA}, 
> etc. like the GDB manual does for these names would be a good idea?  I 
> remember Eli (cc-ed), the GDB manual reviewer, being quite keen on using 
> this command for this purpose.  Plus keeping the manuals at least remotely 
> consistent in style across toolchain pieces seems reasonable to me.
> 
>  As to this change -- checked html, info and pdf output.  OK to apply?

I'd prefer to use @acronym, indeed.  @samp is certainly not right in
these cases.



More information about the Binutils mailing list