From: Kevin Grittner <Kevin.Grittner@wicourts.gov>
To: Thom Brown <thom@linux.com>
To: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Ambiguous index entry for Privileges
Date: Mon, 16 Aug 2010 08:59:52 -0500
Message-ID: <4C68FE080200002500034660@gw.wicourts.gov> (raw)
In-Reply-To: <AANLkTimumJnZawJYVokoid7Sz3-G4sYumh_1gJryQ_=N@mail.gmail.com>
References: <AANLkTi=BTZqXThTwzf+RY6hCBYiRwvv9o0mSxY-Wz97T@mail.gmail.com>
<AANLkTimumJnZawJYVokoid7Sz3-G4sYumh_1gJryQ_=N@mail.gmail.com>
Thom Brown <thom@linux.com> wrote:
> On 12 August 2010 00:05, Thom Brown <thom@linux.com> wrote:
>> I noticed that there are 2 linked entries for "Privileges":
>> http://www.postgresql.org/docs/9.0/static/bookindex.html#AEN128982
>>
>> While they both go to different pages (with admittedly very
>> similar content), those pages are both entitled "Privileges" so
>> it's unclear from the index which page you'll end up at. Can we
>> rename one of those pages to clarify as it looks weird in the
>> index.
>
> Does anyone have an opinion on this?
Sure -- I think the page at
http://www.postgresql.org/docs/9.0/static/privileges.html (in
"Chapter 20. Database Roles and Privileges" should be more
conceptual rather than a subset of the other page. Rather than
explaining how to use GRANT and REVOKE to change privileges, it
should give an overview of privileges and discuss what is allowed by
each particular privilege. It could link to the other page, so
there would be one place to keep up-to-date on how to grant and
revoke privileges.
I think the page at
http://www.postgresql.org/docs/9.0/static/ddl-priv.html (in "Chapter
5. Data Definition") should be renamed to something more like
"Modifying Privileges" or "Granting and Revoking Privileges" (or
something to that effect). It might make sense to have its entry in
the index be a secondary entry under privilege, with some similar
qualification.
-Kevin
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: pgsql-docs@postgresql.org
Cc: Kevin.Grittner@wicourts.gov, thom@linux.com
Subject: Re: Ambiguous index entry for Privileges
In-Reply-To: <4C68FE080200002500034660@gw.wicourts.gov>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
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