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

[RFR] templates://freepops/{freepops.templates}



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

This review will last from Thursday, April 12, 2007 to Sunday, April 22, 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 for changes:

--- ../freepops.old/debian/freepops.templates	2007-04-09 14:36:35.764680454 +0200
+++ debian/freepops.templates	2007-04-12 12:22:21.610394628 +0200
@@ -1,29 +1,34 @@
 Template: freepops/init
 Type: boolean
 _Description: Start freepopsd automatically after each boot?
- The FreePOPs daemon can be started automatically after each boot for you.
- By default it will bind on port 2000, but you can change this behaviour
- editing /etc/default/freepops
+ The FreePOPs daemon can be started automatically after each boot.
+ By default, it will bind to port 2000. This setting may be changed by
+ editing the /etc/default/freepops file.

"for you" is useless and implies the idea that the computer is a
person

Rewording the second sentence to just give facts and


 
 Template: freepops/jail
 Type: boolean
 Default: false
 _Description: Create a chroot jail for freepops?
- FreePOPs can be launched in a chrooted environment to improve security.
- The jail will be created in /var/lib/freepops/chroot-jail/. This will also
- create a start.sh script in the root of the jail that should be used to
- launch freepopsd. This is perfectly integrated with the init script, so
- you have to change nothing to automatically start freepopsd at boot. This
- feature is mostly untested, you are warned.
+ FreePOPs can be launched in a chrooted environment to improve the
+ system's security.
+ .
+ The jail will be created in /var/lib/freepops/chroot-jail/.
+ The regular init script will then take care of launching the daemon
+ by calling a script named start.sh atthe root of the chroot jail.

Split in two paragraphs for readability.

Explain what security is improved..:-)

Shorter and (hopefully) clearer explanation.

No need to mention that the feature is experimental. This pertains to
README.Debian and you'll forget to remove this when the feature will
no longer be experimental...:)...or if you remove it, you'll make
translators unhappy.


 
 Template: freepops/updates
 Type: boolean
 Default: true
 _Description: Remove local updates on upgrade?
- freepops-updater-fltk or freepops-updater-dialog can install local updates in 
- /var/lib/freepops/lua_updates. These updates are usually integrated in the next
- freepops release or can be downloaded again running the updater, so they can be safely removed. 
- Modules placed in /var/lib/freepops/lua_updates have higher priority than the
- ones in /usr/share/frepops/lua; if you don't remove them you may end up running outdated
- modules. Anyway the system administrator may use this mechanism to freeze some local 
- modifications with respect to FreePOPs updates.
+ The freepops-updater-fltk or freepops-updater-dialog utilities will
+ install local updates in /var/lib/freepops/lua_updates.
+ .
+ Such updates are usually integrated in further FreePOPs releases or
+ can be downloaded again running the updater. Therefore, they
+ may safely be removed when the package is upgraded.
+ .
+ The modules saved in /var/lib/freepops/lua_updates have a higher
+ priority than those from /usr/share/frepops/lua. It is thus
+ recommended to remove them in order to avoid using outdated modules,
+ unless you intend to freeze the local modifications regardless of
+ FreePOPs updates.

Split in paragraphs for readability.

Rewording to avoid "spoken" language.

Use "FreePOPs" consistently


--- ../freepops.old/debian/control	2007-04-09 14:36:35.764680454 +0200
+++ debian/control	2007-04-12 12:25:05.151731630 +0200
@@ -10,24 +10,24 @@
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0 , lsb-base (>= 3.0-6)
 Suggests: dialog
-Description: POP3 interface to several webmails
- freepopsd is a POP3 daemon that translates local POP3 commands
+Description: POP3 interface to several webmail software
+ FreePOPs is a POP3 daemon that translates local POP3 commands
  to remote HTTP requests to the supported webmail sites.
  .
- freepopsd can also be used as RSS aggregator and POP3 forwarder.
+ FreePOPs can also be used as RSS aggregator and POP3 forwarder.
  .
- This package also includes a dialog based updater program, to check for updates
- and eventually download them. 
+ This package also includes a dialog based updater program, to check
+ for updates and eventually download them.

Consistent spelling of FreePOPs. Using the software name and not the
daemon name allows to use a capital letter at the beginning of sentences

 
 Package: freepops-doc
 Section: doc
 Architecture: all
 Depends: 
-Description: freepops user/developer manual
- freepopsd is a POP3 daemon that translates local POP3 commands
+Description: FreePOPs user/developer manual
+ FreePOPs is a POP3 daemon that translates local POP3 commands
  to remote HTTP requests to the supported webmail sites.
  .
- freepopsd can also be used as RSS aggregator and POP3 forwarder.
+ FreePOPs can also be used as RSS aggregator and POP3 forwarder.
  .
- This is the manual in PDF format for freepops.
+ This package includes the PDF manual for the software.
  


-- 


Template: freepops/init
Type: boolean
_Description: Start freepopsd automatically after each boot?
 The FreePOPs daemon can be started automatically after each boot.
 By default, it will bind to port 2000. This setting may be changed by
 editing the /etc/default/freepops file.

Template: freepops/jail
Type: boolean
Default: false
_Description: Create a chroot jail for freepops?
 FreePOPs can be launched in a chrooted environment to improve the
 system's security.
 .
 The jail will be created in /var/lib/freepops/chroot-jail/.
 The regular init script will then take care of launching the daemon
 by calling a script named start.sh atthe root of the chroot jail.

Template: freepops/updates
Type: boolean
Default: true
_Description: Remove local updates on upgrade?
 The freepops-updater-fltk or freepops-updater-dialog utilities will
 install local updates in /var/lib/freepops/lua_updates.
 .
 Such updates are usually integrated in further FreePOPs releases or
 can be downloaded again running the updater. Therefore, they
 may safely be removed when the package is upgraded.
 .
 The modules saved in /var/lib/freepops/lua_updates have a higher
 priority than those from /usr/share/frepops/lua. It is thus
 recommended to remove them in order to avoid using outdated modules,
 unless you intend to freeze the local modifications regardless of
 FreePOPs updates.
--- ../freepops.old/debian/freepops.templates	2007-04-09 14:36:35.764680454 +0200
+++ debian/freepops.templates	2007-04-12 12:22:21.610394628 +0200
@@ -1,29 +1,34 @@
 Template: freepops/init
 Type: boolean
 _Description: Start freepopsd automatically after each boot?
- The FreePOPs daemon can be started automatically after each boot for you.
- By default it will bind on port 2000, but you can change this behaviour
- editing /etc/default/freepops
+ The FreePOPs daemon can be started automatically after each boot.
+ By default, it will bind to port 2000. This setting may be changed by
+ editing the /etc/default/freepops file.
 
 Template: freepops/jail
 Type: boolean
 Default: false
 _Description: Create a chroot jail for freepops?
- FreePOPs can be launched in a chrooted environment to improve security.
- The jail will be created in /var/lib/freepops/chroot-jail/. This will also
- create a start.sh script in the root of the jail that should be used to
- launch freepopsd. This is perfectly integrated with the init script, so
- you have to change nothing to automatically start freepopsd at boot. This
- feature is mostly untested, you are warned.
+ FreePOPs can be launched in a chrooted environment to improve the
+ system's security.
+ .
+ The jail will be created in /var/lib/freepops/chroot-jail/.
+ The regular init script will then take care of launching the daemon
+ by calling a script named start.sh atthe root of the chroot jail.
 
 Template: freepops/updates
 Type: boolean
 Default: true
 _Description: Remove local updates on upgrade?
- freepops-updater-fltk or freepops-updater-dialog can install local updates in 
- /var/lib/freepops/lua_updates. These updates are usually integrated in the next
- freepops release or can be downloaded again running the updater, so they can be safely removed. 
- Modules placed in /var/lib/freepops/lua_updates have higher priority than the
- ones in /usr/share/frepops/lua; if you don't remove them you may end up running outdated
- modules. Anyway the system administrator may use this mechanism to freeze some local 
- modifications with respect to FreePOPs updates.
+ The freepops-updater-fltk or freepops-updater-dialog utilities will
+ install local updates in /var/lib/freepops/lua_updates.
+ .
+ Such updates are usually integrated in further FreePOPs releases or
+ can be downloaded again running the updater. Therefore, they
+ may safely be removed when the package is upgraded.
+ .
+ The modules saved in /var/lib/freepops/lua_updates have a higher
+ priority than those from /usr/share/frepops/lua. It is thus
+ recommended to remove them in order to avoid using outdated modules,
+ unless you intend to freeze the local modifications regardless of
+ FreePOPs updates.
--- ../freepops.old/debian/control	2007-04-09 14:36:35.764680454 +0200
+++ debian/control	2007-04-12 12:25:05.151731630 +0200
@@ -10,24 +10,24 @@
 Architecture: any
 Depends: ${shlibs:Depends}, debconf | debconf-2.0 , lsb-base (>= 3.0-6)
 Suggests: dialog
-Description: POP3 interface to several webmails
- freepopsd is a POP3 daemon that translates local POP3 commands
+Description: POP3 interface to several webmail software
+ FreePOPs is a POP3 daemon that translates local POP3 commands
  to remote HTTP requests to the supported webmail sites.
  .
- freepopsd can also be used as RSS aggregator and POP3 forwarder.
+ FreePOPs can also be used as RSS aggregator and POP3 forwarder.
  .
- This package also includes a dialog based updater program, to check for updates
- and eventually download them. 
+ This package also includes a dialog based updater program, to check
+ for updates and eventually download them.
 
 Package: freepops-doc
 Section: doc
 Architecture: all
 Depends: 
-Description: freepops user/developer manual
- freepopsd is a POP3 daemon that translates local POP3 commands
+Description: FreePOPs user/developer manual
+ FreePOPs is a POP3 daemon that translates local POP3 commands
  to remote HTTP requests to the supported webmail sites.
  .
- freepopsd can also be used as RSS aggregator and POP3 forwarder.
+ FreePOPs can also be used as RSS aggregator and POP3 forwarder.
  .
- This is the manual in PDF format for freepops.
+ This package includes the PDF manual for the software.
  
Source: freepops
Section: mail
Priority: optional
Maintainer: Enrico Tassi <gareuselesinge@debian.org>
Build-Depends: debhelper (>= 4.1.16), libexpat1-dev, libcurl3-gnutls-dev (>= 7.15.0-2), flex, bison, po-debconf, liblua5.1-filesystem-dev, liblua5.1-expat-dev, liblua5.1-curl-dev, liblua5.1-dev
Build-Depends-Indep: tetex-extra, gs-common
Standards-Version: 3.7.2

Package: freepops
Architecture: any
Depends: ${shlibs:Depends}, debconf | debconf-2.0 , lsb-base (>= 3.0-6)
Suggests: dialog
Description: POP3 interface to several webmail software
 FreePOPs is a POP3 daemon that translates local POP3 commands
 to remote HTTP requests to the supported webmail sites.
 .
 FreePOPs can also be used as RSS aggregator and POP3 forwarder.
 .
 This package also includes a dialog based updater program, to check
 for updates and eventually download them.

Package: freepops-doc
Section: doc
Architecture: all
Depends: 
Description: FreePOPs user/developer manual
 FreePOPs is a POP3 daemon that translates local POP3 commands
 to remote HTTP requests to the supported webmail sites.
 .
 FreePOPs can also be used as RSS aggregator and POP3 forwarder.
 .
 This package includes the PDF manual for the software.
 

Attachment: signature.asc
Description: Digital signature


Reply to: