Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 41acf3d

Browse files
peterepetere
committed
Some tuning
1 parent f9d87c6 commit 41acf3d

File tree

1 file changed

+49
-45
lines changed

1 file changed

+49
-45
lines changed

‎doc/src/sgml/installation.sgml

+49-45
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.69 2001/12/08 03:24:22 thomas Exp $ -->
1+
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.70 2001/12/19 18:49:56 petere Exp $ -->
22

33
<chapter id="installation">
44
<title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -65,7 +65,7 @@ su - postgres
6565
<screen>
6666
<userinput>gmake --version</userinput>
6767
</screen>
68-
If at all possible you should use version 3.76.1 or later.
68+
It is recommended to use version 3.76.1 or later.
6969
</para>
7070
</listitem>
7171

@@ -477,7 +477,7 @@ su - postgres
477477
into private directories under
478478
<varname>includedir</varname>.
479479
See the <citetitle>Programmer's Guide</citetitle> for
480-
information how to get at the header files for each interface.
480+
information about how to get at the header files for each interface.
481481
Finally, a private subdirectory will also be created, if appropriate,
482482
under <varname>libdir</varname> for dynamically loadable modules.
483483
</para>
@@ -568,7 +568,8 @@ su - postgres
568568
to display a program's message in a language other than
569569
English. <replaceable>LANGUAGES</replaceable> is a space
570570
separated list of codes of the languages that you want
571-
supported. (The intersection between your list and the set
571+
supported, for example <literal>--enable-nls='de fr'</>.
572+
(The intersection between your list and the set
572573
of actually provided translations will be computed
573574
automatically.) If you do not specify it, then all available
574575
translations are installed.
@@ -697,8 +698,9 @@ su - postgres
697698
<para>
698699
Build the ODBC driver. By default, the driver will be independent
699700
of a driver manager. To work better with a driver manager already
700-
installed on your system, use one of the following options. More
701-
information can be found in the <citetitle>Programmer's Guide</citetitle>.
701+
installed on your system, use one of the following options in addition
702+
to this one. More information can be found in the
703+
<citetitle>Programmer's Guide</citetitle>.
702704
</para>
703705
</listitem>
704706
</varlistentry>
@@ -743,8 +745,8 @@ su - postgres
743745
</varlistentry>
744746

745747
<varlistentry>
746-
<term><option>--with-krb4=<replaceable>DIRECTORY</></option></term>
747-
<term><option>--with-krb5=<replaceable>DIRECTORY</></option></term>
748+
<term><option>--with-krb4<optional>=<replaceable>DIRECTORY</></></option></term>
749+
<term><option>--with-krb5<optional>=<replaceable>DIRECTORY</></></option></term>
748750
<listitem>
749751
<para>
750752
Build with support for Kerberos authentication. You can use
@@ -786,7 +788,7 @@ su - postgres
786788
<seealso>SSL</seealso>
787789
</indexterm>
788790

789-
<term><option>--with-openssl=<replaceable>DIRECTORY</></option></term>
791+
<term><option>--with-openssl<optional>=<replaceable>DIRECTORY</></></option></term>
790792
<listitem>
791793
<para>
792794
Build with support for <acronym>SSL</> (encrypted) connections.
@@ -969,7 +971,7 @@ All of PostgreSQL is successfully made. Ready to install.
969971
</para>
970972

971973
<para>
972-
The standard install installs only the header files needed for client
974+
The standard installation contains only the header files needed for client
973975
application development. If you plan to do any server-side program
974976
development (such as custom functions or data types written in C),
975977
then you may want to install the entire <productname>PostgreSQL</>
@@ -984,7 +986,7 @@ All of PostgreSQL is successfully made. Ready to install.
984986
</para>
985987

986988
<formalpara>
987-
<title>Client-only installation</title>
989+
<title>Client-only installation:</title>
988990
<para>
989991
If you want to install only the client applications and
990992
interface libraries, then you can use these commands:
@@ -1057,7 +1059,7 @@ setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
10571059
<option><literal>--libdir</></> to in <xref linkend="configure">.
10581060
You should put these commands into a shell start-up file such as
10591061
<filename>/etc/profile</> or <filename>~/.bash_profile</>. Some
1060-
good information about the caveats associated with the method can
1062+
good information about the caveats associated with this method can
10611063
be found at <ulink
10621064
url="http://www.visi.com/~barr/ldpath.html"></ulink>.
10631065
</para>
@@ -1268,21 +1270,21 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
12681270
<itemizedlist>
12691271
<listitem>
12701272
<para>
1271-
The <citetitle>Tutorial</> should be your first reading if you
1272-
are completely new to <acronym>SQL</> databases. It should have
1273-
been installed at
1274-
<filename>/usr/local/pgsql/doc/html/tutorial.html</> unless you
1273+
The <productname>PostgreSQL</> distribution contains a
1274+
comprehensive documentation set, which you should read sometime.
1275+
After installation, the documentation can be accessed by
1276+
pointing your browser to
1277+
<filename>/usr/local/pgsql/doc/html/index.html</>, unless you
12751278
changed the installation directories.
12761279
</para>
1277-
</listitem>
12781280

1279-
<listitem>
12801281
<para>
1282+
The <citetitle>Tutorial</> should be your first reading if you
1283+
are completely new to <acronym>SQL</> databases.
12811284
If you are familiar with database concepts then you want to
12821285
proceed with the <citetitle>Administrator's Guide</citetitle>,
12831286
which contains information about how to set up the database
1284-
server, database users, and authentication. It can be found at
1285-
<filename>/usr/local/pgsql/doc/html/admin.html</>.
1287+
server, database users, and authentication.
12861288
</para>
12871289
</listitem>
12881290

@@ -1552,7 +1554,7 @@ gunzip -c user.ps.gz \
15521554
<entry>OBSD-3.0</entry>
15531555
</row>
15541556
<row>
1555-
<entry><systemitem class="osname">OpenUnix</></entry>
1557+
<entry><systemitem class="osname">OpenUNIX</></entry>
15561558
<entry><systemitem>x86</></entry>
15571559
<entry>7.2</entry>
15581560
<entry>2001-11-28,
@@ -1567,7 +1569,7 @@ gunzip -c user.ps.gz \
15671569
<entry>2001-05-24,
15681570
Bernd Tegge (<email>tegge@repas-aeg.de</email>)
15691571
</entry>
1570-
<entry>7.2 w/patches on QNX 6; see also <filename>doc/FAQ_QNX4</filename></entry>
1572+
<entry>see also <filename>doc/FAQ_QNX4</filename></entry>
15711573
</row>
15721574
<row>
15731575
<entry><systemitem class="osname">Solaris</></entry>
@@ -1585,20 +1587,8 @@ gunzip -c user.ps.gz \
15851587
Martin Renters (<email>martin@datafax.com</email>)</entry>
15861588
<entry>2.8; see also <filename>doc/FAQ_Solaris</filename></entry>
15871589
</row>
1588-
<!--
1589-
No longer compiles without error, but not really needing to be listed
1590-
as unsupported either since it is superceded by Solaris. - thomas 2001-12-03
15911590
<row>
1592-
<entry><systemitem class="osname">SunOS</></entry>
1593-
<entry><systemitem>Sparc</></entry>
1594-
<entry>7.1</entry>
1595-
<entry>2001-03-23,
1596-
Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry>
1597-
<entry>4.1.4</entry>
1598-
</row>
1599-
-->
1600-
<row>
1601-
<entry><systemitem class="osname">Tru64</></entry>
1591+
<entry><systemitem class="osname">Tru64 UNIX</></entry>
16021592
<entry><systemitem>Alpha</></entry>
16031593
<entry>7.2</entry>
16041594
<entry>2001-11-26,
@@ -1618,12 +1608,12 @@ as unsupported either since it is superceded by Solaris. - thomas 2001-12-03
16181608
</informaltable>
16191609

16201610
<formalpara>
1621-
<title>Unsupported Platforms</title>
1611+
<title>Unsupported Platforms:</title>
16221612
<para>
1623-
The following platforms have not been verified to work. Platforms
1624-
listed for version 6.3.x and later should also work with
1625-
&version;, but we did not receive explicit confirmation of such at
1626-
the time this list was compiled. We include these here to let you
1613+
The following platforms are either known not to work, or they used
1614+
to work in a previous release and we did not receive explicit
1615+
confirmation of a successful test with version &majorversion; at
1616+
the time this list was compiled. We include these here to let you
16271617
know that these platforms <emphasis>could</> be supported if given
16281618
some attention.
16291619
</para>
@@ -1647,7 +1637,7 @@ as unsupported either since it is superceded by Solaris. - thomas 2001-12-03
16471637
<entry><systemitem>m88k</></entry>
16481638
<entry>6.3</entry>
16491639
<entry>1998-03-01, Brian E Gallew (<email>geek+@cmu.edu</email>)</entry>
1650-
<entry>6.4 probably OK</entry>
1640+
<entry>no recent reports</entry>
16511641
</row>
16521642
<!--
16531643
Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
@@ -1666,12 +1656,26 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
16661656
<entry>1998-03-01, David Wetzel (<email>dave@turbocat.de</email>)</entry>
16671657
<entry>bit rot suspected</entry>
16681658
</row>
1659+
<row>
1660+
<entry><systemitem class="osname">QNX 6</></entry>
1661+
<entry><systemitem>x86</></entry>
1662+
<entry>7.2</entry>
1663+
<entry>2001-11-20, Igor Kovalenko (<email>Igor.Kovalenko@motorola.com</email>)</entry>
1664+
<entry>patches available, but too late for 7.2</entry>
1665+
</row>
16691666
<row>
16701667
<entry><systemitem class="osname">SCO OpenServer 5</></entry>
16711668
<entry><systemitem>x86</></entry>
16721669
<entry>6.5</entry>
16731670
<entry>1999-05-25, Andrew Merrill (<email>andrew@compclass.com</>)</entry>
1674-
<entry>7.1 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>
1671+
<entry>7.2 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>
1672+
</row>
1673+
<row>
1674+
<entry><systemitem class="osname">SunOS</></entry>
1675+
<entry><systemitem>Sparc</></entry>
1676+
<entry>7.2</entry>
1677+
<entry>2001-12-04, Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry>
1678+
<entry><function>memcmp()</> does not work correctly, so probably not reliable</entry>
16751679
</row>
16761680
<row>
16771681
<entry><systemitem class="osname">System V R4</></entry>
@@ -1685,7 +1689,7 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
16851689
<entry><systemitem>MIPS</></entry>
16861690
<entry>6.4</entry>
16871691
<entry>1998-10-28, Frank Ridderbusch (<email>ridderbusch.pad@sni.de</email>)</entry>
1688-
<entry>no 64-bit integer</entry>
1692+
<entry>no recent reports</entry>
16891693
</row>
16901694
<row>
16911695
<entry><systemitem class="osname">Ultrix</></entry>
@@ -1699,7 +1703,7 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
16991703
<entry><systemitem>VAX</></entry>
17001704
<entry>6.x</entry>
17011705
<entry>1998-03-01</entry>
1702-
<entry>No recent reports</entry>
1706+
<entry>no recent reports</entry>
17031707
</row>
17041708
<row>
17051709
<entry><systemitem class="osname">Windows 9x, ME, NT, 2000</> (native)</entry>
@@ -1708,7 +1712,7 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07
17081712
<entry>2001-03-26, Magnus Hagander (<email>mha@sollentuna.net</email>)</entry>
17091713
<entry>
17101714
client-side libraries (<application>libpq</> and <application>psql</>) or ODBC or JDBC, no server-side;
1711-
<![%standalone-include[see Administrator's Guide]]>
1715+
<![%standalone-include[see <citetitle>Administrator's Guide</>]]>
17121716
<![%standalone-ignore[see <xref linkend="install-win32">]]>
17131717
for instructions
17141718
</entry>

0 commit comments

Comments
 (0)