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

От: Bruce Momjian
Тема: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
Дата: ,
Msg-id: 199909280444.AAA01587@candle.pha.pa.us
(см: обсуждение, исходный текст)
Ответ на: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Peter Eisentraut)
Список: pgsql-docs

Скрыть дерево обсуждения

INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Peter Eisentraut, )
 RE: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Vince Vielhaber, )
 Re: [DOCS] INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Thomas Lockhart, )
  Re: [DOCS] INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Bruce Momjian, )
 Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Bruce Momjian, )
 Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Bruce Momjian, )
  Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Vince Vielhaber, )
   Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)  (Bruce Momjian, )

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 - 
> http://yi.org/peter-e
Content-Description: New INSTALL file?

[Attachment, skipping...]


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



В списке pgsql-docs по дате сообщения:

От: Bruce Momjian
Дата:
Сообщение: Re: INSTALL file (was Re: [HACKERS] Re: HISTORY for 6.5.2)
От: Bruce Momjian
Дата:
Сообщение: New backend flowchart