head	1.16;
access;
symbols
	REL9_0_0:1.16
	REL9_1_ALPHA1:1.16
	REL9_0_RC1:1.16
	REL9_0_BETA4:1.16
	REL9_0_STABLE:1.16.0.2
	REL9_0_BETA3:1.16
	REL9_0_BETA2:1.16
	REL7_4_29:1.7
	REL8_0_25:1.10
	REL8_1_21:1.11
	REL8_2_17:1.13.2.1
	REL8_3_11:1.14
	REL8_4_4:1.15
	REL9_0_BETA1:1.16
	REL9_0_ALPHA5_BRANCH:1.15.0.12
	REL9_0_ALPHA5:1.15
	REL7_4_28:1.7
	REL8_0_24:1.10
	REL8_1_20:1.11
	REL8_2_16:1.13.2.1
	REL8_3_10:1.14
	REL8_4_3:1.15
	REL9_0_ALPHA4:1.15
	REL9_0_ALPHA4_BRANCH:1.15.0.10
	REL8_5_ALPHA3:1.15
	REL8_5_ALPHA3_BRANCH:1.15.0.8
	REL7_4_27:1.7
	REL8_0_23:1.10
	REL8_1_19:1.11
	REL8_2_15:1.13.2.1
	REL8_3_9:1.14
	REL8_4_2:1.15
	REL8_5_ALPHA2:1.15
	REL8_5_ALPHA2_BRANCH:1.15.0.6
	REL7_4_26:1.7
	REL8_0_22:1.10
	REL8_1_18:1.11
	REL8_2_14:1.13.2.1
	REL8_3_8:1.14
	REL8_4_1:1.15
	REL8_5_ALPHA1:1.15
	REL8_5_ALPHA1_BRANCH:1.15.0.4
	REL8_4_STABLE:1.15.0.2
	REL8_4_0:1.15
	REL8_4_RC2:1.15
	REL8_4_RC1:1.15
	REL8_4_BETA2:1.15
	REL8_4_BETA1:1.15
	REL7_4_25:1.7
	REL8_0_21:1.10
	REL8_1_17:1.11
	REL8_2_13:1.13.2.1
	REL8_3_7:1.14
	REL7_4_24:1.7
	REL8_0_20:1.10
	REL8_1_16:1.11
	REL8_2_12:1.13.2.1
	REL8_3_6:1.14
	REL7_4_23:1.7
	REL8_0_19:1.10
	REL8_1_15:1.11
	REL8_2_11:1.13.2.1
	REL8_3_5:1.14
	REL7_4_22:1.7
	REL8_0_18:1.10
	REL8_1_14:1.11
	REL8_2_10:1.13.2.1
	REL8_3_4:1.14
	REL7_4_21:1.7
	REL8_0_17:1.10
	REL8_1_13:1.11
	REL8_2_9:1.13.2.1
	REL8_3_3:1.14
	REL7_4_20:1.7
	REL8_0_16:1.10
	REL8_1_12:1.11
	REL8_2_8:1.13.2.1
	REL8_3_2:1.14
	REL8_2_7:1.13.2.1
	REL8_3_1:1.14
	REL8_3_STABLE:1.14.0.2
	REL8_3_0:1.14
	REL8_3_RC2:1.14
	REL7_3_21:1.4
	REL7_4_19:1.7
	REL8_0_15:1.10
	REL8_1_11:1.11
	REL8_2_6:1.13.2.1
	REL8_3_RC1:1.14
	REL8_3_BETA4:1.14
	REL8_3_BETA3:1.14
	REL8_3_BETA2:1.14
	REL8_3_BETA1:1.14
	REL7_3_20:1.4
	REL7_4_18:1.7
	REL8_0_14:1.10
	REL8_1_10:1.11
	REL8_2_5:1.13.2.1
	REL7_3_19:1.4
	REL7_4_17:1.7
	REL8_0_13:1.10
	REL8_1_9:1.11
	REL8_2_4:1.13
	REL8_0_12:1.10
	REL8_1_8:1.11
	REL8_2_3:1.13
	REL7_3_18:1.4
	REL7_4_16:1.7
	REL8_0_11:1.10
	REL8_1_7:1.11
	REL8_2_2:1.13
	REL8_0_10:1.10
	REL8_1_6:1.11
	REL8_2_1:1.13
	REL7_4_15:1.7
	REL7_3_17:1.4
	REL8_2_STABLE:1.13.0.2
	REL8_2_0:1.13
	REL8_2_RC1:1.13
	REL8_2_BETA3:1.13
	REL8_2_BETA2:1.13
	REL8_1_5:1.11
	REL8_0_9:1.10
	REL7_4_14:1.7
	REL7_3_16:1.4
	REL8_2_BETA1:1.13
	REL7_3_15:1.4
	REL7_4_13:1.7
	REL8_0_8:1.10
	REL8_1_4:1.11
	REL7_3_14:1.4
	REL7_4_12:1.7
	REL8_0_7:1.10
	REL8_1_3:1.11
	REL7_3_13:1.4
	REL7_4_11:1.7
	REL8_0_6:1.10
	REL8_1_2:1.11
	REL7_3_12:1.4
	REL7_4_10:1.7
	REL8_0_5:1.10
	REL8_1_1:1.11
	REL8_1_STABLE:1.11.0.2
	REL8_1_0:1.11
	REL8_1_0RC1:1.11
	REL8_1_0BETA4:1.11
	REL8_1_0BETA3:1.11
	REL7_3_11:1.4
	REL7_4_9:1.7
	REL8_0_4:1.10
	REL8_1_0BETA2:1.11
	REL8_1_0BETA1:1.11
	REL7_2_8:1.3
	REL7_3_10:1.4
	REL7_4_8:1.7
	REL8_0_3:1.10
	REL8_0_2:1.10
	REL7_2_7:1.3
	REL7_3_9:1.4
	REL7_4_7:1.7
	REL8_0_1:1.10
	REL8_0_STABLE:1.10.0.4
	REL8_0_0:1.10.0.2
	REL8_0_0RC5:1.10
	REL8_0_0RC4:1.9
	REL8_0_0RC3:1.8
	REL8_0_0RC2:1.8
	REL8_0_0RC1:1.8
	REL8_0_0BETA5:1.8
	REL8_0_0BETA4:1.8
	REL7_4_6:1.7
	REL7_3_8:1.4
	REL7_2_6:1.3
	REL8_0_0BETA3:1.8
	REL8_0_0BETA2:1.8
	REL7_2_5:1.3
	REL7_4_5:1.7
	REL7_3_7:1.4
	REL7_4_4:1.7
	REL8_0_0BETA1:1.8
	REL7_4_3:1.7
	REL7_4_2:1.7
	REL7_3_6:1.4
	REL7_4_1:1.7
	REL7_3_5:1.4
	REL7_4:1.7
	REL7_4_RC2:1.7
	REL7_4_STABLE:1.7.0.2
	REL7_4_RC1:1.7
	REL7_4_BETA5:1.7
	REL7_4_BETA4:1.7
	REL7_4_BETA3:1.7
	REL7_4_BETA2:1.5
	WIN32_DEV:1.5.0.2
	REL7_4_BETA1:1.5
	REL7_3_4:1.4
	REL7_3_2:1.4
	REL7_2_4:1.3
	REL7_3_STABLE:1.4.0.2
	REL7_2_3:1.3
	REL7_2_STABLE:1.3.0.2
	REL7_2:1.3
	REL7_2_RC2:1.3
	REL7_2_RC1:1.3
	REL7_2_BETA5:1.3
	REL7_2_BETA4:1.3
	REL7_2_BETA3:1.2
	REL7_2_BETA2:1.2
	REL7_2_BETA1:1.2
	REL7_1_2:1.1
	REL7_1_STABLE:1.1.0.4
	REL7_1_BETA:1.1
	REL7_1_BETA3:1.1
	REL7_1_BETA2:1.1
	REL7_1:1.1
	REL7_0_PATCHES:1.1.0.2
	REL7_0:1.1;
locks; strict;
comment	@# @;


1.16
date	2010.04.03.07.23.00;	author petere;	state Exp;
branches;
next	1.15;

1.15
date	2008.11.14.10.22.46;	author petere;	state Exp;
branches;
next	1.14;

1.14
date	2007.05.15.19.43.51;	author neilc;	state Exp;
branches;
next	1.13;

1.13
date	2006.09.16.00.30.18;	author momjian;	state Exp;
branches
	1.13.2.1;
next	1.12;

1.12
date	2006.02.04.19.06.46;	author adunstan;	state Exp;
branches;
next	1.11;

1.11
date	2005.07.26.23.24.02;	author tgl;	state Exp;
branches;
next	1.10;

1.10
date	2005.01.09.05.57.45;	author tgl;	state Exp;
branches;
next	1.9;

1.9
date	2005.01.04.00.39.53;	author tgl;	state Exp;
branches;
next	1.8;

1.8
date	2003.11.29.19.51.38;	author pgsql;	state Exp;
branches;
next	1.7;

1.7
date	2003.09.09.18.28.53;	author tgl;	state Exp;
branches;
next	1.6;

1.6
date	2003.08.31.17.32.22;	author petere;	state Exp;
branches;
next	1.5;

1.5
date	2003.05.04.02.23.16;	author petere;	state Exp;
branches
	1.5.2.1;
next	1.4;

1.4
date	2002.04.21.19.02.39;	author thomas;	state Exp;
branches;
next	1.3;

1.3
date	2001.12.08.03.24.36;	author thomas;	state Exp;
branches;
next	1.2;

1.2
date	2001.09.03.12.57.49;	author petere;	state Exp;
branches;
next	1.1;

1.1
date	2000.01.14.22.11.32;	author petere;	state Exp;
branches;
next	;

1.5.2.1
date	2003.09.07.04.36.45;	author momjian;	state Exp;
branches;
next	;

1.13.2.1
date	2007.05.15.19.43.59;	author neilc;	state Exp;
branches;
next	;


desc
@@


1.16
log
@Remove unnecessary xref endterm attributes and title ids

The endterm attribute is mainly useful when the toolchain does not support
automatic link target text generation for a particular situation.  In  the
past, this was required by the man page tools for all reference page links,
but that is no longer the case, and it now actually gets in the way of
proper automatic link text generation.  The only remaining use cases are
currently xrefs to refsects.
@
text
@<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.15 2008/11/14 10:22:46 petere Exp $
PostgreSQL documentation
-->

<refentry id="SQL-DROPGROUP">
 <refmeta>
  <refentrytitle>DROP GROUP</refentrytitle>
  <manvolnum>7</manvolnum>
  <refmiscinfo>SQL - Language Statements</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>DROP GROUP</refname>
  <refpurpose>remove a database role</refpurpose>
 </refnamediv>

 <indexterm zone="sql-dropgroup">
  <primary>DROP GROUP</primary>
 </indexterm>

 <refsynopsisdiv>
<synopsis>
DROP GROUP [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [, ...]
</synopsis>
 </refsynopsisdiv>

 <refsect1>
  <title>Description</title>

  <para>
   <command>DROP GROUP</command> is now an alias for
   <xref linkend="sql-droprole">.
  </para>
 </refsect1>

 <refsect1>
  <title>Compatibility</title>

  <para>
   There is no <command>DROP GROUP</command> statement in the SQL standard.
  </para>
 </refsect1>

 <refsect1>
  <title>See Also</title>

  <simplelist type="inline">
   <member><xref linkend="sql-droprole"></member>
  </simplelist>
 </refsect1>

</refentry>
@


1.15
log
@Set SQL man pages to be section 7 by default, and only transform them to
another section if required by the platform (instead of the old way of
building them in section "l" and always transforming them to the
platform-specific section).

This speeds up the installation on common platforms, and it avoids some
funny business with the man page tools and build process.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.14 2007/05/15 19:43:51 neilc Exp $
d8 1
a8 1
  <refentrytitle id="SQL-DROPGROUP-TITLE">DROP GROUP</refentrytitle>
d33 1
a33 1
   <xref linkend="sql-droprole" endterm="sql-droprole-title">.
d49 1
a49 1
   <member><xref linkend="sql-droprole" endterm="sql-droprole-title"></member>
@


1.14
log
@Fix a bunch of bad grammar in the docs: "<link>, which see for more
information" is un-good English.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.13 2006/09/16 00:30:18 momjian Exp $
d9 1
@


1.13
log
@Remove emacs info from footer of SGML files.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.12 2006/02/04 19:06:46 adunstan Exp $
d32 1
a32 2
   <xref linkend="sql-droprole" endterm="sql-droprole-title">,
   which see for more information.
@


1.13.2.1
log
@Fix a bunch of bad grammar in the docs: "<link>, which see for more
information" is un-good English.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.13 2006/09/16 00:30:18 momjian Exp $
d32 2
a33 1
   <xref linkend="sql-droprole" endterm="sql-droprole-title">.
@


1.12
log
@
DROP IF EXISTS for ROLE/USER/GROUP
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.11 2005/07/26 23:24:02 tgl Exp $
a53 17

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->
@


1.11
log
@Basic documentation for ROLEs.  The user-manag chapter still needs to
be rewritten, but at least the reference pages are reasonably sane.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.10 2005/01/09 05:57:45 tgl Exp $
d23 1
a23 1
DROP GROUP <replaceable class="PARAMETER">name</replaceable> [, ...]
@


1.10
log
@Some more small improvements in response to 7.4 interactive docs comments.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.9 2005/01/04 00:39:53 tgl Exp $
d14 1
a14 1
  <refpurpose>remove a user group</refpurpose>
d23 1
a23 1
DROP GROUP <replaceable class="PARAMETER">name</replaceable>
d31 3
a33 2
   <command>DROP GROUP</command> removes the specified group.  The
   users in the group are not removed.
a35 29
  
 <refsect1>
  <title>Parameters</title>

  <variablelist>
   <varlistentry>
    <term><replaceable class="PARAMETER">name</replaceable></term>
    <listitem>
     <para>
      The name of an existing group.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1>
  <title>Notes</title>

  <para>
   It is unwise to drop a group that has any
   granted permissions on objects.  Currently, this is not enforced,
   but it is likely that future versions of
   <productname>PostgreSQL</productname> will check for the error.
  </para>
 </refsect1>

 <refsect1>
  <title>Examples</title>
a36 8
  <para>
   To drop a group:
<programlisting>
DROP GROUP staff;
</programlisting>
  </para>
 </refsect1>
 
d49 1
a49 2
   <member><xref linkend="sql-altergroup" endterm="sql-altergroup-title"></member>
   <member><xref linkend="sql-creategroup" endterm="sql-creategroup-title"></member>
@


1.9
log
@More minor updates and copy-editing.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.8 2003/11/29 19:51:38 pgsql Exp $
d32 1
a32 1
   users in the group are not deleted.
@


1.8
log
@
$Header: -> $PostgreSQL Changes ...
@
text
@d2 1
a2 1
$PostgreSQL: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_group.sgml,v 1.7 2003/09/09 18:28:53 tgl Exp $
d52 11
@


1.7
log
@Remove a bunch of content-free Diagnostics sections, as per previous
discussion.  (Still have some work to do editing the remainder.)
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_group.sgml,v 1.6 2003/08/31 17:32:22 petere Exp $
@


1.6
log
@Add/edit index entries.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_group.sgml,v 1.5 2003/05/04 02:23:16 petere Exp $
a44 15
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>
  
 <refsect1>
  <title>Diagnostics</title>

  <variablelist>
   <varlistentry>
    <term><computeroutput>DROP GROUP</computeroutput></term>
    <listitem>
     <para>
      Message returned if the group was successfully removed.
@


1.5
log
@Last round of reference page editing.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_group.sgml,v 1.4 2002/04/21 19:02:39 thomas Exp $
d16 4
@


1.5.2.1
log
@Update this branch to match CVS head, includes WIN32 improvements.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_group.sgml,v 1.6 2003/08/31 17:32:22 petere Exp $
a15 4

 <indexterm zone="sql-dropgroup">
  <primary>DROP GROUP</primary>
 </indexterm>
@


1.4
log
@Augment the date/time examples in the User's Guide to reflect the newer
 capabilities of specifying time zones as intervals per SQL9x.
Put refentrytitle contents on the same line as the tag.
 Otherwise, leading whitespace is propagated into the product, which
 (at least) messes up the ToC layout.
Remove (some) docinfo tags containing dates. Best to omit if the dates
 are not accurate; maybe use CVS dates instead or leave them out.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.3 2001/12/08 03:24:36 thomas Exp $
d11 1
d13 2
a14 6
  <refname>
   DROP GROUP
  </refname>
  <refpurpose>
   remove a user group
  </refpurpose>
d16 1
d18 1
a18 4
  <refsynopsisdivinfo>
   <date>2000-01-14</date>
  </refsynopsisdivinfo>
  <synopsis>
d20 1
a20 45
  </synopsis>
  
  <refsect2 id="R2-SQL-DROPGROUP-1">
   <refsect2info>
    <date>2000-01-14</date>
   </refsect2info>
   <title>
    Inputs
   </title>
   <para>

    <variablelist>
     <varlistentry>
      <term><replaceable class="PARAMETER">name</replaceable></term>
      <listitem>
       <para>
	The name of an existing group.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect2>
  
  <refsect2 id="R2-SQL-DROPGROUP-2">
   <refsect2info>
    <date>2000-01-14</date>
   </refsect2info>
   <title>
    Outputs
   </title>
   <para>
    <variablelist>
     <varlistentry>
      <term><computeroutput>DROP GROUP</computeroutput></term>
      <listitem>
       <para>
	The message returned if the group is successfully deleted.
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>
  </refsect2>
d23 3
a25 7
 <refsect1 id="R1-SQL-DROPGROUP-1">
  <refsect1info>
   <date>2000-01-14</date>
  </refsect1info>
  <title>
   Description
  </title>
d27 2
a28 2
   <command>DROP GROUP</command> removes the specified group from the database.
   The users in the group are not deleted.
a29 5
  <para>
   Use <xref linkend="SQL-CREATEGROUP" endterm="SQL-CREATEGROUP-title">
   to add new groups, and <xref linkend="SQL-ALTERGROUP"
   endterm="SQL-ALTERGROUP-title"> to change a group's membership.
  </para>  
d31 33
a64 4
 <refsect1 id="R1-SQL-DROPGROUP-2">
  <title>
   Usage
  </title>
d73 15
a87 16
 <refsect1 id="R1-SQL-DROPGROUP-3">
  <title>
   Compatibility
  </title>
  
  <refsect2 id="R2-SQL-DROPGROUP-4">
   <refsect2info>
    <date>2000-01-14</date>
   </refsect2info>
   <title>
    SQL92
   </title>
   <para>
    There is no <command>DROP GROUP</command> in <acronym>SQL92</acronym>.
   </para>
  </refsect2>
d89 1
@


1.3
log
@Use PostgreSQL consistantly throughout docs. Before, usage was split evenly
 between Postgres and PostgreSQL.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.2 2001/09/03 12:57:49 petere Exp $
d8 1
a8 3
  <refentrytitle id="SQL-DROPGROUP-TITLE">
   DROP GROUP
  </refentrytitle>
@


1.2
log
@Put some kind of grammatical uniformity in the <refpurpose> lines.
@
text
@d2 2
a3 2
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.1 2000/01/14 22:11:32 petere Exp $
Postgres documentation
@


1.1
log
@* User management commands no longer user pg_exec_query_dest -> more robust

* Let unprivileged users change their own passwords.

* The password is now an Sconst in the parser, which better reflects its text datatype and also
forces users to quote them.

* If your password is NULL you won't be written to the password file, meaning you can't connect
until you have a password set up (if you use password authentication).

* When you drop a user that owns a database you get an error. The database is not gone.
@
text
@d2 1
a2 1
$Header$
d18 1
a18 1
   Removes a group
@
