Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753971AbdIROVO (ORCPT ); Mon, 18 Sep 2017 10:21:14 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:40253 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753139AbdIROVM (ORCPT ); Mon, 18 Sep 2017 10:21:12 -0400 Date: Mon, 18 Sep 2017 07:21:09 -0700 From: "Paul E. McKenney" To: Markus Heiser Cc: Jonathan Corbet , Randy Dunlap , LKML , Linux Doc Mailing List Subject: Re: rcu kernel-doc issues (4.14-rc1) Reply-To: paulmck@linux.vnet.ibm.com 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> <5651996D-F075-48A5-BC3A-9FE0537824A6@darmarit.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5651996D-F075-48A5-BC3A-9FE0537824A6@darmarit.de> User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-GCONF: 00 x-cbid: 17091814-0048-0000-0000-000001E702FE X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00007756; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000229; SDB=6.00918821; UDB=6.00461583; IPR=6.00699048; BA=6.00005594; NDR=6.00000001; ZLA=6.00000005; ZF=6.00000009; ZB=6.00000000; ZP=6.00000000; ZH=6.00000000; ZU=6.00000002; MB=3.00017195; XFM=3.00000015; UTC=2017-09-18 14:21:10 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17091814-0049-0000-0000-000042998BE2 Message-Id: <20170918142109.GH3521@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-09-18_04:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=0 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1707230000 definitions=main-1709180207 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1317 Lines: 39 On Mon, Sep 18, 2017 at 09:30:01AM +0200, Markus Heiser wrote: > > > 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 Thank you for the pointer! I will try it out. Except that v4.14-rc1 apparently needs a later version of sphinx... Thanx, Paul