mirror of
https://github.com/izzy2lost/xemu.git
synced 2026-07-06 00:20:22 -07:00
Revert "scripts/kerneldoc: For Sphinx 3 use c:macro for macros with arguments"
This reverts commit 92bb29f9b2.
We will replace the commit with the fix from Linux.
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Message-Id: <20201117165312.118257-15-pbonzini@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
+1
-17
@@ -860,23 +860,7 @@ sub output_function_rst(%) {
|
||||
output_highlight_rst($args{'purpose'});
|
||||
$start = "\n\n**Syntax**\n\n ``";
|
||||
} else {
|
||||
if ((split(/\./, $sphinx_version))[0] >= 3) {
|
||||
# Sphinx 3 and later distinguish macros and functions and
|
||||
# complain if you use c:function with something that's not
|
||||
# syntactically valid as a function declaration.
|
||||
# We assume that anything with a return type is a function
|
||||
# and anything without is a macro.
|
||||
if ($args{'functiontype'} ne "") {
|
||||
print ".. c:function:: ";
|
||||
} else {
|
||||
print ".. c:macro:: ";
|
||||
}
|
||||
} else {
|
||||
# Older Sphinx don't support documenting macros that take
|
||||
# arguments with c:macro, and don't complain about the use
|
||||
# of c:function for this.
|
||||
print ".. c:function:: ";
|
||||
}
|
||||
print ".. c:function:: ";
|
||||
}
|
||||
if ($args{'functiontype'} ne "") {
|
||||
$start .= $args{'functiontype'} . " " . $args{'function'} . " (";
|
||||
|
||||
Reference in New Issue
Block a user