src/reader.c

   1 /* Input parser for Bison
   2
   3    Copyright (C) 1984, 1986, 1989, 1992, 1998, 2000-2003, 2005-2007,
   4    2009-2012 Free Software Foundation, Inc.
   5
   6    This file is part of Bison, the GNU Compiler Compiler.
   7
   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.
  12
  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.
  17
  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/>.  */
  20
  21 #include <config.h>
  22 #include "system.h"
  23
  24 #include <quote.h>
  25 #include <quotearg.h>
  26
  27 #include "complain.h"
  28 #include "conflicts.h"
  29 #include "files.h"
  30 #include "getargs.h"
  31 #include "gram.h"
  32 #include "muscle-tab.h"
  33 #include "reader.h"
  34 #include "symlist.h"
  35 #include "symtab.h"
  36 #include "scan-gram.h"
  37 #include "scan-code.h"
  38
  39 static void prepare_percent_define_front_end_variables (void);
  40 static void check_and_convert_grammar (void);
  41
  42 static symbol_list *grammar = NULL;
  43 static bool start_flag = false;
  44 merger_list *merge_functions;
  45
  46 /* Was %union seen?  */
  47 bool union_seen = false;
  48
  49 /* Was a tag seen?  */
  50 bool tag_seen = false;
  51
  52 /* Should rules have a default precedence?  */
  53 bool default_prec = true;
  54 \f
  55 /*-----------------------.
  56 | Set the start symbol.  |
  57 `-----------------------*/
  58
  59 void
  60 grammar_start_symbol_set (symbol *sym, location loc)
  61 {
  62   if (start_flag)
  63     complain_at (loc, _("multiple %s declarations"), "%start");
  64   else
  65     {
  66       start_flag = true;
  67       startsymbol = sym;
  68       startsymbol_location = loc;
  69     }
  70 }
  71
  72 \f
  73
  74 /*------------------------------------------------------------------------.
  75 | Return the merger index for a merging function named NAME.  Records the |
  76 | function, if new, in MERGER_LIST.                                       |
  77 `------------------------------------------------------------------------*/
  78
  79 static int
  80 get_merge_function (uniqstr name)
  81 {
  82   merger_list *syms;
  83   merger_list head;
  84   int n;
  85
  86   if (! glr_parser)
  87     return 0;
  88
  89   head.next = merge_functions;
  90   for (syms = &head, n = 1; syms->next; syms = syms->next, n += 1)
  91     if (UNIQSTR_EQ (name, syms->next->name))
  92       break;
  93   if (syms->next == NULL)
  94     {
  95       syms->next = xmalloc (sizeof syms->next[0]);
  96       syms->next->name = uniqstr_new (name);
  97       /* After all symbol type declarations have been parsed, packgram invokes
  98          record_merge_function_type to set the type.  */
  99       syms->next->type = NULL;
 100       syms->next->next = NULL;
 101       merge_functions = head.next;
 102     }
 103   return n;
 104 }
 105
 106 /*-------------------------------------------------------------------------.
 107 | For the existing merging function with index MERGER, record the result   |
 108 | type as TYPE as required by the lhs of the rule whose %merge declaration |
 109 | is at DECLARATION_LOC.                                                   |
 110 `-------------------------------------------------------------------------*/
 111
 112 static void
 113 record_merge_function_type (int merger, uniqstr type, location declaration_loc)
 114 {
 115   int merger_find;
 116   merger_list *merge_function;
 117
 118   if (merger <= 0)
 119     return;
 120
 121   if (type == NULL)
 122     type = uniqstr_new ("");
 123
 124   merger_find = 1;
 125   for (merge_function = merge_functions;
 126        merge_function != NULL && merger_find != merger;
 127        merge_function = merge_function->next)
 128     merger_find += 1;
 129   aver (merge_function != NULL && merger_find == merger);
 130   if (merge_function->type != NULL && !UNIQSTR_EQ (merge_function->type, type))
 131     {
 132       complain_at (declaration_loc,
 133                    _("result type clash on merge function %s: <%s> != <%s>"),
 134                    quote (merge_function->name), type, merge_function->type);
 135       complain_at (merge_function->type_declaration_location,
 136                    _("previous declaration"));
 137     }
 138   merge_function->type = uniqstr_new (type);
 139   merge_function->type_declaration_location = declaration_loc;
 140 }
 141
 142 /*--------------------------------------.
 143 | Free all merge-function definitions.  |
 144 `--------------------------------------*/
 145
 146 void
 147 free_merger_functions (void)
 148 {
 149   merger_list *L0 = merge_functions;
 150   while (L0)
 151     {
 152       merger_list *L1 = L0->next;
 153       free (L0);
 154       L0 = L1;
 155     }
 156 }
 157
 158 \f
 159 /*-------------------------------------------------------------------.
 160 | Parse the input grammar into a one symbol_list structure.  Each    |
 161 | rule is represented by a sequence of symbols: the left hand side   |
 162 | followed by the contents of the right hand side, followed by a     |
 163 | null pointer instead of a symbol to terminate the rule.  The next  |
 164 | symbol is the lhs of the following rule.                           |
 165 |                                                                    |
 166 | All actions are copied out, labelled by the rule number they apply |
 167 | to.                                                                |
 168 `-------------------------------------------------------------------*/
 169
 170 /* The (currently) last symbol of GRAMMAR. */
 171 static symbol_list *grammar_end = NULL;
 172
 173 /* Append SYM to the grammar.  */
 174 static symbol_list *
 175 grammar_symbol_append (symbol *sym, location loc)
 176 {
 177   symbol_list *p = symbol_list_sym_new (sym, loc);
 178
 179   if (grammar_end)
 180     grammar_end->next = p;
 181   else
 182     grammar = p;
 183
 184   grammar_end = p;
 185
 186   /* A null SYM stands for an end of rule; it is not an actual
 187      part of it.  */
 188   if (sym)
 189     ++nritems;
 190
 191   return p;
 192 }
 193
 194 static void
 195 assign_named_ref (symbol_list *p, named_ref *name)
 196 {
 197   symbol *sym = p->content.sym;
 198
 199   if (name->id == sym->tag)
 200     {
 201       warn_at (name->loc,
 202                _("duplicated symbol name for %s ignored"),
 203                quote (sym->tag));
 204       named_ref_free (name);
 205     }
 206   else
 207     p->named_ref = name;
 208 }
 209
 210
 211 /* The rule currently being defined, and the previous rule.
 212    CURRENT_RULE points to the first LHS of the current rule, while
 213    PREVIOUS_RULE_END points to the *end* of the previous rule (NULL).  */
 214 static symbol_list *current_rule = NULL;
 215 static symbol_list *previous_rule_end = NULL;
 216
 217
 218 /*----------------------------------------------.
 219 | Create a new rule for LHS in to the GRAMMAR.  |
 220 `----------------------------------------------*/
 221
 222 void
 223 grammar_current_rule_begin (symbol *lhs, location loc,
 224                             named_ref *lhs_name)
 225 {
 226   symbol_list* p;
 227
 228   /* Start a new rule and record its lhs.  */
 229   ++nrules;
 230   previous_rule_end = grammar_end;
 231
 232   p = grammar_symbol_append (lhs, loc);
 233   if (lhs_name)
 234     assign_named_ref (p, named_ref_copy (lhs_name));
 235
 236   current_rule = grammar_end;
 237
 238   /* Mark the rule's lhs as a nonterminal if not already so.  */
 239   if (lhs->class == unknown_sym)
 240     {
 241       lhs->class = nterm_sym;
 242       lhs->number = nvars;
 243       ++nvars;
 244     }
 245   else if (lhs->class == token_sym)
 246     complain_at (loc, _("rule given for %s, which is a token"), lhs->tag);
 247 }
 248
 249
 250 /*----------------------------------------------------------------------.
 251 | A symbol should be used if either:                                    |
 252 |   1. It has a destructor.                                             |
 253 |   2. The symbol is a mid-rule symbol (i.e., the generated LHS         |
 254 |      replacing a mid-rule action) that was assigned to or used, as in |
 255 |      "exp: { $$ = 1; } { $$ = $1; }".                                 |
 256 `----------------------------------------------------------------------*/
 257
 258 static bool
 259 symbol_should_be_used (symbol_list const *s, bool *midrule_warning)
 260 {
 261   if (symbol_destructor_get (s->content.sym)->code)
 262     return true;
 263   if ((s->midrule && s->midrule->action_props.is_value_used)
 264       || (s->midrule_parent_rule
 265           && symbol_list_n_get (s->midrule_parent_rule,
 266                                 s->midrule_parent_rhs_index)
 267                ->action_props.is_value_used))
 268     {
 269       *midrule_warning = true;
 270       return true;
 271     }
 272   return false;
 273 }
 274
 275 /*----------------------------------------------------------------.
 276 | Check that the rule R is properly defined.  For instance, there |
 277 | should be no type clash on the default action.                  |
 278 `----------------------------------------------------------------*/
 279
 280 static void
 281 grammar_rule_check (const symbol_list *r)
 282 {
 283   /* Type check.
 284
 285      If there is an action, then there is nothing we can do: the user
 286      is allowed to shoot herself in the foot.
 287
 288      Don't worry about the default action if $$ is untyped, since $$'s
 289      value can't be used.  */
 290   if (!r->action_props.code && r->content.sym->type_name)
 291     {
 292       symbol *first_rhs = r->next->content.sym;
 293       /* If $$ is being set in default way, report if any type mismatch.  */
 294       if (first_rhs)
 295         {
 296           char const *lhs_type = r->content.sym->type_name;
 297           const char *rhs_type =
 298             first_rhs->type_name ? first_rhs->type_name : "";
 299           if (!UNIQSTR_EQ (lhs_type, rhs_type))
 300             warn_at (r->location,
 301                      _("type clash on default action: <%s> != <%s>"),
 302                      lhs_type, rhs_type);
 303         }
 304       /* Warn if there is no default for $$ but we need one.  */
 305       else
 306         warn_at (r->location,
 307                  _("empty rule for typed nonterminal, and no action"));
 308     }
 309
 310   /* Check that symbol values that should be used are in fact used.  */
 311   {
 312     symbol_list const *l = r;
 313     int n = 0;
 314     for (; l && l->content.sym; l = l->next, ++n)
 315       {
 316         bool midrule_warning = false;
 317         if (!l->action_props.is_value_used
 318             && symbol_should_be_used (l, &midrule_warning)
 319             /* The default action, $$ = $1, `uses' both.  */
 320             && (r->action_props.code || (n != 0 && n != 1)))
 321           {
 322             void (*warn_at_ptr)(location, char const*, ...) =
 323               midrule_warning ? midrule_value_at : warn_at;
 324             if (n)
 325               warn_at_ptr (r->location, _("unused value: $%d"), n);
 326             else
 327               warn_at_ptr (r->location, _("unset value: $$"));
 328           }
 329       }
 330   }
 331
 332   /* See comments in grammar_current_rule_prec_set for how POSIX
 333      mandates this complaint.  It's only for identifiers, so skip
 334      it for char literals and strings, which are always tokens.  */
 335   if (r->ruleprec
 336       && r->ruleprec->tag[0] != '\'' && r->ruleprec->tag[0] != '"'
 337       && !r->ruleprec->declared && !r->ruleprec->prec)
 338     warn_at (r->location, _("token for %%prec is not defined: %s"),
 339              r->ruleprec->tag);
 340 }
 341
 342
 343 /*-------------------------------------.
 344 | End the currently being grown rule.  |
 345 `-------------------------------------*/
 346
 347 void
 348 grammar_current_rule_end (location loc)
 349 {
 350   /* Put an empty link in the list to mark the end of this rule  */
 351   grammar_symbol_append (NULL, grammar_end->location);
 352   current_rule->location = loc;
 353 }
 354
 355
 356 /*-------------------------------------------------------------------.
 357 | The previous action turns out the be a mid-rule action.  Attach it |
 358 | to the current rule, i.e., create a dummy symbol, attach it this   |
 359 | mid-rule action, and append this dummy nonterminal to the current  |
 360 | rule.                                                              |
 361 `-------------------------------------------------------------------*/
 362
 363 void
 364 grammar_midrule_action (void)
 365 {
 366   /* Since the action was written out with this rule's number, we must
 367      give the new rule this number by inserting the new rule before
 368      it.  */
 369
 370   /* Make a DUMMY nonterminal, whose location is that of the midrule
 371      action.  Create the MIDRULE.  */
 372   location dummy_location = current_rule->action_props.location;
 373   symbol *dummy = dummy_symbol_get (dummy_location);
 374   symbol_list *midrule = symbol_list_sym_new (dummy, dummy_location);
 375
 376   /* Remember named_ref of previous action. */
 377   named_ref *action_name = current_rule->action_props.named_ref;
 378
 379   /* Make a new rule, whose body is empty, before the current one, so
 380      that the action just read can belong to it.  */
 381   ++nrules;
 382   ++nritems;
 383   /* Attach its location and actions to that of the DUMMY.  */
 384   midrule->location = dummy_location;
 385   code_props_rule_action_init (&midrule->action_props,
 386                                current_rule->action_props.code,
 387                                current_rule->action_props.location,
 388                                midrule, 0,
 389                                current_rule->action_props.is_predicate);
 390   code_props_none_init (&current_rule->action_props);
 391
 392   if (previous_rule_end)
 393     previous_rule_end->next = midrule;
 394   else
 395     grammar = midrule;
 396
 397   /* End the dummy's rule.  */
 398   midrule->next = symbol_list_sym_new (NULL, dummy_location);
 399   midrule->next->next = current_rule;
 400
 401   previous_rule_end = midrule->next;
 402
 403   /* Insert the dummy nonterminal replacing the midrule action into
 404      the current rule.  Bind it to its dedicated rule.  */
 405   grammar_current_rule_symbol_append (dummy, dummy_location,
 406                                       action_name);
 407   grammar_end->midrule = midrule;
 408   midrule->midrule_parent_rule = current_rule;
 409   midrule->midrule_parent_rhs_index = symbol_list_length (current_rule->next);
 410 }
 411
 412 /* Set the precedence symbol of the current rule to PRECSYM. */
 413
 414 void
 415 grammar_current_rule_prec_set (symbol *precsym, location loc)
 416 {
 417   /* POSIX says that any identifier is a nonterminal if it does not
 418      appear on the LHS of a grammar rule and is not defined by %token
 419      or by one of the directives that assigns precedence to a token.  We
 420      ignore this here because the only kind of identifier that POSIX
 421      allows to follow a %prec is a token and because assuming it's a
 422      token now can produce more logical error messages.  Nevertheless,
 423      grammar_rule_check does obey what we believe is the real intent of
 424      POSIX here: that an error be reported for any identifier that
 425      appears after %prec but that is not defined separately as a
 426      token.  */
 427   symbol_class_set (precsym, token_sym, loc, false);
 428   if (current_rule->ruleprec)
 429     complain_at (loc, _("only one %s allowed per rule"), "%prec");
 430   current_rule->ruleprec = precsym;
 431 }
 432
 433 /* Attach dynamic precedence DPREC to the current rule. */
 434
 435 void
 436 grammar_current_rule_dprec_set (int dprec, location loc)
 437 {
 438   if (! glr_parser)
 439     warn_at (loc, _("%s affects only GLR parsers"), "%dprec");
 440   if (dprec <= 0)
 441     complain_at (loc, _("%s must be followed by positive number"), "%dprec");
 442   else if (current_rule->dprec != 0)
 443     complain_at (loc, _("only one %s allowed per rule"), "%dprec");
 444   current_rule->dprec = dprec;
 445 }
 446
 447 /* Attach a merge function NAME with argument type TYPE to current
 448    rule. */
 449
 450 void
 451 grammar_current_rule_merge_set (uniqstr name, location loc)
 452 {
 453   if (! glr_parser)
 454     warn_at (loc, _("%s affects only GLR parsers"), "%merge");
 455   if (current_rule->merger != 0)
 456     complain_at (loc, _("only one %s allowed per rule"), "%merge");
 457   current_rule->merger = get_merge_function (name);
 458   current_rule->merger_declaration_location = loc;
 459 }
 460
 461 /* Attach SYM to the current rule.  If needed, move the previous
 462    action as a mid-rule action.  */
 463
 464 void
 465 grammar_current_rule_symbol_append (symbol *sym, location loc,
 466                                     named_ref *name)
 467 {
 468   symbol_list *p;
 469   if (current_rule->action_props.code)
 470     grammar_midrule_action ();
 471   p = grammar_symbol_append (sym, loc);
 472   if (name)
 473     assign_named_ref(p, name);
 474 }
 475
 476 /* Attach an ACTION to the current rule.  */
 477
 478 void
 479 grammar_current_rule_action_append (const char *action, location loc,
 480                                     named_ref *name, bool is_predicate)
 481 {
 482   if (current_rule->action_props.code)
 483     grammar_midrule_action ();
 484   /* After all symbol declarations have been parsed, packgram invokes
 485      code_props_translate_code.  */
 486   code_props_rule_action_init (&current_rule->action_props, action, loc,
 487                                current_rule, name, is_predicate);
 488 }
 489
 490 \f
 491 /*---------------------------------------------------------------.
 492 | Convert the rules into the representation using RRHS, RLHS and |
 493 | RITEM.                                                         |
 494 `---------------------------------------------------------------*/
 495
 496 static void
 497 packgram (void)
 498 {
 499   unsigned int itemno = 0;
 500   rule_number ruleno = 0;
 501   symbol_list *p = grammar;
 502
 503   ritem = xnmalloc (nritems + 1, sizeof *ritem);
 504
 505   /* This sentinel is used by build_relations in gram.c.  */
 506   *ritem++ = 0;
 507
 508   rules = xnmalloc (nrules, sizeof *rules);
 509
 510   while (p)
 511     {
 512       int rule_length = 0;
 513       symbol *ruleprec = p->ruleprec;
 514       record_merge_function_type (p->merger, p->content.sym->type_name,
 515                                   p->merger_declaration_location);
 516       rules[ruleno].user_number = ruleno;
 517       rules[ruleno].number = ruleno;
 518       rules[ruleno].lhs = p->content.sym;
 519       rules[ruleno].rhs = ritem + itemno;
 520       rules[ruleno].prec = NULL;
 521       rules[ruleno].dprec = p->dprec;
 522       rules[ruleno].merger = p->merger;
 523       rules[ruleno].precsym = NULL;
 524       rules[ruleno].location = p->location;
 525       rules[ruleno].useful = true;
 526       rules[ruleno].action = p->action_props.code;
 527       rules[ruleno].action_location = p->action_props.location;
 528       rules[ruleno].is_predicate = p->action_props.is_predicate;
 529
 530       /* If the midrule's $$ is set or its $n is used, remove the `$' from the
 531          symbol name so that it's a user-defined symbol so that the default
 532          %destructor and %printer apply.  */
 533       if (p->midrule_parent_rule
 534           && (p->action_props.is_value_used
 535               || symbol_list_n_get (p->midrule_parent_rule,
 536                                     p->midrule_parent_rhs_index)
 537                    ->action_props.is_value_used))
 538         p->content.sym->tag += 1;
 539
 540       /* Don't check the generated rule 0.  It has no action, so some rhs
 541          symbols may appear unused, but the parsing algorithm ensures that
 542          %destructor's are invoked appropriately.  */
 543       if (p != grammar)
 544         grammar_rule_check (p);
 545
 546       for (p = p->next; p && p->content.sym; p = p->next)
 547         {
 548           ++rule_length;
 549
 550           /* Don't allow rule_length == INT_MAX, since that might
 551              cause confusion with strtol if INT_MAX == LONG_MAX.  */
 552           if (rule_length == INT_MAX)
 553               fatal_at (rules[ruleno].location, _("rule is too long"));
 554
 555           /* item_number = symbol_number.
 556              But the former needs to contain more: negative rule numbers. */
 557           ritem[itemno++] =
 558             symbol_number_as_item_number (p->content.sym->number);
 559           /* A rule gets by default the precedence and associativity
 560              of its last token.  */
 561           if (p->content.sym->class == token_sym && default_prec)
 562             rules[ruleno].prec = p->content.sym;
 563         }
 564
 565       /* If this rule has a %prec,
 566          the specified symbol's precedence replaces the default.  */
 567       if (ruleprec)
 568         {
 569           rules[ruleno].precsym = ruleprec;
 570           rules[ruleno].prec = ruleprec;
 571         }
 572       /* An item ends by the rule number (negated).  */
 573       ritem[itemno++] = rule_number_as_item_number (ruleno);
 574       aver (itemno < ITEM_NUMBER_MAX);
 575       ++ruleno;
 576       aver (ruleno < RULE_NUMBER_MAX);
 577
 578       if (p)
 579         p = p->next;
 580     }
 581
 582   aver (itemno == nritems);
 583
 584   if (trace_flag & trace_sets)
 585     ritem_print (stderr);
 586 }
 587 \f
 588 /*------------------------------------------------------------------.
 589 | Read in the grammar specification and record it in the format     |
 590 | described in gram.h.  All actions are copied into ACTION_OBSTACK, |
 591 | in each case forming the body of a C function (YYACTION) which    |
 592 | contains a switch statement to decide which action to execute.    |
 593 `------------------------------------------------------------------*/
 594
 595 void
 596 reader (void)
 597 {
 598   /* Initialize the symbol table.  */
 599   symbols_new ();
 600
 601   /* Construct the accept symbol. */
 602   accept = symbol_get ("$accept", empty_location);
 603   accept->class = nterm_sym;
 604   accept->number = nvars++;
 605
 606   /* Construct the error token */
 607   errtoken = symbol_get ("error", empty_location);
 608   errtoken->class = token_sym;
 609   errtoken->number = ntokens++;
 610
 611   /* Construct a token that represents all undefined literal tokens.
 612      It is always token number 2.  */
 613   undeftoken = symbol_get ("$undefined", empty_location);
 614   undeftoken->class = token_sym;
 615   undeftoken->number = ntokens++;
 616
 617   gram_in = xfopen (grammar_file, "r");
 618
 619   gram__flex_debug = trace_flag & trace_scan;
 620   gram_debug = trace_flag & trace_parse;
 621   gram_scanner_initialize ();
 622   gram_parse ();
 623   prepare_percent_define_front_end_variables ();
 624
 625   if (! complaint_issued)
 626     check_and_convert_grammar ();
 627
 628   xfclose (gram_in);
 629 }
 630
 631 static void
 632 prepare_percent_define_front_end_variables (void)
 633 {
 634   /* Set %define front-end variable defaults.  */
 635   muscle_percent_define_default ("lr.keep-unreachable-states", "false");
 636   {
 637     char *lr_type;
 638     /* IELR would be a better default, but LALR is historically the
 639        default.  */
 640     muscle_percent_define_default ("lr.type", "lalr");
 641     lr_type = muscle_percent_define_get ("lr.type");
 642     if (0 != strcmp (lr_type, "canonical-lr"))
 643       muscle_percent_define_default ("lr.default-reductions", "most");
 644     else
 645       muscle_percent_define_default ("lr.default-reductions", "accepting");
 646     free (lr_type);
 647   }
 648
 649   /* Check %define front-end variables.  */
 650   {
 651     static char const * const values[] = {
 652       "lr.type", "lalr", "ielr", "canonical-lr", NULL,
 653       "lr.default-reductions", "most", "consistent", "accepting", NULL,
 654       NULL
 655     };
 656     muscle_percent_define_check_values (values);
 657   }
 658 }
 659
 660
 661 /*-------------------------------------------------------------.
 662 | Check the grammar that has just been read, and convert it to |
 663 | internal form.                                               |
 664 `-------------------------------------------------------------*/
 665
 666 static void
 667 check_and_convert_grammar (void)
 668 {
 669   /* Grammar has been read.  Do some checking.  */
 670   if (nrules == 0)
 671     fatal (_("no rules in the input grammar"));
 672
 673   /* If the user did not define her ENDTOKEN, do it now. */
 674   if (!endtoken)
 675     {
 676       endtoken = symbol_get ("$end", empty_location);
 677       endtoken->class = token_sym;
 678       endtoken->number = 0;
 679       /* Value specified by POSIX.  */
 680       endtoken->user_token_number = 0;
 681     }
 682
 683   /* Report any undefined symbols and consider them nonterminals.  */
 684   symbols_check_defined ();
 685
 686   /* Find the start symbol if no %start.  */
 687   if (!start_flag)
 688     {
 689       symbol_list *node;
 690       for (node = grammar;
 691            node != NULL && symbol_is_dummy (node->content.sym);
 692            node = node->next)
 693         {
 694           for (node = node->next;
 695                node != NULL && node->content.sym != NULL;
 696                node = node->next)
 697             ;
 698         }
 699       aver (node != NULL);
 700       grammar_start_symbol_set (node->content.sym,
 701                                 node->content.sym->location);
 702     }
 703
 704   /* Insert the initial rule, whose line is that of the first rule
 705      (not that of the start symbol):
 706
 707      accept: %start EOF.  */
 708   {
 709     symbol_list *p = symbol_list_sym_new (accept, empty_location);
 710     p->location = grammar->location;
 711     p->next = symbol_list_sym_new (startsymbol, empty_location);
 712     p->next->next = symbol_list_sym_new (endtoken, empty_location);
 713     p->next->next->next = symbol_list_sym_new (NULL, empty_location);
 714     p->next->next->next->next = grammar;
 715     nrules += 1;
 716     nritems += 3;
 717     grammar = p;
 718   }
 719
 720   aver (nsyms <= SYMBOL_NUMBER_MAXIMUM && nsyms == ntokens + nvars);
 721
 722   /* Assign the symbols their symbol numbers.  Write #defines for the
 723      token symbols into FDEFINES if requested.  */
 724   symbols_pack ();
 725
 726   /* Scan rule actions after invoking symbol_check_alias_consistency (in
 727      symbols_pack above) so that token types are set correctly before the rule
 728      action type checking.
 729
 730      Before invoking grammar_rule_check (in packgram below) on any rule, make
 731      sure all actions have already been scanned in order to set `used' flags.
 732      Otherwise, checking that a midrule's $$ should be set will not always work
 733      properly because the check must forward-reference the midrule's parent
 734      rule.  For the same reason, all the `used' flags must be set before
 735      checking whether to remove `$' from any midrule symbol name (also in
 736      packgram).  */
 737   {
 738     symbol_list *sym;
 739     for (sym = grammar; sym; sym = sym->next)
 740       code_props_translate_code (&sym->action_props);
 741   }
 742
 743   /* Convert the grammar into the format described in gram.h.  */
 744   packgram ();
 745
 746   /* The grammar as a symbol_list is no longer needed. */
 747   symbol_list_free (grammar);
 748 }