From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14467 invoked by alias); 4 Mar 2014 18:18:06 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 14448 invoked by uid 89); 4 Mar 2014 18:18:04 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.5 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=3.3.2 X-HELO: rock.gnat.com Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-SHA encrypted) ESMTPS; Tue, 04 Mar 2014 18:18:04 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 397FB1165D5; Tue, 4 Mar 2014 13:18:02 -0500 (EST) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id DKvx8qpNJ2MA; Tue, 4 Mar 2014 13:18:02 -0500 (EST) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 11DDA116274; Tue, 4 Mar 2014 13:18:01 -0500 (EST) Received: by joel.gnat.com (Postfix, from userid 1000) id A7E43E07DD; Tue, 4 Mar 2014 10:18:03 -0800 (PST) Date: Tue, 04 Mar 2014 18:18:00 -0000 From: Joel Brobecker To: Ludovic =?iso-8859-1?Q?Court=E8s?= Cc: gdb-patches@sourceware.org Subject: Re: [PATCH] Doxygenate gdbtypes.h Message-ID: <20140304181803.GE4893@adacore.com> References: <53151B5D.5000309@earthlink.net> <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> <531529D4.3050309@earthlink.net> <8761ntoogy.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <8761ntoogy.fsf@gnu.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-SW-Source: 2014-03/txt/msg00081.txt.bz2 > Just because some GNU packages use Doxygen (or CMake, or...) doesn’t > mean it’s a good idea; and it remains a GCS violation. > > > Two extra characters per comment block is not a "lot of random > > garbage" or "vandalism" - over-the-top statements like that are not > > going to convince anybody of anything. > > GNU has a history of well-written documentation and well-commented code. > The rationale is documented, and IMO still holds. > > As a GNU user and hacker, I’ve long appreciated GNU’s luxurious approach. > In contrast, I view the approach that Doxygen, Javadoc & co. favor as an > insult to the reader. > I don't know yet how much I like Stan's approach and Doxygen, but I support him in his efforts. And I need to also say that I am tired of comments like this one that simply denegate someone's effort without providing alternatives. And, I mean, real work. Not just shoulda/coulda/ woulda. What Mark and yourself are saying might be true, but you chose to just criticize without substance. So I invite Stan and others to simply ignore this destructive type of criticism, and I invite you to stop sending it in that form. I know both of you have a rich history of contributing to various GNU projects, or free software in general, and I am not attacking that. But someone is trying to improve our documentation, and the only suitable answers are, IMO, to either support him, and guide him towards alternatives. -- Joel