head	1.5;
access;
symbols;
locks; strict;
comment	@# @;


1.5
date	92.07.14.05.54.17;	author ptong;	state Exp;
branches;
next	1.4;

1.4
date	91.02.22.17.58.40;	author mike;	state Exp;
branches;
next	1.3;

1.3
date	90.07.20.10.03.52;	author claire;	state Exp;
branches;
next	1.2;

1.2
date	90.07.19.16.23.28;	author keongwoo;	state Exp;
branches;
next	1.1;

1.1
date	90.07.18.16.22.11;	author mao;	state Exp;
branches;
next	;


desc
@man page for the destroy postquel command
@


1.5
log
@reformated
@
text
@.\" XXX standard disclaimer belongs here....
.\" $Header: /home/postgres/mer/refs/postquel/RCS/destroy,v 1.4 1991/02/22 17:58:40 mike Exp ptong $
.SP DESTROY COMMANDS 6/14/90
.XA 2 Destroy
.uh NAME
.lp
destroy \*- destroy existing classes
.uh SYNOPSIS
.lp
.(l
\fBdestroy\fR classname-1 { \fB,\fR classname-i }
.)l
.uh DESCRIPTION
.lp
.b Destroy
removes classes from the data base.
Only its owner may destroy a class.
A class may be emptied of instances,
but not destroyed,
by using the
.b delete
statement.
.lp
If a class being destroyed has secondary indices on it,
then they will be removed first.
The removal of just a secondary index will not affect
the indexed class.
.lp
This command may be used to destroy a version class
which is not a parent of some other version.
Destroying a class which is a parent of a
version class is disallowed.
Instead, the
.b merge
command should be used.
Moreover, destroying a qclass whose fields are inherited by other classes
is similarly disallowed.  An inheritance hierarchy must be destroyed from 
leaf level to root level.
.lp
The destruction of classes is not reversable.
Thus, a destroyed class will not be recovered
if a transaction which destroys this class fails to commit.
In addition,
historical access to instances in a destroyed class is not possible.
.uh EXAMPLE
.lp
.ft C
/* Destroy the emp class */

destroy emp

/* Destroy the emp and parts classes */

destroy emp, parts
.ft
.uh "SEE ALSO"
.lp
delete(commands),
remove index(commands),
merge(commands).
@


1.4
log
@objectified
@
text
@d2 1
a2 1
.\" $Header: RCS/destroy,v 1.3 90/07/20 10:03:52 claire Exp Locker: mike $
d10 3
a12 5
.b destroy
classname1 { ,
.r classname \c
.i i
}
d47 1
d51 1
a51 1
.lp
d55 1
@


1.3
log
@*** empty log message ***
@
text
@d2 1
a2 1
.\" $Header: RCS/destroy,v 1.2 90/07/19 16:23:28 keongwoo Exp Locker: claire $
d7 1
a7 1
destroy \*- destroy existing relations
d11 2
a12 2
relname1 { ,
.r relname \c
d18 3
a20 3
removes relations from the data base.
Only its owner may destroy a relation.
A relation may be emptied of tuples,
d26 1
a26 1
If a relation being destroyed has secondary indices on it,
d29 1
a29 1
the indexed relation.
d31 1
a31 1
This command may be used to destroy a version relation
d33 2
a34 2
Destroying a relation which is a parent of a
version relation is disallowed.
d38 1
a38 1
Moreover, destroying a relation whose fields are inherited by other relations
d42 3
a44 3
The destruction of relations is not reversable.
Thus, a destroyed relation will not be recovered
if a transaction which destroys this relation fails to commit.
d46 1
a46 1
historical access to records in a destroyed relation is not possible.
d49 1
a49 1
/* Destroy the emp relation */
d53 1
a53 1
/* Destroy the emp and parts relations */
@


1.2
log
@no changes
@
text
@d2 1
a2 1
.\" $Header: RCS/destroy,v 1.1 90/07/18 16:22:11 mao Exp Locker: keongwoo $
d59 1
a59 1
removeindex(commands),
@


1.1
log
@Initial revision
@
text
@d2 1
a2 1
.\" $Header: destroy,v 1.4 89/03/23 11:42:32 wensel Exp $
@