From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755622AbcBHQ4I (ORCPT ); Mon, 8 Feb 2016 11:56:08 -0500 Received: from mezzanine.sirena.org.uk ([106.187.55.193]:40242 "EHLO mezzanine.sirena.org.uk" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754541AbcBHQ4G (ORCPT ); Mon, 8 Feb 2016 11:56:06 -0500 Date: Mon, 8 Feb 2016 16:55:56 +0000 From: Mark Brown To: Randy Dunlap Cc: LKML , linux-spi@vger.kernel.org, Andrew Morton Message-ID: <20160208165556.GJ7265@sirena.org.uk> References: <56B54CFB.9050904@infradead.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="aznLbwQ42o7LEaqN" Content-Disposition: inline In-Reply-To: <56B54CFB.9050904@infradead.org> X-Cookie: All work and no pay makes a housewife. User-Agent: Mutt/1.5.24 (2015-08-30) X-SA-Exim-Connect-IP: 2a01:348:6:8808:fab::3 X-SA-Exim-Mail-From: broonie@sirena.org.uk Subject: Re: [PATCH] spi: fix spi.h kernel-doc warning X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000) X-SA-Exim-Scanned: Yes (on mezzanine.sirena.org.uk) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org --aznLbwQ42o7LEaqN Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Feb 05, 2016 at 05:31:39PM -0800, Randy Dunlap wrote: > From: Randy Dunlap >=20 > Fix kernel-doc warning for missing struct field notation. >=20 > ..//include/linux/spi/spi.h:540: warning: No description found for parame= ter 'max_transfer_size' The patch description and especially subject here should be something along the lines of "Document max_transfer_size" - describe what you think the change is. --aznLbwQ42o7LEaqN Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBCAAGBQJWuMibAAoJECTWi3JdVIfQAEgH/jIPh473DFX+9FjO6QrUa2Vh l8gPzzTyHNNagbYAfKj+P7Hvgd2JeEzC9oE3T+86Jg2Z7HU6s8jdLsaDwbOzi8yM /nctV09QhgMbKZkzReQYUbxLdstMwTDVGorofDix5EOtbiv80ipH4/6uhnNw1wVW pV8oKPFl6X58gqU6LwSsEwgRUHIc/f+SozXgCb9Vqh07Dft3/H8byWH5K8w6zuep nZIsYH17HmOD5ttg0MxNCwEcnVXwcjmWRnWXTFxhhYB16pQox1zysA1vKrNvcN/Y ByWYBA6hF9Xo5IESrBOCB2RLbJc/hC4OHN3wpbQlR+BtptsX7mFaD/f59u5h3q8= =14BG -----END PGP SIGNATURE----- --aznLbwQ42o7LEaqN--