public inbox for [email protected]  
help / color / mirror / Atom feed
From: David Fetter <[email protected]>
To: PostgreSQL Docs <[email protected]>
To: PostgreSQL Patches <[email protected]>
Subject: Fix misleading references to columns in GRANT/REVOKE summaries
Date: Fri, 6 Apr 2007 16:46:03 -0700
Message-ID: <[email protected]> (raw)

Folks,

Per a question Alexey Parshin asked in the IRC channel, I'm attaching
a patch to the GRANT and REVOKE syntax summaries which replaces the
misleading word "column" with "parameter."  "Column" is misleading
because it could be read to imply a column-level GRANT/REVOKE, which
we don't have yet.

Cheers,
D
-- 
David Fetter <[email protected]> http://fetter.org/
phone: +1 415 235 3778        AIM: dfetter666
                              Skype: davidfetter

Remember to vote!
Consider donating to PostgreSQL: http://www.postgresql.org/about/donate

Index: doc/src/sgml/ref/grant.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v
retrieving revision 1.64
diff -c -r1.64 grant.sgml
*** doc/src/sgml/ref/grant.sgml	1 Feb 2007 00:28:19 -0000	1.64
--- doc/src/sgml/ref/grant.sgml	6 Apr 2007 23:39:20 -0000
***************
*** 525,531 ****
  
  <synopsis>
  GRANT <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="PARAMETER">table</replaceable> [ ( <replaceable class="PARAMETER">column</replaceable> [, ...] ) ] [, ...]
      TO { PUBLIC | <replaceable class="PARAMETER">username</replaceable> [, ...] } [ WITH GRANT OPTION ]
  </synopsis>
     </para>
--- 525,532 ----
  
  <synopsis>
  GRANT <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="PARAMETER">table</replaceable> [ (
! <replaceable class="PARAMETER">parameter</replaceable> [, ...] ) ] [, ...]
      TO { PUBLIC | <replaceable class="PARAMETER">username</replaceable> [, ...] } [ WITH GRANT OPTION ]
  </synopsis>
     </para>
Index: doc/src/sgml/ref/revoke.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/ref/revoke.sgml,v
retrieving revision 1.42
diff -c -r1.42 revoke.sgml
*** doc/src/sgml/ref/revoke.sgml	31 Jan 2007 23:26:04 -0000	1.42
--- doc/src/sgml/ref/revoke.sgml	6 Apr 2007 23:39:20 -0000
***************
*** 235,241 ****
  
  <synopsis>
  REVOKE [ GRANT OPTION FOR ] <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="parameter">object</replaceable> [ ( <replaceable class="parameter">column</replaceable> [, ...] ) ]
      FROM { PUBLIC | <replaceable class="parameter">username</replaceable> [, ...] }
      { RESTRICT | CASCADE }
  </synopsis>
--- 235,242 ----
  
  <synopsis>
  REVOKE [ GRANT OPTION FOR ] <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="parameter">object</replaceable> [ (
! <replaceable class="parameter">parameter</replaceable> [, ...] ) ]
      FROM { PUBLIC | <replaceable class="parameter">username</replaceable> [, ...] }
      { RESTRICT | CASCADE }
  </synopsis>


Attachments:

  [text/plain] fix_grant_revoke.diff (2.2K, 2-fix_grant_revoke.diff)
  download | inline diff:
Index: doc/src/sgml/ref/grant.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v
retrieving revision 1.64
diff -c -r1.64 grant.sgml
*** doc/src/sgml/ref/grant.sgml	1 Feb 2007 00:28:19 -0000	1.64
--- doc/src/sgml/ref/grant.sgml	6 Apr 2007 23:39:20 -0000
***************
*** 525,531 ****
  
  <synopsis>
  GRANT <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="PARAMETER">table</replaceable> [ ( <replaceable class="PARAMETER">column</replaceable> [, ...] ) ] [, ...]
      TO { PUBLIC | <replaceable class="PARAMETER">username</replaceable> [, ...] } [ WITH GRANT OPTION ]
  </synopsis>
     </para>
--- 525,532 ----
  
  <synopsis>
  GRANT <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="PARAMETER">table</replaceable> [ (
! <replaceable class="PARAMETER">parameter</replaceable> [, ...] ) ] [, ...]
      TO { PUBLIC | <replaceable class="PARAMETER">username</replaceable> [, ...] } [ WITH GRANT OPTION ]
  </synopsis>
     </para>
Index: doc/src/sgml/ref/revoke.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/ref/revoke.sgml,v
retrieving revision 1.42
diff -c -r1.42 revoke.sgml
*** doc/src/sgml/ref/revoke.sgml	31 Jan 2007 23:26:04 -0000	1.42
--- doc/src/sgml/ref/revoke.sgml	6 Apr 2007 23:39:20 -0000
***************
*** 235,241 ****
  
  <synopsis>
  REVOKE [ GRANT OPTION FOR ] <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="parameter">object</replaceable> [ ( <replaceable class="parameter">column</replaceable> [, ...] ) ]
      FROM { PUBLIC | <replaceable class="parameter">username</replaceable> [, ...] }
      { RESTRICT | CASCADE }
  </synopsis>
--- 235,242 ----
  
  <synopsis>
  REVOKE [ GRANT OPTION FOR ] <replaceable class="PARAMETER">privileges</replaceable>
!     ON <replaceable class="parameter">object</replaceable> [ (
! <replaceable class="parameter">parameter</replaceable> [, ...] ) ]
      FROM { PUBLIC | <replaceable class="parameter">username</replaceable> [, ...] }
      { RESTRICT | CASCADE }
  </synopsis>


view thread (10+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Fix misleading references to columns in GRANT/REVOKE summaries
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox