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

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



Hello,

I accept the suggestion for the control file as it stands.

For the template there are still issues present.


--- templates.jbr
+++ templates
@@ -1,10 +1,10 @@
 Template: webfsd/web_ip
 Type: string
-_Description: IP address webfsd should listen to:
+_Description: IP address which webfsd should listen to:
  On a system with multiple IP addresses, webfsd can be configured to
  listen to only one of them.
  .
- If you leave this empty, webfsd will listen on all IP addresses.
+ If you leave this empty, webfsd will listen to all IP addresses.
 
Phrasing 'listen to' must be consistent. I miss a relative pronoun.


 Template: webfsd/web_timeout
 Type: string
@@ -31,17 +31,18 @@
 Template: webfsd/web_port
 Type: string
 _Description: Incoming port number for webfsd:
+ Default listening port is 8000.
 
I find explicit mention of default value to be essential here.


 Template: webfsd/web_virtual
 Type: boolean
 Default: false
-_Description: Enable virtual host?
+_Description: Enable virtual hosts?
  This option allows webfsd to support name-based virtual hosts, taking
  the directories immediately below the document root as hostnames.
 
Plural!


 Template: webfsd/web_root
 Type: string
-Default: /var/ftp
+Default: /home/ftp
 _Description: Document root for webfsd:
  Webfsd is a lightweight HTTP server for mostly static content. Its
  most obvious use is to provide HTTP access to an anonymous FTP server.
@@ -55,7 +56,7 @@
 _Description: Host name for webfsd:
  By default, webfsd uses the machine name as hostname.
  .
- You can specify an alternate host name to be used as an external
+ You can specify an alternate hostname to be used as an external
  alias name (for instance "ftp.example.org") instead of the machine's
  fully qualified domain name.
 
Consistency in writing 'hostname'.


@@ -67,14 +68,14 @@
 Template: webfsd/web_syslog
 Type: boolean
 Default: false
-_Description: Log webfsd events (start/stop/...) to syslog?
+_Description: Log webfsd events (start, stop, ...) to syslog?
 
The slashes are legacy text not to my liking.


 Template: webfsd/web_accesslog
 Type: string
 _Description: Access log file:
- Access to webfsd can be logged in common log format.
+ Access to webfsd is logged in common log format.
  .
- If this field is left empty, no logging of incomming connections will
+ If this field is left empty, no logging of incoming connections will
  be done.
 
Change of modus. Spelling.

 Template: webfsd/web_logbuffering
@@ -82,7 +83,7 @@
 Default: true
 _Description: Should logging be buffered?
  With buffered logging, entries will be written in chunks, not as soon
- as they are registered as client calls.
+ as they are accepted as client calls.
 
Change of aspect.


 Template: webfsd/web_group
 Type: string
@@ -102,20 +103,19 @@
 Template: webfsd/web_cgipath
 Type: string
 _Description: CGI script catalog:
- Please specify the location for CGI scripts served by webfsd. This
- path should be located immediately below
- the document root.
+ Please specify the location for CGI scripts to be served by webfsd.
+ This path should be located immediately below the document root.
  .
- Please specify the full path name and not a relative path. If this
+ Please specify the full path name, and not a relative path. If this
  field is left empty, CGI scripts will be disabled.
 
Semantically it seems the comma is to be preferred.

As an experienced TeX and LaTeX user, I am conscious of the notion of
French spacing. The continental Western European and Northern European
languages are using a single space after a full period, whereas the
North American habit, as well as the the Anglosaxon habit, as far as I
understand, is to use double spacing after a full stop. Anyone can
observe the same thing in most manual pages, as well as in the kernel
documentation. The present template file displays a handful instances
of this single spacing, as displayed above. I need advice on how to
implement this in any template file.


 Template: webfsd/web_extras
 Type: string
 _Description: Extra options to include:
- Please specify any webfsd option you want to use with the main
+ Please specify any webfsd options you want to use for the main
  daemon.
  .
  For instance, webfsd can run chrooted, provide timed expiration of
  files, and bind either IPv4 or IPv6 addresses.
  .
- See webfsd's manual page for details.
+ See webfsd's manual page for further options and details.

Plural and slight expansion, respectively.


Regards,
-- 
Mats Erik Andersson, fil. dr
<mats.andersson@gisladisker.se>

Abbonerar på: debian-mentors, debian-devel-games, debian-perl, debian-ipv6
Source: webfs
Section: httpd
Priority: optional
Build-Depends: debhelper (>= 7), po-debconf
Maintainer: Mats Erik Andersson <mats.andersson@gisladisker.se>
Standards-Version: 3.8.4
Homepage: http://linux.bytesex.org/misc/webfs.html

Package: webfs
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debconf | debconf-2.0
Provides: httpd
Description: lightweight HTTP server for static content
 This package provides a simple web server for mostly static content,
 with limited CGI support (GET requests only).
 .
 Example uses include giving HTTP access to the contents of an FTP
 site, or exporting some files by quickly starting a web server
 without any need to edit configuration files first.
--- templates.jbr	2010-03-02 00:23:27.000000000 +0100
+++ templates	2010-03-02 00:58:49.000000000 +0100
@@ -1,10 +1,10 @@
 Template: webfsd/web_ip
 Type: string
-_Description: IP address webfsd should listen to:
+_Description: IP address which webfsd should listen to:
  On a system with multiple IP addresses, webfsd can be configured to
  listen to only one of them.
  .
- If you leave this empty, webfsd will listen on all IP addresses.
+ If you leave this empty, webfsd will listen to all IP addresses.
 
 Template: webfsd/web_timeout
 Type: string
@@ -31,17 +31,18 @@
 Template: webfsd/web_port
 Type: string
 _Description: Incoming port number for webfsd:
+ Default listening port is 8000.
 
 Template: webfsd/web_virtual
 Type: boolean
 Default: false
-_Description: Enable virtual host?
+_Description: Enable virtual hosts?
  This option allows webfsd to support name-based virtual hosts, taking
  the directories immediately below the document root as hostnames.
 
 Template: webfsd/web_root
 Type: string
-Default: /var/ftp
+Default: /home/ftp
 _Description: Document root for webfsd:
  Webfsd is a lightweight HTTP server for mostly static content. Its
  most obvious use is to provide HTTP access to an anonymous FTP server.
@@ -55,7 +56,7 @@
 _Description: Host name for webfsd:
  By default, webfsd uses the machine name as hostname.
  .
- You can specify an alternate host name to be used as an external
+ You can specify an alternate hostname to be used as an external
  alias name (for instance "ftp.example.org") instead of the machine's
  fully qualified domain name.
 
@@ -67,14 +68,14 @@
 Template: webfsd/web_syslog
 Type: boolean
 Default: false
-_Description: Log webfsd events (start/stop/...) to syslog?
+_Description: Log webfsd events (start, stop, ...) to syslog?
 
 Template: webfsd/web_accesslog
 Type: string
 _Description: Access log file:
- Access to webfsd can be logged in common log format.
+ Access to webfsd is logged in common log format.
  .
- If this field is left empty, no logging of incomming connections will
+ If this field is left empty, no logging of incoming connections will
  be done.
 
 Template: webfsd/web_logbuffering
@@ -82,7 +83,7 @@
 Default: true
 _Description: Should logging be buffered?
  With buffered logging, entries will be written in chunks, not as soon
- as they are registered as client calls.
+ as they are accepted as client calls.
 
 Template: webfsd/web_group
 Type: string
@@ -102,20 +103,19 @@
 Template: webfsd/web_cgipath
 Type: string
 _Description: CGI script catalog:
- Please specify the location for CGI scripts served by webfsd. This
- path should be located immediately below
- the document root.
+ Please specify the location for CGI scripts to be served by webfsd.
+ This path should be located immediately below the document root.
  .
- Please specify the full path name and not a relative path. If this
+ Please specify the full path name, and not a relative path. If this
  field is left empty, CGI scripts will be disabled.
 
 Template: webfsd/web_extras
 Type: string
 _Description: Extra options to include:
- Please specify any webfsd option you want to use with the main
+ Please specify any webfsd options you want to use for the main
  daemon.
  .
  For instance, webfsd can run chrooted, provide timed expiration of
  files, and bind either IPv4 or IPv6 addresses.
  .
- See webfsd's manual page for details.
+ See webfsd's manual page for further options and details.
Template: webfsd/web_ip
Type: string
_Description: IP address which webfsd should listen to:
 On a system with multiple IP addresses, webfsd can be configured to
 listen to only one of them.
 .
 If you leave this empty, webfsd will listen to all IP addresses.

Template: webfsd/web_timeout
Type: string
_Description: Timeout for network connections:

Template: webfsd/pending
Type: string
Default: no
Description: for internal use only

Template: webfsd/web_conn
Type: string
_Description: Number of parallel network connections:
 For small private networks, the default number of parallel network
 connections should be fine. This can be increased for larger networks.

Template: webfsd/web_dircache
Type: string
_Description: Directory cache size:
 Directory listings can be cached by webfsd. By default, the size of
 the cache is limited to 128 entries. If the web server has
 very big directory trees, you might want to raise this value.

Template: webfsd/web_port
Type: string
_Description: Incoming port number for webfsd:
 Default listening port is 8000.

Template: webfsd/web_virtual
Type: boolean
Default: false
_Description: Enable virtual hosts?
 This option allows webfsd to support name-based virtual hosts, taking
 the directories immediately below the document root as hostnames.

Template: webfsd/web_root
Type: string
Default: /home/ftp
_Description: Document root for webfsd:
 Webfsd is a lightweight HTTP server for mostly static content. Its
 most obvious use is to provide HTTP access to an anonymous FTP server.
 .
 Please specify the document root for the webfs daemon.
 .
 If you leave this field blank, webfsd will not be started at boot time.

Template: webfsd/web_host
Type: string
_Description: Host name for webfsd:
 By default, webfsd uses the machine name as hostname.
 .
 You can specify an alternate hostname to be used as an external
 alias name (for instance "ftp.example.org") instead of the machine's
 fully qualified domain name.

Template: webfsd/web_user
Type: string
Default: www-data
_Description: User running the webfsd daemon:

Template: webfsd/web_syslog
Type: boolean
Default: false
_Description: Log webfsd events (start, stop, ...) to syslog?

Template: webfsd/web_accesslog
Type: string
_Description: Access log file:
 Access to webfsd is logged in common log format.
 .
 If this field is left empty, no logging of incoming connections will
 be done.

Template: webfsd/web_logbuffering
Type: boolean
Default: true
_Description: Should logging be buffered?
 With buffered logging, entries will be written in chunks, not as soon
 as they are accepted as client calls.

Template: webfsd/web_group
Type: string
Default: www-data
_Description: Group running the webfsd daemon:

Template: webfsd/web_index
Type: string
_Description: Directory index filename:
 If webfsd receives a request for a directory, it can optionally look for an
 index file it should send to the client. Common names are "index.html" and
 "default.html".
 .
 If you leave this field empty, webfsd will send a directory listing to the
 client.

Template: webfsd/web_cgipath
Type: string
_Description: CGI script catalog:
 Please specify the location for CGI scripts to be served by webfsd.
 This path should be located immediately below the document root.
 .
 Please specify the full path name, and not a relative path. If this
 field is left empty, CGI scripts will be disabled.

Template: webfsd/web_extras
Type: string
_Description: Extra options to include:
 Please specify any webfsd options you want to use for the main
 daemon.
 .
 For instance, webfsd can run chrooted, provide timed expiration of
 files, and bind either IPv4 or IPv6 addresses.
 .
 See webfsd's manual page for further options and details.

Attachment: signature.asc
Description: Digital signature


Reply to: