From: Randy Dunlap <randy.dunlap@oracle.com>
To: Matti Linnanvuori <mattilinnanvuori@yahoo.com>
Cc: Andrew Morton <akpm@linux-foundation.org>, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] include/linux/mutex.h: unclear reference to convention
Date: Mon, 24 Sep 2007 07:49:36 -0700 [thread overview]
Message-ID: <46F7CE80.4070805@oracle.com> (raw)
In-Reply-To: <377076.1597.qm@web52004.mail.re2.yahoo.com>
Matti Linnanvuori wrote:
> Randy Dunlap <randy.dunlap@oracle.com>:
>> Another convention is that we put kernel-doc with the implementation
>> (i.e., in .c files) when possible, not with the function prototype.
>> Of course, for inline functions or macros in header files, that's
>> where the kernel-doc has to live.
>>
>> so we don't need this patch.
>
> You should not expect that every reader of the kernel files is aware of
> that convention. I was not and therefore I sought referenced files for
> some time.
Sure, I agree with you.
Where should we put this information so that people will find it?
--
~Randy
Phaedrus says that Quality is about caring.
next prev parent reply other threads:[~2007-09-24 16:47 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-09-24 7:38 [PATCH] include/linux/mutex.h: unclear reference to convention Matti Linnanvuori
2007-09-24 14:49 ` Randy Dunlap [this message]
-- strict thread matches above, loose matches on Subject: below --
2007-09-25 8:11 Matti Linnanvuori
2007-09-25 15:33 ` Randy Dunlap
2007-09-22 8:41 Matti Linnanvuori
2007-09-22 17:35 ` Randy Dunlap
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=46F7CE80.4070805@oracle.com \
--to=randy.dunlap@oracle.com \
--cc=akpm@linux-foundation.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mattilinnanvuori@yahoo.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.