Daniel Gustafsson <dan...@yesql.se> writes: > On 25 Sep 2023, at 05:34, Japin Li <japi...@hotmail.com> wrote: >> How about "See gram.h target's comment in src/backend/parser/Makefile" >> or just "See src/backend/parser/Makefile"?
> The latter seems more stable, if the Makefile is ever restructured it's almost > guaranteed that this comment will be missed with the location info becoming > stale. I did it like this: # Note that while each script call produces two output files, to be -# parallel-make safe we need to split this into two rules. (See for -# example gram.y for more explanation.) +# parallel-make safe we need to split this into two rules. (See notes +# in src/backend/parser/Makefile about rules with multiple outputs.) # There are a whole lot of other cross-references to that same comment, and they all look like # See notes in src/backend/parser/Makefile about the following two rules I considered modifying all of those as well, but decided it wasn't really worth the trouble. The Makefiles' days are numbered I think. regards, tom lane