mirror of
https://git.savannah.gnu.org/git/bison.git
synced 2026-03-10 12:53:03 +00:00
When reporting useless rules and nonterminals, say "useless in grammar" instead of "useless", and say "useless in parser" instead of "never reduced". Discussed starting at <http://lists.gnu.org/archive/html/bison-patches/2007-10/msg00033.html>. * NEWS (2.3a+): Mention this change. * data/xslt/xml2text.xsl: Update output text and expected input XML element names to match changes below. * data/xslt/xml2xhtml.xsl: Likewise. (xsl:template match="bison-xml-report"): Add missing entry in Table of Contents: "Rules useless in parser due to conflicts". * doc/bison.texinfo (Decl Summary): Reword a little. (Understanding): Update example output for changes below. * src/gram.c: (rule_useful_p): Rename to... (rule_useful_in_grammar_p): ... this. (rule_useless_p): Rename to... (rule_useless_in_grammar_p): ... this. (rule_never_reduced_p): Rename to... (rule_useless_in_parser_p): ... this. (grammar_rules_print): Update for renames. (grammar_rules_print_xml): Update for renames. (grammar_rules_never_reduced_report): Rename to... (grammar_rules_useless_report): ... this since it is used for either kind of useless rule. * src/gram.h: Reword comments and update function names in prototypes. * src/main.c (main): Say "rule useless in parser due to conflicts". * src/print-xml.c (print_rules_never_reduced): Rename to... (print_rules_useless_in_parser): ... this, and rename output XML element "rules-never-reduced" to "rules-useless-in-parser". (print_xml): Update for rename. * src/print.c (print_results): Say "Rules useless in parser due to conflicts". * src/reduce.c (reduce_grammar_tables): Say "rule useless in grammar". (nonterminals_reduce): Say "nonterminal useless in grammar". (reduce_output): Say "Nonterminals useless in grammar". Say "Rules useless in grammar". (reduce_xml): Rename output XML element "useless" to "useless-in-grammar". (reduce_print): Don't report the count of grammatically useless rules as "rules never reduced" just because %yacc is specified. In the correct report of this count, say nonterminal(s) and rule(s) "useless in grammar". * tests/conflicts.at (S/R in initial): Update expected output. (Defaulted Conflicted Reduction): Likewise. (Unreachable States After Conflict Resolution): Likewise. * tests/existing.at (GNU pic Grammar): Likewise. * tests/reduce.at (Useless Nonterminals): Likewise. (Useless Rules): Likewise. (Reduced Automaton): Likewise. (Underivable Rules): Likewise. (Empty Language): Likewise.
328 lines
7.2 KiB
C
328 lines
7.2 KiB
C
/* Allocate input grammar variables for Bison.
|
|
|
|
Copyright (C) 1984, 1986, 1989, 2001, 2002, 2003, 2005, 2006
|
|
2007 Free Software Foundation, Inc.
|
|
|
|
This file is part of Bison, the GNU Compiler Compiler.
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#include <config.h>
|
|
#include "system.h"
|
|
|
|
#include <quotearg.h>
|
|
|
|
#include "gram.h"
|
|
#include "reader.h"
|
|
#include "reduce.h"
|
|
#include "symtab.h"
|
|
#include "print-xml.h"
|
|
|
|
/* Comments for these variables are in gram.h. */
|
|
|
|
item_number *ritem = NULL;
|
|
unsigned int nritems = 0;
|
|
|
|
rule *rules = NULL;
|
|
rule_number nrules = 0;
|
|
|
|
symbol **symbols = NULL;
|
|
int nsyms = 0;
|
|
int ntokens = 1;
|
|
int nvars = 0;
|
|
|
|
symbol_number *token_translations = NULL;
|
|
|
|
int max_user_token_number = 256;
|
|
|
|
bool
|
|
rule_useful_in_grammar_p (rule *r)
|
|
{
|
|
return r->number < nrules;
|
|
}
|
|
|
|
bool
|
|
rule_useless_in_grammar_p (rule *r)
|
|
{
|
|
return !rule_useful_in_grammar_p (r);
|
|
}
|
|
|
|
bool
|
|
rule_useless_in_parser_p (rule *r)
|
|
{
|
|
return !r->useful && rule_useful_in_grammar_p (r);
|
|
}
|
|
|
|
void
|
|
rule_lhs_print (rule *r, symbol *previous_lhs, FILE *out)
|
|
{
|
|
fprintf (out, " %3d ", r->number);
|
|
if (previous_lhs != r->lhs)
|
|
{
|
|
fprintf (out, "%s:", r->lhs->tag);
|
|
}
|
|
else
|
|
{
|
|
int n;
|
|
for (n = strlen (previous_lhs->tag); n > 0; --n)
|
|
fputc (' ', out);
|
|
fputc ('|', out);
|
|
}
|
|
}
|
|
|
|
void
|
|
rule_lhs_print_xml (rule *r, FILE *out, int level)
|
|
{
|
|
xml_printf (out, level, "<lhs>%s</lhs>", r->lhs->tag);
|
|
}
|
|
|
|
int
|
|
rule_rhs_length (rule *r)
|
|
{
|
|
int res = 0;
|
|
item_number *rhsp;
|
|
for (rhsp = r->rhs; *rhsp >= 0; ++rhsp)
|
|
++res;
|
|
return res;
|
|
}
|
|
|
|
void
|
|
rule_rhs_print (rule *r, FILE *out)
|
|
{
|
|
if (*r->rhs >= 0)
|
|
{
|
|
item_number *rp;
|
|
for (rp = r->rhs; *rp >= 0; rp++)
|
|
fprintf (out, " %s", symbols[*rp]->tag);
|
|
fputc ('\n', out);
|
|
}
|
|
else
|
|
{
|
|
fprintf (out, " /* %s */\n", _("empty"));
|
|
}
|
|
}
|
|
|
|
static void
|
|
rule_rhs_print_xml (rule *r, FILE *out, int level)
|
|
{
|
|
if (*r->rhs >= 0)
|
|
{
|
|
item_number *rp;
|
|
xml_puts (out, level, "<rhs>");
|
|
for (rp = r->rhs; *rp >= 0; rp++)
|
|
xml_printf (out, level + 1, "<symbol class=\"%s\">%s</symbol>",
|
|
symbol_class_get_string (symbols[*rp]),
|
|
xml_escape (symbols[*rp]->tag));
|
|
xml_puts (out, level, "</rhs>");
|
|
}
|
|
else
|
|
{
|
|
xml_puts (out, level, "<rhs>");
|
|
xml_puts (out, level + 1, "<empty/>");
|
|
xml_puts (out, level, "</rhs>");
|
|
}
|
|
}
|
|
|
|
void
|
|
rule_print (rule *r, FILE *out)
|
|
{
|
|
fprintf (out, "%s:", r->lhs->tag);
|
|
rule_rhs_print (r, out);
|
|
}
|
|
|
|
void
|
|
ritem_print (FILE *out)
|
|
{
|
|
unsigned int i;
|
|
fputs ("RITEM\n", out);
|
|
for (i = 0; i < nritems; ++i)
|
|
if (ritem[i] >= 0)
|
|
fprintf (out, " %s", symbols[ritem[i]]->tag);
|
|
else
|
|
fprintf (out, " (rule %d)\n", item_number_as_rule_number (ritem[i]));
|
|
fputs ("\n\n", out);
|
|
}
|
|
|
|
size_t
|
|
ritem_longest_rhs (void)
|
|
{
|
|
int max = 0;
|
|
rule_number r;
|
|
|
|
for (r = 0; r < nrules; ++r)
|
|
{
|
|
int length = rule_rhs_length (&rules[r]);
|
|
if (length > max)
|
|
max = length;
|
|
}
|
|
|
|
return max;
|
|
}
|
|
|
|
void
|
|
grammar_rules_partial_print (FILE *out, const char *title,
|
|
rule_filter filter)
|
|
{
|
|
rule_number r;
|
|
bool first = true;
|
|
symbol *previous_lhs = NULL;
|
|
|
|
/* rule # : LHS -> RHS */
|
|
for (r = 0; r < nrules + nuseless_productions; r++)
|
|
{
|
|
if (filter && !filter (&rules[r]))
|
|
continue;
|
|
if (first)
|
|
fprintf (out, "%s\n\n", title);
|
|
else if (previous_lhs && previous_lhs != rules[r].lhs)
|
|
fputc ('\n', out);
|
|
first = false;
|
|
rule_lhs_print (&rules[r], previous_lhs, out);
|
|
rule_rhs_print (&rules[r], out);
|
|
previous_lhs = rules[r].lhs;
|
|
}
|
|
if (!first)
|
|
fputs ("\n\n", out);
|
|
}
|
|
|
|
void
|
|
grammar_rules_partial_print_xml (FILE *out, int level, bool rtag,
|
|
rule_filter filter)
|
|
{
|
|
rule_number r;
|
|
bool first = true;
|
|
|
|
for (r = 0; r < nrules + nuseless_productions; r++)
|
|
{
|
|
if (filter && !filter (&rules[r]))
|
|
continue;
|
|
if (rtag && first)
|
|
xml_puts (out, level + 1, "<rules>");
|
|
first = false;
|
|
|
|
xml_printf (out, level + 2, "<rule number=\"%d\">",
|
|
rules[r].number);
|
|
rule_lhs_print_xml (&rules[r], out, level + 3);
|
|
rule_rhs_print_xml (&rules[r], out, level + 3);
|
|
xml_puts (out, level + 2, "</rule>");
|
|
}
|
|
if (rtag)
|
|
{
|
|
if (!first)
|
|
xml_puts (out, level + 1, "</rules>");
|
|
else
|
|
xml_puts (out, level + 1, "<rules/>");
|
|
}
|
|
}
|
|
|
|
void
|
|
grammar_rules_print (FILE *out)
|
|
{
|
|
grammar_rules_partial_print (out, _("Grammar"), rule_useful_in_grammar_p);
|
|
}
|
|
|
|
void
|
|
grammar_rules_print_xml (FILE *out, int level)
|
|
{
|
|
grammar_rules_partial_print_xml (out, level, true, rule_useful_in_grammar_p);
|
|
}
|
|
|
|
void
|
|
grammar_dump (FILE *out, const char *title)
|
|
{
|
|
fprintf (out, "%s\n\n", title);
|
|
fprintf (out,
|
|
"ntokens = %d, nvars = %d, nsyms = %d, nrules = %d, nritems = %d\n\n",
|
|
ntokens, nvars, nsyms, nrules, nritems);
|
|
|
|
|
|
fprintf (out, "Variables\n---------\n\n");
|
|
{
|
|
symbol_number i;
|
|
fprintf (out, "Value Sprec Sassoc Tag\n");
|
|
|
|
for (i = ntokens; i < nsyms; i++)
|
|
fprintf (out, "%5d %5d %5d %s\n",
|
|
i,
|
|
symbols[i]->prec, symbols[i]->assoc,
|
|
symbols[i]->tag);
|
|
fprintf (out, "\n\n");
|
|
}
|
|
|
|
fprintf (out, "Rules\n-----\n\n");
|
|
{
|
|
rule_number i;
|
|
fprintf (out, "Num (Prec, Assoc, Useful, Ritem Range) Lhs -> Rhs (Ritem range) [Num]\n");
|
|
for (i = 0; i < nrules + nuseless_productions; i++)
|
|
{
|
|
rule *rule_i = &rules[i];
|
|
item_number *rp = NULL;
|
|
unsigned int rhs_itemno = rule_i->rhs - ritem;
|
|
unsigned int rhs_count = 0;
|
|
/* Find the last RHS index in ritems. */
|
|
for (rp = rule_i->rhs; *rp >= 0; ++rp)
|
|
++rhs_count;
|
|
fprintf (out, "%3d (%2d, %2d, %2d, %2u-%2u) %2d ->",
|
|
i,
|
|
rule_i->prec ? rule_i->prec->prec : 0,
|
|
rule_i->prec ? rule_i->prec->assoc : 0,
|
|
rule_i->useful,
|
|
rhs_itemno,
|
|
rhs_itemno + rhs_count - 1,
|
|
rule_i->lhs->number);
|
|
/* Dumped the RHS. */
|
|
for (rp = rule_i->rhs; *rp >= 0; rp++)
|
|
fprintf (out, " %3d", *rp);
|
|
fprintf (out, " [%d]\n", item_number_as_rule_number (*rp));
|
|
}
|
|
}
|
|
fprintf (out, "\n\n");
|
|
|
|
fprintf (out, "Rules interpreted\n-----------------\n\n");
|
|
{
|
|
rule_number r;
|
|
for (r = 0; r < nrules + nuseless_productions; r++)
|
|
{
|
|
fprintf (out, "%-5d ", r);
|
|
rule_print (&rules[r], out);
|
|
}
|
|
}
|
|
fprintf (out, "\n\n");
|
|
}
|
|
|
|
void
|
|
grammar_rules_useless_report (const char *message)
|
|
{
|
|
rule_number r;
|
|
for (r = 0; r < nrules ; ++r)
|
|
if (!rules[r].useful)
|
|
{
|
|
location_print (stderr, rules[r].location);
|
|
fprintf (stderr, ": %s: %s: ", _("warning"), message);
|
|
rule_print (&rules[r], stderr);
|
|
}
|
|
}
|
|
|
|
void
|
|
grammar_free (void)
|
|
{
|
|
if (ritem)
|
|
free (ritem - 1);
|
|
free (rules);
|
|
free (token_translations);
|
|
/* Free the symbol table data structure. */
|
|
symbols_free ();
|
|
free_merger_functions ();
|
|
}
|