From 41acf3d8207aacdcb3059b8ed970c856ebea22d6 Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Wed, 19 Dec 2001 18:49:56 +0000 Subject: [PATCH] Some tuning --- doc/src/sgml/installation.sgml | 94 ++++++++++++++++++---------------- 1 file changed, 49 insertions(+), 45 deletions(-) diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 4316cea55c..74d5e4ba29 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -1,4 +1,4 @@ - + <![%standalone-include[<productname>PostgreSQL</>]]> @@ -65,7 +65,7 @@ su - postgres <screen> <userinput>gmake --version</userinput> </screen> - If at all possible you should use version 3.76.1 or later. + It is recommended to use version 3.76.1 or later. </para> </listitem> @@ -477,7 +477,7 @@ su - postgres into private directories under <varname>includedir</varname>. See the <citetitle>Programmer's Guide</citetitle> for - information how to get at the header files for each interface. + information about how to get at the header files for each interface. Finally, a private subdirectory will also be created, if appropriate, under <varname>libdir</varname> for dynamically loadable modules. </para> @@ -568,7 +568,8 @@ su - postgres to display a program's message in a language other than English. <replaceable>LANGUAGES</replaceable> is a space separated list of codes of the languages that you want - supported. (The intersection between your list and the set + supported, for example <literal>--enable-nls='de fr'</>. + (The intersection between your list and the set of actually provided translations will be computed automatically.) If you do not specify it, then all available translations are installed. @@ -697,8 +698,9 @@ su - postgres <para> Build the ODBC driver. By default, the driver will be independent of a driver manager. To work better with a driver manager already - installed on your system, use one of the following options. More - information can be found in the <citetitle>Programmer's Guide</citetitle>. + installed on your system, use one of the following options in addition + to this one. More information can be found in the + <citetitle>Programmer's Guide</citetitle>. </para> </listitem> </varlistentry> @@ -743,8 +745,8 @@ su - postgres </varlistentry> <varlistentry> - <term><option>--with-krb4=<replaceable>DIRECTORY</></option></term> - <term><option>--with-krb5=<replaceable>DIRECTORY</></option></term> + <term><option>--with-krb4<optional>=<replaceable>DIRECTORY</></></option></term> + <term><option>--with-krb5<optional>=<replaceable>DIRECTORY</></></option></term> <listitem> <para> Build with support for Kerberos authentication. You can use @@ -786,7 +788,7 @@ su - postgres <seealso>SSL</seealso> </indexterm> - <term><option>--with-openssl=<replaceable>DIRECTORY</></option></term> + <term><option>--with-openssl<optional>=<replaceable>DIRECTORY</></></option></term> <listitem> <para> Build with support for <acronym>SSL</> (encrypted) connections. @@ -969,7 +971,7 @@ All of PostgreSQL is successfully made. Ready to install. </para> <para> - The standard install installs only the header files needed for client + The standard installation contains only the header files needed for client application development. If you plan to do any server-side program development (such as custom functions or data types written in C), then you may want to install the entire <productname>PostgreSQL</> @@ -984,7 +986,7 @@ All of PostgreSQL is successfully made. Ready to install. </para> <formalpara> - <title>Client-only installation + Client-only installation: If you want to install only the client applications and interface libraries, then you can use these commands: @@ -1057,7 +1059,7 @@ setenv LD_LIBRARY_PATH /usr/local/pgsql/lib @@ -1268,21 +1270,21 @@ kill `cat /usr/local/pgsql/data/postmaster.pid` - The Tutorial should be your first reading if you - are completely new to SQL databases. It should have - been installed at - /usr/local/pgsql/doc/html/tutorial.html unless you + The PostgreSQL distribution contains a + comprehensive documentation set, which you should read sometime. + After installation, the documentation can be accessed by + pointing your browser to + /usr/local/pgsql/doc/html/index.html, unless you changed the installation directories. - - + The Tutorial should be your first reading if you + are completely new to SQL databases. If you are familiar with database concepts then you want to proceed with the Administrator's Guide, which contains information about how to set up the database - server, database users, and authentication. It can be found at - /usr/local/pgsql/doc/html/admin.html. + server, database users, and authentication. @@ -1552,7 +1554,7 @@ gunzip -c user.ps.gz \ OBSD-3.0 - OpenUnix + OpenUNIX x86 7.2 2001-11-28, @@ -1567,7 +1569,7 @@ gunzip -c user.ps.gz \ 2001-05-24, Bernd Tegge (tegge@repas-aeg.de) - 7.2 w/patches on QNX 6; see also doc/FAQ_QNX4 + see also doc/FAQ_QNX4 Solaris @@ -1585,20 +1587,8 @@ gunzip -c user.ps.gz \ Martin Renters (martin@datafax.com) 2.8; see also doc/FAQ_Solaris - - - Tru64 + Tru64 UNIX Alpha 7.2 2001-11-26, @@ -1618,12 +1608,12 @@ as unsupported either since it is superceded by Solaris. - thomas 2001-12-03 - Unsupported Platforms + Unsupported Platforms: - The following platforms have not been verified to work. Platforms - listed for version 6.3.x and later should also work with - &version;, but we did not receive explicit confirmation of such at - the time this list was compiled. We include these here to let you + The following platforms are either known not to work, or they used + to work in a previous release and we did not receive explicit + confirmation of a successful test with version &majorversion; at + the time this list was compiled. We include these here to let you know that these platforms could be supported if given some attention. @@ -1647,7 +1637,7 @@ as unsupported either since it is superceded by Solaris. - thomas 2001-12-03 m88k 6.3 1998-03-01, Brian E Gallew (geek+@cmu.edu) - 6.4 probably OK + no recent reports