Prefixing libpq error message with function names

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: PostgreSQL Development <pgsql-hackers(at)postgresql(dot)org>
Subject: Prefixing libpq error message with function names
Date: 2001-07-12 16:27:21
Message-ID: Pine.LNX.4.30.0107121818020.681-100000@peter.localdomain
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Most, or at least half, of the error messages that libpq itself generates
look like "PQwhatever(): this and that went wrong", where PQwhatever is
usually the function that generates the error message.

I consider this practice ugly. If PQwhatever is an exported API function,
then the users knows perfectly well what function the message came from.
In fact, a common idiom is

if (PQsomething() != OK)
fprintf(stderr, "PQsomething: %s", PQerrorMessage(conn));

which is obviously going to look funky.

If PQwhatever is an internal function, then this practice is just plain
confusing to the user. In some cases the code tries to be smart and pass
in the name of "front line" API function, but this doesn't really end up
helping anybody.

libpq is not complex and large enough that it would be tedious for a
developer to locate any given error message or derive the location in case
of a rare duplicate. (I understand that in the backend this premise does
not necessarily hold, but I'm only talking about libpq.)

So would anyone object if I get rid of this while doing the i18n pass over
libpq?

--
Peter Eisentraut peter_e(at)gmx(dot)net http://funkturm.homeip.net/~peter

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2001-07-12 17:09:10 Re: Prefixing libpq error message with function names
Previous Message Tom Lane 2001-07-12 15:14:15 Re: Child itemid in update-chain marked as unused - can't continue repair_frag