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

Commit 5ebad9a

Browse files
committed
docs: re-add spaces before units removed
This reverts the spaces before k/M/G/TB units removed for consistency in commit ca0c37b. Discussion: 20160802165116.GC32575@momjian.us
1 parent a629330 commit 5ebad9a

File tree

10 files changed

+34
-34
lines changed

10 files changed

+34
-34
lines changed

doc/src/sgml/bloom.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ CREATE INDEX
177177
query. We could reduce that by specifying a larger signature length.
178178
In this example, creating the index with <literal>length=200</>
179179
reduced the number of false positives to 55; but it doubled the index size
180-
(to 306MB) and ended up being slower for this query (125 ms overall).
180+
(to 306 MB) and ended up being slower for this query (125 ms overall).
181181
</para>
182182

183183
<para>
@@ -202,7 +202,7 @@ CREATE INDEX
202202
</programlisting>
203203
Although this query runs much faster than with either of the single
204204
indexes, we pay a large penalty in index size. Each of the single-column
205-
btree indexes occupies 214MB, so the total space needed is over 1.2GB,
205+
btree indexes occupies 214 MB, so the total space needed is over 1.2GB,
206206
more than 8 times the space used by the bloom index.
207207
</para>
208208
</sect2>

doc/src/sgml/catalogs.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4021,7 +4021,7 @@
40214021
segments or <quote>pages</> small enough to be conveniently stored as rows
40224022
in <structname>pg_largeobject</structname>.
40234023
The amount of data per page is defined to be <symbol>LOBLKSIZE</> (which is currently
4024-
<literal>BLCKSZ/4</>, or typically 2kB).
4024+
<literal>BLCKSZ/4</>, or typically 2 kB).
40254025
</para>
40264026

40274027
<para>

doc/src/sgml/config.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2702,7 +2702,7 @@ include_dir 'conf.d'
27022702
checkpoints. This is a soft limit; WAL size can exceed
27032703
<varname>max_wal_size</> under special circumstances, like
27042704
under heavy load, a failing <varname>archive_command</>, or a high
2705-
<varname>wal_keep_segments</> setting. The default is 1GB.
2705+
<varname>wal_keep_segments</> setting. The default is 1 GB.
27062706
Increasing this parameter can increase the amount of time needed for
27072707
crash recovery.
27082708
This parameter can only be set in the <filename>postgresql.conf</>
@@ -2723,7 +2723,7 @@ include_dir 'conf.d'
27232723
always recycled for future use at a checkpoint, rather than removed.
27242724
This can be used to ensure that enough WAL space is reserved to
27252725
handle spikes in WAL usage, for example when running large batch
2726-
jobs. The default is 80MB.
2726+
jobs. The default is 80 MB.
27272727
This parameter can only be set in the <filename>postgresql.conf</>
27282728
file or on the server command line.
27292729
</para>

doc/src/sgml/datatype.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1120,7 +1120,7 @@ SELECT '52093.89'::money::numeric::float8;
11201120
the physical requirement on disk might be less. Very long values are also
11211121
stored in background tables so that they do not interfere with rapid
11221122
access to shorter column values. In any case, the longest
1123-
possible character string that can be stored is about 1GB. (The
1123+
possible character string that can be stored is about 1 GB. (The
11241124
maximum value that will be allowed for <replaceable>n</> in the data
11251125
type declaration is less than that. It wouldn't be useful to
11261126
change this because with multibyte character encodings the number of

doc/src/sgml/installation.sgml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -326,12 +326,12 @@ su - postgres
326326

327327
<para>
328328
Also check that you have sufficient disk space. You will need about
329-
100MB for the source tree during compilation and about 20MB for
329+
100 MB for the source tree during compilation and about 20 MB for
330330
the installation directory. An empty database cluster takes about
331-
35MB; databases take about five times the amount of space that a
331+
35 MB; databases take about five times the amount of space that a
332332
flat text file with the same data would take. If you are going to
333333
run the regression tests you will temporarily need up to an extra
334-
150MB. Use the <command>df</command> command to check free disk
334+
150 MB. Use the <command>df</command> command to check free disk
335335
space.
336336
</para>
337337
</sect1>
@@ -2241,7 +2241,7 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
22412241
createlang: language installation failed: ERROR: could not load library "/opt/dbs/pgsql748/lib/plperl.so": Bad address
22422242
</screen>
22432243
Another example is out of memory errors in the PostgreSQL server
2244-
logs, with every memory allocation near or greater than 256MB
2244+
logs, with every memory allocation near or greater than 256 MB
22452245
failing.
22462246
</para>
22472247

@@ -2250,8 +2250,8 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
22502250
and memory model used by the server process. By default, all
22512251
binaries built on AIX are 32-bit. This does not depend upon
22522252
hardware type or kernel in use. These 32-bit processes are
2253-
limited to 4GB of memory laid out in 256MB segments using one
2254-
of a few models. The default allows for less than 256MB in the
2253+
limited to 4 GB of memory laid out in 256 MB segments using one
2254+
of a few models. The default allows for less than 256 MB in the
22552255
heap as it shares a single segment with the stack.
22562256
</para>
22572257

@@ -2282,7 +2282,7 @@ createlang: language installation failed: ERROR: could not load library "/opt/d
22822282
settings to find a configuration that works satisfactorily. This
22832283
use of <symbol>LDR_CNTRL</symbol> tells AIX that you want the
22842284
server to have <symbol>MAXDATA</symbol> bytes set aside for the
2285-
heap, allocated in 256MB segments. When you find a workable
2285+
heap, allocated in 256 MB segments. When you find a workable
22862286
configuration,
22872287
<command>ldedit</command> can be used to modify the binaries so
22882288
that they default to using the desired heap size. PostgreSQL can

doc/src/sgml/lobj.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,8 @@
5050
larger than a single database page into a secondary storage area per table.
5151
This makes the large object facility partially obsolete. One
5252
remaining advantage of the large object facility is that it allows values
53-
up to 4TB in size, whereas <acronym>TOAST</acronym>ed fields can be at
54-
most 1GB. Also, reading and updating portions of a large object can be
53+
up to 4 TB in size, whereas <acronym>TOAST</acronym>ed fields can be at
54+
most 1 GB. Also, reading and updating portions of a large object can be
5555
done efficiently, while most operations on a <acronym>TOAST</acronym>ed
5656
field will read or write the whole value as a unit.
5757
</para>

doc/src/sgml/protocol.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1973,7 +1973,7 @@ The commands accepted in walsender mode are:
19731973
Limit (throttle) the maximum amount of data transferred from server
19741974
to client per unit of time. The expected unit is kilobytes per second.
19751975
If this option is specified, the value must either be equal to zero
1976-
or it must fall within the range from 32kB through 1GB (inclusive).
1976+
or it must fall within the range from 32 kB through 1 GB (inclusive).
19771977
If zero is passed or the option is not specified, no restriction is
19781978
imposed on the transfer.
19791979
</para>

doc/src/sgml/runtime.sgml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -968,7 +968,7 @@ option SEMMAP=256
968968
</term>
969969
<listitem>
970970
<para>
971-
The default maximum segment size is 32MB, and the
971+
The default maximum segment size is 32 MB, and the
972972
default maximum total size is 2097152
973973
pages. A page is almost always 4096 bytes except in unusual
974974
kernel configurations with <quote>huge pages</quote>
@@ -977,7 +977,7 @@ option SEMMAP=256
977977

978978
<para>
979979
The shared memory size settings can be changed via the
980-
<command>sysctl</command> interface. For example, to allow 16GB:
980+
<command>sysctl</command> interface. For example, to allow 16 GB:
981981
<screen>
982982
<prompt>$</prompt> <userinput>sysctl -w kernel.shmmax=17179869184</userinput>
983983
<prompt>$</prompt> <userinput>sysctl -w kernel.shmall=4194304</userinput>
@@ -1032,7 +1032,7 @@ kern.sysv.shmall=1024
10321032
</para>
10331033

10341034
<para>
1035-
<varname>SHMALL</> is measured in 4kB pages on this platform.
1035+
<varname>SHMALL</> is measured in 4 kB pages on this platform.
10361036
</para>
10371037

10381038
<para>
@@ -1075,7 +1075,7 @@ sysctl -w kern.sysv.shmall
10751075
</term>
10761076
<listitem>
10771077
<para>
1078-
In the default configuration, only 512kB of shared memory per
1078+
In the default configuration, only 512 kB of shared memory per
10791079
segment is allowed. To increase the setting, first change to the
10801080
directory <filename>/etc/conf/cf.d</>. To display the current value of
10811081
<varname>SHMMAX</>, run:
@@ -1180,7 +1180,7 @@ project.max-msg-ids=(priv,4096,deny)
11801180
<listitem>
11811181
<para>
11821182
On <productname>UnixWare</> 7, the maximum size for shared
1183-
memory segments is 512kB in the default configuration.
1183+
memory segments is 512 kB in the default configuration.
11841184
To display the current value of <varname>SHMMAX</>, run:
11851185
<programlisting>
11861186
/etc/conf/bin/idtune -g SHMMAX

doc/src/sgml/storage.sgml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -217,11 +217,11 @@ function.
217217
</caution>
218218

219219
<para>
220-
When a table or index exceeds 1GB, it is divided into gigabyte-sized
220+
When a table or index exceeds 1 GB, it is divided into gigabyte-sized
221221
<firstterm>segments</>. The first segment's file name is the same as the
222222
filenode; subsequent segments are named filenode.1, filenode.2, etc.
223223
This arrangement avoids problems on platforms that have file size limitations.
224-
(Actually, 1GB is just the default segment size. The segment size can be
224+
(Actually, 1 GB is just the default segment size. The segment size can be
225225
adjusted using the configuration option <option>--with-segsize</option>
226226
when building <productname>PostgreSQL</>.)
227227
In principle, free space map and visibility map forks could require multiple
@@ -303,7 +303,7 @@ Oversized-Attribute Storage Technique).
303303

304304
<para>
305305
<productname>PostgreSQL</productname> uses a fixed page size (commonly
306-
8kB), and does not allow tuples to span multiple pages. Therefore, it is
306+
8 kB), and does not allow tuples to span multiple pages. Therefore, it is
307307
not possible to store very large field values directly. To overcome
308308
this limitation, large field values are compressed and/or broken up into
309309
multiple physical rows. This happens transparently to the user, with only
@@ -336,15 +336,15 @@ See <xref linkend="xtypes-toast"> for more detail.)
336336
<acronym>TOAST</> usurps two bits of the varlena length word (the high-order
337337
bits on big-endian machines, the low-order bits on little-endian machines),
338338
thereby limiting the logical size of any value of a <acronym>TOAST</>-able
339-
data type to 1GB (2<superscript>30</> - 1 bytes). When both bits are zero,
339+
data type to 1 GB (2<superscript>30</> - 1 bytes). When both bits are zero,
340340
the value is an ordinary un-<acronym>TOAST</>ed value of the data type, and
341341
the remaining bits of the length word give the total datum size (including
342342
length word) in bytes. When the highest-order or lowest-order bit is set,
343343
the value has only a single-byte header instead of the normal four-byte
344344
header, and the remaining bits of that byte give the total datum size
345345
(including length byte) in bytes. This alternative supports space-efficient
346346
storage of values shorter than 127 bytes, while still allowing the data type
347-
to grow to 1GB at need. Values with single-byte headers aren't aligned on
347+
to grow to 1 GB at need. Values with single-byte headers aren't aligned on
348348
any particular boundary, whereas values with four-byte headers are aligned on
349349
at least a four-byte boundary; this omission of alignment padding provides
350350
additional space savings that is significant compared to short values.
@@ -420,10 +420,10 @@ bytes regardless of the actual size of the represented value.
420420
<para>
421421
The <acronym>TOAST</> management code is triggered only
422422
when a row value to be stored in a table is wider than
423-
<symbol>TOAST_TUPLE_THRESHOLD</> bytes (normally 2kB).
423+
<symbol>TOAST_TUPLE_THRESHOLD</> bytes (normally 2 kB).
424424
The <acronym>TOAST</> code will compress and/or move
425425
field values out-of-line until the row value is shorter than
426-
<symbol>TOAST_TUPLE_TARGET</> bytes (also normally 2kB)
426+
<symbol>TOAST_TUPLE_TARGET</> bytes (also normally 2 kB)
427427
or no more gains can be had. During an UPDATE
428428
operation, values of unchanged fields are normally preserved as-is; so an
429429
UPDATE of a row with out-of-line values incurs no <acronym>TOAST</> costs if
@@ -491,7 +491,7 @@ containing typical HTML pages and their URLs was stored in about half of the
491491
raw data size including the <acronym>TOAST</> table, and that the main table
492492
contained only about 10% of the entire data (the URLs and some small HTML
493493
pages). There was no run time difference compared to an un-<acronym>TOAST</>ed
494-
comparison table, in which all the HTML pages were cut down to 7kB to fit.
494+
comparison table, in which all the HTML pages were cut down to 7 kB to fit.
495495
</para>
496496

497497
</sect2>
@@ -512,7 +512,7 @@ pointers to <firstterm>expanded</> data.
512512
Indirect <acronym>TOAST</> pointers simply point at a non-indirect varlena
513513
value stored somewhere in memory. This case was originally created merely
514514
as a proof of concept, but it is currently used during logical decoding to
515-
avoid possibly having to create physical tuples exceeding 1GB (as pulling
515+
avoid possibly having to create physical tuples exceeding 1 GB (as pulling
516516
all out-of-line field values into the tuple might do). The case is of
517517
limited use since the creator of the pointer datum is entirely responsible
518518
that the referenced data survives for as long as the pointer could exist,
@@ -703,7 +703,7 @@ an item is a row; in an index, an item is an index entry.
703703

704704
<para>
705705
Every table and index is stored as an array of <firstterm>pages</> of a
706-
fixed size (usually 8kB, although a different page size can be selected
706+
fixed size (usually 8 kB, although a different page size can be selected
707707
when compiling the server). In a table, all the pages are logically
708708
equivalent, so a particular item (row) can be stored in any page. In
709709
indexes, the first page is generally reserved as a <firstterm>metapage</>

doc/src/sgml/wal.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -475,7 +475,7 @@
475475
linkend="guc-checkpoint-timeout"> seconds, or if
476476
<xref linkend="guc-max-wal-size"> is about to be exceeded,
477477
whichever comes first.
478-
The default settings are 5 minutes and 1GB, respectively.
478+
The default settings are 5 minutes and 1 GB, respectively.
479479
If no WAL has been written since the previous checkpoint, new checkpoints
480480
will be skipped even if <varname>checkpoint_timeout</> has passed.
481481
(If WAL archiving is being used and you want to put a lower limit on how
@@ -735,10 +735,10 @@
735735
<para>
736736
<acronym>WAL</acronym> logs are stored in the directory
737737
<filename>pg_xlog</filename> under the data directory, as a set of
738-
segment files, normally each 16MB in size (but the size can be changed
738+
segment files, normally each 16 MB in size (but the size can be changed
739739
by altering the <option>--with-wal-segsize</> configure option when
740740
building the server). Each segment is divided into pages, normally
741-
8kB each (this size can be changed via the <option>--with-wal-blocksize</>
741+
8 kB each (this size can be changed via the <option>--with-wal-blocksize</>
742742
configure option). The log record headers are described in
743743
<filename>access/xlogrecord.h</filename>; the record content is dependent
744744
on the type of event that is being logged. Segment files are given

0 commit comments

Comments
 (0)