Stamp releases 8.2.4, 8.1.9, 8.0.13, 7.4.17, 7.3.19.

doc/FAQ

@@ -1,7 +1,7 @@
 
                 Frequently Asked Questions (FAQ) for PostgreSQL
                                        
-   Last updated: Tue Feb 6 22:16:17 EST 2007
+   Last updated: Wed Apr 18 23:05:05 EDT 2007
    
    Current maintainer: Bruce Momjian (bruce@momjian.us)
    
@@ -173,7 +173,7 @@
    
   1.6) What is the most recent release?
   
-   The latest release of PostgreSQL is version 8.2.3.
+   The latest release of PostgreSQL is version 8.2.4.
    
    We plan to have a major release every year, with minor releases every
    few months.
@@ -430,20 +430,7 @@
    
   3.6) What is the upgrade process for PostgreSQL?
   
-   The PostgreSQL team makes only bug fixes in minor releases, so, for
+   See http://www.postgresql.org/support/versioning.
-   example, upgrading from 7.4.8 to 7.4.9 does not require a dump and
-   restore; merely stop the database server, install the updated
-   binaries, and restart the server.
-   
-   All users should upgrade to the most recent minor release as soon as
-   it is available. While every upgrade has some risk, PostgreSQL minor
-   releases are designed to fix only common bugs with the least risk. The
-   community considers not upgrading more risky that upgrading.
-   
-   Major releases (e.g. from 7.3 to 7.4) often change the internal format
-   of system tables and data files. These changes are often complex, so
-   we don't maintain backward compatibility for data files. A dump/reload
-   of the database is required for major upgrades.
    
   3.7) What computer hardware should I use?
   
@@ -547,25 +534,25 @@
    As an example, consider a file of 100,000 lines with an integer and
    text description on each line. Suppose the text string avergages
    twenty bytes in length. The flat file would be 2.8 MB. The size of the
-   PostgreSQL database file containing this data can be estimated as 5.6
+   PostgreSQL database file containing this data can be estimated as 5.2
    MB:
-    28 bytes: each row header (approximate)
+    24 bytes: each row header (approximate)
     24 bytes: one int field and one text field
    + 4 bytes: pointer on page to tuple
    ----------------------------------------
-    56 bytes per row
+    52 bytes per row
 
    The data page size in PostgreSQL is 8192 bytes (8 KB), so:
 
    8192 bytes per page
-   -------------------   =  146 rows per database page (rounded down)
+   -------------------   =  158 rows per database page (rounded down)
-     56 bytes per row
+     52 bytes per row
 
    100000 data rows
-   --------------------  =  685 database pages (rounded up)
+   --------------------  =  633 database pages (rounded up)
-      146 rows per page
+      158 rows per page
 
-685 database pages * 8192 bytes per page  =  5,611,520 bytes (5.6 MB)
+633 database pages * 8192 bytes per page  =  5,185,536 bytes (5.2 MB)
 
    Indexes do not require as much overhead, but do contain the data that
    is being indexed, so they can be large also.
@@ -817,7 +804,7 @@
   4.18) How do I return multiple rows or columns from a function?
   
    It is easy using set-returning functions,
-   http://techdocs.postgresql.org/guides/SetReturningFunctions
+   http://www.postgresql.org/docs/techdocs.17
    .
    
   4.19) Why do I get "relation with OID ##### does not exist" errors when

doc/FAQ_AIX

@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
 AIX Specific
 TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
 =======================================================
-Last updated:        $Date: 2007/02/07 03:16:59 $
+Last updated:        $Date: 2007/04/19 03:07:22 $
 
 Topics
 
@@ -16,7 +16,7 @@ Topics
 -----
 
 From: Zeugswetter Andreas <ZeugswetterA@spardat.at>
-$Date: 2007/02/07 03:16:59 $
+$Date: 2007/04/19 03:07:22 $
 
 On AIX 4.3.2 PostgreSQL compiled with the native IBM compiler xlc
 (vac.C 5.0.1) passes all regression tests.  Other versions of OS and

doc/FAQ_DEV

@@ -1,7 +1,7 @@
 
           Developer's Frequently Asked Questions (FAQ) for PostgreSQL
                                        
-   Last updated: Thu Jan 4 16:00:00 EST 2007
+   Last updated: Mon Mar 19 12:52:30 EDT 2007
    
    Current maintainer: Bruce Momjian (bruce@momjian.us)
    
@@ -30,7 +30,8 @@ General Questions
    1.16) Where can I get a copy of the SQL standards?
    1.17) Where can I get technical assistance?
    1.18) How do I get involved in PostgreSQL web site development?
-   1.19) What is the timeline for the next major PostgreSQL release?
+   1.19) Why haven't you replaced CVS with SVN, Git, Monotone, VSS,
+   <insert your favorite SCM system here>?
    
 Technical Questions
 
@@ -77,11 +78,14 @@ General Questions
    Some developers use compilers from other software vendors with mixed
    results.
    
-   Developers who are regularly rebuilding the source often pass the
+   Developers who regularly rebuild the source often pass the
    --enable-depend flag to configure. The result is that when you make a
    modification to a C header file, all files depend upon that file are
    also rebuilt.
    
+   src/Makefile.custom can be used to set environment variables, like
+   CUSTOM_COPT, that are used for every compile.
+   
   1.3) What areas need work?
   
    Outstanding features are detailed in the TODO list. This is located in
@@ -131,20 +135,20 @@ General Questions
        src/tools/make_diff/difforig useful. (Unified diffs are only
        preferable if the file changes are single-line changes and do not
        rely on surrounding lines.)
-    4. PostgreSQL is licensed under a BSD license, so any submissions
+    4. PostgreSQL is licensed under a BSD license. By posting a patch to
-       must conform to the BSD license to be included. If you use code
+       the public PostgreSQL mailling lists, you are giving the
-       that is available under some other license that is BSD compatible
+       PostgreSQL Global Development Group the non-revokable right to
-       (eg. public domain) please note that code in your email submission
+       distribute your patch under the BSD license.
     5. Confirm that your changes can pass the regression tests. If your
        changes are port specific, please list the ports you have tested
        it on.
-    6. Provide an implementation overview, preferably in code comments.
+    6. If you are adding a new feature, confirm that it has been tested
-       Following the surrounding code commenting style is usually a good
+       thoroughly. Try to test the feature in all conceivable scenarios.
-       approach.
     7. New feature patches should also be accompanied by documentation
        patches. If you need help checking the SQL standard, see 1.16.
-    8. If you are adding a new feature, confirm that it has been tested
+    8. Provide an implementation overview, preferably in code comments.
-       thoroughly. Try to test the feature in all conceivable scenarios.
+       Following the surrounding code commenting style is usually a good
+       approach.
     9. If it is a performance patch, please provide confirming test
        results to show the benefit of your patch. It is OK to post
        patches without this information, though the patch will not be
@@ -565,6 +569,22 @@ General Questions
    http://gborg.postgresql.org/project/pgweb/projdisplay.php , the code
    for the next version of the website is under the "portal" module.
    
+  1.19) Why haven't you replaced CVS with SVN, Git, Monotone, VSS, <insert your
+  favorite SCMS here>?
+  
+   Currently the core developers see no SCMS that will provide enough
+   benefit to outwiegh the pain involved in moving to a new SCMS. Typical
+   problems that must be addressed by any new SCMS include:
+     * Run natively on all of our supported platforms.
+     * Integrate into the Buildfarm.
+     * Import our entire CVS Repository while preserving complete
+       history.
+     * Allow for anonymous checkouts.
+       
+   Currently there is no intention for switching to a new SCMS until at
+   least the end of the 8.4 development cycle sometime in late 2008. For
+   more information please refer to the mailing list archives.
+   
 Technical Questions
 
   2.1) How do I efficiently access information in tables from the backend code?
@@ -799,24 +819,3 @@ typedef struct nameData
    pgsql/data directory. The client profile file will be put in the
    client's current directory. Linux requires a compile with
    -DLINUX_PROFILE for proper profiling.
-   
-  2.9) What is the timeline for the next major PostgreSQL release?
-  
-   The development schedule for the 8.3 release is:
-   
-          March 1, 2007
-          
-   Initial community review of all major feature patches
-          April 1, 2007
-          
-   Feature freeze, all patches must be submitted for review and
-          application
-          mid-May, 2007
-          
-   All patches applied, beta testing begins
-          July, 2007
-          
-   Release of 8.3.0
-          
-   Patches that appear after appropriate dates are typically not applied
-   but held for the next major release.

doc/FAQ_HPUX

@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
 HP-UX Specific
 TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
 =======================================================
-last updated:           $Date: 2007/02/07 03:16:59 $
+last updated:           $Date: 2007/04/19 03:07:22 $
 
 current maintainer:     Tom Lane (tgl@sss.pgh.pa.us)
 original author:        Tom Lane (tgl@sss.pgh.pa.us)

doc/FAQ_IRIX

@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
 IRIX Specific
 TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
 =======================================================
-last updated:           $Date: 2007/02/07 03:16:59 $
+last updated:           $Date: 2007/04/19 03:07:22 $
 
 current maintainer:     Luis Amigo (lamigo@atc.unican.es)
 original author:        Luis Amigo (lamigo@atc.unican.es)

doc/FAQ_SCO

@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
 IRIX Specific
 TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
 =======================================================
-last updated:           $Date: 2007/02/07 03:16:59 $
+last updated:           $Date: 2007/04/19 03:07:22 $
 
 current maintainer:     Billy G. Allie (Bill.Allie@mug.org)
 original author:        Andrew Merrill (andrew@compclass.com)

doc/FAQ_Solaris

@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
 Sun Solaris specific
 To be read in conjunction with the installation instructions.
 ============================================================
-Last updated:        $Date: 2007/02/07 03:16:59 $
+Last updated:        $Date: 2007/04/19 03:07:22 $
 
 
 Contents:
@@ -72,14 +72,12 @@ problem.  Solaris 9 and above has a newer version of OpenSSL.
 This is probably a case of the run-time linker being unable to find
 some library, probably libz, libreadline or some other non-standard
 library such as libssl.  To point it to the right location, set the
-LD_LIBRARY_PATH environment variable, e.g.,
+LDFLAGS environment variable, e.g.,
 
-	LD_LIBRARY_PATH=/usr/sfw/lib:/opt/sfw/lib:/usr/local/lib
+	LDFLAGS="-R /usr/sfw/lib:/opt/sfw/lib:/usr/local/lib"
-	export LD_LIBRARY_PATH
+	export LDFLAGS
 
-and restart configure.  You will also have to keep this setting whenever
+and restart configure. See the ld(1) man page for more
-you run any of the installed PostgreSQL programs.   Alternatively, set
-the environment variable LD_RUN_PATH.  See the ld(1) man page for more
 information.
 
 
@@ -145,6 +143,10 @@ recommendations are also useful on other hardware with Solaris.
 Yes, see the chapter "Monitoring Database Activity" in the documentation
 for further information.
 
+You can also find more information here:
+
+	http://blogs.sun.com/robertlor/entry/user_level_dtrace_probes_in
+
 If you see the linking of the postgres executable abort with an error
 message like
 
@@ -157,8 +159,9 @@ message like
 	gmake: *** [postgres] Error 1
 
 your DTrace installation is too old to handle probes in static
-functions.  You need Solaris 10u3 or newer.
+functions.  You need Solaris 10u4 or newer. Workaround is remove static
+keyword from AbortTransaction and CommitTransaction functions declaration in 
+src/backend/access/transam/xact.c.
 
-You can also find more information here:
+See http://sunsolve.sun.com/search/document.do?assetkey=1-1-2139224-1
-
+(registration required).
-	http://blogs.sun.com/robertlor/entry/user_level_dtrace_probes_in

doc/FAQ_german

@@ -356,8 +356,8 @@
     1.13) Wie sende ich einen Fehlerbericht?
     
    Bitte besuchen Sie die PostgreSQL-BugTool-Seite
-   http://www.postgresql.org/bugform.html, die Hinweise und Anleitungen
+   http://www.postgresql.org/support/submitbug, die Hinweise und
-   zur Einreichung von Fehlerberichten enthält.
+   Anleitungen zur Einreichung von Fehlerberichten enthält.
    
    Überprüfe auch den ftp-Server ftp://ftp.postgresql.org/pub/, um
    nachzusehen, ob es eine neuere PostgreSQL-Version oder neue Patches

doc/FAQ_japanese

@@ -1,6 +1,6 @@
 PostgreSQL(ポストグレス・キュー・エル)についてよくある質問とその解答(FAQ)
 
-原文最終更新日: Mon Dec 11 17:45:54 EST 2006
+原文最終更新日: Tue Mar 20 13:43:40 EDT 2007
 
 現在の維持管理者: Bruce Momjian (bruce@momjian.us)
 Maintainer of Japanese Translation: Jun Kuwamura (juk at PostgreSQL.jp)
@@ -37,6 +37,7 @@ Maintainer of Japanese Translation: Jun Kuwamura (juk at PostgreSQL.jp)
 1.11) SQLはどうすれば学べますか？
 1.12) パッチを提供したり、開発チーム参加するにはどうすればよいですか？
 1.13) 他のDBMSと比べてPostgreSQLはどうなのですか？
+1.14) PostgreSQLは国毎の最新の夏時間の変更を扱いますか？
 
                           ユーザ・クライアントの質問
 
@@ -53,8 +54,8 @@ Maintainer of Japanese Translation: Jun Kuwamura (juk at PostgreSQL.jp)
 ？
 3.4) どのようなデバグ機能が使えますか？
 3.5) 接続しようとするときに 'Sorry, too many clients' が出るのはなぜですか？
-3.6) PostgreSQLのアップグレードの手順はどうしますか？
+3.6) PostgreSQLのアップグレードの手順はどうなりますか？
-3.7) ハードウェアにはどんなコンピュータを使えばよいですか？
+3.7) ハードウェアにはどのようなコンピュータを使えばよいですか？
 
                                  操作上の質問
 
@@ -168,7 +169,7 @@ SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 
         POSTGRESQL データベース管理システム
 
-        部分的著作権 (c) 1996-2006, PostgreSQL国際開発チーム
+        部分的著作権 (c) 1996-2007, PostgreSQL国際開発チーム
         部分的著作権 (c) 1994-1996 カリフォルニア大学本校
 
 
@@ -227,7 +228,7 @@ ftp://ftp.PostgreSQL.org/pub/
 
 1.6) 最新のリリースはどれですか？
 
-PostgreSQL の最新版はバージョン 8.2.0 です。
+PostgreSQL の最新版はバージョン 8.2.3 です。
 
 我々は、1年毎にメジャーリリースを、数ヵ月ごとのマイナーリリースを行なうことを計
 画しています。
@@ -426,6 +427,14 @@ http://www.postgresql.jp/PostgreSQL/references.html
     スタイルの使用許諾に外れない限り、PostgreSQLのコードを制限無しで商品に組み
     込むことができます。
 
+1.14) PostgreSQLは国毎の最新の夏時間の変更を扱いますか？
+
+合州国の夏時間の変更は、PostgreSQLのリリース8.0.4以降[4+]と、その後のメジャーリ
+リース、たとえば 8.1 には含まれています。カナダとオー西部ストラリアの変更は、
+8.0.[10+], 8.1.[6+] および、その後のメジャーリリースのすべてに含まれます。8.0よ
+り前のPosrgreSQLではオペレーティングシステムのタイムゾーンデータベースを夏時間
+情報のために使っています。
+
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
                           ユーザ・クライアントの質問
@@ -535,25 +544,34 @@ postmaster
 postgresql.conf の中の max_connections の値を変更して postmasterを再起動するこ
 とで可能になります。
 
-3.6) PostgreSQLのアップグレードの手順はどうしますか？
+3.6) PostgreSQLのアップグレードの手順はどうなりますか？
 
-PostgreSQLチームはマイナーリリースではバグの修正しか行ないませんので、たとえば
+バージョン番号付けの方針については、http://www.postgresql.org/support/
-7.4.8 から 7.4.9 へのアップグレードにダンプとリストアは必要ありません。したがっ
+versioning をご覧ください。
-て、データベースサーバを一時的に停止して、アップデートしたバイナリをインストー
-ルし、そして、サーバをリスタートするだけです。
 
-全ユーザはできるだけ早く最新のマイナーリリースにアップグレードするべきです。す
+新しい機能を盛り込むPostgreSQLのメジャーリリースはだいたい年に1回程度行ないます
-べてのアップグレードにリスクはつきものですが、 PostgreSQLのマイナーリリースは、
+。メジャーリリースは、たとえば、8.1から8.2へのように、バージョン番号の1番目か2
-なるべく小さなリスクで一般的なバグの修正だけを目論んだものです。我々コミュニテ
+番目の部分を増やしてゆきます。
-ィの中ではアップグレードしないほうがもっとリスクが高いものと考えられています。
 
-しかし、メジャーリリース（たとえば、7.3 から 7.4 のような）では、システムテーブ
+PostgreSQLのメジャーリリースは通常、システムテーブルとデータの内部フォーマット
-ルやデータファイルの内部フォーマットの変更をしばしば行ないます。これらの変更は
+を変更します。これらの変更はたいていは複雑なのでで、データファイルの後方互換性
-たいてい複雑で、そのため我々はデータファイルのための後方互換性を維持することが
+を維持したりはしません。メジャーアップグレードのためには、データベースのダンプ/
-できません。メジャーアップグレードのためには、データベースのダンプ/リロードが必
+リロードが必要になります。
-要です。
 
-3.7) ハードウェアにはどんなコンピュータを使えばよいですか？
+マイナーリリースは、たとえば、8.1.5 から8.1.6へのように、バージョン番号の3番目
+の値を増やします。PostgreSQLチームは、マイナーリリースに対しては、バグフィクス
+しか行ないません。すべてのユーザは、できるだけ最新のマイナーリリースに更新すべ
+きです。アップグレードには、常にリスクがつきものですから、PostgreSQLのマイナー
+修正リリースでは、頻繁に発生したり、セキュリティに関係したり、データがつぶれる
+バグだけを修正し、アップグレードのリスクを最小限にとどめます。我々のコミュニテ
+ィでは、アップグレードするリスクよりも、アップグレードしないリスクのほうが高い
+と考えています。
+
+マイナーリリースのアップグレードにはダンプとリストアの必要はなく、データベース
+サーバを停止して、アップデートされたバイナリをインストールし、サーバをリスター
+トします。
+
+3.7) ハードウェアにはどのようなコンピュータを使えばよいですか？
 
 PCハードウェアはほとんど互換性がありますので、ほとんどの人は、すべてのPCハード
 ウェアが同じ品質だと思い込む傾向があります。しかし、それは間違いです。ECC RAM、
@@ -656,25 +674,25 @@ VACUUM FULL tab
 例題として、各行に整数とテキスト記述を持つ 100,000行のファイルを考えてみましょ
 う。テキストの文字列の平均長さを20バイトと仮定すると、フラットファイルの大きさ
 は約2.8MB です。このデータを含む PostgreSQL データベースファイルの大きさは次の
-ように約5.6MBと見積もることができます：
+ように約5.2MBと見積もることができます：
 
-    28 bytes: 各ロウのヘッダ(概算)
+    24 bytes: 各ロウのヘッダ(概算)
     24 bytes: 整数(int)フィールドとテキスト(text)フィールド
    + 4 bytes: ページ上のタップルへのポインタ
    ----------------------------------------
-    56 bytes per row
+    52 bytes per row
 
    PostgreSQL のデータページサイズは 8192バイト(8KB)なので:
 
    8192 bytes per page
    -------------------   =  146 rows per database page (切り捨て)
-     56 bytes per row
+     52 bytes per row
 
    100000 data rows
-   --------------------  =  685 database pages (切り上げ)
+   --------------------  =  633 database pages (切り上げ)
-      146 rows per page
+      158 rows per page
 
-  685 database pages * 8192 bytes per page  =  5,611,520 bytes (5.6 MB)
+  633 database pages * 8192 bytes per page  =  5,185,536 bytes (5.2 MB)
 
 インデックスは、これほどのオーバヘッドは要求しませんが、インデックス付けされる
 データを含む以上、それなりに大きくなります。
@@ -939,8 +957,10 @@ contrib/dblink
 
 4.18) 関数から複数のロウまたはカラムを返すにはどうしますか？
 
-集合を返す関数(Set Returning Functions): http://techdocs.postgresql.org/guides/
+集合を返す関数(Set Returning Functions): http://www.postgresql.org/docs/
-SetReturningFunctions を使うと簡単です
+techdocs.17
+
+を使うと簡単です
 
 。
 
@@ -1017,7 +1037,7 @@ client_encoding
 [訳注：
   日本語版の製作については以下の通りです。
 
-  最終更新日:   2006年12月25日
+  最終更新日:   2007年03月25日
   翻訳者:       桑村 潤 (Jun Kuwamura <juk at PostgreSQL.jp>)
 
   このFAQの和訳の作成にあたり協力をしてくださった方々(敬称は略させていただきます):

doc/bug.template

@@ -31,7 +31,7 @@ System Configuration:
 
   Operating System (example: Linux 2.4.18)	:
 
-  PostgreSQL version (example: PostgreSQL 8.2.3):  PostgreSQL 8.2.3
+  PostgreSQL version (example: PostgreSQL 8.2.4):  PostgreSQL 8.2.4
 
   Compiler used (example: gcc 3.3.5)		:
 

doc/src/FAQ/FAQ.html

@@ -10,7 +10,7 @@
   alink="#0000ff">
     <H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
 
-    <P>Last updated: Tue Feb  6 22:16:17 EST 2007</P>
+    <P>Last updated: Wed Apr 18 23:05:05 EDT 2007</P>
 
     <P>Current maintainer: Bruce Momjian (<A href=
     "mailto:bruce@momjian.us">bruce@momjian.us</A>)
@@ -221,7 +221,7 @@
 
     <H3 id="item1.6">1.6) What is the most recent release?</H3>
 
-    <P>The latest release of PostgreSQL is version 8.2.3.</P>
+    <P>The latest release of PostgreSQL is version 8.2.4.</P>
 
     <P>We plan to have a major release every year, with minor releases
     every few months.</P>
@@ -584,21 +584,9 @@
 
     <H3 id="item3.6">3.6) What is the upgrade process for PostgreSQL?</H3>
 
-    <P>The PostgreSQL team makes only bug fixes in minor releases,
+    <P>See <a
-    so, for example, upgrading from 7.4.8 to 7.4.9 does not require
+    href="http://www.postgresql.org/support/versioning">http://www.postgresql.org/support/versioning</a>.
-    a dump and restore;  merely stop the database server, install
+    </P>
-    the updated binaries, and restart the server.</P>
-
-    <P>All users should upgrade to the most recent minor release as
-    soon as it is available.  While every upgrade has some risk,
-    PostgreSQL minor releases are designed to fix only common bugs
-    with the least risk.  The community considers <i>not</i> upgrading
-    more risky that upgrading.</P>
-
-    <P>Major releases (e.g. from 7.3 to 7.4) often change the internal
-    format of system tables and data files. These changes are often complex,
-    so we don't maintain backward compatibility for data files. A dump/reload
-    of the database is required for major upgrades.</P>
 
     <H3 id="item3.7">3.7) What computer hardware should I use?</H3>
 
@@ -720,25 +708,25 @@ table?</TD><TD>unlimited</TD></TR>
     and text description on each line. Suppose the text string
     avergages twenty bytes in length. The flat file would be 2.8 MB.
     The size of the PostgreSQL database file containing this data can
-    be estimated as 5.6 MB:</P>
+    be estimated as 5.2 MB:</P>
 <PRE>
-    28 bytes: each row header (approximate)
+    24 bytes: each row header (approximate)
     24 bytes: one int field and one text field
    + 4 bytes: pointer on page to tuple
    ----------------------------------------
-    56 bytes per row
+    52 bytes per row
 
    The data page size in PostgreSQL is 8192 bytes (8 KB), so:
 
    8192 bytes per page
-   -------------------   =  146 rows per database page (rounded down)
+   -------------------   =  158 rows per database page (rounded down)
-     56 bytes per row
+     52 bytes per row
 
    100000 data rows
-   --------------------  =  685 database pages (rounded up)
+   --------------------  =  633 database pages (rounded up)
-      146 rows per page
+      158 rows per page
 
-685 database pages * 8192 bytes per page  =  5,611,520 bytes (5.6 MB)
+633 database pages * 8192 bytes per page  =  5,185,536 bytes (5.2 MB)
 </PRE>
 
     <P>Indexes do not require as much overhead, but do contain the data
@@ -1069,8 +1057,8 @@ length</TD></TR>
     columns from a function?</H3>
 
     <P>It is easy using set-returning functions, 
-    <a href="http://techdocs.postgresql.org/guides/SetReturningFunctions">
+    <a href="http://www.postgresql.org/docs/techdocs.17">
-    http://techdocs.postgresql.org/guides/SetReturningFunctions</a></P>.
+    http://www.postgresql.org/docs/techdocs.17</a></P>.
 
     <H3 id="item4.19">4.19) Why do I get "relation with OID #####
     does not exist" errors when accessing temporary tables in PL/PgSQL

doc/src/FAQ/FAQ_DEV.html

@@ -13,7 +13,7 @@
     <H1>Developer's Frequently Asked Questions (FAQ) for
     PostgreSQL</H1>
 
-    <P>Last updated: Thu Jan  4 16:00:00 EST 2007</P>
+    <P>Last updated: Mon Mar 19 12:52:30 EDT 2007</P>
 
     <P>Current maintainer: Bruce Momjian (<A href=
     "mailto:bruce@momjian.us">bruce@momjian.us</A>)<BR>
@@ -55,8 +55,8 @@
     assistance?<BR>
      <A href="#item1.18">1.18</A>) How do I get involved in PostgreSQL web
     site development?<BR>
-     <A href="#item1.19">1.19</A>) What is the timeline for the next major
+     <A href="#item1.19">1.19</A>) Why haven't you replaced CVS with SVN, Git,
-    PostgreSQL release?<BR>
+    Monotone, VSS, &lt;insert your favorite SCM system here&gt;?
 
 
       <H2>Technical Questions</H2>
@@ -120,10 +120,13 @@
     <P>Some developers use compilers from other software vendors with
     mixed results.</P>
 
-    <P>Developers who are regularly rebuilding the source often pass
+    <P>Developers who regularly rebuild the source often pass the
-    the --enable-depend flag to <I>configure</I>. The result is that
+    --enable-depend flag to <I>configure</I>. The result is that when you
-    when you make a modification to a C header file, all files depend
+    make a modification to a C header file, all files depend upon that
-    upon that file are also rebuilt.</P>
+    file are also rebuilt.</P>
+
+    <P><I>src/Makefile.custom</I> can be used to set environment variables,
+    like <I>CUSTOM_COPT</I>, that are used for every compile.
 
     <H3 id="item1.3">1.3) What areas need work?</H3>
     Outstanding features are detailed in the TODO list. This is located
@@ -185,26 +188,26 @@
     preferable if the file changes are single-line changes and do not
     rely on surrounding lines.)</li>
 
-    <li>PostgreSQL is licensed under a BSD license, so any submissions must 
+    <li>PostgreSQL is licensed under a BSD license.  By posting a patch
-    conform to the BSD license to be included. If you use code that is 
+    to the public PostgreSQL mailling lists, you are giving the PostgreSQL
-    available under some other license that is BSD compatible (eg. public 
+    Global Development Group the non-revokable right to distribute your
-    domain) please note that code in your email submission</li>
+    patch under the BSD license.</li>
 
     <li>Confirm that your changes can pass the regression tests. If your 
     changes are port specific, please list the ports you have tested it
     on.</li>
 
-    <li>Provide an implementation overview, preferably in code comments.
+    <li>If you are adding a new feature, confirm that it has been tested
-    Following the surrounding code commenting style is usually a good
+    thoroughly.  Try to test the feature in all conceivable
-    approach.</li>
+    scenarios.</li>
 
     <li>New feature patches should also be accompanied by documentation
     patches.  If you need help checking the SQL standard, see <a href=
     "#item1.16">1.16</a>.</li>
 
-    <li>If you are adding a new feature, confirm that it has been tested
+    <li>Provide an implementation overview, preferably in code comments.
-    thoroughly.  Try to test the feature in all conceivable
+    Following the surrounding code commenting style is usually a good
-    scenarios.</li>
+    approach.</li>
 
     <li>If it is a performance patch, please provide confirming test
     results to show the benefit of your patch. It is OK to post patches
@@ -705,7 +708,26 @@
     the source code is available at <A href=
     "http://gborg.postgresql.org/project/pgweb/projdisplay.php">http://gborg.postgresql.org/project/pgweb/projdisplay.php</A>
     , the code for the next version of the website is under the
-    "portal" module. 
+    "portal" module.</P> 
+
+    <H3 id="item1.19">1.19) Why haven't you replaced CVS with SVN, Git,
+    Monotone, VSS, &lt;insert your favorite SCMS here&gt;?</H3>
+
+    <P>Currently the core developers see no SCMS that will provide 
+    enough benefit to outwiegh the pain involved in moving to a new
+    SCMS. Typical problems that must be addressed by any new SCMS include:</P>
+
+    <ul>
+    <li>Run natively on all of our <a href="http://www.postgresql.org/docs/current/interactive/supported-platforms.html">supported platforms</a>.</li>
+    <li>Integrate into the <a href="http://pgbuildfarm.org/">Buildfarm</a>.</li>
+    <li>Import our entire CVS Repository while preserving complete history.</li>
+    <li>Allow for anonymous checkouts.</li>
+    </ul>
+
+    <P>Currently there is no intention for switching to a new SCMS until at least the
+    end of the 8.4 development cycle sometime in late 2008. For more information
+    please refer to the mailing list archives.</P>
+     
 
       <H2>Technical Questions</H2>
 
@@ -995,24 +1017,6 @@
     requires a compile with <I>-DLINUX_PROFILE</I> for proper
     profiling.</P>
 
-    <H3 id="item2.9">2.9) What is the timeline for the next major
-    PostgreSQL release?<BR>
-
-    <P>The development schedule for the 8.3 release is:</P>
-    <DL>
-    <DD>March 1, 2007</DD>
-    <DT>Initial community review of all major feature patches</DT>
-    <DD>April 1, 2007</DD>
-    <DT>Feature freeze, all patches must be submitted for review and application</DT>
-    <DD>mid-May, 2007</DD>
-    <DT>All patches applied, beta testing begins</DT>
-    <DD>July, 2007</DD>
-    <DT>Release of 8.3.0</DT>
-    </DL>
-
-    <P>Patches that appear after appropriate dates are typically
-    not applied but held for the next major release.</P>
-
   </BODY>
 </HTML>
 

doc/src/FAQ/FAQ_MINGW.html

@@ -9,24 +9,24 @@
 <h1 style="text-align: center;">Compiling PostgreSQL On Native Win32 FAQ<br>
 </h1>
 <P>Last updated: Thu Oct 14 18:22:57 EDT 2004</P>
-<P>Current maintainer: Bruce Momjian (<A href=
+<P>Current maintainer: Bruce Momjian &lt;<A href=
-"mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR>
+"mailto:bruce@momjian.us">bruce@momjian.us</A>&gt;<BR>
 </P>
 
 <P>The most recent version of this document can be viewed at <A href=
 "http://www.postgresql.org/docs/faqs.FAQ_MINGW.html">
 http://www.postgresql.org/docs/faqs.FAQ_MINGW.html</A>.</P>
 
-<P>The FAQ for running PostgreSQL on native Win32 is at <A href=
+<P>The FAQ Running & Installing PostgreSQL On Native Windows is at <A href=
-"http://pginstaller.projects.postgresql.org/FAQ_windows.html">
+"http://pginstaller.projects.postgresql.org/faq/FAQ_windows.html">
-http://pginstaller.projects.postgresql.org/FAQ_windows.html</A>.</P>
+http://pginstaller.projects.postgresql.org/faq/FAQ_windows.html</A>.</P>
 
 <p>The native Win32 port is built from source using MinGW tools.&nbsp;
 There is also a precompiled binary installer called <span
  style="font-style: italic;">pginstaller</span> which you can find at
 from <a href="http://pgfoundry.org/projects/pginstaller">http://pgfoundry.org/projects/pginstaller</a>.&nbsp;
 It is a fully native build and uses no additional software like MinGW.
-The ready-made instlaler files are available on the main PostgreSQL ftp servers
+The ready-made installer files are available on the main PostgreSQL ftp servers
 in the binary/win32 directory.
 <br>
 </p>

doc/src/FAQ/FAQ_german.html

@@ -340,7 +340,7 @@ href="mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</a>).</p>
 
     <h4><a name="1.13">1.13</a>) Wie sende ich einen Fehlerbericht?</h4>
 
-    <p>Bitte besuchen Sie die PostgreSQL-BugTool-Seite <a href="http://www.postgresql.org/bugform.html">http://www.postgresql.org/bugform.html</a>,
+    <p>Bitte besuchen Sie die PostgreSQL-BugTool-Seite <a href="http://www.postgresql.org/support/submitbug">http://www.postgresql.org/support/submitbug</a>,
     die Hinweise und Anleitungen zur Einreichung von Fehlerberichten enthält.</p>
 
     <p>Überprüfe auch den ftp-Server <a href="ftp://ftp.postgresql.org/pub/">ftp://ftp.postgresql.org/pub/</a>,

doc/src/FAQ/FAQ_japanese.html

@@ -4,12 +4,12 @@
 <TITLE>PostgreSQL FAQ in Japanese</TITLE>
 </HEAD>
 <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#FF0000" VLINK="#A00000" ALINK="#0000FF">
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=x-euc-jp">
+<META http-equiv="Content-Type" content="text/html; charset=EUC-JP">
 
 <div id="pgContentWrap">
 
 <h1>PostgreSQL(ポストグレス・キュー・エル)についてよくある質問とその解答(FAQ)</h1>
-<p>原文最終更新日:		Mon Dec 11 17:45:54 EST 2006</p>
+<p>原文最終更新日:		Tue Mar 20 13:43:40 EDT 2007</p>
 <p>現在の維持管理者:	Bruce Momjian (<A
 href="mailto:bruce@momjian.us">bruce@momjian.us</a>)<br />
 Maintainer of Japanese Translation:	Jun Kuwamura (<A
@@ -53,7 +53,7 @@ href="mailto:juk at PostgreSQL.jp">juk at PostgreSQL.jp</a>)<br /></p>
 <a href="#item1.11">1.11</a>) <small>SQL</small>はどうすれば学べますか？<br />
 <a href="#item1.12">1.12</a>) パッチを提供したり、開発チーム参加するにはどうすればよいですか？<br />
 <a href="#item1.13">1.13</a>) 他の<small>DBMS</small>と比べてPostgreSQLはどうなのですか？<br />
-
+<a href="#item1.14">1.14</a>) PostgreSQLは国毎の最新の夏時間の変更を扱いますか？<br />
 
 <h2 align="center">ユーザ・クライアントの質問</h2>
 
@@ -69,14 +69,14 @@ href="mailto:juk at PostgreSQL.jp">juk at PostgreSQL.jp</a>)<br /></p>
 <a href="#item3.3">3.3</a>) より良い性能を得るためには、データベース・エンジンをどのように調整しますか？<br />
 <a href="#item3.4">3.4</a>) どのようなデバグ機能が使えますか？<br />
 <a href="#item3.5">3.5</a>) 接続しようとするときに <i>'Sorry, too many clients'</i> が出るのはなぜですか？<br />
-<a href="#item3.6">3.6</a>) PostgreSQLのアップグレードの手順はどうしますか？<br />
+<a href="#item3.6">3.6</a>) PostgreSQLのアップグレードの手順はどうなりますか？<br />
-<a href="#item3.7">3.7</a>) ハードウェアにはどんなコンピュータを使えばよいですか？<br />
+<a href="#item3.7">3.7</a>) ハードウェアにはどのようなコンピュータを使えばよいですか？<br />
 
 
 <h2 align="center">操作上の質問</h2>
 
 <a href="#item4.1">4.1</a>) 最初のいくつかのロウのみを <small>select</small> するにはどうしますか？ ランダムなロウ？ <br />
-<a href="#item4.7">4.2</a>) 定義されたテーブル、インデックス、データベース、および、ユーザをどのようにして見つけ出しますか？<br />
+<a href="#item4.2">4.2</a>) 定義されたテーブル、インデックス、データベース、および、ユーザをどのようにして見つけ出しますか？<br />
 <a href="#item4.3">4.3</a>) カラムのデータタイプを変更するにはどうしますか？<br />
 <a href="#item4.4">4.4</a>) ロウ、テーブル、データベースの最大サイズは？<br />
 <a href="#item4.5">4.5</a>) 一般的なテキストファイルのデータを保存するには、データベースのディスク容量はどのくらい必要ですか？<br />
@@ -192,7 +192,7 @@ href="mailto:juk at PostgreSQL.jp">juk at PostgreSQL.jp</a>)<br /></p>
     <small><pre>
 	POSTGRESQL データベース管理システム
 
-	部分的著作権 (c) 1996-2006, PostgreSQL国際開発チーム
+	部分的著作権 (c) 1996-2007, PostgreSQL国際開発チーム
 	部分的著作権 (c) 1994-1996 カリフォルニア大学本校
 
 
@@ -261,7 +261,7 @@ href="mailto:juk at PostgreSQL.jp">juk at PostgreSQL.jp</a>)<br /></p>
 
 <h4 id="item1.6">1.6</a>) 最新のリリースはどれですか？</h4>
 
-    <p>PostgreSQL の最新版はバージョン 8.2.0 です。</p>
+    <p>PostgreSQL の最新版はバージョン 8.2.3 です。</p>
     <p>我々は、1年毎にメジャーリリースを、数ヵ月ごとのマイナーリリースを
     行なうことを計画しています。</p>
 
@@ -547,6 +547,15 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
    </dl>
    </p>
 
+<h3 id="item1.14">1.14) PostgreSQLは国毎の最新の夏時間の変更を扱いますか？</h3>
+
+   <p>合州国の夏時間の変更は、PostgreSQLのリリース8.0.4以降[4+]と、その
+      後のメジャーリリース、たとえば 8.1 には含まれています。カナダとオー
+      西部ストラリアの変更は、8.0.[10+], 8.1.[6+] および、その後のメジャー
+      リリースのすべてに含まれます。8.0より前のPosrgreSQLではオペレーティ
+      ングシステムのタイムゾーンデータベースを夏時間情報のために使ってい
+      ます。</p>
+
 <hr />
 
 <h2 align="center">ユーザ・クライアントの質問</h2>
@@ -683,6 +692,7 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
     <p>サーバ構成変数には多くの <code>log_*</code> があり、クエリとプロ
     セスの統計を出力することができ、デバグと性能計測にとても便利です。</p>
 
+
 <h4 id="item3.5">3.5</a>) 接続しようとするときに <i>'Sorry, too many clients'</i> が出るのはなぜですか？</h4>
 
     <p> 既定での制限である 100 のデータベースセッションに達してしまって
@@ -691,27 +701,39 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
     <i>max_connections</i> の値を変更して <i>postmaster</i>を再起動する
     ことで可能になります。</p>
 
-<h4 id="item3.6">3.6</a>)  PostgreSQLのアップグレードの手順はどうしますか？</h4>
 
-    <p>PostgreSQLチームはマイナーリリースではバグの修正しか行ないません
+<h4 id="item3.6">3.6</a>)  PostgreSQLのアップグレードの手順はどうなりますか？</h4>
-    ので、たとえば 7.4.8 から 7.4.9 へのアップグレードにダンプとリスト
-    アは必要ありません。したがって、データベースサーバを一時的に停止して、
-    アップデートしたバイナリをインストールし、そして、サーバをリスタート
-    するだけです。</p>
 
-    <p>全ユーザはできるだけ早く最新のマイナーリリースにアップグレードす
+    <p>バージョン番号付けの方針については、<a
-    るべきです。すべてのアップグレードにリスクはつきものですが、
+    href="http://www.postgresql.org/support/versioning">http://www.postgresql.org/support/versioning</a>
-    PostgreSQLのマイナーリリースは、なるべく小さなリスクで一般的なバグの
+    をご覧ください。
-    修正だけを目論んだものです。我々コミュニティの中ではアップグレード
+    </p>
-    <i>しない</i>ほうがもっとリスクが高いものと考えられています。</p>
 
-    <p>しかし、メジャーリリース（たとえば、7.3 から 7.4 のような）では、
+    <p>新しい機能を盛り込むPostgreSQLのメジャーリリースはだいたい年に1回
-    システムテーブルやデータファイルの内部フォーマットの変更をしばしば行
+    程度行ないます。メジャーリリースは、たとえば、8.1から8.2へのように、
-    ないます。これらの変更はたいてい複雑で、そのため我々はデータファイル
+    バージョン番号の1番目か2番目の部分を増やしてゆきます。</p>
-    のための後方互換性を維持することができません。メジャーアップグレード
-    のためには、データベースのダンプ/リロードが必要です。</p>
 
-<h4 id="item3.7">3.7</a>) ハードウェアにはどんなコンピュータを使えばよいですか？</h4>
+    <p>PostgreSQLのメジャーリリースは通常、システムテーブルとデータの内
+    部フォーマットを変更します。これらの変更はたいていは複雑なのでで、デー
+    タファイルの後方互換性を維持したりはしません。メジャーアップグレード
+    のためには、データベースのダンプ/リロードが必要になります。</p>
+
+    <p>マイナーリリースは、たとえば、8.1.5 から8.1.6へのように、バージョ
+    ン番号の3番目の値を増やします。PostgreSQLチームは、マイナーリリース
+    に対しては、バグフィクスしか行ないません。すべてのユーザは、できるだ
+    け最新のマイナーリリースに更新すべきです。アップグレードには、常にリ
+    スクがつきものですから、PostgreSQLのマイナー修正リリースでは、頻繁に
+    発生したり、セキュリティに関係したり、データがつぶれるバグだけを修正
+    し、アップグレードのリスクを最小限にとどめます。我々のコミュニティで
+    は、アップグレードするリスクよりも、アップグレード<i>しないリスク</i>
+    のほうが高いと考えています。</p>
+
+    <p>マイナーリリースのアップグレードにはダンプとリストアの必要はなく、
+    データベースサーバを停止して、アップデートされたバイナリをインストー
+    ルし、サーバをリスタートします。</p>
+
+
+<h4 id="item3.7">3.7</a>) ハードウェアにはどのようなコンピュータを使えばよいですか？</h4>
 
     <p>PCハードウェアはほとんど互換性がありますので、ほとんどの人は、す
     べてのPCハードウェアが同じ品質だと思い込む傾向があります。しかし、そ
@@ -724,6 +746,7 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
 
 <hr />
 
+
 <h2 align="center">操作上の質問</h2>
 
 <h4 id="item4.1">4.1</a>) 最初の数ロウのみを <small>SELECT</small>するにはどうしますか？ランダムなロウ？
@@ -828,27 +851,27 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
     <p> 例題として、各行に整数とテキスト記述を持つ 100,000行のファイルを
     考えてみましょう。テキストの文字列の平均長さを20バイトと仮定すると、
     フラットファイルの大きさは約2.8MB です。このデータを含む PostgreSQL
-    データベースファイルの大きさは次のように約5.6MBと見積もることができ
+    データベースファイルの大きさは次のように約5.2MBと見積もることができ
     ます： 
 
 <pre>
-    28 bytes: 各ロウのヘッダ(概算)
+    24 bytes: 各ロウのヘッダ(概算)
     24 bytes: 整数(int)フィールドとテキスト(text)フィールド
    + 4 bytes: ページ上のタップルへのポインタ
    ----------------------------------------
-    56 bytes per row
+    52 bytes per row
 
    PostgreSQL のデータページサイズは 8192バイト(8KB)なので:
 
    8192 bytes per page
    -------------------   =  146 rows per database page (切り捨て)
-     56 bytes per row
+     52 bytes per row
 
    100000 data rows
-   --------------------  =  685 database pages (切り上げ)
+   --------------------  =  633 database pages (切り上げ)
-      146 rows per page
+      158 rows per page
  
-  685 database pages * 8192 bytes per page  =  5,611,520 bytes (5.6 MB)
+  633 database pages * 8192 bytes per page  =  5,185,536 bytes (5.2 MB)
 </pre>
 
     <p>インデックスは、これほどのオーバヘッドは要求しませんが、インデッ
@@ -1175,8 +1198,8 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
 <h4 id="item4.18">4.18</a>) 関数から複数のロウまたはカラムを返すにはどうしますか？</h4>
 
     <p>集合を返す関数(Set Returning Functions):
-    <a href="http://techdocs.postgresql.org/guides/SetReturningFunctions">
+    <a href="http://www.postgresql.org/docs/techdocs.17">
-    http://techdocs.postgresql.org/guides/SetReturningFunctions</a>
+    http://www.postgresql.org/docs/techdocs.17</a></p>
     を使うと簡単です</p>。
 
 
@@ -1266,7 +1289,7 @@ http://www.postgresql.jp/PostgreSQL/references.html</a>
 [訳注：
   日本語版の製作については以下の通りです。
 
-  最終更新日:	2006年12月25日
+  最終更新日:	2007年03月25日
   翻訳者:	桑村 潤 (<a href="mailto:juk at PostgreSQL.jp">Jun Kuwamura &lt;juk at PostgreSQL.jp&gt;</a>)
 
   このFAQの和訳の作成にあたり協力をしてくださった方々(敬称は略させていただきます):

src/include/pg_config.h.win32

@@ -571,13 +571,13 @@
 #define PACKAGE_STRING "PostgreSQL 8.2.3"
 
 /* Define to the version of this package. */
-#define PACKAGE_VERSION "8.2.3"
+#define PACKAGE_VERSION "8.2.4"
 
 /* PostgreSQL version as a string */
-#define PG_VERSION "8.2.3"
+#define PG_VERSION "8.2.4"
 
 /* PostgreSQL version as a number */
-#define PG_VERSION_NUM 80203
+#define PG_VERSION_NUM 80204
 
 /* Define to the one symbol short name of this package. */
 #define PACKAGE_TARNAME "postgresql"

src/interfaces/libpq/libpq.rc.in

@@ -1,8 +1,8 @@
 #include <winver.h>
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 8,2,3,0
+ FILEVERSION 8,2,4,0
- PRODUCTVERSION 8,2,3,0
+ PRODUCTVERSION 8,2,4,0
  FILEFLAGSMASK 0x3fL
  FILEFLAGS 0
  FILEOS VOS__WINDOWS32
@@ -15,13 +15,13 @@ BEGIN
         BEGIN
             VALUE "CompanyName", "\0"
             VALUE "FileDescription", "PostgreSQL Access Library\0"
-            VALUE "FileVersion", "8.2.3\0"
+            VALUE "FileVersion", "8.2.4\0"
             VALUE "InternalName", "libpq\0"
             VALUE "LegalCopyright", "Copyright (C) 2005\0"
             VALUE "LegalTrademarks", "\0"
             VALUE "OriginalFilename", "libpq.dll\0"
             VALUE "ProductName", "PostgreSQL\0"
-            VALUE "ProductVersion", "8.2.3\0"
+            VALUE "ProductVersion", "8.2.4\0"
         END
     END
     BLOCK "VarFileInfo"

src/port/win32ver.rc

@@ -2,8 +2,8 @@
 #include "pg_config.h"
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION    8,2,3,0
+ FILEVERSION    8,2,4,0
- PRODUCTVERSION 8,2,3,0
+ PRODUCTVERSION 8,2,4,0
  FILEFLAGSMASK  0x17L
  FILEFLAGS      0x0L
  FILEOS         VOS_NT_WINDOWS32