


     IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))	       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20000 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111))))	    IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))



     NNNNAAAAMMMMEEEE
	  injnews, inews - `user-friendly' news-posting front-ends for relaynews

     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
	  iiiinnnnjjjjnnnneeeewwwwssss [ ----NNNN ] [ ----AAAA ]	[ ----VVVV ] [ ----xxxx excluded-site ]
	 iiiinnnneeeewwwwssss [ ----hhhh ] [	----NNNN ] [ ----AAAA ] [ ----VVVV ] [ ----xxxx	excluded-site ]	[ ----WWWW ]
	    [ ----MMMM ] [ ----aaaa	Approved:-contents ] [ ----cccc Control:-contents ]
	    [ ----dddd Distribution:-contents	] [ ----eeee Expires:-contents ] [
	    ----ffff From:-contents ]	[ ----nnnn Newsgroups:-contents ] [ ----oooo
	    Organization:-contents ] [ ----rrrr Reply-To:-contents ] [ ----tttt
	    Subject:-contents ]	[ ----CCCC newsgroup ] [ ----FFFF References:-
	    contents ] [ file ...  ]
	 iiiinnnneeeewwwwssss ----pppp [ file ... ]

     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
	  _I_n_j_n_e_w_s and _i_n_e_w_s massage news articles to make them conform
	  to DARPA RFC 1036, then _inject them into the _n_e_w_s flow.
	  _I_n_j_n_e_w_s is the preferred interface.  _I_n_e_w_s is	slower but
	  handles all the old B	News options, primarily	for the
	  benefit of old news readers.

	  _I_n_j_n_e_w_s injects an article, found on standard	input, into
	  the news flow, installing it locally and broadcasting	it (if
	  appropriate) onto the	network.  _I_n_j_n_e_w_s assumes the presence
	  of at	least SSSSuuuubbbbjjjjeeeecccctttt:::: and NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: headers in the article,
	  then adds and	alters headers,	notably	MMMMeeeessssssssaaaaggggeeee----IIIIDDDD::::, FFFFrrrroooommmm:::: and
	  PPPPaaaatttthhhh::::, deletes invisible characters, and appends the first
	  four lines of	$$$$HHHHOOOOMMMMEEEE////....ssssiiiiggggnnnnaaaattttuuuurrrreeee, if any, to the article, and
	  hands	the resulting article to _r_e_l_a_y_n_e_w_s(8), provided	the
	  newsgroup(s) are unmoderated.	 If any	of the groups are
	  moderated, the article will instead be mailed	to the
	  moderator of one of the moderated newsgroups in the
	  NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header.  ----NNNN suppresses posting and produces on
	  standard output the article that would have otherwise	been
	  posted; the resultant	article	will have been checked for
	  illegalities as usual	and will be suitable as	input to
	  _r_e_l_a_y_n_e_w_s(8).	 ----AAAA waits until	enough space becomes free in
	  ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss.  ----VVVV causes _r_e_l_a_y_n_e_w_s	to emit	a log file
	  line on stdout after processing is complete, by having
	  _r_e_l_a_y_n_e_w_s not	redirect stdout	and stderr to
	  ////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s////lllloooogggg and	////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s////eeeerrrrrrrrlllloooogggg.... ----xxxx prevents
	  transmission to site _e_x_c_l_u_d_e_d-_s_i_t_e.

	  _I_n_e_w_s	does everything	that _i_n_j_n_e_w_s does, plus	some
	  backwardly-compatible	things.	 The article is	read from
	  _f_i_l_es	or standard input if none.  Normal usage is iiiinnnneeeewwwwssss ----hhhh,
	  which	assumes	that the input article starts with headers;
	  otherwise it starts the article body and the B News options
	  described below must be given	to supply the headers.	----WWWW
	  waits	for _r_e_l_a_y_n_e_w_s to complete, instead of running it in
	  the background and not waiting.  ----MMMM does nothing, for	B News



     Page 1					      (printed 6/4/94)






     IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))	       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20000 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111))))	    IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))



	  compatibility.  The rest of the options are inherited	from B
	  News and exist only for backward-compatibility with news
	  readers.  _T_h_e_y _s_h_o_u_l_d	_n_o_t _b_e _u_s_e_d _b_y _h_u_m_a_n_s, as they are
	  equivalent to	adding the obvious headers, with two small
	  twists: ----ffff generates FFFFrrrroooommmm:::: _F_r_o_m:-_c_o_n_t_e_n_t_s which generates a
	  SSSSeeeennnnddddeeeerrrr:::: _u_s_e_r@@@@_h_o_s_t header if there is no SSSSeeeennnnddddeeeerrrr:::: header in
	  the input, and ----CCCC tells you to use _a_d_d_g_r_o_u_p for local	group
	  creations and	tells you what to feed to _i_n_j_n_e_w_s for global
	  ones.

	  iiiinnnneeeewwwwssss	----pppp _f_i_l_e_s is exactly equivalent to invoking rrrreeeellllaaaayyyynnnneeeewwwwssss
	  ----rrrr _f_i_l_e_s, where _f_i_l_e_s	may be an empty	list; there is no
	  automatic recovery of	the input file(s) in case of errors,
	  full disks or	other problems.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
	  iiiinnnnjjjjnnnneeeewwwwssss <<<<aaaarrrrttttiiiicccclllleeee
	       Post _a_r_t_i_c_l_e to Usenet.

	  iiiinnnnjjjjnnnneeeewwwwssss ----NNNN <<<<aaaarrrrttttiiiicccclllleeee >>>>////ddddeeeevvvv////nnnnuuuullllllll
	       Check _a_r_t_i_c_l_e for obvious errors.

     FFFFIIIILLLLEEEESSSS
	  ////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s////aaaaccccttttiiiivvvveeee
			      contains (un)moderated flag
	  ////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s////mmmmaaaaiiiillllppppaaaatttthhhhssss
			      routes to	moderators, Internet gateway
	  ////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s////mmmmaaaaiiiillllnnnnaaaammmmeeee
			      the name of this cluster of machines for
			      purposes of mail,	including any domain
	  ////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s////sssseeeerrrrvvvveeeerrrr
			      the hostname of this cluster's server
	  ////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s////wwwwhhhhooooaaaammmmiiii
			      the name of this cluster for purposes of
			      news
	  $_H_O_M_E////....ssssiiiiggggnnnnaaaattttuuuurrrreeee    your name	and network addresses (no
			      line-printer graphics, please)
	  $_H_O_M_E////ddddeeeeaaaadddd....aaaarrrrttttiiiicccclllleeee  saved article in case of errors or
			      problems
	  ////ttttmmmmpppp////iiiinnnn*	      temporaries

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  _m_a_i_l(1), _n_e_w_s(5), _n_e_w_s_a_u_x(8),	_r_e_l_a_y_n_e_w_s(8)
	  DARPA	RFC 1036

     HHHHIIIISSSSTTTTOOOORRRRYYYY
	  Written by Geoff Collyer as part of the C news project.

     BBBBUUUUGGGGSSSS
	  _I_n_e_w_s	should be unnecessary; its only	useful function	is
	  adding MMMMeeeessssssssaaaaggggeeee----IIIIDDDD:::: headers and most novices use _P_n_e_w_s, which
	  could	invoke _r_e_l_a_y_n_e_w_s directly.



     Page 2					      (printed 6/4/94)






     IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))	       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20000 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111))))	    IIIINNNNJJJJNNNNEEEEWWWWSSSS((((1111))))



	  _I_n_e_w_s	is a shell script currently and	can fail if any	of the
	  underlying Unix tools	fail.  This typically happens with
	  very long input lines.




















































     Page 3					      (printed 6/4/94)



