RE: Question: Do we have a rule to use "PostgreSQL" and "PostgreSQL" separately?

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