Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Bruce Momjian <maillist(at)candle(dot)pha(dot)pa(dot)us>, Vince Vielhaber <vev(at)michvhf(dot)com>, The Hermit Hacker <scrappy(at)hub(dot)org>, docs(at)postgreSQL(dot)org
Subject: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
Date: 1999-11-29 23:16:33
Message-ID: 199911292316.SAA16942@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers


I hope we can get everyone with ideas together before 7.0 is released.

> 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(at)gmx(dot)net
> http://yi.org/peter-e
Content-Description: New INSTALL file?

[Attachment, skipping...]

--
Bruce Momjian | http://www.op.net/~candle
maillist(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Vince Vielhaber 1999-11-29 23:28:46 Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
Previous Message Thomas Lockhart 1999-11-29 08:07:19 Re: [DOCS] Re: Postgresql Documentation

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 1999-11-29 23:27:34 Re: [HACKERS] Tricky query, tricky response
Previous Message Bruce Momjian 1999-11-29 23:12:36 Re: [HACKERS] Bug