Обсуждение: Freezing docs for v6.5
I've frozen the docs sources for the Programmer's Guide, and have
generated the hardcopy. I'm planning on generating the Tutorial,
INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
Bruce, are install.sgml and release.sgml finished?
I am looking for updates to ref/{lock,set}.sgml for MVCC and related
changes, which go into the User's Guide. I'm out of town Saturday Jun
5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
by tomorrow or I'll need to ask for yet another extension.
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
Thomas Lockhart wrote:
>
> I've frozen the docs sources for the Programmer's Guide, and have
> generated the hardcopy. I'm planning on generating the Tutorial,
> INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
>
> Bruce, are install.sgml and release.sgml finished?
>
> I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> changes, which go into the User's Guide. I'm out of town Saturday Jun
> 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> by tomorrow or I'll need to ask for yet another extension.
I'll post these changes today directly to you.
Text version...
Vadim
> I'll post these changes today directly to you.
> Text version...
Thanks :)
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
> I've frozen the docs sources for the Programmer's Guide, and have
> generated the hardcopy. I'm planning on generating the Tutorial,
> INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
>
> Bruce, are install.sgml and release.sgml finished?
>
> I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> changes, which go into the User's Guide. I'm out of town Saturday Jun
> 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> by tomorrow or I'll need to ask for yet another extension.
>
No, nor is the ref stuff done. Extend it.
-- Bruce Momjian | http://www.op.net/~candle maillist@candle.pha.pa.us | (610)
853-3000+ If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill,
Pennsylvania19026
> > I've frozen the docs sources for the Programmer's Guide, and have
> > generated the hardcopy. I'm planning on generating the Tutorial,
> > INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
> > Bruce, are install.sgml and release.sgml finished?
> > I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> > changes, which go into the User's Guide. I'm out of town Saturday Jun
> > 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> > by tomorrow or I'll need to ask for yet another extension.
> No, nor is the ref stuff done. Extend it.
Whoops! The "No" means that install.sgml and release.sgml are not
finished? What else needs to be done on them? I've made some very
minor wording and markup changes in the release notes, and will commit
those tonight. the Programmer's Guide and the Tutorial are finished,
and I was hoping to do INSTALL, HISTORY, and the Admin Guide (all of
which need install.sgml and release.sgml to be done) tonight.
Vadim sez he'll send some plain text updates (hopefully for the ref
pages) tomorrow, so I should be able to get that incorporated into the
User's Guide then.
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
> I've frozen the docs sources for the Programmer's Guide, and have
> generated the hardcopy. I'm planning on generating the Tutorial,
> INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
>
> Bruce, are install.sgml and release.sgml finished?
>
> I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> changes, which go into the User's Guide. I'm out of town Saturday Jun
> 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> by tomorrow or I'll need to ask for yet another extension.
If someone else can take on the lock/set grammar changes, that would be
great. I did a cvs diff of gram.y from the 6.4.2 date and current, and
there is what needs to be changed.
-- Bruce Momjian | http://www.op.net/~candle maillist@candle.pha.pa.us | (610)
853-3000+ If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill,
Pennsylvania19026
Thomas Lockhart wrote:
>
> > > I've frozen the docs sources for the Programmer's Guide, and have
> > > generated the hardcopy. I'm planning on generating the Tutorial,
> > > INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
> > > Bruce, are install.sgml and release.sgml finished?
> > > I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> > > changes, which go into the User's Guide. I'm out of town Saturday Jun
> > > 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> > > by tomorrow or I'll need to ask for yet another extension.
> > No, nor is the ref stuff done. Extend it.
>
> Whoops! The "No" means that install.sgml and release.sgml are not
> finished? What else needs to be done on them? I've made some very
> minor wording and markup changes in the release notes, and will commit
> those tonight. the Programmer's Guide and the Tutorial are finished,
> and I was hoping to do INSTALL, HISTORY, and the Admin Guide (all of
> which need install.sgml and release.sgml to be done) tonight.
>
> Vadim sez he'll send some plain text updates (hopefully for the ref
> pages) tomorrow, so I should be able to get that incorporated into the
For lock.sgml and set.sgml. I assume that they are used for lock and
set man pages which I would like to use as sources for updation.
> User's Guide then.
BTW, I have some notes for release.sgml, "Migration to v6.5" section,
about using contrib/refint.* - one will have to use LOCK statements
to get it working properly, -:(. I'll write it in the next 12 hours...
Vadim
> > Vadim sez he'll send some plain text updates (hopefully for the ref
> > pages) tomorrow
> For lock.sgml and set.sgml. I assume that they are used for lock and
> set man pages which I would like to use as sources for updation.
The sgml produces html and ps formats. The man pages are not (yet)
generated automatically from the sgml, but will be in some future
release (offers of help on the conversion have not yet resulted in
actual help...).
I would appreciate getting the updates inside of ref/{lock,set}.sgml,
and then you or someone else can update the man pages while I am
working on the hardcopy.
> BTW, I have some notes for release.sgml, "Migration to v6.5" section,
> about using contrib/refint.* - one will have to use LOCK statements
> to get it working properly, -:(. I'll write it in the next 12 hours...
OK, great. That might delay me a bit, but it will be well worth it. I
had hoped to run through another ~200 pages of hardcopy tonight, but
am on hold for both the release notes and the User's Guide.
If you can get to the release notes first, then I can go ahead and
finish 3 docs (the Admin Guide, INSTALL, and HISTORY).
Thanks for all of your work. Hope this crunch isn't too painful :/
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
Thomas Lockhart wrote:
>
> > > Vadim sez he'll send some plain text updates (hopefully for the ref
> > > pages) tomorrow
> > For lock.sgml and set.sgml. I assume that they are used for lock and
> > set man pages which I would like to use as sources for updation.
>
> The sgml produces html and ps formats. The man pages are not (yet)
> generated automatically from the sgml, but will be in some future
> release (offers of help on the conversion have not yet resulted in
> actual help...).
>
> I would appreciate getting the updates inside of ref/{lock,set}.sgml,
Ok.
> and then you or someone else can update the man pages while I am
> working on the hardcopy.
>
> > BTW, I have some notes for release.sgml, "Migration to v6.5" section,
> > about using contrib/refint.* - one will have to use LOCK statements
> > to get it working properly, -:(. I'll write it in the next 12 hours...
>
> OK, great. That might delay me a bit, but it will be well worth it. I
> had hoped to run through another ~200 pages of hardcopy tonight, but
> am on hold for both the release notes and the User's Guide.
>
> If you can get to the release notes first, then I can go ahead and
> finish 3 docs (the Admin Guide, INSTALL, and HISTORY).
Ok. In the next 3 hours... ok?
Vadim
On Thu, 3 Jun 1999, Thomas Lockhart wrote:
> If you can get to the release notes first, then I can go ahead and
> finish 3 docs (the Admin Guide, INSTALL, and HISTORY).
>
> Thanks for all of your work. Hope this crunch isn't too painful :/
How are we doing for the 7th as a release? Need a couple of more days to
touch up docs? Or are we okay for the 7th?
Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
> Whoops! The "No" means that install.sgml and release.sgml are not > finished? What else needs to be done on them? I've made some very > minor wording and markup changes in the release notes, and will commit > those tonight. the Programmer's Guide and the Tutorial are finished, > and I was hoping to do INSTALL, HISTORY, and the Admin Guide (all of > which need install.sgml and release.sgml to be done) tonight. > > Vadim sez he'll send some plain text updates (hopefully for the ref > pages) tomorrow, so I should be able to get that incorporated into the > User's Guide then. Sorry. Install is done. release notes just need to be finalized with all listed changes. When should we say no more? Things are still happening in the fix area, I think. The man pages and sgml/ref stuff is the hard part. I am not sure what they all do, and was discouraged to see the 'set' manual page doesn't have lots of stuff that should be in there, and are in the sgml version. The psql \h stuff also needs work. I am pretty busy with other stuff for the next two days. That is the problem. -- Bruce Momjian | http://www.op.net/~candle maillist@candle.pha.pa.us | (610) 853-3000+ If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania19026
> > Whoops! The "No" means that install.sgml and release.sgml are not > > finished? What else needs to be done on them? I've made some very > > minor wording and markup changes in the release notes, and will commit > > those tonight. the Programmer's Guide and the Tutorial are finished, > > and I was hoping to do INSTALL, HISTORY, and the Admin Guide (all of > > which need install.sgml and release.sgml to be done) tonight. > > > > Vadim sez he'll send some plain text updates (hopefully for the ref > > pages) tomorrow, so I should be able to get that incorporated into the > > For lock.sgml and set.sgml. I assume that they are used for lock and > set man pages which I would like to use as sources for updation. The man pages and sgml pages are separate, and require separate maintenance. -- Bruce Momjian | http://www.op.net/~candle maillist@candle.pha.pa.us | (610) 853-3000+ If your life is a hard drive, | 830 Blythe Avenue + Christ can be your backup. | Drexel Hill, Pennsylvania19026
> How are we doing for the 7th as a release? Need a couple of more days
> to touch up docs? Or are we okay for the 7th?
Not sure yet. I expect that I will need an extra day or two since I'm
out of town for the 5th and 6th. But if we plan to slip, then the
stuff I need might slip too :/
Tom Lane is still chasing bugs with great efficiency, so an extra day
to test a "candidate release tarball" (missing only a few of the docs)
could certainly do no harm. If nothing else it would let us test the
tarball to make sure that the yacc/bison file phasing is OK (this has
bit us a few times recently).
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
On Thu, 3 Jun 1999, Thomas Lockhart wrote:
> > How are we doing for the 7th as a release? Need a couple of more days
> > to touch up docs? Or are we okay for the 7th?
>
> Not sure yet. I expect that I will need an extra day or two since I'm
> out of town for the 5th and 6th. But if we plan to slip, then the
> stuff I need might slip too :/
>
> Tom Lane is still chasing bugs with great efficiency, so an extra day
> to test a "candidate release tarball" (missing only a few of the docs)
> could certainly do no harm. If nothing else it would let us test the
> tarball to make sure that the yacc/bison file phasing is OK (this has
> bit us a few times recently).
Okay, let's go with a 'pre-release' tarball for the 7th and a release on
the 9th then, if no objections?
Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
> Sorry. Install is done. release notes just need to be finalized with
> all listed changes. When should we say no more? Things are still
> happening in the fix area, I think.
OK, I'm freezing install.sgml and release.sgml. Feel free to make
changes to release.sgml, and *if* you limit the changes to one or a
few one-liners I can update the hardcopy at the last minute. But we
should document release info up to the last minute rather than leaving
something out because docs were supposed to be frozen.
> The man pages and sgml/ref stuff is the hard part. I am not sure what
> they all do, and was discouraged to see the 'set' manual page doesn't
> have lots of stuff that should be in there, and are in the sgml version.
> The psql \h stuff also needs work. I am pretty busy with other stuff
> for the next two days. That is the problem.
No problem. afaik the sgml sources are almost done, with a couple of
patches coming from Vadim sometime soon. imho the original man pages
are doing pretty well, and we aren't promising that they are as
complete or voluminous as the html docs.
The "set" man page is probably the most out of date since there were
several new commands added recently. So if you have a chance to update
that one things are likely to be good enough.
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
Thomas Lockhart wrote:
>
> I've frozen the docs sources for the Programmer's Guide, and have
> generated the hardcopy. I'm planning on generating the Tutorial,
> INSTALL, and HISTORY tonight, and the User's Guide tomorrow.
>
> Bruce, are install.sgml and release.sgml finished?
>
> I am looking for updates to ref/{lock,set}.sgml for MVCC and related
> changes, which go into the User's Guide. I'm out of town Saturday Jun
> 5 01:00 UTC through Monday June 7 5:00 UTC, so will need the updates
> by tomorrow or I'll need to ask for yet another extension.
Sorry, but I'm not able to update lock.sgml now - too many things
to say about and I'm tired, -:(.
Vadim
> Sorry, but I'm not able to update lock.sgml now - too many things
> to say about and I'm tired, -:(.
OK. Bruce has made some additions already, and I'll do the User's
Guide (which contains ref/lock.sgml and ref/set.sgml) as the last doc.
Be sure to get the latest copies before making more changes.
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California