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
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
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
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
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.
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
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
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
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
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
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
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
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
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
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
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.
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 defined
17 matches
Mail list logo
