Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit17f0b55

Browse files
committed
Initial round of tweakage for man pages
1 parent31578cd commit17f0b55

File tree

12 files changed

+61
-57
lines changed

12 files changed

+61
-57
lines changed

‎doc/src/sgml/Makefile‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
#
99
#
1010
# IDENTIFICATION
11-
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.44 2001/11/16 16:29:56 petere Exp $
11+
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.45 2001/11/18 20:35:02 petere Exp $
1212
#
1313
#----------------------------------------------------------------------------
1414

@@ -67,10 +67,10 @@ DEFAULTSECTION := $(sqlmansect_dummy)
6767

6868
man:$(ALLSGML)
6969
$(NSGMLS)$(NSGMLS_FLAGS)$(srcdir)/book-decl.sgml$(srcdir)/reference.sgml\
70-
|$(SGMLSPL)$(D2MSCRIPT) --lowercase --section$(DEFAULTSECTION)
70+
|$(SGMLSPL)$(D2MSCRIPT) --lowercase --section$(DEFAULTSECTION) --date"`date'+%Y-%m-%d'`"
7171
# One more time, to resolve cross-references
7272
$(NSGMLS) $(NSGMLS_FLAGS) $(srcdir)/book-decl.sgml $(srcdir)/reference.sgml \
73-
| $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION)
73+
| $(SGMLSPL) $(D2MSCRIPT) --lowercase --section $(DEFAULTSECTION) --date "`date '+%Y-%m-%d'`"
7474
$(mkinstalldirs) man1 man$(DEFAULTSECTION)
7575
mv *.1 man1/
7676
mv *.$(DEFAULTSECTION) man$(DEFAULTSECTION)/

‎doc/src/sgml/ref/alter_table.sgml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.31 2001/11/10 20:13:37 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.32 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

@@ -161,22 +161,22 @@ ALTER TABLE <replaceable class="PARAMETER">table</replaceable>
161161
<para>
162162
<command>ALTER TABLE</command> changes the definition of an existing table.
163163
The <literal>ADD COLUMN</literal> form adds a new column to the table
164-
using the same syntax as <xref linkend="SQL-CREATETABLE">.
164+
using the same syntax as <xref linkend="SQL-CREATETABLE" endterm="SQL-CREATETABLE-TITLE">.
165165
The <literal>ALTER COLUMN SET/DROP DEFAULT</literal> forms
166166
allow you to set or remove the default for the column. Note that defaults
167167
only apply to subsequent <command>INSERT</command> commands; they do not
168168
cause rows already in the table to change.
169169
The <literal>ALTER COLUMN SET STATISTICS</literal> form allows you to
170170
set the statistics-gathering target for subsequent
171-
<xref linkend="sql-analyze"> operations.
171+
<xref linkend="sql-analyze" endterm="sql-analyze-title"> operations.
172172
The <literal>RENAME</literal> clause causes the name of a table or column
173173
to change without changing any of the data contained in
174174
the affected table. Thus, the table or column will
175175
remain of the same type and size after this command is
176176
executed.
177177
The ADD <replaceable class="PARAMETER">table constraint definition</replaceable> clause
178178
adds a new constraint to the table using the same syntax as <xref
179-
linkend="SQL-CREATETABLE">.
179+
linkend="SQL-CREATETABLE" endterm="SQL-CREATETABLE-TITLE">.
180180
The DROP CONSTRAINT <replaceable class="PARAMETER">constraint</replaceable> clause
181181
drops all constraints on the table (and its children) that match <replaceable class="PARAMETER">constraint</replaceable>.
182182
The OWNER clause changes the owner of the table to the user <replaceable class="PARAMETER">
@@ -204,18 +204,18 @@ ALTER TABLE <replaceable class="PARAMETER">table</replaceable>
204204
You can use the <literal>SET DEFAULT</literal> form
205205
of <command>ALTER TABLE</command> to set the default later.
206206
(You may also want to update the already existing rows to the
207-
new default value, using <xref linkend="sql-update">.)
207+
new default value, using <xref linkend="sql-update" endterm="sql-update-title">.)
208208
</para>
209209

210210
<para>
211211
In DROP CONSTRAINT, the RESTRICT keyword is required, although
212212
dependencies are not yet checked. The CASCADE option is unsupported.
213213
Currently DROP CONSTRAINT drops only CHECK constraints.
214214
To remove a PRIMARY or UNIQUE constraint, drop the
215-
relevant index using the <xref linkend="SQL-DROPINDEX"> command.
215+
relevant index using the <xref linkend="SQL-DROPINDEX" endterm="sql-dropindex-title"> command.
216216
To remove FOREIGN KEY constraints you need to recreate
217217
and reload the table, using other parameters to the
218-
<xref linkend="SQL-CREATETABLE"> command.
218+
<xref linkend="SQL-CREATETABLE" endterm="sql-createtable-title"> command.
219219
</para>
220220
<para>
221221
For example, to drop all constraints on a table <literal>distributors</literal>:

‎doc/src/sgml/ref/create_function.sgml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.28 2001/10/26 21:17:03 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.29 2001/11/18 20:35:02 petere Exp $
33
-->
44

55
<refentry id="SQL-CREATEFUNCTION">
66
<refmeta>
7-
<refentrytitle>CREATE FUNCTION</refentrytitle>
7+
<refentrytitle id="SQL-CREATEFUNCTION-TITLE">CREATE FUNCTION</refentrytitle>
88
<refmiscinfo>SQL - Language Statements</refmiscinfo>
99
</refmeta>
1010

@@ -130,7 +130,7 @@ CREATE [ OR REPLACE ] FUNCTION <replaceable class="parameter">name</replaceable>
130130
class="parameter">plname</replaceable>, where <replaceable
131131
class="parameter">plname</replaceable> is the name of a
132132
created procedural language. See
133-
<xref linkend="sql-createlanguage">
133+
<xref linkend="sql-createlanguage" endterm="sql-createlanguage-title">
134134
for details. For backward compatibility, the name may be
135135
enclosed by single quotes.
136136
</para>
@@ -244,7 +244,7 @@ CREATE [ OR REPLACE ] FUNCTION <replaceable class="parameter">name</replaceable>
244244
When repeated <command>CREATE FUNCTION</command> calls refer to
245245
the same object file, the file is only loaded once. To unload and
246246
reload the file (perhaps during development), use the <xref
247-
linkend="sql-load"> command.
247+
linkend="sql-load" endterm="sql-load-title"> command.
248248
</para>
249249

250250
<para>

‎doc/src/sgml/ref/create_language.sgml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.18 2001/10/26 21:17:03 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.19 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

@@ -177,12 +177,12 @@ ERROR: PL handler function <replaceable class="parameter">funcname</replaceable
177177
</para>
178178

179179
<para>
180-
Use the <xref linkend="sql-createfunction"> command to create a new
180+
Use the <xref linkend="sql-createfunction" endterm="sql-createfunction-title"> command to create a new
181181
function.
182182
</para>
183183

184184
<para>
185-
Use <xref linkend="sql-droplanguage">, or better yet the <xref
185+
Use <xref linkend="sql-droplanguage" endterm="sql-droplanguage-title">, or better yet the <xref
186186
linkend="app-droplang"> script, to drop procedural languages.
187187
</para>
188188

‎doc/src/sgml/ref/create_table.sgml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.48 2001/10/22 18:14:47 petere Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.49 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

66
<refentry id="SQL-CREATETABLE">
77
<refmeta>
8-
<refentrytitle>CREATE TABLE</refentrytitle>
8+
<refentrytitle id="sql-createtable-title">CREATE TABLE</refentrytitle>
99
<refmiscinfo>SQL - Language Statements</refmiscinfo>
1010
</refmeta>
1111

@@ -448,7 +448,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
448448
constraint that is not deferrable will be checked immediately
449449
after every command. Checking of constraints that are
450450
deferrable may be postponed until the end of the transaction
451-
(using the <xref linkend="sql-set-constraints"> command).
451+
(using the <xref linkend="sql-set-constraints" endterm="sql-set-constraints-title"> command).
452452
<literal>NOT DEFERRABLE</literal> is the default. Only foreign
453453
key constraints currently accept this clause. All other
454454
constraint types are not deferrable.
@@ -466,7 +466,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
466466
statement. This is the default. If the constraint is
467467
<literal>INITIALLY DEFERRED</literal>, it is checked only at the
468468
end of the transaction. The constraint check time can be
469-
altered with the <xref linkend="sql-set-constraints"> command.
469+
altered with the <xref linkend="sql-set-constraints" endterm="sql-set-constraints-title"> command.
470470
</para>
471471
</listitem>
472472
</varlistentry>
@@ -554,7 +554,7 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
554554
index for each unique constraint and primary key constraint to
555555
enforce the uniqueness. Thus, it is not necessary to create an
556556
explicit index for primary key columns. (See <xref
557-
linkend="sql-createindex"> for more information.)
557+
linkend="sql-createindex" endterm="sql-createindex-title"> for more information.)
558558
</para>
559559
</listitem>
560560

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.20 2001/09/03 12:57:49 petere Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.21 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

@@ -192,7 +192,7 @@ Postgres documentation
192192
</variablelist>
193193

194194
If there is an error condition, the backend error message will be displayed.
195-
See <xref linkend="SQL-CREATEDATABASE">
195+
See <xref linkend="SQL-CREATEDATABASE" endterm="SQL-CREATEDATABASE-TITLE">
196196
and <xref linkend="APP-PSQL"> for possibilities.
197197
</para>
198198
</refsect2>

‎doc/src/sgml/ref/ecpg-ref.sgml‎

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.11 2001/09/14 10:24:35 ishii Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.12 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

@@ -23,9 +23,14 @@ Postgres documentation
2323
<refsynopsisdivinfo>
2424
<date>1999-07-20</date>
2525
</refsynopsisdivinfo>
26-
<synopsis>
27-
ecpg [ -v ] [ -t ] [ -I include-path ] [ -o outfile ] file1 [ file2 ] [ ... ]
28-
</synopsis>
26+
<cmdsynopsis>
27+
<command>ecpg</command>
28+
<arg choice="opt">-v</arg>
29+
<arg choice="opt">-t</arg>
30+
<arg choice="opt">-I <replaceable>include-path</replaceable></arg>
31+
<arg choice="opt">-o <replaceable>outfile</replaceable></arg>
32+
<arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg>
33+
</cmdsynopsis>
2934

3035
<refsect2 id="R2-APP-ECPG-1">
3136
<refsect2info>
@@ -58,7 +63,7 @@ ecpg [ -v ] [ -t ] [ -I include-path ] [ -o outfile ] file1 [ file2 ] [ ... ]
5863
</varlistentry>
5964

6065
<varlistentry>
61-
<term>-I <replaceable class="parameter">path</replaceable></term>
66+
<term>-I <replaceable class="parameter">include-path</replaceable></term>
6267
<listitem>
6368
<para>
6469
Specify an additional include path.
@@ -73,7 +78,7 @@ ecpg [ -v ] [ -t ] [ -I include-path ] [ -o outfile ] file1 [ file2 ] [ ... ]
7378
</varlistentry>
7479

7580
<varlistentry>
76-
<term>-o</term>
81+
<term>-o <replaceable>outfile</replaceable></term>
7782
<listitem>
7883
<para>
7984
Specifies that <application>ecpg</application> should write all its output to outfile.

‎doc/src/sgml/ref/grant.sgml‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v 1.14 2001/11/17 22:20:34 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v 1.15 2001/11/1820:35:02 petere Exp $
33
Postgres documentation
44
-->
55

66
<refentry id="SQL-GRANT">
77
<refmeta>
8-
<refentrytitle>GRANT</refentrytitle>
8+
<refentrytitle id="sql-grant-title">GRANT</refentrytitle>
99
<refmiscinfo>SQL - Language Statements</refmiscinfo>
1010
</refmeta>
1111

@@ -49,9 +49,9 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
4949
<term>SELECT</term>
5050
<listitem>
5151
<para>
52-
Allows <xref linkend="sql-select"> from any column of the
52+
Allows <xref linkend="sql-select" endterm="sql-select-title"> from any column of the
5353
specified table, view, or sequence. Also allows the use of
54-
<xref linkend="sql-copy"> FROM.
54+
<xref linkend="sql-copy" endterm="sql-copy-title"> FROM.
5555
</para>
5656
</listitem>
5757
</varlistentry>
@@ -60,8 +60,8 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
6060
<term>INSERT</term>
6161
<listitem>
6262
<para>
63-
Allows <xref linkend="sql-insert"> of a new row into the
64-
specified table. Also allows <xref linkend="sql-copy"> TO.
63+
Allows <xref linkend="sql-insert" endterm="sql-insert-title"> of a new row into the
64+
specified table. Also allows <xref linkend="sql-copy" endterm="sql-copy-title"> TO.
6565
</para>
6666
</listitem>
6767
</varlistentry>
@@ -70,7 +70,7 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
7070
<term>UPDATE</term>
7171
<listitem>
7272
<para>
73-
Allows <xref linkend="sql-update"> of any column of the
73+
Allows <xref linkend="sql-update" endterm="sql-update-title"> of any column of the
7474
specified table. <literal>SELECT ... FOR UPDATE</literal>
7575
also requires this privilege (besides the
7676
<literal>SELECT</literal> privilege). For sequences, this
@@ -84,7 +84,7 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
8484
<term>DELETE</term>
8585
<listitem>
8686
<para>
87-
Allows the <xref linkend="sql-delete"> of a row from the
87+
Allows the <xref linkend="sql-delete" endterm="sql-delete-title"> of a row from the
8888
specified table.
8989
</para>
9090
</listitem>
@@ -95,7 +95,7 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
9595
<listitem>
9696
<para>
9797
Allows the creation of a rule on the table/view. (See <xref
98-
linkend="sql-createrule"> statement).
98+
linkend="sql-createrule" endterm="sql-createrule-title"> statement).
9999
</para>
100100
</listitem>
101101
</varlistentry>
@@ -116,7 +116,7 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
116116
<listitem>
117117
<para>
118118
Allows the creation of a trigger on the specified table. (See
119-
<xref linkend="sql-createtrigger"> statement).
119+
<xref linkend="sql-createtrigger" endterm="sql-createtrigger-title"> statement).
120120
</para>
121121
</listitem>
122122
</varlistentry>
@@ -177,7 +177,7 @@ GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER } [,..
177177
</para>
178178

179179
<para>
180-
The <xref linkend="sql-revoke"> command is used to revoke access
180+
The <xref linkend="sql-revoke" endterm="sql-revoke-title"> command is used to revoke access
181181
privileges.
182182
</para>
183183
</refsect1>

‎doc/src/sgml/ref/load.sgml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/load.sgml,v 1.10 2001/10/26 19:58:12 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/load.sgml,v 1.11 2001/11/18 20:35:02 petere Exp $
33
-->
44

55
<refentry id="SQL-LOAD">
66
<refmeta>
7-
<refentrytitle>LOAD</refentrytitle>
7+
<refentrytitle id="SQL-LOAD-TITLE">LOAD</refentrytitle>
88
<refmiscinfo>SQL - Language Statements</refmiscinfo>
99
</refmeta>
1010

@@ -29,12 +29,12 @@ LOAD '<replaceable class="PARAMETER">filename</replaceable>'
2929
shared library file that has been changed since the backend first
3030
loaded it. To make use of the
3131
shared library, function(s) in it need to be declared using the <xref
32-
linkend="sql-createfunction"> command.
32+
linkend="sql-createfunction" endterm="sql-createfunction-title"> command.
3333
</para>
3434

3535
<para>
3636
The filename is specified in the same way as for shared library
37-
names in <xref linkend="sql-createfunction">; in particular, one
37+
names in <xref linkend="sql-createfunction" endterm="sql-createfunction-title">; in particular, one
3838
may rely on a search path and automatic addition of the system's standard
3939
shared library filename extension. See the
4040
<citetitle>Programmer's Guide</citetitle> for more detail.

‎doc/src/sgml/ref/pg_dump.sgml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.38 2001/10/23 22:11:22 tgl Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.39 2001/11/18 20:35:02 petere Exp $
33
Postgres documentation
44
-->
55

@@ -462,17 +462,17 @@ Postgres documentation
462462
<xref linkend="app-psql"> <command>\connect</command> command.
463463
This command actually opens a new connection, which might
464464
require manual interaction (e.g., passwords). If you use the
465-
<option>-X use-set-session-authorization</option>, then
465+
<option>-X use-set-session-authorization</option> option, then
466466
<command>pg_dump</command> will instead output <xref
467-
linkend="sql-set-session-authorization"> commands. This has
467+
linkend="sql-set-session-authorization" endterm="sql-set-session-authorization-title"> commands. This has
468468
the same effect, but it requires that the user restoring the
469469
database from the generated script be a database superuser.
470470
This option effectively overrides the <option>-R</option>
471471
option.
472472
</para>
473473

474474
<para>
475-
Since <xref linkend="sql-set-session-authorization"> is a
475+
Since <xref linkend="sql-set-session-authorization" endterm="sql-set-session-authorization-title"> is a
476476
standard SQL command, whereas <command>\connect</command> only
477477
works in <xref linkend="app-psql">, this option also enhances
478478
the theoretical portability of the output script.

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp