Bug#220180: cdrom-detect: Debconf templates polishing
On Tue, Nov 11, 2003 at 11:08:20AM +0100, Christian Perrier wrote:
> Package: cdrom-detect
> Severity: normal
> Tags: patch d-i
>
> Now usual debconf templates polishing bug report.
>
> Proofreading by native English speakers needed. Chris, I'm sure you're
> reading this..:)
>
> Detailed rationale:
>
> 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
> - 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.
> +_Description: Manually select the CD-ROM module and device?
> + No common CD-ROM reader was detected.
> + .
> + Your CD-ROM reader may be 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 network installation
> + instead of a CD-ROM installation.
>
> 1) Removed space before question mark. Shorten the question
> 2) Better readability by splitting in two paragraphs with the most important
> one at the top
> 3) s/CDROM/CD-ROM for general d-i consistency
> 4) Drop the "but you may have".....which seems too french to me..:-)
>
> English native speakers, please proofread this 2nd paragraph
:) Sounds too French for me.
No really, it's fine, and an improvement.
>
> 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.
If your CD-ROM was already in the drive, then your CD-ROM hardware did
not respond. Manual CD-ROM configuration may help.
('occurred' would be better than 'happened' above. But I think a
rewrite is even better.)
> 1) Removed space before QM
> 2) split into paragraphs for readability. Minor rewrite of the third one
>
> 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:
> + The automatic detection 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).
>
> 1) Short desc=prompt
> 2) Just give facts..:-)
>
> 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.
Non-standard CD-ROM readers use non-standard device files, for example
/dev/mcdx. Please enter the device file which is used to access your
CD-ROM reader.
(I think it reads better to switch these sentences around, and
rewrite the request. YMMV.)
> 1) Prompt
> 2) s/CDROM/CD-ROM
> 3) removed 1st person. English proofreading needed
>
> 4) s/here/to this screen
>
>
> 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.
>
> 1) Short desc==title
> 2) "worked" is a bit trivial, isn't it?
>
> Proofreading needed
Much improved.
> 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) Title so no phrase required...but is this correct?
Yes, your version is a title, the old one is a complete sentence.
> 2) Minor rephrase
>
> Template: cdrom-detect/wrong-cd
> Type: error
> -_Description: A CDROM has been detected, but it isn't a Debian CD
> +_Description: Non-Debian CD-ROM detected
> + A CDROM has been detected, but it isn't a Debian CD.
> + .
> Please make sure that the correct CD is inserted.
>
> 1) Title
> 2) Move the former short desc to extended description
>
> 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 automatic detection?
> + 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) Removed space and shorten question
> 2) rephrase....proofreading needed
I like it, much improved.
> 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.
>
> Consistency with the similar template in choose-mirror
This is the first time I've heard the term 'branch' associated
with distributions. Usually each is just termed a 'distribution'
which seems right to me; each distribution stands by itself.
So, I would remove 'branch' and 'branches', otherwise OK.
> 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
> +_Description: Detect and mount CD-ROM
>
> Shorter....This should be enough and easier to translate in 58 chars..:-)
>
> -- 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)
>
Sweet!
--
Debian GNU/Linux Operating System
By the People, For the People
Chris Tillman (a people instance)
toff one at cox dot net
Reply to: