Skip to content

Commit d72168d

Browse files
author
Thomas G. Lockhart
committed
Complete first pass at markup adjustments for docbook2man man pages.
Add some internal cross references to select.sgml.
1 parent d289011 commit d72168d

File tree

8 files changed

+865
-834
lines changed

8 files changed

+865
-834
lines changed

‎doc/src/sgml/ref/select.sgml

Lines changed: 164 additions & 152 deletions
Large diffs are not rendered by default.

‎doc/src/sgml/ref/select_into.sgml

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
<refentry id="SQL-SELECTINTO">
22
<refmeta>
33
<refentrytitle>
4-
SELECT INTO
4+
SELECT INTO
55
</refentrytitle>
66
<refmiscinfo>SQL - Language Statements</refmiscinfo>
77
</refmeta>
88
<refnamediv>
99
<refname>
10-
SELECT INTO
10+
SELECT INTO
1111
</refname>
1212
<refpurpose>
13-
Create a new table from an existing table or view
13+
Create a new table from an existing table or view
1414
</refpurpose></refnamediv>
1515
<refsynopsisdiv>
1616
<refsynopsisdivinfo>
@@ -37,7 +37,8 @@ SELECT [ ALL | DISTINCT ] <replaceable class="PARAMETER">expression</replaceable
3737
Inputs
3838
</title>
3939
<para>
40-
All input fields are described in detail for SELECT.
40+
All input fields are described in detail for
41+
<xref linkend="select-title" endterm="select-title">.
4142
</para>
4243
</refsect2>
4344

@@ -49,7 +50,8 @@ All input fields are described in detail for SELECT.
4950
Outputs
5051
</title>
5152
<para>
52-
All output fields are described in detail for SELECT.
53+
All output fields are described in detail for
54+
<xref linkend="select-title" endterm="select-title">.
5355
</para>
5456
</refsect2>
5557
</refsynopsisdiv>
@@ -62,12 +64,14 @@ All output fields are described in detail for SELECT.
6264
Description
6365
</title>
6466
<para>
65-
SELECT INTO creates a new table from the results of a query. Typically, this
67+
<command>SELECT INTO</command> creates a new table from the results
68+
of a query. Typically, this
6669
query draws data from an existing table, but any SQL query is allowed.
70+
6771
<note>
68-
<para>
69-
CREATE TABLE AS is functionally equivalent to the SELECT INTO command.
70-
</para>
72+
<para>
73+
CREATE TABLE AS is functionally equivalent to the SELECT INTO command.
74+
</para>
7175
</note>
7276
</para>
7377
</refsect1>
@@ -76,7 +80,7 @@ All output fields are described in detail for SELECT.
7680
<!-- Keep this comment at the end of the file
7781
Local variables:
7882
mode: sgml
79-
sgml-omittag:
83+
sgml-omittag:nil
8084
sgml-shorttag:t
8185
sgml-minimize-attributes:nil
8286
sgml-always-quote-attributes:t

‎doc/src/sgml/ref/set.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -201,9 +201,9 @@ default
201201
Setting the <envar>PGDATESTYLE</envar> environment variable.
202202
</member>
203203
<member>
204-
Running postmaster using the <option>-oe</option> parameter to set
204+
Running postmaster using the option <option>-o -e</option> to set
205205
dates to the <literal>European</literal> convention.
206-
Note that this affects only the some combinations of date styles; for example
206+
Note that this affects only some combinations of date styles; for example
207207
the ISO style is not affected by this parameter.
208208
</member>
209209
<member>

‎doc/src/sgml/ref/show.sgml

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
<date>1998-09-24</date>
1919
</refsynopsisdivinfo>
2020
<synopsis>
21-
SHOW <replaceable class="PARAMETER">variable</replaceable>
21+
SHOW <replaceable class="PARAMETER">keyword</replaceable>
2222
</synopsis>
2323

2424
<refsect2 id="R2-SQL-SHOW-1">
@@ -28,17 +28,15 @@ SHOW <replaceable class="PARAMETER">variable</replaceable>
2828
<title>
2929
Inputs
3030
</title>
31-
<para>
3231

32+
<para>
3333
<variablelist>
3434
<varlistentry>
35-
<term>
36-
<replaceable class="PARAMETER">variable</replaceable>
37-
</term>
35+
<term><replaceable class="PARAMETER">keyword</replaceable></term>
3836
<listitem>
3937
<para>
4038
Refer to <command>SET</command> for more information on available
41-
variables.
39+
arguments.
4240
</para>
4341
</listitem>
4442
</varlistentry>
@@ -53,40 +51,40 @@ SHOW <replaceable class="PARAMETER">variable</replaceable>
5351
<title>
5452
Outputs
5553
</title>
56-
<para>
5754

55+
<para>
5856
<variablelist>
5957
<varlistentry>
60-
<term>
61-
<returnvalue>NOTICE: <replaceable
62-
class="PARAMETER">">variab</replaceable>E> is <replaceable>value</replaceable></returnvalue>
63-
SHOW VARIABLE
64-
</term>
58+
<term><computeroutput>
59+
NOTICE: <replaceable class="PARAMETER">variable</replaceable> is <replaceable>value</replaceable>
60+
SHOW VARIABLE
61+
</computeroutput></term>
6562
<listitem>
6663
<para>
67-
Message returned if successfully.
64+
Message returned if successful.
6865
</para>
6966
</listitem>
7067
</varlistentry>
7168
<varlistentry>
72-
<term>
73-
<returnvalue>NOTICE: Unrecognized variable <replaceable>value</replaceable></returnvalue>
74-
</term>
69+
<term><computeroutput>
70+
NOTICE: Unrecognized variable <replaceable>value</replaceable>
71+
</computeroutput></term>
7572
<listitem>
7673
<para>
7774
Message returned if <returnvalue>value</returnvalue> does not exist.
7875
</para>
7976
</listitem>
8077
</varlistentry>
81-
78+
8279
<varlistentry>
83-
<term>
84-
NOTICE: Time zone is unknown
85-
SHOW VARIABLE
86-
</term>
80+
<term><computeroutput>
81+
NOTICE: Time zone is unknown
82+
SHOW VARIABLE
83+
</computeroutput></term>
8784
<listitem>
8885
<para>
89-
If the TZ environment variable is not set.
86+
If the <envar>TZ</envar> or <envar>PGTZ</envar> environment
87+
variable is not set.
9088
</para>
9189
</listitem>
9290
</varlistentry>
@@ -138,12 +136,17 @@ SHOW <replaceable class="PARAMETER">variable</replaceable>
138136
Usage
139137
</title>
140138
<para>
139+
Show the current <literal>DateStyle</literal> setting:
140+
141141
<programlisting>
142-
-- show DateStyle;
143142
SHOW DateStyle;
144143
NOTICE:DateStyle is Postgres with US (NonEuropean) conventions
144+
</programlisting>
145+
</para>
145146

146-
-- show Geqo;
147+
<para>
148+
Show the current genetic optimizer (<literal>geqo</literal>) setting:
149+
<programlisting>
147150
SHOW GEQO;
148151
NOTICE:GEQO is ON
149152
</programlisting>
@@ -183,7 +186,7 @@ sgml-indent-data:t
183186
sgml-parent-document:nil
184187
sgml-default-dtd-file:"../reference.ced"
185188
sgml-exposed-tags:nil
186-
sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
189+
sgml-local-catalogs:"/usr/lib/sgml/catalog"
187190
sgml-local-ecat-files:nil
188191
End:
189192
-->

0 commit comments

Comments
 (0)