Re: [DOCS] Questionable tag usage

2017-01-11 Thread Jürgen Purtz
Some general notes to the discussion about vs. rendering in the new toolchain: (1) There is a general distinction in the *meaning* of the two elements: is an internal link with validation semantic whereas is an external link to any URL. See: http://doccookbook.sourceforge.net/html/en/dbc.

Re: [DOCS] [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-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