binutils/gold/options.h

11 // (at your option) any later version.
34 // of the last instance of that option specified on the commandline wins).
66   // Startup files that appear before the first disposition option.
68   // --incremental-startup-unchanged option is given.
87 // These routines convert from a string option to various types.
131 // TWO_DASHES is how we print the option in --help.  However, some
133 // special value DASH_Z means that the option is preceded by "-z".
139 // LONGNAME is the long-name of the option with dashes converted to
140 //    underscores, or else the short-name if the option has no long-name.
143 // SHORTNAME is the short-name of the option, as a char, or '\0' if the
144 //    option has no short-name.  If the option has no long-name, you
146 // DEFAULT_VALUE is the value of the option if not specified on the
148 // HELPSTRING is the descriptive text used with the option via --help
149 // HELPARG is how you define the argument to the option.
151 //    HELPARG should be NULL iff the option is a bool and takes no arg.
152 // OPTIONAL_ARG is true if this option takes an optional argument.  An
181     // style uses dashes in option names.  longname is likely to have
195   // This option takes an argument iff helparg is not NULL.
205   // Register this option with the global list of options.
209   // Print this option to stdout (used with --help).
215 // actually implements parse_to_value for that option.
218   // OPTION: the name of the option as specified on the commandline,
219   //    including leading dashes, and any text following the option:
221   // ARG: the arg associated with this option, or NULL if the option
226   parse_to_value(const char* option, const char* arg,
242     : option(varname, dashes, shortname, "", helpstring, helparg, false, this,
247   void parse_to_value(const char* option, const char* arg,
249   { (options->*(this->parse))(option, arg, cmdline); }
251   One_option option;
264 // When we define the linker command option "assert", the macro argument
292       : option(#varname__, dashes__, shortname__, default_value_as_string__, \
305     options::One_option option;                                              \
314 // These macros allow for easy addition of a new commandline option.
317 // VARNAME, we also create an option called no-VARNAME (or, for a -z
318 // option, noVARNAME).
326     Struct_no_##varname__() : option((dashes__ == options::DASH_Z	 \
343     options::One_option option;                                          \
354     Struct_no_##varname__() : option((dashes__ == options::DASH_Z	 \
371     options::One_option option;                                          \
382     Struct_disable_##varname__() : option("disable-" #varname__,         \
394     options::One_option option;                                          \
494 // option.  This option becomes an alias for that one.  INVERT is true
495 // if this option is an inversion of the other one.
502       : option(#option__, dashes__, shortname__, "", helpstring__,	\
515     options::One_option option;						\
522       : option((dashes__ == options::DASH_Z				\
538     options::One_option option;						\
543 // option.  This option becomes an alias for that one.
550       : option(#option__, dashes__, shortname__, "", helpstring__,	\
564     options::One_option option;						\
572 // helparg__ should be NULL iff this special-option is a boolean.
576   void parse_##varname__(const char* option, const char* arg,           \
588 // An option that takes an optional string argument.  If the option is
662   // NOTE: For every option that you add here, also consider if you
672   // the alphabet, we show the option whose shortname is that letter
828   // Alphabetized under 'e' because the option is spelled --enable-new-dtags.
896 		N_("Ignored for GCC linker option compatibility"),
978 		    "(files preceding this option)"), NULL);
1119 		 N_("Pass an option to the plugin"), N_("OPTION"));
1580   // The --demangle option takes an optional string, and there is also
1581   // a --no-demangle option.  This is the best way to decide whether
1632   // --incremental-unchanged or --incremental-unknown option.  The
1643   // first --incremental-changed, etc. option).
1654   // the --section-start option, return true and set *PADDR to the
1659   // Return whether any --section-start option was used.
1789   // Add a plugin option.
1817   // --incremental-unchanged or --incremental-unknown option.  The
1841   // Orphan handling option, decoded to an enum value.
1848 // --no-whole-archive," we want to store the whole-archive option with
2196   // Start a group (the --start-group option).
2200   // End a group (the --end-group option).
2204   // Start a lib (the --start-lib option).
2208   // End a lib (the --end-lib option).
2272   // appropriate error message if an unrecognized option is seen.
2276   // Process one command-line option.  This takes the index of argv to
2277   // process, and returns the index for the next option.  no_more_options