Re: RFH: Rewrite of the backup-manager's templates for DTSG compliance
Quoting Christian Perrier (bubulle@debian.org):
>
> > You'll find attached to this mail the backup-manager.templates file
> > which needs your attention.
> >
> > Please Cc me because I'm not subscribed to this list.
>
> Attached an unfinished version (I'll try to finish later). But after
I finally managed to complete the rewrite. As you may see, I tried to
simpligy the wording in many places. IMHO, you don't need to explain
each and every detail. The style is more or less what I personnally
consider the most appropriate style for debconf templates wording :
-as neutral as possible
-use active voice most of the time
-avoid repeating the short description in the long description
-no questions except for boolean templates
-no first person sentences
-"opened prompts" for all user input except boolean (meaning a final
colon)
-no ending dot on note templates (and no exclamation mark...this is
not neutral wording)
Of course, I bet there are my usual English mistakes, so other
contributors will probably correct them..:-)
Template: backup-manager/backup-repository
Type: string
Default: /var/archives
_Description: Archives location:
Please enter the name of the directory where backup-manager will
store the generated archives.
.
The size of archives may be rather important so you should store them
on a disk with enough available space.
Template: backup-manager/filetype
Type: select
Choices: tar, tar.gz, tar.bz2, zip
Default: tar.gz
_Description: Archives storage format:
Template: backup-manager/dump_symlinks
Type: boolean
Default: false
_Description: Do you want to dereference symlinks?
The tar, tar.gz and tar.bz2 filetypes may dereference the symlinks in
generated archives. Doing so is likely to generate huge archives.
Template: backup-manager/blacklist
Type: string
Default: /var/archives
_Description: Directories to skip in archives:
Please enter a space-separated list of directories which should not be
archived.
Template: backup-manager/name-format
Type: select
_Choices: long, short
Default: long
_Description: Archives name format:
Files generated by backup-manager may use different file naming
conventions.
.
The long format is "host-full-path-to-directory.ext" while the short
format only uses the last directory name. For instance, /home/me
would be named me.tar.gz.
Template: backup-manager/time-to-live
Type: string
Default: 5
_Description: Age of kept archives (days):
Please choose the number of days backup-manager will keep the files
before purging them. Combining several directories and a large number of
days for keeping them may lead to huge archives.
Template: backup-manager/directories
Type: string
Default: /etc /home
_Description: Directories to backup:
Please enter a space-separated list of all the directories you want
to backup.
.
You should rather to enter several subdirectories instead of the
parent in order to have more pertinent files in your backup repository.
.
For instance, "/home/user1 /home/user2 /home/user3" is more appropriate
than "/home" alone.
Template: backup-manager/burning-enabled
Type: boolean
Default: false
_Description: Do you want to enable automatic burning?
Backup-manager can burn archives when it is launched.
.
Be aware that choosing this option will cause backup-manager to try
burning daily archives on the selected media, which must be present
at that time.
Template: backup-manager/burning-media
Type: select
Choices: cdrom, dvd
Default: cdrom
_Description: Burning media:
Choosing "cdrom" will require the cdrecord program while "dvd" needs
growisofs.
Template: backup-manager/burning-device
Type: string
Default: /dev/cdrom
_Description: Device to use for burning data:
Template: backup-manager/burning-maxsize
Type: string
Default: 650
_Description: Maximum size of your media (Mb):
Template: backup-manager/burning-method
Type: select
Choices: CDRW, CDR
Default: CDRW
_Description: Burning method:
When burning data, backup-manager will try to burn the whole archives
repository. If it does not fit in the media, it will try to burn only the
daily generated archives.
.
The CDRW method will first blank the media and then burn the data.
.
The CDR method will only burn the data, assuming that the media is empty.
Template: backup-manager/want_to_upload
Type: boolean
Default: false
_Description: Do you want to enable the backup-manager's uploading system ?
You can choose to upload archives to a remote host (either by ftp or scp).
Template: backup-manager/transfert_mode
Type: select
Choices: scp, ftp
Default: scp
_Description: Transfer mode for uploads:
Please choose the way files will be uploaded to the remote host.
.
If you choose the ftp mode, you'll be prompted for a password, whereas scp
will use key authentification (see man ssh-keygen for details on scp
transfer).
Template: backup-manager/upload-hosts
Type: string
_Description: Upload hosts:
Please enter a list of hosts where backup-manager will send the
generated archives each day.
Template: backup-manager/upload-user-scp
Type: string
Default: bman
_Description: Login for scp uploads:
To enable scp transfer, you have to set up a user which exists on both
remote and local hosts. This is needed for key authentification.
.
A SSH key should be created locally for this user and its public part
must be placed in the remote user's "authorized_keys" file
(see ssh-keygen(1) for details).
Template: backup-manager/upload-user-scp-warning
Type: note
_Description: Invalid user
The username you entered does not exist locally. Note that
the username you choose for scp transfer must exist on both local and
remote hosts.
.
You will not be prompted again for a username. Please use
"dpkg-reconfigure backup-manager" later to configure this feature.
Template: backup-manager/upload-user-ftp
Type: string
_Description: FTP username:
Please enter the username for FTP transfers to the remote hosts.
Template: backup-manager/upload-key
Type: string
_Description: Private key file to use for SSH authentification:
Please enter a SSH private key to use for the scp transfers.
Template: backup-manager/upload-passwd
Type: password
_Description: FTP password:
Please enter the password for FTP transfers to the remote hosts.
Template: backup-manager/upload-dir
Type: string
Default: /backup/upload
_Description: Remote host repository:
Please enter the name of the directory where the files will be
stored on the remote host.
Template: backup-manager/cron_frequency
Type: select
__Choices: hourly, daily, weekly, monthly
Default: daily
_Description: Backup frequency:
Please choose the frequency for backups run by backup-manager.
Reply to: