Commit 5b48e2ec authored by Tom Lane's avatar Tom Lane

Work around a documentation toolchain problem by replacing the "AIX-fixlevels"

table with a <variablelist> carrying the same information.  Previously the
9.0 documentation was failing to build as a US-size PDF file.  It's quite
obscure what the real problem is or why this avoids it, but we need a hack
now so we can build docs for beta4.

In passing do a bit of editing in the AIX installation docs, in particular
remove a long-obsolete claim that the regression tests are likely to fail.
parent 1a078629
<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.349 2010/07/27 19:01:16 petere Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.350 2010/07/29 18:29:52 tgl Exp $ -->
<chapter id="installation"> <chapter id="installation">
<title><![%standalone-include[<productname>PostgreSQL</>]]> <title><![%standalone-include[<productname>PostgreSQL</>]]>
...@@ -2126,77 +2126,49 @@ kill `cat /usr/local/pgsql/data/postmaster.pid` ...@@ -2126,77 +2126,49 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
</para> </para>
<para> <para>
Use the following <command>configure</command> flags in addition The minimum recommended fix levels for supported AIX versions are:
to your own if you have installed Readline or libz
there: <literal>--with-includes=/usr/local/include
--with-libraries=/usr/local/lib</literal>.
</para> </para>
<para> <variablelist>
If you don't have a PowerPC or use GCC you might see rounding <varlistentry>
differences in the geometry regression test. There will probably <term>AIX 4.3.3</term>
be warnings about 0.0/0.0 division and duplicate symbols which you <listitem><para>Maintenance Level 11 + post ML11 bundle</para></listitem>
can safely ignore. </varlistentry>
</para>
<para> <varlistentry>
Some of the AIX tools may be <quote>a little different</quote> <term>AIX 5.1</term>
from what you may be accustomed to on other platforms. If you are <listitem><para>Maintenance Level 9 + post ML9 bundle</para></listitem>
looking for a version of <command>ldd</command>, useful for </varlistentry>
determining what object code depends on what libraries, the
following URLs may help you: <varlistentry>
<ulink url="http://www.faqs.org/faqs/aix-faq/part4/section-22.html"></ulink>, <term>AIX 5.2</term>
<ulink url="http://www.han.de/~jum/aix/ldd.c"></ulink>. <listitem><para>Technology Level 10 Service Pack 3</para></listitem>
</para> </varlistentry>
<varlistentry>
<term>AIX 5.3</term>
<listitem><para>Technology Level 7</para></listitem>
</varlistentry>
<varlistentry>
<term>AIX 6.1</term>
<listitem><para>Base Level</para></listitem>
</varlistentry>
</variablelist>
<para> <para>
<xref linkend="AIX-fixlevels"> shows the minimum recommended fix levels To check your current fix level, use
for various AIX versions. To check your current fix level, use
<command>oslevel -r</command> in AIX 4.3.3 to AIX 5.2 ML 7, or <command>oslevel -r</command> in AIX 4.3.3 to AIX 5.2 ML 7, or
<command>oslevel -s</command> in later versions. <command>oslevel -s</command> in later versions.
</para> </para>
<table id="AIX-fixlevels"> <para>
<title> Use the following <command>configure</command> flags in addition
Minimum recommended <systemitem class="osname">AIX</systemitem> fix levels to your own if you have installed Readline or libz in
</title> <literal>/usr/local</>:
<literal>--with-includes=/usr/local/include
<tgroup cols="2"> --with-libraries=/usr/local/lib</literal>.
<thead> </para>
<row>
<entry>AIX version</entry>
<entry>fix level</entry>
</row>
</thead>
<tbody>
<row>
<entry>AIX 4.3.3</entry>
<entry>Maintenance Level 11 + post ML11 bundle</entry>
</row>
<row>
<entry>AIX 5.1</entry>
<entry>Maintenance Level 9 + post ML9 bundle</entry>
</row>
<row>
<entry>AIX 5.2</entry>
<entry>Technology Level 10 Service Pack 3</entry>
</row>
<row>
<entry>AIX 5.3</entry>
<entry>Technology Level 7</entry>
</row>
<row>
<entry>AIX 6.1</entry>
<entry>Base Level</entry>
</row>
</tbody>
</tgroup>
</table>
<sect3> <sect3>
<title>GCC issues</title> <title>GCC issues</title>
...@@ -2250,8 +2222,8 @@ kill `cat /usr/local/pgsql/data/postmaster.pid` ...@@ -2250,8 +2222,8 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
to parse IP addresses in <varname>listen_addresses</>, to parse IP addresses in <varname>listen_addresses</>,
<filename>pg_hba.conf</>, etc. Older versions of AIX have assorted <filename>pg_hba.conf</>, etc. Older versions of AIX have assorted
bugs in this function. If you have problems related to these settings, bugs in this function. If you have problems related to these settings,
updating to the appropriate fix level shown in <xref updating to the appropriate AIX fix level shown above
linkend="AIX-fixlevels"> should take care of it. should take care of it.
</para> </para>
<!-- http://archives.postgresql.org/message-id/6064jt6cfm.fsf_-_@dba2.int.libertyrms.com --> <!-- http://archives.postgresql.org/message-id/6064jt6cfm.fsf_-_@dba2.int.libertyrms.com -->
...@@ -2301,13 +2273,15 @@ hosts=local4,bind4 ...@@ -2301,13 +2273,15 @@ hosts=local4,bind4
</itemizedlist> </itemizedlist>
</para> </para>
<warning> <para> This is really a workaround of problems relating <warning>
<para>
This is really a workaround for problems relating
to immaturity of IPv6 support, which improved visibly during the to immaturity of IPv6 support, which improved visibly during the
course of AIX 5.3 releases. It has worked with AIX version 5.3, course of AIX 5.3 releases. It has worked with AIX version 5.3,
but does not represent an elegant solution to the problem. It has but does not represent an elegant solution to the problem. It has
been reported that this workaround is not only unnecessary, but been reported that this workaround is not only unnecessary, but
causes problems on AIX 6.1, where IPv6 support has become more causes problems on AIX 6.1, where IPv6 support has become more mature.
mature. </para> </para>
</warning> </warning>
</sect3> </sect3>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment