mirror of
https://github.com/curl/curl.git
synced 2024-12-15 06:40:09 +08:00
6967571bf2
Add a deprecated attribute to functions and enum values that should not be used anymore. This uses a gcc 4.3 dialect, thus is only available for this version of gcc and newer. Note that the _Pragma() keyword is introduced by C99, but is available as part of the gcc dialect even when compiling in C89 mode. It is still possible to disable deprecation at a calling module compile time by defining CURL_DISABLE_DEPRECATION. Gcc type checking macros are made aware of possible deprecations. Some testing support Perl programs are adapted to the extended declaration syntax. Several test and unit test C programs intentionally use deprecated functions/options and are annotated to not generate a warning. New test 1222 checks the deprecation status in doc and header files. Closes #9667
159 lines
3.9 KiB
Perl
Executable File
159 lines
3.9 KiB
Perl
Executable File
#!/usr/bin/env perl
|
|
#***************************************************************************
|
|
# _ _ ____ _
|
|
# Project ___| | | | _ \| |
|
|
# / __| | | | |_) | |
|
|
# | (__| |_| | _ <| |___
|
|
# \___|\___/|_| \_\_____|
|
|
#
|
|
# Copyright (C) 2010-2022, Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
#
|
|
# This software is licensed as described in the file COPYING, which
|
|
# you should have received as part of this distribution. The terms
|
|
# are also available at https://curl.se/docs/copyright.html.
|
|
#
|
|
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
# copies of the Software, and permit persons to whom the Software is
|
|
# furnished to do so, under the terms of the COPYING file.
|
|
#
|
|
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
# KIND, either express or implied.
|
|
#
|
|
# SPDX-License-Identifier: curl
|
|
#
|
|
###########################################################################
|
|
#
|
|
# This script grew out of help from Przemyslaw Iskra and Balint Szilakszi
|
|
# a late evening in the #curl IRC channel.
|
|
#
|
|
|
|
use strict;
|
|
use warnings;
|
|
use vars qw($Cpreprocessor);
|
|
|
|
#
|
|
# configurehelp perl module is generated by configure script
|
|
#
|
|
my $rc = eval {
|
|
require configurehelp;
|
|
configurehelp->import(qw(
|
|
$Cpreprocessor
|
|
));
|
|
1;
|
|
};
|
|
# Set default values if configure has not generated a configurehelp.pm file.
|
|
# This is the case with cmake.
|
|
if (!$rc) {
|
|
$Cpreprocessor = 'cpp';
|
|
}
|
|
|
|
my $verbose=0;
|
|
|
|
# verbose mode when -v is the first argument
|
|
if($ARGV[0] eq "-v") {
|
|
$verbose=1;
|
|
shift;
|
|
}
|
|
|
|
# we may get the dir root pointed out
|
|
my $root=$ARGV[0] || ".";
|
|
|
|
# need an include directory when building out-of-tree
|
|
my $i = ($ARGV[1]) ? "-I$ARGV[1] " : '';
|
|
|
|
my $incdir = "$root/include/curl";
|
|
|
|
my $summary=0;
|
|
my $misses=0;
|
|
|
|
my @syms;
|
|
my %doc;
|
|
my %rem;
|
|
|
|
sub scanenums {
|
|
my ($file)=@_;
|
|
my $skipit = 0;
|
|
|
|
open H_IN, "-|", "$Cpreprocessor -DCURL_DISABLE_DEPRECATION $i$file" ||
|
|
die "Cannot preprocess $file";
|
|
while ( <H_IN> ) {
|
|
my ($line, $linenum) = ($_, $.);
|
|
if( /^#(line|) (\d+) \"(.*)\"/) {
|
|
# if the included file isn't in our incdir, then we skip this section
|
|
# until next #line
|
|
#
|
|
if($3 !~ /^$incdir/) {
|
|
$skipit = 1;
|
|
next;
|
|
}
|
|
# parse this!
|
|
$skipit = 0;
|
|
next;
|
|
}
|
|
if($skipit) {
|
|
next;
|
|
}
|
|
if (/^#/) {
|
|
next;
|
|
}
|
|
if ( /enum\s+(\S+\s+)?{/ .. /}/ ) {
|
|
s/^\s+//;
|
|
chomp;
|
|
s/[,\s].*//;
|
|
if(($_ !~ /\}(;|)/) &&
|
|
($_ ne "typedef") &&
|
|
($_ ne "enum") &&
|
|
($_ ne "=") &&
|
|
($_ !~ /^[ \t]*$/)) {
|
|
if($verbose) {
|
|
print "Source: $Cpreprocessor $i$file\n";
|
|
print "Symbol: $_\n";
|
|
print "Line #$linenum: $line\n\n";
|
|
}
|
|
push @syms, $_;
|
|
}
|
|
}
|
|
}
|
|
close H_IN || die "Error preprocessing $file";
|
|
}
|
|
|
|
sub scanheader {
|
|
my ($f)=@_;
|
|
scanenums($f);
|
|
open H, "<$f";
|
|
while(<H>) {
|
|
my ($line, $linenum) = ($_, $.);
|
|
if (/^#define +([^ \n]*)/) {
|
|
if($verbose) {
|
|
print "Source: $f\n";
|
|
print "Symbol: $1\n";
|
|
print "Line #$linenum: $line\n\n";
|
|
}
|
|
push @syms, $1;
|
|
}
|
|
}
|
|
close H;
|
|
}
|
|
|
|
|
|
opendir(my $dh, $incdir) || die "Can't opendir $incdir: $!";
|
|
my @hfiles = grep { /\.h$/ } readdir($dh);
|
|
closedir $dh;
|
|
|
|
for(@hfiles) {
|
|
scanheader("$incdir/$_");
|
|
}
|
|
|
|
my $errors = 0;
|
|
for my $s (@syms) {
|
|
if($s !~ /^(lib|)curl/i) {
|
|
print "Bad symbols in public header files:\n" if(!$errors);
|
|
$errors++;
|
|
print " $s\n";
|
|
}
|
|
}
|
|
if($errors) {
|
|
exit 1;
|
|
}
|
|
printf "%d fine symbols found\n", scalar(@syms);
|