Re: BUG #4410: Indexes not seen right away - Mailing list pgsql-bugs

From Magnus Hagander
Subject Re: BUG #4410: Indexes not seen right away
Date
Msg-id 48E9C567.408@hagander.net
Whole thread Raw
In response to Re: BUG #4410: Indexes not seen right away  ("Greg Sabino Mullane" <greg@turnstep.com>)
List pgsql-bugs
Greg Sabino Mullane wrote:
>
>>>> Does it have pg_index.indcheckxmin = true?  If so, see README.HOT.
>>> Yes, that was probably it. Is this worth noting in the documentation somewhere
>>> (other than the technical bowels of HOT)? Perhaps in the CREATE INDEX
>>> docs?
> ...
>> I have attached the scripts I used for testing.  I don't think it is
>> worth documenting this until we have 8.4 released and people start using
>> it.
>
> I'm not following this, Bruce. HOT came out in 8.3, not 8.4, so why would we
> wait on documenting the problem?
>
>> I believe a mention in the manual would require quite complex wording.
>
> Seems something would be better than nothing. Example:
>
> "Note: In versions 8.3 and higher, indexes may not be immediately visible
> due to the way HOT chains work. For more information, please see
> <link to README.HOT>."

I think putting links in the user documentation directly to development
README files that require you to look in the source code is a bad thing...


> It might be nice to upgrade README.HOT to a real documentation page
> as well.

If we want the full explanation there, that's how it should be done :-)

//Magnus

pgsql-bugs by date:

Previous
From: "Scott V"
Date:
Subject: BUG #4451: initcap() function capitalizes incorrectly
Next
From: Magnus Hagander
Date:
Subject: Re: BUG #4451: initcap() function capitalizes incorrectly