pgsql: Cause initdb to create a third standard database "postgres",

[tgl(at)svr1(dot)postgresql(dot)org (Tom Lane)]

Log Message:
-----------
Cause initdb to create a third standard database "postgres", which
unlike template0 and template1 does not have any special status in
terms of backend functionality.  However, all external utilities such
as createuser and createdb now connect to "postgres" instead of
template1, and the documentation is changed to encourage people to use
"postgres" instead of template1 as a play area.  This should fix some
longstanding gotchas involving unexpected propagation of database
objects by createdb (when you used template1 without understanding
the implications), as well as ameliorating the problem that CREATE
DATABASE is unhappy if anyone else is connected to template1.
Patch by Dave Page, minor editing by Tom Lane.  All per recent
pghackers discussions.

Modified Files:
--------------
    pgsql/contrib/dblink/doc:
        connection (r1.2 -> r1.3)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/dblink/doc/connection.diff?r1=1.2&r2=1.3)
        cursor (r1.3 -> r1.4)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/dblink/doc/cursor.diff?r1=1.3&r2=1.4)
        misc (r1.1 -> r1.2)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/dblink/doc/misc.diff?r1=1.1&r2=1.2)
        query (r1.3 -> r1.4)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/dblink/doc/query.diff?r1=1.3&r2=1.4)
    pgsql/contrib/oid2name:
        oid2name.c (r1.26 -> r1.27)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/oid2name/oid2name.c.diff?r1=1.26&r2=1.27)
    pgsql/contrib/reindexdb:
        reindexdb (r1.5 -> r1.6)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/reindexdb/reindexdb.diff?r1=1.5&r2=1.6)
    pgsql/contrib/seg:
        README.seg (r1.3 -> r1.4)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/contrib/seg/README.seg.diff?r1=1.3&r2=1.4)
    pgsql/doc/src/sgml:
        backup.sgml (r2.66 -> r2.67)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/backup.sgml.diff?r1=2.66&r2=2.67)
        charset.sgml (r2.72 -> r2.73)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/charset.sgml.diff?r1=2.72&r2=2.73)
        client-auth.sgml (r1.80 -> r1.81)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/client-auth.sgml.diff?r1=1.80&r2=1.81)
        installation.sgml (r1.235 -> r1.236)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/installation.sgml.diff?r1=1.235&r2=1.236)
        libpq.sgml (r1.185 -> r1.186)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/libpq.sgml.diff?r1=1.185&r2=1.186)
        manage-ag.sgml (r2.41 -> r2.42)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/manage-ag.sgml.diff?r1=2.41&r2=2.42)
        runtime.sgml (r1.329 -> r1.330)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/runtime.sgml.diff?r1=1.329&r2=1.330)
        start.sgml (r1.38 -> r1.39)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/start.sgml.diff?r1=1.38&r2=1.39)
    pgsql/doc/src/sgml/ref:
        createlang.sgml (r1.34 -> r1.35)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/createlang.sgml.diff?r1=1.34&r2=1.35)
        drop_database.sgml (r1.19 -> r1.20)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/drop_database.sgml.diff?r1=1.19&r2=1.20)
        initdb.sgml (r1.34 -> r1.35)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/initdb.sgml.diff?r1=1.34&r2=1.35)
        pg_dumpall.sgml (r1.49 -> r1.50)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/ref/pg_dumpall.sgml.diff?r1=1.49&r2=1.50)
    pgsql/src/backend/commands:
        dbcommands.c (r1.159 -> r1.160)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/backend/commands/dbcommands.c.diff?r1=1.159&r2=1.160)
    pgsql/src/bin/initdb:
        initdb.c (r1.84 -> r1.85)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/initdb/initdb.c.diff?r1=1.84&r2=1.85)
    pgsql/src/bin/pg_ctl:
        pg_ctl.c (r1.57 -> r1.58)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/pg_ctl/pg_ctl.c.diff?r1=1.57&r2=1.58)
    pgsql/src/bin/pg_dump:
        pg_dumpall.c (r1.59 -> r1.60)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/pg_dump/pg_dumpall.c.diff?r1=1.59&r2=1.60)
    pgsql/src/bin/psql:
        startup.c (r1.117 -> r1.118)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/psql/startup.c.diff?r1=1.117&r2=1.118)
    pgsql/src/bin/scripts:
        clusterdb.c (r1.12 -> r1.13)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/clusterdb.c.diff?r1=1.12&r2=1.13)
        createdb.c (r1.14 -> r1.15)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/createdb.c.diff?r1=1.14&r2=1.15)
        createuser.c (r1.16 -> r1.17)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/createuser.c.diff?r1=1.16&r2=1.17)
        dropdb.c (r1.14 -> r1.15)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/dropdb.c.diff?r1=1.14&r2=1.15)
        dropuser.c (r1.13 -> r1.14)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/dropuser.c.diff?r1=1.13&r2=1.14)
        vacuumdb.c (r1.12 -> r1.13)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/bin/scripts/vacuumdb.c.diff?r1=1.12&r2=1.13)
    pgsql/src/include/catalog:
        catversion.h (r1.279 -> r1.280)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/include/catalog/catversion.h.diff?r1=1.279&r2=1.280)
    pgsql/src/interfaces/ecpg/test:
        testdynalloc.pgc (r1.1 -> r1.2)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/interfaces/ecpg/test/testdynalloc.pgc.diff?r1=1.1&r2=1.2)
    pgsql/src/interfaces/libpq:
        pg_service.conf.sample (r1.2 -> r1.3)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/interfaces/libpq/pg_service.conf.sample.diff?r1=1.2&r2=1.3)
    pgsql/src/test/bench:
        create.sh (r1.4 -> r1.5)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/test/bench/create.sh.diff?r1=1.4&r2=1.5)
    pgsql/src/test/examples:
        testlibpq.c (r1.14 -> r1.15)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/test/examples/testlibpq.c.diff?r1=1.14&r2=1.15)
        testlibpq2.c (r1.11 -> r1.12)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/test/examples/testlibpq2.c.diff?r1=1.11&r2=1.12)
        testlibpq3.c (r1.10 -> r1.11)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/test/examples/testlibpq3.c.diff?r1=1.10&r2=1.11)
    pgsql/src/test/regress:
        pg_regress.sh (r1.56 -> r1.57)
        (http://developer.postgresql.org/cvsweb.cgi/pgsql/src/test/regress/pg_regress.sh.diff?r1=1.56&r2=1.57)