From 7e599887c5afe993d6ebc13d08cc1a359547f99b Mon Sep 17 00:00:00 2001
From: Eric Bollengier <eric@eb.homelinux.org>
Date: Mon, 19 Feb 2007 17:20:55 +0000
Subject: [PATCH] ebl  add RecyclePool notes

---
 docs/manual/console.tex   | 6 ++++--
 docs/manual/dirdconf.tex  | 9 +++++++++
 docs/manual/recycling.tex | 7 ++++---
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/docs/manual/console.tex b/docs/manual/console.tex
index 366cf746..f202310b 100644
--- a/docs/manual/console.tex
+++ b/docs/manual/console.tex
@@ -1196,6 +1196,7 @@ wish to change.  The following Volume parameters may be changed:
    Maximum Volume Files
    Maximum Volume Bytes
    Recycle Flag
+   Recycle Pool
    Slot
    InChanger Flag
    Pool
@@ -1227,8 +1228,9 @@ wish to change.  The following Volume parameters may be changed:
    existing pool to the pool specified.
 
    For {\bf Volume from Pool} and {\bf All Volumes from Pool}, the
-   following values are updated from the Pool record: Recycle,
+   following values are updated from the Pool record: Recycle, RecyclePool,
    VolRetention, VolUseDuration, MaxVolJobs, MaxVolFiles, and MaxVolBytes.
+   (RecyclePool feature is available with bacula 2.1.4 or higher.)
 
    The full form of the update command with all command line arguments is:
 
@@ -1236,7 +1238,7 @@ wish to change.  The following Volume parameters may be changed:
 \begin{verbatim}
        update volume=xxx pool=yyy slots volstatus=xxx VolRetention=ddd
          VolUse=ddd MaxVolJobs=nnn MaxVolBytes=nnn Recycle=yes|no
-         slot=nnn enabled=n  
+         slot=nnn enabled=n recyclepool=zzz
       
 \end{verbatim}
 \normalsize
diff --git a/docs/manual/dirdconf.tex b/docs/manual/dirdconf.tex
index bf4389f4..8bb32ca8 100644
--- a/docs/manual/dirdconf.tex
+++ b/docs/manual/dirdconf.tex
@@ -2484,6 +2484,14 @@ The Pool Resource defined in the Director's configuration file
    created, changing the value  in the bacula-dir.conf file will not change what
    is stored  for the Volume. To change the value for an existing Volume  you
    must use the {\bf update} command in the Console.
+
+\label{PoolRecyclePool}
+\item [RecyclePool = \lt{}pool-resource-name\gt{}]
+   \index[dir]{RecyclePool}
+   \index[dir]{Directive!RecyclePool}
+
+   On versions 2.1.4 or greater, Bacula can recycle media in the pool of your
+   choice. The most useful setup is to use \ilink{Scratch}{TheScratchPool}.
    
 \label{PoolRecycle}
 \item [Recycle = \lt{}yes|no\gt{}]
@@ -2667,6 +2675,7 @@ Pool {
 \normalsize
 
 \subsection{The Scratch Pool}
+\label{TheScratchPool}
 \index[general]{Scratch Pool}
 In general, you can give your Pools any name you wish, but there is one 
 important restriction: the Pool named {\bf Scratch}, if it exists behaves 
diff --git a/docs/manual/recycling.tex b/docs/manual/recycling.tex
index 44f3b82c..c2962d51 100644
--- a/docs/manual/recycling.tex
+++ b/docs/manual/recycling.tex
@@ -29,14 +29,15 @@ number of tapes in your pool or pools remains constant.
 By properly defining your Volume Pools with appropriate Retention periods,
 Bacula can manage the recycling (such as defined above) automatically. 
 
-Automatic recycling of Volumes is controlled by three records in the {\bf
-Pool} resource definition in the Director's configuration file. These three
+Automatic recycling of Volumes is controlled by four records in the {\bf
+Pool} resource definition in the Director's configuration file. These four
 records are: 
 
 \begin{itemize}
 \item AutoPrune = yes 
 \item VolumeRetention = \lt{}time\gt{} 
-\item Recycle = yes 
+\item Recycle = yes
+\item RecyclePool = \lt{}APool\gt{} (\textit{This require bacula 2.1.4 or greater})
 \end{itemize}
 
 The above three directives are all you need assuming that you fill
-- 
2.39.5