From: Tom Lane Date: Fri, 24 Dec 2004 19:12:37 +0000 (+0000) Subject: Minor updates and copy-editing. X-Git-Url: http://git.postgresql.org/gitweb/static/gitweb.js?a=commitdiff_plain;h=945c552ade72d96fa89590bc812394d0820ace8c;p=users%2Fbernd%2Fpostgres.git Minor updates and copy-editing. --- diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 4723c74c33..0cd1b942f4 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -146,7 +146,7 @@ su - postgres libperl library must be a shared library also on most platforms. This appears to be the default in recent Perl versions, but it was not - in earlier versions, and in general it is the choice of whomever + in earlier versions, and in any case it is the choice of whomever installed Perl at your site. @@ -238,8 +238,9 @@ su - postgres - Kerberos, OpenSSL, or PAM, - if you want to support authentication using these services. + Kerberos, OpenSSL, or + PAM, if you want to support authentication or + encryption using these services. @@ -393,23 +394,27 @@ su - postgres old one then shut down the old server, at the latest before you install the new files: -kill -INT `cat /usr/local/pgsql/data/postmaster.pid | sed 1q` +pg_ctl stop - Versions prior to 7.0 do not have this - postmaster.pid file. If you are using such a version - you must find out the process ID of the server yourself, for - example by typing ps ax | grep postmaster, and - supply it to the kill command. + On systems that have PostgreSQL started at boot time, + there is probably a start-up file that will accomplish the same thing. For + example, on a Red Hat Linux system one + might find that + +/etc/rc.d/init.d/postgresql stop + + works. - On systems that have PostgreSQL started at boot time, there is - probably a start-up file that will accomplish the same thing. For - example, on a Red Hat Linux system one might find that + Very old versions might not have pg_ctl. If you + can't find it or it doesn't work, find out the process ID of the + old server, for + example by typing ps ax | grep postmaster, and + signal it to stop this way: -/etc/rc.d/init.d/postgresql stop +kill -INT processID - works. Another possibility is pg_ctl stop. @@ -443,10 +448,10 @@ su - postgres - These topics are discussed at length in ,]]> which you are encouraged to read in any - case. + Further discussion appears in + + ,]]> + which you are encouraged to read in any case. @@ -691,7 +696,7 @@ su - postgres Enables Native Language Support (NLS), that is, the ability to display a program's messages in a language other than English. - LANGUAGES is a space separated + LANGUAGES is a space-separated list of codes of the languages that you want supported, for example --enable-nls='de fr'. (The intersection between your list and the set of actually provided @@ -825,7 +830,7 @@ su - postgres - Prevents the use of the Readline library. This disables + Prevents use of the Readline library. This disables command-line editing and history in psql, so it is not recommended. @@ -836,7 +841,8 @@ su - postgres - Build with Rendezvous support. + Build with Rendezvous support. This requires Rendezvous support + in your operating system. Recommended on Mac OS X. @@ -864,7 +870,8 @@ su - postgres Make the client libraries thread-safe. This allows concurrent threads in libpq and ECPG programs to safely control - their private connection handles. + their private connection handles. This option requires adequate + threading support in your operating system. @@ -873,8 +880,12 @@ su - postgres - Prevents the use of the Zlib library. This disables - compression support in pg_dump. + + zlib + + Prevents use of the Zlib library. This disables + support for compressed archives in pg_dump + and pg_restore. This option is only intended for those rare systems where this library is not available. @@ -936,12 +947,12 @@ su - postgres If you prefer a C compiler different from the one - configure picks then you can set the + configure picks, you can set the environment variable CC to the program of your choice. By default, configure will pick - gcc unless this is inappropriate for the - platform. Similarly, you can override the default compiler flags - with the CFLAGS variable. + gcc if available, else the platform's + default (usually cc). Similarly, you can override the + default compiler flags if needed with the CFLAGS variable. @@ -1002,8 +1013,8 @@ All of PostgreSQL is successfully made. Ready to install. If you are upgrading an existing system and are going to install - the new files over the old ones, then you should have backed up - your data and shut down the old server by now, as explained in + the new files over the old ones, be sure to back up + your data and shut down the old server before proceeding, as explained in above. @@ -1036,8 +1047,11 @@ All of PostgreSQL is successfully made. Ready to install. The standard installation provides all the header files needed for client - application development as well as for any server-side program - development (such as custom functions or data types written in C). + application development as well as for server-side program + development, such as custom functions or data types written in C. + (Prior to PostgreSQL 8.0, a separate gmake + install-all-headers command was needed for the latter, but this + step has been folded into the standard install.) diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml index e99e03433b..894e2ca74f 100644 --- a/doc/src/sgml/postgres.sgml +++ b/doc/src/sgml/postgres.sgml @@ -117,7 +117,7 @@ $PostgreSQL$ PostgreSQL database administrator. This includes installation of the software, set up and configuration of the server, management of users and databases, and maintenance tasks. - Anyone who runs a PostgreSQL server, either for + Anyone who runs a PostgreSQL server, even for personal use, but especially in production, should be familiar with the topics covered in this part. @@ -135,8 +135,8 @@ $PostgreSQL$ The first few chapters are written so that they can be understood without prerequisite knowledge, so that new users who need to set up their own server can begin their exploration with this part. - The rest of this part which is about tuning and management - presupposes that the reader is familiar with the general use of + The rest of this part is about tuning and management; that material + assumes that the reader is familiar with the general use of the PostgreSQL database system. Readers are encouraged to look at and for additional information.