From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752706AbdJSVYT (ORCPT ); Thu, 19 Oct 2017 17:24:19 -0400 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:60136 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751458AbdJSVYR (ORCPT ); Thu, 19 Oct 2017 17:24:17 -0400 Date: Thu, 19 Oct 2017 14:24:12 -0700 From: "Paul E. McKenney" To: torvalds@linux-foundation.org Cc: linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, corbet@lwn.net, rdunlap@infradead.org, akiyks@gmail.com Subject: [PATCH doc/rcu 0/2] Fix docbook regression Reply-To: paulmck@linux.vnet.ibm.com MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-GCONF: 00 x-cbid: 17101921-0048-0000-0000-000001F84D2B X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00007920; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000238; SDB=6.00933547; UDB=6.00470223; IPR=6.00713835; BA=6.00005651; NDR=6.00000001; ZLA=6.00000005; ZF=6.00000009; ZB=6.00000000; ZP=6.00000000; ZH=6.00000000; ZU=6.00000002; MB=3.00017613; XFM=3.00000015; UTC=2017-10-19 21:24:14 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17101921-0049-0000-0000-000042EC874E Message-Id: <20171019212412.GA4995@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:,, definitions=2017-10-19_11:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1707230000 definitions=main-1710190292 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hello, Linus, Commit 764f80798b95 ("doc: Add RCU files to docbook-generation files"), which is in v4.14-rc1, added :external: options for RCU source files in the file Documentation/core-api/kernel-api.rst. However, this now means nothing, and furthermore breaks builds of the docbook, which has led to popular demand for this to be fixed in v4.14: lkml.kernel.org/r/20171018100340.7f34aace@lwn.net This series therefore contains the following two patches: 1. Remove the erroneous :external: options. 2. Fix the many docbook build complaints that have crept into RCU's docbook comment headers. These fixes include one non-comment change where the name of rcu_sync_func()'s argument is changed to match RCU convention. Thanx, Paul ------------------------------------------------------------------------ Documentation/core-api/kernel-api.rst | 14 -------------- include/linux/rculist.h | 2 +- include/linux/rcupdate.h | 22 ++++++++++++++-------- include/linux/srcu.h | 1 + kernel/rcu/srcutree.c | 2 +- kernel/rcu/sync.c | 9 ++++++--- kernel/rcu/tree.c | 18 ++++++++++-------- 7 files changed, 33 insertions(+), 35 deletions(-)