OSDN Git Service

* c-decl.c (store_parm_decls_oldstyle): Let diagnostic machinery
[pf3gnuchains/gcc-fork.git] / gcc / common.opt
index b641381..466077c 100644 (file)
@@ -1,6 +1,6 @@
 ; Options for the language- and target-independent parts of the compiler.
 
-; Copyright (C) 2003, 2004 Free Software Foundation, Inc.
+; Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
 ;
 ; This file is part of GCC.
 ;
@@ -19,7 +19,7 @@
 ; Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 ; 02111-1307, USA.
 
-; See c.opt for a description of this file's format.
+; See the GCC internals manual for a description of this file's format.
 
 ; Please try to keep this file in ASCII collating order.
 
@@ -29,7 +29,7 @@ Display this information
 
 -param
 Common Separate
---param <param>=<value>        Set paramter <param> to value.  See below for a complete list of parameters
+--param <param>=<value>        Set parameter <param> to value.  See below for a complete list of parameters
 
 -target-help
 Common
@@ -182,12 +182,17 @@ dumpbase
 Common Separate
 -dumpbase <file>       Set the file basename to be used for dumps
 
-fPIC
-Common Report Var(flag_pic,2)
-
-fPIE
-Common Report Var(flag_pie,2)
-
+; The version of the C++ ABI in use.  The following values are allowed:
+;
+; 0: The version of the ABI believed most conformant with the C++ ABI
+;    specification.  This ABI may change as bugs are discovered and fixed.
+;    Therefore, 0 will not necessarily indicate the same ABI in different
+;    versions of G++.
+;
+; 1: The version of the ABI first used in G++ 3.2.
+;
+; Additional positive integers will be assigned as new versions of
+; the ABI become the default version of the ABI.
 fabi-version=
 Common Joined UInteger Var(flag_abi_version) Init(2)
 
@@ -219,6 +224,13 @@ Align the start of loops
 falign-loops=
 Common RejectNegative Joined UInteger
 
+; This flag is only tested if alias checking is enabled.
+; 0 if pointer arguments may alias each other.  True in C.
+; 1 if pointer arguments may not alias each other but may alias
+;   global variables.
+; 2 if pointer arguments may not alias each other and may not
+;   alias global variables.  True in Fortran.
+;   The value is ignored if flag_alias_check is 0.
 fargument-alias
 Common Report Var(flag_argument_noalias,0)
 Specify that arguments may alias each other and globals
@@ -235,6 +247,10 @@ fasynchronous-unwind-tables
 Common Report Var(flag_asynchronous_unwind_tables)
 Generate unwind tables that are exact at each instruction boundary
 
+; -fcheck-bounds causes gcc to generate array bounds checks.
+; For C, C++ and ObjC: defaults off.
+; For Java: defaults to on.
+; For Fortran: defaults to off.
 fbounds-check
 Common Report Var(flag_bounds_check)
 Generate code to check bounds before indexing arrays
@@ -267,6 +283,9 @@ fcall-used-
 Common Joined RejectNegative
 -fcall-used-<register> Mark <register> as being corrupted by function calls
 
+; Nonzero for -fcaller-saves: allocate values in regs that need to
+; be saved across function calls, if that produces overall better code.
+; Optional now, so people can test it.
 fcaller-saves
 Common Report Var(flag_caller_saves)
 Save registers around function calls
@@ -291,10 +310,16 @@ fcse-skip-blocks
 Common Report Var(flag_cse_skip_blocks)
 When running CSE, follow conditional jumps
 
+fcx-limited-range
+Common Report Var(flag_cx_limited_range)
+Omit range reduction step when performing complex division
+
 fdata-sections
 Common Report Var(flag_data_sections)
 Place data items into their own section
 
+; Nonzero for -fdefer-pop: don't pop args after each function call
+; instead save them up to pop many calls' args with one insns.
 fdefer-pop
 Common Report Var(flag_defer_pop)
 Defer popping functions args from stack until later
@@ -311,6 +336,10 @@ fdiagnostics-show-location=
 Common Joined RejectNegative
 -fdiagnostics-show-location=[once|every-line]  How often to emit source location at the beginning of line-wrapped diagnostics
 
+fdiagnostics-show-option
+Common Var(diagnostics_show_options)
+Amend appropriate diagnostic messages with the command line option that controls them.
+
 fdump-
 Common Joined RejectNegative
 -fdump-<type>  Dump various compiler internals to a file
@@ -352,16 +381,23 @@ Common Joined RejectNegative
 
 ffloat-store
 Common Report Var(flag_float_store)
-Do not store floats in registers
+Don't allocate floats and doubles in extended-precision registers
 
+; Nonzero for -fforce-addr: load memory address into a register before
+; reference to memory.  This makes better cse but slower compilation.
 fforce-addr
 Common Report Var(flag_force_addr)
 Copy memory address constants into registers before use
 
+; Nonzero for -fforce-mem: load memory value into a register
+; before arithmetic on it.  This makes better cse but slower compilation.
 fforce-mem
 Common Report Var(flag_force_mem)
 Copy memory operands into registers before use
 
+; Nonzero means don't put addresses of constant functions in registers.
+; Used for compiling the Unix kernel, where strange substitutions are
+; done on the assembly output.
 ffunction-cse
 Common Report Var(flag_no_function_cse,0)
 Allow function addresses to be held in registers
@@ -379,11 +415,11 @@ Common Report Var(flag_gcse_lm) Init(1)
 Perform enhanced load motion during global common subexpression elimination
 
 fgcse-sm
-Common Report Var(flag_gcse_sm) Init(1)
+Common Report Var(flag_gcse_sm) Init(0)
 Perform store motion after global common subexpression elimination
 
 fgcse-las
-Common Report Var(flag_gcse_las) Init(1)
+Common Report Var(flag_gcse_las) Init(0)
 Perform redundant load after store elimination in global common subexpression
 elimination
 
@@ -396,6 +432,10 @@ fguess-branch-probability
 Common Report Var(flag_guess_branch_prob)
 Enable guessing of branch probabilities
 
+; Nonzero means ignore `#ident' directives.  0 means handle them.
+; Generate position-independent code for executables if possible
+; On SVR4 targets, it also controls whether or not to emit a
+; string identifying the compiler.
 fident
 Common Report Var(flag_no_ident,0)
 Process #ident directives
@@ -408,10 +448,19 @@ fif-conversion2
 Common Report Var(flag_if_conversion2)
 Perform conversion of conditional jumps to conditional execution
 
+; -finhibit-size-directive inhibits output of .size for ELF.
+; This is used only for compiling crtstuff.c,
+; and it may be extended to other effects
+; needed for crtstuff.c on other systems.
 finhibit-size-directive
 Common Report Var(flag_inhibit_size_directive)
 Do not generate .size directives
 
+; Nonzero means that functions declared `inline' will be treated
+; as `static'.  Prevents generation of zillions of copies of unused
+; static inline functions; instead, `inlines' are written out
+; only when actually used.  Used in conjunction with -g.  Also
+; does the right thing with #pragma interface.
 finline
 Common Report Var(flag_no_inline,0) Init(2)
 Pay attention to the \"inline\" keyword
@@ -431,6 +480,10 @@ finstrument-functions
 Common Report Var(flag_instrument_function_entry_exit)
 Instrument function entry and exit with profiling calls
 
+fivopts
+Common Report Var(flag_ivopts) Init(1)
+Optimize induction variables on trees
+
 fkeep-inline-functions
 Common Report Var(flag_keep_inline_functions)
 Generate code for functions even if they are fully inlined
@@ -447,6 +500,10 @@ floop-optimize
 Common Report Var(flag_loop_optimize)
 Perform loop optimizations
 
+floop-optimize2
+Common Report Var(flag_loop_optimize2)
+Perform loop optimizations using the new loop optimizer
+
 fmath-errno
 Common Report Var(flag_errno_math) Init(1)
 Set errno after built-in math functions
@@ -455,6 +512,9 @@ fmem-report
 Common Report Var(mem_report)
 Report on permanent memory allocation
 
+; This will attempt to merge constant section constants, if 1 only
+; string constants and constants from constant pool, if 2 also constant
+; variables.
 fmerge-all-constants
 Common Report Var(flag_merge_constants,2) Init(1)
 Attempt to merge identical constants and constant variables
@@ -471,9 +531,9 @@ fmodulo-sched
 Common Report Var(flag_modulo_sched)
 Perform SMS based modulo scheduling before the first scheduling pass
 
-fmove-all-movables
-Common Report Var(flag_move_all_movables)
-Force all loop invariant computations out of loops
+fmove-loop-invariants
+Common Report Var(flag_move_loop_invariants)
+Move loop invariant computations out of loops
 
 fmudflap
 Common RejectNegative Report Var(flag_mudflap)
@@ -487,22 +547,14 @@ fmudflapir
 Common RejectNegative Report Var(flag_mudflap_ignore_reads)
 Ignore read operations when inserting mudflap instrumentation.
 
-fnew-ra
-Common Report Var(flag_new_regalloc)
-Use graph-coloring register allocation
+freschedule-modulo-scheduled-loops
+Common Report Var(flag_resched_modulo_sched)
+Enable/Disable the traditional scheduling in loops that already passed modulo scheduling
 
 fnon-call-exceptions
 Common Report Var(flag_non_call_exceptions)
 Support synchronous non-call exceptions
 
-fold-unroll-loops
-Common Report Var(flag_old_unroll_loops)
-Perform loop unrolling when iteration count is known
-
-fold-unroll-all-loops
-Common Report Var(flag_old_unroll_all_loops)
-Perform loop unrolling for all loops
-
 fomit-frame-pointer
 Common Report Var(flag_omit_frame_pointer)
 When possible do not generate stack frames
@@ -519,6 +571,10 @@ fpack-struct
 Common Report Var(flag_pack_struct)
 Pack structure members together without holes
 
+fpack-struct=
+Common RejectNegative Joined UInteger
+-fpack-struct=<number> Set initial maximum structure member alignment
+
 fpcc-struct-return
 Common Report Var(flag_pcc_struct_return,1) VarExists
 Return small aggregates in memory, not registers
@@ -535,13 +591,21 @@ fpeephole2
 Common Report Var(flag_peephole2)
 Enable an RTL peephole pass before sched2
 
+fPIC
+Common Report Var(flag_pic,2)
+Generate position-independent code if possible (large mode)
+
+fPIE
+Common Report Var(flag_pie,2)
+Generate position-independent code for executables if possible (large mode)
+
 fpic
 Common Report Var(flag_pic,1) VarExists
-Generate position-independent code if possible
+Generate position-independent code if possible (small mode)
 
 fpie
 Common Report Var(flag_pie,1) VarExists
-Generate position-independent code for executables if possible
+Generate position-independent code for executables if possible (small mode)
 
 fprefetch-loop-arrays
 Common Report Var(flag_prefetch_loop_arrays)
@@ -574,10 +638,6 @@ frandom-seed=
 Common Joined RejectNegative
 -frandom-seed=<string> Make compile reproducible using <string>
 
-freduce-all-givs
-Common Report Var(flag_reduce_all_givs)
-Strength reduce all loop general induction variables
-
 freg-struct-return
 Common Report Var(flag_pcc_struct_return,0) VarExists
 Return small aggregates in registers
@@ -650,26 +710,36 @@ fschedule-insns2
 Common Report Var(flag_schedule_insns_after_reload)
 Reschedule instructions after register allocation
 
+; sched_stalled_insns means that insns can be moved prematurely from the queue
+; of stalled insns into the ready list.
 fsched-stalled-insns
 Common Report Var(flag_sched_stalled_insns)
 Allow premature scheduling of queued insns
 
 fsched-stalled-insns=
 Common RejectNegative Joined UInteger 
--fsched-stalled-insns=<number>       Set number of queued insns that can be prematurely scheduled
+-fsched-stalled-insns=<number> Set number of queued insns that can be prematurely scheduled
 
+; sched_stalled_insns_dep controls how many recently scheduled cycles will
+; be examined for a dependency on a stalled insn that is candidate for
+; premature removal from the queue of stalled insns into the ready list (has
+; an effect only if the flag 'sched_stalled_insns' is set).
 fsched-stalled-insns-dep
 Common Report Var(flag_sched_stalled_insns_dep,1) Init(1)
 Set dependence distance checking in premature scheduling of queued insns
 
 fsched-stalled-insns-dep=
 Common RejectNegative Joined UInteger
--fsched-stalled-insns-dep=<number>   Set dependence distance checking in premature scheduling of queued insns
+-fsched-stalled-insns-dep=<number>     Set dependence distance checking in premature scheduling of queued insns
 
 fshared-data
 Common Report Var(flag_shared_data)
 Mark data as shared rather than private
 
+fshow-column
+Common C ObjC C++ ObjC++ Report Var(flag_show_column) Init(1)
+Show column numbers in diagnostics, when available.  Default on.
+
 fsignaling-nans
 Common Report Var(flag_signaling_nans)
 Disable optimizations observable by IEEE signaling NaNs
@@ -678,6 +748,20 @@ fsingle-precision-constant
 Common Report Var(flag_single_precision_constant)
 Convert floating point constants to single precision constants
 
+fspeculative-prefetching
+Common Report Var(flag_speculative_prefetching)
+Use value profiling for speculative prefetching
+
+fsplit-ivs-in-unroller
+Common Report Var(flag_split_ivs_in_unroller) Init(1)
+Split lifetimes of induction variables when loops are unrolled.
+
+fvariable-expansion-in-unroller
+Common Report Var(flag_variable_expansion_in_unroller) 
+Apply variable expansion when loops are unrolled.
+
+; Emit code to probe the stack, to help detect stack overflow; also
+; may cause large objects to be allocated dynamically.
 fstack-check
 Common Report Var(flag_stack_check)
 Insert stack checking code into the program
@@ -697,6 +781,10 @@ fstrength-reduce
 Common Report Var(flag_strength_reduce)
 Perform strength reduction optimizations
 
+; Nonzero if we should do (language-dependent) alias analysis.
+; Typically, this analysis will assume that expressions of certain
+; types do not alias expressions of certain other types.  Only used
+; if alias analysis (in general) is enabled.
 fstrict-aliasing
 Common Report Var(flag_strict_aliasing)
 Assume strict aliasing rules apply
@@ -725,8 +813,11 @@ ftracer
 Common Report Var(flag_tracer)
 Perform superblock formation via tail duplication
 
+; Zero means that floating-point math operations cannot generate a
+; (user-visible) trap.  This is the case, for example, in nonstop
+; IEEE 754 arithmetic.
 ftrapping-math
-Common Report Var(flag_trapping_math)
+Common Report Var(flag_trapping_math) Init(1)
 Assume floating-point operations can trap
 
 ftrapv
@@ -741,6 +832,10 @@ ftree-ccp
 Common Report Var(flag_tree_ccp)
 Enable SSA-CCP optimization on trees
 
+ftree-store-ccp
+Common Report Var(flag_tree_store_ccp)
+Enable SSA-CCP optimization for stores and loads
+
 ftree-ch
 Common Report Var(flag_tree_ch)
 Enable loop header copying on trees
@@ -753,6 +848,14 @@ ftree-copyrename
 Common Report Var(flag_tree_copyrename)
 Replace SSA temporaries with better names in copies.
 
+ftree-copy-prop
+Common Report Var(flag_tree_copy_prop)
+Enable copy propagation on trees
+
+ftree-store-copy-prop
+Common Report Var(flag_tree_store_copy_prop)
+Enable copy propagation for stores and loads
+
 ftree-dce
 Common Report Var(flag_tree_dce)
 Enable SSA dead code elimination optimization on trees
@@ -765,13 +868,38 @@ ftree-dse
 Common Report Var(flag_tree_dse)
 Enable dead store elimination
 
-ftree-points-to=
-Common Joined RejectNegative
+ftree-fre
+Common Report Var(flag_tree_fre)
+Enable Full Redundancy Elimination (FRE) on trees
+
+ftree-loop-im
+Common Report Var(flag_tree_loop_im) Init(1)
+Enable loop invariant motion on trees
+
+ftree-loop-linear
+Common Report Var(flag_tree_loop_linear)
+Enable linear loop transforms on trees
+
+ftree-loop-ivcanon
+Common Report Var(flag_tree_loop_ivcanon) Init(1)
+Create canonical induction variables in loops
+
+ftree-loop-optimize
+Common Report Var(flag_tree_loop_optimize) Init(1)
+Enable loop optimizations on tree level
 
 ftree-pre
 Common Report Var(flag_tree_pre)
 Enable SSA-PRE optimization on trees
 
+ftree-salias
+Common Report Var(flag_tree_salias)
+Perform structural alias analysis
+
+ftree-sink
+Common Report Var(flag_tree_sink)
+Enable SSA code sinking on trees
+
 ftree-sra
 Common Report Var(flag_tree_sra)
 Perform scalar replacement of aggregates
@@ -784,6 +912,10 @@ ftree-lrs
 Common Report Var(flag_tree_live_range_split)
 Perform live range splitting during the SSA->normal pass.
 
+ftree-vrp
+Common Report Var(flag_tree_vrp) Init(0)
+Perform Value Range Propagation on trees
+
 funit-at-a-time
 Common Report Var(flag_unit_at_a_time)
 Compile whole compilation unit at a time
@@ -796,6 +928,10 @@ funroll-all-loops
 Common Report Var(flag_unroll_all_loops)
 Perform loop unrolling for all loops
 
+; Nonzero means that unsafe floating-point math optimizations are allowed
+; for the sake of speed.  IEEE compliance is not guaranteed, and operations
+; are allowed to assume that their arguments and results are "normal"
+; (e.g., nonnegative for SQRT).
 funsafe-math-optimizations
 Common Report Var(flag_unsafe_math_optimizations)
 Allow math optimizations that may violate IEEE or ISO standards
@@ -812,16 +948,35 @@ fvar-tracking
 Common Report Var(flag_var_tracking) VarExists
 Perform variable tracking
 
+ftree-vectorize
+Common Report Var(flag_tree_vectorize)
+Enable loop vectorization on trees
+
+ftree-vectorizer-verbose=
+Common RejectNegative Joined
+-ftree-vectorizer-verbose=<number>     Set the verbosity level of the vectorizer
+
+; -fverbose-asm causes extra commentary information to be produced in
+; the generated assembly code (to make it more readable).  This option
+; is generally only of use to those who actually need to read the
+; generated assembly code (perhaps while debugging the compiler itself).
+; -fno-verbose-asm, the default, causes the extra information
+; to not be added and is useful when comparing two assembler files.
 fverbose-asm
 Common Report Var(flag_verbose_asm)
 Add extra commentary to assembler output
 
+fvisibility=
+Common Joined RejectNegative
+-fvisibility=[default|internal|hidden|protected]       Set the default symbol visibility
+
+
 fvpt
 Common Report Var(flag_value_profile_transformations)
 Use expression value profiles in optimizations
 
 fweb
-Common Report Var(flag_web) VarExists
+Common Report Var(flag_web) Init(0)
 Construct webs and split unrelated uses of single variable
 
 fwrapv
@@ -868,9 +1023,6 @@ gxcoff+
 Common JoinedOrMissing
 Generate debug information in extended XCOFF format
 
-m
-Common Joined
-
 o
 Common Joined Separate
 -o <file>      Place output into <file>