view docs/inews.1 @ 494:372f8b55506e noffle

[svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', which optionally postpones adding a message ID to the upstream server. If this is done, post-locally must be off. This is to deal with an upstream server troubling Jan. It usually (but not always) rejects posts with a Noffle message ID. I have changed Jan's original option of 'add-message-id-if-missing' for consistency with 'replace-messageid' and added the manual page entry. See SourceForge feature request 1513395.
author bears
date Wed, 12 Jul 2006 20:26:41 +0100
parents 1c7303c71f66
children
line wrap: on
line source

.TH inews 1
.\" $Id: inews.1 227 2000-10-26 21:21:13Z bears $
.SH NAME
inews \- Send a Usenet article.

.SH SYNOPSIS

.B inews
[
.B \-D
]
[
.B \-O
]
[
.B \-S
]
[
.I input
]

.SH DESCRIPTION

.I inews
reads a Usenet news article including headers from
the named file or standard input if no file is given.
It adds some headers and performs some checks. If the article
fails the checks (e.g. the article lacks a body, or has no Newsgroups:
line), the article is rejected. Otherwise the article is posted.


.SH OPTIONS

.TP
.B \-D
Debug mode.
.I inews
adds header lines and performs some checks. If the checks are successful,
the article is printed on the standard output and not posted.
.TP
.B \-O
If no
.I Organization:
header is found, and a value for
.I organization
is specified in
.BR noffle.conf (5),
.I inews
will add a
.I Organization:
header using that value. To suppress this behaviour, use the
.B \-O
flag.
.TP
.B "\-h \-A \-V \-W"
For compatibility with inews programs used with other news servers,
.I inews
accepts, but ignores, the ``\fB\-h\fP'', ``\fB\-A\fP'', ``\fB\-V\fP''
and ``\fB\-W\fP'' flags.
.TP
.B \-N
For compatability with inews programs used with other news servers,
the ``\fB\-N\fP'' flag is treated as the ``\fB\-D\fP'' flag.
.TP
.B \-S
Normally, if a file named
.I .signature
exists in the user's home directory,
.I inews
will try to append it to the end of the article. If the file cannot be
read, the article will not be posted.
If the
.B \-S
flag is given, .signature will not be added.

.SH NOTES

.I inews
exits with a zero status if the article was successfully posted, or a
non-zero status if a check fails or posting fails.

.PP
This
.I inews
is supplied with the
.B NOFFLE
news server. It is, in fact, the main
.BR noffle (1)
executable, and the
.I inews
program is just a link to the main
.I noffle
program. If the
.I noffle
program sees it is being executed under the name
.I inews
it adjusts its behaviour accordingly.

.SH FILES

.B NOFFLE
takes its configuration from a configuration file, by default
.I /etc/noffle.conf.
For a description of this file, see
.BR noffle.conf(5).

.SH SEE ALSO

.BR noffle (1),
.BR noffle.conf (5),

.SH AUTHORS

Markus Enzenberger <markus.enzenberger@t-online.de>
.br
Volker Wysk <volker.wysk@student.uni-tuebingen.de>
.br
Jim Hague <jim.hague@acm.org>
.br
Uwe Hermann <uh1763@bingo-ev.de>

1998-2000.