This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: PATCH: second stage of dfp-branch merge
On Thu, 1 Dec 2005, Ben Elliston wrote:
> > I don't see documentation for the new modes in rtl.texi, and a lot
> > of new functions lack comments explaining what they do.
>
> I was planning on submitting the documentation in a separate step (to
> save on the effort of breaking those changes into their relevant
> pieces). The documentation has been taken care of on the dfp-branch.
> Would you rather that I submit the documentation changes at each step?
I think documentation should go along with the code it describes.
Although this problem shouldn't arise in the present case, doing otherwise
can lead either to code going in and the documentation not being done, or
documentation being in and code not going in (e.g. the ObjC++
documentation on 4.0 branch which doesn't have ObjC++).
--
Joseph S. Myers http://www.srcf.ucam.org/~jsm28/gcc/
jsm@polyomino.org.uk (personal mail)
joseph@codesourcery.com (CodeSourcery mail)
jsm28@gcc.gnu.org (Bugzilla assignments and CCs)