mirrors/SDL
0
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2024-11-23 10:53:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

wikiheaders: add (disabled) code to check for missing \threadsafety tags.

Browse Source 
Reference Issue #7140.
This commit is contained in:
Ryan C. Gordon 2024-10-22 10:47:51 -04:00
parent 19a1175c02
commit e9b5f6749e
No known key found for this signature in database
GPG Key ID: FA148B892AB48044
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
build-scripts/wikiheaders.pl
View File

@ -1860,6 +1860,7 @@ if ($copy_direction == 1) { # --copy-to-headers
my @paramsorder = ();
my $fnsigparams = $headersymsparaminfo{$sym};
my $has_returns = 0;
my $has_threadsafety = 0;
while (@doxygenlines) {
my $l = shift @doxygenlines;
@ -1998,6 +1999,7 @@ if ($copy_direction == 1) { # --copy-to-headers
}
$desc =~ s/[\s\n]+\Z//ms;
$sections{'Thread Safety'} = wordwrap(wikify($wikitype, $desc)) . "\n";
$has_threadsafety = 1;
} elsif ($l =~ /\A\\sa\s+(.*)\Z/) {
my $sa = $1;
$sa =~ s/\(\)\Z//; # Convert "SDL_Func()" to "SDL_Func"
@ -2014,6 +2016,11 @@ if ($copy_direction == 1) { # --copy-to-headers
print STDERR "WARNING: Function '$sym' has a non-void return type but no '\\returns' declaration\n";
}
# !!! FIXME: uncomment this when we're trying to clean this up in the headers.
#if (($symtype == 1) && !$has_threadsafety) {
# print STDERR "WARNING: Function '$sym' doesn't have a '\\threadsafety' declaration\n";
#}
# Make sure %params is in the same order as the actual function signature and add C datatypes...
my $params_has_c_datatype = 0;
my @final_params = ();