Skip site navigation (1) Skip section navigation (2)

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

From: Bruce Momjian <maillist(at)candle(dot)pha(dot)pa(dot)us>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: Vince Vielhaber <vev(at)michvhf(dot)com>, The Hermit Hacker <scrappy(at)hub(dot)org>, docs(at)postgreSQL(dot)org, "Thomas G(dot) Lockhart" <lockhart(at)alumni(dot)caltech(dot)edu>
Subject: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
Date: 1999-09-28 04:44:07
Message-ID: 199909280444.AAA01587@candle.pha.pa.us (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackers
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(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

pgsql-docs by date

Next:From: Bruce MomjianDate: 1999-09-28 15:32:43
Subject: New backend flowchart
Previous:From: Daniel FungDate: 1999-09-27 15:59:55
Subject: Getting Postgres Info

pgsql-hackers by date

Next:From: Hiroshi InoueDate: 1999-09-28 04:52:12
Subject: Recovery on incomplete write
Previous:From: Bruce MomjianDate: 1999-09-28 04:32:24
Subject: Re: [HACKERS] Doccumentation Patch for Create Function

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group