From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-111145-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 23896 invoked by alias); 15 Mar 2014 19:45:46 -0000
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
Received: (qmail 23884 invoked by uid 89); 15 Mar 2014 19:45:44 -0000
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=-2.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_LOW,SPF_PASS,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2
X-HELO: mail-ve0-f182.google.com
Received: from mail-ve0-f182.google.com (HELO mail-ve0-f182.google.com) (209.85.128.182) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Sat, 15 Mar 2014 19:45:44 +0000
Received: by mail-ve0-f182.google.com with SMTP id jw12so4269183veb.27        for <gdb-patches@sourceware.org>; Sat, 15 Mar 2014 12:45:41 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=1e100.net; s=20130820;        h=x-gm-message-state:mime-version:date:message-id:subject:from:to         :content-type;        bh=5sAQYa4LjJ5MkqSk/c1eBZTdWLFdHVy9Y+oKzzQgLtE=;        b=WJmhJgiKPhW8Eykv3XS7SR6wYdfr8j+WUcass508eTWRloyNDsU/1P2JfdMTF2zPEw         QGcscD7DN+34Gh/yBsOGR71thGfPwrEf/4AUAK38CpaFO4t7oAjR8dkqyKnArj7EaOhj         HlboWPmhvlCP95C7lzLTAkMzyqSvRgCktBsTm/8q+LmGzPsOCot0Z5rpZhX5X0D/tXyY         7f/2GrqWDqX5OZy1QRnzfP196+qS/vXPsBL+mYP3omTidNb8L71DlLJe39JlBgEDWYFV         qBtp8RUVwjUvgRL/lwyPBem3OjF+fB61QgPGfVglKbUqK1iRcqOMFe2REGI7UddA2i6T         QfvQ==
X-Gm-Message-State: ALoCoQlBdjgmx94L35A8T4Xk+bqt7XmczMY3Qp04faswg24h+uYD8UuDeF3lftIBfFGuUdykz7s9P2p4Q7E0yZxlFrpH/E3zR0FCUEnEHekD7Tl15rC0NHRi1hTdn3ODv8RH0ihzAXB1A3azNcPKtvMCMZTYMZY1AHqo3ZRNCRJrdbxSEG1gxFiewTR6G8be09sstWYrSQKvj+yduMAxN1PKCH++q95y2Q==
MIME-Version: 1.0
X-Received: by 10.52.113.1 with SMTP id iu1mr26615vdb.35.1394912741847; Sat, 15 Mar 2014 12:45:41 -0700 (PDT)
Received: by 10.52.13.101 with HTTP; Sat, 15 Mar 2014 12:45:41 -0700 (PDT)
Date: Sat, 15 Mar 2014 19:45:00 -0000
Message-ID: <CADPb22QBBrYB70YoL-Aqyfi77gphGija4zK5mSgYckwfZ7e84g@mail.gmail.com>
Subject: [RFC] Stop putting function comments in foo.h
From: Doug Evans <dje@google.com>
To: gdb-patches <gdb-patches@sourceware.org>
Content-Type: text/plain; charset=UTF-8
X-IsSubscribed: yes
X-SW-Source: 2014-03/txt/msg00343.txt.bz2

Hi.

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.