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

Bug#219189: cdrom-checker: Debconf templates polishing



Package: cdrom-checker
Severity: normal
Tags: patch

As usual, please consider all modifications as suggestions....this is part
of the general work on debconf templates "polishing" operation.

Rationale (native English speakers, PLEASE read and correct if needed):

 Template: cdrom-checker/start
 Type: boolean
 Default: false
-_Description: CD-ROM integrity check
- Warning: this check depends on your hardware and may take some time. Are you
- sure that you want to continue?
+_Description: Check CD-ROM integrity?
+ Warning: this check depends on your hardware and may take some time.

Boolean template-->question on short description
Then avoid repeating the question in extended description. I see no real
need for insisting on "Are you sure"...

 Template: cdrom-checker/askmount
 Type: note
 _Description: Insert a Debian CD-ROM
- Please insert one of the official Debian CD-ROMs into the drive and press
- ENTER to continue.
+ Please insert one of the official Debian CD-ROMs into the drive 
+ before continuing.

No reference to specific user action (moreover, depending on keyboard
models, the "Enter" key is labeled as such ...or not).

 Template: cdrom-checker/mntfailed
-Type: note
+Type: error
 _Description: Failed to mount CD-ROM
  The CD-ROM ${CDROM} could not be mounted correctly. Please check the media
  and cables, and try it again.

Error-->template type=error

 Template: cdrom-checker/wrongcd
-Type: note
-_Description: No valid debian CD-ROM
- The CD-ROM you have inserted isn't a valid Debian CD-ROM. Please change the disk.
+Type: error
+_Description: No valid Debian CD-ROM
+ The CD-ROM you have inserted is not a valid Debian CD-ROM. 
+ Please change the disk.

Ditto.
Debian properly spelled
s/isn't/is not

 Template: cdrom-checker/md5file_failed
-Type: note
-_Description: Failed to open MD5 file
- Failed to open the MD5 file, which contains the checksums of the files
- located on the CD-ROM.
+Type: error
+_Description: Failed to open checksum file
+ Opening the MD5 file on the CD-ROM failed. This file contains the checksums
+ of the files located on the CD-ROM.

Error: ditto
Short description : less jargon
Extended description : make a real sentence (is it good English?)


 Template: cdrom-checker/passed
 Type: note
-_Description: Integrity test successful!
- The integrity for the CD-ROM was successful. The CD-ROM looks good!
+_Description: Integrity test successful
+ The integrity for the CD-ROM was successful. The CD-ROM looks correct.

Just facts. The check was successful, not need for yelling, this should be
normal after all..:-)

Looks good vs. looks correct : sounds better to me, but I may be wrong. I
want to avoid "trivial" language.

 Template: cdrom-checker/mismatch
-Type: note
-_Description: Integrity test failed!
- The following file has a md5sum mismatch: ${FILE}. Your CD-ROM or
+Type: error
+_Description: Integrity test failed
+ The ${FILE} file failed the MD5 checkum verification. Your CD-ROM or
  this file may be corrupt.

Error again
No yelling again, just facts..:)
The extended description is reworded. But I'm not sure about
"verification"....probably too french..:-)

"corrupt" or "corrupted"??


 Template: cdrom-checker/nextcd
 Type: boolean
 Default: false
-_Description: Test another CD-ROM
- Would you like to test another CD-ROM?
+_Description: Check another CD-ROM integrity?

We always "checked" the CD-ROM, so let's continue....Extended description is
just repeating the short one, so let's drop it.


 Template: cdrom-checker/firstcd
 Type: note
@@ -62,4 +61,4 @@
 Template: debian-installer/cdrom-checker/title
 Type: text
 #  Main menu item
-_Description: Verify the cd contents
+_Description: Check the CD-ROM(s) integrity


"Check" is used internally, so use it in the Main Menu entry also.
Same for "CD-ROM" and "integrity" (the latter may be dropped...)

I also suggest adding "(s)" as we allow for checking several CD's.

-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux mykerinos 2.4.22 #2 Mon Sep 29 15:12:10 CEST 2003 i686
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (ignored: LC_ALL set to fr_FR.UTF-8)

--- templates.ori	2003-11-04 22:48:39.000000000 +0100
+++ templates	2003-11-04 22:48:28.000000000 +0100
@@ -1,49 +1,48 @@
 Template: cdrom-checker/start
 Type: boolean
 Default: false
-_Description: CD-ROM integrity check
- Warning: this check depends on your hardware and may take some time. Are you
- sure that you want to continue?
+_Description: Check CD-ROM integrity?
+ Warning: this check depends on your hardware and may take some time.
 
 Template: cdrom-checker/askmount
 Type: note
 _Description: Insert a Debian CD-ROM
- Please insert one of the official Debian CD-ROMs into the drive and press
- ENTER to continue.
+ Please insert one of the official Debian CD-ROMs into the drive 
+ before continuing.
 
 Template: cdrom-checker/mntfailed
-Type: note
+Type: error
 _Description: Failed to mount CD-ROM
  The CD-ROM ${CDROM} could not be mounted correctly. Please check the media
  and cables, and try it again.
 
 Template: cdrom-checker/wrongcd
-Type: note
-_Description: No valid debian CD-ROM
- The CD-ROM you have inserted isn't a valid Debian CD-ROM. Please change the disk.
+Type: error
+_Description: No valid Debian CD-ROM
+ The CD-ROM you have inserted is not a valid Debian CD-ROM. 
+ Please change the disk.
 
 Template: cdrom-checker/md5file_failed
-Type: note
-_Description: Failed to open MD5 file
- Failed to open the MD5 file, which contains the checksums of the files
- located on the CD-ROM.
+Type: error
+_Description: Failed to open checksum file
+ Opening the MD5 file on the CD-ROM failed. This file contains the checksums
+ of the files located on the CD-ROM.
 
 Template: cdrom-checker/passed
 Type: note
-_Description: Integrity test successful!
- The integrity for the CD-ROM was successful. The CD-ROM looks good!
+_Description: Integrity test successful
+ The integrity for the CD-ROM was successful. The CD-ROM looks correct.
 
 Template: cdrom-checker/mismatch
-Type: note
-_Description: Integrity test failed!
- The following file has a md5sum mismatch: ${FILE}. Your CD-ROM or
+Type: error
+_Description: Integrity test failed
+ The ${FILE} file failed the MD5 checkum verification. Your CD-ROM or
  this file may be corrupt.
 
 Template: cdrom-checker/nextcd
 Type: boolean
 Default: false
-_Description: Test another CD-ROM
- Would you like to test another CD-ROM?
+_Description: Check another CD-ROM integrity?
 
 Template: cdrom-checker/firstcd
 Type: note
@@ -62,4 +61,4 @@
 Template: debian-installer/cdrom-checker/title
 Type: text
 #  Main menu item
-_Description: Verify the cd contents
+_Description: Check the CD-ROM(s) integrity

Reply to: