Re: logical/relation.c header description

On Fri, Sep 18, 2020 at 12:30 PM Amit Kapila <amit(dot)kapila16(at)gmail(dot)com> wrote:
> On Thu, Sep 17, 2020 at 6:46 PM Amit Langote <amitlangote09(at)gmail(dot)com> wrote:
> >
> > Thanks for taking a look.
> >
> > On Thu, Sep 17, 2020 at 9:20 PM Amit Kapila <amit(dot)kapila16(at)gmail(dot)com> wrote:
> > > On Thu, Sep 17, 2020 at 3:22 PM Amit Langote <amitlangote09(at)gmail(dot)com> wrote:
> > > >
> > >
> > > /*-------------------------------------------------------------------------
> > > * relation.c
> > > - * PostgreSQL logical replication
> > > + * PostgreSQL logical replication relation mapping routines
> > > *
> > > ..
> > > * NOTES
> > > * This file contains helper functions for logical replication relation
> > > * mapping cache.
> > >
> > > The new header title and NOTES section say the almost same thing. How
> > > about changing the title as "PostgreSQL logical replication relation
> > > mapping cache" and remove the NOTES section.
> >
> > That makes sense.
> >
> > Actually, I did consider expanding that NOTE to mention what the
> > module does but there are not actually that many interesting things in
> > there. If you would like to take a look at the text I had come up
> > with, please check the attached.
> >
> I am not very excited to add information about structures used in the
> file especially when we have explained 'LogicalRepPartMapEntry' a few
> lines after. I think we can leave explaining structures but otherwise,
> it looks good. See attached.

Works for me, thanks.

--
Amit Langote
EnterpriseDB: http://www.enterprisedb.com