borg/docs/usage/completion.rst.inc
Thomas Waldmann 465e9fa22a
completion: complete the --sort-by fields of list and diff
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.
2026-08-12 15:59:40 +02:00

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.