Re: BUG #3486: doc bug - Preventing transaction ID wraparound failures

On Jul 26, 2007, at 4:09 AM, Fujii Masao wrote:
> The following bug has been logged online:
>
> Bug reference: 3486
> Logged by: Fujii Masao
> Email address: fujii(dot)masao(at)oss(dot)ntt(dot)co(dot)jp
> PostgreSQL version: 8.3
> Operating system: RHEL4
> Description: doc bug - Preventing transaction ID wraparound
> failures
> Details:
>
> According to "varsup.c - GetNewTransactionId()", the error message in
> transaction ID wraparound failures
> is different from the one in the document.
>
>
> *** ./doc/src/sgml/maintenance.sgml.orig 2007-07-26 10:44:19.000000000
> +0900
> --- ./doc/src/sgml/maintenance.sgml 2007-07-26 10:45:11.000000000
> +0900
> ***************
> *** 447,453 ****
> until wraparound:
>
> <programlisting>
> ! ERROR: database is shut down to avoid wraparound data loss in
> database
> "mydb"
> HINT: Stop the postmaster and use a standalone backend to VACUUM in
> "mydb".
> </programlisting>
>
> --- 447,453 ----
> until wraparound:
>
> <programlisting>
> ! ERROR: database is not accepting commands to avoid wraparound
> data loss
> in database "mydb"
> HINT: Stop the postmaster and use a standalone backend to VACUUM in
> "mydb".
> </programlisting>

Is there any way we could extend the po system to allow for calling
out actual error messages from code into the docs? I see that the .po
files call out source code files and locations...

As an alternative, I could probably come up with something that would
allow for putting error message examples in comments in the source
code so at least if someone's changing something they can just change
it in one place.
--
Decibel!, aka Jim Nasby decibel(at)decibel(dot)org
EnterpriseDB http://enterprisedb.com 512.569.9461 (cell)