Re: [DOCS] [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-12 Thread Tom Lane
Peter Eisentraut writes: > On 2/8/14, 4:41 PM, Tom Lane wrote: >> + Release notes for all versions of PostgreSQL can be found on-line at >> + http://www.postgresql.org/docs/devel/static/release.html > Should be "current" instead of "devel"? >> + >> + In a distribution file set, release notes fo

Re: [DOCS] [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-12 Thread Peter Eisentraut
On 2/8/14, 4:41 PM, Tom Lane wrote: > diff --git a/HISTORY b/HISTORY > index ...360c7f6 . > *** a/HISTORY > --- b/HISTORY > *** > *** 0 > --- 1,6 > + Release notes for all versions of PostgreSQL can be found on-line at > + http://www.postgresql.org/docs/devel/static/release.ht

Re: [DOCS] [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-09 Thread Robert Haas
On Sat, Feb 8, 2014 at 4:41 PM, Tom Lane wrote: > I wrote: >> Gavin Flower writes: >>> How about adding URL's for the online versions of HISTORY & README's (or >>> their rough equivalents - perhaps the online version of the latest >>> 'Appendix E. Release Notes' would be sufficient?) to the INSTA

Re: [DOCS] [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-08 Thread Tom Lane
I wrote: > Gavin Flower writes: >> How about adding URL's for the online versions of HISTORY & README's (or >> their rough equivalents - perhaps the online version of the latest >> 'Appendix E. Release Notes' would be sufficient?) to the INSTALL file? > Actually, what I had in mind was to repla

Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-07 Thread Tom Lane
Gavin Flower writes: > How about adding URL's for the online versions of HISTORY & README's (or > their rough equivalents - perhaps the online version of the latest > 'Appendix E. Release Notes' would be sufficient?) to the INSTALL file? Actually, what I had in mind was to replace the dynamical

Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-07 Thread Gavin Flower
On 08/02/14 19:05, Tom Lane wrote: Peter Eisentraut writes: On 2/3/14, 8:48 PM, Tom Lane wrote: That's a very fair question. It's a reasonable bet that pretty much nobody actually looks at the text versions of either HISTORY or regress_README anymore. It's conceivable that somebody somewhere

Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-07 Thread Tom Lane
Peter Eisentraut writes: > On 2/3/14, 8:48 PM, Tom Lane wrote: >> That's a very fair question. It's a reasonable bet that pretty much >> nobody actually looks at the text versions of either HISTORY or >> regress_README anymore. It's conceivable that somebody somewhere makes >> use of the text ve

Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-07 Thread Peter Eisentraut
On 2/3/14, 8:48 PM, Tom Lane wrote: > That's a very fair question. It's a reasonable bet that pretty much > nobody actually looks at the text versions of either HISTORY or > regress_README anymore. It's conceivable that somebody somewhere makes > use of the text version of INSTALL when trying to

Re: [HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-03 Thread Tom Lane
Noah Misch writes: >> Robert Haas writes: >>> I wonder if these standalone things are really worthwhile. > I wonder how difficult it would be to make sufficient link data available when > building the standalone files. There would be no linking per se; we would > just need the referent's text f

[HACKERS] Viability of text HISTORY/INSTALL/regression README files (was Re: [COMMITTERS] pgsql: Document a few more regression test hazards.)

2014-02-03 Thread Tom Lane
Robert Haas writes: > On Mon, Feb 3, 2014 at 4:38 PM, Tom Lane wrote: >> guaibasaurus doesn't like this patch: you need to be more careful >> about links, because the regression instructions are supposed to >> compile as a standalone document. > I wonder if these standalone things are really wor