X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/9611cfa20bf95cf06b79c598ae5e69979ea1ff8e..4654b0c0a8a355e7a8fcdf51b1a5eb6c485126f1:/src/muscle_tab.h diff --git a/src/muscle_tab.h b/src/muscle_tab.h index aafaaae5..2f1e51e6 100644 --- a/src/muscle_tab.h +++ b/src/muscle_tab.h @@ -1,22 +1,20 @@ /* Muscle table manager for Bison, - Copyright (C) 2001, 2002, 2003, 2006, 2007 Free Software Foundation, Inc. + Copyright (C) 2001, 2002, 2003, 2006, 2007, 2008 Free Software Foundation, Inc. This file is part of Bison, the GNU Compiler Compiler. - Bison is free software; you can redistribute it and/or modify + 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 2, or (at your option) - any later version. + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. - Bison is distributed in the hope that it will be useful, + 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 Bison; see the file COPYING. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. */ + along with this program. If not, see . */ #ifndef MUSCLE_TAB_H_ # define MUSCLE_TAB_H_ @@ -53,6 +51,7 @@ do { \ muscle_insert (Key, obstack_finish (&muscle_obstack)); \ } while(0) +/* Key -> Value, but don't apply escaping to Value. */ #define MUSCLE_INSERT_STRING_RAW(Key, Value) \ do { \ obstack_sgrow (&muscle_obstack, Value); \ @@ -60,6 +59,7 @@ do { \ muscle_insert (Key, obstack_finish (&muscle_obstack)); \ } while(0) +/* Key -> Value, applying M4 escaping to Value. */ #define MUSCLE_INSERT_STRING(Key, Value) \ do { \ MUSCLE_OBSTACK_SGROW (&muscle_obstack, Value); \ @@ -131,6 +131,35 @@ void muscle_user_name_list_grow (char const *key, char const *user_name, void muscle_percent_define_insert (char const *variable, location variable_loc, char const *value); +/* Mimic b4_percent_define_get in ../data/bison.m4 exactly. That is, if the + %define variable VARIABLE is defined, return its value. Otherwise, return + the empty string. Also, record Bison's usage of VARIABLE by defining + b4_percent_define_bison_variables(VARIABLE). The caller is responsible for + freeing the memory of the returned string. */ +char *muscle_percent_define_get (char const *variable); + +/* Mimic muscle_percent_define_get_loc in ../data/bison.m4 exactly. That is, + if the %define variable VARIABLE is undefined, complain fatally since that's + a Bison error. Otherwise, return its definition location in a form + approriate for the first argument of warn_at, complain_at, or fatal_at. + Don't record this as a Bison usage of VARIABLE as there's no reason to + suspect that the user-supplied value has yet influenced the output. */ +location muscle_percent_define_get_loc (char const *variable); + +/* Mimic muscle_percent_define_get_syncline in ../data/bison.m4 exactly. That + is, if the %define variable VARIABLE is undefined, complain fatally since + that's a Bison error. Otherwise, return its definition location as a + b4_syncline invocation. Don't record this as a Bison usage of VARIABLE as + there's no reason to suspect that the user-supplied value has yet influenced + the output. */ +char const *muscle_percent_define_get_syncline (char const *variable); + +/* Mimic b4_percent_define_ifdef in ../data/bison.m4 exactly. That is, if the + %define variable VARIABLE is defined, return true. Otherwise, return false. + Also, record Bison's usage of VARIABLE by defining + b4_percent_define_bison_variables(VARIABLE). */ +bool muscle_percent_define_ifdef (char const *variable); + /* Mimic b4_percent_define_flag_if in ../data/bison.m4 exactly. That is, if the %define variable VARIABLE is defined to "" or "true", return true. If it is defined to "false", return false. Complain if it is undefined (a @@ -145,6 +174,19 @@ bool muscle_percent_define_flag_if (char const *variable); suspect that the value has yet influenced the output. */ void muscle_percent_define_default (char const *variable, char const *value); +/* Mimic b4_percent_define_check_values in ../data/bison.m4 exactly except that + the VALUES structure is more appropriate for C. That is, VALUES points to a + list of strings that is partitioned into sublists by NULL's, one terminating + each sublist. The last sublist is followed by a second NULL. For each + sublist, the first string is the name of a %define variable, and all + remaining strings in that sublist are the valid values for that variable. + Complain if such a variable is undefined (a Bison error since the default + value should have been set already) or defined to any other value (possibly + a user error). Don't record this as a Bison usage of the variable as + there's no reason to suspect that the value has yet influenced the + output. */ +void muscle_percent_define_check_values (char const * const *values); + /* Grow the muscle for the %code qualifier QUALIFIER appearing at QUALIFIER_LOC in the grammar file with code CODE appearing at CODE_LOC. Record this as a grammar occurrence of VARIABLE by invoking muscle_user_name_list_grow. */