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

Bug#219231: cdrom-checker: Debconf templates polishing



Package: cdrom-checker
Severity: normal
Tags: patch

Usual polishing bug report. Usual general rationale : get consistency among
d-i modules and follow my own "Debconf Templates Style Guide" document (next
revision soon to come).

Sorry, I suggest lot of changes....Translators will suffer...:-(

 Template: cdrom-detect/manual_config
 Type: boolean
 Default: true
-_Description: Do you want to manually select the CDROM module and device ?
- No common CDROM reader was detected. But you may have an old Mitsumi or
- another non-IDE, non-SCSI CDROM reader. In that case you can indicate
+_Description: Manually select the CD-ROM module and device?
+ No common CD-ROM reader was detected. You may however own an old Mitsumi or
+ another non-IDE, non-SCSI CD-ROM reader. In that case you may choose
  which module to load and which device to use. If you don't know what
- module and device are needed, look for some documentation or try a net
- install instead of a CDROM install.
+ module and device are needed, look for some documentation or try a network
+ installation instead of a CD-ROM installation.

1) shorten short desc
2) s/CDROM/CD-ROM for consistency with cdrom-checker
3) "But you may have" sound a bit trivial to my ears. I'm pissing off my
french tsl fellow colleagues for avoiding "I have this or that" for talking
about stuff we *own*
4) s/install/installation : we have room, this is an extended description..:-)


 Template: cdrom-detect/is_cd_inserted
 Type: boolean
 Default: false
-_Description: Perform manual CD configuration ?
- Your installation CD couldn't be mounted. That probably means that the CD
- is not yet inserted. If that's the case, just insert it and don't perform
- the manual configuration; the CD mount will be re-tried. If your CD was
- already in the drive, there was another problem; try the manual CD
- configuration.
+_Description: Perform manual CD-ROM configuration?
+ Your installation CD-ROM couldn't be mounted. 
+ .
+ That probably means that the CD-ROM is not yet inserted. If that's the case,
+ just insert it and don't perform the manual configuration. The CD-ROM mount
+ will be re-tried. 
+ .
+ If your CD-ROM was already in the drive, some other problem happened. You
+ should then try the manual CD-ROM configuration.
 
1) No space before question mark (in English) 
2) Cut in paragraphs for improving readability.
3) Some rewording. Natives (english speakers...), please check

 Template: cdrom-detect/cdrom_module
 Type: select
 Choices: ${choices}
 Default: none
-_Description: Select a module to load for the CDROM support
- Apparently the autodetection didn't find any CDROM reader. You can try to
- load one of the modules if you have a specific CDROM reader (that is
+_Description: Module needed for accessing the CD-ROM:
+ Apparently the autodetection didn't find any CD-ROM reader. You can try to
+ load a specific module if you have a specific CD-ROM reader (that is
  neither IDE nor SCSI).

Well, apart from s/CDROM/CD-ROM, some minor rewording. Dunno if it's better

 Template: cdrom-detect/cdrom_device
 Type: string
 Default: /dev/cdrom
-_Description: Give the corresponding device file
- In order to get access to your CDROM reader, I must know which device file
- should be used since non-standard CDROM readers use non-standard device
- files (like /dev/mcdx for example).
+_Description: Device file for accessing the CD-ROM:
+ In order to get access to your CD-ROM reader, please enter which device file
+ should be used. Non-standard CD-ROM readers use non-standard device
+ files (such as /dev/mcdx).
  .
  You may switch to the shell on the second terminal (ALT+F2) to check the
- available devices in /dev with "ls /dev". You can come back here with
- ALT+F1.
+ available devices in /dev with "ls /dev". You can come back to this screen
+ with ALT+F1.

1) Prompting for input, so adapted short desc
2) Thou shall repeat : the computer is not a person, so (s)he must know
nothing..:-)
3) Cosmetic

 Template: cdrom-detect/success
 Type: note
-_Description: A CDROM has been detected.
- CD autodetection worked. A CDROM reader has been found with the following
- CD inserted : ${cdname} You can continue the install.
+_Description: CD-ROM detected
+ The CD-ROM autodetection was successful. A CD-ROM reader has been found. It
+ currently contains this CD: ${cdname}. The installation process may continue.
 
 Template: cdrom-detect/no-cd
 Type: error
-_Description: No CD was detected
- Please make sure that there is a CD in the CDROM reader.
+_Description: No CD detected
+ Please check that a CD has been inserted in the CD-ROM reader.

1) Error template : short desc is a title
2) Reformulation : is this better?

 Template: cdrom-detect/wrong-cd
 Type: error
@@ -58,23 +61,23 @@
 Template: cdrom-detect/skip_autodetection
 Type: boolean
 Default: false
-_Description: Do you want to skip CDROM autodetection ?
- You may want to try this if autodetection is causing trouble. Otherwise
- you really shouldn't; manual intervention will be required to mount the
- CDROM on /cdrom before you can proceed.
+_Description: Skip CD-ROM autodetection ?
+ You should skip the CD-ROM automatic detection only if it is causing trouble.
+ If you skip it, a manual intervention will be required to mount the
+ CD-ROM on /cdrom before you can proceed.
 
1) Shorten the short desc (helping translators)
2) The rephrased ext desc looks better to me : more factual about what
happens and consequences of actions
 
 Template: mirror/distribution
 Type: select
 _Choices: woody, sarge, sid
 Default: sarge
-_Description: Select distribution to install
- Please select which of the distributions you want to install.
+_Description: Distribution branch to install
+ Please select which of the Debian distribution branches you want to install:
  .
-  woody is the current stable release of Debian
-  sarge is the "testing" unreleased version of Debian
-  sid is "unstable" and will never be released.
+  - woody is the current stable release of Debian;
+  - sarge is the "testing" unreleased version of Debian;
+  - sid is "unstable" and will never be released.

I left the translatable "Choices" field, but is this needed. I think that no
translators will change the distribution names.

I introduced the concept of "distribution branch". Rationale : mostly for
newbies. WHen installating Debian, they already install a Linux
"distribution". So, for them, the "distribution to install".....is Debian..:-)

I added common enumeration typography. English typography specialists,
please confirm that this is indeed correct.

 Template: debian-installer/cdrom-detect/title
 Type: text
 #  Item in the main menu to select this package
-_Description: Detect CDROM devices and mount the CD in /cdrom
+_Description: Detect and mount CD-ROM

THIS is debatable. The main idea is simplifying the entry :
-for improving readability
-for helping out translators (main menu entries are cut at 58
characters....at least for french, the above is nearly impossible to fully
translate in 58 chars....)

--- cdrom-detect.templates.ori	2003-11-04 23:01:36.000000000 +0100
+++ cdrom-detect.templates	2003-11-05 07:28:54.000000000 +0100
@@ -1,54 +1,57 @@
 Template: cdrom-detect/manual_config
 Type: boolean
 Default: true
-_Description: Do you want to manually select the CDROM module and device ?
- No common CDROM reader was detected. But you may have an old Mitsumi or
- another non-IDE, non-SCSI CDROM reader. In that case you can indicate
+_Description: Manually select the CD-ROM module and device?
+ No common CD-ROM reader was detected. You may however own an old Mitsumi or
+ another non-IDE, non-SCSI CD-ROM reader. In that case you may choose
  which module to load and which device to use. If you don't know what
- module and device are needed, look for some documentation or try a net
- install instead of a CDROM install.
+ module and device are needed, look for some documentation or try a network
+ installation instead of a CD-ROM installation.
 
 Template: cdrom-detect/is_cd_inserted
 Type: boolean
 Default: false
-_Description: Perform manual CD configuration ?
- Your installation CD couldn't be mounted. That probably means that the CD
- is not yet inserted. If that's the case, just insert it and don't perform
- the manual configuration; the CD mount will be re-tried. If your CD was
- already in the drive, there was another problem; try the manual CD
- configuration.
+_Description: Perform manual CD-ROM configuration?
+ Your installation CD-ROM couldn't be mounted. 
+ .
+ That probably means that the CD-ROM is not yet inserted. If that's the case,
+ just insert it and don't perform the manual configuration. The CD-ROM mount
+ will be re-tried. 
+ .
+ If your CD-ROM was already in the drive, some other problem happened. You
+ should then try the manual CD-ROM configuration.
 
 Template: cdrom-detect/cdrom_module
 Type: select
 Choices: ${choices}
 Default: none
-_Description: Select a module to load for the CDROM support
- Apparently the autodetection didn't find any CDROM reader. You can try to
- load one of the modules if you have a specific CDROM reader (that is
+_Description: Module needed for accessing the CD-ROM:
+ Apparently the autodetection didn't find any CD-ROM reader. You can try to
+ load a specific module if you have a specific CD-ROM reader (that is
  neither IDE nor SCSI).
 
 Template: cdrom-detect/cdrom_device
 Type: string
 Default: /dev/cdrom
-_Description: Give the corresponding device file
- In order to get access to your CDROM reader, I must know which device file
- should be used since non-standard CDROM readers use non-standard device
- files (like /dev/mcdx for example).
+_Description: Device file for accessing the CD-ROM:
+ In order to get access to your CD-ROM reader, please enter which device file
+ should be used. Non-standard CD-ROM readers use non-standard device
+ files (such as /dev/mcdx).
  .
  You may switch to the shell on the second terminal (ALT+F2) to check the
- available devices in /dev with "ls /dev". You can come back here with
- ALT+F1.
+ available devices in /dev with "ls /dev". You can come back to this screen
+ with ALT+F1.
 
 Template: cdrom-detect/success
 Type: note
-_Description: A CDROM has been detected.
- CD autodetection worked. A CDROM reader has been found with the following
- CD inserted : ${cdname} You can continue the install.
+_Description: CD-ROM detected
+ The CD-ROM autodetection was successful. A CD-ROM reader has been found. It
+ currently contains this CD: ${cdname}. The installation process may continue.
 
 Template: cdrom-detect/no-cd
 Type: error
-_Description: No CD was detected
- Please make sure that there is a CD in the CDROM reader.
+_Description: No CD detected
+ Please check that a CD has been inserted in the CD-ROM reader.
 
 Template: cdrom-detect/wrong-cd
 Type: error
@@ -58,23 +61,23 @@
 Template: cdrom-detect/skip_autodetection
 Type: boolean
 Default: false
-_Description: Do you want to skip CDROM autodetection ?
- You may want to try this if autodetection is causing trouble. Otherwise
- you really shouldn't; manual intervention will be required to mount the
- CDROM on /cdrom before you can proceed.
+_Description: Skip CD-ROM autodetection ?
+ You should skip the CD-ROM automatic detection only if it is causing trouble.
+ If you skip it, a manual intervention will be required to mount the
+ CD-ROM on /cdrom before you can proceed.
 
 Template: mirror/distribution
 Type: select
 _Choices: woody, sarge, sid
 Default: sarge
-_Description: Select distribution to install
- Please select which of the distributions you want to install.
+_Description: Distribution branch to install
+ Please select which of the Debian distribution branches you want to install:
  .
-  woody is the current stable release of Debian
-  sarge is the "testing" unreleased version of Debian
-  sid is "unstable" and will never be released.
+  - woody is the current stable release of Debian;
+  - sarge is the "testing" unreleased version of Debian;
+  - sid is "unstable" and will never be released.
 
 Template: debian-installer/cdrom-detect/title
 Type: text
 #  Item in the main menu to select this package
-_Description: Detect CDROM devices and mount the CD in /cdrom
+_Description: Detect and mount CD-ROM

Reply to: