mirror
/
borg
mirror of https://github.com/borgbackup/borg.git
1
0
Fork 0
Code Issues Releases Wiki Activity
borg/docs/usage/general/positional-arguments.rst.inc

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

16 lines
621 B
PHP
Raw Normal View History

[DOCS] #4587 – Make Sphinx warnings break docs build 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.
2020-03-16 18:17:16 +00:00
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:
::
build_usage / build_man / doc updates
2022-06-23 23:19:19 +00:00
borg create -s --progress archive path # good and preferred
borg create archive path -s --progress # also works
borg create -s archive path --progress # works, but ugly
borg create archive -s --progress path # BAD
[DOCS] #4587 – Make Sphinx warnings break docs build 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.
2020-03-16 18:17:16 +00:00
Use HTTPS everywhere (mechanical edit using util from https-everywhere) Ref: https://github.com/EFForg/https-everywhere/tree/master/utils/rewriter ```Shell ~/src/EFForg/https-everywhere/utils/rewriter/rewriter.js . ``` A few changes were reset/fixed manually before the commit.
2020-12-19 19:11:32 +00:00
This is due to a problem in the argparse module: https://bugs.python.org/issue15112