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
