Updating Bareos and Release Notes

adding section about how to update Bareos, Release Notes and howto access the Bareos catalog database.
Also some cleanup is applied.

manuals/en/main/accuratemode.tex

@@ -0,0 +1,4 @@
+\label{accuratemode}
+\TODO{to be written}
+
+See  \ilink{director fileset configuration about accurate mode}{dir-resource-accurate}.

manuals/en/main/backward-compability.tex

@@ -1,5 +1,6 @@
 \chapter{Backward Compatibility}
 \index[general]{Compatibility:Backward}
+\label{backward-compability}
 
 \section{Tape Formats}
 \index[general]{Tape!Format}
@@ -15,7 +16,7 @@ \section{Tape Formats}
 must be able to recognize old formats.  All the problems except the
 last are ones that we cannot solve, but by careful planning you can.
 
-Since the very beginning of Bacula (January 2000) until today (2013),
+Since the very beginning of Bacula (January 2000) until today (2014),
 there have been three major Bacula/Bareos tape formats.  The second format
 was introduced in Bacula version 1.27 in November of 2002.
 Bareos has been required to adapt the tape format to avoid potential trademark issues,
@@ -44,6 +45,7 @@ \section{Tape Formats}
 \section{Compatibility between Bareos and Bacula}
 \index[general]{Compatibility:Bacula}
 \index[general]{Bacula}
+\label{compat-bacula}
 
 A Director and a Storage Daemon should (must) always run at the same version.
 This is true for Baroes as well as for Bacula.

manuals/en/main/bareos-manual-main-reference.tex

@@ -19,10 +19,10 @@
 \usepackage{longtable}
 \usepackage{makeidx}
 \usepackage{index}
-\usepackage{hyperref}
 % \usepackage[linkcolor=black,colorlinks=true]{hyperref}
+%\usepackage{hyperref}
+\usepackage[hyperindex]{hyperref}
 \usepackage{url}
-\usepackage{varioref}
 \usepackage{moreverb}
 \renewcommand\verbatimtabsize{4\relax}
 \usepackage{ifthen}
@@ -42,7 +42,6 @@
 
 \usepackage{bareos}
 
-
 \makeindex
 \newindex{general}{general.idx}{general.ind}{General Index}
 \newindex{dir}{director.idx}{director.ind}{Director Index}
@@ -133,8 +132,7 @@ \chapter{Volume Management}
 \include{migration}
 
 \chapter{Accurate Mode}
-    \label{accuratemode}
-    \TODO{to be written}
+    \input{accuratemode}
 
 \include{basejob}
 
@@ -199,6 +197,9 @@ \chapter{Howtos}
 \chapter{Troubleshooting}
 \input{troubleshooting}
 
+\chapter{Release Notes}
+\input{releasenotes}
+
 \chapter{Bareos Copyright, Trademark, and Licenses}
 \label{LicenseChapter}
 \index[general]{Licenses!Bareos Copyright Trademark}
@@ -227,6 +228,11 @@ \section{GNU Lesser Gerneral Public License}
 % pull in the index
 %\clearpage
 \part{Index}
+
+% label should reside directly at index begin, not Index cover page.
+\phantomsection
+\label{index}
+
 \printindex[general]
 \printindex[dir]
 \printindex[sd]

manuals/en/main/bareos.sty

@@ -24,7 +24,10 @@
 \def\idir{../../images/conv/}  %% images directory
 
 \newcommand{\fileStoragePath}{\path|/var/lib/bareos/storage/|}
+\newcommand{\scriptPathUnix}{\path|/usr/lib/bareos/scripts/|}
 \newcommand{\configPathUnix}{\path|/etc/bareos/|}
+\newcommand{\configFileDirUnix}{\path|/etc/bareos/bareos-dir.conf|}
+\newcommand{\logfileUnix}{\path|/var/log/bareos/bareos.log|}
 
 
 %%
@@ -41,6 +44,7 @@
 \newcommand{\lt}{\textless}
 \newcommand{\gt}{\textgreater}
 
+\newcommand{\commandPrompt}{root{\at}linux:\~{}\# }
 \newcommand{\command}[1]{\path|#1|}
 \newcommand{\bcommand}[1]{\path|#1|}
 \newcommand{\file}[1]{\path|#1|}
@@ -50,6 +54,7 @@
 \newcommand{\parameter}[1]{\path|#1|}
 \newcommand{\variable}[1]{\path|#1|}
 \newcommand{\configdirective}[1]{\textbf{#1}}
+\newcommand{\host}[1]{\path|#1|}
 %%
 \newcommand{\debug}[1]{\marginpar{#1}}
 %%
@@ -60,6 +65,11 @@
 %%
 \newcommand{\warning}[1]{Please note! \textit{#1}}
 %%
+\newcommand{\releasenote}[2]{
+    \subsection*{bareos-#1}
+    \index[general]{#1!Release Notes}%
+    #2
+}
 \newcommand{\sinceVersion}[3]{Version $>=$ #3%
     \index[#1]{#2}%
     \index[general]{#3!#2}%
@@ -178,6 +188,7 @@
         %basicstyle=\ttfamily,
         basicstyle=\small,
         stringstyle=\ttfamily,
+        keepspaces=true,
         columns=fixed,
         backgroundcolor=\color{colorBconsole},
         frame=single,
@@ -203,13 +214,58 @@
         frame=single,
         framerule=0pt,
         basicstyle=\ttfamily,
+        keepspaces=true,
         columns=fullflexible,
         %label=config:#1,
         caption=#1,
         captionpos=b,
     }
 }{}
 
+\lstnewenvironment{config}[1]{%
+    % #1 caption
+    \renewcommand*{\lstlistingname}{Configuration}
+    \footnotesize
+    \definecolor{colorConfig}{gray}{0.9}
+    \lstset{
+        backgroundcolor=\color{colorConfig},
+        frame=single,
+        framerule=0pt,
+        basicstyle=\ttfamily,
+        keepspaces=true,
+        columns=fullflexible,
+        %label=config:#1,
+        caption=#1,
+        captionpos=b,
+        moredelim=[is][\it]{<input>}{</input>},
+        moredelim=[is][\underline]{<strong>}{</strong>},
+    }
+}{}
+
+\lstnewenvironment{commands}[1]{%
+    % #1 caption
+    \renewcommand*{\lstlistingname}{Commands}
+    \footnotesize
+    \definecolor{colorConfig}{gray}{0.9}
+    \lstset{
+        backgroundcolor=\color{colorConfig},
+        frame=single,
+        framerule=0pt,
+        basicstyle=\ttfamily,
+        keepspaces=true,
+        columns=fullflexible,
+        caption=#1,
+        captionpos=b,
+        % command only work for single commands without parameter.
+        % as workaround, split a command and its parameter as in following example:
+        % <command>su</command><input> - bareos</input>
+        moredelim=[is][\commandPrompt\bf]{<command>}{</command>},
+        moredelim=[is][\bf]{<parameter>}{</parameter>},
+        moredelim=[is][\bf]{<input>}{</input>},
+        moredelim=[is][\underline]{<strong>}{</strong>},
+    }
+}{}
+
 
 
 \newfloat{floatCommandOut}{h}{lop}
@@ -222,24 +278,23 @@
     \footnotesize
     \def\commandOut1{#1}
     \ifthenelse{\isempty{#2}}{
-        \def\commandPrompt{root@linux:\~{}\# }
+        \def\commandOutPrompt{\commandPrompt}
     }{
-        \def\commandPrompt{#2}
+        \def\commandOutPrompt{#2}
     }
 
     % \definecolor{shadecolor}{gray}{0.95}
     % TODO: does not work with htlatex
     % \snugshade
     \verbatim
-\commandPrompt{}#3
+\commandOutPrompt{}#3
 }
 {
     \endverbatim
     % \endsnugshade
     \ifthenelse{\isempty{\commandOut1}}{
     }{
         \captionof{floatCommandOut}{\commandOut1}
-        %\label{command:\commandOut1}
     }
 }
 

manuals/en/main/bconsole.tex

@@ -1151,7 +1151,7 @@ \section{Console Commands}
 
 \item[setbandwidth]
   \index[general]{Console!Command!setbandwidth}
-  This command (\sinceVersion{console}{setbandwidth}{12.4.0}) is used to limit the bandwidth of a running job or a client.
+  This command (\sinceVersion{console}{setbandwidth}{12.4.1}) is used to limit the bandwidth of a running job or a client.
 
 \begin{bconsole}{setbandwidth}
 setbandwidth limit=<nb> [jobid=<id> | client=<cli>]