From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 17278 invoked by alias); 17 Mar 2014 13:44:39 -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 17265 invoked by uid 89); 17 Mar 2014 13:44:39 -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; Mon, 17 Mar 2014 13:44:38 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 886A71162E9; Mon, 17 Mar 2014 09:44:36 -0400 (EDT) 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 pj1FDxNNuurz; Mon, 17 Mar 2014 09:44:36 -0400 (EDT) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 588A71162E1; Mon, 17 Mar 2014 09:44:36 -0400 (EDT) Received: by joel.gnat.com (Postfix, from userid 1000) id 071A9E0D11; Mon, 17 Mar 2014 06:44:36 -0700 (PDT) Date: Mon, 17 Mar 2014 13:44:00 -0000 From: Joel Brobecker To: Doug Evans Cc: gdb-patches Subject: Re: [RFC] Stop putting function comments in foo.h Message-ID: <20140317134435.GA4282@adacore.com> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) X-SW-Source: 2014-03/txt/msg00360.txt.bz2 > I'd like to start a discussion. > With doxygen is there still as much value to putting function comments > in foo.h instead of foo.c? > > I ask because every time I find a "See foo.h." comment I get depressed > and disappointed. They're just getting in my way, and I'm wondering > if it's just me. I have a preference, but only a slight one, towards putting the comments in the .c file. -- Joel