Return to news.5 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / news / man

Annotation of 43BSD/contrib/news/man/news.5, revision 1.1

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

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