2002-09-25 Andrew Cagney <cagney@redhat.com>

[deliverable/binutils-gdb.git] / gdb / complaints.h

diff --git a/gdb/complaints.h b/gdb/complaints.h
index d65b037c3b52b055ee3aec137490e28dfed19a7f..c176b190588f9ba9f6475f51419b4e995e914741 100644 (file)
--- a/gdb/complaints.h
+++ b/gdb/complaints.h
@@ -1,5 +1,7 @@
 /* Definitions for complaint handling during symbol reading in GDB.
-   Copyright (C) 1990, 1991, 1992  Free Software Foundation, Inc.
+
+   Copyright 1990, 1991, 1992, 1995, 1998, 2000, 2002 Free Software
+   Foundation, Inc.
 
    This file is part of GDB.
 
@@ -22,33 +24,50 @@
 #if !defined (COMPLAINTS_H)
 #define COMPLAINTS_H
 
+/* Opaque object used to track the number of complaints of a
+   particular category.  */
+struct complaints;
 
-/* Support for complaining about things in the symbol file that aren't
-   catastrophic.
+/* Predefined categories.  */
+extern struct complaints *symfile_complaints;
 
-   Each such thing gets a counter.  The first time we have the problem,
-   during a symbol read, we report it.  At the end of symbol reading,
-   if verbose, we report how many of each problem we had.  */
+/* Register a complaint.  */
+extern void complaint (struct complaints **complaints, const char *fmt,
+                      ...) ATTR_FORMAT (printf, 2, 3);
+extern void internal_complaint (struct complaints **complaints,
+                               const char *file, int line, const char *fmt,
+                               ...) ATTR_FORMAT (printf, 4, 5);
 
-struct complaint
-  {
-    char *message;
-    unsigned counter;
-    struct complaint *next;
-  };
+/* Clear out / initialize all complaint counters that have ever been
+   incremented.  If LESS_VERBOSE is 1, be less verbose about
+   successive complaints, since the messages are appearing all
+   together during a command that is reporting a contiguous block of
+   complaints (rather than being interleaved with other messages).  If
+   noisy is 1, we are in a noisy command, and our caller will print
+   enough context for the user to figure it out.  */
 
-/* Root of the chain of complaints that have at some point been issued. 
-   This is used to reset the counters, and/or report the total counts.  */
+extern void clear_complaints (struct complaints **complaints,
+                             int less_verbose, int noisy);
 
-extern struct complaint complaint_root[1];
 
-/* Functions that handle complaints.  (in complaints.c)  */
+/* Legacy interfaces to keep the old code working (until it is all
+   converted to the above).  While the structure below contains a
+   number of fields, all but .message are ignored.
 
-extern void
-complain PARAMS ((struct complaint *,...));
+   Support for complaining about things in the symbol file that aren't
+   catastrophic.
+
+   Each such thing gets a counter.  The first time we have the problem,
+   during a symbol read, we report it.  At the end of symbol reading,
+   if verbose, we report how many of each problem we had.  */
 
-extern void
-clear_complaints PARAMS ((int, int));
+struct complaint
+{
+  const char *message;
+  unsigned counter_ignored;
+  struct complaint *next_ignored;
+};
 
+extern void complain (struct complaint *, ...);
 
 #endif /* !defined (COMPLAINTS_H) */