Markup enhancements, some factual corrections.

This commit is contained in:
Peter Eisentraut 2000-11-11 23:01:45 +00:00
parent 8095924bdd
commit d55f878193
12 changed files with 466 additions and 568 deletions

View File

@ -1,35 +1,33 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.10 2000/03/27 17:14:42 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.11 2000/11/11 23:01:38 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-CREATEDB" xreflabel="createdb"> <refentry id="APP-CREATEDB" xreflabel="createdb">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-CREATEDB-TITLE"> <refentrytitle id="APP-CREATEDB-TITLE"><application>createdb</application></refentrytitle>
<application>createdb</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname> <refname>createdb</refname>
<application>createdb</application> <refpurpose>Create a new <productname>Postgres</productname> database</refpurpose>
</refname>
<refpurpose>
Create a new <productname>Postgres</productname> database
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-11-07</date> <command>createdb</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>options</replaceable></arg>
<synopsis> <arg choice="plain"><replaceable>dbname</replaceable></arg>
createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable class="parameter">dbname</replaceable> [ <replaceable class="parameter">description</replaceable> ] <arg><replaceable>description</replaceable></arg>
</synopsis> </cmdsynopsis>
<refsect2 id="R2-APP-CREATEDB-1"> <refsect2 id="R2-APP-CREATEDB-1">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Inputs Inputs
</title> </title>
@ -99,9 +97,8 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
<term>-D, --location <replaceable class="parameter">datadir</replaceable></term> <term>-D, --location <replaceable class="parameter">datadir</replaceable></term>
<listitem> <listitem>
<para> <para>
Specifies the alternate database location for this database installation. Specifies the alternative database location. See also <xref
This is the location of the installation system tables, not the location linkend="app-initlocation" endterm="app-initlocation-title">.
of this specific database, which may be different.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -146,9 +143,6 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
</refsect2> </refsect2>
<refsect2 id="R2-APP-CREATEDB-2"> <refsect2 id="R2-APP-CREATEDB-2">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -189,9 +183,6 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-CREATEDB-1"> <refsect1 id="R1-APP-CREATEDB-1">
<refsect1info>
<date>1999-11-07</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -215,36 +206,34 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
</refsect1> </refsect1>
<refsect1 id="R1-APP-CREATEDB-2"> <refsect1 id="R1-APP-CREATEDB-2">
<refsect1info> <title>Usage</title>
<date>1999-11-07</date>
</refsect1info> <informalexample>
<title>
Usage
</title>
<para> <para>
To create the database <literal>demo</literal> To create the database <literal>demo</literal> using the default
using the default database server: database server:
<screen>
<programlisting> <prompt>$ </prompt><userinput>createdb demo</userinput>
$ <userinput>createdb demo</userinput> <computeroutput>CREATE DATABASE</computeroutput>
CREATE DATABASE </screen>
</programlisting>
The response is the same as you would have gotten from running the The response is the same as you would have gotten from running the
<command>CREATE DATABASE</command> <acronym>SQL</acronym> command. <command>CREATE DATABASE</command> <acronym>SQL</acronym> command.
</para> </para>
</informalexample>
<informalexample>
<para> <para>
To create the database <literal>demo</literal> To create the database <literal>demo</literal> using the
using the postmaster on host eden, port 5000, using the <literal>LATIN1</literal> postmaster on host eden, port 5000, using the
encoding scheme with a look at the underlying query: <literal>LATIN1</literal> encoding scheme with a look at the
underlying query:
<programlisting> <screen>
$ <userinput>createdb -p 5000 -h eden -E LATIN1 -e demo</userinput> <prompt>$ </prompt><userinput>createdb -p 5000 -h eden -E LATIN1 -e demo</userinput>
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1' <computeroutput>CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'</computeroutput>
CREATE DATABASE <computeroutput>CREATE DATABASE</computeroutput>
</programlisting> </screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,31 +1,36 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.9 2000/11/04 21:09:41 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.10 2000/11/11 23:01:38 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-CREATELANG"> <refentry id="APP-CREATELANG">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-CREATELANG-TITLE"> <refentrytitle id="APP-CREATELANG-TITLE"><application>createlang</application></refentrytitle>
<application>createlang</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname id="createlang"> <refname id="createlang">createlang</refname>
<application>createlang</application> <refpurpose>Add a new programming language to a <productname>Postgres</productname> database</refpurpose>
</refname>
<refpurpose>
Add a new programming language to a <productname>Postgres</productname> database
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-12-05</date> <command>createlang</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<synopsis> <arg><replaceable>langname</replaceable></arg>
createlang [ <replaceable class="parameter">connection options</replaceable> ] [ <replaceable class="parameter">langname</replaceable> [ <replaceable class="parameter">dbname</replaceable> ] ] <arg choice="plain"><replaceable>dbname</replaceable></arg>
createlang [ <replaceable class="parameter">connection options</replaceable> ] --list|-l [ <replaceable class="parameter">dbname</replaceable> ] <sbr>
</synopsis> <command>createlang</command>
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<group choice="plain"><arg>--list</arg><arg>-l</arg></group>
<arg choice="plain"><replaceable>dbname</replaceable></arg>
</cmdsynopsis>
<refsect2 id="R2-APP-CREATELANG-1"> <refsect2 id="R2-APP-CREATELANG-1">
<title> <title>
@ -119,9 +124,6 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
</refsect2> </refsect2>
<refsect2 id="R2-APP-CREATELANG-2"> <refsect2 id="R2-APP-CREATELANG-2">
<refsect2info>
<date>1998-10-04</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -136,9 +138,6 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-CREATELANG-1"> <refsect1 id="R1-APP-CREATELANG-1">
<refsect1info>
<date>1999-12-05</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -171,15 +170,17 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
</refsect1> </refsect1>
<refsect1 id="R1-APP-CREATELANG-3"> <refsect1 id="R1-APP-CREATELANG-3">
<title> <title>Usage</title>
Usage
</title> <informalexample>
<para> <para>
To install <literal>pltcl</literal>: To install <literal>pltcl</literal> into the database
<programlisting> <literal>template1</literal>:
$ createlang pltcl dbname <screen>
</programlisting> <prompt>$ </prompt><userinput>createlang pltcl template1</userinput>
</screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,36 +1,32 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.9 2000/03/27 17:14:42 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.10 2000/11/11 23:01:40 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-CREATEUSER"> <refentry id="APP-CREATEUSER">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-CREATEUSER-TITLE"> <refentrytitle id="APP-CREATEUSER-TITLE"><application>createuser</application></refentrytitle>
<application>createuser</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv>
<refname>
<application>createuser</application>
</refname>
<refpurpose>
Create a new <productname>Postgres</productname> user
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<date>1999-11-07</date>
</refsynopsisdivinfo>
<synopsis> <refnamediv>
createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable class="parameter">username</replaceable> ] <refname>createuser</refname>
</synopsis> <refpurpose>Create a new <productname>Postgres</productname> user</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>createuser</command>
<arg rep="repeat"><replaceable>options</replaceable></arg>
<arg><replaceable>username</replaceable></arg>
</cmdsynopsis>
<refsect2 id="R2-APP-CREATEUSER-1"> <refsect2 id="R2-APP-CREATEUSER-1">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Inputs Inputs
</title> </title>
@ -159,9 +155,6 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
</refsect2> </refsect2>
<refsect2 id="R2-APP-CREATEUSER-2"> <refsect2 id="R2-APP-CREATEUSER-2">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -195,9 +188,6 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-CREATEUSER-1"> <refsect1 id="R1-APP-CREATEUSER-1">
<refsect1info>
<date>1998-11-07</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -226,35 +216,33 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
<refsect1 id="R1-APP-CREATEUSER-2"> <refsect1 id="R1-APP-CREATEUSER-2">
<refsect1info> <title>Usage</title>
<date>1999-11-07</date>
</refsect1info> <informalexample>
<title>
Usage
</title>
<para> <para>
To create a user <literal>joe</literal> To create a user <literal>joe</literal> on the default database
on the default database server: server:
<screen>
<programlisting> <prompt>$ </prompt><userinput>createuser joe</userinput>
$ <userinput>createuser joe</userinput> <computeroutput>Is the new user allowed to create databases? (y/n) </computeroutput><userinput>n</userinput>
Is the new user allowed to create databases? (y/n) <userinput>n</userinput> <computeroutput>Shall the new user be allowed to create more new users? (y/n) </computeroutput><userinput>n</userinput>
Shall the new user be allowed to create more new users? (y/n) <userinput>n</userinput> <computeroutput>CREATE USER</computeroutput>
CREATE USER </screen>
</programlisting>
</para> </para>
</informalexample>
<informalexample>
<para> <para>
To create the same user <literal>joe</literal> To create the same user <literal>joe</literal> using the
using the postmaster on host eden, port 5000, avoiding postmaster on host eden, port 5000, avoiding the prompts and
the prompts and taking a look at the underlying query: taking a look at the underlying query:
<screen>
<programlisting> <prompt>$ </prompt><userinput>createuser -p 5000 -h eden -D -A -e joe</userinput>
$ <userinput>createuser -p 5000 -h eden -D -A -e joe</userinput> <computeroutput>CREATE USER "joe" NOCREATEDB NOCREATEUSER</computeroutput>
CREATE USER "joe" NOCREATEDB NOCREATEUSER <computeroutput>CREATE USER</computeroutput>
CREATE USER </screen>
</programlisting>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,9 +1,9 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.10 2000/10/05 19:48:18 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.11 2000/11/11 23:01:43 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="SQL-DROPDATABASE" xreflabel="drop_database"> <refentry id="SQL-DROPDATABASE">
<refmeta> <refmeta>
<refentrytitle id="SQL-DROPDATABASE-TITLE"> <refentrytitle id="SQL-DROPDATABASE-TITLE">
DROP DATABASE DROP DATABASE

View File

@ -1,35 +1,32 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.3 2000/03/27 17:14:43 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.4 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-DROPDB"> <refentry id="APP-DROPDB">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-DROPDB-TITLE"> <refentrytitle id="APP-DROPDB-TITLE"><application>dropdb</application></refentrytitle>
<application>dropdb</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname> <refname>dropdb</refname>
<application>dropdb</application> <refpurpose>Remove an existing <productname>Postgres</productname> database</refpurpose>
</refname>
<refpurpose>
Remove an existing <productname>Postgres</productname> database
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-11-07</date> <command>dropdb</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>options</replaceable></arg>
<synopsis> <arg choice="plain"><replaceable>dbname</replaceable></arg>
dropdb [ <replaceable class="parameter">options</replaceable> ] <replaceable class="parameter">dbname</replaceable> </cmdsynopsis>
</synopsis>
<refsect2 id="R2-APP-DROPDB-1"> <refsect2 id="R2-APP-DROPDB-1">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Inputs Inputs
</title> </title>
@ -124,9 +121,6 @@ dropdb [ <replaceable class="parameter">options</replaceable> ] <replaceable cla
<refsect2 id="R2-APP-DROPDB-2"> <refsect2 id="R2-APP-DROPDB-2">
<refsect2info>
<date>1998-10-02</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -157,9 +151,6 @@ dropdb [ <replaceable class="parameter">options</replaceable> ] <replaceable cla
<refsect1 id="R1-APP-DROPDB-1"> <refsect1 id="R1-APP-DROPDB-1">
<refsect1info>
<date>1998-10-02</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -185,32 +176,33 @@ dropdb [ <replaceable class="parameter">options</replaceable> ] <replaceable cla
</refsect1> </refsect1>
<refsect1 id="R1-APP-DROPDB-2"> <refsect1 id="R1-APP-DROPDB-2">
<refsect1info> <title>Usage</title>
<date>1999-11-07</date>
</refsect1info> <informalexample>
<title>
Usage
</title>
<para> <para>
To destroy the database <literal>demo</literal> To destroy the database <literal>demo</literal> on the default
on the default database server: database server:
<programlisting> <screen>
$ <userinput>dropdb demo</userinput> <prompt>$ </prompt><userinput>dropdb demo</userinput>
DROP DATABASE <computeroutput>DROP DATABASE</computeroutput>
</programlisting> </screen>
</para> </para>
</informalexample>
<informalexample>
<para> <para>
To destroy the database <literal>demo</literal> To destroy the database <literal>demo</literal> using the
using the postmaster on host eden, port 5000, with verification postmaster on host eden, port 5000, with verification and a peek
and a peek at the underlying query: at the underlying query:
<programlisting> <screen>
$ <userinput>dropdb -p 5000 -h eden -i -e demo</userinput> <prompt>$ </prompt><userinput>dropdb -p 5000 -h eden -i -e demo</userinput>
Database "demo" will be permanently deleted. <computeroutput>Database "demo" will be permanently deleted.
Are you sure? (y/n) <userinput>y</userinput> Are you sure? (y/n) </computeroutput><userinput>y</userinput>
DROP DATABASE "demo" <computeroutput>DROP DATABASE "demo"
DROP DATABASE DROP DATABASE</computeroutput>
</programlisting> </screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,31 +1,36 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.3 2000/03/27 17:14:43 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.4 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-DROPLANG"> <refentry id="APP-DROPLANG">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-DROPLANG-TITLE"> <refentrytitle id="APP-DROPLANG-TITLE"><application>droplang</application></refentrytitle>
<application>droplang</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname id="droplang"> <refname id="droplang">droplang</refname>
<application>droplang</application> <refpurpose>Remove a programming language from a <productname>Postgres</productname> database</refpurpose>
</refname>
<refpurpose>
Remove a programming language from a <productname>Postgres</productname> database
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-12-05</date> <command>droplang</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<synopsis> <arg><replaceable>langname</replaceable></arg>
droplang [ <replaceable class="parameter">connection options</replaceable> ] [ <replaceable class="parameter">langname</replaceable> [ <replaceable class="parameter">dbname</replaceable> ] ] <arg choice="plain"><replaceable>dbname</replaceable></arg>
droplang [ <replaceable class="parameter">connection options</replaceable> ] --list|-l <sbr>
</synopsis> <command>droplang</command>
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<group choice="plain"><arg>--list</arg><arg>-l</arg></group>
<arg choice="plain"><replaceable>dbname</replaceable></arg>
</cmdsynopsis>
<refsect2 id="R2-APP-DROPLANG-1"> <refsect2 id="R2-APP-DROPLANG-1">
<title> <title>
@ -119,9 +124,6 @@ droplang [ <replaceable class="parameter">connection options</replaceable> ] --l
</refsect2> </refsect2>
<refsect2 id="R2-APP-DROPLANG-2"> <refsect2 id="R2-APP-DROPLANG-2">
<refsect2info>
<date>1999-12-05</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -136,9 +138,6 @@ droplang [ <replaceable class="parameter">connection options</replaceable> ] --l
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-DROPLANG-1"> <refsect1 id="R1-APP-DROPLANG-1">
<refsect1info>
<date>1999-12-05</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -172,15 +171,16 @@ droplang [ <replaceable class="parameter">connection options</replaceable> ] --l
</refsect1> </refsect1>
<refsect1 id="R1-APP-DROPLANG-3"> <refsect1 id="R1-APP-DROPLANG-3">
<title> <title>Usage</title>
Usage
</title> <informalexample>
<para> <para>
To remove <literal>pltcl</literal>: To remove <literal>pltcl</literal>:
<programlisting> <screen>
$ droplang pltcl <prompt>$ </prompt><userinput>droplang pltcl</userinput>
</programlisting> </screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,35 +1,32 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.4 2000/03/27 17:14:43 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.5 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-DROPUSER"> <refentry id="APP-DROPUSER">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-DROPUSER-TITLE"> <refentrytitle id="APP-DROPUSER-TITLE"><application>dropuser</application></refentrytitle>
<application>dropuser</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname> <refname>dropuser</refname>
<application>dropuser</application> <refpurpose>Drops (removes) a <productname>Postgres</productname> user</refpurpose>
</refname>
<refpurpose>
Drops (removes) a <productname>Postgres</productname> user
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-11-07</date> <command>dropuser</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>options</replaceable></arg>
<synopsis> <arg><replaceable>username</replaceable></arg>
dropuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable class="parameter">username</replaceable> ] </cmdsynopsis>
</synopsis>
<refsect2 id="R2-APP-DROPUSER-1"> <refsect2 id="R2-APP-DROPUSER-1">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Inputs Inputs
</title> </title>
@ -108,9 +105,6 @@ dropuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable
</refsect2> </refsect2>
<refsect2 id="R2-APP-DROPUSER-2"> <refsect2 id="R2-APP-DROPUSER-2">
<refsect2info>
<date>1999-11-07</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -145,9 +139,6 @@ dropuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-DROPUSER-1"> <refsect1 id="R1-APP-DROPUSER-1">
<refsect1info>
<date>1999-11-07</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -176,33 +167,33 @@ dropuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable
</refsect1> </refsect1>
<refsect1 id="R1-APP-DROPUSER-2"> <refsect1 id="R1-APP-DROPUSER-2">
<refsect1info> <title>Usage</title>
<date>1999-11-07</date>
</refsect1info>
<title>
Usage
</title>
<para>
To remove user <literal>joe</literal>
from the default database server:
<programlisting>
$ <userinput>dropuser joe</userinput>
DROP USER
</programlisting>
</para>
<informalexample>
<para> <para>
To remove user <literal>joe</literal> To remove user <literal>joe</literal> from the default database
using the postmaster on host eden, port 5000, with verification server:
and a peek at the underlying query: <screen>
<programlisting> <prompt>$ </prompt><userinput>dropuser joe</userinput>
$ <userinput>dropuser -p 5000 -h eden -i -e joe</userinput> <computeroutput>DROP USER</computeroutput>
User "joe" and any owned databases will be permanently deleted. </screen>
Are you sure? (y/n) <userinput>y</userinput>
DROP USER "joe"
DROP USER
</programlisting>
</para> </para>
</informalexample>
<informalexample>
<para>
To remove user <literal>joe</literal> using the postmaster on host
eden, port 5000, with verification and a peek at the underlying
query:
<screen>
<prompt>$ </prompt><userinput>dropuser -p 5000 -h eden -i -e joe</userinput>
<computeroutput>User "joe" and any owned databases will be permanently deleted.
Are you sure? (y/n) </computeroutput><userinput>y</userinput>
<computeroutput>DROP USER "joe"
DROP USER</computeroutput>
</screen>
</para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,50 +1,97 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/initdb.sgml,v 1.12 2000/10/05 19:48:18 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/initdb.sgml,v 1.13 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-INITDB"> <refentry id="APP-INITDB">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-INITDB-TITLE"> <refentrytitle id="APP-INITDB-TITLE"><application>initdb</application></refentrytitle>
<application>initdb</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv>
<refname>
<application>initdb</application>
</refname>
<refpurpose>
Create a new <productname>Postgres</productname> database installation
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<date>1999-12-17</date>
</refsynopsisdivinfo>
<synopsis>
initdb [ --pgdata|-D <replaceable class="parameter">dbdir</replaceable> ]
[ --sysid|-i <replaceable class="parameter">sysid</replaceable> ]
[ --pwprompt|-W ]
[ --encoding|-E <replaceable class="parameter">encoding</replaceable> ]
[ --pglib|-L <replaceable class="parameter">libdir</replaceable> ]
[ --noclean | -n ] [ --debug | -d ] [ --template | -t ]
</synopsis>
<refsect2 id="R2-APP-INITDB-1"> <refnamediv>
<refsect2info> <refname>initdb</refname>
<date>1999-11-17</date> <refpurpose>Create a new <productname>Postgres</productname> database cluster</refpurpose>
</refsect2info> </refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>initdb</command>
<group choice="plain">
<arg>--pgdata </arg>
<arg>-D </arg>
<replaceable>dbdir</replaceable>
</group>
<group>
<arg>--sysid </arg>
<arg>-i </arg>
<replaceable>sysid</replaceable>
</group>
<group><arg>--pwprompt</arg><arg>-W</arg></group>
<group>
<arg>--encoding </arg>
<arg>-E </arg>
<replaceable>encoding</replaceable>
</group>
<arg>-L <replaceable>directory</replaceable></arg>
<group><arg>--noclean</arg><arg>-n</arg></group>
<group><arg>--debug</arg><arg>-d</arg></group>
<group><arg>--template</arg><arg>-t</arg></group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="R1-APP-INITDB-1">
<title> <title>
Inputs Description
</title> </title>
<para> <para>
<application>initdb</application> creates a new
<productname>Postgres</productname> database cluster or system. A
database cluster is a collection of databases that are managed by a
single postmaster.
</para>
<para>
Creating a database system consists of creating the directories in which
the database data will live, generating the shared catalog tables
(tables that don't belong to any particular database), and
creating the <literal>template1</literal>
database. When you create a new database, everything in the
<literal>template1</literal> database is copied.
It contains catalog tables filled in for things like the
built-in types.
</para>
<para>
You must not execute <application>initdb</application> as root. This is
because you cannot run the database server as root either, but the
server needs to have access to the files <application>initdb</application>
creates. Furthermore, during the initialization phase, when there are no
users and no access controls installed, <productname>Postgres</productname>
will only connect with
the name of the current Unix user, so you must log in under the account
that will own the server process.
</para>
<para>
Although <application>initdb</application> will attempt to create the respective
data directory, chances are that it won't have the permission to do so. Thus
it is a good idea to create the data directory before running <application>initdb</application>
<emphasis>and</emphasis> to hand over the ownership of it to the database superuser.
</para>
<refsect2>
<title>Options</title>
<para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>--pgdata=<replaceable class="parameter">dbdir</replaceable></term> <term>--pgdata=<replaceable class="parameter">dbdir</replaceable></term>
<term>-D <replaceable class="parameter">dbdir</replaceable></term> <term>-D <replaceable class="parameter">dbdir</replaceable></term>
<term><envar>PGDATA</envar></term>
<listitem> <listitem>
<para> <para>
This option specifies where in the file system the database should be This option specifies where in the file system the database should be
@ -64,7 +111,7 @@ initdb [ --pgdata|-D <replaceable class="parameter">dbdir</replaceable> ]
Selects the system id of the database superuser. This defaults to Selects the system id of the database superuser. This defaults to
the effective user id of the user running initdb. It is really the effective user id of the user running initdb. It is really
not important what the superuser's sysid is, but one might choose not important what the superuser's sysid is, but one might choose
to start the numbering at some number like 0 or 1. to start the numbering at some number like 1.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -104,18 +151,13 @@ initdb [ --pgdata|-D <replaceable class="parameter">dbdir</replaceable> ]
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>--pglib=<replaceable class="parameter">libdir</replaceable></term> <term>-L <replaceable class="parameter">directory</replaceable></term>
<term>-l <replaceable class="parameter">libdir</replaceable></term>
<listitem> <listitem>
<para> <para>
initdb needs a few input files to initialize the database. This option Specifies where initdb should find its input files to
tells where to find them. You normally don't have to worry about this initialize the database system. This is normally not
since initdb knows about the most common installation layouts and will necessary. You will be told if you need to specify their
find the files itself. You will be told if you need to specify their location explicitly.
location explicitly. If that happens, one of the files is called
<filename>global1.bki.source</filename> and is traditionally installed
along with the others in the library directory (e.g.,
<filename>/usr/local/pgsql/lib</filename>).
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -174,65 +216,16 @@ initdb [ --pgdata|-D <replaceable class="parameter">dbdir</replaceable> ]
</para> </para>
</refsect2> </refsect2>
<refsect2 id="R2-APP-INITDB-2">
<refsect2info>
<date>1999-12-17</date>
</refsect2info>
<title>
Outputs
</title>
<para>
<application>initdb</application> will create files in the specified
data area which are the system tables and framework for a complete
installation.
</para>
</refsect2>
</refsynopsisdiv>
<refsect1 id="R1-APP-INITDB-1">
<refsect1info>
<date>1999-12-17</date>
</refsect1info>
<title>
Description
</title>
<para>
<application>initdb</application> creates a new
<productname>Postgres</productname> database system.
A database system is a
collection of databases that are all administered by the same Unix user
and managed by a single postmaster.
</para>
<para>
Creating a database system consists of creating the directories in which
the database data will live, generating the shared catalog tables
(tables that don't belong to any particular database), and
creating the <literal>template1</literal>
database. When you create a new database, everything in the
<literal>template1</literal> database is copied.
It contains catalog tables filled in for things like the
built-in types.
</para>
<para>
You must not execute <application>initdb</application> as root. This is
because you cannot run the database server as root either, but the
server needs to have access to the files <application>initdb</application>
creates. Furthermore, during the initialization phase, when there are no
users and no access controls installed, <productname>Postgres</productname>
will only connect with
the name of the current Unix user, so you must log in under the account
that will own the server process.
</para>
<para>
Although <application>initdb</application> will attempt to create the respective
data directory, chances are that it won't have the permission to do so. Thus
it is a good idea to create the data directory before running <application>initdb</application>
<emphasis>and</emphasis> to hand over the ownership of it to the database superuser.
</para>
</refsect1> </refsect1>
<refsect1>
<title>See also</title>
<simpara>
<citetitle>PostgreSQL Administrator's Guide</citetitle>
</simpara>
</refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file

View File

@ -1,75 +1,33 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/initlocation.sgml,v 1.10 2000/10/05 19:48:18 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/initlocation.sgml,v 1.11 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-INITLOCATION"> <refentry id="APP-INITLOCATION">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-INITLOCATION-TITLE"> <refentrytitle id="APP-INITLOCATION-TITLE"><application>initlocation</application></refentrytitle>
<application>initlocation</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname> <refname>initlocation</refname>
<application>initlocation</application> <refpurpose>Create a secondary <productname>Postgres</productname> database storage area</refpurpose>
</refname>
<refpurpose>
Create a secondary <productname>Postgres</productname> database storage area
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>2000-01-17</date> <command>initlocation</command>
</refsynopsisdivinfo> <arg choice="plain"><replaceable>directory</replaceable></arg>
<synopsis> </cmdsynopsis>
initlocation <replaceable class="parameter">directory</replaceable>
</synopsis>
<refsect2 id="R2-APP-INITLOCATION-1">
<refsect2info>
<date>1998-10-02</date>
</refsect2info>
<title>
Inputs
</title>
<para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">directory</replaceable></term>
<listitem>
<para>
Where in your Unix filesystem do you want alternate databases to go?
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
<refsect2 id="R2-APP-INITLOCATION-2">
<refsect2info>
<date>1998-09-26</date>
</refsect2info>
<title>
Outputs
</title>
<para>
<application>initlocation</application> will create directories in
the specified place.
</para>
</refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-INITLOCATION-1"> <refsect1 id="R1-APP-INITLOCATION-1">
<refsect1info> <title>Description</title>
<date>1998-09-26</date>
</refsect1info>
<title>
Description
</title>
<para> <para>
<application>initlocation</application> <application>initlocation</application>
creates a new <productname>Postgres</productname> secondary database storage area. creates a new <productname>Postgres</productname> secondary database storage area.
@ -85,33 +43,34 @@ initlocation <replaceable class="parameter">directory</replaceable>
</refsect1> </refsect1>
<refsect1 id="R1-APP-INITLOCATION-2"> <refsect1 id="R1-APP-INITLOCATION-2">
<refsect1info> <title>Usage</title>
<date>1998-09-26</date>
</refsect1info>
<title>
Usage
</title>
<para>
To create a database in an alternate location, using an environment variable:
<programlisting>
$ export PGDATA2=/opt/postgres/data
</programlisting>
Start and stop postmaster so it sees the $PGDATA2 environment variable.
The system must be configured so the postmaster sees $PGDATA2 every time it
starts.
<programlisting>
$ initlocation PGDATA2
$ createdb -D 'PGDATA2' 'testdb'
</programlisting>
</para>
<informalexample>
<para>
To create a database in an alternate location, using an
environment variable:
<screen>
<prompt>$ </prompt><userinput>export PGDATA2=/opt/postgres/data</userinput>
</screen>
Stop and start postmaster so it sees the <envar>PGDATA2</envar>
environment variable. The system must be configured so the
postmaster sees <envar>PGDATA2</envar> every time it starts. Finally:
<screen>
<prompt>$</prompt> <userinput>initlocation PGDATA2</userinput>
<prompt>$</prompt> <userinput>createdb -D PGDATA2 testdb</userinput>
</screen>
</para>
</informalexample>
<informalexample>
<para> <para>
Alternatively, if you allow absolute paths you could write: Alternatively, if you allow absolute paths you could write:
<programlisting> <screen>
$ initlocation /opt/postgres/data <prompt>$</prompt> <userinput>initlocation /opt/postgres/data</userinput>
$ createdb -D '/opt/postgres/data/testdb' testdb <prompt>$</prompt> <userinput>createdb -D /opt/postgres/data/testdb testdb</userinput>
</programlisting> </screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>

View File

@ -1,63 +1,32 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.2 2000/10/05 19:48:18 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.3 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-IPCCLEAN"> <refentry id="APP-IPCCLEAN">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-IPCCLEAN-TITLE"> <refentrytitle id="APP-IPCCLEAN-TITLE"><application>ipcclean</application></refentrytitle>
<application>ipcclean</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname> <refname>ipcclean</refname>
<application>ipcclean</application> <refpurpose>Clean up shared memory and semaphores from aborted backends</refpurpose>
</refname>
<refpurpose>
Clean up shared memory and semaphores from aborted backends
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-07-20</date> <command>ipcclean</command>
</refsynopsisdivinfo> </cmdsynopsis>
<synopsis>
ipcclean
</synopsis>
<refsect2 id="R2-APP-IPCCLEAN-1">
<refsect2info>
<date>1999-07-20</date>
</refsect2info>
<title>
Inputs
</title>
<para>
None.
</para>
</refsect2>
<refsect2 id="R2-APP-IPCCLEAN-2">
<refsect2info>
<date>1999-07-30</date>
</refsect2info>
<title>
Outputs
</title>
<para>
None.
</para>
</refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-IPCCLEAN-1"> <refsect1 id="R1-APP-IPCCLEAN-1">
<refsect1info> <title>Description</title>
<date>1999-07-20</date>
</refsect1info>
<title>
Description
</title>
<para> <para>
<application>ipcclean</application> <application>ipcclean</application>
cleans up shared memory and semaphore space from aborted backends by cleans up shared memory and semaphore space from aborted backends by

View File

@ -1,20 +1,32 @@
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.3 2000/10/20 13:44:39 thomas Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.4 2000/11/11 23:01:45 petere Exp $ -->
<refentry id="app-pgconfig"> <refentry id="app-pgconfig">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="app-pgconfig-title">pg_config</> <refentrytitle id="app-pgconfig-title">pg_config</refentrytitle>
<refmiscinfo>Application</> <manvolnum>1</manvolnum>
<refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname>pg_config</> <refname>pg_config</refname>
<refpurpose>Provides information about the installed version of <productname>PostgreSQL</></> <refpurpose>Provides information about the installed version of <productname>PostgreSQL</></refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<synopsis> <cmdsynopsis>
pg_config --bindir | --includedir | --libdir | --configure | --version <command>pg_config</command>
</synopsis> <group choice="req" rep="repeat">
<arg>--bindir</arg>
<arg>--includedir</arg>
<arg>--libdir</arg>
<arg>--configure</arg>
<arg>--version</arg>
</group>
</cmdsynopsis>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1> <refsect1>

View File

@ -1,37 +1,44 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.9 2000/05/02 20:02:03 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.10 2000/11/11 23:01:45 petere Exp $
Postgres documentation Postgres documentation
--> -->
<refentry id="APP-VACUUMDB"> <refentry id="APP-VACUUMDB">
<docinfo>
<date>2000-11-11</date>
</docinfo>
<refmeta> <refmeta>
<refentrytitle id="APP-VACUUMDB-TITLE"> <refentrytitle id="APP-VACUUMDB-TITLE"><application>vacuumdb</application></refentrytitle>
<application>vacuumdb</application> <manvolnum>1</manvolnum>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo> <refmiscinfo>Application</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname id="vacuumdb"> <refname id="vacuumdb">vacuumdb</refname>
<application>vacuumdb</application> <refpurpose>Clean and analyze a <productname>Postgres</productname> database</refpurpose>
</refname>
<refpurpose>
Clean and analyze a <productname>Postgres</productname> database
</refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <cmdsynopsis>
<date>1999-12-04</date> <command>vacuumdb</command>
</refsynopsisdivinfo> <arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<synopsis> <arg><arg>-d</arg> <replaceable>dbname</replaceable></arg>
vacuumdb [ <replaceable class="parameter">options</replaceable> ] [ --analyze | -z ] <group><arg>--analyze</arg><arg>-z</arg></group>
[ --alldb | -a ] [ --verbose | -v ] <group><arg>--verbose</arg><arg>-v</arg></group>
[ --table '<replaceable class="parameter">table</replaceable> [ ( <replaceable class="parameter">column</replaceable> [,...] ) ]' ] [ [-d] <replaceable class="parameter">dbname</replaceable> ] <sbr>
</synopsis> <arg>--table '<replaceable>table</replaceable>
<arg>( <replaceable class="parameter">column</replaceable> [,...] )</arg>'
</arg>
<sbr>
<command>vacuumdb</command>
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<group><arg>--all</arg><arg>-a</arg></group>
<group><arg>--analyze</arg><arg>-z</arg></group>
<group><arg>--verbose</arg><arg>-v</arg></group>
</cmdsynopsis>
<refsect2 id="R2-APP-VACUUMDB-1"> <refsect2 id="R2-APP-VACUUMDB-1">
<refsect2info>
<date>1999-12-04</date>
</refsect2info>
<title> <title>
Inputs Inputs
</title> </title>
@ -174,9 +181,6 @@ vacuumdb [ <replaceable class="parameter">options</replaceable> ] [ --analyze |
</refsect2> </refsect2>
<refsect2 id="R2-APP-VACUUMDB-2"> <refsect2 id="R2-APP-VACUUMDB-2">
<refsect2info>
<date>1999-12-04</date>
</refsect2info>
<title> <title>
Outputs Outputs
</title> </title>
@ -213,9 +217,6 @@ vacuumdb [ <replaceable class="parameter">options</replaceable> ] [ --analyze |
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-APP-VACUUMDB-1"> <refsect1 id="R1-APP-VACUUMDB-1">
<refsect1info>
<date>1999-12-04</date>
</refsect1info>
<title> <title>
Description Description
</title> </title>
@ -243,34 +244,37 @@ vacuumdb [ <replaceable class="parameter">options</replaceable> ] [ --analyze |
</refsect1> </refsect1>
<refsect1 id="R1-APP-VACUUMDB-3"> <refsect1 id="R1-APP-VACUUMDB-3">
<refsect1info> <title>Usage</title>
<date>1998-10-04</date>
</refsect1info>
<title>
Usage
</title>
<informalexample>
<para> <para>
To clean the database <literal>test</literal>: To clean the database <literal>test</literal>:
<programlisting> <screen>
$ vacuumdb test <prompt>$ </prompt><userinput>vacuumdb test</userinput>
</programlisting> </screen>
</para> </para>
</informalexample>
<informalexample>
<para> <para>
To analyze a database named <literal>bigdb</literal> for the optimizer: To analyze for the optimzer a database named
<programlisting> <literal>bigdb</literal>:
$ vacuumdb --analyze bigdb <screen>
</programlisting> <prompt>$ </prompt><userinput>vacuumdb --analyze bigdb</userinput>
</screen>
</para> </para>
</informalexample>
<informalexample>
<para> <para>
To analyze a single column <literal>bar</literal> in table <literal>foo</literal> To analyze a single column <literal>bar</literal> in table
in a database named <literal>xyzzy</literal> for the optimizer: <literal>foo</literal> in a database named
<programlisting> <literal>xyzzy</literal> for the optimizer:
$ vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy <screen>
</programlisting> <prompt>$ </prompt><userinput>vacuumdb --analyze --verbose --table 'foo(bar)' xyzzy</userinput>
</screen>
</para> </para>
</informalexample>
</refsect1> </refsect1>
</refentry> </refentry>