This is the mail archive of the mailing list for the GCC project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

RFA: hook doc patch (87/112): TARGET_OPTION_PRAGMA_PARSE (revised)

Quoting "Joseph S. Myers" <>:

This says what happens if args is NULL, but says nothing about the meaning of a non-NULL value (presumably it's not simply a boolean, or it would be bool rather than tree). Nor is anything said about *how* pop_target "specifies the default options to use" (even a reference to code that defines how options correspond to trees, for example).
2010-02-05  Joern Rennecke  <>

	* doc/tm.texi (TARGET_OPTION_PRAGMA_PARSE): Fix argument list.
	Fix TARGET_OPTION_VALID_ATTRIBUTE_P name.  Document arguments and
	return value.

Index: doc/tm.texi
--- doc/tm.texi	(revision 156503)
+++ doc/tm.texi	(working copy)
@@ -9555,11 +9568,19 @@ information in the @var{struct cl_target
 function specific options.
 @end deftypefn
-@deftypefn {Target Hook} bool TARGET_OPTION_PRAGMA_PARSE (target @var{args})
+@deftypefn {Target Hook} bool TARGET_OPTION_PRAGMA_PARSE (tree @var{args}, tree @var{pop_target})
 This target hook parses the options for @code{#pragma GCC option} to
 set the machine specific options for functions that occur later in the
 input stream.  The options should be the same as handled by the
+If @var{args} is non-NULL, it is a chain of string constants, each of
+which represents an option inside the @code{#pragma GCC option}.
+If @var{args} is @code{NULL}, @var{pop_target} specifies the default
+options to use: if it is @code{NULL}, too, use
+@code{TREE_TARGET_OPTION (target_option_default_node)}; if it is non-NULL,
+use @code{TREE_TARGET_OPTION (args)}; e.g. this is suitable as an agument to
+Return @code{true} if the options are valid, and set the current state.
 @end deftypefn
 @deftypefn {Target Hook} bool TARGET_CAN_INLINE_P (tree @var{caller}, tree @var{callee})

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]