Commit 310668e8 by Jan van Male Committed by Gerald Pfeifer

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