From a91dd04d11ed5c69b7b4ec7edfcd2bc2b09f2081 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Sat, 26 Mar 2022 23:40:03 +0100
Subject: [PATCH] docs: usage: add benchmark cpu and key change-location

---
 docs/usage/benchmark.rst               |  2 +
 docs/usage/benchmark_cpu.rst.inc       | 44 ++++++++++++++++++
 docs/usage/key.rst                     |  2 +
 docs/usage/key_change-location.rst.inc | 63 ++++++++++++++++++++++++++
 4 files changed, 111 insertions(+)
 create mode 100644 docs/usage/benchmark_cpu.rst.inc
 create mode 100644 docs/usage/key_change-location.rst.inc

diff --git a/docs/usage/benchmark.rst b/docs/usage/benchmark.rst
index 27436a9b1..f70349b36 100644
--- a/docs/usage/benchmark.rst
+++ b/docs/usage/benchmark.rst
@@ -1 +1,3 @@
 .. include:: benchmark_crud.rst.inc
+
+.. include:: benchmark_cpu.rst.inc
diff --git a/docs/usage/benchmark_cpu.rst.inc b/docs/usage/benchmark_cpu.rst.inc
new file mode 100644
index 000000000..f02aeefd7
--- /dev/null
+++ b/docs/usage/benchmark_cpu.rst.inc
@@ -0,0 +1,44 @@
+.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
+
+.. _borg_benchmark_cpu:
+
+borg benchmark cpu
+------------------
+.. code-block:: none
+
+    borg [common options] benchmark cpu [options]
+
+.. only:: html
+
+    .. class:: borg-options-table
+
+    +-------------------------------------------------------+
+    | .. 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
+
+
+
+    :ref:`common_options`
+        |
+
+Description
+~~~~~~~~~~~
+
+This command benchmarks misc. CPU bound borg operations.
+
+It creates input data in memory, runs the operation and then displays throughput.
+To reduce outside influence on the timings, please make sure to run this with:
+- an otherwise as idle as possible machine
+- enough free memory so there will be no slow down due to paging activity
\ No newline at end of file
diff --git a/docs/usage/key.rst b/docs/usage/key.rst
index 10ccdfe5b..d923fd2dc 100644
--- a/docs/usage/key.rst
+++ b/docs/usage/key.rst
@@ -2,6 +2,8 @@
 
 .. include:: key_change-passphrase.rst.inc
 
+.. include:: key_change-location.rst.inc
+
 Examples
 ~~~~~~~~
 ::
diff --git a/docs/usage/key_change-location.rst.inc b/docs/usage/key_change-location.rst.inc
new file mode 100644
index 000000000..879eae995
--- /dev/null
+++ b/docs/usage/key_change-location.rst.inc
@@ -0,0 +1,63 @@
+.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
+
+.. _borg_key_change-location:
+
+borg key change-location
+------------------------
+.. code-block:: none
+
+    borg [common options] key change-location [options] [REPOSITORY] KEY_LOCATION
+
+.. only:: html
+
+    .. class:: borg-options-table
+
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    | **positional arguments**                                                                                                                  |
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    |                                                       | ``REPOSITORY``   |                                                                |
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    |                                                       | ``KEY_LOCATION`` | select key location                                            |
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    | **optional arguments**                                                                                                                    |
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    |                                                       | ``--keep``       | keep the key also at the current location (default: remove it) |
+    +-------------------------------------------------------+------------------+----------------------------------------------------------------+
+    | .. 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
+
+    REPOSITORY
+
+    KEY_LOCATION
+        select key location
+
+
+    optional arguments
+        --keep     keep the key also at the current location (default: remove it)
+
+
+    :ref:`common_options`
+        |
+
+Description
+~~~~~~~~~~~
+
+Change the location of a borg key. The key can be stored at different locations:
+
+keyfile: locally, usually in the home directory
+repokey: inside the repo (in the repo config)
+
+Note: this command does NOT change the crypto algorithms, just the key location,
+      thus you must ONLY give the key location (keyfile or repokey).
\ No newline at end of file