From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 32526 invoked by alias); 5 Mar 2014 01:17:33 -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 32517 invoked by uid 89); 5 Mar 2014 01:17:32 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.0 required=5.0 tests=AWL,BAYES_00,MISSING_HEADERS,RCVD_IN_DNSWL_LOW,SPF_PASS autolearn=no version=3.3.2 X-HELO: mail-pb0-f44.google.com Received: from mail-pb0-f44.google.com (HELO mail-pb0-f44.google.com) (209.85.160.44) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Wed, 05 Mar 2014 01:17:31 +0000 Received: by mail-pb0-f44.google.com with SMTP id rp16so332787pbb.31 for ; Tue, 04 Mar 2014 17:17:29 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:message-id:date:from:organization:user-agent :mime-version:cc:subject:references:in-reply-to:content-type :content-transfer-encoding; bh=I+U2x4uPrKAJZRJp2VRAsbhoUyMck5SCx+uRpw/SCic=; b=NJ+lsu7vI4ZnsYIuK2tHG0KNEZ0FD5bOtXVGPl7trkTR8DFjCmJOqPqVaPw4osNwHH PvP0h5UffLUQ7Fon1KDAajaFfqzxLmI4GUMsxy1gG2nkZJbLttTAwzKv4SuViqcf/UL0 s9tQvE2tt4O7UTExuYzCl6EZNK8tQGMSffyTjWsl/X3UXOXPe8jutQm0KBg473Yk3e2+ uuPwzWK1f4GrxH1/0sUpOEe8cwwsAkoBZcMMSXYb/UVDM0yT5BONaMXH7XOx9sflnAdt Q1Ozr7e6IU94vKQWt09TPCyudF8diHvmihpjzS5wNb8SbFqbvvVXpIkEbuipWOYnor1U BBtA== X-Gm-Message-State: ALoCoQnU9Jx7kYlTWuSBfSHTO7V6dCarYbg9E4acrNGXlaqEQ5x7sVZflaJBl7BDK5nv0WBFeuXE X-Received: by 10.68.190.200 with SMTP id gs8mr3261475pbc.130.1393982249656; Tue, 04 Mar 2014 17:17:29 -0800 (PST) Received: from tcwgrob.welcomehome.org (z88l218.static.ctm.net. [202.175.88.218]) by mx.google.com with ESMTPSA id un5sm3990989pab.3.2014.03.04.17.17.24 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 04 Mar 2014 17:17:29 -0800 (PST) Message-ID: <53167B17.1070107@linaro.org> Date: Wed, 05 Mar 2014 01:17:00 -0000 From: Rob Savoye User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 MIME-Version: 1.0 CC: gdb-patches@sourceware.org Subject: Re: [PATCH] Doxygenate gdbtypes.h References: <53151B5D.5000309@earthlink.net> <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> <531529D4.3050309@earthlink.net> <8761ntoogy.fsf@gnu.org> <53162394.3030604@earthlink.net> <83txbdrd10.fsf@gnu.org> <53162EA7.9090804@earthlink.net> In-Reply-To: <53162EA7.9090804@earthlink.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-IsSubscribed: yes X-SW-Source: 2014-03/txt/msg00100.txt.bz2 On 03/04/2014 12:51 PM, Stan Shebs wrote: > In this context, it's important that the standard says "preferred", not > "required". As we've been discussing since last August, writing > internals documentation as a separate manual in Texinfo has not worked > out for GDB. Fortunately, the general coding standards do allow > projects to set their own additional practices, where such changes > do not contradict any explicit requirements set down by the FSF. My Gnash project (a high priority project of the FSF) has used Doxygen (and Docbook) for many years, and it's never been an issue with the FSF or RMS at all, so I don't see what the problem is. - rob -