.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/create_database.l,v 1.3 1997/05/19 14:23:08 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/create_database.l,v 1.4 1997/11/07 06:33:55 thomas Exp $
.TH "CREATE DATABASE" SQL 11/05/95 PostgreSQL PostgreSQL
.SH NAME
create database \(em create a new database
.SH SYNOPSIS
.nf
-\fBcreate database\fP dbname
+\fBcreate database\fP dbname [\fBwith location = '\fPdbpath\fB'\fP]
.fi
.SH DESCRIPTION
-.BR "Create database"
+.BR "create database"
creates a new Postgres database. The creator becomes the administrator
-of the new database.
+of the new database. An alternate location can be specified as either an
+environment variable known to the backend server (e.g. 'PGDATA2') or as
+an absolute path name (e.g. '/home/postgres/data'). In either case, the
+location must be pre-configured by
+.BR initarea
+
.SH "SEE ALSO"
createdb(1),
drop database(l),
destroydb(1),
+initarea(1),
initdb(1).
.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
-.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.3 1997/08/26 17:29:54 momjian Exp $
+.\" $Header: /cvsroot/pgsql/src/man/Attic/createdb.1,v 1.4 1997/11/07 06:33:57 thomas Exp $
.TH CREATEDB UNIX 11/05/95 PostgreSQL PostgreSQL
.SH NAME
createdb \(em create a database
[\c
.BR -p
port]
+[\c
+.BR -D
+location]
[dbname]
.SH DESCRIPTION
-.IR Createdb
+.BR createdb
creates a new database. The person who executes this command becomes
the database administrator, or DBA, for this database and is the only
person, other than the Postgres super-user, who can destroy it.
.IR dbname
specifies the name of the database to be created. The name must be
unique among all Postgres databases.
-.IR Dbname
+.IR dbname
defaults to the value of the
.SM USER
environment variable.
.PP
-.IR Createdb
+.IR createdb
understands the following command-line options:
.TP 5n
.BR "-a" " system"
.IR postmaster
process. The default is site-specific.
.TP
+.BR "-D" " dbpath"
+Specifies the alternate database location for this database.
+.TP
.BR "-h" " host"
Specifies the hostname of the machine on which the
.IR postmaster