Option now accepts just two arguments and intended to show long or short options. But it breaks standardization and makes impossible to write something like this:
But treat them specially (as short - long option pair) when GNU-style long and short option are both provided (it keeps backward compatibility).
On the other hand I can introduce comprehensive placeholders first and then make option placeholder comprehensive. It makes sense to always list all available options in the context of some code example.
Option now accepts just two arguments and intended to show long or short options. But it breaks standardization and makes impossible to write something like this:
This workaround:
results in unsupported placeholder.
How to solve?
On the other hand I can introduce comprehensive placeholders first and then make option placeholder comprehensive. It makes sense to always list all available options in the context of some code example.