X-Git-Url: https://git.saurik.com/bison.git/blobdiff_plain/7f8ba6c7f3fa2fbd9d04ff04fc2e9cb17bbdb902..8ff146cd31d887f9bb28ec5f96bffcad4b4057f7:/src/complain.h?ds=sidebyside diff --git a/src/complain.h b/src/complain.h index 564645f2..db151257 100644 --- a/src/complain.h +++ b/src/complain.h @@ -1,10 +1,12 @@ /* Declaration for error-reporting function for Bison. - Copyright (C) 2000, 2001, 2002 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 2, or (at your option) any - later version. + Copyright (C) 2000, 2001, 2002, 2006, 2009, 2010 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 @@ -12,9 +14,7 @@ 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, write to the Free Software - Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, - USA. */ + along with this program. If not, see . */ #ifndef COMPLAIN_H_ # define COMPLAIN_H_ 1 @@ -25,34 +25,52 @@ extern "C" { # endif -/* Informative messages, but we proceed. */ +/** Informative messages, but we proceed. */ -void warn (const char *format, ...) +void warn (char const *format, ...) __attribute__ ((__format__ (__printf__, 1, 2))); -void warn_at (location_t location, const char *format, ...) +void warn_at (location loc, char const *format, ...) __attribute__ ((__format__ (__printf__, 2, 3))); -/* Something bad happen, but let's continue and die later. */ +/* Generate a message aligned by an indent. + When *indent == 0, assign message's indent to *indent, + When *indent > 0, align the message by *indent value. */ +void warn_at_indent (location loc, unsigned *indent, + char const *format, ...) + __attribute__ ((__format__ (__printf__, 3, 4))); + +/** An error, but we continue and die later. */ -void complain (const char *format, ...) +void complain (char const *format, ...) __attribute__ ((__format__ (__printf__, 1, 2))); -void complain_at (location_t location, const char *format, ...) +void complain_at (location loc, char const *format, ...) + __attribute__ ((__format__ (__printf__, 2, 3))); + +/* Generate a message aligned by an indent. + When *indent == 0, assign message's indent to *indent, + When *indent > 0, align the message by *indent value. */ +void complain_at_indent (location loc, unsigned *indent, + char const *format, ...) + __attribute__ ((__format__ (__printf__, 3, 4))); + +/** An incompatibility with POSIX Yacc: mapped either to warn* or + complain* depending on yacc_flag. */ + +void yacc_at (location loc, char const *format, ...) __attribute__ ((__format__ (__printf__, 2, 3))); -/* Something bad happen and we die now. */ -void fatal (const char *format, ...) +/** A fatal error, causing immediate exit. */ + +void fatal (char const *format, ...) __attribute__ ((__noreturn__, __format__ (__printf__, 1, 2))); -void fatal_at (location_t location, const char *format, ...) +void fatal_at (location loc, char const *format, ...) __attribute__ ((__noreturn__, __format__ (__printf__, 2, 3))); -/* This variable is set each time `warn' is called. */ -extern bool warning_issued; - -/* This variable is set each time `complain' is called. */ +/** Whether an error was reported. */ extern bool complaint_issued; # ifdef __cplusplus