X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [64.117.224.193])
	by svr1.postgresql.org (Postfix) with ESMTP
	id 78D2930DFB0; Thu, 12 Jun 2003 03:36:54 +0000 (GMT)
Received: from svr1.postgresql.org ([64.117.224.193])
	by localhost (svr1.postgresql.org [64.117.224.193]) (amavisd-new,
	port 10024)
	with ESMTP id 39711-03; Thu, 12 Jun 2003 00:36:43 -0300 (ADT)
Received: from mailav.tor1.inquent.com (mail.inquent.com [216.208.117.106])
	by svr1.postgresql.org (Postfix) with ESMTP
	id A2B9E30DC61; Thu, 12 Jun 2003 00:36:43 -0300 (ADT)
Received: from localhost (localhost [127.0.0.1])
	by mailav.tor1.inquent.com (Postfix) with ESMTP
	id 9155F1024D; Wed, 11 Jun 2003 23:30:39 -0400 (EDT)
Received: from [192.168.1.200] (HSE-Toronto-ppp116801.sympatico.ca
	[216.209.81.112]) by mailav.tor1.inquent.com (Postfix) with ESMTP
	id 6A4D010248; Wed, 11 Jun 2003 23:30:36 -0400 (EDT)
Subject: Synopsis inconsistencies
From: Rod Taylor <rbt@rbt.ca>
To: PostgreSQL Docs <pgsql-docs@postgresql.org>
Cc: PostgreSQL Patches <pgsql-patches@postgresql.org>
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature";
	boundary="=-kNkxYGlFUYTsJ9bHO+SH"
Message-Id: <1055389007.50088.19.camel@jester>
Mime-Version: 1.0
X-Mailer: Ximian Evolution 1.4.0 
Date: 11 Jun 2003 23:36:47 -0400
X-Virus-Scanned: by AMaViS perl-11
X-Archive-Number: 200306/27
X-Sequence-Number: 1813

--=-kNkxYGlFUYTsJ9bHO+SH
Content-Type: multipart/mixed; boundary="=-OkuhtzgHiwjwrfwmJrHr"

--=-OkuhtzgHiwjwrfwmJrHr
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

Most of the synopsis areas for DROP commands use "name" as the
identifier, while some areas do not.

The attached converts be below to "name":
conversion_name
index_name


The below have an existing, initdb supplied, entity named "name".  As
such, it could be confusing for the reader to see that identifier used
in the example.

domainname
typename

Perhaps we should be going the otherway and converting the other uses of
"name" into "group_name", "user_name", "function_name", etc.

--=20
Rod Taylor <rbt@rbt.ca>

PGP Key: http://www.rbt.ca/rbtpub.asc

--=-OkuhtzgHiwjwrfwmJrHr
Content-Disposition: attachment; filename=name.patch
Content-Type: text/x-patch; name=name.patch; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Index: create_conversion.sgml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /home/rbt/work/postgresql/cvs/pgsql-server/doc/src/sgml/ref/creat=
e_conversion.sgml,v
retrieving revision 1.8
diff -c -r1.8 create_conversion.sgml
*** create_conversion.sgml	22 Apr 2003 10:08:08 -0000	1.8
--- create_conversion.sgml	12 Jun 2003 03:34:18 -0000
***************
*** 13,19 ****
=20=20
   <refsynopsisdiv>
  <synopsis>
! CREATE [DEFAULT] CONVERSION <replaceable>conversion_name</replaceable>
      FOR <replaceable>source_encoding</replaceable> TO <replaceable>dest_e=
ncoding</replaceable> FROM <replaceable>funcname</replaceable>
  </synopsis>
   </refsynopsisdiv>
--- 13,19 ----
=20=20
   <refsynopsisdiv>
  <synopsis>
! CREATE [DEFAULT] CONVERSION <replaceable>name</replaceable>
      FOR <replaceable>source_encoding</replaceable> TO <replaceable>dest_e=
ncoding</replaceable> FROM <replaceable>funcname</replaceable>
  </synopsis>
   </refsynopsisdiv>
***************
*** 55,61 ****
      </varlistentry>
=20=20
      <varlistentry>
!      <term><replaceable>conversion_name</replaceable></term>
=20=20
       <listitem>
        <para>
--- 55,61 ----
      </varlistentry>
=20=20
      <varlistentry>
!      <term><replaceable>name</replaceable></term>
=20=20
       <listitem>
        <para>
Index: drop_index.sgml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /home/rbt/work/postgresql/cvs/pgsql-server/doc/src/sgml/ref/drop_=
index.sgml,v
retrieving revision 1.17
diff -c -r1.17 drop_index.sgml
*** drop_index.sgml	4 May 2003 02:23:16 -0000	1.17
--- drop_index.sgml	12 Jun 2003 03:34:00 -0000
***************
*** 16,22 ****
=20=20
   <refsynopsisdiv>
  <synopsis>
! DROP INDEX <replaceable class=3D"PARAMETER">index_name</replaceable> [, .=
..] [ CASCADE | RESTRICT ]
  </synopsis>
   </refsynopsisdiv>
=20=20
--- 16,22 ----
=20=20
   <refsynopsisdiv>
  <synopsis>
! DROP INDEX <replaceable class=3D"PARAMETER">name</replaceable> [, ...] [ =
CASCADE | RESTRICT ]
  </synopsis>
   </refsynopsisdiv>
=20=20
***************
*** 35,41 ****
=20=20
    <variablelist>
     <varlistentry>
!     <term><replaceable class=3D"PARAMETER">index_name</replaceable></term>
      <listitem>
       <para>
        The name (optionally schema-qualified) of an index to remove.
--- 35,41 ----
=20=20
    <variablelist>
     <varlistentry>
!     <term><replaceable class=3D"PARAMETER">name</replaceable></term>
      <listitem>
       <para>
        The name (optionally schema-qualified) of an index to remove.
***************
*** 78,88 ****
     </varlistentry>
=20=20
     <varlistentry>
!     <term><computeroutput>ERROR: index "<replaceable class=3D"PARAMETER">=
index_name</replaceable>" does not exist</computeroutput></term>
      <listitem>
       <para>
        This message is returned if <replaceable
!       class=3D"PARAMETER">index_name</replaceable> is not an existing
        index.
       </para>
      </listitem>
--- 78,88 ----
     </varlistentry>
=20=20
     <varlistentry>
!     <term><computeroutput>ERROR: index "<replaceable class=3D"PARAMETER">=
name</replaceable>" does not exist</computeroutput></term>
      <listitem>
       <para>
        This message is returned if <replaceable
!       class=3D"PARAMETER">name</replaceable> is not an existing
        index.
       </para>
      </listitem>

--=-OkuhtzgHiwjwrfwmJrHr--

--=-kNkxYGlFUYTsJ9bHO+SH
Content-Type: application/pgp-signature; name=signature.asc
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (FreeBSD)

iD8DBQA+5/VO6DETLow6vwwRAmGYAJ9swV35ArUd88PM9qGTuv6IgDBedwCeIuP7
YNdC3qJmix8ZFYaDdOLEWWA=
=U28O
-----END PGP SIGNATURE-----

--=-kNkxYGlFUYTsJ9bHO+SH--