pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedSynopsis inconsistencies
3+ messages / 2 participants
[nested] [flat]
* Synopsis inconsistencies
@ 2003-06-12 03:36 Rod Taylor <rbt@rbt.ca>
2003-06-23 06:16 ` Re: [PATCHES] Synopsis inconsistencies Bruce Momjian <pgman@candle.pha.pa.us>
2003-06-24 23:29 ` Re: [PATCHES] Synopsis inconsistencies Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 2 replies; 3+ messages in thread
From: Rod Taylor @ 2003-06-12 03:36 UTC (permalink / raw)
To: pgsql-docs; +Cc: PostgreSQL Patches <pgsql-patches@postgresql.org>
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.
--
Rod Taylor <rbt@rbt.ca>
PGP Key: http://www.rbt.ca/rbtpub.asc
Attachments:
name.patch (text/x-patch, 3.2K) download
Index: create_conversion.sgml
===================================================================
RCS file: /home/rbt/work/postgresql/cvs/pgsql-server/doc/src/sgml/ref/create_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 ****
<refsynopsisdiv>
<synopsis>
! CREATE [DEFAULT] CONVERSION <replaceable>conversion_name</replaceable>
FOR <replaceable>source_encoding</replaceable> TO <replaceable>dest_encoding</replaceable> FROM <replaceable>funcname</replaceable>
</synopsis>
</refsynopsisdiv>
--- 13,19 ----
<refsynopsisdiv>
<synopsis>
! CREATE [DEFAULT] CONVERSION <replaceable>name</replaceable>
FOR <replaceable>source_encoding</replaceable> TO <replaceable>dest_encoding</replaceable> FROM <replaceable>funcname</replaceable>
</synopsis>
</refsynopsisdiv>
***************
*** 55,61 ****
</varlistentry>
<varlistentry>
! <term><replaceable>conversion_name</replaceable></term>
<listitem>
<para>
--- 55,61 ----
</varlistentry>
<varlistentry>
! <term><replaceable>name</replaceable></term>
<listitem>
<para>
Index: drop_index.sgml
===================================================================
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 ****
<refsynopsisdiv>
<synopsis>
! DROP INDEX <replaceable class="PARAMETER">index_name</replaceable> [, ...] [ CASCADE | RESTRICT ]
</synopsis>
</refsynopsisdiv>
--- 16,22 ----
<refsynopsisdiv>
<synopsis>
! DROP INDEX <replaceable class="PARAMETER">name</replaceable> [, ...] [ CASCADE | RESTRICT ]
</synopsis>
</refsynopsisdiv>
***************
*** 35,41 ****
<variablelist>
<varlistentry>
! <term><replaceable class="PARAMETER">index_name</replaceable></term>
<listitem>
<para>
The name (optionally schema-qualified) of an index to remove.
--- 35,41 ----
<variablelist>
<varlistentry>
! <term><replaceable class="PARAMETER">name</replaceable></term>
<listitem>
<para>
The name (optionally schema-qualified) of an index to remove.
***************
*** 78,88 ****
</varlistentry>
<varlistentry>
! <term><computeroutput>ERROR: index "<replaceable class="PARAMETER">index_name</replaceable>" does not exist</computeroutput></term>
<listitem>
<para>
This message is returned if <replaceable
! class="PARAMETER">index_name</replaceable> is not an existing
index.
</para>
</listitem>
--- 78,88 ----
</varlistentry>
<varlistentry>
! <term><computeroutput>ERROR: index "<replaceable class="PARAMETER">name</replaceable>" does not exist</computeroutput></term>
<listitem>
<para>
This message is returned if <replaceable
! class="PARAMETER">name</replaceable> is not an existing
index.
</para>
</listitem>
* Re: [PATCHES] Synopsis inconsistencies
2003-06-12 03:36 Synopsis inconsistencies Rod Taylor <rbt@rbt.ca>
@ 2003-06-23 06:16 ` Bruce Momjian <pgman@candle.pha.pa.us>
1 sibling, 0 replies; 3+ messages in thread
From: Bruce Momjian @ 2003-06-23 06:16 UTC (permalink / raw)
To: Rod Taylor <rbt@rbt.ca>; +Cc: pgsql-docs; PostgreSQL Patches <pgsql-patches@postgresql.org>
Your patch has been added to the PostgreSQL unapplied patches list at:
http://momjian.postgresql.org/cgi-bin/pgpatches
I will try to apply it within the next 48 hours.
---------------------------------------------------------------------------
Rod Taylor wrote:
-- Start of PGP signed section.
> 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.
>
> --
> Rod Taylor <rbt@rbt.ca>
>
> PGP Key: http://www.rbt.ca/rbtpub.asc
[ Attachment, skipping... ]
-- End of PGP section, PGP failed!
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: [PATCHES] Synopsis inconsistencies
2003-06-12 03:36 Synopsis inconsistencies Rod Taylor <rbt@rbt.ca>
@ 2003-06-24 23:29 ` Bruce Momjian <pgman@candle.pha.pa.us>
1 sibling, 0 replies; 3+ messages in thread
From: Bruce Momjian @ 2003-06-24 23:29 UTC (permalink / raw)
To: Rod Taylor <rbt@rbt.ca>; +Cc: pgsql-docs; PostgreSQL Patches <pgsql-patches@postgresql.org>
Patch applied. Thanks.
---------------------------------------------------------------------------
Rod Taylor wrote:
-- Start of PGP signed section.
> 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.
>
> --
> Rod Taylor <rbt@rbt.ca>
>
> PGP Key: http://www.rbt.ca/rbtpub.asc
[ Attachment, skipping... ]
-- End of PGP section, PGP failed!
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2003-06-24 23:29 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2003-06-12 03:36 Synopsis inconsistencies Rod Taylor <rbt@rbt.ca>
2003-06-23 06:16 ` Bruce Momjian <pgman@candle.pha.pa.us>
2003-06-24 23:29 ` Bruce Momjian <pgman@candle.pha.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox