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

[RFR] templates://italc/{italc-client.templates}



Please find, for review, the debconf templates and packages descriptions for the italc source package.

This review will last from Monday, August 19, 2013 to Thursday, August 29, 2013.

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, a summary will be sent to the review bug report,
and a mail will be sent to this list with "[BTS]" as a subject tag.

Rationale:
--- italc.old/debian/italc-client.templates	2013-08-15 10:48:49.746321613 +0200
+++ italc/debian/italc-client.templates	2013-08-19 14:23:00.877825759 +0200
@@ -25,7 +25,7 @@
  iTALC knows four different access roles for iTALC clients (teacher, student,
  supporter, and administrator).
  .
- iTALC manages this role based client access via SSL keys.
+ iTALC manages this role-based client access via SSL keys.
  .
  After installation of this package you may want those SSL keys to be
  created automatically. If so, you will find the freshly created keys in

"role based" --> "role-based"

@@ -35,30 +35,30 @@
 Type: boolean
 Default: true
 _Description: Create Posix groups for iTALC roles now?
- iTALC's role model requires configuration of four Posix groups on your
+ iTALC's role model requires configuration of four Posix groups on the
  system. The available roles are teacher, student, supporter, and admin.
  .
  You can either create those four Posix groups now or (re-)use Posix groups
- that already exist on your system.
+ that already exist on the system.

Impersonate the system. This is not necessarily "my" system.

 
 Template: italc-client/use-existing-groups-for-roles
 Type: boolean
 Default: false
 _Description: Use already existing groups for iTALC roles?
  If you already have set up groups for reflecting the iTALC role model
- (e.g. in your LDAP user/group database) then you can specify those group
+ (e.g. in the LDAP user/group database) then you can specify those group
  names on the next screens.

Ditto
 
 Template: italc-client/group-italc-teacher
 Type: string
 Default: italc-teacher
-_Description: Group for people in the role of iTALC teachers:
- Specify the Posix group name for people in the role of an iTALC teacher.
- The teacher role gives you basic control over iTALC clients in class
+_Description: iTALC teachers role group:
+ Please specify the Posix group name for iTALC teachers.
+ .
+ The teacher role gives basic control over iTALC clients in class
  rooms.
  .
- If the below field stays empty, then the Posix group root will be used
- instead.
+ If you leave this empty, the "root" Posix group will be used.
 
 Template: italc-client/del-last-group-teacher
 Type: boolean


Synopsis: more compact formulation

Split the first paragraph in two for better factorization, for translators

The field is not necessarily "below". It can be "above" or "aside",
depending on the debconf interface that's used. So switch to a more
standard formulation.

Quote "root" so that it is clearer what we're talking about.

These changes are repeated over for the other similar templates.


@@ -66,18 +66,18 @@
 _Description: Do you want to delete the group that was formerly used for this role?
  The Posix group for the iTALC teacher role has been modified.
  .
- If unsure, keep the formerly used group and manually investigate your
+ If unsure, keep the formerly used group and manually investigate the
  system later.


 
 Template: italc-client/key-access-for-groups
 Type: boolean
 Default: true
 _Description: Make iTALC's SSL keys accessible to the role model groups?
- To make the iTALC role model fully functional now, specific group access
+ To make the iTALC role model fully functional now, specific group access
  to the created SSL keys has to be granted.
  .
  If you skip this step, iTALC SSL keys are only accessible by the
- super-user `root' and you have to manually setup file permissions on the
+ super-user "root" and you have to manually setup file permissions on the
  keys later.

1st para: no change...:-)

quote "root" with the standard double quotes we're using all over
debconf templates.


--- italc.old/debian/control	2013-08-15 10:48:49.746321613 +0200
+++ italc/debian/control	2013-08-19 14:31:38.957576368 +0200
@@ -44,11 +44,11 @@
  libitalccore (=${binary:Version}),
 Description: Intelligent Teaching and Learning with Computers - Master
  iTALC makes it possible, to access and influence the students
- activities just from the computer of the teacher. With the
- help of iTALC, for example the teacher is able to see the
+ activities just from the computer of the teacher. For example, with the
+ help of iTALC, the teacher is able to see the
  content of the students screens on his screen. If a student needs
  help, the teacher can access the students desktop and give support
- from his computer. The student can watch all activities, the
+ from his computer. The student can watch all activities the
  teacher is doing on his desktop. So the student can learn new processes.
  For teaching something to all students, you can switch into demo-mode
  where all screens of the students show the teacher-screen.

Move "for example" for (I guess) better English

Drop the comma: I don't think it's needed here

These changes are of course repeated in all other boilerplates



@@ -134,4 +134,4 @@
  Furthermore things like locking student's screens, killing games,
  power on/off clients and much more can be done with iTALC.
  .
- This package provides the necessary library for italc
+ This package provides the needed libraries for iTALC.

Properly capitalize iTALC. Add a sentence dot. s/necessary/needed (?)

-- 


Template: italc-client/last-group-teacher
Type: string
Default: 
Description: for internal use

Template: italc-client/last-group-student
Type: string
Default: 
Description: for internal use

Template: italc-client/last-group-supporter
Type: string
Default: 
Description: for internal use

Template: italc-client/last-group-admin
Type: string
Default: 
Description: for internal use

Template: italc-client/create-keypairs
Type: boolean
Default: false
_Description: Automatically set up iTALC's role model and create iTALC SSL key pairs?
 iTALC knows four different access roles for iTALC clients (teacher, student,
 supporter, and administrator).
 .
 iTALC manages this role-based client access via SSL keys.
 .
 After installation of this package you may want those SSL keys to be
 created automatically. If so, you will find the freshly created keys in
 subfolders of /etc/italc/keys.

Template: italc-client/create-groups-for-roles
Type: boolean
Default: true
_Description: Create Posix groups for iTALC roles now?
 iTALC's role model requires configuration of four Posix groups on the
 system. The available roles are teacher, student, supporter, and admin.
 .
 You can either create those four Posix groups now or (re-)use Posix groups
 that already exist on the system.

Template: italc-client/use-existing-groups-for-roles
Type: boolean
Default: false
_Description: Use already existing groups for iTALC roles?
 If you already have set up groups for reflecting the iTALC role model
 (e.g. in the LDAP user/group database) then you can specify those group
 names on the next screens.

Template: italc-client/group-italc-teacher
Type: string
Default: italc-teacher
_Description: iTALC teachers role group:
 Please specify the Posix group name for iTALC teachers.
 .
 The teacher role gives basic control over iTALC clients in class
 rooms.
 .
 If you leave this empty, the "root" Posix group will be used.

Template: italc-client/del-last-group-teacher
Type: boolean
Default: false
_Description: Do you want to delete the group that was formerly used for this role?
 The Posix group for the iTALC teacher role has been modified.
 .
 If unsure, keep the formerly used group and manually investigate the
 system later.

Template: italc-client/group-italc-student
Type: string
Default: italc-student
_Description: iTALC students role group:
 Please specify the Posix group name for iTALC students.
 .
 The iTALC client only starts for users being a member in this group.
 .
 If you leave this empty, the "root" Posix group will be used.

Template: italc-client/del-last-group-student
Type: boolean
Default: false
_Description: Do you want to delete the group that was formerly used for this role?
 The Posix group for the iTALC student role has been modified.
 .
 If unsure, keep the formerly used group and manually investigate the
 system later.

Template: italc-client/group-italc-supporter
Type: string
Default: italc-supporter
_Description: iTALC supporters role group:
 Please specify the Posix group name for iTALC supporters.
 .
 The supporter role gives extended control over the iTALC setup on this
 site and facilitates giving support to iTALC users.
 .
 If you leave this empty, the "root" Posix group will be used.

Template: italc-client/del-last-group-supporter
Type: boolean
Default: false
_Description: Do you want to delete the group that was formerly used for this role?
 The Posix group for the iTALC supporter role has been modified.
 .
 If unsure, keep the formerly used group and manually investigate the
 system later.

Template: italc-client/group-italc-admin
Type: string
Default: italc-admin
_Description: iTALC administrators role group:
 Please Specify the Posix group name for iTALC administrators.
 .
 The administrator role grants full access to the iTALC instance on
 this site.
 .
 If you leave this empty, the "root" Posix group will be used.


Template: italc-client/del-last-group-admin
Type: boolean
Default: false
_Description: Do you want to delete the group that was formerly used for this role?
 The Posix group for the iTALC administrator role has been modified.
 .
 If unsure, keep the formerly used group and manually investigate the
 system later.

Template: italc-client/key-access-for-groups
Type: boolean
Default: true
_Description: Make iTALC's SSL keys accessible to the role model groups?
 To make the iTALC role model fully functional now, specific group access
 to the created SSL keys has to be granted.
 .
 If you skip this step, iTALC SSL keys are only accessible by the
 super-user "root" and you have to manually setup file permissions on the
 keys later.
--- italc.old/debian/italc-client.templates	2013-08-15 10:48:49.746321613 +0200
+++ italc/debian/italc-client.templates	2013-08-19 14:38:42.943306641 +0200
@@ -25,7 +25,7 @@
  iTALC knows four different access roles for iTALC clients (teacher, student,
  supporter, and administrator).
  .
- iTALC manages this role based client access via SSL keys.
+ iTALC manages this role-based client access via SSL keys.
  .
  After installation of this package you may want those SSL keys to be
  created automatically. If so, you will find the freshly created keys in
@@ -35,30 +35,30 @@
 Type: boolean
 Default: true
 _Description: Create Posix groups for iTALC roles now?
- iTALC's role model requires configuration of four Posix groups on your
+ iTALC's role model requires configuration of four Posix groups on the
  system. The available roles are teacher, student, supporter, and admin.
  .
  You can either create those four Posix groups now or (re-)use Posix groups
- that already exist on your system.
+ that already exist on the system.
 
 Template: italc-client/use-existing-groups-for-roles
 Type: boolean
 Default: false
 _Description: Use already existing groups for iTALC roles?
  If you already have set up groups for reflecting the iTALC role model
- (e.g. in your LDAP user/group database) then you can specify those group
+ (e.g. in the LDAP user/group database) then you can specify those group
  names on the next screens.
 
 Template: italc-client/group-italc-teacher
 Type: string
 Default: italc-teacher
-_Description: Group for people in the role of iTALC teachers:
- Specify the Posix group name for people in the role of an iTALC teacher.
- The teacher role gives you basic control over iTALC clients in class
+_Description: iTALC teachers role group:
+ Please specify the Posix group name for iTALC teachers.
+ .
+ The teacher role gives basic control over iTALC clients in class
  rooms.
  .
- If the below field stays empty, then the Posix group root will be used
- instead.
+ If you leave this empty, the "root" Posix group will be used.
 
 Template: italc-client/del-last-group-teacher
 Type: boolean
@@ -66,18 +66,18 @@
 _Description: Do you want to delete the group that was formerly used for this role?
  The Posix group for the iTALC teacher role has been modified.
  .
- If unsure, keep the formerly used group and manually investigate your
+ If unsure, keep the formerly used group and manually investigate the
  system later.
 
 Template: italc-client/group-italc-student
 Type: string
 Default: italc-student
-_Description: Group for people in the role of iTALC students:
- Specify the Posix group name for people in the role of an iTALC student.
+_Description: iTALC students role group:
+ Please specify the Posix group name for iTALC students.
+ .
  The iTALC client only starts for users being a member in this group.
  .
- If the below field stays empty, then the Posix group root will be used
- instead.
+ If you leave this empty, the "root" Posix group will be used.
 
 Template: italc-client/del-last-group-student
 Type: boolean
@@ -85,19 +85,19 @@
 _Description: Do you want to delete the group that was formerly used for this role?
  The Posix group for the iTALC student role has been modified.
  .
- If unsure, keep the formerly used group and manually investigate your
+ If unsure, keep the formerly used group and manually investigate the
  system later.
 
 Template: italc-client/group-italc-supporter
 Type: string
 Default: italc-supporter
-_Description: Group for people in the role of iTALC supporters:
- Specify the Posix group name for people in the role of an iTALC supporter.
- The supporter role gives extended control over the iTALC setup on your
+_Description: iTALC supporters role group:
+ Please specify the Posix group name for iTALC supporters.
+ .
+ The supporter role gives extended control over the iTALC setup on this
  site and facilitates giving support to iTALC users.
  .
- If the below field stays empty, then the Posix group root will be used
- instead.
+ If you leave this empty, the "root" Posix group will be used.
 
 Template: italc-client/del-last-group-supporter
 Type: boolean
@@ -105,27 +105,28 @@
 _Description: Do you want to delete the group that was formerly used for this role?
  The Posix group for the iTALC supporter role has been modified.
  .
- If unsure, keep the formerly used group and manually investigate your
+ If unsure, keep the formerly used group and manually investigate the
  system later.
 
 Template: italc-client/group-italc-admin
 Type: string
 Default: italc-admin
-_Description: Group for people in the role of iTALC administrators:
- Specify the Posix group name for people in the role of an iTALC
- administrator. The admin role grants full access to the iTALC instance on
- your site.
+_Description: iTALC administrators role group:
+ Please Specify the Posix group name for iTALC administrators.
  .
- If the below field stays empty, then the Posix group root will be used
- instead.
+ The administrator role grants full access to the iTALC instance on
+ this site.
+ .
+ If you leave this empty, the "root" Posix group will be used.
+
 
 Template: italc-client/del-last-group-admin
 Type: boolean
 Default: false
 _Description: Do you want to delete the group that was formerly used for this role?
- The Posix group for the iTALC admin role has been modified.
+ The Posix group for the iTALC administrator role has been modified.
  .
- If unsure, keep the formerly used group and manually investigate your
+ If unsure, keep the formerly used group and manually investigate the
  system later.
 
 Template: italc-client/key-access-for-groups
@@ -136,5 +137,5 @@
  to the created SSL keys has to be granted.
  .
  If you skip this step, iTALC SSL keys are only accessible by the
- super-user `root' and you have to manually setup file permissions on the
+ super-user "root" and you have to manually setup file permissions on the
  keys later.
--- italc.old/debian/control	2013-08-15 10:48:49.746321613 +0200
+++ italc/debian/control	2013-08-19 14:31:38.957576368 +0200
@@ -44,11 +44,11 @@
  libitalccore (=${binary:Version}),
 Description: Intelligent Teaching and Learning with Computers - Master
  iTALC makes it possible, to access and influence the students
- activities just from the computer of the teacher. With the
- help of iTALC, for example the teacher is able to see the
+ activities just from the computer of the teacher. For example, with the
+ help of iTALC, the teacher is able to see the
  content of the students screens on his screen. If a student needs
  help, the teacher can access the students desktop and give support
- from his computer. The student can watch all activities, the
+ from his computer. The student can watch all activities the
  teacher is doing on his desktop. So the student can learn new processes.
  For teaching something to all students, you can switch into demo-mode
  where all screens of the students show the teacher-screen.
@@ -70,11 +70,11 @@
  italc-management-console (=${binary:Version}),
 Description: Intelligent Teaching and Learning with Computers - Client
  iTALC makes it possible, to access and influence the students
- activities just from the computer of the teacher. With the
- help of iTALC, for example the teacher is able to see the
+ activities just from the computer of the teacher. For example, with the
+ help of iTALC, the teacher is able to see the
  content of the students screens on his screen. If a student needs
  help, the teacher can access the students desktop and give support
- from his computer. The student can watch all activities, the
+ from his computer. The student can watch all activities the
  teacher is doing on his desktop. So the student can learn new processes.
  For teaching something to all students, you can switch into demo-mode
  where all screens of the students show the teacher-screen.
@@ -134,4 +134,4 @@
  Furthermore things like locking student's screens, killing games,
  power on/off clients and much more can be done with iTALC.
  .
- This package provides the necessary library for italc
+ This package provides the needed libraries for iTALC.
--- italc.old/debian/changelog	2013-08-15 10:48:49.746321613 +0200
+++ italc/debian/changelog	2013-08-15 11:50:11.548741974 +0200
@@ -1,3 +1,11 @@
+italc (1:2.0.1-2) UNRELEASED; urgency=low
+
+  * Debconf templates and debian/control reviewed by the debian-l10n-
+    english team as part of the Smith review project. Closes: #719778
+  * [Debconf translation updates]
+
+ -- Christian Perrier <bubulle@debian.org>  Thu, 15 Aug 2013 11:50:11 +0200
+
 italc (1:2.0.1-1) unstable; urgency=low
 
   * New upstream version.
Source: italc
Section: x11
Priority: optional
Maintainer: Debian Edu Packaging Team <debian-edu-pkg-team@lists.alioth.debian.org>
Uploaders:
 Patrick Winnertz <winnie@debian.org>,
 Mike Gabriel <sunweaver@debian.org>,
Build-Depends:
 cdbs,
 dpkg-dev (>= 1.16.1~),
 debhelper (>= 7.0.50~),
 cmake,
 libqt4-dev,
 zlib1g-dev,
 libjpeg-dev,
 imagemagick,
 libpam0g-dev,
 libavahi-client-dev,
 libssl-dev,
 libvncserver-dev (>= 0.9.7),
 libxdamage-dev,
 libxext-dev,
 libxfixes-dev,
 libxss-dev,
 libxtst-dev,
 libxrandr-dev,
 libxinerama-dev,
 libv4l-dev [linux-any],
 gcj-jdk | gcj,
Standards-Version: 3.9.4
Homepage: http://italc.sourceforge.net/home.php
Vcs-Git: git://git.debian.org/debian-edu/italc.git
Vcs-Browser: http://anonscm.debian.org/gitweb/?p=debian-edu/italc.git;a=summary

Package: italc-master
Architecture: any
Pre-Depends:
 dpkg (>= 1.15.6~),
Depends:
 ${shlibs:Depends},
 ${misc:Depends},
 python,
 italc-client,
 libitalccore (=${binary:Version}),
Description: Intelligent Teaching and Learning with Computers - Master
 iTALC makes it possible, to access and influence the students
 activities just from the computer of the teacher. For example, with the
 help of iTALC, the teacher is able to see the
 content of the students screens on his screen. If a student needs
 help, the teacher can access the students desktop and give support
 from his computer. The student can watch all activities the
 teacher is doing on his desktop. So the student can learn new processes.
 For teaching something to all students, you can switch into demo-mode
 where all screens of the students show the teacher-screen.
 Furthermore things like locking student's screens, killing games,
 power on/off clients and much more can be done with iTALC.
 .
 This package contains the software necessary to observe and control iTALC
 clients provided by the italc-client package.

Package: italc-client
Architecture: any
Pre-Depends:
 dpkg (>= 1.15.6~),
Depends:
 ${shlibs:Depends},
 ${misc:Depends},
 adduser,
 libitalccore (=${binary:Version}),
 italc-management-console (=${binary:Version}),
Description: Intelligent Teaching and Learning with Computers - Client
 iTALC makes it possible, to access and influence the students
 activities just from the computer of the teacher. For example, with the
 help of iTALC, the teacher is able to see the
 content of the students screens on his screen. If a student needs
 help, the teacher can access the students desktop and give support
 from his computer. The student can watch all activities the
 teacher is doing on his desktop. So the student can learn new processes.
 For teaching something to all students, you can switch into demo-mode
 where all screens of the students show the teacher-screen.
 Furthermore things like locking student's screens, killing games,
 power on/off clients and much more can be done with iTALC.
 .
 This package contains the client software for iTALC that can be controlled
 using italc-master.

Package: italc-management-console
Architecture: any
Pre-Depends:
 dpkg (>= 1.15.6~),
Depends:
 ${shlibs:Depends},
 ${misc:Depends},
 libitalccore (=${binary:Version}),
Description: Intelligent Teaching and Learning with Computers - Management Console
 iTALC makes it possible, to access and influence the students
 activities just from the computer of the teacher. With the
 help of iTALC, for example the teacher is able to see the
 content of the students screens on his screen. If a student needs
 help, the teacher can access the students desktop and give support
 from his computer. The student can watch all activities, the
 teacher is doing on his desktop. So the student can learn new processes.
 For teaching something to all students, you can switch into demo-mode
 where all screens of the students show the teacher-screen.
 Furthermore things like locking student's screens, killing games,
 power on/off clients and much more can be done with iTALC.
 .
 This package contains the management console for iTALC that helps to configure
 and manage iTALC installations.

Package: libitalccore
Architecture: any
Pre-Depends:
 dpkg (>= 1.15.6~),
Depends:
 ${shlibs:Depends},
 ${misc:Depends},
Provides:
 libitalc,
Breaks:
 libitalc,
Replaces:
 libitalc,
Description: Intelligent Teaching and Learning with Computers - common libraries
 iTALC makes it possible, to access and influence the students
 activities just from the computer of the teacher. With the
 help of iTALC, for example the teacher is able to see the
 content of the students screens on his screen. If a student needs
 help, the teacher can access the students desktop and give support
 from his computer. The student can watch all activities, the
 teacher is doing on his desktop. So the student can learn new processes.
 For teaching something to all students, you can switch into demo-mode
 where all screens of the students show the teacher-screen.
 Furthermore things like locking student's screens, killing games,
 power on/off clients and much more can be done with iTALC.
 .
 This package provides the needed libraries for iTALC.

Attachment: signature.asc
Description: Digital signature


Reply to: