symbols-in-version: add CURL_SOCKET_BAD

I also documented the filtering logic in the symbol-scan.pl function to
clarify why not all CURL_* symbols are included.

diff --git a/docs/libcurl/symbols-in-versions b/docs/libcurl/symbols-in-versions
index 1884d3d33b6a5f9af5c9c07946dd25dfdc3fcca6..a366ce2ab0efc21900103e29cab3453acf14cbc9 100644 (file)
--- a/docs/libcurl/symbols-in-versions
+++ b/docs/libcurl/symbols-in-versions
@@ -426,9 +426,9 @@ CURLOPT_READDATA                7.9.7
 CURLOPT_READFUNCTION            7.1
 CURLOPT_REDIR_PROTOCOLS         7.19.4
 CURLOPT_REFERER                 7.1
+CURLOPT_RESOLVE                 7.21.3
 CURLOPT_RESUME_FROM             7.1
 CURLOPT_RESUME_FROM_LARGE       7.11.0
-CURLOPT_RESOLVE                 7.21.3
 CURLOPT_RTSPHEADER              7.20.0
 CURLOPT_RTSP_CLIENT_CSEQ        7.20.0
 CURLOPT_RTSP_REQUEST            7.20.0
@@ -639,6 +639,7 @@ CURL_RTSPREQ_TEARDOWN           7.20.0
 CURL_SEEKFUNC_CANTSEEK          7.19.5
 CURL_SEEKFUNC_FAIL              7.19.5
 CURL_SEEKFUNC_OK                7.19.5
+CURL_SOCKET_BAD                 7.14.0
 CURL_SOCKET_TIMEOUT             7.14.0
 CURL_SSLVERSION_DEFAULT         7.9.2
 CURL_SSLVERSION_SSLv2           7.9.2

diff --git a/tests/symbol-scan.pl b/tests/symbol-scan.pl
index 4c7edb6442ec60147e107e83c188044dfcca7650..2f9ce3507ac5bd72d05aa086232a6b292545e190 100644 (file)
--- a/tests/symbol-scan.pl
+++ b/tests/symbol-scan.pl
@@ -77,7 +77,18 @@ close S;
 
 my $ignored=0;
 for my $e (sort @syms) {
-    if($e =~ /(OBSOLETE|^CURL_EXTERN|^CURL_SOCKET_BAD|_LAST\z|_LASTENTRY\z)/) {
+    # OBSOLETE - names that are just placeholders for a position where we
+    # previously had a name, that is now removed. The OBSOLETE names should
+    # never be used for anything.
+    #
+    # CURL_EXTERN - is a define used for libcurl functions that are external,
+    # public. No app or other code should ever use it.
+    #
+    # *_LAST and *_LASTENTRY are just prefix for the placeholders used for the
+    # last entry in many enum series.
+    #
+    
+    if($e =~ /(OBSOLETE|^CURL_EXTERN|_LAST\z|_LASTENTRY\z)/) {
         $ignored++;
         next;
     }