Ordering of command line options in curl manpage (fwd)

-- 
  / daniel.haxx.se
---------- Forwarded message ----------
Date: Sat, 9 Dec 2023 09:01:59
From: Boris Verkhovskiy
To: "daniel_at_haxx.se" <daniel_at_haxx.se>
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