diff options
Diffstat (limited to 'gcc/doc')
-rw-r--r-- | gcc/doc/extend.texi | 2 | ||||
-rw-r--r-- | gcc/doc/install.texi | 51 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 16 | ||||
-rw-r--r-- | gcc/doc/tm.texi | 36 |
4 files changed, 76 insertions, 29 deletions
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index e8b5628c0f1..4a7db02c902 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -6758,7 +6758,7 @@ This is an acceptable initializer even if @var{EXPRESSION} is not a constant expression, including the case where @code{__builtin_constant_p} returns 1 because @var{EXPRESSION} can be folded to a constant but @var{EXPRESSION} contains operands that would -not otherwize be permitted in a static initializer (for example, +not otherwise be permitted in a static initializer (for example, @code{0 && foo ()}). GCC must be more conservative about evaluating the built-in in this case, because it has no opportunity to perform optimization. diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 07b807b0e5d..7cba4d3df0e 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -983,6 +983,57 @@ sysv, aix. @end table +@item --with-multilib-list=@var{list} +@itemx --without-multilib-list +Specify what multilibs to build. +Currently only implemented for sh*-*-*. + +@var{list} is a comma separated list of CPU names. These must be of the +form @code{sh*} or @code{m*} (in which case they match the compiler option +for that processor). The list should not contain any endian options - +these are handled by @option{--with-endian}. + +If @var{list} is empty, then there will be no multilibs for extra +processors. The multilib for the secondary endian remains enabled. + +As a special case, if an entry in the list starts with a @code{!} +(exclamation point), then it is added to the list of excluded multilibs. +Entries of this sort should be compatible with @samp{MULTILIB_EXCLUDES} +(once the leading @code{!} has been stripped). + +If @option{--with-multilib-list} is not given, then a default set of +multilibs is selected based on the value of @option{--target}. This is +usually the complete set of libraries, but some targets imply a more +specialized subset. + +Example 1: to configure a compiler for SH4A only, but supporting both +endians, with little endian being the default: +@smallexample +--with-cpu=sh4a --with-endian=little,big --with-multilib-list= +@end smallexample + +Example 2: to configure a compiler for both SH4A and SH4AL-DSP, but with +only little endian SH4AL: +@smallexample +--with-cpu=sh4a --with-endian=little,big --with-multilib-list=sh4al,!mb/m4al +@end smallexample + +@item --with-endian=@var{endians} +Specify what endians to use. +Currently only implemented for sh*-*-*. + +@var{endians} may be one of the following: +@table @code +@item big +Use big endian exclusively. +@item little +Use little endian exclusively. +@item big,little +Use big endian by default. Provide a multilib for little endian. +@item little,big +Use little endian by default. Provide a multilib for big endian. +@end table + @item --enable-threads Specify that the target supports threads. This affects the Objective-C compiler and runtime diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 554b6d93cad..e1dd0e0ad46 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -2758,6 +2758,7 @@ Options} and @ref{Objective-C and Objective-C++ Dialect Options}. -Warray-bounds @r{(only with} @option{-O2}@r{)} @gol -Wc++0x-compat @gol -Wchar-subscripts @gol +-Wenum-compare @r{(in C/Objc; this is on by default in C++)} @gol -Wimplicit-int @gol -Wimplicit-function-declaration @gol -Wcomment @gol @@ -2803,6 +2804,7 @@ name is still supported, but the newer name is more descriptive.) @gccoptlist{-Wclobbered @gol -Wempty-body @gol -Wignored-qualifiers @gol +-Wlogical-op @gol -Wmissing-field-initializers @gol -Wmissing-parameter-type @r{(C only)} @gol -Wold-style-declaration @r{(C only)} @gol @@ -3743,11 +3745,12 @@ integers are disabled by default in C++ unless Warn if an empty body occurs in an @samp{if}, @samp{else} or @samp{do while} statement. This warning is also enabled by @option{-Wextra}. -@item -Wenum-compare @r{(C++ and Objective-C++ only)} +@item -Wenum-compare @opindex Wenum-compare @opindex Wno-enum-compare -Warn about a comparison between values of different enum types. This -warning is enabled by default. +Warn about a comparison between values of different enum types. In C++ +this warning is enabled by default. In C this warning is enabled by +@option{-Wall}. @item -Wsign-compare @opindex Wsign-compare @@ -3788,7 +3791,8 @@ programmer intended to use @code{strcmp}. This warning is enabled by @opindex Wno-logical-op Warn about suspicious uses of logical operators in expressions. This includes using logical operators in contexts where a -bit-wise operator is likely to be expected. +bit-wise operator is likely to be expected. This warning is enabled by +@option{-Wextra}. @item -Waggregate-return @opindex Waggregate-return @@ -15566,14 +15570,14 @@ This option is available for Cygwin and MinGW targets. It specifies that a console application is to be generated, by instructing the linker to set the PE header subsystem type required for console applications. -This is the default behaviour for Cygwin and MinGW targets. +This is the default behavior for Cygwin and MinGW targets. @item -mcygwin @opindex mcygwin This option is available for Cygwin targets. It specifies that the Cygwin internal interface is to be used for predefined preprocessor macros, C runtime libraries and related linker -paths and options. For Cygwin targets this is the default behaviour. +paths and options. For Cygwin targets this is the default behavior. This option is deprecated and will be removed in a future release. @item -mno-cygwin diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index 0396a706cf7..5718eb9be67 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -750,10 +750,10 @@ This variable is declared in @file{options.h}, which is included before any target-specific headers. @end deftypevar -@deftypevar {Target Hook} int TARGET_DEFAULT_TARGET_FLAGS +@deftypevr {Target Hook} int TARGET_DEFAULT_TARGET_FLAGS This variable specifies the initial value of @code{target_flags}. Its default setting is 0. -@end deftypevar +@end deftypevr @cindex optional hardware or system features @cindex features, optional, in system conventions @@ -1424,14 +1424,6 @@ floating-point arithmetic. The default definition of this macro returns false for all sizes. @end defmac -@deftypefn {Target Hook} bool TARGET_VECTOR_OPAQUE_P (tree @var{type}) -This target hook should return @code{true} a vector is opaque. That -is, if no cast is needed when copying a vector value of type -@var{type} into another vector lvalue of the same size. Vector opaque -types cannot be initialized. The default is that there are no such -types. -@end deftypefn - @deftypefn {Target Hook} bool TARGET_MS_BITFIELD_LAYOUT_P (tree @var{record_type}) This target hook returns @code{true} if bit-fields in the given @var{record_type} are to be laid out following the rules of Microsoft @@ -5680,18 +5672,18 @@ in order to make effective use of section anchors. It won't use section anchors at all unless either @code{TARGET_MIN_ANCHOR_OFFSET} or @code{TARGET_MAX_ANCHOR_OFFSET} is set to a nonzero value. -@deftypevar {Target Hook} HOST_WIDE_INT TARGET_MIN_ANCHOR_OFFSET +@deftypevr {Target Hook} HOST_WIDE_INT TARGET_MIN_ANCHOR_OFFSET The minimum offset that should be applied to a section anchor. On most targets, it should be the smallest offset that can be applied to a base register while still giving a legitimate address for every mode. The default value is 0. -@end deftypevar +@end deftypevr -@deftypevar {Target Hook} HOST_WIDE_INT TARGET_MAX_ANCHOR_OFFSET +@deftypevr {Target Hook} HOST_WIDE_INT TARGET_MAX_ANCHOR_OFFSET Like @code{TARGET_MIN_ANCHOR_OFFSET}, but the maximum (inclusive) offset that should be applied to section anchors. The default value is 0. -@end deftypevar +@end deftypevr @deftypefn {Target Hook} void TARGET_ASM_OUTPUT_ANCHOR (rtx @var{x}) Write the assembly code to define section anchor @var{x}, which is a @@ -6839,10 +6831,10 @@ Returns true if @var{exp} should be placed into a ``small data'' section. The default version of this hook always returns false. @end deftypefn -@deftypevar {Target Hook} bool TARGET_HAVE_SRODATA_SECTION +@deftypevr {Target Hook} bool TARGET_HAVE_SRODATA_SECTION Contains the value true if the target places read-only ``small data'' into a separate section. The default value is false. -@end deftypevar +@end deftypevr @deftypefn {Target Hook} bool TARGET_BINDS_LOCAL_P (tree @var{exp}) Returns true if @var{exp} names an object for which name resolution @@ -6854,10 +6846,10 @@ for ELF, which has a looser model of global name binding than other currently supported object file formats. @end deftypefn -@deftypevar {Target Hook} bool TARGET_HAVE_TLS +@deftypevr {Target Hook} bool TARGET_HAVE_TLS Contains the value true if the target supports thread-local storage. The default value is false. -@end deftypevar +@end deftypevr @node PIC @@ -8498,10 +8490,10 @@ Define this macro if your target has ABI specified unwind tables. Usually these will be output by @code{TARGET_UNWIND_EMIT}. @end defmac -@deftypevar {Target Hook} bool TARGET_UNWIND_TABLES_DEFAULT +@deftypevr {Target Hook} bool TARGET_UNWIND_TABLES_DEFAULT This variable should be set to @code{true} if the target ABI requires unwinding tables even when exceptions are not used. -@end deftypevar +@end deftypevr @defmac MUST_USE_SJLJ_EXCEPTIONS This macro need only be defined if @code{DWARF2_UNWIND_INFO} is @@ -8525,12 +8517,12 @@ minimum alignment otherwise. @xref{SDB and DWARF}. Only applicable if the target supports DWARF 2 frame unwind information. @end defmac -@deftypevar {Target Hook} bool TARGET_TERMINATE_DW2_EH_FRAME_INFO +@deftypevr {Target Hook} bool TARGET_TERMINATE_DW2_EH_FRAME_INFO Contains the value true if the target should add a zero word onto the end of a Dwarf-2 frame info section when used for exception handling. Default value is false if @code{EH_FRAME_SECTION_NAME} is defined, and true otherwise. -@end deftypevar +@end deftypevr @deftypefn {Target Hook} rtx TARGET_DWARF_REGISTER_SPAN (rtx @var{reg}) Given a register, this hook should return a parallel of registers to |