On Wed, Nov 13, 2013 at 10:44 AM, Reuben Thomas <r...@sc3d.org> wrote: > On 11 November 2013 14:30, Jim Meyering <j...@meyering.net> wrote: >> >> Glad you found it. >> If you can find a good way to document it, I'd appreciate a patch. > > > I can think of nothing better than a note in the source, by whoever wrote > it, so it reflects their intention rather than my half-baked guesses.
I'm the guilty party. I did look at maint.mk around that rule, but didn't find a good, fulfilling way to document that the whole thing feels like a house of cards, and that it is nontrivial (as you've found) to diagnose failures. I guess anything at all would be welcome.