Dear Daniel, Tom,
> > On 20 Mar 2023, at 15:31, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> >
> > "Hayato Kuroda (Fujitsu)" <kuroda.hayato@fujitsu.com> writes:
> >> While checking documentations, I found that one line notes our product as
> >> "<productname>PostgreSQL</productname>", whereas another line notes
> as just
> >> "PostgreSQL".
> >
> > IMO the convention is to use the <productname> tag everywhere that we
> > spell out "PostgreSQL". I don't think it's actually rendered differently
> > with our current stylesheets, but maybe someday it will be.
>
> IIRC the main use in DocBook is for automatically decorating productnames with
> trademark signs etc, and to generate lists of trademarks, but also that they
> can be rendered differently.
OK, I understood that even if the string is not rendered, that should be tagged as <productname>.
> IIRC the main use in DocBook is for automatically decorating productnames with
> trademark signs etc, and to generate lists of trademarks, but also that they
> can be rendered differently.
>
> This reminded me that I was planning to apply the below to make the markup of
> PostgreSQL consistent:
I have also grepped to detect another wrong markups, and I think at least
"<entry>PostgreSQL</entry>" should be changed. PSA the patch.
```
$ grep -rI \>PostgreSQL\< | grep -v productname
config.sgml: the log. The default is <literal>PostgreSQL</literal>.
func.sgml: <returnvalue>PostgreSQL</returnvalue>
func.sgml: <entry>PostgreSQL</entry>
runtime.sgml: event source named <literal>PostgreSQL</literal>.
problems.sgml: The software package in total is called <quote>PostgreSQL</quote>,
ref/pg_ctl-ref.sgml: default is <literal>PostgreSQL</literal>. Note that this only controls
ref/pg_ctl-ref.sgml: source name <literal>PostgreSQL</literal>.
ref/pg_ctl-ref.sgml: The default is <literal>PostgreSQL</literal>.
```
Best Regards,
Hayato Kuroda
FUJITSU LIMITED
