Re: [HACKERS] Questionable tag usage

2017-04-03 Thread Peter Eisentraut
On 3/21/17 21:50, Peter Eisentraut wrote: > This question is still open. Do we want to keep the new linking style > Section 1.2.3, "Title", or revert back to the old style just Section > 1.2.3? It's a simple toggle setting. Changed back to old style, per discussion. -- Peter Eisentraut

Re: [HACKERS] Questionable tag usage

2017-03-21 Thread Tom Lane
Peter Eisentraut writes: >> On 1/4/17 11:50 PM, Tom Lane wrote: >>> Anyway, bottom line is I'm not terribly excited about fixing just this >>> one place. I think we need to decide whether we like the new more-verbose >>> output for links. If we don't, we need to fix the markup rules to not do >>

Re: [HACKERS] Questionable tag usage

2017-03-21 Thread Peter Eisentraut
On 1/11/17 11:55, Peter Eisentraut wrote: > On 1/4/17 11:50 PM, Tom Lane wrote: >> Anyway, bottom line is I'm not terribly excited about fixing just this >> one place. I think we need to decide whether we like the new more-verbose >> output for links. If we don't, we need to fix the markup rules

Re: [HACKERS] Questionable tag usage

2017-01-11 Thread Peter Eisentraut
On 1/6/17 8:56 AM, Magnus Hagander wrote: > You could argue that nobody reads the PG docs on dead trees anymore > and we should embrace the hyperlink style with enthusiasm. I wouldn't > be against that personally, but there are a lot of places to change if > we decide that parenthe

Re: [HACKERS] Questionable tag usage

2017-01-11 Thread Peter Eisentraut
On 1/4/17 11:50 PM, Tom Lane wrote: > Anyway, bottom line is I'm not terribly excited about fixing just this > one place. I think we need to decide whether we like the new more-verbose > output for links. If we don't, we need to fix the markup rules to not do > that. If we do, there are a lot of

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Bruce Momjian
On Tue, Jan 10, 2017 at 12:39:57PM -0500, Robert Haas wrote: > Since I've spent a fair amount of brainpower trying to use > rather than where possible, I'm not innately enthusiastic about > a project whose end is to get rid of . I won't lose a lot of > sleep over it if we decide to go that direc

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Robert Haas
On Tue, Jan 10, 2017 at 12:22 PM, Tom Lane wrote: > However, that complaint was already lodged in another thread. What I > think *this* thread is about is whether we ought to switch from the > up-to-now-project-standard style > > ... how to frob your wug (see ) ... > > to > > ... how to f

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Tom Lane
Robert Haas writes: > Personally, I think that if the doc toolchain changeover changed the > way xrefs render - and it seems that it did - that's a bug that ought > to be fixed, I quite agree. We'll have enough to do with the toolchain changeover; we don't need random changes in what common mark

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Robert Haas
On Tue, Jan 10, 2017 at 10:58 AM, Tom Lane wrote: > Robert Haas writes: >> On Fri, Jan 6, 2017 at 10:18 AM, Tom Lane wrote: I don't think there are a lto of people who use dead tree editions anymore, but they certainly do exist. A lot of people use the PDFs though, particularly fo

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Kevin Grittner
On Tue, Jan 10, 2017 at 9:58 AM, Tom Lane wrote: > whether to continue using "see section m.n"-type cross-references For my part, I have a preference for including the section name with the link text, although if it took much work to add it (rather than being the new default) I might question wh

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Tom Lane
Robert Haas writes: > On Fri, Jan 6, 2017 at 10:18 AM, Tom Lane wrote: >>> I don't think there are a lto of people who use dead tree editions anymore, >>> but they certainly do exist. A lot of people use the PDFs though, >>> particularly for offline reading or loading them in ebook readers. So it

Re: [DOCS] [HACKERS] Questionable tag usage

2017-01-10 Thread Robert Haas
On Fri, Jan 6, 2017 at 10:18 AM, Tom Lane wrote: >> I don't think there are a lto of people who use dead tree editions anymore, >> but they certainly do exist. A lot of people use the PDFs though, >> particularly for offline reading or loading them in ebook readers. So it >> still has to be workab

Re: [HACKERS] Questionable tag usage

2017-01-06 Thread Tom Lane
Magnus Hagander writes: > On Thu, Jan 5, 2017 at 5:50 AM, Tom Lane wrote: >> Well ... that will read nicely in output formats that have hyperlinks, >> but not so well on plain dead trees where the cross-reference is either >> invisible or an explicit footnote. Our typical convention for this sor

Re: [HACKERS] Questionable tag usage

2017-01-06 Thread Magnus Hagander
On Thu, Jan 5, 2017 at 5:50 AM, Tom Lane wrote: > Tatsuo Ishii writes: > > In: > > https://www.postgresql.org/docs/devel/static/runtime- > config-file-locations.html > > "Specifies the configuration file for Section 20.2, $B!H (BUser Name > Maps $B!I (B > > user name mapping" looks pretty stran

Re: [HACKERS] Questionable tag usage

2017-01-04 Thread Tom Lane
Tatsuo Ishii writes: > In: > https://www.postgresql.org/docs/devel/static/runtime-config-file-locations.html > "Specifies the configuration file for Section 20.2, $B!H(BUser Name > Maps$B!I(B > user name mapping" looks pretty strange to me because a raw section > name appears. Yeah, it's def

[HACKERS] Questionable tag usage

2017-01-04 Thread Tatsuo Ishii
In: https://www.postgresql.org/docs/devel/static/runtime-config-file-locations.html --- ident_file (string) Specifies the configuration file for Section 20.2, “User Name Maps” user name mapping (customarily called pg_ident.conf). This parameter