"Documentation by paper"

[Zack Weinberg]

Put your money where your mouth is.

You've been saying all along that the original author is the person
who must write the documentation.  Fine.  You invented MEM_ATTRS and
the adjust_address family of functions.  There is not one word about
these things in doc/*.texi.  The function-level comments for the
adjust_address family do not give any clue of the most important
detail, viz., which one to use for what.  The fields of MEM_ATTRS are
cursorily documented in rtl.h but there is no high-level view.

Write documentation for all this, to the standard you are advocating,
and let us see if it's good enough.

zw