Questionable tag usage

From: Tatsuo Ishii <ishii(at)sraoss(dot)co(dot)jp>
To: pgsql-docs(at)postgresql(dot)org
Cc: pgsql-hackers(at)postgresql(dot)org
Subject: Questionable tag usage
Date: 2017-01-05 00:25:57
Message-ID: 20170105.092557.1822243556008160851.t-ishii@sraoss.co.jp
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

In:
https://www.postgresql.org/docs/devel/static/runtime-config-file-locations.html

---------------------------------------------------
ident_file (string)

Specifies the configuration file for Section 20.2, “User Name Maps” user name mapping (customarily called pg_ident.conf). This parameter can only be set at server start.
---------------------------------------------------

"Specifies the configuration file for Section 20.2, “User Name Maps”
user name mapping" looks pretty strange to me because a raw section
name appears. This is due to the corresponding SGML coding:

<para>
Specifies the configuration file for
<xref linkend="auth-username-maps"> user name mapping
(customarily called <filename>pg_ident.conf</>).
This parameter can only be set at server start.
</para>

Shouldn't we use a link tag instead of the xref tag here? Attached is
a patch to fix this.

Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp

Attachment Content-Type Size
config.diff text/x-patch 768 bytes

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message nnj 2017-01-05 01:09:04 I notice Postgresql 'HAVING' doesn't work.
Previous Message Tatsuo Ishii 2017-01-04 23:40:28 Questionable tag usage

Browse pgsql-hackers by date

  From Date Subject
Next Message Vitaly Burovoy 2017-01-05 00:34:15 Re: identity columns
Previous Message Kouhei Kaigai 2017-01-04 23:58:18 Re: PassDownLimitBound for ForeignScan/CustomScan [take-2]