Re: [RFR] templates://bacula/{bacula-director-sqlite.templates}
Christian Perrier wrote:
> Your review should be sent as an answer to this mail.
I'm having trouble generating a patch here; the Unstable source at
http://ftp.uk.debian.org/debian/pool/main/b/bacula/bacula_2.2.6-0.1.dsc
seems not to match yours.
> Template: bacula-director-sqlite/create_tables
[...]
> + Please choose whetther these tables should be automatically created.
Typo: ^
> Package: bacula
[...]
> + Bacula is a set of computer programs to manage backup, recovery and
> + verification of computer data across a network of computers of different
> + kinds.
Three repetitions of "computer"; cut the first two.
> Bacula is relatively easy to use and efficient, while offering many advanced
Avoid the interpretation "relatively (a) easy to use and (b)
efficient" by saying "efficient and relatively easy to use".
> storage management features that make it easy to find and recover lost or
> + damaged files. Due to its modular design, Bacula is scalable from small
> + single computer systems to systems consisting of hundreds of computers
> + located over a large network.
This is in danger of turning into "computer systems, networks of
computers, and computer network systems." Besides, once I'm told
a network contains hundreds of computers, I can make up my own mind
about whether that's large.
> This meta-package provides the entire suite of bacula applications:
> job scheduling, storage control, node connector, and administrative console.
I'd prefer meta-packages to state that they *install* these things
(or ensure their availability, or suchlike) rather than claiming
that they themselves "provide" them.
Bacula is a set of programs to manage backup, recovery and verification
of data across a network of computers of different kinds.
.
It is efficient and relatively easy to use, while offering many advanced
storage management features that make it easy to find and recover lost or
damaged files. Due to its modular design, Bacula is scalable from small
single computer systems to networks of hundreds of machines.
.
This meta-package installs the entire suite of Bacula applications: job
scheduling, storage control, node connector, and administrative console.
> Package: bacula-director-common
[...]
> +Description: network backup, recovery and verification - Director common files
Ultra-trivial typo: ^
[...]
> + The Bacula Director service supervises all the backup, restore, verify and
> + archive operations. The system administrator uses the Director to schedule
> + backups and to recover files.
> + The Director can run as a daemon or as a service (i.e. in the foreground).
I'm hoping we can make this:
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
but I may be misinterpreting.
> - There is a Win32 version of this program available for download from
> - Bacula's website: www.bacula.org
>
> This last paragraph is useless in the context of a Debian package.
Conceivably the information that there are Win32 clients could be
shifted to the blurb in the bacula meta-package (after the bit about
scalability).
Further changes, diffing against the RFR version:
Package: bacula-director-sqlite3
[...]
- This version stores Bacula's Catalog in an SQLite3 database, and thus is
+ This version stores Bacula's catalog in an SQLite 3 database, and thus is
Lowercasing catalog throughout, and insisting on whitespace in the
"upstream" name SQLite 3.
Package: bacula-fd
[...]
-Description: network backup, recovery and verification - filer daemon
+Description: network backup, recovery and verification - file daemon
"Filer daemon" would make a kind of sense, but it I don't see it
used anywhere except this synopsis line. I suspect a typo.
- This program has to be installed in the machine to be backed up. It is
+ The file daemon has to be installed on the machine to be backed up. It is
The long description should include the expansion of the
packagename. And you install software *on* a machine (though
hardware goes *in* it).
Package: bacula-server
[...]
- This meta-package provides an standard server install, comprising the
+ This meta-package provides a standard server install, consisting of the
director and storage daemons.
"An" install, but "a" blah blah install. Then there's "comprise";
according to the definitions in my dictionaries, it's the daemons
that comprise the server install, not vice versa. Some people use
the word in this reversed sense, but let's avoid the issue.
Package: bacula-sd
[...]
The storage daemon performs the storage and recovery of the file
- attributes and data to the physical backup media or volumes. In other
- words, it is responsible for reading and writing the tapes (or other
- storage media, such as files).
+ attributes and data to the physical media; in other words, it is
+ responsible for reading and writing the backups.
Streamlining the bit that's going to be repeated, leaving the issue
of media type to the package-specific section. (Besides, I wouldn't
talk about "writing the tapes"; I'd talk about writing the content
*to* the medium. But this feels dangerously like an en_US/en_GBism)
- It runs as a daemon on the machine which has the backup
- device(s) (usually a tape drive).
+ It runs on the machine which has access to the backup device(s) - usually
+ a tape drive, but alternatively other storage media, such as files.
Transplanted details, and avoidance of )(
Package: bacula-sd-sqlite3
[...]
-Description: network backup, recovery and verification - SD tools for SQLite3
+Description: network backup, recovery and verification - SQLite 3 SD tools
Reordered to save space.
- This package contains the bscan and bcopy utilities, which are used for
- recovery when Bacula's catalog is unavailable.
+ This package contains SQLite 3 versions of the bscan and bcopy utilities,
+ which are used for recovery when Bacula's catalog is unavailable.
Differentiating the long descriptions in line with the short ones.
Package: bacula-console
[...]
-Description: network backup, recovery and verification - management console
+Description: network backup, recovery and verification - text console
Taking out the word "management" to save space, then clarifying that
this is the basic non-GUI version.
- This prockage provides the TTY version of the console.
+ This package provides the text-interface version of the console.
"Prockage" is such a great typo it seems a shame to fix it. But
"TTY" isn't even particularly accurate jargon.
Package: bacula-console-wx
[...]
-Description: network backup, recovery and verification - WxWindows-based management console
+Description: network backup, recovery and verification - WxWindows console
Ditto. And it's a genuine WxWindows GUI, so no need for "-based".
This GUI interface has been designed to ease restore operations as much as
- possible as compared to the "conventional" console.
+ possible as compared to the basic text console.
"Conventional" isn't very informative to new users.
Package: bacula-console-qt
[...]
- This prockage provides a WxWindows GUI version of the console.
+ This package provides a Qt GUI version of the console.
Oh no it doesn't!
Package: bacula-traymonitor
[...]
-Description: network backup, recovery and verification (Tray monitor)
+Description: network backup, recovery and verification - tray monitor
Stylistic standardisation.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Template: bacula-director-sqlite/create_tables
Type: boolean
Default: true
_Description: Create tables for Bacula's catalog?
The tables needed for Bacula's catalog are missing. This is normal
for a fresh install of Bacula.
.
These tables are needed for the Bacula director to function.
Please choose whether these tables should be automatically created.
Template: bacula-director-sqlite/remove_catalog_on_purge
Type: boolean
Default: false
_Description: Remove catalog on purge?
Please choose whether the Bacula catalog should be removed when
the director package is purged.
Source: bacula
Section: utils
Priority: optional
Maintainer: John Goerzen <jgoerzen@complete.org>
Build-Depends: autotools-dev, debhelper (>= 4.2), po-debconf (>= 0.8.2),
zlib1g-dev, libreadline5-dev | libreadline-dev, libjconv-dev,
libsqlite0-dev, libsqlite3-dev, libmysqlclient15-dev (>= 5.0.24-1) | libmysqlclient14-dev, libpq-dev,
libwrap0-dev, python-dev,
libgnome2-dev, libwxgtk2.6-dev, libacl1-dev, libkrb5-dev, libgnomeui-dev,
libx11-dev, mtx, bc, libxt-dev, dpkg-dev (>= 1.13.19), libqt4-dev, libqwt5-qt4-dev
Build-Conflicts: python2.2-dev, python2.3, qt3-dev-tools
Standards-Version: 3.7.2
Package: bacula
Architecture: all
Depends: bacula-server, bacula-client
Suggests: bacula-doc
Description: network backup, recovery and verification - meta-package
Bacula is a set of programs to manage backup, recovery and verification
of computer data across a network of computers of different kinds.
.
It is efficient and relatively easy to use, while offering many advanced
storage management features that make it easy to find and recover lost or
damaged files. Due to its modular design, Bacula is scalable from small
single computer systems to networks of hundreds of machines.
.
This meta-package installs the entire suite of Bacula applications: job
scheduling, storage control, node connector, and administrative console.
Package: bacula-common
Architecture: all
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0
Depends: adduser (>= 3.0)
Suggests: bacula-doc
Description: network backup, recovery and verification - common support files
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
This package provides files that are useful for other Bacula packages.
Package: bacula-director-common
Architecture: any
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0, bacula-common (= ${source:Version})
Depends: ${shlibs:Depends}, adduser, mailx
Description: network backup, recovery and verification - Director common files
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
This package provides common files for the Bacula Director daemon.
Package: bacula-director-sqlite
Architecture: any
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0
Depends: bacula-director-common (= ${binary:Version}), sqlite, ${shlibs:Depends}
Conflicts: bacula-director
Provides: bacula-director
Replaces: bacula-director
Description: network backup, recovery and verification - SQLite storage for Director
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
This version stores Bacula's catalog in an SQLite database, and thus is
suited for smaller installations.
Package: bacula-director-sqlite3
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0
Architecture: any
Depends: bacula-director-common (= ${binary:Version}), sqlite3, ${shlibs:Depends}
Conflicts: bacula-director
Provides: bacula-director
Replaces: bacula-director
Description: network backup, recovery and verification - SQLite 3 storage for Director
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
This version stores Bacula's catalog in an SQLite 3 database, and thus is
suited for smaller installations.
Package: bacula-director-mysql
Architecture: any
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0
Depends: bacula-director-common (= ${binary:Version}), dbconfig-common (>= 1.8.19), mysql-client, ${shlibs:Depends}
Conflicts: bacula-director
Provides: bacula-director
Replaces: bacula-director
Recommends: mysql-server (>= 4.0)
Description: network backup, recovery and verification - MySQL storage for Director
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
This version stores Bacula's catalog in a MySQL server, and thus is suited
for largish installations.
Package: bacula-director-pgsql
Pre-Depends: debconf (>= 1.4.30) | debconf-2.0
Architecture: any
Depends: bacula-director-common (= ${binary:Version}), dbconfig-common (>= 1.8.19), postgresql-client (>= 7.4) | postgresql-client-8.1 | postgresql-client-7.4 , ${shlibs:Depends}
Conflicts: bacula-director
Provides: bacula-director
Replaces: bacula-director
Recommends: postgresql-8.1 | postgresql-8.0 | postgresql (>= 7.4)
Suggests: postgresql-contrib, postgresql-doc
Description: network backup, recovery and verification - PostgreSQL storage for Director
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
This version stores Bacula's catalog in a PostgreSQL server, and thus is
suited for largish installations.
Package: bacula-client
Architecture: all
Depends: bacula-console (>= ${source:Version}), bacula-fd (>= ${source:Version})
Recommends: bacula-traymonitor
Description: network backup, recovery and verification - client meta-package
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
The package is a meta-package for client installations (file daemon and
console only).
Package: bacula-fd
Architecture: any
Depends: bacula-common (= ${source:Version}), ${shlibs:Depends}
Suggests: bacula-traymonitor
Description: network backup, recovery and verification - file daemon
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The Bacula Director service supervises all the backup, restore, verify and
archive operations. It can run as a daemon or as a foreground service which
administrators can use to schedule backups and recover files.
.
The file daemon has to be installed on the machine to be backed up. It is
responsible for providing the file attributes and data when requested by
the Director, and also for the filesystem-dependent part of restoration.
Package: bacula-server
Architecture: all
Depends: bacula-director-sqlite3 (>= ${source:Version})|bacula-director, bacula-sd (>= ${source:Version}), bacula-sd-sqlite3 (>= ${source:Version})|bacula-sd-tools
Recommends: bacula-fd
Description: network backup, recovery and verification - server meta-package
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
This meta-package provides a standard server install, consisting of the
director and storage daemons.
Package: bacula-sd
Architecture: any
Pre-Depends: bacula-common (= ${source:Version})
Depends: ${shlibs:Depends}, mtx, python
Recommends: mt-st, bacula-sd-tools
Suggests: dds2tar, scsitools, sg3-utils
Description: network backup, recovery and verification - storage daemon
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The storage daemon performs the storage and recovery of the file
attributes and data to the physical media; in other words, it is
responsible for reading and writing the backups.
.
It runs on the machine which has access to the backup device(s) - usually
a tape drive, but alternatively other storage media, such as files.
Package: bacula-sd-sqlite3
Architecture: any
Depends: bacula-sd (= ${binary:Version}), ${shlibs:Depends}
Conflicts: bacula-sd-tools, bacula-sd (<< 1.38.9)
Replaces: bacula-sd-tools, bacula-sd (<< 1.38.9)
Provides: bacula-sd-tools
Description: network backup, recovery and verification - SQLite 3 SD tools
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The storage daemon performs the storage and recovery of the file
attributes and data to the physical media; in other words, it is
responsible for reading and writing the backups.
.
This package contains SQLite 3 versions of the bscan and bcopy utilities,
which are used for recovery when Bacula's catalog is unavailable.
Package: bacula-sd-sqlite
Architecture: any
Depends: bacula-sd (= ${binary:Version}), ${shlibs:Depends}
Conflicts: bacula-sd-tools, bacula-sd (<< 1.38.9)
Replaces: bacula-sd-tools, bacula-sd (<< 1.38.9)
Provides: bacula-sd-tools
Description: network backup, recovery and verification - SQLite SD tools
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The storage daemon performs the storage and recovery of the file
attributes and data to the physical media; in other words, it is
responsible for reading and writing the backups.
.
This package contains SQLite versions of the bscan and bcopy utilities,
which are used for recovery when Bacula's catalog is unavailable.
Package: bacula-sd-mysql
Architecture: any
Depends: bacula-sd (= ${binary:Version}), ${shlibs:Depends}
Conflicts: bacula-sd-tools, bacula-sd (<< 1.38.9)
Replaces: bacula-sd-tools, bacula-sd (<< 1.38.9)
Provides: bacula-sd-tools
Description: network backup, recovery and verification - MySQL SD tools
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The storage daemon performs the storage and recovery of the file
attributes and data to the physical media; in other words, it is
responsible for reading and writing the backups.
.
This package contains MySQL versions of the bscan and bcopy utilities,
which are used for recovery when Bacula's catalog is unavailable.
Package: bacula-sd-pgsql
Architecture: any
Depends: bacula-sd (= ${binary:Version}), ${shlibs:Depends}
Conflicts: bacula-sd-tools, bacula-sd (<< 1.38.9)
Replaces: bacula-sd-tools, bacula-sd (<< 1.38.9)
Provides: bacula-sd-tools
Description: network backup, recovery and verification - PostgreSQL SD tools
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The storage daemon performs the storage and recovery of the file
attributes and data to the physical media; in other words, it is
responsible for reading and writing the backups.
.
This package contains PostgreSQL versions of the bscan and bcopy utilities,
which are used for recovery when Bacula's catalog is unavailable.
Package: bacula-console
Architecture: any
Pre-Depends: debconf (>= 1.4.30)
Depends: bacula-common (= ${source:Version}), ${shlibs:Depends}
Description: network backup, recovery and verification - text console
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The management console allows the administrator or user to
communicate with the Bacula Director.
.
This package provides the text-interface version of the console.
Package: bacula-console-wx
Provides: bacula-wxconsole
Replaces: bacula-wxconsole
Conflicts: bacula-wxconsole
Architecture: any
Pre-Depends: debconf (>= 1.4.30)
Depends: bacula-common (= ${source:Version}), ${shlibs:Depends}
Description: network backup, recovery and verification - WxWindows console
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The management console allows the administrator or user to
communicate with the Bacula Director.
.
This package provides a WxWindows GUI version of the console.
.
This GUI interface has been designed to ease restore operations as much as
possible as compared to the basic text console.
Package: bacula-console-qt
Architecture: any
Pre-Depends: debconf (>= 1.4.30)
Depends: bacula-common (= ${source:Version}), ${shlibs:Depends}
Description: network backup, recovery and verification - Qt console
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
The management console allows the administrator or user to
communicate with the Bacula Director.
.
This package provides a Qt GUI version of the console.
.
This GUI interface has been designed to ease restore operations as much as
possible as compared to the basic text console.
Package: bacula-traymonitor
Architecture: any
Depends: ${shlibs:Depends}, bacula-common (= ${source:Version})
Recommends: kde|desktop-environment
Description: network backup, recovery and verification - tray monitor
Bacula is a set of programs to manage backup, recovery and verification of
data across a network of computers of different kinds.
.
This package provides a tray monitor for the Bacula backup system. It is
FreeDesktop-compatible, which means it will work under both KDE and
GNOME.
.
The monitor constantly displays Bacula's status.
Reply to: