This patch fixes a bug reported by Graham Leggett (minfrin@sharp.fm).
The bug was that any insert or update would fail if the returned oid was
larger than a signed int.  Since OIDs are unsigned int's it was
a bug that the code used a java signed int to deal with the values.  The bug
would result in the error message: "Unable to fathom update count".
While fixing the bug, it became apparent that other code made a similar
assumption about OIDs being signed ints.  Therefore some methods that returned
or took OIDs are arguements also needed to be changed.
Since we are so close to the 7.2 release I have added new methods that
return longs and deprecated the old methods returning ints.  Therefore all
old code should still work without requiring a code change to cast from long to int.  Also note that the methods below are PostgreSQL specific extensions to
the JDBC api are are not part of the spec from Sun, thus it is unlikely that
they are used much or at all.

The deprecated methods are:
  ResultSet.getInsertedOID()
  Statement.getInsertedOID()
  Serialize.store()
  Connection.putObject()
and are replaced by:
  ResultSet.getLastOID()
  Statement.getLastOID()
  Serialize.storeObject()
  Connection.storeObject()
All the deprecated methods returned int, while their replacements return long

This patch also fixes two comments in MD5Digest that the author Jeremy Wohl
submitted.

--Barry

Encoding isn't necessarily multibyte

Fix comment

Backend /po patch.

http://laser.zhengmai.com.cn/download/backend_zh_CN.po.diff.gz

Weiping He

Further work on postmaster and postgres reference pages.

Fix markup error I introduced.

Add cross-reference to standalone-backend ref page.

Mention -c also allows -- GNU long option format, all platforms.

Remove bogus pg_amop insertion commands, per discussion of 25-Oct.
No change in results of script, but perhaps less confusion for people
reading it.

Tweak int8in to accept -9223372036854775808, per recent discussion in
pgsql-patches.

Make initdb --help not line wrap.

Remove extraneous space that somehow got into expected alter_table.out.
The default diff switches prevented regression tests from complaining,
but that doesn't make it correct.

Fix boundary condition in btbulkdelete: don't examine high key in case
where rightmost index page splits while we are waiting to obtain exclusive
lock on it.  Not clear this would actually hurt (probably the callback
would always fail), but better safe than sorry.
Also, improve comments describing concurrency considerations in this code.

Copy-editing.

Copy-editing.

Improve wording.

Document index entries are built first.

Update TODO list.

Update TODO list.

Update TODO list.

Remove compile errors of psql.exe and libpq.dll under
Multibyte mode.

Add mention that ALTER TABLE RENAME affects indexes and sequences too.

Update TODO list.

Update TODO list.

Update TODO list.

Update TODO list.

Add description of SSL request protocol.  Miscellaneous copy-editing.

/doc/src -> /doc for Peter.

Spell 'precedes', 'preceding' correctly in various places.

Add documentation for pg_get_ruledef and friends.

Update TODO list.

Remove mention of internals.ps.

Spelling and grammatical corrections.

Update TODO list.

Update TODO list.

Insert CommandCounterIncrement call into SPI_cursor_open.

Tweak interval_avg support to avoid coredump with Alpha/Tru64 compiler.
Per report from Bernd Tegge.

Update regress tests to reflect removal of 'current'.

Move internals.ps to web cvs.

Point to doc/src/postgres.tar.gz, which is where the tarball will be
built, not /doc.

Deprecate 'current' date/time constant.
Purge "Postgres" in favor of "PostgreSQL" in docs. ref/ not yet done.

Add a few new time zones, and list every time zone mentioned in my
 Linux box's time zone database.
Do not allow 'current' as a date/time input value.

Repair swapped sign for time minus time routine (time_mi_time()).
 Problem reported by Manuel Sugawara (masm@fciencias.unam.mx).

Allow 'PostgreSQL' as a date/time formatting style. Formerly, recognized
 'Postgres' only, but now accepts both.

Deprecate 'current' for date/time input.
Fix up references to "PostgreSQL" rather than "Postgres". Was roughly
 evenly split between the two before. ref/ files not yet done.

Update for first platforms reported as working
 for the upcoming 7.2 release.

I think it's patch's size problem that I can't
send patches to pgsql-patches list.
the zh_CN NLS patch is about 80K,
but sended twice and still can emerge on list.
so I've put it at:

http://laser.zhengmai.com.cn/download/zh_CN.po.diff.tar.gz

If possible, please download it and apply it.
(for current CVS).

    regards   laser

Fix beta build, for Marc.

// -> /* */, per Tatsuo.

Peter Eisentraut wrote:

> So I would base this discussion on the premise "bytea stores binary data"
> (insert examples).
>
> Some stylistic issues:
>
> bytea => <type>bytea</type>
>
> NULLs => zero bytes/bytes of value zero ("NULL" is too overloaded)
>
> 'non-printable' => <quote>nonprintable</quote>
>
> MUST => <emphasis>must</emphasis>
>

Here's a patch against *CVS tip* to address Peter's comments. Please let
me know what you think!

Joe Conway

Update for bytea, from Joe Conway

Update my2pg.pl for release.

Update HISTORY, for Tatsuo.

Bruce's octet_length change breaks this regression test.

Include sys/types.h in crypt-des.c.  FreeBSD netinet/in.h
needs it.

Seems it is getting compileable...

Marko Kreen

Added a few paragraphs to explain current restricted execution environment,
and error handling behavior.

Bradley McLean

Here's a patch adding documentation for the PQescapeBytea function to
libpq.sgml

I was trying (but gave up) to cross-reference back to the input escape
table in the User's Guide, but could not get the documentation to
compile with a cross-book xref (missing IDREF error). Can a cross-book
xref be done?

 Joe Conway

Duh, my regexp's missed bunch of them.  Here's next batch, this
should be all.

Marko Kreen

Add mention of template1 usage.

pgcrypto uses non-standard type uint, which causes compile
failures on FreeBSD.  This patch replaces uint -> unsigned.

This was reported by Daniel Holtzman against 0.4pre3 standalone
package, but it needs fixing in contrib/pgcrypto too.

Marko Kreen

I've created a new section to func.sgml, "Binary String Functions and
Operators", plagiarized shamelessly from the "String Functions and
Operators" section. There were enough differences that it made sense (at
least to me) to give this its own section instead of cramming it in with
normal string functions. This way I could also make the examples
relevant, which is particularly important for bytea.

One thing I think worth mentioning: while documenting the trim()
function I realized that I never implemented the bytea equivalent of
rtrim and ltrim. Therefore, the 'leading' and 'trailing' forms of trim,
available with text, are not available with bytea (I'd be happy to
correct this, but since it would require an initdb, I guess not until
7.3) -- the submitted doc accurately reflects this.

I will look for other areas of the docs that need mention of bytea, but
any guidance would be much appreciated.

--

Here's a second bytea documentation patch. This one significantly
expands the "Binary Data" section added by Bruce recently.

Joe Conway

Update TODO list.

Expand discussion of logfile management a little bit.

Update HISTORY to current changes.

update configure.in for b3 ...

Some minor tweaks of REINDEX processing: grab exclusive lock a little
earlier, make error checks more uniform.

Expand description of how to use REINDEX.

Simplify pg_convert() in that it calls pg_convert2 using new fmgr interface.

Double quotes in ln command to guard against spaces in path.

Change 'return ;' to 'return;'; remove space.

Fill in empty tutorial section about transactions.

Indent jdbc case labels using pgjindent.

More jdbc comment cleanups.  Code looks very nice now.

Update pgindent README so it gets *.java.in files.

JDBC indenting, comment cleanups.

Update TODO list.

Tweak format_type so that we get good behavior for both column type
display (with a typemod) and function arg/result type display (without
a typemod).

Fix arg coerect match text type, per Tom.

Try to be a little bit clearer about the implications of GRANT TO PUBLIC
and REVOKE FROM PUBLIC: the latter is not the same as 'revoke from all
users', but the ref page blurred the difference.

Make text octet_length() return non-compressed length to be consistent
with other data types, per disucssion.  Encoding issue still open.

Update TODO list.

Grammatical and spelling fixes.

Fix nasty bugs in pg_convert() and pg_convert2().

    o they sometimes returns a result garbage string appended.
    o they do not work if client encoding is different from server
      encoding

Fix comment at top of file to match file name.

pg_restore should exit with status 0, not 1, on success.

Fix a few typos, grammatical problems, etc in new tutorial material.
Overall a really nice job here, Peter ...

A bunch of small doco updates motivated by scanning the comments on
the interactive docs.

Add example of using 'sameuser' followed by 'all' pg_hba records to
enforce a limit on who can connect to databases other than their own.
From a recent discussion in pg-admin.

Improve comments about duplicate files.

Fix some typos.

Update various obsolete remarks about VACUUM.

Fix typo.

utils/geo-decls.h should be utils/geo_decls.h, per report from
StÅphane Raimbault.

Mention that LIKE ... ESCAPE '' is allowed to specify no
escape character.

Update TODO list.

Point out that TRUNCATE can't be used inside a transaction block.

Initial round of tweakage for man pages

Updates about NLS

Update TODO list.

Optimization for bpcharlen, textlen, varcharlen in case of single byte
encodings.