Date: Thu, 20 Mar 2008 15:10:54 -0700 (PDT)
Message-Id: <20080320.151054.41532763.davem@davemloft.net>
To: linville@tuxdriver.com
Cc: johannes@sipsolutions.net, sam@ravnborg.org, dsd@gentoo.org,
       linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org,
       netdev@vger.kernel.org
Subject: Re: [PATCH/RFC v2] introduce ARCH_CAN_UNALIGNED_ACCESS Kconfig
 symbol
From: David Miller <davem@davemloft.net>
In-Reply-To: <20080320220348.GC1330@tuxdriver.com>
References: <20080320.141307.173590705.davem@davemloft.net>
	<1206048106.16475.161.camel@johannes.berg>
	<20080320220348.GC1330@tuxdriver.com>
Mime-Version: 1.0
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 827
Lines: 18

From: "John W. Linville" <linville@tuxdriver.com>
Date: Thu, 20 Mar 2008 18:03:48 -0400

> While I think Dave has a point, I don't think you should labor the word
> choice too much.  Try to document it as clearly as possible and hope
> for the best -- I hear that the arch maintainers are top notch! :-)

I think the name of the macro is very important.

Non-arch people will see this thing and wonder what in the
world it means.  You can document something with kerneldoc
foo as much as you like, still the initial impression the
reader gets from the name is of utmost importance.
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/