Return to news.5 CVS log

Up to [Research Unix] / researchv10no / cmd / netnews / man

Annotation of researchv10no/cmd/netnews/man/news.5, revision 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)

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