9a0cf56471
Since the documentation text blob might be gzipped, it needs to search for what to output in a streaming manner. It then first searches for "\nALL OPTIONS". Then, it looks for the start to display at "\n -[option]" and stops again at "\n -". Except for the last option in the man page, which ends at "\nFILES" - the subtitle for the section following all options in the manpage. Test 1707 to 1710 verify Closes #13997
1.2 KiB
OPTIONS
Options start with one or two dashes. Many of the options require an additional value next to them. If provided text does not start with a dash, it is presumed to be and treated as a URL.
The short "single-dash" form of the options, -d for example, may be used with or without a space between it and its value, although a space is a recommended separator. The long double-dash form, --data for example, requires a space between it and its value.
Short version options that do not need any additional values can be used immediately next to each other, like for example you can specify all the options -O, -L and -v at once as -OLv.
In general, all boolean options are enabled with --option and yet again
disabled with --**no-**option. That is, you use the same option name but
prefix it with no-. However, in this list we mostly only list and show the
--option version of them.
When --next is used, it resets the parser state and you start again with a clean option state, except for the options that are global. Global options retain their values and meaning even after --next.
The following options are global: %GLOBALS.