Bug#219633: netcfg: Debconf templates polishing
On Fri, Nov 07, 2003 at 06:46:26PM +0100, Christian Perrier wrote:
> Package: netcfg
> Severity: normal
> Tags: patch d-i
[...]
> Template: netcfg/get_nameservers
> Type: string
> -_Description: Choose the DNS Server Addresses
> +_Description: Name servers addresses:
> Please enter the IP addresses (not host names) of up to 3 name servers,
> separated by spaces. Do not use commas. The servers will be queried in the
> - order in which you enter them. If you don't want to use any name servers
> + order you mentioned. If you don't want to use any name server,
> just leave this field blank.
I have to disagree with that one. I understand you, but the first
way is much clearer. Or how about:
The first server in the list will be the first to be queried.
> 1) -->prompt
> 2) looks better to me
>
> Template: netcfg/choose_interface
> Type: select
> Choices: ${ifchoices}
> -_Description: Choose an interface.
> - The following interfaces were detected. Choose the type of your primary
> - network interface that you will need for installing the Debian system (via
> - NFS or HTTP).
> +_Description: Interface:
> + Please choose the interface you want to configure. Below are shown
> + all currently detected interfaces on your system. Please choose the
Please choose the interface you want to configure. All currently
detected interfaces on your system are shown below. Please choose the
> + type of your primary network interface. This interface will be used
> + for installing the Debian system (via NFS or HTTP).
>
> 1) -->prompt
> 2) Reformulation for more clarity
[...]
> Template: netcfg/dhcp_hostname
> Type: string
> -_Description: What is your dhcp hostname?
> - You may need to supply a DHCP host name. If you are using
> - a cable modem, you might need to specify an account number
> - here. Most other users can just leave this blank.
> +_Description: DHCP hostname:
> + Supplying a DHCP host name is sometimes needed. If you are using
> + a cable modem, you might need to specify an account number here.
> + .
> + Most other users can just leave this blank.
>
> Again, short desc-->prompt
>
> I reformulate the extended description for improving readability and make it
> clearer that most people will leave the field blank.
I think splitting it up is an improvement. But the first sentence is
better in the original, because it is in active voice instead of passive.
>
> Template: netcfg/confirm_dhcp
> Type: boolean
> Default: true
> -_Description: Is this information correct?
> +_Description: Are these informations correct?
> + Currently configured network parameters:
> + .
> interface = ${interface}
> hostname = ${hostname}
> domain = ${domain}
>
> The original style looked very bad with the new cdebconf layout.
>
> Above is a proposal....this may be enhanced. The two added strings are
> identical with the similar ones in netcfg/confirm_static.
Information is plural; fact is the singular. Informations is not
really an English word. So the original is correct for the prompt.
>
> Template: netcfg/no_dhcp_client
> -Type: note
> -_Description: No dhcp client found. I cannot continue.
> - This package requires pump or dhcp-client.
> +Type: error
> +_Description: No DHCP client found
> + No DHCP client was found. This package requires pump or dhcp-client.
> + .
> + The DHCP configuration process will be aborted.
>
> That one also was somewhat incorrect:
>
> 1) s/note/error
> 2) make the short desc a real title
> 3) explain things in the extended desc (and forget about "I")
>
>
> Template: netcfg/dhcp-title
> Type: text
> @@ -36,4 +41,4 @@
> Template: debian-installer/netcfg-dhcp/title
> Type: text
> # Item in the main menu to select this package
> -_Description: Configure the network via DHCP
> +_Description: Configure the network using dynamic addressing (DHCP)
>
> Well, THIS IS A PROPOSAL. This may be more clear for newbies (maybe someday,
> Debian will at least be recommended to newbies by "Linux for dummies"-type
> books...:-))
>
> However, this won't make the translators work easy, maybe.
Well, I like it, FWIW.
[...]
> Template: netcfg/confirm_static
> Type: boolean
> Default: true
> -_Description: Is this configuration correct?
> +_Description: Are these informations correct?
> + Currently configured network parameters:
> + .
> interface = ${interface}
> hostname = ${hostname}
> domain = ${domain}
>
> See above for the similar template in DHCP configuration
Is this information correct? can be re-used.
--
Debian GNU/Linux Operating System
By the People, For the People
Chris Tillman (a people instance)
toff one at cox dot net
Reply to: