From 91099b4874ba61fd085fc3fbd1a9deda73fdee27 Mon Sep 17 00:00:00 2001
From: marchersimon <50295997+marchersimon@users.noreply.github.com>
Date: Sun, 7 Aug 2022 17:44:20 +0200
Subject: [PATCH] tlmgr-restore: add page (#8288)

---
 pages/common/tlmgr-backup.md  |  4 ++--
 pages/common/tlmgr-restore.md | 29 +++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 2 deletions(-)
 create mode 100644 pages/common/tlmgr-restore.md

diff --git a/pages/common/tlmgr-backup.md b/pages/common/tlmgr-backup.md
index e4f1a6e3cc..874df9f667 100644
--- a/pages/common/tlmgr-backup.md
+++ b/pages/common/tlmgr-backup.md
@@ -1,7 +1,7 @@
 # tlmgr backup
 
 > Manage backups of TeX Live packages.
-> The default backup location is saved in the `backupdir` setting, which can be obtained with `tlmgr option`.
+> The default backup directory is specified by the `backupdir` option, and can be obtained with `tlmgr option`.
 > More information: <https://www.tug.org/texlive/tlmgr.html>.
 
 - Make a backup of one or more packages:
@@ -12,7 +12,7 @@
 
 `tlmgr backup --all`
 
-- Make a backup to a specific directory:
+- Make a backup to a custom directory:
 
 `tlmgr backup {{package}} --backupdir {{path/to/backup_directory}}`
 
diff --git a/pages/common/tlmgr-restore.md b/pages/common/tlmgr-restore.md
new file mode 100644
index 0000000000..fe56b1572b
--- /dev/null
+++ b/pages/common/tlmgr-restore.md
@@ -0,0 +1,29 @@
+# tlmgr restore
+
+> Restore package backups created with `tlmgr backup`.
+> The default backup directory is specified by the `backupdir` option, and can be obtained with `tlmgr option`.
+> More information: <https://www.tug.org/texlive/tlmgr.html>.
+
+- List all available backup revisions for all packages:
+
+`tlmgr restore`
+
+- List all available backup revisions for a specific package:
+
+`tlmgr restore {{package}}`
+
+- Restore a specific revision of a specific package:
+
+`tlmgr restore {{package}} {{revision}}`
+
+- Restore the latest revision of all backed-up packages:
+
+`tlmgr restore --all`
+
+- Restore a package from a custom backup directory:
+
+`tlmgr restore {{package}} {{revision}} --backupdir {{path/to/backup_directory}}`
+
+- Perform a dry-run and print all taken actions without making them:
+
+`tlmgr restore --dry-run {{package}} {{revision}}`