Release Note clarifications

manuals/en/main/bareos.sty

@@ -95,6 +95,18 @@
 % and
 % \hyperlink{label}{text}
 
+\newcommand{\ticket}[1]{%
+    \href{https://bugs.bareos.org/view.php?id=#1}{Ticket \##1}%
+}
+
+\newcommand{\releaseUrlDownloadBareosOrg}[1]{%
+\url{http://download.bareos.org/bareos/release/#1/}%
+}
+
+\newcommand{\releaseUrlDownloadBareosCom}[1]{%
+\url{https://download.bareos.com/bareos/release/#1/}%
+}
+
 
 %
 % special characters

manuals/en/main/releasenotes.tex

@@ -1,17 +1,19 @@
 \label{releasenotes}
 
-The technical changelog is automatically generated from the Bareos bug tracking system, see \elink{http://bugs.bareos.org/changelog\_page.php}{http://bugs.bareos.org/changelog\_page.php}.
+The technical changelog is automatically generated from the Bareos bug tracking system, see \url{http://bugs.bareos.org/changelog\_page.php}.
 
 Please note, that some of the subreleases are only internal development releases.
 
 Open issues for a specific version are shown at
-\elink{http://bugs.bareos.org/roadmap\_page.php}{http://bugs.bareos.org/roadmap\_page.php}.
+\url{http://bugs.bareos.org/roadmap\_page.php}.
 
 The overview about new feature of a release are shown at
-\elink{https://github.com/bareos/bareos}{https://github.com/bareos/bareos} and in the \ilink{index}{index} of this document.
+\url{https://github.com/bareos/bareos} and in the \ilink{index}{index} of this document.
 
 This chapter concentrates on things to do when updating an existing Baroes installation.
 
+\warning{While all the source code is published on \elink{GitHub}{https://github.com/bareos/bareos}, the releases of packages on \url{http://download.baroes.org} is limited to the initial versions of a major release. Later maintenance releases are only published on \url{https://download.bareos.com}.}
+
 \section*{Bareos-14.2}
 
 It is known, that \command{drop_database} scripts will not longer work on PostgreSQL $<$ 8.4. However, as \command{drop_database} scripts are very seldom needed, package dependencies do not yet enforce PostgreSQL $>=$ 8.4.
@@ -22,26 +24,35 @@ \section*{Bareos-14.2}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2015-03-23 \\
 Database Version  & 2003 (unchanged)\\
-Release Ticket    & \url{https://bugs.bareos.org/view.php?id=420}
+Release Ticket    & \ticket{420} \\
+Url               & \releaseUrlDownloadBareosCom{14.2} \\
 \end{tabular}
 
-Besides other bugs, this release also fixes \url{https://bugs.bareos.org/view.php?id=437}.
-Bareos in versions from 14.2.0 to 14.2.3 contain this bug.
-Under certain circumstances
-some files in the backup are reduced by a 64k block. This release fixes this bug.
-The problem did occur when having a job that needs multiple volumes
-and the next volume is created by autolabeling.
-In this case, the first file on the new volume could be broken.
-Tape based environment nearly never use autolabeling, so these setups are not affeced.
+This release contains several bugfix, including one major bugfix (\ticket{437}), relevant for those of you using backup to disk with autolabeling enabled.
+
+It can lead to loss of a 64k block of data when all of this conditions apply:
+\begin{itemize}
+ \item backups are written to disk (tape backups are not affected)
+ \item autolabelling is enabled
+ \item a backup spans over multiple volumes
+ \item the additional volumes are newly created and labeled during the backup
+\end{itemize}
+If existing volumes are used for backups spanning over multiple volumes, the problem does not occur.
+
+We recommend to update to the latest packages as soon as possible.
 
+If an update is not possible immediately,
+autolabeling should be disabled and volumes should be labelled manually
+until the update can be installed.
 }
 
 \releasenote{14.2.3}{
 
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2015-02-02 \\
 Database Version  & 2003 (unchanged)\\
-Release Ticket    & \url{https://bugs.bareos.org/view.php?id=393}
+Release Ticket    & \ticket{393}\\
+Url               & \releaseUrlDownloadBareosCom{14.2} \\
 \end{tabular}
 
 }
@@ -53,6 +64,8 @@ \section*{Bareos-14.2}
 Database Version  & 2003 (unchanged)\\
                   & Database update required if updating from version $<$ 14.2.\\
                   & See the \nameref{bareos-update} section for details.\\
+Url               & \releaseUrlDownloadBareosOrg{14.2} \\
+                  & \releaseUrlDownloadBareosCom{14.2} \\
 \end{tabular}
 
 First stable release of the Bareos 14.2 branch.
@@ -64,6 +77,7 @@ \section*{Bareos-14.2}
 Code Release & 2014-09-22 \\
 Database Version  & 2003\\
                   & Database update required, see the \nameref{bareos-update} section.\\
+Url               & \releaseUrlDownloadBareosOrg{14.2} \\
 \end{tabular}
 
 Beta release.
@@ -76,6 +90,7 @@ \section*{Bareos-13.2}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2014-11-05 \\
 Database Version  & 2002 (unchanged)\\
+Url               & \releaseUrlDownloadBareosCom{13.2} \\
 \end{tabular}
 }
 
@@ -85,6 +100,7 @@ \section*{Bareos-13.2}
 Code Release      & 2014-03-11 \\
 Database Version  & 2002\\
                   & Database update required, see the \nameref{bareos-update} section.\\
+Url               & \releaseUrlDownloadBareosCom{13.2} \\
 \end{tabular}
 
 It is known, that \command{drop_database} scripts will not longer work on PostgreSQL $<$ 8.4. However, as \command{drop_database} scripts are very seldom needed, package dependencies do not yet enforce PostgreSQL $>=$ 8.4. We plan to ensure this in future version of Bareos.
@@ -95,6 +111,8 @@ \section*{Bareos-13.2}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2013-11-19 \\
 Database Version  & 2001 (unchanged)\\
+Url               & \releaseUrlDownloadBareosOrg{13.2} \\
+                  & \releaseUrlDownloadBareosCom{13.2} \\
 \end{tabular}
 }
 
@@ -108,6 +126,8 @@ \section*{Bareos-12.4}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2013-11-19 \\
 Database Version  & 2001 (unchanged)\\
+Url               & \releaseUrlDownloadBareosOrg{12.4} \\
+                  & \releaseUrlDownloadBareosCom{12.4} \\
 \end{tabular}
 }
 
@@ -118,6 +138,7 @@ \section*{Bareos-12.4}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2013-09-10 \\
 Database Version  & 2001 (unchanged)\\
+Url               & \releaseUrlDownloadBareosCom{12.4} \\
 \end{tabular}
 }
 
@@ -127,6 +148,8 @@ \section*{Bareos-12.4}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2013-06-17 \\
 Database Version  & 2001 (unchanged)\\
+Url               & \releaseUrlDownloadBareosOrg{12.4} \\
+                  & \releaseUrlDownloadBareosCom{12.4} \\
 \end{tabular}
 }
 
@@ -136,6 +159,8 @@ \section*{Bareos-12.4}
 \begin{tabular}{p{0.2\textwidth} p{0.8\textwidth}}
 Code Release      & 2013-04-15 \\
 Database Version  & 2001 (unchanged)\\
+Url               & \releaseUrlDownloadBareosOrg{12.4} \\
+                  & \releaseUrlDownloadBareosCom{12.4} \\
 \end{tabular}
 }