.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MOTD.NEWS 5"
.TH MOTD.NEWS 5 2024-02-12 "INN 2.7.2" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
motd.news \- Message of the day information for feeders or readers
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Two files, found in \fIpathetc\fR, contain local information for news feeders or
news readers in a free-form format.  The entire files are returned verbatim
to any client that issues the LIST MOTD command.  This might be used for
new information, notification of upcoming downtime, or similar purposes.
.PP
These files are named \fImotd.innd\fR (for news feeders) and \fImotd.nnrpd\fR
(for news readers); they are used by \fBinnd\fR and \fBnnrpd\fR, respectively.
.PP
Make sure that these files are encoded in UTF\-8.  They should also be
"dot-stuffed", that is to say that a line beginning with a dot should have
that dot doubled.
.PP
Be aware that use of the LIST MOTD command is not widespread (though
documented in RFC\ 6048) and most news clients will never ask for
this file.
.PP
If one or both of these files are missing, it is not an error.  The server
will just send the client the appropriate response for an unmaintained
\&\fImotd.innd\fR or \fImotd.nnrpd\fR file.
.PP
On a fresh INN install, samples for these files are installed
in \fIpathetc\fR; you will therefore find in \fImotd.innd.sample\fR and
\&\fImotd.nnrpd.sample\fR a few examples of messages that can be communicated
to news clients.
.SH HISTORY
.IX Header "HISTORY"
Rewritten in POD by Russ Allbery <eagle@eyrie.org> for InterNetNews.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
inn.conf(5).