Doc patch, index search_path where it's used to secure functions

Hi,

Doc patch, index search_path where it's used to secure functions.
search_path-securing.patch

Against git head. (As are the previous doc patches.)

Karl <kop(at)meme(dot)com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

On 09/28/2012 11:28:39 AM, Karl O. Pinc wrote:

> Doc patch, index search_path where it's used to secure functions.
> search_path-securing.patch

Second version. Should be indexing the concept, not the run-time
setting.

Karl <kop(at)meme(dot)com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

On Fri, 2012-09-28 at 12:17 -0500, Karl O. Pinc wrote:
> On 09/28/2012 11:28:39 AM, Karl O. Pinc wrote:
>
> > Doc patch, index search_path where it's used to secure functions.
> > search_path-securing.patch
>
> Second version. Should be indexing the concept, not the run-time
> setting.

Well, I'm not sure. We currently have three index entries on the topic:

search path
search_path
search_path configuration parameter

I think I'd put them all under search_path.

On 11/13/2012 08:46:19 PM, Peter Eisentraut wrote:
>
> Well, I'm not sure. We currently have three index entries on the
> topic:
>
> search path
> search_path
> search_path configuration parameter
>
> I think I'd put them all under search_path.

Ok.

I think you are right that they need to all be
under one index entry.

It might make sense to have a "search term"
entry that says "see search_term", but since
the two entries would be right next to each
other in the index this seems overkill.

I'm going to send this in as a single patch
that fixes all the search path related
index entries:

search_path-index.patch

(replaces search_path-normalize.patch
and search_path-securing_v2.patch)

This new patch also changes the
search path index in doc/src/sgml/func.sgml.
Perhaps I just don't understand the logic
in the indexing in that file but the
search path index there seems to point to the
entire file/nowhere useful. Since there are 2 places
in the file that are concerned with
search path I've removed the "global"
index into the file and added new
index entries. This also moved the
"schema, current" index target.
(Since that too involves search path.)

I've also added a <seealso> entry to "schema, current"
to the top-level "search_path" index entry.

If you want this broken up into smaller
patches let me know.

Regards,

Karl <kop(at)meme(dot)com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein

On Wed, 2012-11-14 at 00:21 -0600, Karl O. Pinc wrote:
> I'm going to send this in as a single patch
> that fixes all the search path related
> index entries:
>
> search_path-index.patch
>
> (replaces search_path-normalize.patch
> and search_path-securing_v2.patch)

The other configuration parameters are all indexed as "x_y_z
configuration parameter", so I've kept search_path aligned with that. I
have applied your other changes, so I think it's good now. Let me know
if you feel additional changes should be made.

On 12/13/2012 10:05:15 PM, Peter Eisentraut wrote:

> The other configuration parameters are all indexed as "x_y_z
> configuration parameter", so I've kept search_path aligned with that.
> I
> have applied your other changes, so I think it's good now. Let me
> know
> if you feel additional changes should be made.

I like the way it has come out. Thanks!

Karl <kop(at)meme(dot)com>
Free Software: "You don't pay back, you pay forward."
-- Robert A. Heinlein