Commit6ae4d27

committed

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 WilliamsDiscussion:https://postgr.es/m/157313712259.14261.16141263269989647311@wrigleys.postgresql.org

1 parent50d22de commit6ae4d27Copy full SHA for 6ae4d27

File tree

-5

lines changed

-5

lines changed

Lines changed: 4 additions & 3 deletions

Original file line number	Diff line number	Diff line change
`@@ -199,11 +199,12 @@ createdb -O <replaceable>rolename</replaceable> <replaceable>dbname</replaceable`
`199`	`199`	`should never be changed after the database cluster has been`
`200`	`200`	`initialized. By instructing`
`201`	`201`	`<command>CREATE DATABASE</command> to copy <literal>template0</literal> instead`
`202`		`- of <literal>template1</literal>, you can create a <quote>virgin</quote> user`
`203`		`- database that contains none of the site-local additions in`
	`202`	`+ of <literal>template1</literal>, you can create a <quote>pristine</quote> user`
	`203`	`+ database (one where no user-defined objects exist and where the system`
	`204`	`+ objects have not been altered) that contains none of the site-local additions in`
`204`	`205`	`<literal>template1</literal>. This is particularly handy when restoring a`
`205`	`206`	`<literal>pg_dump</literal> dump: the dump script should be restored in a`
`206`		`-virgin database to ensure that one recreates the correct contents`
	`207`	`+pristine database to ensure that one recreates the correct contents`
`207`	`208`	`of the dumped database, without conflicting with objects that`
`208`	`209`	`might have been added to <literal>template1</literal> later on.`
`209`	`210`	`</para>`

Lines changed: 4 additions & 2 deletions

Original file line number	Diff line number	Diff line change
`@@ -54,8 +54,10 @@ CREATE DATABASE <replaceable class="parameter">name</replaceable>`
`54`	`54`	`system database <literal>template1</literal>. A different template can be`
`55`	`55`	`specified by writing <literal>TEMPLATE`
`56`	`56`	`<replaceable class="parameter">name</replaceable></literal>. In particular,`
`57`		`- by writing <literal>TEMPLATE template0</literal>, you can create a virgin`
`58`		`- database containing only the standard objects predefined by your`
	`57`	`+ by writing <literal>TEMPLATE template0</literal>, you can create a pristine`
	`58`	`+ database (one where no user-defined objects exist and where the system`
	`59`	`+ objects have not been altered)`
	`60`	`+ containing only the standard objects predefined by your`
`59`	`61`	`version of <productname>PostgreSQL</productname>. This is useful`
`60`	`62`	`if you wish to avoid copying`
`61`	`63`	`any installation-local objects that might have been added to`

Comments

(0)