Skip to content

Commit 1d3ff89

Browse files
bmomjianbmomjian
committed
doc: add commas after 'i.e.' and 'e.g.'
This follows the American format, https://jakubmarian.com/comma-after-i-e-and-e-g/. There is no intention of requiring this format for future text, but making existing text consistent every few years makes sense. Discussion: https://postgr.es/m/20200825183619.GA22369@momjian.us Backpatch-through: 9.5
1 parent 787ccf5 commit 1d3ff89

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+102
-102
lines changed

‎doc/src/sgml/bki.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -458,7 +458,7 @@
458458
Use of symbolic references is enabled in a particular catalog column
459459
by attaching <literal>BKI_LOOKUP(<replaceable>lookuprule</replaceable>)</literal>
460460
to the column's definition, where <replaceable>lookuprule</replaceable>
461-
is the name of the referenced catalog, e.g. <literal>pg_proc</literal>.
461+
is the name of the referenced catalog, e.g., <literal>pg_proc</literal>.
462462
<literal>BKI_LOOKUP</literal> can be attached to columns of
463463
type <type>Oid</type>, <type>regproc</type>, <type>oidvector</type>,
464464
or <type>Oid[]</type>; in the latter two cases it implies performing a

‎doc/src/sgml/config.sgml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -424,7 +424,7 @@ include_dir 'directory'
424424
start with the <literal>.</literal> character are also ignored, to
425425
prevent mistakes since such files are hidden on some platforms. Multiple
426426
files within an include directory are processed in file name order
427-
(according to C locale rules, i.e. numbers before letters, and
427+
(according to C locale rules, i.e., numbers before letters, and
428428
uppercase letters before lowercase ones).
429429
</para>
430430

@@ -1085,7 +1085,7 @@ include_dir 'conf.d'
10851085
<para>
10861086
With this parameter enabled, you can still create ordinary global
10871087
users. Simply append <literal>@</literal> when specifying the user
1088-
name in the client, e.g. <literal>joe@</literal>. The <literal>@</literal>
1088+
name in the client, e.g., <literal>joe@</literal>. The <literal>@</literal>
10891089
will be stripped off before the user name is looked up by the
10901090
server.
10911091
</para>
@@ -3268,7 +3268,7 @@ include_dir 'conf.d'
32683268
disabled, but the server continues to accumulate WAL segment files in
32693269
the expectation that a command will soon be provided. Setting
32703270
<varname>archive_command</varname> to a command that does nothing but
3271-
return true, e.g. <literal>/bin/true</literal> (<literal>REM</literal> on
3271+
return true, e.g., <literal>/bin/true</literal> (<literal>REM</literal> on
32723272
Windows), effectively disables
32733273
archiving, but also breaks the chain of WAL files needed for
32743274
archive recovery, so it should only be used in unusual circumstances.
@@ -3513,7 +3513,7 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
35133513
<listitem>
35143514
<para>
35153515
This parameter specifies that recovery should end as soon as a
3516-
consistent state is reached, i.e. as early as possible. When restoring
3516+
consistent state is reached, i.e., as early as possible. When restoring
35173517
from an online backup, this means the point where taking the backup
35183518
ended.
35193519
</para>
@@ -3559,7 +3559,7 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
35593559
<xref linkend="guc-timezone-abbreviations"/> variable has been set
35603560
earlier in the configuration file). Preferred style is to use a
35613561
numeric offset from UTC, or you can write a full time zone name,
3562-
e.g. <literal>Europe/Helsinki</literal> not <literal>EEST</literal>.
3562+
e.g., <literal>Europe/Helsinki</literal> not <literal>EEST</literal>.
35633563
</para>
35643564
</listitem>
35653565
</varlistentry>
@@ -4941,7 +4941,7 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
49414941
if your data is likely to be completely in cache, such as when
49424942
the database is smaller than the total server memory, decreasing
49434943
random_page_cost can be appropriate. Storage that has a low random
4944-
read cost relative to sequential, e.g. solid-state drives, might
4944+
read cost relative to sequential, e.g., solid-state drives, might
49454945
also be better modeled with a lower value for random_page_cost,
49464946
e.g., <literal>1.1</literal>.
49474947
</para>
@@ -9026,7 +9026,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
90269026
rows that can be locked; that value is unlimited. The default,
90279027
64, has historically proven sufficient, but you might need to
90289028
raise this value if you have queries that touch many different
9029-
tables in a single transaction, e.g. query of a parent table with
9029+
tables in a single transaction, e.g., query of a parent table with
90309030
many children. This parameter can only be set at server start.
90319031
</para>
90329032

@@ -9522,7 +9522,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
95229522
with assertions enabled. That is the case if the
95239523
macro <symbol>USE_ASSERT_CHECKING</symbol> is defined
95249524
when <productname>PostgreSQL</productname> is built (accomplished
9525-
e.g. by the <command>configure</command> option
9525+
e.g., by the <command>configure</command> option
95269526
<option>--enable-cassert</option>). By
95279527
default <productname>PostgreSQL</productname> is built without
95289528
assertions.

‎doc/src/sgml/datatype.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -520,7 +520,7 @@
520520
very large number of digits. It is especially recommended for
521521
storing monetary amounts and other quantities where exactness is
522522
required. Calculations with <type>numeric</type> values yield exact
523-
results where possible, e.g. addition, subtraction, multiplication.
523+
results where possible, e.g., addition, subtraction, multiplication.
524524
However, calculations on <type>numeric</type> values are very slow
525525
compared to the integer types, or to the floating-point types
526526
described in the next section.
@@ -5056,7 +5056,7 @@ SELECT * FROM pg_attribute
50565056

50575057
<row>
50585058
<entry><type>unknown</type></entry>
5059-
<entry>Identifies a not-yet-resolved type, e.g. of an undecorated
5059+
<entry>Identifies a not-yet-resolved type, e.g., of an undecorated
50605060
string literal.</entry>
50615061
</row>
50625062
</tbody>

‎doc/src/sgml/ddl.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1338,7 +1338,7 @@ ALTER TABLE products ADD COLUMN description text;
13381338
</para>
13391339

13401340
<para>
1341-
However, if the default value is volatile (e.g.
1341+
However, if the default value is volatile (e.g.,
13421342
<function>clock_timestamp()</function>)
13431343
each row will need to be updated with the value calculated at the time
13441344
<command>ALTER TABLE</command> is executed. To avoid a potentially
@@ -1833,7 +1833,7 @@ REVOKE ALL ON accounts FROM PUBLIC;
18331833
schema (assuming that the objects' own privilege requirements are
18341834
also met). Essentially this allows the grantee to <quote>look up</quote>
18351835
objects within the schema. Without this permission, it is still
1836-
possible to see the object names, e.g. by querying system catalogs.
1836+
possible to see the object names, e.g., by querying system catalogs.
18371837
Also, after revoking this permission, existing sessions might have
18381838
statements that have previously performed this lookup, so this is not
18391839
a completely secure way to prevent object access.

‎doc/src/sgml/ecpg.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3689,7 +3689,7 @@ EXEC SQL DEALLOCATE DESCRIPTOR <replaceable>identifier</replaceable>;
36893689
EXEC SQL FETCH NEXT FROM mycursor INTO SQL DESCRIPTOR mydesc;
36903690
</programlisting>
36913691
If the result set is empty, the Descriptor Area will still contain
3692-
the metadata from the query, i.e. the field names.
3692+
the metadata from the query, i.e., the field names.
36933693
</para>
36943694

36953695
<para>
@@ -4106,7 +4106,7 @@ typedef struct sqlvar_struct sqlvar_t;
41064106
<term><literal>sqllen</literal></term>
41074107
<listitem>
41084108
<para>
4109-
Contains the binary length of the field. e.g. 4 bytes for <type>ECPGt_int</type>.
4109+
Contains the binary length of the field. e.g., 4 bytes for <type>ECPGt_int</type>.
41104110
</para>
41114111
</listitem>
41124112
</varlistentry>
@@ -8062,7 +8062,7 @@ EXEC SQL CLOSE DATABASE;
80628062
<term><literal>FREE cursor_name</literal></term>
80638063
<listitem>
80648064
<para>
8065-
Due to the differences how ECPG works compared to Informix's ESQL/C (i.e. which steps
8065+
Due to the differences how ECPG works compared to Informix's ESQL/C (i.e., which steps
80668066
are purely grammar transformations and which steps rely on the underlying run-time library)
80678067
there is no <literal>FREE cursor_name</literal> statement in ECPG. This is because in ECPG,
80688068
<literal>DECLARE CURSOR</literal> doesn't translate to a function call into

‎doc/src/sgml/extend.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -756,7 +756,7 @@ RETURNS anycompatible AS ...
756756
<para>
757757
An extension is <firstterm>relocatable</firstterm> if it is possible to move
758758
its contained objects into a different schema after initial creation
759-
of the extension. The default is <literal>false</literal>, i.e. the
759+
of the extension. The default is <literal>false</literal>, i.e., the
760760
extension is not relocatable.
761761
See <xref linkend="extend-extensions-relocation"/> for more information.
762762
</para>
@@ -1645,7 +1645,7 @@ include $(PGXS)
16451645
<term><varname>NO_INSTALLCHECK</varname></term>
16461646
<listitem>
16471647
<para>
1648-
don't define an <literal>installcheck</literal> target, useful e.g. if tests require special configuration, or don't use <application>pg_regress</application>
1648+
don't define an <literal>installcheck</literal> target, useful e.g., if tests require special configuration, or don't use <application>pg_regress</application>
16491649
</para>
16501650
</listitem>
16511651
</varlistentry>

‎doc/src/sgml/func.sgml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7632,9 +7632,9 @@ SELECT regexp_match('abc01234xyz', '(?:(.*?)(\d+)(.*)){1,1}');
76327632
<listitem>
76337633
<para>
76347634
In <function>to_timestamp</function> and <function>to_date</function>,
7635-
if the year format specification is less than four digits, e.g.
7635+
if the year format specification is less than four digits, e.g.,
76367636
<literal>YYY</literal>, and the supplied year is less than four digits,
7637-
the year will be adjusted to be nearest to the year 2020, e.g.
7637+
the year will be adjusted to be nearest to the year 2020, e.g.,
76387638
<literal>95</literal> becomes 1995.
76397639
</para>
76407640
</listitem>
@@ -26355,7 +26355,7 @@ FOR EACH ROW EXECUTE FUNCTION suppress_redundant_updates_trigger();
2635526355
<row>
2635626356
<entry><literal>objsubid</literal></entry>
2635726357
<entry><type>integer</type></entry>
26358-
<entry>Sub-object ID (e.g. attribute number for a column)</entry>
26358+
<entry>Sub-object ID (e.g., attribute number for a column)</entry>
2635926359
</row>
2636026360
<row>
2636126361
<entry><literal>command_tag</literal></entry>
@@ -26445,7 +26445,7 @@ FOR EACH ROW EXECUTE FUNCTION suppress_redundant_updates_trigger();
2644526445
<row>
2644626446
<entry><literal>objsubid</literal></entry>
2644726447
<entry><type>integer</type></entry>
26448-
<entry>Sub-object ID (e.g. attribute number for a column)</entry>
26448+
<entry>Sub-object ID (e.g., attribute number for a column)</entry>
2644926449
</row>
2645026450
<row>
2645126451
<entry><literal>original</literal></entry>

‎doc/src/sgml/glossary.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -695,7 +695,7 @@
695695
<glossdef>
696696
<para>
697697
Contains the values of <glossterm linkend="glossary-tuple">row</glossterm>
698-
attributes (i.e. the data) for a
698+
attributes (i.e., the data) for a
699699
<glossterm linkend="glossary-relation">relation</glossterm>.
700700
The heap is realized within one or more
701701
<glossterm linkend="glossary-file-segment">file segments</glossterm>

‎doc/src/sgml/high-availability.sgml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -219,7 +219,7 @@ protocol to make nodes agree on a serializable transactional order.
219219
this is unacceptable, either the middleware or the application
220220
must query such values from a single server and then use those
221221
values in write queries. Another option is to use this replication
222-
option with a traditional master-standby setup, i.e. data modification
222+
option with a traditional master-standby setup, i.e., data modification
223223
queries are sent only to the master and are propagated to the
224224
standby servers via master-standby replication, not by the replication
225225
middleware. Care must also be taken that all
@@ -662,7 +662,7 @@ protocol to make nodes agree on a serializable transactional order.
662662
Set up continuous archiving on the primary to an archive directory
663663
accessible from the standby, as described
664664
in <xref linkend="continuous-archiving"/>. The archive location should be
665-
accessible from the standby even when the master is down, i.e. it should
665+
accessible from the standby even when the master is down, i.e., it should
666666
reside on the standby server itself or another trusted server, not on
667667
the master server.
668668
</para>
@@ -2233,7 +2233,7 @@ LOG: database system is ready to accept read only connections
22332233
<itemizedlist>
22342234
<listitem>
22352235
<para>
2236-
Data Definition Language (DDL): e.g. <command>CREATE INDEX</command>
2236+
Data Definition Language (DDL): e.g., <command>CREATE INDEX</command>
22372237
</para>
22382238
</listitem>
22392239
<listitem>
@@ -2299,7 +2299,7 @@ LOG: database system is ready to accept read only connections
22992299

23002300
<para>
23012301
WAL file control commands will not work during recovery,
2302-
e.g. <function>pg_start_backup</function>, <function>pg_switch_wal</function> etc.
2302+
e.g., <function>pg_start_backup</function>, <function>pg_switch_wal</function> etc.
23032303
</para>
23042304

23052305
<para>

‎doc/src/sgml/indexam.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -385,7 +385,7 @@ amcanreturn (Relation indexRelation, int attno);
385385
linkend="indexes-index-only-scans"><firstterm>index-only scans</firstterm></link> on
386386
the given column, by returning the indexed column values for an index entry
387387
in the form of an <structname>IndexTuple</structname>. The attribute number
388-
is 1-based, i.e. the first column's attno is 1. Returns true if supported,
388+
is 1-based, i.e., the first column's attno is 1. Returns true if supported,
389389
else false. If the access method does not support index-only scans at all,
390390
the <structfield>amcanreturn</structfield> field in its <structname>IndexAmRoutine</structname>
391391
struct can be set to NULL.

‎doc/src/sgml/install-windows.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@
117117
same purpose.
118118
From the <application>Visual Studio Command Prompt</application>, you can
119119
change the targeted CPU architecture, build type, and target OS by using the
120-
<command>vcvarsall.bat</command> command, e.g.
120+
<command>vcvarsall.bat</command> command, e.g.,
121121
<command>vcvarsall.bat x64 10.0.10240.0</command> to target Windows 10
122122
with a 64-bit release build. See <command>-help</command> for the other
123123
options of <command>vcvarsall.bat</command>. All commands should be run from
@@ -250,7 +250,7 @@ $ENV{MSBFLAGS}="/m";
250250
installations <filename>C:\Program Files\GnuWin32</filename>.
251251
Consider installing into <filename>C:\GnuWin32</filename> or use the
252252
NTFS short name path to GnuWin32 in your PATH environment setting
253-
(e.g. <filename>C:\PROGRA~1\GnuWin32</filename>).
253+
(e.g., <filename>C:\PROGRA~1\GnuWin32</filename>).
254254
</para>
255255
</note>
256256

‎doc/src/sgml/libpq.sgml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -355,7 +355,7 @@ PostgresPollingStatusType PQconnectPoll(PGconn *conn);
355355
Conversely, if <function>PQconnectPoll(conn)</function> last returned
356356
<symbol>PGRES_POLLING_WRITING</symbol>, wait until the socket is ready
357357
to write, then call <function>PQconnectPoll(conn)</function> again.
358-
On the first iteration, i.e. if you have yet to call
358+
On the first iteration, i.e., if you have yet to call
359359
<function>PQconnectPoll</function>, behave as if it last returned
360360
<symbol>PGRES_POLLING_WRITING</symbol>. Continue this loop until
361361
<function>PQconnectPoll(conn)</function> returns
@@ -994,7 +994,7 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
994994
<literal>hostaddr</literal>, and <literal>port</literal> options accept a comma-separated
995995
list of values. The same number of elements must be given in each
996996
option that is specified, such
997-
that e.g. the first <literal>hostaddr</literal> corresponds to the first host name,
997+
that e.g., the first <literal>hostaddr</literal> corresponds to the first host name,
998998
the second <literal>hostaddr</literal> corresponds to the second host name, and so
999999
forth. As an exception, if only one <literal>port</literal> is specified, it
10001000
applies to all the hosts.
@@ -1022,7 +1022,7 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
10221022
<para>
10231023
If a password file is used, you can have different passwords for
10241024
different hosts. All the other connection options are the same for every
1025-
host in the list; it is not possible to e.g. specify different
1025+
host in the list; it is not possible to e.g., specify different
10261026
usernames for different hosts.
10271027
</para>
10281028
</sect3>
@@ -1227,7 +1227,7 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
12271227
<listitem>
12281228
<para>
12291229
Maximum wait for connection, in seconds (write as a decimal integer,
1230-
e.g. <literal>10</literal>). Zero, negative, or not specified means
1230+
e.g., <literal>10</literal>). Zero, negative, or not specified means
12311231
wait indefinitely. The minimum allowed timeout is 2 seconds, therefore
12321232
a value of <literal>1</literal> is interpreted as <literal>2</literal>.
12331233
This timeout applies separately to each host name or IP address.
@@ -2426,7 +2426,7 @@ const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);
24262426
<term><literal>cipher</literal></term>
24272427
<listitem>
24282428
<para>
2429-
A short name of the ciphersuite used, e.g.
2429+
A short name of the ciphersuite used, e.g.,
24302430
<literal>"DHE-RSA-DES-CBC3-SHA"</literal>. The names are specific
24312431
to each SSL implementation.
24322432
</para>
@@ -4821,7 +4821,7 @@ int PQflush(PGconn *conn);
48214821
<xref linkend="libpq-PQflush"/> again. Repeat until
48224822
<xref linkend="libpq-PQflush"/> returns 0. (It is necessary to check for
48234823
read-ready and drain the input with <xref linkend="libpq-PQconsumeInput"/>,
4824-
because the server can block trying to send us data, e.g. NOTICE
4824+
because the server can block trying to send us data, e.g., NOTICE
48254825
messages, and won't read our data until we read its.) Once
48264826
<xref linkend="libpq-PQflush"/> returns 0, wait for the socket to be
48274827
read-ready and then read the response as described above.
@@ -7737,7 +7737,7 @@ ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*)
77377737
For a connection to be known SSL-secured, SSL usage must be configured
77387738
on <emphasis>both the client and the server</emphasis> before the connection
77397739
is made. If it is only configured on the server, the client may end up
7740-
sending sensitive information (e.g. passwords) before
7740+
sending sensitive information (e.g., passwords) before
77417741
it knows that the server requires high security. In libpq, secure
77427742
connections can be ensured
77437743
by setting the <literal>sslmode</literal> parameter to <literal>verify-full</literal> or

‎doc/src/sgml/monitoring.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -206,7 +206,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
206206
When the server shuts down cleanly, a permanent copy of the statistics
207207
data is stored in the <filename>pg_stat</filename> subdirectory, so that
208208
statistics can be retained across server restarts. When recovery is
209-
performed at server start (e.g. after immediate shutdown, server crash,
209+
performed at server start (e.g., after immediate shutdown, server crash,
210210
and point-in-time recovery), all statistics counters are reset.
211211
</para>
212212

‎doc/src/sgml/mvcc.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -269,7 +269,7 @@
269269
<para>
270270
In <productname>PostgreSQL</productname>, you can request any of
271271
the four standard transaction isolation levels, but internally only
272-
three distinct isolation levels are implemented, i.e. PostgreSQL's
272+
three distinct isolation levels are implemented, i.e., PostgreSQL's
273273
Read Uncommitted mode behaves like Read Committed. This is because
274274
it is the only sensible way to map the standard isolation levels to
275275
PostgreSQL's multiversion concurrency control architecture.

0 commit comments

Comments
 (0)