From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.6 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id EC872C54FCC for ; Tue, 21 Apr 2020 17:58:22 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id D3F5D206F4 for ; Tue, 21 Apr 2020 17:58:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1587491902; bh=oH3D3wW81vM+XAyd0PlDCJfJGYGDphzLmObR7cqzafY=; h=Date:From:To:Cc:Subject:Reply-To:References:In-Reply-To:List-ID: From; b=nA88lgVmL4UFw+XvNsJNJjKlpkKEwrsT4LhZcxT2hTLAd9Ms62/iv8PTzNVhtQaVx /P/xTTgnV90sEbY6N60H+0/tuXjjMONtnIkbKs5eLcON2Z4wKsyJamsLhmquLKgzn0 CPMlxAqzmx93p9xtTwwJ4HgRQjJENGwjOwTLs2AA= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729127AbgDUR6U (ORCPT ); Tue, 21 Apr 2020 13:58:20 -0400 Received: from mail.kernel.org ([198.145.29.99]:56678 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725870AbgDUR6U (ORCPT ); Tue, 21 Apr 2020 13:58:20 -0400 Received: from paulmck-ThinkPad-P72.home (50-39-105-78.bvtn.or.frontiernet.net [50.39.105.78]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 3592820663; Tue, 21 Apr 2020 17:58:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1587491899; bh=oH3D3wW81vM+XAyd0PlDCJfJGYGDphzLmObR7cqzafY=; h=Date:From:To:Cc:Subject:Reply-To:References:In-Reply-To:From; b=0SWGGMZ06asXScTJ8MfuNaK9TrSpnZy+/ZKmI3vB6kEXBj6d7PVVtroBvv/FuslGZ wlUsp+e3ncKpnFGhHiX2h53nORYZz/6Z9bqZRgPMPrgfvKIu/xxb2KuBq0CkF1e6+f 8uJeZkBe1pyUKQXI93w21sYPEPfiC03QO5Az217g= Received: by paulmck-ThinkPad-P72.home (Postfix, from userid 1000) id 08D133523441; Tue, 21 Apr 2020 10:58:19 -0700 (PDT) Date: Tue, 21 Apr 2020 10:58:19 -0700 From: "Paul E. McKenney" To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , linux-kernel@vger.kernel.org, Jonathan Corbet , "David S. Miller" , Josh Triplett , Vito Caputo , Alexey Dobriyan , Jakub Kicinski , Davidlohr Bueso , Joe Stringer , Joel Fernandes , Martin KaFai Lau , Lai Jiangshan , Thomas Gleixner , Daniel Borkmann , Eric Dumazet , Peter Zijlstra , Jakub Sitnicki , rcu@vger.kernel.org, Ingo Molnar , zhanglin , netdev@vger.kernel.org, Greg Kroah-Hartman , Will Deacon , Steven Rostedt , Mathieu Desnoyers , Rob Herring Subject: Re: [PATCH 00/10] Manually convert RCU text files to ReST format Message-ID: <20200421175818.GS17661@paulmck-ThinkPad-P72> Reply-To: paulmck@kernel.org References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.9.4 (2018-02-28) Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org On Tue, Apr 21, 2020 at 07:04:01PM +0200, Mauro Carvalho Chehab wrote: > 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 I queued all but 7/10 and 8/10, for which I have the bibtex-to-ReST conversion question. Thank you for dragging these files kicking and screaming into the year 2020! ;-) Thanx, Paul > 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 > >