The syntax for a parameter is '@<name>'. Let also use this when
referencing a parameter name in another section (other parameters
or long description) and mark these references in bold (the same
as the parameters themseelves are presented).
Signed-off-by: Luc Van Oostenryck <luc.vanoostenryck@xxxxxxxxx>
---
Documentation/sphinx/cdoc.py | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/Documentation/sphinx/cdoc.py b/Documentation/sphinx/cdoc.py
index b0cad851f..845c30adc 100755
--- a/Documentation/sphinx/cdoc.py
+++ b/Documentation/sphinx/cdoc.py
@@ -156,6 +156,10 @@ def process_file(f):
return docs
+def decorate(l):
+ l = re.sub(r"@(\w+)", "**\\1**", l)
+ return l
+
def convert_to_rst(info):
lst = []
#print('info= ' + str(info))
@@ -183,6 +187,7 @@ def convert_to_rst(info):
for (n, name, l) in info.get('args', []):
if name != 'return':
name = 'param ' + name
+ l = decorate(l)
l = '\t:%s: %s' % (name, l)
lst.append((n, l))
lst.append((n+1, ''))
@@ -191,6 +196,7 @@ def convert_to_rst(info):
n = desc[0]
r = ''
for l in desc[1:]:
+ l = decorate(l)
r += '\t' + l + '\n'
lst.append((n, r))
return lst
--
2.17.0
--
To unsubscribe from this list: send the line "unsubscribe linux-sparse" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
