pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedMerging old man pages
7+ messages / 3 participants
[nested] [flat]
* Merging old man pages
@ 1999-07-17 16:31 Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 7+ messages in thread
From: Thomas Lockhart @ 1999-07-17 16:31 UTC (permalink / raw)
To: Postgres Documentation List <docs@postgresql.org>; Postgres Hackers List <hackers@postgresql.org>
We've now got a viable mechanism for generating man pages from sgml
sources. So, I'm starting to go through the old man pages (those in
src/man/) to verify that all information in them is available
somewhere in the new docs.
From here on, there is no need to update the src/man/ man pages when
updating docs. Please do all updates in doc/src/sgml/{.,/ref}/*.sgml.
I'll be removing the old man pages from the cvs tree, but not until
I've got the new man page generating mechanism installed at
postgresql.org. This should all be completed well in advance of a v6.6
release.
TIA
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Merging old man pages
@ 1999-07-17 17:22 Tom Lane <tgl@sss.pgh.pa.us>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 1999-07-17 17:22 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: Postgres Documentation List <docs@postgreSQL.org>; Postgres Hackers List <hackers@postgreSQL.org>
Thomas Lockhart <lockhart@alumni.caltech.edu> writes:
> We've now got a viable mechanism for generating man pages from sgml
> sources.
Excellent!
> From here on, there is no need to update the src/man/ man pages when
> updating docs. Please do all updates in doc/src/sgml/{.,/ref}/*.sgml.
> I'll be removing the old man pages from the cvs tree,
OK, let me get this straight: man pages will no longer be in the CVS
tree because they will no longer be original files, but they will be
part of the standard distribution as derived files, right?
regards, tom lane
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Merging old man pages
@ 1999-07-17 20:54 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 @ 1999-07-17 20:54 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Postgres Documentation List <docs@postgreSQL.org>; Postgres Hackers List <hackers@postgreSQL.org>
> OK, let me get this straight: man pages will no longer be in the CVS
> tree because they will no longer be original files, but they will be
> part of the standard distribution as derived files, right?
Yes. Well, at least, maybe, sort of...
As is the case with the other (html) docs, I'm planning on putting a
man tarball into the distribution. Up to now, the easiest way to do
that is to put the tarball into cvs, but I'm open to other
suggestions.
Do I guess correctly that we currently generate our production
releases by actually doing a cvs checkout and then a "mini-build" of
the system to generate the yacc/bison derived files? If so, we could
consider doing the same sort of thing for the html and man products,
but it (probably) makes this packaging process more fragile.
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [HACKERS] Merging old man pages
@ 1999-07-17 21:47 Tom Lane <tgl@sss.pgh.pa.us>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 0 replies; 7+ messages in thread
From: Tom Lane @ 1999-07-17 21:47 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: Postgres Documentation List <docs@postgreSQL.org>; Postgres Hackers List <hackers@postgreSQL.org>
Thomas Lockhart <lockhart@alumni.caltech.edu> writes:
> Do I guess correctly that we currently generate our production
> releases by actually doing a cvs checkout and then a "mini-build" of
> the system to generate the yacc/bison derived files?
Right.
> If so, we could
> consider doing the same sort of thing for the html and man products,
> but it (probably) makes this packaging process more fragile.
Less fragile than doing it by hand ;-). I'd say that's exactly the
way to proceed.
The shell script src/tools/release_prep contains the commands that
are executed (at hub.org) to prepare derived files for release.
Add whatever is needed to build the derived doc files, and we should
be set.
regards, tom lane
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Merging old man pages
@ 1999-07-18 14:28 Fred Wilson Horch <fhorch@ecoaccess.org>
0 siblings, 1 reply; 7+ messages in thread
From: Fred Wilson Horch @ 1999-07-18 14:28 UTC (permalink / raw)
To: pgsql-docs@hub.org
Thomas,
I'm interested in the new mechanism. Where can I find more detail about
it?
Thanks,
Fred H.
You wrote:
>
> We've now got a viable mechanism for generating man pages from sgml
> sources.
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [DOCS] Re: Merging old man pages
@ 1999-07-18 16:46 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Fred Wilson Horch <fhorch@ecoaccess.org>
0 siblings, 1 reply; 7+ messages in thread
From: Thomas Lockhart @ 1999-07-18 16:46 UTC (permalink / raw)
To: Fred Wilson Horch <fhorch@ecoaccess.org>; +Cc: pgsql-docs@hub.org
> I'm interested in the new mechanism. Where can I find more detail
> about it?
I believe that I wrote a small bit about the setup in the latest docs
appendix on "Documentation". Look on the web site or on
ftp://postgresql.org/pub/docs/postgres.tar.gz
Basically, to get this working on my Linux box I had to install a perl
package from CPAN and then reuse some routines I already had from my
jade installation (which builds the main docs).
If you want to try it, you will need to get my patched version of the
processing script. The original author has said that he will take most
of my patches, but I'm not sure how that will turn out. In any case,
I'll post these tools on postgresql.org sometime soon.
If you want to get started earlier, let me know and I'll send some
files...
- Thomas
--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: [DOCS] Re: Merging old man pages
@ 1999-07-18 17:38 Fred Wilson Horch <fhorch@ecoaccess.org>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 0 replies; 7+ messages in thread
From: Fred Wilson Horch @ 1999-07-18 17:38 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: pgsql-docs@hub.org
Thomas,
Thanks for the info. The documentation tools are indeed nicely
described at http://www.postgresql.org/docs/postgres/docguide.htm.
Thomas Lockhart wrote:
>
> > I'm interested in the new mechanism. Where can I find more detail
> > about it?
>
> I believe that I wrote a small bit about the setup in the latest docs
> appendix on "Documentation". Look on the web site [...]
> If you want to try it, you will need to get my patched version of the
> processing script. The original author has said that he will take most
> of my patches, but I'm not sure how that will turn out. In any case,
> I'll post these tools on postgresql.org sometime soon.
That would be great. I'll wait till then.
Fred H.
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~1999-07-18 17:38 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
1999-07-17 16:31 Merging old man pages Thomas Lockhart <lockhart@alumni.caltech.edu>
1999-07-17 17:22 ` Tom Lane <tgl@sss.pgh.pa.us>
1999-07-17 20:54 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
1999-07-17 21:47 ` Tom Lane <tgl@sss.pgh.pa.us>
1999-07-18 14:28 Re: Merging old man pages Fred Wilson Horch <fhorch@ecoaccess.org>
1999-07-18 16:46 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
1999-07-18 17:38 ` Fred Wilson Horch <fhorch@ecoaccess.org>
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