-/* Parse command line arguments for bison.
- Copyright 1984, 1986, 1989, 1992, 2000 Free Software Foundation, Inc.
+/* Parse command line arguments for Bison.
+
+ Copyright (C) 1984, 1986, 1989, 1992, 2000, 2001, 2002, 2003, 2004,
+ 2005, 2006 Free Software Foundation, Inc.
This file is part of Bison, the GNU Compiler Compiler.
You should have received a copy of the GNU General Public License
along with Bison; see the file COPYING. If not, write to the Free
- Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
- 02111-1307, USA. */
+ Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ 02110-1301, USA. */
-#include <stdio.h>
-#include "getopt.h"
+#include <config.h>
#include "system.h"
+#include "revision.h"
+
+#include <argmatch.h>
+#include <error.h>
+
+/* Hack to get <getopt.h> to declare getopt with a prototype. */
+#if lint && ! defined __GNU_LIBRARY__
+# define __GNU_LIBRARY__
+# define HACK_FOR___GNU_LIBRARY___PROTOTYPE 1
+#endif
+
+#include <getopt.h>
+
+#ifdef HACK_FOR___GNU_LIBRARY___PROTOTYPE
+# undef __GNU_LIBRARY__
+# undef HACK_FOR___GNU_LIBRARY___PROTOTYPE
+#endif
+
+#include "complain.h"
#include "files.h"
#include "getargs.h"
+#include "uniqstr.h"
-int debug_flag = 0;
-int defines_flag = 0;
-int locations_flag = 0;
-int no_lines_flag = 0;
-int no_parser_flag = 0;
-int raw_flag = 0;
-int token_table_flag = 0;
-int verbose_flag = 0;
-int statistics_flag = 0;
-int yacc_flag = 0; /* for -y */
+bool debug_flag;
+bool defines_flag;
+bool graph_flag;
+bool locations_flag;
+bool no_lines_flag;
+bool no_parser_flag;
+bool token_table_flag;
+bool yacc_flag; /* for -y */
+
+bool error_verbose = false;
+
+bool nondeterministic_parser = false;
+bool glr_parser = false;
+bool pure_parser = false;
+
+int report_flag = report_none;
+int trace_flag = trace_none;
+int warnings_flag = warnings_none;
+
+const char *skeleton = NULL;
+const char *include = NULL;
extern char *program_name;
-const char *shortopts = "yvdhrltknVo:b:p:";
-static struct option longopts[] =
+
+
+/** Decode an option's set of keys.
+ *
+ * \param option option being decoded.
+ * \paran keys array of valid subarguments.
+ * \param values array of corresponding (int) values.
+ * \param flag the flags to update
+ * \param args colon separated list of effective subarguments to decode.
+ * If 0, then activate all the flags.
+ *
+ * The special value 0 resets the flags to 0.
+ */
+static void
+flags_argmatch (const char *option,
+ const char * const keys[], const int values[],
+ int *flags, char *args)
{
- /* Operation modes. */
- {"help", no_argument, 0, 'h'},
- {"version", no_argument, 0, 'V'},
- {"yacc", no_argument, 0, 'y'},
- {"fixed-output-files",no_argument, 0, 'y'},
+ if (args)
+ {
+ args = strtok (args, ",");
+ do
+ {
+ int value = XARGMATCH (option, args, keys, values);
+ if (value == 0)
+ *flags = 0;
+ else
+ *flags |= value;
+ }
+ while ((args = strtok (NULL, ",")));
+ }
+ else
+ *flags = ~0;
+}
- /* Parser. */
- {"locations", no_argument, &locations_flag, 1},
- /* was 'a'; apparently unused -wjh */
- {"name-prefix", required_argument, 0, 'p'},
- {"no-lines", no_argument, 0, 'l'},
- {"no-parser", no_argument, 0, 'n'},
- {"raw", no_argument, 0, 'r'},
- {"token-table", no_argument, 0, 'k'},
- {"debug", no_argument, 0, 'd'},
+/** Decode a set of sub arguments.
+ *
+ * \param FlagName the flag familly to update.
+ * \param args the effective sub arguments to decode.
+ *
+ * \arg FlagName_args the list of keys.
+ * \arg FlagName_types the list of values.
+ * \arg FlagName_flag the flag to update.
+ */
+#define FLAGS_ARGMATCH(FlagName, Args) \
+ flags_argmatch ("--" #FlagName, FlagName ## _args, FlagName ## _types, \
+ &FlagName ## _flag, Args)
- /* Output. */
- {"defines", no_argument, 0, 'd'},
- {"verbose", no_argument, 0, 'v'},
- {"file-prefix", required_argument, 0, 'b'},
- {"output-file", required_argument, 0, 'o'},
- /* Hidden. */
- {"statistics", no_argument, &statistics_flag, 1},
- {0, 0, 0, 0}
+/*----------------------.
+| --report's handling. |
+`----------------------*/
+
+static const char * const report_args[] =
+{
+ /* In a series of synonyms, present the most meaningful first, so
+ that argmatch_valid be more readable. */
+ "none",
+ "state", "states",
+ "itemset", "itemsets",
+ "lookahead", "lookaheads", "look-ahead",
+ "solved",
+ "all",
+ 0
+};
+
+static const int report_types[] =
+{
+ report_none,
+ report_states, report_states,
+ report_states | report_itemsets, report_states | report_itemsets,
+ report_states | report_lookahead_tokens,
+ report_states | report_lookahead_tokens,
+ report_states | report_lookahead_tokens,
+ report_states | report_solved_conflicts,
+ report_all
+};
+
+ARGMATCH_VERIFY (report_args, report_types);
+
+
+/*---------------------.
+| --trace's handling. |
+`---------------------*/
+
+static const char * const trace_args[] =
+{
+ /* In a series of synonyms, present the most meaningful first, so
+ that argmatch_valid be more readable. */
+ "none - no traces",
+ "scan - grammar scanner traces",
+ "parse - grammar parser traces",
+ "automaton - construction of the automaton",
+ "bitsets - use of bitsets",
+ "grammar - reading, reducing the grammar",
+ "resource - memory consumption (where available)",
+ "sets - grammar sets: firsts, nullable etc.",
+ "tools - m4 invocation",
+ "m4 - m4 traces",
+ "skeleton - skeleton postprocessing",
+ "time - time consumption",
+ "all - all of the above",
+ 0
+};
+
+static const int trace_types[] =
+{
+ trace_none,
+ trace_scan,
+ trace_parse,
+ trace_automaton,
+ trace_bitsets,
+ trace_grammar,
+ trace_resource,
+ trace_sets,
+ trace_tools,
+ trace_m4,
+ trace_skeleton,
+ trace_time,
+ trace_all
};
-/*---------------------------.
-| Display the help message. |
-`---------------------------*/
+ARGMATCH_VERIFY (trace_args, trace_types);
+
+
+/*------------------------.
+| --warnings's handling. |
+`------------------------*/
+
+static const char * const warnings_args[] =
+{
+ /* In a series of synonyms, present the most meaningful first, so
+ that argmatch_valid be more readable. */
+ "none - no warnings",
+ "error - warnings are errors",
+ "yacc - incompatibilities with POSIX YACC",
+ "all - all of the above",
+ 0
+};
+
+static const int warnings_types[] =
+{
+ warnings_none,
+ warnings_error,
+ warnings_yacc,
+ warnings_all
+};
+
+ARGMATCH_VERIFY (warnings_args, warnings_types);
+
+
+/*-------------------------------------------.
+| Display the help message and exit STATUS. |
+`-------------------------------------------*/
+
+static void usage (int) ATTRIBUTE_NORETURN;
static void
-usage (FILE *stream)
+usage (int status)
{
- /* Some efforts were made to ease the translators' task, please
- continue. */
- fputs (_("\
-GNU bison generates parsers for LALR(1) grammars.\n"), stream);
- putc ('\n', stream);
+ if (status != 0)
+ fprintf (stderr, _("Try `%s --help' for more information.\n"),
+ program_name);
+ else
+ {
+ /* Some efforts were made to ease the translators' task, please
+ continue. */
+ fputs (_("\
+GNU bison generates LALR(1) and GLR parsers.\n"), stdout);
+ putc ('\n', stdout);
- fprintf (stream, _("\
+ fprintf (stdout, _("\
Usage: %s [OPTION]... FILE\n"), program_name);
- putc ('\n', stream);
+ putc ('\n', stdout);
- fputs (_("\
+ fputs (_("\
If a long option shows an argument as mandatory, then it is mandatory\n\
for the equivalent short option also. Similarly for optional arguments.\n"),
- stream);
- putc ('\n', stream);
+ stdout);
+ putc ('\n', stdout);
- fputs (_("\
+ fputs (_("\
Operation modes:\n\
- -h, --help display this help and exit\n\
- -V, --version output version information and exit\n\
- -y, --yacc emulate POSIX yacc\n"), stream);
- putc ('\n', stream);
+ -h, --help display this help and exit\n\
+ -V, --version output version information and exit\n\
+ --print-localedir output directory containing locale-dependent data\n\
+ -y, --yacc emulate POSIX Yacc\n"), stdout);
+ putc ('\n', stdout);
- fputs (_("\
+ fputs (_("\
Parser:\n\
+ -S, --skeleton=FILE specify the skeleton to use\n\
-t, --debug instrument the parser for debugging\n\
--locations enable locations computation\n\
-p, --name-prefix=PREFIX prepend PREFIX to the external symbols\n\
-l, --no-lines don't generate `#line' directives\n\
-n, --no-parser generate the tables only\n\
- -r, --raw number the tokens from 3\n\
-k, --token-table include a table of token names\n\
-"), stream);
- putc ('\n', stream);
+"), stdout);
+ putc ('\n', stdout);
- fputs (_("\
+ fputs (_("\
Output:\n\
-d, --defines also produce a header file\n\
- -v, --verbose also produce an explanation of the automaton\n\
+ -r, --report=THINGS also produce details on the automaton\n\
+ -v, --verbose same as `--report=state'\n\
-b, --file-prefix=PREFIX specify a PREFIX for output files\n\
- -o, --output-file=FILE leave output to FILE\n"), stream);
- putc ('\n', stream);
+ -o, --output=FILE leave output to FILE\n\
+ -g, --graph also produce a VCG description of the automaton\n\
+"), stdout);
+ putc ('\n', stdout);
+
+ fputs (_("\
+THINGS is a list of comma separated words that can include:\n\
+ `state' describe the states\n\
+ `itemset' complete the core item sets with their closure\n\
+ `lookahead' explicitly associate lookahead tokens to items\n\
+ `solved' describe shift/reduce conflicts solving\n\
+ `all' include all the above information\n\
+ `none' disable the report\n\
+"), stdout);
+ putc ('\n', stdout);
+
+ fputs (_("\
+Report bugs to <" PACKAGE_BUGREPORT ">.\n"), stdout);
+ }
- fputs (_("\
-Report bugs to <bug-bison@gnu.org>.\n"), stream);
+ exit (status);
}
`------------------------------*/
static void
-version (FILE *stream)
+version (void)
{
/* Some efforts were made to ease the translators' task, please
continue. */
- fprintf (stream, _("\
-bison (GNU Bison) %s"), VERSION);
- putc ('\n', stream);
- putc ('\n', stream);
+ printf (_("bison (GNU Bison) %s"), VERSION);
+ putc ('\n', stdout);
+ printf ("%s", revision);
+ fputs (_("Written by Robert Corbett and Richard Stallman.\n"), stdout);
+ putc ('\n', stdout);
- fputs (_("\
-Copyright 1984, 1986, 1989, 1992, 2000 Free Software Foundation, Inc.\n"),
- stream);
+ fprintf (stdout,
+ _("Copyright (C) %d Free Software Foundation, Inc.\n"), 2006);
fputs (_("\
This is free software; see the source for copying conditions. There is NO\n\
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\
"),
- stream);
+ stdout);
}
| Process the options. |
`----------------------*/
+/* Shorts options. */
+static char const short_options[] = "yvegdhr:ltknVo:b:p:S:T::W";
+
+/* Values for long options that do not have single-letter equivalents. */
+enum
+{
+ LOCATIONS_OPTION = CHAR_MAX + 1,
+ PRINT_LOCALEDIR_OPTION
+};
+
+static struct option const long_options[] =
+{
+ /* Operation modes. */
+ { "help", no_argument, 0, 'h' },
+ { "version", no_argument, 0, 'V' },
+ { "print-localedir", no_argument, 0, PRINT_LOCALEDIR_OPTION },
+ { "warnings", optional_argument, 0, 'W' },
+
+ /* Parser. */
+ { "name-prefix", required_argument, 0, 'p' },
+ { "include", required_argument, 0, 'I' },
+
+ /* Output. */
+ { "file-prefix", required_argument, 0, 'b' },
+ { "output", required_argument, 0, 'o' },
+ { "output-file", required_argument, 0, 'o' },
+ { "graph", optional_argument, 0, 'g' },
+ { "report", required_argument, 0, 'r' },
+ { "verbose", no_argument, 0, 'v' },
+
+ /* Hidden. */
+ { "trace", optional_argument, 0, 'T' },
+
+ /* Output. */
+ { "defines", optional_argument, 0, 'd' },
+
+ /* Operation modes. */
+ { "fixed-output-files", no_argument, 0, 'y' },
+ { "yacc", no_argument, 0, 'y' },
+
+ /* Parser. */
+ { "debug", no_argument, 0, 't' },
+ { "locations", no_argument, 0, LOCATIONS_OPTION },
+ { "no-lines", no_argument, 0, 'l' },
+ { "no-parser", no_argument, 0, 'n' },
+ { "raw", no_argument, 0, 0 },
+ { "skeleton", required_argument, 0, 'S' },
+ { "token-table", no_argument, 0, 'k' },
+
+ {0, 0, 0, 0}
+};
+
+/* Under DOS, there is no difference on the case. This can be
+ troublesome when looking for `.tab' etc. */
+#ifdef MSDOS
+# define AS_FILE_NAME(File) (strlwr (File), (File))
+#else
+# define AS_FILE_NAME(File) (File)
+#endif
+
void
getargs (int argc, char *argv[])
{
int c;
- while ((c = getopt_long (argc, argv, "yvdhrltknVo:b:p:", longopts, (int *)0))
- != EOF)
- {
- switch (c)
- {
- case 0:
- /* Certain long options cause getopt_long to return 0. */
- break;
-
- case 'y':
- yacc_flag = 1;
- break;
-
- case 'h':
- usage (stdout);
- exit (0);
-
- case 'V':
- version (stdout);
- exit (0);
-
- case 'v':
- verbose_flag = 1;
- break;
-
- case 'd':
- defines_flag = 1;
- break;
-
- case 'l':
- no_lines_flag = 1;
- break;
-
- case 'k':
- token_table_flag = 1;
- break;
-
- case 'r':
- raw_flag = 1;
- break;
-
- case 'n':
- no_parser_flag = 1;
- break;
-
- case 't':
- debug_flag = 1;
- break;
-
- case 'o':
- spec_outfile = optarg;
- break;
-
- case 'b':
- spec_file_prefix = optarg;
- break;
-
- case 'p':
- spec_name_prefix = optarg;
- break;
-
- default:
- fprintf (stderr, _("Try `%s --help' for more information.\n"),
- program_name);
- exit (1);
- }
- }
-
- if (optind == argc)
+ while ((c = getopt_long (argc, argv, short_options, long_options, NULL))
+ != -1)
+ switch (c)
+ {
+ case 0:
+ /* Certain long options cause getopt_long to return 0. */
+ break;
+
+ case 'b':
+ spec_file_prefix = AS_FILE_NAME (optarg);
+ break;
+
+ case 'g':
+ /* Here, the -g and --graph=FILE options are differentiated. */
+ graph_flag = true;
+ if (optarg)
+ spec_graph_file = AS_FILE_NAME (optarg);
+ break;
+
+ case 'h':
+ usage (EXIT_SUCCESS);
+
+ case 'S':
+ skeleton = AS_FILE_NAME (optarg);
+ break;
+
+ case 'I':
+ include = AS_FILE_NAME (optarg);
+ break;
+
+ case 'd':
+ /* Here, the -d and --defines options are differentiated. */
+ defines_flag = true;
+ if (optarg)
+ spec_defines_file = AS_FILE_NAME (optarg);
+ break;
+
+ case 'k':
+ token_table_flag = true;
+ break;
+
+ case 'l':
+ no_lines_flag = true;
+ break;
+
+ case 'n':
+ no_parser_flag = true;
+ break;
+
+ case 'o':
+ spec_outfile = AS_FILE_NAME (optarg);
+ break;
+
+ case 'p':
+ spec_name_prefix = optarg;
+ break;
+
+ case 'r':
+ FLAGS_ARGMATCH (report, optarg);
+ break;
+
+ case 'T':
+ FLAGS_ARGMATCH (trace, optarg);
+ break;
+
+ case 't':
+ debug_flag = true;
+ break;
+
+ case 'V':
+ version ();
+ exit (EXIT_SUCCESS);
+
+ case 'v':
+ report_flag |= report_states;
+ break;
+
+ case 'y':
+ yacc_flag = true;
+ break;
+
+ case 'W':
+ FLAGS_ARGMATCH (warnings, optarg);
+ break;
+
+ case LOCATIONS_OPTION:
+ locations_flag = true;
+ break;
+
+ case PRINT_LOCALEDIR_OPTION:
+ printf ("%s\n", LOCALEDIR);
+ exit (EXIT_SUCCESS);
+
+ default:
+ usage (EXIT_FAILURE);
+ }
+
+ if (argc - optind != 1)
{
- fprintf (stderr, _("%s: no grammar file given\n"), program_name);
- exit (1);
+ if (argc - optind < 1)
+ error (0, 0, _("missing operand after `%s'"), argv[argc - 1]);
+ else
+ error (0, 0, _("extra operand `%s'"), argv[optind + 1]);
+ usage (EXIT_FAILURE);
}
- if (optind < argc - 1)
- fprintf (stderr, _("%s: extra arguments ignored after `%s'\n"),
- program_name, argv[optind]);
- infile = argv[optind];
+ current_file = grammar_file = uniqstr_new (argv[optind]);
}