From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5921 invoked by alias); 4 Mar 2014 17:36:56 -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 5911 invoked by uid 89); 4 Mar 2014 17:36:55 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.7 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 X-HELO: plane.gmane.org Received: from plane.gmane.org (HELO plane.gmane.org) (80.91.229.3) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-SHA encrypted) ESMTPS; Tue, 04 Mar 2014 17:36:53 +0000 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1WKtGm-0001VO-AQ for gdb-patches@sourceware.org; Tue, 04 Mar 2014 18:36:44 +0100 Received: from pluto.bordeaux.inria.fr ([193.50.110.57]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 04 Mar 2014 18:36:44 +0100 Received: from ludo by pluto.bordeaux.inria.fr with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 04 Mar 2014 18:36:44 +0100 To: gdb-patches@sourceware.org From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH] Doxygenate gdbtypes.h Date: Tue, 04 Mar 2014 17:36:00 -0000 Message-ID: <8761ntoogy.fsf@gnu.org> References: <53151B5D.5000309@earthlink.net> <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> <531529D4.3050309@earthlink.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 14 =?utf-8?Q?Vent=C3=B4se?= an 222 de la =?utf-8?Q?R?= =?utf-8?Q?=C3=A9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu User-Agent: Gnus/5.130007 (Ma Gnus v0.7) Emacs/24.3 (gnu/linux) X-IsSubscribed: yes X-SW-Source: 2014-03/txt/msg00079.txt.bz2 Stan Shebs skribis: > Give the histrionics a rest, please. You claimed it was against policy, > but then you never replied when I asked what specific policy > is being violated. 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. So I can sympathize with Mark’s comment. Thanks, Ludo’.