For fcli help output, synopsis output was improved in https://github.com/fortify/fcli/commit/78b530cde00e514be59377d2f80d6479a90d893b (showing positional parameters before options), but manual pages still show the old format. If possible, synopsis format in manual pages should match synopsis format from fcli help output:
Manual page:
Help output:
Notice how <action> is shown before the options list (which is more logical from a user perspective), rather than after the options list.
Enhancement Request
For fcli help output, synopsis output was improved in https://github.com/fortify/fcli/commit/78b530cde00e514be59377d2f80d6479a90d893b (showing positional parameters before options), but manual pages still show the old format. If possible, synopsis format in manual pages should match synopsis format from fcli help output:
Manual page:
Help output:
Notice how
<action>
is shown before the options list (which is more logical from a user perspective), rather than after the options list.