documentation: clean up a minor syntax issue.

This commit is contained in:
Ryan C. Gordon
2024-06-13 18:10:28 -04:00
parent 466886049c
commit 2ad7c70ac6
8 changed files with 31 additions and 23 deletions

View File

@@ -1856,6 +1856,14 @@ if ($copy_direction == 1) { # --copy-to-headers
# !!! FIXME: complain if this isn't a function or macro.
my $retstr = "R$1"; # "Return" or "Returns"
my $desc = $2;
if (0) { # !!! FIXME: disabled because it's not currently suitable for general use, but for manually inspecting the output, it can be useful.
if (($desc =~ /\A[A-Z]/) && (not $desc =~ /\ASDL_/)) {
print STDERR "WARNING: $sym\'s '\\returns' text starts with a capital letter: '$desc'. Fixing.\n";
$desc = lcfirst($desc);
}
}
while (@doxygenlines) {
my $subline = $doxygenlines[0];
$subline =~ s/\A\s*//;