This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: GFDL/GPL issues
- From: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner)
- To: dnovillo at google dot com
- Cc: Joe dot Buck at synopsys dot com, ams at gnu dot org, bkoz at redhat dot com, dewar at adacore dot com, gcc at gcc dot gnu dot org, iant at google dot com, mark at codesourcery dot com, richard dot guenther at gmail dot com, stevenb dot gcc at gmail dot com
- Date: Mon, 02 Aug 2010 19:17:55 EDT
- Subject: Re: GFDL/GPL issues
- References: <4BFC6EF0.4090908@codesourcery.com> <20100714172307.3687a9c4@shotwell> <4C48D2C4.5000103@codesourcery.com> <AANLkTiksONrxGm3sT7_yF8XXQbtHPqhMHSobQ7+0NE_n@mail.gmail.com> <4C48D60E.3000604@codesourcery.com> <mcraapifvyu.fsf@google.com> <20100726175013.20b12428@shotwell> <4C4E35B8.6010301@codesourcery.com> <4C4E37FC.1060208@adacore.com> <4C4F010C.5060401@codesourcery.com> <20100727180738.GU17485@synopsys.com> <4C4F20E8.5050206@codesourcery.com> <AANLkTimaPhMzhw66Z6WM+n4dhe1w_ibGFpYExiCym1RC@mail.gmail.com> <AANLkTimZo8PZbrhcghxxaHPyEdW-nExj6VoL25WR3os-@mail.gmail.com> <4C509E54.6090401@codesourcery.com> <AANLkTim+nkpKL9y2kspaWejfOUd9m7xeo6qFUmNJdp8F@mail.gmail.com> <E1OeNjt-0004kn-PY@fencepost.gnu.org> <mcriq3yk7lt.fsf@google.com> <11007291247.AA02219@vlsi1.ultra.nyu.edu> <4C5195FA.2060208@codesourcery.com> <4C52B176.7040807@adacore.com> <4C52E1C0.6090400@codesourcery.com> <4C53696B.7030801@adacore.com> <4C536B50.4010402@codesourcery.com> <AANLkTikQ_ajAfJu8LkCjCP_tVBmZOkNgXFNmFHAMzTiY@mail.gmail.com>
> We are already having trouble keeping our documentation up-to-date.
> Some of it is in such a poor shape as to be laughable. Yes, it's
> mostly our fault, but if we were able to generate documentation by
> simply extracting it from the code. Tools exist for this, and
> properly maintained, they are very useful.
I disagree and think that's backwards. To get good quality
documentation, we have to WRITE good quality documentation. Using
tools to generate it from sources will DECREASE its quality, in my
opinion. The best measure of quality of a document is how much time
people spend writing and editing it.