I don't have experience doing advanced networking, but should there also be some kind of structure in this area somewhere so it says something like:

route [-n] command [-net | -host] destination [gateway [-weight] [netmask]] [-fib number]

Maybe?

I don't have experience doing advanced networking, but should there also be some kind of structure in this area somewhere so it says something like:

route [-n] command [-net | -host] destination [gateway [-weight] [netmask]] [-fib number]

You're right, we should include -weight and -metric in that too.
but there are too many keywords too include AND you can use -metric without specifying -gateway during route del and vice versa.
So [gateway [-weight] [netmask]] won't help much.

I prefer to use word selected instead of preferred.
words like cost, metric, preference are similar but have their own technical meaning in routing stack.
I don't want to accidentally confuse users.

sounds like we need another list like what's on 335. we could do that in a followup commit, if you want?

okay, thanks for explaining!

Yes! That's a good idea.
I'll work on one in another revision.