Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752162AbdIRHaR convert rfc822-to-8bit (ORCPT ); Mon, 18 Sep 2017 03:30:17 -0400 Received: from smtp3.goneo.de ([85.220.129.37]:55432 "EHLO smtp3.goneo.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751938AbdIRHaP (ORCPT ); Mon, 18 Sep 2017 03:30:15 -0400 X-Spam-Flag: NO X-Spam-Score: -2.776 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Subject: Re: rcu kernel-doc issues (4.14-rc1) From: Markus Heiser In-Reply-To: <20170918024013.GA27294@linux.vnet.ibm.com> Date: Mon, 18 Sep 2017 09:30:01 +0200 Cc: Randy Dunlap , LKML , Linux Doc Mailing List Content-Transfer-Encoding: 8BIT Message-Id: <5651996D-F075-48A5-BC3A-9FE0537824A6@darmarit.de> References: <20170917044145.GZ3521@linux.vnet.ibm.com> <20170917174716.GA3611@linux.vnet.ibm.com> <20170917194910.GC3521@linux.vnet.ibm.com> <20170918024013.GA27294@linux.vnet.ibm.com> To: "Paul E. McKenney" , Jonathan Corbet X-Mailer: Apple Mail (2.3273) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1066 Lines: 36 > Am 18.09.2017 um 04:40 schrieb Paul E. McKenney : [...] > And after some playing around, I did get rid of the error messages. > The code-block output looks a bit strange though, hints? I preceded > the code block with "::", again at Akira's suggestion. It looks fine > except for the :c:func: and backquotes on the first and last lines. > > Thanx, Paul > > ------------------------------------------------------------------------ > > :c:func:`rcu_read_lock()`; > p = rcu_dereference(gp); > long_lived = is_long_lived(p); > if (long_lived) { > if (!atomic_inc_not_zero(p->refcnt)) > long_lived = false; > else > p = rcu_pointer_handoff(p); > } > :c:func:`rcu_read_unlock()`; FYI: such replacements in code-blocks are comming from the "Highlights and cross-references" see: https://www.kernel.org/doc/html/latest/doc-guide/kernel-doc.html#highlights-and-cross-references and this is still a bug in the kernel-doc parser: https://www.mail-archive.com/linux-doc@vger.kernel.org/msg14409.html -- Markus --