Changed " to '. Removed bug section from psql. added reminder for log call

in built-in.  fixed backslases in source for libpq.

Author: bmomjian

src/man/built-in.3

@@ -1,6 +1,6 @@
 .\" This is -*-nroff-*-
 .\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/built-in.3,v 1.1 1996/11/14 10:15:15 scrappy Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/built-in.3,v 1.2 1996/11/15 17:55:26 momjian Exp $
 .TH BUILT-INS INTRO 11/05/95 Postgres95 Postgres95
 .SH "DESCRIPTION"
 This section describes the data types, functions and operators
@@ -208,7 +208,7 @@ float8
 	|/	square root
 	||/	cube root
 	:	exponential function
-	;	natural logarithm
+	;	natural logarithm (in psql, protect with parentheses)
 
 point
 	!<	A is left of B

src/man/large_objects.3

@@ -1,7 +1,6 @@
 .\" This is -*-nroff-*-
 .\" XXX standard disclaimer belongs here....
-.\" $Header: /usr/local/devel/postgres/src/ref/RCS/large_objects.3pqsrc,v 1.12 1
-993/08/23 09:03:16 aoki Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.2 1996/11/15 17:55:29 momjian Exp $
 .TH "LARGE OBJECTS" INTRO 03/18/94 Postgres95 Postgres95
 .SH DESCRIPTION
 .PP
@@ -16,7 +15,6 @@ This section describes the implementation and the
 programmatic and query language interfaces to Postgres large object data.
 .PP
 .SH "Historical Note"
-.SH "Historical Note"
 .PP
 Originally, postgres 4.2 supports three standard implementations of large
 objects: as files external to Postgres, as Unix files managed by Postgres, and as
@@ -27,15 +25,13 @@ it provides stricter data integrity and time travel. For historical reasons,
 they are called Inversion large objects. (We will use Inversion and large
 objects interchangeably to mean the same thing in this section.)
 .SH "Inversion Large Objects"
-.SH "Inversion Large Objects"
 .PP
 The Inversion large
 object implementation breaks large objects up into \*(lqchunks\*(rq and
 stores the chunks in tuples in the database.  A B-tree index
 guarantees fast searches for the correct chunk number when doing
 random access reads and writes.
 .SH "Large Object Interfaces"
-.SH "Large Object Interfaces"
 .PP
 The facilities Postgres provides to access large objects, both in
 the backend as part of user-defined functions or the front end
@@ -77,7 +73,6 @@ Postgres provides a set of routines that
 support opening, reading, writing, closing, and seeking on large
 objects.  
 .SH "Creating a Large Object"
-.SH "Creating a Large Object"
 .PP
 The routine
 .nf
@@ -114,7 +109,6 @@ The commands below create an (Inversion) large object:
 inv_oid = lo_creat(INV_READ|INV_WRITE|INV_ARCHIVE);
 .fi
 .SH "Importing a Large Object"
-.SH "Importing a Large Object"
 To import a UNIX file as a large object, call
 .nf
 Oid
@@ -125,7 +119,6 @@ The
 argument specifies the UNIX pathname of the file to be imported as
 a large object.
 .SH "Exporting a Large Object"
-.SH "Exporting a Large Object"
 To export a large object into UNIX file, call
 .nf
 int
@@ -138,7 +131,6 @@ the
 .I filename
 argument specifies the UNIX pathname of the file.
 .SH "Opening an Existing Large Object"
-.SH "Opening an Existing Large Object"
 .PP
 To open an existing large object, call
 .nf
@@ -165,7 +157,6 @@ and
 .B lo_close .
 .\"-----------
 .SH "Writing Data to a Large Object"
-.SH "Writing Data to a Large Object"
 .PP
 The routine
 .nf
@@ -187,7 +178,6 @@ The number of bytes actually written is returned.
 In the event of an error,
 the return value is negative.
 .SH "Seeking on a Large Object"
-.SH "Seeking on a Large Object"
 .PP
 To change the current read or write location on a large object,
 call
@@ -207,7 +197,6 @@ and
 .SM SEEK_END.
 .\"-----------
 .SH "Closing a Large Object Descriptor"
-.SH "Closing a Large Object Descriptor"
 .PP
 A large object may be closed by calling
 .nf
@@ -223,7 +212,6 @@ On success,
 returns zero.  On error, the return value is negative.
 .PP
 .SH "Built in registered functions"
-.SH "Built in registered functions"
 .PP
 There are two built-in registered functions,
 .I lo_import
@@ -241,12 +229,11 @@ CREATE TABLE image (
 INSERT INTO image (name, raster)
    VALUES ('beautiful image', lo_import('/etc/motd'));
 
-SELECT lo_export(image.raster, "/tmp/motd") from image
+SELECT lo_export(image.raster, '/tmp/motd') from image
    WHERE name = 'beautiful image';
 .fi
 .PP
 .SH "Accessing Large Objects from LIBPQ"
-.SH "Accessing Large Objects from LIBPQ"
 Below is a sample program which shows how the large object interface in
 \*(LP can be used.  Parts of the program are commented out but are left
 in the source for the readers benefit.  This program can be found in 
@@ -262,7 +249,6 @@ and link with the
 library.
 .bp
 .SH "Sample Program"
-.SH "Sample Program"
 .nf
 /*-------------------------------------------------------------------------
  *
@@ -273,7 +259,7 @@ library.
  *
  *
  * IDENTIFICATION
- *    $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.1 1996/11/14 10:17:24 scrappy Exp $
+ *    $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.2 1996/11/15 17:55:29 momjian Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -301,7 +287,7 @@ Oid importFile(PGconn *conn, char *filename)
      */
     fd = open(filename, O_RDONLY, 0666);
     if (fd < 0)  {   /* error */
-	fprintf(stderr, "can't open unix file\"%s\"\n", filename);
+	fprintf(stderr, "can't open unix file\\"%s\\"\\n", filename);
     }
 
     /*
@@ -319,7 +305,7 @@ Oid importFile(PGconn *conn, char *filename)
     while ((nbytes = read(fd, buf, BUFSIZE)) > 0) {
 	tmp = lo_write(conn, lobj_fd, buf, nbytes);
 	if (tmp < nbytes) {
-	    fprintf(stderr, "error while reading \"%s\"", filename);
+	    fprintf(stderr, "error while reading \\"%s\\"", filename);
 	}
     }
 
@@ -348,11 +334,11 @@ void pickout(PGconn *conn, Oid lobjId, int start, int len)
     nread = 0;
     while (len - nread > 0) {
 	nbytes = lo_read(conn, lobj_fd, buf, len - nread);
-	buf[nbytes] = '\0';
+	buf[nbytes] = '\\0';
 	fprintf(stderr,">>> %s", buf);
 	nread += nbytes;
     }
-    fprintf(stderr,"\n");
+    fprintf(stderr,"\\n");
     lo_close(conn, lobj_fd);
 }
 
@@ -375,14 +361,14 @@ void overwrite(PGconn *conn, Oid lobjId, int start, int len)
 
     for (i=0;i<len;i++)
 	buf[i] = 'X';
-    buf[i] = '\0';
+    buf[i] = '\\0';
 
     nwritten = 0;
     while (len - nwritten > 0) {
 	nbytes = lo_write(conn, lobj_fd, buf + nwritten, len - nwritten);
 	nwritten += nbytes;
     }
-    fprintf(stderr,"\n");
+    fprintf(stderr,"\\n");
     lo_close(conn, lobj_fd);
 }
 
@@ -413,7 +399,7 @@ void exportFile(PGconn *conn, Oid lobjId, char *filename)
      */
     fd = open(filename, O_CREAT|O_WRONLY, 0666);
     if (fd < 0)  {   /* error */
-	fprintf(stderr, "can't open unix file\"%s\"",
+	fprintf(stderr, "can't open unix file\\"%s\\"",
 		filename);
     }
 
@@ -423,7 +409,7 @@ void exportFile(PGconn *conn, Oid lobjId, char *filename)
     while ((nbytes = lo_read(conn, lobj_fd, buf, BUFSIZE)) > 0) {
 	tmp = write(fd, buf, nbytes);
         if (tmp < nbytes) {
-	    fprintf(stderr,"error while writing \"%s\"",
+	    fprintf(stderr,"error while writing \\"%s\\"",
 		    filename);
 	}
     }
@@ -451,7 +437,7 @@ main(int argc, char **argv)
     PGresult *res;
 
     if (argc != 4) {
-	fprintf(stderr, "Usage: %s database_name in_filename out_filename\n",
+	fprintf(stderr, "Usage: %s database_name in_filename out_filename\\n",
 		argv[0]);
 	exit(1);
     }
@@ -467,27 +453,27 @@ main(int argc, char **argv)
 
     /* check to see that the backend connection was successfully made */
     if (PQstatus(conn) == CONNECTION_BAD) {
-	fprintf(stderr,"Connection to database '%s' failed.\n", database);
+	fprintf(stderr,"Connection to database '%s' failed.\\n", database);
 	fprintf(stderr,"%s",PQerrorMessage(conn));
 	exit_nicely(conn);
     }
 
     res = PQexec(conn, "begin");
     PQclear(res);
-    printf("importing file \"%s\" ...\n", in_filename);
+    printf("importing file \\"%s\\" ...\\n", in_filename);
 /*  lobjOid = importFile(conn, in_filename); */
     lobjOid = lo_import(conn, in_filename); 
 /*
-    printf("\tas large object %d.\n", lobjOid);
+    printf("\\tas large object %d.\\n", lobjOid);
 
-    printf("picking out bytes 1000-2000 of the large object\n");
+    printf("picking out bytes 1000-2000 of the large object\\n");
     pickout(conn, lobjOid, 1000, 1000);
 
-    printf("overwriting bytes 1000-2000 of the large object with X's\n");
+    printf("overwriting bytes 1000-2000 of the large object with X's\\n");
     overwrite(conn, lobjOid, 1000, 1000);
 */
 
-    printf("exporting large object to file \"%s\" ...\n", out_filename);
+    printf("exporting large object to file \\"%s\\" ...\\n", out_filename);
 /*    exportFile(conn, lobjOid, out_filename); */
     lo_export(conn, lobjOid,out_filename);