X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/b6403170609485abe21038a65255ae4d3825ec00..fea2516636dfcf73e92c24b68804ffe7666086c1:/src/complain.h diff --git a/src/complain.h b/src/complain.h index e8c26d16..0d81503d 100644 --- a/src/complain.h +++ b/src/complain.h @@ -1,6 +1,6 @@ /* Declaration for error-reporting function for Bison. - Copyright (C) 2000-2002, 2006, 2009-2012 Free Software Foundation, + Copyright (C) 2000-2002, 2006, 2009-2013 Free Software Foundation, Inc. This program is free software: you can redistribute it and/or modify @@ -21,61 +21,124 @@ # include "location.h" -# ifdef __cplusplus -extern "C" { -# endif +/* Sub-messages indent. */ +# define SUB_INDENT (4) /*-------------. | --warnings. | `-------------*/ +/** The bits assigned to each warning type. */ typedef enum { - Wnone = 0, /**< Issue no warnings. */ - Wmidrule_values = 1 << 0, /**< Unset or unused midrule values. */ - Wyacc = 1 << 1, /**< POSIXME. */ - Wconflicts_sr = 1 << 2, /**< S/R conflicts. */ - Wconflicts_rr = 1 << 3, /**< R/R conflicts. */ - Wother = 1 << 4, /**< All other warnings. */ - - Werror = 1 << 10, /**< Warnings are treated as errors. */ + warning_midrule_values, /**< Unset or unused midrule values. */ + warning_yacc, /**< POSIXME. */ + warning_conflicts_sr, /**< S/R conflicts. */ + warning_conflicts_rr, /**< R/R conflicts. */ + warning_empty_rule, /**< Implicitly empty rules. */ + warning_deprecated, /**< Obsolete constructs. */ + warning_precedence, /**< Useless precedence and associativity. */ + warning_other, /**< All other warnings. */ + + warnings_size /**< The number of warnings. Must be last. */ + } warning_bit; + +/** Whether -Werror was set. */ +extern bool warnings_are_errors; + +/** Decode a single argument from -W. + * + * \param arg the subarguments to decode. + * If null, then activate all the flags. + * \param no length of the potential "no-" prefix. + * Can be 0 or 3. If 3, negate the action of the subargument. + * \param err length of a potential "error=". + * Can be 0 or 6. If 6, treat the subargument as a CATEGORY. + * + * If VALUE != 0 then KEY sets flags and no-KEY clears them. + * If VALUE == 0 then KEY clears all flags from \c all and no-KEY sets all + * flags from \c all. Thus no-none = all and no-all = none. + */ +void warning_argmatch (char const *arg, size_t no, size_t err); + +/** Decode a comma-separated list of arguments from -W. + * + * \param args comma separated list of effective subarguments to decode. + * If 0, then activate all the flags. + */ +void warnings_argmatch (char *args); + + +/*-----------. +| complain. | +`-----------*/ + +/** Initialize this module. */ +void complain_init (void); + +typedef enum + { + /**< Issue no warnings. */ + Wnone = 0, + + Wmidrule_values = 1 << warning_midrule_values, + Wyacc = 1 << warning_yacc, + Wconflicts_sr = 1 << warning_conflicts_sr, + Wconflicts_rr = 1 << warning_conflicts_rr, + Wdeprecated = 1 << warning_deprecated, + Wempty_rule = 1 << warning_empty_rule, + Wprecedence = 1 << warning_precedence, + Wother = 1 << warning_other, + + Werror = 1 << 10, /** This bit is no longer used. */ + complaint = 1 << 11, /**< All complaints. */ fatal = 1 << 12, /**< All fatal errors. */ silent = 1 << 13, /**< Do not display the warning type. */ - Wall = ~Werror /**< All above warnings. */ - } warnings; - -/** What warnings are issued. */ -extern warnings warnings_flag; - -/** Display a "[-Wyacc]" like message on stderr. */ -void warnings_print_categories (warnings warn_flags); + no_caret = 1 << 14, /**< Do not display caret location. */ -/** Record that a warning is about to be issued, and treat it as an - error if warnings_flag & Werror. This is exported - only for the sake of Yacc-compatible conflict reports in conflicts.c. - All other warnings should be implemented in complain.c and should use - the normal warning format. */ -void set_warning_issued (void); + /**< All above warnings. */ + Weverything = ~complaint & ~fatal & ~silent, + Wall = Weverything & ~Wyacc + } warnings; -/** Make a complaint, but don't specify any location. */ -void complain (warnings flags, char const *message, ...) - __attribute__ ((__format__ (__printf__, 2, 3))); +/** Whether the warnings of \a flags are all unset. + (Never enabled, never disabled). */ +bool warning_is_unset (warnings flags); -/** Make a complaint with location. */ -void complain_at (location loc, warnings flags, char const *message, ...) +/** Make a complaint, with maybe a location. */ +void complain (location const *loc, warnings flags, char const *message, ...) __attribute__ ((__format__ (__printf__, 3, 4))); +/** Likewise, but with an \a argc/argv interface. */ +void complain_args (location const *loc, warnings w, unsigned *indent, + int argc, char *arg[]); + /** Make a complaint with location and some indentation. */ -void complain_at_indent (location loc, warnings flags, unsigned *indent, - char const *message, ...) +void complain_indent (location const *loc, warnings flags, unsigned *indent, + char const *message, ...) __attribute__ ((__format__ (__printf__, 4, 5))); -/** Whether an error was reported. */ -extern bool complaint_issued; -# ifdef __cplusplus -} -# endif +/** Report an obsolete syntax, suggest the updated one. */ +void deprecated_directive (location const *loc, + char const *obsolete, char const *updated); + +/** Report a repeated directive for a rule. */ +void duplicate_directive (char const *directive, + location first, location second); + +/** Warnings treated as errors shouldn't stop the execution as regular errors + should (because due to their nature, it is safe to go on). Thus, there are + three possible execution statuses. */ +typedef enum + { + status_none, + status_warning_as_error, + status_complaint + } err_status; + +/** Whether an error was reported. */ +extern err_status complaint_status; #endif /* !COMPLAIN_H_ */