This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: "Documentation by paper"
- From: "Zack Weinberg" <zack at codesourcery dot com>
- To: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner)
- Cc: gcc at gcc dot gnu dot org
- Date: Mon, 09 Feb 2004 10:34:04 -0800
- Subject: Re: "Documentation by paper"
- References: <10402091722.AA06761@vlsi1.ultra.nyu.edu>
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