Add restorejob documentation

diff --git a/docs/manuals/en/console/bconsole.tex b/docs/manuals/en/console/bconsole.tex
index d0cecf17f856cf6676778742c2aef4fd0a800a04..fb1c2bf792554e36aade1b8ef6ac38362919aa9f 100644 (file)
--- a/docs/manuals/en/console/bconsole.tex
+++ b/docs/manuals/en/console/bconsole.tex
@@ -951,7 +951,7 @@ release storage=<storage-name>
    to be restored.  This mode is somewhat similar to the standard Unix {\bf
    restore} program's interactive file selection mode.
 \begin{lstlisting}
-restore storage=<storage-name> client=<backup-client-name> where=<path> pool=<pool-name> fileset=<fileset-name> restoreclient=<restore-client-name> select current all done
+restore storage=<storage-name> client=<backup-client-name> where=<path> pool=<pool-name> fileset=<fileset-name> restoreclient=<restore-client-name> restorejob=<job-name> select current all done
 \end{lstlisting}
    Where {\bf current}, if specified, tells the restore command to
    automatically select a restore to the most current backup.  If not
@@ -966,6 +966,12 @@ restore storage=<storage-name> client=<backup-client-name> where=<path> pool=<po
    if the restoreclient keyword is specified, then the restore is written
    to that client.
 
+   The restore job rarely needs to be specified, as bacula installations
+   commonly only have a single restore job configured. However, for certain
+   cases, such as a varying list of RunScript specifications, multiple
+   restore jobs may be configured. The restorejob argument allows the
+   selection of one of these jobs.
+
 \item [run]
    \index[general]{run}
    This command allows you to schedule jobs  to be run immediately. The full form

diff --git a/docs/manuals/en/main/restore.tex b/docs/manuals/en/main/restore.tex
index 589515cf0bc1a87da67de760ed26172dac81a6a2..b8ecb5db4c1c9ed9c0d1110c2135aced6961a2cd 100644 (file)
--- a/docs/manuals/en/main/restore.tex
+++ b/docs/manuals/en/main/restore.tex
@@ -631,6 +631,12 @@ The full list of possible command line arguments are:
 \item {\bf add\_suffix=.old} -- add a suffix to all your files.
 \item {\bf regexwhere=!a.pdf!a.bkp.pdf!} -- do complex filename manipulation
   like with sed unix command. Will overwrite other filename manipulation.
+\item {\bf restorejob=jobname} -- Pre-chooses a restore job. Bacula can be
+  configured with multiple restore jobs ("Type = Restore" in the job
+  definition). This allows the specification of different restore properties,
+  including a set of RunScripts. When more than one job of this type is
+  configured, during restore, Bacula will ask for a user selection
+  interactively, or use the given restorejob.
 \end{bsysitemize}
 
 \label{restorefilerelocation}