[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://boxbackup/{boxbackup-client.templates,boxbackup-server.templates}



Please find, for review, the debconf templates of boxbackup.

This review will last from Saturday, June 02, 2007 to Tuesday, June 12, 2007.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:

--- /home/bubulle/travail/debian/rewrite/INTENT/boxbackup/boxbackup.old/debian/boxbackup-client.templates	2007-05-25 08:09:06.963866340 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/boxbackup/boxbackup/debian/boxbackup-client.templates	2007-06-02 13:39:20.292789046 +0200
@@ -1,130 +1,125 @@
 Template: boxbackup-client/debconf
 Type: boolean
 Default: true
-_Description: Do you want to handle the boxbackup client configuration with debconf?
- Debconf can create the configuration files for boxbackup client.
- If you prefer to do this by yourself you will need to use the script
- bbackupd-config provided by this package.
+_Description: Should the BoxBackup client be configured automatically?
+ The package configuration scripts can create the configuration files
+ for the BoxBackup client.

No mention of "debconf". General policy for debconf templates

Consistent writing of "BoxBackup" (debian/control uses this)

We could maybe keep the mention of the program that does it
separately, though I consider this extra cruft.

  .
- The server won't start if it isn't configured.
+ You should choose this option if you are not familiar with BoxBackup's
+ configuration options.
  .
- Whatever you choose here, you will need to read the README.Debian file
- in /usr/share/doc/boxbackup-client.
+ Please read the /usr/share/doc/boxbackup-client/README.Debian for details
+ about the configuration of the BoxBackup client.

Consistent writing style across packages.

 
 Template: boxbackup-client/backupMode
 Type: select
-Choices: lazy, snapshot
-_Description: Run boxbackup client in lazy or snapshot mode:
- Boxbackup client supports two modes of backup:
+__Choices: lazy, snapshot

Choices can be translated

+_Description: Run mode for the BoxBackup client:


Consistent style

+ The BoxBackup client supports two modes of backup:
  .
- In the lazy mode, the backup daemon will regularly scan your filesystem
- searching for modified files. It will then upload the files over a
+ In the 'lazy' mode, the backup daemon will regularly scan the file system
+ searching for modified files. It will then upload the files older than a
  specified age to the backup server.
  .
- In snapshot mode the backup will be explicitly run at given time set in
- a cron entry. The cron file is provided with this package, you will
- have to set the time you wish the backup to occur
- (/etc/cron.d/boxbackup-client).
+ In the 'snapshot' mode the backup will be explicitly run at regular intervals.
+ An cron file (/etc/cron.d/boxbackup-client) is provided with the
+ package and should be adapted to suit your needs.
+ 

General: 'better' writing, imho

 
 Template: boxbackup-client/accountNumber
 Type: string
 _Description: Account number for this node on the backup server:
- The administrator of the boxbackup server (perhaps you) should have provided
- you an account number. It consits in an hexadecimal number.
+ The administrator of the BoxBackup server should have assigned this client
+ an account hexadecimal number.

"perhaps you" is useless, imho. The account number is assigned to the
client, not the person.

  .
- If you don't already have one, leave that field blank. You will be able to
- configure it later by running dpkg-reconfigure boxbackup-client as root.
+ If no account number has been assigned yet, leave that field blank and
+ configure it later by running 'dpkg-reconfigure boxbackup-client' as root.

General writing style consistency
 
 Template: boxbackup-client/incorrectAccountNumber
 Type: error
-_Description: Please enter an hexadecimal number
+_Description: Invalid account number
  The account number must be an hexadecimal number (e.g. 1E04 or 4500).

Usual style for note/error. The short description is a title.

 
 Template: boxbackup-client/backupServer
 Type: string
-_Description: Full qualified domain name of the backup server:
- The server name is the computer running an instance of Boxbackup server
- your client will connect to. It must be the fully qualified domain name
- of that machine (that can be resolve to an IP address).
- If you are behind a firewall, you must allow outgoing connexion to tcp
- port 2201 to be able to reach the server.
+_Description: Fully qualified domain name of the backup server:
+ Please enter the fully qualified domain name of the BoxBackup server which
+ your client will use.
+ .
+ The client will connect to the TCP port 2201 of the server.

General style rewrite. I see no need to mention that port 2201 should
be opened with firewalls. Just mention that the protocol uses port 2201.

 
 Template: boxbackup-client/backupDirs
 Type: string
 _Description: List of directories to backup:
- You must tell boxbackup which directories you would like to backup to the remote
+ Please mention a space-separated list of directories to backup to the remote
  server.

One does not "tell" something to a program. General write style
consistency across packages.

  .
- You must enter this directories as a space separated list of absolute path names.
- Be careful that those directories do NOT contain other mounted file systems within
- them at any depth or you will have problems.
+ Those directories should not include mounted file systems on some of their
+ subdirectories, at any level.
 
 Template: boxbackup-client/incorrectDirectories
-Type: note
-_Description: Please enter correct path names
- The path names to the directories must be absolute path names separated by spaces.
+Type: error
+_Description: Invalid path name
+ The path names to the directories must be absolute path names, separated
+ by spaces.
  .
  For example: /home/myaccount /etc/

Usual style for error templates. Please note that I turn such
templates to "error" type, now supported in debconf.

 
 Template: boxbackup-client/UpdateStoreInterval
 Type: string
 Default: 3600
-_Description: Interval in seconds between scan of directories:
- Boxbackup scans the directories you have selected looking for modified files.
- This scans occurs at regular interval that you can customize.
+_Description: Interval (in seconds) between directories' scans:
+ BoxBackup regularly scans the selected directories, looking for modified
+ files.
  .
- The default value is 3600s (one hour).
+ Please choose the scan interval in seconds.

I see no value added mentioning the default. It is already quite clear
as it is displayed..:-)

Make the template shorter and clearer.

 
 Template: boxbackup-client/MinimumFileAge
 Type: string
 Default: 21600
-_Description: Time to wait after a file modification before uploading it:
+_Description: Minimum time to wait (in seconds) before uploading a file:
  A file will be uploaded to the server only after a certain time after its
- last modification. Reducing this value results in often modfied files being
- uploaded more often to the server. This means that more revisions will be
- created on the server and therefore the quota limit will be reached faster
- (thus removing older revisions of the files sooner).
+ last modification. 
  .
- The default value is 21600 seconds (six hours).
+ Low interval values will trigger frequent uploads to the server and more
+ revisions being created with older revisions being removed earlier.

Ditto. Shorter and clearer.

 
 Template: boxbackup-client/MaxUploadWait
 Type: string
 Default: 86400
-_Description: Maximum time to wait before uploading a frequently modified file:
- As a file is not uploaded before a certain time after its last modification,
- if it is frequently modified, it would never get uploaded. So this parameter
- defines the maximum time to wait since the first modification noticed
- before uploading a file.
+_Description: Maximum time to wait (in seconds) before uploading a file:
+ Frequently modified files are likely to never get uploaded if they
+ never reach the minimum wait time.
  .
- The default value is 86400 seconds (1 day).
+ Please enter the maximum time to reach before the upload of a modified
+ file to the server is enforced.

Ditto again.

 
 Template: boxbackup-client/IncorrectNumber
-Type: note
-_Description: Please enter a correct number of seconds
- This parameter must be a number.
+Type: error
+_Description: Invalid time entered
+ Please enter an integer number.

Again, error template and short description as a title.

 
 Template: boxbackup-client/notifyMail
 Type: string
 Default: root
-_Description: User name or email address to send notification to:
- Boxbackup client must know the user name or email address of the person
- who will receive alert notifications. Such notifications are sent when
- a problem occurs during the backup (the store is full or some files
- were not readable).
+_Description: Recipient for alert notifications:
+ The BoxBackup client sends alert notifications when a problem occurs
+ during the backup.
  .
- Enter either a user name (e.g. root) or an email address (e.g. admin@mydomain.org)
+ Please enter either a local user name (for example 'root') or an email
+ address (for example 'admin@example.org').

Short description shorter.

A program does not "know" anything. Let's give the fact: the program
sends alerts and we have to mention who these must be sent to.

 
 Template: boxbackup-client/generateCertificate
 Type: boolean
 Default: true
-_Description: Generate the client private key and x509 certificate request?
- The boxbackup client needs a RSA private key and the corresponding x509 certificate
- to authenticate itself to the server.
- .
- Debconf can generate for you the private key and a x509 certificate sign request.
- You will need to send the certificate request to the administrator of the Boxbackup server
- and this one will sign it and send it back to you along with the server Certification Authority
- certificate. You will need to put these files in your boxbackup configuration directory (see
- /etc/boxbackup/bbackupd.conf file for the exact name to give to these files).
+_Description: Generate the client private key and X.509 certificate request?
+ The BoxBackup client needs a RSA private key and the corresponding X.509
+ certificate to authenticate itself with the server.
+ .
+ Both can be generated automatically. You will need to send the
+ certificate request to the BoxBackup server administrator who will
+ sign it and send it back to you along with the server's Certification
+ Authority certificate.
  .
- If you prefer to manage this by yourself, say No here.
+ These files should be copied in BoxBackup's configuration directory. The file
+ names to use are mentioned in the /etc/boxbackup/bbackupd.conf file.

X.509 is the correct spelling.

General attempt to make the template shorter and clearer again.

Changes to boxbackup-server are mostly similar. I tried to keep
consistency between both templates files.

 
--- /home/bubulle/travail/debian/rewrite/INTENT/boxbackup/boxbackup.old/debian/control	2007-05-25 08:09:06.999866641 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/boxbackup/boxbackup/debian/control	2007-06-02 13:38:20.295739233 +0200
@@ -11,20 +11,20 @@
 Architecture: any
 Depends: ${misc:Depends}, ${shlibs:Depends}, adduser, perl, gawk, ucf, openssl, debconf | debconf-2.0
 Recommends: boxbackup-utils
-Description: Server for BoxBackup remote backup system
- Boxbackup is an automatic on-line backup system.
+Description: server for the BoxBackup remote backup system

No initial capital

+ BoxBackup is an automatic on-line backup system.

Consistent spelling of "BoxBackup"

...and X.509 spellin as well.

Template: boxbackup-client/debconf
Type: boolean
Default: true
_Description: Should the BoxBackup client be configured automatically?
 The package configuration scripts can create the configuration files
 for the BoxBackup client.
 .
 You should choose this option if you are not familiar with BoxBackup's
 configuration options.
 .
 Please read the /usr/share/doc/boxbackup-client/README.Debian for details
 about the configuration of the BoxBackup client.

Template: boxbackup-client/backupMode
Type: select
__Choices: lazy, snapshot
_Description: Run mode for the BoxBackup client:
 The BoxBackup client supports two modes of backup:
 .
 In the 'lazy' mode, the backup daemon will regularly scan the file system
 searching for modified files. It will then upload the files older than a
 specified age to the backup server.
 .
 In the 'snapshot' mode the backup will be explicitly run at regular intervals.
 An cron file (/etc/cron.d/boxbackup-client) is provided with the
 package and should be adapted to suit your needs.
 

Template: boxbackup-client/accountNumber
Type: string
_Description: Account number for this node on the backup server:
 The administrator of the BoxBackup server should have assigned this client
 an account hexadecimal number.
 .
 If no account number has been assigned yet, leave that field blank and
 configure it later by running 'dpkg-reconfigure boxbackup-client' as root.

Template: boxbackup-client/incorrectAccountNumber
Type: error
_Description: Invalid account number
 The account number must be an hexadecimal number (e.g. 1E04 or 4500).

Template: boxbackup-client/backupServer
Type: string
_Description: Fully qualified domain name of the backup server:
 Please enter the fully qualified domain name of the BoxBackup server which
 your client will use.
 .
 The client will connect to the TCP port 2201 of the server.

Template: boxbackup-client/backupDirs
Type: string
_Description: List of directories to backup:
 Please mention a space-separated list of directories to backup to the remote
 server.
 .
 Those directories should not include mounted file systems on some of their
 subdirectories, at any level.

Template: boxbackup-client/incorrectDirectories
Type: error
_Description: Invalid path name
 The path names to the directories must be absolute path names, separated
 by spaces.
 .
 For example: /home/myaccount /etc/

Template: boxbackup-client/UpdateStoreInterval
Type: string
Default: 3600
_Description: Interval (in seconds) between directories' scans:
 BoxBackup regularly scans the selected directories, looking for modified
 files.
 .
 Please choose the scan interval in seconds.

Template: boxbackup-client/MinimumFileAge
Type: string
Default: 21600
_Description: Minimum time to wait (in seconds) before uploading a file:
 A file will be uploaded to the server only after a certain time after its
 last modification. 
 .
 Low interval values will trigger frequent uploads to the server and more
 revisions being created with older revisions being removed earlier.

Template: boxbackup-client/MaxUploadWait
Type: string
Default: 86400
_Description: Maximum time to wait (in seconds) before uploading a file:
 Frequently modified files are likely to never get uploaded if they
 never reach the minimum wait time.
 .
 Please enter the maximum time to reach before the upload of a modified
 file to the server is enforced.

Template: boxbackup-client/IncorrectNumber
Type: error
_Description: Invalid time entered
 Please enter an integer number.

Template: boxbackup-client/notifyMail
Type: string
Default: root
_Description: Recipient for alert notifications:
 The BoxBackup client sends alert notifications when a problem occurs
 during the backup.
 .
 Please enter either a local user name (for example 'root') or an email
 address (for example 'admin@example.org').

Template: boxbackup-client/generateCertificate
Type: boolean
Default: true
_Description: Generate the client private key and X.509 certificate request?
 The BoxBackup client needs a RSA private key and the corresponding X.509
 certificate to authenticate itself with the server.
 .
 Both can be generated automatically. You will need to send the
 certificate request to the BoxBackup server administrator who will
 sign it and send it back to you along with the server's Certification
 Authority certificate.
 .
 These files should be copied in BoxBackup's configuration directory. The file
 names to use are mentioned in the /etc/boxbackup/bbackupd.conf file.
Template: boxbackup-server/debconf
Type: boolean
Default: true
_Description: Should BoxBackup be configured automatically?
 The package configuration scripts can create the configuration files
 for the BoxBackup server.
 .
 You should choose this option if you are not familiar with BoxBackup's
 configuration options. The configuration can be done manually with the
 'raidfile-config' and 'bbstored-config' scripts.
 .
 The server will not start if it is not configured. In all cases,
 reading the /usr/share/doc/boxbackup-server/README.Debian is
 recommended.

Template: boxbackup-server/raidDirectories
Type: string
_Description: Location of the RAID directories:
 Please choose the location for the 3 RAID file directories.
 .
 RAID is enabled if the directories names (space-separated) point to
 3 partitions on 3 differents physical hard drives (e.g.
 '/raid/0.0 /raid/0.1 /raid/0.2').
 .
 If you don't want to enable RAID, just specify the path to one directory
 where the backups will be stored in (e.g. /usr/local/lib/boxbackup).
 .
 These directories will be created if they do not exist.

Template: boxbackup-server/incorrectDirectories
Type: error
_Description: Invalid path names
 The path names to the directories must be absolute path names,
 separated by spaces.
 .
 For example: /raid/0.0 /raid/0.1 /raid/0.2

Template: boxbackup-server/raidBlockSize
Type: string
Default: 4096
_Description: Block size for the userland RAID system:
 BoxBackup uses userland RAID techniques.
 .
 Please choose the block size to use for the storage.
 For maximum efficiency, you should choose the block size of the underlying
 filesystem (which can be displayed with the 'tune2fs -l' command).
 .
 This value should be set even if you don't plan to use RAID.

Template: boxbackup-server/generateCertificate
Type: boolean
Default: true
_Description: Generate a server private key and a X.509 certificate request?
 The BoxBackup server needs a RSA private key and the corresponding X.509
 certificate to perform client-server authentication and communication
 encryption.
 .
 Both can be generated automatically. You will need to sign the
 certificate with your root CA (see the boxbackup-utils package) and
 put this signed certificate and the root CA certificate in the
 configuration folder.

Template: boxbackup-server/incorrectBlocksize
Type: error
_Description: Invalid block size
 The block size must be a power of two number (e.g. 1024 or 4096).

--- ../boxbackup.old/debian/boxbackup-client.templates	2007-05-25 08:09:06.963866340 +0200
+++ debian/boxbackup-client.templates	2007-06-02 13:39:20.292789046 +0200
@@ -1,130 +1,125 @@
 Template: boxbackup-client/debconf
 Type: boolean
 Default: true
-_Description: Do you want to handle the boxbackup client configuration with debconf?
- Debconf can create the configuration files for boxbackup client.
- If you prefer to do this by yourself you will need to use the script
- bbackupd-config provided by this package.
+_Description: Should the BoxBackup client be configured automatically?
+ The package configuration scripts can create the configuration files
+ for the BoxBackup client.
  .
- The server won't start if it isn't configured.
+ You should choose this option if you are not familiar with BoxBackup's
+ configuration options.
  .
- Whatever you choose here, you will need to read the README.Debian file
- in /usr/share/doc/boxbackup-client.
+ Please read the /usr/share/doc/boxbackup-client/README.Debian for details
+ about the configuration of the BoxBackup client.
 
 Template: boxbackup-client/backupMode
 Type: select
-Choices: lazy, snapshot
-_Description: Run boxbackup client in lazy or snapshot mode:
- Boxbackup client supports two modes of backup:
+__Choices: lazy, snapshot
+_Description: Run mode for the BoxBackup client:
+ The BoxBackup client supports two modes of backup:
  .
- In the lazy mode, the backup daemon will regularly scan your filesystem
- searching for modified files. It will then upload the files over a
+ In the 'lazy' mode, the backup daemon will regularly scan the file system
+ searching for modified files. It will then upload the files older than a
  specified age to the backup server.
  .
- In snapshot mode the backup will be explicitly run at given time set in
- a cron entry. The cron file is provided with this package, you will
- have to set the time you wish the backup to occur
- (/etc/cron.d/boxbackup-client).
+ In the 'snapshot' mode the backup will be explicitly run at regular intervals.
+ An cron file (/etc/cron.d/boxbackup-client) is provided with the
+ package and should be adapted to suit your needs.
+ 
 
 Template: boxbackup-client/accountNumber
 Type: string
 _Description: Account number for this node on the backup server:
- The administrator of the boxbackup server (perhaps you) should have provided
- you an account number. It consits in an hexadecimal number.
+ The administrator of the BoxBackup server should have assigned this client
+ an account hexadecimal number.
  .
- If you don't already have one, leave that field blank. You will be able to
- configure it later by running dpkg-reconfigure boxbackup-client as root.
+ If no account number has been assigned yet, leave that field blank and
+ configure it later by running 'dpkg-reconfigure boxbackup-client' as root.
 
 Template: boxbackup-client/incorrectAccountNumber
 Type: note
-_Description: Please enter an hexadecimal number
+_Description: Invalid account number
  The account number must be an hexadecimal number (e.g. 1E04 or 4500).
 
 Template: boxbackup-client/backupServer
 Type: string
-_Description: Full qualified domain name of the backup server:
- The server name is the computer running an instance of Boxbackup server
- your client will connect to. It must be the fully qualified domain name
- of that machine (that can be resolve to an IP address).
- If you are behind a firewall, you must allow outgoing connexion to tcp
- port 2201 to be able to reach the server.
+_Description: Fully qualified domain name of the backup server:
+ Please enter the fully qualified domain name of the BoxBackup server which
+ your client will use.
+ .
+ The client will connect to the TCP port 2201 of the server.
 
 Template: boxbackup-client/backupDirs
 Type: string
 _Description: List of directories to backup:
- You must tell boxbackup which directories you would like to backup to the remote
+ Please mention a space-separated list of directories to backup to the remote
  server.
  .
- You must enter this directories as a space separated list of absolute path names.
- Be careful that those directories do NOT contain other mounted file systems within
- them at any depth or you will have problems.
+ Those directories should not include mounted file systems on some of their
+ subdirectories, at any level.
 
 Template: boxbackup-client/incorrectDirectories
-Type: note
-_Description: Please enter correct path names
- The path names to the directories must be absolute path names separated by spaces.
+Type: error
+_Description: Invalid path name
+ The path names to the directories must be absolute path names, separated
+ by spaces.
  .
  For example: /home/myaccount /etc/
 
 Template: boxbackup-client/UpdateStoreInterval
 Type: string
 Default: 3600
-_Description: Interval in seconds between scan of directories:
- Boxbackup scans the directories you have selected looking for modified files.
- This scans occurs at regular interval that you can customize.
+_Description: Interval (in seconds) between directories' scans:
+ BoxBackup regularly scans the selected directories, looking for modified
+ files.
  .
- The default value is 3600s (one hour).
+ Please choose the scan interval in seconds.
 
 Template: boxbackup-client/MinimumFileAge
 Type: string
 Default: 21600
-_Description: Time to wait after a file modification before uploading it:
+_Description: Minimum time to wait (in seconds) before uploading a file:
  A file will be uploaded to the server only after a certain time after its
- last modification. Reducing this value results in often modfied files being
- uploaded more often to the server. This means that more revisions will be
- created on the server and therefore the quota limit will be reached faster
- (thus removing older revisions of the files sooner).
+ last modification. 
  .
- The default value is 21600 seconds (six hours).
+ Low interval values will trigger frequent uploads to the server and more
+ revisions being created with older revisions being removed earlier.
 
 Template: boxbackup-client/MaxUploadWait
 Type: string
 Default: 86400
-_Description: Maximum time to wait before uploading a frequently modified file:
- As a file is not uploaded before a certain time after its last modification,
- if it is frequently modified, it would never get uploaded. So this parameter
- defines the maximum time to wait since the first modification noticed
- before uploading a file.
+_Description: Maximum time to wait (in seconds) before uploading a file:
+ Frequently modified files are likely to never get uploaded if they
+ never reach the minimum wait time.
  .
- The default value is 86400 seconds (1 day).
+ Please enter the maximum time to reach before the upload of a modified
+ file to the server is enforced.
 
 Template: boxbackup-client/IncorrectNumber
-Type: note
-_Description: Please enter a correct number of seconds
- This parameter must be a number.
+Type: error
+_Description: Invalid time entered
+ Please enter an integer number.
 
 Template: boxbackup-client/notifyMail
 Type: string
 Default: root
-_Description: User name or email address to send notification to:
- Boxbackup client must know the user name or email address of the person
- who will receive alert notifications. Such notifications are sent when
- a problem occurs during the backup (the store is full or some files
- were not readable).
+_Description: Recipient for alert notifications:
+ The BoxBackup client sends alert notifications when a problem occurs
+ during the backup.
  .
- Enter either a user name (e.g. root) or an email address (e.g. admin@mydomain.org)
+ Please enter either a local user name (for example 'root') or an email
+ address (for example 'admin@example.org').
 
 Template: boxbackup-client/generateCertificate
 Type: boolean
 Default: true
-_Description: Generate the client private key and x509 certificate request?
- The boxbackup client needs a RSA private key and the corresponding x509 certificate
- to authenticate itself to the server.
- .
- Debconf can generate for you the private key and a x509 certificate sign request.
- You will need to send the certificate request to the administrator of the Boxbackup server
- and this one will sign it and send it back to you along with the server Certification Authority
- certificate. You will need to put these files in your boxbackup configuration directory (see
- /etc/boxbackup/bbackupd.conf file for the exact name to give to these files).
+_Description: Generate the client private key and X.509 certificate request?
+ The BoxBackup client needs a RSA private key and the corresponding X.509
+ certificate to authenticate itself with the server.
+ .
+ Both can be generated automatically. You will need to send the
+ certificate request to the BoxBackup server administrator who will
+ sign it and send it back to you along with the server's Certification
+ Authority certificate.
  .
- If you prefer to manage this by yourself, say No here.
+ These files should be copied in BoxBackup's configuration directory. The file
+ names to use are mentioned in the /etc/boxbackup/bbackupd.conf file.
--- ../boxbackup.old/debian/boxbackup-server.templates	2007-05-25 08:09:07.015866774 +0200
+++ debian/boxbackup-server.templates	2007-06-02 13:38:39.794780426 +0200
@@ -1,36 +1,37 @@
 Template: boxbackup-server/debconf
 Type: boolean
 Default: true
-_Description: Should Debconf handle your boxbackup config?
- Debconf can create the configuration files for boxbackup server.
- Select this option if you are familiar with boxbackup's
- configuration options. If you prefer to do this by yourself you
- will need to use the scripts raidfile-config and bbstored-config
- provided by this package.
- .
- The server won't start if it isn't configured.
- .
- Whatever you choose here, you will need to read the README.Debian file
- in /usr/share/doc/boxbackup-server.
+_Description: Should BoxBackup be configured automatically?
+ The package configuration scripts can create the configuration files
+ for the BoxBackup server.
+ .
+ You should choose this option if you are not familiar with BoxBackup's
+ configuration options. The configuration can be done manually with the
+ 'raidfile-config' and 'bbstored-config' scripts.
+ .
+ The server will not start if it is not configured. In all cases,
+ reading the /usr/share/doc/boxbackup-server/README.Debian is
+ recommended.
 
 Template: boxbackup-server/raidDirectories
 Type: string
 _Description: Location of the RAID directories:
- You have to choose the location for the 3 RAID file directories.
- To enable RAID, it must be 3 directories path names separated by spaces
- and those path names should point to 3 partitions on 3 differents
- physical hard drives.
- For example: /raid/0.0 /raid/0.1 /raid/0.2
+ Please choose the location for the 3 RAID file directories.
+ .
+ RAID is enabled if the directories names (space-separated) point to
+ 3 partitions on 3 differents physical hard drives (e.g.
+ '/raid/0.0 /raid/0.1 /raid/0.2').
  .
  If you don't want to enable RAID, just specify the path to one directory
  where the backups will be stored in (e.g. /usr/local/lib/boxbackup).
  .
- If they don't allready exist, these directories will be created for you.
+ These directories will be created if they do not exist.
 
 Template: boxbackup-server/incorrectDirectories
-Type: note
-_Description: Please enter correct path names
- The path names to the directories must be absolute path names separated by spaces.
+Type: error
+_Description: Invalid path names
+ The path names to the directories must be absolute path names,
+ separated by spaces.
  .
  For example: /raid/0.0 /raid/0.1 /raid/0.2
 
@@ -39,27 +40,28 @@
 Default: 4096
 _Description: Block size for the userland RAID system:
  BoxBackup uses userland RAID techniques.
- You have to choose the block size to use for the storage.
- For maximum efficiency, set it to the block size of the underlying
- filesystem (see tune2fs -l /dev/... to find your block size).
- Even if you don't plan to use RAID, you have to set that value.
+ .
+ Please choose the block size to use for the storage.
+ For maximum efficiency, you should choose the block size of the underlying
+ filesystem (which can be displayed with the 'tune2fs -l' command).
+ .
+ This value should be set even if you don't plan to use RAID.
 
 Template: boxbackup-server/generateCertificate
 Type: boolean
 Default: true
-_Description: Generate a the server private key and x509 certificate request?
- The boxbackup server needs a RSA private key and the corresponding x509
+_Description: Generate a server private key and a X.509 certificate request?
+ The BoxBackup server needs a RSA private key and the corresponding X.509
  certificate to perform client-server authentication and communication
  encryption.
  .
- Debconf can generate for you the private key and a x509 certificate sign request.
- You will need to sign the certificate with your root CA (see the boxbackup-utils package)
- and put this signed certificate and the root CA certificate in your configuration folder.
- .
- If you prefer to manage this by yourself, say No here.
+ Both can be generated automatically. You will need to sign the
+ certificate with your root CA (see the boxbackup-utils package) and
+ put this signed certificate and the root CA certificate in the
+ configuration folder.
 
 Template: boxbackup-server/incorrectBlocksize
-Type: note
-_Description: Please enter a power of two number
+Type: error
+_Description: Invalid block size
  The block size must be a power of two number (e.g. 1024 or 4096).
 
--- ../boxbackup.old/debian/control	2007-05-25 08:09:06.999866641 +0200
+++ debian/control	2007-06-02 13:38:20.295739233 +0200
@@ -11,20 +11,20 @@
 Architecture: any
 Depends: ${misc:Depends}, ${shlibs:Depends}, adduser, perl, gawk, ucf, openssl, debconf | debconf-2.0
 Recommends: boxbackup-utils
-Description: Server for BoxBackup remote backup system
- Boxbackup is an automatic on-line backup system.
+Description: server for the BoxBackup remote backup system
+ BoxBackup is an automatic on-line backup system.
  The server waits for connections from remote clients,
- authenticates them via x509 certificates and stores the
- encrypted data on hard drives with optionnals RAID techniques.
+ authenticates them via X.509 certificates and stores the
+ encrypted data on hard drives with optionnal RAID techniques.
  It also supports versions historization and per-user quotas.
 
 Package: boxbackup-client
 Architecture: any
 Depends: ${misc:Depends}, ${shlibs:Depends}, ucf, perl, openssl, debconf | debconf-2.0
-Description: Client for BoxBackup remote backup system
- Boxbackup is an automatic on-line backup system.
+Description: client for the BoxBackup remote backup system
+ BoxBackup is an automatic on-line backup system.
  The client is watching for changes on the local filesystem,
- connects to a Boxbackup server and send the changes via a
+ connects to a BoxBackup server and send the changes via a
  secure channel. All data is encrypted before being sent to
- the server. A command line tool is provided for restoration
+ the server. A command-line tool is provided for restoration
  of backups including deleted files and old versions.
Source: boxbackup
Section: utils
Priority: optional
Maintainer: Reinhard Tartler <siretart@tauware.de>
Build-Depends: debhelper (>> 5.0.0), libedit-dev, libdb4.3-dev, libssl-dev, zlib1g-dev
Standards-Version: 3.7.2
XS-Vcs-bzr: http://bazaar.launchpad.net/~siretart/boxbackup/boxbackup.debian
XS-Vcs-Browser: http://codebrowse.launchpad.net/~siretart/boxbackup/boxbackup.debian/files

Package: boxbackup-server
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, adduser, perl, gawk, ucf, openssl, debconf | debconf-2.0
Recommends: boxbackup-utils
Description: server for the BoxBackup remote backup system
 BoxBackup is an automatic on-line backup system.
 The server waits for connections from remote clients,
 authenticates them via X.509 certificates and stores the
 encrypted data on hard drives with optionnal RAID techniques.
 It also supports versions historization and per-user quotas.

Package: boxbackup-client
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, ucf, perl, openssl, debconf | debconf-2.0
Description: client for the BoxBackup remote backup system
 BoxBackup is an automatic on-line backup system.
 The client is watching for changes on the local filesystem,
 connects to a BoxBackup server and send the changes via a
 secure channel. All data is encrypted before being sent to
 the server. A command-line tool is provided for restoration
 of backups including deleted files and old versions.

Attachment: signature.asc
Description: Digital signature


Reply to: