Re: [PATCH 03/36] docs-rst: convert kernel-locking to ReST

From: Markus Heiser
Date: Fri May 12 2017 - 12:50:22 EST



Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>:

> Use pandoc to convert documentation to ReST by calling
> Documentation/sphinx/tmplcvt script.
>
> - Manually adjust tables with got broken by conversion
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>
> ---
> Documentation/DocBook/Makefile | 1 -
> Documentation/DocBook/kernel-locking.tmpl | 2151 -----------------------------
> Documentation/kernel-hacking/hacking.rst | 811 +++++++++++
> Documentation/kernel-hacking/index.rst | 814 +----------
> Documentation/kernel-hacking/locking.rst | 1453 +++++++++++++++++++
> 5 files changed, 2268 insertions(+), 2962 deletions(-)
> delete mode 100644 Documentation/DocBook/kernel-locking.tmpl
> create mode 100644 Documentation/kernel-hacking/hacking.rst
> create mode 100644 Documentation/kernel-hacking/locking.rst
...

There are some misplaced colons at the end of the filenames ...

> +``arch/x86/include/asm/uaccess_32.h:``::
> +
> + #define copy_to_user(to,from,n) \
> + (__builtin_constant_p(n) ? \
> + __constant_copy_to_user((to),(from),(n)) : \
> + __generic_copy_to_user((to),(from),(n)))
> +

...

> +
> +``arch/sparc/kernel/head.S:``::
> +
> + /*
> + * Sun people can't spell worth damn. "compatability" indeed.
> + * At least we *know* we can't spell, and use a spell-checker.
> + */
> +

...

> +
> +``arch/sparc/lib/checksum.S:``::
> +
> + /* Sun, you just can't beat me, you just can't. Stop trying,
> + * give up. I'm serious, I am going to kick the living shit
> + * out of you, game over, lights out.
> + */

-- Markus--