1Positional Arguments and Options: Order matters
2~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
4Borg only supports taking options (``-s`` and ``--progress`` in the example)
5to the left or right of all positional arguments (``repo::archive`` and ``path``
6in the example), but not in between them:
7
8::
9
10    borg create -s --progress repo::archive path  # good and preferred
11    borg create repo::archive path -s --progress  # also works
12    borg create -s repo::archive path --progress  # works, but ugly
13    borg create repo::archive -s --progress path  # BAD
14
15This is due to a problem in the argparse module: https://bugs.python.org/issue15112
16