home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 400-499 / ff473.lzh / CNewsSrc / cnews_src.lzh / man / news.man < prev    next >
Text File  |  1991-01-05  |  29KB  |  393 lines

  1.  
  2.  
  3.  
  4. NEWS(5)                   FILE FORMATS                    NEWS(5)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      news - USENET network news articles, batches, related files
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      There are two formats of news articles:  AAAA and BBBB....  AAAA  format
  13.      is obsolete, but looks like this:
  14.  
  15.           AAAA_a_r_t_i_c_l_e-_I_D
  16.           _n_e_w_s_g_r_o_u_p_s
  17.           _p_a_t_h
  18.           _d_a_t_e
  19.           _t_i_t_l_e
  20.           _B_o_d_y _o_f _a_r_t_i_c_l_e
  21.  
  22.      A BBBB format _a_r_t_i_c_l_e consists of a series of headers and  then
  23.      the  body.   A  header  line is defined (approximately) as a
  24.      line at the start of the article or immediately following  a
  25.      header line with a capital letter as the first character and
  26.      a colon immediately following the first word, of alphanumer-
  27.      ics  and  dashes,  on  the line (a specialisation of RFC 822
  28.      format).  Continued headers are as per  RFC  822.   Unrecog-
  29.      nized  headers are ignored.  News is stored in the same for-
  30.      mat transmitted,  see  ``Standard  for  the  Interchange  of
  31.      USENET Messages'' (RFC 1036 nee 850) for a full description.
  32.      The following headers are among those recognized:
  33.  
  34.           FFFFrrrroooommmm:::: _u_s_e_r@@@@_h_o_s_t._d_o_m_a_i_n[._d_o_m_a_i_n ...] (((( _F_u_l_l _N_a_m_e))))
  35.           NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: _n_e_w_s _g_r_o_u_p_s
  36.           MMMMeeeessssssssaaaaggggeeee----IIIIDDDD:::: <<<<_U_n_i_q_u_e _R_F_C_8_2_2 _m_e_s_s_a_g_e-_i_d>>>>
  37.           SSSSuuuubbbbjjjjeeeecccctttt:::: _d_e_s_c_r_i_p_t_i_v_e _t_i_t_l_e
  38.           DDDDaaaatttteeee:::: _d_a_t_e _p_o_s_t_e_d
  39.           EEEExxxxppppiiiirrrreeeessss:::: _e_x_p_i_r_a_t_i_o_n _d_a_t_e
  40.           RRRReeeeppppllllyyyy----TTTToooo:::: _a_d_d_r_e_s_s _f_o_r _m_a_i_l _r_e_p_l_i_e_s
  41.           RRRReeeeffffeeeerrrreeeennnncccceeeessss:::: _M_e_s_s_a_g_e-_I_D _o_f _a_r_t_i_c_l_e _t_h_i_s _i_s  _a  _f_o_l_l_o_w-_u_p
  42.           _t_o.
  43.           CCCCoooonnnnttttrrrroooollll:::: _t_e_x_t _o_f _a _c_o_n_t_r_o_l _m_e_s_s_a_g_e
  44.  
  45.      Here is an example of an article:
  46.  
  47.           PPPPaaaatttthhhh:::: aaaatttttttt!!!!eeeeaaaagggglllleeee!!!!jjjjeeeerrrrrrrryyyy
  48.           FFFFrrrroooommmm:::: jjjjeeeerrrrrrrryyyy@@@@eeeeaaaagggglllleeee....uuuuuuuuccccpppp ((((JJJJeeeerrrrrrrryyyy SSSScccchhhhwwwwaaaarrrrzzzz))))
  49.           NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: nnnneeeewwwwssss....aaaannnnnnnnoooouuuunnnncccceeee
  50.           SSSSuuuubbbbjjjjeeeecccctttt:::: UUUUsssseeeennnneeeetttt EEEEttttiiiiqqqquuuueeeetttttttteeee -------- PPPPlllleeeeaaaasssseeee RRRReeeeaaaadddd
  51.           MMMMeeeessssssssaaaaggggeeee----IIIIDDDD:::: <<<<666644442222@@@@eeeeaaaagggglllleeee....UUUUUUUUCCCCPPPP>>>>
  52.           DDDDaaaatttteeee:::: FFFFrrrriiiiddddaaaayyyy,,,, 11119999 NNNNoooovvvv 88882222 11116666::::11114444::::55555555 EEEESSSSTTTT
  53.           FFFFoooolllllllloooowwwwuuuupppp----TTTToooo:::: nnnneeeewwwwssss....mmmmiiiisssscccc
  54.           EEEExxxxppppiiiirrrreeeessss:::: SSSSaaaattttuuuurrrrddddaaaayyyy,,,, 1111 JJJJaaaannnn 88883333 00000000::::00000000::::00000000 EEEESSSSTTTT
  55.           OOOOrrrrggggaaaannnniiiizzzzaaaattttiiiioooonnnn:::: BBBBeeeellllllll LLLLaaaabbbbssss,,,, MMMMuuuurrrrrrrraaaayyyy HHHHiiiillllllll
  56.           TTTThhhheeee bbbbooooddddyyyy ooooffff tttthhhheeee aaaarrrrttttiiiicccclllleeee ccccoooommmmeeeessss hhhheeeerrrreeee,,,, aaaafffftttteeeerrrr aaaannnn eeeemmmmppppttttyyyy lllliiiinnnneeee....
  57.  
  58.  
  59.  
  60.  
  61. Sun Microsystems    Last change: 12 Sept 1990                   1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. NEWS(5)                   FILE FORMATS                    NEWS(5)
  69.  
  70.  
  71.  
  72.      A _n_e_w_s _b_a_t_c_h consists of zero or more  articles,  each  pre-
  73.      ceded by a line of the form
  74.  
  75.           ####!!!! rrrrnnnneeeewwwwssss _b_y_t_e-_c_o_u_n_t
  76.  
  77.      where _b_y_t_e-_c_o_u_n_t is the number of  bytes  in  the  following
  78.      article,  where  each  newline  is counted as a single byte,
  79.      even if it is stored as a CR-LF or  some  other  representa-
  80.      tion.   Spaces  are  significant:   one before and one after
  81.      rrrrnnnneeeewwwwssss.  News batches are usually transmitted _c_o_m_p_r_e_s_sed.
  82.  
  83.      Various peculiar optional  encapsulations  of  news  batches
  84.      exist  which  consist  of  doing  something to the (probably
  85.      compressed) batch, then prepending a ####!!!! _g_o_o line to the out-
  86.      put,  where  _g_o_o  reflects  the form of encapsulation; known
  87.      values of _g_o_o include ccccuuuunnnnbbbbaaaattttcccchhhh (the null encapsulation), and
  88.      cccc7777uuuunnnnbbbbaaaattttcccchhhh  (encode the batch using only seven bits per char-
  89.      acter).
  90.  
  91.      The _s_y_s file line has four fields, each separated by colons:
  92.  
  93.      _s_y_s_t_e_m-
  94.      _n_a_m_e////_e_x_c_l_u_s_i_o_n_1,,,,_e_x_c_l_u_s_i_o_n_2...::::_s_u_b_s_c_r_i_p_t_i_o_n_s////_d_i_s_t_r_i_b_u_t_i_o_n_s::::_f_l_a_g_s::::_t_r_a_n_s_m_i_s_s_i_o_n
  95.      _c_o_m_m_a_n_d
  96.  
  97.      A #### as the first character in  a  line  denotes  a  comment.
  98.      Empty lines are ignored.  A logical line may be continued to
  99.      the next physical line by putting a \\\\  at  the  end  of  the
  100.      current  physical line.  Spaces are permitted in _s_y_s only in
  101.      comments, _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d when it really is  a  command
  102.      and  not  a  filename, and, for B news compatibility, at the
  103.      start of a continuation line (after a \\\\ and a newline).
  104.  
  105.      Of the _s_y_s fields, only the _s_y_s_t_e_m-_n_a_m_e need be present.  If
  106.      a  field  and all the fields after it are omitted, the colon
  107.      immediately before that field and all the  colons  after  it
  108.      may  be omitted too.  The optional subfields (_e_x_c_l_u_s_i_o_ns and
  109.      _d_i_s_t_r_i_b_u_t_i_o_n_s) and their leading slashes may be omitted.
  110.  
  111.      The _s_y_s_t_e_m _n_a_m_e is the name of the system being sent to, and
  112.      is  checked  against  site  names  in PPPPaaaatttthhhh:::: headers to avoid
  113.      sending an article back to a site that  has  seen  it.   The
  114.      _e_x_c_l_u_s_i_o_ns  are  also  checked  against the PPPPaaaatttthhhh:::: header and
  115.      articles are not sent to _s_y_s_t_e_m _n_a_m_e if  they  have  visited
  116.      any of the _e_x_c_l_u_s_i_o_n_s.
  117.  
  118.      The special _s_y_s_t_e_m _n_a_m_e  MMMMEEEE  stands  for  the  name  of  the
  119.      machine   news   is   running   on,   as   determined   from
  120.      /_u_s_r/_l_i_b/_n_e_w_s/_w_h_o_a_m_i.  (The MMMMEEEE line, or a line whose  _s_y_s_t_e_m
  121.      _n_a_m_e  is  explicitly that of the machine news is running on,
  122.      has a rather different meaning from that of  the  other  _s_y_s
  123.      file  lines:   its  _s_u_b_s_c_r_i_p_t_i_o_n_s  subfield  identifies  the
  124.  
  125.  
  126.  
  127. Sun Microsystems    Last change: 12 Sept 1990                   2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. NEWS(5)                   FILE FORMATS                    NEWS(5)
  135.  
  136.  
  137.  
  138.      newsgroups that this site subscribes to (i.e. is willing  to
  139.      receive), and its other fields and subfields are ignored.)
  140.  
  141.      _s_u_b_s_c_r_i_p_t_i_o_n_s is a comma-separated list  of  _n_e_w_s_g_r_o_u_p  _p_a_t_-
  142.      _t_e_r_n_s  specifying  the  newsgroups  to be transmitted to the
  143.      _s_y_s_t_e_m; each newsgroup from the NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header  of  each
  144.      article  is  matched  against  the  pattern list, and if any
  145.      newsgroup matches the pattern list, the article is transmit-
  146.      ted.   The  rules  for matching a newsgroup against a single
  147.      pattern are:
  148.      +o    _w_o_r_ds in a newsgroup or  a  pattern  are  delimited  by
  149.           periods;
  150.  
  151.      +o    words of a pattern and a newsgroup match only  if  they
  152.           are  identical,  except  that the word aaaallllllll in a pattern
  153.           matches any newsgroup word;
  154.  
  155.      +o    a newsgroup is matched against a pattern word by  word,
  156.           and  all  words  must  match for the newsgroup to match
  157.           that pattern;
  158.  
  159.      +o    if the pattern has fewer words than the newsgroup,  the
  160.           pattern  is  implicitly  extended to the same number of
  161.           words by appending ....aaaallllllll as many times as necessary;
  162.  
  163.      +o    if the newsgroup has fewer words than the pattern,  the
  164.           newsgroup does not match the pattern;
  165.  
  166.      +o    if _p_a_t_t_e_r_n matches  a  newsgroup,  !!!!_p_a_t_t_e_r_n  _m_i_smatches
  167.           that newsgroup.
  168.  
  169.      A newsgroup matches a pattern  list  if,  and  only  if,  it
  170.      matches at least one of the patterns and:
  171.      +o    the newsgroup does not mismatch any of the patterns, or
  172.  
  173.      +o    the longest matched pattern is longer than the  longest
  174.           mismatched  pattern  (length  is  measured in number of
  175.           words, with each explicit occurrence of aaaallllllll counted  as
  176.           slightly  less  than one word, and does not include the
  177.           implicit extension of patterns with ....aaaallllllll).
  178.  
  179.      Note that order in the lists is not  significant,  and  that
  180.      ties  are  broken  in  favor  of  not matching.  An example:
  181.      ccccoooommmmpppp,,,,ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn,,,,!!!!ccccoooommmmpppp....ssssyyyyssss matches  all  the  ccccoooommmmpppp  groups,
  182.      _e_x_c_e_p_t the ccccoooommmmpppp....ssssyyyyssss groups _b_u_t _i_n_c_l_u_d_i_n_g ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn.
  183.  
  184.      The distributions in the DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: header are  similarly
  185.      matched  against the _d_i_s_t_r_i_b_u_t_i_o_n_s.  If no _d_i_s_t_r_i_b_u_t_i_o_n_s are
  186.      supplied, DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: will be  matched  against  the  _s_u_b_-
  187.      _s_c_r_i_p_t_i_o_n_s  instead.   (The  DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: header is ignored
  188.      when receiving news; it is only significant when sending.)
  189.  
  190.  
  191.  
  192.  
  193. Sun Microsystems    Last change: 12 Sept 1990                   3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. NEWS(5)                   FILE FORMATS                    NEWS(5)
  201.  
  202.  
  203.  
  204.      Note that some older news software reportedly attached magi-
  205.      cal   significance   to   the  distributions  ``world''  and
  206.      ``local''; C News treats them as ordinary distribution names
  207.      with  no  special  properties  (except that ``world'' is the
  208.      default distribution of an article if  none  appears  expli-
  209.      citly).   For  example, a _d_i_s_t_r_i_b_u_t_i_o_n_s list like aaaallllllll,,,,!!!!llllooooccccaaaallll
  210.      will _n_o_t prevent local articles from being sent unless  they
  211.      contain explicit DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: llllooooccccaaaallll lines.
  212.  
  213.      The _f_l_a_g_s are a set of letters describing  how  the  article
  214.      should  be  transmitted.   Valid  flags include ffff (interpret
  215.      _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d as a file name and write the  name  and
  216.      size  in  bytes of each article on the end of it), FFFF (like ffff
  217.      but omit the size), IIII (like FFFF but write Message-ID:s instead
  218.      of  filenames), nnnn (like FFFF but write a Message-ID: after each
  219.      filename), LLLL_n (only send articles generated within _n hops of
  220.      here;  0  is  the  default  value  for  _n), mmmm (transmit only
  221.      moderated groups), uuuu  (transmit  only  unmoderated  groups).
  222.      There are other obsolete ones.
  223.  
  224.      The _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d is executed by the shell  with  the
  225.      article  to  be  transmitted  as  the  standard  input.  The
  226.      default is `uuuuuuuuxxxx ---- ----zzzz ----rrrr _s_y_s_n_a_m_e!!!!rrrrnnnneeeewwwwssss' for  a  command;  the
  227.      PATH  searched  includes ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////rrrreeeellllaaaayyyy, so that the
  228.      commands described in _n_e_w_s_m_a_i_l(8) are available as  alterna-
  229.      tives  to _u_u_x.  If one of the _f_l_a_g_s has caused this field to
  230.      be    taken    as    a    filename,    the    default     is
  231.      ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg////_s_y_s_n_a_m_e////ttttooooggggoooo;  if  a  filename  is
  232.      given but it does not start with `/', it is  assumed  to  be
  233.      relative to the ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg directory.
  234.  
  235.      Some examples:
  236.  
  237.           #### lllliiiinnnneeee iiiinnnnddddiiiiccccaaaattttiiiinnnngggg wwwwhhhhaaaatttt wwwweeee aaaarrrreeee wwwwiiiilllllllliiiinnnngggg ttttoooo rrrreeeecccceeeeiiiivvvveeee;;;; nnnnooootttteeee llllooooccccaaaallll ggggrrrroooouuuuppppssss oooonnnn eeeennnndddd
  238.           MMMMEEEE::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo,,,,ccccaaaannnn,,,,oooonnnntttt,,,,ttttoooorrrr,,,,uuuutttt
  239.           #### ssssaaaammmmpppplllleeee iiiinnnnssssiiiiggggnnnniiiiffffiiiiccccaaaannnntttt ffffeeeeeeeedddd nnnnooootttt uuuussssiiiinnnngggg bbbbaaaattttcccchhhhiiiinnnngggg
  240.           hhhhuuuueeeeyyyy::::nnnneeeewwwwssss....ccccoooonnnnffffiiiigggg,,,,ttttoooo....hhhhuuuueeeeyyyy////aaaallllllll::::::::uuuuuuuuxxxx ---- ----rrrr ----ggggdddd hhhhuuuueeeeyyyy!!!!rrrrnnnneeeewwwwssss
  241.           #### ssssaaaammmmpppplllleeee mmmmaaaajjjjoooorrrr bbbbaaaattttcccchhhheeeedddd ffffeeeeeeeedddd,,,, iiiinnnncccclllluuuuddddiiiinnnngggg ((((uuuunnnnnnnneeeecccceeeessssssssaaaarrrryyyy)))) eeeexxxxpppplllliiiicccciiiitttt ffffiiiilllleeee nnnnaaaammmmeeee
  242.           ddddeeeewwwweeeeyyyy::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo....ddddeeeewwwweeeeyyyy,,,,ccccaaaannnn,,,,oooonnnntttt,,,,ttttoooorrrr,,,,uuuutttt////aaaallllllll::::ffff::::ddddeeeewwwweeeeyyyy////ttttooooggggoooo
  243.           #### ssssaaaammmmpppplllleeee lllloooonnnngggg----hhhhaaaauuuullll ffffeeeeeeeedddd;;;; nnnnooootttteeee nnnnoooo llllooooccccaaaallll ggggrrrroooouuuuppppssss
  244.           ddddoooonnnnaaaalllldddd::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo....ddddoooonnnnaaaalllldddd////aaaallllllll::::ffff::::
  245.           #### ssssaaaammmmpppplllleeee llllooooccccaaaallll----ppppoooossssttttiiiinnnnggggssss----oooonnnnllllyyyy ffffeeeeeeeedddd ddddiiiirrrreeeecccctttt ttttoooo mmmmaaaajjjjoooorrrr ssssiiiitttteeee ((((ggggeeeettttssss tttthhhheeeemmmm oooouuuutttt ffffaaaasssstttt))))
  246.           ssssccccrrrrooooooooggggeeee::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo....ssssccccrrrrooooooooggggeeee////aaaallllllll::::LLLLffff::::
  247.           #### ssssaaaammmmpppplllleeee iiiihhhhaaaavvvveeee////sssseeeennnnddddmmmmeeee lllliiiinnnnkkkk
  248.           #### SSSSeeeennnndddd iiiihhhhaaaavvvveeee tttteeeelllllllliiiinnnngggg lllloooouuuuiiiieeee wwwwhhhhaaaatttt wwwweeee hhhhaaaavvvveeee -------- bbbbaaaattttcccchhhheeeerrrr ttttuuuurrrrnnnnssss tttthhhheeee bbbbaaaattttcccchhhh iiiinnnnttttoooo aaaa
  249.           #### ggggiiiiaaaannnntttt ccccoooonnnnttttrrrroooollll mmmmeeeessssssssaaaaggggeeee aaaannnndddd ppppoooossssttttssss iiiitttt ttttoooo """"ttttoooo....lllloooouuuuiiiieeee""""....  ((((####1111))))
  250.           lllloooouuuuiiiieeee::::rrrreeeecccc....mmmmuuuussssiiiicccc....ssssyyyynnnntttthhhh////aaaallllllll,,,,!!!!sssseeeennnnddddmmmmeeee,,,,!!!!iiiihhhhaaaavvvveeee::::IIII::::lllloooouuuuiiiieeee....iiiihhhhaaaavvvveeee////ttttooooggggoooo
  251.           #### SSSSeeeennnndddd sssseeeennnnddddmmmmeeee iiiinnnn rrrreeeessssppppoooonnnnsssseeee ttttoooo iiiihhhhaaaavvvveeee ffffrrrroooommmm lllloooouuuuiiiieeee -------- aaaaggggaaaaiiiinnnn,,,, ttttuuuurrrrnnnneeeedddd bbbbyyyy bbbbaaaattttcccchhhheeeerrrr
  252.           #### iiiinnnnttttoooo ggggiiiiaaaannnntttt ccccoooonnnnttttrrrroooollll mmmmeeeessssssssaaaaggggeeee ppppoooosssstttteeeedddd ttttoooo """"ttttoooo....lllloooouuuuiiiieeee""""....  ((((####3333))))
  253.           lllloooouuuuiiiieeee----sssseeeennnndddd----iiiiddddssss::::ttttoooo....lllloooouuuuiiiieeee////iiiihhhhaaaavvvveeee::::IIII::::lllloooouuuuiiiieeee....sssseeeennnnddddmmmmeeee////ttttooooggggoooo
  254.  
  255.  
  256.  
  257. Sun Microsystems    Last change: 12 Sept 1990                   4
  258.  
  259.  
  260.  
  261.  
  262. NEWS(5)                   FILE FORMATS                    NEWS(5)
  263.  
  264.  
  265.  
  266.           #### TTTTrrrraaaannnnssssmmmmiiiitttt ssssaaaaiiiidddd ggggiiiiaaaannnntttt ccccoooonnnnttttrrrroooollll mmmmeeeessssssssaaaaggggeeeessss bbbbyyyy nnnnoooorrrrmmmmaaaallll bbbbaaaattttcccchhhhiiiinnnngggg....  ((((####2222,,,,####4444))))
  267.           lllloooouuuuiiiieeee----ccccttttllll::::ttttoooo....lllloooouuuuiiiieeee////aaaallllllll,,,,!!!!sssseeeennnnddddmmmmeeee,,,,!!!!iiiihhhhaaaavvvveeee::::ffff::::lllloooouuuuiiiieeee////ttttooooggggoooo
  268.           #### SSSSeeeennnndddd aaaarrrrttttiiiicccclllleeeessss iiiinnnn rrrreeeessssppppoooonnnnsssseeee ttttoooo sssseeeennnnddddmmmmeeee mmmmeeeessssssssaaaaggggeeeessss ffffrrrroooommmm lllloooouuuuiiiieeee.... ((((####5555))))
  269.           lllloooouuuuiiiieeee----rrrreeeeaaaallll::::ttttoooo....lllloooouuuuiiiieeee////sssseeeennnnddddmmmmeeee::::ffff::::lllloooouuuuiiiieeee////ttttooooggggoooo
  270.           #### AAAAccccttttuuuuaaaallllllllyyyy tttthhhheeee llllaaaasssstttt ttttwwwwoooo ccccoooouuuulllldddd bbbbeeee ccccoooommmmbbbbiiiinnnneeeedddd....
  271.  
  272.      (The ``to._s_y_s_n_a_m_e'' groups are normal  newsgroups  used  for
  273.      testing individual news feeds.)
  274.  
  275.      Somewhere in the _s_y_s file, there must be a line for the host
  276.      system.  This line has no _f_l_a_g_s or _c_o_m_m_a_n_d_s.
  277.  
  278.      The _a_c_t_i_v_e file contains one  line  per  locally-valid  news
  279.      group.   Each  line consists of four blank-separated fields:
  280.      newsgroup  name,  highest  local  article  number  assigned,
  281.      lowest  local  article  number in use (approximately), and a
  282.      flag.  Both article-number fields are at least  five  digits
  283.      wide.   (Some  older  news  software may expect exactly five
  284.      digits.)  The current flag values  are  yyyy  (a  normal  unmo-
  285.      derated  group), nnnn (like yyyy but local postings disallowed), mmmm
  286.      (a normal moderated group), xxxx (a locally-disabled group,  no
  287.      articles  will  be  filed here), and ==== (followed by the real
  288.      group under which to file articles in this  group;  articles
  289.      are treated exactly as if their NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header specified
  290.      the real group instead of  the  original  one;  highest  and
  291.      lowest fields are ignored).  An example:
  292.  
  293.           ccccoooommmmpppp....oooorrrrgggg....uuuussssrrrrggggrrrroooouuuupppp 0000000000000000000000000000000000006666 00000000000000004444 yyyy
  294.           ttttaaaallllkkkk....bbbbiiiizzzzaaaarrrrrrrreeee 0000000000000000222299996666111122223333 222299992222111133336666 nnnn
  295.           ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn 0000000000000000000000000000111177775555 00000000111177773333 mmmm
  296.           lllliiiisssstttt....ssssuuuunnnn----ssssppppoooottttssss 0000000000000000000000000000000077776666 00000000000077776666 ====ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn
  297.           ccccoooommmmpppp....oooossss....vvvvmmmmssss 0000000000000000000000000000000000000000 00000000000000000000 xxxx
  298.  
  299.      The  _h_i_s_t_o_r_y  file  contains  one  line  for  each   article
  300.      received.  Each line consists of three tab-separated fields:
  301.      a _M_e_s_s_a_g_e-_I_D:, the arrival time as seconds  since  midnight,
  302.      Jan  1,  1970 and the EEEExxxxppppiiiirrrreeeessss:::: value (a dash indicates there
  303.      was none) separated by a tilde, and the  list  of  links  to
  304.      this  article.   If an article has been expired or cancelled
  305.      without being seen first, the list  of  links  and  the  tab
  306.      before it are omitted.  An example:
  307.  
  308.           <<<<3333444455551111@@@@hhhhccccrrrr....UUUUUUUUCCCCPPPP>>>>     555588881111999900005555555588888888~~~~----    ccccoooommmmpppp....tttteeeexxxxtttt////1111333311117777 ccccoooommmmpppp....ssssoooouuuurrrrcccceeeessss....wwwwaaaannnntttteeeedddd////4444222200000000
  309.           <<<<9999333388883333@@@@aaaalllliiiicccceeee....UUUUUUUUCCCCPPPP>>>>   666611111111999933334444555511111111~~~~----
  310.  
  311. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  312.      _c_h_e_c_k_n_e_w_s(1),  _c_o_m_p_r_e_s_s(1),  _i_n_e_w_s(1),  _p_o_s_t_n_e_w_s(1),   _r_e_a_d_-
  313.      _n_e_w_s(1),   _r_n(1),  _v_n_e_w_s(1),  _g_e_t_d_a_t_e(3),  _e_x_p_i_r_e(8),  _n_e_w_s_-
  314.      _b_a_t_c_h(8), _n_e_w_s_m_a_i_l(8), _r_e_l_a_y_n_e_w_s(8),  _r_e_c_n_e_w_s(8),  _r_n_e_w_s(8),
  315.      _s_e_n_d_n_e_w_s(8), _u_u_r_e_c(8), _n_e_w_s_i_n_v_a_d_e_r_s(9.1)
  316.      ARPA Internet RFCs 1036 and 850
  317.  
  318.  
  319.  
  320.  
  321. Sun Microsystems    Last change: 12 Sept 1990                   5
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. NEWS(5)                   FILE FORMATS                    NEWS(5)
  329.  
  330.  
  331.  
  332. BBBBUUUUGGGGSSSS
  333.      B format articles must not start with AAAA, to distinguish them
  334.      from  AAAA  format,  which  is only a problem if moderators put
  335.      AAAApppppppprrrroooovvvveeeedddd:::: first.
  336.      CCCCoooonnnnttttrrrroooollll:::: and NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: are not required to  be  the  first
  337.      headers, if present.
  338.      People insist on making  their  whacko  local  encapsulation
  339.      schemes (ccccuuuunnnnbbbbaaaattttcccchhhh, etc.)  _r_n_e_w_s's problem.
  340.      One could argue that RFC 822 is less than an ideal base  for
  341.      article format.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387. Sun Microsystems    Last change: 12 Sept 1990                   6
  388.  
  389.  
  390.  
  391.