From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-return-163523-listarch-gcc=gcc.gnu.org@gcc.gnu.org>
Received: (qmail 3399 invoked by alias); 2 Aug 2010 23:16:42 -0000
Received: (qmail 3391 invoked by uid 22791); 2 Aug 2010 23:16:41 -0000
X-SWARE-Spam-Status: No, hits=-2.1 required=5.0	tests=AWL,BAYES_00,T_RP_MATCHES_RCVD
X-Spam-Check-By: sourceware.org
Received: from VLSI1.ULTRA.NYU.EDU (HELO vlsi1.ultra.nyu.edu) (128.122.140.213)    by sourceware.org (qpsmtpd/0.43rc1) with SMTP; Mon, 02 Aug 2010 23:16:37 +0000
Received: by vlsi1.ultra.nyu.edu (4.1/1.34)	id AA08984; Mon, 2 Aug 10 19:17:57 EDT
From: kenner@vlsi1.ultra.nyu.edu (Richard Kenner)
Message-Id: <11008022317.AA08984@vlsi1.ultra.nyu.edu>
Date: Mon, 02 Aug 2010 23:16:00 -0000
To: dnovillo@google.com
Subject: Re: GFDL/GPL issues
Cc: Joe.Buck@synopsys.com, ams@gnu.org, bkoz@redhat.com, dewar@adacore.com,        gcc@gcc.gnu.org, iant@google.com, mark@codesourcery.com,        richard.guenther@gmail.com, stevenb.gcc@gmail.com
In-Reply-To: <AANLkTikQ_ajAfJu8LkCjCP_tVBmZOkNgXFNmFHAMzTiY@mail.gmail.com>
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>
X-IsSubscribed: yes
Mailing-List: contact gcc-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Id: <gcc.gcc.gnu.org>
List-Archive: <http://gcc.gnu.org/ml/gcc/>
List-Post: <mailto:gcc@gcc.gnu.org>
List-Help: <http://gcc.gnu.org/ml/>
Sender: gcc-owner@gcc.gnu.org
X-SW-Source: 2010-08/txt/msg00014.txt.bz2

> 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.