Horton
Menu

Thread

  1. unsubscribe

    willy lubamba <willy@afrinet.cd> — 2001-03-19T02:54:03Z

    unsubscribe

----- Original Message ----- 
From: Tom Lane <tgl@sss.pgh.pa.us>
To: <pgsql-hackers@postgresql.org>; <pgsql-docs@postgresql.org>
Sent: Monday, March 19, 2001 11:37 PM
Subject: [DOCS] src/test/regress/README duplicates SGML material


> Is it really necessary to maintain identical text in the test README
> file and in the SGML docs?  I'm sorely tempted to remove the README
> rather than double-editing yet again.
> 
> regards, tom lane
> 
> ---------------------------(end of broadcast)---------------------------
> TIP 1: subscribe and unsubscribe commands go to majordomo@postgresql.org

  2. src/test/regress/README duplicates SGML material

    Tom Lane <tgl@sss.pgh.pa.us> — 2001-03-19T22:37:33Z

    Is it really necessary to maintain identical text in the test README
file and in the SGML docs?  I'm sorely tempted to remove the README
rather than double-editing yet again.

			regards, tom lane

  3. Re: [HACKERS] src/test/regress/README duplicates SGML material

    Tom Lane <tgl@sss.pgh.pa.us> — 2001-03-19T23:08:37Z

    Peter Eisentraut <peter_e@gmx.net> writes:
> Tom Lane writes:
>> Is it really necessary to maintain identical text in the test README
>> file and in the SGML docs?  I'm sorely tempted to remove the README
>> rather than double-editing yet again.

> It's referenced from the INSTALL file, because people presumably won't be
> able to read the HTML during installation.  Actually, the README was once
> generated from the HTML version.  It can be done again, but the exact
> process it kind of hazy.

If you've got any hints, I could really use a clue right about now ...
otherwise I'll have to do these LOCALE edits twice ...

			regards, tom lane

  4. Re: [HACKERS] src/test/regress/README duplicates SGML material

    Peter Eisentraut <peter_e@gmx.net> — 2001-03-19T23:13:36Z

    Tom Lane writes:

> Is it really necessary to maintain identical text in the test README
> file and in the SGML docs?  I'm sorely tempted to remove the README
> rather than double-editing yet again.

It's referenced from the INSTALL file, because people presumably won't be
able to read the HTML during installation.  Actually, the README was once
generated from the HTML version.  It can be done again, but the exact
process it kind of hazy.

-- 
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/

  5. Re: src/test/regress/README duplicates SGML material

    Thomas Lockhart <lockhart@alumni.caltech.edu> — 2001-03-20T05:58:34Z

    > >> Is it really necessary to maintain identical text in the test README
> >> file and in the SGML docs?  I'm sorely tempted to remove the README
> >> rather than double-editing yet again.
> > It's referenced from the INSTALL file, because people presumably won't be
> > able to read the HTML during installation.  Actually, the README was once
> > generated from the HTML version.  It can be done again, but the exact
> > process it kind of hazy.
> If you've got any hints, I could really use a clue right about now ...
> otherwise I'll have to do these LOCALE edits twice ...

Just make sure that we have a *complete* list of files which need to be
formatted from sgml to something other than HTML and postscript or pdf
and we'll get them built for the release.

Mostly depending on who is doing the work, the process seems to bounce
between using sgml->rtf->text or sgml->html->text, with each having pros
and cons.

                    - Thomas

  6. regression.diff wrong dir name

    Justin Clift <jclift@iprimus.com.au> — 2001-03-20T09:27:12Z

    Hi all,

Something minor, but when you do a "make check" from the main source
directory and it finishes, it mentions that the regression.diff file is
in ./regression.diff

It's really at src/test/regress/regression.diff, and although not hard
to figure out (it's a carry-over from pre 7.1), it might be confusing to
people to new PostgreSQL.

Regards and best wishes,

Justin Clift

  7. Re: regression.diff wrong dir name

    Peter Eisentraut <peter_e@gmx.net> — 2001-03-20T16:17:21Z

    Justin Clift writes:

> Something minor, but when you do a "make check" from the main source
> directory and it finishes, it mentions that the regression.diff file is
> in ./regression.diff

But it says afterwards, "make: leaving directory xyz".  If figured that
would be sufficient.  I hesitated to include the full name, because it
would uglify the display so much.

-- 
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/

  8. Re: src/test/regress/README duplicates SGML material

    Peter Eisentraut <peter_e@gmx.net> — 2001-03-20T16:25:56Z

    Thomas Lockhart writes:

> Just make sure that we have a *complete* list of files which need to be
> formatted from sgml to something other than HTML and postscript or pdf
> and we'll get them built for the release.

It's all documented:  Developer's Guide -> Documentation -> Building the
Documentation -> Plain Text Files.

The three affected text files are:
INSTALL
HISTORY
src/test/regress/README

The INSTALL file hasn't been updated in a while, but I am keeping my eye
on it, but we need to have a complete platform list first.  (Probably a
good time now...)  The HISTORY file isn't actually generated the way it's
documented, but just in case Bruce loses his memory there's an option.
;-)  The regress README is also documented, but it involves manual labour.

-- 
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/

  9. Re: Re: src/test/regress/README duplicates SGML material

    Tom Lane <tgl@sss.pgh.pa.us> — 2001-03-20T16:30:20Z

    Peter Eisentraut <peter_e@gmx.net> writes:
> The regress README is also documented, but it involves manual labour.

I ended up just applying the same diffs to the README by hand, so it's
not an issue at the moment.

			regards, tom lane

  10. Re: Re: src/test/regress/README duplicates SGML material

    Bruce Momjian <pgman@candle.pha.pa.us> — 2001-03-20T16:38:15Z

    > It's all documented:  Developer's Guide -> Documentation -> Building the
> Documentation -> Plain Text Files.
> 
> The three affected text files are:
> INSTALL
> HISTORY
> src/test/regress/README
> 
> The INSTALL file hasn't been updated in a while, but I am keeping my eye
> on it, but we need to have a complete platform list first.  (Probably a
> good time now...)  The HISTORY file isn't actually generated the way it's
> documented, but just in case Bruce loses his memory there's an option.
> ;-)  The regress README is also documented, but it involves manual labour.
> 

I thought we were going to be generating HISTORY from SGML in the
future.  Good to know we will just keep it as as double-patch.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026