diff options
Diffstat (limited to 'gcc/doc/invoke.texi')
| -rw-r--r-- | gcc/doc/invoke.texi | 170 |
1 files changed, 84 insertions, 86 deletions
diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 86ce1719199..9e3d915c0a3 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -252,7 +252,7 @@ in the following sections. -feliminate-unused-debug-symbols -fmem-report -fprofile-arcs @gol -frandom-seed=@var{string} -fsched-verbose=@var{n} @gol -ftest-coverage -ftime-report @gol --g -g@var{level} -gcoff -gdwarf -gdwarf-1 -gdwarf-1+ -gdwarf-2 @gol +-g -g@var{level} -gcoff -gdwarf-2 @gol -ggdb -gstabs -gstabs+ -gvms -gxcoff -gxcoff+ @gol -p -pg -print-file-name=@var{library} -print-libgcc-file-name @gol -print-multi-directory -print-multi-lib @gol @@ -281,6 +281,7 @@ in the following sections. -fno-trapping-math -fno-zero-initialized-in-bss @gol -fomit-frame-pointer -foptimize-register-move @gol -foptimize-sibling-calls -fprefetch-loop-arrays @gol +-fprofile-generate -fprofile-use @gol -freduce-all-givs -fregmove -frename-registers @gol -freorder-blocks -freorder-functions @gol -frerun-cse-after-loop -frerun-loop-opt @gol @@ -1048,7 +1049,7 @@ names @samp{c9x} and @samp{iso9899:199x} are deprecated. Default, ISO C90 plus GNU extensions (including some C99 features). @item gnu99 -@item gnu9x +@itemx gnu9x ISO C99 plus GNU extensions. When ISO C99 is fully implemented in GCC, this will become the default. The name @samp{gnu9x} is deprecated. @@ -3024,8 +3025,7 @@ makes debugging work better in GDB but will probably make other debuggers crash or refuse to read the program. If you want to control for certain whether to generate the extra information, use @option{-gstabs+}, @option{-gstabs}, -@option{-gxcoff+}, @option{-gxcoff}, @option{-gdwarf-1+}, @option{-gdwarf-1}, -or @option{-gvms} (see below). +@option{-gxcoff+}, @option{-gxcoff}, or @option{-gvms} (see below). Unlike most other C compilers, GCC allows you to use @option{-g} with @option{-O}. The shortcuts taken by optimized code may occasionally @@ -3087,23 +3087,6 @@ use of these extensions is likely to make other debuggers crash or refuse to read the program, and may cause assemblers other than the GNU assembler (GAS) to fail with an error. -@item -gdwarf -@opindex gdwarf -Produce debugging information in DWARF version 1 format (if that is -supported). This is the format used by SDB on most System V Release 4 -systems. - -This option is deprecated. - -@item -gdwarf+ -@opindex gdwarf+ -Produce debugging information in DWARF version 1 format (if that is -supported), using GNU extensions understood only by the GNU debugger -(GDB)@. The use of these extensions is likely to make other debuggers -crash or refuse to read the program. - -This option is deprecated. - @item -gdwarf-2 @opindex gdwarf-2 Produce debugging information in DWARF version 2 format (if that is @@ -3133,9 +3116,9 @@ present in the program. Some debuggers support macro expansion when you use @option{-g3}. Note that in order to avoid confusion between DWARF1 debug level 2, -and DWARF2, neither @option{-gdwarf} nor @option{-gdwarf-2} accept -a concatenated debug level. Instead use an additional @option{-g@var{level}} -option to change the debug level for DWARF1 or DWARF2. +and DWARF2 @option{-gdwarf-2} does not accept a concatenated debug +level. Instead use an additional @option{-g@var{level}} option to +change the debug level for DWARF2. @item -feliminate-dwarf2-dups @opindex feliminate-dwarf2-dups @@ -4377,6 +4360,21 @@ and occasionally eliminate the copy. Disabled at levels @option{-O}, @option{-O2}, @option{-O3}, @option{-Os}. +@item -fprofile-generate +@opindex fprofile-generate +Enable options usually used for instrumenting application to produce profile usefull +for later recompilation profile feedback based optimization. + +The following options are enabled: @code{-fprofile-arcs}, @code{-fprofile-values}, @code{-fvpt} + +@item -fprofile-use +@opindex fprofile-use +Enable profile feedback directed optimizations, and optimizations +generally profitable only with profile feedback available. + +The following options are enabled: @code{-fbranch-probabilities}, +@code{-fvpt}, @code{-funroll-loops}, @code{-fpeel-loops}, @code{-ftracer}. + @end table The following options control compiler behavior regarding floating @@ -7815,62 +7813,62 @@ This specifies the @var{executable} that will be loading the build output file being linked. See man ld(1) for more information. @item -allowable_client @var{client_name} -@item -arch_only - -@item -client_name -@item -compatibility_version -@item -current_version -@item -dependency-file -@item -dylib_file -@item -dylinker_install_name -@item -dynamic -@item -dynamiclib -@item -exported_symbols_list -@item -filelist -@item -flat_namespace -@item -force_cpusubtype_ALL -@item -force_flat_namespace -@item -headerpad_max_install_names -@item -image_base -@item -init -@item -install_name -@item -keep_private_externs -@item -multi_module -@item -multiply_defined -@item -multiply_defined_unused -@item -noall_load -@item -nofixprebinding -@item -nomultidefs -@item -noprebind -@item -noseglinkedit -@item -pagezero_size -@item -prebind -@item -prebind_all_twolevel_modules -@item -private_bundle -@item -read_only_relocs -@item -sectalign -@item -sectobjectsymbols -@item -whyload -@item -seg1addr -@item -sectcreate -@item -sectobjectsymbols -@item -sectorder -@item -seg_addr_table -@item -seg_addr_table_filename -@item -seglinkedit -@item -segprot -@item -segs_read_only_addr -@item -segs_read_write_addr -@item -single_module -@item -static -@item -sub_library -@item -sub_umbrella -@item -twolevel_namespace -@item -umbrella -@item -undefined -@item -unexported_symbols_list -@item -weak_reference_mismatches -@item -whatsloaded +@itemx -arch_only + +@itemx -client_name +@itemx -compatibility_version +@itemx -current_version +@itemx -dependency-file +@itemx -dylib_file +@itemx -dylinker_install_name +@itemx -dynamic +@itemx -dynamiclib +@itemx -exported_symbols_list +@itemx -filelist +@itemx -flat_namespace +@itemx -force_cpusubtype_ALL +@itemx -force_flat_namespace +@itemx -headerpad_max_install_names +@itemx -image_base +@itemx -init +@itemx -install_name +@itemx -keep_private_externs +@itemx -multi_module +@itemx -multiply_defined +@itemx -multiply_defined_unused +@itemx -noall_load +@itemx -nofixprebinding +@itemx -nomultidefs +@itemx -noprebind +@itemx -noseglinkedit +@itemx -pagezero_size +@itemx -prebind +@itemx -prebind_all_twolevel_modules +@itemx -private_bundle +@itemx -read_only_relocs +@itemx -sectalign +@itemx -sectobjectsymbols +@itemx -whyload +@itemx -seg1addr +@itemx -sectcreate +@itemx -sectobjectsymbols +@itemx -sectorder +@itemx -seg_addr_table +@itemx -seg_addr_table_filename +@itemx -seglinkedit +@itemx -segprot +@itemx -segs_read_only_addr +@itemx -segs_read_write_addr +@itemx -single_module +@itemx -static +@itemx -sub_library +@itemx -sub_umbrella +@itemx -twolevel_namespace +@itemx -umbrella +@itemx -undefined +@itemx -unexported_symbols_list +@itemx -weak_reference_mismatches +@itemx -whatsloaded @opindex allowable_client @opindex arch_only @@ -7929,7 +7927,7 @@ output file being linked. See man ld(1) for more information. @opindex weak_reference_mismatches @opindex whatsloaded -This options are available for Darwin linker. Darwin linker man page +These options are available for Darwin linker. Darwin linker man page describes them in detail. @end table @@ -8588,7 +8586,7 @@ and will not be binary compatible with structures in code compiled without that switch. @item -m96bit-long-double -@item -m128bit-long-double +@itemx -m128bit-long-double @opindex m96bit-long-double @opindex m128bit-long-double These switches control the size of @code{long double} type. The i386 @@ -9387,7 +9385,7 @@ Supported values for @var{cpu_type} are @table @samp @item ev4 -@item ev45 +@itemx ev45 @itemx 21064 Schedules as an EV4 and has no instruction set extensions. @@ -9409,7 +9407,7 @@ Schedules as an EV5 and supports the BWX and MAX extensions. Schedules as an EV6 and supports the BWX, FIX, and MAX extensions. @item ev67 -@item 21264a +@itemx 21264a Schedules as an EV6 and supports the BWX, CIX, FIX, and MAX extensions. @end table @@ -9659,7 +9657,7 @@ parameters for machine type @var{cpu_type}. Supported values for TMS320C40. @item -mbig-memory -@item -mbig +@itemx -mbig @itemx -msmall-memory @itemx -msmall @opindex mbig-memory @@ -10751,7 +10749,7 @@ Use 32-bit @code{int}. Use 64-bit @code{float}. This is the default. @item -mfloat32 -@item -mno-float64 +@itemx -mno-float64 @opindex mfloat32 @opindex mno-float64 Use 32-bit @code{float}. |