functions and symbol deprecation statuses

From: Patrick Monnerat via curl-library <curl-library_at_lists.haxx.se>
Date: Tue, 11 Oct 2022 16:49:01 +0200

Hi friends,

I just wrote a program to check deprecation statuses by comparing how
symbols and functions are labeled in the various doc files:

- symbols-in-versions,

- function man pages,

- for options, pertaining function man page and option man page,

- public header files; they are used to get the defined names, but do
not participate in the inconsistency check by now since they do not
deprecate anything yet (except in comments!).


My intention is to make a new test of it.


It already determines some inconsistencies in our files and here are the
first results:

----------------------

error: CURLOPT_SOCKS5_GSSAPI_SERVICE man page lists unmatching
deprecation versions 7.49.0 and 7.49
Legend:
<empty> Not listed
X       Not deprecated
?       Deprecated in unknown version
x.yy.z  Deprecated in version x.yy.z

Symbol                                 symbols-in  func man  opt man   .h
                                        -versions
CURLINFO_CONTENT_LENGTH_DOWNLOAD       X           ? X         X
CURLINFO_CONTENT_LENGTH_UPLOAD         X           ? X         X
CURLINFO_LASTSOCKET                    X           X 7.45.0    X
CURLINFO_PROTOCOL                      X           X ?         X
CURLINFO_SIZE_DOWNLOAD                 X           ? X         X
CURLINFO_SIZE_UPLOAD                   X           ? X         X
CURLINFO_SPEED_DOWNLOAD                X           ? X         X
CURLINFO_SPEED_UPLOAD                  X           ? X         X
CURLOPT_DNS_USE_GLOBAL_CACHE           7.11.1      X 7.62.0    X
CURLOPT_EGDSOCKET                      X           X 7.84.0    X
CURLOPT_HTTPPOST                       7.56.0      X 7.56.0    X
CURLOPT_PROTOCOLS                      X           X ?         X
CURLOPT_PUT                            X           X 7.12.1    X
CURLOPT_RANDOM_FILE                    X           X 7.84.0    X
CURLOPT_REDIR_PROTOCOLS                X           X ?         X
CURLOPT_SOCKS5_GSSAPI_SERVICE          7.49.0      X 7.49.0    X
CURLOPT_SSL_ENABLE_NPN                 7.86.0      X 7.86.0    X

----------------------

I don't want to submit a PR for a new test before our code base will
allow it to run successfully.

Thus I'll be glad to get some comments about the results above, in order
to fix our files (or my program) to suppress all detected inconsistencies.

Thanks for your replies,

Patrick

-- 
Unsubscribe: https://lists.haxx.se/listinfo/curl-library
Etiquette:   https://curl.se/mail/etiquette.html

Received on 2022-10-11