Package: webfs
Version: N/A
Severity: normal
Tags: patch

Dear Debian maintainer,

On Saturday, February 20, 2010, I notified you of the beginning of a review 
process
concerning debconf templates for webfs.

The debian-l10n-english contributors have now reviewed these templates,
and the proposed changes are attached to this bug report.

Please review the suggested changes, and if you have any
objections, let me know in the next 3 days.

However, please try to avoid uploading webfs with these changes
right now.

The second phase of this process will begin on Monday, March 08, 2010, when I 
will
coordinate updates to translations of debconf templates.

The existing translators will be notified of the changes: they will
receive an updated PO file for their language.

Simultaneously, a general call for new translations will be sent to
the debian-i18n mailing list.

Both these calls for translations will request updates to be sent as
individual bug reports. That will probably trigger a lot of bug
reports against your package, but these should be easier to deal with.

The call for translation updates and new translations will run until
about Monday, March 29, 2010. Please avoid uploading a package with fixed or 
changed
debconf templates and/or translation updates in the meantime. Of
course, other changes are safe.

Please note that this is an approximative delay, which depends on my
own availability to process this work and is influenced by the fact
that I simultaneously work on many packages.

Around Tuesday, March 30, 2010, I will contact you again and will send a final 
patch
summarizing all the updates (changes to debconf templates,
updates to debconf translations and new debconf translations).

Again, thanks for your attention and cooperation.


-- System Information:
Debian Release: squeeze/sid
Architecture: i386 (i686)

Kernel: Linux 2.6.32-2-686 (SMP w/2 CPU cores)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/dash
--- webfs.old/debian/templates  2010-01-29 10:53:29.000000000 +0100
+++ webfs/debian/templates      2010-03-05 07:46:41.443312214 +0100
@@ -1,14 +1,23 @@
+# These templates have been reviewed by the debian-l10n-english
+# team
+#
+# If modifications/additions/rewording are needed, please ask
+# debian-l10n-engl...@lists.debian.org for advice.
+#
+# Even minor modifications require translation updates and such
+# changes should be coordinated with translators and reviewers.
+
 Template: webfsd/web_ip
 Type: string
-_Description: IP address webfsd should listen on:
- If your box has more than one IP address, you can pick one here for webfsd.
- Leaving this field blank will allow webfsd to listen on all IP addresses.
+_Description: IP address 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:
- The default timeout is 60 seconds.  You can pick another value here if you
- want.
 
 Template: webfsd/pending
 Type: string
@@ -18,51 +27,48 @@
 Template: webfsd/web_conn
 Type: string
 _Description: Number of parallel network connections:
- By default, webfsd allows 32 network connections. For private/small
- networks, the default should be fine. If you are running a big server, you
- probably want to use a higher number.
+ 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:
- webfsd can keep cached directory listings.  By default, the size of
- the cache is limited to 128 entries.  If you have a very big
- directory tree, you might want to raise this value.
+ 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: Port number webfsd should listen on:
- By default, webfsd listens on port 8000.  If you want to use another port, 
enter
- it here.
+_Description: Incoming port number for webfsd:
+ Please enter the port number for webfsd to listen to. If you leave
+ this blank, the default port (8000) will be used.
 
 Template: webfsd/web_virtual
 Type: boolean
 Default: false
-_Description: Should virtual host support be enabled?
- Please choose this option if you want webfsd support name-based
- virtual hosts.  The first directory level below your document root
- will then be used as hostname.
+_Description: Enable virtual hosts?
+ This option allows webfsd to support name-based virtual hosts, taking
+ the directories immediately below the document root as host names.
 
 Template: webfsd/web_root
 Type: string
-Default: /var/ftp
+Default: /srv/ftp
 _Description: Document root for webfsd:
- webfsd is a lightweight HTTP server which only serves static files.  You
- can use it for example to provide HTTP access to your anonymous FTP
- server.
+ Webfsd is a lightweight HTTP server for mostly static content. Its
+ most obvious use is to provide HTTP access to an anonymous FTP server.
  .
- You need to specify the document root for the webfs daemon, i.e. the
- directory tree which will be exported.
+ Please specify the document root for the webfs daemon.
  .
- Leave this blank if you don't want webfsd started by the system at boot time.
+ 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:
- webfsd will use the machine's hostname by default. If this box has an alias
- name (like ftp.domain.org) which should be visible outside instead of the
- real hostname (say debian.domain.org), then enter this name here.
- Otherwise you can leave this blank.
+ By default, webfsd uses the machine name as host name.
+ .
+ You can specify an alternate host name 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
@@ -72,20 +78,22 @@
 Template: webfsd/web_syslog
 Type: boolean
 Default: false
-_Description: Should webfsd log events (start/stop/...) to syslog?
+_Description: Log webfsd events (start, stop, etc.) to syslog?
 
 Template: webfsd/web_accesslog
 Type: string
 _Description: Access log file:
- webfsd can write an access log in common log format. If you want this,
- enter the log file name here.  By default, no logfile will be written.
+ 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 registered as client calls.
+ as they are accepted as client calls.
 
 Template: webfsd/web_group
 Type: string
@@ -96,22 +104,28 @@
 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 want this, enter the filename here.  If you leave it
- blank or no such file exists, webfsd will send a directory listing to the
+ index file to be sent 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:
- If webfsd shall be able to deliver output from CGI functions, their
- location must be declared. The path must begin immediately below
- the document root and be specified with an initial slash. An empty
- path disables this feature.
+ 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, 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:
- Webfsd has further capacities that were not mentioned above, such as
- chrooted service, timed expiration of files, and locked binding to
- either IPv6 or IPv4. Consult the manual page and add any extras here.
+ Please specify any webfsd options you want to use with 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.
--- webfs.old/debian/control    2010-02-03 21:27:50.000000000 +0100
+++ webfs/debian/control        2010-02-25 07:23:56.821238387 +0100
@@ -10,10 +10,10 @@
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, debconf | debconf-2.0
 Provides: httpd
-Description: lightweight http server for static content
- This is a simple http server for mostly static content.  You
- can use it to serve the content of a ftp server via http for
- example.  It is also nice to export some files the quick way
- by starting a http server in a few seconds, without editing
- some config file first.  Limited cgi support (GET requests
- only) has been added recently.
+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.

Reply via email to