Remove the word "virgins" for documentation

Apparently, it's no longer welcome.  Therefore replace it with "pristine",
and add some explanatory text while at it.

Reported by Brian Williams
Discussion: https://postgr.es/m/157313712259.14261.16141263269989647311@wrigleys.postgresql.org

diff --git a/doc/src/sgml/manage-ag.sgml b/doc/src/sgml/manage-ag.sgml
index 0154064e506306eda0ca848b960752ecc217a650..b1b8539fb3a52c335d69cb44e6e49061de6a6c21 100644 (file)
--- a/doc/src/sgml/manage-ag.sgml
+++ b/doc/src/sgml/manage-ag.sgml
@@ -199,11 +199,12 @@ createdb -O rolename dbname
    should never be changed after the database cluster has been
    initialized.  By instructing
    CREATE DATABASE to copy template0 instead
-   of template1, you can create a virgin user
-   database that contains none of the site-local additions in
+   of template1, you can create a pristine user
+   database (one where no user-defined objects exist and where the system
+   objects have not been altered) that contains none of the site-local additions in
    template1.  This is particularly handy when restoring a
    pg_dump dump: the dump script should be restored in a
-   virgin database to ensure that one recreates the correct contents
+   pristine database to ensure that one recreates the correct contents
    of the dumped database, without conflicting with objects that
    might have been added to template1 later on.
   

diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml
index 4014f6703bbaeaeac8ebdc13dcd2f674c9088fcb..504c1b022460d774be99d42639fe0eeef2c10d72 100644 (file)
--- a/doc/src/sgml/ref/create_database.sgml
+++ b/doc/src/sgml/ref/create_database.sgml
@@ -54,8 +54,10 @@ CREATE DATABASE name
    system database template1.  A different template can be
    specified by writing TEMPLATE
    name.  In particular,
-   by writing TEMPLATE template0, you can create a virgin
-   database containing only the standard objects predefined by your
+   by writing TEMPLATE template0, you can create a pristine
+   database (one where no user-defined objects exist and where the system
+   objects have not been altered)
+   containing only the standard objects predefined by your
    version of PostgreSQL.  This is useful
    if you wish to avoid copying
    any installation-local objects that might have been added to