Re: Adding xreflable

2020-05-15 Thread Bruce Momjian
On Fri, May 15, 2020 at 11:30:34AM -0400, Bruce Momjian wrote: > On Fri, May 15, 2020 at 11:06:58AM -0400, Tom Lane wrote: > > Bruce Momjian writes: > > > Well, I would like both the SQL command references and the application > > > man pages to have xreflabel text. > > > > I guess my point is

Re: Adding xreflable

2020-05-15 Thread Bruce Momjian
On Fri, May 15, 2020 at 11:06:58AM -0400, Tom Lane wrote: > Bruce Momjian writes: > > Well, I would like both the SQL command references and the application > > man pages to have xreflabel text. > > I guess my point is that in the other several thousand pages of the docs, > we just use or

Re: Adding xreflable

2020-05-15 Thread Tom Lane
Bruce Momjian writes: > Well, I would like both the SQL command references and the application > man pages to have xreflabel text. I guess my point is that in the other several thousand pages of the docs, we just use or , and it looks fine and works fine. Why are you insisting on doing it

Re: Relnotes for 13: There is word missing in UUID generation sentence

2020-05-15 Thread Bruce Momjian
On Fri, May 15, 2020 at 02:09:32PM +, Daniel Westermann (DWE) wrote: > Hi, > > "Previously UUID generation functions were only available external modules > uuid-ossp or pgcrypto were installed." > > Shouldn't that be: > Previously UUID generation functions were only available if external

Relnotes for 13: There is word missing in UUID generation sentence

2020-05-15 Thread Daniel Westermann (DWE)
Hi, "Previously UUID generation functions were only available external modules uuid-ossp or pgcrypto were installed." Shouldn't that be: Previously UUID generation functions were only

Re: Adding xreflable

2020-05-15 Thread Tom Lane
Bruce Momjian writes: > I have noticed that our ref/*.sgml pages don't have such labels. I > would like to add them and use them for our release notes. Some of our > extensions need them too. Why? Our convention generally is to refer to the command, not to the ref page as such.

Adding xreflable

2020-05-15 Thread Bruce Momjian
You might know that while SGML's requires you to specify link text, can pull text from the "xreflabel" link site; our doc/src/sgml/README.links file explains it: use to get chapter/section number from the title of the target link, or xreflabel if