From cad8e0e61bc32327cf2e5b33d05f0f08c10fcbd8 Mon Sep 17 00:00:00 2001
From: Kern Sibbald <kern@sibbald.com>
Date: Sat, 3 Dec 2011 09:55:34 +0100
Subject: [PATCH] Fix Attribute spooling documentation

---
 docs/manuals/en/main/dirdconf.tex | 50 +++++++++++++++++--------------
 1 file changed, 28 insertions(+), 22 deletions(-)

diff --git a/docs/manuals/en/main/dirdconf.tex b/docs/manuals/en/main/dirdconf.tex
index 32f4558b..9f9739c0 100644
--- a/docs/manuals/en/main/dirdconf.tex
+++ b/docs/manuals/en/main/dirdconf.tex
@@ -1513,15 +1513,29 @@ RunScript {
 
    If this directive is set  to {\bf yes} (default no), the Storage daemon will
    be requested  to spool the data for this Job to disk rather than write it 
-   directly to tape. Once all the data arrives or the spool files' maximum sizes
-   are reached, the data will be despooled and written  to tape. Spooling data 
-   prevents tape  shoe-shine (start and stop) during
-   Incremental saves. If you are writing to a disk file using this option
-   will probably just slow down the backup jobs.
+   directly to the Volume (normally a tape). 
+
+   Thus the data is written in large blocks to the Volume rather than small
+   blocks.  This directive is particularly useful when running multiple
+   simultaneous backups to tape.  Once all the data arrives or the spool
+   files' maximum sizes are reached, the data will be despooled and written
+   to tape.
+
+   Spooling data prevents interleaving date from several job and reduces or
+   eliminates tape drive stop and start commonly known as "shoe-shine".
+   
+   We don't recommend using this option if you are writing to a disk file
+   using this option will probably just slow down the backup jobs.
 
    NOTE: When this directive is set to yes, Spool Attributes is also
    automatically set to yes.
 
+\item [SpoolData=yes\vb{}no]
+   \index[dir]{SpoolData}
+   \index[dir]{Directive!SpoolData}
+   tells Bacula to request the Storage  daemon to spool data to a disk file
+   before writing it to the Volume (normally a tape). 
+
 \item [Spool Attributes = \lt{}yes\vb{}no\gt{}]
    \index[dir]{Spool Attributes}
    \index[dir]{Directive!Spool Attributes}
@@ -1541,6 +1555,15 @@ RunScript {
    NOTE: When Spool Data is set to yes, Spool Attributes is also
    automatically set to yes.
 
+\item [SpoolSize={\it bytes}]
+   \index[dir]{SpoolSize}
+   \index[dir]{Directive!SpoolSize}
+   where the bytes specify the maximum spool size for this job.
+   The default is take from Device Maximum Spool Size limit. 
+   This directive is available only in Bacula version 2.3.5 or 
+   later.
+
+
 \item [Where = \lt{}directory\gt{}]
    \index[dir]{Where}
    \index[dir]{Directive!Where}
@@ -2006,23 +2029,6 @@ upgraded from another type  to a full backup.
    specifies to use the Pool  named {\bf Incremental} if the job is an
 incremental  backup.  
 
-\item [SpoolData=yes\vb{}no]
-   \index[dir]{SpoolData}
-   \index[dir]{Directive!SpoolData}
-   tells Bacula to request the Storage  daemon to spool data to a disk file
-   before writing it to the Volume (normally a tape). Thus the data is
-   written in large blocks to the Volume rather than small blocks. This
-   directive is particularly useful when running multiple simultaneous
-   backups to tape. It prevents interleaving of the job data and reduces
-   or eliminates tape drive stop and start commonly known as "shoe-shine".
-
-\item [SpoolSize={\it bytes}]
-   \index[dir]{SpoolSize}
-   \index[dir]{Directive!SpoolSize}
-   where the bytes specify the maximum spool size for this job.
-   The default is take from Device Maximum Spool Size limit. 
-   This directive is available only in Bacula version 2.3.5 or 
-   later.
 
 \item [WritePartAfterJob=yes\vb{}no]
    \index[dir]{WritePartAfterJob}
-- 
2.39.5