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

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



Christian Perrier wrote:
> Your review should be sent as an answer to this mail.

Okay, here we go.  Today's theme is separable verbs: "a setup", "a
login", but "to set (it) up", "to log (yourself) in".

> --- syscp.old/debian/templates	2009-10-08 14:56:57.620805428 +0200
> +++ syscp/debian/templates	2009-10-08 18:36:01.613441007 +0200
[...]
>  _Description: Username for the first admin user:
>   You need to setup an admin user to be able to login to SysCP after
                   ^                                 ^
[...]
> + If you leave this empty, the default "/var/lib/syscp/customers"
> + directory will be sued. Upstream developers, however, use
                      used

And move the "however" (and the "So" in the following sentence) to
conserve commas.
  
> + SysCP also needs cron jobs. They are not installed
> + automatically because they restart the web server which you probably want
> + to keep controlled.         

It's not quite clear what the "which" is referring to there - the
web server or the restarts.

    SysCP also requires cron jobs. These are not installed automatically
    because they cause web server reloads, which you probably want to keep
    controlled.

In the control file:
> +Description: system control panel for LAMP Servers

You missed the one I was sure of:             s

>   SysCP is an easy-to-use system control panel for web and mail servers. It

I think this needs a tweak: I'm running "web and mail servers" on
lots of machines, but I'm not in SysCP's target market.  Maybe "for
ISP web and mail servers"?  "For commercial web- and mail-hosting
servers"?  I've gone with "ISP", but I'm not sure.

>   provides an administration interface to setup customers, assign domains to
>   them and configure those to have web space and mail accounts under regulation
> + of quotas. With SysCP, ISP customers can login and manage their mail
> + accounts, subdomains and other services on their own.

Another set⁁up and log⁁in; and say "regulated by quotas".
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
--- syscp-1.4.2.1.pristine/debian/templates	2009-10-08 07:50:14.000000000 +0100
+++ syscp-1.4.2.1/debian/templates	2009-10-08 19:50:57.000000000 +0100
@@ -9,17 +9,16 @@
 Type: string
 Default: admin
 _Description: Username for the first admin user:
- You need to setup an admin user to be able to login to SysCP after
- installation. You may set a user name now.
+ You need to set up an admin user to be able to log in to SysCP after
+ installation.
  .
- If you leave this field empty, the default username ('admin') will be used.
+ If you leave this field empty, the default username ("admin") will be used.
 
 Template: syscp/admin-password
 Type: password
 Default:
 _Description: Password for the first admin user:
- To secure your new admin user's login you should now set a password for the
- new user.
+ Please choose a password for the new admin user.
  .
  If you leave this field empty, the password will be randomly generated.
  .
@@ -29,24 +28,26 @@
 Type: string
 Default: /var/lib/syscp/customers
 _Description: Directory for customer data:
- SysCP will be configured to save customer data in one location for your
- convenience. Subdirectories will be created for web services ('webs'), mail
- accounts ('mail'), temporary files ('tmp'), and log files ('log').
- .
- The Debian default for this data is '/var/lib/syscp/customers' and will be
- used if the field is left blank. Upstream, however, usually uses
- '/var/customers'. So, if you already have customer data somewhere, e.g. from a
- former installation, or if you want an entirely different directory to hold
- your customer's data, please enter it now.
+ SysCP will be configured to save customer data in one location.
+ Subdirectories will be created for web services ("webs"), mail
+ accounts ("mail"), temporary files ("tmp"), and log files ("log").
+ .
+ If you leave this empty, the default "/var/lib/syscp/customers"
+ directory will be used. However, upstream developers use
+ "/var/customers", so if you already have customer data somewhere, such
+ as data originating from a former installation, or if you want an
+ entirely different directory to hold the customers' data, you can enter
+ the directory path here.
 
 Template: syscp/no-config
 Type: note
 _Description: Daemons not configured
  Please note that, in order to keep your current installation safe, SysCP did
- not reconfigure your mail or ftp server. You need to configure them to use the
- MySQL table provided by SysCP.
+ not reconfigure the mail or FTP servers. They should be configured
+ to use the MySQL table provided by SysCP.
  .
- SysCP furthermore needs cron jobs to run which are also not installed
- automatically as those would reload your web server unexpectedly.
+ SysCP also requires cron jobs. These are not installed automatically
+ because they cause web server reloads, which you probably want to keep
+ controlled.
  .
- Find some example configurations at /usr/share/doc/syscp/examples.
+ Some example configurations may be found in /usr/share/doc/syscp/examples.
--- syscp-1.4.2.1.pristine/debian/control	2009-10-08 07:50:14.000000000 +0100
+++ syscp-1.4.2.1/debian/control	2009-10-08 20:02:04.000000000 +0100
@@ -17,12 +17,12 @@
  proftpd-mod-mysql, mysql-client
 Suggests: bind9, maildrop, courier-authlib-mysql
 Conflicts: syscp (< 1.4.2.1-1)
-Description: System Control Panel for LAMP Servers
- SysCP is an easy-to-use system control panel for web and mail servers. It
- provides an administration interface to setup customers, assign domains to
- them and configure those to have web space and mail accounts under regulation
- of quotas. At the same time customers can login and manage their mail
- accounts, subdomains etc. on their own.
+Description: system control panel for LAMP Servers
+ SysCP is an easy-to-use system control panel for ISP web and mail servers. It
+ provides an administration interface to set up customers, assign domains to
+ them and configure those to have web space and mail accounts regulated by
+ quotas. With SysCP, ISP customers can log in and manage their mail
+ accounts, subdomains and other services on their own.
  .
- SysCP supports apache2, lighttpd, proftpd, postfix, courier, dovecot, MySQL
- and other common daemons an internet service provider would need.
+ SysCP supports Apache 2, lighttpd, ProFTPd, Postfix, Courier, Dovecot, MySQL
+ and other common daemons an Internet service provider would need.
Template: syscp/reconfigure-webserver
Type: multiselect
Choices: apache2, lighttpd
_Description: Web server to reconfigure automatically:
 Please choose the web server that should be automatically configured
 to run SysCP.

Template: syscp/admin-username
Type: string
Default: admin
_Description: Username for the first admin user:
 You need to set up an admin user to be able to log in to SysCP after
 installation.
 .
 If you leave this field empty, the default username ("admin") will be used.

Template: syscp/admin-password
Type: password
Default:
_Description: Password for the first admin user:
 Please choose a password for the new admin user.
 .
 If you leave this field empty, the password will be randomly generated.
 .
 The user name and password will be stored in /etc/syscp/debian.php.

Template: syscp/customer-dir
Type: string
Default: /var/lib/syscp/customers
_Description: Directory for customer data:
 SysCP will be configured to save customer data in one location.
 Subdirectories will be created for web services ("webs"), mail
 accounts ("mail"), temporary files ("tmp"), and log files ("log").
 .
 If you leave this empty, the default "/var/lib/syscp/customers"
 directory will be used. However, upstream developers use
 "/var/customers", so if you already have customer data somewhere, such
 as data originating from a former installation, or if you want an
 entirely different directory to hold the customers' data, you can enter
 the directory path here.

Template: syscp/no-config
Type: note
_Description: Daemons not configured
 Please note that, in order to keep your current installation safe, SysCP did
 not reconfigure the mail or FTP servers. They should be configured
 to use the MySQL table provided by SysCP.
 .
 SysCP also requires cron jobs. These are not installed automatically
 because they cause web server reloads, which you probably want to keep
 controlled.
 .
 Some example configurations may be found in /usr/share/doc/syscp/examples.
Source: syscp
Section: admin
Priority: extra
Maintainer: Jan Hauke Rahm <jhr@debian.org>
Build-Depends: debhelper (>= 7.0.50), quilt (>= 0.46-7)
Build-Depends-Indep: po-debconf
Standards-Version: 3.8.3
Homepage: http://www.syscp.org

Package: syscp
Architecture: all
Depends: apache2 | lighttpd, php5-cli, php5-mysql, mysql-server, webalizer,
 dbconfig-common, libphp-phpmailer, php-fpdf, ${misc:Depends}
Recommends: postfix, postfix-mysql, libsasl2-2, libsasl2-modules,
 libsasl2-modules-sql, courier-pop | dovecot-pop3d, courier-imap |
 dovecot-imapd, php5-gd, php5-suhosin, php5-imap, proftpd-basic,
 proftpd-mod-mysql, mysql-client
Suggests: bind9, maildrop, courier-authlib-mysql
Conflicts: syscp (< 1.4.2.1-1)
Description: system control panel for LAMP Servers
 SysCP is an easy-to-use system control panel for ISP web and mail servers. It
 provides an administration interface to set up customers, assign domains to
 them and configure those to have web space and mail accounts regulated by
 quotas. With SysCP, ISP customers can log in and manage their mail
 accounts, subdomains and other services on their own.
 .
 SysCP supports Apache 2, lighttpd, ProFTPd, Postfix, Courier, Dovecot, MySQL
 and other common daemons an Internet service provider would need.

Reply to: