diff options
author | bstarynk <bstarynk@138bc75d-0d04-0410-961f-82ee72b054a4> | 2011-11-14 14:34:33 +0000 |
---|---|---|
committer | bstarynk <bstarynk@138bc75d-0d04-0410-961f-82ee72b054a4> | 2011-11-14 14:34:33 +0000 |
commit | 1e87b08a4c89ee453308a0b09b5bc40a5e3bec10 (patch) | |
tree | ed7af923d74901a7a6ff5d07ef176a640a585ba7 /gcc/doc | |
parent | cbacd2740bd9c2dfe6a0a755f74ddb45781a0665 (diff) | |
download | gcc-1e87b08a4c89ee453308a0b09b5bc40a5e3bec10.tar.gz |
2011-11-14 Basile Starynkevitch <basile@starynkevitch.net>
MELT branch merged with trunk rev 181350 using svnmerge
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/branches/melt-branch@181351 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'gcc/doc')
-rw-r--r-- | gcc/doc/extend.texi | 21 | ||||
-rw-r--r-- | gcc/doc/gcov.texi | 51 | ||||
-rw-r--r-- | gcc/doc/install.texi | 2 | ||||
-rw-r--r-- | gcc/doc/invoke.texi | 8 | ||||
-rw-r--r-- | gcc/doc/tm.texi | 18 | ||||
-rw-r--r-- | gcc/doc/tm.texi.in | 18 |
6 files changed, 85 insertions, 33 deletions
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index c7e8ede9cb0..15238c1b39e 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -7002,6 +7002,27 @@ All memory models are valid. @end deftypefn +@deftypefn {Built-in Function} bool __atomic_test_and_set (bool *ptr, int memmodel) + +This built-in function performs an atomic test-and-set operation on +@code{*@var{ptr}}. @code{*@var{ptr}} is set to the value 1 and +the previous contents are returned. + +All memory models are valid. + +@end deftypefn + +@deftypefn {Built-in Function} void __atomic_clear (bool *ptr, int memmodel) + +This built-in function performs an atomic clear operation on +@code{*@var{ptr}}. After the operation, @code{*@var{ptr}} will contain 0. + +The valid memory model variants are +@code{__ATOMIC_RELAXED}, @code{__ATOMIC_SEQ_CST}, and +@code{__ATOMIC_RELEASE}. + +@end deftypefn + @deftypefn {Built-in Function} void __atomic_thread_fence (int memmodel) This built-in function acts as a synchronization fence between threads diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi index e635b69a0eb..640d52e1284 100644 --- a/gcc/doc/gcov.texi +++ b/gcc/doc/gcov.texi @@ -113,7 +113,7 @@ compatible with any other profiling or test coverage mechanism. @section Invoking @command{gcov} @smallexample -gcov @r{[}@var{options}@r{]} @var{sourcefiles} +gcov @r{[}@var{options}@r{]} @var{files} @end smallexample @command{gcov} accepts the following options: @@ -124,13 +124,16 @@ gcov [@option{-v}|@option{--version}] [@option{-h}|@option{--help}] [@option{-a}|@option{--all-blocks}] [@option{-b}|@option{--branch-probabilities}] [@option{-c}|@option{--branch-counts}] + [@option{-u}|@option{--unconditional-branches}] [@option{-n}|@option{--no-output}] [@option{-l}|@option{--long-file-names}] [@option{-p}|@option{--preserve-paths}] + [@option{-r}|@option{--relative-only}] [@option{-f}|@option{--function-summaries}] - [@option{-o}|@option{--object-directory} @var{directory|file}] @var{sourcefiles} - [@option{-u}|@option{--unconditional-branches}] + [@option{-o}|@option{--object-directory} @var{directory|file}] + [@option{-s}|@option{--source-prefix} @var{directory}] [@option{-d}|@option{--display-progress}] + @var{files} @c man end @c man begin SEEALSO gpl(7), gfdl(7), fsf-funding(7), gcc(1) and the Info entry for @file{gcc}. @@ -176,11 +179,12 @@ Do not create the @command{gcov} output file. @itemx --long-file-names Create long file names for included source files. For example, if the header file @file{x.h} contains code, and was included in the file -@file{a.c}, then running @command{gcov} on the file @file{a.c} will produce -an output file called @file{a.c##x.h.gcov} instead of @file{x.h.gcov}. -This can be useful if @file{x.h} is included in multiple source -files. If you use the @samp{-p} option, both the including and -included file names will be complete path names. +@file{a.c}, then running @command{gcov} on the file @file{a.c} will +produce an output file called @file{a.c##x.h.gcov} instead of +@file{x.h.gcov}. This can be useful if @file{x.h} is included in +multiple source files and you want to see the individual +contributions. If you use the @samp{-p} option, both the including +and included file names will be complete path names. @item -p @itemx --preserve-paths @@ -188,9 +192,16 @@ Preserve complete path information in the names of generated @file{.gcov} files. Without this option, just the filename component is used. With this option, all directories are used, with @samp{/} characters translated to @samp{#} characters, @file{.} directory components -removed and @file{..} +removed and unremoveable @file{..} components renamed to @samp{^}. This is useful if sourcefiles are in several -different directories. It also affects the @samp{-l} option. +different directories. + +@item -r +@itemx --relative-only +Only output information about source files with a relative pathname +(after source prefix elision). Absolute paths are usually system +header files and coverage of any inline functions therein is normally +uninteresting. @item -f @itemx --function-summaries @@ -203,9 +214,16 @@ Specify either the directory containing the gcov data files, or the object path name. The @file{.gcno}, and @file{.gcda} data files are searched for using this option. If a directory is specified, the data files are in that directory and named after the -source file name, without its extension. If a file is specified here, -the data files are named after that file, without its extension. If this -option is not supplied, it defaults to the current directory. +input file name, without its extension. If a file is specified here, +the data files are named after that file, without its extension. + +@item -s @var{directory} +@itemx --source-prefix @var{directory} +A prefix for source file names to remove when generating the output +coverage files. This option is useful when building in a separate +directory, and the pathname to the source directory is not wanted when +determining the output file names. Note that this prefix detection is +applied before determining whether the source file is absolute. @item -u @itemx --unconditional-branches @@ -223,12 +241,17 @@ when you invoked the compiler. Otherwise it will not be able to locate the source files. @command{gcov} produces files called @file{@var{mangledname}.gcov} in the current directory. These contain the coverage information of the source file they correspond to. -One @file{.gcov} file is produced for each source file containing code, +One @file{.gcov} file is produced for each source (or header) file +containing code, which was compiled to produce the data files. The @var{mangledname} part of the output file name is usually simply the source file name, but can be something more complicated if the @samp{-l} or @samp{-p} options are given. Refer to those options for details. +If you invoke @command{gcov} with multiple input files, the +contributions from each input file are summed. Typically you would +invoke it with the same list of files as the final link of your executable. + The @file{.gcov} files contain the @samp{:} separated fields along with program source code. The format is diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 643ba7208e6..1daddb865e4 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -4476,7 +4476,7 @@ both 64-bit x86-64 and 32-bit x86 code (via the @option{-m32} switch). @html <hr /> @end html -@heading @anchor{x86-64-x-solaris2.10}x86_64-*-solaris2.1[0-9]* +@heading @anchor{x86-64-x-solaris210}x86_64-*-solaris2.1[0-9]* GCC also supports the x86-64 architecture implemented by the AMD64 processor (@samp{amd64-*-*} is an alias for @samp{x86_64-*-*}) on diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 2c5307deff6..73f874f152c 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -200,7 +200,7 @@ in the following sections. -Weffc++ -Wstrict-null-sentinel @gol -Wno-non-template-friend -Wold-style-cast @gol -Woverloaded-virtual -Wno-pmf-conversions @gol --Wsign-promo} +-Wsign-promo -Wzero-as-null-pointer-constant} @item Objective-C and Objective-C++ Language Options @xref{Objective-C and Objective-C++ Dialect Options,,Options Controlling @@ -3561,7 +3561,7 @@ To suppress this warning use the @samp{unused} attribute @opindex Wunused-result @opindex Wno-unused-result Do not warn if a caller of a function marked with attribute -@code{warn_unused_result} (@pxref{Variable Attributes}) does not use +@code{warn_unused_result} (@pxref{Function Attributes}) does not use its return value. The default is @option{-Wunused-result}. @item -Wunused-variable @@ -10609,8 +10609,8 @@ assembly code. Permissible names are: @samp{arm2}, @samp{arm250}, @samp{arm10e}, @samp{arm1020e}, @samp{arm1022e}, @samp{arm1136j-s}, @samp{arm1136jf-s}, @samp{mpcore}, @samp{mpcorenovfp}, @samp{arm1156t2-s}, @samp{arm1156t2f-s}, @samp{arm1176jz-s}, @samp{arm1176jzf-s}, -@samp{cortex-a5}, @samp{cortex-a8}, @samp{cortex-a9}, @samp{cortex-a15}, -@samp{cortex-r4}, @samp{cortex-r4f}, @samp{cortex-r5}, +@samp{cortex-a5}, @samp{cortex-a7}, @samp{cortex-a8}, @samp{cortex-a9}, +@samp{cortex-a15}, @samp{cortex-r4}, @samp{cortex-r4f}, @samp{cortex-r5}, @samp{cortex-m4}, @samp{cortex-m3}, @samp{cortex-m1}, @samp{cortex-m0}, diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index d96932b4e48..10fd876fd09 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -2435,12 +2435,13 @@ register address. You should define this macro if base plus index addresses have different requirements than other base register uses. @end defmac -@defmac MODE_CODE_BASE_REG_CLASS (@var{mode}, @var{outer_code}, @var{index_code}) +@defmac MODE_CODE_BASE_REG_CLASS (@var{mode}, @var{address_space}, @var{outer_code}, @var{index_code}) A C expression whose value is the register class to which a valid -base register must belong. @var{outer_code} and @var{index_code} define the -context in which the base register occurs. @var{outer_code} is the code of -the immediately enclosing expression (@code{MEM} for the top level of an -address, @code{ADDRESS} for something that occurs in an +base register for a memory reference in mode @var{mode} to address +space @var{address_space} must belong. @var{outer_code} and @var{index_code} +define the context in which the base register occurs. @var{outer_code} is +the code of the immediately enclosing expression (@code{MEM} for the top level +of an address, @code{ADDRESS} for something that occurs in an @code{address_operand}). @var{index_code} is the code of the corresponding index expression if @var{outer_code} is @code{PLUS}; @code{SCRATCH} otherwise. @end defmac @@ -2480,8 +2481,11 @@ Use of this macro is deprecated; please use the more general @code{REGNO_MODE_CODE_OK_FOR_BASE_P}. @end defmac -@defmac REGNO_MODE_CODE_OK_FOR_BASE_P (@var{num}, @var{mode}, @var{outer_code}, @var{index_code}) -A C expression that is just like @code{REGNO_MODE_OK_FOR_BASE_P}, except +@defmac REGNO_MODE_CODE_OK_FOR_BASE_P (@var{num}, @var{mode}, @var{address_space}, @var{outer_code}, @var{index_code}) +A C expression which is nonzero if register number @var{num} is +suitable for use as a base register in operand addresses, accessing +memory in mode @var{mode} in address space @var{address_space}. +This is similar to @code{REGNO_MODE_OK_FOR_BASE_P}, except that that expression may examine the context in which the register appears in the memory reference. @var{outer_code} is the code of the immediately enclosing expression (@code{MEM} if at the top level of the diff --git a/gcc/doc/tm.texi.in b/gcc/doc/tm.texi.in index 146e38a35e1..cebeb1fa777 100644 --- a/gcc/doc/tm.texi.in +++ b/gcc/doc/tm.texi.in @@ -2423,12 +2423,13 @@ register address. You should define this macro if base plus index addresses have different requirements than other base register uses. @end defmac -@defmac MODE_CODE_BASE_REG_CLASS (@var{mode}, @var{outer_code}, @var{index_code}) +@defmac MODE_CODE_BASE_REG_CLASS (@var{mode}, @var{address_space}, @var{outer_code}, @var{index_code}) A C expression whose value is the register class to which a valid -base register must belong. @var{outer_code} and @var{index_code} define the -context in which the base register occurs. @var{outer_code} is the code of -the immediately enclosing expression (@code{MEM} for the top level of an -address, @code{ADDRESS} for something that occurs in an +base register for a memory reference in mode @var{mode} to address +space @var{address_space} must belong. @var{outer_code} and @var{index_code} +define the context in which the base register occurs. @var{outer_code} is +the code of the immediately enclosing expression (@code{MEM} for the top level +of an address, @code{ADDRESS} for something that occurs in an @code{address_operand}). @var{index_code} is the code of the corresponding index expression if @var{outer_code} is @code{PLUS}; @code{SCRATCH} otherwise. @end defmac @@ -2468,8 +2469,11 @@ Use of this macro is deprecated; please use the more general @code{REGNO_MODE_CODE_OK_FOR_BASE_P}. @end defmac -@defmac REGNO_MODE_CODE_OK_FOR_BASE_P (@var{num}, @var{mode}, @var{outer_code}, @var{index_code}) -A C expression that is just like @code{REGNO_MODE_OK_FOR_BASE_P}, except +@defmac REGNO_MODE_CODE_OK_FOR_BASE_P (@var{num}, @var{mode}, @var{address_space}, @var{outer_code}, @var{index_code}) +A C expression which is nonzero if register number @var{num} is +suitable for use as a base register in operand addresses, accessing +memory in mode @var{mode} in address space @var{address_space}. +This is similar to @code{REGNO_MODE_OK_FOR_BASE_P}, except that that expression may examine the context in which the register appears in the memory reference. @var{outer_code} is the code of the immediately enclosing expression (@code{MEM} if at the top level of the |