X-Git-Url: http://git.sourceforge.jp/view?p=pf3gnuchains%2Fgcc-fork.git;a=blobdiff_plain;f=gcc%2Fdoc%2Fsourcebuild.texi;h=cad3a88d16b490da2f8eec4a8309bdae30ccb6f6;hp=fc564908efb24ab1d62a232b769636651c147a6c;hb=38cd700915f1abaf909ff60335c58c39ceb45a90;hpb=50388ca3231d2219dd81d1b840dc1581671fe7cf diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi index fc564908efb..cad3a88d16b 100644 --- a/gcc/doc/sourcebuild.texi +++ b/gcc/doc/sourcebuild.texi @@ -368,7 +368,7 @@ directory or in @file{doc/include}. HTML manuals will be generated by @samp{makeinfo --html}, PostScript manuals by @command{texi2dvi} and @command{dvips}, and PDF manuals by @command{texi2pdf}. All Texinfo files that are parts of manuals must -be checked into CVS, even if they are generated files, for the +be checked into SVN, even if they are generated files, for the generation of online manuals to work. The installation manual, @file{doc/install.texi}, is also provided on @@ -447,8 +447,6 @@ versions, the information is on the GCC web site.) @item README.Portability Information about portability issues when writing code in GCC@. FIXME: why isn't this part of this manual or of the GCC Coding Conventions? -@item SERVICE -A pointer to the GNU Service Directory. @end table FIXME: document such files in subdirectories, at least @file{config}, @@ -504,7 +502,7 @@ Details of the directories of any runtime libraries in @file{gcc/doc/sourcebuild.texi}. @end itemize -If the front end is added to the official GCC CVS repository, the +If the front end is added to the official GCC source repository, the following are also necessary: @itemize @bullet @@ -542,8 +540,6 @@ to list the tarballs and diffs for this front end. If this front end includes its own version files that include the current date, @file{maintainer-scripts/update_version} should be updated accordingly. -@item -@file{CVSROOT/modules} in the GCC CVS repository should be updated. @end itemize @menu @@ -784,7 +780,7 @@ manual needs to be installed as info for this to work, or to be a chapter of this manual. @end itemize -If the back end is added to the official GCC CVS repository, the +If the back end is added to the official GCC source repository, the following are also necessary: @itemize @bullet @@ -944,9 +940,9 @@ it is executed. It is one of: @table @code @item preprocess Compile with @option{-E} to run only the preprocessor. -@item assemble -Compile with @option{-S} to produce an assembly code file. @item compile +Compile with @option{-S} to produce an assembly code file. +@item assemble Compile with @option{-c} to produce a relocatable object file. @item link Compile, assemble, and link to produce an executable file. @@ -963,16 +959,33 @@ If the directive includes the optional @samp{@{ target @var{selector} @}} then the test is skipped unless the target system is included in the list of target triplets or matches the effective-target keyword. -If the directive includes the optional @samp{@{ xfail @var{selector} @}} -and the selector is met then the test is expected to fail. For -@code{dg-do run}, execution is expected to fail but compilation -is expected to pass. +If @samp{do-what-keyword} is @code{run} and the directive includes +the optional @samp{@{ xfail @var{selector} @}} and the selector is met +then the test is expected to fail. The @code{xfail} clause is ignored +for other values of @samp{do-what-keyword}; those tests can use +directive @code{dg-xfail-if}. @item @{ dg-options @var{options} [@{ target @var{selector} @}] @} This DejaGnu directive provides a list of compiler options, to be used if the target system matches @var{selector}, that replace the default options used for this set of tests. +@item @{ dg-add-options @var{feature} ... @} +Add any compiler options that are needed to access certain features. +This directive does nothing on targets that enable the features by +default, or that don't provide them at all. It must come after +all @code{dg-options} directives. + +The supported values of @var{feature} are: +@table @code +@item c99_runtime +The target's C99 runtime (both headers and libraries). + +@item mips16_attribute +@code{mips16} function attributes. Only MIPS targets support this feature, +and only then in certain modes. +@end table + @item @{ dg-skip-if @var{comment} @{ @var{selector} @} @{ @var{include-opts} @} @{ @var{exclude-opts} @} @} Skip the test if the test system is included in @var{selector} and if each of the options in @var{include-opts} is in the set of options with @@ -990,14 +1003,16 @@ Expect the test to fail if the conditions (which are the same as for @item @{ dg-require-@var{support} args @} Skip the test if the target does not provide the required support; see @file{gcc-dg.exp} in the GCC testsuite for the actual directives. -These directives must appear after any @code{dg-do} directive in the test. +These directives must appear after any @code{dg-do} directive in the test +and before any @code{dg-additional-sources} directive. They require at least one argument, which can be an empty string if the specific procedure does not examine the argument. @item @{ dg-require-effective-target @var{keyword} @} Skip the test if the test target, including current multilib flags, is not covered by the effective-target keyword. -This directive must appear after any @code{dg-do} directive in the test. +This directive must appear after any @code{dg-do} directive in the test +and before any @code{dg-additional-sources} directive. @item @{ dg-shouldfail @var{comment} @{ @var{selector} @} @{ @var{include-opts} @} @{ @var{exclude-opts} @} @} Expect the test executable to return a nonzero exit status if the