From 310668e86dd5f3324eaff5efffd58ccabe7e5963 Mon Sep 17 00:00:00 2001 From: Jan van Male Date: Thu, 31 May 2001 06:27:52 +0200 Subject: [PATCH] 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 --- gcc/ChangeLog | 8 ++++ gcc/extend.texi | 22 +++++---- gcc/gcc.texi | 7 +-- gcc/invoke.texi | 122 +++++++++++++++++++++++++----------------------- 4 files changed, 88 insertions(+), 71 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index f48aed4e0a8..e62726ca7b0 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,11 @@ +2001-05-31 Jan van Male + + * 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 * dwarf2out.c (dwarf2out_finish): Don't emit DW_AT_stmt_list at -g1. diff --git a/gcc/extend.texi b/gcc/extend.texi index 7f486c5f4a7..7e45b61e00a 100644 --- a/gcc/extend.texi +++ b/gcc/extend.texi @@ -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 diff --git a/gcc/gcc.texi b/gcc/gcc.texi index c5c1ef91cac..b618737c2cb 100644 --- a/gcc/gcc.texi +++ b/gcc/gcc.texi @@ -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. diff --git a/gcc/invoke.texi b/gcc/invoke.texi index f961b90c08e..29584214185 100644 --- a/gcc/invoke.texi +++ b/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, -- 2.30.2