Ok then, let's see (:
On Sun, Aug 16, 2009 at 09:41:22AM +0200, Christian Perrier wrote:
> --- vpb-driver.old/debian/libvpb0.templates 2009-07-24 12:56:52.658486944
> +0200
> +++ vpb-driver/debian/libvpb0.templates 2009-08-16 09:41:08.126613874
> +0200
> @@ -6,5 +15,9 @@
> # phone in the region you are translating for, without any "long distance
> call"
> # prefix numbers that are specific to the telephone exchange being called
> from.
> _Default: 61
> -_Description: Enter your ITU-T telephone code (eg. 61 for Australia, 33 for
> France):
> - Configure locale specific options for Voicetronix hardware.
> +_Description: ITU-T telephone code:
> + To configure the Voicetronix telephony hardware driver, please enter the
> + prefix a caller would dial to make an international call to your region
> + (without any "long distance call" prefix numbers specific to the exchange
> + being called from). For instance, the code is 1 for North America, 61 for
> + Australia, or 33 for France.
This hunk was the main one I still wasn't terribly happy with ...
We added a lot of words about phone prefixes, but sort of blurred the
main keys to answering it correctly.
a) Do I have VT hardware? no: doesn't matter what you answer, nothing
will use it anyway.
b) Which of all of these numbers I have, is the one that I put in here?
The only people who really need to answer that are people who do already
have this hardware, and who should be expecting it. We just need to give
them their cue when to type it in.
As a small aside, 'code 1' probably isn't a really good example here.
I know there are lots of people, in lots of regions, all under code 1,
but lots of other phone things start with 1 prefix too, so it's a bit
too ambiguous for an example people can match against.
Anyhow here's my next shot at it then:
Template: libvpb0/countrycode
Type: string
# Translators, you can find a list of the ITU-T codes here:
# http://en.wikipedia.org/wiki/List_of_country_calling_codes
# This is the prefix someone would dial to make an international call to a
# phone in the region you are translating for, without any "long distance call"
# prefix numbers that are specific to the telephone exchange being called from.
# Feel free to alter the examples given to other regions if appropriate, but do
# try to pick regions with numeric codes that are not easily confused with some
# other numeric series than the ITU-T codes.
_Default: 61
_Description: ITU-T telephone code:
This is the numeric code for the region your phone system will be operating in
(eg. 61 for Australia or 33 for France). It is used to configure the default
regional standards that Voicetronix telephony hardware should comply with.
Which still seems a bit priority inverted and wordier than it needs to be
to me, but it covers the essential points I think ...
> --- vpb-driver.old/debian/control 2009-07-24 12:56:52.650487253 +0200
> +++ vpb-driver/debian/control 2009-08-14 08:55:15.527594269 +0200
> -Description: Source for the Voicetronix telephony hardware drivers
> +Description: Voicetronix telephony hardware driver source code
I dropped 'code' off the end of the short description, it should be
obvious, and is repeated in the next breath anyhow. But otherwise
I ack this one.
> - This package provides the user space support utilities for Voicetronix
> + This package provides the userspace support utilities for Voicetronix
Applied these two as well.
> -Description: Voicetronix telephony interface library documentation
> +Description: Voicetronix telephony hardware interface library documentation
This one I've stayed with the original. It makes the phrasing consistent
with other packages, but 'hardware' isn't _only_ thing documented there,
so adding it makes the description a slightly misleading tongue twister
to my ear.
Full text below. If anyone sees anything else they want to tweak before
this ball gets rolling again, then do please poke me about that soon.
We can still change it after I upload, but... the sooner the better,
and all that ... /o\
Thanks!
Ron
Source: vpb-driver
Section: comm
Priority: optional
Build-Depends: debhelper (>= 5.0.24), po-debconf, bzip2, zlib1g-dev, libpci-dev
| pciutils-dev
Build-Depends-Indep: doxygen, graphviz
Standards-Version: 3.8.3.0
Package: vpb-driver-source
Section: kernel
Architecture: all
Depends: module-assistant, debhelper (>>4.0.0), make, bzip2
Description: Voicetronix telephony hardware driver source
This package provides the source code for the Voicetronix kernel modules.
Kernel source or headers are required to compile these modules.
.
To build a binary module package to suit your running kernel, do:
m-a a-i vpb-driver
Package: vpb-utils
Section: comm
Architecture: any
Depends: ${shlibs:Depends}
Description: Voicetronix telephony hardware userspace tools
This package provides the userspace support utilities for Voicetronix
telephony hardware.
Package: libvpb0
Section: libs
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Recommends: vpb-driver-source
Suggests: vpb-utils
Description: Voicetronix telephony hardware userspace interface library
This package provides the userspace support library for Voicetronix telephony
hardware.
Package: libvpb-dev
Section: libdevel
Architecture: any
Depends: libvpb0 (= ${binary:Version})
Description: Voicetronix telephony hardware userspace library development files
This package provides the necessary headers and library support files for
building applications that use libvpb.
Package: libvpb-doc
Section: doc
Architecture: all
Suggests: vpb-driver-source, libvpb-dev
Description: Voicetronix telephony interface library documentation
This package provides the developer documentation for the Voicetronix
telephony library.
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
