Subject: Re: Removal of pre-7.4 documentation items

From: Bruce Momjian <[email-masked]>
Date: Wed, 24 Feb 2010 09:53:50 -0500 (EST)

bruce wrote:
> Dave Page wrote:
> > 2010/2/24 Magnus Hagander <[email-masked]>:
> > > 2010/2/24 Devrim G?ND?Z <[email-masked]>:
> > >> On Mon, 2010-02-22 at 19:18 -0500, Bruce Momjian wrote:
> > >>> With us supporting only PG >=8.0,
> > >>
> > >> Really? Since when?
> > >
> > > http://wiki.postgresql.org/wiki/PostgreSQL_Release_Support_Policy
> > >
> > > And we're not likely to release 9.0 before then :(
> > 
> > In that case, it should be >= 8.1.
> 
> I am sure there are some people lagging behind so I kept >=7.4 info.

Also, another reason to keep >= 7.4 is people might be porting old,
unused application code from older releases to current ones.

Here are the appropriate removals for the reference manual pages.

-- 
  Bruce Momjian  <[email-masked]>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com
  PG East:  http://www.enterprisedb.com/community/nav-pg-east-2010.do
  + If your life is a hard drive, Christ can be your backup. +
Index: doc/src/sgml/ref/copy.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v
retrieving revision 1.95
diff -c -c -r1.95 copy.sgml
*** doc/src/sgml/ref/copy.sgml	23 Feb 2010 21:38:35 -0000	1.95
--- doc/src/sgml/ref/copy.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 629,641 ****
      a file trailer.  Headers and data are in network byte order.
     </para>
  
-    <note>
-     <para>
-      <productname>PostgreSQL</productname> releases before 7.4 used a
-      different binary file format.
-     </para>
-    </note>
- 
     <refsect3>
      <title>File Header</title>
  
--- 629,634 ----
Index: doc/src/sgml/ref/create_cast.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/create_cast.sgml,v
retrieving revision 1.32
diff -c -c -r1.32 create_cast.sgml
*** doc/src/sgml/ref/create_cast.sgml	19 Sep 2009 10:23:26 -0000	1.32
--- doc/src/sgml/ref/create_cast.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 324,340 ****
    </para>
  
    <para>
-    Prior to <productname>PostgreSQL</> 7.3, every function that had
-    the same name as a data type, returned that data type, and took one
-    argument of a different type was automatically a cast function.
-    This convention has been abandoned in face of the introduction of
-    schemas and to be able to represent binary-coercible casts in the
-    system catalogs.  The built-in cast functions still follow this naming
-    scheme, but they have to be shown as casts in the system catalog
-    <structname>pg_cast</> as well.
-   </para>
- 
-   <para>
     While not required, it is recommended that you continue to follow this old
     convention of naming cast implementation functions after the target data
     type.  Many users are used to being able to cast data types using a
--- 324,329 ----
Index: doc/src/sgml/ref/create_language.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v
retrieving revision 1.49
diff -c -c -r1.49 create_language.sgml
*** doc/src/sgml/ref/create_language.sgml	23 Feb 2010 22:51:42 -0000	1.49
--- doc/src/sgml/ref/create_language.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 264,278 ****
     the installation.)
    </para>
  
-   <para>
-    In <productname>PostgreSQL</productname> versions before 7.3, it was
-    necessary to declare handler functions as returning the placeholder
-    type <type>opaque</>, rather than <type>language_handler</>.
-    To support loading
-    of old dump files, <command>CREATE LANGUAGE</> will accept a function
-    declared as returning <type>opaque</>, but it will issue a notice and
-    change the function's declared return type to <type>language_handler</>.
-   </para>
   </refsect1>
  
   <refsect1 id="sql-createlanguage-examples">
--- 264,269 ----
Index: doc/src/sgml/ref/create_trigger.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v
retrieving revision 1.52
diff -c -c -r1.52 create_trigger.sgml
*** doc/src/sgml/ref/create_trigger.sgml	20 Nov 2009 20:38:09 -0000	1.52
--- doc/src/sgml/ref/create_trigger.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 272,285 ****
     rows.
    </para>
  
-   <para>
-    In <productname>PostgreSQL</productname> versions before 7.3, it was
-    necessary to declare trigger functions as returning the placeholder
-    type <type>opaque</>, rather than <type>trigger</>.  To support loading
-    of old dump files, <command>CREATE TRIGGER</> will accept a function
-    declared as returning <type>opaque</>, but it will issue a notice and
-    change the function's declared return type to <type>trigger</>.
-   </para>
   </refsect1>
  
   <refsect1 id="SQL-CREATETRIGGER-examples">
--- 272,277 ----
Index: doc/src/sgml/ref/create_type.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v
retrieving revision 1.80
diff -c -c -r1.80 create_type.sgml
*** doc/src/sgml/ref/create_type.sgml	26 Dec 2009 16:55:21 -0000	1.80
--- doc/src/sgml/ref/create_type.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 663,680 ****
     function is written in C.
    </para>
  
-   <para>
-    In <productname>PostgreSQL</productname> versions before 7.3, it
-    was customary to avoid creating a shell type at all, by replacing the
-    functions' forward references to the type name with the placeholder
-    pseudotype <type>opaque</>.  The <type>cstring</> arguments and
-    results also had to be declared as <type>opaque</> before 7.3.  To
-    support loading of old dump files, <command>CREATE TYPE</> will
-    accept I/O functions declared using <type>opaque</>, but it will issue
-    a notice and change the function declarations to use the correct
-    types.
-   </para>
- 
   </refsect1>
  
   <refsect1>
--- 663,668 ----
Index: doc/src/sgml/ref/pg_config-ref.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v
retrieving revision 1.28
diff -c -c -r1.28 pg_config-ref.sgml
*** doc/src/sgml/ref/pg_config-ref.sgml	18 Feb 2008 14:51:48 -0000	1.28
--- doc/src/sgml/ref/pg_config-ref.sgml	24 Feb 2010 14:48:33 -0000
***************
*** 275,289 ****
    <title>Notes</title>
  
    <para>
-    The option <option>--includedir-server</option> was new in
-    <productname>PostgreSQL</> 7.2.  In prior releases, the server include files were
-    installed in the same location as the client headers, which could
-    be queried with the option <option>--includedir</option>.  To make your
-    package handle both cases, try the newer option first and test the
-    exit status to see whether it succeeded.
-   </para>
- 
-   <para>
     The options <option>--docdir</option>, <option>--pkgincludedir</option>,
     <option>--localedir</option>, <option>--mandir</option>,
     <option>--sharedir</option>, <option>--sysconfdir</option>,
--- 275,280 ----
***************
*** 294,304 ****
     The option <option>--htmldir</option> is new in <productname>PostgreSQL</> 8.4.
    </para>
  
-   <para>
-    In releases prior to <productname>PostgreSQL</> 7.1, before
-    <command>pg_config</command> came to be, a method for finding the
-    equivalent configuration information did not exist.
-   </para>
   </refsect1>

--- 285,290 ----
Index: doc/src/sgml/ref/psql-ref.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v
retrieving revision 1.239
diff -c -c -r1.239 psql-ref.sgml
*** doc/src/sgml/ref/psql-ref.sgml	19 Feb 2010 14:36:45 -0000	1.239
--- doc/src/sgml/ref/psql-ref.sgml	24 Feb 2010 14:48:37 -0000
***************
*** 3149,3155 ****
         server is of a newer version than <application>psql</> itself.  However,
         backslash commands of the <literal>\d</> family should work with
         servers of versions back to 7.4, though not necessarily with servers
!        newer than  <application>psql</> itself.
        </para>
        </listitem>
  
--- 3149,3155 ----
         server is of a newer version than <application>psql</> itself.  However,
         backslash commands of the <literal>\d</> family should work with
         servers of versions back to 7.4, though not necessarily with servers
!        newer than <application>psql</> itself.
        </para>
        </listitem>
  
Index: doc/src/sgml/ref/reindex.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v
retrieving revision 1.39
diff -c -c -r1.39 reindex.sgml
*** doc/src/sgml/ref/reindex.sgml	7 Feb 2010 20:48:09 -0000	1.39
--- doc/src/sgml/ref/reindex.sgml	24 Feb 2010 14:48:37 -0000
***************
*** 226,237 ****
     factor.  The old behavior is available as <command>REINDEX SYSTEM</>.
    </para>
  
-   <para>
-    Prior to <productname>PostgreSQL</productname> 7.4, <command>REINDEX
-    TABLE</> did not automatically process TOAST tables, and so those had
-    to be reindexed by separate commands.  This is still possible, but
-    redundant.
-   </para>
   </refsect1>
  
   <refsect1>
--- 226,231 ----