Re: [RFR] templates://leafnode/{templates}
Mark Brown wrote:
> Christian Perrier wrote:
>> - Whoever is providing you with internet access should provide information about
>> - which server to use to download news. Typically this server is called
>> - something like "news.domain" or "nntp.domain".
>> + The name of the news server should be provided by your Internet
>> + service provider or your organization.
>
> Shouldn't either all or none of ISP be capitalised?
Also clarifying that "your organization" isn't "Dorm-Room LAN", even
though that might well be what /etc/news/organization says:
The name of the news server should be provided by the organization
providing you with network access, such as your Internet Service
Provider.
(Resurrecting a couple of bits that were snipped:)
>> Template: leafnode/tcpd
[...]
>> + If you do not enable some access controls for Leafnode, anybody
>> + will be able to use the news server which opens opportunities
>> + for spam or resource abuse.
>
> s/people everywhere/anybody
I'd revert that one (to emphasise that it's not just "anybody in
your dorm"), and make it:
If you do not enable access controls for Leafnode, people everywhere
will be able to use the news server, which opens opportunities for
spamming or resource abuse.
>> Template: leafnode/network
[...]
>> + Scripts provided with the package support two network connection types:
>> + - permanent: news are downloaded hourly;
>> + - PPP : news are downloaded every time a PPP connection is
>> + established.
News looks plural, but it's unaccountably uncountable.
- permanent: news is downloaded hourly;
- PPP : news is downloaded every time a PPP connection is
established.
Or if we really want to squeeze,
- permanent: hourly news downloads;
- PPP : news downloads triggered by dialouts.
>> Either option will work if you are using diald to manage a PPP connection.
Seems overspecific - couldn't it be just:
Either option will work for a dial-on-demand network connection.
>> Template: leafnode/update-groups
[...]
>> - If you choose to update the list of groups during package set up then
>> + If you choose to update the list of groups,
>> newsgroups will be available to clients as soon as Leafnode has been
>> set up.
>
>> "during package set up" seems obvious
>
> Not quite so obvious as one might hope, unfortunately. The confusion is
> more to do with having the option of never updating than anything else.
It's a pity it had that repetition of "set up", though - the noun
should probably be "setup" anyway. How about:
If you choose to update the list of groups immediately,
(Other maintainer suggestions adopted.)
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- ../leafnode.old/debian/templates 2008-01-27 09:32:06.000000000 +0000
+++ debian/templates 2008-02-02 21:14:13.000000000 +0000
@@ -1,57 +1,62 @@
Template: leafnode/server
Type: string
-_Default: news
+Default: news
_Description: Server to download news from:
- Whoever is providing you with internet access should provide information about
- which server to use to download news. Typically this server is called
- something like "news.domain" or "nntp.domain".
+ The name of the news server should be provided by the organization
+ providing you with network access, such as your Internet Service
+ Provider.
+ .
+ This server is generally called "news.<domain>" or "nntp.<domain>"
+ where <domain> is the local domain name.
Template: leafnode/tcpd
Type: boolean
Default: true
_Description: Enable access controls for Leafnode?
- If you do not enable some access controls for leafnode, people everywhere
- will be able to use your news server for things like posting spam or
- accessing huge binary newsgroups. People actively scan the net for open
- news servers.
- .
- If you do enable access controls, this will prevent any computers except
- localhost from accessing your news server. You can modify /etc/hosts.allow
- later to broaden the access controls if necessary.
+ If you do not enable access controls for Leafnode, people everywhere
+ will be able to use the news server, which opens opportunities for
+ spamming or resource abuse.
+ .
+ Access controls will prevent computers other than the news server
+ itself reading or posting to newsgroups using the server. If required
+ access can be granted to other computers by editing /etc/hosts.allow.
Template: leafnode/network
Type: select
-_Choices: PPP, permanent, none
+#flag:translate!:1
+__Choices: PPP, permanent, none
Default: PPP
-_Description: What type of network connection do you have?
- The Leafnode package can automatically download new news for you. When
- this should be done depends on your network connection. The scripts
- provided with the package support two kinds of network connection: a
- permanent one and one provided by PPP. When set up for PPP the package
- will download news every time a PPP connection is established. With a
- permanent connection news will be downloaded every hour. Either option
- will work if you are using diald to manage a PPP connection.
+_Description: Network connection type:
+ The Leafnode package can automatically download news.
+ .
+ The method used for this depends on the network connection type.
+ Scripts provided with the package support two network connection types:
+ - permanent: news is downloaded hourly;
+ - PPP : news is downloaded every time a PPP connection is
+ established.
+ .
+ Either option will work for a dial-on-demand network connection.
.
- You can also select "none", which will disable automatic downloads. News
- can be downloaded manually by running fetchnews.
+ Choosing 'none' will disable automatic news downloads. News
+ can be downloaded manually by running 'fetchnews'.
Template: leafnode/update-groups
Type: boolean
Default: true
-_Description: Do you wish to update the list of available groups?
- Leafnode keeps the list of available newsgroups up to date when
- it checks for new news. Until it has done so it will not offer any
- newsgroups to clients.
+_Description: Update the list of available groups?
+ Leafnode updates the list of available newsgroups when
+ it checks for new news. No newsgroups will be available until this has
+ happened at least once.
.
- If you choose to update the list of groups during package set up then
+ If you choose to update the list of groups immediately,
newsgroups will be available to clients as soon as Leafnode has been
set up.
Template: leafnode/purge
Type: boolean
Default: false
-_Description: Should /var/spool/news and all its contents be removed?
- /var/spool/news holds the database of news articles downloaded by
- Leafnode. Many other news servers also use this directory to store their
- news database - if you have replaced Leafnode with another server it is
- very likely that you do not want to do this.
+_Description: Remove news groups and articles when purging the package?
+ The directory /var/spool/news holds the database of news articles
+ downloaded by Leafnode. Many other news servers also use this
+ directory to store their news database and you may wish to keep it
+ even when removing the leafnode package.
--- ../leafnode.old/debian/control 2008-01-27 09:32:09.000000000 +0000
+++ debian/control 2008-02-02 21:15:04.000000000 +0000
@@ -11,9 +11,9 @@
Conflicts: news-transport-system, newsx
Depends: openbsd-inetd | inet-superserver, tcpd, logrotate, debconf (>= 0.5) | debconf-2.0, ${shlibs:Depends}
Suggests: slrn | news-reader, perl5, libnet-perl
-Description: NNTP server for small leaf sites
+Description: NNTP server for small sites
Leafnode is a news server suitable for small, limited-bandwidth sites
- with only a few users. Leafnode keeps track of which groups are being
+ with only a few users. It keeps track of which groups are being
read, and downloads only articles in those groups. Leafnode has been
designed to require no maintenance and to be easy to set up.
.
Template: leafnode/server
Type: string
Default: news
_Description: Server to download news from:
The name of the news server should be provided by the organization
providing you with network access, such as your Internet Service
Provider.
.
This server is generally called "news.<domain>" or "nntp.<domain>"
where <domain> is the local domain name.
Template: leafnode/tcpd
Type: boolean
Default: true
_Description: Enable access controls for Leafnode?
If you do not enable access controls for Leafnode, people everywhere
will be able to use the news server, which opens opportunities for
spamming or resource abuse.
.
Access controls will prevent computers other than the news server
itself reading or posting to newsgroups using the server. If required
access can be granted to other computers by editing /etc/hosts.allow.
Template: leafnode/network
Type: select
#flag:translate!:1
__Choices: PPP, permanent, none
Default: PPP
_Description: Network connection type:
The Leafnode package can automatically download news.
.
The method used for this depends on the network connection type.
Scripts provided with the package support two network connection types:
- permanent: news is downloaded hourly;
- PPP : news is downloaded every time a PPP connection is
established.
.
Either option will work for a dial-on-demand network connection.
.
Choosing 'none' will disable automatic news downloads. News
can be downloaded manually by running 'fetchnews'.
Template: leafnode/update-groups
Type: boolean
Default: true
_Description: Update the list of available groups?
Leafnode updates the list of available newsgroups when
it checks for new news. No newsgroups will be available until this has
happened at least once.
.
If you choose to update the list of groups immediately,
newsgroups will be available to clients as soon as Leafnode has been
set up.
Template: leafnode/purge
Type: boolean
Default: false
_Description: Remove news groups and articles when purging the package?
The directory /var/spool/news holds the database of news articles
downloaded by Leafnode. Many other news servers also use this
directory to store their news database and you may wish to keep it
even when removing the leafnode package.
Source: leafnode
Section: news
Priority: extra
Maintainer: Mark Brown <broonie@debian.org>
Standards-Version: 3.7.3
Build-Depends: libpcre3-dev, debhelper (>= 6.0.0)
Package: leafnode
Architecture: any
Provides: news-transport-system
Conflicts: news-transport-system, newsx
Depends: openbsd-inetd | inet-superserver, tcpd, logrotate, debconf (>= 0.5) | debconf-2.0, ${shlibs:Depends}
Suggests: slrn | news-reader, perl5, libnet-perl
Description: NNTP server for small sites
Leafnode is a news server suitable for small, limited-bandwidth sites
with only a few users. It keeps track of which groups are being
read, and downloads only articles in those groups. Leafnode has been
designed to require no maintenance and to be easy to set up.
.
Perl and the libnet-perl package are required to use some optional
features of the package for handling very low volume newsgroups.
Reply to: