Fix description of Volume Retention -- bug 1844

[bacula/docs] / docs / manuals / en / main / newfeatures.tex

diff --git a/docs/manuals/en/main/newfeatures.tex b/docs/manuals/en/main/newfeatures.tex
index e52436e198f2bb4ae7f88b177745397563fb5029..7cb823c641f4783001e57dc6b8c88e49bbeb6d47 100644 (file)
--- a/docs/manuals/en/main/newfeatures.tex
+++ b/docs/manuals/en/main/newfeatures.tex
@@ -2,6 +2,36 @@
 This chapter presents the new features that have been added to
 the various versions of Bacula.
 
+\section{New Features in 7.4.3}
+\subsection{RunScripts}
+There are two new RunScript short cut directives implemented in
+the Director.  They are:
+
+\begin{verbatim}
+Job {
+  ...
+  ConsoleRunBeforeJob = "console-command"
+  ...
+}
+\end{verbatim}
+
+\begin{verbatim}
+Job {
+  ...
+  ConsoleRunAfterJob = "console-command"
+  ...
+}
+\end{verbatim}
+
+As with other RunScript commands, you may have multiple copies
+of either the {\bf ConsoleRunBeforeJob} or the {\bf ConsoleRunAfterJob}
+in the same Job resource definition.
+\smallskip
+Please note that not all console commands are permitted, and that 
+if you run a console command that requires a response, the results
+are not determined (i.e. it will probably fail).
+
+
 \section{New Features in 7.4.0}
 \subsection{Verify Volume Data}
 
@@ -120,7 +150,7 @@ directories that are encrypted on Windows filesystem.
 \subsection{SSL Connections to MySQL}
 
 There are five new Directives for the Catalog resource in the
-\bf{bacula-dir.conf} file that you can use to encrypt the 
+{\bf bacula-dir.conf} file that you can use to encrypt the 
 communications between Bacula and MySQL for additional
 security.
 
@@ -141,6 +171,30 @@ that is a maximum time between Virtual Full jobs.  It is much like the
 Max Full Interval directive but applies to Virtual Full jobs rather
 that Full jobs.
 
+\subsection{New List Volumes Output}
+The {\bf list} and {\bf llist} commands have been modified so that when
+listing Volumes a new pseudo field {\bf expiresin} will be printed. This 
+field is the number of seconds in which the retention period will expire. 
+If the retention period has already expired the value will be zero.  Any
+non-zero value means that the retention period is still in effect.
+
+An example with many columns shorted for display purpose is:
+
+\begin{verbatim}
+*list volumes
+Pool: Default
+*list volumes
+Pool: Default
++----+---------------+-----------+---------+-------------+-----------+
+| id | volumename    | volstatus | enabled | volbytes    | expiresin |
++----+---------------+-----------+---------+-------------+-----------+
+|  1 | TestVolume001 | Full      |       1 | 249,940,696 |         0 |
+|  2 | TestVolume002 | Full      |       1 | 249,961,704 |         1 |
+|  3 | TestVolume003 | Full      |       1 | 249,961,704 |         2 |
+|  4 | TestVolume004 | Append    |       1 | 127,367,896 |         3 |
++----+---------------+-----------+---------+-------------+-----------+
+\end{verbatim}
+
 %%
 %%
 \chapter{New Features in 7.2.0}
@@ -1065,10 +1119,10 @@ by Bacula Systems.
 
 \subsection{Changes in the Pruning Algorithm}
 
-We rewrote the job pruning algorithm in this version. Previously, in some users
-reported that the pruning process at the end of jobs was very long. It should
-not be longer the case. Now, Bacula won't prune automatically a Job if this
-particular Job is needed to restore data. Example:
+We rewrote the job pruning algorithm in this version.  Previously, in some
+users reported that the pruning process at the end of jobs was very long.
+It should not be longer the case.  Now, Bacula won't prune automatically a
+Job if this particular Job is needed to restore data.  Example:
 
 \begin{verbatim}
 JobId: 1  Level: Full
@@ -1083,9 +1137,10 @@ resource causes that Jobs with Jobid in 1,2,3,4 can be pruned, Bacula will
 detect that JobId 1 and 4 are essential to restore data at the current state
 and will prune only JobId 2 and 3.
 
-\texttt{Important}, this change affect only the automatic pruning step after a
-Job and the \texttt{prune jobs} Bconsole command. If a volume expires after the
-\texttt{VolumeRetention} period, important jobs can be pruned.
+\texttt{Important}, this change affect only the automatic pruning step
+after a Job and the \texttt{prune jobs} Bconsole command.  If a volume
+expires after the \texttt{VolumeRetention} period, important jobs can be
+pruned.
 
 \subsection{Ability to Verify any specified Job}
 You now have the ability to tell Bacula which Job should verify instead of