[PATCH 0/5] Convert more books to ReST
From: Mauro Carvalho Chehab
Date: Sat May 13 2017 - 07:12:15 EST
This patch series convert the following books to ReST:
- librs
- mtdnand
- sh
And it is based on my previous series of conversion patches.
After this series, there will be just one DocBook pending conversion:
- lsm (Linux Security Modules)
This book is very outdated: no changes since the Kernel moved
to git, in 2005 (except for a minor editorial fix in 2008).
I took a look on the described API: it doesn't seem to be describing
the current security implementation.
The best here is if someone that works with LSM to convert it to
ReST with:
$ Documentation/sphinx/tmplcvt Documentation/DocBook/lsm.tmpl lsm.rst
And fix the document to produce something that reflects the current
implementation. If nobody is interested, then maybe we could just
drop it.
-
This patch series is based on my past 00/36 patch series, applied on
the top of docs tree (next branch).
The full patch series is on this tree is at:
https://git.linuxtv.org//mchehab/experimental.git/log/?h=docbook
And the HTML output at:
http://www.infradead.org/~mchehab/kernel_docs/
https://mchehab.fedorapeople.org/kernel_docs/
Mauro Carvalho Chehab (5):
docs-rst: convert librs book to ReST
docs-rst: convert mtdnand book to ReST
mtdnand.rst: Fix some typos and group the "::" with previous line
mtd: adjust kernel-docs to avoid Sphinx/kerneldoc warnings
docs-rst: convert sh book to ReST
Documentation/DocBook/Makefile | 5 +-
Documentation/DocBook/librs.tmpl | 289 --------
Documentation/DocBook/mtdnand.tmpl | 1291 ----------------------------------
Documentation/DocBook/sh.tmpl | 105 ---
Documentation/conf.py | 2 +
Documentation/core-api/index.rst | 1 +
Documentation/core-api/librs.rst | 212 ++++++
Documentation/driver-api/index.rst | 1 +
Documentation/driver-api/mtdnand.rst | 1007 ++++++++++++++++++++++++++
Documentation/index.rst | 11 +
Documentation/sh/index.rst | 59 ++
drivers/mtd/nand/nand_base.c | 7 +-
include/linux/mtd/nand.h | 2 +-
13 files changed, 1300 insertions(+), 1692 deletions(-)
delete mode 100644 Documentation/DocBook/librs.tmpl
delete mode 100644 Documentation/DocBook/mtdnand.tmpl
delete mode 100644 Documentation/DocBook/sh.tmpl
create mode 100644 Documentation/core-api/librs.rst
create mode 100644 Documentation/driver-api/mtdnand.rst
create mode 100644 Documentation/sh/index.rst
--
2.9.3