Commit a4ac2f45 authored by Thomas G. Lockhart's avatar Thomas G. Lockhart

Fix markup for docbook2man man page generation.

No big deal; fixed lots of other markup at the same time.
Bigest change: make sure there is no whitespace
 in front of <term> contents.
This will probably help the other output types too.
parent 192a66e3
<REFENTRY ID="SQL-ABORT"> <refentry id="SQL-ABORT">
<REFMETA> <refmeta>
<REFENTRYTITLE> <refentrytitle>
ABORT ABORT
</REFENTRYTITLE> </refentrytitle>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO> <refmiscinfo>SQL - Language Statements</refmiscinfo>
</REFMETA> </refmeta>
<REFNAMEDIV> <refnamediv>
<REFNAME> <refname>
ABORT ABORT
</REFNAME> </refname>
<REFPURPOSE> <refpurpose>
Aborts the current transaction Aborts the current transaction
</REFPURPOSE> </refpurpose>
</REFNAMEDIV> </refnamediv>
<REFSYNOPSISDIV> <refsynopsisdiv>
<REFSYNOPSISDIVINFO> <refsynopsisdivinfo>
<DATE>1998-09-27</DATE> <date>1998-09-27</date>
</REFSYNOPSISDIVINFO> </refsynopsisdivinfo>
<SYNOPSIS> <synopsis>
ABORT ABORT [ TRANSACTION | WORK ]
</SYNOPSIS> </synopsis>
<REFSECT2 ID="R2-SQL-ABORT-1"> <refsect2 id="R2-SQL-ABORT-1">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-27</DATE> <date>1998-09-27</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Inputs Inputs
</TITLE> </title>
<PARA>
None.
</para>
</REFSECT2> <para>
None.
</para>
</refsect2>
<REFSECT2 ID="R2-SQL-ABORT-2"> <refsect2 id="R2-SQL-ABORT-2">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-27</DATE> <date>1998-09-27</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Outputs Outputs
</TITLE> </title>
<PARA>
<VARIABLELIST> <para>
<VARLISTENTRY>
<TERM> <variablelist>
ABORT <varlistentry>
</TERM> <term><computeroutput>
<LISTITEM> ABORT
<PARA> </computeroutput></term>
Message returned if successful. <listitem>
</para> <para>
</listitem> Message returned if successful.
</VARLISTENTRY> </para>
<VARLISTENTRY> </listitem>
<TERM> </varlistentry>
<varlistentry>
<term><computeroutput>
NOTICE: UserAbortTransactionBlock and not in in-progress state NOTICE: UserAbortTransactionBlock and not in in-progress state
ABORT ABORT
</TERM> </computeroutput></term>
<LISTITEM> <listitem>
<PARA> <para>
If there is not any transaction currently in progress. If there is not any transaction currently in progress.
</para> </para>
</listitem> </listitem>
</VARLISTENTRY> </varlistentry>
</VARIABLELIST> </variablelist>
</para> </para>
</REFSECT2> </refsect2>
</REFSYNOPSISDIV> </refsynopsisdiv>
<REFSECT1 ID="R1-SQL-ABORT-1"> <refsect1 id="R1-SQL-ABORT-1">
<REFSECT1INFO> <refsect1info>
<DATE>1998-09-27</DATE> <date>1998-09-27</date>
</REFSECT1INFO> </refsect1info>
<TITLE> <title>
Description Description
</TITLE> </title>
<PARA> <para>
<command>ABORT</command> rolls back the current transaction and causes <command>ABORT</command> rolls back the current transaction and causes
all the updates made by the transaction to be discarded. all the updates made by the transaction to be discarded.
This command is identical This command is identical
in behavior to the <acronym>SQL92</acronym> command <command>ROLLBACK</command>, in behavior to the <acronym>SQL92</acronym> command <command>ROLLBACK</command>,
and is present only for historical reasons. and is present only for historical reasons.
</para> </para>
<REFSECT2 ID="R2-SQL-ABORT-3"> <refsect2 id="R2-SQL-ABORT-3">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-27</DATE> <date>1998-09-27</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Notes Notes
</TITLE> </title>
<para> <para>
Use the <command>COMMIT</command> statement to successfully Use <command>COMMIT</command> to successfully
terminate a transaction. terminate a transaction.
</para> </para>
</refsect2> </refsect2>
</REFSECT1> </refsect1>
<REFSECT1 ID="R1-SQL-ABORT-2"> <refsect1 id="R1-SQL-ABORT-2">
<TITLE> <title>
Usage Usage
</TITLE> </title>
<PARA> <para>
<ProgramListing> To abort all changes:
--To abort all changes <programlisting>
--
ABORT WORK; ABORT WORK;
</ProgramListing> </programlisting>
</para> </para>
</refsect1>
</REFSECT1> <refsect1 id="R1-SQL-ABORT-3">
<title>
Compatibility
</title>
<REFSECT1 ID="R1-SQL-ABORT-3"> <refsect2 id="R2-SQL-ABORT-4">
<TITLE> <refsect2info>
Compatibility <date>1998-09-27</date>
</TITLE> </refsect2info>
<title>
SQL92
</title>
<para>
This command is a <productname>Postgres</productname> extension present
for historical reasons. <command>ROLLBACK</command> is the <acronym>SQL92</acronym>
equivalent command.
</para>
</refsect2>
</refsect1>
<REFSECT2 ID="R2-SQL-ABORT-4"> </refentry>
<REFSECT2INFO>
<DATE>1998-09-27</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<para>
This command is a <productname>Postgres</productname> extension present
for historical reasons. <command>ROLLBACK</command> is the <acronym>SQL92</acronym>
equivalent command.
</PARA>
</refsect2>
</refsect1>
</REFENTRY> <!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->
This diff is collapsed.
This diff is collapsed.
...@@ -30,7 +30,7 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -30,7 +30,7 @@ BEGIN [ WORK | TRANSACTION ]
Inputs Inputs
</title> </title>
<para> <para>
None None.
</para> </para>
</refsect2> </refsect2>
...@@ -45,9 +45,9 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -45,9 +45,9 @@ BEGIN [ WORK | TRANSACTION ]
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term><computeroutput>
<returnvalue>BEGIN</returnvalue> BEGIN
</term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
This signifies that a new transaction has been started. This signifies that a new transaction has been started.
...@@ -55,9 +55,9 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -55,9 +55,9 @@ BEGIN [ WORK | TRANSACTION ]
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term><computeroutput>
<returnvalue>NOTICE: BeginTransactionBlock and not in default state</returnvalue> NOTICE: BeginTransactionBlock and not in default state
</term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
This indicates that a transaction was already in progress. This indicates that a transaction was already in progress.
......
<REFENTRY ID="SQL-CLOSE"> <refentry id="SQL-CLOSE">
<REFMETA> <refmeta>
<REFENTRYTITLE> <refentrytitle>
CLOSE CLOSE
</REFENTRYTITLE> </refentrytitle>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO> <refmiscinfo>SQL - Language Statements</refmiscinfo>
</REFMETA> </refmeta>
<REFNAMEDIV> <refnamediv>
<REFNAME> <refname>
CLOSE CLOSE
</REFNAME> </refname>
<REFPURPOSE> <refpurpose>
Close a cursor Close a cursor
</REFPURPOSE> </refpurpose>
</refnamediv> </refnamediv>
<REFSYNOPSISDIV> <refsynopsisdiv>
<REFSYNOPSISDIVINFO> <refsynopsisdivinfo>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSYNOPSISDIVINFO> </refsynopsisdivinfo>
<SYNOPSIS> <synopsis>
CLOSE <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> CLOSE <replaceable class="PARAMETER">cursor</replaceable>
</SYNOPSIS> </synopsis>
<REFSECT2 ID="R2-SQL-CLOSE-1"> <refsect2 id="R2-SQL-CLOSE-1">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Inputs Inputs
</TITLE> </title>
<PARA> <para>
<VARIABLELIST>
<VARLISTENTRY> <variablelist>
<TERM> <varlistentry>
<REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> <term><replaceable class="PARAMETER">cursor</replaceable></term>
</TERM> <listitem>
<LISTITEM> <para>
<PARA> The name of an open cursor to close.
The name of an open cursor to close. </para>
</PARA> </listitem>
</LISTITEM> </varlistentry>
</VARLISTENTRY> </variablelist>
</variablelist>
</para> </para>
</REFSECT2> </refsect2>
<REFSECT2 ID="R2-SQL-CLOSE-2"> <refsect2 id="R2-SQL-CLOSE-2">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Outputs Outputs
</TITLE> </title>
<PARA> <para>
<VARIABLELIST>
<VARLISTENTRY> <variablelist>
<TERM> <varlistentry>
<ReturnValue>CLOSE</ReturnValue> <term><computeroutput>
</TERM> CLOSE
<LISTITEM> </computeroutput></term>
<PARA> <listitem>
Message returned if the cursor is successfully closed. <para>
</PARA> Message returned if the cursor is successfully closed.
</LISTITEM> </para>
</VARLISTENTRY> </listitem>
<VARLISTENTRY> </varlistentry>
<TERM> <varlistentry>
<ReturnValue>NOTICE PerformPortalClose: portal "<REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE>" not found</ReturnValue> <term><computeroutput>
</TERM> NOTICE PerformPortalClose: portal "<replaceable class="PARAMETER">cursor</replaceable>" not found
<LISTITEM> </computeroutput></term>
<PARA> <listitem>
This warning is given if <para>
<REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> is not This warning is given if
declared or has already been closed. <replaceable class="PARAMETER">cursor</replaceable> is not
declared or has already been closed.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</VARIABLELIST> </variablelist>
</para> </para>
</REFSECT2> </refsect2>
</REFSYNOPSISDIV> </refsynopsisdiv>
<REFSECT1 ID="R1-SQL-CLOSE-1"> <refsect1 id="R1-SQL-CLOSE-1">
<REFSECT1INFO> <refsect1info>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSECT1INFO> </refsect1info>
<TITLE> <title>
Description Description
</TITLE> </title>
<PARA> <para>
<command>CLOSE</command> frees the resources associated with an open cursor. <command>CLOSE</command> frees the resources associated with an open cursor.
After the cursor is closed, no subsequent operations After the cursor is closed, no subsequent operations
are allowed on it. A cursor should be closed when it is are allowed on it. A cursor should be closed when it is
no longer needed. no longer needed.
</PARA> </para>
<PARA> <para>
An implicit close is executed for every open cursor when a An implicit close is executed for every open cursor when a
transaction is terminated by <command>COMMIT</command> transaction is terminated by <command>COMMIT</command>
or <command>ROLLBACK</command>. or <command>ROLLBACK</command>.
</PARA> </para>
<REFSECT2 ID="R2-SQL-CLOSE-3"> <refsect2 id="R2-SQL-CLOSE-3">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Notes Notes
</TITLE> </title>
<PARA> <para>
<productname>Postgres</productname> does not have <productname>Postgres</productname> does not have
an explicit <command>OPEN</command> cursor statement; an explicit <command>OPEN</command> cursor statement;
a cursor is considered open when it is declared. a cursor is considered open when it is declared.
Use the <command>DECLARE</command> statement to declare a cursor. Use the <command>DECLARE</command> statement to declare a cursor.
</PARA> </para>
</REFSECT2> </refsect2>
</refsect1> </refsect1>
<REFSECT1 ID="R1-SQL-CLOSE-2"> <refsect1 id="R1-SQL-CLOSE-2">
<TITLE> <title>
Usage Usage
</TITLE> </title>
<PARA> <para>
Close the cursor liahona: Close the cursor liahona:
</PARA> </para>
<ProgramListing> <programlisting>
CLOSE liahona; CLOSE liahona;
</ProgramListing> </programlisting>
</REFSECT1> </refsect1>
<REFSECT1 ID="R1-SQL-CLOSE-3"> <refsect1 id="R1-SQL-CLOSE-3">
<TITLE> <title>
Compatibility Compatibility
</TITLE> </title>
<PARA> <para>
</PARA> </para>
<REFSECT2 ID="R2-SQL-CLOSE-4"> <refsect2 id="R2-SQL-CLOSE-4">
<REFSECT2INFO> <refsect2info>
<DATE>1998-09-08</DATE> <date>1998-09-08</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
SQL92 SQL92
</TITLE> </title>
<PARA> <para>
<command>CLOSE</command> is fully compatible with SQL92. <command>CLOSE</command> is fully compatible with SQL92.
</PARA> </para>
</refsect2> </refsect2>
</refsect1> </refsect1>
</REFENTRY> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
......
This diff is collapsed.
...@@ -30,7 +30,7 @@ COMMIT [ WORK | TRANSACTION ] ...@@ -30,7 +30,7 @@ COMMIT [ WORK | TRANSACTION ]
Inputs Inputs
</title> </title>
<para> <para>
None None.
</para> </para>
</refsect2> </refsect2>
...@@ -45,9 +45,9 @@ COMMIT [ WORK | TRANSACTION ] ...@@ -45,9 +45,9 @@ COMMIT [ WORK | TRANSACTION ]
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term><computeroutput>
<returnvalue>END</returnvalue> END
</term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
Message returned if the transaction is successfully committed. Message returned if the transaction is successfully committed.
...@@ -55,9 +55,9 @@ COMMIT [ WORK | TRANSACTION ] ...@@ -55,9 +55,9 @@ COMMIT [ WORK | TRANSACTION ]
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term><computeroutput>
<returnvalue>NOTICE EndTransactionBlock and not inprogress/abort state</returnvalue> NOTICE EndTransactionBlock and not inprogress/abort state
</term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
If there is no transaction in progress. If there is no transaction in progress.
......
This diff is collapsed.
This diff is collapsed.
<REFENTRY ID="SQL-CREATEDATABASE"> <refentry id="SQL-CREATEDATABASE">
<REFMETA> <refmeta>
<REFENTRYTITLE> <refentrytitle>
CREATE DATABASE CREATE DATABASE
</REFENTRYTITLE> </refentrytitle>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO> <refmiscinfo>SQL - Language Statements</refmiscinfo>
</REFMETA> </refmeta>
<REFNAMEDIV> <refnamediv>
<REFNAME> <refname>
CREATE DATABASE CREATE DATABASE
</REFNAME> </refname>
<REFPURPOSE> <refpurpose>
Creates a new database Creates a new database
</REFPURPOSE> </refpurpose>
</refnamediv> </refnamediv>
<REFSYNOPSISDIV> <refsynopsisdiv>
<REFSYNOPSISDIVINFO> <refsynopsisdivinfo>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSYNOPSISDIVINFO> </refsynopsisdivinfo>
<SYNOPSIS> <synopsis>
CREATE DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> [ WITH LOCATION = '<replaceable class="parameter">dbpath</replaceable>' ] CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATION = '<replaceable class="parameter">dbpath</replaceable>' ]
</SYNOPSIS> </synopsis>
<REFSECT2 ID="R2-SQL-CREATEDATABASE-1"> <refsect2 id="R2-SQL-CREATEDATABASE-1">
<REFSECT2INFO> <refsect2info>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Inputs Inputs
</TITLE> </title>
<PARA> <para>
<VARIABLELIST>
<VARLISTENTRY> <variablelist>
<TERM> <varlistentry>
<replaceable class="parameter">name</replaceable> <term><replaceable class="parameter">name</replaceable></term>
</TERM> <listitem>
<LISTITEM> <para>
<PARA> The name of a database to create.
The name of a database to create. </para>
</PARA> </listitem>
</LISTITEM> </varlistentry>
</VARLISTENTRY> <varlistentry>
<VARLISTENTRY> <term><replaceable class="parameter">dbpath</replaceable></term>
<TERM> <listitem>
<replaceable class="parameter">dbpath</replaceable> <para>
</TERM> An alternate location can be specified as either an
<LISTITEM> environment variable known to the backend server
<PARA> (e.g. '<envar>PGDATA2</envar>') or as an absolute path name
An alternate location can be specified as either an (e.g. '<filename>/usr/local/pgsql/data</filename>').
environment variable known to the backend server In either case, the location must be pre-configured
(e.g. '<envar>PGDATA2</envar>') or as an absolute path name by <command>initlocation</command>.
(e.g. '<filename>/usr/local/pgsql/data</filename>'). </para>
In either case, the location must be pre-configured </listitem>
by <command>initlocation</command>. </varlistentry>
</PARA> </variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</para> </para>
</REFSECT2> </refsect2>
<REFSECT2 ID="R2-SQL-CREATEDATABASE-2"> <refsect2 id="R2-SQL-CREATEDATABASE-2">
<REFSECT2INFO> <refsect2info>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Outputs Outputs
</TITLE> </title>
<PARA> <para>
<VARIABLELIST> <variablelist>
<VARLISTENTRY> <varlistentry>
<TERM> <term><computeroutput>
<ReturnValue>CREATEDB</ReturnValue> CREATEDB
</TERM> </computeroutput></term>
<LISTITEM> <listitem>
<PARA> <para>
Message returned if the command completes successfully. Message returned if the command completes successfully.
</PARA> </para>
</LISTITEM> </listitem>
</VARLISTENTRY> </varlistentry>
<VARLISTENTRY> <varlistentry>
<TERM> <term><computeroutput>
<ReturnValue>WARN: createdb: database "<replaceable class="parameter">name</replaceable>" already exists.</ReturnValue> WARN: createdb: database "<replaceable class="parameter">name</replaceable>" already exists.
</TERM> </computeroutput></term>
<LISTITEM> <listitem>
<PARA> <para>
This occurs if <replaceable class="parameter">database</replaceable> specified already exists. This occurs if <replaceable class="parameter">database</replaceable> specified already exists.
</PARA> </para>
</LISTITEM> </listitem>
</VARLISTENTRY> </varlistentry>
<VARLISTENTRY> <varlistentry>
<TERM> <term><computeroutput>
<ReturnValue>ERROR: Unable to create database directory <replaceable class="parameter">directory</replaceable> ERROR: Unable to create database directory <replaceable class="parameter">directory</replaceable>
</ReturnValue> </computeroutput></term>
</TERM> <listitem>
<LISTITEM> <para>
<PARA>
There was a problem with creating the required directory; this operation will There was a problem with creating the required directory; this operation will
need permissions for the <literal>postgres</literal> user on the specified location. need permissions for the <literal>postgres</literal> user on the specified location.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</VARIABLELIST> </variablelist>
</para> </para>
</REFSECT2> </refsect2>
</REFSYNOPSISDIV> </refsynopsisdiv>
<REFSECT1 ID="R1-SQL-CREATEDATABASE-1"> <refsect1 id="R1-SQL-CREATEDATABASE-1">
<REFSECT1INFO> <refsect1info>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSECT1INFO> </refsect1info>
<TITLE> <title>
Description Description
</TITLE> </title>
<PARA> <para>
<command>CREATE DATABASE</command> creates a new Postgres database. <command>CREATE DATABASE</command> creates a new Postgres database.
The creator becomes the administrator of the new database. The creator becomes the administrator of the new database.
</PARA> </para>
<REFSECT2 ID="R2-SQL-CREATEDATABASE-3"> <refsect2 id="R2-SQL-CREATEDATABASE-3">
<REFSECT2INFO> <refsect2info>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Notes Notes
</TITLE> </title>
<PARA> <para>
<command>CREATE DATABASE</command> is a <productname>Postgres</productname> <command>CREATE DATABASE</command> is a <productname>Postgres</productname>
language extension. language extension.
</PARA> </para>
<para> <para>
Use <command>DROP DATABASE</command> to remove a database. Use <command>DROP DATABASE</command> to remove a database.
</para> </para>
</REFSECT2> </refsect2>
</refsect1> </refsect1>
<REFSECT1 ID="R1-SQL-CREATEDATABASE-2"> <refsect1 id="R1-SQL-CREATEDATABASE-2">
<TITLE> <title>
Usage Usage
</TITLE> </title>
<PARA> <para>
To create a new database: To create a new database:
</PARA>
<ProgramListing> <programlisting>
<prompt>olly=></prompt> <userinput>create database lusiadas;</userinput> <prompt>olly=></prompt> <userinput>create database lusiadas;</userinput>
</ProgramListing> </programlisting>
<PARA> </para>
<para>
To create a new database in an alternate area <filename>~/private_db</filename>: To create a new database in an alternate area <filename>~/private_db</filename>:
</PARA>
<ProgramListing> <programlisting>
<prompt>$</prompt> <userinput>mkdir private_db</userinput> <prompt>$</prompt> <userinput>mkdir private_db</userinput>
<prompt>$</prompt> <userinput>initlocation ~/private_db</userinput> <prompt>$</prompt> <userinput>initlocation ~/private_db</userinput>
<computeroutput>Creating Postgres database system directory /home/olly/private_db/base</computeroutput> <computeroutput>Creating Postgres database system directory /home/olly/private_db/base</computeroutput>
<prompt>$</prompt> <userinput>psql olly</userinput> <prompt>$</prompt> <userinput>psql olly</userinput>
<computeroutput>Welcome to the POSTGRESQL interactive sql monitor: <computeroutput>Welcome to the POSTGRESQL interactive sql monitor:
...@@ -164,21 +162,22 @@ CREATE DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> [ WITH LOCATIO ...@@ -164,21 +162,22 @@ CREATE DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> [ WITH LOCATIO
<prompt>olly=></prompt></computeroutput> <userinput>create database elsewhere with location = '/home/olly/private_db';</userinput> <prompt>olly=></prompt></computeroutput> <userinput>create database elsewhere with location = '/home/olly/private_db';</userinput>
<computeroutput>CREATEDB</computeroutput> <computeroutput>CREATEDB</computeroutput>
</ProgramListing> </programlisting>
</REFSECT1> </para>
</refsect1>
<REFSECT1 ID="R1-SQL-CREATEDATABASE-3">
<TITLE> <refsect1 id="R1-SQL-CREATEDATABASE-3">
<title>
Bugs Bugs
</TITLE> </title>
<PARA> <para>
There are security and data integrity issues There are security and data integrity issues
involved with using alternate database locations involved with using alternate database locations
specified with absolute path names, and by default specified with absolute path names, and by default
only an environment variable known to the backend may be only an environment variable known to the backend may be
specified for an alternate location. specified for an alternate location.
See the Administrator's Guide for more information. See the Administrator's Guide for more information.
</PARA> </para>
</refsect1> </refsect1>
<!-- <!--
...@@ -192,33 +191,32 @@ Hmm. This isn't an issue since the upgrade would do a dump/reload from the main ...@@ -192,33 +191,32 @@ Hmm. This isn't an issue since the upgrade would do a dump/reload from the main
Not sure if the dump/reload would guarantee that the alternate data area gets refreshed though... Not sure if the dump/reload would guarantee that the alternate data area gets refreshed though...
--> -->
<REFSECT1 ID="R1-SQL-CREATEDATABASE-4"> <refsect1 id="R1-SQL-CREATEDATABASE-4">
<TITLE> <title>
Compatibility Compatibility
</TITLE> </title>
<REFSECT2 ID="R2-SQL-CREATEDATABASE-4"> <refsect2 id="R2-SQL-CREATEDATABASE-4">
<REFSECT2INFO> <refsect2info>
<DATE>1998-04-15</DATE> <date>1998-04-15</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
SQL92 SQL92
</TITLE> </title>
<PARA> <para>
There is no <command>CREATE DATABASE</command> statement in SQL92. There is no <command>CREATE DATABASE</command> statement in SQL92.
</PARA> </para>
<para> <para>
The equivalent command in standard SQL is <command>CREATE SCHEMA</command>. The equivalent command in standard SQL is <command>CREATE SCHEMA</command>.
</para> </para>
</refsect2> </refsect2>
</refsect1> </refsect1>
</REFENTRY> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode: sgml
sgml-omittag:t sgml-omittag:nil
sgml-shorttag:t sgml-shorttag:t
sgml-minimize-attributes:nil sgml-minimize-attributes:nil
sgml-always-quote-attributes:t sgml-always-quote-attributes:t
......
...@@ -32,41 +32,34 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -32,41 +32,34 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
Inputs Inputs
</title> </title>
<para> <para>
<variablelist>
<varlistentry> <variablelist>
<term> <varlistentry>
<replaceable class="parameter">name</replaceable> <term><replaceable class="parameter">name</replaceable></term>
</term> <listitem>
<listitem> <para>
<para> The name of a function to create.
The name of a function to create. </para>
</para> </listitem>
</listitem> </varlistentry>
</varlistentry> <varlistentry>
<varlistentry> <term><replaceable class="parameter">ftype</replaceable></term>
<term> <listitem>
<replaceable class="parameter">ftype</replaceable> <para>
</term> The data type of function arguments.
<listitem> </para>
<para> </listitem>
The data type of function arguments. </varlistentry>
</para> <varlistentry>
</listitem> <term><replaceable class="parameter">rtype</replaceable></term>
</varlistentry> <listitem>
<varlistentry> <para>
<term> The return data type.
<replaceable class="parameter">rtype</replaceable> </para>
</term> </listitem>
<listitem> </varlistentry>
<para> <varlistentry>
The return data type. <term><replaceable class="parameter">definition</replaceable></term>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<replaceable class="parameter">definition</replaceable>
</term>
<listitem> <listitem>
<para> <para>
A string defining the function; the meaning depends on the language. A string defining the function; the meaning depends on the language.
...@@ -76,9 +69,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -76,9 +69,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term><replaceable class="parameter">langname</replaceable></term>
<replaceable class="parameter">langname</replaceable>
</term>
<listitem> <listitem>
<para> <para>
may be '<literal>C</literal>', '<literal>sql</literal>', may be '<literal>C</literal>', '<literal>sql</literal>',
...@@ -93,7 +84,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -93,7 +84,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
</variablelist> </variablelist>
</para> </para>
</refsect2> </refsect2>
<refsect2 id="R2-SQL-CREATEFUNCTION-2"> <refsect2 id="R2-SQL-CREATEFUNCTION-2">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>1998-09-09</date>
...@@ -102,12 +93,12 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -102,12 +93,12 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
Outputs Outputs
</title> </title>
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term><computeroutput>
<returnvalue>CREATE</returnvalue> CREATE
</term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
This is returned if the command completes successfully. This is returned if the command completes successfully.
...@@ -118,7 +109,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -118,7 +109,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
</para> </para>
</refsect2> </refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-SQL-CREATEFUNCTION-1"> <refsect1 id="R1-SQL-CREATEFUNCTION-1">
<refsect1info> <refsect1info>
<date>1998-09-09</date> <date>1998-09-09</date>
...@@ -188,20 +179,21 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle> ...@@ -188,20 +179,21 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle>
</title> </title>
<para> <para>
To create a simple SQL function: To create a simple SQL function:
</para>
<programlisting> <programlisting>
CREATE FUNCTION one() RETURNS int4 CREATE FUNCTION one() RETURNS int4
AS 'SELECT 1 AS RESULT' AS 'SELECT 1 AS RESULT'
LANGUAGE 'sql'; LANGUAGE 'sql';
SELECT one() AS answer;
SELECT one() AS answer;
<computeroutput> <computeroutput>
answer answer
------ ------
1 1
</computeroutput> </computeroutput>
</programlisting> </programlisting>
</para>
<para> <para>
To create a C function, calling a routine from a user-created To create a C function, calling a routine from a user-created
shared library. This particular routine calculates a check shared library. This particular routine calculates a check
...@@ -210,16 +202,16 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle> ...@@ -210,16 +202,16 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle>
</para> </para>
<programlisting> <programlisting>
<userinput> <userinput>
CREATE FUNCTION ean_checkdigit(bpchar, bpchar) RETURNS bool CREATE FUNCTION ean_checkdigit(bpchar, bpchar) RETURNS bool
AS '/usr1/proj/bray/sql/funcs.so' LANGUAGE 'c'; AS '/usr1/proj/bray/sql/funcs.so' LANGUAGE 'c';
CREATE TABLE product ( CREATE TABLE product (
id char(8) PRIMARY KEY, id char(8) PRIMARY KEY,
eanprefix char(8) CHECK (eanprefix ~ '[0-9]{2}-[0-9]{5}') eanprefix char(8) CHECK (eanprefix ~ '[0-9]{2}-[0-9]{5}')
REFERENCES brandname(ean_prefix), REFERENCES brandname(ean_prefix),
eancode char(6) CHECK (eancode ~ '[0-9]{6}'), eancode char(6) CHECK (eancode ~ '[0-9]{6}'),
CONSTRAINT ean CHECK (ean_checkdigit(eanprefix, eancode)) CONSTRAINT ean CHECK (ean_checkdigit(eanprefix, eancode))
); );
</userinput> </userinput>
</programlisting> </programlisting>
</refsect1> </refsect1>
...@@ -232,16 +224,16 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle> ...@@ -232,16 +224,16 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle>
A C function cannot return a set of values. A C function cannot return a set of values.
</para> </para>
</refsect1> </refsect1>
<refsect1 id="R1-SQL-CREATEFUNCTION-4"> <refsect1 id="R1-SQL-CREATEFUNCTION-4">
<title> <title>
Compatibility Compatibility
</title> </title>
<para> <para>
<command>CREATE FUNCTION</command> is <command>CREATE FUNCTION</command> is
a <productname>Postgres</productname> language extension. a <productname>Postgres</productname> language extension.
</para> </para>
<refsect2 id="R2-SQL-CREATEFUNCTION-4"> <refsect2 id="R2-SQL-CREATEFUNCTION-4">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>1998-09-09</date>
...@@ -251,27 +243,26 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle> ...@@ -251,27 +243,26 @@ in the <citetitle>PostgreSQL Programmer's Guide</citetitle>
</title> </title>
<para> <para>
<note> <note>
<para> <para>
PSM stands for Persistent Stored Modules. It is a procedural PSM stands for Persistent Stored Modules. It is a procedural
language and it was originally hoped that PSM would be ratified language and it was originally hoped that PSM would be ratified
as an official standard by late 1996. As of mid-1998, this as an official standard by late 1996. As of mid-1998, this
has not yet happened, but it is hoped that PSM will has not yet happened, but it is hoped that PSM will
eventually become a standard. eventually become a standard.
</para> </para>
</note> </note>
SQL/PSM <command>CREATE FUNCTION</command> has the following syntax: SQL/PSM <command>CREATE FUNCTION</command> has the following syntax:
<synopsis> <synopsis>
CREATE FUNCTION <replaceable class="parameter">name</replaceable> CREATE FUNCTION <replaceable class="parameter">name</replaceable>
( [ [ IN | OUT | INOUT ] <replaceable class="parameter">eter</replaceable>eable> <replaceable ( [ [ IN | OUT | INOUT ] <replaceable class="parameter">eter</replaceable>eable>eable> <replaceable
class="parameter">type</replaceable> [, ...] ] ) class="parameter">type</replaceable> [, ...] ] )
RETURNS <replaceable class="parameter">rtype</replaceable> RETURNS <replaceable class="parameter">rtype</replaceable>
LANGUAGE '<replaceable class="parameter">langname</replaceable>' LANGUAGE '<replaceable class="parameter">langname</replaceable>'
ESPECIFIC <replaceable class="parameter">routine</replaceable> ESPECIFIC <replaceable class="parameter">routine</replaceable>
<replaceable class="parameter">SQL-statement</replaceable> <replaceable class="parameter">SQL-statement</replaceable>
</synopsis> </synopsis>
</para> </para>
</refsect2> </refsect2>
</refsect1> </refsect1>
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
...@@ -33,9 +33,7 @@ CREATE TABLE <replaceable>table</replaceable> [ (<replaceable>column</replaceabl ...@@ -33,9 +33,7 @@ CREATE TABLE <replaceable>table</replaceable> [ (<replaceable>column</replaceabl
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term><replaceable>table</replaceable></term>
<replaceable>table</replaceable>
</term>
<listitem> <listitem>
<para> <para>
The name of a new table to be created. The name of a new table to be created.
...@@ -44,25 +42,21 @@ CREATE TABLE <replaceable>table</replaceable> [ (<replaceable>column</replaceabl ...@@ -44,25 +42,21 @@ CREATE TABLE <replaceable>table</replaceable> [ (<replaceable>column</replaceabl
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term><replaceable>column</replaceable></term>
<replaceable>column</replaceable> <listitem>
</term> <para>
<listitem> The name of a column. Multiple column names can be specified using
<para> a comma-delimited list of column names.
The name of a column. Multiple column names can be specified using </para>
a comma-delimited list of column names. </listitem>
</para> </varlistentry>
</listitem>
</varlistentry> <varlistentry>
<term><replaceable>select_clause</replaceable></term>
<varlistentry> <listitem>
<term> <para>
<replaceable>select_clause</replaceable> A valid query statement. Refer to SELECT for a description of the
</term> allowed syntax.
<listitem>
<para>
A valid query statement. Refer to SELECT for a description of the
allowed syntax.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -78,7 +72,8 @@ allowed syntax. ...@@ -78,7 +72,8 @@ allowed syntax.
Outputs Outputs
</title> </title>
<para> <para>
Refer to CREATE TABLE and SELECT for a summary of possible output Refer to <command>CREATE TABLE</command>
and <command>SELECT</command> for a summary of possible output
messages. messages.
</para> </para>
</refsect2> </refsect2>
...@@ -91,10 +86,10 @@ allowed syntax. ...@@ -91,10 +86,10 @@ allowed syntax.
<title> <title>
Description Description
</title> </title>
<para> <para>
CREATE TABLE AS enables a table to be created from the contents of <command>CREATE TABLE AS</command> enables a table to be created from the contents of
an existing table. It has functionality equivalent to SELECT TABLE INTO, an existing table. It has functionality equivalent to <command>SELECT TABLE INTO</command>,
but with perhaps a more obvious syntax. but with perhaps a more direct syntax.
</para> </para>
</refsect1> </refsect1>
</refentry> </refentry>
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
<REFENTRY ID="APP-PGACCESS"> <refentry id="APP-PGACCESS">
<REFMETA> <refmeta>
<REFENTRYTITLE id="pgaccess-ref"> <refentrytitle id="pgaccess-ref">
<application>pgaccess</application> <application>pgaccess</application>
</REFENTRYTITLE> </refentrytitle>
<REFMISCINFO>Application</REFMISCINFO> <refmiscinfo>Application</refmiscinfo>
</REFMETA> </refmeta>
<REFNAMEDIV> <refnamediv>
<REFNAME> <refname>
<application>pgaccess</application> <application>pgaccess</application>
</REFNAME> </refname>
<REFPURPOSE> <refpurpose>
<productname>Postgres</productname> graphical interactive client <productname>Postgres</productname> graphical interactive client
</REFPURPOSE> </refpurpose>
</refnamediv> </refnamediv>
<REFSYNOPSISDIV> <refsynopsisdiv>
<REFSYNOPSISDIVINFO> <refsynopsisdivinfo>
<DATE>1999-05-19</DATE> <date>1999-05-19</date>
</REFSYNOPSISDIVINFO> </refsynopsisdivinfo>
<SYNOPSIS> <synopsis>
pgaccess [ <replaceable class="parameter">dbname</replaceable> ] pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
</SYNOPSIS> </synopsis>
<REFSECT2 ID="R2-APP-PGACCESS-1"> <refsect2 id="R2-APP-PGACCESS-1">
<REFSECT2INFO> <refsect2info>
<DATE>1999-05-19</DATE> <date>1999-05-19</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Inputs Inputs
</TITLE> </title>
<PARA> <para>
<variablelist>
<varlistentry>
<term><replaceable class="PARAMETER">dbname</replaceable></term>
<listitem>
<para>
The name of an existing database to access.
</para>
</listitem>
</varlistentry>
</variablelist>
</para> </para>
</refsect2> </refsect2>
<REFSECT2 ID="R2-APP-PGACCESS-2"> <refsect2 id="R2-APP-PGACCESS-2">
<REFSECT2INFO> <refsect2info>
<DATE>1999-05-19</DATE> <date>1999-05-19</date>
</REFSECT2INFO> </refsect2info>
<TITLE> <title>
Outputs Outputs
</TITLE> </title>
<PARA> <para>
</para> </para>
</refsect2> </refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<REFSECT1 ID="R1-APP-PGACCESS-1"> <refsect1 id="R1-APP-PGACCESS-1">
<REFSECT1INFO> <refsect1info>
<DATE>1999-05-19</DATE> <date>1999-05-19</date>
</REFSECT1INFO> </refsect1info>
<TITLE> <title>
Description Description
</TITLE> </title>
<PARA> <para>
<note>
<title>Editor's Note</title>
<para>
This should be transcribed from other pgaccess info. Volunteers?
</para>
</note>
</para> </para>
</refsect1> </refsect1>
</refentry> </refentry>
...@@ -68,7 +85,7 @@ sgml-indent-data:t ...@@ -68,7 +85,7 @@ sgml-indent-data:t
sgml-parent-document:nil sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced" sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/CATALOG" sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil sgml-local-ecat-files:nil
End: End:
--> -->
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment