Update CLI options

Author: mre

src/content/docs/usage/cli.md

@@ -23,7 +23,7 @@ Arguments:
 Options:
   -c, --config <CONFIG_FILE>
           Configuration file to use
-
+          
           [default: lychee.toml]
 
   -v, --verbose...
@@ -41,9 +41,25 @@ Options:
 
       --max-cache-age <MAX_CACHE_AGE>
           Discard all cached requests older than this duration
-
+          
           [default: 1d]
 
+      --cache-exclude-status <CACHE_EXCLUDE_STATUS>
+          A list of status codes that will be ignored from the cache
+          
+          The following accept range syntax is supported: [start]..[=]end|code. Some valid
+          examples are:
+          
+          - 429
+          - 500..=599
+          - 500..
+          
+          Use "lychee --cache-exclude-status '429, 500..502' <inputs>..." to provide a comma- separated
+          list of excluded status codes. This example will not cache results with a status code of 429, 500,
+          501 and 502.
+          
+          [default: ]
+
       --dump
           Don't perform any link checking. Instead, dump all the links extracted from inputs that would be checked
 
@@ -52,34 +68,34 @@ Options:
 
       --archive <ARCHIVE>
           Specify the use of a specific web archive. Can be used in combination with `--suggest`
-
+          
           [possible values: wayback]
 
       --suggest
           Suggest link replacements for broken links, using a web archive. The web archive can be specified with `--archive`
 
   -m, --max-redirects <MAX_REDIRECTS>
           Maximum number of allowed redirects
-
+          
           [default: 5]
 
       --max-retries <MAX_RETRIES>
           Maximum number of retries per request
-
+          
           [default: 3]
 
       --max-concurrency <MAX_CONCURRENCY>
           Maximum number of concurrent network requests
-
+          
           [default: 128]
 
   -T, --threads <THREADS>
           Number of threads to utilize. Defaults to number of cores available to the system
 
   -u, --user-agent <USER_AGENT>
           User agent
-
-          [default: lychee/0.14.2]
+          
+          [default: lychee/0.18.0]
 
   -i, --insecure
           Proceed for server connections considered insecure (invalid TLS)
@@ -128,62 +144,71 @@ Options:
           Test the specified file extensions for URIs when checking files locally.
           Multiple extensions can be separated by commas. Extensions will be checked in
           order of appearance.
-
+          
           Example: --fallback-extensions html,htm,php,asp,aspx,jsp,cgi
 
       --header <HEADER>
           Custom request header
 
   -a, --accept <ACCEPT>
           A List of accepted status codes for valid links
-
+          
           The following accept range syntax is supported: [start]..[=]end|code. Some valid
           examples are:
-
+          
           - 200..=204
           - 200..204
           - ..=204
           - ..204
           - 200
-
+          
           Use "lychee --accept '200..=204, 429, 500' <inputs>..." to provide a comma-
           separated list of accepted status codes. This example will accept 200, 201,
           202, 203, 204, 429, and 500 as valid status codes.
-
+          
           [default: 100..=103,200..=299]
 
       --include-fragments
           Enable the checking of fragments in links
 
   -t, --timeout <TIMEOUT>
           Website timeout in seconds from connect to response finished
-
+          
           [default: 20]
 
   -r, --retry-wait-time <RETRY_WAIT_TIME>
           Minimum wait time in seconds between retries of failed requests
-
+          
           [default: 1]
 
   -X, --method <METHOD>
           Request method
-
+          
           [default: get]
 
   -b, --base <BASE>
-          Base URL or website root directory to check relative URLs e.g. https://example.com or `/path/to/public`
+          Base URL or website root directory to check relative URLs e.g. <https://example.com> or `/path/to/public`
+
+      --root-dir <ROOT_DIR>
+          Root path to use when checking absolute local links, must be an absolute path
 
       --basic-auth <BASIC_AUTH>
           Basic authentication support. E.g. `http://example.com username:password`
 
       --github-token <GITHUB_TOKEN>
           GitHub API token to use when checking github.com links, to avoid rate limiting
-
+          
           [env: GITHUB_TOKEN]
 
       --skip-missing
           Skip missing input files (default is to error if they don't exist)
 
+      --no-ignore
+          Do not skip files that would otherwise be ignored by '.gitignore', '.ignore', or the global ignore file
+
+      --hidden
+          Do not skip hidden directories and files
+
       --include-verbatim
           Find links in verbatim sections like `pre`- and `code` blocks
 
@@ -193,10 +218,17 @@ Options:
   -o, --output <OUTPUT>
           Output file of status report
 
-  -f, --format <FORMAT>
-          Output format of final status report (compact, detailed, json, markdown)
+      --mode <MODE>
+          Set the output display mode. Determines how results are presented in the terminal
+          
+          [default: color]
+          [possible values: plain, color, emoji]
 
+  -f, --format <FORMAT>
+          Output format of final status report
+          
           [default: compact]
+          [possible values: compact, detailed, json, markdown, raw]
 
       --require-https
           When HTTPS is available, treat HTTP links as errors
@@ -209,7 +241,6 @@ Options:
 
   -V, --version
           Print version
-
 ```
 
 :::note