From: | Corey Huinker <corey(dot)huinker(at)gmail(dot)com> |
---|---|
To: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> |
Cc: | Jürgen Purtz <juergen(at)purtz(dot)de>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Michael Paquier <michael(at)paquier(dot)xyz> |
Subject: | Re: Add A Glossary |
Date: | 2020-03-20 15:48:24 |
Message-ID: | CADkLM=dTFNCnx+bdoVCVbAn3v8ihvgUh-dQpin4ngrx=RMykFA@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-hackers |
>
> Jürgen mentioned off-list that the man page doesn't build. I was going to
>> look into that, but if anyone has more familiarity with that, I'm listening.
>>
>
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.
>
From | Date | Subject | |
---|---|---|---|
Next Message | Alvaro Herrera | 2020-03-20 17:51:44 | Re: Add A Glossary |
Previous Message | Corey Huinker | 2020-03-20 01:41:54 | Re: Add A Glossary |
From | Date | Subject | |
---|---|---|---|
Next Message | Oleksii Kliukin | 2020-03-20 16:02:15 | Issues with building cpp extensions on PostgreSQL 10+ |
Previous Message | Robert Haas | 2020-03-20 15:38:15 | Re: potential stuck lock in SaveSlotToPath() |