Received: by 10.192.165.148 with SMTP id m20csp3317407imm; Mon, 7 May 2018 10:08:46 -0700 (PDT) X-Google-Smtp-Source: AB8JxZorZ4IppVDgaho1MZCoAVk0AK0YD5e5QGKCuz9mEElYpwGxiAgvO22pRI+OzHV5wJ7VcbnE X-Received: by 2002:a6b:a9d1:: with SMTP id f78-v6mr38382235ioj.277.1525712926261; Mon, 07 May 2018 10:08:46 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1525712926; cv=none; d=google.com; s=arc-20160816; b=z2cHrv1/cO1CbpqDfwEKxtgbWzvBJPr3UeH2PtpdpI4TACKi4ZMiILQhblFbkH4GEX Ym9PLUrz+PFVd7CqXEoFAhKnx3x9Jg71uV4Lv26diP/iQyS+EW9i985UtbRKrsH58ycO ailTZnTuZX9VAlhx5MjLMmdTz2DyepsqHn2vc/UcGAQZE4RO2qgkzC9FihdmgpmT3X/L EqbrroCjsYdhdTrag6Yf2u/wRdyG3S7YXntuhTfSWl/Aespt9tQbGKJ+rLIJtzp/jJP+ dJMZ0IpxR1EbAdCqnGPrzwC3IvybwUB1irRZF1lZ0D6viSyEsG/h3BjX0DSwNFNsTZmw JXEg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:subject:cc:to:from:date :dkim-signature:arc-authentication-results; bh=BxDdqi9vwaDh6xe6LcOs4P4+tat21k+VxY6ZkCz87hM=; b=nms7iOEgfgHooS+WbdakvynsPv4dqnUdHCebudxSOJmrsl/b2OGd8Gg7mwUuP/WAJR WpHWqNvfleDMYdtVN6iYfDYVjDVe3sEUVK/uBXf0yo/cud87YsCL6J8M5pxNKvdeNvms 8q/WvGZpRuT9Qd+RJdMwKugqtKNTwKhouiKQ2GTDsTkoLSO0huJ0tIOo5ItPbqqRLmjx B81L1nCU3rcIH91Ofv/M8lz2xeHnZSpYXkV0A2nQzmoIaspmHmraVGoXyaJ4hh/QtUZv SSYPeG9Cl2PsapzlxmCnr3rEdSYiH7ScfymqzEBjDNz0oeSXwcx5yrQ6Qfn+8xxUk8iH CZlA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=Qs97S64A; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id i1-v6si21408420ioa.255.2018.05.07.10.08.32; Mon, 07 May 2018 10:08:46 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=Qs97S64A; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752376AbeEGRIK (ORCPT + 99 others); Mon, 7 May 2018 13:08:10 -0400 Received: from mail.kernel.org ([198.145.29.99]:37046 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752020AbeEGRIJ (ORCPT ); Mon, 7 May 2018 13:08:09 -0400 Received: from archlinux (cpc91196-cmbg18-2-0-cust659.5-4.cable.virginm.net [81.96.234.148]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 5C07C214DA; Mon, 7 May 2018 17:08:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1525712888; bh=qCy/xl16dNSm+nNL9JF0nqJqVabOrAIItvaUWREnMGo=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=Qs97S64ATDSb5QdEa0nFTXbXejMNt0E7VuhGkz9cJ2UDqqchqHOEoepBcm/HusAE4 7pnZ/4rYlsOIAZj+tbXa9TSqu9AW0HrfXzbBy3LAoaY81J/VgM2FLGXadoLdYwYtyI FWCpMCEgFmhN+5cenImmbIZH0QXc6+5cDW10DNRg= Date: Mon, 7 May 2018 18:08:03 +0100 From: Jonathan Cameron To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Hartmut Knaack , Lars-Peter Clausen , Peter Meerwald-Stadler , linux-iio@vger.kernel.org Subject: Re: [PATCH 15/18] iio: iio.h: use nested struct support on kernel-doc markup Message-ID: <20180507180803.21e967b2@archlinux> In-Reply-To: <1a31240699b1b6ee089b5b36889ab27ae14ad94e.1525684985.git.mchehab+samsung@kernel.org> References: <1a31240699b1b6ee089b5b36889ab27ae14ad94e.1525684985.git.mchehab+samsung@kernel.org> X-Mailer: Claws Mail 3.16.0 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 7 May 2018 06:35:51 -0300 Mauro Carvalho Chehab wrote: > Solve those Sphinx warnings: > > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.sign' not described in 'iio_chan_spec' > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.realbits' not described in 'iio_chan_spec' > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.storagebits' not described in 'iio_chan_spec' > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.shift' not described in 'iio_chan_spec' > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.repeat' not described in 'iio_chan_spec' > ./include/linux/iio/iio.h:270: warning: Function parameter or member 'scan_type.endianness' not described in 'iio_chan_spec' > > ./include/linux/iio/iio.h:191: WARNING: Unexpected indentation. > ./include/linux/iio/iio.h:192: WARNING: Block quote ends without a blank line; unexpected unindent. > ./include/linux/iio/iio.h:198: WARNING: Definition list ends without a blank line; unexpected unindent. > > Signed-off-by: Mauro Carvalho Chehab Great thanks. I couldn't figure out how to do this last time I looked at it. Applied to the togreg branch of iio.git and pushed out as testing for the autobuilders to ignore it. Thanks, Jonathan > --- > include/linux/iio/iio.h | 24 ++++++++++++------------ > 1 file changed, 12 insertions(+), 12 deletions(-) > > diff --git a/include/linux/iio/iio.h b/include/linux/iio/iio.h > index 11579fd4126e..a74cb177dc6f 100644 > --- a/include/linux/iio/iio.h > +++ b/include/linux/iio/iio.h > @@ -183,18 +183,18 @@ struct iio_event_spec { > * @address: Driver specific identifier. > * @scan_index: Monotonic index to give ordering in scans when read > * from a buffer. > - * @scan_type: sign: 's' or 'u' to specify signed or unsigned > - * realbits: Number of valid bits of data > - * storagebits: Realbits + padding > - * shift: Shift right by this before masking out > - * realbits. > - * repeat: Number of times real/storage bits > - * repeats. When the repeat element is > - * more than 1, then the type element in > - * sysfs will show a repeat value. > - * Otherwise, the number of repetitions is > - * omitted. > - * endianness: little or big endian > + * @scan_type: struct describing the scan type > + * @scan_type.sign: 's' or 'u' to specify signed or unsigned > + * @scan_type.realbits: Number of valid bits of data > + * @scan_type.storagebits: Realbits + padding > + * @scan_type.shift: Shift right by this before masking out > + * realbits. > + * @scan_type.repeat: Number of times real/storage bits repeats. > + * When the repeat element is more than 1, then > + * the type element in sysfs will show a repeat > + * value. Otherwise, the number of repetitions > + * is omitted. > + * @scan_type.endianness: little or big endian > * @info_mask_separate: What information is to be exported that is specific to > * this channel. > * @info_mask_separate_available: What availability information is to be