Formatted man pages

Bruce Momjian <pgman@candle.pha.pa.us> writes:

I see a man.tar.gz on the ftp site in the /dev/doc directory. Shouldn't
those file be added to the web site and main ftp directories?

It's part of the distribution tarball already, no?

regards, tom lane

Tom Lane wrote:

Bruce Momjian <pgman@candle.pha.pa.us> writes:

I see a man.tar.gz on the ftp site in the /dev/doc directory. Shouldn't
those file be added to the web site and main ftp directories?

It's part of the distribution tarball already, no?

You would think so, but I can't find them. The HTML reference pages are
there, but not the formatted manual pages.

-- 
  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

Bruce Momjian writes:

Tom Lane wrote:

Bruce Momjian <pgman@candle.pha.pa.us> writes:

I see a man.tar.gz on the ftp site in the /dev/doc directory. Shouldn't
those file be added to the web site and main ftp directories?

It's part of the distribution tarball already, no?

You would think so, but I can't find them. The HTML reference pages are
there, but not the formatted manual pages.

$ tar tzf postgresql-7.2.tar.gz | grep man.tar.gz
postgresql-7.2/doc/man.tar.gz

--
Peter Eisentraut peter_e@gmx.net

Peter Eisentraut wrote:

Bruce Momjian writes:

Tom Lane wrote:

Bruce Momjian <pgman@candle.pha.pa.us> writes:

I see a man.tar.gz on the ftp site in the /dev/doc directory. Shouldn't
those file be added to the web site and main ftp directories?

It's part of the distribution tarball already, no?

You would think so, but I can't find them. The HTML reference pages are
there, but not the formatted manual pages.

$ tar tzf postgresql-7.2.tar.gz | grep man.tar.gz
postgresql-7.2/doc/man.tar.gz

Oh, so it is in the main tarball and not in the docs tarball?

-- 
  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

Peter Eisentraut wrote:

Bruce Momjian writes:

Oh, so it is in the main tarball and not in the docs tarball?

Yeah, because that's where the programs are that the man pages document.

But shouldn't it be in the doc tarball too?

-- 
  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

Bruce Momjian writes:

Oh, so it is in the main tarball and not in the docs tarball?

Yeah, because that's where the programs are that the man pages document.

--
Peter Eisentraut peter_e@gmx.net

Peter Eisentraut wrote:

Bruce Momjian writes:

Peter Eisentraut wrote:

Bruce Momjian writes:

Oh, so it is in the main tarball and not in the docs tarball?

Yeah, because that's where the programs are that the man pages document.

But shouldn't it be in the doc tarball too?

You could argue for them being in the docs tarball, but not for "too",
because these tarballs must be nonoverlapping (and you need to main
tarball anyway to do anything with the others).

Oh. I thought postgresql-7.2.tar.gz had everything. I guess it has
everything except the HTML docs. I see now. Makes sense.

-- 
  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

Bruce Momjian writes:

Peter Eisentraut wrote:

Bruce Momjian writes:

Oh, so it is in the main tarball and not in the docs tarball?

Yeah, because that's where the programs are that the man pages document.

But shouldn't it be in the doc tarball too?

You could argue for them being in the docs tarball, but not for "too",
because these tarballs must be nonoverlapping (and you need to main
tarball anyway to do anything with the others).

--
Peter Eisentraut peter_e@gmx.net

On Fri, 22 Feb 2002, Bruce Momjian wrote:

Peter Eisentraut wrote:

Bruce Momjian writes:

Peter Eisentraut wrote:

Bruce Momjian writes:

Oh, so it is in the main tarball and not in the docs tarball?

Yeah, because that's where the programs are that the man pages document.

But shouldn't it be in the doc tarball too?

You could argue for them being in the docs tarball, but not for "too",
because these tarballs must be nonoverlapping (and you need to main
tarball anyway to do anything with the others).

Oh. I thought postgresql-7.2.tar.gz had everything. I guess it has
everything except the HTML docs. I see now. Makes sense.

Glad it makes sense to someone. I, too, thought the main tarball had
everything. It should. I was under the impression that the base tarball
is the one you needed if you were only grabbing parts of the distribution.

Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
56K Nationwide Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================

Vince Vielhaber wrote:

Oh. I thought postgresql-7.2.tar.gz had everything. I guess it has
everything except the HTML docs. I see now. Makes sense.

Glad it makes sense to someone. I, too, thought the main tarball had
everything. It should. I was under the impression that the base tarball
is the one you needed if you were only grabbing parts of the distribution.

Actually, it doesn't make sense to me. I was being polite. :-) I
thought the postgresql-7.2.tar.gz had everything, including HTML. At
least I think it should.

In fact, in looking at the postgresql-7.2.tar.gz tarball, I see:

FAQ FAQ_Solaris TODO
FAQ_AIX FAQ_german TODO.detail/
FAQ_DEV FAQ_japanese bug.template
FAQ_HPUX KNOWN_BUGS man.tar.gz <----
FAQ_IRIX MISSING_FEATURES postgres.tar.gz <----
FAQ_MSWIN Makefile src/
FAQ_QNX4 README.mb.big5
FAQ_SCO README.mb.jp

So, it has the man pages and HTML files? OK, I see now, the man pages
are in the base tarball postgresql-base-7.2.tar.gz, so they don't need
to be in the doc tarball. Now, I really do get it.

-- 
  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

On Fri, 22 Feb 2002, Bruce Momjian wrote:

Vince Vielhaber wrote:

Oh. I thought postgresql-7.2.tar.gz had everything. I guess it has
everything except the HTML docs. I see now. Makes sense.

Glad it makes sense to someone. I, too, thought the main tarball had
everything. It should. I was under the impression that the base tarball
is the one you needed if you were only grabbing parts of the distribution.

Actually, it doesn't make sense to me. I was being polite. :-) I
thought the postgresql-7.2.tar.gz had everything, including HTML. At
least I think it should.

In fact, in looking at the postgresql-7.2.tar.gz tarball, I see:

FAQ FAQ_Solaris TODO
FAQ_AIX FAQ_german TODO.detail/
FAQ_DEV FAQ_japanese bug.template
FAQ_HPUX KNOWN_BUGS man.tar.gz <----
FAQ_IRIX MISSING_FEATURES postgres.tar.gz <----
FAQ_MSWIN Makefile src/
FAQ_QNX4 README.mb.big5
FAQ_SCO README.mb.jp

If this is the doc directory then the main tarball does have everything
and it makes sense to me now too.

Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
56K Nationwide Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================

Bruce Momjian <pgman@candle.pha.pa.us> writes:

thought the postgresql-7.2.tar.gz had everything, including HTML. At
least I think it should.

Certainly, and it does.

So, it has the man pages and HTML files? OK, I see now, the man pages
are in the base tarball postgresql-base-7.2.tar.gz, so they don't need
to be in the doc tarball. Now, I really do get it.

I thought the item under discussion was which split-tarball file should
contain the prebuilt doc files. To me, putting 'em in -docs makes much
more sense than putting them in -base, for both HTML and man-page files.
So I think your complaint was legit, if poorly worded.

regards, tom lane

Tom Lane wrote:

Bruce Momjian <pgman@candle.pha.pa.us> writes:

thought the postgresql-7.2.tar.gz had everything, including HTML. At
least I think it should.

Certainly, and it does.

So, it has the man pages and HTML files? OK, I see now, the man pages
are in the base tarball postgresql-base-7.2.tar.gz, so they don't need
to be in the doc tarball. Now, I really do get it.

I thought the item under discussion was which split-tarball file should
contain the prebuilt doc files. To me, putting 'em in -docs makes much
more sense than putting them in -base, for both HTML and man-page files.
So I think your complaint was legit, if poorly worded.

Yes, I did expect them to be only in doc, not in base. In fact, when I
didn't find them in /doc, I thought they weren't anywhere. I never
thought to look in base.

However, Peter's point is that they go with the binaries and are not
part of the documentation set, at least not in man pages format. In
HTML format, they are in the doc set.

-- 
  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