From a8376c1c8419dff0afd639098fa03ba127c7fb32 Mon Sep 17 00:00:00 2001 From: Bruce Momjian <bruce@momjian.us> Date: Wed, 24 Jun 1998 13:21:30 +0000 Subject: [PATCH] cleanup --- src/man/alter_table.l | 11 +++++------ src/man/cleardbdir.1 | 3 +-- src/man/copy.l | 4 ++-- src/man/create_function.l | 6 +++--- src/man/create_operator.l | 6 +++--- src/man/create_rule.l | 5 ++--- src/man/create_table.l | 8 ++++---- src/man/create_type.l | 4 ++-- src/man/create_user.l | 4 ++-- src/man/create_version.l | 4 ++-- src/man/createdb.1 | 6 +++--- src/man/createuser.1 | 6 +++--- src/man/delete.l | 6 ++---- src/man/destroydb.1 | 6 +++--- src/man/destroyuser.1 | 6 +++--- src/man/drop_database.l | 6 +++--- src/man/drop_table.l | 4 ++-- src/man/drop_user.l | 3 +-- src/man/drop_view.l | 4 ++-- src/man/ecpg.1 | 1 - src/man/fetch.l | 6 +++--- src/man/grant.l | 4 ++-- src/man/initdb.1 | 6 ++---- src/man/insert.l | 7 +++---- src/man/large_objects.3 | 12 ++++++------ src/man/libpq.3 | 10 +++++----- src/man/listen.l | 4 ++-- src/man/notify.l | 6 +++--- src/man/pg_dump.1 | 4 ++-- src/man/pg_dumpall.1 | 4 ++-- src/man/pg_hba.conf.5 | 3 +-- src/man/pg_passwd.1 | 3 +-- src/man/pgbuiltin.3 | 16 ++++++++-------- src/man/pgintro.1 | 14 +++++++------- src/man/postmaster.1 | 8 ++++---- src/man/psql.1 | 11 +++++------ src/man/reset.l | 8 ++++---- src/man/revoke.l | 4 ++-- src/man/select.l | 4 ++-- src/man/set.l | 8 ++++---- src/man/show.l | 8 ++++---- src/man/sql.l | 4 ++-- 42 files changed, 122 insertions(+), 135 deletions(-) diff --git a/src/man/alter_table.l b/src/man/alter_table.l index e77502bfe5c..d31af5f72ab 100644 --- a/src/man/alter_table.l +++ b/src/man/alter_table.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/alter_table.l,v 1.6 1998/06/23 17:52:29 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/alter_table.l,v 1.7 1998/06/24 13:21:23 momjian Exp $ .TH "ALTER TABLE" SQL 09/25/97 PostgreSQL .SH NAME alter table - add attributes to a class, or rename an attribute or class @@ -30,7 +30,7 @@ after this command is executed. .PP The new attributes and their types are specified in the same style and with the the same restrictions as in -.IR "create_table" (l). +.IR create_table(l). .PP In order to add an attribute to each class in an entire inheritance hierarchy, use the @@ -52,7 +52,7 @@ For efficiency reasons, default values for added attributes are not placed in existing instances of a class. That is, existing instances will have NULL values in the new attributes. If non-NULL values are desired, a subsequent -.IR update (l) +.IR update(l) query should be run. .PP In order to rename an attribute in each class in an entire inheritance @@ -99,6 +99,5 @@ alter table emp rename column sports to hobbies alter table person * rename column last_name to family_name .fi .SH "SEE ALSO" -create_table (l), -update (l). - +create_table(l), +update(l). diff --git a/src/man/cleardbdir.1 b/src/man/cleardbdir.1 index 54809b91347..7ee05307eb9 100644 --- a/src/man/cleardbdir.1 +++ b/src/man/cleardbdir.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/cleardbdir.1,v 1.3 1998/01/11 22:17:07 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/cleardbdir.1,v 1.4 1998/06/24 13:21:23 momjian Exp $ .TH CLEARDBDIR UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME cleardbdir - completely destroys all database files @@ -20,4 +20,3 @@ should ensure the process is not running before running cleardbdir. .SH "SEE ALSO" initdb(1) - diff --git a/src/man/copy.l b/src/man/copy.l index 2cb0617956f..9372a8f92e7 100644 --- a/src/man/copy.l +++ b/src/man/copy.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/copy.l,v 1.5 1998/06/23 17:52:30 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/copy.l,v 1.6 1998/06/24 13:21:24 momjian Exp $ .TH COPY SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME copy - copy data to or from a class from or to a Unix file. @@ -153,7 +153,7 @@ in the event of a but the target relation will, of course, be partially modified in a .BR "copy to" . The -.IR vacuum (l) +.IR vacuum(l) query should be used to clean up after a failed .BR "copy" . .PP diff --git a/src/man/create_function.l b/src/man/create_function.l index 8436d8f1c62..a79524243b4 100644 --- a/src/man/create_function.l +++ b/src/man/create_function.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_function.l,v 1.9 1998/06/23 17:52:31 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_function.l,v 1.10 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE FUNCTION" SQL 11/05/95 PostgreSQL PostgreSQL .SH "NAME" create function - define a new function @@ -59,7 +59,7 @@ functions, as explained below. .SH "C FUNCTIONS" Functions written in C can be defined to Postgres, which will dynamically load them into its address space. The loading happens either using -.IR load (l) +.IR load(l) or automatically the first time the function is necessary for execution. Repeated execution of a function will cause negligible additional overhead, as the function will remain in a main memory @@ -201,7 +201,7 @@ Under HP-UX, DEC OSF/1, AIX and SunOS 4, all object files must be turned into .IR "shared libraries" using the operating system's native object file loader, -.IR ld (1). +.IR ld(1). .PP Under HP-UX, an object file must be compiled using the native HP-UX C compiler, diff --git a/src/man/create_operator.l b/src/man/create_operator.l index 2a5609d5b19..db6b126241b 100644 --- a/src/man/create_operator.l +++ b/src/man/create_operator.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_operator.l,v 1.5 1998/06/23 17:52:32 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_operator.l,v 1.6 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE OPERATOR" SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME create operator - define a new user operator @@ -66,7 +66,7 @@ The name of the operator, can be composed of symbols only. Also, the .IR func_name procedure must have been previously defined using -.IR "create_function" (l) +.IR create_function(l) and must have one or two arguments. .PP .\" that multiple instances of the @@ -191,7 +191,7 @@ is present in the qualification, then Postgres may have to estimate the fraction of the instances in MYBOXES that satisfy the clause. The function res_proc must be a registered function (meaning it is already defined using -.IR "define function" (l)) +.IR create_function(l)) which accepts one argument of the correct data type and returns a floating point number. The query optimizer simply calls this function, passing the parameter "0,0,1,1" diff --git a/src/man/create_rule.l b/src/man/create_rule.l index a8612d429c9..d83749f7bae 100644 --- a/src/man/create_rule.l +++ b/src/man/create_rule.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_rule.l,v 1.8 1998/06/23 17:52:32 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_rule.l,v 1.9 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE RULE" SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME create rule - define a new rule @@ -140,8 +140,7 @@ select * from EMP .PP You must have .IR "rule definition" -access to a class in order to define a rule on it (see -.IR "change acl" (l). +access to a class in order to define a rule on it. .SH EXAMPLES .nf -- diff --git a/src/man/create_table.l b/src/man/create_table.l index aa42576a19b..264c0edd0ef 100644 --- a/src/man/create_table.l +++ b/src/man/create_table.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_table.l,v 1.20 1998/06/24 12:52:47 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_table.l,v 1.21 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE TABLE" SQL 09/25/97 PostgreSQL .SH NAME create table - create a new class @@ -63,11 +63,11 @@ Each new class .IR classname is automatically created as a type. Therefore, one or more instances from the class are automatically a type and can be used in -.IR "alter_table" (l) +.IR alter_table(l) or other -.BR "create table" +.BR create_table(l) statements. See -.IR pgintro (1) +.IR pgintro(1) for a further discussion of this point. .PP The optional diff --git a/src/man/create_type.l b/src/man/create_type.l index 49272216caa..60292da6fdc 100644 --- a/src/man/create_type.l +++ b/src/man/create_type.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_type.l,v 1.5 1998/06/23 17:52:33 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_type.l,v 1.6 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE TYPE" SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME create type - define a new base data type @@ -28,7 +28,7 @@ defined for this database. .PP .BR "Create type" requires the registration of two functions (using -.IR "create_function" (l)) +.IR create_function(l)) before defining the type. The representation of a new base type is determined by .IR input_function , diff --git a/src/man/create_user.l b/src/man/create_user.l index e39ea0f73b7..52119849b5c 100644 --- a/src/man/create_user.l +++ b/src/man/create_user.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_user.l,v 1.2 1998/03/06 18:03:21 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_user.l,v 1.3 1998/06/24 13:21:24 momjian Exp $ .TH "CREATE USER" SQL 01/26/98 PostgreSQL PostgreSQL .SH NAME create user -- create a new user within a PostgreSQL instance @@ -87,4 +87,4 @@ create user tab with password jw8s0F4 valid until 'Jan 1 2002'; create user tab with password jw8s0F4 createdb; .fi .SH "SEE ALSO" -pg_crypt(3), alter_user(l), drop_user(l). +alter_user(l), drop_user(l). diff --git a/src/man/create_version.l b/src/man/create_version.l index 43f885863d7..f5cc59e6ddb 100644 --- a/src/man/create_version.l +++ b/src/man/create_version.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/create_version.l,v 1.4 1998/06/23 17:52:34 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/create_version.l,v 1.5 1998/06/24 13:21:25 momjian Exp $ .TH "CREATE VERSION" SQL 01/23/93 PostgreSQL PostgreSQL .SH NAME create version - construct a version class @@ -62,7 +62,7 @@ in [ONG90]. create version foobar from barfoo [ "Jan 17 1990" ] .fi .SH "SEE ALSO" -create_view(l), merge(l). +create_view(l). .SH "BUGS" Snapshots (i.e., the optional .IR abstime diff --git a/src/man/createdb.1 b/src/man/createdb.1 index 4650839a599..ff879281bd7 100644 --- a/src/man/createdb.1 +++ b/src/man/createdb.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.8 1998/01/29 02:26:33 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.9 1998/06/24 13:21:25 momjian Exp $ .TH CREATEDB UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME createdb - create a database @@ -41,7 +41,7 @@ and environment variables will be passed on to .IR psql and processed as described in -.IR psql (1). +.IR psql(1). .PP The optional argument .IR dbname @@ -59,7 +59,7 @@ understands the following command-line options: Specifies an authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) to use in connecting to the .IR postmaster process. This option no longer has any effect. diff --git a/src/man/createuser.1 b/src/man/createuser.1 index ca10405135b..246e98d5628 100644 --- a/src/man/createuser.1 +++ b/src/man/createuser.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/createuser.1,v 1.7 1998/03/06 18:03:31 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/createuser.1,v 1.8 1998/06/24 13:21:25 momjian Exp $ .TH CREATEUSER UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME createuser - create a Postgres user @@ -37,7 +37,7 @@ environment variables will be passed on to .IR psql and processed as described in -.IR psql (1). +.IR psql(1). .PP The optional argument .IR username @@ -52,7 +52,7 @@ understands the following command-line options: Specifies an authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) to use in connecting to the .IR postmaster process. This option no longer has any effect. diff --git a/src/man/delete.l b/src/man/delete.l index 230b1472b49..90b3bf09db5 100644 --- a/src/man/delete.l +++ b/src/man/delete.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/delete.l,v 1.3 1998/01/11 22:17:24 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/delete.l,v 1.4 1998/06/24 13:21:25 momjian Exp $ .TH DELETE SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME delete - delete instances from a class @@ -17,9 +17,7 @@ If the qualification is absent, the effect is to delete all instances in the class. The result is a valid, but empty class. .PP You must have write access to the class in order to modify it, as well -as read access to any class whose values are read in the qualification -(see -.IR "change acl" (l). +as read access to any class whose values are read in the qualification. .SH EXAMPLE .nf -- diff --git a/src/man/destroydb.1 b/src/man/destroydb.1 index b451df6c518..d290e780be8 100644 --- a/src/man/destroydb.1 +++ b/src/man/destroydb.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/destroydb.1,v 1.7 1998/01/26 01:42:45 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/destroydb.1,v 1.8 1998/06/24 13:21:25 momjian Exp $ .TH DESTROYDB UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME destroydb - destroy an existing database @@ -40,7 +40,7 @@ environment variables will be passed on to .IR psql and processed as described in -.IR psql (1). +.IR psql(1). .PP The optional argument .IR dbname @@ -62,7 +62,7 @@ Prompts before destroying a database (interactive). Specifies an authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) to use in connecting to the .IR postmaster process. This option no longer has any effect. diff --git a/src/man/destroyuser.1 b/src/man/destroyuser.1 index 2cd131e944a..c8848cf2625 100644 --- a/src/man/destroyuser.1 +++ b/src/man/destroyuser.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/destroyuser.1,v 1.7 1998/03/06 18:03:35 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/destroyuser.1,v 1.8 1998/06/24 13:21:25 momjian Exp $ .TH DESTROYUSER UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME destroyuser - destroy a Postgres user and associated databases @@ -38,7 +38,7 @@ and environment variables will be passed on to .IR psql and processed as described in -.IR psql (1). +.IR psql(1). .PP The optional argument .IR username @@ -52,7 +52,7 @@ understands the following command-line options: Specifies an authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) to use in connecting to the .IR postmaster process. This option no longer has any effect. diff --git a/src/man/drop_database.l b/src/man/drop_database.l index 6301a5ff416..7001e6fcf27 100644 --- a/src/man/drop_database.l +++ b/src/man/drop_database.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_database.l,v 1.3 1998/06/23 17:52:35 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_database.l,v 1.4 1998/06/24 13:21:26 momjian Exp $ .TH "DROP DATABASE" SQL 01/23/93 PostgreSQL PostgreSQL .SH NAME drop database - destroy an existing database @@ -13,7 +13,7 @@ drop database - destroy an existing database removes the catalog entries for an existing database and deletes the directory containing the data. It can only be executed by the database administrator (see -.IR createdb (l) +.IR createdb(l) for details). .SH "SEE ALSO" create_database(l), @@ -22,5 +22,5 @@ destroydb(1). This query should .BR NOT be executed interactively. The -.IR destroydb (1) +.IR destroydb(1) script should be used instead. diff --git a/src/man/drop_table.l b/src/man/drop_table.l index 23ad4ce1dc7..4fd2660b039 100644 --- a/src/man/drop_table.l +++ b/src/man/drop_table.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_table.l,v 1.3 1998/06/23 17:52:36 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_table.l,v 1.4 1998/06/24 13:21:26 momjian Exp $ .TH "DROP TABLE" SQL 09/26/97 PostgreSQL .SH NAME drop table - destroy existing classes @@ -13,7 +13,7 @@ drop table - destroy existing classes removes classes from the data base. Only its owner may destroy a class. A class may be emptied of instances, but not destroyed, by using -.IR delete (l). +.IR delete(l). .PP If a class being destroyed has secondary indices on it, then they will be removed first. The removal of just a secondary index will not diff --git a/src/man/drop_user.l b/src/man/drop_user.l index 13005066083..e88a47f09b8 100644 --- a/src/man/drop_user.l +++ b/src/man/drop_user.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_user.l,v 1.1 1998/01/25 07:42:02 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_user.l,v 1.2 1998/06/24 13:21:26 momjian Exp $ .TH "DROP USER" SQL 01/26/98 PostgreSQL PostgreSQL .SH NAME drop user -- drop user from within a PostgreSQL instance @@ -27,4 +27,3 @@ drop user tab; .SH "SEE ALSO" alter_user(l), create_user(l). - diff --git a/src/man/drop_view.l b/src/man/drop_view.l index 25584efc55f..80959379927 100644 --- a/src/man/drop_view.l +++ b/src/man/drop_view.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_view.l,v 1.3 1998/06/23 17:52:37 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/drop_view.l,v 1.4 1998/06/24 13:21:26 momjian Exp $ .TH "DROP VIEW" SQL 04/25/94 PostgreSQL PostgreSQL .SH NAME drop view - removes a view from Postgres @@ -20,4 +20,4 @@ drop view myview .fi .SH "SEE ALSO" create_view(l), -drop_rule(l), +drop_rule(l). diff --git a/src/man/ecpg.1 b/src/man/ecpg.1 index c43781bf6f1..e5aa8af2848 100644 --- a/src/man/ecpg.1 +++ b/src/man/ecpg.1 @@ -65,4 +65,3 @@ ecpg cannot use pointer variables except [unsigned] char * returns 0 to the shell on successful completion, -1 for errors, .SH "SEE ALSO" cc(1). - diff --git a/src/man/fetch.l b/src/man/fetch.l index 906047eb96a..36cdc8d0c00 100644 --- a/src/man/fetch.l +++ b/src/man/fetch.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/fetch.l,v 1.6 1998/03/23 15:09:29 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/fetch.l,v 1.7 1998/06/24 13:21:26 momjian Exp $ .TH FETCH SQL 01/23/93 PostgreSQL PostgreSQL .SH NAME fetch - fetch instance(s) from a cursor @@ -32,9 +32,9 @@ view updates. Consequently, users must issue explicit replace commands to update data. .PP Cursors may only be used inside of transaction blocks marked by -.IR begin (l) +.IR begin(l) and -.IR commit (l) +.IR commit(l) because the data that they store spans multiple user queries. .SH EXAMPLE .nf diff --git a/src/man/grant.l b/src/man/grant.l index 35c9cb1781c..5d00e549964 100644 --- a/src/man/grant.l +++ b/src/man/grant.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/grant.l,v 1.4 1998/03/26 21:01:47 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/grant.l,v 1.5 1998/06/24 13:21:26 momjian Exp $ .TH GRANT SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME grant - grant access control to a user or group @@ -28,4 +28,4 @@ grant insert to public .fi .SH "SEE ALSO" -revoke(l) +revoke(l). diff --git a/src/man/initdb.1 b/src/man/initdb.1 index 77e8e93fdc0..8bce88f9056 100644 --- a/src/man/initdb.1 +++ b/src/man/initdb.1 @@ -1,5 +1,5 @@ .\" This is -*-nroff-*- -.\" $Header: /cvsroot/pgsql/src/man/Attic/initdb.1,v 1.3 1998/01/11 22:17:38 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/initdb.1,v 1.4 1998/06/24 13:21:26 momjian Exp $ .TH INITDB UNIX 11/29/96 PostgreSQL PostgreSQL .SH NAME initdb - create a new Postgres database system @@ -243,6 +243,4 @@ vacuum(l), bki(5), create_database(l), createuser(1), -psql(1) - - +psql(1). diff --git a/src/man/insert.l b/src/man/insert.l index 8d9d1b74716..0bc3ff539da 100644 --- a/src/man/insert.l +++ b/src/man/insert.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/insert.l,v 1.10 1998/06/23 17:52:37 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/insert.l,v 1.11 1998/06/24 13:21:27 momjian Exp $ .TH INSERT SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME insert - insert tuples to a relation @@ -61,7 +61,7 @@ or is an integer constant and .IR array_str is an array constant (see -.IR pgintro (1)). +.IR pgintro(1)). .PP If the user does not specify any array bounds (as in the third form) @@ -77,8 +77,7 @@ contain garbage. .PP You must have write or append access to a class in order to append to it, as well as read access on any class whose values are read in the -target list or qualification (see -.IR "change acl" (l)). +target list or qualification. .SH EXAMPLES .nf -- diff --git a/src/man/large_objects.3 b/src/man/large_objects.3 index adce6bd62b7..5d7d2b36cf3 100644 --- a/src/man/large_objects.3 +++ b/src/man/large_objects.3 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.7 1998/06/16 03:03:03 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.8 1998/06/24 13:21:27 momjian Exp $ .TH "LARGE OBJECTS" INTRO 03/18/94 PostgreSQL PostgreSQL .SH DESCRIPTION .PP @@ -42,10 +42,10 @@ for dynamically-loaded C functions as well as for \*(LQ. .PP The Postgres large object interface is modeled after the Unix file system interface, with analogues of -.I open (2), -.I read (2), -.I write (2), -.I lseek (2), +.I open(2), +.I read(2), +.I write(2), +.I lseek(2), etc. User functions call these routines to retrieve only the data of interest from a large object. For example, if a large object type called @@ -259,7 +259,7 @@ library. * * * IDENTIFICATION - * $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.7 1998/06/16 03:03:03 momjian Exp $ + * $Header: /cvsroot/pgsql/src/man/Attic/large_objects.3,v 1.8 1998/06/24 13:21:27 momjian Exp $ * *------------------------------------------------------------------------- */ diff --git a/src/man/libpq.3 b/src/man/libpq.3 index f62af0616ae..1675a8ea7a3 100644 --- a/src/man/libpq.3 +++ b/src/man/libpq.3 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/libpq.3,v 1.16 1998/04/26 04:09:48 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/libpq.3,v 1.17 1998/06/24 13:21:27 momjian Exp $ .TH LIBPQ INTRO 03/12/94 PostgreSQL PostgreSQL .SH DESCRIPTION Libpq is the programmer's interface to Postgres. Libpq is a set of @@ -488,13 +488,13 @@ backend server) into a buffer of size .I length . Like -.I fgets (3), +.I fgets(3), this routine copies up to .I length "-1" characters into .I string . It is like -.I gets (3), +.I gets(3), however, in that it converts the terminating newline into a null character. .IP @@ -599,9 +599,9 @@ routines no longer have any effect and should not be used. .IP Returns a pointer to static space containing whatever name the user has authenticated. Use of this routine in place of calls to -.I getenv (3) +.I getenv(3) or -.I getpwuid (3) +.I getpwuid(3) by applications is highly recommended, as it is entirely possible that the authenticated user name is .B not diff --git a/src/man/listen.l b/src/man/listen.l index 676cf709b80..d18d3fdd7f0 100644 --- a/src/man/listen.l +++ b/src/man/listen.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/listen.l,v 1.5 1998/06/23 17:52:37 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/listen.l,v 1.6 1998/06/24 13:21:27 momjian Exp $ .TH "LISTEN" SQL 03/12/94 PostgreSQL PostgreSQL .SH NAME listen - listen for notification on a relation @@ -40,5 +40,5 @@ There is no way to un-\c except to drop the connection (i.e., restart the backend server). .PP The -.IR psql (1) +.IR psql(1) command does not poll for asynchronous events. diff --git a/src/man/notify.l b/src/man/notify.l index 81e962831df..50f44b442e5 100644 --- a/src/man/notify.l +++ b/src/man/notify.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/notify.l,v 1.3 1998/01/11 22:17:45 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/notify.l,v 1.4 1998/06/24 13:21:27 momjian Exp $ .TH "NOTIFY" SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME notify - signal all frontends and backends listening on a class @@ -12,7 +12,7 @@ notify - signal all frontends and backends listening on a class .BR notify is used to awaken all backends and consequently all frontends that have executed -.IR listen (l) +.IR listen(l) on .IR class_name . This can be used either within an instance-level rule as part of the @@ -45,4 +45,4 @@ never be processed. .SH "SEE ALSO" define rule(l), listen(l), -libpq. +libpq(3). diff --git a/src/man/pg_dump.1 b/src/man/pg_dump.1 index 33f66f05480..c34fe322a7d 100644 --- a/src/man/pg_dump.1 +++ b/src/man/pg_dump.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_dump.1,v 1.10 1998/01/29 02:26:47 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_dump.1,v 1.11 1998/06/24 13:21:28 momjian Exp $ .TH PG_DUMP UNIX 1/20/96 PostgreSQL PostgreSQL .SH NAME pg_dump - dumps out a Postgres database into a script file @@ -128,4 +128,4 @@ To reload it: psql -e database <db.out .SH "SEE ALSO" -copy(l) +copy(l). diff --git a/src/man/pg_dumpall.1 b/src/man/pg_dumpall.1 index aefadaaac93..7bd41b15de1 100644 --- a/src/man/pg_dumpall.1 +++ b/src/man/pg_dumpall.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_dumpall.1,v 1.4 1998/03/06 18:03:37 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_dumpall.1,v 1.5 1998/06/24 13:21:28 momjian Exp $ .TH pg_dumpall UNIX 1/20/96 PostgreSQL PostgreSQL .SH NAME pg_dumpall - dumps out all Postgres databases into a script file @@ -26,4 +26,4 @@ To reload into a fresh installation (you can use psql options): .fi .SH "SEE ALSO" -pg_dump(1) +pg_dump(1). diff --git a/src/man/pg_hba.conf.5 b/src/man/pg_hba.conf.5 index 32166ea2d33..758d3ac6606 100644 --- a/src/man/pg_hba.conf.5 +++ b/src/man/pg_hba.conf.5 @@ -1,5 +1,5 @@ .\" This is -*-nroff-*- -.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_hba.conf.5,v 1.5 1998/03/06 18:03:38 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_hba.conf.5,v 1.6 1998/06/24 13:21:28 momjian Exp $ .TH pg_hba.conf 5 1/26/98 PostgreSQL PostgreSQL .SH NAME $PGDATA/pg_hba.conf @@ -112,4 +112,3 @@ host all 192.168.0.0 255.255.255.0 crypt .SH "SEE ALSO" pgintro(1). - diff --git a/src/man/pg_passwd.1 b/src/man/pg_passwd.1 index 69f2b954046..1aa3475905d 100644 --- a/src/man/pg_passwd.1 +++ b/src/man/pg_passwd.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_passwd.1,v 1.3 1998/01/26 01:42:49 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pg_passwd.1,v 1.4 1998/06/24 13:21:28 momjian Exp $ .TH PG_PASSWD UNIX 11/05/95 PostgreSQL PostgreSQL .SH NAME pg_passwd - manipulate the flat password file @@ -113,4 +113,3 @@ $PGDATA/pg_hba.conf The Host Based Authentication file .SH "SEE ALSO" psql(1). - diff --git a/src/man/pgbuiltin.3 b/src/man/pgbuiltin.3 index 35428b76186..5551a7379ab 100644 --- a/src/man/pgbuiltin.3 +++ b/src/man/pgbuiltin.3 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/pgbuiltin.3,v 1.10 1997/11/18 23:04:27 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pgbuiltin.3,v 1.11 1998/06/24 13:21:29 momjian Exp $ .TH PGBUILTIN INTRO 04/01/97 PostgreSQL PostgreSQL .PP .SH "DESCRIPTION" @@ -80,14 +80,14 @@ and the input can have any of a wide variety of styles. For numeric date representations, European and US conventions can differ, and the proper interpretation is obtained by using the -.IR set (l) +.IR set(l) command before entering data. Output formats can be set to one of three styles: ISO-8601, SQL (traditional Oracle/Ingres), and traditional Postgres (see section on .IR "absolute time" ) with the SQL style having European and US variants (see -.IR set (l)). +.IR set(l)). In future releases, the number of date/time types will decrease, with the current implementation of datetime becoming timestamp, timespan becoming interval, @@ -528,12 +528,12 @@ Consult those commands for more listings. .PP .SH "SEE ALSO" -.IR set (l), -.IR show (l), -.IR reset (l), -.IR psql (1). +.IR set(l), +.IR show(l), +.IR reset(l), +.IR psql(1). For examples on specifying literals of built-in types, see -.IR SQL (l). +.IR SQL(l). .PP .SH BUGS Although most of the input and output functions corresponding to the diff --git a/src/man/pgintro.1 b/src/man/pgintro.1 index 54d5fce67d9..291bcb00705 100644 --- a/src/man/pgintro.1 +++ b/src/man/pgintro.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/pgintro.1,v 1.6 1998/06/24 13:05:01 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/pgintro.1,v 1.7 1998/06/24 13:21:29 momjian Exp $ .TH PGINTRO UNIX 11/05/95 PostgreSQL PostgreSQL .SP INFORMATION UNIX 11/05/95 .BH "SECTION 2 - Unix COMMANDS (Unix)" @@ -36,7 +36,7 @@ or DBA, is the person who is responsible for installing Postgres to enforce a security policy for a site. The DBA can add new users by the method described below and maintain a set of template databases for use by -.IR createdb (1). +.IR createdb(1). .PP The .IR postmaster @@ -51,7 +51,7 @@ can take several command-line arguments to tune its behavior. However, supplying arguments is necessary only if you intend to run multiple sites or a non-default site. See -.IR postmaster (1) +.IR postmaster(1) for details. .PP The @@ -97,7 +97,7 @@ identity is performed in a variety of ways. .SS "From the user shell" A backend server started from a user shell notes the user's (effective) user-id before performing a -.IR setuid (3) +.IR setuid(3) to the user-id of user \*(lqpostgres\*(rq. The effective user-id is used as the basis for access control checks. No other authentication is conducted. @@ -126,7 +126,7 @@ system catalogs (or modification of their schemas) is never allowed. .SS "Access Privilege The use of access privilege to limit reading, writing and setting of rules on classes is covered in -.IR "grant/revoke" (l). +.IR grant/revoke(l). .SS "Class removal and schema modification" Commands that destroy or modify the structure of an existing class, such as @@ -260,9 +260,9 @@ normal .IR Kerberos service. For details on the use of authentication, see the manual pages for -.IR postmaster (1) +.IR postmaster(1) and -.IR psql (1). +.IR psql(1). .PP In the .IR Kerberos diff --git a/src/man/postmaster.1 b/src/man/postmaster.1 index d11b9eeb735..1455dc0592d 100644 --- a/src/man/postmaster.1 +++ b/src/man/postmaster.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/postmaster.1,v 1.11 1998/01/26 01:42:52 scrappy Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/postmaster.1,v 1.12 1998/06/24 13:21:29 momjian Exp $ .TH POSTMASTER UNIX 11/05/95 PostgreSQL PostgreSQL .SH "NAME" postmaster - run the Postgres postmaster @@ -91,7 +91,7 @@ discarded. Specifies whether or not to use the authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) for frontend applications to use in connecting to the .IR postmaster process. Specify @@ -180,7 +180,7 @@ program to examine shared memory and semaphore state. .TP .BR "-o" " backend_options" The -.IR postgres (1) +.IR postgres(1) options specified in .IR "backend_options" are passed to all backend server processes started by this @@ -226,7 +226,7 @@ as this will prevent the from freeing the system resources (e.g., shared memory and semaphores) that it holds before dying. This prevents you from having to deal with the problem with -.IR shmat (2) +.IR shmat(2) described below. .SH "EXAMPLES" .nf diff --git a/src/man/psql.1 b/src/man/psql.1 index 16999b7bab2..bea7923c62a 100644 --- a/src/man/psql.1 +++ b/src/man/psql.1 @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/psql.1,v 1.25 1998/06/23 15:43:19 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/psql.1,v 1.26 1998/06/24 13:21:29 momjian Exp $ .TH PSQL UNIX 1/20/96 PostgreSQL PostgreSQL .SH NAME psql - run the interactive query front-end @@ -118,7 +118,7 @@ understands the following command-line options: Specifies an authentication system .IR "system" (see -.IR pgintro (1)) +.IR pgintro(1)) to use in connecting to the .IR postmaster process. This option no longer has any effect. @@ -267,9 +267,9 @@ semicolon is reached. .PP Whenever a query is executed, psql also polls for asynchronous notification events generated by -.IR listen (l) +.IR listen(l) and -.IR notify (l). +.IR notify(l). .PP .SH "PSQL COMMANDS" Anything you enter in psql that begins with an unquoted backslash is a psql @@ -422,7 +422,7 @@ authentication is in use. If this environment variable is set, Postgres will attempt authentication with servers for this realm and use separate ticket files to avoid conflicts with local ticket files. See -.IR pgintro (1) +.IR pgintro(1) for additional information on .IR Kerberos . @@ -437,4 +437,3 @@ any reason. libpq(3), postgres(1), postmaster(1). - diff --git a/src/man/reset.l b/src/man/reset.l index dbeaff0726c..67a79018d63 100644 --- a/src/man/reset.l +++ b/src/man/reset.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/reset.l,v 1.3 1998/01/11 22:17:55 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/reset.l,v 1.4 1998/06/24 13:21:29 momjian Exp $ .TH RESET SQL 05/14/97 PostgreSQL PostgreSQL .SH NAME reset - restore run-time parameters for session to default values @@ -15,13 +15,13 @@ will display the current configuration parameters for during a session. .PP The session can be configured using -.IR set (l), +.IR set(l), and values can be displayed using -.IR show (l). +.IR show(l). Parameters and values are case-insensitive. .PP See -.IR set (l) +.IR set(l) for more information on available variables. .SH EXAMPLES diff --git a/src/man/revoke.l b/src/man/revoke.l index 312d687555c..d1363ae976f 100644 --- a/src/man/revoke.l +++ b/src/man/revoke.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/revoke.l,v 1.3 1998/01/11 22:17:56 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/revoke.l,v 1.4 1998/06/24 13:21:29 momjian Exp $ .TH REVOKE SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME revoke - revoke access privileges @@ -26,4 +26,4 @@ revoke insert from public .fi .SH "SEE ALSO" -grant(l) +grant(l). diff --git a/src/man/select.l b/src/man/select.l index a21c1767c28..5ffa34922b8 100644 --- a/src/man/select.l +++ b/src/man/select.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/select.l,v 1.8 1998/06/23 17:52:37 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/select.l,v 1.9 1998/06/24 13:21:29 momjian Exp $ .TH SELECT SQL 11/05/95 PostgreSQL PostgreSQL .SH NAME select - retrieve instances from a class @@ -71,7 +71,7 @@ of the system depends on whether you used "nested dots" to project out attributes of the complex type or not. See the examples below. .PP You must have read access to a class to read its values (see -.IR "grant/revoke" (l). +.IR grant/revoke(l). .SH EXAMPLES .nf -- diff --git a/src/man/set.l b/src/man/set.l index cfa905d6569..7cd257d6627 100644 --- a/src/man/set.l +++ b/src/man/set.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/set.l,v 1.8 1998/01/11 22:17:58 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/set.l,v 1.9 1998/06/24 13:21:30 momjian Exp $ .TH SET SQL 05/14/97 PostgreSQL PostgreSQL .SH NAME set - set run-time parameters for session @@ -15,9 +15,9 @@ will modify configuration parameters for during a session. .PP Current values can be obtained using -.IR show (l), +.IR show(l), and values can be restored to the defaults using -.IR reset (l). +.IR reset(l). Parameters and values are case-insensitive. Note that the value field is always specified as a string, so is enclosed in single-quotes. @@ -25,7 +25,7 @@ is enclosed in single-quotes. .IR DateStyle determines the output format for the date and time data types. See -.IR "pgbuiltin" (3) +.IR pgbuiltin(3) for more information on available styles. .ce 1 diff --git a/src/man/show.l b/src/man/show.l index 67a6acaef60..3fde3d8acfe 100644 --- a/src/man/show.l +++ b/src/man/show.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/show.l,v 1.3 1998/01/11 22:17:59 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/show.l,v 1.4 1998/06/24 13:21:30 momjian Exp $ .TH SHOW SQL 05/14/97 PostgreSQL PostgreSQL .SH NAME show - show run-time parameters for session @@ -15,13 +15,13 @@ will display the current configuration parameters for during a session. .PP The session can be configured using -.IR set (l), +.IR set(l), and values can be restored to the defaults using -.IR reset (l). +.IR reset(l). Parameters and values are case-insensitive. .PP See -.IR set (l) +.IR set(l) for more information on available variables. .SH EXAMPLES diff --git a/src/man/sql.l b/src/man/sql.l index e3e4cbe8087..97dd59416b6 100644 --- a/src/man/sql.l +++ b/src/man/sql.l @@ -1,6 +1,6 @@ .\" This is -*-nroff-*- .\" XXX standard disclaimer belongs here.... -.\" $Header: /cvsroot/pgsql/src/man/Attic/sql.l,v 1.11 1998/04/26 04:09:51 momjian Exp $ +.\" $Header: /cvsroot/pgsql/src/man/Attic/sql.l,v 1.12 1998/06/24 13:21:30 momjian Exp $ .TH INTRODUCTION SQL 11/5/95 PostgreSQL PostgreSQL .SH "Section 4 - SQL Commands (COMMANDS)" .SH "General Information" @@ -173,7 +173,7 @@ New and current can only appear in the action portion of a rule, while other instance variables can be used in any SQL statement. .IR Composite_field is a field of of one of the Postgres composite types indicated in the -.IR information (l) +.IR pgbuiltin(l) section, while successive composite fields address attributes in the class(s) to which the composite field evaluates. Lastly, .IR field -- GitLab