src/complain.h

/* Declaration for error-reporting function for Bison.

   Copyright (C) 2000-2002, 2006, 2009-2012 Free Software Foundation,
   Inc.

   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/>.  */

#ifndef COMPLAIN_H_
# define COMPLAIN_H_ 1

# include "location.h"

/*-------------.
| --warnings.  |
`-------------*/

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.  */
    Wdeprecated       = 1 << 4,  /**< Obsolete constructs.  */
    Wother            = 1 << 5,  /**< All other warnings.  */

    Werror            = 1 << 10, /**< Warnings are treated as errors.  */
    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);

/** Record that a warning is about to be issued, and treat it as an
    error if <tt>warnings_flag & Werror</tt>.  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);

/** Make a complaint, but don't specify any location.  */
void complain (warnings flags, char const *message, ...)
  __attribute__ ((__format__ (__printf__, 2, 3)));

/** Make a complaint with location.  */
void complain_at (location loc, warnings flags, char const *message, ...)
  __attribute__ ((__format__ (__printf__, 3, 4)));

/** Make a complaint with location and some indentation.  */
void complain_at_indent (location loc, warnings flags, unsigned *indent,
                         char const *message, ...)
  __attribute__ ((__format__ (__printf__, 4, 5)));

/** Whether an error was reported.  */
extern bool complaint_issued;

#endif /* !COMPLAIN_H_ */
Commit	Line	Data
	1	/* Declaration for error-reporting function for Bison.
	2
	3	Copyright (C) 2000-2002, 2006, 2009-2012 Free Software Foundation,
	4	Inc.
	5
	6	This program is free software: you can redistribute it and/or modify
	7	it under the terms of the GNU General Public License as published by
	8	the Free Software Foundation, either version 3 of the License, or
	9	(at your option) any later version.
	10
	11	This program is distributed in the hope that it will be useful,
	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	GNU General Public License for more details.
	15
	16	You should have received a copy of the GNU General Public License
	17	along with this program. If not, see <http://www.gnu.org/licenses/>. */
	18
	19	#ifndef COMPLAIN_H_
	20	# define COMPLAIN_H_ 1
	21
	22	# include "location.h"
	23
	24	/*-------------.
	25	\| --warnings. \|
	26	`-------------*/
	27
	28	typedef enum
	29	{
	30	Wnone = 0, /*< Issue no warnings. /
	31	Wmidrule_values = 1 << 0, /*< Unset or unused midrule values. /
	32	Wyacc = 1 << 1, /*< POSIXME. /
	33	Wconflicts_sr = 1 << 2, /*< S/R conflicts. /
	34	Wconflicts_rr = 1 << 3, /*< R/R conflicts. /
	35	Wdeprecated = 1 << 4, /*< Obsolete constructs. /
	36	Wother = 1 << 5, /*< All other warnings. /
	37
	38	Werror = 1 << 10, /*< Warnings are treated as errors. /
	39	complaint = 1 << 11, /*< All complaints. /
	40	fatal = 1 << 12, /*< All fatal errors. /
	41	silent = 1 << 13, /*< Do not display the warning type. /
	42	Wall = ~Werror /*< All above warnings. /
	43	} warnings;
	44
	45	/** What warnings are issued. */
	46	extern warnings warnings_flag;
	47
	48	/** Display a "[-Wyacc]" like message on stderr. */
	49	void warnings_print_categories (warnings warn_flags);
	50
	51	/** Record that a warning is about to be issued, and treat it as an
	52	error if <tt>warnings_flag & Werror</tt>. This is exported
	53	only for the sake of Yacc-compatible conflict reports in conflicts.c.
	54	All other warnings should be implemented in complain.c and should use
	55	the normal warning format. */
	56	void set_warning_issued (void);
	57
	58	/** Make a complaint, but don't specify any location. */
	59	void complain (warnings flags, char const *message, ...)
	60	__attribute__ ((__format__ (__printf__, 2, 3)));
	61
	62	/** Make a complaint with location. */
	63	void complain_at (location loc, warnings flags, char const *message, ...)
	64	__attribute__ ((__format__ (__printf__, 3, 4)));
	65
	66	/** Make a complaint with location and some indentation. */
	67	void complain_at_indent (location loc, warnings flags, unsigned *indent,
	68	char const *message, ...)
	69	__attribute__ ((__format__ (__printf__, 4, 5)));
	70
	71	/** Whether an error was reported. */
	72	extern bool complaint_issued;
	73
	74	#endif /* !COMPLAIN_H_ */