curl.1: provide examples for each option

The file format for each option now features a "Example:" header that
can provide one or more examples that get rendered appropriately in the
output. All options MUST have at least one example or gen.pl complains
at build-time.

This fix also does a few other minor format and consistency cleanups.

Closes #7654
This commit is contained in:
Daniel Stenberg 2021-08-31 16:37:14 +02:00
parent c905459e87
commit 68784d73c3
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
245 changed files with 348 additions and 53 deletions

View file

@ -4,6 +4,7 @@ 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
@ -14,3 +15,5 @@ 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.