Received: by 2002:a25:1985:0:0:0:0:0 with SMTP id 127csp345360ybz; Tue, 21 Apr 2020 10:05:42 -0700 (PDT) X-Google-Smtp-Source: APiQypLvUTl+FEw18HTvTEi8vwZxxuIrrtYYy//6okd2BAYhdUtvRRHbLXE6FTcNmm0IdQRAXX/p X-Received: by 2002:a17:906:2f8f:: with SMTP id w15mr12781002eji.255.1587488742300; Tue, 21 Apr 2020 10:05:42 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1587488742; cv=none; d=google.com; s=arc-20160816; b=X/SlvShCMi5tXjSVAokCokmLGVvJxzsuxiePbv1GQF26M1pxQv4Od3nJnm6Uhqki0a jZDzL+JIAuvXJ2t9oWdFo/10i4sBoy9hy/hEwaNA0R1qcSEMIqX04QWSaR00r9b7xFkH cInBanaTuyvmd0IeNEZTpbr4BkNz/V+e7dcpFNz/SpaOx1vML7yLGswv1jHJLhRnZQ8D gu0oVfbV/wgnCSvc77HfThDRIFGyeHu2eHP77TrKkAN2lwt0yKaYX2tyVAv9HHt3BJ/0 J3Ovgf/9JOa1DTMZ78FKxUv+ivZfBuEMEKcUWpzpnYO/Xu8emHQU0wRw0LfNsIFlgoLh Qd9g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=HYxpQitEpQTcSVNxz1LzoDtOxpdgFSPgv/qS+UBdV6c=; b=ncRvvmQ7KFk6gooNQqm8gS6WTRn5G3ltR2p3JkBC9gdzVuSrOMmaPQ5FHMRp6gKkdj C86hduzMryZT1BREth4JzVStxVbO5wNmBAqsKzVTvSDus18cMw06YDAqAscwo+j1nP8d rN+1vH8DWXJWz0jaYIe/N0AonsPGGl1sPv0iFF6k9K1p1HivvV/2dlS/MIovB/ZKD0w4 gKghiAEHEv8BWe0t9Tef0+lHgKGxroOsAfgIvLBInnIg5+JlSyNzIQL5VZ21POZqgDXR q55r286gFOs+ZTBDXEF1BrdkSAGvCEATKWINYRLLvvEa2E39bpFMv65htc42/xovGkV9 ETtA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=LafIXWdd; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id y5si2373752edm.211.2020.04.21.10.05.19; Tue, 21 Apr 2020 10:05:42 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=LafIXWdd; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729202AbgDURET (ORCPT + 99 others); Tue, 21 Apr 2020 13:04:19 -0400 Received: from mail.kernel.org ([198.145.29.99]:33578 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726741AbgDUREO (ORCPT ); Tue, 21 Apr 2020 13:04:14 -0400 Received: from mail.kernel.org (ip5f5ad4d8.dynamic.kabel-deutschland.de [95.90.212.216]) (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 ED9F22071C; Tue, 21 Apr 2020 17:04:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1587488654; bh=TKwQ9ykgax7V0in9J67Gf5It6T8tA6kFCL0qRblfIrI=; h=From:To:Cc:Subject:Date:From; b=LafIXWddU/e0Xydt4GgYYdU5GaDFxqylQCmJxnpFAsQ2UlzspnKjfAIwz2UuDLwVR gVRmCny6BzaRVHvJXgLBylroC8orFZoRb4sX4+u8lcB7JlovofGV6Wl8JEqDnyKk4s 6Hxr9plhj/JBx6aui9oOtVZHaggRYuIbiXDgG/rM= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jQwJg-00CmLT-1Q; Tue, 21 Apr 2020 19:04:12 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , 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 , "Paul E. McKenney" , zhanglin , netdev@vger.kernel.org, Greg Kroah-Hartman , Will Deacon , Steven Rostedt , Mathieu Desnoyers , Rob Herring Subject: [PATCH 00/10] Manually convert RCU text files to ReST format Date: Tue, 21 Apr 2020 19:04:01 +0200 Message-Id: X-Mailer: git-send-email 2.25.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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