From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
To: Linux Doc Mailing List <linux-doc@vger.kernel.org>
Cc: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,
linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
"David S. Miller" <davem@davemloft.net>,
Josh Triplett <josh@joshtriplett.org>,
Vito Caputo <vcaputo@pengaru.com>,
Alexey Dobriyan <adobriyan@gmail.com>,
Jakub Kicinski <kuba@kernel.org>,
Davidlohr Bueso <dave@stgolabs.net>,
Joe Stringer <joe@wand.net.nz>,
Joel Fernandes <joel@joelfernandes.org>,
Martin KaFai Lau <kafai@fb.com>,
Lai Jiangshan <jiangshanlai@gmail.com>,
Thomas Gleixner <tglx@linutronix.de>,
Daniel Borkmann <daniel@iogearbox.net>,
Eric Dumazet <edumazet@google.com>,
Peter Zijlstra <peterz@infradead.org>,
Jakub Sitnicki <jakub@cloudflare.com>,
rcu@vger.kernel.org, Ingo Molnar <mingo@redhat.com>,
"Paul E. McKenney" <paulmck@kernel.org>,
zhanglin <zhang.lin16@zte.com.cn>,
netdev@vger.kernel.org,
Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
Will Deacon <will@kernel.org>,
Steven Rostedt <rostedt@goodmis.org>,
Mathieu Desnoyers <mathieu.desnoyers@efficios.com>,
Rob Herring <robh@kernel.org>
Subject: [PATCH 00/10] Manually convert RCU text files to ReST format
Date: Tue, 21 Apr 2020 19:04:01 +0200 [thread overview]
Message-ID: <cover.1587488137.git.mchehab+huawei@kernel.org> (raw)
This patch series convert RCU patches to ReST.
One interesting point to be noticed hereis that the RTFP.txt file contain a
broken TeX bib file. I suspect that someone added some new articles
directly there without trying to use LaTeX to check if the addition is
valid. Or maybe it is just due to some version differences from the time
such references were added.
During the RTFP.txt conversion, I fixed the bibtex problems in order for it
to be properly parsed by LaTeX, and used the fixed file to produce a list of
the actually used references inside the RTFP.txt file., manually adding them
to the converted RTFP.rst.
As not all references were mentioned there, I opted to preserve the
converted RTFP.bib, as it could be useful for someone doing any
research around RCU.
The results of those changes (together with other changes from my pending
doc patches) are available at:
https://www.infradead.org/~mchehab/kernel_docs/RCU/index.html
And the series is on my git tree:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=rcu-docs
Mauro Carvalho Chehab (10):
docs: RCU: convert checklist.txt to ReST
docs: RCU: convert lockdep-splat.txt to ReST
docs: RCU: convert lockdep.txt to ReST
docs: RCU: convert rculist_nulls.txt to ReST
docs: RCU: convert torture.txt to ReST
docs: RCU: convert rcuref.txt to ReST
docs: RCU: RTFP: fix bibtex entries
docs: RCU: convert RTFP.txt to ReST
docs: RCU: stallwarn.txt: convert it to ReST
docs: RCU: rculist_nulls.rst: don't duplicate chapter names
Documentation/RCU/{RTFP.txt => RTFP.bib} | 323 ++--------
Documentation/RCU/RTFP.rst | 593 ++++++++++++++++++
.../RCU/{checklist.txt => checklist.rst} | 17 +-
Documentation/RCU/index.rst | 11 +
.../{lockdep-splat.txt => lockdep-splat.rst} | 99 +--
.../RCU/{lockdep.txt => lockdep.rst} | 12 +-
Documentation/RCU/rcu.rst | 4 +-
Documentation/RCU/rculist_nulls.rst | 200 ++++++
Documentation/RCU/rculist_nulls.txt | 172 -----
Documentation/RCU/{rcuref.txt => rcuref.rst} | 193 +++---
.../RCU/{stallwarn.txt => stallwarn.rst} | 55 +-
.../RCU/{torture.txt => torture.rst} | 115 ++--
Documentation/locking/locktorture.rst | 2 +-
MAINTAINERS | 4 +-
include/linux/rculist_nulls.h | 2 +-
kernel/rcu/rcutorture.c | 2 +-
kernel/rcu/tree_stall.h | 4 +-
net/core/sock.c | 4 +-
18 files changed, 1139 insertions(+), 673 deletions(-)
rename Documentation/RCU/{RTFP.txt => RTFP.bib} (82%)
create mode 100644 Documentation/RCU/RTFP.rst
rename Documentation/RCU/{checklist.txt => checklist.rst} (98%)
rename Documentation/RCU/{lockdep-splat.txt => lockdep-splat.rst} (54%)
rename Documentation/RCU/{lockdep.txt => lockdep.rst} (96%)
create mode 100644 Documentation/RCU/rculist_nulls.rst
delete mode 100644 Documentation/RCU/rculist_nulls.txt
rename Documentation/RCU/{rcuref.txt => rcuref.rst} (50%)
rename Documentation/RCU/{stallwarn.txt => stallwarn.rst} (90%)
rename Documentation/RCU/{torture.txt => torture.rst} (76%)
--
2.25.2
next reply other threads:[~2020-04-21 17:05 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-04-21 17:04 Mauro Carvalho Chehab [this message]
2020-04-21 17:04 ` [PATCH 01/10] docs: RCU: convert checklist.txt to ReST Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 02/10] docs: RCU: convert lockdep-splat.txt " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 03/10] docs: RCU: convert lockdep.txt " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 04/10] docs: RCU: convert rculist_nulls.txt " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 05/10] docs: RCU: convert torture.txt " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 06/10] docs: RCU: convert rcuref.txt " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 07/10] docs: RCU: RTFP: fix bibtex entries Mauro Carvalho Chehab
2020-04-21 17:43 ` Paul E. McKenney
2020-04-21 17:52 ` Paul E. McKenney
2020-04-21 19:29 ` Mauro Carvalho Chehab
2020-04-22 0:42 ` Paul E. McKenney
2020-04-21 17:04 ` [PATCH 08/10] docs: RCU: convert RTFP.txt to ReST Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 09/10] docs: RCU: stallwarn.txt: convert it " Mauro Carvalho Chehab
2020-04-21 17:04 ` [PATCH 10/10] docs: RCU: rculist_nulls.rst: don't duplicate chapter names Mauro Carvalho Chehab
2020-04-21 17:58 ` [PATCH 00/10] Manually convert RCU text files to ReST format Paul E. McKenney
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1587488137.git.mchehab+huawei@kernel.org \
--to=mchehab+huawei@kernel.org \
--cc=adobriyan@gmail.com \
--cc=corbet@lwn.net \
--cc=daniel@iogearbox.net \
--cc=dave@stgolabs.net \
--cc=davem@davemloft.net \
--cc=edumazet@google.com \
--cc=gregkh@linuxfoundation.org \
--cc=jakub@cloudflare.com \
--cc=jiangshanlai@gmail.com \
--cc=joe@wand.net.nz \
--cc=joel@joelfernandes.org \
--cc=josh@joshtriplett.org \
--cc=kafai@fb.com \
--cc=kuba@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mathieu.desnoyers@efficios.com \
--cc=mingo@redhat.com \
--cc=netdev@vger.kernel.org \
--cc=paulmck@kernel.org \
--cc=peterz@infradead.org \
--cc=rcu@vger.kernel.org \
--cc=robh@kernel.org \
--cc=rostedt@goodmis.org \
--cc=tglx@linutronix.de \
--cc=vcaputo@pengaru.com \
--cc=will@kernel.org \
--cc=zhang.lin16@zte.com.cn \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).