head	1.14;
access;
symbols
	REL9_0_0:1.14
	REL9_1_ALPHA1:1.14
	REL9_0_RC1:1.14
	REL9_0_BETA4:1.14
	REL9_0_STABLE:1.14.0.2
	REL9_0_BETA3:1.14
	REL9_0_BETA2:1.13
	REL7_4_29:1.7
	REL8_0_25:1.8
	REL8_1_21:1.8
	REL8_2_17:1.10
	REL8_3_11:1.11
	REL8_4_4:1.12
	REL9_0_BETA1:1.13
	REL9_0_ALPHA5_BRANCH:1.12.0.12
	REL9_0_ALPHA5:1.12
	REL7_4_28:1.7
	REL8_0_24:1.8
	REL8_1_20:1.8
	REL8_2_16:1.10
	REL8_3_10:1.11
	REL8_4_3:1.12
	REL9_0_ALPHA4:1.12
	REL9_0_ALPHA4_BRANCH:1.12.0.10
	REL8_5_ALPHA3:1.12
	REL8_5_ALPHA3_BRANCH:1.12.0.8
	REL7_4_27:1.7
	REL8_0_23:1.8
	REL8_1_19:1.8
	REL8_2_15:1.10
	REL8_3_9:1.11
	REL8_4_2:1.12
	REL8_5_ALPHA2:1.12
	REL8_5_ALPHA2_BRANCH:1.12.0.6
	REL7_4_26:1.7
	REL8_0_22:1.8
	REL8_1_18:1.8
	REL8_2_14:1.10
	REL8_3_8:1.11
	REL8_4_1:1.12
	REL8_5_ALPHA1:1.12
	REL8_5_ALPHA1_BRANCH:1.12.0.4
	REL8_4_STABLE:1.12.0.2
	REL8_4_0:1.12
	REL8_4_RC2:1.12
	REL8_4_RC1:1.12
	REL8_4_BETA2:1.12
	REL8_4_BETA1:1.12
	REL7_4_25:1.7
	REL8_0_21:1.8
	REL8_1_17:1.8
	REL8_2_13:1.10
	REL8_3_7:1.11
	REL7_4_24:1.7
	REL8_0_20:1.8
	REL8_1_16:1.8
	REL8_2_12:1.10
	REL8_3_6:1.11
	REL7_4_23:1.7
	REL8_0_19:1.8
	REL8_1_15:1.8
	REL8_2_11:1.10
	REL8_3_5:1.11
	REL7_4_22:1.7
	REL8_0_18:1.8
	REL8_1_14:1.8
	REL8_2_10:1.10
	REL8_3_4:1.11
	REL7_4_21:1.7
	REL8_0_17:1.8
	REL8_1_13:1.8
	REL8_2_9:1.10
	REL8_3_3:1.11
	REL7_4_20:1.7
	REL8_0_16:1.8
	REL8_1_12:1.8
	REL8_2_8:1.10
	REL8_3_2:1.11
	REL8_2_7:1.10
	REL8_3_1:1.11
	REL8_3_STABLE:1.11.0.2
	REL8_3_0:1.11
	REL8_3_RC2:1.11
	REL7_3_21:1.3
	REL7_4_19:1.7
	REL8_0_15:1.8
	REL8_1_11:1.8
	REL8_2_6:1.10
	REL8_3_RC1:1.11
	REL8_3_BETA4:1.11
	REL8_3_BETA3:1.11
	REL8_3_BETA2:1.11
	REL8_3_BETA1:1.11
	REL7_3_20:1.3
	REL7_4_18:1.7
	REL8_0_14:1.8
	REL8_1_10:1.8
	REL8_2_5:1.10
	REL7_3_19:1.3
	REL7_4_17:1.7
	REL8_0_13:1.8
	REL8_1_9:1.8
	REL8_2_4:1.10
	REL8_0_12:1.8
	REL8_1_8:1.8
	REL8_2_3:1.10
	REL7_3_18:1.3
	REL7_4_16:1.7
	REL8_0_11:1.8
	REL8_1_7:1.8
	REL8_2_2:1.10
	REL8_0_10:1.8
	REL8_1_6:1.8
	REL8_2_1:1.10
	REL7_4_15:1.7
	REL7_3_17:1.3
	REL8_2_STABLE:1.10.0.2
	REL8_2_0:1.10
	REL8_2_RC1:1.10
	REL8_2_BETA3:1.10
	REL8_2_BETA2:1.10
	REL8_1_5:1.8
	REL8_0_9:1.8
	REL7_4_14:1.7
	REL7_3_16:1.3
	REL8_2_BETA1:1.10
	REL7_3_15:1.3
	REL7_4_13:1.7
	REL8_0_8:1.8
	REL8_1_4:1.8
	REL7_3_14:1.3
	REL7_4_12:1.7
	REL8_0_7:1.8
	REL8_1_3:1.8
	REL7_3_13:1.3
	REL7_4_11:1.7
	REL8_0_6:1.8
	REL8_1_2:1.8
	REL7_3_12:1.3
	REL7_4_10:1.7
	REL8_0_5:1.8
	REL8_1_1:1.8
	REL8_1_STABLE:1.8.0.6
	REL8_1_0:1.8
	REL8_1_0RC1:1.8
	REL8_1_0BETA4:1.8
	REL8_1_0BETA3:1.8
	REL7_3_11:1.3
	REL7_4_9:1.7
	REL8_0_4:1.8
	REL8_1_0BETA2:1.8
	REL8_1_0BETA1:1.8
	REL7_3_10:1.3
	REL7_4_8:1.7
	REL8_0_3:1.8
	REL8_0_2:1.8
	REL7_3_9:1.3
	REL7_4_7:1.7
	REL8_0_1:1.8
	REL8_0_STABLE:1.8.0.4
	REL8_0_0:1.8.0.2
	REL8_0_0RC5:1.8
	REL8_0_0RC4:1.8
	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.3
	REL8_0_0BETA3:1.8
	REL8_0_0BETA2:1.8
	REL7_4_5:1.7
	REL7_3_7:1.3
	REL7_4_4:1.7
	REL8_0_0BETA1:1.8
	REL7_4_3:1.7
	REL7_4_2:1.7
	REL7_3_6:1.3
	REL7_4_1:1.7
	REL7_3_5:1.3
	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.6
	REL7_4_BETA2:1.5
	WIN32_DEV:1.5.0.2
	REL7_4_BETA1:1.5
	REL7_3_4:1.3
	REL7_3_2:1.3
	REL7_3_STABLE:1.3.0.2;
locks; strict;
comment	@# @;


1.14
date	2010.06.16.02.12.51;	author petere;	state Exp;
branches;
next	1.13;

1.13
date	2010.04.03.07.23.00;	author petere;	state Exp;
branches;
next	1.12;

1.12
date	2008.11.14.10.22.46;	author petere;	state Exp;
branches;
next	1.11;

1.11
date	2007.01.31.23.26.03;	author momjian;	state Exp;
branches;
next	1.10;

1.10
date	2006.09.16.00.30.18;	author momjian;	state Exp;
branches;
next	1.9;

1.9
date	2005.11.19.17.39.44;	author adunstan;	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.22.00.16.58;	author petere;	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.06.27.14.45.26;	author petere;	state Exp;
branches
	1.5.2.1;
next	1.4;

1.4
date	2003.05.04.02.23.16;	author petere;	state Exp;
branches;
next	1.3;

1.3
date	2002.09.21.18.32.54;	author petere;	state Exp;
branches;
next	1.2;

1.2
date	2002.07.22.13.00.00;	author ishii;	state Exp;
branches;
next	1.1;

1.1
date	2002.07.22.08.57.15;	author ishii;	state Exp;
branches;
next	;

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


desc
@@


1.14
log
@Add notes that CREATE/DROP CONVERSION is similar to CREATE/DROP
TRANSLATION in the SQL standard.
@
text
@<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.13 2010/04/03 07:23:00 petere Exp $ -->

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

 <refnamediv>
  <refname>DROP CONVERSION</refname>
  <refpurpose>remove a conversion</refpurpose>
 </refnamediv>

 <indexterm zone="sql-dropconversion">
  <primary>DROP CONVERSION</primary>
 </indexterm>

 <refsynopsisdiv>
<synopsis>
DROP CONVERSION [ IF EXISTS ] <replaceable>name</replaceable> [ CASCADE | RESTRICT ]
</synopsis>
 </refsynopsisdiv>
  
 <refsect1 id="sql-dropconversion-description">
  <title>Description</title>

  <para>
   <command>DROP CONVERSION</command> removes a previously defined conversion.
   To be able to drop a conversion, you must own the conversion.
  </para>
 </refsect1>

 <refsect1>
  <title>Parameters</title>

   <variablelist>
    <varlistentry>
     <term><literal>IF EXISTS</literal></term>
     <listitem>
      <para>
       Do not throw an error if the conversion does not exist. 
       A notice is issued in this case.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><replaceable>name</replaceable></term>

     <listitem>
      <para>
       The name of the conversion. The conversion name can be
       schema-qualified.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><literal>CASCADE</literal></term>
     <term><literal>RESTRICT</literal></term>

     <listitem>
      <para>
       These key words do not have any effect, since there are no
       dependencies on conversions.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
 </refsect1>

 <refsect1 id="sql-dropconversion-examples">
  <title>Examples</title>

  <para>
   To drop the conversion named <literal>myname</>:
<programlisting>
DROP CONVERSION myname;
</programlisting>
  </para>
 </refsect1>

 <refsect1 id="sql-dropconversion-compat">
  <title>Compatibility</title>

  <para>
   There is no <command>DROP CONVERSION</command> statement in the SQL
   standard, but a <command>DROP TRANSLATION</command> statement that
   goes along with the <command>CREATE TRANSLATION</command> statement
   that is similar to the <command>CREATE CONVERSION</command>
   statement in PostgreSQL.
  </para>
 </refsect1>

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

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

</refentry>
@


1.13
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
@d1 1
a1 1
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.12 2008/11/14 10:22:46 petere Exp $ -->
d89 4
a92 1
   standard.
@


1.12
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
@d1 1
a1 1
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.11 2007/01/31 23:26:03 momjian Exp $ -->
d5 1
a5 1
  <refentrytitle id="SQL-DROPCONVERSION-TITLE">DROP CONVERSION</refentrytitle>
d97 2
a98 2
   <member><xref linkend="sql-alterconversion" endterm="sql-alterconversion-title"></member>
   <member><xref linkend="sql-createconversion" endterm="sql-createconversion-title"></member>
@


1.11
log
@Update reference documentation on may/can/might:

Standard English uses "may", "can", and "might" in different ways:

        may - permission, "You may borrow my rake."

        can - ability, "I can lift that log."

        might - possibility, "It might rain today."

Unfortunately, in conversational English, their use is often mixed, as
in, "You may use this variable to do X", when in fact, "can" is a better
choice.  Similarly, "It may crash" is better stated, "It might crash".
@
text
@d1 1
a1 1
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.10 2006/09/16 00:30:18 momjian Exp $ -->
d6 1
@


1.10
log
@Remove emacs info from footer of SGML files.
@
text
@d1 1
a1 1
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.9 2005/11/19 17:39:44 adunstan Exp $ -->
d52 1
a52 1
       The name of the conversion. The conversion name may be
@


1.9
log
@
DROP objecttype IF EXISTS for the following objects:
  table view index sequence schema type domain conversion
@
text
@d1 1
a1 1
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.8 2003/11/29 19:51:38 pgsql Exp $ -->
a101 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.8
log
@
$Header: -> $PostgreSQL Changes ...
@
text
@d1 1
a1 1
<!-- $PostgreSQL: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.7 2003/09/22 00:16:58 petere Exp $ -->
d20 1
a20 1
DROP CONVERSION <replaceable>name</replaceable> [ CASCADE | RESTRICT ]
d38 10
@


1.7
log
@Make the SQL command synopses appear less random.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.6 2003/08/31 17:32:22 petere Exp $ -->
@


1.6
log
@Add/edit index entries.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.5 2003/06/27 14:45:26 petere Exp $ -->
d11 1
a11 1
  <refpurpose>remove a user-defined conversion</refpurpose>
d20 1
a20 1
DROP CONVERSION <replaceable>conversion_name</replaceable> [ CASCADE | RESTRICT ]
d38 1
a38 1
     <term><replaceable>conversion_name</replaceable></term>
@


1.5
log
@First batch of object rename commands.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.4 2003/05/04 02:23:16 petere Exp $ -->
d13 4
@


1.5.2.1
log
@Update this branch to match CVS head, includes WIN32 improvements.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.6 2003/08/31 17:32:22 petere Exp $ -->
a12 4

 <indexterm zone="sql-dropconversion">
  <primary>DROP CONVERSION</primary>
 </indexterm>
@


1.4
log
@Last round of reference page editing.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.3 2002/09/21 18:32:54 petere Exp $ -->
d82 1
@


1.3
log
@Add more appropriate markup.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql-server/doc/src/sgml/ref/drop_conversion.sgml,v 1.2 2002/07/22 13:00:00 ishii Exp $ -->
d16 1
a16 2
DROP CONVERSION <replaceable>conversion_name</replaceable>
    [ CASCADE | RESTRICT ]
d25 1
d27 1
d29 2
a30 3
  <para>
   To be able to drop a conversion, you must own the conversion.
  </para>
a32 2
    <title>Parameters</title>

a55 1

a57 14
 <refsect1 id="sql-dropconversion-notes">
  <title>Notes</title>

  <para>
   Use <command>CREATE CONVERSION</command> to create user-defined conversions.
  </para>

  <para>
   The privileges required to drop a conversion may be changed in a future
   release.
  </para>
 </refsect1>


a68 1
 
d73 2
a74 4
    <command>DROP CONVERSION</command>
    is a <productname>PostgreSQL</productname> extension.
    There is no <command>DROP CONVERSION</command>
    statement in <acronym>SQL99</acronym>.
d78 1
a78 2

 <refsect1 id="sql-dropconversion-seealso">
d81 3
a83 3
  <para>
   <xref linkend="sql-createconversion" endterm="sql-createconversion-title">
  </para>
@


1.2
log
@Fix typo.
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_conversion.sgml,v 1.1 2002/07/22 08:57:15 ishii Exp $ -->
d79 1
a79 1
   To drop the conversion named myname:
@


1.1
log
@Add CREATE CONVERSION/DROP CONVERSOION reference manual
@
text
@d1 1
a1 1
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_cast.sgml,v 1.1 2002/07/18 23:11:27 petere Exp $ -->
d93 1
a93 1
    There is no <command>DROP OPERATOR</command>
@
