libcurl.3: mention the URL API

To make it easier to find. Also a minor polish of libcurl-url.3

Closes #7009
This commit is contained in:
Daniel Stenberg 2021-05-05 09:17:24 +02:00
parent 577f19397c
commit a42b8f08d8
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
2 changed files with 12 additions and 9 deletions

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -23,10 +23,9 @@
.SH NAME .SH NAME
libcurl-url \- URL interface overview libcurl-url \- URL interface overview
.SH DESCRIPTION .SH DESCRIPTION
The URL interface provides a set of functions for parsing and generating URLs. The URL interface provides functions for parsing and generating URLs.
.SH INCLUDE .SH INCLUDE
You still only include <curl/curl.h> in your code. Note that the URL API was You still only include <curl/curl.h> in your code.
introduced in 7.62.0.
.SH CREATE .SH CREATE
Create a handle that holds URL info and resources with \fIcurl_url(3)\fP: Create a handle that holds URL info and resources with \fIcurl_url(3)\fP:
@ -132,6 +131,8 @@ Now the URL looks like
.nf .nf
https://example.com/?shoes=2&hat=1&candy=N%26N` https://example.com/?shoes=2&hat=1&candy=N%26N`
.fi .fi
.SH AVALABILITY
The URL API was introduced in libcurl 7.62.0.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR curl_url "(3), " curl_url_cleanup "(3), " curl_url_get "(3), " .BR curl_url "(3), " curl_url_cleanup "(3), " curl_url_get "(3), "
.BR curl_url_dup "(3), " curl_url_set "(3), " CURLOPT_URL "(3), " .BR curl_url_dup "(3), " curl_url_set "(3), " CURLOPT_URL "(3), "

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -24,10 +24,10 @@
libcurl \- client-side URL transfers libcurl \- client-side URL transfers
.SH DESCRIPTION .SH DESCRIPTION
This is a short overview on how to use libcurl in your C programs. There are This is a short overview on how to use libcurl in your C programs. There are
specific man pages for each function mentioned in here. There are also the specific man pages for each function mentioned in here. See
\fIlibcurl-easy(3)\fP man page, the \fIlibcurl-multi(3)\fP man page, the \fIlibcurl-easy(3)\fP, \fIlibcurl-multi(3)\fP, \fIlibcurl-share(3)\fP,
\fIlibcurl-share(3)\fP man page and the \fIlibcurl-tutorial(3)\fP man page for \fIlibcurl-url(3)\fP and \fIlibcurl-tutorial(3)\fP for in-depth understanding
in-depth understanding on how to program with libcurl. on how to program with libcurl.
There are many bindings available that bring libcurl access to your favourite There are many bindings available that bring libcurl access to your favourite
language. Look elsewhere for documentation on those. language. Look elsewhere for documentation on those.
@ -84,6 +84,8 @@ free a list built with \fIcurl_formadd(3)\fP
builds a linked list builds a linked list
.IP curl_slist_free_all() .IP curl_slist_free_all()
frees a whole curl_slist frees a whole curl_slist
.IP curl_url_set()
parses a URL
.RE .RE
.SH "LINKING WITH LIBCURL" .SH "LINKING WITH LIBCURL"