tlmgr-restore: add page (#8288)

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}}`
 

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}}`