Annotation of researchv10no/cmd/netnews/man/news.5, revision 1.1.1.1

1.1       root        1: .TH NEWS 5
                      2: .SH NAME
                      3: news \- USENET network news article, utility files
                      4: .SH DESCRIPTION
                      5: .PP
                      6: There are two formats of news articles:
                      7: .BR A " and " B.
                      8: .B A
                      9: format is the only format that version 1 netnews systems can read or write.
                     10: Systems running the version 2 netnews can read either format and there
                     11: are provisions for the version 2 netnews to write in
                     12: .BR A " format.  " A " format"
                     13: looks like this:
                     14: .LP
                     15: .BI A article-ID
                     16: .br
                     17: .I newsgroups
                     18: .br
                     19: .I path
                     20: .br
                     21: .I date
                     22: .br
                     23: .I title
                     24: .br
                     25: .I Body of article
                     26: .br
                     27: .LP
                     28: Only version 2 netnews systems can read and write
                     29: .BR B " format.  " B " format"
                     30: contains two extra pieces of information:  receival date and expiration
                     31: date.  The basic structure of a
                     32: .B B
                     33: format file consists of a series of headers and then the body.  A header
                     34: field is defined as a line with a capital letter in the 1st column and
                     35: a colon somewhere on the line.  Unrecognized header fields are ignored.
                     36: News is stored in the same format transmitted, see ``Standard for the
                     37: Interchange of USENET Messages'' for a full description.
                     38: The following fields are among those recognized:
                     39: .TP 15
                     40: Header
                     41: Information
                     42: .TP 15
                     43: .B From:
                     44: .I [email protected][.domain ...] (Full Name)
                     45: .TP 15
                     46: .B Newsgroups:
                     47: .I Newsgroups
                     48: .TP 15
                     49: .B Message-ID:
                     50: .I <Unique Identifier>
                     51: .TP 15
                     52: .B Subject:
                     53: .I descriptive title
                     54: .TP 15
                     55: .B Date:
                     56: .I Date Posted
                     57: .TP 15
                     58: .B Date-Received:
                     59: .I Date received on local machine
                     60: .TP 15
                     61: .B Expires:
                     62: .I Expiration Date
                     63: .TP 15
                     64: .B Reply-To:
                     65: .I Address for mail replies
                     66: .TP 15
                     67: .B References:
                     68: .I Article ID of article this is a follow-up to.
                     69: .TP 15
                     70: .B Control:
                     71: .I Text of a control message
                     72: .LP
                     73: Here is an example of an article:
                     74: .LP
                     75: .nf
                     76: Relay-Version: B 2.10  2/13/83 cbosgd.UUCP
                     77: Posting-Version: B 2.10        2/13/83 eagle.UUCP
                     78: Path: cbosgd!mhuxj!mhuxt!eagle!jerry
                     79: From: [email protected] (Jerry Schwarz)
                     80: Newsgroups: net.general
                     81: Subject: Usenet Etiquette -- Please Read
                     82: Message-ID: <[email protected]>
                     83: Date: Friday, 19-Nov-82 16:14:55 EST
                     84: Followup-To: net.news
                     85: Expires: Saturday, 1-Jan-83 00:00:00 EST
                     86: Date-Received: Friday, 19-Nov-82 16:59:30 EST
                     87: Organization: Bell Labs, Murray Hill
                     88: 
                     89: The body of the article comes here, after a blank line.
                     90: .fi
                     91: .LP
                     92: A
                     93: .I sys
                     94: file line has four fields, each seperated by colons:
                     95: .LP
                     96: .I system-name:subscriptions:flags:transmission command
                     97: .PP
                     98: Of these fields, on the
                     99: .IR system-name " and " subscriptions " need"
                    100: to be present.
                    101: .PP
                    102: The
                    103: .I system name
                    104: is the name of the system being sent to.  The
                    105: .I subscriptions
                    106: is the list of newsgroups to be transmitted to the system.  The
                    107: .I flags
                    108: are a set of letters describing how the article should be transmitted.
                    109: The default is B.
                    110: Valid flags include A (send in A format), B (send in B format),
                    111: N (use ihave/sendme protocol),
                    112: U (use uux -c and the name of the stored article in a %s string).
                    113: .LP
                    114: The
                    115: .I transmission command
                    116: is executed by the shell with the article to be transmitted as the standard
                    117: input.
                    118: The default is
                    119: .BI "uux \- \-z \-r " sysname !rnews.
                    120: Some examples:
                    121: .LP
                    122: .B "xyz:net.all"
                    123: .br
                    124: .B "oldsys:net.all,fa.all,to.oldsys:A"
                    125: .br
                    126: .B "berksys:net.all,ucb.all::/usr/lib/news/sendnews \-b berksys\\:rnews"
                    127: .br
                    128: .B "arpasys:net.all,arpa.all::/usr/lib/news/sendnews \-a rnews@arpasys"
                    129: .br
                    130: .B "old2:net.all,fa.all:A:/usr/lib/sendnews \-o old2\\:rnews"
                    131: .br
                    132: .B "user:fa.sf-lovers::mail user"
                    133: .LP
                    134: Somewhere in a
                    135: .I sys
                    136: file, there must be a line for the host system.  This line has no
                    137: .IR flags " or " commands .
                    138: A # as the first character in a line denotes a comment.
                    139: .LP
                    140: The history, active, and ngfile files have one line per item.
                    141: .SH SEE ALSO
                    142: inews(1),
                    143: postnews(1),
                    144: sendnews(8),
                    145: uurec(8),
                    146: readnews(1)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.