mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-27 10:18:12 +00:00
19aa9825a8
general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels.
15 lines
644 B
HTML
15 lines
644 B
HTML
Positional Arguments and Options: Order matters
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Borg only supports taking options (``-s`` and ``--progress`` in the example)
|
|
to the left or right of all positional arguments (``repo::archive`` and ``path``
|
|
in the example), but not in between them:
|
|
|
|
::
|
|
|
|
borg create -s --progress repo::archive path # good and preferred
|
|
borg create repo::archive path -s --progress # also works
|
|
borg create -s repo::archive path --progress # works, but ugly
|
|
borg create repo::archive -s --progress path # BAD
|
|
|
|
This is due to a problem in the argparse module: http://bugs.python.org/issue15112
|