pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedsrc/test/regress/README duplicates SGML material
7+ messages / 4 participants
[nested] [flat]
* src/test/regress/README duplicates SGML material
@ 2001-03-19 22:37 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 2001-03-19 22:37 UTC (permalink / raw)
To: pgsql-hackers@postgreSQL.org; pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] src/test/regress/README duplicates SGML material
@ 2001-03-19 23:08 Tom Lane <tgl@sss.pgh.pa.us>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 2001-03-19 23:08 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-hackers@postgreSQL.org; pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] src/test/regress/README duplicates SGML material
@ 2001-03-19 23:13 Peter Eisentraut <peter_e@gmx.net>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2001-03-19 23:13 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-hackers@postgreSQL.org; pgsql-docs
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/
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: src/test/regress/README duplicates SGML material
@ 2001-03-20 05:58 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Thomas Lockhart @ 2001-03-20 05:58 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-hackers@postgreSQL.org; pgsql-docs
> >> 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: src/test/regress/README duplicates SGML material
@ 2001-03-20 16:25 Peter Eisentraut <peter_e@gmx.net>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 2 replies; 7+ messages in thread
From: Peter Eisentraut @ 2001-03-20 16:25 UTC (permalink / raw)
To: lockhart@fourpalms.org; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; pgsql-hackers@postgreSQL.org; pgsql-docs
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/
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Re: src/test/regress/README duplicates SGML material
@ 2001-03-20 16:30 Tom Lane <tgl@sss.pgh.pa.us>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 0 replies; 7+ messages in thread
From: Tom Lane @ 2001-03-20 16:30 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: lockhart@fourpalms.org; pgsql-hackers@postgresql.org; pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Re: src/test/regress/README duplicates SGML material
@ 2001-03-20 16:38 Bruce Momjian <pgman@candle.pha.pa.us>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 0 replies; 7+ messages in thread
From: Bruce Momjian @ 2001-03-20 16:38 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: lockhart@fourpalms.org, Tom Lane <tgl@sss.pgh.pa.us>; pgsql-hackers@postgresql.org; pgsql-docs
> 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
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2001-03-20 16:38 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-03-19 22:37 src/test/regress/README duplicates SGML material Tom Lane <tgl@sss.pgh.pa.us>
2001-03-19 23:13 ` Peter Eisentraut <peter_e@gmx.net>
2001-03-19 23:08 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-03-20 05:58 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-03-20 16:25 ` Peter Eisentraut <peter_e@gmx.net>
2001-03-20 16:30 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-03-20 16:38 ` Bruce Momjian <pgman@candle.pha.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox