linux-kernel - [PATCH doc/rcu 0/2] Fix docbook regression

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-Id: <20171019212412.GA4995@linux.vnet.ibm.com>
Date:   Thu, 19 Oct 2017 14:24:12 -0700
From:   "Paul E. McKenney" <paulmck@...ux.vnet.ibm.com>
To:     torvalds@...ux-foundation.org
Cc:     linux-kernel@...r.kernel.org, linux-doc@...r.kernel.org,
        corbet@....net, rdunlap@...radead.org, akiyks@...il.com
Subject: [PATCH doc/rcu 0/2] Fix docbook regression

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@....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(-)