docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 06:18:43 +08:00
|
|
|
<!-- Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. -->
|
|
|
|
|
<!-- SPDX-License-Identifier: curl -->
|
|
|
|
|
# URL
|
|
|
|
|
The URL syntax is protocol-dependent. You find a detailed description in
|
|
|
|
|
RFC 3986.
|
|
|
|
|
|
|
|
|
|
If you provide a URL without a leading **protocol://** scheme, curl guesses
|
|
|
|
|
what protocol you want. It then defaults to HTTP but assumes others based on
|
2024-02-27 17:35:28 +08:00
|
|
|
often-used hostname prefixes. For example, for hostnames starting with `ftp.`
|
|
|
|
|
curl assumes you want FTP.
|
docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 06:18:43 +08:00
|
|
|
|
|
|
|
|
You can specify any amount of URLs on the command line. They are fetched in a
|
|
|
|
|
sequential manner in the specified order unless you use --parallel. You can
|
|
|
|
|
specify command line options and URLs mixed and in any order on the command
|
|
|
|
|
line.
|
|
|
|
|
|
|
|
|
|
curl attempts to reuse connections when doing multiple transfers, so that
|
|
|
|
|
getting many files from the same server do not use multiple connects and setup
|
|
|
|
|
handshakes. This improves speed. Connection reuse can only be done for URLs
|
|
|
|
|
specified for a single command line invocation and cannot be performed between
|
|
|
|
|
separate curl runs.
|
|
|
|
|
|
|
|
|
|
Provide an IPv6 zone id in the URL with an escaped percentage sign. Like in
|
|
|
|
|
|
|
|
|
|
"http://[fe80::3%25eth0]/"
|
|
|
|
|
|
|
|
|
|
Everything provided on the command line that is not a command line option or
|
|
|
|
|
its argument, curl assumes is a URL and treats it as such.
|
