]>
git.saurik.com Git - bison.git/blob - src/getargs.c
dbea65d5a499bd831e45fdd99153401fd2ff05ae
1 /* Parse command line arguments for Bison.
3 Copyright (C) 1984, 1986, 1989, 1992, 2000-2013 Free Software
6 This file is part of Bison, the GNU Compiler Compiler.
8 This program is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
26 #include <c-strcase.h>
27 #include <configmake.h>
35 #include "muscle-tab.h"
43 bool token_table_flag
;
44 bool yacc_flag
; /* for -y */
46 bool nondeterministic_parser
= false;
47 bool glr_parser
= false;
49 int feature_flag
= feature_caret
;
50 int report_flag
= report_none
;
51 int trace_flag
= trace_none
;
53 static struct bison_language
const valid_languages
[] = {
54 { "c", "c-skel.m4", ".c", ".h", true },
55 { "c++", "c++-skel.m4", ".cc", ".hh", true },
56 { "java", "java-skel.m4", ".java", ".java", false },
57 { "", "", "", "", false }
60 int skeleton_prio
= default_prio
;
61 const char *skeleton
= NULL
;
62 int language_prio
= default_prio
;
63 struct bison_language
const *language
= &valid_languages
[0];
64 const char *include
= NULL
;
66 /** Decode an option's key.
68 * \param option option being decoded.
69 * \param keys array of valid subarguments.
70 * \param values array of corresponding (int) values.
71 * \param all the all value.
72 * \param flags the flags to update
73 * \param arg the subarguments to decode.
74 * If null, then activate all the flags.
75 * \param no length of the potential "no-" prefix.
76 * Can be 0 or 3. If 3, negate the action of the subargument.
78 * If VALUE != 0 then KEY sets flags and no-KEY clears them.
79 * If VALUE == 0 then KEY clears all flags from \c all and no-KEY sets all
80 * flags from \c all. Thus no-none = all and no-all = none.
83 flag_argmatch (const char *option
,
84 const char * const keys
[], const int values
[],
85 int all
, int *flags
, char *arg
, size_t no
)
88 value
= XARGMATCH (option
, arg
+ no
, keys
, values
);
106 /** Decode an option's set of keys.
108 * \param option option being decoded.
109 * \param keys array of valid subarguments.
110 * \param values array of corresponding (int) values.
111 * \param all the all value.
112 * \param flags the flags to update
113 * \param args comma separated list of effective subarguments to decode.
114 * If 0, then activate all the flags.
117 flags_argmatch (const char *option
,
118 const char * const keys
[], const int values
[],
119 int all
, int *flags
, char *args
)
122 for (args
= strtok (args
, ","); args
; args
= strtok (NULL
, ","))
124 size_t no
= STRPREFIX_LIT ("no-", args
) ? 3 : 0;
125 flag_argmatch (option
, keys
,
126 values
, all
, flags
, args
, no
);
133 /** Decode a set of sub arguments.
135 * \param FlagName the flag familly to update.
136 * \param Args the effective sub arguments to decode.
137 * \param All the "all" value.
139 * \arg FlagName_args the list of keys.
140 * \arg FlagName_types the list of values.
141 * \arg FlagName_flag the flag to update.
143 #define FLAGS_ARGMATCH(FlagName, Args, All) \
144 flags_argmatch ("--" #FlagName, FlagName ## _args, FlagName ## _types, \
145 All, &FlagName ## _flag, Args)
148 /*----------------------.
149 | --report's handling. |
150 `----------------------*/
152 static const char * const report_args
[] =
154 /* In a series of synonyms, present the most meaningful first, so
155 that argmatch_valid be more readable. */
158 "itemset", "itemsets",
159 "lookahead", "lookaheads", "look-ahead",
165 static const int report_types
[] =
168 report_states
, report_states
,
169 report_states
| report_itemsets
, report_states
| report_itemsets
,
170 report_states
| report_lookahead_tokens
,
171 report_states
| report_lookahead_tokens
,
172 report_states
| report_lookahead_tokens
,
173 report_states
| report_solved_conflicts
,
177 ARGMATCH_VERIFY (report_args
, report_types
);
180 /*---------------------.
181 | --trace's handling. |
182 `---------------------*/
184 static const char * const trace_args
[] =
187 "scan - grammar scanner traces",
188 "parse - grammar parser traces",
189 "automaton - construction of the automaton",
190 "bitsets - use of bitsets",
191 "grammar - reading, reducing the grammar",
192 "resource - memory consumption (where available)",
193 "sets - grammar sets: firsts, nullable etc.",
194 "muscles - m4 definitions passed to the skeleton",
195 "tools - m4 invocation",
197 "skeleton - skeleton postprocessing",
198 "time - time consumption",
199 "ielr - IELR conversion",
200 "all - all of the above",
204 static const int trace_types
[] =
223 ARGMATCH_VERIFY (trace_args
, trace_types
);
226 /*------------------------.
227 | --warnings's handling. |
228 `------------------------*/
230 /** Decode a single argument from -W.
232 * \param option option being decoded.
233 * \param keys array of valid subarguments.
234 * \param values array of corresponding (int) values.
235 * \param all the all value.
236 * \param flags the flags to update
237 * \param arg the subarguments to decode.
238 * If null, then activate all the flags.
239 * \param no length of the potential "no-" prefix.
240 * Can be 0 or 3. If 3, negate the action of the subargument.
241 * \param err length of a potential "error=".
242 * Can be 0 or 6. If 6, treat the subargument as a CATEGORY
244 * If VALUE != 0 then KEY sets flags and no-KEY clears them.
245 * If VALUE == 0 then KEY clears all flags from \c all and no-KEY sets all
246 * flags from \c all. Thus no-none = all and no-all = none.
249 warning_argmatch (const char *option
,
250 const char * const keys
[], const int values
[],
251 int all
, int *flags
, char *arg
, size_t no
, size_t err
)
254 if (!err
|| arg
[no
+ err
++] != '\0')
255 value
= XARGMATCH (option
, arg
+ no
+ err
, keys
, values
);
264 warnings_flag
|= value
;
270 /* With a simpler 'if (no)' version, -Werror means -Werror=all
271 (or rather, -Werror=no-none, but that syntax is invalid).
273 - Werror activates all errors, but not the warnings
274 - Werror=all activates errors, and all warnings */
282 /** Decode a comma-separated list of arguments from -W.
284 * \param option option being decoded.
285 * \param keys array of valid subarguments.
286 * \param values array of corresponding (int) values.
287 * \param all the all value.
288 * \param flags the flags to update
289 * \param args comma separated list of effective subarguments to decode.
290 * If 0, then activate all the flags.
293 warnings_argmatch (const char *option
,
294 const char * const keys
[], const int values
[],
295 int all
, int *flags
, char *args
)
298 for (args
= strtok (args
, ","); args
; args
= strtok (NULL
, ","))
300 size_t no
= STRPREFIX_LIT ("no-", args
) ? 3 : 0;
301 size_t err
= STRPREFIX_LIT ("error", args
+ no
) ? 5 : 0;
303 warning_argmatch (option
, keys
,
304 values
, all
, err
? &errors_flag
: flags
,
311 /** Decode a set of sub arguments.
313 * \param FlagName the flag familly to update.
314 * \param Args the effective sub arguments to decode.
315 * \param All the "all" value.
317 * \arg FlagName_args the list of keys.
318 * \arg FlagName_types the list of values.
319 * \arg FlagName_flag the flag to update.
321 #define WARNINGS_ARGMATCH(FlagName, Args, All) \
322 warnings_argmatch ("--" #FlagName, FlagName ## _args, FlagName ## _types, \
323 All, &FlagName ## _flag, Args)
325 const char * const warnings_args
[] =
340 const int warnings_types
[] =
354 ARGMATCH_VERIFY (warnings_args
, warnings_types
);
356 /*-----------------------.
357 | --feature's handling. |
358 `-----------------------*/
360 static const char * const feature_args
[] =
363 "caret", "diagnostics-show-caret",
368 static const int feature_types
[] =
371 feature_caret
, feature_caret
,
375 ARGMATCH_VERIFY (feature_args
, feature_types
);
377 /*-------------------------------------------.
378 | Display the help message and exit STATUS. |
379 `-------------------------------------------*/
381 static void usage (int) ATTRIBUTE_NORETURN
;
387 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
391 /* For ../build-aux/cross-options.pl to work, use the format:
392 ^ -S, --long[=ARGS] (whitespace)
393 A --long option is required.
394 Otherwise, add exceptions to ../build-aux/cross-options.pl. */
396 printf (_("Usage: %s [OPTION]... FILE\n"), program_name
);
398 Generate a deterministic LR or generalized LR (GLR) parser employing\n\
399 LALR(1), IELR(1), or canonical LR(1) parser tables. IELR(1) and\n\
400 canonical LR(1) support is experimental.\n\
405 Mandatory arguments to long options are mandatory for short options too.\n\
408 The same is true for optional arguments.\n\
414 -h, --help display this help and exit\n\
415 -V, --version output version information and exit\n\
416 --print-localedir output directory containing locale-dependent data\n\
417 --print-datadir output directory containing skeletons and XSLT\n\
418 -y, --yacc emulate POSIX Yacc\n\
419 -W, --warnings[=CATEGORY] report the warnings falling in CATEGORY\n\
420 -f, --feature[=FEATURE] activate miscellaneous features\n\
426 -L, --language=LANGUAGE specify the output programming language\n\
427 -S, --skeleton=FILE specify the skeleton to use\n\
428 -t, --debug instrument the parser for tracing\n\
429 same as `-Dparse.trace'\n\
430 --locations enable location support\n\
431 -D, --define=NAME[=VALUE] similar to '%define NAME \"VALUE\"'\n\
432 -F, --force-define=NAME[=VALUE] override '%define NAME \"VALUE\"'\n\
433 -p, --name-prefix=PREFIX prepend PREFIX to the external symbols\n\
434 deprecated by '-Dapi.prefix=PREFIX'\n\
435 -l, --no-lines don't generate '#line' directives\n\
436 -k, --token-table include a table of token names\n\
440 /* Keep -d and --defines separate so that ../build-aux/cross-options.pl
441 * won't assume that -d also takes an argument. */
444 --defines[=FILE] also produce a header file\n\
445 -d likewise but cannot specify FILE (for POSIX Yacc)\n\
446 -r, --report=THINGS also produce details on the automaton\n\
447 --report-file=FILE write report to FILE\n\
448 -v, --verbose same as `--report=state'\n\
449 -b, --file-prefix=PREFIX specify a PREFIX for output files\n\
450 -o, --output=FILE leave output to FILE\n\
451 -g, --graph[=FILE] also output a graph of the automaton\n\
452 -x, --xml[=FILE] also output an XML report of the automaton\n\
453 (the XML schema is experimental)\n\
458 Warning categories include:\n\
459 `midrule-values' unset or unused midrule values\n\
460 `yacc' incompatibilities with POSIX Yacc\n\
461 `conflicts-sr' S/R conflicts (enabled by default)\n\
462 `conflicts-rr' R/R conflicts (enabled by default)\n\
463 `deprecated' obsolete constructs\n\
464 `precedence' useless precedence and associativity\n\
465 `other' all other warnings (enabled by default)\n\
466 `all' all the warnings\n\
467 `no-CATEGORY' turn off warnings in CATEGORY\n\
468 `none' turn off all the warnings\n\
469 `error[=CATEGORY]' treat warnings as errors\n\
474 THINGS is a list of comma separated words that can include:\n\
475 `state' describe the states\n\
476 `itemset' complete the core item sets with their closure\n\
477 `lookahead' explicitly associate lookahead tokens to items\n\
478 `solved' describe shift/reduce conflicts solving\n\
479 `all' include all the above information\n\
480 `none' disable the report\n\
485 FEATURE is a list of comma separated words that can include:\n\
486 `caret' show errors with carets\n\
487 `all' all of the above\n\
488 `none' disable all of the above\n\
492 printf (_("Report bugs to <%s>.\n"), PACKAGE_BUGREPORT
);
493 printf (_("%s home page: <%s>.\n"), PACKAGE_NAME
, PACKAGE_URL
);
494 fputs (_("General help using GNU software: "
495 "<http://www.gnu.org/gethelp/>.\n"),
497 /* Don't output this redundant message for English locales.
498 Note we still output for 'C' so that it gets included in the
500 const char *lc_messages
= setlocale (LC_MESSAGES
, NULL
);
501 if (lc_messages
&& !STREQ (lc_messages
, "en_"))
502 /* TRANSLATORS: Replace LANG_CODE in this URL with your language
503 code <http://translationproject.org/team/LANG_CODE.html> to
504 form one of the URLs at http://translationproject.org/team/.
505 Otherwise, replace the entire URL with your translation team's
507 fputs (_("Report translation bugs to "
508 "<http://translationproject.org/team/>.\n"), stdout
);
509 fputs (_("For complete documentation, run: info bison.\n"), stdout
);
516 /*------------------------------.
517 | Display the version message. |
518 `------------------------------*/
523 /* Some efforts were made to ease the translators' task, please
525 printf (_("bison (GNU Bison) %s"), VERSION
);
527 fputs (_("Written by Robert Corbett and Richard Stallman.\n"), stdout
);
531 _("Copyright (C) %d Free Software Foundation, Inc.\n"),
532 PACKAGE_COPYRIGHT_YEAR
);
535 This is free software; see the source for copying conditions. There is NO\n\
536 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\
542 /*-------------------------------------.
543 | --skeleton and --language handling. |
544 `--------------------------------------*/
547 skeleton_arg (char const *arg
, int prio
, location loc
)
549 if (prio
< skeleton_prio
)
551 skeleton_prio
= prio
;
554 else if (prio
== skeleton_prio
)
555 complain (&loc
, complaint
,
556 _("multiple skeleton declarations are invalid"));
560 language_argmatch (char const *arg
, int prio
, location loc
)
564 if (prio
< language_prio
)
567 for (i
= 0; valid_languages
[i
].language
[0]; i
++)
568 if (c_strcasecmp (arg
, valid_languages
[i
].language
) == 0)
570 language_prio
= prio
;
571 language
= &valid_languages
[i
];
574 msg
= _("%s: invalid language");
576 else if (language_prio
== prio
)
577 msg
= _("multiple language declarations are invalid");
581 complain (&loc
, complaint
, msg
, quotearg_colon (arg
));
584 /*----------------------.
585 | Process the options. |
586 `----------------------*/
589 Should be computed from long_options. */
590 static char const short_options
[] =
616 /* Values for long options that do not have single-letter equivalents. */
619 LOCATIONS_OPTION
= CHAR_MAX
+ 1,
620 PRINT_LOCALEDIR_OPTION
,
621 PRINT_DATADIR_OPTION
,
625 static struct option
const long_options
[] =
627 /* Operation modes. */
628 { "help", no_argument
, 0, 'h' },
629 { "version", no_argument
, 0, 'V' },
630 { "print-localedir", no_argument
, 0, PRINT_LOCALEDIR_OPTION
},
631 { "print-datadir", no_argument
, 0, PRINT_DATADIR_OPTION
},
632 { "warnings", optional_argument
, 0, 'W' },
635 { "name-prefix", required_argument
, 0, 'p' },
636 { "include", required_argument
, 0, 'I' },
639 { "file-prefix", required_argument
, 0, 'b' },
640 { "output", required_argument
, 0, 'o' },
641 { "output-file", required_argument
, 0, 'o' },
642 { "graph", optional_argument
, 0, 'g' },
643 { "xml", optional_argument
, 0, 'x' },
644 { "report", required_argument
, 0, 'r' },
645 { "report-file", required_argument
, 0, REPORT_FILE_OPTION
},
646 { "verbose", no_argument
, 0, 'v' },
649 { "trace", optional_argument
, 0, 'T' },
652 { "defines", optional_argument
, 0, 'd' },
653 { "feature", optional_argument
, 0, 'f' },
655 /* Operation modes. */
656 { "fixed-output-files", no_argument
, 0, 'y' },
657 { "yacc", no_argument
, 0, 'y' },
660 { "debug", no_argument
, 0, 't' },
661 { "define", required_argument
, 0, 'D' },
662 { "force-define", required_argument
, 0, 'F' },
663 { "locations", no_argument
, 0, LOCATIONS_OPTION
},
664 { "no-lines", no_argument
, 0, 'l' },
665 { "raw", no_argument
, 0, 0 },
666 { "skeleton", required_argument
, 0, 'S' },
667 { "language", required_argument
, 0, 'L' },
668 { "token-table", no_argument
, 0, 'k' },
673 /* Under DOS, there is no difference on the case. This can be
674 troublesome when looking for `.tab' etc. */
676 # define AS_FILE_NAME(File) (strlwr (File), (File))
678 # define AS_FILE_NAME(File) (File)
681 /* Build a location for the current command line argument. */
684 command_line_location (void)
687 /* "<command line>" is used in GCC's messages about -D. */
688 boundary_set (&res
.start
, uniqstr_new ("<command line>"), optind
- 1, -1);
695 getargs (int argc
, char *argv
[])
699 while ((c
= getopt_long (argc
, argv
, short_options
, long_options
, NULL
))
703 /* ASCII Sorting for short options (i.e., upper case then
704 lower case), and then long-only options. */
707 /* Certain long options cause getopt_long to return 0. */
710 case 'D': /* -DNAME[=VALUE]. */
711 case 'F': /* -FNAME[=VALUE]. */
714 char* value
= strchr (optarg
, '=');
717 muscle_percent_define_insert (name
, command_line_location (),
719 c
== 'D' ? MUSCLE_PERCENT_DEFINE_D
720 : MUSCLE_PERCENT_DEFINE_F
);
725 include
= AS_FILE_NAME (optarg
);
729 language_argmatch (optarg
, command_line_prio
,
730 command_line_location ());
734 skeleton_arg (AS_FILE_NAME (optarg
), command_line_prio
,
735 command_line_location ());
739 FLAGS_ARGMATCH (trace
, optarg
, trace_all
);
747 FLAGS_ARGMATCH (feature
, optarg
, feature_all
);
751 WARNINGS_ARGMATCH (warnings
, optarg
, Wall
);
755 spec_file_prefix
= AS_FILE_NAME (optarg
);
759 /* Here, the -d and --defines options are differentiated. */
763 free (spec_defines_file
);
764 spec_defines_file
= xstrdup (AS_FILE_NAME (optarg
));
772 free (spec_graph_file
);
773 spec_graph_file
= xstrdup (AS_FILE_NAME (optarg
));
778 usage (EXIT_SUCCESS
);
781 token_table_flag
= true;
785 no_lines_flag
= true;
789 spec_outfile
= AS_FILE_NAME (optarg
);
793 spec_name_prefix
= optarg
;
797 FLAGS_ARGMATCH (report
, optarg
, report_all
);
801 muscle_percent_define_insert ("parse.trace",
802 command_line_location (), "",
803 MUSCLE_PERCENT_DEFINE_D
);
807 report_flag
|= report_states
;
814 free (spec_xml_file
);
815 spec_xml_file
= xstrdup (AS_FILE_NAME (optarg
));
820 warnings_flag
|= Wyacc
;
821 errors_flag
|= Wyacc
;
825 case LOCATIONS_OPTION
:
826 muscle_percent_define_ensure ("locations",
827 command_line_location (), true);
830 case PRINT_LOCALEDIR_OPTION
:
831 printf ("%s\n", LOCALEDIR
);
834 case PRINT_DATADIR_OPTION
:
835 printf ("%s\n", pkgdatadir ());
838 case REPORT_FILE_OPTION
:
839 free (spec_verbose_file
);
840 spec_verbose_file
= xstrdup (AS_FILE_NAME (optarg
));
844 usage (EXIT_FAILURE
);
847 if (argc
- optind
!= 1)
849 if (argc
- optind
< 1)
850 error (0, 0, _("%s: missing operand"), quotearg_colon (argv
[argc
- 1]));
852 error (0, 0, _("extra operand %s"), quote (argv
[optind
+ 1]));
853 usage (EXIT_FAILURE
);
856 current_file
= grammar_file
= uniqstr_new (argv
[optind
]);
857 MUSCLE_INSERT_C_STRING ("file_name", grammar_file
);
861 tr (char *s
, char from
, char to
)