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

Re: [RFR] templates://emacspeak/{templates}



Christian Perrier wrote:
>  Template: shared/emacspeak/rootgroup
>  Type: error
> -_Description: ERROR: no normal user can use ${port}.
> - Since the speech device is connected to ${port}, normal users must
> - have permission to read and write that device.  Please change its
> - mode with "chmod a+rw ${port}" or its group with "chown root.dialout
> - ${port}", then configure emacspeak again with "dpkg-reconfigure
> - emacspeak".
> +_Description: ${port} non writable by unprivileged users

I'd say:
   _Description: ${port} non-writable for unprivileged users

> + Since the speech device is connected to ${port}, unprivileged users must
> + have permission to read and write that device.
[...]
>  "write that device"? Shouldn't this be "write *on* that device"?

Or "write to", but then it has to be "read from and write to".
Maybe it would be simpler to say: 

    Since the speech device is connected to ${port}, unprivileged users must
    have read/write access to that device.

> + .
> + You should modify the device permissions with 'chmod a+rw ${port}'
> + or modify the device group with 'chown root.dialout ${port}',
> + then reconfigure emacspeak with 'dpkg-reconfigure emacspeak'.

The recommended syntax is 'chown root:dialout ${port}', just in case
there's a user named root.dialout...

>  Description: speech output interface to Emacs
>   Emacspeak is a speech output system that will allow someone who
> - cannot see to work directly on a UNIX system.  Emacspeak is built on
> - top of Emacs.  Once you start emacs with emacspeak loaded, you get
> - spoken feedback for everything you do.  Your mileage will vary
> - depending on how well you can use Emacs.  There is nothing that you
> - cannot do inside Emacs :-).  This package includes speech servers
> + cannot see to work directly on a UNIX system.
> + .
> + Emacspeak is built on
> + top of Emacs.  Once Emacs is stared with emacspeak loaded, users get
                                 started
> + spoken feedback for all actions.  As Emacs can do everything,
> + they get speech feedback for everything they do.

I think this would work better as "they will get..." (i.e. from that
point on).
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff -u ../emacspeak.old/debian/control debian/control
--- ../emacspeak.old/debian/control	2008-11-23 16:28:42.000000000 +0000
+++ debian/control	2008-11-23 16:38:59.000000000 +0000
@@ -9,16 +9,19 @@
 
 Package: emacspeak
 Architecture: all
-Depends: tclx8.4, tcl8.4, perl, emacsen-common, make, emacs22|emacs21, w3-url-e21, adduser, debconf
+Depends: tclx8.4, tcl8.4, perl-5.6|perl, emacsen-common, make, emacs22|emacs21, w3-url-e21, adduser, debconf
 Conflicts: emacspeak-dt (<= 0.30), emacspeak-ss (<< 1.12-2)
-Suggests: emacspeak-ss, psgml, xsltproc, eflite, espeak, w3-el-e21
+Suggests: emacspeak-ss, calc, psgml, xsltproc, eflite, espeak, w3-el-e21
 Description: speech output interface to Emacs
  Emacspeak is a speech output system that will allow someone who
- cannot see to work directly on a UNIX system.  Emacspeak is built on
- top of Emacs.  Once you start emacs with emacspeak loaded, you get
- spoken feedback for everything you do.  Your mileage will vary
- depending on how well you can use Emacs.  There is nothing that you
- cannot do inside Emacs :-).  This package includes speech servers
+ cannot see to work directly on a UNIX system.
+ .
+ Emacspeak is built on
+ top of Emacs.  Once Emacs is started with emacspeak loaded, users get
+ spoken feedback for all actions.  As Emacs can do everything,
+ they will get speech feedback for everything they do.
+ .
+ This package includes speech servers
  written in Tcl to support the DECtalk Express and DECtalk MultiVoice
  speech synthesizers.  For other synthesizers, look for separate
  speech server packages such as emacspeak-ss and eflite.
Only in ../emacspeak.old/debian/: emacspeak_28.0.orig.tar.gz
diff -u ../emacspeak.old/debian/templates debian/templates
--- ../emacspeak.old/debian/templates	2008-11-23 16:28:42.000000000 +0000
+++ debian/templates	2008-11-23 16:41:48.000000000 +0000
@@ -1,7 +1,7 @@
 Template: shared/emacspeak/fake
 Type: select
 Choices: ${choices}
-Description: Which packages have installed speech servers?
+Description: for internal use
  This template is never shown to the user and does not require
  translation.
 
@@ -9,62 +9,59 @@
 Type: select
 Choices: ${choices}
 _Description: Default speech server:
- The file /etc/emacspeak.conf will be configured so that the command
- "/usr/bin/emacspeak" will start emacs with emacspeak support using
- this server.  You may change the selection later by running
- "dpkg-reconfigure emacspeak" as root, or temporarily override the
- selection by setting the environment variable DTK_PROGRAM.  If you
- want to use a server in a separate package, which does not appear in
- the list, just accept the default now, and you should be asked again
- when that other package is installed.
+ The /etc/emacspeak.conf file will be configured so that the command
+ '/usr/bin/emacspeak' will start Emacs with emacspeak support using
+ this server.
+ .
+ You may change the selection later by running
+ 'dpkg-reconfigure emacspeak' as root, or temporarily override the
+ selection by setting the environment variable DTK_PROGRAM.
 Default: DECtalk Express
 
 Template: shared/emacspeak/port
 Type: string
-# "none" must remain in english
-_Description: hardware port:
- If a hardware device is used to generate speech, enter the Unix
- device file associated with it.  For example, "/dev/ttyS0" or
- "/dev/ttyUSB0" (but without the quotation marks).  For software
- generated speech, enter "none".
+#flag:comment:3
+# Translators, please do not translate "none"
+_Description: Hardware port of the speech generation device:
+ If a hardware device is used to generate speech, please enter the
+ Unix device file associated with it, such as' /dev/ttyS0' or
+ '/dev/ttyUSB0'
+ .
+ If you use a software method to generate speech, please enter 'none'.
 
 Template: shared/emacspeak/invalidport
 Type: error
-_Description: ERROR: ${port} is not a character special device.
+_Description: ${port} is not a character special device
 
 Template: shared/emacspeak/groupies
 Type: string
 _Description: Users of speech server:
  Users must be members of group ${group} to access the speech server
- connected to ${port}.  Please review the following space-separated
- list of members, and add or remove usernames if needed.
- .
- For a user whose account doesn't exist yet, please reconfigure
- emacspeak after creating the account, with the command
+ connected to ${port}. Please review the space-separated list of
+ current members of that group, and add or remove usernames if needed.
  .
-   dpkg-reconfigure emacspeak
- .
- or manually enroll the user in ${group} with the command
- .
-   adduser ${group} mary
+ If you later add users to the system, you can either reconfigure
+ the emacspeak package afterwards, or enroll the user in ${group}
+ with 'adduser ${group} <user>'.
  .
  Group membership is checked at login time, so new members must log
  out and log in again before using the speech server.
 
 Template: shared/emacspeak/invaliduser
 Type: error
-_Description: Skipping invalid username ${user}.
+_Description: Invalid username ${user}
  There is no user named ${user}, so no such user could be added to
  ${group}.
 
 Template: shared/emacspeak/rootgroup
 Type: error
-_Description: ERROR: no normal user can use ${port}.
- Since the speech device is connected to ${port}, normal users must
- have permission to read and write that device.  Please change its
- mode with "chmod a+rw ${port}" or its group with "chown root.dialout
- ${port}", then configure emacspeak again with "dpkg-reconfigure
- emacspeak".
+_Description: ${port} non-writable for unprivileged users
+ Since the speech device is connected to ${port}, unprivileged users must
+ have read/write access to that device.
+ .
+ You should modify the device permissions with 'chmod a+rw ${port}'
+ or modify the device group with 'chown root:dialout ${port}',
+ then reconfigure emacspeak with 'dpkg-reconfigure emacspeak'.
 
 Template: shared/emacspeak/program
 Type: string
Template: shared/emacspeak/fake
Type: select
Choices: ${choices}
Description: for internal use
 This template is never shown to the user and does not require
 translation.

Template: shared/emacspeak/device
Type: select
Choices: ${choices}
_Description: Default speech server:
 The /etc/emacspeak.conf file will be configured so that the command
 '/usr/bin/emacspeak' will start Emacs with emacspeak support using
 this server.
 .
 You may change the selection later by running
 'dpkg-reconfigure emacspeak' as root, or temporarily override the
 selection by setting the environment variable DTK_PROGRAM.
Default: DECtalk Express

Template: shared/emacspeak/port
Type: string
#flag:comment:3
# Translators, please do not translate "none"
_Description: Hardware port of the speech generation device:
 If a hardware device is used to generate speech, please enter the
 Unix device file associated with it, such as' /dev/ttyS0' or
 '/dev/ttyUSB0'
 .
 If you use a software method to generate speech, please enter 'none'.

Template: shared/emacspeak/invalidport
Type: error
_Description: ${port} is not a character special device

Template: shared/emacspeak/groupies
Type: string
_Description: Users of speech server:
 Users must be members of group ${group} to access the speech server
 connected to ${port}. Please review the space-separated list of
 current members of that group, and add or remove usernames if needed.
 .
 If you later add users to the system, you can either reconfigure
 the emacspeak package afterwards, or enroll the user in ${group}
 with 'adduser ${group} <user>'.
 .
 Group membership is checked at login time, so new members must log
 out and log in again before using the speech server.

Template: shared/emacspeak/invaliduser
Type: error
_Description: Invalid username ${user}
 There is no user named ${user}, so no such user could be added to
 ${group}.

Template: shared/emacspeak/rootgroup
Type: error
_Description: ${port} non-writable for unprivileged users
 Since the speech device is connected to ${port}, unprivileged users must
 have read/write access to that device.
 .
 You should modify the device permissions with 'chmod a+rw ${port}'
 or modify the device group with 'chown root:dialout ${port}',
 then reconfigure emacspeak with 'dpkg-reconfigure emacspeak'.

Template: shared/emacspeak/program
Type: string
Description: for internal use
 This template is never shown to the user and does not require
 translation.  This variable holds the path to the speech server,
 relative to /usr/share/<flavor>/site-lisp/emacspeak/servers.

Template: shared/emacspeak/tcl
Type: string
Description: for internal use
 This template is never shown to the user and does not require
 translation.  This variable holds the path to the interpreter if any
 used to run the speech server.

Template: shared/emacspeak/database
Type: select
Choices: ${choices}
Description: for internal use
 This template is never shown to the user and does not require
 translation.  This variable holds all the available choices for
 speech servers, and the corresponding values of "program", "tcl", and
 "device" for the above variables.
Source: emacspeak
Section: editors
Priority: extra
Maintainer: James R. Van Zandt <jrv@debian.org>
Build-Depends: debhelper (>= 5), po-debconf
Build-Depends-Indep: texi2html, lynx, texinfo, ghostscript
Standards-Version: 3.8.0
Homepage: http://emacspeak.sf.net

Package: emacspeak
Architecture: all
Depends: tclx8.4, tcl8.4, perl-5.6|perl, emacsen-common, make, emacs22|emacs21, w3-url-e21, adduser, debconf
Conflicts: emacspeak-dt (<= 0.30), emacspeak-ss (<< 1.12-2)
Suggests: emacspeak-ss, calc, psgml, xsltproc, eflite, espeak, w3-el-e21
Description: speech output interface to Emacs
 Emacspeak is a speech output system that will allow someone who
 cannot see to work directly on a UNIX system.
 .
 Emacspeak is built on
 top of Emacs.  Once Emacs is started with emacspeak loaded, users get
 spoken feedback for all actions.  As Emacs can do everything,
 they will get speech feedback for everything they do.
 .
 This package includes speech servers
 written in Tcl to support the DECtalk Express and DECtalk MultiVoice
 speech synthesizers.  For other synthesizers, look for separate
 speech server packages such as emacspeak-ss and eflite.

Reply to: