diff --git a/doc/src/sgml/lobj.sgml b/doc/src/sgml/lobj.sgml
index 57bb57083a5..b767ba1d051 100644
--- a/doc/src/sgml/lobj.sgml
+++ b/doc/src/sgml/lobj.sgml
@@ -138,19 +138,50 @@
Creating a Large Object
- lo_creat
+ lo_create
The function
+Oid lo_create(PGconn *conn, Oid lobjId);
+
+ creates a new large object. The OID to be assigned can be
+ specified by lobjId;
+ if so, failure occurs if that OID is already in use for some large
+ object. If lobjId
+ is InvalidOid (zero) then lo_create
+ assigns an unused OID.
+ The return value is the OID that was assigned to the new large object,
+ or InvalidOid (zero) on failure.
+
+
+
+ An example:
+
+inv_oid = lo_create(conn, desired_oid);
+
+
+
+
+ lo_creat
+ The older function
+
Oid lo_creat(PGconn *conn, int mode);
- creates a new large object.
+ also creates a new large object, always assigning an unused OID.
The return value is the OID that was assigned to the new large object,
or InvalidOid (zero) on failure.
+
- mode is unused and
- ignored as of PostgreSQL 8.1; however, for
- backward compatibility with earlier releases it is best to
- set it to INV_READ, INV_WRITE,
+
+ In PostgreSQL releases 8.1 and later,
+ the mode is ignored,
+ so that lo_creat is exactly equivalent to
+ lo_create with a zero second argument.
+ However, there is little reason to use lo_creat
+ unless you need to work with servers older than 8.1.
+ To work with such an old server, you must
+ use lo_creat not lo_create,
+ and you must set mode to
+ one of INV_READ, INV_WRITE,
or INV_READ | INV_WRITE.
(These symbolic constants are defined
in the header file libpq/libpq-fs.h.)
@@ -160,35 +191,6 @@ Oid lo_creat(PGconn *conn, int mode);
An example:
inv_oid = lo_creat(conn, INV_READ|INV_WRITE);
-
-
-
-
- lo_create
- The function
-
-Oid lo_create(PGconn *conn, Oid lobjId);
-
- also creates a new large object. The OID to be assigned can be
- specified by lobjId;
- if so, failure occurs if that OID is already in use for some large
- object. If lobjId
- is InvalidOid (zero) then lo_create assigns an unused
- OID (this is the same behavior as lo_creat).
- The return value is the OID that was assigned to the new large object,
- or InvalidOid (zero) on failure.
-
-
-
- lo_create is new as of PostgreSQL
- 8.1; if this function is run against an older server version, it will
- fail and return InvalidOid.
-
-
-
- An example:
-
-inv_oid = lo_create(conn, desired_oid);