


     RRRRNNNNEEEEWWWWSSSS((((8888))))		  XXXXEEEENNNNIIIIXXXX	3333....0000 ((((22227777	JJJJaaaannnn 1111999999992222))))	      RRRRNNNNEEEEWWWWSSSS((((8888))))



     NNNNAAAAMMMMEEEE
	  rnews, cunbatch - accept and spool news input
	  newsspool, newsrun, c7decode - news input spooler and processing
	  newsrunning - control news-processing daemon

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  rrrrnnnneeeewwwwssss
	  ccccuuuunnnnbbbbaaaattttcccchhhh
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssssssppppoooooooollll [ ----gggg	grade ]	[ ----iiii ] [ file
	  ... ]
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssrrrruuuunnnn [ grades ]
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////cccc7777ddddeeeeccccooooddddeeee
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////iiiinnnnppppuuuutttt////nnnneeeewwwwssssrrrruuuunnnnnnnniiiinnnngggg [oooonnnn|ooooffffffff]

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  _R_n_e_w_s	accepts	news from standard input and spools it up for
	  processing, space permitting.	 If space is persistently too
	  short, _r_n_e_w_s looks for the file /_u_s_r/_l_i_b/_n_e_w_s/_r_n_e_w_s._s_t_a_l_l;
	  if it	is present, _r_n_e_w_s waits	patiently for more space to
	  appear, while	if it is absent, _r_n_e_w_s discards	the news and
	  reports this.

	  _C_u_n_b_a_t_c_h is a	historical synonym for _r_n_e_w_s; there is no
	  difference in	what they do.

	  _N_e_w_s_s_p_o_o_l is the actual spooling program.  It	copies the
	  input	_f_i_l_e(s)	(standard input	default) to a file in the
	  input-spooling directory /_u_s_r/_s_p_o_o_l/_n_e_w_s/_i_n._c_o_m_i_n_g,
	  stripping off	any `####!!!!	ccccuuuunnnnbbbbaaaattttcccchhhh' or `####!!!! cccc7777uuuunnnnbbbbaaaattttcccchhhh' header as
	  it does so.  The filename is based on	the current time, plus
	  a suffix classifying the file	by type	(compressed,
	  _c_7_e_n_c_o_d_ed, or	plain text), plus a possible prefix denoting
	  the one-digit	numeric	_g_r_a_d_e (if the ----gggg option	is given;
	  _r_n_e_w_s	does not use this option).  If invoked with the	----iiii
	  option, when finished	_n_e_w_s_s_p_o_o_l attempts to start _n_e_w_s_r_u_n to
	  process the new news immediately.  _R_n_e_w_s invokes it this way
	  if and only if the file /_u_s_r/_l_i_b/_n_e_w_s/_r_n_e_w_s._i_m_m_e_d exists.

	  _N_e_w_s_r_u_n should be run	periodically (e.g. by _c_r_o_n(8)) to
	  process spooled news.	 _N_e_w_s_r_u_n_n_i_n_g can be used to turn
	  _n_e_w_s_r_u_n's processing off and on if it	is desired to avoid
	  major	news processing	during certain hours.  `nnnneeeewwwwssssrrrruuuunnnnnnnniiiinnnngggg
	  ooooffffffff' instructs any currently-running _n_e_w_s_r_u_n to stop as soon
	  as possible, and prevents later ones from running.  (This is
	  a slight oversimplification; see the discussion of _g_r_a_d_e_s
	  below.) `nnnneeeewwwwssssrrrruuuunnnnnnnniiiinnnngggg oooonnnn' removes the inhibition (but does
	  not actually start a new _n_e_w_s_r_u_n).  Without an argument,
	  _n_e_w_s_r_u_n_n_i_n_g reports the current status: ``off'' or ``on''.

	  _N_e_w_s_r_u_n checks for the _s_t_o_p file that	_n_e_w_s_r_u_n_n_i_n_g _o_f_f
	  creates, verifies that there is enough disk space for



     Page 1					      (printed 6/4/94)






     RRRRNNNNEEEEWWWWSSSS((((8888))))		  XXXXEEEENNNNIIIIXXXX	3333....0000 ((((22227777	JJJJaaaannnn 1111999999992222))))	      RRRRNNNNEEEEWWWWSSSS((((8888))))



	  processing, and then starts processing spooled news.	News
	  is processed in order	by _g_r_a_d_e: if the name of the spooled
	  file starts with a digit followed by a period, the digit is
	  the file's _g_r_a_d_e.  Files without a grade are considered to
	  have a grade just after grade	9.  Lower-numbered grades are
	  processed first, with	processing within a grade in
	  chronological	order.

	  If _n_e_w_s_r_u_n is	invoked	with a _g_r_a_d_e_s argument,	that specifies
	  the grades to	be processed.  A _g_r_a_d_e_s	argument can be	a
	  single grade (`1'), a	list (`123'), or a range (`1-5').  In
	  the absence of the argument, _n_e_w_s_r_u_n's default is all	grades
	  if there is no _s_t_o_p file present, and	just grade 0 if	there
	  is a _s_t_o_p file.  If a	_s_t_o_p file appears during processing,
	  _n_e_w_s_r_u_n will stop processing all but grade 0 and will	exit
	  when there is	no grade-0 news	left.

	  Each batch is	run through _c_7_d_e_c_o_d_e (if necessary),
	  de_c_o_m_p_r_e_s_sed (if necessary), and then	fed to _r_e_l_a_y_n_e_w_s.
	  (Files that lack a classification suffix, typically because
	  they arrived by some means other than	_n_e_w_s_s_p_o_o_l, are tried
	  first	as compressed and then as plain	text.) If _r_e_l_a_y_n_e_w_s
	  fails, _n_e_w_s_r_u_n attempts to save the spooled batch in the _b_a_d
	  subdirectory for human inspection.

	  _C_7_d_e_c_o_d_e passes standard input to standard output, decoding
	  a complex and	bizarre	encoding of 8-bit data as printable
	  ASCII	characters.

     FFFFIIIILLLLEEEESSSS
	  (All in /_u_s_r/_s_p_o_o_l/_n_e_w_s/_i_n._c_o_m_i_n_g)

	  000000000 (etc.) unclassified	ungraded spooled news
	  000000000.Zungraded compressed spooled news
	  000000000.tungraded plain-text spooled news
	  000000000.7ungraded compressed _c_7_e_n_c_o_d_ed spooled news
	  1.000000000.Zgrade 1 compressed spooled news,	etc.
	  stop	    _n_e_w_s_r_u_n disable file
	  bad	    directory for failed news

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  compress(1), newsbatch(8), newsmail(8), relaynews(8)

     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
	  Complaints are mailed	to uuuusssseeeennnneeeetttt if something goes wrong.

     HHHHIIIISSSSTTTTOOOORRRRYYYY
	  Part of C News.  Written at University of Toronto by Henry
	  Spencer.

     BBBBUUUUGGGGSSSS
	  _C_7_d_e_c_o_d_e should be part of the underlying transport



     Page 2					      (printed 6/4/94)






     RRRRNNNNEEEEWWWWSSSS((((8888))))		  XXXXEEEENNNNIIIIXXXX	3333....0000 ((((22227777	JJJJaaaannnn 1111999999992222))))	      RRRRNNNNEEEEWWWWSSSS((((8888))))



	  mechanism.  It hasn't	been tested very well in the C News
	  environment.	_B_d_e_c_o_d_e	(see _n_e_w_s_m_a_i_l(8)) is probably better
	  for most uses.

	  _R_e_l_a_y_n_e_w_s is a bit too enthusiastic about declaring batches
	  bad, so things may end up in _b_a_d for no terribly good
	  reason.  Actually, it's rare for the contents	of _b_a_d to be
	  very interesting.

	  The grading mechanism	relies slightly	on collating sequence,
	  and in particular on `.' collating before the	digits.












































     Page 3					      (printed 6/4/94)



