[PATCH 0/5] Convert more books to ReST
boris.brezillon at free-electrons.com
Mon May 15 05:09:12 PDT 2017
On Sat, 13 May 2017 08:10:53 -0300
Mauro Carvalho Chehab <mchehab at s-opensource.com> wrote:
> 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:
> And the HTML output at:
> 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 maintainers did not receive the above patch. Can you Cc us the
whole series next time.
BTW, I had a look at your branch and it seems the typo you're fixing is
actually not a type. Flags are *OR-ed* (with the | operator) to form a
valid combination of flags.
> mtd: adjust kernel-docs to avoid Sphinx/kerneldoc warnings
Not sure how you plan to merge these changes, but if it goes through
a single tree I'll probably need an immutable topic branch, because I
plan to change a few things in nand_base.c nand.h for the next release.
> 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
More information about the linux-mtd