MIME-Version: 1.0
References: 
 <CADkLM=fwtE-TCU7sRnvaE74z12kOp_A+CdUwMr7aZt39pXbh6A@mail.gmail.com>
 <20200320001122.GA19602@alvherre.pgsql>
 <CADkLM=edwjdfMCoCMxHDrXfX_UW0TdPuyvRO=wFqaddxER4cTQ@mail.gmail.com>
In-Reply-To: 
 <CADkLM=edwjdfMCoCMxHDrXfX_UW0TdPuyvRO=wFqaddxER4cTQ@mail.gmail.com>
From: Corey Huinker <corey.huinker@gmail.com>
Date: Fri, 20 Mar 2020 11:48:24 -0400
Message-ID: 
 <CADkLM=dTFNCnx+bdoVCVbAn3v8ihvgUh-dQpin4ngrx=RMykFA@mail.gmail.com>
Subject: Re: Add A Glossary
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: =?UTF-8?Q?J=C3=BCrgen_Purtz?= <juergen@purtz.de>,
	Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
	Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
Content-Type: multipart/alternative; boundary="00000000000002f65d05a14b3813"
Precedence: bulk

--00000000000002f65d05a14b3813
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

>
> J=C3=BCrgen mentioned off-list that the man page doesn't build. I was goi=
ng to
>> look into that, but if anyone has more familiarity with that, I'm listen=
ing.
>>
>
Looking at this some more, I'm not sure anything needs to be done for man
pages. man1 is for executables, man3 seems to be dblink and SPI, and man7
is all SQL commands. This isn't any of those. The only possible thing left
would be how to render the text of a <glossterm>foo</glossterm, and so I
looked to see what we do in man pages for acronyms, and the answer appears
to be "nothing":

postgres/doc/src$ git grep acronym | grep -v '\/acronym'
sgml/filelist.sgml:<!ENTITY acronyms   SYSTEM "acronyms.sgml">
sgml/postgres.sgml:  &acronyms;
sgml/release.sgml:[A-Z][A-Z_ ]+[A-Z_]             <command>, <literal>,
<envar>, <acronym>
sgml/stylesheet.css:acronym { font-style: inherit; }

filelist.sgml, postgres.sgml, ans stylesheet.css already have the
corresponding change, and the release.sgml is just an incidental mention of
acronym.

Of course I could be missing something.

>

--00000000000002f65d05a14b3813
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div class=3D"gmail_quote"><blockquote cl=
ass=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid=
 rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><div class=3D"gmail_qu=
ote"><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;bo=
rder-left:1px solid rgb(204,204,204);padding-left:1ex">J=C3=BCrgen mentione=
d off-list that the man page doesn&#39;t build. I was going to look into th=
at, but if anyone has more familiarity with that, I&#39;m listening.<br></b=
lockquote></div></div></blockquote><div><br></div><div>Looking at this some=
 more, I&#39;m not sure anything needs to be done for man pages. man1 is fo=
r executables, man3 seems to be dblink and SPI, and man7 is all SQL command=
s. This isn&#39;t any of those. The only possible thing left would be how t=
o render the text of a &lt;glossterm&gt;foo&lt;/glossterm, and so I looked =
to see what we do in man pages for acronyms, and the answer appears to be &=
quot;nothing&quot;:</div><div><br></div><div>postgres/doc/src$ git grep acr=
onym | grep -v &#39;\/acronym&#39;<br>sgml/filelist.sgml:&lt;!ENTITY acrony=
ms =C2=A0 SYSTEM &quot;acronyms.sgml&quot;&gt;<br>sgml/postgres.sgml: =C2=
=A0&amp;acronyms;<br>sgml/release.sgml:[A-Z][A-Z_ ]+[A-Z_] =C2=A0 =C2=A0 =
=C2=A0 =C2=A0 =C2=A0 =C2=A0 &lt;command&gt;, &lt;literal&gt;, &lt;envar&gt;=
, &lt;acronym&gt;<br>sgml/stylesheet.css:acronym		{ font-style: inherit; }<=
br></div><div><br></div><div>filelist.sgml, postgres.sgml, ans stylesheet.c=
ss already have the corresponding change, and the release.sgml is just an i=
ncidental mention of acronym.<br><br>Of course I could be missing something=
.</div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;=
border-left:1px solid rgb(204,204,204);padding-left:1ex">
</blockquote></div></div></div>

--00000000000002f65d05a14b3813--