Bug 7746 - internal document error() vs warning()
Summary: internal document error() vs warning()
Status: RESOLVED OBSOLETE
Alias: None
Product: gdb
Classification: Unclassified
Component: gdb (show other bugs)
Version: unknown
: P3 normal
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-08-11 12:18 UTC by ac131313
Modified: 2021-12-28 21:49 UTC (History)
3 users (show)

See Also:
Host:
Target:
Build:
Last reconfirmed:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description ac131313 2002-08-11 19:18:00 UTC 
[Converted from Gnats 641]

GDB's use of error() and warning() should be documented.

error()/warning() are responses to user input (an object file is ``user input'').

internal_error() / internal_warning() are responses to GDB detecting a [fatal] problem with its internals.

error() / internal_error() are not recoverable. The operation is abandoned.

warning() / internal_warning() are recoverable, execution continues.  Hopefully GDB managed to take action sufficient to avoid creating an error() situtation.

Release:
unknown
Comment 1 ac131313 2002-08-11 20:07:28 UTC 
From: Andrew Cagney <ac131313@ges.redhat.com>
To: gdb-gnats@sources.redhat.com
Cc:  
Subject: Re: gdb/641: innternal document error() vs warning()
Date: Sun, 11 Aug 2002 16:07:28 -0400

 Should also document complaint().
Comment 2 Tom Tromey 2021-12-28 21:49:18 UTC 
We aren't really doing internals docs anymore, and anyway I
think this is all well-understood these days.