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

Commit 5b48e2e

Browse files
committed
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.
1 parent 1a07862 commit 5b48e2e

File tree

1 file changed

+47
-73
lines changed

1 file changed

+47
-73
lines changed

doc/src/sgml/installation.sgml

+47-73
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.349 2010/07/27 19:01:16 petere Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.350 2010/07/29 18:29:52 tgl Exp $ -->
22

33
<chapter id="installation">
44
<title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -2126,77 +2126,49 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
21262126
</para>
21272127

21282128
<para>
2129-
Use the following <command>configure</command> flags in addition
2130-
to your own if you have installed Readline or libz
2131-
there: <literal>--with-includes=/usr/local/include
2132-
--with-libraries=/usr/local/lib</literal>.
2129+
The minimum recommended fix levels for supported AIX versions are:
21332130
</para>
21342131

2135-
<para>
2136-
If you don't have a PowerPC or use GCC you might see rounding
2137-
differences in the geometry regression test. There will probably
2138-
be warnings about 0.0/0.0 division and duplicate symbols which you
2139-
can safely ignore.
2140-
</para>
2141-
2142-
<para>
2143-
Some of the AIX tools may be <quote>a little different</quote>
2144-
from what you may be accustomed to on other platforms. If you are
2145-
looking for a version of <command>ldd</command>, useful for
2146-
determining what object code depends on what libraries, the
2147-
following URLs may help you:
2148-
<ulink url="http://www.faqs.org/faqs/aix-faq/part4/section-22.html"></ulink>,
2149-
<ulink url="http://www.han.de/~jum/aix/ldd.c"></ulink>.
2150-
</para>
2132+
<variablelist>
2133+
<varlistentry>
2134+
<term>AIX 4.3.3</term>
2135+
<listitem><para>Maintenance Level 11 + post ML11 bundle</para></listitem>
2136+
</varlistentry>
2137+
2138+
<varlistentry>
2139+
<term>AIX 5.1</term>
2140+
<listitem><para>Maintenance Level 9 + post ML9 bundle</para></listitem>
2141+
</varlistentry>
2142+
2143+
<varlistentry>
2144+
<term>AIX 5.2</term>
2145+
<listitem><para>Technology Level 10 Service Pack 3</para></listitem>
2146+
</varlistentry>
2147+
2148+
<varlistentry>
2149+
<term>AIX 5.3</term>
2150+
<listitem><para>Technology Level 7</para></listitem>
2151+
</varlistentry>
2152+
2153+
<varlistentry>
2154+
<term>AIX 6.1</term>
2155+
<listitem><para>Base Level</para></listitem>
2156+
</varlistentry>
2157+
</variablelist>
21512158

21522159
<para>
2153-
<xref linkend="AIX-fixlevels"> shows the minimum recommended fix levels
2154-
for various AIX versions. To check your current fix level, use
2160+
To check your current fix level, use
21552161
<command>oslevel -r</command> in AIX 4.3.3 to AIX 5.2 ML 7, or
21562162
<command>oslevel -s</command> in later versions.
21572163
</para>
21582164

2159-
<table id="AIX-fixlevels">
2160-
<title>
2161-
Minimum recommended <systemitem class="osname">AIX</systemitem> fix levels
2162-
</title>
2163-
2164-
<tgroup cols="2">
2165-
<thead>
2166-
<row>
2167-
<entry>AIX version</entry>
2168-
<entry>fix level</entry>
2169-
</row>
2170-
</thead>
2171-
2172-
<tbody>
2173-
<row>
2174-
<entry>AIX 4.3.3</entry>
2175-
<entry>Maintenance Level 11 + post ML11 bundle</entry>
2176-
</row>
2177-
2178-
<row>
2179-
<entry>AIX 5.1</entry>
2180-
<entry>Maintenance Level 9 + post ML9 bundle</entry>
2181-
</row>
2182-
2183-
<row>
2184-
<entry>AIX 5.2</entry>
2185-
<entry>Technology Level 10 Service Pack 3</entry>
2186-
</row>
2187-
2188-
<row>
2189-
<entry>AIX 5.3</entry>
2190-
<entry>Technology Level 7</entry>
2191-
</row>
2192-
2193-
<row>
2194-
<entry>AIX 6.1</entry>
2195-
<entry>Base Level</entry>
2196-
</row>
2197-
</tbody>
2198-
</tgroup>
2199-
</table>
2165+
<para>
2166+
Use the following <command>configure</command> flags in addition
2167+
to your own if you have installed Readline or libz in
2168+
<literal>/usr/local</>:
2169+
<literal>--with-includes=/usr/local/include
2170+
--with-libraries=/usr/local/lib</literal>.
2171+
</para>
22002172

22012173
<sect3>
22022174
<title>GCC issues</title>
@@ -2250,8 +2222,8 @@ kill `cat /usr/local/pgsql/data/postmaster.pid`
22502222
to parse IP addresses in <varname>listen_addresses</>,
22512223
<filename>pg_hba.conf</>, etc. Older versions of AIX have assorted
22522224
bugs in this function. If you have problems related to these settings,
2253-
updating to the appropriate fix level shown in <xref
2254-
linkend="AIX-fixlevels"> should take care of it.
2225+
updating to the appropriate AIX fix level shown above
2226+
should take care of it.
22552227
</para>
22562228

22572229
<!-- http://archives.postgresql.org/message-id/6064jt6cfm.fsf_-_@dba2.int.libertyrms.com -->
@@ -2301,13 +2273,15 @@ hosts=local4,bind4
23012273
</itemizedlist>
23022274
</para>
23032275

2304-
<warning> <para> This is really a workaround of problems relating
2305-
to immaturity of IPv6 support, which improved visibly during the
2306-
course of AIX 5.3 releases. It has worked with AIX version 5.3,
2307-
but does not represent an elegant solution to the problem. It has
2308-
been reported that this workaround is not only unnecessary, but
2309-
causes problems on AIX 6.1, where IPv6 support has become more
2310-
mature. </para>
2276+
<warning>
2277+
<para>
2278+
This is really a workaround for problems relating
2279+
to immaturity of IPv6 support, which improved visibly during the
2280+
course of AIX 5.3 releases. It has worked with AIX version 5.3,
2281+
but does not represent an elegant solution to the problem. It has
2282+
been reported that this workaround is not only unnecessary, but
2283+
causes problems on AIX 6.1, where IPv6 support has become more mature.
2284+
</para>
23112285
</warning>
23122286

23132287
</sect3>

0 commit comments

Comments
 (0)