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.
> Peter Eisentraut - peter_e(at)gmx(dot)net
Content-Description: New INSTALL file?
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 Momjian||Date: 1999-09-28 15:32:43|
|Subject: New backend flowchart|
|Previous:||From: Daniel Fung||Date: 1999-09-27 15:59:55|
|Subject: Getting Postgres Info|
pgsql-hackers by date
|Next:||From: Hiroshi Inoue||Date: 1999-09-28 04:52:12|
|Subject: Recovery on incomplete write|
|Previous:||From: Bruce Momjian||Date: 1999-09-28 04:32:24|
|Subject: Re: [HACKERS] Doccumentation Patch for Create Function|