From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | Michael Paquier <michael(at)paquier(dot)xyz> |
Cc: | PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Event trigger code comment duplication |
Date: | 2020-05-13 01:48:51 |
Message-ID: | CAKFQuwbJGzFUmMcHaiz4ZFKSFurw_5775pBa7hdVmBWb5gOttg@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Mon, May 11, 2020 at 11:30 PM Michael Paquier <michael(at)paquier(dot)xyz>
wrote:
> The second point about the check with (!currentEventTriggerState) in
> EventTriggerTableRewrite() and EventTriggerDDLCommandEnd() shows that
> both comments share the same first sentence, but there is enough
> different context to just keep them as separate IMO.
>
Went back and looked this over - the comment differences in the check for
currentEventTriggerState boil down to:
the word "required" vs "important" - either works for both.
the fact that the DDLCommandEnd function probably wouldn't crash absent the
check - which while I do not know whether DDLTriggerRewrite would crash for
certain (hence the "required") as a practical matter it is required (and
besides if keeping note of which of these would crash or not is deemed
important that can be commented upon specifically in each - both
DDLCommandStart (which lacks the check altogether...) and SQLDrop both
choose not to elaborate on that point at all.
Whether its a style thing, or some requirement of the C-language, I found
it odd that the four nearly identical checks were left inline in the
functions instead of being pulled out into a function. I've attached a
conceptual patch that does just this and more clearly presents on my
thoughts on the topic. In particular I tried to cleanup the quadruple
negative sentence (and worse for the whole paragraph) as part of the
refactoring of the currentEventTriggerState comment.
David J.
Attachment | Content-Type | Size |
---|---|---|
event_trigger_diff_v1.txt | text/plain | 5.4 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Mark Dilger | 2020-05-13 02:07:46 | Re: new heapcheck contrib module |
Previous Message | Isaac Morland | 2020-05-13 01:16:40 | Re: Our naming of wait events is a disaster. |