Skip to content

Commit 22c46ec

Browse files
Fix conflicts for sgml
1 parent 77c8b05 commit 22c46ec

34 files changed

Lines changed: 0 additions & 12822 deletions

doc/src/sgml/catalogs.sgml

Lines changed: 0 additions & 4577 deletions
Large diffs are not rendered by default.

doc/src/sgml/charset.sgml

Lines changed: 0 additions & 118 deletions
Original file line numberDiff line numberDiff line change
@@ -1017,124 +1017,6 @@ CREATE COLLATION german (provider = libc, locale = 'de_DE');
10171017

10181018
<sect4 id="collation-managing-create-icu">
10191019
<title>ICU Collations</title>
1020-
1021-
<<<<<<< HEAD
1022-
<para>
1023-
ICU allows collations to be customized beyond the basic language+country
1024-
set that is preloaded by <command>initdb</command>. Users are encouraged
1025-
to define their own collation objects that make use of these facilities to
1026-
suit the sorting behavior to their requirements.
1027-
See <ulink url="https://unicode-org.github.io/icu/userguide/locale/"></ulink>
1028-
and <ulink url="https://unicode-org.github.io/icu/userguide/collation/api.html"></ulink> for
1029-
information on ICU locale naming. The set of acceptable names and
1030-
attributes depends on the particular ICU version.
1031-
</para>
1032-
1033-
<para>
1034-
Here are some examples:
1035-
1036-
<variablelist>
1037-
<varlistentry>
1038-
<term><literal>CREATE COLLATION "de-u-co-phonebk-x-icu" (provider = icu, locale = 'de-u-co-phonebk');</literal></term>
1039-
<term><literal>CREATE COLLATION "de-u-co-phonebk-x-icu" (provider = icu, locale = 'de@collation=phonebook');</literal></term>
1040-
<listitem>
1041-
<para>German collation with phone book collation type</para>
1042-
<para>
1043-
The first example selects the ICU locale using a <quote>language
1044-
tag</quote> per BCP 47. The second example uses the traditional
1045-
ICU-specific locale syntax. The first style is preferred going
1046-
forward, but it is not supported by older ICU versions.
1047-
</para>
1048-
<para>
1049-
Note that you can name the collation objects in the SQL environment
1050-
anything you want. In this example, we follow the naming style that
1051-
the predefined collations use, which in turn also follow BCP 47, but
1052-
that is not required for user-defined collations.
1053-
</para>
1054-
</listitem>
1055-
</varlistentry>
1056-
1057-
<varlistentry>
1058-
<term><literal>CREATE COLLATION "und-u-co-emoji-x-icu" (provider = icu, locale = 'und-u-co-emoji');</literal></term>
1059-
<term><literal>CREATE COLLATION "und-u-co-emoji-x-icu" (provider = icu, locale = '@collation=emoji');</literal></term>
1060-
<listitem>
1061-
<para>
1062-
Root collation with Emoji collation type, per Unicode Technical Standard #51
1063-
</para>
1064-
<para>
1065-
Observe how in the traditional ICU locale naming system, the root
1066-
locale is selected by an empty string.
1067-
</para>
1068-
</listitem>
1069-
</varlistentry>
1070-
1071-
<varlistentry>
1072-
<term><literal>CREATE COLLATION latinlast (provider = icu, locale = 'en-u-kr-grek-latn');</literal></term>
1073-
<term><literal>CREATE COLLATION latinlast (provider = icu, locale = 'en@colReorder=grek-latn');</literal></term>
1074-
<listitem>
1075-
<para>
1076-
Sort Greek letters before Latin ones. (The default is Latin before Greek.)
1077-
</para>
1078-
</listitem>
1079-
</varlistentry>
1080-
1081-
<varlistentry>
1082-
<term><literal>CREATE COLLATION upperfirst (provider = icu, locale = 'en-u-kf-upper');</literal></term>
1083-
<term><literal>CREATE COLLATION upperfirst (provider = icu, locale = 'en@colCaseFirst=upper');</literal></term>
1084-
<listitem>
1085-
<para>
1086-
Sort upper-case letters before lower-case letters. (The default is
1087-
lower-case letters first.)
1088-
</para>
1089-
</listitem>
1090-
</varlistentry>
1091-
1092-
<varlistentry>
1093-
<term><literal>CREATE COLLATION special (provider = icu, locale = 'en-u-kf-upper-kr-grek-latn');</literal></term>
1094-
<term><literal>CREATE COLLATION special (provider = icu, locale = 'en@colCaseFirst=upper;colReorder=grek-latn');</literal></term>
1095-
<listitem>
1096-
<para>
1097-
Combines both of the above options.
1098-
</para>
1099-
</listitem>
1100-
</varlistentry>
1101-
1102-
<varlistentry>
1103-
<term><literal>CREATE COLLATION numeric (provider = icu, locale = 'en-u-kn-true');</literal></term>
1104-
<term><literal>CREATE COLLATION numeric (provider = icu, locale = 'en@colNumeric=yes');</literal></term>
1105-
<listitem>
1106-
<para>
1107-
Numeric ordering, sorts sequences of digits by their numeric value,
1108-
for example: <literal>A-21</literal> &lt; <literal>A-123</literal>
1109-
(also known as natural sort).
1110-
</para>
1111-
</listitem>
1112-
</varlistentry>
1113-
</variablelist>
1114-
1115-
See <ulink url="https://www.unicode.org/reports/tr35/tr35-collation.html">Unicode
1116-
Technical Standard #35</ulink>
1117-
and <ulink url="https://tools.ietf.org/html/bcp47">BCP 47</ulink> for
1118-
details. The list of possible collation types (<literal>co</literal>
1119-
subtag) can be found in
1120-
the <ulink url="https://github.com/unicode-org/cldr/blob/master/common/bcp47/collation.xml">CLDR
1121-
repository</ulink>.
1122-
</para>
1123-
1124-
<para>
1125-
Note that while this system allows creating collations that <quote>ignore
1126-
case</quote> or <quote>ignore accents</quote> or similar (using the
1127-
<literal>ks</literal> key), in order for such collations to act in a
1128-
truly case- or accent-insensitive manner, they also need to be declared as not
1129-
<firstterm>deterministic</firstterm> in <command>CREATE COLLATION</command>;
1130-
see <xref linkend="collation-nondeterministic"/>.
1131-
Otherwise, any strings that compare equal according to the collation but
1132-
are not byte-wise equal will be sorted according to their byte values.
1133-
</para>
1134-
1135-
<note>
1136-
=======
1137-
>>>>>>> REL_16_9
11381020
<para>
11391021
ICU collations can be created like:
11401022

doc/src/sgml/config.sgml

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2016,8 +2016,6 @@ include_dir 'conf.d'
20162016
that has no effect on the number of dead tuples that autovacuum can
20172017
collect while scanning a table.
20182018
</para>
2019-
<<<<<<< HEAD
2020-
=======
20212019
</listitem>
20222020
</varlistentry>
20232021

@@ -2048,7 +2046,6 @@ include_dir 'conf.d'
20482046
setting may cause too many other useful pages to be evicted from
20492047
shared buffers.
20502048
</para>
2051-
>>>>>>> REL_16_9
20522049
</listitem>
20532050
</varlistentry>
20542051

@@ -2898,14 +2895,8 @@ include_dir 'conf.d'
28982895
In fact, the server will not even start in this mode if
28992896
<varname>max_wal_senders</varname> is non-zero.
29002897
Note that changing <varname>wal_level</varname> to
2901-
<<<<<<< HEAD
2902-
<literal>minimal</literal> makes any base backups taken before
2903-
unavailable for archive recovery and standby server, which may
2904-
lead to data loss. Cluster file encryption also does not support.
2905-
=======
29062898
<literal>minimal</literal> makes previous base backups unusable
29072899
for point-in-time recovery and standby servers.
2908-
>>>>>>> REL_16_9
29092900
</para>
29102901
<para>
29112902
In <literal>logical</literal> level, the same information is logged as
@@ -8105,22 +8096,13 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
81058096
Enables the collection of information on the currently
81068097
executing command of each session, along with its identifier and the
81078098
time when that command began execution. This parameter is on by
8108-
<<<<<<< HEAD
8109-
default. Note that even when enabled, this information is not
8110-
visible to all users, only to superusers, roles with privileges of the
8111-
<literal>pg_read_all_stats</literal> role and the user owning the
8112-
sessions being reported on (including sessions belonging to a role they
8113-
have the privileges of), so it should not represent a security risk.
8114-
Only superusers can change this setting.
8115-
=======
81168099
default. Note that even when enabled, this information is only
81178100
visible to superusers, roles with privileges of the
81188101
<literal>pg_read_all_stats</literal> role and the user owning the
81198102
sessions being reported on (including sessions belonging to a role they
81208103
have the privileges of), so it should not represent a security risk.
81218104
Only superusers and users with the appropriate <literal>SET</literal>
81228105
privilege can change this setting.
8123-
>>>>>>> REL_16_9
81248106
</para>
81258107
</listitem>
81268108
</varlistentry>

doc/src/sgml/custom-rmgr.sgml

Lines changed: 0 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,6 @@ typedef struct RmgrData
5555
void (*rm_decode) (struct LogicalDecodingContext *ctx,
5656
struct XLogRecordBuffer *buf);
5757
} RmgrData;
58-
<<<<<<< HEAD
59-
</programlisting>
60-
</para>
61-
=======
6258
</programlisting>
6359
</para>
6460

@@ -68,7 +64,6 @@ typedef struct RmgrData
6864
resource managers.
6965
</para>
7066

71-
>>>>>>> REL_16_9
7267
<para>
7368
Then, register your new resource
7469
manager.
@@ -78,31 +73,18 @@ typedef struct RmgrData
7873
* Register a new custom WAL resource manager.
7974
*
8075
* Resource manager IDs must be globally unique across all extensions. Refer
81-
<<<<<<< HEAD
82-
* to https://wiki.postgresql.org/wiki/CustomWALResourceManager to reserve a
83-
=======
8476
* to https://wiki.postgresql.org/wiki/CustomWALResourceManagers to reserve a
85-
>>>>>>> REL_16_9
8677
* unique RmgrId for your extension, to avoid conflicts with other extension
8778
* developers. During development, use RM_EXPERIMENTAL_ID to avoid needlessly
8879
* reserving a new ID.
8980
*/
90-
<<<<<<< HEAD
91-
extern void RegisterCustomRmgr(RmgrId rmid, RmgrData *rmgr);
92-
=======
9381
extern void RegisterCustomRmgr(RmgrId rmid, const RmgrData *rmgr);
94-
>>>>>>> REL_16_9
9582
</programlisting>
9683
<function>RegisterCustomRmgr</function> must be called from the
9784
extension module's <link linkend="xfunc-c-dynload">_PG_init</link> function.
9885
While developing a new extension, use <literal>RM_EXPERIMENTAL_ID</literal>
99-
<<<<<<< HEAD
100-
for <parameter>rmid</parameter>. When you ready to release the extension to
101-
users, reserve a new resource manager ID at the <ulink
102-
=======
10386
for <parameter>rmid</parameter>. When you are ready to release the extension
10487
to users, reserve a new resource manager ID at the <ulink
105-
>>>>>>> REL_16_9
10688
url="https://wiki.postgresql.org/wiki/CustomWALResourceManagers">Custom WAL
10789
Resource Manager</ulink> page.
10890
</para>
@@ -113,11 +95,7 @@ extern void RegisterCustomRmgr(RmgrId rmid, const RmgrData *rmgr);
11395
during <productname>PostgreSQL</productname> startup.
11496
</para>
11597
<note>
116-
<<<<<<< HEAD
117-
<para>
118-
=======
11998
<para>
120-
>>>>>>> REL_16_9
12199
The extension must remain in shared_preload_libraries as long as any
122100
custom WAL records may exist in the system. Otherwise
123101
<productname>PostgreSQL</productname> will not be able to apply or decode

doc/src/sgml/datatype.sgml

Lines changed: 0 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -2872,13 +2872,6 @@ P <optional> <replaceable>years</replaceable>-<replaceable>months</replaceable>-
28722872
</para>
28732873

28742874
<para>
2875-
<<<<<<< HEAD
2876-
Field values can have fractional parts: for example, <literal>'1.5
2877-
weeks'</literal> or <literal>'01:02:03.45'</literal>. However,
2878-
because interval internally stores only three integer units (months,
2879-
days, microseconds), fractional units must be spilled to smaller
2880-
units. Fractional parts of units greater than months are truncated to
2881-
=======
28822875
Internally, <type>interval</type> values are stored as three integral
28832876
fields: months, days, and microseconds. These fields are kept
28842877
separate because the number of days in a month varies, while a day
@@ -2905,7 +2898,6 @@ SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
29052898
because <type>interval</type> internally stores only integral fields,
29062899
fractional values must be converted into smaller
29072900
units. Fractional parts of units greater than months are rounded to
2908-
>>>>>>> REL_16_9
29092901
be an integer number of months, e.g. <literal>'1.5 years'</literal>
29102902
becomes <literal>'1 year 6 mons'</literal>. Fractional parts of
29112903
weeks and days are computed to be an integer number of days and
@@ -2954,36 +2946,6 @@ SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
29542946
</tgroup>
29552947
</table>
29562948

2957-
<<<<<<< HEAD
2958-
<para>
2959-
Internally <type>interval</type> values are stored as months, days,
2960-
and microseconds. This is done because the number of days in a month
2961-
varies, and a day can have 23 or 25 hours if a daylight savings
2962-
time adjustment is involved. The months and days fields are integers
2963-
while the microseconds field can store fractional seconds. Because intervals are
2964-
usually created from constant strings or <type>timestamp</type> subtraction,
2965-
this storage method works well in most cases, but can cause unexpected
2966-
results:
2967-
2968-
<programlisting>
2969-
SELECT EXTRACT(hours from '80 minutes'::interval);
2970-
date_part
2971-
-----------
2972-
1
2973-
2974-
SELECT EXTRACT(days from '80 hours'::interval);
2975-
date_part
2976-
-----------
2977-
0
2978-
</programlisting>
2979-
2980-
Functions <function>justify_days</function> and
2981-
<function>justify_hours</function> are available for adjusting days
2982-
and hours that overflow their normal ranges.
2983-
</para>
2984-
2985-
=======
2986-
>>>>>>> REL_16_9
29872949
</sect2>
29882950

29892951
<sect2 id="datatype-interval-output">

0 commit comments

Comments
 (0)