Received: by 2002:a25:6193:0:0:0:0:0 with SMTP id v141csp2158174ybb; Thu, 26 Mar 2020 23:33:12 -0700 (PDT) X-Google-Smtp-Source: ADFU+vtRhOv8jT7ioiyavIH52EPeG+Wa9KX0x5lmnkRFSqf/gLd1z0UqEAPaTUjoFEY8DZjKYgqd X-Received: by 2002:a9d:70d0:: with SMTP id w16mr9738898otj.9.1585290792840; Thu, 26 Mar 2020 23:33:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1585290792; cv=none; d=google.com; s=arc-20160816; b=VCM0rkcZEq/OFr0xCMVRJzV7TdCC3VNFGejwh1xtPL75DwWGdMcNzeYuiS0FWBe8eU wg9CKBaoC1+8eHZZFF0UeHwFDySsR5AI8L2Qm4yUmn4v4HRC35KVmWDuFeT3Cuw5PKWb JU4N/kIOkxcGrPr6735o9SGLomgJ8aOVKwjNLeFRaU59X9DngNeU+phW6Dl40ifNQyMd 7yrARlYRN7Tk+lCJBQGvEjNVEJIbWD1UfVPQHMQzGZU1/jjafzKlMtB5bm7/yBpWa3gb mR/zFlHE0NCcMAPcpl8llB5+tvtyORyul19d644CA0tGgiYRg+xo7RgsPY9cklfTSVmp FTxg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:in-reply-to:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :dkim-signature; bh=2O9jd2pG/oSZljyC88M50zjeKCi1hIq8++KZLp4WWNM=; b=NGnzCIEPojtCFKILFGjZQapkpFXoTFP//ZZ/z+/XGkJEpcbJjIawmHu4smUlijg9Ko YHv7cE7zQ5S7/2Zztq3Deb6Fi9QNqtYfL82FZlNtvT+Vz72M7Q2EX6KyWTqpPGI3Nfoi IpJpglH4rLbpyI03rHE716BvgR0QSAbSLPnNoYa+GcCotS/J6sohCeM/UZ/TLqXxMQRj ukSpZ7DRGc7yVkSNfLpmHVxXIp9Db7Sx//VUE3/qkvn/HrefvwvRbqav6sLk0RjrM0Fi m8hY9whwGHqn64IZGnMcXODKyE+a7Nbenpll2y87cacB4aJsy6Nx1ISZslJ+tRJ7OpzH r1xQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=vndsNj2a; 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id c17si2175785otr.109.2020.03.26.23.32.58; Thu, 26 Mar 2020 23:33:12 -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=vndsNj2a; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726383AbgC0Gcg (ORCPT + 99 others); Fri, 27 Mar 2020 02:32:36 -0400 Received: from mail.kernel.org ([198.145.29.99]:44420 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725992AbgC0Gcf (ORCPT ); Fri, 27 Mar 2020 02:32:35 -0400 Received: from localhost (83-86-89-107.cable.dynamic.v4.ziggo.nl [83.86.89.107]) (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 D8CFA20663; Fri, 27 Mar 2020 06:32:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1585290755; bh=ZRrCX6Kb/mbwp2oOlBAUbxjPIj5ASBM+09HqLycX7h0=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=vndsNj2aNpMgJeMQrfekwmAcagH6Rw1vkxM72gTToe9qTz5/xdFchzyh58pwc6/lP fvn10/C5aDbTKUejU8mzFzPX8JUa0qOkMlQbb68AdEVKhT6h+dXJK4u3I8LuEVijhl VbKRMQpM43X854FooyTJ/SrzWjUbpqPeF3baIEFo= Date: Fri, 27 Mar 2020 07:32:32 +0100 From: Greg Kroah-Hartman To: peter@bikeshed.quignogs.org.uk Cc: Matthew Wilcox , linux-kernel@vger.kernel.org, "Rafael J. Wysocki" , linux-doc@vger.kernel.org, Jonathan Corbet Subject: Re: [PATCH v3 1/1] A compact idiom to add code examples in kerneldoc comments. Message-ID: <20200327063232.GF1601217@kroah.com> References: <20200326192947.GM22483@bombadil.infradead.org> <20200326195156.11858-1-peter@bikeshed.quignogs.org.uk> <20200326195156.11858-2-peter@bikeshed.quignogs.org.uk> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200326195156.11858-2-peter@bikeshed.quignogs.org.uk> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, Mar 26, 2020 at 07:51:56PM +0000, peter@bikeshed.quignogs.org.uk wrote: > From: Peter Lister > > scripts/kernel-doc - When a double colon follows a section heading > (e.g. Example::), write a double colon line to the ReST output to make > the following text (e.g. a code snippet) into a literal block. > > drivers/base/platform.c - Changed Example: headings to Example:: to > literalise code snippets as above. > > This patch also removes two kerneldoc build warnings: > ./drivers/base/platform.c:134: WARNING: Unexpected indentation. > ./drivers/base/platform.c:213: WARNING: Unexpected indentation. > > Signed-off-by: Peter Lister > --- > drivers/base/platform.c | 4 ++-- > scripts/kernel-doc | 19 +++++++++++++++---- > 2 files changed, 17 insertions(+), 6 deletions(-) For the driver/base/platform.c change: Reviewed-by: Greg Kroah-Hartman