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

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



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

I agree with your rationales, but I've got a couple of further
patches to suggest including some corrections to your corrections.

> Template: freepops/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.

Typo ----------------------------------^

> Template: freepops/updates
>  Such updates are usually integrated in further FreePOPs releases or
>  can be downloaded again running the updater. Therefore, they

Missing word (you caught the first case of this): _by_ running.

> -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.

"Several webmails" is wrong, but so is plural "softwares"; "webmail
sites" is okay, though, and I revommend using it in the short
description too.

> - 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.

"Eventually" is a false friend; here I'd go for "optionally".

Diff to originals and modified versions attached.
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
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 at the 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 by 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.
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 sites
 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 optionally 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.
 
--- templates.orig	2007-04-12 14:26:22.000000000 +0100
+++ templates.jbr	2007-04-12 14:27:01.000000000 +0100
@@ -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 at the 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 by 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.
--- control.orig	2007-04-12 14:36:03.000000000 +0100
+++ control.jbr	2007-04-12 13:15:34.000000000 +0100
@@ -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 sites
+ 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 optionally 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.
  

Reply to: