Dear Daniel, Tom, > > On 20 Mar 2023, at 15:31, Tom Lane <t...@sss.pgh.pa.us> wrote: > > > > "Hayato Kuroda (Fujitsu)" <kuroda.hay...@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
fix_inconsistent_tag.patch
Description: fix_inconsistent_tag.patch