From: Robert Haas <rhaas@postgresql.org>
Date: Wed, 12 Jun 2013 16:20:59 +0000 (-0400)
Subject: Improve description of loread/lowrite.
X-Git-Tag: REL8_4_18~35
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=0da76f384d71cffeb695391e97713e0e5bc58c4b;p=thirdparty%2Fpostgresql.git

Improve description of loread/lowrite.

Patch by me, reviewed by Tatsuo Ishii.
---

diff --git a/doc/src/sgml/lobj.sgml b/doc/src/sgml/lobj.sgml
index 9ddb9c74dc0..d37bef03436 100644
--- a/doc/src/sgml/lobj.sgml
+++ b/doc/src/sgml/lobj.sgml
@@ -396,14 +396,10 @@ int lo_unlink(PGconn *conn, Oid lobjId);
 
   <para>
    There are server-side functions callable from SQL that correspond to
-   each of the client-side functions described above(please note
-   that the server side function
-   for <function>lo_read</function> is <function>loread</function> and
-   the server side function for <function>lo_write</function>
-   is <function>lowrite</function>); indeed, for the most part the
-   client-side functions are simply interfaces to the equivalent
-   server-side functions.  The ones that are actually useful to call
-   via SQL commands are
+   each of the client-side functions described above; indeed, for the
+   most part the client-side functions are simply interfaces to the
+   equivalent server-side functions.  The ones that are actually useful
+   to call via SQL commands are
    <function>lo_creat</function><indexterm><primary>lo_creat</></>,
    <function>lo_create</function><indexterm><primary>lo_create</></>,
    <function>lo_unlink</function><indexterm><primary>lo_unlink</></>,
@@ -445,6 +441,15 @@ SELECT lo_export(image.raster, '/tmp/motd') FROM image
     The client-side functions can be used by any
     <productname>PostgreSQL</productname> user.
   </para>
+
+  <para>
+    The functionality of <function>lo_read</function> and
+    <function>lo_write</function> is also available via server-side calls,
+    but the names of the server-side functions differ from the client side
+    interfaces in that they do not contain underscores.  You must call
+    these functions as <function>loread</> and <function>lowrite</>.
+  </para>
+
 </sect1>
 
 <sect1 id="lo-examplesect">