INN commit: trunk (5 files)

Mon Feb 17 18:03:37 UTC 2014

Date: Monday, February 17, 2014 @ 10:03:36
  Author: iulius
Revision: 9604

do not install motd files by default, but only samples

On a fresh INN install, motd.innd and motd.nnrpd are no longer
installed by default.  Instead, samples for these files are provided
in >pathetc>, named differently so that their default contents are
not displayed to news clients before they get customised.

Modified:
  trunk/doc/pod/motd.news.pod
  trunk/doc/pod/news.pod
  trunk/samples/motd.innd
  trunk/samples/motd.nnrpd
  trunk/site/Makefile

-----------------------+
 doc/pod/motd.news.pod |    5 ++++
 doc/pod/news.pod      |    7 +++++
 samples/motd.innd     |   52 ++++++++++++++++++++++++++++++++++++++---
 samples/motd.nnrpd    |   60 ++++++++++++++++++++++++++++++++++++++++++++----
 site/Makefile         |    4 +--
 5 files changed, 118 insertions(+), 10 deletions(-)

Modified: doc/pod/motd.news.pod
===================================================================

--- doc/pod/motd.news.pod	2014-02-17 13:18:21 UTC (rev 9603)
+++ doc/pod/motd.news.pod	2014-02-17 18:03:36 UTC (rev 9604)
@@ -24,6 +24,11 @@
 will just send the client the appropriate response for an unmaintained
 F<motd.innd> or F<motd.nnrpd> file.
 
+On a fresh INN install, samples for these files are installed
+in I<pathec>; you will therefore find in F<motd.innd.sample> and
+F<motd.nnrpd.sample> a few examples of messages that can be communicated
+to news clients.
+
 =head1 HISTORY
 
 Rewritten in POD by Russ Allbery <rra at stanford.edu> for InterNetNews.

Modified: doc/pod/news.pod
===================================================================
--- doc/pod/news.pod	2014-02-17 13:18:21 UTC (rev 9603)
+++ doc/pod/news.pod	2014-02-17 18:03:36 UTC (rev 9604)
@@ -269,6 +269,13 @@
 F<-L/usr/lib> to the linker include flags; unconditionally adding it
 may break the build on systems using lib32 and lib64 directories.
 
+=item *
+
+On a fresh INN install, F<motd.innd> and F<motd.nnrpd> are no longer
+installed by default.  Instead, samples for these files are provided
+in I<pathetc>, named differently so that their default contents are
+not displayed to news clients before they get customised.
+
 =back
 
 =head1 Changes in 2.5.3

Modified: samples/motd.innd
===================================================================
--- samples/motd.innd	2014-02-17 13:18:21 UTC (rev 9603)
+++ samples/motd.innd	2014-02-17 18:03:36 UTC (rev 9604)
@@ -1,5 +1,49 @@
-Sample "message of the day" file.  Any text you put in here will be returned
-to the news feeder when it issues the LIST MOTD command to innd.
+Here are a few suggestions of messages to display to peers feeding news
+articles to the server.
 
-It is not an error if this file does not exist nor if it is empty.  However,
-it must be encoded in UTF-8.
+The contents of this file is displayed in reply to the LIST MOTD command
+from feeders.
+
+Just rename this file to "motd.innd" and adjust its contents to whatever
+message of the day (encoded in UTF-8) you want to communicate.  It is
+not an error if this file does not exist nor if it is empty.
+
+For more information, please have a look at the generic motd.news
+man page.
+
+
+Example 1
+---------
+
+Attention all users,
+
+This server will be down for scheduled upgrades on February 1st.
+It should be back up by 8:00 a.m. February 2nd.
+Any questions should be e-mailed to <newsmaster at example.com>.
+
+Apologies for the disturbance.
+
+
+Example 2
+---------
+
+This news server now carries the comp.* hierarchy.  Feel free to add
+it to the list of hierarchies you feed us.
+
+
+Example 3
+---------
+
+This news server no longer accepts articles whose length exceeds 32
+768 bytes.  Please configure your server not to send us such articles.
+
+
+Example 4
+---------
+
+Starting from February 1st, the IP of this news server will change.
+Note that its host name remains the same.
+
+In case explicit rules based on IP exist at your end (firewall, iptables,
+feed configuration, etc.), please update them to use 10.0.0.1 as the
+IP of our news server.

Modified: samples/motd.nnrpd
===================================================================
--- samples/motd.nnrpd	2014-02-17 13:18:21 UTC (rev 9603)
+++ samples/motd.nnrpd	2014-02-17 18:03:36 UTC (rev 9604)
@@ -1,5 +1,57 @@
-Sample "message of the day" file.  Any text you put in here will be returned
-to the news reader when it issues the LIST MOTD command to nnrpd.
+Here are a few suggestions of messages to display to news readers
+accessing the server.
 
-It is not an error if this file does not exist nor if it is empty.  However,
-it must be encoded in UTF-8.
+The contents of this file is displayed in reply to the LIST MOTD command
+from readers.
+
+Just rename this file to "motd.nnrpd" and adjust its contents to whatever
+message of the day (encoded in UTF-8) you want to communicate.  It is
+not an error if this file does not exist nor if it is empty.
+
+For more information, please have a look at the generic motd.news
+man page.
+
+
+Example 1
+---------
+
+Attention all users,
+
+This server will be down for scheduled upgrades on February 1st.
+It should be back up by 8:00 a.m. February 2nd.
+Any questions should be e-mailed to <newsmaster at example.com>.
+
+Apologies for the disturbance.
+
+
+Example 2
+---------
+
+Dear customers,
+
+We are pleased to announce the creation of a support newsgroup, named
+"our.company.support".  It was created on February 1st and is intended
+to receive your questions about the use of our services.  Our support
+team will usually be responding within a couple of days.
+
+Please use this new newsgroup as the preferable means to contact us.
+
+
+Example 3
+---------
+
+This news server now supports TLS connections.  Please configure your
+news reader to use TLS when connecting or authenticating.  A tutorial
+is available in the "our.company.tutorials" newsgroup to help you do
+the change.  Do not hesitate to ask for help in the "our.company.support"
+newsgroup if you encounter issues during the change.
+
+Starting from February 1st, unencrypted authentications (that is to
+say not using TLS) will be rejected.
+
+
+Example 4
+---------
+
+Support for a new SASL mechanism has been added:  OPENID20 can now be
+used to authenticate.  Feel free to use it!

Modified: site/Makefile
===================================================================
--- site/Makefile	2014-02-17 13:18:21 UTC (rev 9603)
+++ site/Makefile	2014-02-17 18:03:36 UTC (rev 9604)
@@ -40,8 +40,8 @@
 PATH_CTLWATCH		= ${PATHETC}/innwatch.ctl
 PATH_ACTSYNC_IGN	= ${PATHETC}/actsync.ign
 PATH_ACTSYNC_CFG	= ${PATHETC}/actsync.cfg
-PATH_MOTD_INND		= ${PATHETC}/motd.innd
-PATH_MOTD_NNRPD		= ${PATHETC}/motd.nnrpd
+PATH_MOTD_INND		= ${PATHETC}/motd.innd.sample
+PATH_MOTD_NNRPD		= ${PATHETC}/motd.nnrpd.sample
 PATH_STORAGECONF	= ${PATHETC}/storage.conf
 PATH_CYCBUFFCONFIG	= ${PATHETC}/cycbuff.conf
 PATH_INNFEEDCTL		= ${PATHETC}/innfeed.conf

