summaryrefslogtreecommitdiff
path: root/static/v10/man1/inews.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/v10/man1/inews.1')
-rw-r--r--static/v10/man1/inews.1151
1 files changed, 151 insertions, 0 deletions
diff --git a/static/v10/man1/inews.1 b/static/v10/man1/inews.1
new file mode 100644
index 00000000..15bb55a6
--- /dev/null
+++ b/static/v10/man1/inews.1
@@ -0,0 +1,151 @@
+.TH INEWS 1
+.SH NAME
+inews \- submit news articles
+.SH SYNOPSIS
+.B inews
+[
+.B \-h
+]
+.B \-t
+.IR title " [ "
+.B \-n
+.IR newsgroups " ] [ "
+.B \-e
+.IR "expiration date" " ]"
+.PP
+.B "inews \-p"
+.RI " [ " filename " ] "
+.PP
+.BI "inews \-C " newsgroup
+.SH DESCRIPTION
+.I Inews
+submits news articles to the USENET news
+network.
+It is intended as a raw interface, not as a human user interface.
+Casual users should probably use
+.IR postnews (1)
+instead.
+.PP
+The first form is for submitting user articles.
+The body will be read from the standard
+input. A
+.I title
+must be specified as there is no default. Each article
+belongs to a list of newsgroups. If the
+.B \-n
+flag is omitted, the list
+will default to something line
+.IR general .
+(On ours, it is
+.IR general .)
+If you wish to submit
+an article in multiple newsgroups, the
+.I newsgroups
+must be separated by commas and/or spaces.
+If not specified, the expiration date will be
+set to the local default.
+The
+.B \-f
+flag specifies the article's sender. Without this flag, the sender
+defaults to the user's name.
+If
+.B \-f
+is specified, the real sender's name will be included as a Sender line.
+The
+.B \-h
+flag specifies that headers are present at the beginning of the
+article, and these headers should be included with the article
+header instead of as text.
+(This mechanism can be used to edit headers and supply additional
+nondefault headers, but not to specify certain information,
+such as the sender and article ID, that inews itself generates.)
+.LP
+When posting an article, the environment is checked for
+information about the sender.
+If NAME is found, its value is used for the full name,
+rather than the system value (often in /etc/passwd).
+This is useful if the system value cannot be set, or when
+more than one person uses the same login.
+If ORGANIZATION is found, the value overrides the system
+default organization.
+This is useful when a person uses a guest login and is
+not primarily associated with the organization owning the machine.
+.LP
+The second form is used for receiving articles from other machines.
+If
+.I filename
+is given, the article will be read from the specified file; otherwise
+the article will be read from the standard input. An expiration date
+need not be present and a receival date, if present, will be ignored.
+.LP
+After local installation, inews will transmit the article to all systems
+that subscribe to the newsgroups that the article belongs to.
+.LP
+The third form is for creating new newsgroups. On some systems, this may
+be limited to specific users such as the super-user or news administrator.
+(This happens on ours.)
+.LP
+If the file /usr/lib/news/recording is present, it is taken as a list of
+"recordings" to be shown to users posting news.
+(This is by analogy to the recording you hear when you dial information
+in some parts of the country, asking you if you really wanted to do this.)
+The file contains lines of the form:
+.br
+ newsgroups <tab> filename
+.br
+for example:
+.br
+ net.all net.recording
+ fa.all fa.recording
+.br
+Any user posting an article to a newsgroup matching the pattern on
+the left will be shown the contents of the file on the right.
+The file is found in the LIB directory (often /usr/lib/news).
+The user is then told to hit DEL to abort or RETURN to proceed.
+The intent of this feature is to help companies keep proprietary
+information from accidently leaking out.
+.SH FILES
+.PD 0
+.TP 25
+/usr/spool/news/.sys.nnn
+temporary articles
+.TP 25
+.RI /usr/spool/news/ newsgroups / article_no.
+Articles
+.TP 25
+/usr/spool/oldnews/
+Expired articles
+.TP 25
+/usr/lib/news/active
+List of known newsgroups and highest local article numbers in each.
+.TP 25
+/usr/lib/news/seq
+Sequence number of last article
+.TP 25
+/usr/lib/news/history
+List of all articles ever seen
+.TP 25
+/usr/lib/news/sys
+System subscription list
+.PD
+.SH "SEE ALSO"
+Mail(1),
+binmail(1),
+getdate(3),
+msgs(1),
+news(5),
+newsrc(5),
+postnews(1),
+readnews(1),
+recnews(1),
+sendnews(8),
+uucp(1),
+uurec(8),
+.SH AUTHORS
+Matt Glickman
+.br
+Mark Horton
+.br
+Stephen Daniel
+.br
+Tom R. Truscott