[PATCH v4 08/15] docs: kernel_abi.py: allow passing ABI files in a transparent way

From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
To: gregkh@linuxfoundation.org
Cc: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>,
	Jonathan Corbet <corbet@lwn.net>,
	linux-doc@vger.kernel.org
Subject: [PATCH v4 08/15] docs: kernel_abi.py: allow passing ABI files in a transparent way
Date: Wed, 17 Jul 2019 09:28:12 -0300	[thread overview]
Message-ID: <c4bd23436b7bfe6fe60154423ea6424bde9fae64.1563365880.git.mchehab+samsung@kernel.org> (raw)
In-Reply-To: <cover.1563365880.git.mchehab+samsung@kernel.org>

As get-abi.pl supports an ABI file that it is ReST compliant,
add an option to kernel-abi.py to allow using the transparent
mode of the tool.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/sphinx/kernel_abi.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/Documentation/sphinx/kernel_abi.py b/Documentation/sphinx/kernel_abi.py
index 615b3773bb62..30cac84e18f5 100644
--- a/Documentation/sphinx/kernel_abi.py
+++ b/Documentation/sphinx/kernel_abi.py
@@ -71,12 +71,13 @@ class KernelCmd(Directive):
     u"""KernelABI (``kernel-abi``) directive"""
 
     required_arguments = 1
-    optional_arguments = 0
+    optional_arguments = 2
     has_content = False
     final_argument_whitespace = True
 
     option_spec = {
-        "debug"     : directives.flag
+        "debug"     : directives.flag,
+        "rst"       : directives.unchanged
     }
 
     def warn(self, message, **replace):
@@ -96,6 +97,9 @@ class KernelCmd(Directive):
         cmd = "get_abi.pl rest --enable-lineno --dir "
         cmd += self.arguments[0]
 
+        if 'rst' in self.options:
+            cmd += " --rst-source"
+
         srctree = path.abspath(os.environ["srctree"])
 
         fname = cmd
-- 
2.21.0

