thr3ads.net - Adduser devel - [ITR] templates://adduser/{templates} [Jun 2007]

If this information is useful, please help other people find it:
Share via:

Christian Perrier

2007-Jun-07 21:07 UTC

[ITR] templates://adduser/{templates}

Dear Debian maintainer,

The Debian internationalisation team and the Debian English
localisation team will soon begin the review of the debconf
templates used in adduser.

This review takes place for all packages that use debconf to interact with
users and its aims are:
- to improve the use of English in all debconf templates;
- to make the wording of debconf templates more consistent;
- to encourage more translations of templates.

Even if your first language is English, this process is likely to help
track down typos or errors, and improve consistency between the
debconf templates of your package and that of other packages in the
distribution.

The process involves both debian-l10n-english contributors and
Debian translators.

The details of the process are given in
http://wiki.debian.org/I18n/SmithDebconfReviewProcess.

I will act as the coordinator of this activity for adduser.

The first step of the process is to review the debconf source
template file(s) of adduser. This review will start on Sunday, June 10, 2007, or
as soon as you acknowledge this mail with an agreement for us to
carry out this process.

All parts of the process will be carried out in close collaboration
with you, and, unless you explicitely ask for it, no upload nor NMU
will happen for adduser.

If you approve this process, please let us know by replying to this
mail. If some work in progress on your side would conflict with such a
rewrite (such as adding or removing debconf templates), please say so,
and we will defer the review to later in the development cycle.

Thank you for your attention.

--

Christian Perrier

2007-Jun-11 06:19 UTC

head link

[Adduser-devel] [RFR] templates://adduser/{templates}

Please find, for review, the debconf templates of adduser.

This review will last from Monday, June 11, 2007 to Thursday, June 21, 2007.

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 will reach a consensus, I 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:

---
/home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser.old/debian/templates
2007-06-05 06:06:04.090505737 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser/debian/templates
2007-06-07 23:09:53.371287343 +0200
@@ -1,11 +1,11 @@
 Template: adduser/homedir-permission
 Type: boolean
 Default: true
-_Description: Do you want system wide readable home directories?
- Normally, home directories can be viewed by all users on the system. If
- you want to increase the security/privacy on your system, you might want
- your home directories only readable by the user. If you are unsure,
- enable system wide readable home directories.
+_Description: Do you want system-wide readable home directories?
+ By default, the users'' home directories are readable by all users on
+ the system. If you want to increase the security and privacy on the
+ system, you might want home directories to be only readable by their
+ owners. If in doubt, you should enable this option.

Hyphen: recommended use in English in such cases?

paragraph rewrite for what seems to be better wording to
me..:-). Again, tending to avoid personnalization ("your home
directories")

  .
- This will only affect home directories of users added with the adduser
- program later.
+ This will only affect newly created home directories for users added
+ with the adduser program.

I feel this like better wording but this may be improved by native
speakers, though.


---
/home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser.old/debian/control
2007-06-05 06:06:04.090505737 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser/debian/control
2007-06-07 23:13:06.862196867 +0200
@@ -12,25 +12,25 @@
 Depends: perl-base (>=5.6.0), passwd (>= 1:4.0.12), debconf | debconf-2.0
 Suggests: liblocale-gettext-perl, perl-modules
 Replaces: manpages-pl (<= 20051117-1), manpages-it (<< 0.3.4-2)
-Description: Add and remove users and groups
+Description: add and remove users and groups

Remove extra capital for overall consistency among packages

  This package includes the adduser and deluser commands for creating
  and removing users.
  .
-  - Adduser can create new users and groups and add existing users to
-    existing groups.
-  - Deluser can remove users and groups and remove users from a given
+  - ''adduser'' creates new users and groups and adds existing
users to
+    existing groups;
+  - ''deluser'' removes users and groups and removes users from
a given
     group.

As we''re speaking about commands, let''s use quotes. Common
enumeration
typography.

  .
- Adding users with adduser is much easier than adding them by hand.
+ Adding users with adduser is much easier than adding them manually.

Matter of taste...


  Adduser will choose appropriate UID and GID values, create a home
- directory, copy skeletal user configuration, allow you to set an
- initial password and the GECOS field.
+ directory, copy skeletal user configuration, fill in the GECOS field
+ and allow setting an initial password.

Native speakers: is "allow setting" Frenglish??:-)


  .
  Deluser can optionally remove and backup the user''s home directory
- and mail spool or all files on the system owned by him.
+ and mail spool or all files on the system owned by the removed user.


Gender neutrality

  .
- Optionally a custom script can be executed after each of the commands.
+ A custom script can be executed after each of the commands.

"can" already includes the idea of being optional


  .
- Adduser is maintained on http://alioth.debian.org/projects/adduser/.
- There is also a development mailing list on
- http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/.
+  Homepage: http://alioth.debian.org/projects/adduser/
+  Development mailing list:
+    http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/

General convention for such information in packages'' descriptions.

-- 


-------------- next part --------------
Template: adduser/homedir-permission
Type: boolean
Default: true
_Description: Do you want system-wide readable home directories?
 By default, the users'' home directories are readable by all users on
 the system. If you want to increase the security and privacy on the
 system, you might want home directories to be only readable by their
 owners. If in doubt, you should enable this option.
 .
 This will only affect newly created home directories for users added
 with the adduser program.
-------------- next part --------------
--- ../adduser.old/debian/templates	2007-06-05 06:06:04.090505737 +0200
+++ debian/templates	2007-06-07 23:09:53.371287343 +0200
@@ -1,11 +1,11 @@
 Template: adduser/homedir-permission
 Type: boolean
 Default: true
-_Description: Do you want system wide readable home directories?
- Normally, home directories can be viewed by all users on the system. If
- you want to increase the security/privacy on your system, you might want
- your home directories only readable by the user. If you are unsure,
- enable system wide readable home directories.
+_Description: Do you want system-wide readable home directories?
+ By default, the users'' home directories are readable by all users on
+ the system. If you want to increase the security and privacy on the
+ system, you might want home directories to be only readable by their
+ owners. If in doubt, you should enable this option.
  .
- This will only affect home directories of users added with the adduser
- program later.
+ This will only affect newly created home directories for users added
+ with the adduser program.
--- ../adduser.old/debian/control	2007-06-05 06:06:04.090505737 +0200
+++ debian/control	2007-06-07 23:13:06.862196867 +0200
@@ -12,25 +12,25 @@
 Depends: perl-base (>=5.6.0), passwd (>= 1:4.0.12), debconf | debconf-2.0
 Suggests: liblocale-gettext-perl, perl-modules
 Replaces: manpages-pl (<= 20051117-1), manpages-it (<< 0.3.4-2)
-Description: Add and remove users and groups
+Description: add and remove users and groups
  This package includes the adduser and deluser commands for creating
  and removing users.
  .
-  - Adduser can create new users and groups and add existing users to
-    existing groups.
-  - Deluser can remove users and groups and remove users from a given
+  - ''adduser'' creates new users and groups and adds existing
users to
+    existing groups;
+  - ''deluser'' removes users and groups and removes users from
a given
     group.
  .
- Adding users with adduser is much easier than adding them by hand.
+ Adding users with adduser is much easier than adding them manually.
  Adduser will choose appropriate UID and GID values, create a home
- directory, copy skeletal user configuration, allow you to set an
- initial password and the GECOS field.
+ directory, copy skeletal user configuration, fill in the GECOS field
+ and allow setting an initial password.
  .
  Deluser can optionally remove and backup the user''s home directory
- and mail spool or all files on the system owned by him.
+ and mail spool or all files on the system owned by the removed user.
  .
- Optionally a custom script can be executed after each of the commands.
+ A custom script can be executed after each of the commands.
  .
- Adduser is maintained on http://alioth.debian.org/projects/adduser/.
- There is also a development mailing list on
- http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/.
+  Homepage: http://alioth.debian.org/projects/adduser/
+  Development mailing list:
+    http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/
-------------- next part --------------
Source: adduser
Section: admin
Priority: important
Maintainer: Debian Adduser Developers <adduser-devel at
lists.alioth.debian.org>
Uploaders: Roland Bauerschmidt <rb at debian.org>, Marc Haber
<mh+debian-packages at zugschlus.de>
Standards-Version: 3.7.2
Build-Depends: po-debconf
Build-Depends-Indep: gettext (>= 0.13), po4a (>= 0.23)

Package: adduser
Architecture: all
Depends: perl-base (>=5.6.0), passwd (>= 1:4.0.12), debconf | debconf-2.0
Suggests: liblocale-gettext-perl, perl-modules
Replaces: manpages-pl (<= 20051117-1), manpages-it (<< 0.3.4-2)
Description: add and remove users and groups
 This package includes the adduser and deluser commands for creating
 and removing users.
 .
  - ''adduser'' creates new users and groups and adds existing
users to
    existing groups;
  - ''deluser'' removes users and groups and removes users from
a given
    group.
 .
 Adding users with adduser is much easier than adding them manually.
 Adduser will choose appropriate UID and GID values, create a home
 directory, copy skeletal user configuration, fill in the GECOS field
 and allow setting an initial password.
 .
 Deluser can optionally remove and backup the user''s home directory
 and mail spool or all files on the system owned by the removed user.
 .
 A custom script can be executed after each of the commands.
 .
  Homepage: http://alioth.debian.org/projects/adduser/
  Development mailing list:
    http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url :
http://lists.alioth.debian.org/pipermail/adduser-devel/attachments/20070611/385bf611/attachment.pgp

Joerg Hoh

2007-Jun-11 19:11 UTC

head link

[Adduser-devel] [RFR] templates://adduser/{templates}

Hi

my 0.02 Cent

On Mon, Jun 11, 2007 at 08:19:40AM +0200, Christian Perrier
wrote:> ---
/home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser.old/debian/templates
2007-06-05 06:06:04.090505737 +0200
> +++
/home/bubulle/travail/debian/rewrite/INTENT/adduser/adduser/debian/templates
2007-06-07 23:09:53.371287343 +0200
> @@ -1,11 +1,11 @@
>  Template: adduser/homedir-permission
>  Type: boolean
>  Default: true
> -_Description: Do you want system wide readable home directories?
> - Normally, home directories can be viewed by all users on the system. If
> - you want to increase the security/privacy on your system, you might want
> - your home directories only readable by the user. If you are unsure,
> - enable system wide readable home directories.
> +_Description: Do you want system-wide readable home directories?
> + By default, the users'' home directories are readable by all
users on
> + the system. If you want to increase the security and privacy on the
> + system, you might want home directories to be only readable by their
> + owners. If in doubt, you should enable this option.
s/only readable/readably only/

> 
>   Adduser will choose appropriate UID and GID values, create a home
> - directory, copy skeletal user configuration, allow you to set an
> - initial password and the GECOS field.
> + directory, copy skeletal user configuration, fill in the GECOS field
> + and allow setting an initial password.
> 
> Native speakers: is "allow setting" Frenglish??:-)
> 
"allow to set"?


J?rg, no native speaker 


-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url :
http://lists.alioth.debian.org/pipermail/adduser-devel/attachments/20070611/10bf3080/attachment.pgp

Justin B Rye

2007-Jun-11 19:32 UTC

head link

[Adduser-devel] [RFR] templates://adduser/{templates}

Christian Perrier wrote:> Your review should be sent as an answer to this mail.
> +_Description: Do you want system-wide readable home directories?
> + By default, the users'' home directories are readable by all
users on
> + the system. If you want to increase the security and privacy on the
> + system, you might want home directories to be only readable by their
> + owners.
> 
> Hyphen: recommended use in English in such cases?
"System-wide"?  Definitely.
 > paragraph rewrite for what seems to be better wording to
> me..:-). Again, tending to avoid personnalization ("your home
directories")
That makes sense.  But (preserved from the original) "to increase
the security and privacy on the system" falls between two stools:
	to increase the security/privacy of the system
	to increase security/privacy on the system
and although it''s not particularly jarring, it''s enough to
make me
notice that "on the system" is getting repeated.

  _Description: Do you want system-wide readable home directories?
   By default, user home directories are readable for all users on the
   system. If you want to increase security and privacy, you might want
   home directories to be readable only for their owners.
>             If in doubt, you should enable this option.
Which means you should *not* change it from the default of "true"
("yes, leave them public").  There''s a danger readers will
misunderstand this as advice that they should play safe by enabling
the option just mentioned ("no, make them private").

              But if in doubt, leave this option enabled.
> + This will only affect newly created home directories for users added
> + with the adduser program.
> 
> I feel this like better wording but this may be improved by native
> speakers, though.
I was thinking
   This will affect only home directories of users added from this point
   on with the adduser command.         
 >   Adduser will choose appropriate UID and GID values, create a home
> - directory, copy skeletal user configuration, allow you to set an
> - initial password and the GECOS field.
> + directory, copy skeletal user configuration, fill in the GECOS field
> + and allow setting an initial password.
> 
> Native speakers: is "allow setting" Frenglish??:-)
No, but I don''t like "allow" here anyway, since adduser
doesn''t
normally offer an alternative!  Also, adduser does not itself fill
in the GECOS field; it just lets you fill it in at the same time as
the password.  And do we really need to use this term "GECOS", which
isn''t explained even in "man 5 passwd"?  It stands for
"General
Electric Comprehensive Operating Supervisor", but even GE themselves
haven''t called it by that name since 1970! 

How about:

    directory, copy skeletal user configuration, and automate setting
    initial values for the user''s password, real name and so on.
>   Deluser can optionally remove and backup the user''s home
directory
The verb is (usually) "back up", not "backup", and
it''s safer to
archive things before you remove them... (Oh, and there''s a "can
optionally" here too!  But this time it works, contrasting with the
things adduser *will* do).

    Deluser can optionally back up and remove the user''s home directory
    and mail spool or all files on the system owned by the removed user.

But I would gender-neutralise it this way instead:

    Deluser can optionally back up and remove users'' home directories
    and mail spools or all the files they own on the system.
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
-------------- next part --------------
4,8c4,8
< _Description: Do you want system wide readable home directories?
<  Normally, home directories can be viewed by all users on the system. If
<  you want to increase the security/privacy on your system, you might want
<  your home directories only readable by the user. If you are unsure,
<  enable system wide readable home directories.
---> _Description: Do you want system-wide readable home directories?
>  By default, user home directories are readable for all users on the
>  system. If you want to increase security and privacy, you might want
>  home directories to be readable only for their owners. But if in
>  doubt, leave this option enabled.10,11c10,11
<  This will only affect home directories of users added with the adduser
<  program later.
--->  This will affect only home directories of users added from this point
>  on with the adduser command.15c15
< Description: Add and remove users and groups
---> Description: add and remove users and groups19,21c19,21
<   - Adduser can create new users and groups and add existing users to
<     existing groups.
<   - Deluser can remove users and groups and remove users from a given
--->   - ''adduser'' creates new users and groups and adds
existing users to
>     existing groups;
>   - ''deluser'' removes users and groups and removes users
from a given24c24
<  Adding users with adduser is much easier than adding them by hand.
--->  Adding users with adduser is much easier than adding them manually.26,27c26,27
<  directory, copy skeletal user configuration, allow you to set an
<  initial password and the GECOS field.
--->  directory, copy skeletal user configuration, and automate setting
>  initial values for the user''s password, real name and so on.29,30c29,30
<  Deluser can optionally remove and backup the user''s home
directory
<  and mail spool or all files on the system owned by him.
--->  Deluser can optionally back up and remove users'' home directories
>  and mail spools or all the files they own on the system.32c32
<  Optionally a custom script can be executed after each of the commands.
--->  A custom script can be executed after each of the commands.34,36c34,36
<  Adduser is maintained on http://alioth.debian.org/projects/adduser/.
<  There is also a development mailing list on
<  http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/.
--->   Homepage: http://alioth.debian.org/projects/adduser/
>   Development mailing list:
>     http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/-------------- next part --------------
Template: adduser/homedir-permission
Type: boolean
Default: true
_Description: Do you want system-wide readable home directories?
 By default, user home directories are readable for all users on the
 system. If you want to increase security and privacy, you might want
 home directories to be readable only for their owners. But if in
 doubt, leave this option enabled.
 .
 This will affect only home directories of users added from this point
 on with the adduser command.
-------------- next part --------------
Source: adduser
Section: admin
Priority: important
Maintainer: Debian Adduser Developers <adduser-devel at
lists.alioth.debian.org>
Uploaders: Roland Bauerschmidt <rb at debian.org>, Marc Haber
<mh+debian-packages at zugschlus.de>
Standards-Version: 3.7.2
Build-Depends: po-debconf
Build-Depends-Indep: gettext (>= 0.13), po4a (>= 0.23)

Package: adduser
Architecture: all
Depends: perl-base (>=5.6.0), passwd (>= 1:4.0.12), debconf | debconf-2.0
Suggests: liblocale-gettext-perl, perl-modules
Replaces: manpages-pl (<= 20051117-1), manpages-it (<< 0.3.4-2)
Description: add and remove users and groups
 This package includes the adduser and deluser commands for creating
 and removing users.
 .
  - ''adduser'' creates new users and groups and adds existing
users to
    existing groups;
  - ''deluser'' removes users and groups and removes users from
a given
    group.
 .
 Adding users with adduser is much easier than adding them manually.
 Adduser will choose appropriate UID and GID values, create a home
 directory, copy skeletal user configuration, and automate setting
 initial values for the user''s password, real name and so on.
 .
 Deluser can optionally back up and remove users'' home directories
 and mail spools or all the files they own on the system.
 .
 A custom script can be executed after each of the commands.
 .
  Homepage: http://alioth.debian.org/projects/adduser/
  Development mailing list:
    http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/

Christian Perrier

2007-Jun-12 05:04 UTC

head link

[Adduser-devel] [RFR2] templates://adduser/{templates}

There have been many contributions (thanks Joerg, Adam and Justin), so
I feel that it coul dbe good to send the corrected versions of both
the templates and control files after changing what you guys
suggested.

-------------- next part --------------
Template: adduser/homedir-permission
Type: boolean
Default: true
_Description: Do you want system-wide readable home directories?
By default, users'' home directories are readable by all users on the
system. If you want to increase security and privacy, you might want
home directories to be readable only for their owners. But if in doubt,
leave this option enabled.
.
This will affect only home directories of users added from this point
on with the adduser command.
-------------- next part --------------
Source: adduser
Section: admin
Priority: important
Maintainer: Debian Adduser Developers <adduser-devel at
lists.alioth.debian.org>
Uploaders: Roland Bauerschmidt <rb at debian.org>, Marc Haber
<mh+debian-packages at zugschlus.de>
Standards-Version: 3.7.2
Build-Depends: po-debconf
Build-Depends-Indep: gettext (>= 0.13), po4a (>= 0.23)

.
Deluser can back up and remove users'' home directories
and mail spool or all the files they own on the system.
.
A custom script can be executed after each of the commands.
.
Homepage: http://alioth.debian.org/projects/adduser/
Development mailing list:
http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url :
http://lists.alioth.debian.org/pipermail/adduser-devel/attachments/20070612/1a484c91/attachment.pgp

Justin B Rye

2007-Jun-12 07:14 UTC

head link

[Adduser-devel] [RFR2] templates://adduser/{templates}

Christian Perrier wrote:> I feel that it coul dbe good to send the corrected versions of both
> the templates and control files after changing what you guys
> suggested.
> Package: adduser
...>  Adding users with adduser is much easier than adding them manually.
>  Adduser will choose appropriate UID and GID values, create a home
>  directory, copy skeletal user configuration, and automate setting
>  initial values for the user''s password, real name and so on.
> 
>  .
>  Deluser can back up and remove users'' home directories
>  and mail spool or all the files they own on the system.
Surplus whitespace.
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)

Christian Perrier

2007-Jun-23 01:03 UTC

head link

[Adduser-devel] [LCFC] templates://adduser/{templates}

This is the last call for comments for the review of debconf
templates for adduser.

The reviewed templates will be sent on Monday, June 25, 2007 to the package
maintainer as a bug report and a mail will be sent to this list with
"[BTS]" as a subject tag.

Package: adduser
Architecture: all
Depends: perl-base (>=5.6.0), passwd (>= 1:4.0.12), debconf | debconf-2.0
Suggests: liblocale-gettext-perl, perl-modules
Replaces: manpages-pl (<= 20051117-1), manpages-it (<< 0.3.4-2)
Description: add and remove users and groups
This package includes the ''adduser'' and
''deluser'' commands for creating
and removing users.
.
- ''adduser'' creates new users and groups and adds existing
users to
existing groups;
- ''deluser'' removes users and groups and removes users from
a given
group.
.
Adding users with ''adduser'' is much easier than adding them
manually.
Adduser will choose appropriate UID and GID values, create a home
directory, copy skeletal user configuration, and automate setting
initial values for the user''s password, real name and so on.
.
Deluser can back up and remove users'' home directories
and mail spool or all the files they own on the system.
.
A custom script can be executed after each of the commands.
.
Homepage: http://alioth.debian.org/projects/adduser/
Development mailing list:
http://lists.alioth.debian.org/mailman/listinfo/adduser-devel/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url :
http://lists.alioth.debian.org/pipermail/adduser-devel/attachments/20070623/d42ce0f8/attachment.pgp

Adduser devel - Jun 2007 - [ITR] templates://adduser/{templates}

[ITR] templates://adduser/{templates}

[Adduser-devel] [RFR] templates://adduser/{templates}

[Adduser-devel] [RFR] templates://adduser/{templates}

[Adduser-devel] [RFR] templates://adduser/{templates}

[Adduser-devel] [RFR2] templates://adduser/{templates}

[Adduser-devel] [RFR2] templates://adduser/{templates}

[Adduser-devel] [LCFC] templates://adduser/{templates}