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.
This commit is contained in:
Tom Lane 2010-07-29 18:29:52 +00:00
parent 1a078629ac
commit 5b48e2ecd4

View File

@ -1,4 +1,4 @@
<!-- $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`
</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>
<varlistentry>
<term>AIX 5.1</term>
<listitem><para>Maintenance Level 9 + post ML9 bundle</para></listitem>
</varlistentry>
<varlistentry>
<term>AIX 5.2</term>
<listitem><para>Technology Level 10 Service Pack 3</para></listitem>
</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>
Some of the AIX tools may be <quote>a little different</quote> To check your current fix level, use
from what you may be accustomed to on other platforms. If you are
looking for a version of <command>ldd</command>, useful for
determining what object code depends on what libraries, the
following URLs may help you:
<ulink url="http://www.faqs.org/faqs/aix-faq/part4/section-22.html"></ulink>,
<ulink url="http://www.han.de/~jum/aix/ldd.c"></ulink>.
</para>
<para>
<xref linkend="AIX-fixlevels"> shows the minimum recommended fix levels
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`
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
</itemizedlist> </itemizedlist>
</para> </para>
<warning> <para> This is really a workaround of problems relating <warning>
to immaturity of IPv6 support, which improved visibly during the <para>
course of AIX 5.3 releases. It has worked with AIX version 5.3, This is really a workaround for problems relating
but does not represent an elegant solution to the problem. It has to immaturity of IPv6 support, which improved visibly during the
been reported that this workaround is not only unnecessary, but course of AIX 5.3 releases. It has worked with AIX version 5.3,
causes problems on AIX 6.1, where IPv6 support has become more but does not represent an elegant solution to the problem. It has
mature. </para> been reported that this workaround is not only unnecessary, but
causes problems on AIX 6.1, where IPv6 support has become more mature.
</para>
</warning> </warning>
</sect3> </sect3>