This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: RETURN_ADDR_RTX / new target macro: ALLOCATE_INITIAL_VALUE
- To: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Subject: Re: RETURN_ADDR_RTX / new target macro: ALLOCATE_INITIAL_VALUE
- From: law at redhat dot com
- Date: Fri, 19 Oct 2001 16:41:33 -0600
- cc: Joern Rennecke <amylaar at redhat dot com>, gcc-patches at gcc dot gnu dot org, aph at redhat dot com
- Reply-To: law at redhat dot com
In message <Pine.LNX.4.33.0109171730560.20157-100000@kern.srcf.societies.cam.
ac.uk>you write:
> > The GNU Coding standards still contain this paragraph:
> >
> > There's no need to make change log entries for documentation files. This
> is because documentation is not susceptible to
> > bugs that are hard to fix. Documentation does not consist of parts that
> must interact in a precisely engineered fashion.
> > To correct an error, you need not know the history of the erroneous pass
> age; it is enough to compare what the
> > documentation says with the way the program actually works.
> >
> > If that is not longer to be followed, we should take it out.
>
> The relevant coding standards are the GCC ones (codingconventions.html)
> which require ChangeLog entries for documentation.
Right. While the GNU project does not require doc changes to be mentioned
in the ChangeLog, they do not forbid them. The GCC project does require doc
changes to be mentioned in the ChangeLog.
The two policies are compatible and when working on GCC the GCC coding
conventions should be followed.
jeff