mirror of
https://github.com/borgbackup/borg.git
synced 2026-09-01 14:13:19 +02:00
There are 3 kinds of --sort-by now (archives, items, item diffs), each with its own set of valid sort keys, so the completion helper is generated once per key set from one template per shell. diff --sort-by had no completion at all before. tcsh matches completion rules by option name only, in one flat namespace for all subcommands, so there it stays one helper offering the union of all keys.
56 lines
No EOL
2.4 KiB
HTML
56 lines
No EOL
2.4 KiB
HTML
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
.. _borg_completion:
|
|
|
|
borg completion
|
|
---------------
|
|
.. code-block:: none
|
|
|
|
borg [common options] completion [options] SHELL
|
|
|
|
.. only:: html
|
|
|
|
.. class:: borg-options-table
|
|
|
|
+-------------------------------------------------------+-----------+--------------------------------------------------------+
|
|
| **positional arguments** |
|
|
+-------------------------------------------------------+-----------+--------------------------------------------------------+
|
|
| | ``SHELL`` | shell to generate completion for (one of: %(choices)s) |
|
|
+-------------------------------------------------------+-----------+--------------------------------------------------------+
|
|
| .. class:: borg-common-opt-ref |
|
|
| |
|
|
| :ref:`common_options` |
|
|
+-------------------------------------------------------+-----------+--------------------------------------------------------+
|
|
|
|
.. raw:: html
|
|
|
|
<script type='text/javascript'>
|
|
$(document).ready(function () {
|
|
$('.borg-options-table colgroup').remove();
|
|
})
|
|
</script>
|
|
|
|
.. only:: latex
|
|
|
|
SHELL
|
|
shell to generate completion for (one of: %(choices)s)
|
|
|
|
|
|
:ref:`common_options`
|
|
|
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
This command prints a shell completion script for the given shell.
|
|
|
|
Please note that for some dynamic completions (like archive IDs), the shell
|
|
completion script will call borg to query the repository. This will work best
|
|
if that call can be made without prompting for user input, so you may want to
|
|
set BORG_REPO and BORG_PASSPHRASE environment variables.
|
|
|
|
In tcsh, completions for positional arguments are matched by word position, so
|
|
e.g. an archive name is only completed if no options precede it - one more
|
|
reason to use BORG_REPO there rather than --repo. Also, options are matched by
|
|
name only, so --sort-by offers the union of the sort keys valid for list, diff
|
|
and the commands filtering archives. |