espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-20 18:08:24 +08:00
Code Issues Packages Projects Releases Wiki Activity

gas/

Browse Source 
* doc/as.texinfo: Use MIPS rather than @sc{mips} throughout.
	Use "CPU" instead of "cpu".
	* doc/c-mips.texi: Likewise.
	(MIPS Opts): Rename to MIPS Options.
	(MIPS option stack): Rename to MIPS Option Stack.
	(MIPS ASE instruction generation overrides): Rename to
	MIPS ASE Instruction Generation Overrides (for now).
	(MIPS floating-point): Rename to MIPS Floating-Point.
This commit is contained in:
Richard Sandiford
2013-06-22 16:18:45 +00:00
parent fc16f8cc9b
commit 98508b2a6e
3 changed files with 53 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
gas/ChangeLog
View File

@ -1,3 +1,14 @@
2013-06-22 Richard Sandiford <rdsandiford@googlemail.com>
* doc/as.texinfo: Use MIPS rather than @sc{mips} throughout.
Use "CPU" instead of "cpu".
* doc/c-mips.texi: Likewise.
(MIPS Opts): Rename to MIPS Options.
(MIPS option stack): Rename to MIPS Option Stack.
(MIPS ASE instruction generation overrides): Rename to
MIPS ASE Instruction Generation Overrides (for now).
(MIPS floating-point): Rename to MIPS Floating-Point.
2013-06-22 Richard Sandiford <rdsandiford@googlemail.com> 2013-06-22 Richard Sandiford <rdsandiford@googlemail.com>
* doc/c-mips.texi (MIPS Macros): New section. * doc/c-mips.texi (MIPS Macros): New section.

12
gas/doc/as.texinfo
View File

@ -1219,7 +1219,7 @@ behaviour in the shell.
@ifset MIPS @ifset MIPS
The following options are available when @value{AS} is configured for The following options are available when @value{AS} is configured for
a @sc{mips} processor. a MIPS processor.
@table @gcctabopt @table @gcctabopt
@item -G @var{num} @item -G @var{num}
@ -1247,7 +1247,7 @@ Generate ``little endian'' format output.
@itemx -mips32r2 @itemx -mips32r2
@itemx -mips64 @itemx -mips64
@itemx -mips64r2 @itemx -mips64r2
Generate code for a particular @sc{mips} Instruction Set Architecture level. Generate code for a particular MIPS Instruction Set Architecture level.
@samp{-mips1} is an alias for @samp{-march=r3000}, @samp{-mips2} is an @samp{-mips1} is an alias for @samp{-march=r3000}, @samp{-mips2} is an
alias for @samp{-march=r6000}, @samp{-mips3} is an alias for alias for @samp{-march=r6000}, @samp{-mips3} is an alias for
@samp{-march=r4000} and @samp{-mips4} is an alias for @samp{-march=r8000}. @samp{-march=r4000} and @samp{-mips4} is an alias for @samp{-march=r8000}.
@ -1258,11 +1258,11 @@ correspond to generic
and @samp{MIPS64 Release 2} and @samp{MIPS64 Release 2}
ISA processors, respectively. ISA processors, respectively.
@item -march=@var{CPU} @item -march=@var{cpu}
Generate code for a particular @sc{mips} cpu. Generate code for a particular MIPS CPU.
@item -mtune=@var{cpu} @item -mtune=@var{cpu}
Schedule and tune for a particular @sc{mips} cpu. Schedule and tune for a particular MIPS CPU.
@item -mfix7000 @item -mfix7000
@itemx -mno-fix7000 @itemx -mno-fix7000
@ -1370,7 +1370,7 @@ in the name. Using @samp{-EB} or @samp{-EL} will override the endianness
selection in any case. selection in any case.
This option is currently supported only when the primary target This option is currently supported only when the primary target
@command{@value{AS}} is configured for is a @sc{mips} ELF or ECOFF target. @command{@value{AS}} is configured for is a MIPS ELF or ECOFF target.
Furthermore, the primary target or others specified with Furthermore, the primary target or others specified with
@samp{--enable-targets=@dots{}} at configuration time must include support for @samp{--enable-targets=@dots{}} at configuration time must include support for
the other format, if both are to be available. For example, the Irix 5 the other format, if both are to be available. For example, the Irix 5

72
gas/doc/c-mips.texi
View File

@ -14,32 +14,32 @@
@end ifclear @end ifclear
@cindex MIPS processor @cindex MIPS processor
@sc{gnu} @code{@value{AS}} for @sc{mips} architectures supports several @sc{gnu} @code{@value{AS}} for MIPS architectures supports several
different @sc{mips} processors, and MIPS ISA levels I through V, MIPS32, different MIPS processors, and MIPS ISA levels I through V, MIPS32,
and MIPS64. For information about the @sc{mips} instruction set, see and MIPS64. For information about the MIPS instruction set, see
@cite{MIPS RISC Architecture}, by Kane and Heindrich (Prentice-Hall). @cite{MIPS RISC Architecture}, by Kane and Heindrich (Prentice-Hall).
For an overview of @sc{mips} assembly conventions, see ``Appendix D: For an overview of MIPS assembly conventions, see ``Appendix D:
Assembly Language Programming'' in the same work. Assembly Language Programming'' in the same work.
@menu @menu
* MIPS Opts:: Assembler options * MIPS Options:: Assembler options
* MIPS Macros:: High-level assembly macros * MIPS Macros:: High-level assembly macros
* MIPS Symbol Sizes:: Directives to override the size of symbols * MIPS Symbol Sizes:: Directives to override the size of symbols
* MIPS Small Data:: Controlling the use of small data accesses * MIPS Small Data:: Controlling the use of small data accesses
* MIPS ISA:: Directives to override the ISA level * MIPS ISA:: Directives to override the ISA level
* MIPS autoextend:: Directives for extending MIPS 16 bit instructions * MIPS autoextend:: Directives for extending MIPS 16 bit instructions
* MIPS insn:: Directive to mark data as an instruction * MIPS insn:: Directive to mark data as an instruction
* MIPS option stack:: Directives to save and restore options * MIPS Option Stack:: Directives to save and restore options
* MIPS ASE instruction generation overrides:: Directives to control * MIPS ASE Instruction Generation Overrides:: Directives to control
generation of MIPS ASE instructions generation of MIPS ASE instructions
* MIPS floating-point:: Directives to override floating-point options * MIPS Floating-Point:: Directives to override floating-point options
* MIPS Syntax:: MIPS specific syntactical considerations * MIPS Syntax:: MIPS specific syntactical considerations
@end menu @end menu
@node MIPS Opts @node MIPS Options
@section Assembler options @section Assembler options
The @sc{mips} configurations of @sc{gnu} @code{@value{AS}} support these The MIPS configurations of @sc{gnu} @code{@value{AS}} support these
special options: special options:
@table @code @table @code
@ -56,7 +56,7 @@ Set the ``small data'' limit to @var{n} bytes. The default limit is 8 bytes.
@cindex little-endian output, MIPS @cindex little-endian output, MIPS
@item -EB @item -EB
@itemx -EL @itemx -EL
Any @sc{mips} configuration of @code{@value{AS}} can select big-endian or Any MIPS configuration of @code{@value{AS}} can select big-endian or
little-endian output at run time (unlike the other @sc{gnu} development little-endian output at run time (unlike the other @sc{gnu} development
tools, which must be configured for one or the other). Use @samp{-EB} tools, which must be configured for one or the other). Use @samp{-EB}
to select big-endian output, and @samp{-EL} for little-endian. to select big-endian output, and @samp{-EL} for little-endian.
@ -84,10 +84,10 @@ VxWorks-style position-independent macro expansions.
@itemx -mips64 @itemx -mips64
@itemx -mips64r2 @itemx -mips64r2
Generate code for a particular MIPS Instruction Set Architecture level. Generate code for a particular MIPS Instruction Set Architecture level.
@samp{-mips1} corresponds to the @sc{r2000} and @sc{r3000} processors, @samp{-mips1} corresponds to the R2000 and R3000 processors,
@samp{-mips2} to the @sc{r6000} processor, @samp{-mips3} to the @samp{-mips2} to the R6000 processor, @samp{-mips3} to the
@sc{r4000} processor, and @samp{-mips4} to the @sc{r8000} and R4000 processor, and @samp{-mips4} to the R8000 and
@sc{r10000} processors. @samp{-mips5}, @samp{-mips32}, @samp{-mips32r2}, R10000 processors. @samp{-mips5}, @samp{-mips32}, @samp{-mips32r2},
@samp{-mips64}, and @samp{-mips64r2} @samp{-mips64}, and @samp{-mips64r2}
correspond to generic correspond to generic
@sc{MIPS V}, @sc{MIPS32}, @sc{MIPS32 Release 2}, @sc{MIPS64}, @sc{MIPS V}, @sc{MIPS32}, @sc{MIPS32 Release 2}, @sc{MIPS64},
@ -201,8 +201,8 @@ batches, but this fix has no side effect to them.
@item -mfix-loongson2f-nop @item -mfix-loongson2f-nop
@itemx -mno-fix-loongson2f-nop @itemx -mno-fix-loongson2f-nop
Replace nops by @code{or at,at,zero} to work around the Loongson2F Replace nops by @code{or at,at,zero} to work around the Loongson2F
@samp{nop} errata. Without it, under extreme cases, cpu might @samp{nop} errata. Without it, under extreme cases, the CPU might
deadlock. The issue has been solved in latest loongson2f batches, but deadlock. The issue has been solved in later Loongson2F batches, but
this fix has no side effect to them. this fix has no side effect to them.
@item -mfix-vr4120 @item -mfix-vr4120
@ -226,15 +226,15 @@ certain CN63XXP1 errata.
@item -m4010 @item -m4010
@itemx -no-m4010 @itemx -no-m4010
Generate code for the LSI @sc{r4010} chip. This tells the assembler to Generate code for the LSI R4010 chip. This tells the assembler to
accept the @sc{r4010} specific instructions (@samp{addciu}, @samp{ffc}, accept the R4010-specific instructions (@samp{addciu}, @samp{ffc},
etc.), and to not schedule @samp{nop} instructions around accesses to etc.), and to not schedule @samp{nop} instructions around accesses to
the @samp{HI} and @samp{LO} registers. @samp{-no-m4010} turns off this the @samp{HI} and @samp{LO} registers. @samp{-no-m4010} turns off this
option. option.
@item -m4650 @item -m4650
@itemx -no-m4650 @itemx -no-m4650
Generate code for the MIPS @sc{r4650} chip. This tells the assembler to accept Generate code for the MIPS R4650 chip. This tells the assembler to accept
the @samp{mad} and @samp{madu} instruction, and to not schedule @samp{nop} the @samp{mad} and @samp{madu} instruction, and to not schedule @samp{nop}
instructions around accesses to the @samp{HI} and @samp{LO} registers. instructions around accesses to the @samp{HI} and @samp{LO} registers.
@samp{-no-m4650} turns off this option. @samp{-no-m4650} turns off this option.
@ -244,11 +244,11 @@ instructions around accesses to the @samp{HI} and @samp{LO} registers.
@itemx -m4100 @itemx -m4100
@itemx -no-m4100 @itemx -no-m4100
For each option @samp{-m@var{nnnn}}, generate code for the MIPS For each option @samp{-m@var{nnnn}}, generate code for the MIPS
@sc{r@var{nnnn}} chip. This tells the assembler to accept instructions R@var{nnnn} chip. This tells the assembler to accept instructions
specific to that chip, and to schedule for that chip's hazards. specific to that chip, and to schedule for that chip's hazards.
@item -march=@var{cpu} @item -march=@var{cpu}
Generate code for a particular MIPS cpu. It is exactly equivalent to Generate code for a particular MIPS CPU. It is exactly equivalent to
@samp{-m@var{cpu}}, except that there are more value of @var{cpu} @samp{-m@var{cpu}}, except that there are more value of @var{cpu}
understood. Valid @var{cpu} value are: understood. Valid @var{cpu} value are:
@ -340,7 +340,7 @@ accepted as synonyms for @samp{@var{n}f1_1}. These values are
deprecated. deprecated.
@item -mtune=@var{cpu} @item -mtune=@var{cpu}
Schedule and tune for a particular MIPS cpu. Valid @var{cpu} values are Schedule and tune for a particular MIPS CPU. Valid @var{cpu} values are
identical to @samp{-march=@var{cpu}}. identical to @samp{-march=@var{cpu}}.
@item -mabi=@var{abi} @item -mabi=@var{abi}
@ -464,8 +464,8 @@ integer constants. For example, the architectural instruction
@code{lbu} allows only a signed 16-bit offset, whereas the macro @code{lbu} allows only a signed 16-bit offset, whereas the macro
@code{lbu} allows code such as @samp{lbu $4,array+32769($5)}. @code{lbu} allows code such as @samp{lbu $4,array+32769($5)}.
The implementation of these symbolic offsets depends on several factors, The implementation of these symbolic offsets depends on several factors,
such as whether the assembler is generating SVR4-style PIC (selected such as whether the assembler is generating SVR4-style PIC (selected by
by @option{-KPIC}, @pxref{MIPS Opts,, Assembler options}), the size of symbols @option{-KPIC}, @pxref{MIPS Options,, Assembler options}), the size of symbols
(@pxref{MIPS Symbol Sizes,, Directives to override the size of symbols}), (@pxref{MIPS Symbol Sizes,, Directives to override the size of symbols}),
and the small data limit (@pxref{MIPS Small Data,, Controlling the use and the small data limit (@pxref{MIPS Small Data,, Controlling the use
of small data accesses}). of small data accesses}).
@ -577,7 +577,7 @@ In order to cut down on this overhead, most embedded MIPS systems
set aside a 64-kilobyte ``small data'' area and guarantee that all set aside a 64-kilobyte ``small data'' area and guarantee that all
data of size @var{n} and smaller will be placed in that area. data of size @var{n} and smaller will be placed in that area.
The limit @var{n} is passed to both the assembler and the linker The limit @var{n} is passed to both the assembler and the linker
using the command-line option @option{-G @var{n}}, @pxref{MIPS Opts,, using the command-line option @option{-G @var{n}}, @pxref{MIPS Options,,
Assembler options}. Note that the same value of @var{n} must be used Assembler options}. Note that the same value of @var{n} must be used
when linking and when assembling all input files to the link; any when linking and when assembling all input files to the link; any
inconsistency could cause a relocation overflow error. inconsistency could cause a relocation overflow error.
@ -616,7 +616,7 @@ Small data is not supported for SVR4-style PIC.
@cindex MIPS ISA override @cindex MIPS ISA override
@kindex @code{.set mips@var{n}} @kindex @code{.set mips@var{n}}
@sc{gnu} @code{@value{AS}} supports an additional directive to change @sc{gnu} @code{@value{AS}} supports an additional directive to change
the @sc{mips} Instruction Set Architecture level on the fly: @code{.set the MIPS Instruction Set Architecture level on the fly: @code{.set
mips@var{n}}. @var{n} should be a number from 0 to 5, or 32, 32r2, 64 mips@var{n}}. @var{n} should be a number from 0 to 5, or 32, 32r2, 64
or 64r2. or 64r2.
The values other than 0 make the assembler accept instructions The values other than 0 make the assembler accept instructions
@ -641,13 +641,13 @@ The directive @code{.set mips16} puts the assembler into MIPS 16 mode,
in which it will assemble instructions for the MIPS 16 processor. Use in which it will assemble instructions for the MIPS 16 processor. Use
@code{.set nomips16} to return to normal 32 bit mode. @code{.set nomips16} to return to normal 32 bit mode.
Traditional @sc{mips} assemblers do not support this directive. Traditional MIPS assemblers do not support this directive.
The directive @code{.set micromips} puts the assembler into microMIPS mode, The directive @code{.set micromips} puts the assembler into microMIPS mode,
in which it will assemble instructions for the microMIPS processor. Use in which it will assemble instructions for the microMIPS processor. Use
@code{.set nomicromips} to return to normal 32 bit mode. @code{.set nomicromips} to return to normal 32 bit mode.
Traditional @sc{mips} assemblers do not support this directive. Traditional MIPS assemblers do not support this directive.
@node MIPS autoextend @node MIPS autoextend
@section Directives for extending MIPS 16 bit instructions @section Directives for extending MIPS 16 bit instructions
@ -662,7 +662,7 @@ must be explicitly extended with the @code{.e} modifier (e.g.,
to once again automatically extend instructions when necessary. to once again automatically extend instructions when necessary.
This directive is only meaningful when in MIPS 16 mode. Traditional This directive is only meaningful when in MIPS 16 mode. Traditional
@sc{mips} assemblers do not support this directive. MIPS assemblers do not support this directive.
@node MIPS insn @node MIPS insn
@section Directive to mark data as an instruction @section Directive to mark data as an instruction
@ -700,7 +700,7 @@ baz:
@end example @end example
@node MIPS option stack @node MIPS Option Stack
@section Directives to save and restore options @section Directives to save and restore options
@cindex MIPS option stack @cindex MIPS option stack
@ -716,9 +716,9 @@ These directives can be useful inside an macro which must change an
option such as the ISA level or instruction reordering but does not want option such as the ISA level or instruction reordering but does not want
to change the state of the code which invoked the macro. to change the state of the code which invoked the macro.
Traditional @sc{mips} assemblers do not support these directives. Traditional MIPS assemblers do not support these directives.
@node MIPS ASE instruction generation overrides @node MIPS ASE Instruction Generation Overrides
@section Directives to control generation of MIPS ASE instructions @section Directives to control generation of MIPS ASE instructions
@cindex MIPS MIPS-3D instruction generation override @cindex MIPS MIPS-3D instruction generation override
@ -787,9 +787,9 @@ from the Virtualization Application Specific Extension from that point
on in the assembly. The @code{.set novirt} directive prevents Virtualization on in the assembly. The @code{.set novirt} directive prevents Virtualization
instructions from being accepted. instructions from being accepted.
Traditional @sc{mips} assemblers do not support these directives. Traditional MIPS assemblers do not support these directives.
@node MIPS floating-point @node MIPS Floating-Point
@section Directives to override floating-point options @section Directives to override floating-point options
@cindex Disable floating-point instructions @cindex Disable floating-point instructions
@ -810,7 +810,7 @@ float-point operations. These directives always override the default
(that double-precision operations are accepted) or the command-line (that double-precision operations are accepted) or the command-line
options (@samp{-msingle-float} and @samp{-mdouble-float}). options (@samp{-msingle-float} and @samp{-mdouble-float}).
Traditional @sc{mips} assemblers do not support these directives. Traditional MIPS assemblers do not support these directives.
@node MIPS Syntax @node MIPS Syntax
@section Syntactical considerations for the MIPS assembler @section Syntactical considerations for the MIPS assembler