From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751029AbdL3J6Y (ORCPT ); Sat, 30 Dec 2017 04:58:24 -0500 Received: from out2-smtp.messagingengine.com ([66.111.4.26]:52223 "EHLO out2-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750886AbdL3J6X (ORCPT ); Sat, 30 Dec 2017 04:58:23 -0500 X-ME-Sender: Date: Sat, 30 Dec 2017 20:58:12 +1100 From: "Tobin C. Harding" To: Jonathan Cameron Cc: Hartmut Knaack , Lars-Peter Clausen , Peter Meerwald-Stadler , linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] iio: add kernel-doc '@owner' Message-ID: <20171230095812.GB6042@caerus> References: <1513664270-29523-1-git-send-email-me@tobin.cc> <20171229173640.5fd6e649@archlinux> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20171229173640.5fd6e649@archlinux> X-Mailer: Mutt 1.5.24 (2015-08-30) User-Agent: Mutt/1.5.24 (2015-08-30) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Dec 29, 2017 at 05:36:40PM +0000, Jonathan Cameron wrote: > On Tue, 19 Dec 2017 17:17:50 +1100 > "Tobin C. Harding" wrote: > > > When building kernel documentation sphinx emits the following warning > > > > warning: No description found for parameter 'owner' > > > > Add description for struct member 'owner'. > > > > Signed-off-by: Tobin C. Harding > > --- > > > > I couldn't work out what DRIVER/INTERN were for so I took a guess. > Try the other one ;) > > They refer to whether the driver should be directly accessing the > field or not. In the case of owner they shouldn't be so it is INTERN. > > Were I writing the subsystem from scratch again I'd probably make the > separation of the two cleaner, but there we are. Thanks, will re-spin after Christmas break. Tobin