On Thu, Nov 10, 2016 at 12:13 AM, Tsunakawa, Takayuki <tsunakawa.ta...@jp.fujitsu.com> wrote: > From: pgsql-hackers-ow...@postgresql.org >> [mailto:pgsql-hackers-ow...@postgresql.org] On Behalf Of Robert Haas >> OK. I agree that's a problem. However, your patch adds zero new comment >> text while removing some existing comments, so I can't easily tell how it >> solves that problem or whether it does so correctly. Even if I were smart >> enough to figure it out, I wouldn't want to rely on the next person also >> being that smart. This is obviously a subtle problem in tricky code, so >> a clear explanation of the fix seems like a very good idea. > > The comment describes what the code is trying to achieve. Actually, I just > imitated the code and comment of later major releases. The only difference > between later releases and my patch (for 9.2) is whether the state is stored > in XLogReaderStruct or as global variables. Below is the comment from 9.6, > where the second paragraph describes what the two nested if conditions mean. > The removed comment lines are what became irrelevant, which is also not > present in later major releases.
Let me try to be more clear. I will not commit this patch if it is not properly commented. I doubt that anyone else will, either. The fact that those code changes already exist in 9.4+ is not a reason to back-port them to earlier releases without a proper explanation of why we are doing it. Very possibly, we should also improve the comments in newer branches so that future authors don't reintroduce whatever bugs were fixed by these changes. But whether we do that or not, I am not going to commit uncommented patches to complex code in order to fix obscure bugs in 3+-year-old branches. I think that is a non-starter. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company -- Sent via pgsql-hackers mailing list (email@example.com) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers