On Sun, Jan 10, 2021 at 01:11:07PM -0800, Noah Misch wrote: > On Sun, Jan 10, 2021 at 08:22:42PM +0900, Tatsuo Ishii wrote: > > In doc/src/sgml/func.sgml description of SHOW command use > > "<acronym>SQL</acronym>", while SET command description the same > > section does not use "<acronym>". Shouldn't the description of SET use > > "<acronym>" for "SQL" as well? Patch attached. > > https://tdg.docbook.org/tdg/5.2/acronym.html suggests docbook formatters > either ignore that <acronym> or use it as a signal to substitute small caps. > I don't consider small caps an improvement for "SQL", so I'd prefer to never > use <acronym>SQL</acronym>. <acronym> also makes the markup longer (though > one could mitigate that with an entity like &SQL). However, standardizing on > either way is better than varying within the manual.
I think smallcaps is almost always a win for acronyms. -- Bruce Momjian <br...@momjian.us> https://momjian.us EnterpriseDB https://enterprisedb.com The usefulness of a cup is in its emptiness, Bruce Lee
