Re: Adding xreflable

2020-06-11 Thread Bruce Momjian
On Thu, Jun 4, 2020 at 07:11:41PM +0200, Peter Eisentraut wrote: > On 2020-06-04 00:38, Alvaro Herrera wrote: > > On 2020-Jun-02, Bruce Momjian wrote: > > > > > I can adjust things, but what logic are we following? Before my patch, > > > sepgsql had an xreflabel, and vacuumlo did not. I would l

Re: Adding xreflable

2020-06-11 Thread Bruce Momjian
On Thu, Jun 4, 2020 at 07:14:17PM +0200, Peter Eisentraut wrote: > On 2020-06-02 18:07, Bruce Momjian wrote: > > I can adjust things, but what logic are we following? Before my patch, > > sepgsql had an xreflabel, and vacuumlo did not. I would like to have a > > documented policy of where we sho

Re: Adding xreflable

2020-06-04 Thread Peter Eisentraut
On 2020-06-02 18:07, Bruce Momjian wrote: I can adjust things, but what logic are we following? Before my patch, sepgsql had an xreflabel, and vacuumlo did not. I would like to have a documented policy of where we should have xreflabels, and where not, and I can then adjust things to match. I

Re: Adding xreflable

2020-06-04 Thread Peter Eisentraut
On 2020-06-04 00:38, Alvaro Herrera wrote: On 2020-Jun-02, Bruce Momjian wrote: I can adjust things, but what logic are we following? Before my patch, sepgsql had an xreflabel, and vacuumlo did not. I would like to have a documented policy of where we should have xreflabels, and where not, an

Re: Adding xreflable

2020-06-03 Thread Alvaro Herrera
On 2020-Jun-02, Bruce Momjian wrote: > I can adjust things, but what logic are we following? Before my patch, > sepgsql had an xreflabel, and vacuumlo did not. I would like to have a > documented policy of where we should have xreflabels, and where not, and > I can then adjust things to match.

Re: Adding xreflable

2020-06-02 Thread Bruce Momjian
On Tue, May 26, 2020 at 01:41:41PM +0200, Peter Eisentraut wrote: > On 2020-05-22 18:45, Bruce Momjian wrote: > > Ugh, I see what you mean. I have read doc/src/sgml/README.links many > > times and still get confused. What you are saying is that if there is > > no xreflabel on a target, you can ge

Re: Adding xreflable

2020-05-26 Thread Peter Eisentraut
On 2020-05-22 18:45, Bruce Momjian wrote: Ugh, I see what you mean. I have read doc/src/sgml/README.links many times and still get confused. What you are saying is that if there is no xreflabel on a target, you can get the chapter/section via or specify text via . But, if there is an xreflabe

Re: Adding xreflable

2020-05-22 Thread Bruce Momjian
On Fri, May 22, 2020 at 12:09:18PM +0200, Peter Eisentraut wrote: > On 2020-05-15 18:47, Bruce Momjian wrote: > > Done. Thanks for the tips. > > This doesn't seem right. By adding xreflabels you are changing the > appearance for all links pointing to the target, not only from the release > notes

Re: Adding xreflable

2020-05-22 Thread Peter Eisentraut
On 2020-05-15 18:47, Bruce Momjian wrote: 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

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 tha

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 linke

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 diffe

Re: Adding xreflable

2020-05-15 Thread Bruce Momjian
On Fri, May 15, 2020 at 10:09:06AM -0400, Tom Lane wrote: > Bruce Momjian writes: > > On Fri, May 15, 2020 at 09:37:30AM -0400, Tom Lane wrote: > >> Why? Our convention generally is to refer to the command, not to the ref > >> page as such. > > > Uh, for the release notes, I am referencing the d

Re: Adding xreflable

2020-05-15 Thread Tom Lane
Bruce Momjian writes: > On Fri, May 15, 2020 at 09:37:30AM -0400, Tom Lane wrote: >> Why? Our convention generally is to refer to the command, not to the ref >> page as such. > Uh, for the release notes, I am referencing the doc page about the > feature, and without the xref, I have to mention i

Re: Adding xreflable

2020-05-15 Thread Bruce Momjian
On Fri, May 15, 2020 at 09:37:30AM -0400, Tom Lane wrote: > 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

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.