Fix actively-misleading comments about the contents of struct pg_tm.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 6 Sep 2021 15:43:44 +0000 (11:43 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 6 Sep 2021 15:43:44 +0000 (11:43 -0400)
commit89dba59590fdd03799a47daf8019890d4324fbcf
tree0321a2b360059809b7e6709542b253ae556742df
parent388e71af880d579212c2489686903c2cfdea9032
Fix actively-misleading comments about the contents of struct pg_tm.

pgtime.h documented the PG interpretation of tm_mon right alongside
the POSIX interpretation of tm_year, with no hint that neither
comment was correct throughout our code.

Perhaps someday we ought to switch to using two separate struct
definitions to provide a clearer indication of which semantics are
in use where.  But I fear the tedium-versus-safety-gain tradeoff
would not be very good.

Discussion: https://postgr.es/m/CAJ7c6TOMG8zSNEZtCn5SPe+cCk3Lfxb71ZaQwT2F4T7PJ_t=KA@mail.gmail.com
src/include/pgtime.h