This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: RETURN_ADDR_RTX / new target macro: ALLOCATE_INITIAL_VALUE


  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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]