Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > > > NAME="GENERATOR" > CONTENT="Modular DocBook HTML Stylesheet Version 1.59">http://docbook.sourceforge.net/projects/dsssl/index.html ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Peter Eisentraut <[EMAIL PROTECTED]> writes: > Tom Lane wrote: >> CONTENT="Modular DocBook HTML Stylesheet Version 1.59"> This qualifies as ancient. Newer versions are available from > http://docbook.sourceforge.net/projects/dsssl/index.html Okay. I see that both postgresql.org and Bruce are generating the docs with Modular DocBook HTML Stylesheet Version 1.7 Shall we standardize on that and lynx 2.8.5 as the current "official" versions to use for building the docs? Also, I'm running openjade 1.3 on this machine, and as I recall it was a serious pain in the arse to build. Is it worth worrying about a newer version of that? regards, tom lane ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > Okay. I see that both postgresql.org and Bruce are generating the > docs with > Modular DocBook HTML Stylesheet Version 1.7 There is no version "1.7". This is in fact a bug; the correct version number of the latest version (which is in use at postgresql.org) is 1.78. > Shall we standardize on that and lynx 2.8.5 as the current "official" > versions to use for building the docs? Works for me. > Also, I'm running openjade 1.3 on this machine, and as I recall it > was a serious pain in the arse to build. Is it worth worrying about > a newer version of that? Well, there is 1.3.2 now, but I can't tell you how easy or hard to build that one is. There is also a 1.4 in the making, but the whole DSSSL toolchain is sort of dying. ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Peter Eisentraut <[EMAIL PROTECTED]> writes: > Tom Lane wrote: >> Also, I'm running openjade 1.3 on this machine, and as I recall it >> was a serious pain in the arse to build. Is it worth worrying about >> a newer version of that? > Well, there is 1.3.2 now, but I can't tell you how easy or hard to build > that one is. There is also a 1.4 in the making, but the whole DSSSL > toolchain is sort of dying. Having re-read my notes about installing 1.3 from source, I won't shed a tear if it dies. Should I be thinking of installing something else instead, and if so what? regards, tom lane ---(end of broadcast)--- TIP 6: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > Peter Eisentraut <[EMAIL PROTECTED]> writes: > > Tom Lane wrote: > >> CONTENT="Modular DocBook HTML Stylesheet Version 1.59"> > > This qualifies as ancient. Newer versions are available from > > http://docbook.sourceforge.net/projects/dsssl/index.html > > Okay. I see that both postgresql.org and Bruce are generating the docs > with > Modular DocBook HTML Stylesheet Version 1.7 > Shall we standardize on that and lynx 2.8.5 as the current "official" > versions to use for building the docs? 2.8.5 is a development release of lynx, not a stable one: Lynx Version 2.8.5dev.16 (01 Jun 2003) Do we want to standardize on a development version of some tools? It is only converting to text, so I guess it is OK. I downloaded the version of lynx Tom has just so I can generate the newer output. The only difference between my 2.8.3 lynx and 2.8.5 is that 2.8.5 trips spaces on blank lines used between headings, which is good. I have also rebuilt the HISTORY file in CVS to match our official style sheets. > Also, I'm running openjade 1.3 on this machine, and as I recall it was > a serious pain in the arse to build. Is it worth worrying about a newer > version of that? I can help you because I just installed new tools a few months ago. I will phone you. -- Bruce Momjian| http://candle.pha.pa.us [EMAIL PROTECTED] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Bruce Momjian <[EMAIL PROTECTED]> writes: > Tom Lane wrote: >> That argument seems a bit silly for HISTORY, seeing that it's generally >> not up-to-date during beta testing. As for INSTALL, those instructions >> don't change fast enough to surprise beta testers, so I'm not convinced >> about it either. > Actually, recent releases had a current HISTORY before beta started. > However, if they are downloading the beta tarballs, the HISTORY/INSTALL > files are already generated. It would only be useful for CVS pulls > during beta though. The other point is: how plausible is it really that someone testing CVS pulls would not find it convenient to read these docs from the website? They've got to have net access to do the pull in the first place. regards, tom lane ---(end of broadcast)--- TIP 6: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Bruce Momjian <[EMAIL PROTECTED]> writes: > 2.8.5 is a development release of lynx, not a stable one: > Lynx Version 2.8.5dev.16 (01 Jun 2003) 2.8.5rel1 is a release version that has been out for some time. If you're running a development version, that's not my problem. ---(end of broadcast)--- TIP 6: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Bruce Momjian wrote: > One idea would be to replace file content with a single URL that points > to the development docs, then when the tarball is built, it can > overwrite those files. > > Marc? Overwrite the files with ... ? The contents of the URL itself, pulled down with lynx? if so, ya, that's easy enough ... Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > Bruce Momjian <[EMAIL PROTECTED]> writes: > >> Peter Eisentraut <[EMAIL PROTECTED]> writes: > >>> A better approach for that would be to remove HISTORY from CVS and build > >>> it only when the release tarball is made. > > > I think the only reason HISTORY and INSTALL are in CVS is because we > > want people running CVS during beta to have changes docs and install > > instructions that don't require them to pull down a new tarball each > > time or read the docs via a web site. > > That argument seems a bit silly for HISTORY, seeing that it's generally > not up-to-date during beta testing. As for INSTALL, those instructions > don't change fast enough to surprise beta testers, so I'm not convinced > about it either. Actually, recent releases had a current HISTORY before beta started. However, if they are downloading the beta tarballs, the HISTORY/INSTALL files are already generated. It would only be useful for CVS pulls during beta though. One idea would be to replace file content with a single URL that points to the development docs, then when the tarball is built, it can overwrite those files. Marc? -- Bruce Momjian| http://candle.pha.pa.us [EMAIL PROTECTED] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 2: you can get off all lists at once with the unregister command (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Marc G. Fournier wrote: > On Tue, 9 Mar 2004, Bruce Momjian wrote: > > > One idea would be to replace file content with a single URL that points > > to the development docs, then when the tarball is built, it can > > overwrite those files. > > > > Marc? > > Overwrite the files with ... ? The contents of the URL itself, pulled > down with lynx? > > if so, ya, that's easy enough ... No, actually the URL points to an HTML. You need to do 'gmake HISTORY' in the sgml directory, and put that in /HISTORY. Same for INSTALL. -- Bruce Momjian| http://candle.pha.pa.us [EMAIL PROTECTED] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > Bruce Momjian <[EMAIL PROTECTED]> writes: > > 2.8.5 is a development release of lynx, not a stable one: > > Lynx Version 2.8.5dev.16 (01 Jun 2003) > > 2.8.5rel1 is a release version that has been out for some time. > If you're running a development version, that's not my problem. Well, looking at: http://lynx.browser.org/ It mentions 2.8.3 as most current, and lists 2.8.5 under Development Versions. -- Bruce Momjian| http://candle.pha.pa.us [EMAIL PROTECTED] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Bruce Momjian wrote: > Marc G. Fournier wrote: > > On Tue, 9 Mar 2004, Bruce Momjian wrote: > > > > > One idea would be to replace file content with a single URL that points > > > to the development docs, then when the tarball is built, it can > > > overwrite those files. > > > > > > Marc? > > > > Overwrite the files with ... ? The contents of the URL itself, pulled > > down with lynx? > > > > if so, ya, that's easy enough ... > > No, actually the URL points to an HTML. You need to do 'gmake HISTORY' > in the sgml directory, and put that in /HISTORY. Same for INSTALL. Ah, even easier ... stupid question, but the snapshot is still using the 7.4 docs ... is there a 'gmake' I should be using to build man.tar.gz, like I do with postgres? Based on the above, though, here are the steps for building the snapshot that should be followed ... please confirm ... /usr/bin/cvs -d /cvsroot -q export -rHEAD pgsql cd pgsql ./configure cd doc/src gmake postgres.tar.gz mv postgres.tar.gz .. cp ~ftp/pub/dev/doc/postgres.tar.gz ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc cd sgml gmake HISTORY INSTALL cp HISTORY INSTALL ../../.. cd ../../.. gmake split-dist=yes VERSION=snapshot dist gmake maintainer-clean Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Bruce Momjian wrote: > One idea would be to replace file content with a single URL that > points to the development docs, then when the tarball is built, it > can overwrite those files. Please do not automatically overwrite files that are in CVS. That will lead to trouble. An alternative, which is actually in quite common use, is to simply provide a file README.cvs that explains various things about dealing with a CVS check out tree. When you make a tarball, you simply delete the file. ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Bruce Momjian <[EMAIL PROTECTED]> writes: > Tom Lane wrote: >> 2.8.5rel1 is a release version that has been out for some time. >> If you're running a development version, that's not my problem. > Well, looking at: > http://lynx.browser.org/ > It mentions 2.8.3 as most current, and lists 2.8.5 under Development > Versions. Why do you think that is authoritative? Freshmeat shows lynx.isc.org as the home site for lynx, and http://lynx.isc.org/release/lynx2.8.5.tar.gz as the current release. regards, tom lane ---(end of broadcast)--- TIP 2: you can get off all lists at once with the unregister command (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
"Marc G. Fournier" <[EMAIL PROTECTED]> writes: > cp ~ftp/pub/dev/doc/postgres.tar.gz ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc That doesn't look right; for one thing you just made a postgres.tar.gz, why would you overwrite it? Also see the business about whether man.tar.gz has a version number. > cd sgml > gmake HISTORY INSTALL > cp HISTORY INSTALL ../../.. > cd ../../.. This gmake will leave some crud files that you don't want in the distro. Instead of 'cp' I'd suggest mv -f HISTORY INSTALL ../../.. gmake clean Not sure if there are any other issues. regards, tom lane ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Tom Lane wrote: > "Marc G. Fournier" <[EMAIL PROTECTED]> writes: > > cp ~ftp/pub/dev/doc/postgres.tar.gz ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc > > That doesn't look right; for one thing you just made a postgres.tar.gz, > why would you overwrite it? Also see the business about whether > man.tar.gz has a version number. k, both of those are fixed ... > > > cd sgml > > gmake HISTORY INSTALL > > cp HISTORY INSTALL ../../.. > > cd ../../.. > > This gmake will leave some crud files that you don't want in the distro. > Instead of 'cp' I'd suggest > mv -f HISTORY INSTALL ../../.. > gmake clean > > Not sure if there are any other issues. Changed ... Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Tom Lane wrote: > This gmake will leave some crud files that you don't want in the > distro. Instead of 'cp' I'd suggest > mv -f HISTORY INSTALL ../../.. > gmake clean The "make dist" step will do its own cleaning. ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Marc G. Fournier wrote: > /usr/bin/cvs -d /cvsroot -q export -rHEAD pgsql > cd pgsql > ./configure > cd doc/src > gmake postgres.tar.gz > mv postgres.tar.gz .. > cp ~ftp/pub/dev/doc/postgres.tar.gz ~ftp/pub/dev/doc/man-7.4.tar.gz > ../doc cd sgml > gmake HISTORY INSTALL > cp HISTORY INSTALL ../../.. > cd ../../.. > gmake split-dist=yes VERSION=snapshot dist > gmake maintainer-clean This looks mostly correct (modulo the other comments), but it seems there is still a lot of room for automation in there. ---(end of broadcast)--- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faqs/FAQ.html
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Peter Eisentraut wrote: > Marc G. Fournier wrote: > > /usr/bin/cvs -d /cvsroot -q export -rHEAD pgsql > > cd pgsql > > ./configure > > cd doc/src > > gmake postgres.tar.gz > > mv postgres.tar.gz .. > > cp ~ftp/pub/dev/doc/postgres.tar.gz ~ftp/pub/dev/doc/man-7.4.tar.gz > > ../doc cd sgml > > gmake HISTORY INSTALL > > cp HISTORY INSTALL ../../.. > > cd ../../.. > > gmake split-dist=yes VERSION=snapshot dist > > gmake maintainer-clean > > This looks mostly correct (modulo the other comments), but it seems > there is still a lot of room for automation in there. Definitely open to suggestions on changing it ... I'm down to: /usr/bin/cvs -d /cvsroot -q export -rHEAD pgsql cd pgsql ./configure cd doc/src gmake postgres.tar.gz mv postgres.tar.gz .. cp ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc/man.tar.gz cd sgml gmake HISTORY INSTALL mv -f HISTORY INSTALL ../../.. cd ../../.. gmake split-dist=yes VERSION=snapshot dist gmake maintainer-clean You tell me what else I should add here ... :) Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faqs/FAQ.html
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
"Marc G. Fournier" <[EMAIL PROTECTED]> writes: > Definitely open to suggestions on changing it ... I'm down to: > cd doc/src > gmake postgres.tar.gz > mv postgres.tar.gz .. > cp ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc/man.tar.gz On second look, isn't that copying the man tarball to the wrong directory? Looks like it'll try to put it in doc/doc ... regards, tom lane ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Bruce Momjian wrote: > Peter Eisentraut wrote: > > Tom Lane wrote: > > > This gmake will leave some crud files that you don't want in the > > > distro. Instead of 'cp' I'd suggest > > > mv -f HISTORY INSTALL ../../.. > > > gmake clean > > > > The "make dist" step will do its own cleaning. > > Actually only as of yesterday. There was no clean target for HISTORY > and INSTALL before. > > I just added the clean target to 7.4.X too. 'k, and I've removed it from the script ... Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, 9 Mar 2004, Tom Lane wrote: > "Marc G. Fournier" <[EMAIL PROTECTED]> writes: > > Definitely open to suggestions on changing it ... I'm down to: > > > cd doc/src > > gmake postgres.tar.gz > > mv postgres.tar.gz .. > > cp ~ftp/pub/dev/doc/man-7.4.tar.gz ../doc/man.tar.gz > > On second look, isn't that copying the man tarball to the wrong > directory? Looks like it'll try to put it in doc/doc ... Fixed ... does nobody ever download teh nsapshots? :) that script hasn't been touched in *months* now ... Marc G. Fournier Hub.Org Networking Services (http://www.hub.org) Email: [EMAIL PROTECTED] Yahoo!: yscrappy ICQ: 7615664 ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, Mar 09, 2004 at 12:42:46 -0500, Bruce Momjian <[EMAIL PROTECTED]> wrote: > > 2.8.5 is a development release of lynx, not a stable one: > > Lynx Version 2.8.5dev.16 (01 Jun 2003) > > Do we want to standardize on a development version of some tools? It is > only converting to text, so I guess it is OK. > > I downloaded the version of lynx Tom has just so I can generate the > newer output. The only difference between my 2.8.3 lynx and 2.8.5 is > that 2.8.5 trips spaces on blank lines used between headings, which is > good. I think the major advantage of 2.8.5 is https support. That isn't needed for what you are doing, but is a good reason for someone to use it as their browser in preference to earlier versions. I am using 2.8.5dev.9 and it seems to work reasonably well. The new scroll bar function has an issue (copying text accross the scroll bar doesn't work) so I don't use that feature. ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] [COMMITTERS] pgsql-server/doc/src/sgml Makefile
On Tue, Mar 09, 2004 at 13:16:58 -0500, Tom Lane <[EMAIL PROTECTED]> wrote: > > The other point is: how plausible is it really that someone testing CVS > pulls would not find it convenient to read these docs from the website? > They've got to have net access to do the pull in the first place. I started using 7.4 early in the development cycle and was using the developer doc pages fairly often. I was having trouble with jade back then though. I can now make the html version of the documentation and do that when I get new versions of 7.4 STABLE from CVS. ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
[DOCS] HISTORY, INSTALL, README.CVS
Peter Eisentraut wrote: > Bruce Momjian wrote: > > One idea would be to replace file content with a single URL that > > points to the development docs, then when the tarball is built, it > > can overwrite those files. > > Please do not automatically overwrite files that are in CVS. That will > lead to trouble. An alternative, which is actually in quite common > use, is to simply provide a file README.cvs that explains various > things about dealing with a CVS check out tree. When you make a > tarball, you simply delete the file. OK, I have removed HISTORY and INSTALL from CVS, and added a README.CVS which contains URL's to that content. Marc, would you modify your tar build script to remove README.CVS from the tar file? -- Bruce Momjian| http://candle.pha.pa.us [EMAIL PROTECTED] | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup.| Newtown Square, Pennsylvania 19073 ---(end of broadcast)--- TIP 9: the planner will ignore your desire to choose an index scan if your joining column's datatypes do not match
Re: [DOCS] HISTORY, INSTALL, README.CVS
Bruce Momjian <[EMAIL PROTECTED]> writes: > OK, I have removed HISTORY and INSTALL from CVS, and added a README.CVS > which contains URL's to that content. > Marc, would you modify your tar build script to remove README.CVS from > the tar file? Sounds good, but are we all on the same page here? Does this apply only to CVS HEAD, or also in the 7.4 and 7.3 branches? (I assume we are not planning any further releases before 7.3.) regards, tom lane ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings
