[PATCH] doc-rst: fixed kernel-doc directives in usb/typec.rst

Even if this file is not yet included in any toctree, it is parsed by Sphinx since it is named '.rst'. This patch fixes the following two ERRORs from Sphinx build: Documentation/usb/typec.rst:116: ERROR: Error in "kernel-doc" directive: invalid option block. .. kernel-doc::

[PATCH] doc-rst: fix inline emphasis in unshare.rst

The asterisk of the pointer is interpreted as a start tag for inline emphasis. Asterisks which are not Sphinx markup need to be quoted in rst-files. This fixes the Sphinx warning: Documentation/userspace-api/unshare.rst:108: WARNING: Inline emphasis start-string without end-string.

[PATCH] core-api: remove an unexpected unident

As complained by Sphinx: Documentation/core-api/assoc_array.rst:13: WARNING: Enumerated list ends without a blank line; unexpected unindent. This was already addressed, but not really fixed in 2ba90ccca7. Signed-off-by: Markus Heiser ---

[PATCH V4] cfg80211: add request id to cfg80211_sched_scan_*() api

Hi Arend, I guess there is a typo in your kernel-doc comment [1]: modified include/net/cfg80211.h @@ -1666,6 +1666,7 @@ struct cfg80211_bss_select_adjust { * (others are filtered out). * If ommited, all results are passed. * @n_match_sets: number of match sets + *

[PATCH 03/17] doc: ReSTify IMA-templates.txt

Adjust IMA-templates.txt for ReST markup and add to the index for security/, under the Kernel API Documentation. Cc: Mimi Zohar Signed-off-by: Kees Cook --- Documentation/security/00-INDEX| 2 - .../{IMA-templates.txt =>

[PATCH 04/17] doc: ReSTify credentials.txt

This updates the credentials API documentation to ReST markup and moves it under the security subsection of kernel API documentation. Cc: David Howells Signed-off-by: Kees Cook --- Documentation/security/00-INDEX| 2 -

[PATCH 06/17] doc: security: minor cleanups to build kernel-doc

These fixes were needed to parse lsm_hooks.h kernel-doc. More work is needed, but this is the first step. Cc: Casey Schaufler Signed-off-by: Kees Cook --- include/linux/lsm_hooks.h | 25 - 1 file changed, 12 insertions(+),

[PATCH 02/17] doc: ReSTify no_new_privs.txt

This updates no_new_privs documentation to ReST markup and adds it to the user-space API documentation. Signed-off-by: Kees Cook --- Documentation/userspace-api/index.rst | 1 + .../no_new_privs.rst} | 44 --

[PATCH 11/17] doc: ReSTify Yama.txt

Adjusts for ReST markup and moves under LSM admin guide. Signed-off-by: Kees Cook --- .../Yama.txt => admin-guide/LSM/Yama.rst} | 55 -- Documentation/admin-guide/LSM/index.rst| 1 + Documentation/security/00-INDEX

[PATCH 13/17] doc: ReSTify Smack.txt

Adjusts for ReST markup and moves under LSM admin guide. Cc: Casey Schaufler Signed-off-by: Kees Cook --- .../Smack.txt => admin-guide/LSM/Smack.rst}| 273 ++--- Documentation/admin-guide/LSM/index.rst| 1 +

[PATCH 14/17] doc: ReSTify keys.txt

This creates a new section in the security development index for kernel keys, and adjusts for ReST markup. Cc: David Howells Signed-off-by: Kees Cook --- Documentation/crypto/asymmetric-keys.txt | 2 +- Documentation/security/00-INDEX

[PATCH 3/5] mtdnand.rst: Fix some typos and group the "::" with previous line

Typo: ored -> ordered While here, group the :: with the previous paragraph, in order to make it visually better when reading as a text file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/mtdnand.rst | 24 +++- 1 file

[PATCH 5/5] docs-rst: convert sh book to ReST

Use pandoc to convert documentation to ReST by calling Documentation/sphinx/tmplcvt script. Signed-off-by: Mauro Carvalho Chehab --- Documentation/DocBook/Makefile | 4 +- Documentation/DocBook/sh.tmpl | 105 -

[PATCH 2/5] docs-rst: convert mtdnand book to ReST

Use pandoc to convert documentation to ReST by calling Documentation/sphinx/tmplcvt script. The tables were manually adjusted to fit into 80 columns. Signed-off-by: Mauro Carvalho Chehab --- Documentation/DocBook/Makefile |1 -

Re: [PATCH 01/36] docs-rst: convert kernel-hacking to ReST

Em Fri, 12 May 2017 18:35:29 +0200 Markus Heiser escreveu: > Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab > : > > > Use pandoc to convert documentation to ReST by calling > > Documentation/sphinx/tmplcvt script. > > > > - Manually

Re: [PATCH 04/36] mutex, futex: adjust kernel-doc markups to generate ReST

Em Fri, 12 May 2017 15:19:17 -0700 Darren Hart escreveu: > On Sat, May 13, 2017 at 12:11:09AM +0200, Peter Zijlstra wrote: > > On Fri, May 12, 2017 at 06:51:50PM -0300, Mauro Carvalho Chehab wrote: > > > > * Return: > > > > * * 0 - ready to wait > > > > * * 1 -

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

Em Fri, 12 May 2017 18:57:13 +0200 Markus Heiser escreveu: > Am 12.05.2017 um 15:59 schrieb Mauro Carvalho Chehab > : > > > Use pandoc to convert documentation to ReST by calling > > Documentation/sphinx/tmplcvt script. > > > > - Manually

Re: [PATCH 21/36] fs: locks: Fix some troubles at kernel-doc comments

Hi Jeff, Em Fri, 12 May 2017 10:02:56 -0400 Jeff Layton escreveu: > On Fri, 2017-05-12 at 11:00 -0300, Mauro Carvalho Chehab wrote: > > There are a few syntax violations that cause outputs of > > a few comments to not be properly parsed in ReST format. > > > > No

Re: [PATCH 26/36] libata.rst: add c function and struct cross-references

-rst-convert-kernel-hacking-to-ReST/20170513-131229 reproduce: make htmldocs All warnings (new ones prefixed by >>): WARNING: convert(1) not found, for SVG to PDF conversion install ImageMagick (https://www.imagemagick.org) arch/x86/include/asm/uaccess_32.h:1: warning: no structured co