Please find, for review, the debconf templates of wvdial.
This review will last from Saturday, January 15, 2011 to Tuesday,
January 25, 2011.
Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.
Your review should be sent as an answer to this mail.
When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.
When we reach a consensus, I will send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.
Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.
Rationale:
--- ../wvdial.old/debian/wvdial.templates 2011-01-12 16:35:45.000000000 +0000
+++ debian/wvdial.templates 2011-01-15 23:28:53.000000000 +0000
@@ -1,8 +1,8 @@
Template: wvdial/wvdialconf
Type: boolean
Default: true
-_Description: Automatically detect and configure your modem?
- WvDial can automatically detect your modem and create its configuration
+_Description: Automatically detect and configure the modem?
+ WvDial can automatically detect the modem and create its configuration
file. This detection may cause problems with some computers.
.
You may reconfigure WvDial by running a program called wvdialconf which
In common with other reviews, we don't talk about "your" modem, because it
might not belong to the user answering these questions. Instead, we just
say "the modem".
@@ -10,27 +10,27 @@
Template: wvdial/phone
Type: string
-_Description: Internet service provider's telephone number:
- Please provide the telephone number that your Internet service provider
- (ISP) has given to you.
+_Description: ISP's telephone number:
+ Please enter the telephone number that should be used to call the Internet
+ Service Provider (ISP).
Make the short description more concise, because the contraction is already
expanded in the long description. As before, remove references to "your"
ISP (after all, not many people using wvdial also own an ISP :)
Maintainer, there is no clue about precisely what the user should enter
(for example, an area code). Can you clarify this?
Similarly for subsequent questions:
Template: wvdial/login
Type: string
-_Description: User name:
- Please provide the user name or login for your account with your ISP.
+_Description: Account username:
+ Please enter the username or login for an account issued by the ISP.
Template: wvdial/passphrase
Type: password
-_Description: Passphrase:
- Please provide the password or passphrase that unlocks access to your
- account.
+_Description: Account passphrase:
+ Please enter the password or passphrase that corresponds with the account
+ username.
Template: wvdial/passphrase2
Type: password
-_Description: Again:
- Retype the password or passphrase for verification.
+_Description: Confirm passphrase:
+ Please enter the password or passphrase again for verification.
Template: wvdial/passphrases_mismatch
Type: error
-_Description: Passphrases must match
- The two passphrases that you entered do not match. Please retype them.
+_Description: Passphrase mismatch
+ The passphrase and its confirmation do not match.
For some measure of standardisation, I stole these two descriptions from
the dbconfig-common package, except to standardise on "passphrase" because
that's how it is used in earlier questions.
--- ../wvdial.old/debian/control 2011-01-12 16:35:45.000000000 +0000
+++ debian/control 2011-01-15 22:32:46.000000000 +0000
@@ -9,13 +9,13 @@
Package: wvdial
Architecture: any
Depends: ppp (>= 2.3.0), debconf (>= 0.5.00) | cdebconf, ${shlibs:Depends}, ${misc:Depends}
-Description: PPP dialer with built-in intelligence
+Description: intelligent point-to-point protocol (PPP) dialer
move the emphasis to the "intelligent" part, because that's what sets
wvdial apart from chat, and expand the initialism
WvDial sacrifices some of the flexibility of programs like "chat" in order
- to make your dialup configuration easier. When you install this package,
- your modem will be detected automatically and you need to specify just
- three parameters: the phone number, username, and password. WvDial knows
+ to make dialup configuration easier. With WvDial,
+ the modem is detected automatically and only three additional parameters
+ are required: the telephone number, username, and password. WvDial knows
enough to dial with most modems and log in to most servers without any
other help.
Again, the person installing the package may not be the user of it, and
vice-versa. So we remove this, and make the sentences passive
.
- In particular, you no longer need a "chat script" to handle the most common
+ In particular, a "chat script" is not required to handle the most common
situations.
Likewise.
--
Jonathan Wiltshire jmw@debian.org
Debian Developer http://people.debian.org/~jmw
4096R: 0xD3524C51 / 0A55 B7C5 1223 3942 86EC 74C3 5394 479D D352 4C51
Template: wvdial/wvdialconf Type: boolean Default: true _Description: Automatically detect and configure the modem? WvDial can automatically detect the modem and create its configuration file. This detection may cause problems with some computers. . You may reconfigure WvDial by running a program called wvdialconf which will write these settings into the /etc/wvdial.conf file. Template: wvdial/phone Type: string _Description: ISP's telephone number: Please enter the telephone number that should be used to call the Internet Service Provider (ISP). Template: wvdial/login Type: string _Description: Account username: Please enter the username or login for an account issued by the ISP. Template: wvdial/passphrase Type: password _Description: Account passphrase: Please enter the password or passphrase that corresponds with the account username. Template: wvdial/passphrase2 Type: password _Description: Confirm passphrase: Please enter the password or passphrase again for verification. Template: wvdial/passphrases_mismatch Type: error _Description: Passphrase mismatch The passphrase and its confirmation do not match.
--- ../wvdial.old/debian/wvdial.templates 2011-01-12 16:35:45.000000000 +0000
+++ debian/wvdial.templates 2011-01-15 23:28:53.000000000 +0000
@@ -1,8 +1,8 @@
Template: wvdial/wvdialconf
Type: boolean
Default: true
-_Description: Automatically detect and configure your modem?
- WvDial can automatically detect your modem and create its configuration
+_Description: Automatically detect and configure the modem?
+ WvDial can automatically detect the modem and create its configuration
file. This detection may cause problems with some computers.
.
You may reconfigure WvDial by running a program called wvdialconf which
@@ -10,27 +10,27 @@
Template: wvdial/phone
Type: string
-_Description: Internet service provider's telephone number:
- Please provide the telephone number that your Internet service provider
- (ISP) has given to you.
+_Description: ISP's telephone number:
+ Please enter the telephone number that should be used to call the Internet
+ Service Provider (ISP).
Template: wvdial/login
Type: string
-_Description: User name:
- Please provide the user name or login for your account with your ISP.
+_Description: Account username:
+ Please enter the username or login for an account issued by the ISP.
Template: wvdial/passphrase
Type: password
-_Description: Passphrase:
- Please provide the password or passphrase that unlocks access to your
- account.
+_Description: Account passphrase:
+ Please enter the password or passphrase that corresponds with the account
+ username.
Template: wvdial/passphrase2
Type: password
-_Description: Again:
- Retype the password or passphrase for verification.
+_Description: Confirm passphrase:
+ Please enter the password or passphrase again for verification.
Template: wvdial/passphrases_mismatch
Type: error
-_Description: Passphrases must match
- The two passphrases that you entered do not match. Please retype them.
+_Description: Passphrase mismatch
+ The passphrase and its confirmation do not match.
--- ../wvdial.old/debian/control 2011-01-12 16:35:45.000000000 +0000
+++ debian/control 2011-01-15 22:32:46.000000000 +0000
@@ -9,13 +9,13 @@
Package: wvdial
Architecture: any
Depends: ppp (>= 2.3.0), debconf (>= 0.5.00) | cdebconf, ${shlibs:Depends}, ${misc:Depends}
-Description: PPP dialer with built-in intelligence
+Description: intelligent point-to-point (PPP) dialer
WvDial sacrifices some of the flexibility of programs like "chat" in order
- to make your dialup configuration easier. When you install this package,
- your modem will be detected automatically and you need to specify just
- three parameters: the phone number, username, and password. WvDial knows
+ to make dialup configuration easier. With WvDial,
+ the modem is detected automatically and only three additional parameters
+ are required: the telephone number, username, and password. WvDial knows
enough to dial with most modems and log in to most servers without any
other help.
.
- In particular, you no longer need a "chat script" to handle the most common
+ In particular, a "chat script" is not required to handle the most common
situations.
Source: wvdial
Section: comm
Priority: optional
Maintainer: Thierry Randrianiriana <thierry@debian.org>
Build-Depends: debhelper (>= 7), libwvstreams-dev (>= 4.4.1), pkg-config, po-debconf
Standards-Version: 3.9.1
Homepage: http://alumnit.ca/wiki/index.php?page=WvDial
Package: wvdial
Architecture: any
Depends: ppp (>= 2.3.0), debconf (>= 0.5.00) | cdebconf, ${shlibs:Depends}, ${misc:Depends}
Description: intelligent point-to-point (PPP) dialer
WvDial sacrifices some of the flexibility of programs like "chat" in order
to make dialup configuration easier. With WvDial,
the modem is detected automatically and only three additional parameters
are required: the telephone number, username, and password. WvDial knows
enough to dial with most modems and log in to most servers without any
other help.
.
In particular, a "chat script" is not required to handle the most common
situations.
Attachment:
signature.asc
Description: Digital signature