Ordering of command line options in curl manpage (fwd)

Forwarded to the list

-- 

  / daniel.haxx.se

---------- Forwarded message ----------
Date: Sat, 9 Dec 2023 09:01:59
From: Boris Verkhovskiy
To: "[email protected]" <[email protected]>
Subject: Ordering of command line options in curl manpage

Hello, just a quick minor thing that has been bothering me whenever I'm
reading the curl docs is that it sorts the "absence of character" as the
last letter of the alphabet

What I mean is that on
https://curl.se/docs/manpage.html

The order of the arguments is

--data-ascii
--data-binary
--data-raw
--data-urlencode
--data

and also

--location-trusted
--location

Instead, it should be

--data
--data-ascii
--data-binary
--data-raw
--data-urlencode

and

--location
--location-trusted

It just doesn't make any sense that all the --data-* arguments, which all
mention --data should appear before it. Similarly, --location-trusted is a
specific form of --location, and there's probably a few other flags, the
point being is that when an option is a shorter section of a different
option, it's always the more important one and the one readers are more
likely to be searching for.
This annoyed me when I had to refer to the documentation a lot, because I
do "ctrl-f" for "--data", the option I want, but then have to actually
scroll past 4 options I'm not interested in. so "absence of character"
should be treated as the 0th letter of the alphabet.

Thanks.
-- 
Unsubscribe: https://lists.haxx.se/mailman/listinfo/curl-users
Etiquette:   https://curl.se/mail/etiquette.html