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.

1 files changed, 12 insertions, 1 deletions

diff --git a/tests/symbol-scan.pl b/tests/symbol-scan.pl
index 4c7edb644..2f9ce3507 100644
--- 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;
     }