un-nest curl

curl-8.15.0/docs/curl-config.1

@@ -0,0 +1,90 @@
+.\" generated by cd2nroff 0.1 from curl-config.md
+.TH curl-config 1 "2025-08-14" curl-config
+.SH NAME
+curl\-config \- Get information about a libcurl installation
+.SH SYNOPSIS
+\fBcurl\-config [options]\fP
+.SH DESCRIPTION
+\fBcurl\-config\fP
+displays information about the curl and libcurl installation.
+.SH OPTIONS
+.IP --ca
+Displays the built\-in path to the CA cert bundle this libcurl uses.
+.IP --cc
+Displays the compiler used to build libcurl.
+.IP --cflags
+Set of compiler options (CFLAGS) to use when compiling files that use
+libcurl. Currently that is only the include path to the curl include files.
+.IP "--checkfor [version]"
+Specify the oldest possible libcurl version string you want, and this script
+returns 0 if the current installation is new enough or it returns 1 and
+outputs a text saying that the current version is not new enough. (Added in
+7.15.4)
+.IP --configure
+Displays the arguments given to configure when building curl.
+.IP --feature
+Lists what particular main features the installed libcurl was built with. At
+the time of writing, this list may include SSL, KRB4 or IPv6. Do not assume
+any particular order. The keywords are separated by newlines. There may be
+none, one, or several keywords in the list.
+.IP --help
+Displays the available options.
+.IP --libs
+Shows the complete set of libs and other linker options you need in order to
+link your application with libcurl.
+.IP --prefix
+This is the prefix used when libcurl was installed. libcurl is then installed
+in $prefix/lib and its header files are installed in $prefix/include and so
+on. The prefix is set with \fIconfigure \--prefix\fP.
+.IP --protocols
+Lists what particular protocols the installed libcurl was built to support. At
+the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE,
+TELNET, LDAP, DICT and many more. Do not assume any particular order. The
+protocols are listed using uppercase and are separated by newlines. There may
+be none, one, or several protocols in the list. (Added in 7.13.0)
+.IP --ssl-backends
+Lists the SSL backends that were enabled when libcurl was built. It might be
+no, one or several names. If more than one name, they appear comma\-separated.
+(Added in 7.58.0)
+.IP --static-libs
+Shows the complete set of libs and other linker options you need in order to
+link your application with libcurl statically. (Added in 7.17.1)
+.IP --version
+Outputs version information about the installed libcurl.
+.IP --vernum
+Outputs version information about the installed libcurl, in numerical mode.
+This shows the version number, in hexadecimal, using 8 bits for each part:
+major, minor, and patch numbers. This makes libcurl 7.7.4 appear as 070704 and
+libcurl 12.13.14 appear as 0c0d0e... Note that the initial zero might be
+omitted. (This option was broken in the 7.15.0 release.)
+.SH EXAMPLES
+What linker options do I need when I link with libcurl?
+
+.nf
+$ curl-config --libs
+.fi
+
+What compiler options do I need when I compile using libcurl functions?
+
+.nf
+$ curl-config --cflags
+.fi
+
+How do I know if libcurl was built with SSL support?
+
+.nf
+$ curl-config --feature | grep SSL
+.fi
+
+What\(aqs the installed libcurl version?
+
+.nf
+$ curl-config --version
+.fi
+
+How do I build a single file with a one\-line command?
+
+.nf
+$ `curl-config --cc --cflags` -o example source.c `curl-config --libs`
+.SH SEE ALSO
+.BR curl (1)