I think that you need to take a little broader look at this section. > At the top, it says "To use any of these functions, you need to > include the header file foreign/foreign.h in your source file", but > this function is defined in foreign/fdwapi.h. It's not clear to me > whether we should consider moving the prototype, or just document that > this function is someplace else. The other functions prototyped in > fdwapi.h aren't documented at all, except for > IsImportableForeignTable, which is mentioned in passing. > > Further down, the section says "Some object types have name-based > lookup functions in addition to the OID-based ones:" and you propose > to put the documentation for this function after that. But this > comment doesn't actually describe this particular function. >
> Actually, this function just doesn't seem to fit into this section at > all. It's really quite different from the others listed there. How > about something like the attached instead? Right. Mentioning the function in the description of relevant function looks better and avoids some duplication. -- Best Wishes, Ashutosh Bapat EnterpriseDB Corporation The Postgres Database Company