pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Anton Voloshin <a.voloshin@postgrespro.ru>
To: pgsql-docs@lists.postgresql.org
Subject: [PATCH] add link to domain data types section from locale documentation
Date: Tue, 30 Mar 2021 22:46:34 +0300
Message-ID: <2ea65bdf-1380-f088-02bd-ff1a31ed265c@postgrespro.ru> (raw)

Hello.

While browsing character set collation documentation [1]
I've found myself a bit puzzled by unfamiliar terminology:
 > of course a domain over a collatable data type is collatable

Of course, it only takes a search or two to find out the exact
meaning of "domain" in this context, but I think it would be useful
to make this word a link to the relevant section as a help for less 
experienced users like myself.

I've attached a patch that does that. Please let me know whether this 
fix is desirable and correct (I'm new to Postgres) and if there is a 
better way of suggesting an improvement for the documentation.

[1] https://www.postgresql.org/docs/current/collation.html

-- 
Anton Voloshin
Postgres Professional: https://www.postgrespro.com
Russian Postgres Company

Attachments:

collation-domains-link.patch (text/plain, 795B) download diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index 1b00e543a6..300a0d83d4 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -346,7 +346,8 @@ initdb --locale=sv_SE collation. (The built-in collatable data types are <type>text</type>, <type>varchar</type>, and <type>char</type>. User-defined base types can also be marked collatable, and of course - a domain over a collatable data type is collatable.) If the + a <link linkend="domains">domain</link> over a collatable data type + is collatable.) If the expression is a column reference, the collation of the expression is the defined collation of the column. If the expression is a constant, the collation is the default collation of the data type of the

view thread (10+ messages)  latest in thread

Message-ID: <2ea65bdf-1380-f088-02bd-ff1a31ed265c@postgrespro.ru>
Permalink:  ../2ea65bdf-1380-f088-02bd-ff1a31ed265c@postgrespro.ru/
Also on:    postgresql.org/message-id/2ea65bdf-1380-f088-02bd-ff1a31ed265c@postgrespro.ru

 ·  · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: a.voloshin@postgrespro.ru, pgsql-docs@lists.postgresql.org
  Subject: Re: [PATCH] add link to domain data types section from locale documentation
  In-Reply-To: <2ea65bdf-1380-f088-02bd-ff1a31ed265c@postgrespro.ru>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox