Re: [RFR] new and old gpsd template
Bernd Zeimetz wrote:
> please review the attached template file for gpsd! As I'm not on the
> list, please keep me on CC.
> The last question in the template is new, and I guess there a lot to fix
> ;) So before I send out requests to translate only one question of the
> template, I'd prefer to have the whole template reviewed and fixed.
Commented diff inline, patch and revised version attached. The main
recurring issue is the assumption that you (answering the questions)
necessarily own the hardware or make the policy decisions.
--- gpsd.templates.old 2008-03-03 20:05:07.000000000 +0000
+++ gpsd.templates.new 2008-03-03 20:16:45.000000000 +0000
@@ -1,18 +1,18 @@
Template: gpsd/device
Type: string
-_Description: Device your GPS receiver is attached to:
- Enter the device your GPS is attached to; this will probably be something
- like /dev/ttyS0 or /dev/ttyUSB0.
+_Description: Device the GPS receiver is attached to:
+ Enter the device the GPS receiver is attached to. This will probably be
+ something like /dev/ttyS0 or /dev/ttyUSB0.
.
- You can enter several devices, separated by spaces.
+ Multiple devices may be specified as a space-separated list.
(My change to the final line is just a suggestion.)
Template: gpsd/start_daemon
Type: boolean
Default: false
-_Description: Should gpsd start on boot?
- If your GPS receiver is permanently attached to your computer, you might
- want to start gpsd at boot time. Otherwise, you can run it by calling
- gpsd(8) at any time, or you can use the hotplug interface for USB devices.
+_Description: Start gpsd automatically on boot?
+ If the GPS receiver is permanently attached to this computer, it might be
+ appropriate for gpsd to start at boot time. Alternatively it can be started
+ by the hotplug interface for USB devices, or by running gpsd(8) manually.
More of the same; reshuffling the options seemed to make it flow
better. The change to the Description line is mostly to make it
match my shortened version of the gpsd/autodetection Description,
below.
Template: gpsd/daemon_options
Type: string
(I didn't have any suggestions for this one)
@@ -23,10 +23,8 @@
Template: gpsd/autodetection
Type: boolean
Default: false
-_Description: Should gpsd automatically start as soon as a GPS receiver is
- attached via USB?
- Please note that several GPS receivers use common serial <> USB converter
- chips. If you're using USB to serial converters to connect your computer
- to non-GPS devices, it is recommended to say no here, as gpsd may result
- in an undesired behaviour. Also gpsd may affect tools like gpsbabel if
- it is running at the same time.
+_Description: Start gpsd automatically on attaching a USB GPS receiver?
+ Please note that several GPS receivers use common USB-to-serial converter
+ chips. If this computer has non-GPS devices attached with USB-to-serial
+ converters, gpsd may misbehave or interfere with tools like gpsbabel, so
+ it is recommended to reject this option.
A Description badly in need of shortening!
The usual de-personalisation, plus avoidance of the obscure use of
an ASCII-art "to/from" and reorganisation of the last sentence
("situation, problem, recommendation").
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Template: gpsd/device
Type: string
_Description: Device the GPS receiver is attached to:
Enter the device the GPS receiver is attached to. This will probably be
something like /dev/ttyS0 or /dev/ttyUSB0.
.
Multiple devices may be specified as a space-separated list.
Template: gpsd/start_daemon
Type: boolean
Default: false
_Description: Start gpsd automatically on boot?
If the GPS receiver is permanently attached to this computer, it might be
appropriate for gpsd to start at boot time. Alternatively it can be started
by the hotplug interface for USB devices, or by running gpsd(8) manually.
Template: gpsd/daemon_options
Type: string
_Description: Options to gpsd:
You can give additional arguments when starting gpsd; see gpsd(8) for a
list of options.
Template: gpsd/autodetection
Type: boolean
Default: false
_Description: Start gpsd automatically on attaching a USB GPS receiver?
Please note that several GPS receivers use common USB-to-serial converter
chips. If this computer has non-GPS devices attached with USB-to-serial
converters, gpsd may misbehave or interfere with tools like gpsbabel, so
it is recommended to reject this option.
--- gpsd.templates.old 2008-03-03 20:05:07.000000000 +0000
+++ gpsd.templates.new 2008-03-03 20:16:45.000000000 +0000
@@ -1,18 +1,18 @@
Template: gpsd/device
Type: string
-_Description: Device your GPS receiver is attached to:
- Enter the device your GPS is attached to; this will probably be something
- like /dev/ttyS0 or /dev/ttyUSB0.
+_Description: Device the GPS receiver is attached to:
+ Enter the device the GPS receiver is attached to. This will probably be
+ something like /dev/ttyS0 or /dev/ttyUSB0.
.
- You can enter several devices, separated by spaces.
+ Multiple devices may be specified as a space-separated list.
Template: gpsd/start_daemon
Type: boolean
Default: false
-_Description: Should gpsd start on boot?
- If your GPS receiver is permanently attached to your computer, you might
- want to start gpsd at boot time. Otherwise, you can run it by calling
- gpsd(8) at any time, or you can use the hotplug interface for USB devices.
+_Description: Start gpsd automatically on boot?
+ If the GPS receiver is permanently attached to this computer, it might be
+ appropriate for gpsd to start at boot time. Alternatively it can be started
+ by the hotplug interface for USB devices, or by running gpsd(8) manually.
Template: gpsd/daemon_options
Type: string
@@ -23,10 +23,8 @@
Template: gpsd/autodetection
Type: boolean
Default: false
-_Description: Should gpsd automatically start as soon as a GPS receiver is
- attached via USB?
- Please note that several GPS receivers use common serial <> USB converter
- chips. If you're using USB to serial converters to connect your computer
- to non-GPS devices, it is recommended to say no here, as gpsd may result
- in an undesired behaviour. Also gpsd may affect tools like gpsbabel if
- it is running at the same time.
+_Description: Start gpsd automatically on attaching a USB GPS receiver?
+ Please note that several GPS receivers use common USB-to-serial converter
+ chips. If this computer has non-GPS devices attached with USB-to-serial
+ converters, gpsd may misbehave or interfere with tools like gpsbabel, so
+ it is recommended to reject this option.
Reply to: