From b34f9ccb761716bd9fcb03861b89b82b3167c6c0 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Tue, 30 Aug 2022 11:42:20 +0800
Subject: [PATCH 1/9] update rust format and build script

---
 Cargo.toml                                    |   4 -
 ci/01-base.sh                                 |  35 ++-
 lib/Cargo.toml                                |  24 --
 lib/lib.rs                                    |   5 -
 rust/rust_ffi/build.rs                        |   2 +-
 rust/rust_ffi/lib.rs                          |   9 +-
 rust/rust_ffi/src/ffi_alias/mod.rs            |   2 +-
 rust/rust_ffi/src/ffi_alias/type_alias.rs     |  75 ++---
 rust/rust_ffi/src/ffi_fun/fun_call.rs         |   4 +-
 rust/rust_ffi/src/ffi_fun/mod.rs              |   2 +-
 rust/rust_ffi/src/ffi_struct/mod.rs           |   2 +-
 rust/rust_ffi/src/ffi_struct/struct_define.rs |   9 +-
 rust/rust_project/build.rs                    |   2 +-
 rust/rust_project/lib.rs                      |   9 +-
 rust/rust_project/src/http_ntlm.rs            | 293 ++++++------------
 rust/rust_project/src/vtls/keylog.rs          |  80 ++---
 16 files changed, 204 insertions(+), 353 deletions(-)
 delete mode 100644 Cargo.toml
 delete mode 100644 lib/Cargo.toml
 delete mode 100644 lib/lib.rs

diff --git a/Cargo.toml b/Cargo.toml
deleted file mode 100644
index 9d93075..0000000
--- a/Cargo.toml
+++ /dev/null
@@ -1,4 +0,0 @@
-[workspace]
-members = [
-  "lib",
-]
diff --git a/ci/01-base.sh b/ci/01-base.sh
index 2fe2ffa..45043a6 100755
--- a/ci/01-base.sh
+++ b/ci/01-base.sh
@@ -1,27 +1,38 @@
 #!/bin/bash
 
-#开始检查
+cd ../rust
+
+# 开始检查
 cargo fmt --all -- --check -v
 cargo clean
 
-#cargo clippy --all-targets --all-features --tests --benches -- -D warnings
+# cargo clippy --all-targets --all-features --tests --benches -- -D warnings
 cargo clippy --all-targets --all-features --tests --benches -- -v
 cargo clean
 
 cargo check
 cargo clean
 
-#cargo rustc -- -D warnings
-bin=$(sed -n '/[[bin]]/ {n;p}' Cargo.toml | sed 's/\"//g' | sed 's/name = //g')
-for bin_name in $bin
-do
-echo $bin_name
-cargo rustc --bin $bin_name -- -D warnings -v
-done
+# cargo rustc -- -D warnings
+# bin=$(sed -n '/[[bin]]/ {n;p}' Cargo.toml | sed 's/\"//g' | sed 's/name = //g')
+# for bin_name in $bin
+# do
+# echo $bin_name
+# cargo rustc --bin $bin_name -- -D warnings -v
+# done
 
 cargo build --release -v
 
-#RUST_BACKTRACE=1 cargo test --all -v -- --nocapture --test-threads=1
-RUST_BACKTRACE=1 cargo test --all -- --nocapture
+# RUST_BACKTRACE=1 cargo test --all -v -- --nocapture --test-threads=1
+# RUST_BACKTRACE=1 cargo test --all -- --nocapture
+
+# cargo doc --all --no-deps
+
+cd ../
+
+aclocal
+automake
+
+LDFLAGS="-L`pwd`/rust/target/release" LIBS="-lrust_project -ldl" ./configure --disable-shared
 
-cargo doc --all --no-deps
+make
\ No newline at end of file
diff --git a/lib/Cargo.toml b/lib/Cargo.toml
deleted file mode 100644
index 967427b..0000000
--- a/lib/Cargo.toml
+++ /dev/null
@@ -1,24 +0,0 @@
-[package]
-name = "lib"
-version = "0.1.0"
-authors = ["seuzw <930zhaowei@163.com>"]
-edition = "2018"
-
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
-[lib]
-crate-type = ["lib"]
-path = "lib.rs"
-name = "lib"
-
-toml = "0.5.8"
-serde_derive = "1.0.130"
-serde = "1.0.130"
-log = "0.4"
-log4rs = "1.0"
-thiserror = "1.0"
-anyhow = "1.0"
-http = "0.2.6"
-procfs = "0.12.0"
-nix = "0.23.0"
-pathdiff = "0.2.1"
diff --git a/lib/lib.rs b/lib/lib.rs
deleted file mode 100644
index 9ff1ed3..0000000
--- a/lib/lib.rs
+++ /dev/null
@@ -1,5 +0,0 @@
-pub mod http_aws_sigv4;
-pub mod http_chunks;
-pub mod http_digest;
-pub mod http_ntlm;
-pub mod http_proxy;
diff --git a/rust/rust_ffi/build.rs b/rust/rust_ffi/build.rs
index 7d59d25..3d5e53c 100644
--- a/rust/rust_ffi/build.rs
+++ b/rust/rust_ffi/build.rs
@@ -8,4 +8,4 @@ fn main() {
 fn main() {
     // add macos dependencies below
     // println!("cargo:rustc-flags=-l edit");
-}
\ No newline at end of file
+}
diff --git a/rust/rust_ffi/lib.rs b/rust/rust_ffi/lib.rs
index 55a0c6c..d4d1549 100644
--- a/rust/rust_ffi/lib.rs
+++ b/rust/rust_ffi/lib.rs
@@ -7,12 +7,7 @@
     unused_assignments,
     unused_mut
 )]
-#![feature(
-    c_variadic,
-    extern_types,
-    label_break_value,
-    register_tool
-)]
+#![feature(c_variadic, extern_types, label_break_value, register_tool)]
 #![register_tool(c2rust)]
 
 #[macro_use]
@@ -23,4 +18,4 @@ pub mod src {
     pub mod ffi_alias;
     pub mod ffi_fun;
     pub mod ffi_struct;
-}
\ No newline at end of file
+}
diff --git a/rust/rust_ffi/src/ffi_alias/mod.rs b/rust/rust_ffi/src/ffi_alias/mod.rs
index b0be722..78804ab 100644
--- a/rust/rust_ffi/src/ffi_alias/mod.rs
+++ b/rust/rust_ffi/src/ffi_alias/mod.rs
@@ -1 +1 @@
-pub mod type_alias;
\ No newline at end of file
+pub mod type_alias;
diff --git a/rust/rust_ffi/src/ffi_alias/type_alias.rs b/rust/rust_ffi/src/ffi_alias/type_alias.rs
index fb4089c..bc077a3 100644
--- a/rust/rust_ffi/src/ffi_alias/type_alias.rs
+++ b/rust/rust_ffi/src/ffi_alias/type_alias.rs
@@ -24,57 +24,49 @@ pub type _IO_lock_t = ();
 pub type curl_sslbackend = libc::c_uint;
 pub type bit = libc::c_uint;
 pub type CURLproxycode = libc::c_uint;
-pub type wildcard_dtor = Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
-pub type Curl_llist_dtor = Option::<unsafe extern "C" fn(*mut libc::c_void, *mut libc::c_void) -> (),>;
+pub type wildcard_dtor = Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
+pub type Curl_llist_dtor = Option<unsafe extern "C" fn(*mut libc::c_void, *mut libc::c_void) -> ()>;
 pub type wildcard_states = libc::c_uint;
 pub type trailers_state = libc::c_uint;
 pub type Curl_HttpReq = libc::c_uint;
 // pub type CURLU = Curl_URL;
-pub type curl_read_callback = Option::<unsafe extern "C" fn(*mut libc::c_char, size_t, size_t, *mut libc::c_void) -> size_t,>;
+pub type curl_read_callback =
+    Option<unsafe extern "C" fn(*mut libc::c_char, size_t, size_t, *mut libc::c_void) -> size_t>;
 pub type expire_id = libc::c_uint;
-pub type Curl_hash_dtor = Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
-pub type comp_function = Option::<unsafe extern "C" fn(*mut libc::c_void, size_t, *mut libc::c_void, size_t) -> size_t,>;
-pub type hash_function = Option::<unsafe extern "C" fn(*mut libc::c_void, size_t, size_t) -> size_t,>;
+pub type Curl_hash_dtor = Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
+pub type comp_function =
+    Option<unsafe extern "C" fn(*mut libc::c_void, size_t, *mut libc::c_void, size_t) -> size_t>;
+pub type hash_function = Option<unsafe extern "C" fn(*mut libc::c_void, size_t, size_t) -> size_t>;
 pub type timediff_t = curl_off_t;
 // pub type curl_trailer_callback = Option::<unsafe extern "C" fn(*mut *mut curl_slist, *mut libc::c_void) -> libc::c_int,>;
 // pub type multidone_func = Option::<unsafe extern "C" fn(*mut Curl_easy, CURLcode) -> libc::c_int,>;
 pub type CURLcode = libc::c_uint;
-pub type curl_resolver_start_callback = Option::<
-    unsafe extern "C" fn(
-        *mut libc::c_void,
-        *mut libc::c_void,
-        *mut libc::c_void,
-    ) -> libc::c_int,
+pub type curl_resolver_start_callback = Option<
+    unsafe extern "C" fn(*mut libc::c_void, *mut libc::c_void, *mut libc::c_void) -> libc::c_int,
 >;
-pub type curl_fnmatch_callback = Option::<
+pub type curl_fnmatch_callback = Option<
     unsafe extern "C" fn(
         *mut libc::c_void,
         *const libc::c_char,
         *const libc::c_char,
     ) -> libc::c_int,
 >;
-pub type curl_chunk_end_callback = Option::<
-    unsafe extern "C" fn(*mut libc::c_void) -> libc::c_long,
->;
-pub type curl_chunk_bgn_callback = Option::<
-unsafe extern "C" fn(
-    *const libc::c_void,
-    *mut libc::c_void,
-        libc::c_int,
-    ) -> libc::c_long,
+pub type curl_chunk_end_callback = Option<unsafe extern "C" fn(*mut libc::c_void) -> libc::c_long>;
+pub type curl_chunk_bgn_callback = Option<
+    unsafe extern "C" fn(*const libc::c_void, *mut libc::c_void, libc::c_int) -> libc::c_long,
 >;
 pub type Curl_RtspReq = libc::c_uint;
 pub type curl_usessl = libc::c_uint;
 pub type CURL_NETRC_OPTION = libc::c_uint;
 // pub type curl_sshkeycallback = Option::<
 //     unsafe extern "C" fn(
-    //         *mut CURL,
-    //         *const curl_khkey,
-    //         *const curl_khkey,
-    //         curl_khmatch,
-    //         *mut libc::c_void,
-    //     ) -> libc::c_int,
-    // >;
+//         *mut CURL,
+//         *const curl_khkey,
+//         *const curl_khkey,
+//         curl_khmatch,
+//         *mut libc::c_void,
+//     ) -> libc::c_int,
+// >;
 pub type curl_khmatch = libc::c_uint;
 pub type curl_khtype = libc::c_uint;
 // pub type CURL = Curl_easy;
@@ -88,8 +80,9 @@ pub type CURL_TLSAUTH = libc::c_uint;
 pub type curl_proxytype = libc::c_uint;
 pub type curl_TimeCond = libc::c_uint;
 pub type mimestate = libc::c_uint;
-pub type curl_free_callback = Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
-pub type curl_seek_callback = Option::<unsafe extern "C" fn(*mut libc::c_void, curl_off_t, libc::c_int) -> libc::c_int,>;
+pub type curl_free_callback = Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
+pub type curl_seek_callback =
+    Option<unsafe extern "C" fn(*mut libc::c_void, curl_off_t, libc::c_int) -> libc::c_int>;
 pub type mimekind = libc::c_uint;
 // pub type curl_hstswrite_callback = Option::<
 //     unsafe extern "C" fn(
@@ -107,8 +100,9 @@ pub type CURLSTScode = libc::c_uint;
 //         *mut libc::c_void,
 //     ) -> CURLSTScode,
 // >;
-pub type curl_conv_callback = Option::<unsafe extern "C" fn(*mut libc::c_char, size_t) -> CURLcode,>;
-pub type curl_closesocket_callback = Option::<unsafe extern "C" fn(*mut libc::c_void, curl_socket_t) -> libc::c_int,>;
+pub type curl_conv_callback = Option<unsafe extern "C" fn(*mut libc::c_char, size_t) -> CURLcode>;
+pub type curl_closesocket_callback =
+    Option<unsafe extern "C" fn(*mut libc::c_void, curl_socket_t) -> libc::c_int>;
 pub type curl_socket_t = libc::c_int;
 // pub type curl_opensocket_callback = Option::<
 //     unsafe extern "C" fn(
@@ -118,7 +112,8 @@ pub type curl_socket_t = libc::c_int;
 //     ) -> curl_socket_t,
 // >;
 pub type curlsocktype = libc::c_uint;
-pub type curl_sockopt_callback = Option::<unsafe extern "C" fn(*mut libc::c_void, curl_socket_t, curlsocktype) -> libc::c_int,>;
+pub type curl_sockopt_callback =
+    Option<unsafe extern "C" fn(*mut libc::c_void, curl_socket_t, curlsocktype) -> libc::c_int>;
 // pub type curl_ioctl_callback = Option::<
 //     unsafe extern "C" fn(*mut CURL, libc::c_int, *mut libc::c_void) -> curlioerr,
 // >;
@@ -133,7 +128,7 @@ pub type curlioerr = libc::c_uint;
 //     ) -> libc::c_int,
 // >;
 pub type curl_infotype = libc::c_uint;
-pub type curl_xferinfo_callback = Option::<
+pub type curl_xferinfo_callback = Option<
     unsafe extern "C" fn(
         *mut libc::c_void,
         curl_off_t,
@@ -142,7 +137,7 @@ pub type curl_xferinfo_callback = Option::<
         curl_off_t,
     ) -> libc::c_int,
 >;
-pub type curl_progress_callback = Option::<
+pub type curl_progress_callback = Option<
     unsafe extern "C" fn(
         *mut libc::c_void,
         libc::c_double,
@@ -151,9 +146,8 @@ pub type curl_progress_callback = Option::<
         libc::c_double,
     ) -> libc::c_int,
 >;
-pub type curl_write_callback = Option::<
-    unsafe extern "C" fn(*mut libc::c_char, size_t, size_t, *mut libc::c_void) -> size_t,
->;
+pub type curl_write_callback =
+    Option<unsafe extern "C" fn(*mut libc::c_char, size_t, size_t, *mut libc::c_void) -> size_t>;
 pub type curl_pp_transfer = libc::c_uint;
 pub type uint8_t = __uint8_t;
 pub type uint32_t = __uint32_t;
@@ -216,7 +210,6 @@ pub type ChunkyState = libc::c_uint;
 pub type connect_t = libc::c_uint;
 pub type dupstring = libc::c_uint;
 
-
 // ----------------------Constants----------------------
 // curl_sslbackend
 pub const CURLSSLBACKEND_RUSTLS: curl_sslbackend = 14;
@@ -920,4 +913,4 @@ pub const STRING_COOKIE: dupstring = 4;
 pub const STRING_CERT_TYPE_PROXY: dupstring = 3;
 pub const STRING_CERT_TYPE: dupstring = 2;
 pub const STRING_CERT_PROXY: dupstring = 1;
-pub const STRING_CERT: dupstring = 0;
\ No newline at end of file
+pub const STRING_CERT: dupstring = 0;
diff --git a/rust/rust_ffi/src/ffi_fun/fun_call.rs b/rust/rust_ffi/src/ffi_fun/fun_call.rs
index 1166d2a..ddb6122 100644
--- a/rust/rust_ffi/src/ffi_fun/fun_call.rs
+++ b/rust/rust_ffi/src/ffi_fun/fun_call.rs
@@ -66,5 +66,5 @@ extern "C" {
     // vtls/vtls.rs
 
     // vtls/wolfssl.rs
-    
-}
\ No newline at end of file
+
+}
diff --git a/rust/rust_ffi/src/ffi_fun/mod.rs b/rust/rust_ffi/src/ffi_fun/mod.rs
index 03184eb..97cfebb 100644
--- a/rust/rust_ffi/src/ffi_fun/mod.rs
+++ b/rust/rust_ffi/src/ffi_fun/mod.rs
@@ -1 +1 @@
-pub mod fun_call;
\ No newline at end of file
+pub mod fun_call;
diff --git a/rust/rust_ffi/src/ffi_struct/mod.rs b/rust/rust_ffi/src/ffi_struct/mod.rs
index e4061a1..91d4de3 100644
--- a/rust/rust_ffi/src/ffi_struct/mod.rs
+++ b/rust/rust_ffi/src/ffi_struct/mod.rs
@@ -1 +1 @@
-pub mod struct_define;
\ No newline at end of file
+pub mod struct_define;
diff --git a/rust/rust_ffi/src/ffi_struct/struct_define.rs b/rust/rust_ffi/src/ffi_struct/struct_define.rs
index 9af0d6a..ef41a51 100644
--- a/rust/rust_ffi/src/ffi_struct/struct_define.rs
+++ b/rust/rust_ffi/src/ffi_struct/struct_define.rs
@@ -1,5 +1,5 @@
-use c2rust_bitfields::BitfieldStruct;
 use crate::src::ffi_alias::type_alias::*;
+use c2rust_bitfields::BitfieldStruct;
 
 // http_ntlm.rs + vtls/keylog.rs
 #[derive(Copy, Clone)]
@@ -1475,7 +1475,8 @@ pub struct ConnectBits {
     #[bitfield(name = "tls_upgraded", ty = "bit", bits = "32..=32")]
     #[bitfield(name = "sock_accepted", ty = "bit", bits = "33..=33")]
     #[bitfield(name = "parallel_connect", ty = "bit", bits = "34..=34")]
-    pub httpproxy_socksproxy_proxy_user_passwd_tunnel_proxy_proxy_connect_closed_close_reuse_altused_conn_to_host_conn_to_port_proxy_user_passwd_ipv6_ip_ipv6_do_more_protoconnstart_retry_authneg_rewindaftersend_ftp_use_epsv_ftp_use_eprt_ftp_use_data_ssl_ftp_use_control_ssl_netrc_bound_multiplex_tcp_fastopen_tls_enable_npn_tls_enable_alpn_connect_only_doh_abstract_unix_socket_tls_upgraded_sock_accepted_parallel_connect: [u8; 5],
+    pub httpproxy_socksproxy_proxy_user_passwd_tunnel_proxy_proxy_connect_closed_close_reuse_altused_conn_to_host_conn_to_port_proxy_user_passwd_ipv6_ip_ipv6_do_more_protoconnstart_retry_authneg_rewindaftersend_ftp_use_epsv_ftp_use_eprt_ftp_use_data_ssl_ftp_use_control_ssl_netrc_bound_multiplex_tcp_fastopen_tls_enable_npn_tls_enable_alpn_connect_only_doh_abstract_unix_socket_tls_upgraded_sock_accepted_parallel_connect:
+        [u8; 5],
     #[bitfield(padding)]
     pub c2rust_padding: [u8; 3],
 }
@@ -1525,7 +1526,7 @@ pub struct connstate {
 #[derive(Copy, Clone)]
 #[repr(C)]
 pub struct bufref {
-    pub dtor: Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>,
+    pub dtor: Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>,
     pub ptr: *const libc::c_uchar,
     pub len: size_t,
-}
\ No newline at end of file
+}
diff --git a/rust/rust_project/build.rs b/rust/rust_project/build.rs
index 7d59d25..3d5e53c 100644
--- a/rust/rust_project/build.rs
+++ b/rust/rust_project/build.rs
@@ -8,4 +8,4 @@ fn main() {
 fn main() {
     // add macos dependencies below
     // println!("cargo:rustc-flags=-l edit");
-}
\ No newline at end of file
+}
diff --git a/rust/rust_project/lib.rs b/rust/rust_project/lib.rs
index 6b366d7..6b31642 100644
--- a/rust/rust_project/lib.rs
+++ b/rust/rust_project/lib.rs
@@ -7,12 +7,7 @@
     unused_assignments,
     unused_mut
 )]
-#![feature(
-    c_variadic,
-    extern_types,
-    label_break_value,
-    register_tool
-)]
+#![feature(c_variadic, extern_types, label_break_value, register_tool)]
 #![register_tool(c2rust)]
 
 #[macro_use]
@@ -48,4 +43,4 @@ pub mod src {
         // pub mod vtls;
         // pub mod wolfssl;
     }
-}
\ No newline at end of file
+}
diff --git a/rust/rust_project/src/http_ntlm.rs b/rust/rust_project/src/http_ntlm.rs
index dd0b83b..282dbec 100644
--- a/rust/rust_project/src/http_ntlm.rs
+++ b/rust/rust_project/src/http_ntlm.rs
@@ -22,11 +22,7 @@ extern "C" {
     pub type tftp_state_data;
     pub type nghttp2_session;
     pub type ssl_backend_data;
-    fn curl_strnequal(
-        s1: *const libc::c_char,
-        s2: *const libc::c_char,
-        n: size_t,
-    ) -> libc::c_int;
+    fn curl_strnequal(s1: *const libc::c_char, s2: *const libc::c_char, n: size_t) -> libc::c_int;
     fn Curl_isspace(c: libc::c_int) -> libc::c_int;
     fn curl_free(p: *mut libc::c_void);
     fn strlen(_: *const libc::c_char) -> libc::c_ulong;
@@ -70,7 +66,7 @@ extern "C" {
         br: *mut bufref,
         ptr: *const libc::c_void,
         len: size_t,
-        dtor: Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>,
+        dtor: Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>,
     );
     fn Curl_bufref_ptr(br: *const bufref) -> *const libc::c_uchar;
     fn Curl_bufref_len(br: *const bufref) -> size_t;
@@ -165,7 +161,7 @@ pub struct UrlState {
     pub os_errno: libc::c_int,
     pub scratch: *mut libc::c_char,
     pub followlocation: libc::c_long,
-    pub prev_signal: Option::<unsafe extern "C" fn(libc::c_int) -> ()>,
+    pub prev_signal: Option<unsafe extern "C" fn(libc::c_int) -> ()>,
     pub digest: digestdata,
     pub proxydigest: digestdata,
     pub authhost: auth,
@@ -227,7 +223,8 @@ pub struct UrlState {
     #[bitfield(name = "url_alloc", ty = "bit", bits = "18..=18")]
     #[bitfield(name = "referer_alloc", ty = "bit", bits = "19..=19")]
     #[bitfield(name = "wildcard_resolve", ty = "bit", bits = "20..=20")]
-    pub multi_owned_by_easy_this_is_a_follow_refused_stream_errorbuf_allow_port_authproblem_ftp_trying_alternative_wildcardmatch_expect100header_disableexpect_use_range_rangestringalloc_done_stream_depends_e_previouslypending_cookie_engine_prefer_ascii_list_only_url_alloc_referer_alloc_wildcard_resolve: [u8; 3],
+    pub multi_owned_by_easy_this_is_a_follow_refused_stream_errorbuf_allow_port_authproblem_ftp_trying_alternative_wildcardmatch_expect100header_disableexpect_use_range_rangestringalloc_done_stream_depends_e_previouslypending_cookie_engine_prefer_ascii_list_only_url_alloc_referer_alloc_wildcard_resolve:
+        [u8; 3],
     #[bitfield(padding)]
     pub c2rust_padding_0: [u8; 5],
 }
@@ -486,14 +483,12 @@ pub struct UserDefined {
     #[bitfield(name = "doh_verifystatus", ty = "bit", bits = "59..=59")]
     #[bitfield(name = "http09_allowed", ty = "bit", bits = "60..=60")]
     #[bitfield(name = "mail_rcpt_allowfails", ty = "bit", bits = "61..=61")]
-    pub is_fread_set_is_fwrite_set_free_referer_tftp_no_options_sep_headers_cookiesession_crlf_strip_path_slash_ssh_compression_get_filetime_tunnel_thru_httpproxy_prefer_ascii_remote_append_list_only_ftp_use_port_ftp_use_epsv_ftp_use_eprt_ftp_use_pret_ftp_skip_ip_hide_progress_http_fail_on_error_http_keep_sending_on_error_http_follow_location_http_transfer_encoding_allow_auth_to_other_hosts_include_header_http_set_referer_http_auto_referer_opt_no_body_upload_verbose_krb_reuse_forbid_reuse_fresh_no_signal_tcp_nodelay_ignorecl_connect_only_http_te_skip_http_ce_skip_proxy_transfer_mode_sasl_ir_wildcard_enabled_tcp_keepalive_tcp_fastopen_ssl_enable_npn_ssl_enable_alpn_path_as_is_pipewait_suppress_connect_headers_dns_shuffle_addresses_stream_depends_e_haproxyprotocol_abstract_unix_socket_disallow_username_in_url_doh_doh_get_doh_verifypeer_doh_verifyhost_doh_verifystatus_http09_allowed_mail_rcpt_allowfails: [u8; 8],
+    pub is_fread_set_is_fwrite_set_free_referer_tftp_no_options_sep_headers_cookiesession_crlf_strip_path_slash_ssh_compression_get_filetime_tunnel_thru_httpproxy_prefer_ascii_remote_append_list_only_ftp_use_port_ftp_use_epsv_ftp_use_eprt_ftp_use_pret_ftp_skip_ip_hide_progress_http_fail_on_error_http_keep_sending_on_error_http_follow_location_http_transfer_encoding_allow_auth_to_other_hosts_include_header_http_set_referer_http_auto_referer_opt_no_body_upload_verbose_krb_reuse_forbid_reuse_fresh_no_signal_tcp_nodelay_ignorecl_connect_only_http_te_skip_http_ce_skip_proxy_transfer_mode_sasl_ir_wildcard_enabled_tcp_keepalive_tcp_fastopen_ssl_enable_npn_ssl_enable_alpn_path_as_is_pipewait_suppress_connect_headers_dns_shuffle_addresses_stream_depends_e_haproxyprotocol_abstract_unix_socket_disallow_username_in_url_doh_doh_get_doh_verifypeer_doh_verifyhost_doh_verifystatus_http09_allowed_mail_rcpt_allowfails:
+        [u8; 8],
 }
-pub type curl_trailer_callback = Option::<
-    unsafe extern "C" fn(*mut *mut curl_slist, *mut libc::c_void) -> libc::c_int,
->;
-pub type multidone_func = Option::<
-    unsafe extern "C" fn(*mut Curl_easy, CURLcode) -> libc::c_int,
->;
+pub type curl_trailer_callback =
+    Option<unsafe extern "C" fn(*mut *mut curl_slist, *mut libc::c_void) -> libc::c_int>;
+pub type multidone_func = Option<unsafe extern "C" fn(*mut Curl_easy, CURLcode) -> libc::c_int>;
 
 #[derive(Copy, Clone)]
 #[repr(C)]
@@ -502,7 +497,7 @@ pub struct Curl_http2_dep {
     pub data: *mut Curl_easy,
 }
 
-pub type curl_sshkeycallback = Option::<
+pub type curl_sshkeycallback = Option<
     unsafe extern "C" fn(
         *mut CURL,
         *const curl_khkey,
@@ -537,13 +532,13 @@ pub struct ssl_config_data {
     #[bitfield(name = "revoke_best_effort", ty = "bit", bits = "5..=5")]
     #[bitfield(name = "native_ca_store", ty = "bit", bits = "6..=6")]
     #[bitfield(name = "auto_client_cert", ty = "bit", bits = "7..=7")]
-    pub certinfo_falsestart_enable_beast_no_revoke_no_partialchain_revoke_best_effort_native_ca_store_auto_client_cert: [u8; 1],
+    pub certinfo_falsestart_enable_beast_no_revoke_no_partialchain_revoke_best_effort_native_ca_store_auto_client_cert:
+        [u8; 1],
     #[bitfield(padding)]
     pub c2rust_padding: [u8; 3],
 }
-pub type curl_ssl_ctx_callback = Option::<
-    unsafe extern "C" fn(*mut CURL, *mut libc::c_void, *mut libc::c_void) -> CURLcode,
->;
+pub type curl_ssl_ctx_callback =
+    Option<unsafe extern "C" fn(*mut CURL, *mut libc::c_void, *mut libc::c_void) -> CURLcode>;
 #[derive(Copy, Clone)]
 #[repr(C)]
 pub struct curl_mimepart {
@@ -573,17 +568,11 @@ pub struct curl_mimepart {
 #[repr(C)]
 pub struct mime_encoder {
     pub name: *const libc::c_char,
-    pub encodefunc: Option::<
-        unsafe extern "C" fn(
-            *mut libc::c_char,
-            size_t,
-            bool,
-            *mut curl_mimepart,
-        ) -> size_t,
-    >,
-    pub sizefunc: Option::<unsafe extern "C" fn(*mut curl_mimepart) -> curl_off_t>,
+    pub encodefunc:
+        Option<unsafe extern "C" fn(*mut libc::c_char, size_t, bool, *mut curl_mimepart) -> size_t>,
+    pub sizefunc: Option<unsafe extern "C" fn(*mut curl_mimepart) -> curl_off_t>,
 }
-pub type curl_free_callback = Option::<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
+pub type curl_free_callback = Option<unsafe extern "C" fn(*mut libc::c_void) -> ()>;
 #[derive(Copy, Clone)]
 #[repr(C)]
 pub struct curl_mime {
@@ -594,7 +583,7 @@ pub struct curl_mime {
     pub boundary: [libc::c_char; 41],
     pub state: mime_state,
 }
-pub type curl_hstswrite_callback = Option::<
+pub type curl_hstswrite_callback = Option<
     unsafe extern "C" fn(
         *mut CURL,
         *mut curl_hstsentry,
@@ -602,24 +591,14 @@ pub type curl_hstswrite_callback = Option::<
         *mut libc::c_void,
     ) -> CURLSTScode,
 >;
-pub type curl_hstsread_callback = Option::<
-    unsafe extern "C" fn(
-        *mut CURL,
-        *mut curl_hstsentry,
-        *mut libc::c_void,
-    ) -> CURLSTScode,
+pub type curl_hstsread_callback =
+    Option<unsafe extern "C" fn(*mut CURL, *mut curl_hstsentry, *mut libc::c_void) -> CURLSTScode>;
+pub type curl_opensocket_callback = Option<
+    unsafe extern "C" fn(*mut libc::c_void, curlsocktype, *mut curl_sockaddr) -> curl_socket_t,
 >;
-pub type curl_opensocket_callback = Option::<
-    unsafe extern "C" fn(
-        *mut libc::c_void,
-        curlsocktype,
-        *mut curl_sockaddr,
-    ) -> curl_socket_t,
->;
-pub type curl_ioctl_callback = Option::<
-    unsafe extern "C" fn(*mut CURL, libc::c_int, *mut libc::c_void) -> curlioerr,
->;
-pub type curl_debug_callback = Option::<
+pub type curl_ioctl_callback =
+    Option<unsafe extern "C" fn(*mut CURL, libc::c_int, *mut libc::c_void) -> curlioerr>;
+pub type curl_debug_callback = Option<
     unsafe extern "C" fn(
         *mut CURL,
         curl_infotype,
@@ -668,7 +647,8 @@ pub struct SingleRequest {
     #[bitfield(name = "upload_chunky", ty = "bit", bits = "7..=7")]
     #[bitfield(name = "getheader", ty = "bit", bits = "8..=8")]
     #[bitfield(name = "forbidchunk", ty = "bit", bits = "9..=9")]
-    pub header_content_range_upload_done_ignorebody_http_bodyless_chunk_ignore_cl_upload_chunky_getheader_forbidchunk: [u8; 2],
+    pub header_content_range_upload_done_ignorebody_http_bodyless_chunk_ignore_cl_upload_chunky_getheader_forbidchunk:
+        [u8; 2],
     #[bitfield(padding)]
     pub c2rust_padding: [u8; 6],
 }
@@ -778,11 +758,10 @@ pub struct Curl_multi {
     pub ipv6_works: bool,
     pub ssl_seeded: bool,
 }
-pub type curl_multi_timer_callback = Option::<
-    unsafe extern "C" fn(*mut CURLM, libc::c_long, *mut libc::c_void) -> libc::c_int,
->;
+pub type curl_multi_timer_callback =
+    Option<unsafe extern "C" fn(*mut CURLM, libc::c_long, *mut libc::c_void) -> libc::c_int>;
 pub type CURLM = Curl_multi;
-pub type curl_push_callback = Option::<
+pub type curl_push_callback = Option<
     unsafe extern "C" fn(
         *mut CURL,
         *mut CURL,
@@ -791,7 +770,7 @@ pub type curl_push_callback = Option::<
         *mut libc::c_void,
     ) -> libc::c_int,
 >;
-pub type curl_socket_callback = Option::<
+pub type curl_socket_callback = Option<
     unsafe extern "C" fn(
         *mut CURL,
         curl_socket_t,
@@ -856,8 +835,8 @@ pub struct connectdata {
     pub sock: [curl_socket_t; 2],
     pub tempsock: [curl_socket_t; 2],
     pub tempfamily: [libc::c_int; 2],
-    pub recv: [Option::<Curl_recv>; 2],
-    pub send: [Option::<Curl_send>; 2],
+    pub recv: [Option<Curl_recv>; 2],
+    pub send: [Option<Curl_send>; 2],
     pub ssl: [ssl_connect_data; 2],
     pub proxy_ssl: [ssl_connect_data; 2],
     pub ssl_extra: *mut libc::c_void,
@@ -939,7 +918,7 @@ pub struct SASLproto {
     pub contcode: libc::c_int,
     pub finalcode: libc::c_int,
     pub maxirlen: size_t,
-    pub sendauth: Option::<
+    pub sendauth: Option<
         unsafe extern "C" fn(
             *mut Curl_easy,
             *mut connectdata,
@@ -947,16 +926,10 @@ pub struct SASLproto {
             *const libc::c_char,
         ) -> CURLcode,
     >,
-    pub sendcont: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *const libc::c_char,
-        ) -> CURLcode,
-    >,
-    pub getmessage: Option::<
-        unsafe extern "C" fn(*mut libc::c_char, *mut *mut libc::c_char) -> (),
+    pub sendcont: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *const libc::c_char) -> CURLcode,
     >,
+    pub getmessage: Option<unsafe extern "C" fn(*mut libc::c_char, *mut *mut libc::c_char) -> ()>,
 }
 #[derive(Copy, Clone)]
 #[repr(C)]
@@ -972,10 +945,8 @@ pub struct pingpong {
     pub response: curltime,
     pub response_time: timediff_t,
     pub sendbuf: dynbuf,
-    pub statemachine: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> CURLcode,
-    >,
-    pub endofresp: Option::<
+    pub statemachine: Option<unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> CURLcode>,
+    pub endofresp: Option<
         unsafe extern "C" fn(
             *mut Curl_easy,
             *mut connectdata,
@@ -1024,8 +995,8 @@ pub struct http_conn {
     pub binlen: size_t,
     pub trnsfr: *mut Curl_easy,
     pub h2: *mut nghttp2_session,
-    pub send_underlying: Option::<Curl_send>,
-    pub recv_underlying: Option::<Curl_recv>,
+    pub send_underlying: Option<Curl_send>,
+    pub recv_underlying: Option<Curl_recv>,
     pub inbuf: *mut libc::c_char,
     pub inbuflen: size_t,
     pub nread_inbuf: size_t,
@@ -1080,68 +1051,35 @@ pub struct ftp_conn {
 #[repr(C)]
 pub struct Curl_handler {
     pub scheme: *const libc::c_char,
-    pub setup_connection: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> CURLcode,
+    pub setup_connection:
+        Option<unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> CURLcode>,
+    pub do_it: Option<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
+    pub done: Option<unsafe extern "C" fn(*mut Curl_easy, CURLcode, bool) -> CURLcode>,
+    pub do_more: Option<unsafe extern "C" fn(*mut Curl_easy, *mut libc::c_int) -> CURLcode>,
+    pub connect_it: Option<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
+    pub connecting: Option<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
+    pub doing: Option<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
+    pub proto_getsock: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *mut curl_socket_t) -> libc::c_int,
     >,
-    pub do_it: Option::<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
-    pub done: Option::<unsafe extern "C" fn(*mut Curl_easy, CURLcode, bool) -> CURLcode>,
-    pub do_more: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut libc::c_int) -> CURLcode,
+    pub doing_getsock: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *mut curl_socket_t) -> libc::c_int,
     >,
-    pub connect_it: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode,
+    pub domore_getsock: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *mut curl_socket_t) -> libc::c_int,
     >,
-    pub connecting: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode,
-    >,
-    pub doing: Option::<unsafe extern "C" fn(*mut Curl_easy, *mut bool) -> CURLcode>,
-    pub proto_getsock: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *mut curl_socket_t,
-        ) -> libc::c_int,
+    pub perform_getsock: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *mut curl_socket_t) -> libc::c_int,
     >,
-    pub doing_getsock: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *mut curl_socket_t,
-        ) -> libc::c_int,
+    pub disconnect:
+        Option<unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, bool) -> CURLcode>,
+    pub readwrite: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, *mut ssize_t, *mut bool) -> CURLcode,
     >,
-    pub domore_getsock: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *mut curl_socket_t,
-        ) -> libc::c_int,
+    pub connection_check: Option<
+        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, libc::c_uint) -> libc::c_uint,
     >,
-    pub perform_getsock: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *mut curl_socket_t,
-        ) -> libc::c_int,
-    >,
-    pub disconnect: Option::<
-        unsafe extern "C" fn(*mut Curl_easy, *mut connectdata, bool) -> CURLcode,
-    >,
-    pub readwrite: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            *mut ssize_t,
-            *mut bool,
-        ) -> CURLcode,
-    >,
-    pub connection_check: Option::<
-        unsafe extern "C" fn(
-            *mut Curl_easy,
-            *mut connectdata,
-            libc::c_uint,
-        ) -> libc::c_uint,
-    >,
-    pub attach: Option::<unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> ()>,
+    pub attach: Option<unsafe extern "C" fn(*mut Curl_easy, *mut connectdata) -> ()>,
     pub defport: libc::c_int,
     pub protocol: libc::c_uint,
     pub family: libc::c_uint,
@@ -1185,8 +1123,7 @@ pub unsafe extern "C" fn Curl_input_ntlm(
         strlen(b"NTLM\0" as *const u8 as *const libc::c_char),
     ) != 0
     {
-        header = header
-            .offset(strlen(b"NTLM\0" as *const u8 as *const libc::c_char) as isize);
+        header = header.offset(strlen(b"NTLM\0" as *const u8 as *const libc::c_char) as isize);
         while *header as libc::c_int != 0
             && Curl_isspace(*header as libc::c_uchar as libc::c_int) != 0
         {
@@ -1223,9 +1160,7 @@ pub unsafe extern "C" fn Curl_input_ntlm(
                     b"NTLM auth restarted\0" as *const u8 as *const libc::c_char,
                 );
                 Curl_http_auth_cleanup_ntlm(conn);
-            } else if *state as libc::c_uint
-                    == NTLMSTATE_TYPE3 as libc::c_int as libc::c_uint
-                {
+            } else if *state as libc::c_uint == NTLMSTATE_TYPE3 as libc::c_int as libc::c_uint {
                 Curl_infof(
                     data,
                     b"NTLM handshake rejected\0" as *const u8 as *const libc::c_char,
@@ -1233,17 +1168,15 @@ pub unsafe extern "C" fn Curl_input_ntlm(
                 Curl_http_auth_cleanup_ntlm(conn);
                 *state = NTLMSTATE_NONE;
                 return CURLE_REMOTE_ACCESS_DENIED;
-            } else {
-                if *state as libc::c_uint
-                    >= NTLMSTATE_TYPE1 as libc::c_int as libc::c_uint
-                {
-                    Curl_infof(
-                        data,
-                        b"NTLM handshake failure (internal error)\0" as *const u8
-                            as *const libc::c_char,
-                    );
-                    return CURLE_REMOTE_ACCESS_DENIED;
-                }
+            } else if *state as libc::c_uint >= NTLMSTATE_TYPE1 as libc::c_int as libc::c_uint {
+                // if *state as libc::c_uint >= NTLMSTATE_TYPE1 as libc::c_int as libc::c_uint {
+                Curl_infof(
+                    data,
+                    b"NTLM handshake failure (internal error)\0" as *const u8
+                        as *const libc::c_char,
+                );
+                return CURLE_REMOTE_ACCESS_DENIED;
+                // }
             }
             *state = NTLMSTATE_TYPE1;
         }
@@ -1251,10 +1184,7 @@ pub unsafe extern "C" fn Curl_input_ntlm(
     return result;
 }
 #[no_mangle]
-pub unsafe extern "C" fn Curl_output_ntlm(
-    mut data: *mut Curl_easy,
-    mut proxy: bool,
-) -> CURLcode {
+pub unsafe extern "C" fn Curl_output_ntlm(mut data: *mut Curl_easy, mut proxy: bool) -> CURLcode {
     let mut base64: *mut libc::c_char = 0 as *mut libc::c_char;
     let mut len: size_t = 0 as libc::c_int as size_t;
     let mut result: CURLcode = CURLE_OK;
@@ -1276,16 +1206,13 @@ pub unsafe extern "C" fn Curl_output_ntlm(
         allocuserpwd = &mut (*data).state.aptr.proxyuserpwd;
         userp = (*data).state.aptr.proxyuser;
         passwdp = (*data).state.aptr.proxypasswd;
-        service = if !((*data)
-            .set
-            .str_0[STRING_PROXY_SERVICE_NAME as libc::c_int as usize])
-            .is_null()
-        {
-            (*data).set.str_0[STRING_PROXY_SERVICE_NAME as libc::c_int as usize]
-                as *const libc::c_char
-        } else {
-            b"HTTP\0" as *const u8 as *const libc::c_char
-        };
+        service =
+            if !((*data).set.str_0[STRING_PROXY_SERVICE_NAME as libc::c_int as usize]).is_null() {
+                (*data).set.str_0[STRING_PROXY_SERVICE_NAME as libc::c_int as usize]
+                    as *const libc::c_char
+            } else {
+                b"HTTP\0" as *const u8 as *const libc::c_char
+            };
         hostname = (*conn).http_proxy.host.name;
         ntlm = &mut (*conn).proxyntlm;
         state = &mut (*conn).proxy_ntlm_state;
@@ -1294,11 +1221,8 @@ pub unsafe extern "C" fn Curl_output_ntlm(
         allocuserpwd = &mut (*data).state.aptr.userpwd;
         userp = (*data).state.aptr.user;
         passwdp = (*data).state.aptr.passwd;
-        service = if !((*data).set.str_0[STRING_SERVICE_NAME as libc::c_int as usize])
-            .is_null()
-        {
-            (*data).set.str_0[STRING_SERVICE_NAME as libc::c_int as usize]
-                as *const libc::c_char
+        service = if !((*data).set.str_0[STRING_SERVICE_NAME as libc::c_int as usize]).is_null() {
+            (*data).set.str_0[STRING_SERVICE_NAME as libc::c_int as usize] as *const libc::c_char
         } else {
             b"HTTP\0" as *const u8 as *const libc::c_char
         };
@@ -1318,13 +1242,7 @@ pub unsafe extern "C" fn Curl_output_ntlm(
     let mut current_block_61: u64;
     match *state as libc::c_uint {
         2 => {
-            result = Curl_auth_create_ntlm_type3_message(
-                data,
-                userp,
-                passwdp,
-                ntlm,
-                &mut ntlmmsg,
-            );
+            result = Curl_auth_create_ntlm_type3_message(data, userp, passwdp, ntlm, &mut ntlmmsg);
             if result as u64 == 0 && Curl_bufref_len(&mut ntlmmsg) != 0 {
                 result = Curl_base64_encode(
                     data,
@@ -1334,13 +1252,11 @@ pub unsafe extern "C" fn Curl_output_ntlm(
                     &mut len,
                 );
                 if result as u64 == 0 {
-                    Curl_cfree
-                        .expect(
-                            "non-null function pointer",
-                        )(*allocuserpwd as *mut libc::c_void);
+                    Curl_cfree.expect("non-null function pointer")(
+                        *allocuserpwd as *mut libc::c_void,
+                    );
                     *allocuserpwd = curl_maprintf(
-                        b"%sAuthorization: NTLM %s\r\n\0" as *const u8
-                            as *const libc::c_char,
+                        b"%sAuthorization: NTLM %s\r\n\0" as *const u8 as *const libc::c_char,
                         if proxy as libc::c_int != 0 {
                             b"Proxy-\0" as *const u8 as *const libc::c_char
                         } else {
@@ -1348,10 +1264,7 @@ pub unsafe extern "C" fn Curl_output_ntlm(
                         },
                         base64,
                     );
-                    Curl_cfree
-                        .expect(
-                            "non-null function pointer",
-                        )(base64 as *mut libc::c_void);
+                    Curl_cfree.expect("non-null function pointer")(base64 as *mut libc::c_void);
                     if (*allocuserpwd).is_null() {
                         result = CURLE_OUT_OF_MEMORY;
                     } else {
@@ -1388,13 +1301,11 @@ pub unsafe extern "C" fn Curl_output_ntlm(
                     &mut len,
                 );
                 if result as u64 == 0 {
-                    Curl_cfree
-                        .expect(
-                            "non-null function pointer",
-                        )(*allocuserpwd as *mut libc::c_void);
+                    Curl_cfree.expect("non-null function pointer")(
+                        *allocuserpwd as *mut libc::c_void,
+                    );
                     *allocuserpwd = curl_maprintf(
-                        b"%sAuthorization: NTLM %s\r\n\0" as *const u8
-                            as *const libc::c_char,
+                        b"%sAuthorization: NTLM %s\r\n\0" as *const u8 as *const libc::c_char,
                         if proxy as libc::c_int != 0 {
                             b"Proxy-\0" as *const u8 as *const libc::c_char
                         } else {
@@ -1402,10 +1313,7 @@ pub unsafe extern "C" fn Curl_output_ntlm(
                         },
                         base64,
                     );
-                    Curl_cfree
-                        .expect(
-                            "non-null function pointer",
-                        )(base64 as *mut libc::c_void);
+                    Curl_cfree.expect("non-null function pointer")(base64 as *mut libc::c_void);
                     if (*allocuserpwd).is_null() {
                         result = CURLE_OUT_OF_MEMORY;
                     }
@@ -1416,8 +1324,7 @@ pub unsafe extern "C" fn Curl_output_ntlm(
     }
     match current_block_61 {
         660359442149512078 => {
-            Curl_cfree
-                .expect("non-null function pointer")(*allocuserpwd as *mut libc::c_void);
+            Curl_cfree.expect("non-null function pointer")(*allocuserpwd as *mut libc::c_void);
             *allocuserpwd = 0 as *mut libc::c_char;
             (*authp).set_done(1 as libc::c_int as bit);
         }
@@ -1431,4 +1338,4 @@ pub unsafe extern "C" fn Curl_http_auth_cleanup_ntlm(mut conn: *mut connectdata)
     Curl_auth_cleanup_ntlm(&mut (*conn).ntlm);
     Curl_auth_cleanup_ntlm(&mut (*conn).proxyntlm);
     Curl_http_auth_cleanup_ntlm_wb(conn);
-}
\ No newline at end of file
+}
diff --git a/rust/rust_project/src/vtls/keylog.rs b/rust/rust_project/src/vtls/keylog.rs
index 8789ff7..c342024 100644
--- a/rust/rust_project/src/vtls/keylog.rs
+++ b/rust/rust_project/src/vtls/keylog.rs
@@ -16,11 +16,7 @@ extern "C" {
         __n: size_t,
     ) -> libc::c_int;
     fn fputs(__s: *const libc::c_char, __stream: *mut FILE) -> libc::c_int;
-    fn memcpy(
-        _: *mut libc::c_void,
-        _: *const libc::c_void,
-        _: libc::c_ulong,
-    ) -> *mut libc::c_void;
+    fn memcpy(_: *mut libc::c_void, _: *const libc::c_void, _: libc::c_ulong) -> *mut libc::c_void;
     fn strlen(_: *const libc::c_char) -> libc::c_ulong;
     static mut Curl_cfree: curl_free_callback;
 }
@@ -64,14 +60,9 @@ static mut keylog_file_fp: *mut FILE = 0 as *const FILE as *mut FILE;
 pub unsafe extern "C" fn Curl_tls_keylog_open() {
     let mut keylog_file_name: *mut libc::c_char = 0 as *mut libc::c_char;
     if keylog_file_fp.is_null() {
-        keylog_file_name = curl_getenv(
-            b"SSLKEYLOGFILE\0" as *const u8 as *const libc::c_char,
-        );
+        keylog_file_name = curl_getenv(b"SSLKEYLOGFILE\0" as *const u8 as *const libc::c_char);
         if !keylog_file_name.is_null() {
-            keylog_file_fp = fopen(
-                keylog_file_name,
-                b"a\0" as *const u8 as *const libc::c_char,
-            );
+            keylog_file_fp = fopen(keylog_file_name, b"a\0" as *const u8 as *const libc::c_char);
             if !keylog_file_fp.is_null() {
                 if setvbuf(
                     keylog_file_fp,
@@ -84,10 +75,7 @@ pub unsafe extern "C" fn Curl_tls_keylog_open() {
                     keylog_file_fp = 0 as *mut FILE;
                 }
             }
-            Curl_cfree
-                .expect(
-                    "non-null function pointer",
-                )(keylog_file_name as *mut libc::c_void);
+            Curl_cfree.expect("non-null function pointer")(keylog_file_name as *mut libc::c_void);
             keylog_file_name = 0 as *mut libc::c_char;
         }
     }
@@ -104,9 +92,7 @@ pub unsafe extern "C" fn Curl_tls_keylog_enabled() -> bool {
     return !keylog_file_fp.is_null();
 }
 #[no_mangle]
-pub unsafe extern "C" fn Curl_tls_keylog_write_line(
-    mut line: *const libc::c_char,
-) -> bool {
+pub unsafe extern "C" fn Curl_tls_keylog_write_line(mut line: *const libc::c_char) -> bool {
     let mut linelen: size_t = 0;
     let mut buf: [libc::c_char; 256] = [0; 256];
     if keylog_file_fp.is_null() || line.is_null() {
@@ -120,9 +106,13 @@ pub unsafe extern "C" fn Curl_tls_keylog_write_line(
     {
         return 0 as libc::c_int != 0;
     }
-    memcpy(buf.as_mut_ptr() as *mut libc::c_void, line as *const libc::c_void, linelen);
-    if *line.offset(linelen.wrapping_sub(1 as libc::c_int as libc::c_ulong) as isize)
-        as libc::c_int != '\n' as i32
+    memcpy(
+        buf.as_mut_ptr() as *mut libc::c_void,
+        line as *const libc::c_void,
+        linelen,
+    );
+    if *line.offset(linelen.wrapping_sub(1 as libc::c_int as libc::c_ulong) as isize) as libc::c_int
+        != '\n' as i32
     {
         let fresh0 = linelen;
         linelen = linelen.wrapping_add(1);
@@ -139,8 +129,7 @@ pub unsafe extern "C" fn Curl_tls_keylog_write(
     mut secret: *const libc::c_uchar,
     mut secretlen: size_t,
 ) -> bool {
-    let mut hex: *const libc::c_char = b"0123456789ABCDEF\0" as *const u8
-        as *const libc::c_char;
+    let mut hex: *const libc::c_char = b"0123456789ABCDEF\0" as *const u8 as *const libc::c_char;
     let mut pos: size_t = 0;
     let mut i: size_t = 0;
     let mut line: [libc::c_char; 195] = [0; 195];
@@ -150,12 +139,17 @@ pub unsafe extern "C" fn Curl_tls_keylog_write(
     pos = strlen(label);
     if pos
         > (::std::mem::size_of::<[libc::c_char; 32]>() as libc::c_ulong)
-            .wrapping_sub(1 as libc::c_int as libc::c_ulong) || secretlen == 0
+            .wrapping_sub(1 as libc::c_int as libc::c_ulong)
+        || secretlen == 0
         || secretlen > 48 as libc::c_int as libc::c_ulong
     {
         return 0 as libc::c_int != 0;
     }
-    memcpy(line.as_mut_ptr() as *mut libc::c_void, label as *const libc::c_void, pos);
+    memcpy(
+        line.as_mut_ptr() as *mut libc::c_void,
+        label as *const libc::c_void,
+        pos,
+    );
     let fresh1 = pos;
     pos = pos.wrapping_add(1);
     line[fresh1 as usize] = ' ' as i32 as libc::c_char;
@@ -163,20 +157,14 @@ pub unsafe extern "C" fn Curl_tls_keylog_write(
     while i < 32 as libc::c_int as libc::c_ulong {
         let fresh2 = pos;
         pos = pos.wrapping_add(1);
-        line[fresh2
-            as usize] = *hex
-            .offset(
-                (*client_random.offset(i as isize) as libc::c_int >> 4 as libc::c_int)
-                    as isize,
-            );
+        line[fresh2 as usize] = *hex.offset(
+            (*client_random.offset(i as isize) as libc::c_int >> 4 as libc::c_int) as isize,
+        );
         let fresh3 = pos;
         pos = pos.wrapping_add(1);
-        line[fresh3
-            as usize] = *hex
-            .offset(
-                (*client_random.offset(i as isize) as libc::c_int & 0xf as libc::c_int)
-                    as isize,
-            );
+        line[fresh3 as usize] = *hex.offset(
+            (*client_random.offset(i as isize) as libc::c_int & 0xf as libc::c_int) as isize,
+        );
         i = i.wrapping_add(1);
     }
     let fresh4 = pos;
@@ -186,18 +174,12 @@ pub unsafe extern "C" fn Curl_tls_keylog_write(
     while i < secretlen {
         let fresh5 = pos;
         pos = pos.wrapping_add(1);
-        line[fresh5
-            as usize] = *hex
-            .offset(
-                (*secret.offset(i as isize) as libc::c_int >> 4 as libc::c_int) as isize,
-            );
+        line[fresh5 as usize] =
+            *hex.offset((*secret.offset(i as isize) as libc::c_int >> 4 as libc::c_int) as isize);
         let fresh6 = pos;
         pos = pos.wrapping_add(1);
-        line[fresh6
-            as usize] = *hex
-            .offset(
-                (*secret.offset(i as isize) as libc::c_int & 0xf as libc::c_int) as isize,
-            );
+        line[fresh6 as usize] =
+            *hex.offset((*secret.offset(i as isize) as libc::c_int & 0xf as libc::c_int) as isize);
         i = i.wrapping_add(1);
     }
     let fresh7 = pos;
@@ -206,4 +188,4 @@ pub unsafe extern "C" fn Curl_tls_keylog_write(
     line[pos as usize] = '\0' as i32 as libc::c_char;
     fputs(line.as_mut_ptr(), keylog_file_fp);
     return 1 as libc::c_int != 0;
-}
\ No newline at end of file
+}
-- 
Gitee


From b4a8bd6b195bbd3fb6597d82bfff9caaec7bb065 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Tue, 30 Aug 2022 12:21:13 +0800
Subject: [PATCH 2/9] fix ci script error

---
 ci/01-base.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ci/01-base.sh b/ci/01-base.sh
index 45043a6..1be75f6 100755
--- a/ci/01-base.sh
+++ b/ci/01-base.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 
-cd ../rust
+cd rust/
 
 # 开始检查
 cargo fmt --all -- --check -v
-- 
Gitee


From a78451ede412982b5c9ba1dd2d22faab99afc9b7 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Tue, 30 Aug 2022 17:33:28 +0800
Subject: [PATCH 3/9] change rustc version

---
 ci/00-pre.sh  | 3 +++
 ci/01-base.sh | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/ci/00-pre.sh b/ci/00-pre.sh
index 14fc496..3d0b3ae 100755
--- a/ci/00-pre.sh
+++ b/ci/00-pre.sh
@@ -7,5 +7,8 @@ git config --global url."https://github.91chi.fun/https://github.com/".insteadOf
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o rustlang.sh
 sh rustlang.sh -y
 
+rustup install nightly
+rustup default nightly
+
 source ~/.bashrc
 
diff --git a/ci/01-base.sh b/ci/01-base.sh
index 1be75f6..b4c9457 100755
--- a/ci/01-base.sh
+++ b/ci/01-base.sh
@@ -33,6 +33,6 @@ cd ../
 aclocal
 automake
 
-LDFLAGS="-L`pwd`/rust/target/release" LIBS="-lrust_project -ldl" ./configure --disable-shared
+LDFLAGS="-L`pwd`/rust/target/release" LIBS="-lrust_project -ldl" ./configure --without-ssl --disable-shared
 
 make
\ No newline at end of file
-- 
Gitee


From 076354e81d8865eaf8afe7588822f51edfa18dca Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Tue, 30 Aug 2022 19:11:02 +0800
Subject: [PATCH 4/9] fix rustc version change bug

---
 ci/00-pre.sh | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ci/00-pre.sh b/ci/00-pre.sh
index 3d0b3ae..86f3e20 100755
--- a/ci/00-pre.sh
+++ b/ci/00-pre.sh
@@ -7,6 +7,8 @@ git config --global url."https://github.91chi.fun/https://github.com/".insteadOf
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o rustlang.sh
 sh rustlang.sh -y
 
+source ~/.bashrc
+
 rustup install nightly
 rustup default nightly
 
-- 
Gitee


From 938664ef0de0df6d01a7dd849e9844c27eee08f9 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Wed, 31 Aug 2022 10:49:40 +0800
Subject: [PATCH 5/9] modified 00-pre.sh

---
 ci/00-pre.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ci/00-pre.sh b/ci/00-pre.sh
index 86f3e20..2283e93 100755
--- a/ci/00-pre.sh
+++ b/ci/00-pre.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 sudo yum clean all
-sudo yum install -y gcc openssl-libs
+sudo yum install -y gcc openssl-libs automake
 
 #git加速并安装rust工具链
 git config --global url."https://github.91chi.fun/https://github.com/".insteadOf "https://github.com/"
-- 
Gitee


From c96f39b2e3859718f4bf2c9ff5cc3c09e0347d8f Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Wed, 31 Aug 2022 11:48:44 +0800
Subject: [PATCH 6/9] add make to pre-enviroment

---
 ci/00-pre.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ci/00-pre.sh b/ci/00-pre.sh
index 2283e93..3130348 100755
--- a/ci/00-pre.sh
+++ b/ci/00-pre.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 sudo yum clean all
-sudo yum install -y gcc openssl-libs automake
+sudo yum install -y gcc openssl-libs automake make cmake
 
 #git加速并安装rust工具链
 git config --global url."https://github.91chi.fun/https://github.com/".insteadOf "https://github.com/"
-- 
Gitee


From 8b5cfc0aad0afcec124212ca6013827055083121 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Wed, 31 Aug 2022 14:43:43 +0800
Subject: [PATCH 7/9] update gitignore and upload .d files

---
 .gitignore                                    |  80 ++++----
 docs/cmdline-opts/abstract-unix-socket.d      |  11 +
 docs/cmdline-opts/alt-svc.d                   |  17 ++
 docs/cmdline-opts/anyauth.d                   |  19 ++
 docs/cmdline-opts/append.d                    |  10 +
 docs/cmdline-opts/aws-sigv4.d                 |  18 ++
 docs/cmdline-opts/basic.d                     |  13 ++
 docs/cmdline-opts/cacert.d                    |  35 ++++
 docs/cmdline-opts/capath.d                    |  17 ++
 docs/cmdline-opts/cert-status.d               |  15 ++
 docs/cmdline-opts/cert-type.d                 |  12 ++
 docs/cmdline-opts/cert.d                      |  52 +++++
 docs/cmdline-opts/ciphers.d                   |  13 ++
 docs/cmdline-opts/compressed-ssh.d            |   9 +
 docs/cmdline-opts/compressed.d                |  12 ++
 docs/cmdline-opts/config.d                    |  72 +++++++
 docs/cmdline-opts/connect-timeout.d           |  14 ++
 docs/cmdline-opts/connect-to.d                |  23 +++
 docs/cmdline-opts/continue-at.d               |  18 ++
 docs/cmdline-opts/cookie-jar.d                |  27 +++
 docs/cmdline-opts/cookie.d                    |  36 ++++
 docs/cmdline-opts/create-dirs.d               |  14 ++
 docs/cmdline-opts/create-file-mode.d          |  16 ++
 docs/cmdline-opts/crlf.d                      |   9 +
 docs/cmdline-opts/crlfile.d                   |  12 ++
 docs/cmdline-opts/curves.d                    |  19 ++
 docs/cmdline-opts/data-ascii.d                |   8 +
 docs/cmdline-opts/data-binary.d               |  20 ++
 docs/cmdline-opts/data-raw.d                  |  12 ++
 docs/cmdline-opts/data-urlencode.d            |  38 ++++
 docs/cmdline-opts/data.d                      |  33 +++
 docs/cmdline-opts/delegation.d                |  20 ++
 docs/cmdline-opts/digest.d                    |  13 ++
 docs/cmdline-opts/disable-eprt.d              |  21 ++
 docs/cmdline-opts/disable-epsv.d              |  18 ++
 docs/cmdline-opts/disable.d                   |   9 +
 docs/cmdline-opts/disallow-username-in-url.d  |  10 +
 docs/cmdline-opts/dns-interface.d             |  13 ++
 docs/cmdline-opts/dns-ipv4-addr.d             |  15 ++
 docs/cmdline-opts/dns-ipv6-addr.d             |  15 ++
 docs/cmdline-opts/dns-servers.d               |  14 ++
 docs/cmdline-opts/doh-cert-status.d           |   8 +
 docs/cmdline-opts/doh-insecure.d              |   8 +
 docs/cmdline-opts/doh-url.d                   |  17 ++
 docs/cmdline-opts/dump-header.d               |  16 ++
 docs/cmdline-opts/egd-file.d                  |  10 +
 docs/cmdline-opts/engine.d                    |  10 +
 docs/cmdline-opts/etag-compare.d              |  19 ++
 docs/cmdline-opts/etag-save.d                 |  12 ++
 docs/cmdline-opts/expect100-timeout.d         |  13 ++
 docs/cmdline-opts/fail-early.d                |  23 +++
 docs/cmdline-opts/fail-with-body.d            |  16 ++
 docs/cmdline-opts/fail.d                      |  17 ++
 docs/cmdline-opts/false-start.d               |  14 ++
 docs/cmdline-opts/form-string.d               |  13 ++
 docs/cmdline-opts/form.d                      | 140 +++++++++++++
 docs/cmdline-opts/ftp-account.d               |  12 ++
 docs/cmdline-opts/ftp-alternative-to-user.d   |  12 ++
 docs/cmdline-opts/ftp-create-dirs.d           |  10 +
 docs/cmdline-opts/ftp-method.d                |  25 +++
 docs/cmdline-opts/ftp-pasv.d                  |  18 ++
 docs/cmdline-opts/ftp-port.d                  |  36 ++++
 docs/cmdline-opts/ftp-pret.d                  |  10 +
 docs/cmdline-opts/ftp-skip-pasv-ip.d          |  16 ++
 docs/cmdline-opts/ftp-ssl-ccc-mode.d          |  13 ++
 docs/cmdline-opts/ftp-ssl-ccc.d               |  12 ++
 docs/cmdline-opts/ftp-ssl-control.d           |  10 +
 docs/cmdline-opts/get.d                       |  19 ++
 docs/cmdline-opts/globoff.d                   |  10 +
 docs/cmdline-opts/happy-eyeballs-timeout-ms.d |  19 ++
 docs/cmdline-opts/haproxy-protocol.d          |  13 ++
 docs/cmdline-opts/head.d                      |  10 +
 docs/cmdline-opts/header.d                    |  43 ++++
 docs/cmdline-opts/help.d                      |  13 ++
 docs/cmdline-opts/hostpubmd5.d                |  11 +
 docs/cmdline-opts/hsts.d                      |  17 ++
 docs/cmdline-opts/http0.9.d                   |  15 ++
 docs/cmdline-opts/http1.0.d                   |  12 ++
 docs/cmdline-opts/http1.1.d                   |  10 +
 docs/cmdline-opts/http2-prior-knowledge.d     |  14 ++
 docs/cmdline-opts/http2.d                     |  19 ++
 docs/cmdline-opts/http3.d                     |  20 ++
 docs/cmdline-opts/ignore-content-length.d     |  14 ++
 docs/cmdline-opts/include.d                   |  12 ++
 docs/cmdline-opts/insecure.d                  |  19 ++
 docs/cmdline-opts/interface.d                 |  18 ++
 docs/cmdline-opts/ipv4.d                      |  14 ++
 docs/cmdline-opts/ipv6.d                      |  14 ++
 docs/cmdline-opts/junk-session-cookies.d      |  12 ++
 docs/cmdline-opts/keepalive-time.d            |  15 ++
 docs/cmdline-opts/key-type.d                  |  11 +
 docs/cmdline-opts/key.d                       |  19 ++
 docs/cmdline-opts/krb.d                       |  13 ++
 docs/cmdline-opts/libcurl.d                   |  16 ++
 docs/cmdline-opts/limit-rate.d                |  23 +++
 docs/cmdline-opts/list-only.d                 |  26 +++
 docs/cmdline-opts/local-port.d                |  11 +
 docs/cmdline-opts/location-trusted.d          |  11 +
 docs/cmdline-opts/location.d                  |  27 +++
 docs/cmdline-opts/login-options.d             |  16 ++
 docs/cmdline-opts/mail-auth.d                 |  12 ++
 docs/cmdline-opts/mail-from.d                 |  10 +
 docs/cmdline-opts/mail-rcpt-allowfails.d      |  18 ++
 docs/cmdline-opts/mail-rcpt.d                 |  18 ++
 docs/cmdline-opts/manual.d                    |   7 +
 docs/cmdline-opts/max-filesize.d              |  19 ++
 docs/cmdline-opts/max-redirs.d                |  12 ++
 docs/cmdline-opts/max-time.d                  |  16 ++
 docs/cmdline-opts/metalink.d                  |   8 +
 docs/cmdline-opts/negotiate.d                 |  17 ++
 docs/cmdline-opts/netrc-file.d                |  14 ++
 docs/cmdline-opts/netrc-optional.d            |   9 +
 docs/cmdline-opts/netrc.d                     |  19 ++
 docs/cmdline-opts/next.d                      |  25 +++
 docs/cmdline-opts/no-alpn.d                   |  13 ++
 docs/cmdline-opts/no-buffer.d                 |  13 ++
 docs/cmdline-opts/no-keepalive.d              |  10 +
 docs/cmdline-opts/no-npn.d                    |  14 ++
 docs/cmdline-opts/no-progress-meter.d         |  12 ++
 docs/cmdline-opts/no-sessionid.d              |  15 ++
 docs/cmdline-opts/noproxy.d                   |  17 ++
 docs/cmdline-opts/ntlm-wb.d                   |   9 +
 docs/cmdline-opts/ntlm.d                      |  20 ++
 docs/cmdline-opts/oauth2-bearer.d             |  14 ++
 docs/cmdline-opts/output-dir.d                |  20 ++
 docs/cmdline-opts/output.d                    |  45 ++++
 docs/cmdline-opts/parallel-immediate.d        |  14 ++
 docs/cmdline-opts/parallel-max.d              |  15 ++
 docs/cmdline-opts/parallel.d                  |  12 ++
 docs/cmdline-opts/pass.d                      |  10 +
 docs/cmdline-opts/path-as-is.d                |   9 +
 docs/cmdline-opts/pinnedpubkey.d              |  35 ++++
 docs/cmdline-opts/post301.d                   |  13 ++
 docs/cmdline-opts/post302.d                   |  13 ++
 docs/cmdline-opts/post303.d                   |  12 ++
 docs/cmdline-opts/preproxy.d                  |  24 +++
 docs/cmdline-opts/progress-bar.d              |  17 ++
 docs/cmdline-opts/proto-default.d             |  16 ++
 docs/cmdline-opts/proto-redir.d               |  20 ++
 docs/cmdline-opts/proto.d                     |  45 ++++
 docs/cmdline-opts/proxy-anyauth.d             |   9 +
 docs/cmdline-opts/proxy-basic.d               |   9 +
 docs/cmdline-opts/proxy-cacert.d              |   9 +
 docs/cmdline-opts/proxy-capath.d              |   9 +
 docs/cmdline-opts/proxy-cert-type.d           |   8 +
 docs/cmdline-opts/proxy-cert.d                |   8 +
 docs/cmdline-opts/proxy-ciphers.d             |   8 +
 docs/cmdline-opts/proxy-crlfile.d             |   8 +
 docs/cmdline-opts/proxy-digest.d              |   8 +
 docs/cmdline-opts/proxy-header.d              |  28 +++
 docs/cmdline-opts/proxy-insecure.d            |   7 +
 docs/cmdline-opts/proxy-key-type.d            |   8 +
 docs/cmdline-opts/proxy-key.d                 |   7 +
 docs/cmdline-opts/proxy-negotiate.d           |  10 +
 docs/cmdline-opts/proxy-ntlm.d                |   8 +
 docs/cmdline-opts/proxy-pass.d                |   8 +
 docs/cmdline-opts/proxy-pinnedpubkey.d        |  19 ++
 docs/cmdline-opts/proxy-service-name.d        |   8 +
 docs/cmdline-opts/proxy-ssl-allow-beast.d     |   7 +
 .../cmdline-opts/proxy-ssl-auto-client-cert.d |   7 +
 docs/cmdline-opts/proxy-tls13-ciphers.d       |  18 ++
 docs/cmdline-opts/proxy-tlsauthtype.d         |   8 +
 docs/cmdline-opts/proxy-tlspassword.d         |   8 +
 docs/cmdline-opts/proxy-tlsuser.d             |   8 +
 docs/cmdline-opts/proxy-tlsv1.d               |   7 +
 docs/cmdline-opts/proxy-user.d                |  20 ++
 docs/cmdline-opts/proxy.d                     |  41 ++++
 docs/cmdline-opts/proxy1.0.d                  |  12 ++
 docs/cmdline-opts/proxytunnel.d               |  14 ++
 docs/cmdline-opts/pubkey.d                    |  16 ++
 docs/cmdline-opts/quote.d                     |  68 +++++++
 docs/cmdline-opts/random-file.d               |   9 +
 docs/cmdline-opts/range.d                     |  49 +++++
 docs/cmdline-opts/raw.d                       |   9 +
 docs/cmdline-opts/referer.d                   |  18 ++
 docs/cmdline-opts/remote-header-name.d        |  21 ++
 docs/cmdline-opts/remote-name-all.d           |  10 +
 docs/cmdline-opts/remote-name.d               |  23 +++
 docs/cmdline-opts/remote-time.d               |   9 +
 docs/cmdline-opts/request-target.d            |  12 ++
 docs/cmdline-opts/request.d                   |  42 ++++
 docs/cmdline-opts/resolve.d                   |  37 ++++
 docs/cmdline-opts/retry-all-errors.d          |  30 +++
 docs/cmdline-opts/retry-connrefused.d         |   8 +
 docs/cmdline-opts/retry-delay.d               |  13 ++
 docs/cmdline-opts/retry-max-time.d            |  15 ++
 docs/cmdline-opts/retry.d                     |  23 +++
 docs/cmdline-opts/sasl-authzid.d              |  14 ++
 docs/cmdline-opts/sasl-ir.d                   |   7 +
 docs/cmdline-opts/service-name.d              |  10 +
 docs/cmdline-opts/show-error.d                |  11 +
 docs/cmdline-opts/silent.d                    |  13 ++
 docs/cmdline-opts/socks4.d                    |  22 ++
 docs/cmdline-opts/socks4a.d                   |  21 ++
 docs/cmdline-opts/socks5-basic.d              |   9 +
 docs/cmdline-opts/socks5-gssapi-nec.d         |  10 +
 docs/cmdline-opts/socks5-gssapi-service.d     |  14 ++
 docs/cmdline-opts/socks5-gssapi.d             |  10 +
 docs/cmdline-opts/socks5-hostname.d           |  21 ++
 docs/cmdline-opts/socks5.d                    |  23 +++
 docs/cmdline-opts/speed-limit.d               |  12 ++
 docs/cmdline-opts/speed-time.d                |  15 ++
 docs/cmdline-opts/ssl-allow-beast.d           |  13 ++
 docs/cmdline-opts/ssl-auto-client-cert.d      |  13 ++
 docs/cmdline-opts/ssl-no-revoke.d             |   9 +
 docs/cmdline-opts/ssl-reqd.d                  |  11 +
 docs/cmdline-opts/ssl-revoke-best-effort.d    |   9 +
 docs/cmdline-opts/ssl.d                       |  13 ++
 docs/cmdline-opts/sslv2.d                     |  15 ++
 docs/cmdline-opts/sslv3.d                     |  15 ++
 docs/cmdline-opts/stderr.d                    |  14 ++
 docs/cmdline-opts/styled-output.d             |  11 +
 docs/cmdline-opts/suppress-connect-headers.d  |  10 +
 docs/cmdline-opts/tcp-fastopen.d              |   7 +
 docs/cmdline-opts/tcp-nodelay.d               |  11 +
 docs/cmdline-opts/telnet-option.d             |  14 ++
 docs/cmdline-opts/tftp-blksize.d              |  13 ++
 docs/cmdline-opts/tftp-no-options.d           |  12 ++
 docs/cmdline-opts/time-cond.d                 |  21 ++
 docs/cmdline-opts/tls-max.d                   |  30 +++
 docs/cmdline-opts/tls13-ciphers.d             |  18 ++
 docs/cmdline-opts/tlsauthtype.d               |  12 ++
 docs/cmdline-opts/tlspassword.d               |  11 +
 docs/cmdline-opts/tlsuser.d                   |  11 +
 docs/cmdline-opts/tlsv1.0.d                   |  12 ++
 docs/cmdline-opts/tlsv1.1.d                   |  12 ++
 docs/cmdline-opts/tlsv1.2.d                   |  12 ++
 docs/cmdline-opts/tlsv1.3.d                   |  14 ++
 docs/cmdline-opts/tlsv1.d                     |  14 ++
 docs/cmdline-opts/tr-encoding.d               |   9 +
 docs/cmdline-opts/trace-ascii.d               |  19 ++
 docs/cmdline-opts/trace-time.d                |  10 +
 docs/cmdline-opts/trace.d                     |  16 ++
 docs/cmdline-opts/unix-socket.d               |   9 +
 docs/cmdline-opts/upload-file.d               |  31 +++
 docs/cmdline-opts/url.d                       |  20 ++
 docs/cmdline-opts/use-ascii.d                 |  10 +
 docs/cmdline-opts/user-agent.d                |  17 ++
 docs/cmdline-opts/user.d                      |  41 ++++
 docs/cmdline-opts/verbose.d                   |  24 +++
 docs/cmdline-opts/version.d                   |  80 ++++++++
 docs/cmdline-opts/write-out.d                 | 192 ++++++++++++++++++
 docs/cmdline-opts/xattr.d                     |  10 +
 243 files changed, 4317 insertions(+), 40 deletions(-)
 create mode 100644 docs/cmdline-opts/abstract-unix-socket.d
 create mode 100644 docs/cmdline-opts/alt-svc.d
 create mode 100644 docs/cmdline-opts/anyauth.d
 create mode 100644 docs/cmdline-opts/append.d
 create mode 100644 docs/cmdline-opts/aws-sigv4.d
 create mode 100644 docs/cmdline-opts/basic.d
 create mode 100644 docs/cmdline-opts/cacert.d
 create mode 100644 docs/cmdline-opts/capath.d
 create mode 100644 docs/cmdline-opts/cert-status.d
 create mode 100644 docs/cmdline-opts/cert-type.d
 create mode 100644 docs/cmdline-opts/cert.d
 create mode 100644 docs/cmdline-opts/ciphers.d
 create mode 100644 docs/cmdline-opts/compressed-ssh.d
 create mode 100644 docs/cmdline-opts/compressed.d
 create mode 100644 docs/cmdline-opts/config.d
 create mode 100644 docs/cmdline-opts/connect-timeout.d
 create mode 100644 docs/cmdline-opts/connect-to.d
 create mode 100644 docs/cmdline-opts/continue-at.d
 create mode 100644 docs/cmdline-opts/cookie-jar.d
 create mode 100644 docs/cmdline-opts/cookie.d
 create mode 100644 docs/cmdline-opts/create-dirs.d
 create mode 100644 docs/cmdline-opts/create-file-mode.d
 create mode 100644 docs/cmdline-opts/crlf.d
 create mode 100644 docs/cmdline-opts/crlfile.d
 create mode 100644 docs/cmdline-opts/curves.d
 create mode 100644 docs/cmdline-opts/data-ascii.d
 create mode 100644 docs/cmdline-opts/data-binary.d
 create mode 100644 docs/cmdline-opts/data-raw.d
 create mode 100644 docs/cmdline-opts/data-urlencode.d
 create mode 100644 docs/cmdline-opts/data.d
 create mode 100644 docs/cmdline-opts/delegation.d
 create mode 100644 docs/cmdline-opts/digest.d
 create mode 100644 docs/cmdline-opts/disable-eprt.d
 create mode 100644 docs/cmdline-opts/disable-epsv.d
 create mode 100644 docs/cmdline-opts/disable.d
 create mode 100644 docs/cmdline-opts/disallow-username-in-url.d
 create mode 100644 docs/cmdline-opts/dns-interface.d
 create mode 100644 docs/cmdline-opts/dns-ipv4-addr.d
 create mode 100644 docs/cmdline-opts/dns-ipv6-addr.d
 create mode 100644 docs/cmdline-opts/dns-servers.d
 create mode 100644 docs/cmdline-opts/doh-cert-status.d
 create mode 100644 docs/cmdline-opts/doh-insecure.d
 create mode 100644 docs/cmdline-opts/doh-url.d
 create mode 100644 docs/cmdline-opts/dump-header.d
 create mode 100644 docs/cmdline-opts/egd-file.d
 create mode 100644 docs/cmdline-opts/engine.d
 create mode 100644 docs/cmdline-opts/etag-compare.d
 create mode 100644 docs/cmdline-opts/etag-save.d
 create mode 100644 docs/cmdline-opts/expect100-timeout.d
 create mode 100644 docs/cmdline-opts/fail-early.d
 create mode 100644 docs/cmdline-opts/fail-with-body.d
 create mode 100644 docs/cmdline-opts/fail.d
 create mode 100644 docs/cmdline-opts/false-start.d
 create mode 100644 docs/cmdline-opts/form-string.d
 create mode 100644 docs/cmdline-opts/form.d
 create mode 100644 docs/cmdline-opts/ftp-account.d
 create mode 100644 docs/cmdline-opts/ftp-alternative-to-user.d
 create mode 100644 docs/cmdline-opts/ftp-create-dirs.d
 create mode 100644 docs/cmdline-opts/ftp-method.d
 create mode 100644 docs/cmdline-opts/ftp-pasv.d
 create mode 100644 docs/cmdline-opts/ftp-port.d
 create mode 100644 docs/cmdline-opts/ftp-pret.d
 create mode 100644 docs/cmdline-opts/ftp-skip-pasv-ip.d
 create mode 100644 docs/cmdline-opts/ftp-ssl-ccc-mode.d
 create mode 100644 docs/cmdline-opts/ftp-ssl-ccc.d
 create mode 100644 docs/cmdline-opts/ftp-ssl-control.d
 create mode 100644 docs/cmdline-opts/get.d
 create mode 100644 docs/cmdline-opts/globoff.d
 create mode 100644 docs/cmdline-opts/happy-eyeballs-timeout-ms.d
 create mode 100644 docs/cmdline-opts/haproxy-protocol.d
 create mode 100644 docs/cmdline-opts/head.d
 create mode 100644 docs/cmdline-opts/header.d
 create mode 100644 docs/cmdline-opts/help.d
 create mode 100644 docs/cmdline-opts/hostpubmd5.d
 create mode 100644 docs/cmdline-opts/hsts.d
 create mode 100644 docs/cmdline-opts/http0.9.d
 create mode 100644 docs/cmdline-opts/http1.0.d
 create mode 100644 docs/cmdline-opts/http1.1.d
 create mode 100644 docs/cmdline-opts/http2-prior-knowledge.d
 create mode 100644 docs/cmdline-opts/http2.d
 create mode 100644 docs/cmdline-opts/http3.d
 create mode 100644 docs/cmdline-opts/ignore-content-length.d
 create mode 100644 docs/cmdline-opts/include.d
 create mode 100644 docs/cmdline-opts/insecure.d
 create mode 100644 docs/cmdline-opts/interface.d
 create mode 100644 docs/cmdline-opts/ipv4.d
 create mode 100644 docs/cmdline-opts/ipv6.d
 create mode 100644 docs/cmdline-opts/junk-session-cookies.d
 create mode 100644 docs/cmdline-opts/keepalive-time.d
 create mode 100644 docs/cmdline-opts/key-type.d
 create mode 100644 docs/cmdline-opts/key.d
 create mode 100644 docs/cmdline-opts/krb.d
 create mode 100644 docs/cmdline-opts/libcurl.d
 create mode 100644 docs/cmdline-opts/limit-rate.d
 create mode 100644 docs/cmdline-opts/list-only.d
 create mode 100644 docs/cmdline-opts/local-port.d
 create mode 100644 docs/cmdline-opts/location-trusted.d
 create mode 100644 docs/cmdline-opts/location.d
 create mode 100644 docs/cmdline-opts/login-options.d
 create mode 100644 docs/cmdline-opts/mail-auth.d
 create mode 100644 docs/cmdline-opts/mail-from.d
 create mode 100644 docs/cmdline-opts/mail-rcpt-allowfails.d
 create mode 100644 docs/cmdline-opts/mail-rcpt.d
 create mode 100644 docs/cmdline-opts/manual.d
 create mode 100644 docs/cmdline-opts/max-filesize.d
 create mode 100644 docs/cmdline-opts/max-redirs.d
 create mode 100644 docs/cmdline-opts/max-time.d
 create mode 100644 docs/cmdline-opts/metalink.d
 create mode 100644 docs/cmdline-opts/negotiate.d
 create mode 100644 docs/cmdline-opts/netrc-file.d
 create mode 100644 docs/cmdline-opts/netrc-optional.d
 create mode 100644 docs/cmdline-opts/netrc.d
 create mode 100644 docs/cmdline-opts/next.d
 create mode 100644 docs/cmdline-opts/no-alpn.d
 create mode 100644 docs/cmdline-opts/no-buffer.d
 create mode 100644 docs/cmdline-opts/no-keepalive.d
 create mode 100644 docs/cmdline-opts/no-npn.d
 create mode 100644 docs/cmdline-opts/no-progress-meter.d
 create mode 100644 docs/cmdline-opts/no-sessionid.d
 create mode 100644 docs/cmdline-opts/noproxy.d
 create mode 100644 docs/cmdline-opts/ntlm-wb.d
 create mode 100644 docs/cmdline-opts/ntlm.d
 create mode 100644 docs/cmdline-opts/oauth2-bearer.d
 create mode 100644 docs/cmdline-opts/output-dir.d
 create mode 100644 docs/cmdline-opts/output.d
 create mode 100644 docs/cmdline-opts/parallel-immediate.d
 create mode 100644 docs/cmdline-opts/parallel-max.d
 create mode 100644 docs/cmdline-opts/parallel.d
 create mode 100644 docs/cmdline-opts/pass.d
 create mode 100644 docs/cmdline-opts/path-as-is.d
 create mode 100644 docs/cmdline-opts/pinnedpubkey.d
 create mode 100644 docs/cmdline-opts/post301.d
 create mode 100644 docs/cmdline-opts/post302.d
 create mode 100644 docs/cmdline-opts/post303.d
 create mode 100644 docs/cmdline-opts/preproxy.d
 create mode 100644 docs/cmdline-opts/progress-bar.d
 create mode 100644 docs/cmdline-opts/proto-default.d
 create mode 100644 docs/cmdline-opts/proto-redir.d
 create mode 100644 docs/cmdline-opts/proto.d
 create mode 100644 docs/cmdline-opts/proxy-anyauth.d
 create mode 100644 docs/cmdline-opts/proxy-basic.d
 create mode 100644 docs/cmdline-opts/proxy-cacert.d
 create mode 100644 docs/cmdline-opts/proxy-capath.d
 create mode 100644 docs/cmdline-opts/proxy-cert-type.d
 create mode 100644 docs/cmdline-opts/proxy-cert.d
 create mode 100644 docs/cmdline-opts/proxy-ciphers.d
 create mode 100644 docs/cmdline-opts/proxy-crlfile.d
 create mode 100644 docs/cmdline-opts/proxy-digest.d
 create mode 100644 docs/cmdline-opts/proxy-header.d
 create mode 100644 docs/cmdline-opts/proxy-insecure.d
 create mode 100644 docs/cmdline-opts/proxy-key-type.d
 create mode 100644 docs/cmdline-opts/proxy-key.d
 create mode 100644 docs/cmdline-opts/proxy-negotiate.d
 create mode 100644 docs/cmdline-opts/proxy-ntlm.d
 create mode 100644 docs/cmdline-opts/proxy-pass.d
 create mode 100644 docs/cmdline-opts/proxy-pinnedpubkey.d
 create mode 100644 docs/cmdline-opts/proxy-service-name.d
 create mode 100644 docs/cmdline-opts/proxy-ssl-allow-beast.d
 create mode 100644 docs/cmdline-opts/proxy-ssl-auto-client-cert.d
 create mode 100644 docs/cmdline-opts/proxy-tls13-ciphers.d
 create mode 100644 docs/cmdline-opts/proxy-tlsauthtype.d
 create mode 100644 docs/cmdline-opts/proxy-tlspassword.d
 create mode 100644 docs/cmdline-opts/proxy-tlsuser.d
 create mode 100644 docs/cmdline-opts/proxy-tlsv1.d
 create mode 100644 docs/cmdline-opts/proxy-user.d
 create mode 100644 docs/cmdline-opts/proxy.d
 create mode 100644 docs/cmdline-opts/proxy1.0.d
 create mode 100644 docs/cmdline-opts/proxytunnel.d
 create mode 100644 docs/cmdline-opts/pubkey.d
 create mode 100644 docs/cmdline-opts/quote.d
 create mode 100644 docs/cmdline-opts/random-file.d
 create mode 100644 docs/cmdline-opts/range.d
 create mode 100644 docs/cmdline-opts/raw.d
 create mode 100644 docs/cmdline-opts/referer.d
 create mode 100644 docs/cmdline-opts/remote-header-name.d
 create mode 100644 docs/cmdline-opts/remote-name-all.d
 create mode 100644 docs/cmdline-opts/remote-name.d
 create mode 100644 docs/cmdline-opts/remote-time.d
 create mode 100644 docs/cmdline-opts/request-target.d
 create mode 100644 docs/cmdline-opts/request.d
 create mode 100644 docs/cmdline-opts/resolve.d
 create mode 100644 docs/cmdline-opts/retry-all-errors.d
 create mode 100644 docs/cmdline-opts/retry-connrefused.d
 create mode 100644 docs/cmdline-opts/retry-delay.d
 create mode 100644 docs/cmdline-opts/retry-max-time.d
 create mode 100644 docs/cmdline-opts/retry.d
 create mode 100644 docs/cmdline-opts/sasl-authzid.d
 create mode 100644 docs/cmdline-opts/sasl-ir.d
 create mode 100644 docs/cmdline-opts/service-name.d
 create mode 100644 docs/cmdline-opts/show-error.d
 create mode 100644 docs/cmdline-opts/silent.d
 create mode 100644 docs/cmdline-opts/socks4.d
 create mode 100644 docs/cmdline-opts/socks4a.d
 create mode 100644 docs/cmdline-opts/socks5-basic.d
 create mode 100644 docs/cmdline-opts/socks5-gssapi-nec.d
 create mode 100644 docs/cmdline-opts/socks5-gssapi-service.d
 create mode 100644 docs/cmdline-opts/socks5-gssapi.d
 create mode 100644 docs/cmdline-opts/socks5-hostname.d
 create mode 100644 docs/cmdline-opts/socks5.d
 create mode 100644 docs/cmdline-opts/speed-limit.d
 create mode 100644 docs/cmdline-opts/speed-time.d
 create mode 100644 docs/cmdline-opts/ssl-allow-beast.d
 create mode 100644 docs/cmdline-opts/ssl-auto-client-cert.d
 create mode 100644 docs/cmdline-opts/ssl-no-revoke.d
 create mode 100644 docs/cmdline-opts/ssl-reqd.d
 create mode 100644 docs/cmdline-opts/ssl-revoke-best-effort.d
 create mode 100644 docs/cmdline-opts/ssl.d
 create mode 100644 docs/cmdline-opts/sslv2.d
 create mode 100644 docs/cmdline-opts/sslv3.d
 create mode 100644 docs/cmdline-opts/stderr.d
 create mode 100644 docs/cmdline-opts/styled-output.d
 create mode 100644 docs/cmdline-opts/suppress-connect-headers.d
 create mode 100644 docs/cmdline-opts/tcp-fastopen.d
 create mode 100644 docs/cmdline-opts/tcp-nodelay.d
 create mode 100644 docs/cmdline-opts/telnet-option.d
 create mode 100644 docs/cmdline-opts/tftp-blksize.d
 create mode 100644 docs/cmdline-opts/tftp-no-options.d
 create mode 100644 docs/cmdline-opts/time-cond.d
 create mode 100644 docs/cmdline-opts/tls-max.d
 create mode 100644 docs/cmdline-opts/tls13-ciphers.d
 create mode 100644 docs/cmdline-opts/tlsauthtype.d
 create mode 100644 docs/cmdline-opts/tlspassword.d
 create mode 100644 docs/cmdline-opts/tlsuser.d
 create mode 100644 docs/cmdline-opts/tlsv1.0.d
 create mode 100644 docs/cmdline-opts/tlsv1.1.d
 create mode 100644 docs/cmdline-opts/tlsv1.2.d
 create mode 100644 docs/cmdline-opts/tlsv1.3.d
 create mode 100644 docs/cmdline-opts/tlsv1.d
 create mode 100644 docs/cmdline-opts/tr-encoding.d
 create mode 100644 docs/cmdline-opts/trace-ascii.d
 create mode 100644 docs/cmdline-opts/trace-time.d
 create mode 100644 docs/cmdline-opts/trace.d
 create mode 100644 docs/cmdline-opts/unix-socket.d
 create mode 100644 docs/cmdline-opts/upload-file.d
 create mode 100644 docs/cmdline-opts/url.d
 create mode 100644 docs/cmdline-opts/use-ascii.d
 create mode 100644 docs/cmdline-opts/user-agent.d
 create mode 100644 docs/cmdline-opts/user.d
 create mode 100644 docs/cmdline-opts/verbose.d
 create mode 100644 docs/cmdline-opts/version.d
 create mode 100644 docs/cmdline-opts/write-out.d
 create mode 100644 docs/cmdline-opts/xattr.d

diff --git a/.gitignore b/.gitignore
index eea36b4..2717959 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,72 +1,72 @@
 # for c project
 # Prerequisites
-*.d
+# *.d
 
 # Object files
-*.o
-*.ko
-*.obj
-*.elf
+# *.o
+# *.ko
+# *.obj
+# *.elf
 
 # Linker output
-*.ilk
-*.map
-*.exp
+# *.ilk
+# *.map
+# *.exp
 
 # Precompiled Headers
-*.gch
-*.pch
+# *.gch
+# *.pch
 
 # Libraries
-*.lib
-*.a
-*.la
-*.lo
+# *.lib
+# *.a
+# *.la
+# *.lo
 
 # Shared objects (inc. Windows DLLs)
-*.dll
-*.so
-*.so.*
-*.dylib
+# *.dll
+# *.so
+# *.so.*
+# *.dylib
 
 # Executables
-*.exe
-*.out
-*.app
-*.i*86
-*.x86_64
-*.hex
+# *.exe
+# *.out
+# *.app
+# *.i*86
+# *.x86_64
+# *.hex
 
 # Debug files
-*.dSYM/
-*.su
-*.idb
-*.pdb
+# *.dSYM/
+# *.su
+# *.idb
+# *.pdb
 
 # Kernel Module Compile Results
-*.mod*
-*.cmd
-.tmp_versions/
-modules.order
-Module.symvers
-Mkfile.old
-dkms.conf
+# *.mod*
+# *.cmd
+# .tmp_versions/
+# modules.order
+# Module.symvers
+# Mkfile.old
+# dkms.conf
 
 # for rust project
 # Generated by Cargo
 # will have compiled files and executables
-debug/
-target/
+# debug/
+# target/
 
 # Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
 # More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
-Cargo.lock
+# Cargo.lock
 
 # These are backup files generated by rustfmt
-**/*.rs.bk
+# **/*.rs.bk
 
 # MSVC Windows builds of rustc generate these, which store debugging information
-*.pdb
+# *.pdb
 
 # for vscode
 .vscode/*
diff --git a/docs/cmdline-opts/abstract-unix-socket.d b/docs/cmdline-opts/abstract-unix-socket.d
new file mode 100644
index 0000000..e26048f
--- /dev/null
+++ b/docs/cmdline-opts/abstract-unix-socket.d
@@ -0,0 +1,11 @@
+Long: abstract-unix-socket
+Arg: <path>
+Help: Connect via abstract Unix domain socket
+Added: 7.53.0
+Protocols: HTTP
+Category: connection
+Example: --abstract-unix-socket socketpath $URL
+---
+Connect through an abstract Unix domain socket, instead of using the network.
+Note: netstat shows the path of an abstract socket prefixed with '@', however
+the <path> argument should not have this leading character.
diff --git a/docs/cmdline-opts/alt-svc.d b/docs/cmdline-opts/alt-svc.d
new file mode 100644
index 0000000..914b1fb
--- /dev/null
+++ b/docs/cmdline-opts/alt-svc.d
@@ -0,0 +1,17 @@
+Long: alt-svc
+Arg: <file name>
+Protocols: HTTPS
+Help: Enable alt-svc with this cache file
+Added: 7.64.1
+Category: http
+Example: --alt-svc svc.txt $URL
+---
+This option enables the alt-svc parser in curl. If the file name points to an
+existing alt-svc cache file, that will be used. After a completed transfer,
+the cache will be saved to the file name again if it has been modified.
+
+Specify a "" file name (zero length) to avoid loading/saving and make curl
+just handle the cache in memory.
+
+If this option is used several times, curl will load contents from all the
+files but the last one will be used for saving.
diff --git a/docs/cmdline-opts/anyauth.d b/docs/cmdline-opts/anyauth.d
new file mode 100644
index 0000000..427a64c
--- /dev/null
+++ b/docs/cmdline-opts/anyauth.d
@@ -0,0 +1,19 @@
+Long: anyauth
+Help: Pick any authentication method
+Protocols: HTTP
+See-also: proxy-anyauth basic digest
+Category: http proxy auth
+Example: --anyauth --user me:pwd $URL
+---
+Tells curl to figure out authentication method by itself, and use the most
+secure one the remote site claims to support. This is done by first doing a
+request and checking the response-headers, thus possibly inducing an extra
+network round-trip. This is used instead of setting a specific authentication
+method, which you can do with --basic, --digest, --ntlm, and --negotiate.
+
+Using --anyauth is not recommended if you do uploads from stdin, since it may
+require data to be sent twice and then the client must be able to rewind. If
+the need should arise when uploading from stdin, the upload operation will
+fail.
+
+Used together with --user.
diff --git a/docs/cmdline-opts/append.d b/docs/cmdline-opts/append.d
new file mode 100644
index 0000000..8afaf0e
--- /dev/null
+++ b/docs/cmdline-opts/append.d
@@ -0,0 +1,10 @@
+Short: a
+Long: append
+Help: Append to target file when uploading
+Protocols: FTP SFTP
+Category: ftp sftp
+Example: --upload-file local --append ftp://example.com/
+---
+When used in an upload, this makes curl append to the target file instead of
+overwriting it. If the remote file doesn't exist, it will be created.  Note
+that this flag is ignored by some SFTP servers (including OpenSSH).
diff --git a/docs/cmdline-opts/aws-sigv4.d b/docs/cmdline-opts/aws-sigv4.d
new file mode 100644
index 0000000..db98864
--- /dev/null
+++ b/docs/cmdline-opts/aws-sigv4.d
@@ -0,0 +1,18 @@
+Long: aws-sigv4
+Arg: <provider1[:provider2[:region[:service]]]>
+Help: Use AWS V4 signature authentication
+Category: auth http
+Added: 7.75.0
+Example: --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" $URL
+---
+Use AWS V4 signature authentication in the transfer.
+
+The provider argument is a string that is used by the algorithm when creating
+outgoing authentication headers.
+
+The region argument is a string that points to a geographic area of
+a resources collection (region-code) when the region name is omitted from
+the endpoint.
+
+The service argument is a string that points to a function provided by a cloud
+(service-code) when the service name is omitted from the endpoint.
diff --git a/docs/cmdline-opts/basic.d b/docs/cmdline-opts/basic.d
new file mode 100644
index 0000000..62d2c22
--- /dev/null
+++ b/docs/cmdline-opts/basic.d
@@ -0,0 +1,13 @@
+Long: basic
+Help: Use HTTP Basic Authentication
+See-also: proxy-basic
+Protocols: HTTP
+Category: auth
+Example: -u name:password --basic $URL
+---
+Tells curl to use HTTP Basic authentication with the remote host. This is the
+default and this option is usually pointless, unless you use it to override a
+previously set option that sets a different authentication method (such as
+--ntlm, --digest, or --negotiate).
+
+Used together with --user.
diff --git a/docs/cmdline-opts/cacert.d b/docs/cmdline-opts/cacert.d
new file mode 100644
index 0000000..1f38040
--- /dev/null
+++ b/docs/cmdline-opts/cacert.d
@@ -0,0 +1,35 @@
+Long: cacert
+Arg: <file>
+Help: CA certificate to verify peer against
+Protocols: TLS
+Category: tls
+Example: --cacert CA-file.txt $URL
+---
+Tells curl to use the specified certificate file to verify the peer. The file
+may contain multiple CA certificates. The certificate(s) must be in PEM
+format. Normally curl is built to use a default file for this, so this option
+is typically used to alter that default file.
+
+curl recognizes the environment variable named 'CURL_CA_BUNDLE' if it is
+set, and uses the given path as a path to a CA cert bundle. This option
+overrides that variable.
+
+The windows version of curl will automatically look for a CA certs file named
+\'curl-ca-bundle.crt\', either in the same directory as curl.exe, or in the
+Current Working Directory, or in any folder along your PATH.
+
+If curl is built against the NSS SSL library, the NSS PEM PKCS#11 module
+(libnsspem.so) needs to be available for this option to work properly.
+
+(iOS and macOS only) If curl is built against Secure Transport, then this
+option is supported for backward compatibility with other SSL engines, but it
+should not be set. If the option is not set, then curl will use the
+certificates in the system and user Keychain to verify the peer, which is the
+preferred method of verifying the peer's certificate chain.
+
+(Schannel only) This option is supported for Schannel in Windows 7 or later
+with libcurl 7.60 or later. This option is supported for backward
+compatibility with other SSL engines; instead it is recommended to use
+Windows' store of root certificates (the default for Schannel).
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/capath.d b/docs/cmdline-opts/capath.d
new file mode 100644
index 0000000..ba407ed
--- /dev/null
+++ b/docs/cmdline-opts/capath.d
@@ -0,0 +1,17 @@
+Long: capath
+Arg: <dir>
+Help: CA directory to verify peer against
+Protocols: TLS
+Category: tls
+Example: --capath /local/directory $URL
+---
+Tells curl to use the specified certificate directory to verify the
+peer. Multiple paths can be provided by separating them with ":" (e.g.
+\&"path1:path2:path3"). The certificates must be in PEM format, and if curl is
+built against OpenSSL, the directory must have been processed using the
+c_rehash utility supplied with OpenSSL. Using --capath can allow
+OpenSSL-powered curl to make SSL-connections much more efficiently than using
+--cacert if the --cacert file contains many CA certificates.
+
+If this option is set, the default capath value will be ignored, and if it is
+used several times, the last one will be used.
diff --git a/docs/cmdline-opts/cert-status.d b/docs/cmdline-opts/cert-status.d
new file mode 100644
index 0000000..360e5c9
--- /dev/null
+++ b/docs/cmdline-opts/cert-status.d
@@ -0,0 +1,15 @@
+Long: cert-status
+Protocols: TLS
+Added: 7.41.0
+Help: Verify the status of the server cert via OCSP-staple
+Category: tls
+Example: --cert-status $URL
+---
+Tells curl to verify the status of the server certificate by using the
+Certificate Status Request (aka. OCSP stapling) TLS extension.
+
+If this option is enabled and the server sends an invalid (e.g. expired)
+response, if the response suggests that the server certificate has been revoked,
+or no response at all is received, the verification fails.
+
+This is currently only implemented in the OpenSSL, GnuTLS and NSS backends.
diff --git a/docs/cmdline-opts/cert-type.d b/docs/cmdline-opts/cert-type.d
new file mode 100644
index 0000000..9fcbfe7
--- /dev/null
+++ b/docs/cmdline-opts/cert-type.d
@@ -0,0 +1,12 @@
+Long: cert-type
+Protocols: TLS
+Arg: <type>
+Help: Certificate type (DER/PEM/ENG)
+See-also: cert key key-type
+Category: tls
+Example: --cert-type PEM --cert file $URL
+---
+Tells curl what type the provided client certificate is using. PEM, DER, ENG
+and P12 are recognized types.  If not specified, PEM is assumed.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/cert.d b/docs/cmdline-opts/cert.d
new file mode 100644
index 0000000..8e0fb88
--- /dev/null
+++ b/docs/cmdline-opts/cert.d
@@ -0,0 +1,52 @@
+Short: E
+Long: cert
+Arg: <certificate[:password]>
+Help: Client certificate file and password
+Protocols: TLS
+See-also: cert-type key key-type
+Category: tls
+Example: --cert certfile --key keyfile $URL
+---
+Tells curl to use the specified client certificate file when getting a file
+with HTTPS, FTPS or another SSL-based protocol. The certificate must be in
+PKCS#12 format if using Secure Transport, or PEM format if using any other
+engine.  If the optional password isn't specified, it will be queried for on
+the terminal. Note that this option assumes a \&"certificate" file that is the
+private key and the client certificate concatenated! See --cert and --key to
+specify them independently.
+
+If curl is built against the NSS SSL library then this option can tell
+curl the nickname of the certificate to use within the NSS database defined
+by the environment variable SSL_DIR (or by default /etc/pki/nssdb). If the
+NSS PEM PKCS#11 module (libnsspem.so) is available then PEM files may be
+loaded. If you want to use a file from the current directory, please precede
+it with "./" prefix, in order to avoid confusion with a nickname.  If the
+nickname contains ":", it needs to be preceded by "\\" so that it is not
+recognized as password delimiter.  If the nickname contains "\\", it needs to
+be escaped as "\\\\" so that it is not recognized as an escape character.
+
+If curl is built against OpenSSL library, and the engine pkcs11 is available,
+then a PKCS#11 URI (RFC 7512) can be used to specify a certificate located in
+a PKCS#11 device. A string beginning with "pkcs11:" will be interpreted as a
+PKCS#11 URI. If a PKCS#11 URI is provided, then the --engine option will be set
+as "pkcs11" if none was provided and the --cert-type option will be set as
+"ENG" if none was provided.
+
+(iOS and macOS only) If curl is built against Secure Transport, then the
+certificate string can either be the name of a certificate/private key in the
+system or user keychain, or the path to a PKCS#12-encoded certificate and
+private key. If you want to use a file from the current directory, please
+precede it with "./" prefix, in order to avoid confusion with a nickname.
+
+(Schannel only) Client certificates must be specified by a path
+expression to a certificate store. (Loading PFX is not supported; you can
+import it to a store first). You can use
+"<store location>\\<store name>\\<thumbprint>" to refer to a certificate
+in the system certificates store, for example,
+"CurrentUser\\MY\\934a7ac6f8a5d579285a74fa61e19f23ddfe8d7a". Thumbprint is
+usually a SHA-1 hex string which you can see in certificate details. Following
+store locations are supported: CurrentUser, LocalMachine, CurrentService,
+Services, CurrentUserGroupPolicy, LocalMachineGroupPolicy,
+LocalMachineEnterprise.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/ciphers.d b/docs/cmdline-opts/ciphers.d
new file mode 100644
index 0000000..c2cb92e
--- /dev/null
+++ b/docs/cmdline-opts/ciphers.d
@@ -0,0 +1,13 @@
+Long: ciphers
+Arg: <list of ciphers>
+Help: SSL ciphers to use
+Protocols: TLS
+Category: tls
+Example: --ciphers ECDHE-ECDSA-AES256-CCM8 $URL
+---
+Specifies which ciphers to use in the connection. The list of ciphers must
+specify valid ciphers. Read up on SSL cipher list details on this URL:
+
+ https://curl.se/docs/ssl-ciphers.html
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/compressed-ssh.d b/docs/cmdline-opts/compressed-ssh.d
new file mode 100644
index 0000000..d95c6ad
--- /dev/null
+++ b/docs/cmdline-opts/compressed-ssh.d
@@ -0,0 +1,9 @@
+Long: compressed-ssh
+Help: Enable SSH compression
+Protocols: SCP SFTP
+Added: 7.56.0
+Category: scp ssh
+Example: --compressed-ssh sftp://example.com/
+---
+Enables built-in SSH compression.
+This is a request, not an order; the server may or may not do it.
diff --git a/docs/cmdline-opts/compressed.d b/docs/cmdline-opts/compressed.d
new file mode 100644
index 0000000..945beb8
--- /dev/null
+++ b/docs/cmdline-opts/compressed.d
@@ -0,0 +1,12 @@
+Long: compressed
+Help: Request compressed response
+Protocols: HTTP
+Category: http
+Example: --compressed $URL
+---
+Request a compressed response using one of the algorithms curl supports, and
+automatically decompress the content. Headers are not modified.
+
+If this option is used and the server sends an unsupported encoding, curl will
+report an error. This is a request, not an order; the server may or may not
+deliver data compressed.
diff --git a/docs/cmdline-opts/config.d b/docs/cmdline-opts/config.d
new file mode 100644
index 0000000..1de0b31
--- /dev/null
+++ b/docs/cmdline-opts/config.d
@@ -0,0 +1,72 @@
+Long: config
+Arg: <file>
+Help: Read config from a file
+Short: K
+Category: curl
+Example: --config file.txt $URL
+---
+
+Specify a text file to read curl arguments from. The command line arguments
+found in the text file will be used as if they were provided on the command
+line.
+
+Options and their parameters must be specified on the same line in the file,
+separated by whitespace, colon, or the equals sign. Long option names can
+optionally be given in the config file without the initial double dashes and
+if so, the colon or equals characters can be used as separators. If the option
+is specified with one or two dashes, there can be no colon or equals character
+between the option and its parameter.
+
+If the parameter contains whitespace (or starts with : or =), the parameter
+must be enclosed within quotes. Within double quotes, the following escape
+sequences are available: \\\\, \\", \\t, \\n, \\r and \\v. A backslash
+preceding any other letter is ignored.
+
+If the first column of a config line is a '#' character, the rest of the line
+will be treated as a comment.
+
+Only write one option per physical line in the config file.
+
+Specify the filename to --config as '-' to make curl read the file from stdin.
+
+Note that to be able to specify a URL in the config file, you need to specify
+it using the --url option, and not by simply writing the URL on its own
+line. So, it could look similar to this:
+
+url = "https://curl.se/docs/"
+
+When curl is invoked, it (unless --disable is used) checks for a default
+config file and uses it if found, even when this option is used. The default
+config file is checked for in the following places in this order:
+
+1) Use the CURL_HOME environment variable if set
+
+2) Use the XDG_CONFIG_HOME environment variable if set (Added in 7.73.0)
+
+3) Use the HOME environment variable if set
+
+4) Non-windows: use getpwuid to find the home directory
+
+5) Windows: use APPDATA if set
+
+6) Windows: use "USERPROFILE\\Application Data" if set
+
+7) On windows, if there is no .curlrc file in the home dir, it checks for one
+in the same dir the curl executable is placed. On Unix-like systems, it will
+simply try to load .curlrc from the determined home dir.
+
+.nf
+# --- Example file ---
+# this is a comment
+url = "example.com"
+output = "curlhere.html"
+user-agent = "superagent/1.0"
+
+# and fetch another URL too
+url = "example.com/docs/manpage.html"
+-O
+referer = "http://nowhereatall.example.com/"
+# --- End of example file ---
+.fi
+
+This option can be used multiple times to load multiple config files.
diff --git a/docs/cmdline-opts/connect-timeout.d b/docs/cmdline-opts/connect-timeout.d
new file mode 100644
index 0000000..e66e35a
--- /dev/null
+++ b/docs/cmdline-opts/connect-timeout.d
@@ -0,0 +1,14 @@
+Long: connect-timeout
+Arg: <fractional seconds>
+Help: Maximum time allowed for connection
+See-also: max-time
+Category: connection
+Example: --connect-timeout 20 $URL
+Example: --connect-timeout 3.14 $URL
+---
+Maximum time in seconds that you allow curl's connection to take.  This only
+limits the connection phase, so if curl connects within the given period it
+will continue - if not it will exit.  Since version 7.32.0, this option
+accepts decimal values.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/connect-to.d b/docs/cmdline-opts/connect-to.d
new file mode 100644
index 0000000..ebea9b9
--- /dev/null
+++ b/docs/cmdline-opts/connect-to.d
@@ -0,0 +1,23 @@
+Long: connect-to
+Arg: <HOST1:PORT1:HOST2:PORT2>
+Help: Connect to host
+Added: 7.49.0
+See-also: resolve header
+Category: connection
+Example: --connect-to example.com:443:example.net:8443 $URL
+---
+
+For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead.
+This option is suitable to direct requests at a specific server, e.g. at a
+specific cluster node in a cluster of servers. This option is only used to
+establish the network connection. It does NOT affect the hostname/port that is
+used for TLS/SSL (e.g. SNI, certificate verification) or for the application
+protocols. "HOST1" and "PORT1" may be the empty string, meaning "any
+host/port". "HOST2" and "PORT2" may also be the empty string, meaning "use the
+request's original host/port".
+
+A "host" specified to this option is compared as a string, so it needs to
+match the name used in request URL. It can be either numerical such as
+"127.0.0.1" or the full host name such as "example.org".
+
+This option can be used many times to add many connect rules.
diff --git a/docs/cmdline-opts/continue-at.d b/docs/cmdline-opts/continue-at.d
new file mode 100644
index 0000000..9e11bdb
--- /dev/null
+++ b/docs/cmdline-opts/continue-at.d
@@ -0,0 +1,18 @@
+Short: C
+Long: continue-at
+Arg: <offset>
+Help: Resumed transfer offset
+See-also: range
+Category: connection
+Example: -C - $URL
+Example: -C 400 $URL
+---
+Continue/Resume a previous file transfer at the given offset. The given offset
+is the exact number of bytes that will be skipped, counting from the beginning
+of the source file before it is transferred to the destination.  If used with
+uploads, the FTP server command SIZE will not be used by curl.
+
+Use "-C -" to tell curl to automatically find out where/how to resume the
+transfer. It then uses the given output/input files to figure that out.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/cookie-jar.d b/docs/cmdline-opts/cookie-jar.d
new file mode 100644
index 0000000..f418af6
--- /dev/null
+++ b/docs/cmdline-opts/cookie-jar.d
@@ -0,0 +1,27 @@
+Short: c
+Long: cookie-jar
+Arg: <filename>
+Protocols: HTTP
+Help: Write cookies to <filename> after operation
+Category: http
+Example: -c store-here.txt $URL
+Example: -c store-here.txt -b read-these $URL
+---
+Specify to which file you want curl to write all cookies after a completed
+operation. Curl writes all cookies from its in-memory cookie storage to the
+given file at the end of operations. If no cookies are known, no data will be
+written. The file will be written using the Netscape cookie file format. If
+you set the file name to a single dash, "-", the cookies will be written to
+stdout.
+
+This command line option will activate the cookie engine that makes curl
+record and use cookies. Another way to activate it is to use the --cookie
+option.
+
+If the cookie jar can't be created or written to, the whole curl operation
+won't fail or even report an error clearly. Using --verbose will get a warning
+displayed, but that is the only visible feedback you get about this possibly
+lethal situation.
+
+If this option is used several times, the last specified file name will be
+used.
diff --git a/docs/cmdline-opts/cookie.d b/docs/cmdline-opts/cookie.d
new file mode 100644
index 0000000..b593935
--- /dev/null
+++ b/docs/cmdline-opts/cookie.d
@@ -0,0 +1,36 @@
+Short: b
+Long: cookie
+Arg: <data|filename>
+Protocols: HTTP
+Help: Send cookies from string/file
+Category: http
+Example: -b cookiefile $URL
+Example: -b cookiefile -c cookiefile $URL
+---
+Pass the data to the HTTP server in the Cookie header. It is supposedly
+the data previously received from the server in a "Set-Cookie:" line.  The
+data should be in the format "NAME1=VALUE1; NAME2=VALUE2".
+
+If no '=' symbol is used in the argument, it is instead treated as a filename
+to read previously stored cookie from. This option also activates the cookie
+engine which will make curl record incoming cookies, which may be handy if
+you're using this in combination with the --location option or do multiple URL
+transfers on the same invoke. If the file name is exactly a minus ("-"), curl
+will instead read the contents from stdin.
+
+The file format of the file to read cookies from should be plain HTTP headers
+(Set-Cookie style) or the Netscape/Mozilla cookie file format.
+
+The file specified with --cookie is only used as input. No cookies will be
+written to the file. To store cookies, use the --cookie-jar option.
+
+If you use the Set-Cookie file format and don't specify a domain then the
+cookie is not sent since the domain will never match. To address this, set a
+domain in Set-Cookie line (doing that will include sub-domains) or preferably:
+use the Netscape format.
+
+This option can be used multiple times.
+
+Users very often want to both read cookies from a file and write updated
+cookies back to a file, so using both --cookie and --cookie-jar in the same
+command line is common.
diff --git a/docs/cmdline-opts/create-dirs.d b/docs/cmdline-opts/create-dirs.d
new file mode 100644
index 0000000..cae1d5a
--- /dev/null
+++ b/docs/cmdline-opts/create-dirs.d
@@ -0,0 +1,14 @@
+Long: create-dirs
+Help: Create necessary local directory hierarchy
+Category: curl
+Example: --create-dirs --output local/dir/file $URL
+---
+When used in conjunction with the --output option, curl will create the
+necessary local directory hierarchy as needed. This option creates the
+directories mentioned with the --output option, nothing else. If the --output
+file name uses no directory, or if the directories it mentions already exist,
+no directories will be created.
+
+Created dirs are made with mode 0750 on unix style file systems.
+
+To create remote directories when using FTP or SFTP, try --ftp-create-dirs.
diff --git a/docs/cmdline-opts/create-file-mode.d b/docs/cmdline-opts/create-file-mode.d
new file mode 100644
index 0000000..429b5ee
--- /dev/null
+++ b/docs/cmdline-opts/create-file-mode.d
@@ -0,0 +1,16 @@
+Long: create-file-mode
+Arg: <mode>
+Help: File mode for created files
+Protocols: SFTP SCP FILE
+Category: sftp scp file upload
+See-also: ftp-create-dirs
+Added: 7.75.0
+Example: --create-file-mode 0777 -T localfile sftp://example.com/new
+---
+When curl is used to create files remotely using one of the supported
+protocols, this option allows the user to set which 'mode' to set on the file
+at creation time, instead of the default 0644.
+
+This option takes an octal number as argument.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/crlf.d b/docs/cmdline-opts/crlf.d
new file mode 100644
index 0000000..856cd13
--- /dev/null
+++ b/docs/cmdline-opts/crlf.d
@@ -0,0 +1,9 @@
+Long: crlf
+Help: Convert LF to CRLF in upload
+Protocols: FTP SMTP
+Category: ftp smtp
+Example: --crlf -T file ftp://example.com/
+---
+Convert LF to CRLF in upload. Useful for MVS (OS/390).
+
+(SMTP added in 7.40.0)
diff --git a/docs/cmdline-opts/crlfile.d b/docs/cmdline-opts/crlfile.d
new file mode 100644
index 0000000..21e86a8
--- /dev/null
+++ b/docs/cmdline-opts/crlfile.d
@@ -0,0 +1,12 @@
+Long: crlfile
+Arg: <file>
+Protocols: TLS
+Help: Use this CRL list
+Added: 7.19.7
+Category: tls
+Example: --crlfile rejects.txt $URL
+---
+Provide a file using PEM format with a Certificate Revocation List that may
+specify peer certificates that are to be considered revoked.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/curves.d b/docs/cmdline-opts/curves.d
new file mode 100644
index 0000000..ac5ab10
--- /dev/null
+++ b/docs/cmdline-opts/curves.d
@@ -0,0 +1,19 @@
+Long: curves
+Arg: <algorithm list>
+Help: (EC) TLS key exchange algorithm(s) to request
+Protocols: TLS
+Added: 7.73.0
+Category: tls
+Example: --curves X25519 $URL
+---
+Tells curl to request specific curves to use during SSL session establishment
+according to RFC 8422, 5.1.  Multiple algorithms can be provided by separating
+them with ":" (e.g.  "X25519:P-521").  The parameter is available identically
+in the "openssl s_client/s_server" utilities.
+
+--curves allows a OpenSSL powered curl to make SSL-connections with exactly
+the (EC) curve requested by the client, avoiding intransparent client/server
+negotiations.
+
+If this option is set, the default curves list built into openssl will be
+ignored.
diff --git a/docs/cmdline-opts/data-ascii.d b/docs/cmdline-opts/data-ascii.d
new file mode 100644
index 0000000..943f301
--- /dev/null
+++ b/docs/cmdline-opts/data-ascii.d
@@ -0,0 +1,8 @@
+Long: data-ascii
+Arg: <data>
+Help: HTTP POST ASCII data
+Protocols: HTTP
+Category: http post upload
+Example: --data-ascii @file $URL
+---
+This is just an alias for --data.
diff --git a/docs/cmdline-opts/data-binary.d b/docs/cmdline-opts/data-binary.d
new file mode 100644
index 0000000..578cebc
--- /dev/null
+++ b/docs/cmdline-opts/data-binary.d
@@ -0,0 +1,20 @@
+Long: data-binary
+Arg: <data>
+Help: HTTP POST binary data
+Protocols: HTTP
+Category: http post upload
+Example: --data-binary @filename $URL
+---
+This posts data exactly as specified with no extra processing whatsoever.
+
+If you start the data with the letter @, the rest should be a filename.  Data
+is posted in a similar manner as --data does, except that newlines and
+carriage returns are preserved and conversions are never done.
+
+Like --data the default content-type sent to the server is
+application/x-www-form-urlencoded. If you want the data to be treated as
+arbitrary binary data by the server then set the content-type to octet-stream:
+-H "Content-Type: application/octet-stream".
+
+If this option is used several times, the ones following the first will append
+data as described in --data.
diff --git a/docs/cmdline-opts/data-raw.d b/docs/cmdline-opts/data-raw.d
new file mode 100644
index 0000000..b8cd0f7
--- /dev/null
+++ b/docs/cmdline-opts/data-raw.d
@@ -0,0 +1,12 @@
+Long: data-raw
+Arg: <data>
+Protocols: HTTP
+Help: HTTP POST data, '@' allowed
+Added: 7.43.0
+See-also: data
+Category: http post upload
+Example: --data-raw "hello" $URL
+Example: --data-raw "@at@at@" $URL
+---
+This posts data similarly to --data but without the special
+interpretation of the @ character.
diff --git a/docs/cmdline-opts/data-urlencode.d b/docs/cmdline-opts/data-urlencode.d
new file mode 100644
index 0000000..8b12957
--- /dev/null
+++ b/docs/cmdline-opts/data-urlencode.d
@@ -0,0 +1,38 @@
+Long: data-urlencode
+Arg: <data>
+Help: HTTP POST data url encoded
+Protocols: HTTP
+See-also: data data-raw
+Added: 7.18.0
+Category: http post upload
+Example: --data-urlencode name=val $URL
+Example: --data-urlencode =encodethis $URL
+Example: --data-urlencode name@file $URL
+Example: --data-urlencode @fileonly $URL
+---
+This posts data, similar to the other --data options with the exception
+that this performs URL-encoding.
+
+To be CGI-compliant, the <data> part should begin with a *name* followed
+by a separator and a content specification. The <data> part can be passed to
+curl using one of the following syntaxes:
+.RS
+.IP "content"
+This will make curl URL-encode the content and pass that on. Just be careful
+so that the content doesn't contain any = or @ symbols, as that will then make
+the syntax match one of the other cases below!
+.IP "=content"
+This will make curl URL-encode the content and pass that on. The preceding =
+symbol is not included in the data.
+.IP "name=content"
+This will make curl URL-encode the content part and pass that on. Note that
+the name part is expected to be URL-encoded already.
+.IP "@filename"
+This will make curl load data from the given file (including any newlines),
+URL-encode that data and pass it on in the POST.
+.IP "name@filename"
+This will make curl load data from the given file (including any newlines),
+URL-encode that data and pass it on in the POST. The name part gets an equal
+sign appended, resulting in *name=urlencoded-file-content*. Note that the
+name is expected to be URL-encoded already.
+.RE
diff --git a/docs/cmdline-opts/data.d b/docs/cmdline-opts/data.d
new file mode 100644
index 0000000..35fd675
--- /dev/null
+++ b/docs/cmdline-opts/data.d
@@ -0,0 +1,33 @@
+Long: data
+Short: d
+Arg: <data>
+Help: HTTP POST data
+Protocols: HTTP MQTT
+See-also: data-binary data-urlencode data-raw
+Mutexed: form head upload-file
+Category: important http post upload
+Example: -d "name=curl" $URL
+Example: -d "name=curl" -d "tool=cmdline" $URL
+Example: -d @filename $URL
+---
+Sends the specified data in a POST request to the HTTP server, in the same way
+that a browser does when a user has filled in an HTML form and presses the
+submit button. This will cause curl to pass the data to the server using the
+content-type application/x-www-form-urlencoded.  Compare to --form.
+
+--data-raw is almost the same but does not have a special interpretation of
+the @ character. To post data purely binary, you should instead use the
+--data-binary option.  To URL-encode the value of a form field you may use
+--data-urlencode.
+
+If any of these options is used more than once on the same command line, the
+data pieces specified will be merged together with a separating
+&-symbol. Thus, using '-d name=daniel -d skill=lousy' would generate a post
+chunk that looks like \&'name=daniel&skill=lousy'.
+
+If you start the data with the letter @, the rest should be a file name to
+read the data from, or - if you want curl to read the data from stdin. Posting
+data from a file named \&'foobar' would thus be done with --data @foobar. When
+--data is told to read from a file like that, carriage returns and newlines
+will be stripped out. If you don't want the @ character to have a special
+interpretation use --data-raw instead.
diff --git a/docs/cmdline-opts/delegation.d b/docs/cmdline-opts/delegation.d
new file mode 100644
index 0000000..1514d66
--- /dev/null
+++ b/docs/cmdline-opts/delegation.d
@@ -0,0 +1,20 @@
+Long: delegation
+Arg: <LEVEL>
+Help: GSS-API delegation permission
+Protocols: GSS/kerberos
+Category: auth
+Example: --delegation "none" $URL
+---
+Set LEVEL to tell the server what it is allowed to delegate when it
+comes to user credentials.
+.RS
+.IP "none"
+Don't allow any delegation.
+.IP "policy"
+Delegates if and only if the OK-AS-DELEGATE flag is set in the Kerberos
+service ticket, which is a matter of realm policy.
+.IP "always"
+Unconditionally allow the server to delegate.
+.RE
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/digest.d b/docs/cmdline-opts/digest.d
new file mode 100644
index 0000000..1934137
--- /dev/null
+++ b/docs/cmdline-opts/digest.d
@@ -0,0 +1,13 @@
+Long: digest
+Help: Use HTTP Digest Authentication
+Protocols: HTTP
+Mutexed: basic ntlm negotiate
+See-also: user proxy-digest anyauth
+Category: proxy auth http
+Example: -u name:password --digest $URL
+---
+Enables HTTP Digest authentication. This is an authentication scheme that
+prevents the password from being sent over the wire in clear text. Use this in
+combination with the normal --user option to set user name and password.
+
+If this option is used several times, only the first one is used.
diff --git a/docs/cmdline-opts/disable-eprt.d b/docs/cmdline-opts/disable-eprt.d
new file mode 100644
index 0000000..38b3e0b
--- /dev/null
+++ b/docs/cmdline-opts/disable-eprt.d
@@ -0,0 +1,21 @@
+Long: disable-eprt
+Help: Inhibit using EPRT or LPRT
+Protocols: FTP
+Category: ftp
+Example: --disable-eprt ftp://example.com/
+---
+Tell curl to disable the use of the EPRT and LPRT commands when doing active
+FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT
+before using PORT, but with this option, it will use PORT right away. EPRT and
+LPRT are extensions to the original FTP protocol, and may not work on all
+servers, but they enable more functionality in a better way than the
+traditional PORT command.
+
+--eprt can be used to explicitly enable EPRT again and --no-eprt is an alias
+for --disable-eprt.
+
+If the server is accessed using IPv6, this option will have no effect as EPRT
+is necessary then.
+
+Disabling EPRT only changes the active behavior. If you want to switch to
+passive mode you need to not use --ftp-port or force it with --ftp-pasv.
diff --git a/docs/cmdline-opts/disable-epsv.d b/docs/cmdline-opts/disable-epsv.d
new file mode 100644
index 0000000..281ec5c
--- /dev/null
+++ b/docs/cmdline-opts/disable-epsv.d
@@ -0,0 +1,18 @@
+Long: disable-epsv
+Help: Inhibit using EPSV
+Protocols: FTP
+Category: ftp
+Example: --disable-epsv ftp://example.com/
+---
+Tell curl to disable the use of the EPSV command when doing passive FTP
+transfers. Curl will normally always first attempt to use EPSV before
+PASV, but with this option, it will not try using EPSV.
+
+--epsv can be used to explicitly enable EPSV again and --no-epsv is an alias
+for --disable-epsv.
+
+If the server is an IPv6 host, this option will have no effect as EPSV is
+necessary then.
+
+Disabling EPSV only changes the passive behavior. If you want to switch to
+active mode you need to use --ftp-port.
diff --git a/docs/cmdline-opts/disable.d b/docs/cmdline-opts/disable.d
new file mode 100644
index 0000000..3eb87f8
--- /dev/null
+++ b/docs/cmdline-opts/disable.d
@@ -0,0 +1,9 @@
+Long: disable
+Short: q
+Help: Disable .curlrc
+Category: curl
+Example: -q $URL
+---
+If used as the first parameter on the command line, the *curlrc* config
+file will not be read and used. See the --config for details on the default
+config file search path.
diff --git a/docs/cmdline-opts/disallow-username-in-url.d b/docs/cmdline-opts/disallow-username-in-url.d
new file mode 100644
index 0000000..f3122ae
--- /dev/null
+++ b/docs/cmdline-opts/disallow-username-in-url.d
@@ -0,0 +1,10 @@
+Long: disallow-username-in-url
+Help: Disallow username in url
+Protocols: HTTP
+Added: 7.61.0
+See-also: proto
+Category: curl http
+Example: --disallow-username-in-url $URL
+---
+This tells curl to exit if passed a url containing a username. This is probably
+most useful when the URL is being provided at run-time or similar.
diff --git a/docs/cmdline-opts/dns-interface.d b/docs/cmdline-opts/dns-interface.d
new file mode 100644
index 0000000..fec7927
--- /dev/null
+++ b/docs/cmdline-opts/dns-interface.d
@@ -0,0 +1,13 @@
+Long: dns-interface
+Arg: <interface>
+Help: Interface to use for DNS requests
+Protocols: DNS
+See-also: dns-ipv4-addr dns-ipv6-addr
+Added: 7.33.0
+Requires: c-ares
+Category: dns
+Example: --dns-interface eth0 $URL
+---
+Tell curl to send outgoing DNS requests through <interface>. This option is a
+counterpart to --interface (which does not affect DNS). The supplied string
+must be an interface name (not an address).
diff --git a/docs/cmdline-opts/dns-ipv4-addr.d b/docs/cmdline-opts/dns-ipv4-addr.d
new file mode 100644
index 0000000..e09153a
--- /dev/null
+++ b/docs/cmdline-opts/dns-ipv4-addr.d
@@ -0,0 +1,15 @@
+Long: dns-ipv4-addr
+Arg: <address>
+Help: IPv4 address to use for DNS requests
+Protocols: DNS
+See-also: dns-interface dns-ipv6-addr
+Added: 7.33.0
+Requires: c-ares
+Category: dns
+Example: --dns-ipv4-addr 10.1.2.3 $URL
+---
+Tell curl to bind to <ip-address> when making IPv4 DNS requests, so that
+the DNS requests originate from this address. The argument should be a
+single IPv4 address.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/dns-ipv6-addr.d b/docs/cmdline-opts/dns-ipv6-addr.d
new file mode 100644
index 0000000..954cb98
--- /dev/null
+++ b/docs/cmdline-opts/dns-ipv6-addr.d
@@ -0,0 +1,15 @@
+Long: dns-ipv6-addr
+Arg: <address>
+Help: IPv6 address to use for DNS requests
+Protocols: DNS
+See-also: dns-interface dns-ipv4-addr
+Added: 7.33.0
+Requires: c-ares
+Category: dns
+Example: --dns-ipv6-addr 2a04:4e42::561 $URL
+---
+Tell curl to bind to <ip-address> when making IPv6 DNS requests, so that
+the DNS requests originate from this address. The argument should be a
+single IPv6 address.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/dns-servers.d b/docs/cmdline-opts/dns-servers.d
new file mode 100644
index 0000000..0894735
--- /dev/null
+++ b/docs/cmdline-opts/dns-servers.d
@@ -0,0 +1,14 @@
+Long: dns-servers
+Arg: <addresses>
+Help: DNS server addrs to use
+Requires: c-ares
+Added: 7.33.0
+Category: dns
+Example: --dns-servers 192.168.0.1,192.168.0.2 $URL
+---
+Set the list of DNS servers to be used instead of the system default.
+The list of IP addresses should be separated with commas. Port numbers
+may also optionally be given as *:<port-number>* after each IP
+address.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/doh-cert-status.d b/docs/cmdline-opts/doh-cert-status.d
new file mode 100644
index 0000000..a760a6f
--- /dev/null
+++ b/docs/cmdline-opts/doh-cert-status.d
@@ -0,0 +1,8 @@
+Long: doh-cert-status
+Help: Verify the status of the DoH server cert via OCSP-staple
+Protocols: all
+Added: 7.76.0
+Category: dns tls
+Example: --doh-cert-status --doh-url https://doh.example $URL
+---
+Same as --cert-status but used for DoH (DNS-over-HTTPS).
diff --git a/docs/cmdline-opts/doh-insecure.d b/docs/cmdline-opts/doh-insecure.d
new file mode 100644
index 0000000..907a5dc
--- /dev/null
+++ b/docs/cmdline-opts/doh-insecure.d
@@ -0,0 +1,8 @@
+Long: doh-insecure
+Help: Allow insecure DoH server connections
+Protocols: all
+Added: 7.76.0
+Category: dns tls
+Example: --doh-insecure --doh-url https://doh.example $URL
+---
+Same as --insecure but used for DoH (DNS-over-HTTPS).
diff --git a/docs/cmdline-opts/doh-url.d b/docs/cmdline-opts/doh-url.d
new file mode 100644
index 0000000..80ff96c
--- /dev/null
+++ b/docs/cmdline-opts/doh-url.d
@@ -0,0 +1,17 @@
+Long: doh-url
+Arg: <URL>
+Help: Resolve host names over DoH
+Protocols: all
+Added: 7.62.0
+Category: dns
+Example: --doh-url https://doh.example $URL
+---
+Specifies which DNS-over-HTTPS (DoH) server to use to resolve hostnames,
+instead of using the default name resolver mechanism. The URL must be HTTPS.
+
+Some SSL options that you set for your transfer will apply to DoH since the
+name lookups take place over SSL. However, the certificate verification
+settings are not inherited and can be controlled separately via
+--doh-insecure and --doh-cert-status.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/dump-header.d b/docs/cmdline-opts/dump-header.d
new file mode 100644
index 0000000..62c92f4
--- /dev/null
+++ b/docs/cmdline-opts/dump-header.d
@@ -0,0 +1,16 @@
+Long: dump-header
+Short: D
+Arg: <filename>
+Help: Write the received headers to <filename>
+Protocols: HTTP FTP
+See-also: output
+Category: http ftp
+Example: --dump-header store.txt $URL
+---
+Write the received protocol headers to the specified file. If no headers are
+received, the use of this option will create an empty file.
+
+When used in FTP, the FTP server response lines are considered being "headers"
+and thus are saved there.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/egd-file.d b/docs/cmdline-opts/egd-file.d
new file mode 100644
index 0000000..2e99df4
--- /dev/null
+++ b/docs/cmdline-opts/egd-file.d
@@ -0,0 +1,10 @@
+Long: egd-file
+Arg: <file>
+Help: EGD socket path for random data
+Protocols: TLS
+See-also: random-file
+Category: tls
+Example: --egd-file /random/here $URL
+---
+Specify the path name to the Entropy Gathering Daemon socket. The socket is
+used to seed the random engine for SSL connections.
diff --git a/docs/cmdline-opts/engine.d b/docs/cmdline-opts/engine.d
new file mode 100644
index 0000000..8a2dcf7
--- /dev/null
+++ b/docs/cmdline-opts/engine.d
@@ -0,0 +1,10 @@
+Long: engine
+Arg: <name>
+Help: Crypto engine to use
+Protocols: TLS
+Category: tls
+Example: --engine flavor $URL
+---
+Select the OpenSSL crypto engine to use for cipher operations. Use --engine
+list to print a list of build-time supported engines. Note that not all (and
+possibly none) of the engines may be available at run-time.
diff --git a/docs/cmdline-opts/etag-compare.d b/docs/cmdline-opts/etag-compare.d
new file mode 100644
index 0000000..fa16762
--- /dev/null
+++ b/docs/cmdline-opts/etag-compare.d
@@ -0,0 +1,19 @@
+Long: etag-compare
+Arg: <file>
+Help: Pass an ETag from a file as a custom header
+Protocols: HTTP
+Added: 7.68.0
+Category: http
+Example: --etag-compare etag.txt $URL
+---
+This option makes a conditional HTTP request for the specific ETag read
+from the given file by sending a custom If-None-Match header using the
+stored ETag.
+
+For correct results, make sure that the specified file contains only a
+single line with the desired ETag. An empty file is parsed as an empty
+ETag.
+
+Use the option --etag-save to first save the ETag from a response, and
+then use this option to compare against the saved ETag in a subsequent
+request.
diff --git a/docs/cmdline-opts/etag-save.d b/docs/cmdline-opts/etag-save.d
new file mode 100644
index 0000000..8efad90
--- /dev/null
+++ b/docs/cmdline-opts/etag-save.d
@@ -0,0 +1,12 @@
+Long: etag-save
+Arg: <file>
+Help: Parse ETag from a request and save it to a file
+Protocols: HTTP
+Added: 7.68.0
+Category: http
+Example: --etag-save storetag.txt $URL
+---
+This option saves an HTTP ETag to the specified file. An ETag is a
+caching related header, usually returned in a response.
+
+If no ETag is sent by the server, an empty file is created.
diff --git a/docs/cmdline-opts/expect100-timeout.d b/docs/cmdline-opts/expect100-timeout.d
new file mode 100644
index 0000000..8855edd
--- /dev/null
+++ b/docs/cmdline-opts/expect100-timeout.d
@@ -0,0 +1,13 @@
+Long: expect100-timeout
+Arg: <seconds>
+Help: How long to wait for 100-continue
+Protocols: HTTP
+Added: 7.47.0
+See-also: connect-timeout
+Category: http
+Example: --expect100-timeout 2.5 -T file $URL
+---
+Maximum time in seconds that you allow curl to wait for a 100-continue
+response when curl emits an Expects: 100-continue header in its request. By
+default curl will wait one second. This option accepts decimal values! When
+curl stops waiting, it will continue as if the response has been received.
diff --git a/docs/cmdline-opts/fail-early.d b/docs/cmdline-opts/fail-early.d
new file mode 100644
index 0000000..aad15c3
--- /dev/null
+++ b/docs/cmdline-opts/fail-early.d
@@ -0,0 +1,23 @@
+Long: fail-early
+Help: Fail on first transfer error, do not continue
+Added: 7.52.0
+Category: curl
+Example: --fail-early $URL https://two.example
+---
+Fail and exit on the first detected transfer error.
+
+When curl is used to do multiple transfers on the command line, it will
+attempt to operate on each given URL, one by one. By default, it will ignore
+errors if there are more URLs given and the last URL's success will determine
+the error code curl returns. So early failures will be "hidden" by subsequent
+successful transfers.
+
+Using this option, curl will instead return an error on the first transfer
+that fails, independent of the amount of URLs that are given on the command
+line. This way, no transfer failures go undetected by scripts and similar.
+
+This option is global and does not need to be specified for each use of --next.
+
+This option does not imply --fail, which causes transfers to fail due to the
+server's HTTP status code. You can combine the two options, however note --fail
+is not global and is therefore contained by --next.
diff --git a/docs/cmdline-opts/fail-with-body.d b/docs/cmdline-opts/fail-with-body.d
new file mode 100644
index 0000000..9b8c7db
--- /dev/null
+++ b/docs/cmdline-opts/fail-with-body.d
@@ -0,0 +1,16 @@
+Long: fail-with-body
+Protocols: HTTP
+Help: Fail on HTTP errors but save the body
+Category: http output
+Added: 7.76.0
+See-also: fail
+Example: --fail-with-body $URL
+---
+Return an error on server errors where the HTTP response code is 400 or
+greater). In normal cases when an HTTP server fails to deliver a document, it
+returns an HTML document stating so (which often also describes why and
+more). This flag will still allow curl to output and save that content but
+also to return error 22.
+
+This is an alternative option to --fail which makes curl fail for the same
+circumstances but without saving the content.
diff --git a/docs/cmdline-opts/fail.d b/docs/cmdline-opts/fail.d
new file mode 100644
index 0000000..a5e0c91
--- /dev/null
+++ b/docs/cmdline-opts/fail.d
@@ -0,0 +1,17 @@
+Long: fail
+Short: f
+Protocols: HTTP
+Help: Fail silently (no output at all) on HTTP errors
+See-also: fail-with-body
+Category: important http
+Example: --fail $URL
+---
+Fail silently (no output at all) on server errors. This is mostly done to
+enable scripts etc to better deal with failed attempts. In normal cases
+when an HTTP server fails to deliver a document, it returns an HTML document
+stating so (which often also describes why and more). This flag will prevent
+curl from outputting that and return error 22.
+
+This method is not fail-safe and there are occasions where non-successful
+response codes will slip through, especially when authentication is involved
+(response codes 401 and 407).
diff --git a/docs/cmdline-opts/false-start.d b/docs/cmdline-opts/false-start.d
new file mode 100644
index 0000000..de36962
--- /dev/null
+++ b/docs/cmdline-opts/false-start.d
@@ -0,0 +1,14 @@
+Long: false-start
+Help: Enable TLS False Start
+Protocols: TLS
+Added: 7.42.0
+Category: tls
+Example: --false-start $URL
+---
+Tells curl to use false start during the TLS handshake. False start is a mode
+where a TLS client will start sending application data before verifying the
+server's Finished message, thus saving a round trip when performing a full
+handshake.
+
+This is currently only implemented in the NSS and Secure Transport (on iOS 7.0
+or later, or OS X 10.9 or later) backends.
diff --git a/docs/cmdline-opts/form-string.d b/docs/cmdline-opts/form-string.d
new file mode 100644
index 0000000..4f1a766
--- /dev/null
+++ b/docs/cmdline-opts/form-string.d
@@ -0,0 +1,13 @@
+Long: form-string
+Help: Specify multipart MIME data
+Protocols: HTTP SMTP IMAP
+Arg: <name=string>
+See-also: form
+Category: http upload
+Example: --form-string "data" $URL
+---
+Similar to --form except that the value string for the named parameter is used
+literally. Leading \&'@' and \&'<' characters, and the \&';type=' string in
+the value have no special meaning. Use this in preference to --form if
+there's any possibility that the string value may accidentally trigger the
+\&'@' or \&'<' features of --form.
diff --git a/docs/cmdline-opts/form.d b/docs/cmdline-opts/form.d
new file mode 100644
index 0000000..06f2c55
--- /dev/null
+++ b/docs/cmdline-opts/form.d
@@ -0,0 +1,140 @@
+Long: form
+Short: F
+Arg: <name=content>
+Help: Specify multipart MIME data
+Protocols: HTTP SMTP IMAP
+Mutexed: data head upload-file
+Category: http upload
+Example: --form "name=curl" --form "file=@loadthis" $URL
+---
+For HTTP protocol family, this lets curl emulate a filled-in form in which a
+user has pressed the submit button. This causes curl to POST data using the
+Content-Type multipart/form-data according to RFC 2388.
+
+For SMTP and IMAP protocols, this is the means to compose a multipart mail
+message to transmit.
+
+This enables uploading of binary files etc. To force the 'content' part to be
+a file, prefix the file name with an @ sign. To just get the content part from
+a file, prefix the file name with the symbol <. The difference between @ and <
+is then that @ makes a file get attached in the post as a file upload, while
+the < makes a text field and just get the contents for that text field from a
+file.
+
+Tell curl to read content from stdin instead of a file by using - as
+filename. This goes for both @ and < constructs. When stdin is used, the
+contents is buffered in memory first by curl to determine its size and allow a
+possible resend.  Defining a part's data from a named non-regular file (such
+as a named pipe or similar) is unfortunately not subject to buffering and will
+be effectively read at transmission time; since the full size is unknown
+before the transfer starts, such data is sent as chunks by HTTP and rejected
+by IMAP.
+
+Example: send an image to an HTTP server, where \&'profile' is the name of the
+form-field to which the file portrait.jpg will be the input:
+
+ curl -F profile=@portrait.jpg https://example.com/upload.cgi
+
+Example: send your name and shoe size in two text fields to the server:
+
+ curl -F name=John -F shoesize=11 https://example.com/
+
+Example: send your essay in a text field to the server. Send it as a plain
+text field, but get the contents for it from a local file:
+
+ curl -F "story=<hugefile.txt" https://example.com/
+
+You can also tell curl what Content-Type to use by using 'type=', in a manner
+similar to:
+
+ curl -F "web=@index.html;type=text/html" example.com
+
+or
+
+ curl -F "name=daniel;type=text/foo" example.com
+
+You can also explicitly change the name field of a file upload part by setting
+filename=, like this:
+
+ curl -F "file=@localfile;filename=nameinpost" example.com
+
+If filename/path contains ',' or ';', it must be quoted by double-quotes like:
+
+ curl -F "file=@\\"local,file\\";filename=\\"name;in;post\\"" example.com
+
+or
+
+ curl -F 'file=@"local,file";filename="name;in;post"' example.com
+
+Note that if a filename/path is quoted by double-quotes, any double-quote
+or backslash within the filename must be escaped by backslash.
+
+Quoting must also be applied to non-file data if it contains semicolons,
+leading/trailing spaces or leading double quotes:
+
+ curl -F 'colors="red; green; blue";type=text/x-myapp' example.com
+
+You can add custom headers to the field by setting headers=, like
+
+  curl -F "submit=OK;headers=\\"X-submit-type: OK\\"" example.com
+
+or
+
+  curl -F "submit=OK;headers=@headerfile" example.com
+
+The headers= keyword may appear more that once and above notes about quoting
+apply. When headers are read from a file, Empty lines and lines starting
+with '#' are comments and ignored; each header can be folded by splitting
+between two words and starting the continuation line with a space; embedded
+carriage-returns and trailing spaces are stripped.
+Here is an example of a header file contents:
+
+  # This file contain two headers.
+.br
+  X-header-1: this is a header
+
+  # The following header is folded.
+.br
+  X-header-2: this is
+.br
+   another header
+
+
+To support sending multipart mail messages, the syntax is extended as follows:
+.br
+- name can be omitted: the equal sign is the first character of the argument,
+.br
+- if data starts with '(', this signals to start a new multipart: it can be
+followed by a content type specification.
+.br
+- a multipart can be terminated with a '=)' argument.
+
+Example: the following command sends an SMTP mime e-mail consisting in an
+inline part in two alternative formats: plain text and HTML. It attaches a
+text file:
+
+ curl -F '=(;type=multipart/alternative' \\
+.br
+         -F '=plain text message' \\
+.br
+         -F '= <body>HTML message</body>;type=text/html' \\
+.br
+      -F '=)' -F '=@textfile.txt' ...  smtp://example.com
+
+Data can be encoded for transfer using encoder=. Available encodings are
+*binary* and *8bit* that do nothing else than adding the corresponding
+Content-Transfer-Encoding header, *7bit* that only rejects 8-bit characters
+with a transfer error, *quoted-printable* and *base64* that encodes data
+according to the corresponding schemes, limiting lines length to 76
+characters.
+
+Example: send multipart mail with a quoted-printable text message and a
+base64 attached file:
+
+ curl -F '=text message;encoder=quoted-printable' \\
+.br
+      -F '=@localfile;encoder=base64' ... smtp://example.com
+
+See further examples and details in the MANUAL.
+
+This option can be used multiple times.
diff --git a/docs/cmdline-opts/ftp-account.d b/docs/cmdline-opts/ftp-account.d
new file mode 100644
index 0000000..ce816f1
--- /dev/null
+++ b/docs/cmdline-opts/ftp-account.d
@@ -0,0 +1,12 @@
+Long: ftp-account
+Arg: <data>
+Help: Account data string
+Protocols: FTP
+Added: 7.13.0
+Category: ftp auth
+Example: --ftp-account "mr.robot" ftp://example.com/
+---
+When an FTP server asks for "account data" after user name and password has
+been provided, this data is sent off using the ACCT command.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/ftp-alternative-to-user.d b/docs/cmdline-opts/ftp-alternative-to-user.d
new file mode 100644
index 0000000..a5fb985
--- /dev/null
+++ b/docs/cmdline-opts/ftp-alternative-to-user.d
@@ -0,0 +1,12 @@
+Long: ftp-alternative-to-user
+Arg: <command>
+Help: String to replace USER [name]
+Protocols: FTP
+Added: 7.15.5
+Category: ftp
+Example: --ftp-alternative-to-user "U53r" ftp://example.com
+---
+If authenticating with the USER and PASS commands fails, send this command.
+When connecting to Tumbleweed's Secure Transport server over FTPS using a
+client certificate, using "SITE AUTH" will tell the server to retrieve the
+username from the certificate.
diff --git a/docs/cmdline-opts/ftp-create-dirs.d b/docs/cmdline-opts/ftp-create-dirs.d
new file mode 100644
index 0000000..579f8e3
--- /dev/null
+++ b/docs/cmdline-opts/ftp-create-dirs.d
@@ -0,0 +1,10 @@
+Long: ftp-create-dirs
+Protocols: FTP SFTP
+Help: Create the remote dirs if not present
+See-also: create-dirs
+Category: ftp sftp curl
+Example: --ftp-create-dirs -T file ftp://example.com/remote/path/file
+---
+When an FTP or SFTP URL/operation uses a path that doesn't currently exist on
+the server, the standard behavior of curl is to fail. Using this option, curl
+will instead attempt to create missing directories.
diff --git a/docs/cmdline-opts/ftp-method.d b/docs/cmdline-opts/ftp-method.d
new file mode 100644
index 0000000..4af0baf
--- /dev/null
+++ b/docs/cmdline-opts/ftp-method.d
@@ -0,0 +1,25 @@
+Long: ftp-method
+Arg: <method>
+Help: Control CWD usage
+Protocols: FTP
+Added: 7.15.1
+Category: ftp
+Example: --ftp-method multicwd ftp://example.com/dir1/dir2/file
+Example: --ftp-method nocwd ftp://example.com/dir1/dir2/file
+Example: --ftp-method singlecwd ftp://example.com/dir1/dir2/file
+---
+Control what method curl should use to reach a file on an FTP(S)
+server. The method argument should be one of the following alternatives:
+.RS
+.IP multicwd
+curl does a single CWD operation for each path part in the given URL. For deep
+hierarchies this means very many commands. This is how RFC 1738 says it should
+be done. This is the default but the slowest behavior.
+.IP nocwd
+curl does no CWD at all. curl will do SIZE, RETR, STOR etc and give a full
+path to the server for all these commands. This is the fastest behavior.
+.IP singlecwd
+curl does one CWD with the full target directory and then operates on the file
+\&"normally" (like in the multicwd case). This is somewhat more standards
+compliant than 'nocwd' but without the full penalty of 'multicwd'.
+.RE
diff --git a/docs/cmdline-opts/ftp-pasv.d b/docs/cmdline-opts/ftp-pasv.d
new file mode 100644
index 0000000..d920fef
--- /dev/null
+++ b/docs/cmdline-opts/ftp-pasv.d
@@ -0,0 +1,18 @@
+Long: ftp-pasv
+Help: Use PASV/EPSV instead of PORT
+Protocols: FTP
+Added: 7.11.0
+See-also: disable-epsv
+Category: ftp
+Example: --ftp-pasv ftp://example.com/
+---
+Use passive mode for the data connection. Passive is the internal default
+behavior, but using this option can be used to override a previous --ftp-port
+option.
+
+If this option is used several times, only the first one is used. Undoing an
+enforced passive really isn't doable but you must then instead enforce the
+correct --ftp-port again.
+
+Passive mode means that curl will try the EPSV command first and then PASV,
+unless --disable-epsv is used.
diff --git a/docs/cmdline-opts/ftp-port.d b/docs/cmdline-opts/ftp-port.d
new file mode 100644
index 0000000..52e55e5
--- /dev/null
+++ b/docs/cmdline-opts/ftp-port.d
@@ -0,0 +1,36 @@
+Long: ftp-port
+Arg: <address>
+Help: Use PORT instead of PASV
+Short: P
+Protocols: FTP
+See-also: ftp-pasv disable-eprt
+Category: ftp
+Example: -P - ftp:/example.com
+Example: -P eth0 ftp:/example.com
+Example: -P 192.168.0.2 ftp:/example.com
+---
+Reverses the default initiator/listener roles when connecting with FTP. This
+option makes curl use active mode. curl then tells the server to connect back
+to the client's specified address and port, while passive mode asks the server
+to setup an IP address and port for it to connect to. <address> should be one
+of:
+.RS
+.IP interface
+e.g. "eth0" to specify which interface's IP address you want to use (Unix only)
+.IP "IP address"
+e.g. "192.168.10.1" to specify the exact IP address
+.IP "host name"
+e.g. "my.host.domain" to specify the machine
+.IP "-"
+make curl pick the same IP address that is already used for the control
+connection
+.RE
+
+If this option is used several times, the last one will be used. Disable the
+use of PORT with --ftp-pasv. Disable the attempt to use the EPRT command
+instead of PORT by using --disable-eprt. EPRT is really PORT++.
+
+Since 7.19.5, you can append \&":[start]-[end]\&" to the right of the address,
+to tell curl what TCP port range to use. That means you specify a port range,
+from a lower to a higher number. A single number works as well, but do note
+that it increases the risk of failure since the port may not be available.
diff --git a/docs/cmdline-opts/ftp-pret.d b/docs/cmdline-opts/ftp-pret.d
new file mode 100644
index 0000000..453d8cf
--- /dev/null
+++ b/docs/cmdline-opts/ftp-pret.d
@@ -0,0 +1,10 @@
+Long: ftp-pret
+Help: Send PRET before PASV
+Protocols: FTP
+Added: 7.20.0
+Category: ftp
+Example: --ftp-pret ftp://example.com/
+---
+Tell curl to send a PRET command before PASV (and EPSV). Certain FTP servers,
+mainly drftpd, require this non-standard command for directory listings as
+well as up and downloads in PASV mode.
diff --git a/docs/cmdline-opts/ftp-skip-pasv-ip.d b/docs/cmdline-opts/ftp-skip-pasv-ip.d
new file mode 100644
index 0000000..36f9e6d
--- /dev/null
+++ b/docs/cmdline-opts/ftp-skip-pasv-ip.d
@@ -0,0 +1,16 @@
+Long: ftp-skip-pasv-ip
+Help: Skip the IP address for PASV
+Protocols: FTP
+Added: 7.14.2
+See-also: ftp-pasv
+Category: ftp
+Example: --ftp-skip-pasv-ip ftp://example.com/
+---
+Tell curl to not use the IP address the server suggests in its response
+to curl's PASV command when curl connects the data connection. Instead curl
+will re-use the same IP address it already uses for the control
+connection.
+
+Since curl 7.74.0 this option is enabled by default.
+
+This option has no effect if PORT, EPRT or EPSV is used instead of PASV.
diff --git a/docs/cmdline-opts/ftp-ssl-ccc-mode.d b/docs/cmdline-opts/ftp-ssl-ccc-mode.d
new file mode 100644
index 0000000..15ad1f5
--- /dev/null
+++ b/docs/cmdline-opts/ftp-ssl-ccc-mode.d
@@ -0,0 +1,13 @@
+Long: ftp-ssl-ccc-mode
+Arg: <active/passive>
+Help: Set CCC mode
+Protocols: FTP
+Added: 7.16.2
+See-also: ftp-ssl-ccc
+Category: ftp tls
+Example: --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/
+---
+Sets the CCC mode. The passive mode will not initiate the shutdown, but
+instead wait for the server to do it, and will not reply to the shutdown from
+the server. The active mode initiates the shutdown and waits for a reply from
+the server.
diff --git a/docs/cmdline-opts/ftp-ssl-ccc.d b/docs/cmdline-opts/ftp-ssl-ccc.d
new file mode 100644
index 0000000..bfaf431
--- /dev/null
+++ b/docs/cmdline-opts/ftp-ssl-ccc.d
@@ -0,0 +1,12 @@
+Long: ftp-ssl-ccc
+Help: Send CCC after authenticating
+Protocols: FTP
+See-also: ssl ftp-ssl-ccc-mode
+Added: 7.16.1
+Category: ftp tls
+Example: --ftp-ssl-ccc ftps://example.com/
+---
+Use CCC (Clear Command Channel) Shuts down the SSL/TLS layer after
+authenticating. The rest of the control channel communication will be
+unencrypted. This allows NAT routers to follow the FTP transaction. The
+default mode is passive.
diff --git a/docs/cmdline-opts/ftp-ssl-control.d b/docs/cmdline-opts/ftp-ssl-control.d
new file mode 100644
index 0000000..72dc080
--- /dev/null
+++ b/docs/cmdline-opts/ftp-ssl-control.d
@@ -0,0 +1,10 @@
+Long: ftp-ssl-control
+Help: Require SSL/TLS for FTP login, clear for transfer
+Protocols: FTP
+Added: 7.16.0
+Category: ftp tls
+Example: --ftp-ssl-control ftp://example.com
+---
+Require SSL/TLS for the FTP login, clear for transfer.  Allows secure
+authentication, but non-encrypted data transfers for efficiency.  Fails the
+transfer if the server doesn't support SSL/TLS.
diff --git a/docs/cmdline-opts/get.d b/docs/cmdline-opts/get.d
new file mode 100644
index 0000000..c5fb5c9
--- /dev/null
+++ b/docs/cmdline-opts/get.d
@@ -0,0 +1,19 @@
+Long: get
+Short: G
+Help: Put the post data in the URL and use GET
+Category: http upload
+Example: --get $URL
+Example: --get -d "tool=curl" -d "age=old" $URL
+Example: --get -I -d "tool=curl" $URL
+---
+When used, this option will make all data specified with --data, --data-binary
+or --data-urlencode to be used in an HTTP GET request instead of the POST
+request that otherwise would be used. The data will be appended to the URL
+with a '?' separator.
+
+If used in combination with --head, the POST data will instead be appended to
+the URL with a HEAD request.
+
+If this option is used several times, only the first one is used. This is
+because undoing a GET doesn't make sense, but you should then instead enforce
+the alternative method you prefer.
diff --git a/docs/cmdline-opts/globoff.d b/docs/cmdline-opts/globoff.d
new file mode 100644
index 0000000..ec2c7ae
--- /dev/null
+++ b/docs/cmdline-opts/globoff.d
@@ -0,0 +1,10 @@
+Long: globoff
+Short: g
+Help: Disable URL sequences and ranges using {} and []
+Category: curl
+Example: -g "https://example.com/{[]}}}}"
+---
+This option switches off the "URL globbing parser". When you set this option,
+you can specify URLs that contain the letters {}[] without having curl itself
+interpret them. Note that these letters are not normal legal URL contents but
+they should be encoded according to the URI standard.
diff --git a/docs/cmdline-opts/happy-eyeballs-timeout-ms.d b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d
new file mode 100644
index 0000000..c3b2a51
--- /dev/null
+++ b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d
@@ -0,0 +1,19 @@
+Long: happy-eyeballs-timeout-ms
+Arg: <milliseconds>
+Help: Time for IPv6 before trying IPv4
+Added: 7.59.0
+Category: connection
+Example: --happy-eyeballs-timeout-ms 500 $URL
+---
+Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6
+addresses for dual-stack hosts, giving IPv6 a head-start of the specified
+number of milliseconds. If the IPv6 address cannot be connected to within that
+time, then a connection attempt is made to the IPv4 address in parallel. The
+first connection to be established is the one that is used.
+
+The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says
+"It is RECOMMENDED that connection attempts be paced 150-250 ms apart to
+balance human factors against network load." libcurl currently defaults to
+200 ms. Firefox and Chrome currently default to 300 ms.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/haproxy-protocol.d b/docs/cmdline-opts/haproxy-protocol.d
new file mode 100644
index 0000000..446dc65
--- /dev/null
+++ b/docs/cmdline-opts/haproxy-protocol.d
@@ -0,0 +1,13 @@
+Long: haproxy-protocol
+Help: Send HAProxy PROXY protocol v1 header
+Protocols: HTTP
+Added: 7.60.0
+Category: http proxy
+Example: --haproxy-protocol $URL
+---
+Send a HAProxy PROXY protocol v1 header at the beginning of the
+connection. This is used by some load balancers and reverse proxies to
+indicate the client's true IP address and port.
+
+This option is primarily useful when sending test requests to a service that
+expects this header.
diff --git a/docs/cmdline-opts/head.d b/docs/cmdline-opts/head.d
new file mode 100644
index 0000000..06d2489
--- /dev/null
+++ b/docs/cmdline-opts/head.d
@@ -0,0 +1,10 @@
+Long: head
+Short: I
+Help: Show document info only
+Protocols: HTTP FTP FILE
+Category: http ftp file
+Example: -I $URL
+---
+Fetch the headers only! HTTP-servers feature the command HEAD which this uses
+to get nothing but the header of a document. When used on an FTP or FILE file,
+curl displays the file size and last modification time only.
diff --git a/docs/cmdline-opts/header.d b/docs/cmdline-opts/header.d
new file mode 100644
index 0000000..11c96d5
--- /dev/null
+++ b/docs/cmdline-opts/header.d
@@ -0,0 +1,43 @@
+Long: header
+Short: H
+Arg: <header/@file>
+Help: Pass custom header(s) to server
+Protocols: HTTP
+Category: http
+See-also: user-agent referer
+Example: -H "X-First-Name: Joe" $URL
+Example: -H "User-Agent: yes-please/2000" $URL
+Example: -H "Host:" $URL
+---
+Extra header to include in the request when sending HTTP to a server. You may
+specify any number of extra headers. Note that if you should add a custom
+header that has the same name as one of the internal ones curl would use, your
+externally set header will be used instead of the internal one. This allows
+you to make even trickier stuff than curl would normally do. You should not
+replace internally set headers without knowing perfectly well what you're
+doing. Remove an internal header by giving a replacement without content on
+the right side of the colon, as in: -H \&"Host:". If you send the custom
+header with no-value then its header must be terminated with a semicolon, such
+as \-H \&"X-Custom-Header;" to send "X-Custom-Header:".
+
+curl will make sure that each header you add/replace is sent with the proper
+end-of-line marker, you should thus **not** add that as a part of the header
+content: do not add newlines or carriage returns, they will only mess things
+up for you.
+
+This option can take an argument in @filename style, which then adds a header
+for each line in the input file. Using @- will make curl read the header file
+from stdin. Added in 7.55.0.
+
+You need --proxy-header to send custom headers intended for a HTTP
+proxy. Added in 7.37.0.
+
+Passing on a "Transfer-Encoding: chunked" header when doing a HTTP request
+with a request body, will make curl send the data using chunked encoding.
+
+**WARNING**: headers set with this option will be set in all requests - even
+after redirects are followed, like when told with --location. This can lead to
+the header being sent to other hosts than the original host, so sensitive
+headers should be used with caution combined with following redirects.
+
+This option can be used multiple times to add/replace/remove multiple headers.
diff --git a/docs/cmdline-opts/help.d b/docs/cmdline-opts/help.d
new file mode 100644
index 0000000..28ae868
--- /dev/null
+++ b/docs/cmdline-opts/help.d
@@ -0,0 +1,13 @@
+Long: help
+Arg: <category>
+Short: h
+Help: Get help for commands
+Category: important curl
+Example: --help all
+---
+Usage help. This lists all commands of the <category>.
+If no arg was provided, curl will display the most important
+command line arguments.
+If the argument "all" was provided, curl will display all options available.
+If the argument "category" was provided, curl will display all categories and
+their meanings.
diff --git a/docs/cmdline-opts/hostpubmd5.d b/docs/cmdline-opts/hostpubmd5.d
new file mode 100644
index 0000000..833db95
--- /dev/null
+++ b/docs/cmdline-opts/hostpubmd5.d
@@ -0,0 +1,11 @@
+Long: hostpubmd5
+Arg: <md5>
+Help: Acceptable MD5 hash of the host public key
+Protocols: SFTP SCP
+Added: 7.17.1
+Category: sftp scp
+Example: --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/
+---
+Pass a string containing 32 hexadecimal digits. The string should
+be the 128 bit MD5 checksum of the remote host's public key, curl will refuse
+the connection with the host unless the md5sums match.
diff --git a/docs/cmdline-opts/hsts.d b/docs/cmdline-opts/hsts.d
new file mode 100644
index 0000000..f9cd453
--- /dev/null
+++ b/docs/cmdline-opts/hsts.d
@@ -0,0 +1,17 @@
+Long: hsts
+Arg: <file name>
+Protocols: HTTPS
+Help: Enable HSTS with this cache file
+Added: 7.74.0
+Category: http
+Example: --hsts cache.txt $URL
+---
+This option enables HSTS for the transfer. If the file name points to an
+existing HSTS cache file, that will be used. After a completed transfer, the
+cache will be saved to the file name again if it has been modified.
+
+Specify a "" file name (zero length) to avoid loading/saving and make curl
+just handle HSTS in memory.
+
+If this option is used several times, curl will load contents from all the
+files but the last one will be used for saving.
diff --git a/docs/cmdline-opts/http0.9.d b/docs/cmdline-opts/http0.9.d
new file mode 100644
index 0000000..7c45d56
--- /dev/null
+++ b/docs/cmdline-opts/http0.9.d
@@ -0,0 +1,15 @@
+Long: http0.9
+Tags: Versions
+Protocols: HTTP
+Added:
+Help: Allow HTTP 0.9 responses
+Category: http
+Example: --http0.9 $URL
+---
+Tells curl to be fine with HTTP version 0.9 response.
+
+HTTP/0.9 is a completely headerless response and therefore you can also
+connect with this to non-HTTP servers and still get a response since curl will
+simply transparently downgrade - if allowed.
+
+Since curl 7.66.0, HTTP/0.9 is disabled by default.
diff --git a/docs/cmdline-opts/http1.0.d b/docs/cmdline-opts/http1.0.d
new file mode 100644
index 0000000..cbfbaee
--- /dev/null
+++ b/docs/cmdline-opts/http1.0.d
@@ -0,0 +1,12 @@
+Short: 0
+Long: http1.0
+Tags: Versions
+Protocols: HTTP
+Added:
+Mutexed: http1.1 http2
+Help: Use HTTP 1.0
+Category: http
+Example: --http1.0 $URL
+---
+Tells curl to use HTTP version 1.0 instead of using its internally preferred
+HTTP version.
diff --git a/docs/cmdline-opts/http1.1.d b/docs/cmdline-opts/http1.1.d
new file mode 100644
index 0000000..01fa76d
--- /dev/null
+++ b/docs/cmdline-opts/http1.1.d
@@ -0,0 +1,10 @@
+Long: http1.1
+Tags: Versions
+Protocols: HTTP
+Added: 7.33.0
+Mutexed: http1.0 http2
+Help: Use HTTP 1.1
+Category: http
+Example: --http1.1 $URL
+---
+Tells curl to use HTTP version 1.1.
diff --git a/docs/cmdline-opts/http2-prior-knowledge.d b/docs/cmdline-opts/http2-prior-knowledge.d
new file mode 100644
index 0000000..e3b32f6
--- /dev/null
+++ b/docs/cmdline-opts/http2-prior-knowledge.d
@@ -0,0 +1,14 @@
+Long: http2-prior-knowledge
+Tags: Versions
+Protocols: HTTP
+Added: 7.49.0
+Mutexed: http1.1 http1.0 http2
+Requires: HTTP/2
+Help: Use HTTP 2 without HTTP/1.1 Upgrade
+Category: http
+Example: --http2-prior-knowledge $URL
+---
+Tells curl to issue its non-TLS HTTP requests using HTTP/2 without HTTP/1.1
+Upgrade. It requires prior knowledge that the server supports HTTP/2 straight
+away. HTTPS requests will still do HTTP/2 the standard way with negotiated
+protocol version in the TLS handshake.
diff --git a/docs/cmdline-opts/http2.d b/docs/cmdline-opts/http2.d
new file mode 100644
index 0000000..2a85db6
--- /dev/null
+++ b/docs/cmdline-opts/http2.d
@@ -0,0 +1,19 @@
+Long: http2
+Tags: Versions
+Protocols: HTTP
+Added: 7.33.0
+Mutexed: http1.1 http1.0 http2-prior-knowledge
+Requires: HTTP/2
+See-also: no-alpn
+Help: Use HTTP 2
+See-also: http1.1 http3
+Category: http
+Example: --http2 $URL
+---
+Tells curl to use HTTP version 2.
+
+For HTTPS, this means curl will attempt to negotiate HTTP/2 in the TLS
+handshake. curl does this by default.
+
+For HTTP, this means curl will attempt to upgrade the request to HTTP/2 using
+the Upgrade: request header.
diff --git a/docs/cmdline-opts/http3.d b/docs/cmdline-opts/http3.d
new file mode 100644
index 0000000..f6c92b3
--- /dev/null
+++ b/docs/cmdline-opts/http3.d
@@ -0,0 +1,20 @@
+Long: http3
+Tags: Versions
+Protocols: HTTP
+Added: 7.66.0
+Mutexed: http1.1 http1.0 http2 http2-prior-knowledge
+Requires: HTTP/3
+Help: Use HTTP v3
+See-also: http1.1 http2
+Category: http
+Example: --http3 $URL
+---
+**WARNING**: this option is experimental. Do not use in production.
+
+Tells curl to use HTTP version 3 directly to the host and port number used in
+the URL. A normal HTTP/3 transaction will be done to a host and then get
+redirected via Alt-Svc, but this option allows a user to circumvent that when
+you know that the target speaks HTTP/3 on the given host and port.
+
+This option will make curl fail if a QUIC connection cannot be established, it
+cannot fall back to a lower HTTP version on its own.
diff --git a/docs/cmdline-opts/ignore-content-length.d b/docs/cmdline-opts/ignore-content-length.d
new file mode 100644
index 0000000..8a4c247
--- /dev/null
+++ b/docs/cmdline-opts/ignore-content-length.d
@@ -0,0 +1,14 @@
+Long: ignore-content-length
+Help: Ignore the size of the remote resource
+Protocols: FTP HTTP
+Category: http ftp
+Example: --ignore-content-length $URL
+---
+For HTTP, Ignore the Content-Length header. This is particularly useful for
+servers running Apache 1.x, which will report incorrect Content-Length for
+files larger than 2 gigabytes.
+
+For FTP (since 7.46.0), skip the RETR command to figure out the size before
+downloading a file.
+
+This option doesn't work for HTTP if libcurl was built to use hyper.
diff --git a/docs/cmdline-opts/include.d b/docs/cmdline-opts/include.d
new file mode 100644
index 0000000..80a05e0
--- /dev/null
+++ b/docs/cmdline-opts/include.d
@@ -0,0 +1,12 @@
+Long: include
+Short: i
+Help: Include protocol response headers in the output
+See-also: verbose
+Category: important verbose
+Example: -i $URL
+---
+Include the HTTP response headers in the output. The HTTP response headers can
+include things like server name, cookies, date of the document, HTTP version
+and more...
+
+To view the request headers, consider the --verbose option.
diff --git a/docs/cmdline-opts/insecure.d b/docs/cmdline-opts/insecure.d
new file mode 100644
index 0000000..fb2c17d
--- /dev/null
+++ b/docs/cmdline-opts/insecure.d
@@ -0,0 +1,19 @@
+Long: insecure
+Short: k
+Help: Allow insecure server connections when using SSL
+Protocols: TLS
+See-also: proxy-insecure cacert
+Category: tls
+Example: --insecure $URL
+---
+By default, every SSL connection curl makes is verified to be secure. This
+option allows curl to proceed and operate even for server connections
+otherwise considered insecure.
+
+The server connection is verified by making sure the server's certificate
+contains the right name and verifies successfully using the cert store.
+
+See this online resource for further details:
+ https://curl.se/docs/sslcerts.html
+
+**WARNING**: this makes the transfer insecure.
diff --git a/docs/cmdline-opts/interface.d b/docs/cmdline-opts/interface.d
new file mode 100644
index 0000000..b2c8eee
--- /dev/null
+++ b/docs/cmdline-opts/interface.d
@@ -0,0 +1,18 @@
+Long: interface
+Arg: <name>
+Help: Use network INTERFACE (or address)
+See-also: dns-interface
+Category: connection
+Example: --interface eth0 $URL
+---
+
+Perform an operation using a specified interface. You can enter interface
+name, IP address or host name. An example could look like:
+
+ curl --interface eth0:1 https://www.example.com/
+
+If this option is used several times, the last one will be used.
+
+On Linux it can be used to specify a VRF, but the binary needs to either
+have CAP_NET_RAW or to be run as root. More information about Linux VRF:
+https://www.kernel.org/doc/Documentation/networking/vrf.txt
diff --git a/docs/cmdline-opts/ipv4.d b/docs/cmdline-opts/ipv4.d
new file mode 100644
index 0000000..90a6dda
--- /dev/null
+++ b/docs/cmdline-opts/ipv4.d
@@ -0,0 +1,14 @@
+Short: 4
+Long: ipv4
+Tags: Versions
+Protocols:
+Added:
+Mutexed: ipv6
+Requires:
+See-also: http1.1 http2
+Help: Resolve names to IPv4 addresses
+Category: connection dns
+Example: --ipv4 $URL
+---
+This option tells curl to resolve names to IPv4 addresses only, and not for
+example try IPv6.
diff --git a/docs/cmdline-opts/ipv6.d b/docs/cmdline-opts/ipv6.d
new file mode 100644
index 0000000..dfa79ab
--- /dev/null
+++ b/docs/cmdline-opts/ipv6.d
@@ -0,0 +1,14 @@
+Short: 6
+Long: ipv6
+Tags: Versions
+Protocols:
+Added:
+Mutexed: ipv4
+Requires:
+See-also: http1.1 http2
+Help: Resolve names to IPv6 addresses
+Category: connection dns
+Example: --ipv6 $URL
+---
+This option tells curl to resolve names to IPv6 addresses only, and not for
+example try IPv4.
diff --git a/docs/cmdline-opts/junk-session-cookies.d b/docs/cmdline-opts/junk-session-cookies.d
new file mode 100644
index 0000000..0cc342c
--- /dev/null
+++ b/docs/cmdline-opts/junk-session-cookies.d
@@ -0,0 +1,12 @@
+Long: junk-session-cookies
+Short: j
+Help: Ignore session cookies read from file
+Protocols: HTTP
+See-also: cookie cookie-jar
+Category: http
+Example: --junk-session-cookies -b cookies.txt $URL
+---
+When curl is told to read cookies from a given file, this option will make it
+discard all "session cookies". This will basically have the same effect as if
+a new session is started. Typical browsers always discard session cookies when
+they're closed down.
diff --git a/docs/cmdline-opts/keepalive-time.d b/docs/cmdline-opts/keepalive-time.d
new file mode 100644
index 0000000..1b96c4d
--- /dev/null
+++ b/docs/cmdline-opts/keepalive-time.d
@@ -0,0 +1,15 @@
+Long: keepalive-time
+Arg: <seconds>
+Help: Interval time for keepalive probes
+Added: 7.18.0
+Category: connection
+Example: --keepalive-time 20 $URL
+---
+This option sets the time a connection needs to remain idle before sending
+keepalive probes and the time between individual keepalive probes. It is
+currently effective on operating systems offering the TCP_KEEPIDLE and
+TCP_KEEPINTVL socket options (meaning Linux, recent AIX, HP-UX and more). This
+option has no effect if --no-keepalive is used.
+
+If this option is used several times, the last one will be used. If
+unspecified, the option defaults to 60 seconds.
diff --git a/docs/cmdline-opts/key-type.d b/docs/cmdline-opts/key-type.d
new file mode 100644
index 0000000..4baa9af
--- /dev/null
+++ b/docs/cmdline-opts/key-type.d
@@ -0,0 +1,11 @@
+Long: key-type
+Arg: <type>
+Help: Private key file type (DER/PEM/ENG)
+Protocols: TLS
+Category: tls
+Example: --key-type DER --key here $URL
+---
+Private key file type. Specify which type your --key provided private key
+is. DER, PEM, and ENG are supported. If not specified, PEM is assumed.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/key.d b/docs/cmdline-opts/key.d
new file mode 100644
index 0000000..d7f5e22
--- /dev/null
+++ b/docs/cmdline-opts/key.d
@@ -0,0 +1,19 @@
+Long: key
+Arg: <key>
+Protocols: TLS SSH
+Help: Private key file name
+Category: tls ssh
+Example: --cert certificate --key here $URL
+---
+Private key file name. Allows you to provide your private key in this separate
+file. For SSH, if not specified, curl tries the following candidates in order:
+\&'~/.ssh/id_rsa', '~/.ssh/id_dsa', './id_rsa', './id_dsa'.
+
+If curl is built against OpenSSL library, and the engine pkcs11 is available,
+then a PKCS#11 URI (RFC 7512) can be used to specify a private key located in a
+PKCS#11 device. A string beginning with "pkcs11:" will be interpreted as a
+PKCS#11 URI. If a PKCS#11 URI is provided, then the --engine option will be set
+as "pkcs11" if none was provided and the --key-type option will be set as
+"ENG" if none was provided.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/krb.d b/docs/cmdline-opts/krb.d
new file mode 100644
index 0000000..3d9ce99
--- /dev/null
+++ b/docs/cmdline-opts/krb.d
@@ -0,0 +1,13 @@
+Long: krb
+Arg: <level>
+Help: Enable Kerberos with security <level>
+Protocols: FTP
+Requires: Kerberos
+Category: ftp
+Example: --krb clear ftp://example.com/
+---
+Enable Kerberos authentication and use. The level must be entered and should
+be one of 'clear', 'safe', 'confidential', or 'private'. Should you use a
+level that is not one of these, 'private' will instead be used.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/libcurl.d b/docs/cmdline-opts/libcurl.d
new file mode 100644
index 0000000..b7371ff
--- /dev/null
+++ b/docs/cmdline-opts/libcurl.d
@@ -0,0 +1,16 @@
+Long: libcurl
+Arg: <file>
+Help: Dump libcurl equivalent code of this command line
+Added: 7.16.1
+Category: curl
+Example: --libcurl client.c $URL
+---
+Append this option to any ordinary curl command line, and you will get
+libcurl-using C source code written to the file that does the equivalent
+of what your command-line operation does!
+
+This option is global and does not need to be specified for each use of
+--next.
+
+If this option is used several times, the last given file name will be
+used.
diff --git a/docs/cmdline-opts/limit-rate.d b/docs/cmdline-opts/limit-rate.d
new file mode 100644
index 0000000..7c46e54
--- /dev/null
+++ b/docs/cmdline-opts/limit-rate.d
@@ -0,0 +1,23 @@
+Long: limit-rate
+Arg: <speed>
+Help: Limit transfer speed to RATE
+Category: connection
+Example: --limit-rate 100K $URL
+Example: --limit-rate 1000 $URL
+Example: --limit-rate 10M $URL
+---
+Specify the maximum transfer rate you want curl to use - for both downloads
+and uploads. This feature is useful if you have a limited pipe and you'd like
+your transfer not to use your entire bandwidth. To make it slower than it
+otherwise would be.
+
+The given speed is measured in bytes/second, unless a suffix is appended.
+Appending 'k' or 'K' will count the number as kilobytes, 'm' or 'M' makes it
+megabytes, while 'g' or 'G' makes it gigabytes. The suffixes (k, M, G, T, P)
+are 1024 based. For example 1k is 1024. Examples: 200K, 3m and 1G.
+
+If you also use the --speed-limit option, that option will take precedence and
+might cripple the rate-limiting slightly, to help keeping the speed-limit
+logic working.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/list-only.d b/docs/cmdline-opts/list-only.d
new file mode 100644
index 0000000..29f9ba2
--- /dev/null
+++ b/docs/cmdline-opts/list-only.d
@@ -0,0 +1,26 @@
+Long: list-only
+Short: l
+Protocols: FTP POP3
+Help: List only mode
+Added: 4.0
+Category: ftp pop3
+Example: --list-only ftp://example.com/dir/
+---
+(FTP)
+When listing an FTP directory, this switch forces a name-only view. This is
+especially useful if the user wants to machine-parse the contents of an FTP
+directory since the normal directory view doesn't use a standard look or
+format. When used like this, the option causes an NLST command to be sent to
+the server instead of LIST.
+
+Note: Some FTP servers list only files in their response to NLST; they do not
+include sub-directories and symbolic links.
+
+(POP3)
+When retrieving a specific email from POP3, this switch forces a LIST command
+to be performed instead of RETR. This is particularly useful if the user wants
+to see if a specific message-id exists on the server and what size it is.
+
+Note: When combined with --request, this option can be used to send a UIDL
+command instead, so the user may use the email's unique identifier rather than
+its message-id to make the request.
diff --git a/docs/cmdline-opts/local-port.d b/docs/cmdline-opts/local-port.d
new file mode 100644
index 0000000..7766417
--- /dev/null
+++ b/docs/cmdline-opts/local-port.d
@@ -0,0 +1,11 @@
+Long: local-port
+Arg: <num/range>
+Help: Force use of RANGE for local port numbers
+Added: 7.15.2
+Category: connection
+Example: --local-port 1000-3000 $URL
+---
+Set a preferred single number or range (FROM-TO) of local port numbers to use
+for the connection(s).  Note that port numbers by nature are a scarce resource
+that will be busy at times so setting this range to something too narrow might
+cause unnecessary connection setup failures.
diff --git a/docs/cmdline-opts/location-trusted.d b/docs/cmdline-opts/location-trusted.d
new file mode 100644
index 0000000..98c49ff
--- /dev/null
+++ b/docs/cmdline-opts/location-trusted.d
@@ -0,0 +1,11 @@
+Long: location-trusted
+Help: Like --location, and send auth to other hosts
+Protocols: HTTP
+See-also: user
+Category: http auth
+Example: --location-trusted -u user:password $URL
+---
+Like --location, but will allow sending the name + password to all hosts that
+the site may redirect to. This may or may not introduce a security breach if
+the site redirects you to a site to which you'll send your authentication info
+(which is plaintext in the case of HTTP Basic authentication).
diff --git a/docs/cmdline-opts/location.d b/docs/cmdline-opts/location.d
new file mode 100644
index 0000000..08c939c
--- /dev/null
+++ b/docs/cmdline-opts/location.d
@@ -0,0 +1,27 @@
+Long: location
+Short: L
+Help: Follow redirects
+Protocols: HTTP
+Category: http
+Example: -L $URL
+---
+If the server reports that the requested page has moved to a different
+location (indicated with a Location: header and a 3XX response code), this
+option will make curl redo the request on the new place. If used together with
+--include or --head, headers from all requested pages will be shown. When
+authentication is used, curl only sends its credentials to the initial
+host. If a redirect takes curl to a different host, it won't be able to
+intercept the user+password. See also --location-trusted on how to change
+this. You can limit the amount of redirects to follow by using the
+--max-redirs option.
+
+When curl follows a redirect and if the request is a POST, it will send the
+following request with a GET if the HTTP response was 301, 302, or 303. If the
+response code was any other 3xx code, curl will re-send the following request
+using the same unmodified method.
+
+You can tell curl to not change POST requests to GET after a 30x response by
+using the dedicated options for that: --post301, --post302 and --post303.
+
+The method set with --request overrides the method curl would otherwise select
+to use.
diff --git a/docs/cmdline-opts/login-options.d b/docs/cmdline-opts/login-options.d
new file mode 100644
index 0000000..de77288
--- /dev/null
+++ b/docs/cmdline-opts/login-options.d
@@ -0,0 +1,16 @@
+Long: login-options
+Arg: <options>
+Protocols: IMAP POP3 SMTP
+Help: Server login options
+Added: 7.34.0
+Category: imap pop3 smtp auth
+Example: --login-options 'AUTH=*' imap://example.com
+---
+Specify the login options to use during server authentication.
+
+You can use login options to specify protocol specific options that may be
+used during authentication. At present only IMAP, POP3 and SMTP support
+login options. For more information about login options please see RFC
+2384, RFC 5092 and IETF draft draft-earhart-url-smtp-00.txt
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/mail-auth.d b/docs/cmdline-opts/mail-auth.d
new file mode 100644
index 0000000..49a02d5
--- /dev/null
+++ b/docs/cmdline-opts/mail-auth.d
@@ -0,0 +1,12 @@
+Long: mail-auth
+Arg: <address>
+Protocols: SMTP
+Help: Originator address of the original email
+Added: 7.25.0
+See-also: mail-rcpt mail-from
+Category: smtp
+Example: --mail-auth user@example.come -T mail smtp://example.com/
+---
+Specify a single address. This will be used to specify the authentication
+address (identity) of a submitted message that is being relayed to another
+server.
diff --git a/docs/cmdline-opts/mail-from.d b/docs/cmdline-opts/mail-from.d
new file mode 100644
index 0000000..be0547c
--- /dev/null
+++ b/docs/cmdline-opts/mail-from.d
@@ -0,0 +1,10 @@
+Long: mail-from
+Arg: <address>
+Help: Mail from this address
+Protocols: SMTP
+Added: 7.20.0
+See-also: mail-rcpt mail-auth
+Category: smtp
+Example: --mail-from user@example.com -T mail smtp://example.com/
+---
+Specify a single address that the given mail should get sent from.
diff --git a/docs/cmdline-opts/mail-rcpt-allowfails.d b/docs/cmdline-opts/mail-rcpt-allowfails.d
new file mode 100644
index 0000000..36d555e
--- /dev/null
+++ b/docs/cmdline-opts/mail-rcpt-allowfails.d
@@ -0,0 +1,18 @@
+Long: mail-rcpt-allowfails
+Help: Allow RCPT TO command to fail for some recipients
+Protocols: SMTP
+Added: 7.69.0
+Category: smtp
+Example: --mail-rcpt-allowfails --mail-rcpt dest@example.com smtp://example.com
+---
+When sending data to multiple recipients, by default curl will abort SMTP
+conversation if at least one of the recipients causes RCPT TO command to
+return an error.
+
+The default behavior can be changed by passing --mail-rcpt-allowfails
+command-line option which will make curl ignore errors and proceed with the
+remaining valid recipients.
+
+If all recipients trigger RCPT TO failures and this flag is specified, curl
+will still abort the SMTP conversation and return the error received from to
+the last RCPT TO command.
diff --git a/docs/cmdline-opts/mail-rcpt.d b/docs/cmdline-opts/mail-rcpt.d
new file mode 100644
index 0000000..d4a2502
--- /dev/null
+++ b/docs/cmdline-opts/mail-rcpt.d
@@ -0,0 +1,18 @@
+Long: mail-rcpt
+Arg: <address>
+Help: Mail to this address
+Protocols: SMTP
+Added: 7.20.0
+Category: smtp
+Example: --mail-rcpt user@example.net smtp://example.com
+---
+Specify a single e-mail address, user name or mailing list name. Repeat this
+option several times to send to multiple recipients.
+
+When performing an address verification (VRFY command), the recipient should be
+specified as the user name or user name and domain (as per Section 3.5 of
+RFC5321). (Added in 7.34.0)
+
+When performing a mailing list expand (EXPN command), the recipient should be
+specified using the mailing list name, such as "Friends" or "London-Office".
+(Added in 7.34.0)
diff --git a/docs/cmdline-opts/manual.d b/docs/cmdline-opts/manual.d
new file mode 100644
index 0000000..c81754b
--- /dev/null
+++ b/docs/cmdline-opts/manual.d
@@ -0,0 +1,7 @@
+Long: manual
+Short: M
+Help: Display the full manual
+Category: curl
+Example: --manual
+---
+Manual. Display the huge help text.
diff --git a/docs/cmdline-opts/max-filesize.d b/docs/cmdline-opts/max-filesize.d
new file mode 100644
index 0000000..0f8aca4
--- /dev/null
+++ b/docs/cmdline-opts/max-filesize.d
@@ -0,0 +1,19 @@
+Long: max-filesize
+Arg: <bytes>
+Help: Maximum file size to download
+Protocols: FTP HTTP MQTT
+See-also: limit-rate
+Category: connection
+Example: --max-filesize 100K $URL
+---
+Specify the maximum size (in bytes) of a file to download. If the file
+requested is larger than this value, the transfer will not start and curl will
+return with exit code 63.
+
+A size modifier may be used. For example, Appending 'k' or 'K' will count the
+number as kilobytes, 'm' or 'M' makes it megabytes, while 'g' or 'G' makes it
+gigabytes. Examples: 200K, 3m and 1G. (Added in 7.58.0)
+
+**NOTE**: The file size is not always known prior to download, and for such
+files this option has no effect even if the file transfer ends up being larger
+than this given limit.
\ No newline at end of file
diff --git a/docs/cmdline-opts/max-redirs.d b/docs/cmdline-opts/max-redirs.d
new file mode 100644
index 0000000..eade17f
--- /dev/null
+++ b/docs/cmdline-opts/max-redirs.d
@@ -0,0 +1,12 @@
+Long: max-redirs
+Arg: <num>
+Help: Maximum number of redirects allowed
+Protocols: HTTP
+Category: http
+Example: --max-redirs 3 --location $URL
+---
+Set maximum number of redirections to follow. When --location is used, to
+prevent curl from following too many redirects, by default, the limit is
+set to 50 redirects. Set this option to -1 to make it unlimited.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/max-time.d b/docs/cmdline-opts/max-time.d
new file mode 100644
index 0000000..cb86fa9
--- /dev/null
+++ b/docs/cmdline-opts/max-time.d
@@ -0,0 +1,16 @@
+Long: max-time
+Short: m
+Arg: <fractional seconds>
+Help: Maximum time allowed for transfer
+See-also: connect-timeout
+Category: connection
+Example: --max-time 10 $URL
+Example: --max-time 2.92 $URL
+---
+Maximum time in seconds that you allow the whole operation to take.  This is
+useful for preventing your batch jobs from hanging for hours due to slow
+networks or links going down.  Since 7.32.0, this option accepts decimal
+values, but the actual timeout will decrease in accuracy as the specified
+timeout increases in decimal precision.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/metalink.d b/docs/cmdline-opts/metalink.d
new file mode 100644
index 0000000..1fc1087
--- /dev/null
+++ b/docs/cmdline-opts/metalink.d
@@ -0,0 +1,8 @@
+Long: metalink
+Help: Process given URLs as metalink XML file
+Added: 7.27.0
+Category: misc
+Example: --metalink file $URL
+---
+This option was previously used to specify a metalink resource. Metalink
+support has been disabled in curl since 7.78.0 for security reasons.
diff --git a/docs/cmdline-opts/negotiate.d b/docs/cmdline-opts/negotiate.d
new file mode 100644
index 0000000..e862bc8
--- /dev/null
+++ b/docs/cmdline-opts/negotiate.d
@@ -0,0 +1,17 @@
+Long: negotiate
+Help: Use HTTP Negotiate (SPNEGO) authentication
+Protocols: HTTP
+See-also: basic ntlm anyauth proxy-negotiate
+Category: auth http
+Example: --negotiate -u : $URL
+---
+Enables Negotiate (SPNEGO) authentication.
+
+This option requires a library built with GSS-API or SSPI support. Use
+--version to see if your curl supports GSS-API/SSPI or SPNEGO.
+
+When using this option, you must also provide a fake --user option to activate
+the authentication code properly. Sending a '-u :' is enough as the user name
+and password from the --user option aren't actually used.
+
+If this option is used several times, only the first one is used.
diff --git a/docs/cmdline-opts/netrc-file.d b/docs/cmdline-opts/netrc-file.d
new file mode 100644
index 0000000..df89d51
--- /dev/null
+++ b/docs/cmdline-opts/netrc-file.d
@@ -0,0 +1,14 @@
+Long: netrc-file
+Help: Specify FILE for netrc
+Arg: <filename>
+Added: 7.21.5
+Mutexed: netrc
+Category: curl
+Example: --netrc-file netrc $URL
+---
+This option is similar to --netrc, except that you provide the path (absolute
+or relative) to the netrc file that curl should use.  You can only specify one
+netrc file per invocation. If several --netrc-file options are provided,
+the last one will be used.
+
+It will abide by --netrc-optional if specified.
diff --git a/docs/cmdline-opts/netrc-optional.d b/docs/cmdline-opts/netrc-optional.d
new file mode 100644
index 0000000..3869a20
--- /dev/null
+++ b/docs/cmdline-opts/netrc-optional.d
@@ -0,0 +1,9 @@
+Long: netrc-optional
+Help: Use either .netrc or URL
+Mutexed: netrc
+See-also: netrc-file
+Category: curl
+Example: --netrc-optional $URL
+---
+Very similar to --netrc, but this option makes the .netrc usage **optional**
+and not mandatory as the --netrc option does.
diff --git a/docs/cmdline-opts/netrc.d b/docs/cmdline-opts/netrc.d
new file mode 100644
index 0000000..21e33a1
--- /dev/null
+++ b/docs/cmdline-opts/netrc.d
@@ -0,0 +1,19 @@
+Long: netrc
+Short: n
+Help: Must read .netrc for user name and password
+Category: curl
+Example: --netrc $URL
+---
+Makes curl scan the *.netrc* (*_netrc* on Windows) file in the user's home
+directory for login name and password. This is typically used for FTP on
+Unix. If used with HTTP, curl will enable user authentication. See
+*netrc(5)* and *ftp(1)* for details on the file format. Curl will not
+complain if that file doesn't have the right permissions (it should be
+neither world- nor group-readable). The environment variable "HOME" is used
+to find the home directory.
+
+A quick and very simple example of how to setup a *.netrc* to allow curl
+to FTP to the machine host.domain.com with user name \&'myself' and password
+\&'secret' should look similar to:
+
+.B "machine host.domain.com login myself password secret"
diff --git a/docs/cmdline-opts/next.d b/docs/cmdline-opts/next.d
new file mode 100644
index 0000000..bcbad68
--- /dev/null
+++ b/docs/cmdline-opts/next.d
@@ -0,0 +1,25 @@
+Short: :
+Long: next
+Tags:
+Protocols:
+Added: 7.36.0
+Magic: divider
+Help: Make next URL use its separate set of options
+Category: curl
+Example: $URL --next -d postthis www2.example.com
+Example: -I $URL --next https://example.net/
+---
+Tells curl to use a separate operation for the following URL and associated
+options. This allows you to send several URL requests, each with their own
+specific options, for example, such as different user names or custom requests
+for each.
+
+--next will reset all local options and only global ones will have their
+values survive over to the operation following the --next instruction. Global
+options include --verbose, --trace, --trace-ascii and --fail-early.
+
+For example, you can do both a GET and a POST in a single command line:
+
+.nf
+ curl www1.example.com --next -d postthis www2.example.com
+.fi
diff --git a/docs/cmdline-opts/no-alpn.d b/docs/cmdline-opts/no-alpn.d
new file mode 100644
index 0000000..bc62076
--- /dev/null
+++ b/docs/cmdline-opts/no-alpn.d
@@ -0,0 +1,13 @@
+Long: no-alpn
+Tags: HTTP/2
+Protocols: HTTPS
+Added: 7.36.0
+See-also: no-npn http2
+Requires: TLS
+Help: Disable the ALPN TLS extension
+Category: tls http
+Example: --no-alpn $URL
+---
+Disable the ALPN TLS extension. ALPN is enabled by default if libcurl was built
+with an SSL library that supports ALPN. ALPN is used by a libcurl that supports
+HTTP/2 to negotiate HTTP/2 support with the server during https sessions.
diff --git a/docs/cmdline-opts/no-buffer.d b/docs/cmdline-opts/no-buffer.d
new file mode 100644
index 0000000..fe8da4e
--- /dev/null
+++ b/docs/cmdline-opts/no-buffer.d
@@ -0,0 +1,13 @@
+Long: no-buffer
+Short: N
+Help: Disable buffering of the output stream
+Category: curl
+Example: --no-buffer $URL
+---
+Disables the buffering of the output stream. In normal work situations, curl
+will use a standard buffered output stream that will have the effect that it
+will output the data in chunks, not necessarily exactly when the data arrives.
+Using this option will disable that buffering.
+
+Note that this is the negated option name documented. You can thus use
+--buffer to enforce the buffering.
diff --git a/docs/cmdline-opts/no-keepalive.d b/docs/cmdline-opts/no-keepalive.d
new file mode 100644
index 0000000..a264b7a
--- /dev/null
+++ b/docs/cmdline-opts/no-keepalive.d
@@ -0,0 +1,10 @@
+Long: no-keepalive
+Help: Disable TCP keepalive on the connection
+Category: connection
+Example: --no-keepalive $URL
+---
+Disables the use of keepalive messages on the TCP connection. curl otherwise
+enables them by default.
+
+Note that this is the negated option name documented. You can thus use
+--keepalive to enforce keepalive.
diff --git a/docs/cmdline-opts/no-npn.d b/docs/cmdline-opts/no-npn.d
new file mode 100644
index 0000000..7a9239d
--- /dev/null
+++ b/docs/cmdline-opts/no-npn.d
@@ -0,0 +1,14 @@
+Long: no-npn
+Tags: Versions HTTP/2
+Protocols: HTTPS
+Added: 7.36.0
+Mutexed:
+See-also: no-alpn http2
+Requires: TLS
+Help: Disable the NPN TLS extension
+Category: tls http
+Example: --no-npn $URL
+---
+Disable the NPN TLS extension. NPN is enabled by default if libcurl was built
+with an SSL library that supports NPN. NPN is used by a libcurl that supports
+HTTP/2 to negotiate HTTP/2 support with the server during https sessions.
diff --git a/docs/cmdline-opts/no-progress-meter.d b/docs/cmdline-opts/no-progress-meter.d
new file mode 100644
index 0000000..9c7413e
--- /dev/null
+++ b/docs/cmdline-opts/no-progress-meter.d
@@ -0,0 +1,12 @@
+Long: no-progress-meter
+Help: Do not show the progress meter
+See-also: verbose silent
+Added: 7.67.0
+Category: verbose
+Example: --no-progress-meter -o store $URL
+---
+Option to switch off the progress meter output without muting or otherwise
+affecting warning and informational messages like --silent does.
+
+Note that this is the negated option name documented. You can thus use
+--progress-meter to enable the progress meter again.
diff --git a/docs/cmdline-opts/no-sessionid.d b/docs/cmdline-opts/no-sessionid.d
new file mode 100644
index 0000000..70a3221
--- /dev/null
+++ b/docs/cmdline-opts/no-sessionid.d
@@ -0,0 +1,15 @@
+Long: no-sessionid
+Help: Disable SSL session-ID reusing
+Protocols: TLS
+Added: 7.16.0
+Category: tls
+Example: --no-sessionid $URL
+---
+Disable curl's use of SSL session-ID caching.  By default all transfers are
+done using the cache. Note that while nothing should ever get hurt by
+attempting to reuse SSL session-IDs, there seem to be broken SSL
+implementations in the wild that may require you to disable this in order for
+you to succeed.
+
+Note that this is the negated option name documented. You can thus use
+--sessionid to enforce session-ID caching.
diff --git a/docs/cmdline-opts/noproxy.d b/docs/cmdline-opts/noproxy.d
new file mode 100644
index 0000000..ee0978e
--- /dev/null
+++ b/docs/cmdline-opts/noproxy.d
@@ -0,0 +1,17 @@
+Long: noproxy
+Arg: <no-proxy-list>
+Help: List of hosts which do not use proxy
+Added: 7.19.4
+Category: proxy
+Example: --noproxy "www.example" $URL
+---
+Comma-separated list of hosts for which not to use a proxy, if one is
+specified. The only wildcard is a single * character, which matches all hosts,
+and effectively disables the proxy. Each name in this list is matched as
+either a domain which contains the hostname, or the hostname itself. For
+example, local.com would match local.com, local.com:80, and www.local.com, but
+not www.notlocal.com.
+
+Since 7.53.0, This option overrides the environment variables that disable the
+proxy ('no_proxy' and 'NO_PROXY'). If there's an environment variable
+disabling a proxy, you can set the noproxy list to \&"" to override it.
diff --git a/docs/cmdline-opts/ntlm-wb.d b/docs/cmdline-opts/ntlm-wb.d
new file mode 100644
index 0000000..8901370
--- /dev/null
+++ b/docs/cmdline-opts/ntlm-wb.d
@@ -0,0 +1,9 @@
+Long: ntlm-wb
+Help: Use HTTP NTLM authentication with winbind
+Protocols: HTTP
+See-also: ntlm proxy-ntlm
+Category: auth http
+Example: --ntlm-wb -u user:password $URL
+---
+Enables NTLM much in the style --ntlm does, but hand over the authentication
+to the separate binary ntlmauth application that is executed when needed.
diff --git a/docs/cmdline-opts/ntlm.d b/docs/cmdline-opts/ntlm.d
new file mode 100644
index 0000000..5a50632
--- /dev/null
+++ b/docs/cmdline-opts/ntlm.d
@@ -0,0 +1,20 @@
+Long: ntlm
+Help: Use HTTP NTLM authentication
+Mutexed: basic negotiate digest anyauth
+See-also: proxy-ntlm
+Protocols: HTTP
+Requires: TLS
+Category: auth http
+Example: --ntlm -u user:password $URL
+---
+Enables NTLM authentication. The NTLM authentication method was designed by
+Microsoft and is used by IIS web servers. It is a proprietary protocol,
+reverse-engineered by clever people and implemented in curl based on their
+efforts. This kind of behavior should not be endorsed, you should encourage
+everyone who uses NTLM to switch to a public and documented authentication
+method instead, such as Digest.
+
+If you want to enable NTLM for your proxy authentication, then use
+--proxy-ntlm.
+
+If this option is used several times, only the first one is used.
diff --git a/docs/cmdline-opts/oauth2-bearer.d b/docs/cmdline-opts/oauth2-bearer.d
new file mode 100644
index 0000000..1662a36
--- /dev/null
+++ b/docs/cmdline-opts/oauth2-bearer.d
@@ -0,0 +1,14 @@
+Long: oauth2-bearer
+Help: OAuth 2 Bearer Token
+Arg: <token>
+Protocols: IMAP POP3 SMTP HTTP
+Category: auth
+Example: --oauth2-bearer "mF_9.B5f-4.1JqM" $URL
+---
+Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token
+is used in conjunction with the user name which can be specified as part of
+the --url or --user options.
+
+The Bearer Token and user name are formatted according to RFC 6750.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/output-dir.d b/docs/cmdline-opts/output-dir.d
new file mode 100644
index 0000000..1664f45
--- /dev/null
+++ b/docs/cmdline-opts/output-dir.d
@@ -0,0 +1,20 @@
+Long: output-dir
+Arg: <dir>
+Help: Directory to save files in
+Added: 7.73.0
+See-also: remote-name remote-header-name
+Category: curl
+Example: --output-dir "tmp" -O $URL
+---
+
+This option specifies the directory in which files should be stored, when
+--remote-name or --output are used.
+
+The given output directory is used for all URLs and output options on the
+command line, up until the first --next.
+
+If the specified target directory doesn't exist, the operation will fail
+unless --create-dirs is also used.
+
+If this option is used multiple times, the last specified directory will be
+used.
diff --git a/docs/cmdline-opts/output.d b/docs/cmdline-opts/output.d
new file mode 100644
index 0000000..ce9749d
--- /dev/null
+++ b/docs/cmdline-opts/output.d
@@ -0,0 +1,45 @@
+Long: output
+Arg: <file>
+Short: o
+Help: Write to file instead of stdout
+See-also: remote-name remote-name-all remote-header-name
+Category: important curl
+Example: -o file $URL
+Example: "http://{one,two}.example.com" -o "file_#1.txt"
+Example: "http://{site,host}.host[1-5].com" -o "#1_#2"
+Example: -o file $URL -o file2 https://example.net
+---
+Write output to <file> instead of stdout. If you are using {} or [] to fetch
+multiple documents, you should quote the URL and you can use '#' followed by a
+number in the <file> specifier. That variable will be replaced with the current
+string for the URL being fetched. Like in:
+
+ curl "http://{one,two}.example.com" -o "file_#1.txt"
+
+or use several variables like:
+
+ curl "http://{site,host}.host[1-5].com" -o "#1_#2"
+
+You may use this option as many times as the number of URLs you have. For
+example, if you specify two URLs on the same command line, you can use it like
+this:
+
+  curl -o aa example.com -o bb example.net
+
+and the order of the -o options and the URLs doesn't matter, just that the
+first -o is for the first URL and so on, so the above command line can also be
+written as
+
+  curl example.com example.net -o aa -o bb
+
+See also the --create-dirs option to create the local directories
+dynamically. Specifying the output as '-' (a single dash) will force the
+output to be done to stdout.
+
+To suppress response bodies, you can redirect output to /dev/null:
+
+  curl example.com -o /dev/null
+
+Or for Windows use nul:
+
+  curl example.com -o nul
diff --git a/docs/cmdline-opts/parallel-immediate.d b/docs/cmdline-opts/parallel-immediate.d
new file mode 100644
index 0000000..4f7468d
--- /dev/null
+++ b/docs/cmdline-opts/parallel-immediate.d
@@ -0,0 +1,14 @@
+Long: parallel-immediate
+Help: Do not wait for multiplexing (with --parallel)
+Added: 7.68.0
+See-also: parallel parallel-max
+Category: connection curl
+Example: --parallel-immediate -Z $URL -o file1 $URL -o file2
+---
+When doing parallel transfers, this option will instruct curl that it should
+rather prefer opening up more connections in parallel at once rather than
+waiting to see if new transfers can be added as multiplexed streams on another
+connection.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/parallel-max.d b/docs/cmdline-opts/parallel-max.d
new file mode 100644
index 0000000..1f22fcb
--- /dev/null
+++ b/docs/cmdline-opts/parallel-max.d
@@ -0,0 +1,15 @@
+Long: parallel-max
+Arg: <num>
+Help: Maximum concurrency for parallel transfers
+Added: 7.66.0
+See-also: parallel
+Category: connection curl
+Example: --parallel-max 100 -Z $URL ftp://example.com/
+---
+When asked to do parallel transfers, using --parallel, this option controls
+the maximum amount of transfers to do simultaneously.
+
+This option is global and does not need to be specified for each use of
+--next.
+
+The default is 50.
diff --git a/docs/cmdline-opts/parallel.d b/docs/cmdline-opts/parallel.d
new file mode 100644
index 0000000..2a0ca43
--- /dev/null
+++ b/docs/cmdline-opts/parallel.d
@@ -0,0 +1,12 @@
+Short: Z
+Long: parallel
+Help: Perform transfers in parallel
+Added: 7.66.0
+Category: connection curl
+Example: --parallel $URL -o file1 $URL -o file2
+---
+Makes curl perform its transfers in parallel as compared to the regular serial
+manner.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/pass.d b/docs/cmdline-opts/pass.d
new file mode 100644
index 0000000..58e3558
--- /dev/null
+++ b/docs/cmdline-opts/pass.d
@@ -0,0 +1,10 @@
+Long: pass
+Arg: <phrase>
+Help: Pass phrase for the private key
+Protocols: SSH TLS
+Category: ssh tls auth
+Example: --pass secret --key file $URL
+---
+Passphrase for the private key.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/path-as-is.d b/docs/cmdline-opts/path-as-is.d
new file mode 100644
index 0000000..fb87def
--- /dev/null
+++ b/docs/cmdline-opts/path-as-is.d
@@ -0,0 +1,9 @@
+Long: path-as-is
+Help: Do not squash .. sequences in URL path
+Added: 7.42.0
+Category: curl
+Example: --path-as-is https://example.com/../../etc/passwd
+---
+Tell curl to not handle sequences of /../ or /./ in the given URL
+path. Normally curl will squash or merge them according to standards but with
+this option set you tell it not to do that.
diff --git a/docs/cmdline-opts/pinnedpubkey.d b/docs/cmdline-opts/pinnedpubkey.d
new file mode 100644
index 0000000..dc98b29
--- /dev/null
+++ b/docs/cmdline-opts/pinnedpubkey.d
@@ -0,0 +1,35 @@
+Long: pinnedpubkey
+Arg: <hashes>
+Help: FILE/HASHES Public key to verify peer against
+Protocols: TLS
+Category: tls
+Example: --pinnedpubkey keyfile $URL
+Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+---
+Tells curl to use the specified public key file (or hashes) to verify the
+peer. This can be a path to a file which contains a single public key in PEM
+or DER format, or any number of base64 encoded sha256 hashes preceded by
+\'sha256//\' and separated by \';\'
+
+When negotiating a TLS or SSL connection, the server sends a certificate
+indicating its identity. A public key is extracted from this certificate and
+if it does not exactly match the public key provided to this option, curl will
+abort the connection before sending or receiving any data.
+
+PEM/DER support:
+
+7.39.0: OpenSSL, GnuTLS and GSKit
+
+7.43.0: NSS and wolfSSL
+
+7.47.0: mbedtls
+
+sha256 support:
+
+7.44.0: OpenSSL, GnuTLS, NSS and wolfSSL
+
+7.47.0: mbedtls
+
+Other SSL backends not supported.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/post301.d b/docs/cmdline-opts/post301.d
new file mode 100644
index 0000000..744ef58
--- /dev/null
+++ b/docs/cmdline-opts/post301.d
@@ -0,0 +1,13 @@
+Long: post301
+Help: Do not switch to GET after following a 301
+Protocols: HTTP
+See-also: post302 post303 location
+Added: 7.17.1
+Category: http post
+Example: --post301 --location -d "data" $URL
+---
+Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET
+requests when following a 301 redirection. The non-RFC behavior is ubiquitous
+in web browsers, so curl does the conversion by default to maintain
+consistency. However, a server may require a POST to remain a POST after such
+a redirection. This option is meaningful only when using --location.
diff --git a/docs/cmdline-opts/post302.d b/docs/cmdline-opts/post302.d
new file mode 100644
index 0000000..2c6d4b6
--- /dev/null
+++ b/docs/cmdline-opts/post302.d
@@ -0,0 +1,13 @@
+Long: post302
+Help: Do not switch to GET after following a 302
+Protocols: HTTP
+See-also: post301 post303 location
+Added: 7.19.1
+Category: http post
+Example: --post302 --location -d "data" $URL
+---
+Tells curl to respect RFC 7231/6.4.3 and not convert POST requests into GET
+requests when following a 302 redirection. The non-RFC behavior is ubiquitous
+in web browsers, so curl does the conversion by default to maintain
+consistency. However, a server may require a POST to remain a POST after such
+a redirection. This option is meaningful only when using --location.
diff --git a/docs/cmdline-opts/post303.d b/docs/cmdline-opts/post303.d
new file mode 100644
index 0000000..a2fec18
--- /dev/null
+++ b/docs/cmdline-opts/post303.d
@@ -0,0 +1,12 @@
+Long: post303
+Help: Do not switch to GET after following a 303
+Protocols: HTTP
+See-also: post302 post301 location
+Added: 7.26.0
+Category: http post
+Example: --post303 --location -d "data" $URL
+---
+Tells curl to violate RFC 7231/6.4.4 and not convert POST requests into GET
+requests when following 303 redirections. A server may require a POST to
+remain a POST after a 303 redirection. This option is meaningful only when
+using --location.
diff --git a/docs/cmdline-opts/preproxy.d b/docs/cmdline-opts/preproxy.d
new file mode 100644
index 0000000..c91565c
--- /dev/null
+++ b/docs/cmdline-opts/preproxy.d
@@ -0,0 +1,24 @@
+Long: preproxy
+Arg: [protocol://]host[:port]
+Help: Use this proxy first
+Added: 7.52.0
+Category: proxy
+Example: --preproxy socks5://proxy.example -x http://http.example $URL
+---
+Use the specified SOCKS proxy before connecting to an HTTP or HTTPS --proxy. In
+such a case curl first connects to the SOCKS proxy and then connects (through
+SOCKS) to the HTTP or HTTPS proxy. Hence pre proxy.
+
+The pre proxy string should be specified with a protocol:// prefix to specify
+alternative proxy protocols. Use socks4://, socks4a://, socks5:// or
+socks5h:// to request the specific SOCKS version to be used. No protocol
+specified will make curl default to SOCKS4.
+
+If the port number is not specified in the proxy string, it is assumed to be
+1080.
+
+User and password that might be provided in the proxy string are URL decoded
+by curl. This allows you to pass in special characters such as @ by using %40
+or pass in a colon with %3a.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/progress-bar.d b/docs/cmdline-opts/progress-bar.d
new file mode 100644
index 0000000..96ac300
--- /dev/null
+++ b/docs/cmdline-opts/progress-bar.d
@@ -0,0 +1,17 @@
+Short: #
+Long: progress-bar
+Help: Display transfer progress as a bar
+Category: verbose
+Example: -# -O $URL
+---
+Make curl display transfer progress as a simple progress bar instead of the
+standard, more informational, meter.
+
+This progress bar draws a single line of '#' characters across the screen and
+shows a percentage if the transfer size is known. For transfers without a
+known size, there will be space ship (-=o=-) that moves back and forth but
+only while data is being transferred, with a set of flying hash sign symbols on
+top.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/proto-default.d b/docs/cmdline-opts/proto-default.d
new file mode 100644
index 0000000..a659b84
--- /dev/null
+++ b/docs/cmdline-opts/proto-default.d
@@ -0,0 +1,16 @@
+Long: proto-default
+Help: Use PROTOCOL for any URL missing a scheme
+Arg: <protocol>
+Added: 7.45.0
+Category: connection curl
+Example: --proto-default https ftp.example.com
+---
+Tells curl to use *protocol* for any URL missing a scheme name.
+
+An unknown or unsupported protocol causes error
+*CURLE_UNSUPPORTED_PROTOCOL* (1).
+
+This option does not change the default proxy protocol (http).
+
+Without this option set, curl guesses protocol based on the host name, see
+--url for details.
diff --git a/docs/cmdline-opts/proto-redir.d b/docs/cmdline-opts/proto-redir.d
new file mode 100644
index 0000000..81d495d
--- /dev/null
+++ b/docs/cmdline-opts/proto-redir.d
@@ -0,0 +1,20 @@
+Long: proto-redir
+Arg: <protocols>
+Help: Enable/disable PROTOCOLS on redirect
+Added: 7.20.2
+Category: connection curl
+Example: --proto-redir =http,https $URL
+---
+Tells curl to limit what protocols it may use on redirect. Protocols denied by
+--proto are not overridden by this option. See --proto for how protocols are
+represented.
+
+Example, allow only HTTP and HTTPS on redirect:
+
+ curl --proto-redir -all,http,https http://example.com
+
+By default curl will allow HTTP, HTTPS, FTP and FTPS on redirect (7.65.2).
+Older versions of curl allowed all protocols on redirect except several
+disabled for security reasons: Since 7.19.4 FILE and SCP are disabled, and
+since 7.40.0 SMB and SMBS are also disabled. Specifying *all* or *+all*
+enables all protocols on redirect, including those disabled for security.
diff --git a/docs/cmdline-opts/proto.d b/docs/cmdline-opts/proto.d
new file mode 100644
index 0000000..6ff52c4
--- /dev/null
+++ b/docs/cmdline-opts/proto.d
@@ -0,0 +1,45 @@
+Long: proto
+Arg: <protocols>
+Help: Enable/disable PROTOCOLS
+See-also: proto-redir proto-default
+Added: 7.20.2
+Category: connection curl
+Example: --proto =http,https,sftp $URL
+---
+Tells curl to limit what protocols it may use for transfers. Protocols are
+evaluated left to right, are comma separated, and are each a protocol name or
+\&'all', optionally prefixed by zero or more modifiers. Available modifiers are:
+.RS
+.TP 3
+.B +
+Permit this protocol in addition to protocols already permitted (this is
+the default if no modifier is used).
+.TP
+.B -
+Deny this protocol, removing it from the list of protocols already permitted.
+.TP
+.B =
+Permit only this protocol (ignoring the list already permitted), though
+subject to later modification by subsequent entries in the comma separated
+list.
+.RE
+.IP
+For example:
+.RS
+.TP 15
+.B --proto -ftps
+uses the default protocols, but disables ftps
+.TP
+.B  --proto -all,https,+http
+only enables http and https
+.TP
+.B --proto =http,https
+also only enables http and https
+.RE
+.IP
+Unknown protocols produce a warning. This allows scripts to safely rely on
+being able to disable potentially dangerous protocols, without relying upon
+support for that protocol being built into curl to avoid an error.
+
+This option can be used multiple times, in which case the effect is the same
+as concatenating the protocols into one instance of the option.
diff --git a/docs/cmdline-opts/proxy-anyauth.d b/docs/cmdline-opts/proxy-anyauth.d
new file mode 100644
index 0000000..80f2b97
--- /dev/null
+++ b/docs/cmdline-opts/proxy-anyauth.d
@@ -0,0 +1,9 @@
+Long: proxy-anyauth
+Help: Pick any proxy authentication method
+Added: 7.13.2
+See-also: proxy proxy-basic proxy-digest
+Category: proxy auth
+Example: --proxy-anyauth --proxy-user user:passwd -x proxy $URL
+---
+Tells curl to pick a suitable authentication method when communicating with
+the given HTTP proxy. This might cause an extra request/response round-trip.
diff --git a/docs/cmdline-opts/proxy-basic.d b/docs/cmdline-opts/proxy-basic.d
new file mode 100644
index 0000000..6d38c73
--- /dev/null
+++ b/docs/cmdline-opts/proxy-basic.d
@@ -0,0 +1,9 @@
+Long: proxy-basic
+Help: Use Basic authentication on the proxy
+See-also: proxy proxy-anyauth proxy-digest
+Category: proxy auth
+Example: --proxy-basic --proxy-user user:passwd -x proxy $URL
+---
+Tells curl to use HTTP Basic authentication when communicating with the given
+proxy. Use --basic for enabling HTTP Basic with a remote host. Basic is the
+default authentication method curl uses with proxies.
diff --git a/docs/cmdline-opts/proxy-cacert.d b/docs/cmdline-opts/proxy-cacert.d
new file mode 100644
index 0000000..5c32944
--- /dev/null
+++ b/docs/cmdline-opts/proxy-cacert.d
@@ -0,0 +1,9 @@
+Long: proxy-cacert
+Help: CA certificate to verify peer against for proxy
+Arg: <file>
+Added: 7.52.0
+See-also: proxy-capath cacert capath proxy
+Category: proxy tls
+Example: --proxy-cacert CA-file.txt -x https://proxy $URL
+---
+Same as --cacert but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-capath.d b/docs/cmdline-opts/proxy-capath.d
new file mode 100644
index 0000000..0429984
--- /dev/null
+++ b/docs/cmdline-opts/proxy-capath.d
@@ -0,0 +1,9 @@
+Long: proxy-capath
+Help: CA directory to verify peer against for proxy
+Arg: <dir>
+Added: 7.52.0
+See-also: proxy-cacert proxy capath
+Category: proxy tls
+Example: --proxy-capath /local/directory -x https://proxy $URL
+---
+Same as --capath but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-cert-type.d b/docs/cmdline-opts/proxy-cert-type.d
new file mode 100644
index 0000000..2152f53
--- /dev/null
+++ b/docs/cmdline-opts/proxy-cert-type.d
@@ -0,0 +1,8 @@
+Long: proxy-cert-type
+Arg: <type>
+Added: 7.52.0
+Help: Client certificate type for HTTPS proxy
+Category: proxy tls
+Example: --proxy-cert-type PEM --proxy-cert file -x https://proxy $URL
+---
+Same as --cert-type but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-cert.d b/docs/cmdline-opts/proxy-cert.d
new file mode 100644
index 0000000..3cf54b7
--- /dev/null
+++ b/docs/cmdline-opts/proxy-cert.d
@@ -0,0 +1,8 @@
+Long: proxy-cert
+Arg: <cert[:passwd]>
+Help: Set client certificate for proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-cert file -x https://proxy $URL
+---
+Same as --cert but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-ciphers.d b/docs/cmdline-opts/proxy-ciphers.d
new file mode 100644
index 0000000..b4c3580
--- /dev/null
+++ b/docs/cmdline-opts/proxy-ciphers.d
@@ -0,0 +1,8 @@
+Long: proxy-ciphers
+Arg: <list>
+Help: SSL ciphers to use for proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy $URL
+---
+Same as --ciphers but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-crlfile.d b/docs/cmdline-opts/proxy-crlfile.d
new file mode 100644
index 0000000..1ac1999
--- /dev/null
+++ b/docs/cmdline-opts/proxy-crlfile.d
@@ -0,0 +1,8 @@
+Long: proxy-crlfile
+Arg: <file>
+Help: Set a CRL list for proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-crlfile rejects.txt -x https://proxy $URL
+---
+Same as --crlfile but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-digest.d b/docs/cmdline-opts/proxy-digest.d
new file mode 100644
index 0000000..cc18702
--- /dev/null
+++ b/docs/cmdline-opts/proxy-digest.d
@@ -0,0 +1,8 @@
+Long: proxy-digest
+Help: Use Digest authentication on the proxy
+See-also: proxy proxy-anyauth proxy-basic
+Category: proxy tls
+Example: --proxy-digest --proxy-user user:passwd -x proxy $URL
+---
+Tells curl to use HTTP Digest authentication when communicating with the given
+proxy. Use --digest for enabling HTTP Digest with a remote host.
diff --git a/docs/cmdline-opts/proxy-header.d b/docs/cmdline-opts/proxy-header.d
new file mode 100644
index 0000000..273a773
--- /dev/null
+++ b/docs/cmdline-opts/proxy-header.d
@@ -0,0 +1,28 @@
+Long: proxy-header
+Arg: <header/@file>
+Help: Pass custom header(s) to proxy
+Protocols: HTTP
+Added: 7.37.0
+Category: proxy
+Example: --proxy-header "X-First-Name: Joe" -x http://proxy $URL
+Example: --proxy-header "User-Agent: surprise" -x http://proxy $URL
+Example: --proxy-header "Host:" -x http://proxy $URL
+---
+Extra header to include in the request when sending HTTP to a proxy. You may
+specify any number of extra headers. This is the equivalent option to --header
+but is for proxy communication only like in CONNECT requests when you want a
+separate header sent to the proxy to what is sent to the actual remote host.
+
+curl will make sure that each header you add/replace is sent with the proper
+end-of-line marker, you should thus **not** add that as a part of the header
+content: do not add newlines or carriage returns, they will only mess things
+up for you.
+
+Headers specified with this option will not be included in requests that curl
+knows will not be sent to a proxy.
+
+Starting in 7.55.0, this option can take an argument in @filename style, which
+then adds a header for each line in the input file. Using @- will make curl
+read the header file from stdin.
+
+This option can be used multiple times to add/replace/remove multiple headers.
diff --git a/docs/cmdline-opts/proxy-insecure.d b/docs/cmdline-opts/proxy-insecure.d
new file mode 100644
index 0000000..3f4f7c1
--- /dev/null
+++ b/docs/cmdline-opts/proxy-insecure.d
@@ -0,0 +1,7 @@
+Long: proxy-insecure
+Help: Do HTTPS proxy connections without verifying the proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-insecure -x https://proxy $URL
+---
+Same as --insecure but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-key-type.d b/docs/cmdline-opts/proxy-key-type.d
new file mode 100644
index 0000000..31f47af
--- /dev/null
+++ b/docs/cmdline-opts/proxy-key-type.d
@@ -0,0 +1,8 @@
+Long: proxy-key-type
+Arg: <type>
+Help: Private key file type for proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-key-type DER --proxy-key here -x https://proxy $URL
+---
+Same as --key-type but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-key.d b/docs/cmdline-opts/proxy-key.d
new file mode 100644
index 0000000..1b97973
--- /dev/null
+++ b/docs/cmdline-opts/proxy-key.d
@@ -0,0 +1,7 @@
+Long: proxy-key
+Help: Private key for HTTPS proxy
+Arg: <key>
+Category: proxy tls
+Example: --proxy-key here -x https://proxy $URL
+---
+Same as --key but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-negotiate.d b/docs/cmdline-opts/proxy-negotiate.d
new file mode 100644
index 0000000..5085a7c
--- /dev/null
+++ b/docs/cmdline-opts/proxy-negotiate.d
@@ -0,0 +1,10 @@
+Long: proxy-negotiate
+Help: Use HTTP Negotiate (SPNEGO) authentication on the proxy
+Added: 7.17.1
+See-also: proxy-anyauth proxy-basic
+Category: proxy auth
+Example: --proxy-negotiate --proxy-user user:passwd -x proxy $URL
+---
+Tells curl to use HTTP Negotiate (SPNEGO) authentication when communicating
+with the given proxy. Use --negotiate for enabling HTTP Negotiate (SPNEGO)
+with a remote host.
diff --git a/docs/cmdline-opts/proxy-ntlm.d b/docs/cmdline-opts/proxy-ntlm.d
new file mode 100644
index 0000000..074b7df
--- /dev/null
+++ b/docs/cmdline-opts/proxy-ntlm.d
@@ -0,0 +1,8 @@
+Long: proxy-ntlm
+Help: Use NTLM authentication on the proxy
+See-also: proxy-negotiate proxy-anyauth
+Category: proxy auth
+Example: --proxy-ntlm --proxy-user user:passwd -x http://proxy $URL
+---
+Tells curl to use HTTP NTLM authentication when communicating with the given
+proxy. Use --ntlm for enabling NTLM with a remote host.
diff --git a/docs/cmdline-opts/proxy-pass.d b/docs/cmdline-opts/proxy-pass.d
new file mode 100644
index 0000000..b714684
--- /dev/null
+++ b/docs/cmdline-opts/proxy-pass.d
@@ -0,0 +1,8 @@
+Long: proxy-pass
+Arg: <phrase>
+Help: Pass phrase for the private key for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls auth
+Example: --proxy-pass secret --proxy-key here -x https://proxy $URL
+---
+Same as --pass but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-pinnedpubkey.d b/docs/cmdline-opts/proxy-pinnedpubkey.d
new file mode 100644
index 0000000..b7f50a7
--- /dev/null
+++ b/docs/cmdline-opts/proxy-pinnedpubkey.d
@@ -0,0 +1,19 @@
+Long: proxy-pinnedpubkey
+Arg: <hashes>
+Help: FILE/HASHES public key to verify proxy with
+Protocols: TLS
+Category: proxy tls
+Example: --proxy-pinnedpubkey keyfile $URL
+Example: --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+---
+Tells curl to use the specified public key file (or hashes) to verify the
+proxy. This can be a path to a file which contains a single public key in PEM
+or DER format, or any number of base64 encoded sha256 hashes preceded by
+\'sha256//\' and separated by \';\'
+
+When negotiating a TLS or SSL connection, the server sends a certificate
+indicating its identity. A public key is extracted from this certificate and
+if it does not exactly match the public key provided to this option, curl will
+abort the connection before sending or receiving any data.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/proxy-service-name.d b/docs/cmdline-opts/proxy-service-name.d
new file mode 100644
index 0000000..fbed175
--- /dev/null
+++ b/docs/cmdline-opts/proxy-service-name.d
@@ -0,0 +1,8 @@
+Long: proxy-service-name
+Arg: <name>
+Help: SPNEGO proxy service name
+Added: 7.43.0
+Category: proxy tls
+Example: --proxy-service-name "shrubbery" -x proxy $URL
+---
+This option allows you to change the service name for proxy negotiation.
diff --git a/docs/cmdline-opts/proxy-ssl-allow-beast.d b/docs/cmdline-opts/proxy-ssl-allow-beast.d
new file mode 100644
index 0000000..b3e701f
--- /dev/null
+++ b/docs/cmdline-opts/proxy-ssl-allow-beast.d
@@ -0,0 +1,7 @@
+Long: proxy-ssl-allow-beast
+Help: Allow security flaw for interop for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls
+Example: --proxy-ssl-allow-beast -x https://proxy $URL
+---
+Same as --ssl-allow-beast but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-ssl-auto-client-cert.d b/docs/cmdline-opts/proxy-ssl-auto-client-cert.d
new file mode 100644
index 0000000..7c071d7
--- /dev/null
+++ b/docs/cmdline-opts/proxy-ssl-auto-client-cert.d
@@ -0,0 +1,7 @@
+Long: proxy-ssl-auto-client-cert
+Help: Use auto client certificate for proxy (Schannel)
+Added: 7.77.0
+Category: proxy tls
+Example: --proxy-ssl-auto-client-cert -x https://proxy $URL
+---
+Same as --ssl-auto-client-cert but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-tls13-ciphers.d b/docs/cmdline-opts/proxy-tls13-ciphers.d
new file mode 100644
index 0000000..62578f7
--- /dev/null
+++ b/docs/cmdline-opts/proxy-tls13-ciphers.d
@@ -0,0 +1,18 @@
+Long: proxy-tls13-ciphers
+Arg: <ciphersuite list>
+help: TLS 1.3 proxy cipher suites
+Protocols: TLS
+Category: proxy tls
+Example: --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy $URL
+---
+Specifies which cipher suites to use in the connection to your HTTPS proxy
+when it negotiates TLS 1.3. The list of ciphers suites must specify valid
+ciphers. Read up on TLS 1.3 cipher suite details on this URL:
+
+ https://curl.se/docs/ssl-ciphers.html
+
+This option is currently used only when curl is built to use OpenSSL 1.1.1 or
+later. If you are using a different SSL backend you can try setting TLS 1.3
+cipher suites by using the --proxy-ciphers option.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/proxy-tlsauthtype.d b/docs/cmdline-opts/proxy-tlsauthtype.d
new file mode 100644
index 0000000..c00928e
--- /dev/null
+++ b/docs/cmdline-opts/proxy-tlsauthtype.d
@@ -0,0 +1,8 @@
+Long: proxy-tlsauthtype
+Arg: <type>
+Help: TLS authentication type for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls auth
+Example: --proxy-tlsauthtype SRP -x https://proxy $URL
+---
+Same as --tlsauthtype but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-tlspassword.d b/docs/cmdline-opts/proxy-tlspassword.d
new file mode 100644
index 0000000..89b551d
--- /dev/null
+++ b/docs/cmdline-opts/proxy-tlspassword.d
@@ -0,0 +1,8 @@
+Long: proxy-tlspassword
+Arg: <string>
+Help: TLS password for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls auth
+Example: --proxy-tlspassword passwd -x https://proxy $URL
+---
+Same as --tlspassword but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-tlsuser.d b/docs/cmdline-opts/proxy-tlsuser.d
new file mode 100644
index 0000000..b3c400e
--- /dev/null
+++ b/docs/cmdline-opts/proxy-tlsuser.d
@@ -0,0 +1,8 @@
+Long: proxy-tlsuser
+Arg: <name>
+Help: TLS username for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls auth
+Example: --proxy-tlsuser smith -x https://proxy $URL
+---
+Same as --tlsuser but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-tlsv1.d b/docs/cmdline-opts/proxy-tlsv1.d
new file mode 100644
index 0000000..c54782e
--- /dev/null
+++ b/docs/cmdline-opts/proxy-tlsv1.d
@@ -0,0 +1,7 @@
+Long: proxy-tlsv1
+Help: Use TLSv1 for HTTPS proxy
+Added: 7.52.0
+Category: proxy tls auth
+Example: --proxy-tlsv1 -x https://proxy $URL
+---
+Same as --tlsv1 but used in HTTPS proxy context.
diff --git a/docs/cmdline-opts/proxy-user.d b/docs/cmdline-opts/proxy-user.d
new file mode 100644
index 0000000..81d29f2
--- /dev/null
+++ b/docs/cmdline-opts/proxy-user.d
@@ -0,0 +1,20 @@
+Long: proxy-user
+Short: U
+Arg: <user:password>
+Help: Proxy user and password
+Category: proxy auth
+Example: --proxy-user name:pwd -x proxy $URL
+---
+Specify the user name and password to use for proxy authentication.
+
+If you use a Windows SSPI-enabled curl binary and do either Negotiate or NTLM
+authentication then you can tell curl to select the user name and password
+from your environment by specifying a single colon with this option: "-U :".
+
+On systems where it works, curl will hide the given option argument from
+process listings. This is not enough to protect credentials from possibly
+getting seen by other users on the same system as they will still be visible
+for a brief moment before cleared. Such sensitive data should be retrieved
+from a file instead or similar and never used in clear text in a command line.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/proxy.d b/docs/cmdline-opts/proxy.d
new file mode 100644
index 0000000..81d9bc9
--- /dev/null
+++ b/docs/cmdline-opts/proxy.d
@@ -0,0 +1,41 @@
+Long: proxy
+Short: x
+Arg: [protocol://]host[:port]
+Help: Use this proxy
+Category: proxy
+Example: --proxy http://proxy.example $URL
+---
+Use the specified proxy.
+
+The proxy string can be specified with a protocol:// prefix. No protocol
+specified or http:// will be treated as HTTP proxy. Use socks4://, socks4a://,
+socks5:// or socks5h:// to request a specific SOCKS version to be used.
+(The protocol support was added in curl 7.21.7)
+
+HTTPS proxy support via https:// protocol prefix was added in 7.52.0 for
+OpenSSL, GnuTLS and NSS.
+
+Unrecognized and unsupported proxy protocols cause an error since 7.52.0.
+Prior versions may ignore the protocol and use http:// instead.
+
+If the port number is not specified in the proxy string, it is assumed to be
+1080.
+
+This option overrides existing environment variables that set the proxy to
+use. If there's an environment variable setting a proxy, you can set proxy to
+\&"" to override it.
+
+All operations that are performed over an HTTP proxy will transparently be
+converted to HTTP. It means that certain protocol specific operations might
+not be available. This is not the case if you can tunnel through the proxy, as
+one with the --proxytunnel option.
+
+User and password that might be provided in the proxy string are URL decoded
+by curl. This allows you to pass in special characters such as @ by using %40
+or pass in a colon with %3a.
+
+The proxy host can be specified the exact same way as the proxy environment
+variables, including the protocol prefix (http://) and the embedded user +
+password.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/proxy1.0.d b/docs/cmdline-opts/proxy1.0.d
new file mode 100644
index 0000000..f748345
--- /dev/null
+++ b/docs/cmdline-opts/proxy1.0.d
@@ -0,0 +1,12 @@
+Long: proxy1.0
+Arg: <host[:port]>
+Help: Use HTTP/1.0 proxy on given port
+Category: proxy
+Example: --proxy1.0 -x http://proxy $URL
+---
+Use the specified HTTP 1.0 proxy. If the port number is not specified, it is
+assumed at port 1080.
+
+The only difference between this and the HTTP proxy option --proxy, is that
+attempts to use CONNECT through the proxy will specify an HTTP 1.0 protocol
+instead of the default HTTP 1.1.
diff --git a/docs/cmdline-opts/proxytunnel.d b/docs/cmdline-opts/proxytunnel.d
new file mode 100644
index 0000000..712c755
--- /dev/null
+++ b/docs/cmdline-opts/proxytunnel.d
@@ -0,0 +1,14 @@
+Long: proxytunnel
+Short: p
+Help: Operate through an HTTP proxy tunnel (using CONNECT)
+See-also: proxy
+Category: proxy
+Example: --proxytunnel -x http://proxy $URL
+---
+When an HTTP proxy is used --proxy, this option will make curl tunnel through
+the proxy. The tunnel approach is made with the HTTP proxy CONNECT request and
+requires that the proxy allows direct connect to the remote port number curl
+wants to tunnel through to.
+
+To suppress proxy CONNECT response headers when curl is set to output headers
+use --suppress-connect-headers.
diff --git a/docs/cmdline-opts/pubkey.d b/docs/cmdline-opts/pubkey.d
new file mode 100644
index 0000000..c1fb5d8
--- /dev/null
+++ b/docs/cmdline-opts/pubkey.d
@@ -0,0 +1,16 @@
+Long: pubkey
+Arg: <key>
+Protocols: SFTP SCP
+Help: SSH Public key file name
+Category: sftp scp auth
+Example: --pubkey file.pub sftp://example.com/
+---
+Public key file name. Allows you to provide your public key in this separate
+file.
+
+If this option is used several times, the last one will be used.
+
+(As of 7.39.0, curl attempts to automatically extract the public key from the
+private key file, so passing this option is generally not required. Note that
+this public key extraction requires libcurl to be linked against a copy of
+libssh2 1.2.8 or higher that is itself linked against OpenSSL.)
diff --git a/docs/cmdline-opts/quote.d b/docs/cmdline-opts/quote.d
new file mode 100644
index 0000000..2707c87
--- /dev/null
+++ b/docs/cmdline-opts/quote.d
@@ -0,0 +1,68 @@
+Long: quote
+Arg: <command>
+Short: Q
+Help: Send command(s) to server before transfer
+Protocols: FTP SFTP
+Category: ftp sftp
+Example: --quote "DELE file" ftp://example.com/foo
+---
+Send an arbitrary command to the remote FTP or SFTP server. Quote commands are
+sent BEFORE the transfer takes place (just after the initial PWD command in an
+FTP transfer, to be exact). To make commands take place after a successful
+transfer, prefix them with a dash '-'.  To make commands be sent after curl
+has changed the working directory, just before the transfer command(s), prefix
+the command with a '+' (this is only supported for FTP). You may specify any
+number of commands.
+
+By default curl will stop at first failure. To make curl continue even if the
+command fails, prefix the command with an asterisk (*). Otherwise, if the
+server returns failure for one of the commands, the entire operation will be
+aborted.
+
+You must send syntactically correct FTP commands as RFC 959 defines to FTP
+servers, or one of the commands listed below to SFTP servers.
+
+This option can be used multiple times.
+
+SFTP is a binary protocol. Unlike for FTP, curl interprets SFTP quote commands
+itself before sending them to the server.  File names may be quoted
+shell-style to embed spaces or special characters.  Following is the list of
+all supported SFTP quote commands:
+.RS
+.IP "atime date file"
+The atime command sets the last access time of the file named by the file
+operand. The <date expression> can be all sorts of date strings, see the
+*curl_getdate(3)* man page for date expression details. (Added in 7.73.0)
+.IP "chgrp group file"
+The chgrp command sets the group ID of the file named by the file operand to
+the group ID specified by the group operand. The group operand is a decimal
+integer group ID.
+.IP "chmod mode file"
+The chmod command modifies the file mode bits of the specified file. The
+mode operand is an octal integer mode number.
+.IP "chown user file"
+The chown command sets the owner of the file named by the file operand to the
+user ID specified by the user operand. The user operand is a decimal
+integer user ID.
+.IP "ln source_file target_file"
+The ln and symlink commands create a symbolic link at the target_file location
+pointing to the source_file location.
+.IP "mkdir directory_name"
+The mkdir command creates the directory named by the directory_name operand.
+.IP "mtime date file"
+The mtime command sets the last modification time of the file named by the
+file operand. The <date expression> can be all sorts of date strings, see the
+*curl_getdate(3)* man page for date expression details. (Added in 7.73.0)
+.IP "pwd"
+The pwd command returns the absolute pathname of the current working directory.
+.IP "rename source target"
+The rename command renames the file or directory named by the source
+operand to the destination path named by the target operand.
+.IP "rm file"
+The rm command removes the file specified by the file operand.
+.IP "rmdir directory"
+The rmdir command removes the directory entry specified by the directory
+operand, provided it is empty.
+.IP "symlink source_file target_file"
+See ln.
+.RE
diff --git a/docs/cmdline-opts/random-file.d b/docs/cmdline-opts/random-file.d
new file mode 100644
index 0000000..a207c1e
--- /dev/null
+++ b/docs/cmdline-opts/random-file.d
@@ -0,0 +1,9 @@
+Long: random-file
+Arg: <file>
+Help: File for reading random data from
+Category: misc
+Example: --random-file rubbish $URL
+---
+Specify the path name to file containing what will be considered as random
+data. The data may be used to seed the random engine for SSL connections.  See
+also the --egd-file option.
diff --git a/docs/cmdline-opts/range.d b/docs/cmdline-opts/range.d
new file mode 100644
index 0000000..0637f8f
--- /dev/null
+++ b/docs/cmdline-opts/range.d
@@ -0,0 +1,49 @@
+Long: range
+Short: r
+Help: Retrieve only the bytes within RANGE
+Arg: <range>
+Protocols: HTTP FTP SFTP FILE
+Category: http ftp sftp file
+Example: --range 22-44 $URL
+---
+Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP
+server or a local FILE. Ranges can be specified in a number of ways.
+.RS
+.TP 10
+.B 0-499
+specifies the first 500 bytes
+.TP
+.B 500-999
+specifies the second 500 bytes
+.TP
+.B -500
+specifies the last 500 bytes
+.TP
+.B 9500-
+specifies the bytes from offset 9500 and forward
+.TP
+.B 0-0,-1
+specifies the first and last byte only(*)(HTTP)
+.TP
+.B 100-199,500-599
+specifies two separate 100-byte ranges(*) (HTTP)
+.RE
+.IP
+(*) = NOTE that this will cause the server to reply with a multipart
+response, which will be returned as-is by curl! Parsing or otherwise
+transforming this response is the responsibility of the caller.
+
+Only digit characters (0-9) are valid in the 'start' and 'stop' fields of the
+\&'start-stop' range syntax. If a non-digit character is given in the range,
+the server's response will be unspecified, depending on the server's
+configuration.
+
+You should also be aware that many HTTP/1.1 servers do not have this feature
+enabled, so that when you attempt to get a range, you'll instead get the whole
+document.
+
+FTP and SFTP range downloads only support the simple 'start-stop' syntax
+(optionally with one of the numbers omitted). FTP use depends on the extended
+FTP command SIZE.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/raw.d b/docs/cmdline-opts/raw.d
new file mode 100644
index 0000000..c44d33f
--- /dev/null
+++ b/docs/cmdline-opts/raw.d
@@ -0,0 +1,9 @@
+Long: raw
+Help: Do HTTP "raw"; no transfer decoding
+Added: 7.16.2
+Protocols: HTTP
+Category: http
+Example: --raw $URL
+---
+When used, it disables all internal HTTP decoding of content or transfer
+encodings and instead makes them passed on unaltered, raw.
diff --git a/docs/cmdline-opts/referer.d b/docs/cmdline-opts/referer.d
new file mode 100644
index 0000000..3f6b7c7
--- /dev/null
+++ b/docs/cmdline-opts/referer.d
@@ -0,0 +1,18 @@
+Long: referer
+Short: e
+Arg: <URL>
+Protocols: HTTP
+Help: Referrer URL
+See-also: user-agent header
+Category: http
+Example: --referer "https://fake.example" $URL
+Example: --referer "https://fake.example;auto" -L $URL
+Example: --referer ";auto" -L $URL
+---
+Sends the "Referrer Page" information to the HTTP server. This can also be set
+with the --header flag of course.  When used with --location you can append
+";auto" to the --referer URL to make curl automatically set the previous URL
+when it follows a Location: header. The \&";auto" string can be used alone,
+even if you don't set an initial --referer.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/remote-header-name.d b/docs/cmdline-opts/remote-header-name.d
new file mode 100644
index 0000000..6e0b98b
--- /dev/null
+++ b/docs/cmdline-opts/remote-header-name.d
@@ -0,0 +1,21 @@
+Long: remote-header-name
+Short: J
+Protocols: HTTP
+Help: Use the header-provided filename
+Category: output
+Example: -OJ https://example.com/file
+---
+This option tells the --remote-name option to use the server-specified
+Content-Disposition filename instead of extracting a filename from the URL.
+
+If the server specifies a file name and a file with that name already exists
+in the current working directory it will not be overwritten and an error will
+occur. If the server doesn't specify a file name then this option has no
+effect.
+
+There's no attempt to decode %-sequences (yet) in the provided file name, so
+this option may provide you with rather unexpected file names.
+
+**WARNING**: Exercise judicious use of this option, especially on Windows. A
+rogue server could send you the name of a DLL or other file that could possibly
+be loaded automatically by Windows or some third party software.
diff --git a/docs/cmdline-opts/remote-name-all.d b/docs/cmdline-opts/remote-name-all.d
new file mode 100644
index 0000000..e27bd5f
--- /dev/null
+++ b/docs/cmdline-opts/remote-name-all.d
@@ -0,0 +1,10 @@
+Long: remote-name-all
+Help: Use the remote file name for all URLs
+Added: 7.19.0
+Category: output
+Example: --remote-name-all ftp://example.com/file1 ftp://example.com/file2
+---
+This option changes the default action for all given URLs to be dealt with as
+if --remote-name were used for each one. So if you want to disable that for a
+specific URL after --remote-name-all has been used, you must use "-o -" or
+--no-remote-name.
diff --git a/docs/cmdline-opts/remote-name.d b/docs/cmdline-opts/remote-name.d
new file mode 100644
index 0000000..6892879
--- /dev/null
+++ b/docs/cmdline-opts/remote-name.d
@@ -0,0 +1,23 @@
+Long: remote-name
+Short: O
+Help: Write output to a file named as the remote file
+Category: important output
+Example: -O https://example.com/filename
+---
+Write output to a local file named like the remote file we get. (Only the file
+part of the remote file is used, the path is cut off.)
+
+The file will be saved in the current working directory. If you want the file
+saved in a different directory, make sure you change the current working
+directory before invoking curl with this option.
+
+The remote file name to use for saving is extracted from the given URL,
+nothing else, and if it already exists it will be overwritten. If you want the
+server to be able to choose the file name refer to --remote-header-name which
+can be used in addition to this option. If the server chooses a file name and
+that name already exists it will not be overwritten.
+
+There is no URL decoding done on the file name. If it has %20 or other URL
+encoded parts of the name, they will end up as-is as file name.
+
+You may use this option as many times as the number of URLs you have.
diff --git a/docs/cmdline-opts/remote-time.d b/docs/cmdline-opts/remote-time.d
new file mode 100644
index 0000000..9c463ae
--- /dev/null
+++ b/docs/cmdline-opts/remote-time.d
@@ -0,0 +1,9 @@
+Long: remote-time
+Short: R
+Help: Set the remote file's time on the local output
+Category: output
+Example: --remote-time -o foo $URL
+---
+When used, this will make curl attempt to figure out the timestamp of the
+remote file, and if that is available make the local file get that same
+timestamp.
diff --git a/docs/cmdline-opts/request-target.d b/docs/cmdline-opts/request-target.d
new file mode 100644
index 0000000..5f9e475
--- /dev/null
+++ b/docs/cmdline-opts/request-target.d
@@ -0,0 +1,12 @@
+Long: request-target
+Arg: <path>
+Help: Specify the target for this request
+Protocols: HTTP
+Added: 7.55.0
+Category: http
+Example: --request-target "*" -X OPTIONS $URL
+---
+Tells curl to use an alternative "target" (path) instead of using the path as
+provided in the URL. Particularly useful when wanting to issue HTTP requests
+without leading slash or other data that doesn't follow the regular URL
+pattern, like "OPTIONS *".
diff --git a/docs/cmdline-opts/request.d b/docs/cmdline-opts/request.d
new file mode 100644
index 0000000..0db0bc9
--- /dev/null
+++ b/docs/cmdline-opts/request.d
@@ -0,0 +1,42 @@
+Long: request
+Short: X
+Arg: <command>
+Help: Specify request command to use
+Category: connection
+Example: -X "DELETE" $URL
+Example: -X NLST ftp://example.com/
+---
+(HTTP) Specifies a custom request method to use when communicating with the
+HTTP server.  The specified request method will be used instead of the method
+otherwise used (which defaults to GET). Read the HTTP 1.1 specification for
+details and explanations. Common additional HTTP requests include PUT and
+DELETE, but related technologies like WebDAV offers PROPFIND, COPY, MOVE and
+more.
+
+Normally you don't need this option. All sorts of GET, HEAD, POST and PUT
+requests are rather invoked by using dedicated command line options.
+
+This option only changes the actual word used in the HTTP request, it does not
+alter the way curl behaves. So for example if you want to make a proper HEAD
+request, using -X HEAD will not suffice. You need to use the --head option.
+
+The method string you set with --request will be used for all requests, which
+if you for example use --location may cause unintended side-effects when curl
+doesn't change request method according to the HTTP 30x response codes - and
+similar.
+
+(FTP)
+Specifies a custom FTP command to use instead of LIST when doing file lists
+with FTP.
+
+(POP3)
+Specifies a custom POP3 command to use instead of LIST or RETR. (Added in
+7.26.0)
+
+(IMAP)
+Specifies a custom IMAP command to use instead of LIST. (Added in 7.30.0)
+
+(SMTP)
+Specifies a custom SMTP command to use instead of HELP or VRFY. (Added in 7.34.0)
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/resolve.d b/docs/cmdline-opts/resolve.d
new file mode 100644
index 0000000..6464c42
--- /dev/null
+++ b/docs/cmdline-opts/resolve.d
@@ -0,0 +1,37 @@
+Long: resolve
+Arg: <[+]host:port:addr[,addr]...>
+Help: Resolve the host+port to this address
+Added: 7.21.3
+Category: connection
+Example: --resolve example.com:443:127.0.0.1 $URL
+---
+Provide a custom address for a specific host and port pair. Using this, you
+can make the curl requests(s) use a specified address and prevent the
+otherwise normally resolved address to be used. Consider it a sort of
+/etc/hosts alternative provided on the command line. The port number should be
+the number used for the specific protocol the host will be used for. It means
+you need several entries if you want to provide address for the same host but
+different ports.
+
+By specifying '*' as host you can tell curl to resolve any host and specific
+port pair to the specified address. Wildcard is resolved last so any --resolve
+with a specific host and port will be used first.
+
+The provided address set by this option will be used even if --ipv4 or --ipv6
+is set to make curl use another IP version.
+
+By prefixing the host with a '+' you can make the entry time out after curl's
+default timeout (1 minute). Note that this will only make sense for long
+running parallel transfers with a lot of files. In such cases, if this option
+is used curl will try to resolve the host as it normally would once the
+timeout has expired.
+
+Support for providing the IP address within [brackets] was added in 7.57.0.
+
+Support for providing multiple IP addresses per entry was added in 7.59.0.
+
+Support for resolving with wildcard was added in 7.64.0.
+
+Support for the '+' prefix was was added in 7.75.0.
+
+This option can be used many times to add many host names to resolve.
diff --git a/docs/cmdline-opts/retry-all-errors.d b/docs/cmdline-opts/retry-all-errors.d
new file mode 100644
index 0000000..5cab5dd
--- /dev/null
+++ b/docs/cmdline-opts/retry-all-errors.d
@@ -0,0 +1,30 @@
+Long: retry-all-errors
+Help: Retry all errors (use with --retry)
+Added: 7.71.0
+Category: curl
+Example: --retry-all-errors $URL
+---
+Retry on any error. This option is used together with --retry.
+
+This option is the "sledgehammer" of retrying. Do not use this option by
+default (eg in curlrc), there may be unintended consequences such as sending or
+receiving duplicate data. Do not use with redirected input or output. You'd be
+much better off handling your unique problems in shell script. Please read the
+example below.
+
+**WARNING**: For server compatibility curl attempts to retry failed flaky
+transfers as close as possible to how they were started, but this is not
+possible with redirected input or output. For example, before retrying it
+removes output data from a failed partial transfer that was written to an
+output file. However this is not true of data redirected to a | pipe or >
+file, which are not reset. We strongly suggest don't parse or record output
+via redirect in combination with this option, since you may receive duplicate
+data.
+
+By default curl will not error on an HTTP response code that indicates an HTTP
+error, if the transfer was successful. For example, if a server replies 404
+Not Found and the reply is fully received then that is not an error. When
+--retry is used then curl will retry on some HTTP response codes that indicate
+transient HTTP errors, but that does not include most 4xx response codes such
+as 404. If you want to retry on all response codes that indicate HTTP errors
+(4xx and 5xx) then combine with --fail.
diff --git a/docs/cmdline-opts/retry-connrefused.d b/docs/cmdline-opts/retry-connrefused.d
new file mode 100644
index 0000000..ad079e0
--- /dev/null
+++ b/docs/cmdline-opts/retry-connrefused.d
@@ -0,0 +1,8 @@
+Long: retry-connrefused
+Help: Retry on connection refused (use with --retry)
+Added: 7.52.0
+Category: curl
+Example: --retry-connrefused --retry $URL
+---
+In addition to the other conditions, consider ECONNREFUSED as a transient
+error too for --retry. This option is used together with --retry.
diff --git a/docs/cmdline-opts/retry-delay.d b/docs/cmdline-opts/retry-delay.d
new file mode 100644
index 0000000..2839129
--- /dev/null
+++ b/docs/cmdline-opts/retry-delay.d
@@ -0,0 +1,13 @@
+Long: retry-delay
+Arg: <seconds>
+Help: Wait time between retries
+Added: 7.12.3
+Category: curl
+Example: --retry-delay 5 --retry $URL
+---
+Make curl sleep this amount of time before each retry when a transfer has
+failed with a transient error (it changes the default backoff time algorithm
+between retries). This option is only interesting if --retry is also
+used. Setting this delay to zero will make curl use the default backoff time.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/retry-max-time.d b/docs/cmdline-opts/retry-max-time.d
new file mode 100644
index 0000000..acccff5
--- /dev/null
+++ b/docs/cmdline-opts/retry-max-time.d
@@ -0,0 +1,15 @@
+Long: retry-max-time
+Arg: <seconds>
+Help: Retry only within this period
+Added: 7.12.3
+Category: curl
+Example: --retry-max-time 30 --retry 10 $URL
+---
+The retry timer is reset before the first transfer attempt. Retries will be
+done as usual (see --retry) as long as the timer hasn't reached this given
+limit. Notice that if the timer hasn't reached the limit, the request will be
+made and while performing, it may take longer than this given time period. To
+limit a single request\'s maximum time, use --max-time.  Set this option to
+zero to not timeout retries.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/retry.d b/docs/cmdline-opts/retry.d
new file mode 100644
index 0000000..6238383
--- /dev/null
+++ b/docs/cmdline-opts/retry.d
@@ -0,0 +1,23 @@
+Long: retry
+Arg: <num>
+Added: 7.12.3
+Help: Retry request if transient problems occur
+Category: curl
+Example: --retry 7 $URL
+---
+If a transient error is returned when curl tries to perform a transfer, it
+will retry this number of times before giving up. Setting the number to 0
+makes curl do no retries (which is the default). Transient error means either:
+a timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503 or 504
+response code.
+
+When curl is about to retry a transfer, it will first wait one second and then
+for all forthcoming retries it will double the waiting time until it reaches
+10 minutes which then will be the delay between the rest of the retries.  By
+using --retry-delay you disable this exponential backoff algorithm. See also
+--retry-max-time to limit the total time allowed for retries.
+
+Since curl 7.66.0, curl will comply with the Retry-After: response header if
+one was present to know when to issue the next retry.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/sasl-authzid.d b/docs/cmdline-opts/sasl-authzid.d
new file mode 100644
index 0000000..9065bd5
--- /dev/null
+++ b/docs/cmdline-opts/sasl-authzid.d
@@ -0,0 +1,14 @@
+Long: sasl-authzid
+Arg: <identity>
+Help: Identity for SASL PLAIN authentication
+Added: 7.66.0
+Category: auth
+Example: --sasl-authzid zid imap://example.com/
+---
+Use this authorisation identity (authzid), during SASL PLAIN authentication,
+in addition to the authentication identity (authcid) as specified by --user.
+
+If the option isn't specified, the server will derive the authzid from the
+authcid, but if specified, and depending on the server implementation, it may
+be used to access another user's inbox, that the user has been granted access
+to, or a shared mailbox for example.
diff --git a/docs/cmdline-opts/sasl-ir.d b/docs/cmdline-opts/sasl-ir.d
new file mode 100644
index 0000000..5004306
--- /dev/null
+++ b/docs/cmdline-opts/sasl-ir.d
@@ -0,0 +1,7 @@
+Long: sasl-ir
+Help: Enable initial response in SASL authentication
+Added: 7.31.0
+Category: auth
+Example: --sasl-ir imap://example.com/
+---
+Enable initial response in SASL authentication.
diff --git a/docs/cmdline-opts/service-name.d b/docs/cmdline-opts/service-name.d
new file mode 100644
index 0000000..3a5559b
--- /dev/null
+++ b/docs/cmdline-opts/service-name.d
@@ -0,0 +1,10 @@
+Long: service-name
+Help: SPNEGO service name
+Arg: <name>
+Added: 7.43.0
+Category: misc
+Example: --service-name sockd/server $URL
+---
+This option allows you to change the service name for SPNEGO.
+
+Examples: --negotiate --service-name sockd would use sockd/server-name.
diff --git a/docs/cmdline-opts/show-error.d b/docs/cmdline-opts/show-error.d
new file mode 100644
index 0000000..e8b2177
--- /dev/null
+++ b/docs/cmdline-opts/show-error.d
@@ -0,0 +1,11 @@
+Long: show-error
+Short: S
+Help: Show error even when -s is used
+See-also: no-progress-meter
+Category: curl
+Example: --show-error --silent $URL
+---
+When used with --silent, it makes curl show an error message if it fails.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/silent.d b/docs/cmdline-opts/silent.d
new file mode 100644
index 0000000..7122c54
--- /dev/null
+++ b/docs/cmdline-opts/silent.d
@@ -0,0 +1,13 @@
+Long: silent
+Short: s
+Help: Silent mode
+See-also: verbose stderr no-progress-meter
+Category: important verbose
+Example: -s $URL
+---
+Silent or quiet mode. Don't show progress meter or error messages.  Makes Curl
+mute. It will still output the data you ask for, potentially even to the
+terminal/stdout unless you redirect it.
+
+Use --show-error in addition to this option to disable progress meter but
+still show error messages.
diff --git a/docs/cmdline-opts/socks4.d b/docs/cmdline-opts/socks4.d
new file mode 100644
index 0000000..1cae1e1
--- /dev/null
+++ b/docs/cmdline-opts/socks4.d
@@ -0,0 +1,22 @@
+Long: socks4
+Arg: <host[:port]>
+Help: SOCKS4 proxy on given host + port
+Added: 7.15.2
+Category: proxy
+Example: --socks4 hostname:4096 $URL
+---
+Use the specified SOCKS4 proxy. If the port number is not specified, it is
+assumed at port 1080. Using this socket type make curl resolve the host name
+and passing the address on to the proxy.
+
+This option overrides any previous use of --proxy, as they are mutually
+exclusive.
+
+Since 7.21.7, this option is superfluous since you can specify a socks4 proxy
+with --proxy using a socks4:// protocol prefix.
+
+Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
+--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
+the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/socks4a.d b/docs/cmdline-opts/socks4a.d
new file mode 100644
index 0000000..8edefdd
--- /dev/null
+++ b/docs/cmdline-opts/socks4a.d
@@ -0,0 +1,21 @@
+Long: socks4a
+Arg: <host[:port]>
+Help: SOCKS4a proxy on given host + port
+Added: 7.18.0
+Category: proxy
+Example: --socks4a hostname:4096 $URL
+---
+Use the specified SOCKS4a proxy. If the port number is not specified, it is
+assumed at port 1080. This asks the proxy to resolve the host name.
+
+This option overrides any previous use of --proxy, as they are mutually
+exclusive.
+
+Since 7.21.7, this option is superfluous since you can specify a socks4a proxy
+with --proxy using a socks4a:// protocol prefix.
+
+Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
+--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
+the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/socks5-basic.d b/docs/cmdline-opts/socks5-basic.d
new file mode 100644
index 0000000..f32e0bf
--- /dev/null
+++ b/docs/cmdline-opts/socks5-basic.d
@@ -0,0 +1,9 @@
+Long: socks5-basic
+Help: Enable username/password auth for SOCKS5 proxies
+Added: 7.55.0
+Category: proxy auth
+Example: --socks5-basic --socks5 hostname:4096 $URL
+---
+Tells curl to use username/password authentication when connecting to a SOCKS5
+proxy.  The username/password authentication is enabled by default.  Use
+--socks5-gssapi to force GSS-API authentication to SOCKS5 proxies.
diff --git a/docs/cmdline-opts/socks5-gssapi-nec.d b/docs/cmdline-opts/socks5-gssapi-nec.d
new file mode 100644
index 0000000..73cac7a
--- /dev/null
+++ b/docs/cmdline-opts/socks5-gssapi-nec.d
@@ -0,0 +1,10 @@
+Long: socks5-gssapi-nec
+Help: Compatibility with NEC SOCKS5 server
+Added: 7.19.4
+Category: proxy auth
+Example: --socks5-gssapi-nec --socks5 hostname:4096 $URL
+---
+As part of the GSS-API negotiation a protection mode is negotiated. RFC 1961
+says in section 4.3/4.4 it should be protected, but the NEC reference
+implementation does not.  The option --socks5-gssapi-nec allows the
+unprotected exchange of the protection mode negotiation.
diff --git a/docs/cmdline-opts/socks5-gssapi-service.d b/docs/cmdline-opts/socks5-gssapi-service.d
new file mode 100644
index 0000000..451be8e
--- /dev/null
+++ b/docs/cmdline-opts/socks5-gssapi-service.d
@@ -0,0 +1,14 @@
+Long: socks5-gssapi-service
+Arg: <name>
+Help: SOCKS5 proxy service name for GSS-API
+Added: 7.19.4
+Category: proxy auth
+Example: --socks5-gssapi-service sockd --socks5 hostname:4096 $URL
+---
+The default service name for a socks server is rcmd/server-fqdn. This option
+allows you to change it.
+
+Examples: --socks5 proxy-name --socks5-gssapi-service sockd would use
+sockd/proxy-name --socks5 proxy-name --socks5-gssapi-service sockd/real-name
+would use sockd/real-name for cases where the proxy-name does not match the
+principal name.
diff --git a/docs/cmdline-opts/socks5-gssapi.d b/docs/cmdline-opts/socks5-gssapi.d
new file mode 100644
index 0000000..2ce8069
--- /dev/null
+++ b/docs/cmdline-opts/socks5-gssapi.d
@@ -0,0 +1,10 @@
+Long: socks5-gssapi
+Help: Enable GSS-API auth for SOCKS5 proxies
+Added: 7.55.0
+Category: proxy auth
+Example: --socks5-gssapi --socks5 hostname:4096 $URL
+---
+Tells curl to use GSS-API authentication when connecting to a SOCKS5 proxy.
+The GSS-API authentication is enabled by default (if curl is compiled with
+GSS-API support).  Use --socks5-basic to force username/password authentication
+to SOCKS5 proxies.
diff --git a/docs/cmdline-opts/socks5-hostname.d b/docs/cmdline-opts/socks5-hostname.d
new file mode 100644
index 0000000..729a7bf
--- /dev/null
+++ b/docs/cmdline-opts/socks5-hostname.d
@@ -0,0 +1,21 @@
+Long: socks5-hostname
+Arg: <host[:port]>
+Help: SOCKS5 proxy, pass host name to proxy
+Added: 7.18.0
+Category: proxy
+Example: --socks5-hostname proxy.example:7000 $URL
+---
+Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If
+the port number is not specified, it is assumed at port 1080.
+
+This option overrides any previous use of --proxy, as they are mutually
+exclusive.
+
+Since 7.21.7, this option is superfluous since you can specify a socks5
+hostname proxy with --proxy using a socks5h:// protocol prefix.
+
+Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
+--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
+the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/socks5.d b/docs/cmdline-opts/socks5.d
new file mode 100644
index 0000000..99c740f
--- /dev/null
+++ b/docs/cmdline-opts/socks5.d
@@ -0,0 +1,23 @@
+Long: socks5
+Arg: <host[:port]>
+Help: SOCKS5 proxy on given host + port
+Added: 7.18.0
+Category: proxy
+Example: --socks5 proxy.example:7000 $URL
+---
+Use the specified SOCKS5 proxy - but resolve the host name locally. If the
+port number is not specified, it is assumed at port 1080.
+
+This option overrides any previous use of --proxy, as they are mutually
+exclusive.
+
+Since 7.21.7, this option is superfluous since you can specify a socks5 proxy
+with --proxy using a socks5:// protocol prefix.
+
+Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
+--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
+the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.
+
+If this option is used several times, the last one will be used.
+
+This option (as well as --socks4) does not work with IPV6, FTPS or LDAP.
diff --git a/docs/cmdline-opts/speed-limit.d b/docs/cmdline-opts/speed-limit.d
new file mode 100644
index 0000000..7bf8d5f
--- /dev/null
+++ b/docs/cmdline-opts/speed-limit.d
@@ -0,0 +1,12 @@
+Long: speed-limit
+Short: Y
+Arg: <speed>
+Help: Stop transfers slower than this
+Category: connection
+Example: --speed-limit 300 --speed-time 10 $URL
+---
+If a download is slower than this given speed (in bytes per second) for
+speed-time seconds it gets aborted. speed-time is set with --speed-time and is
+30 if not set.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/speed-time.d b/docs/cmdline-opts/speed-time.d
new file mode 100644
index 0000000..6095214
--- /dev/null
+++ b/docs/cmdline-opts/speed-time.d
@@ -0,0 +1,15 @@
+Long: speed-time
+Short: y
+Arg: <seconds>
+Help: Trigger 'speed-limit' abort after this time
+Category: connection
+Example: --speed-limit 300 --speed-time 10 $URL
+---
+If a download is slower than speed-limit bytes per second during a speed-time
+period, the download gets aborted. If speed-time is used, the default
+speed-limit will be 1 unless set with --speed-limit.
+
+This option controls transfers and thus will not affect slow connects etc. If
+this is a concern for you, try the --connect-timeout option.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/ssl-allow-beast.d b/docs/cmdline-opts/ssl-allow-beast.d
new file mode 100644
index 0000000..f54cf64
--- /dev/null
+++ b/docs/cmdline-opts/ssl-allow-beast.d
@@ -0,0 +1,13 @@
+Long: ssl-allow-beast
+Help: Allow security flaw to improve interop
+Added: 7.25.0
+Category: tls
+Example: --ssl-allow-beast $URL
+---
+This option tells curl to not work around a security flaw in the SSL3 and
+TLS1.0 protocols known as BEAST.  If this option isn't used, the SSL layer may
+use workarounds known to cause interoperability problems with some older SSL
+implementations.
+
+**WARNING**: this option loosens the SSL security, and by using this flag you
+ask for exactly that.
diff --git a/docs/cmdline-opts/ssl-auto-client-cert.d b/docs/cmdline-opts/ssl-auto-client-cert.d
new file mode 100644
index 0000000..7581bdf
--- /dev/null
+++ b/docs/cmdline-opts/ssl-auto-client-cert.d
@@ -0,0 +1,13 @@
+Long: ssl-auto-client-cert
+Help: Use auto client certificate (Schannel)
+Added: 7.77.0
+See-also: proxy-ssl-auto-client-cert
+Category: tls
+Example: --ssl-auto-client-cert $URL
+---
+Tell libcurl to automatically locate and use a client certificate for
+authentication, when requested by the server. This option is only supported
+for Schannel (the native Windows SSL library). Prior to 7.77.0 this was the
+default behavior in libcurl with Schannel. Since the server can request any
+certificate that supports client authentication in the OS certificate store it
+could be a privacy violation and unexpected.
diff --git a/docs/cmdline-opts/ssl-no-revoke.d b/docs/cmdline-opts/ssl-no-revoke.d
new file mode 100644
index 0000000..dde77aa
--- /dev/null
+++ b/docs/cmdline-opts/ssl-no-revoke.d
@@ -0,0 +1,9 @@
+Long: ssl-no-revoke
+Help: Disable cert revocation checks (Schannel)
+Added: 7.44.0
+Category: tls
+Example: --ssl-no-revoke $URL
+---
+(Schannel) This option tells curl to disable certificate revocation checks.
+WARNING: this option loosens the SSL security, and by using this flag you ask
+for exactly that.
diff --git a/docs/cmdline-opts/ssl-reqd.d b/docs/cmdline-opts/ssl-reqd.d
new file mode 100644
index 0000000..489be00
--- /dev/null
+++ b/docs/cmdline-opts/ssl-reqd.d
@@ -0,0 +1,11 @@
+Long: ssl-reqd
+Help: Require SSL/TLS
+Protocols: FTP IMAP POP3 SMTP
+Added: 7.20.0
+Category: tls
+Example: --ssl-reqd ftp://example.com
+---
+Require SSL/TLS for the connection.  Terminates the connection if the server
+doesn't support SSL/TLS.
+
+This option was formerly known as --ftp-ssl-reqd.
diff --git a/docs/cmdline-opts/ssl-revoke-best-effort.d b/docs/cmdline-opts/ssl-revoke-best-effort.d
new file mode 100644
index 0000000..2db3219
--- /dev/null
+++ b/docs/cmdline-opts/ssl-revoke-best-effort.d
@@ -0,0 +1,9 @@
+Long: ssl-revoke-best-effort
+Help: Ignore missing/offline cert CRL dist points
+Added: 7.70.0
+Category: tls
+Example: --ssl-revoke-best-effort $URL
+---
+(Schannel) This option tells curl to ignore certificate revocation checks when
+they failed due to missing/offline distribution points for the revocation check
+lists.
diff --git a/docs/cmdline-opts/ssl.d b/docs/cmdline-opts/ssl.d
new file mode 100644
index 0000000..bc339fa
--- /dev/null
+++ b/docs/cmdline-opts/ssl.d
@@ -0,0 +1,13 @@
+Long: ssl
+Help: Try SSL/TLS
+Protocols: FTP IMAP POP3 SMTP
+Added: 7.20.0
+Category: tls
+Example: --ssl pop3://example.com/
+---
+Try to use SSL/TLS for the connection.  Reverts to a non-secure connection if
+the server doesn't support SSL/TLS.  See also --ftp-ssl-control and --ssl-reqd
+for different levels of encryption required.
+
+This option was formerly known as --ftp-ssl (Added in 7.11.0). That option
+name can still be used but will be removed in a future version.
diff --git a/docs/cmdline-opts/sslv2.d b/docs/cmdline-opts/sslv2.d
new file mode 100644
index 0000000..d96a6cc
--- /dev/null
+++ b/docs/cmdline-opts/sslv2.d
@@ -0,0 +1,15 @@
+Short: 2
+Long: sslv2
+Tags: Versions
+Protocols: SSL
+Added:
+Mutexed: sslv3 tlsv1 tlsv1.1 tlsv1.2
+Requires: TLS
+See-also: http1.1 http2
+Help: Use SSLv2
+Category: tls
+Example: --sslv2 $URL
+---
+This option previously asked curl to use SSLv2, but starting in curl 7.77.0
+this instruction is ignored. SSLv2 is widely considered insecure (see RFC
+6176).
diff --git a/docs/cmdline-opts/sslv3.d b/docs/cmdline-opts/sslv3.d
new file mode 100644
index 0000000..3ee483d
--- /dev/null
+++ b/docs/cmdline-opts/sslv3.d
@@ -0,0 +1,15 @@
+Short: 3
+Long: sslv3
+Tags: Versions
+Protocols: SSL
+Added:
+Mutexed: sslv2 tlsv1 tlsv1.1 tlsv1.2
+Requires: TLS
+See-also: http1.1 http2
+Help: Use SSLv3
+Category: tls
+Example: --sslv3 $URL
+---
+This option previously asked curl to use SSLv3, but starting in curl 7.77.0
+this instruction is ignored. SSLv3 is widely considered insecure (see RFC
+7568).
diff --git a/docs/cmdline-opts/stderr.d b/docs/cmdline-opts/stderr.d
new file mode 100644
index 0000000..c0f0efa
--- /dev/null
+++ b/docs/cmdline-opts/stderr.d
@@ -0,0 +1,14 @@
+Long: stderr
+Arg: <file>
+Help: Where to redirect stderr
+See-also: verbose silent
+Category: verbose
+Example: --stderr output.txt $URL
+---
+Redirect all writes to stderr to the specified file instead. If the file name
+is a plain '-', it is instead written to stdout.
+
+This option is global and does not need to be specified for each use of
+--next.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/styled-output.d b/docs/cmdline-opts/styled-output.d
new file mode 100644
index 0000000..bf63601
--- /dev/null
+++ b/docs/cmdline-opts/styled-output.d
@@ -0,0 +1,11 @@
+Long: styled-output
+Help: Enable styled output for HTTP headers
+Added: 7.61.0
+Category: verbose
+Example: --styled-output -I $URL
+---
+Enables the automatic use of bold font styles when writing HTTP headers to the
+terminal. Use --no-styled-output to switch them off.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/suppress-connect-headers.d b/docs/cmdline-opts/suppress-connect-headers.d
new file mode 100644
index 0000000..71078e8
--- /dev/null
+++ b/docs/cmdline-opts/suppress-connect-headers.d
@@ -0,0 +1,10 @@
+Long: suppress-connect-headers
+Help: Suppress proxy CONNECT response headers
+See-also: dump-header include proxytunnel
+Category: proxy
+Example: --suppress-connect-headers --include -x proxy $URL
+---
+When --proxytunnel is used and a CONNECT request is made don't output proxy
+CONNECT response headers. This option is meant to be used with --dump-header or
+--include which are used to show protocol headers in the output. It has no
+effect on debug options such as --verbose or --trace, or any statistics.
diff --git a/docs/cmdline-opts/tcp-fastopen.d b/docs/cmdline-opts/tcp-fastopen.d
new file mode 100644
index 0000000..e7e9d2e
--- /dev/null
+++ b/docs/cmdline-opts/tcp-fastopen.d
@@ -0,0 +1,7 @@
+Long: tcp-fastopen
+Added: 7.49.0
+Help: Use TCP Fast Open
+Category: connection
+Example: --tcp-fastopen $URL
+---
+Enable use of TCP Fast Open (RFC7413).
diff --git a/docs/cmdline-opts/tcp-nodelay.d b/docs/cmdline-opts/tcp-nodelay.d
new file mode 100644
index 0000000..97cd30a
--- /dev/null
+++ b/docs/cmdline-opts/tcp-nodelay.d
@@ -0,0 +1,11 @@
+Long: tcp-nodelay
+Help: Use the TCP_NODELAY option
+Added: 7.11.2
+Category: connection
+Example: --tcp-nodelay $URL
+---
+Turn on the TCP_NODELAY option. See the *curl_easy_setopt(3)* man page for
+details about this option.
+
+Since 7.50.2, curl sets this option by default and you need to explicitly
+switch it off if you don't want it on.
diff --git a/docs/cmdline-opts/telnet-option.d b/docs/cmdline-opts/telnet-option.d
new file mode 100644
index 0000000..3475cb5
--- /dev/null
+++ b/docs/cmdline-opts/telnet-option.d
@@ -0,0 +1,14 @@
+Long: telnet-option
+Short: t
+Arg: <opt=val>
+Help: Set telnet option
+Category: telnet
+Example: -t TTYPE=vt100 telnet://example.com/
+---
+Pass options to the telnet protocol. Supported options are:
+
+TTYPE=<term> Sets the terminal type.
+
+XDISPLOC=<X display> Sets the X display location.
+
+NEW_ENV=<var,val> Sets an environment variable.
diff --git a/docs/cmdline-opts/tftp-blksize.d b/docs/cmdline-opts/tftp-blksize.d
new file mode 100644
index 0000000..3b19e5c
--- /dev/null
+++ b/docs/cmdline-opts/tftp-blksize.d
@@ -0,0 +1,13 @@
+Long: tftp-blksize
+Arg: <value>
+Help: Set TFTP BLKSIZE option
+Protocols: TFTP
+Added: 7.20.0
+Category: tftp
+Example: --tftp-blksize 1024 tftp://example.com/file
+---
+Set TFTP BLKSIZE option (must be >512). This is the block size that curl will
+try to use when transferring data to or from a TFTP server. By default 512
+bytes will be used.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/tftp-no-options.d b/docs/cmdline-opts/tftp-no-options.d
new file mode 100644
index 0000000..9ff334b
--- /dev/null
+++ b/docs/cmdline-opts/tftp-no-options.d
@@ -0,0 +1,12 @@
+Long: tftp-no-options
+Help: Do not send any TFTP options
+Protocols: TFTP
+Added: 7.48.0
+Category: tftp
+Example: --tftp-no-options tftp://192.168.0.1/
+---
+Tells curl not to send TFTP options requests.
+
+This option improves interop with some legacy servers that do not acknowledge
+or properly implement TFTP options. When this option is used --tftp-blksize is
+ignored.
diff --git a/docs/cmdline-opts/time-cond.d b/docs/cmdline-opts/time-cond.d
new file mode 100644
index 0000000..f82f497
--- /dev/null
+++ b/docs/cmdline-opts/time-cond.d
@@ -0,0 +1,21 @@
+Long: time-cond
+Short: z
+Arg: <time>
+Help: Transfer based on a time condition
+Protocols: HTTP FTP
+Category: http ftp
+Example: -z "Wed 01 Sep 2021 12:18:00" $URL
+Example: -z "-Wed 01 Sep 2021 12:18:00" $URL
+Example: -z file $URL
+---
+Request a file that has been modified later than the given time and date, or
+one that has been modified before that time. The <date expression> can be all
+sorts of date strings or if it doesn't match any internal ones, it is taken as
+a filename and tries to get the modification date (mtime) from <file>
+instead. See the *curl_getdate(3)* man pages for date expression details.
+
+Start the date expression with a dash (-) to make it request for a document
+that is older than the given date/time, default is a document that is newer
+than the specified date/time.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/tls-max.d b/docs/cmdline-opts/tls-max.d
new file mode 100644
index 0000000..54431ac
--- /dev/null
+++ b/docs/cmdline-opts/tls-max.d
@@ -0,0 +1,30 @@
+Long: tls-max
+Arg: <VERSION>
+Tags: Versions
+Protocols: SSL
+Added: 7.54.0
+Requires: TLS
+See-also: tlsv1.0 tlsv1.1 tlsv1.2 tlsv1.3
+Help: Set maximum allowed TLS version
+Category: tls
+Example: --tls-max 1.2 $URL
+Example: --tls-max 1.3 --tlsv1.2 $URL
+---
+VERSION defines maximum supported TLS version. The minimum acceptable version
+is set by tlsv1.0, tlsv1.1, tlsv1.2 or tlsv1.3.
+
+If the connection is done without TLS, this option has no effect. This
+includes QUIC-using (HTTP/3) transfers.
+
+.RS
+.IP "default"
+Use up to recommended TLS version.
+.IP "1.0"
+Use up to TLSv1.0.
+.IP "1.1"
+Use up to TLSv1.1.
+.IP "1.2"
+Use up to TLSv1.2.
+.IP "1.3"
+Use up to TLSv1.3.
+.RE
diff --git a/docs/cmdline-opts/tls13-ciphers.d b/docs/cmdline-opts/tls13-ciphers.d
new file mode 100644
index 0000000..daf1c93
--- /dev/null
+++ b/docs/cmdline-opts/tls13-ciphers.d
@@ -0,0 +1,18 @@
+Long: tls13-ciphers
+Arg: <ciphersuite list>
+help: TLS 1.3 cipher suites to use
+Protocols: TLS
+Category: tls
+Example: --tls13-ciphers TLS_AES_128_GCM_SHA256 $URL
+---
+Specifies which cipher suites to use in the connection if it negotiates TLS
+1.3. The list of ciphers suites must specify valid ciphers. Read up on TLS 1.3
+cipher suite details on this URL:
+
+ https://curl.se/docs/ssl-ciphers.html
+
+This option is currently used only when curl is built to use OpenSSL 1.1.1 or
+later. If you are using a different SSL backend you can try setting TLS 1.3
+cipher suites by using the --ciphers option.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/tlsauthtype.d b/docs/cmdline-opts/tlsauthtype.d
new file mode 100644
index 0000000..57b6ab8
--- /dev/null
+++ b/docs/cmdline-opts/tlsauthtype.d
@@ -0,0 +1,12 @@
+Long: tlsauthtype
+Arg: <type>
+Help: TLS authentication type
+Added: 7.21.4
+Category: tls auth
+Example: --tlsauthtype SRP $URL
+---
+Set TLS authentication type. Currently, the only supported option is "SRP",
+for TLS-SRP (RFC 5054). If --tlsuser and --tlspassword are specified but
+--tlsauthtype is not, then this option defaults to "SRP".  This option works
+only if the underlying libcurl is built with TLS-SRP support, which requires
+OpenSSL or GnuTLS with TLS-SRP support.
diff --git a/docs/cmdline-opts/tlspassword.d b/docs/cmdline-opts/tlspassword.d
new file mode 100644
index 0000000..80cf065
--- /dev/null
+++ b/docs/cmdline-opts/tlspassword.d
@@ -0,0 +1,11 @@
+Long: tlspassword
+Arg: <string>
+Help: TLS password
+Added: 7.21.4
+Category: tls auth
+Example: --tlspassword pwd --tlsuser user $URL
+---
+Set password for use with the TLS authentication method specified with
+--tlsauthtype. Requires that --tlsuser also be set.
+
+This doesn't work with TLS 1.3.
diff --git a/docs/cmdline-opts/tlsuser.d b/docs/cmdline-opts/tlsuser.d
new file mode 100644
index 0000000..2cfcd95
--- /dev/null
+++ b/docs/cmdline-opts/tlsuser.d
@@ -0,0 +1,11 @@
+Long: tlsuser
+Arg: <name>
+Help: TLS user name
+Added: 7.21.4
+Category: tls auth
+Example: --tlspassword pwd --tlsuser user $URL
+---
+Set username for use with the TLS authentication method specified with
+--tlsauthtype. Requires that --tlspassword also is set.
+
+This doesn't work with TLS 1.3.
diff --git a/docs/cmdline-opts/tlsv1.0.d b/docs/cmdline-opts/tlsv1.0.d
new file mode 100644
index 0000000..5fc18dc
--- /dev/null
+++ b/docs/cmdline-opts/tlsv1.0.d
@@ -0,0 +1,12 @@
+Long: tlsv1.0
+Help: Use TLSv1.0 or greater
+Protocols: TLS
+Added: 7.34.0
+Category: tls
+Example: --tlsv1.0 $URL
+---
+Forces curl to use TLS version 1.0 or later when connecting to a remote TLS server.
+
+In old versions of curl this option was documented to allow _only_ TLS 1.0,
+but behavior was inconsistent depending on the TLS library. Use --tls-max if
+you want to set a maximum TLS version.
diff --git a/docs/cmdline-opts/tlsv1.1.d b/docs/cmdline-opts/tlsv1.1.d
new file mode 100644
index 0000000..6d169bf
--- /dev/null
+++ b/docs/cmdline-opts/tlsv1.1.d
@@ -0,0 +1,12 @@
+Long: tlsv1.1
+Help: Use TLSv1.1 or greater
+Protocols: TLS
+Added: 7.34.0
+Category: tls
+Example: --tlsv1.1 $URL
+---
+Forces curl to use TLS version 1.1 or later when connecting to a remote TLS server.
+
+In old versions of curl this option was documented to allow _only_ TLS 1.1,
+but behavior was inconsistent depending on the TLS library. Use --tls-max if
+you want to set a maximum TLS version.
diff --git a/docs/cmdline-opts/tlsv1.2.d b/docs/cmdline-opts/tlsv1.2.d
new file mode 100644
index 0000000..5df843f
--- /dev/null
+++ b/docs/cmdline-opts/tlsv1.2.d
@@ -0,0 +1,12 @@
+Long: tlsv1.2
+Help: Use TLSv1.2 or greater
+Protocols: TLS
+Added: 7.34.0
+Category: tls
+Example: --tlsv1.2 $URL
+---
+Forces curl to use TLS version 1.2 or later when connecting to a remote TLS server.
+
+In old versions of curl this option was documented to allow _only_ TLS 1.2,
+but behavior was inconsistent depending on the TLS library. Use --tls-max if
+you want to set a maximum TLS version.
diff --git a/docs/cmdline-opts/tlsv1.3.d b/docs/cmdline-opts/tlsv1.3.d
new file mode 100644
index 0000000..cc9a53b
--- /dev/null
+++ b/docs/cmdline-opts/tlsv1.3.d
@@ -0,0 +1,14 @@
+Long: tlsv1.3
+Help: Use TLSv1.3 or greater
+Protocols: TLS
+Added: 7.52.0
+Category: tls
+Example: --tlsv1.3 $URL
+---
+Forces curl to use TLS version 1.3 or later when connecting to a remote TLS
+server.
+
+If the connection is done without TLS, this option has no effect. This
+includes QUIC-using (HTTP/3) transfers.
+
+Note that TLS 1.3 is not supported by all TLS backends.
diff --git a/docs/cmdline-opts/tlsv1.d b/docs/cmdline-opts/tlsv1.d
new file mode 100644
index 0000000..b881c24
--- /dev/null
+++ b/docs/cmdline-opts/tlsv1.d
@@ -0,0 +1,14 @@
+Short: 1
+Long: tlsv1
+Tags: Versions
+Protocols: SSL
+Added:
+Mutexed: tlsv1.1 tlsv1.2 tlsv1.3
+Requires: TLS
+See-also: http1.1 http2
+Help: Use TLSv1.0 or greater
+Category: tls
+Example: --tlsv1 $URL
+---
+Tells curl to use at least TLS version 1.x when negotiating with a remote TLS
+server. That means TLS version 1.0 or higher
diff --git a/docs/cmdline-opts/tr-encoding.d b/docs/cmdline-opts/tr-encoding.d
new file mode 100644
index 0000000..7fdf9e0
--- /dev/null
+++ b/docs/cmdline-opts/tr-encoding.d
@@ -0,0 +1,9 @@
+Long: tr-encoding
+Added: 7.21.6
+Help: Request compressed transfer encoding
+Protocols: HTTP
+Category: http
+Example: --tr-encoding $URL
+---
+Request a compressed Transfer-Encoding response using one of the algorithms
+curl supports, and uncompress the data while receiving it.
diff --git a/docs/cmdline-opts/trace-ascii.d b/docs/cmdline-opts/trace-ascii.d
new file mode 100644
index 0000000..89fe588
--- /dev/null
+++ b/docs/cmdline-opts/trace-ascii.d
@@ -0,0 +1,19 @@
+Long: trace-ascii
+Arg: <file>
+Help: Like --trace, but without hex output
+Mutexed: trace verbose
+Category: verbose
+Example: --trace-ascii log.txt $URL
+---
+Enables a full trace dump of all incoming and outgoing data, including
+descriptive information, to the given output file. Use "-" as filename to have
+the output sent to stdout.
+
+This is very similar to --trace, but leaves out the hex part and only shows
+the ASCII part of the dump. It makes smaller output that might be easier to
+read for untrained humans.
+
+This option is global and does not need to be specified for each use of
+--next.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/trace-time.d b/docs/cmdline-opts/trace-time.d
new file mode 100644
index 0000000..083270d
--- /dev/null
+++ b/docs/cmdline-opts/trace-time.d
@@ -0,0 +1,10 @@
+Long: trace-time
+Help: Add time stamps to trace/verbose output
+Added: 7.14.0
+Category: verbose
+Example: --trace-time --trace-ascii output $URL
+---
+Prepends a time stamp to each trace or verbose line that curl displays.
+
+This option is global and does not need to be specified for each use of
+--next.
diff --git a/docs/cmdline-opts/trace.d b/docs/cmdline-opts/trace.d
new file mode 100644
index 0000000..3e71545
--- /dev/null
+++ b/docs/cmdline-opts/trace.d
@@ -0,0 +1,16 @@
+Long: trace
+Arg: <file>
+Help: Write a debug trace to FILE
+Mutexed: verbose trace-ascii
+Category: verbose
+Example: --trace log.txt $URL
+---
+Enables a full trace dump of all incoming and outgoing data, including
+descriptive information, to the given output file. Use "-" as filename to have
+the output sent to stdout. Use "%" as filename to have the output sent to
+stderr.
+
+This option is global and does not need to be specified for each use of
+--next.
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/unix-socket.d b/docs/cmdline-opts/unix-socket.d
new file mode 100644
index 0000000..c526ca6
--- /dev/null
+++ b/docs/cmdline-opts/unix-socket.d
@@ -0,0 +1,9 @@
+Long: unix-socket
+Arg: <path>
+Help: Connect through this Unix domain socket
+Added: 7.40.0
+Protocols: HTTP
+Category: connection
+Example: --unix-socket socket-path $URL
+---
+Connect through this Unix domain socket, instead of using the network.
diff --git a/docs/cmdline-opts/upload-file.d b/docs/cmdline-opts/upload-file.d
new file mode 100644
index 0000000..5cc5628
--- /dev/null
+++ b/docs/cmdline-opts/upload-file.d
@@ -0,0 +1,31 @@
+Long: upload-file
+Short: T
+Arg: <file>
+Help: Transfer local FILE to destination
+Category: important upload
+Example: -T file $URL
+Example: -T "img[1-1000].png" ftp://ftp.example.com/
+Example: --upload-file "{file1,file2}" $URL
+---
+This transfers the specified local file to the remote URL. If there is no file
+part in the specified URL, curl will append the local file name. NOTE that you
+must use a trailing / on the last directory to really prove to Curl that there
+is no file name or curl will think that your last directory name is the remote
+file name to use. That will most likely cause the upload operation to fail. If
+this is used on an HTTP(S) server, the PUT command will be used.
+
+Use the file name "-" (a single dash) to use stdin instead of a given file.
+Alternately, the file name "." (a single period) may be specified instead of
+"-" to use stdin in non-blocking mode to allow reading server output while
+stdin is being uploaded.
+
+You can specify one --upload-file for each URL on the command line. Each
+--upload-file + URL pair specifies what to upload and to where. curl also
+supports "globbing" of the --upload-file argument, meaning that you can upload
+multiple files to a single URL by using the same URL globbing style supported
+in the URL.
+
+When uploading to an SMTP server: the uploaded data is assumed to be RFC 5322
+formatted. It has to feature the necessary set of headers and mail body
+formatted correctly by the user as curl will not transcode nor encode it
+further in any way.
diff --git a/docs/cmdline-opts/url.d b/docs/cmdline-opts/url.d
new file mode 100644
index 0000000..ed1598a
--- /dev/null
+++ b/docs/cmdline-opts/url.d
@@ -0,0 +1,20 @@
+Long: url
+Arg: <url>
+Help: URL to work with
+Category: curl
+Example: --url $URL
+---
+Specify a URL to fetch. This option is mostly handy when you want to specify
+URL(s) in a config file.
+
+If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
+then curl will make a guess based on the host. If the outermost sub-domain
+name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol will be
+used, otherwise HTTP will be used. Since 7.45.0 guessing can be disabled by
+setting a default protocol, see --proto-default for details.
+
+This option may be used any number of times. To control where this URL is
+written, use the --output or the --remote-name options.
+
+**WARNING**: On Windows, particular file:// accesses can be converted to
+network accesses by the operating system. Beware!
diff --git a/docs/cmdline-opts/use-ascii.d b/docs/cmdline-opts/use-ascii.d
new file mode 100644
index 0000000..79554c7
--- /dev/null
+++ b/docs/cmdline-opts/use-ascii.d
@@ -0,0 +1,10 @@
+Short: B
+Long: use-ascii
+Help: Use ASCII/text transfer
+Protocols: FTP LDAP
+Category: misc
+Example: -B ftp://example.com/README
+---
+Enable ASCII transfer. For FTP, this can also be enforced by using a URL that
+ends with ";type=A". This option causes data sent to stdout to be in text mode
+for win32 systems.
diff --git a/docs/cmdline-opts/user-agent.d b/docs/cmdline-opts/user-agent.d
new file mode 100644
index 0000000..a322d14
--- /dev/null
+++ b/docs/cmdline-opts/user-agent.d
@@ -0,0 +1,17 @@
+Short: A
+Long: user-agent
+Arg: <name>
+Help: Send User-Agent <name> to server
+Protocols: HTTP
+Category: important http
+Example: -A "Agent 007" $URL
+---
+Specify the User-Agent string to send to the HTTP server. To encode blanks in
+the string, surround the string with single quote marks. This header can also
+be set with the --header or the --proxy-header options.
+
+If you give an empty argument to --user-agent (""), it will remove the header
+completely from the request. If you prefer a blank header, you can set it to a
+single space (" ").
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/user.d b/docs/cmdline-opts/user.d
new file mode 100644
index 0000000..6ab3c64
--- /dev/null
+++ b/docs/cmdline-opts/user.d
@@ -0,0 +1,41 @@
+Long: user
+Short: u
+Arg: <user:password>
+Help: Server user and password
+Category: important auth
+Example: -u user:secret $URL
+---
+Specify the user name and password to use for server authentication. Overrides
+--netrc and --netrc-optional.
+
+If you simply specify the user name, curl will prompt for a password.
+
+The user name and passwords are split up on the first colon, which makes it
+impossible to use a colon in the user name with this option. The password can,
+still.
+
+On systems where it works, curl will hide the given option argument from
+process listings. This is not enough to protect credentials from possibly
+getting seen by other users on the same system as they will still be visible
+for a brief moment before cleared. Such sensitive data should be retrieved
+from a file instead or similar and never used in clear text in a command line.
+
+When using Kerberos V5 with a Windows based server you should include the
+Windows domain name in the user name, in order for the server to successfully
+obtain a Kerberos Ticket. If you don't then the initial authentication
+handshake may fail.
+
+When using NTLM, the user name can be specified simply as the user name,
+without the domain, if there is a single domain and forest in your setup
+for example.
+
+To specify the domain name use either Down-Level Logon Name or UPN (User
+Principal Name) formats. For example, EXAMPLE\\user and user@example.com
+respectively.
+
+If you use a Windows SSPI-enabled curl binary and perform Kerberos V5,
+Negotiate, NTLM or Digest authentication then you can tell curl to select
+the user name and password from your environment by specifying a single colon
+with this option: "-u :".
+
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/verbose.d b/docs/cmdline-opts/verbose.d
new file mode 100644
index 0000000..f040d75
--- /dev/null
+++ b/docs/cmdline-opts/verbose.d
@@ -0,0 +1,24 @@
+Short: v
+Long: verbose
+Mutexed: trace trace-ascii
+Help: Make the operation more talkative
+See-also: include
+Category: important verbose
+Example: --verbose $URL
+---
+Makes curl verbose during the operation. Useful for debugging and seeing
+what's going on "under the hood". A line starting with '>' means "header data"
+sent by curl, '<' means "header data" received by curl that is hidden in
+normal cases, and a line starting with '*' means additional info provided by
+curl.
+
+If you only want HTTP headers in the output, --include might be the option
+you're looking for.
+
+If you think this option still doesn't give you enough details, consider using
+--trace or --trace-ascii instead.
+
+This option is global and does not need to be specified for each use of
+--next.
+
+Use --silent to make curl really quiet.
diff --git a/docs/cmdline-opts/version.d b/docs/cmdline-opts/version.d
new file mode 100644
index 0000000..f3c5899
--- /dev/null
+++ b/docs/cmdline-opts/version.d
@@ -0,0 +1,80 @@
+Long: version
+Short: V
+Help: Show version number and quit
+Category: important curl
+Example: --version
+---
+Displays information about curl and the libcurl version it uses.
+
+The first line includes the full version of curl, libcurl and other 3rd party
+libraries linked with the executable.
+
+The second line (starts with "Protocols:") shows all protocols that libcurl
+reports to support.
+
+The third line (starts with "Features:") shows specific features libcurl
+reports to offer. Available features include:
+.RS
+.IP "alt-svc"
+Support for the Alt-Svc: header is provided.
+.IP "AsynchDNS"
+This curl uses asynchronous name resolves. Asynchronous name resolves can be
+done using either the c-ares or the threaded resolver backends.
+.IP "brotli"
+Support for automatic brotli compression over HTTP(S).
+.IP "CharConv"
+curl was built with support for character set conversions (like EBCDIC)
+.IP "Debug"
+This curl uses a libcurl built with Debug. This enables more error-tracking
+and memory debugging etc. For curl-developers only!
+.IP "gsasl"
+The built-in SASL authentication includes extensions to support SCRAM because
+libcurl was built with libgsasl.
+.IP "GSS-API"
+GSS-API is supported.
+.IP "HSTS"
+HSTS support is present.
+.IP "HTTP2"
+HTTP/2 support has been built-in.
+.IP "HTTP3"
+HTTP/3 support has been built-in.
+.IP "HTTPS-proxy"
+This curl is built to support HTTPS proxy.
+.IP "IDN"
+This curl supports IDN - international domain names.
+.IP "IPv6"
+You can use IPv6 with this.
+.IP "Kerberos"
+Kerberos V5 authentication is supported.
+.IP "Largefile"
+This curl supports transfers of large files, files larger than 2GB.
+.IP "libz"
+Automatic decompression (via gzip, deflate) of compressed files over HTTP is
+supported.
+.IP "MultiSSL"
+This curl supports multiple TLS backends.
+.IP "NTLM"
+NTLM authentication is supported.
+.IP "NTLM_WB"
+NTLM delegation to winbind helper is supported.
+.IP "PSL"
+PSL is short for Public Suffix List and means that this curl has been built
+with knowledge about "public suffixes".
+.IP "SPNEGO"
+SPNEGO authentication is supported.
+.IP "SSL"
+SSL versions of various protocols are supported, such as HTTPS, FTPS, POP3S
+and so on.
+.IP "SSPI"
+SSPI is supported.
+.IP "TLS-SRP"
+SRP (Secure Remote Password) authentication is supported for TLS.
+.IP "TrackMemory"
+Debug memory tracking is supported.
+.IP "Unicode"
+Unicode support on Windows.
+.IP "UnixSockets"
+Unix sockets support is provided.
+.IP "zstd"
+Automatic decompression (via zstd) of compressed files over HTTP is supported.
+.RE
diff --git a/docs/cmdline-opts/write-out.d b/docs/cmdline-opts/write-out.d
new file mode 100644
index 0000000..6168059
--- /dev/null
+++ b/docs/cmdline-opts/write-out.d
@@ -0,0 +1,192 @@
+Long: write-out
+Short: w
+Arg: <format>
+Help: Use output FORMAT after completion
+Category: verbose
+Example: -w '%{http_code}\\n' $URL
+---
+Make curl display information on stdout after a completed transfer. The format
+is a string that may contain plain text mixed with any number of
+variables. The format can be specified as a literal "string", or you can have
+curl read the format from a file with "@filename" and to tell curl to read the
+format from stdin you write "@-".
+
+The variables present in the output format will be substituted by the value or
+text that curl thinks fit, as described below. All variables are specified as
+%{variable_name} and to output a normal % you just write them as %%. You can
+output a newline by using \\n, a carriage return with \\r and a tab space with
+\\t.
+
+The output will be written to standard output, but this can be switched to
+standard error by using %{stderr}.
+
+.B NOTE:
+The %-symbol is a special symbol in the win32-environment, where all
+occurrences of % must be doubled when using this option.
+
+The variables available are:
+.RS
+.TP 15
+.B content_type
+The Content-Type of the requested document, if there was any.
+.TP
+.B errormsg
+The error message. (Added in 7.75.0)
+.TP
+.B exitcode
+The numerical exitcode of the transfer. (Added in 7.75.0)
+.TP
+.B filename_effective
+The ultimate filename that curl writes out to. This is only meaningful if curl
+is told to write to a file with the --remote-name or --output
+option. It's most useful in combination with the --remote-header-name
+option. (Added in 7.26.0)
+.TP
+.B ftp_entry_path
+The initial path curl ended up in when logging on to the remote FTP
+server. (Added in 7.15.4)
+.TP
+.B http_code
+The numerical response code that was found in the last retrieved HTTP(S) or
+FTP(s) transfer. In 7.18.2 the alias **response_code** was added to show the
+same info.
+.TP
+.B http_connect
+The numerical code that was found in the last response (from a proxy) to a
+curl CONNECT request. (Added in 7.12.4)
+.TP
+.B http_version
+The http version that was effectively used. (Added in 7.50.0)
+.TP
+.B json
+A JSON object with all available keys.
+.TP
+.B local_ip
+The IP address of the local end of the most recently done connection - can be
+either IPv4 or IPv6. (Added in 7.29.0)
+.TP
+.B local_port
+The local port number of the most recently done connection. (Added in 7.29.0)
+.TP
+.B method
+The http method used in the most recent HTTP request. (Added in 7.72.0)
+.TP
+.B num_connects
+Number of new connects made in the recent transfer. (Added in 7.12.3)
+.TP
+.B num_headers
+The number of response headers in the most recent request (restarted at each
+ redirect). Note that the status line IS NOT a header. (Added in 7.73.0)
+.TP
+.B num_redirects
+Number of redirects that were followed in the request. (Added in 7.12.3)
+.TP
+.B onerror
+The rest of the output is only shown if the transfer returned a non-zero error
+(Added in 7.75.0)
+.TP
+.B proxy_ssl_verify_result
+The result of the HTTPS proxy's SSL peer certificate verification that was
+requested. 0 means the verification was successful. (Added in 7.52.0)
+.TP
+.B redirect_url
+When an HTTP request was made without --location to follow redirects (or when
+--max-redirs is met), this variable will show the actual URL a redirect
+*would* have gone to. (Added in 7.18.2)
+.TP
+.B referer
+The Referer: header, if there was any. (Added in 7.76.0)
+.TP
+.B remote_ip
+The remote IP address of the most recently done connection - can be either
+IPv4 or IPv6. (Added in 7.29.0)
+.TP
+.B remote_port
+The remote port number of the most recently done connection. (Added in 7.29.0)
+.TP
+.B response_code
+The numerical response code that was found in the last transfer (formerly
+known as "http_code"). (Added in 7.18.2)
+.TP
+.B scheme
+The URL scheme (sometimes called protocol) that was effectively used. (Added in 7.52.0)
+.TP
+.B size_download
+The total amount of bytes that were downloaded. This is the size of the
+body/data that was transfered, excluding headers.
+.TP
+.B size_header
+The total amount of bytes of the downloaded headers.
+.TP
+.B size_request
+The total amount of bytes that were sent in the HTTP request.
+.TP
+.B size_upload
+The total amount of bytes that were uploaded. This is the size of the
+body/data that was transfered, excluding headers.
+.TP
+.B speed_download
+The average download speed that curl measured for the complete download. Bytes
+per second.
+.TP
+.B speed_upload
+The average upload speed that curl measured for the complete upload. Bytes per
+second.
+.TP
+.B ssl_verify_result
+The result of the SSL peer certificate verification that was requested. 0
+means the verification was successful. (Added in 7.19.0)
+.TP
+.B stderr
+From this point on, the --write-out output will be written to standard
+error. (Added in 7.63.0)
+.TP
+.B stdout
+From this point on, the --write-out output will be written to standard output.
+This is the default, but can be used to switch back after switching to stderr.
+(Added in 7.63.0)
+.TP
+.B time_appconnect
+The time, in seconds, it took from the start until the SSL/SSH/etc
+connect/handshake to the remote host was completed. (Added in 7.19.0)
+.TP
+.B time_connect
+The time, in seconds, it took from the start until the TCP connect to the
+remote host (or proxy) was completed.
+.TP
+.B time_namelookup
+The time, in seconds, it took from the start until the name resolving was
+completed.
+.TP
+.B time_pretransfer
+The time, in seconds, it took from the start until the file transfer was just
+about to begin. This includes all pre-transfer commands and negotiations that
+are specific to the particular protocol(s) involved.
+.TP
+.B time_redirect
+The time, in seconds, it took for all redirection steps including name lookup,
+connect, pretransfer and transfer before the final transaction was
+started. time_redirect shows the complete execution time for multiple
+redirections. (Added in 7.12.3)
+.TP
+.B time_starttransfer
+The time, in seconds, it took from the start until the first byte was just
+about to be transferred. This includes time_pretransfer and also the time the
+server needed to calculate the result.
+.TP
+.B time_total
+The total time, in seconds, that the full operation lasted.
+.TP
+.B url
+The URL that was fetched. (Added in 7.75.0)
+.TP
+.B urlnum
+The URL index number of this transfer, 0-indexed. De-globbed URLs share the
+same index number as the origin globbed URL. (Added in 7.75.0)
+.TP
+.B url_effective
+The URL that was fetched last. This is most meaningful if you've told curl
+to follow location: headers.
+.RE
+.IP
+If this option is used several times, the last one will be used.
diff --git a/docs/cmdline-opts/xattr.d b/docs/cmdline-opts/xattr.d
new file mode 100644
index 0000000..8011b79
--- /dev/null
+++ b/docs/cmdline-opts/xattr.d
@@ -0,0 +1,10 @@
+Long: xattr
+Help: Store metadata in extended file attributes
+Category: misc
+Example: --xattr -o storage $URL
+---
+When saving output to a file, this option tells curl to store certain file
+metadata in extended file attributes. Currently, the URL is stored in the
+xdg.origin.url attribute and, for HTTP, the content type is stored in
+the mime_type attribute. If the file system does not support extended
+attributes, a warning is issued.
-- 
Gitee


From 205516a3eee76f42f059768947787289a4d8c6f8 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Wed, 31 Aug 2022 14:57:41 +0800
Subject: [PATCH 8/9] modified check-in test script

---
 ci/02-examples.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ci/02-examples.sh b/ci/02-examples.sh
index bc43b82..55e8b6f 100755
--- a/ci/02-examples.sh
+++ b/ci/02-examples.sh
@@ -1,3 +1,3 @@
 #!/bin/bash
 
-RUST_BACKTRACE=1 cargo run --example signals
+# RUST_BACKTRACE=1 cargo run --example signals
-- 
Gitee


From 4fb6273b88776c6e5395096893f8cc5bf1803387 Mon Sep 17 00:00:00 2001
From: zzy <1377519372@qq.com>
Date: Wed, 31 Aug 2022 17:09:32 +0800
Subject: [PATCH 9/9] update README.md

---
 README.md | 30 +++++++++++++++++++-----------
 1 file changed, 19 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index b31f6c2..e51fd85 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,31 @@
 # curl-rust
 
 #### 介绍
-Rewrite memory leak related modules for curl using Rust
 
-#### 软件架构
-软件架构说明
+cURL 提供了curl（命令行工具）和 libcurl（C语言的API库），两者功能均是基于网络协议，对指定 URL 进行网络传输。cURL 使用C语言实现，libcurl 历史安全漏洞较多，其中内存类占比51%。本项目通过使用 Rust 重写 cURL 的高危模块，利用 Rust 语言的内存安全优势，以增加 libcurl 的安全性和可靠性。
 
+#### 项目实施方案
 
-#### 安装教程
+对 cURL 的改写，分为以下步骤进行：
 
-1.  进入`rust/`目录，执行`cargo build`
-2.  在项目根目录下，执行`LDFLAGS="-L./rust/target/debug" LIBS="-lrust_project -ldl" ./configure --disable-shared`
-3.  执行`make`完成编译
+- 构建 Rust 项目结构，确定重写的部分的组织方式
+- 使用 c2rust 工具自动改写 C 代码
+- 手动将一些数据结构定义和函数声明移动到公共模块中
+- 改写宏定义
+- 与 C 代码混合编译并通过测试
 
-#### 使用说明
+#### 编译教程
 
-1.  xxxx
-2.  xxxx
-3.  xxxx
+需准备前置条件，以便 curl-rust 能正确地编译，需要的前置条件有：
+make, rustup, cargo, nightly 版的 rustc, gcc, openssl-libs, automake 等。
+
+准备好前置条件后，可以按如下步骤完成编译：
+
+1.  进入`rust/`目录，执行`cargo build --release -v`
+2.  在项目根目录下，执行`aclocal`和`automake`
+3.  在项目根目录下，执行`LDFLAGS="-L./rust/target/debug" LIBS="-lrust_project -ldl" ./configure --without-ssl --disable-shared`
+4.  执行`make`完成编译
+5.  还可以执行`make test`进行测试
 
 #### 参与贡献
 
-- 
Gitee