]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/main/fileset.tex
Improve some text
[bacula/docs] / docs / manuals / en / main / fileset.tex
index 3d99df73b31fd16f71f4e80a87c028804455a603..3d18330b26714ef3c67522ddff74def1165d266e 100644 (file)
@@ -91,9 +91,7 @@ defined for each Backup job.
 \index[dir]{Include \{ [ Options \{\lt{}file-options\gt{}\} ...]
    \lt{}file-list\gt{} \}  }
 \index[dir]{Directive!Include}
-
-\item [Options \{ \lt{}file-options\gt{} \} ]
-\index[dir]{Options  \{ \lt{}file-options\gt{} \}  }
+\index[dir]{Options \{ \lt{}file-options\gt{} \}  }
 
 \item [Exclude \{ \lt{}file-list\gt{} \}]
 \index[dir]{Exclude \{ \lt{}file-list\gt{} \} }
@@ -206,7 +204,7 @@ when excluding as mentioned above.
 
 However, one additional point is that in the case that no match was found,
 Bacula will use the options found in the last Options resource.  As a
-consequence, if you want a particular set of "default" options, you should put
+consequence, if you want a particular set of ``default'' options, you should put
 them in an Options resource after any other Options.
 
 It is a good idea to put all your wild-card and regex expressions inside
@@ -359,8 +357,8 @@ options below.
       \end{description}
 
    A useful set of general options on the {\bf Level=Catalog}  or {\bf
-   Level=DiskToCatalog}  verify is {\bf pins5} i.e. compare permission bits,
-   inodes, number  of links, size, and MD5 changes. 
+   Level=DiskToCatalog}  verify is {\bf pins5} i.e. compare permission bits, then
+   inodes, number  of links, size, and finally MD5 changes.
 
 \item [onefs=yes\vb{}no]
 \index[dir]{onefs}
@@ -445,7 +443,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100
 
    Also be aware that even if you include {\bf /home} in your list
    of files to backup, as you most likely should, you will get the
-   informational message that  "/home is a different filesystem" when 
+   informational message that  ``/home is a different filesystem'' when 
    Bacula is processing the {\bf /} directory.  This message does not
    indicate an error. This message means that while examining the 
    {\bf File =} referred to in the second part of the message, Bacula will 
@@ -803,7 +801,7 @@ Change: 2005-11-06 12:36:48.000000000 +0100
    The default is {\bf no}.  If this option is set to yes, and you have the
    POSIX {\bf libacl} installed on your Linux system, Bacula will backup the
    file and directory Unix Access Control Lists (ACL) as defined in IEEE Std
-   1003.1e draft 17 and "POSIX.1e" (abandoned).  This feature is
+   1003.1e draft 17 and ``POSIX.1e'' (abandoned).  This feature is
    available on Unix systems only and requires the Linux ACL library. Bacula is
    automatically compiled with ACL support if the {\bf libacl} library is
    installed on your Linux system (shown in config.out).  While restoring the
@@ -890,8 +888,6 @@ Change: 2005-11-06 12:36:48.000000000 +0100
    non-local filesystems. Normally, when you use this directive, you
    would also set {\bf onefs=no} so that Bacula will traverse filesystems.
 
-   This option is not implemented in Win32 systems.
-
 \item [DriveType=Windows-drive-type]
 \index[dir]{DriveType}
 \index[dir]{Directive!DriveType}
@@ -943,7 +939,7 @@ There are a number of special cases when specifying directories and files in a
 
 \begin{itemize}
 \item Any name preceded by an at-sign (@) is assumed to be the  name of a
-   file, which contains a list of files each preceded by a "File =".  The
+   file, which contains a list of files each preceded by a ``File =''.  The
    named file is read once when the configuration file is parsed during the
    Director startup.  Note, that the file is read on the Director's machine
    and not on the Client's.  In fact, the @filename can appear anywhere
@@ -1133,8 +1129,7 @@ Include {
 
    Ludovic Strappazon has pointed out that this feature can be  used to backup a
    full Microsoft Windows disk. Simply boot into  the system using a Linux Rescue
-   disk, then load a statically  linked Bacula as described in the 
-   \ilink{ Disaster Recovery Using Bacula}{RescueChapter} chapter of
+   disk, then load a statically  linked Bacula as described in the \ilink{Disaster Recovery Using Bacula}{RescueChapter} chapter of
    this manual. Then  save the whole disk partition. In the case of a disaster,
    you  can then restore the desired partition by again booting with  the rescue
    disk and doing a restore of the partition. 
@@ -1161,7 +1156,7 @@ Include {
    and go on to the next file.  The data read can be anything since Bacula
    treats it as a stream.
 
-   This feature can be an excellent way to do a "hot" backup of a very
+   This feature can be an excellent way to do a ``hot'' backup of a very
    large database.  You can use the {\bf RunBeforeJob} to create the fifo
    and to start a program that dynamically reads your database and writes
    it to the fifo.  Bacula will then write it to the Volume.  Be sure to
@@ -1417,7 +1412,7 @@ FileSet {
 \end{verbatim}
 \normalsize
 
-The "trick" here was to add a RegexFile expression that matches
+The ``trick'' here was to add a RegexFile expression that matches
 all files. It does not match directory names, so all directories in
 /myfile will be backed up (the directory entry) and any *.Z and *.gz
 files contained in them. If you know that certain directories do
@@ -1526,12 +1521,13 @@ C:/Documents and Settings/*/My Documents/My Pictures/*
 To understand how this can be achieved, there are two important points to
 remember:
 
-Firstly, Bacula walks over the filesystem depth-first starting from the File =
-lines.  It stops descending when a directory is excluded, so you must include
-all ancestor directories of each directory containing files to be included.
+Firstly, Bacula traverses the filesystem starting from the File = lines.
+It stops descending when a directory is excluded, so you must include all
+ancestor (higher level) directories of each directory containing files to
+be included.
 
 Secondly, each directory and file is compared to the Options clauses in the
-order they appear in the FileSet.  When a match is found, no further clauses
+order they appear in the FileSet.  When a match is found, no further Optionss
 are compared and the directory or file is either included or excluded.
 
 The FileSet resource definition below implements this by including specifc
@@ -1648,7 +1644,7 @@ the drive and a colon (as in c:). However, the path separators must be
 specified in Unix convention (i.e. forward slash (/)). If you wish to include
 a quote in a file name, precede the quote with a backslash
 (\textbackslash{}). For example you might use the following
-for a Windows machine to backup the "My Documents" directory: 
+for a Windows machine to backup the ``My Documents'' directory: 
 
 \footnotesize
 \begin{verbatim}