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

Bug#218343: yaboot-installer: Debconf templates polishing



Package: yaboot-installer
Severity: normal
Tags: patch d-i

The following proposed changes to debconf templates would make them more
compliant to the proposed "Debconf Templates Style Guide" recently proposed
for discussion.

Please see recently opened bugs for other boot loader installers.

Detailed explanations:
 Template: yaboot-installer/wrongmac
-Type: note
-_Description: No NewWorld PowerMac
+Type: error
+_Description: This machine is not a NewWorld PowerMac
  Yaboot can only be used on NewWorld PowerMac's. Please use the correct
- boot-loader for your ppc-architecture.
+ boot loader for your ppc-architecture.

1) as all error-type templates, I replaced the "note" type by the "error"
type which i shandled slightly differently by cdebconf

2) I found the short description quite uninformative. This is why I propose
something longer but probably more accurate

3) in other templates, hyphen are never used between "boot" and "loader"

 Template: yaboot-installer/noroot
-Type: note
+Type: error
 _Description: No root partition found
- No partition was found which is mounted as your new root partition.
+ No partition is mounted as your new root partition.
  You must mount a root partition first.

I propose a more simple sentence.


 Template: yaboot-installer/bootdev
 Type: select
 Choices: ${DEVICES}
 Default: invaliddevice
-_Description: On which device should yaboot be installed?
- Yaboot (the Linux bootloader) needs to be installed on a hard disk in
- order for your system to be bootable.  You must pick from the available
- hard disks which have "Apple_Bootstrap" partitions available.
+_Description: Device for boot loader installation:
+ Yaboot (the Linux boot loader) needs to be installed on a hard disk in
+ order for your system to be bootable.  Please choose the destination disk
+ among those which have "Apple_Bootstrap" partitions available.

Short description : make it consistent with other boot loaders

Long description : "boot loader" instead of "boot loader" for consistency.
The second sentence sounds better to me but a native English speaker could
probably correct it....


 Template: yaboot-installer/kconferr
-Type: note
-_Description: Failed to create kernel-image config
- Unable to create a new kernel image config file. Please check systemlog and/or
- the output on the third console (tty3).
+Type: error
+_Description: Failed to create kernel-image configuration
+ The creation of a new kernel image configuration file failed. 
+ .
+ Please check the system log or the output on the third console (tty3).

1) Type=error

2) Less terse style, see the "Debconf templates style guide"

3) I split in two paragraph just for having the repetitive sentence
separated. Will save work to translators

4) and/or....I really don't like this. It is obvious there that the "or" is
inclusive....

The same is repeated for further error templates with the same idea :
repeated sentences are separated into paragraphs for saving work to
translators..:-)

 Template: yaboot-installer/success
 Type: note
 _Description: Successfully installed yaboot
- Yaboot was successfully installed!
+ The yaboot boot loader was successfully installed.
+ .
  The system is now ready to boot the new Debian GNU/Linux system.

I prefer facts..:-). After all, as successful installation is normal, so no
need for yelling as if this was a miracle....


--- templates.ori	2003-10-30 07:51:17.000000000 +0100
+++ templates	2003-10-30 18:33:31.000000000 +0100
@@ -1,61 +1,68 @@
 Template: yaboot-installer/wrongmac
-Type: note
-_Description: No NewWorld PowerMac
+Type: error
+_Description: This machine is not a NewWorld PowerMac
  Yaboot can only be used on NewWorld PowerMac's. Please use the correct
- boot-loader for your ppc-architecture.
+ boot loader for your ppc-architecture.
 
 Template: yaboot-installer/nopart
-Type: note
+Type: error
 _Description: No bootstrap partition found
  No hard disks were found which have an "Apple_Bootstrap" partition. 
  You must create an 800k partition named "bootstrap", with type
  "Apple_Bootstrap".
 
 Template: yaboot-installer/noroot
-Type: note
+Type: error
 _Description: No root partition found
- No partition was found which is mounted as your new root partition.
+ No partition is mounted as your new root partition.
  You must mount a root partition first.
 
 Template: yaboot-installer/bootdev
 Type: select
 Choices: ${DEVICES}
 Default: invaliddevice
-_Description: On which device should yaboot be installed?
- Yaboot (the Linux bootloader) needs to be installed on a hard disk in
- order for your system to be bootable.  You must pick from the available
- hard disks which have "Apple_Bootstrap" partitions available.
+_Description: Device for boot loader installation:
+ Yaboot (the Linux boot loader) needs to be installed on a hard disk in
+ order for your system to be bootable.  Please choose the destination disk
+ among those which have "Apple_Bootstrap" partitions available.
 
 Template: yaboot-installer/kconferr
-Type: note
-_Description: Failed to create kernel-image config
- Unable to create a new kernel image config file. Please check systemlog and/or
- the output on the third console (tty3).
+Type: error
+_Description: Failed to create kernel-image configuration
+ The creation of a new kernel image configuration file failed. 
+ .
+ Please check the system log or the output on the third console (tty3).
 
 Template: yaboot-installer/conferr
-Type: note
-_Description: Failed to create yaboot config
- Unable to create the main yaboot config file. Please check systemlog and/or
- the output on the third console (tty3).
+Type: error
+_Description: Failed to create yaboot configuration
+ The creation of the main yaboot configuration file failed. 
+ .
+ Please check the systemlog or the output on the third console (tty3).
+ .
  Warning: Your system may be unbootable!
 
 Template: yaboot-installer/ybinerr
 Type: note
 _Description: Failed to install bootloader
- Unable to install the yaboot bootloader. Please check systemlog and/or
- the output on the third console (tty3).
+ The installation of the yaboot boot loader failed.
+ .
+ Please check the system log or the output on the third console (tty3).
+ .
  Warning: Your system may be unbootable!
 
 Template: yaboot-installer/success
 Type: note
 _Description: Successfully installed yaboot
- Yaboot was successfully installed!
+ The yaboot boot loader was successfully installed.
+ .
  The system is now ready to boot the new Debian GNU/Linux system.
 
 Template: yaboot-installer/mounterr
-Type: note
+Type: error
 _Description: Failed to mount /target/proc
- Unable to mount proc filesystem on /target/proc.
- Please check systemlog and/or
- the output on the third console (tty3).
+ Mounting the proc filesystem on /target/proc failed.
+ .
+ Please check the system log or the output on the third console (tty3).
+ .
  Warning: Your system will maybe be unbootable!

Reply to: