Received: by 10.223.176.5 with SMTP id f5csp1371670wra; Wed, 7 Feb 2018 18:27:45 -0800 (PST) X-Google-Smtp-Source: AH8x225LyYbF5EqZJBiSt781w/Fw+iCIT+fl9+zyOFSK7ffKpeoTHI87UM6cDSltFh5MXEvqHwDb X-Received: by 2002:a17:902:7614:: with SMTP id k20-v6mr8031989pll.343.1518056865318; Wed, 07 Feb 2018 18:27:45 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518056865; cv=none; d=google.com; s=arc-20160816; b=VThOK0xn8dUIHDeF7FY9tVTmIGLoDClfOfRkuRP8Rf0ZaC5/bHxKuavAy76oG0vMmk fr5cX5sxcYtLpFy/ffafdT0Sw+Vmp2o3B+zI+VW1vHK07uO/U4nBZTolHI/v/e2Q86VE WjHKD5vevcgjRzuxZ3WuRZbqSA3xKkU/PmMztPm0TdYZ+NmrrKX6zxOw8Y2X8O5f77Hy e38ZxGuwTcXT/QFH2dL+7VBeL+0M86V1817z2OtlMLQUkk6Qkz8uvhbMUz+bQgM4O/4N VOm/ry/86laT3C++XbBk/gV+lgjG+rwaGiz8GePh6/RkWcdJzLQXLGLPG5dddwX8GwxX tXAQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:dkim-signature:dkim-signature :arc-authentication-results; bh=OQ8OwWhzV0N53ezAprqE2L5KWc6Q9VeLeVWgFaCgXZI=; b=eHqUGOJcEjTINIYKEeslaCZiWFeoBKFgCZJhZ8tpftDbQ3P4JdMGREw/pZnTJ5tmyw tmYw/1P72PopmOzP5Liif9bYsMEpXhLxJSH7M6y2lztRAG/i3eUCYhRfpx0ei7SGsqKe BIyAo4LI+mDMGG0Y2VvC9Ia24Zv10mOWjFfwE8sfs6FFbNtjNucR8K58cbYeAfMLRr+q P401BdzKLLA7pcW8EoKgWDYoOi6WcFKA+c9sEigSew1nn4XE1THmszNgP2aYDhx8sD/D 0512khT44V9XzC1nYocboYLyp+z8XPC5kC8QINdV45H9qu/cAqA+ouEJ5arV+cIdAzKI J7yQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@tobin.cc header.s=fm2 header.b=IwkTOkgI; dkim=pass header.i=@messagingengine.com header.s=fm1 header.b=ZWt721/s; 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 l67si374432pga.687.2018.02.07.18.27.19; Wed, 07 Feb 2018 18:27:45 -0800 (PST) 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=@tobin.cc header.s=fm2 header.b=IwkTOkgI; dkim=pass header.i=@messagingengine.com header.s=fm1 header.b=ZWt721/s; 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 S1751878AbeBHC0R (ORCPT + 99 others); Wed, 7 Feb 2018 21:26:17 -0500 Received: from out2-smtp.messagingengine.com ([66.111.4.26]:32829 "EHLO out2-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751554AbeBHC0P (ORCPT ); Wed, 7 Feb 2018 21:26:15 -0500 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id E973020784; Wed, 7 Feb 2018 21:26:14 -0500 (EST) Received: from frontend2 ([10.202.2.161]) by compute5.internal (MEProxy); Wed, 07 Feb 2018 21:26:14 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobin.cc; h=cc :content-type:date:from:in-reply-to:message-id:mime-version :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=OQ8OwWhzV0N53ezAprqE2L5KWc6Q9VeLeVWgFaCgXZI=; b=IwkTOkgI w0m4i5RI1/szRjNcVKo1z2D4X0HukxKGG5x1TCz5j/eZVK8hehuyZYAZ004CWoEz 7GK0VySg2UFArIJPk/kML3wZVHbxTYe98XSredxrVHpsBp0xF1f8oOJkfsrep5/Q vP3LWN4vTIfnzo9Wa5TILXDFksA9/K8KjOicMmr1FrJMLOJ74H5MZdgBLwmvc4C+ nDdkQJwFKZ+PwS6DXLdjXL1zVL3eVGmnyK/24Y8zudOclnonFA84RSLRJvBquMQW 2DYBzLbcJIZR0rCm5uK6RwEmout9vsIQShAXQQe21tBeDgq66Qs5D3Vl5foItzyu ++qX5SzKkxAzqA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-sender :x-me-sender:x-sasl-enc; s=fm1; bh=OQ8OwWhzV0N53ezAprqE2L5KWc6Q9 VeLeVWgFaCgXZI=; b=ZWt721/sHleBLl9EnZcLo6W/lw4ikCVGalgtguT7JPkL9 2ZBFV/1cCQmkStCnqZZfLc1ByegoKFuoeJmpahWfbWrZZupsfTXM0jyDp8gD+LE6 Swpblnz9dIuMW2AyCKUnBB4FBy1p9A0Q8BWjkjFswDSkaMNB44PN3aAHhAW44w54 UT3cIGQIwk5gDjPDXt/jxsMzBzRdH4a4uYx3hYpOll3PVAcLCkD16kJTv6bmWw3W PU3J/35+Wl0bPe9egjqDhHAbUO/fkbgH6dBzjoTjsei0UvEB/+Zd0Vj/C7RIa9u2 v8vepf8a6Pm3GwRA7xVc+OfhcKI+jNIZMf2Ta2njg== X-ME-Sender: Received: from localhost (202-159-155-205.dyn.iinet.net.au [202.159.155.205]) by mail.messagingengine.com (Postfix) with ESMTPA id 2BE8724636; Wed, 7 Feb 2018 21:26:13 -0500 (EST) Date: Thu, 8 Feb 2018 13:26:11 +1100 From: "Tobin C. Harding" To: Jonathan Corbet Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, mchehab@kernel.org Subject: Re: [PATCH 0/8] Clean up kernel-doc and fix literal-block handling Message-ID: <20180208022611.GA3304@eros> References: <20180207172624.24555-1-corbet@lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180207172624.24555-1-corbet@lwn.net> 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 Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, Feb 07, 2018 at 10:26:16AM -0700, Jonathan Corbet wrote: > So once upon a time I set out to fix the problem reported by Tobin wherein > a literal block within a kerneldoc comment would be corrupted in > processing. On the way, though, I got annoyed at the way I have to learn > how kernel-doc works from the beginning every time I tear into it. Awesome. The patch that exposed that problem hasn't landed yet but I tested this series and can confirm that it fixes it. FTR to test I did: - update function docs for include/linux/rcupdate.h:rcu_pointer_hadoff() removed enclosing '``' and added leading '::' - apply this series - rebuild docs - profit thanks, Tobin.