From: Bruce Momjian <maillist@candle.pha.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: Vince Vielhaber <vev@michvhf.com>
Cc: The Hermit Hacker <scrappy@hub.org>
Cc: docs@postgreSQL.org, "Thomas G. Lockhart" <lockhart@alumni.caltech.edu>
Subject: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
Date: Tue, 28 Sep 1999 00:44:07 -0400 (EDT)
Message-ID: <199909280444.AAA01587@candle.pha.pa.us> (raw)
In-Reply-To: <Pine.LNX.4.10.9909212031480.1899-200000@peter-e.yi.org>
Thomas, can you comment on this. I think he has a good point. Can we
move some of the stuff to footnotes at the end of the file? Can you try
converting to HTML first, then to text to see if it formats better:
lynx -force_html -dump -hiddenlinks=ignore -nolist "$@"
> On Sep 20, Bruce Momjian mentioned:
>
> > I agree our INSTALL is very large. Is there some way we can simplify
> > the install process?
>
> On the one hand a database server is probably not your everyday
> ./configure && make && make install program you get from freshmeat and you
> do want to put some time into a proper installation. On the other hand the
> INSTALL file is really way too long and makes for unpleasant reading.
>
> Here are a couple of ideas.
>
> * Chapter 2 "Ports" should be moved to the README file (has nothing to do
> with the actual installation).
>
> * Move the gory details of item 5 (flex) to a separate file (README.flex).
>
> * Move the locale stuff into a separate file.
>
> * Same with Kerberos
>
> * Move the release notes at the end to CHANGELOG.
>
> That should make the file somewhat smaller, then also it is really to
> verbose at times and is formatted really oddly, at least on my system.
>
> Okay, now I really went out of my way and redid the whole thing. You'll
> find the result attached. This is merely an idea of what I would consider
> simpler. I removed some inconsistencies, things that were unnecessary, too
> complicated, etc. Okay, I removed a lot of stuff, but most of the stuff
> people can really figure out themselves if they need them in the first
> place. And I shrunk the thing to 25%.
>
> Perhaps there should be a separate Install FAQ of the sort "My shell said
> 'export: Command not found.'" or "What's a shared library?" to move the
> really annoying stuff out of people's ways.
>
> Comments?
>
> --
> Peter Eisentraut - peter_e@gmx.net
> http://yi.org/peter-eContent-Description: New INSTALL file?
[Attachment, skipping...]
--
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, Pennsylvania 19026
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: maillist@candle.pha.pa.us, peter_e@gmx.net, vev@michvhf.com, scrappy@hub.org, lockhart@alumni.caltech.edu
Subject: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
In-Reply-To: <199909280444.AAA01587@candle.pha.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
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