dar-backup 0.6.21__py3-none-any.whl → 0.7.2__py3-none-any.whl

{dar_backup-0.6.21.dist-info → dar_backup-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 0.6.21
+Version: 0.7.2
 Summary: A script to do full, differential and incremental backups using dar.     Some files are restored from the backups during verification, after which par2 redundancy files are created.     The script also has a cleanup feature to remove old backups and par2 files.
 Project-URL: GPG Public Key, https://keys.openpgp.org/search?q=dar-backup@pm.me
 Project-URL: Homepage, https://github.com/per2jensen/dar-backup/tree/main/v2
@@ -691,7 +691,27 @@ Classifier: Topic :: System :: Archiving :: Backup
 Requires-Python: >=3.9
 Requires-Dist: argcomplete>=3.6.2
 Requires-Dist: inputimeout>=1.0.4
+Requires-Dist: jinja2>=3.1.6
 Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: anyio>=4.4.0; extra == 'dev'
+Requires-Dist: black>=25.1.0; extra == 'dev'
+Requires-Dist: coverage>=7.8.2; extra == 'dev'
+Requires-Dist: h11>=0.16.0; extra == 'dev'
+Requires-Dist: httpcore>=0.17.3; extra == 'dev'
+Requires-Dist: psutil>=7.0.0; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov>=6.1.1; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest>=8.4.0; extra == 'dev'
+Requires-Dist: requests>=2.32.2; extra == 'dev'
+Requires-Dist: wheel>=0.45.1; extra == 'dev'
+Requires-Dist: zipp>=3.19.1; extra == 'dev'
+Provides-Extra: packaging
+Requires-Dist: build>=1.2.2; extra == 'packaging'
+Requires-Dist: hatch>=1.14.1; extra == 'packaging'
+Requires-Dist: hatchling>=1.27.0; extra == 'packaging'
+Requires-Dist: twine>=6.1.0; extra == 'packaging'
 Description-Content-Type: text/markdown
 
 <!-- markdownlint-disable MD024 -->
@@ -699,11 +719,13 @@ Description-Content-Type: text/markdown
 
 **Reliable DAR backups, automated in clean Python**
 
-[![codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Snyk Vuln findings](https://snyk.io/test/github/per2jensen/dar-backup/badge.svg)](https://snyk.io/test/github/per2jensen/dar-backup)
 ![CI](https://github.com/per2jensen/dar-backup/actions/workflows/py-tests.yml/badge.svg)
 [![PyPI version](https://img.shields.io/pypi/v/dar-backup.svg)](https://pypi.org/project/dar-backup/)
-[![PyPI monthly downloads](https://img.shields.io/pypi/dm/dar-backup)](https://pypi.org/project/dar-backup/)
-[![Total Downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=Total%20Downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+[![PyPI downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=PyPI%20downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+[![# clones](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/badge_clones.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
+[![Milestone](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/milestone_badge.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 
 The wonderful 'dar' [Disk Archiver](https://github.com/Edrusb/DAR) is used for
 the heavy lifting, together with the [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
@@ -712,14 +734,16 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
 
 ## TL;DR
 
-`dar-backup` is a Python-powered CLI for creating and validating full, differential, and incremental backups using dar and par2. Designed for long-term restore integrity, even on user-space filesystems like FUSE.
+`dar-backup` is a Python-powered CLI for creating and validating full, differential, and incremental backups using `dar` and `par2`. Designed for long-term restore integrity, even on user-space filesystems like FUSE.
 
 ## Table of Contents
 
 - [Reliable `dar` backups wrapped in Python](#dar-backup)
 - [My use case](#my-use-case)
+- [Features](#features)
 - [License](#license)
 - [Changelog version 2](https://github.com/per2jensen/dar-backup/blob/main/v2/Changelog.md)
+- [Quick Guide](#quick-guide)
 - [Status](#status)
   - [GPG Signing key](#gpg-signing-key)
   - [Breaking change in version 0.6.0](#breaking-change-in-version-060)
@@ -731,7 +755,7 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [1 - installation](#1---installation)
   - [2 - configuration](#2---configuration)
   - [3 - generate catalog databases](#3---generate-catalog-databases)
-  - [4 - do FULL backups](#4---do-full-backups)
+  - [4 - give `dar-backup` a spin](#4---give-dar-backup-a-spin)
   - [5 - deactivate venv](#5---deactivate-venv)
 - [Config](#config)
   - [Config file](#config-file)
@@ -766,6 +790,7 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [Skipping cache directories](#skipping-cache-directories)
   - [Progress bar + current directory](#progress-bar-and-current-directory)
   - [Shell Autocompletion](#shell-autocompletion)
+  - [Easy development setup](#easy-development-setup)
 - [Todo](#todo)
 - [Known Limitations / Edge Cases](#known-limitations--edge-cases)
 - [Reference](#reference)
@@ -775,21 +800,22 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [manager](#manager-options)
   - [cleanup](#cleanup-options)
   - [clean-log](#clean-log-options)
-  - [dar-backup-systemd](#dar-backup-systemd)
-  - [Installer](#installer)
-  - [demo](#demo)
+  - [dar-backup-systemd](#dar-backup-systemd-options)
+  - [Installer](#installer-options)
+  - [demo](#demo-options)
   
 ## My use case
 
-I have cloud storage mounted on a directory within my home dir. The filesystem is [FUSE based](https://www.kernel.org/doc/html/latest/filesystems/fuse.html), which gives it a few special features
+I needed the following:
 
-- a non-privileged user can perform a mount
-- a privileged user cannot look into the filesystem --> a backup script running as root is not suitable
+- Backup my workstation to a remote server
+- Backup primarily photos, home made video and different types of documents
+- I have cloud storage mounted on a directory within my home dir. The filesystem is [FUSE based](https://www.kernel.org/doc/html/latest/filesystems/fuse.html), which gives it a few special features
 
- I needed the following:
+  - Backup cloud storage (cloud is convenient, but I want control over my backups)
+  - A non-privileged user can perform a mount
+  - A privileged user cannot look into the filesystem --> a backup script running as root is not suitable
 
-- Backup my cloud storage to something local (cloud is convenient, but I want control over my backups)
-- Backup primarily photos, video and different types of documents
 - Have a simple way of restoring, possibly years into the future. 'dar' fits that scenario with a single statically linked binary (kept with the archives). There is no need install/configure anything - restoring is simple and works well.
 - During backup archives must be tested and a restore test (however small) performed
 - Archives stored on a server with a reliable file system (easy to mount a directory over sshfs)
@@ -797,11 +823,252 @@ I have cloud storage mounted on a directory within my home dir. The filesystem i
 
  I do not need the encryption features of dar, as all storage is already encrypted.
 
+## Features
+
+- The battle tested [dar](https://github.com/Edrusb/DAR) Disk Archiver is used for the actual backups - it comes highly recommended.
+- Backup with test of backup and (configurable) restore tests of files with comparison to source
+- [Redundancy files](#par2) created for patching bitrot of the archives (size configurable)
+- Simple [backup definitions](#backup-definition-example) defining what to backup (as many as you need)
+- [Backup catalogs](#dar-manager-databases) in databases, optionally on a disk different from the backups
+- Flexible and precise logging
+- Bash and zsh shell autocompletion for a nice CLI experience, [available completions](#shell-autocompletion):
+  
+  - Options for `dar-backup`, `cleanup`, `manager`
+  - Backup definitions
+  - Archives - filtered to backup definition if given
+  - Catalogs - filtered to backup definition if given
+
+- `dar-backup` is easy to install and configure.
+
+- ✅ The author has used dar-backup since > 4 years, and has been saved multiple times.
+
 ## License
 
   These scripts are licensed under the GPLv3 license.
   Read more here: [GNU  GPL3.0](https://www.gnu.org/licenses/gpl-3.0.en.html), or have a look at the ["LICENSE"](https://github.com/per2jensen/dar-backup/blob/main/LICENSE) file in this repository.
 
+## Quick Guide
+
+This purpose of this quick guide is to show how `dar-backup` works in a few simple steps.
+
+The package include a `demo`application, that can help you set up `dar-backup` quickly.
+
+> ⚠️ **Assumption**
+>
+> The demo program uses these directories in your home directory:
+>
+> - $HOME/dar-backup
+> - $HOME/.config/dar-backup
+>
+> It is assumed they **do not exist** before running the demo.
+>
+> Python **>= 3.9** is required
+
+<br>
+
+**Let's roll** with installation, backup, list backup content, restore & restore check
+
+The demo is known to work on an Ubuntu 24.04 clean VM as delivered from `Multipass`
+
+```bash
+sudo apt -y install dar par2 python3 python3-venv
+INSTALL_DIR=/tmp/dar-backup
+mkdir "$INSTALL_DIR"
+cd "$INSTALL_DIR"
+python3 -m venv venv    # create the virtual environment 
+. venv/bin/activate     # activate the virtual environment
+pip install dar-backup  # run pip to install `dar-backup` into the virtual environment
+```
+
+<details>
+
+<summary>🎯 Install details</summary>
+
+```bash
+(venv) $ INSTALL_DIR=/tmp/dar-backup
+mkdir "$INSTALL_DIR"
+cd "$INSTALL_DIR"
+python3 -m venv venv    # create the virtual environment 
+. venv/bin/activate     # activate the virtual environment
+pip install dar-backup  # run pip to install `dar-backup`
+Collecting dar-backup
+  Downloading dar_backup-0.6.21-py3-none-any.whl.metadata (88 kB)
+     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 88.5/88.5 kB 3.7 MB/s eta 0:00:00
+Collecting argcomplete>=3.6.2 (from dar-backup)
+  Using cached argcomplete-3.6.2-py3-none-any.whl.metadata (16 kB)
+Collecting inputimeout>=1.0.4 (from dar-backup)
+  Using cached inputimeout-1.0.4-py3-none-any.whl.metadata (2.2 kB)
+Collecting rich>=13.0.0 (from dar-backup)
+  Using cached rich-14.0.0-py3-none-any.whl.metadata (18 kB)
+Collecting markdown-it-py>=2.2.0 (from rich>=13.0.0->dar-backup)
+  Using cached markdown_it_py-3.0.0-py3-none-any.whl.metadata (6.9 kB)
+Collecting pygments<3.0.0,>=2.13.0 (from rich>=13.0.0->dar-backup)
+  Using cached pygments-2.19.1-py3-none-any.whl.metadata (2.5 kB)
+Collecting mdurl~=0.1 (from markdown-it-py>=2.2.0->rich>=13.0.0->dar-backup)
+  Using cached mdurl-0.1.2-py3-none-any.whl.metadata (1.6 kB)
+Downloading dar_backup-0.6.21-py3-none-any.whl (101 kB)
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 101.9/101.9 kB 16.2 MB/s eta 0:00:00
+Using cached argcomplete-3.6.2-py3-none-any.whl (43 kB)
+Using cached inputimeout-1.0.4-py3-none-any.whl (4.6 kB)
+Using cached rich-14.0.0-py3-none-any.whl (243 kB)
+Using cached markdown_it_py-3.0.0-py3-none-any.whl (87 kB)
+Using cached pygments-2.19.1-py3-none-any.whl (1.2 MB)
+Using cached mdurl-0.1.2-py3-none-any.whl (10.0 kB)
+Installing collected packages: pygments, mdurl, inputimeout, argcomplete, markdown-it-py, rich, dar-backup
+Successfully installed argcomplete-3.6.2 dar-backup-0.6.21 inputimeout-1.0.4 markdown-it-py-3.0.0 mdurl-0.1.2 pygments-2.19.1 rich-14.0.0
+```
+
+</details>
+
+Setup the demo configurations and show a few operations
+
+<br>
+
+```bash
+# See reference section for options tweaking the install
+demo --install
+
+# create catalog database
+manager --create-db
+
+# FULL backup as defined in backup definition `demo`
+dar-backup --full-backup  
+
+# List the contents of the backup
+dar-backup --list-contents demo_FULL_$(date '+%F')
+```
+
+<details>
+
+<summary>🎯 --list details</summary>
+
+```bash
+(venv) $ demo --install
+Directories created.
+File generated at '/home/user/.config/dar-backup/backup.d/demo'
+File generated at '/home/user/.config/dar-backup/dar-backup.conf'
+1. Now run `manager --create-db` to create the catalog database.
+2. Then you can run `dar-backup --full-backup` to create a backup.
+3. List backups with `dar-backup --list`
+4. List contents of a backup with `dar-backup --list-contents <backup-name>`
+
+
+
+(venv) $ manager --create-db 
+========== Startup Settings ==========
+manager.py:     0.7.1
+Config file:    /home/user/.config/dar-backup/dar-backup.conf
+Logfile:        /home/user/dar-backup/dar-backup.log
+dar_manager:    /home/user/.local/dar/bin/dar_manager
+dar_manager v.: 1.9.0
+======================================
+
+
+
+(venv) $ dar-backup --full-backup
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+======================================
+
+
+
+(venv) $ dar-backup --list-contents demo_FULL_$(date '+%F')
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+======================================
+[Saved][-]       [-L-][  49%][ ]  drwx------   user user  8 kio Sat May 17 13:13:59 2025  .config
+[Saved][-]       [-L-][  49%][ ]  drwxrwxr-x   user user  8 kio Tue May  6 20:55:40 2025  .config/dar-backup
+[Saved][-]       [-L-][  48%][ ]  drwxrwxr-x   user user  6 kio Sat May 17 13:26:21 2025  .config/dar-backup/backup.d
+[Saved][ ]       [-L-][  40%][ ]  -rw-rw-r--   user user  764 o Sun Feb 23 21:23:01 2025  .config/dar-backup/backup.d/media-files
+[Saved][ ]       [-L-][  41%][ ]  -rw-rw-r--   user user  933 o Sun Feb 23 21:23:15 2025  .config/dar-backup/backup.d/pCloudDrive
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  1 kio Sun Mar 16 10:40:29 2025  .config/dar-backup/backup.d/test
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  824 o Tue May 13 17:00:52 2025  .config/dar-backup/backup.d/default
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  1 kio Sat May  3 10:40:33 2025  .config/dar-backup/backup.d/user-homedir
+[Saved][ ]       [-L-][  54%][ ]  -rw-rw-r--   user user  1 kio Sat May 17 18:17:40 2025  .config/dar-backup/backup.d/demo
+[Saved][ ]       [-L-][  55%][ ]  -rw-rw-r--   user user  1 kio Sat May 17 18:17:40 2025  .config/dar-backup/dar-backup.conf
+```
+
+</details>
+
+<br>
+
+Perform a restore and show the restored files
+
+```bash
+# Restore all files in the backup
+dar-backup --restore demo_FULL_$(date '+%F') --verbose
+
+# Prove the files have been restored to directory as configured
+find $HOME/dar-backup/restore
+```
+
+<details>
+
+<summary>🎯 --restore details</summary>
+
+```bash
+(venv) $ dar-backup --restore demo_FULL_$(date '+%F') --verbose
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+Backup.d dir:     /home/user/.config/dar-backup/backup.d
+Backup dir:       /home/user/dar-backup/backups
+Restore dir:      /home/user/dar-backup/restore
+Logfile location: /home/user/dar-backup/dar-backup.log
+PAR2 enabled:     True
+--do-not-compare: False
+======================================
+
+
+
+(venv) $ find ~/dar-backup/restore/
+/home/user/dar-backup/restore/
+/home/user/dar-backup/restore/.config
+/home/user/dar-backup/restore/.config/dar-backup
+/home/user/dar-backup/restore/.config/dar-backup/backup.d
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/media-files
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/pCloudDrive
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/test
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/default
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/user-homedir
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/demo
+/home/user/dar-backup/restore/.config/dar-backup/dar-backup.conf
+```
+
+</details>
+
+<br>
+
+> ✅ **Next steps**
+>
+> Play with `demo's` options:
+>
+> - --root-dir      (perhaps $HOME)
+> - --dir-to-backup (perhaps Pictures)
+> - --backup-dir    (perhaps /media/user/big-disk)
+>
+> See log file: `cat "$HOME/dar-backup/dar-backup.log"`
+>
+> Checkout [systemd timers and services](#generate-systemd-files)
+>
+> Checkout [shell autocompletion (very nice !)](#shell-autocompletion)
+>
+> Checkout the [reference section](#reference)
+
 ## Status
 
 As of August 8, 2024 I am using the alpha versions of `dar-backup` (alpha-0.5.9 onwards) in my automated backup routine.
@@ -923,8 +1190,9 @@ Please review the [Code of Conduct](https://github.com/per2jensen/dar-backup/blo
 
 ## Requirements
 
+- A linux system
 - dar
-- par2
+- parchive (par2)
 - python3
 - python3-venv
 
@@ -977,7 +1245,7 @@ See more [here](#gpg-signing-key).
 
 ### 1 - installation
 
-Installation is currently in a venv. These commands are installed in the venv:
+Installation is currently in a [virtual environment](https://csguide.cs.princeton.edu/software/virtualenv) (commonly called a `venv`). These commands are installed in the venv:
 
 - dar-back
 - cleanup
@@ -989,15 +1257,15 @@ Installation is currently in a venv. These commands are installed in the venv:
 
 Note:
 
-The module `inputimeout` is installed into the venv and used for the confirmation input (with a 30 second timeout)
+The modules `inputimeout`, `rich`and `argcomplete` are installed into the venv and used by `dar-backup`
 
-To install, create a venv and run pip:
+To install `dar-backup`, create a venv and run pip:
 
 ```bash
 mkdir $HOME/tmp
 cd $HOME/tmp
 python3 -m venv venv    # create the virtual environment 
-. venv/bin/activate     # activate the virtual env
+. venv/bin/activate     # activate the virtual environment
 pip install dar-backup  # run pip to install `dar-backup`
 ```
 
@@ -1010,7 +1278,7 @@ alias db=". ~/tmp/venv/bin/activate; dar-backup -v"
 drop the alias into ~/.bashrc like this:
 
 ```bash
-grep -qxF 'alias db=". ~/tmp/venv/bin/activate; dar-backup -v"' ~/.bashrc \
+grep -qxF 'alias db="' ~/.bashrc \
   || echo 'alias db=". ~/tmp/venv/bin/activate; dar-backup -v"' >> ~/.bashrc
 
 source ~/.bashrc
@@ -1029,24 +1297,25 @@ See section 15 and section 16 in the supplied "LICENSE" file.
 
 ### 2 - configuration
 
-The dar-backup `demo` is non-destructive and stops if some of the default directories exist.
+The dar-backup [installer](#installer-options) application can be used to setup the needed directories for `dar-backup` to work.
+It creates necessary directories as prescribed in the config file and optionally creates manager databases.
 
-Run `demo`
+`installer` can also add configuration of shell auto completion.
 
-```bash
-demo --install
-```
+Step 1:
 
-The output is
+Create a config file   - [see details on config file](#config-file))
 
-```text
-Directories created: `/home/user/dar-backup/` and `/home/user/.config/dar-backup`
-Config file deployed to /home/user/.config/dar-backup/dar-backup.conf
-Default backup definition deployed to /home/user/.config/dar-backup/backup.d/default
-1. Now run `manager --create-db` to create the catalog database.
-2. Then you can run `dar-backup --full-backup` to create a backup.
-3. List backups with `dar-backup --list`
-4. List contents of a backup with `dar-backup --list-contents <backup-name>`
+Step 2:
+
+Create one or more backup definitions - [see details on backup definitions](#backup-definition-example)
+
+Step 3:
+
+Run the installer:
+
+```bash
+installer --config <path to dar-backup.conf> --install-autocompletion
 ```
 
 ### 3 - generate catalog databases
@@ -1059,22 +1328,33 @@ Generate the archive catalog database(s).
 manager --create-db
 ```
 
-### 4 - do FULL backups
+### 4 - give dar-backup a spin
 
-Prereq:
-[Backup definitions](#backup-definition-example) are in place in BACKUP.D_DIR (see [config file](#config-file)).
+You are now ready to do backups as configured in your backup definition(s).
 
-You are ready to do backups of all your backup definitions.
+Give `dar-backup`a spin:
 
 ```bash
-dar-backup --full-backup 
+dar-backup --full-backup --verbose
+
+# list backups
+dar-backup --list
+
+# list contents of a dar backup
+dar-backup --list-contents <TAB>... <choose a backup>
+
+# see some examples on usage
+dar-backup --examples
+
+# see the log file
+cat "$HOME/dar-backup/dar-backup.log"
 ```
 
-If you want to see dar-backup's log entries in the terminal, use the `--log-stdout` option. This can be useful if dar-backup is started by systemd.
+If you want to see dar-backup's log entries in the terminal, use the `--log-stdout` option.
 
 If you want more log messages, use the `--verbose` or `--log-level debug` for even more.
 
-If you want a backup of a single definition, use the `-d <backup definition>` option. The definition's name is the filename of the definition in the `backup.d` config directory.
+If you want to take a backup using a single backup definition, use the `-d <backup definition>` option. The backup definition's name is the filename of the definition in the BACKUP.D_DIR (see [config file](#config-file)).
 
 ```bash
 dar-backup --full-backup -d <your backup definition>
@@ -1082,7 +1362,7 @@ dar-backup --full-backup -d <your backup definition>
 
 ### 5 - deactivate venv
 
-Deactivate the virtual environment (venv)
+Deactivate the virtual environment (venv).
 
 ```bash
 deactivate
@@ -1101,6 +1381,9 @@ Tilde `~` and environment variables can be used in the paths for various file lo
 ```text
 [MISC]
 LOGFILE_LOCATION=~/.dar-backup.log
+# optional parameters
+# LOGFILE_MAX_BYTES = 26214400  # 25 MB max file size is default, change as neeeded
+# LOGFILE_BACKUP_COUNT = 5      # 5 backup log files is default, change as needed
 MAX_SIZE_VERIFICATION_MB = 20
 MIN_SIZE_VERIFICATION_MB = 1
 NO_FILES_VERIFICATION = 5
@@ -1119,6 +1402,8 @@ TEST_RESTORE_DIR = /tmp/dar-backup/restore/
 
 [AGE]
 # age settings are in days
+# `cleanup` script removes archives and their .par redundancy files if older than configured.
+# `cleanup` does not remove FULL archives, unless specifically told to and a "y" is answered to "are you sure?".
 DIFF_AGE = 100
 INCR_AGE = 40
 
@@ -1274,6 +1559,12 @@ The name of the file is the name of the backup definition.
 
 You can use as many backup definitions as you need.
 
+> Note 👉
+>
+> Environment variables and tilde (~) not allowed here. `dar` does not expand them.
+>
+> See [TODO](#todo)
+
 ```text
  # Switch to ordered selection mode, which means that the following
  # options will be considered top to bottom
@@ -1419,20 +1710,20 @@ deactivate
 gives something like
 
 ```text
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj  2 Gio   Sat May 10 14:15:07 2025  home/pj
-[Saved][ ]       [-L-][  93%][ ]  -rw-rw-r--   pj pj  29 kio  Fri May  9 16:45:38 2025  home/pj/data/2023/2023-02-11-Udstilling-Fredericia/DSC_0568.NEF.xmp
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj  2 Gio   Fri May  9 12:49:04 2025  home/pj/data/2025
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj  193 Mio Thu May  8 15:59:17 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  15 Mio  Thu May  8 15:52:27 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  10 Mio  Thu May  8 15:52:27 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  9 Mio   Thu May  8 15:51:53 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0559.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  16 Mio  Thu May  8 15:51:45 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  12 Mio  Thu May  8 15:51:45 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  16 Mio  Thu May  8 15:51:24 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  12 Mio  Thu May  8 15:51:23 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG
-[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   pj pj  22 kio  Thu May  8 15:59:58 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj pj  30 kio  Thu May  8 16:00:36 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF.xmp
-[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   pj pj  22 kio  Thu May  8 16:00:29 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG.xmp
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user  2 Gio   Sat May 10 14:15:07 2025  home/user
+[Saved][ ]       [-L-][  93%][ ]  -rw-rw-r--   user user  29 kio  Fri May  9 16:45:38 2025  home/user/data/2023/2023-02-11-Udstilling-Fredericia/DSC_0568.NEF.xmp
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user  2 Gio   Fri May  9 12:49:04 2025  home/user/data/2025
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user  193 Mio Thu May  8 15:59:17 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  15 Mio  Thu May  8 15:52:27 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  10 Mio  Thu May  8 15:52:27 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  9 Mio   Thu May  8 15:51:53 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0559.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  16 Mio  Thu May  8 15:51:45 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  12 Mio  Thu May  8 15:51:45 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  16 Mio  Thu May  8 15:51:24 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  12 Mio  Thu May  8 15:51:23 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG
+[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   user user  22 kio  Thu May  8 15:59:58 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG.xmp
+[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   user user  30 kio  Thu May  8 16:00:36 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF.xmp
+[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   user user  22 kio  Thu May  8 16:00:29 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG.xmp
 ```
 
 ## dar file selection examples
@@ -1453,26 +1744,26 @@ This happens when the shell splits the quoted string or interprets globs before
 
 ### select a directory
 
-Select files and sub directories in `home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
+Select files and sub directories in `home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
 
 ```bash
-dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-g 'home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling'"
+dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-g 'home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling'"
 ```
 
 gives
 
 ```text
 ...
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 10:33:42 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0572.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 28  Mio Fri May  9 10:33:12 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0571.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 25  Mio Fri May  9 10:33:08 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0570.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 27  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0569.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 27  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0568.NEF
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj 833 Mio Fri May  9 12:49:57 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 11  Mio Fri May  9 10:32:45 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0568.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 11  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0569.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 9   Mio Fri May  9 10:33:08 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0570.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 13  Mio Fri May  9 10:33:12 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0571.JPG
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 10:33:42 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0572.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 28  Mio Fri May  9 10:33:12 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0571.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 25  Mio Fri May  9 10:33:08 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0570.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 27  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0569.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 27  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0568.NEF
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user 833 Mio Fri May  9 12:49:57 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 11  Mio Fri May  9 10:32:45 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0568.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 11  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0569.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 9   Mio Fri May  9 10:33:08 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0570.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 13  Mio Fri May  9 10:33:12 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0571.JPG
 ...
 ```
 
@@ -1485,15 +1776,15 @@ dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-I '*Z50*' -
 gives something like
 
 ```text
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Sat May 10 14:15:07 2025 home/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Fri May  9 12:49:04 2025 home/pj/data/2025
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj 193 Mio Thu May  8 15:59:17 2025 home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Fri May  9 16:47:37 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 26  Mio Fri May  9 11:26:16 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0633.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 26  Mio Fri May  9 11:26:16 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0632.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 28  Mio Fri May  9 11:09:04 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0631.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 11:09:03 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0630.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 11:09:03 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0629.NEF
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Sat May 10 14:15:07 2025 home/user
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Fri May  9 12:49:04 2025 home/user/data/2025
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user 193 Mio Thu May  8 15:59:17 2025 home/user/data/2025/2025-05-09-Viltrox-25mm-AIR
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Fri May  9 16:47:37 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0633.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0632.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 28  Mio Fri May  9 11:09:04 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0631.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0630.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0629.NEF
 ...
 ```
 
@@ -1524,9 +1815,9 @@ When restoring and using `/tmp` for --restore-dir, the restored files can be fou
 
 ### a single file
 
-```text
+```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name> --selection "-g path/to/file"
+dar-backup --restore <archive_name> --selection="-g path/to/file"
 deactivate
 ```
 
@@ -1534,15 +1825,23 @@ deactivate
 
 ```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name> --selection "-g path/to/directory"
+dar-backup --restore <archive_name> --selection="-g path/to/directory"
 deactivate
 ```
 
 ### .NEF from a specific date
 
+The backed up directory contains \*.NEF and \*.xmp files.
+
+Filtering:
+
+- Include files with "2024-06-16" in file name
+- Exclude files with file names ending in ".xmp"
+- Files must be in directory "home/user/tmp/LUT-play", compared to the file root (`-R`option) in the backup.
+
 ```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name>  --selection "-X '*.xmp' -I '*2024-06-16*' -g home/pj/tmp/LUT-play"
+dar-backup --restore <archive_name>  --selection="-I '*2024-06-16*' -X '*.xmp' -g home/user/tmp/LUT-play"
 deactivate
 ```
 
@@ -1608,13 +1907,13 @@ One way to do that, is to let dar create a FULL archive from scratch, another is
 I do backups of my homedir. Here it is shown how a FULL archive is merged with a DIFF, creating a new FULL archive.
 
 ```bash
-dar --merge pj-homedir_FULL_2021-09-12  -A pj-homedir_FULL_2021-06-06  -@pj-homedir_DIFF_2021-08-29 -s 12G
+dar --merge user-homedir_FULL_2021-09-12  -A user-homedir_FULL_2021-06-06  -@user-homedir_DIFF_2021-08-29 -s 12G
 
 # test the new FULL archive
-dar -t pj-homedir_FULL_2021-09-12
+dar -t user-homedir_FULL_2021-09-12
 
 # create Par2 redundancy files
-for file in pj-homedir_FULL_yyyy-mm-dd.*.dar; do
+for file in user-homedir_FULL_yyyy-mm-dd.*.dar; do
   par2 c -r5 -n1 "$file"
 done
 ```
@@ -1639,6 +1938,8 @@ These [.darrc](#darrc) settings make `dar` print the current directory being pro
 
 This is very useful in very long running jobs to get an indication that the backup is proceeding normally.
 
+The `dar` output is streamed to the `dar-backup-commands.log` file.
+
 ### Separate log file for command output
 
 Dar-backup's log file is called `dar-backup.log`.
@@ -1749,8 +2050,8 @@ Try auto completion in your session:
 eval "$(register-python-argcomplete dar-backup)"
 eval "$(register-python-argcomplete cleanup)"
 eval "$(register-python-argcomplete manager)"
-complete -o nosort -C 'python -m argcomplete cleanup' cleanup
-complete -o nosort -C 'python -m argcomplete manager' manager
+#complete -o nosort -C 'python -m argcomplete cleanup' cleanup
+#complete -o nosort -C 'python -m argcomplete manager' manager
 ```
 
 To make it persistent across sessions, add this to your ~/.bashrc:
@@ -1761,8 +2062,8 @@ eval "$(register-python-argcomplete dar-backup)"
 eval "$(register-python-argcomplete cleanup)"
 eval "$(register-python-argcomplete manager)"
 # This disables bash sorting, so sorting is by <backup definition> and <date>
-complete -o nosort -C 'python -m argcomplete cleanup' cleanup
-complete -o nosort -C 'python -m argcomplete manager' manager
+#complete -o nosort -C 'python -m argcomplete cleanup' cleanup
+#complete -o nosort -C 'python -m argcomplete manager' manager
 ```
 
 If you're using a virtual environment and register-python-argcomplete isn't in your global PATH, use:
@@ -1800,8 +2101,54 @@ Then reload Zsh:
 source ~/.zshrc
 ```
 
+## Easy development setup
+
+It is very easy to have your own development environment.
+
+```bash
+git clone https://github.com/per2jensen/dar-backup.git
+cd dar-backup/v2
+./build.py
+```
+
+This script:
+
+- Creates a Python virtual environment called `venv`
+- pip install `hatch`
+- pip install the development environment as setup in pyproject.toml
+
+  --
+  
+  ```text
+  dev = [
+  "pytest",
+  "wheel>=0.45.1",
+  "requests>=2.32.2",
+  "coverage>=7.8.2",
+  "pytest>=8.4.0",
+  "pytest-cov>=6.1.1",
+  "psutil>=7.0.0",
+  "pytest-timeout>=2.4.0",
+  "httpcore>=0.17.3",
+  "h11>=0.16.0",
+  "zipp>=3.19.1",
+  "anyio>=4.4.0",
+  "black>=25.1.0"]
+  ```
+
+✅ Your environment is now ready to activate and test!
+
+Activate and run the test suite:
+
+```bash
+source venv/bin/activate # activate the virtual env
+pytest                   # run the test suite
+```
+
 ## Todo
 
+- Perhaps look into pre-processing backup definitions. As `dar` does not expand env vars
+  `dar-backup` could do so and feed the result to `dar`.
 - When run interactively, a progress bar during test and par2 generation would be nice.
 - Look into a way to move the .par2 files away from the `dar` slices, to maximize chance of good redundancy.
 - Add option to dar-backup to use the `dar` option `--fsa-scope none`
@@ -1835,7 +2182,7 @@ One backup definition per file
 | [clean-log](#clean-log-options)  | Clean up excessive log output from dar command logs |
 | [dar-backup-systemd](#dar-backup-systemd-options) | Generate (and optionally install) systemd timers and services for automated backups |
 | [installer](#installer-options)  | Set up directories and optionally create catalog databases according to a config file |
-| [demo](#demo-options)            | Set up required directories and default config files |
+| [demo](#demo-options)            | Set up required directories and config files for a demo|
 
 ### test coverage
 
@@ -1966,10 +2313,12 @@ Sets up `dar-backup` according to provided config file.
 The installer creates the necessary backup catalog databases if `--create-db` is given.
 
 ```bash
---config             Sets up `dar-backup`.
---create-db          Create backup catalog databases.
--v, --version        Display version and licensing information.
--h, --help           Displays usage info
+--config                 Path to a config file. The configured directories will be created.
+--create-db              Create backup catalog databases. Use this option with `--config`.
+--install-autocompletion Add bash or zsh auto completion - idempotent.
+--remove-autocompletion  Remove the auto completion from bash or zsh.
+-v, --version            Display version and licensing information.
+-h, --help               Displays usage info.
 ```
 
 ### Demo options
@@ -1989,10 +2338,17 @@ Create directories:
 Sets up demo config files:
 
 - ~/.config/dar-backup/dar-backup.conf
-- ~/.config/dar-backup/backup.d/default
+- ~/.config/dar-backup/backup.d/demo
 
 ```bash
--i, --install              Sets up `dar-backup`.
--v, --version              Display version and licensing information.
--h, --help                 Displays usage info
+-i, --install       Sets up `dar-backup`.
+--root-dir          Specify the root directory for the backup.
+--dir-to-backup     Directory to backup, relative to the root directory.
+--backup-dir        Directory where backups and redundancy files are put.
+--override          By default, the script will not overwrite existing files or directories.
+                    Use this option to override this behavior.
+--generate          Generate config files and put them in /tmp/ for inspection
+                    without writing to $HOME.
+-v, --version       Display version and licensing information.
+-h, --help          Displays usage info
 ```