Re: Header and comments describing routines in incorrect shape in visibilitymap.c - Mailing list pgsql-hackers

From Alvaro Herrera
Subject Re: Header and comments describing routines in incorrect shape in visibilitymap.c
Date
Msg-id 20160707145712.GA678885@alvherre.pgsql
Whole thread Raw
In response to Header and comments describing routines in incorrect shape in visibilitymap.c  (Michael Paquier <michael.paquier@gmail.com>)
Responses Re: Header and comments describing routines in incorrect shape in visibilitymap.c  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
Michael Paquier wrote:
> Hi all,
> 
> I just bumped into a couple of things in visibilitymap.c:
> - visibilitymap_clear clears all bits of a visibility map, its header
> comment mentions the contrary
> - The header of visibilitymap.c mentions correctly "a bit" when
> referring to setting them, but when clearing, it should say that all
> bits are cleared.
> - visibilitymap_set can set multiple bits
> - visibilitymap_pin can be called to set up more than 1 bit.
> 
> This can be summed by the patch attached.

Regarding the first hunk, I don't like these INTERFACE sections too
much; they get seriously outdated over the time and aren't all that
helpful anyway.  See the one on heapam.c for example.  I'd rather get
rid of that one instead of patching it.  The rest, of course, merit
revision.

-- 
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services



pgsql-hackers by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: Reviewing freeze map code
Next
From: Robert Haas
Date:
Subject: Re: Reviewing freeze map code