From 79c118dc2ff793e79cb3768650f7c15d727b5c74 Mon Sep 17 00:00:00 2001
From: Eric Bollengier <eric@eb.homelinux.org>
Date: Wed, 8 Sep 2010 17:07:26 +0200
Subject: [PATCH] Add documentation for new verify option

---
 docs/manuals/en/main/newfeatures.tex | 24 +++++++++++++++
 docs/manuals/en/main/verify.tex      | 46 ++++++++++++++++++++++------
 2 files changed, 61 insertions(+), 9 deletions(-)

diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex
index 1417590e..4b5a081c 100644
--- a/docs/manuals/en/main/newfeatures.tex
+++ b/docs/manuals/en/main/newfeatures.tex
@@ -3,6 +3,30 @@ This chapter presents the new features that have been added to the
 current version of Bacula that is under development. This version will be
 released at some later date, probably near the end of 2010.
 
+\section{Ability to Verify any specified Job}
+You now have the ability to tell Bacula which Job should verify instead of
+automatically verify just the last one.
+
+This feature can be used with VolumeToCatalog, DiskToCatalog and Catalog level.
+
+To verify a given job, just specify the Job jobid in argument when starting the
+job.
+\begin{verbatim}
+*run job=VerifyVolume jobid=1 level=VolumeToCatalog
+Run Verify job
+JobName:     VerifyVolume
+Level:       VolumeToCatalog
+Client:      127.0.0.1-fd
+FileSet:     Full Set
+Pool:        Default (From Job resource)
+Storage:     File (From Job resource)
+Verify Job:  VerifyVol.2010-09-08_14.17.17_03
+Verify List: /tmp/regress/working/VerifyVol.bsr
+When:        2010-09-08 14:17:31
+Priority:    10
+OK to run? (yes/mod/no):
+\end{verbatim}
+
 \section{Additions to the Plugin API}
 The bfuncs structure has been extended to include a number of
 new entrypoints.
diff --git a/docs/manuals/en/main/verify.tex b/docs/manuals/en/main/verify.tex
index 17261587..6a8f90b3 100644
--- a/docs/manuals/en/main/verify.tex
+++ b/docs/manuals/en/main/verify.tex
@@ -146,6 +146,8 @@ FileSet:  Verify Set
 Level:    Catalog
 Client:   MatouVerify
 Storage:  DLTDrive
+Verify Job:  
+Verify List: /tmp/regress/working/MatouVerify.bsr
 OK to run? (yes/mod/no): mod
 \end{verbatim}
 \normalsize
@@ -157,12 +159,16 @@ Job. After responding {\bf mod}, the console will ask:
 \footnotesize
 \begin{verbatim}
 Parameters to modify:
-     1: Job
-     2: Level
-     3: FileSet
-     4: Client
-     5: Storage
-Select parameter to modify (1-5): 2
+     1: Level
+     2: Storage
+     3: Job
+     4: FileSet
+     5: Client
+     6: When
+     7: Priority
+     8: Pool
+     9: Verify Job
+Select parameter to modify (1-5): 1
 \end{verbatim}
 \normalsize
 
@@ -172,9 +178,10 @@ you should select number 2 to modify the {\bf Level}, and it will display:
 \begin{verbatim}
 Levels:
      1: Initialize Catalog
-     2: Verify from Catalog
-     3: Verify Volume
-     4: Verify Volume Data
+     2: Verify Catalog
+     3: Verify Volume to Catalog
+     4: Verify Disk to Catalog
+     5: Verify Volume Data (not yet implemented)
 Select level (1-4): 1
 \end{verbatim}
 \normalsize
@@ -189,6 +196,8 @@ FileSet:  Verify Set
 Level:    Initcatalog
 Client:   MatouVerify
 Storage:  DLTDrive
+Verify Job:  
+Verify List: /tmp/regress/working/MatouVerify.bsr
 OK to run? (yes/mod/no): yes
 \end{verbatim}
 \normalsize
@@ -200,6 +209,25 @@ have defined. If you wish to immediately verify it, you can simply run a
 Verify {\bf Catalog} which will be the default. No differences should be
 found. 
 
+To use a previous job, you can add \texttt{jobid=xxx} option in run command
+line. It will run the Verify job against the specified job.
+
+\begin{verbatim}
+*run jobid=1 job=MatouVerify
+Run Verify job
+JobName:     MatouVerify
+Level:       Catalog
+Client:      127.0.0.1-fd
+FileSet:     Full Set
+Pool:        Default (From Job resource)
+Storage:     File (From Job resource)
+Verify Job:  MatouVerify.2010-09-08_15.33.33_03
+Verify List: /tmp/regress/working/MatouVerify.bsr
+When:        2010-09-08 15:35:32
+Priority:    10
+OK to run? (yes/mod/no): 
+\end{verbatim}
+
 \section{What To Do When Differences Are Found}
 \index[general]{What To Do When Differences Are Found }
 \index[general]{Found!What To Do When Differences Are }
-- 
2.39.2