1#!/usr/bin/env perl 2# *************************************************************************** 3# * _ _ ____ _ 4# * Project ___| | | | _ \| | 5# * / __| | | | |_) | | 6# * | (__| |_| | _ <| |___ 7# * \___|\___/|_| \_\_____| 8# * 9# * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 10# * 11# * This software is licensed as described in the file COPYING, which 12# * you should have received as part of this distribution. The terms 13# * are also available at https://curl.se/docs/copyright.html. 14# * 15# * You may opt to use, copy, modify, merge, publish, distribute and/or sell 16# * copies of the Software, and permit persons to whom the Software is 17# * furnished to do so, under the terms of the COPYING file. 18# * 19# * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY 20# * KIND, either express or implied. 21# * 22# * SPDX-License-Identifier: curl 23# * 24# *************************************************************************** 25 26my $version="7.41.0"; 27 28use POSIX qw(strftime); 29my $date = strftime "%b %e, %Y", localtime; 30my $year = strftime "%Y", localtime; 31 32print <<HEADER 33.\\" ************************************************************************** 34.\\" * _ _ ____ _ 35.\\" * Project ___| | | | _ \\| | 36.\\" * / __| | | | |_) | | 37.\\" * | (__| |_| | _ <| |___ 38.\\" * \\___|\\___/|_| \\_\\_____| 39.\\" * 40.\\" * Copyright (C) Daniel Stenberg, <daniel\@haxx.se>, et al. 41.\\" * 42.\\" * This software is licensed as described in the file COPYING, which 43.\\" * you should have received as part of this distribution. The terms 44.\\" * are also available at https://curl.se/docs/copyright.html. 45.\\" * 46.\\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell 47.\\" * copies of the Software, and permit persons to whom the Software is 48.\\" * furnished to do so, under the terms of the COPYING file. 49.\\" * 50.\\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY 51.\\" * KIND, either express or implied. 52.\\" * 53.\\" * SPDX-License-Identifier: curl 54.\\" * 55.\\" ************************************************************************** 56.TH libcurl-symbols 3 "$date" "libcurl $version" "libcurl symbols" 57.SH NAME 58libcurl-symbols \\- libcurl symbol version information 59.SH "libcurl symbols" 60This man page details version information for public symbols provided in the 61libcurl header files. This lists the first version in which the symbol was 62introduced and for some symbols two additional information pieces: 63 64The first version in which the symbol is marked "deprecated" - meaning that 65since that version no new code should be written to use the symbol as it is 66marked for getting removed in a future. 67 68The last version that featured the specific symbol. Using the symbol in source 69code will make it no longer compile error-free after that specified version. 70 71This man page is automatically generated from the symbols-in-versions file. 72HEADER 73 ; 74 75while(<STDIN>) { 76 if($_ =~ /^(CURL[A-Z0-9_.]*) *(.*)/i) { 77 my ($symbol, $rest)=($1,$2); 78 my ($intro, $dep, $rem); 79 if($rest =~ s/^([0-9.]*) *//) { 80 $intro = $1; 81 } 82 if($rest =~ s/^([0-9.]*) *//) { 83 $dep = $1; 84 } 85 if($rest =~ s/^([0-9.]*) *//) { 86 $rem = $1; 87 } 88 print ".IP $symbol\nIntroduced in $intro\n"; 89 if($dep) { 90 print "Deprecated since $dep\n"; 91 } 92 if($rem) { 93 print "Last used in $rem\n"; 94 } 95 } 96 97} 98