Received: from maia.hub.org (maia-5.hub.org [200.46.204.29]) by mail.postgresql.org (Postfix) with ESMTP id DD9BE632B89 for ; Mon, 16 Aug 2010 11:00:12 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024) with ESMTP id 77074-01 for ; Mon, 16 Aug 2010 14:00:05 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from gw.wicourts.gov (gwmta.wicourts.gov [165.219.244.99]) by mail.postgresql.org (Postfix) with ESMTP id F277C632B0B for ; Mon, 16 Aug 2010 11:00:04 -0300 (ADT) Received: from Courts-MTA by gw.wicourts.gov with Novell_GroupWise; Mon, 16 Aug 2010 09:00:02 -0500 Message-Id: <4C68FE080200002500034660@gw.wicourts.gov> X-Mailer: Novell GroupWise Internet Agent 8.0.1 Date: Mon, 16 Aug 2010 08:59:52 -0500 From: "Kevin Grittner" To: "Thom Brown" , "pgsql-docs" Subject: Re: Ambiguous index entry for Privileges References: In-Reply-To: Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-4.21 tagged_above=-5 required=5 tests=BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201008/50 X-Sequence-Number: 5874 Thom Brown wrote: > On 12 August 2010 00:05, Thom Brown 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