Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit d55f878

Browse files
peterepetere
committed
Markup enhancements, some factual corrections.
1 parent 8095924 commit d55f878

12 files changed

+463
-565
lines changed

‎doc/src/sgml/ref/createdb.sgml

+45-56
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,33 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.10 2000/03/27 17:14:42 thomas Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.11 2000/11/11 23:01:38 petere Exp $
33
Postgres documentation
44
-->
55

66
<refentry id="APP-CREATEDB" xreflabel="createdb">
7+
<docinfo>
8+
<date>2000-11-11</date>
9+
</docinfo>
10+
711
<refmeta>
8-
<refentrytitle id="APP-CREATEDB-TITLE">
9-
<application>createdb</application>
10-
</refentrytitle>
12+
<refentrytitle id="APP-CREATEDB-TITLE"><application>createdb</application></refentrytitle>
13+
<manvolnum>1</manvolnum>
1114
<refmiscinfo>Application</refmiscinfo>
1215
</refmeta>
16+
1317
<refnamediv>
14-
<refname>
15-
<application>createdb</application>
16-
</refname>
17-
<refpurpose>
18-
Create a new <productname>Postgres</productname> database
19-
</refpurpose>
18+
<refname>createdb</refname>
19+
<refpurpose>Create a new <productname>Postgres</productname> database</refpurpose>
2020
</refnamediv>
21+
2122
<refsynopsisdiv>
22-
<refsynopsisdivinfo>
23-
<date>1999-11-07</date>
24-
</refsynopsisdivinfo>
25-
<synopsis>
26-
createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable class="parameter">dbname</replaceable> [ <replaceable class="parameter">description</replaceable> ]
27-
</synopsis>
23+
<cmdsynopsis>
24+
<command>createdb</command>
25+
<arg rep="repeat"><replaceable>options</replaceable></arg>
26+
<arg choice="plain"><replaceable>dbname</replaceable></arg>
27+
<arg><replaceable>description</replaceable></arg>
28+
</cmdsynopsis>
2829

2930
<refsect2 id="R2-APP-CREATEDB-1">
30-
<refsect2info>
31-
<date>1999-11-07</date>
32-
</refsect2info>
3331
<title>
3432
Inputs
3533
</title>
@@ -99,9 +97,8 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
9997
<term>-D, --location <replaceable class="parameter">datadir</replaceable></term>
10098
<listitem>
10199
<para>
102-
Specifies the alternate database location for this database installation.
103-
This is the location of the installation system tables, not the location
104-
of this specific database, which may be different.
100+
Specifies the alternative database location. See also <xref
101+
linkend="app-initlocation" endterm="app-initlocation-title">.
105102
</para>
106103
</listitem>
107104
</varlistentry>
@@ -146,9 +143,6 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
146143
</refsect2>
147144

148145
<refsect2 id="R2-APP-CREATEDB-2">
149-
<refsect2info>
150-
<date>1999-11-07</date>
151-
</refsect2info>
152146
<title>
153147
Outputs
154148
</title>
@@ -189,9 +183,6 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
189183
</refsynopsisdiv>
190184

191185
<refsect1 id="R1-APP-CREATEDB-1">
192-
<refsect1info>
193-
<date>1999-11-07</date>
194-
</refsect1info>
195186
<title>
196187
Description
197188
</title>
@@ -215,36 +206,34 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
215206
</refsect1>
216207

217208
<refsect1 id="R1-APP-CREATEDB-2">
218-
<refsect1info>
219-
<date>1999-11-07</date>
220-
</refsect1info>
221-
<title>
222-
Usage
223-
</title>
224-
<para>
225-
To create the database <literal>demo</literal>
226-
using the default database server:
209+
<title>Usage</title>
227210

228-
<programlisting>
229-
$ <userinput>createdb demo</userinput>
230-
CREATE DATABASE
231-
</programlisting>
232-
233-
The response is the same as you would have gotten from running the
234-
<command>CREATE DATABASE</command> <acronym>SQL</acronym> command.
235-
</para>
236-
237-
<para>
238-
To create the database <literal>demo</literal>
239-
using the postmaster on host eden, port 5000, using the <literal>LATIN1</literal>
240-
encoding scheme with a look at the underlying query:
211+
<informalexample>
212+
<para>
213+
To create the database <literal>demo</literal> using the default
214+
database server:
215+
<screen>
216+
<prompt>$ </prompt><userinput>createdb demo</userinput>
217+
<computeroutput>CREATE DATABASE</computeroutput>
218+
</screen>
219+
The response is the same as you would have gotten from running the
220+
<command>CREATE DATABASE</command> <acronym>SQL</acronym> command.
221+
</para>
222+
</informalexample>
241223

242-
<programlisting>
243-
$ <userinput>createdb -p 5000 -h eden -E LATIN1 -e demo</userinput>
244-
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
245-
CREATE DATABASE
246-
</programlisting>
247-
</para>
224+
<informalexample>
225+
<para>
226+
To create the database <literal>demo</literal> using the
227+
postmaster on host eden, port 5000, using the
228+
<literal>LATIN1</literal> encoding scheme with a look at the
229+
underlying query:
230+
<screen>
231+
<prompt>$ </prompt><userinput>createdb -p 5000 -h eden -E LATIN1 -e demo</userinput>
232+
<computeroutput>CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'</computeroutput>
233+
<computeroutput>CREATE DATABASE</computeroutput>
234+
</screen>
235+
</para>
236+
</informalexample>
248237
</refsect1>
249238
</refentry>
250239

‎doc/src/sgml/ref/createlang.sgml

+33-32
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,36 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.9 2000/11/04 21:09:41 momjian Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.10 2000/11/11 23:01:38 petere Exp $
33
Postgres documentation
44
-->
55

66
<refentry id="APP-CREATELANG">
7+
<docinfo>
8+
<date>2000-11-11</date>
9+
</docinfo>
10+
711
<refmeta>
8-
<refentrytitle id="APP-CREATELANG-TITLE">
9-
<application>createlang</application>
10-
</refentrytitle>
12+
<refentrytitle id="APP-CREATELANG-TITLE"><application>createlang</application></refentrytitle>
13+
<manvolnum>1</manvolnum>
1114
<refmiscinfo>Application</refmiscinfo>
1215
</refmeta>
16+
1317
<refnamediv>
14-
<refname id="createlang">
15-
<application>createlang</application>
16-
</refname>
17-
<refpurpose>
18-
Add a new programming language to a <productname>Postgres</productname> database
19-
</refpurpose>
18+
<refname id="createlang">createlang</refname>
19+
<refpurpose>Add a new programming language to a <productname>Postgres</productname> database</refpurpose>
2020
</refnamediv>
21+
2122
<refsynopsisdiv>
22-
<refsynopsisdivinfo>
23-
<date>1999-12-05</date>
24-
</refsynopsisdivinfo>
25-
<synopsis>
26-
createlang [ <replaceable class="parameter">connection options</replaceable> ] [ <replaceable class="parameter">langname</replaceable> [ <replaceable class="parameter">dbname</replaceable> ] ]
27-
createlang [ <replaceable class="parameter">connection options</replaceable> ] --list|-l [ <replaceable class="parameter">dbname</replaceable> ]
28-
</synopsis>
23+
<cmdsynopsis>
24+
<command>createlang</command>
25+
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
26+
<arg><replaceable>langname</replaceable></arg>
27+
<arg choice="plain"><replaceable>dbname</replaceable></arg>
28+
<sbr>
29+
<command>createlang</command>
30+
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
31+
<group choice="plain"><arg>--list</arg><arg>-l</arg></group>
32+
<arg choice="plain"><replaceable>dbname</replaceable></arg>
33+
</cmdsynopsis>
2934

3035
<refsect2 id="R2-APP-CREATELANG-1">
3136
<title>
@@ -119,9 +124,6 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
119124
</refsect2>
120125

121126
<refsect2 id="R2-APP-CREATELANG-2">
122-
<refsect2info>
123-
<date>1998-10-04</date>
124-
</refsect2info>
125127
<title>
126128
Outputs
127129
</title>
@@ -136,9 +138,6 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
136138
</refsynopsisdiv>
137139

138140
<refsect1 id="R1-APP-CREATELANG-1">
139-
<refsect1info>
140-
<date>1999-12-05</date>
141-
</refsect1info>
142141
<title>
143142
Description
144143
</title>
@@ -171,15 +170,17 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
171170
</refsect1>
172171

173172
<refsect1 id="R1-APP-CREATELANG-3">
174-
<title>
175-
Usage
176-
</title>
177-
<para>
178-
To install <literal>pltcl</literal>:
179-
<programlisting>
180-
$ createlang pltcl dbname
181-
</programlisting>
182-
</para>
173+
<title>Usage</title>
174+
175+
<informalexample>
176+
<para>
177+
To install <literal>pltcl</literal> into the database
178+
<literal>template1</literal>:
179+
<screen>
180+
<prompt>$ </prompt><userinput>createlang pltcl template1</userinput>
181+
</screen>
182+
</para>
183+
</informalexample>
183184
</refsect1>
184185
</refentry>
185186

‎doc/src/sgml/ref/createuser.sgml

+41-53
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,32 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.9 2000/03/27 17:14:42 thomas Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.10 2000/11/11 23:01:40 petere Exp $
33
Postgres documentation
44
-->
55

66
<refentry id="APP-CREATEUSER">
7+
<docinfo>
8+
<date>2000-11-11</date>
9+
</docinfo>
10+
711
<refmeta>
8-
<refentrytitle id="APP-CREATEUSER-TITLE">
9-
<application>createuser</application>
10-
</refentrytitle>
12+
<refentrytitle id="APP-CREATEUSER-TITLE"><application>createuser</application></refentrytitle>
13+
<manvolnum>1</manvolnum>
1114
<refmiscinfo>Application</refmiscinfo>
1215
</refmeta>
16+
1317
<refnamediv>
14-
<refname>
15-
<application>createuser</application>
16-
</refname>
17-
<refpurpose>
18-
Create a new <productname>Postgres</productname> user
19-
</refpurpose>
18+
<refname>createuser</refname>
19+
<refpurpose>Create a new <productname>Postgres</productname> user</refpurpose>
2020
</refnamediv>
21-
<refsynopsisdiv>
22-
<refsynopsisdivinfo>
23-
<date>1999-11-07</date>
24-
</refsynopsisdivinfo>
2521

26-
<synopsis>
27-
createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceable class="parameter">username</replaceable> ]
28-
</synopsis>
22+
<refsynopsisdiv>
23+
<cmdsynopsis>
24+
<command>createuser</command>
25+
<arg rep="repeat"><replaceable>options</replaceable></arg>
26+
<arg><replaceable>username</replaceable></arg>
27+
</cmdsynopsis>
2928

3029
<refsect2 id="R2-APP-CREATEUSER-1">
31-
<refsect2info>
32-
<date>1999-11-07</date>
33-
</refsect2info>
3430
<title>
3531
Inputs
3632
</title>
@@ -159,9 +155,6 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
159155
</refsect2>
160156

161157
<refsect2 id="R2-APP-CREATEUSER-2">
162-
<refsect2info>
163-
<date>1999-11-07</date>
164-
</refsect2info>
165158
<title>
166159
Outputs
167160
</title>
@@ -195,9 +188,6 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
195188
</refsynopsisdiv>
196189

197190
<refsect1 id="R1-APP-CREATEUSER-1">
198-
<refsect1info>
199-
<date>1998-11-07</date>
200-
</refsect1info>
201191
<title>
202192
Description
203193
</title>
@@ -226,35 +216,33 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
226216

227217

228218
<refsect1 id="R1-APP-CREATEUSER-2">
229-
<refsect1info>
230-
<date>1999-11-07</date>
231-
</refsect1info>
232-
<title>
233-
Usage
234-
</title>
235-
<para>
236-
To create a user <literal>joe</literal>
237-
on the default database server:
219+
<title>Usage</title>
238220

239-
<programlisting>
240-
$ <userinput>createuser joe</userinput>
241-
Is the new user allowed to create databases? (y/n) <userinput>n</userinput>
242-
Shall the new user be allowed to create more new users? (y/n) <userinput>n</userinput>
243-
CREATE USER
244-
</programlisting>
245-
</para>
246-
247-
<para>
248-
To create the same user <literal>joe</literal>
249-
using the postmaster on host eden, port 5000, avoiding
250-
the prompts and taking a look at the underlying query:
221+
<informalexample>
222+
<para>
223+
To create a user <literal>joe</literal> on the default database
224+
server:
225+
<screen>
226+
<prompt>$ </prompt><userinput>createuser joe</userinput>
227+
<computeroutput>Is the new user allowed to create databases? (y/n) </computeroutput><userinput>n</userinput>
228+
<computeroutput>Shall the new user be allowed to create more new users? (y/n) </computeroutput><userinput>n</userinput>
229+
<computeroutput>CREATE USER</computeroutput>
230+
</screen>
231+
</para>
232+
</informalexample>
251233

252-
<programlisting>
253-
$ <userinput>createuser -p 5000 -h eden -D -A -e joe</userinput>
254-
CREATE USER "joe" NOCREATEDB NOCREATEUSER
255-
CREATE USER
256-
</programlisting>
257-
</para>
234+
<informalexample>
235+
<para>
236+
To create the same user <literal>joe</literal> using the
237+
postmaster on host eden, port 5000, avoiding the prompts and
238+
taking a look at the underlying query:
239+
<screen>
240+
<prompt>$ </prompt><userinput>createuser -p 5000 -h eden -D -A -e joe</userinput>
241+
<computeroutput>CREATE USER "joe" NOCREATEDB NOCREATEUSER</computeroutput>
242+
<computeroutput>CREATE USER</computeroutput>
243+
</screen>
244+
</para>
245+
</informalexample>
258246
</refsect1>
259247

260248
</refentry>

‎doc/src/sgml/ref/drop_database.sgml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.10 2000/10/05 19:48:18 momjian Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.11 2000/11/11 23:01:43 petere Exp $
33
Postgres documentation
44
-->
55

6-
<refentry id="SQL-DROPDATABASE" xreflabel="drop_database">
6+
<refentry id="SQL-DROPDATABASE">
77
<refmeta>
88
<refentrytitle id="SQL-DROPDATABASE-TITLE">
99
DROP DATABASE

0 commit comments

Comments
 (0)