ebl Add information about character substitution

[bacula/docs] / docs / manual / fileset.tex

diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex
index 1f68d7e26dda5d3fc7336987f462a27646c137f4..c8a2dd2b5603ad668f6036d292a1c7910789e771 100644 (file)
--- a/docs/manual/fileset.tex
+++ b/docs/manual/fileset.tex
@@ -1,7 +1,7 @@
 -%
 %%
 
-\chapter{The FileSet Resource}
+\section{The FileSet Resource}
 \label{FileSetResource}
 \index[general]{Resource!FileSet}
 \index[general]{FileSet Resource}
@@ -18,8 +18,6 @@ automatically create a new FileSet (defined by the name and an MD5 checksum
 of the Include/Exclude contents).  Each time a new FileSet is created,
 Bacula will ensure that the next backup is always a Full save.
 
-\section{Character Sets}
-\index[general]{Character Sets}
 Bacula is designed to handle most character sets of the world,
 US ASCII, German, French, Chinese, ...  However, it does this by
 encoding everything in UTF-8, and it expects all configuration files
@@ -59,14 +57,18 @@ defined for each Backup job.
 \index[dir]{Directive!Ignore FileSet Changes}
    Normally, if you modify the FileSet Include or Exclude lists,
    the next backup will be forced to a Full so that Bacula can
-   guarantee that any additions or deletions are properly backed
-   up.
+   guarantee that any additions or deletions are properly saved.
+
+   We strongly recommend against setting this directive to yes, 
+   since doing so may cause you to have an incomplete set of backups.
+
    If this directive is set to {\bf yes}, any changes you make to the
-   FileSet Include or Exclude lists will be ignored and not cause Bacula to
-   immediately perform a Full backup.  The default is {\bf no}, in which
-   case, if you change the Include or Exclude, Bacula will force a Full
-   backup to ensure that everything is properly backed up.  It is not
-   recommended to set this directive to yes.
+   FileSet Include or Exclude lists, will not force a Full during 
+   subsequent backups.
+
+   The default is {\bf no}, in which case, if you change the Include or
+   Exclude, Bacula will force a Full backup to ensure that everything is
+   properly backed up.
 
 \item [Enable VSS = \lt{}yes|no\gt{}]
 \index[dir]{Enable VSS}
@@ -302,7 +304,7 @@ The directives within an Options resource may be one of the following:
       \item {\bf c}
       compare the change time (st\_ctime)  
 
-      \item {\bf s}
+      \item {\bf d}
       report file size decreases  
 
       \item {\bf 5}
@@ -616,9 +618,9 @@ Change: 2005-11-06 12:36:48.000000000 +0100
 \index[dir]{Directive!wilddir}
    Specifies a wild-card string to be applied to directory names only.  No
    filenames will be matched by this directive.  Note, if {\bf Exclude} is
-   not enabled, the wild-card will select directories files are to be
+   not enabled, the wild-card will select directories to be
    included.  If {\bf Exclude=yes} is specified, the wild-card will select
-   which files are to be excluded.  Multiple wild-card directives may be
+   which directories are to be excluded.  Multiple wild-card directives may be
    specified, and they will be applied in turn until the first one that
    matches.  Note, if you exclude a directory, no files or directories
    below it will be matched.
@@ -831,7 +833,9 @@ Include {
    a program.  This program will be executed on the Director's machine at
    the time the Job starts (not when the Director reads the configuration
    file), and any output from that program will be assumed to be a list of
-   files or directories, one per line, to be included.  
+   files or directories, one per line, to be included. Before submitting the 
+   specified command bacula will performe 
+   \ilink{character substitution}{character substitution}.
 
    This allows you to have a job that, for example, includes all the local
    partitions even if you change the partitioning by adding a disk.  The