extend.texi: Fix formating of examples, eliminate some 'overfull hboxes'.
* extend.texi: Fix formating of examples, eliminate some 'overfull hboxes'. * gcc.texi: Eliminate some 'overfull hboxes'. * invoke.texi: Use two spaces between command options, eliminate some 'overfull hboxes'. From-SVN: r42735
This commit is contained in:
Jan van Male
Gerald Pfeifer
parent
85836c0b63
commit
310668e86d
4 changed files with 88 additions and 71 deletions
|
|
@ -1,3 +1,11 @@
|
|||
2001-05-31 Jan van Male <jan.vanmale@fenk.wau.nl>
|
||||
|
||||
* extend.texi: Fix formating of examples, eliminate some
|
||||
'overfull hboxes'.
|
||||
* gcc.texi: Eliminate some 'overfull hboxes'.
|
||||
* invoke.texi: Use two spaces between command options, eliminate
|
||||
some 'overfull hboxes'.
|
||||
|
||||
2001-05-30 Richard Henderson <rth@redhat.com>
|
||||
|
||||
* dwarf2out.c (dwarf2out_finish): Don't emit DW_AT_stmt_list at -g1.
|
||||
|
|
|
|||
|
|
@ -265,7 +265,7 @@ example:
|
|||
|
||||
@example
|
||||
#define SEARCH(array, target) \
|
||||
(@{ \
|
||||
(@{ \
|
||||
__label__ found; \
|
||||
typeof (target) _SEARCH_target = (target); \
|
||||
typeof (*(array)) *_SEARCH_array = (array); \
|
||||
|
|
@ -274,7 +274,7 @@ example:
|
|||
for (i = 0; i < max; i++) \
|
||||
for (j = 0; j < max; j++) \
|
||||
if (_SEARCH_array[i][j] == _SEARCH_target) \
|
||||
@{ value = i; goto found; @} \
|
||||
@{ value = i; goto found; @} \
|
||||
value = -1; \
|
||||
found: \
|
||||
value; \
|
||||
|
|
@ -346,7 +346,8 @@ never pass it as an argument.
|
|||
An alternate way to write the above example is
|
||||
|
||||
@example
|
||||
static const int array[] = @{ &&foo - &&foo, &&bar - &&foo, &&hack - &&foo @};
|
||||
static const int array[] = @{ &&foo - &&foo, &&bar - &&foo,
|
||||
&&hack - &&foo @};
|
||||
goto *(&&foo + array[i]);
|
||||
@end example
|
||||
|
||||
|
|
@ -2547,7 +2548,8 @@ int foo __attribute__((section ("shared"), shared)) = 0;
|
|||
int
|
||||
main()
|
||||
@{
|
||||
/* Read and write foo. All running copies see the same value. */
|
||||
/* Read and write foo. All running
|
||||
copies see the same value. */
|
||||
return 0;
|
||||
@}
|
||||
@end smallexample
|
||||
|
|
@ -3123,9 +3125,10 @@ significantly, or combined, by writing the keyword @code{volatile} after
|
|||
the @code{asm}. For example:
|
||||
|
||||
@example
|
||||
#define get_and_set_priority(new) \
|
||||
(@{ int __old; \
|
||||
asm volatile ("get_and_set_priority %0, %1": "=g" (__old) : "g" (new)); \
|
||||
#define get_and_set_priority(new) \
|
||||
(@{ int __old; \
|
||||
asm volatile ("get_and_set_priority %0, %1" \
|
||||
: "=g" (__old) : "g" (new)); \
|
||||
__old; @})
|
||||
@end example
|
||||
|
||||
|
|
@ -3832,8 +3835,9 @@ you may want it to be folded if it involves constants, but need to call
|
|||
a function if it does not. For example:
|
||||
|
||||
@smallexample
|
||||
#define Scale_Value(X) \
|
||||
(__builtin_constant_p (X) ? ((X) * SCALE + OFFSET) : Scale (X))
|
||||
#define Scale_Value(X) \
|
||||
(__builtin_constant_p (X) \
|
||||
? ((X) * SCALE + OFFSET) : Scale (X))
|
||||
@end smallexample
|
||||
|
||||
You may use this builtin function in either a macro or an inline
|
||||
|
|
|
|||
|
|
@ -4109,8 +4109,8 @@ into @file{libgcc.a}.
|
|||
To have GCC include software floating point libraries in @file{libgcc.a}
|
||||
define @code{FPBIT} and @code{DPBIT} along with a few rules as follows:
|
||||
@smallexample
|
||||
# We want fine grained libraries, so use the new code to build the
|
||||
# floating point emulation libraries.
|
||||
# We want fine grained libraries, so use the new code
|
||||
# to build the floating point emulation libraries.
|
||||
FPBIT = fp-bit.c
|
||||
DPBIT = dp-bit.c
|
||||
|
||||
|
|
@ -4723,7 +4723,8 @@ GNU General Public License for more details.
|
|||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program; if not, write to the Free Software
|
||||
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
||||
Foundation, Inc., 59 Temple Place - Suite 330,
|
||||
Boston, MA 02111-1307, USA.
|
||||
@end smallexample
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
|
|
|||
122
gcc/invoke.texi
122
gcc/invoke.texi
|
|
@ -190,7 +190,7 @@ in the following sections.
|
|||
@xref{Objective-C Dialect Options,,Options Controlling Objective-C Dialect}.
|
||||
@gccoptlist{
|
||||
-fconstant-string-class=@var{class name} @gol
|
||||
-fgnu-runtime -fnext-runtime -gen-decls
|
||||
-fgnu-runtime -fnext-runtime -gen-decls @gol
|
||||
-Wno-protocol -Wselector}
|
||||
|
||||
@item Language Independent Options
|
||||
|
|
@ -217,7 +217,7 @@ in the following sections.
|
|||
-Wmissing-format-attribute -Wmissing-noreturn @gol
|
||||
-Wmultichar -Wno-format-extra-args -Wno-format-y2k @gol
|
||||
-Wno-import -Wpacked -Wpadded @gol
|
||||
-Wparentheses -Wpointer-arith -Wredundant-decls @gol
|
||||
-Wparentheses -Wpointer-arith -Wredundant-decls @gol
|
||||
-Wreturn-type -Wsequence-point -Wshadow @gol
|
||||
-Wsign-compare -Wswitch -Wsystem-headers @gol
|
||||
-Wtrigraphs -Wundef -Wuninitialized @gol
|
||||
|
|
@ -227,14 +227,14 @@ in the following sections.
|
|||
|
||||
@item C-only Warning Options
|
||||
@gccoptlist{
|
||||
-Wbad-function-cast -Wmissing-prototypes -Wnested-externs @gol
|
||||
-Wstrict-prototypes -Wtraditional}
|
||||
-Wbad-function-cast -Wmissing-prototypes -Wnested-externs @gol
|
||||
-Wstrict-prototypes -Wtraditional}
|
||||
|
||||
@item Debugging Options
|
||||
@xref{Debugging Options,,Options for Debugging Your Program or GCC}.
|
||||
@gccoptlist{
|
||||
-a -ax -d@var{letters} -dumpspecs -dumpmachine -dumpversion @gol
|
||||
-fdump-unnumbered -fdump-translation-unit=@var{file} @gol
|
||||
-fdump-unnumbered -fdump-translation-unit=@var{file} @gol
|
||||
-fdump-class-layout=@var{file} -fmem-report -fpretend-float @gol
|
||||
-fprofile-arcs -ftest-coverage -ftime-report @gol
|
||||
-g -g@var{level} -gcoff -gdwarf -gdwarf-1 -gdwarf-1+ -gdwarf-2 @gol
|
||||
|
|
@ -314,8 +314,8 @@ in the following sections.
|
|||
@gccoptlist{
|
||||
-m68000 -m68020 -m68020-40 -m68020-60 -m68030 -m68040 @gol
|
||||
-m68060 -mcpu32 -m5200 -m68881 -mbitfield -mc68000 -mc68020 @gol
|
||||
-mfpa -mnobitfield -mrtd -mshort -msoft-float -mpcrel @gol
|
||||
-malign-int -mstrict-align}
|
||||
-mfpa -mnobitfield -mrtd -mshort -msoft-float -mpcrel @gol
|
||||
-malign-int -mstrict-align}
|
||||
|
||||
@emph{M68hc1x Options}
|
||||
@gccoptlist{
|
||||
|
|
@ -333,11 +333,11 @@ in the following sections.
|
|||
-mcmodel=@var{code model} @gol
|
||||
-m32 -m64 @gol
|
||||
-mapp-regs -mbroken-saverestore -mcypress @gol
|
||||
-mepilogue -mfaster-structs -mflat @gol
|
||||
-mepilogue -mfaster-structs -mflat @gol
|
||||
-mfpu -mhard-float -mhard-quad-float @gol
|
||||
-mimpure-text -mlive-g0 -mno-app-regs @gol
|
||||
-mno-epilogue -mno-faster-structs -mno-flat -mno-fpu @gol
|
||||
-mno-impure-text -mno-stack-bias -mno-unaligned-doubles @gol
|
||||
-mno-epilogue -mno-faster-structs -mno-flat -mno-fpu @gol
|
||||
-mno-impure-text -mno-stack-bias -mno-unaligned-doubles @gol
|
||||
-msoft-float -msoft-quad-float -msparclite -mstack-bias @gol
|
||||
-msupersparc -munaligned-doubles -mv8}
|
||||
|
||||
|
|
@ -359,28 +359,28 @@ in the following sections.
|
|||
|
||||
@emph{ARM Options}
|
||||
@gccoptlist{
|
||||
-mapcs-frame -mno-apcs-frame @gol
|
||||
-mapcs-26 -mapcs-32 @gol
|
||||
-mapcs-stack-check -mno-apcs-stack-check @gol
|
||||
-mapcs-float -mno-apcs-float @gol
|
||||
-mapcs-reentrant -mno-apcs-reentrant @gol
|
||||
-msched-prolog -mno-sched-prolog @gol
|
||||
-mlittle-endian -mbig-endian -mwords-little-endian @gol
|
||||
-malignment-traps -mno-alignment-traps @gol
|
||||
-msoft-float -mhard-float -mfpe @gol
|
||||
-mthumb-interwork -mno-thumb-interwork @gol
|
||||
-mcpu=@var{name} -march=@var{name} -mfpe=@var{name} @gol
|
||||
-mapcs-frame -mno-apcs-frame @gol
|
||||
-mapcs-26 -mapcs-32 @gol
|
||||
-mapcs-stack-check -mno-apcs-stack-check @gol
|
||||
-mapcs-float -mno-apcs-float @gol
|
||||
-mapcs-reentrant -mno-apcs-reentrant @gol
|
||||
-msched-prolog -mno-sched-prolog @gol
|
||||
-mlittle-endian -mbig-endian -mwords-little-endian @gol
|
||||
-malignment-traps -mno-alignment-traps @gol
|
||||
-msoft-float -mhard-float -mfpe @gol
|
||||
-mthumb-interwork -mno-thumb-interwork @gol
|
||||
-mcpu=@var{name} -march=@var{name} -mfpe=@var{name} @gol
|
||||
-mstructure-size-boundary=@var{n} @gol
|
||||
-mbsd -mxopen -mno-symrename @gol
|
||||
-mbsd -mxopen -mno-symrename @gol
|
||||
-mabort-on-noreturn @gol
|
||||
-mlong-calls -mno-long-calls @gol
|
||||
-msingle-pic-base -mno-single-pic-base @gol
|
||||
-mlong-calls -mno-long-calls @gol
|
||||
-msingle-pic-base -mno-single-pic-base @gol
|
||||
-mpic-register=@var{reg} @gol
|
||||
-mnop-fun-dllimport @gol
|
||||
-mpoke-function-name @gol
|
||||
-mthumb -marm @gol
|
||||
-mtpcs-frame -mtpcs-leaf-frame @gol
|
||||
-mcaller-super-interworking -mcallee-super-interworking }
|
||||
-mthumb -marm @gol
|
||||
-mtpcs-frame -mtpcs-leaf-frame @gol
|
||||
-mcaller-super-interworking -mcallee-super-interworking }
|
||||
|
||||
@emph{MN10200 Options}
|
||||
@gccoptlist{
|
||||
|
|
@ -493,13 +493,13 @@ in the following sections.
|
|||
|
||||
@emph{DEC Alpha Options}
|
||||
@gccoptlist{
|
||||
-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float @gol
|
||||
-malpha-as -mgas @gol
|
||||
-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float @gol
|
||||
-malpha-as -mgas @gol
|
||||
-mieee -mieee-with-inexact -mieee-conformant @gol
|
||||
-mfp-trap-mode=@var{mode} -mfp-rounding-mode=@var{mode} @gol
|
||||
-mtrap-precision=@var{mode} -mbuild-constants @gol
|
||||
-mcpu=@var{cpu type} @gol
|
||||
-mbwx -mno-bwx -mcix -mno-cix -mmax -mno-max @gol
|
||||
-mbwx -mno-bwx -mcix -mno-cix -mmax -mno-max @gol
|
||||
-mmemory-latency=@var{time}}
|
||||
|
||||
@emph{Clipper Options}
|
||||
|
|
@ -508,7 +508,7 @@ in the following sections.
|
|||
|
||||
@emph{H8/300 Options}
|
||||
@gccoptlist{
|
||||
-mrelax -mh -ms -mint32 -malign-300}
|
||||
-mrelax -mh -ms -mint32 -malign-300}
|
||||
|
||||
@emph{SH Options}
|
||||
@gccoptlist{
|
||||
|
|
@ -532,43 +532,44 @@ in the following sections.
|
|||
|
||||
@emph{TMS320C3x/C4x Options}
|
||||
@gccoptlist{
|
||||
-mcpu=@var{cpu} -mbig -msmall -mregparm -mmemparm @gol
|
||||
-mfast-fix -mmpyi -mbk -mti -mdp-isr-reload @gol
|
||||
-mrpts=@var{count} -mrptb -mdb -mloop-unsigned @gol
|
||||
-mparallel-insns -mparallel-mpy -mpreserve-float}
|
||||
-mcpu=@var{cpu} -mbig -msmall -mregparm -mmemparm @gol
|
||||
-mfast-fix -mmpyi -mbk -mti -mdp-isr-reload @gol
|
||||
-mrpts=@var{count} -mrptb -mdb -mloop-unsigned @gol
|
||||
-mparallel-insns -mparallel-mpy -mpreserve-float}
|
||||
|
||||
@emph{V850 Options}
|
||||
@gccoptlist{
|
||||
-mlong-calls -mno-long-calls -mep -mno-ep @gol
|
||||
-mprolog-function -mno-prolog-function -mspace @gol
|
||||
-mtda=@var{n} -msda=@var{n} -mzda=@var{n} @gol
|
||||
-mv850 -mbig-switch}
|
||||
-mlong-calls -mno-long-calls -mep -mno-ep @gol
|
||||
-mprolog-function -mno-prolog-function -mspace @gol
|
||||
-mtda=@var{n} -msda=@var{n} -mzda=@var{n} @gol
|
||||
-mv850 -mbig-switch}
|
||||
|
||||
@emph{NS32K Options}
|
||||
@gccoptlist{
|
||||
-m32032 -m32332 -m32532 -m32081 -m32381 -mmult-add -mnomult-add @gol
|
||||
-msoft-float -mrtd -mnortd -mregparam -mnoregparam -msb -mnosb @gol
|
||||
-mbitfield -mnobitfield -mhimem -mnohimem}
|
||||
-m32032 -m32332 -m32532 -m32081 -m32381 @gol
|
||||
-mmult-add -mnomult-add -msoft-float -mrtd -mnortd @gol
|
||||
-mregparam -mnoregparam -msb -mnosb @gol
|
||||
-mbitfield -mnobitfield -mhimem -mnohimem}
|
||||
|
||||
@emph{AVR Options}
|
||||
@gccoptlist{
|
||||
-mmcu=@var{mcu} -msize -minit-stack=@var{n} -mno-interrupts @gol
|
||||
-mcall-prologues -mno-tablejump -mtiny-stack}
|
||||
-mmcu=@var{mcu} -msize -minit-stack=@var{n} -mno-interrupts @gol
|
||||
-mcall-prologues -mno-tablejump -mtiny-stack}
|
||||
|
||||
@emph{MCore Options}
|
||||
@gccoptlist{
|
||||
-mhardlit -mno-hardlit -mdiv -mno-div -mrelax-immediates @gol
|
||||
-mno-relax-immediates -mwide-bitfields -mno-wide-bitfields @gol
|
||||
-m4byte-functions -mno-4byte-functions -mcallgraph-data @gol
|
||||
-mno-callgraph-data -mslow-bytes -mno-slow-bytes -mno-lsim @gol
|
||||
-mlittle-endian -mbig-endian -m210 -m340 -mstack-increment}
|
||||
-mhardlit -mno-hardlit -mdiv -mno-div -mrelax-immediates @gol
|
||||
-mno-relax-immediates -mwide-bitfields -mno-wide-bitfields @gol
|
||||
-m4byte-functions -mno-4byte-functions -mcallgraph-data @gol
|
||||
-mno-callgraph-data -mslow-bytes -mno-slow-bytes -mno-lsim @gol
|
||||
-mlittle-endian -mbig-endian -m210 -m340 -mstack-increment}
|
||||
|
||||
@emph{IA-64 Options}
|
||||
@gccoptlist{
|
||||
-mbig-endian -mlittle-endian -mgnu-as -mgnu-ld -mno-pic @gol
|
||||
-mvolatile-asm-stop -mb-step -mregister-names -mno-sdata @gol
|
||||
-mconstant-gp -mauto-pic -minline-divide-min-latency @gol
|
||||
-minline-divide-max-throughput -mno-dwarf2-asm @gol
|
||||
-mbig-endian -mlittle-endian -mgnu-as -mgnu-ld -mno-pic @gol
|
||||
-mvolatile-asm-stop -mb-step -mregister-names -mno-sdata @gol
|
||||
-mconstant-gp -mauto-pic -minline-divide-min-latency @gol
|
||||
-minline-divide-max-throughput -mno-dwarf2-asm @gol
|
||||
-mfixed-range=@var{register range}}
|
||||
|
||||
@item Code Generation Options
|
||||
|
|
@ -581,12 +582,12 @@ in the following sections.
|
|||
-fno-common -fno-ident -fno-gnu-linker @gol
|
||||
-fpcc-struct-return -fpic -fPIC @gol
|
||||
-freg-struct-return -fshared-data -fshort-enums @gol
|
||||
-fshort-double -fvolatile -fvolatile-global -fvolatile-static @gol
|
||||
-fshort-double -fvolatile @gol
|
||||
-fvolatile-global -fvolatile-static @gol
|
||||
-fverbose-asm -fpack-struct -fstack-check @gol
|
||||
-fstack-limit-register=@var{reg} -fstack-limit-symbol=@var{sym} @gol
|
||||
-fargument-alias -fargument-noalias @gol
|
||||
-fargument-noalias-global @gol
|
||||
-fleading-underscore}
|
||||
-fargument-noalias-global -fleading-underscore}
|
||||
@end table
|
||||
|
||||
@menu
|
||||
|
|
@ -4144,7 +4145,8 @@ lib Libraries to include on the command line to the linker
|
|||
libgcc Decides which GCC support library to pass to the linker
|
||||
linker Sets the name of the linker
|
||||
predefines Defines to be passed to the C preprocessor
|
||||
signed_char Defines to pass to CPP to say whether @code{char} is signed by default
|
||||
signed_char Defines to pass to CPP to say whether @code{char} is signed
|
||||
by default
|
||||
startfile Object files to include at the start of the link
|
||||
@end smallexample
|
||||
|
||||
|
|
@ -8305,8 +8307,10 @@ function, so the call site information may not be available to the
|
|||
profiling functions otherwise.)
|
||||
|
||||
@example
|
||||
void __cyg_profile_func_enter (void *this_fn, void *call_site);
|
||||
void __cyg_profile_func_exit (void *this_fn, void *call_site);
|
||||
void __cyg_profile_func_enter (void *this_fn,
|
||||
void *call_site);
|
||||
void __cyg_profile_func_exit (void *this_fn,
|
||||
void *call_site);
|
||||
@end example
|
||||
|
||||
The first argument is the address of the start of the current function,
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue