home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / misc / volume28 / tin / part02 < prev    next >
Encoding:
Text File  |  1992-02-22  |  50.4 KB  |  1,414 lines
  1. Newsgroups: comp.sources.misc
  2. From: iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE
  3. Subject:  v28i046:  tin - threaded full screen newsreader v1.1, Part02/11
  4. Message-ID: <1992Feb18.043055.12405@sparky.imd.sterling.com>
  5. X-Md4-Signature: 081325591a386881626dd927e21fa6b5
  6. Date: Tue, 18 Feb 1992 04:30:55 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE (Iain Lea)
  10. Posting-number: Volume 28, Issue 46
  11. Archive-name: tin/part02
  12. Environment: BSD, SCO, ISC, SUNOS, SYSVR3, SYSVR4, ULTRIX, XENIX
  13. Supersedes: tin: Volume 23, Issue 15-23
  14.  
  15. #!/bin/sh
  16. # this is tin.shar.02 (part 2 of tin1.1)
  17. # do not concatenate these parts, unpack them in order with /bin/sh
  18. # file tin.1 continued
  19. #
  20. if test ! -r _shar_seq_.tmp; then
  21.     echo 'Please unpack part 1 first!'
  22.     exit 1
  23. fi
  24. (read Scheck
  25.  if test "$Scheck" != 2; then
  26.     echo Please unpack part "$Scheck" next!
  27.     exit 1
  28.  else
  29.     exit 0
  30.  fi
  31. ) < _shar_seq_.tmp || exit 1
  32. if test ! -f _shar_wnt_.tmp; then
  33.     echo 'x - still skipping tin.1'
  34. else
  35. echo 'x - continuing file tin.1'
  36. sed 's/^X//' << 'SHAR_EOF' >> 'tin.1' &&
  37. .PP
  38. The 'Kill articles' option needs to be set ON in the Options Menu
  39. (selected by 'M' at any level) to activate this command.
  40. .SH "POSTING ARTICLES"
  41. Tin allows posting of articles, follow-up to already posted articles
  42. and replying direct through mail to the author of an article.
  43. .PP
  44. Use the 'w' command to post an article to a newsgroup. After entering
  45. the post subject the default editor (ie. vi) or the editor specified
  46. by the $EDITOR enviroment variable will be started and the article can
  47. be entered. To crosspost articles simply add a comma and the name of
  48. the newsgroup(s) to the end of the Newsgroups: line at the beginning of
  49. the article. After saving and exiting the editor you are asked if you
  50. wish to a)bort posting the article, e)dit the article again or p)ost
  51. the article to the specified newsgroup(s).
  52. .PP
  53. Use the 'W' command to display a history of the articles you have posted.
  54. The date the article was posted, which newsgroups the article was
  55. posted to and the articles subject line are displayed.
  56. .PP
  57. Use the 'f' / 'F' command to post a follow-up article to an already
  58. posted article. The 'F' command will copy the text of the original
  59. article into the editor. The editing procedure is the same as when
  60. posting an article with the 'w' command.
  61. .PP
  62. Use the 'r' / 'R' command to reply direct through mail to the author
  63. of an already posted article. The 'R' command will copy the text of
  64. the original article into the editor. The editing procedure is the
  65. same as when posting an article with the 'w' command. After saving
  66. and exiting the editor you are asked if you wish to a)bort sending
  67. the article, e)dit the article again or s)end the article to the
  68. author.
  69. .SH "MAILING PIPING PRINTING AND SAVING ARTICLES"
  70. The command interface to mail ('m'), pipe ('|'), print ('o') and save
  71. ('s') articles is the same for ease of use.
  72. .PP
  73. The initial command will ask you to select which a)rticle, t)hread,
  74. r)egex pattern, t)agged articles you wish to mail, pipe etc.
  75. .PP
  76. Tagged articles must have already been tagged with the 'T' command.
  77. All tagged articles can be untagged by the 'U' untag command.
  78. .PP
  79. If regex pattern matching is selected you are asked to enter a regular
  80. expression (ie. to match all articles subject lines containing 'net News'
  81. you must enter '*net News*'). Any articles that match the
  82. entered expression will be mailed, piped etc.
  83. .PP
  84. To save articles to a mailbox with the name of the current newsgroup
  85. (ie. Alt.sources) enter '=' or '=<mailbox name>' when asked for the
  86. save filename.
  87. .PP
  88. To save articles in <newsgroup name>/<filename> format enter '+<filename>'.
  89. .PP
  90. When saving articles you can specify whether the saved files should be
  91. post processed (ie. unshar shell archive, uudecode multiple parts etc).
  92. A default process type can be set by the 'Process type:' in the 'M'
  93. options menu.
  94. .SH AUTOMATIC MAILING AND SAVING NEW NEWS
  95. Tin allows new/unread news articles to be mailed (-M option)/saved
  96. (-S option) in batch mode for later reading. Useful when going on
  97. holiday and you don't want to return and find that expire has removed a
  98. whole load of unread articles. Best to run from crontab everyday while away,
  99. after which you will be mailed a report of which articles were mailed/saved
  100. from which newsgroups and the total number of articles mailed/saved.
  101. Articles are saved in a private news structure under your <savedir> directory
  102. (default is \fI$HOME/News\fP). Be careful of using this option if you read a
  103. lot of groups because you could overflow your filesystem. If you only want to
  104. save a few groups it would be best to backup your full \fI$HOME/.newsrc\fP and
  105. create a new one that only contains the newsgroups you want to mail/save.
  106. Saved news can be read later by starting tin with the -R option.
  107. .PP
  108. tin -M iain -f newsrc.mail (mail any unread articles in newgroups specified
  109. in file newsrc.mail)
  110. .PP
  111. tin -S -f newsrc.save (save any unread articles in newgroups specified
  112. in file newsrc.save)
  113. .PP
  114. tin -R (read any unread articles saved by tin -S option)
  115. .SH SIGNATURES
  116. Tin will recognize a signature in either \fI$HOME/.signature\fP or
  117. \fI$HOME/.Sig\fP. If \fI$HOME/.signature\fP exists, then the signature
  118. will be pulled into the editor for Tin mail commands.  A signature in
  119. \fI$HOME/.signature\fP will not be pulled into the editor for posting
  120. commands since the inews program will append the signature itself.
  121. .PP
  122. A signature in \fI$HOME/.Sig\fP will be pulled into the editor for both
  123. posting and mailing commands.
  124. .PP
  125. The following is an example of a \fI$HOME/.Sig\fP file:
  126. .RS
  127. .nf
  128. NAME   Iain Lea
  129. EMAIL  iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE
  130. SNAIL  Bruecken Strasse 12, 8500 Nuernberg 90, Germany
  131. PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  132. .fi
  133. .RE
  134. .SH "ENVIROMENT VARIABLES"
  135. .TP
  136. \fBTINDIR\fP
  137. Define this variable if you do not want tin's .tin directory in $HOME/.tin.
  138. (ie. if you want all tin's private files in /tmp/.tin you would set
  139. TINDIR to contain /tmp.
  140. .TP
  141. \fBNNTPSERVER\fP
  142. The default NNTP server to remotely read news from. This variable only
  143. needs to be set if the -r command line option is specified and the file
  144. \fI/etc/nntpserver\fP does not exist.
  145. .TP
  146. \fBORGANIZATION\fP
  147. Set the mail header field Organization: to the contents of the
  148. variable instead of the system default. This variable has precedence
  149. over the file \fI$HOME/.tin/organization\fP that may also contain an
  150. organization string.
  151. .TP
  152. \fBREPLYTO\fP
  153. Set the mail header field Reply-To: to the return address specified
  154. by the variable.
  155. This is useful if the machine is not registered in the UUCP mail maps
  156. or if you wish to recieve replies at a different machine.
  157. This variable has precedence over the file \fI$HOME/.tin/replyto\fP
  158. that may also contain a return address.
  159. .TP
  160. \fBADD_ADDRESS\fP
  161. This can contain an address to append to the return address when replying
  162. directly through mail to somebody whose mail address is not directly
  163. recognized by the local host. For example say the return address is
  164. \fIuser@bigvax\fP, but \fIbigvax\fP is not recognized by your host, so
  165. therfore the mail will not reach \fIuser\fP. But the host \fIlittevax\fP
  166. is known to recognize your host and \fIbigvax\fP, so if ADD_ADDRESS is set
  167. (ie. 'setenv ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS @littevax'
  168. and 'export ADD_ADDRESS' for sh) the address \fIuser@bigvax@littlevax\fP will
  169. be used and the mail will reach \fIuser@bigvax\fP.
  170. This variable has precedence over the file \fI$HOME/.tin/add_address\fP
  171. that may also contain an address.
  172. .TP
  173. \fBBUG_ADDRESS\fP
  174. If the 'B' command bug report mail address is not correct this variable should be
  175. set to the correct mail address. This variable has precedence over the file
  176. \fI$HOME/.tin/bug_address\fP that may also contain a mail address.
  177. .TP
  178. \fBEDITOR\fP
  179. This variable has precedence over the default editor (ie. vi) that is
  180. used in all editing operations within tin (ie. posting 'w', replying 'rR',
  181. follow-ups 'fF' and bug reports 'B').
  182. .SH TIPS AND TRICKS
  183. The following newsgroups provide useful information concerning news software:
  184. .in +.5i
  185. .ti -\w'\(em'u
  186. \(emnews.software.readers (info. about news user agents tin,rn,nn,vn etc.)
  187. .ti -\w'\(em'u
  188. \(emnews.software.nntp (info. about NNTP)
  189. .ti -\w'\(em'u
  190. \(emnews.software.b (info. about news transport agents Bnews & Cnews)
  191. .PP
  192. Many prompts (ie. 'Mark everything as read? (y/n): y') within tin 
  193. offer a default choice that the cursor is positioned on. By pressing
  194. <CR> the default value is taken.
  195. .PP
  196. When tin is run in an xterm window it will resize itself each time the xterm
  197. is resized.
  198. .SH FILES
  199. .nf
  200. .ta \w'\fI$HOME/.tin/organization\fP   'u
  201. \fI$HOME/.newsrc\fP    subscribed to newgroups.
  202. \fI$HOME/.tin/tinrc\fP    options.
  203. \fI$HOME/.tin/.index\fP    newsgroup index files directory.
  204. \fI$HOME/.tin/add_address\fP    address to add to when replying through mail.
  205. \fI$HOME/.tin/active\fP    used by -n option for notifying user of new groups.
  206. \fI$HOME/.tin/bug_address\fP    address to send bug reports to.
  207. \fI$HOME/.tin/kill\fP    kill file.
  208. \fI$HOME/.tin/organization\fP    string to replace default organization.
  209. \fI$HOME/.tin/posted\fP    history of articles posted by user.
  210. \fI$HOME/.tin/replyto\fP    host address to use in Reply-To: mail header.
  211. \fI$HOME/.tin/unthread\fP    contains groups that are not to be threaded.
  212. \fI$HOME/.signature\fP    signature.
  213. \fI$HOME/.Sig\fP    signature.
  214. .fi
  215. .SH BUGS
  216. There are bugs somewhere among the creeping featurism. Any bugs found
  217. should be reported by the 'B' (bug report) command.
  218. .PP
  219. There is a bug when article killing is switched ON/OFF at article
  220. page level and the 't' command is used to return to group selection
  221. index.
  222. .PP
  223. When articles have been unkilled, all articles will be marked
  224. unread even if they have already been read.
  225. .PP
  226. Killing articles when tin is setuid causes strange behaviour.
  227. .PP
  228. Will not uudecode some of the images in alt.binaries.pictures because
  229. more than one image is in the multi-part file to uudecode. Only the
  230. first image will be uudecoded.
  231. .PP
  232. Does not handle Xref: headers for cross-posted articles.
  233. .PP
  234. More than one page of responses within a thread cause offset problems
  235. at thread level.
  236. .SH HISTORY
  237. Based on the tass newsreader that was developed by Rich Skrenta and posted
  238. to alt.sources in March 1991. Tass was itself heavily infleuenced by NOTES
  239. which was developed at the University of Illinois in the early 1980's.
  240. .PP
  241. Tin v1.00 (full distribution) was posted in 8 parts to alt.sources on 23 Aug 1991.
  242. .br
  243. Tin v1.0 PL1 (full distribution) was posted in 8 parts to alt.sources on 03 Sep 1991.
  244. .br
  245. Tin v1.0 PL2 (full distribution) was posted in 9 parts to alt.sources on 24 Sep 1991.
  246. .br
  247. Tin v1.0 PL3 (patch) was posted in 4 parts to alt.sources on 30 Sep 1991.
  248. .br
  249. Tin v1.0 PL4 (patch) was posted in 2 parts to alt.sources on 02 Oct 1991.
  250. .br
  251. Tin v1.0 PL5 (patch) was posted in 4 parts to alt.sources on 17 Oct 1991.
  252. .br
  253. Tin v1.0 PL6 (patch) was posted in 5 parts to alt.sources on 27 Nov 1991.
  254. .br
  255. Tin v1.0 PL7 (patch) was posted in 2 parts to alt.sources on 27 Nov 1991.
  256. .br
  257. Tin v1.1 PL0 (full distribution) was posted in ?? parts to alt.sources on ?? Feb 1992.
  258. .SH CREDITS
  259. .TP
  260. Rich Skrenta
  261. author of tass v3.2 which this newsreader used as its base.
  262. .TP
  263. Dave Taylor
  264. author of curses.c from the elm mailreader.
  265. .TP
  266. Rich Salz
  267. author of wildmat.c pattern matching routine.
  268. .TP
  269. Chris Thewalt
  270. author of getline.c emacs style editing routine.
  271. .PP
  272. I wish to thank the following people for supplying patchs:
  273. X
  274. Anton Aylward, Dieter Becker, Marc Boucher, Robert Claeson, Ned Danieley,
  275. Brent Ermlick, Carl Hage, Ed Hanway, Torsten Homeyer, Karl-Koenig Koenigsson,
  276. Kris Kugel, Hakan Lennestal, Clifford Luke, Bill Poitras, Jim Robinson,
  277. Nickolay Saukh, Rich Salz, John Sauter, Bart Sears, Karl-Olav Serrander,
  278. Doug Sewell, Cliff Stanford, Adri Verhoef, Cary Whitney
  279. .PP
  280. I wish to thank the following people for bug reports/comments:
  281. X
  282. Klaus Arzig, Scott Babb, Reiner Balling, Dan Berry, Volker Beyer, Roger Binns,
  283. Georg Biehler, Ian Brown, Andreas Brosig, Steven Cogswell, Tom Czarnik,
  284. David Donovan, Peter Dressler, Gerhard Ermer, Hugh Fader, Joachim Feld,
  285. Paul Fox, Bernhard Gmelch, Viet Hoang, Andy Jackson, Joe Johnson, Cyrill Jung,
  286. Hans-Juergen Knopp, Per Lindqvist, Bob Lukas, Phillip Molloy, Toni Metz,
  287. Greg Miller, Klaus Neuberger, Otto Niesser, Reiner Oelhaf, Wolf Paul,
  288. Andrew Phillips, Ted Richards, Fredy Schwatz, Bernd Schwerin, Klamer Schutte,
  289. Chris Smith, Steve Spearman, Hironobu Takahashi, Sven Werner
  290. .SH AUTHOR
  291. .TP
  292. Iain Lea
  293. (iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE)
  294. SHAR_EOF
  295. echo 'File tin.1 is complete' &&
  296. chmod 0600 tin.1 ||
  297. echo 'restore of tin.1 failed'
  298. Wc_c="`wc -c < 'tin.1'`"
  299. test 31684 -eq "$Wc_c" ||
  300.     echo 'tin.1: original size 31684, current size' "$Wc_c"
  301. rm -f _shar_wnt_.tmp
  302. fi
  303. # ============= wildmat.3 ==============
  304. if test -f 'wildmat.3' -a X"$1" != X"-c"; then
  305.     echo 'x - skipping wildmat.3 (File already exists)'
  306.     rm -f _shar_wnt_.tmp
  307. else
  308. > _shar_wnt_.tmp
  309. echo 'x - extracting wildmat.3 (Text)'
  310. sed 's/^X//' << 'SHAR_EOF' > 'wildmat.3' &&
  311. .TH WILDMAT 3
  312. .SH NAME
  313. wildmat \- perform shell-style wildcard matching
  314. .SH SYNOPSIS
  315. .nf
  316. .B "int"
  317. .B "wildmat(text, pattern)"
  318. .B "    char        *text;"
  319. .B "    char        *pattern;"
  320. .fi
  321. .SH DESCRIPTION
  322. .I Wildmat
  323. compares the
  324. .I text
  325. against the
  326. .I pattern
  327. and
  328. returns non-zero if the pattern matches the text.
  329. The pattern is interpreted similar to shell filename wildcards, and not
  330. as a full regular expression such as those handled by the
  331. .IR grep (1)
  332. family of programs or the
  333. .IR regex (3)
  334. or
  335. .IR regexp (3)
  336. set of routines.
  337. .PP
  338. The pattern is interpreted according to the following rules:
  339. .TP
  340. .BI \e x
  341. Turns off the special meaning of
  342. .I x
  343. and matches it directly; this is used mostly before a question mark or
  344. asterisk, and is not valid inside square brackets.
  345. .TP
  346. .B ?
  347. Matches any single character.
  348. .TP
  349. .B *
  350. Matches any sequence of zero or more characters.
  351. .TP
  352. .BI [ x...y ]
  353. Matches any single character specified by the set
  354. .IR x...y .
  355. A minus sign may be used to indicate a range of characters.
  356. That is,
  357. .I [0\-5abc]
  358. is a shorthand for
  359. .IR [012345abc] .
  360. More than one range may appear inside a character set;
  361. .I [0-9a-zA-Z._]
  362. matches almost all of the legal characters for a host name.
  363. The close bracket,
  364. .IR ] ,
  365. may be used if it is the first character in the set.
  366. The minus sign,
  367. .IR \- ,
  368. may be used if it is either the first or last character in the set.
  369. .TP
  370. .BI [^ x...y ]
  371. This matches any character
  372. .I not
  373. in the set
  374. .IR x...y ,
  375. which is interpreted as described above.
  376. For example,
  377. .I [^]\-]
  378. matches any character other than a close bracket or minus sign.
  379. .SH "BUGS AND LIMITATIONS"
  380. There is no way to end a range with a close bracket.
  381. .SH HISTORY
  382. Written by Rich $alz <rsalz@bbn.com> in 1986, and posted to Usenet
  383. several times since then, most notably in comp.sources.misc in
  384. March, 1991.
  385. .PP
  386. Lars Mathiesen <thorinn@diku.dk> enhanced the multi-asterisk failure
  387. mode in early 1991.
  388. .PP
  389. Rich and Lars increased the efficiency of star patterns and reposted it
  390. to comp.sources.misc in April, 1991.
  391. .PP
  392. Robert Elz <kre@munnari.oz.au> added minus sign and close bracket handling
  393. in June, 1991.
  394. .PP
  395. .de R$
  396. This is revision \\$3, dated \\$4.
  397. ..
  398. .R$ $Id: wildmat.3,v 1.7 91/07/05 17:50:16 rsalz Exp $
  399. .SH "SEE ALSO"
  400. grep(1), regex(3), regexp(3).
  401. SHAR_EOF
  402. chmod 0600 wildmat.3 ||
  403. echo 'restore of wildmat.3 failed'
  404. Wc_c="`wc -c < 'wildmat.3'`"
  405. test 2247 -eq "$Wc_c" ||
  406.     echo 'wildmat.3: original size 2247, current size' "$Wc_c"
  407. rm -f _shar_wnt_.tmp
  408. fi
  409. # ============= tin.nrf ==============
  410. if test -f 'tin.nrf' -a X"$1" != X"-c"; then
  411.     echo 'x - skipping tin.nrf (File already exists)'
  412.     rm -f _shar_wnt_.tmp
  413. else
  414. > _shar_wnt_.tmp
  415. echo 'x - extracting tin.nrf (Text)'
  416. sed 's/^X//' << 'SHAR_EOF' > 'tin.nrf' &&
  417. X
  418. X
  419. X
  420. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  421. X
  422. X
  423. X
  424. NNAAMMEE
  425. X     tin/rtin - A threaded Netnews reader
  426. X
  427. SSYYNNOOPPSSIISS
  428. X     ttiinn//rrttiinn [options] [newsgroups]
  429. X
  430. DDEESSCCRRIIPPTTIIOONN
  431. X     _T_i_n is a full-screen threaded Netnews reader.  It can read
  432. X     news locally (ie. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (rtin or tin
  433. X     -r option) via a NNTP (Network News Transport Protocol)
  434. X     server.
  435. X
  436. X     Tin has four newsreading levels: the newsgroup selection
  437. X     page, the group index page, the thread listing page and the
  438. X     article viewer.  Use the 'h' (help) command to view a list
  439. X     of the commands available at a particular level.
  440. X
  441. X     On startup Tin will show a list of the newsgroups found in
  442. X     $_H_O_M_E/._n_e_w_s_r_c.  An arrow '->' or highlighted bar will point
  443. X     to the first newsgroup.  Move to a group by using the termi-
  444. X     nal arrow keys (ansi/at386/vt100 only) or 'j' and 'k'. Use
  445. X     PgUp/PgDn (ansi/at386/vt100 only) or Ctrl-U and Ctrl-D to
  446. X     page up/down. Enter a newsgroup by pressing RETURN.
  447. X
  448. X     The TAB key may be used to advance to the next newsgroup
  449. X     with unread articles and enter it.
  450. X
  451. OOPPTTIIOONNSS
  452. X     --cc        create/update index files for every group in
  453. X               $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and
  454. X               mark all articles as read.
  455. X
  456. X     --dd ddiirr    save articles to directory. Default is $_H_O_M_E/_N_e_w_s.
  457. X
  458. X     --ff ffiillee   Use the specified file in place of $_H_O_M_E/._n_e_w_s_r_c.
  459. X
  460. X     --hh        help listing all command line options.
  461. X
  462. X     --mm ddiirr    mailbox directory to use. Default is $_H_O_M_E/_M_a_i_l.
  463. X
  464. X     --MM uusseerr   mail unread articles to specified user for later
  465. X               reading. For more information read section
  466. X               Automatic Mailing and Saving New News.
  467. X
  468. X     --nn        notify the user of any newly created newsgroups
  469. X               since the last session.
  470. X
  471. X     --pp ffiillee   print program with options..
  472. X
  473. X     --rr        read news remotely from the default NNTP server
  474. X               specified in the environment variable NNTPSERVER
  475. X               or contained in the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
  476. X
  477. X
  478. X
  479. X
  480. NEWS-OS                   Release 4.1R                          1
  481. X
  482. X
  483. X
  484. X
  485. X
  486. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  487. X
  488. X
  489. X
  490. X     --RR        read news saved by -S option (not yet imple-
  491. X               mented).
  492. X
  493. X     --ss ddiirr    spool directory where news is stored. Default is
  494. X               /_u_s_r/_s_p_o_o_l/_n_e_w_s.
  495. X
  496. X     --SS        save unread articles for later reading by -R
  497. X               option. For more information read section
  498. X               Automatic Mailing and Saving New News.
  499. X
  500. X     --uu        create/update index files for every group in
  501. X               $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option.
  502. X
  503. X     --UU        start tin in the background to update index files
  504. X               while reading news in the foreground.
  505. X
  506. X     --vv        verbose mode for -c -M -S -u and -Z options.
  507. X
  508. X     --zz        only start tin if there is any new/unread news. If
  509. X               there is news tin will position cursor at first
  510. X               group with unread news. Useful for putting in
  511. X               login file.
  512. X
  513. X     --ZZ        check if there is any new/unread news and exit
  514. X               with appropiate status.  If -v option is specified
  515. X               the number of unread articles in each group is
  516. X               printed. An exit code 0 indicates no news, 1 that
  517. X               an error occurred and 2 that new/unread news
  518. X               exists. Useful for writing scripts.
  519. X
  520. X     Tin can also dynamically change its options by the 'M' menu
  521. X     command.  Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
  522. X
  523. IINNDDEEXX FFIILLEESS
  524. X     In order to keep track of threads, Tin maintains an index
  525. X     for each group.  If Tin is made setuid to news, the indexes
  526. X     will be stored in the news spool directory (typically
  527. X     /_u_s_r/_s_p_o_o_l/_n_e_w_s). If Tin is not setuid, it will store index
  528. X     files in the subdirectory $_H_O_M_E/._t_i_n/._i_n_d_e_x.  Do not make
  529. X     Tin setuid news if news will be obtained via NNTP and not
  530. X     from /_u_s_r/_s_p_o_o_l/_n_e_w_s.
  531. X
  532. X     Entering a group the first time tends to be slow because the
  533. X     index file must be built from scratch.  Subsequent readings
  534. X     of a group will cause Tin to incrementally update the index
  535. X     file, adding or removing entries as new articles come in or
  536. X     as news expires. If reading news remotely indexing will be
  537. X     somewhat slower because the articles must be retrieved via
  538. X     the NNTP.
  539. X
  540. X     A good way to keep Tin index files current is to run tin -u
  541. X     from cron:
  542. X
  543. X
  544. X
  545. X
  546. 2                         Release 4.1R                    NEWS-OS
  547. X
  548. X
  549. X
  550. X
  551. X
  552. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  553. X
  554. X
  555. X
  556. X          20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/tin_groups
  557. X     This would update the index files for those groups appearing
  558. X     in /_u_s_r/_l_i_b/_n_e_w_s/_t_i_n__g_r_o_u_p_s.  To index all of the groups on
  559. X     the system, run tin -u with -f indicating the active file:
  560. X          20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/active
  561. X
  562. SSCCRREEEENN FFOORRMMAATT
  563. X     Tin has three separate levels of operation: Selection Group
  564. X     level, Group level and Article level.
  565. X
  566. X     At the Selection Group level the title displays the number
  567. X     of subscribed groups. The newsgroups are displayed on the
  568. X     left of the screen with the number of unread articles
  569. X     displayed on the same line in the middle of the screen.
  570. X               <Selection Num> <Newsgroup> <Num of unread articles>
  571. X          i.e.,
  572. X               1  alt.sources            10
  573. X               2  comp.sources.misc      3
  574. X               3  news.software.readers  12
  575. X
  576. X     At the Group level the title contains the name of the group,
  577. X     the number of conversation threads and total number of arti-
  578. X     cles i.e., alt.sources (7 23).  If the group has been setup
  579. X     not to thread articles (i.e., alt.sources is in
  580. X     $(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the title will be alt.sources (U 23).
  581. X     There are two possible display formats as shown below:
  582. X               288<Selection Num> <Unread> <Responses> <Subject> <Author>
  583. X          i.e.,
  584. X               1  +3Bnews sources?iain@estevax.uucp
  585. X               2  1This question hasether@net
  586. X          or
  587. X               <Selection Num> <Unread> <Responses> <Subject (longer)>
  588. X          i.e.,
  589. X               1  +    3                                      Bnews sources?
  590. X               2       1                                      This question has a longer subject line
  591. X
  592. X     At the Article level the page header has the following for-
  593. X     mat:
  594. X               <Date posted> <Newsgroup>    <Thread 1 of n>
  595. X               <Article Num> <Subject>      <Num of responses in thread>
  596. X               <Author>                     <Organization>
  597. X
  598. X               <Article body>
  599. X          i.e.,
  600. X               24 Jul 15:20:03 GMT   alt.sources      Thread 1 of 2
  601. X               Article 452           Bnews sources?   3 responses
  602. X               iain@estevax.uucp                      Organization name
  603. X
  604. X               <Article boby>
  605. X
  606. CCOOMMMMOONN MMOOVVIINNGG KKEEYYSS
  607. X     This table shows the common keys/commands for moving at all
  608. X
  609. X
  610. X
  611. X
  612. NEWS-OS                   Release 4.1R                          3
  613. X
  614. X
  615. X
  616. X
  617. X
  618. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  619. X
  620. X
  621. X
  622. X     three levels within Tin.
  623. X                                     ansi/at386/vt100  Other Terminals
  624. X          Beginning of list/article  HHoommee              11 (^^RR or gg at article level)
  625. X          End of list/article        EEnndd               $$ (also GG at article level)
  626. X          Page Up                    PPggUUpp              ^^UU or bb
  627. X          Page Down                  PPggDDnn              ^^DD or <<SSPPAACCEE>>
  628. X          Line Up                    UUpp aarrrrooww          kk (not at article level)
  629. X          Line Down                  DDoowwnn aarrrrooww        jj (not at article level)
  630. X
  631. CCOOMMMMOONN EEDDIITTIINNGG CCOOMMMMAANNDDSS
  632. X     An emacs style editing package allows the easy editing of
  633. X     input strings.  An history list allows the easy re-use of
  634. X     previously entered strings.  The following commands are
  635. X     available when editing a string:
  636. X
  637. X
  638. X     ^^AA,,^^EE     move to beginnning or end of line, respectively.
  639. X
  640. X     ^^FF,,^^BB     nondestructive move forward or back one location,
  641. X               respectively.
  642. X
  643. X     ^^DD        delete the character currently under the cursor,
  644. X               or send EOF if no characters in the buffer.
  645. X
  646. X     ^^HH,,<<DDEELL>>  delete character left of the cursor.
  647. X
  648. X     ^^KK        delete from cursor to end of line.
  649. X
  650. X     ^^PP,,^^NN     move through history, previous and next, respec-
  651. X               tively.
  652. X
  653. X     ^^LL,,^^RR     redraw the current line.
  654. X
  655. X     <<CCRR>>      places line on history list if nonblank, appends
  656. X               newline and returns to the caller.
  657. X
  658. X     <<EESSCC>>     aborts the present editing operation.
  659. X
  660. NNEEWWSSGGRROOUUPP SSEELLEECCTTIIOONN CCOOMMMMAANNDDSS
  661. X     44         Select group 4.
  662. X
  663. X     ^^KK        Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
  664. X
  665. X     ^^LL        Redraw page.
  666. X
  667. X     ^^RR        Reset $_H_O_M_E/._n_e_w_s_r_c file.
  668. X
  669. X     <<CCRR>>      Read current group.
  670. X
  671. X     <<TTAABB>>     View next unread group.
  672. X
  673. X     BB         Mail a bug report or comment to the author. This
  674. X
  675. X
  676. X
  677. X
  678. 4                         Release 4.1R                    NEWS-OS
  679. X
  680. X
  681. X
  682. X
  683. X
  684. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  685. X
  686. X
  687. X
  688. X               is the best way of getting bugs fixed and features
  689. X               added/changed.
  690. X
  691. X     cc         Mark current group as all read and goto next group
  692. X               in group selection list.
  693. X
  694. X     CC         Mark current group as all read and goto next
  695. X               unread group in group selection list.
  696. X
  697. X     gg         Choose a new group by name. The position of the
  698. X               group within the group list will also be asked
  699. X               for. By entering '1' the new group will be the
  700. X               first group in the displayed list, by entering '8'
  701. X               the group will be the eighth group in the list
  702. X               etc. By entering '$' the group will be the last
  703. X               group displayed.
  704. X
  705. X     hh         help screen of newsgroup selection commands.
  706. X
  707. X     HH         help screen of context sensitive help about news-
  708. X               group selection level.
  709. X
  710. X     II         Toggle inverse video.
  711. X
  712. X     mm         Move the current group within the group selection
  713. X               list.  By entering '1' the group will become the
  714. X               first displayed group in the list, by entering '8'
  715. X               the eighth group in the list etc. By entering '$'
  716. X               the group will be the last group displayed.
  717. X
  718. X     MM         User configurable options menu (for more informa-
  719. X               tion see section Options Menu).
  720. X
  721. X     qq         Quit tin.
  722. X
  723. X     ss         Subscribe to current group.
  724. X
  725. X     SS         Subscribe to groups matching user specified pat-
  726. X               tern.
  727. X
  728. X     uu         Unsubscribe to current group.
  729. X
  730. X     UU         Unsubscribe to groups matching user specified pat-
  731. X               tern.
  732. X
  733. X     vv         Print tin version number.
  734. X
  735. X     ww         Post an article to current group.
  736. X
  737. X     WW         List articles posted by user. The date posted, the
  738. X               newsgroup and the subject are listed.
  739. X
  740. X
  741. X
  742. X
  743. X
  744. NEWS-OS                   Release 4.1R                          5
  745. X
  746. X
  747. X
  748. X
  749. X
  750. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  751. X
  752. X
  753. X
  754. X     yy         The first time this command is called it will yank
  755. X               in all groups from /_u_s_r/_l_o_c_a_l/_n_e_w_s/_a_c_t_i_v_e that are
  756. X               not in $_H_O_M_E/._n_e_w_s_r_c.  After any groups have been
  757. X               subscribed/unsubscribed to, this command if
  758. X               pressed again will reread $_H_O_M_E/._n_e_w_s_r_c and
  759. X               display only subscribed groups.
  760. X
  761. X     YY         Reread group list from $_H_O_M_E/._n_e_w_s_r_c file.
  762. X
  763. X     zz         Mark all articles in the current group as unread.
  764. X
  765. X     ZZ         Undelete previously deleted group from
  766. X               $_H_O_M_E/._n_e_w_s_r_c file.
  767. X
  768. X     //         Group forward search.
  769. X
  770. X     ??         Group backward search.
  771. X
  772. GGRROOUUPP IINNDDEEXX CCOOMMMMAANNDDSS
  773. X     44         Select article 4.
  774. X
  775. X     ^^KK        Kill current article (for more information read
  776. X               section Kill Article Menu).
  777. X
  778. X     ^^LL        Redraw page.
  779. X
  780. X     <<CCRR>>      Read current article.
  781. X
  782. X     <<TTAABB>>     View next unread article or group.
  783. X
  784. X     aa         Author forward search.
  785. X
  786. X     AA         Author backward search.
  787. X
  788. X     BB         Mail a bug report or comment to the author. This
  789. X               is the best way of getting bugs fixed and features
  790. X               added/changed.
  791. X
  792. X     cc         Mark all articles as read.
  793. X
  794. X     CC         Cancel current article. It must have been posted
  795. X               by the same user. The cancel message can be seen
  796. X               in the newsgroup 'control'.
  797. X
  798. X     dd         Toggle display to show just the subject or the
  799. X               subject and author.
  800. X
  801. X     gg         Choose a new group by name.
  802. X
  803. X     hh         help screen of group index commands.
  804. X
  805. X     HH         help screen of context sensitive help about group
  806. X
  807. X
  808. X
  809. X
  810. 6                         Release 4.1R                    NEWS-OS
  811. X
  812. X
  813. X
  814. X
  815. X
  816. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  817. X
  818. X
  819. X
  820. X               index level.
  821. X
  822. X     II         Toggle inverse video.
  823. X
  824. X     KK         Mark article/thread as read and advance to next
  825. X               unread article/thread.
  826. X
  827. X     ll         List the author of each response in current thread
  828. X               and enter thread selection level.
  829. X
  830. X     mm         Mail current article / thread / articles matching
  831. X               pattern / tagged articles to someone.
  832. X
  833. X     MM         User configurable options menu (for more informa-
  834. X               tion see section Options Menu).
  835. X
  836. X     nn         Go to next group.
  837. X
  838. X     NN         Go to next unread article.
  839. X
  840. X     oo         Output current article / thread / articles match-
  841. X               ing pattern / tagged articles to printer.
  842. X
  843. X     pp         Go to previous group.
  844. X
  845. X     PP         Go to previous unread article.
  846. X
  847. X     qq         Quit tin.
  848. X
  849. X     ss         Save current article / thread / articles matching
  850. X               pattern / tagged articles to file / files / mail-
  851. X               box. To save to a mailbox enter '=' or '=mailbox'
  852. X               when asked for filename to save to. To save in
  853. X               <newsgroup name>/<filename> format enter
  854. X               '+filename'. Environment variables are allowed
  855. X               within a filename (ie. $SOURCES/dir/filename).
  856. X
  857. X     TT         Tag current article for mailing ('m') / piping
  858. X               ('|') / printing ('o') / saving ('s').
  859. X
  860. X     tt         Return to group selection index.
  861. X
  862. X     uu         Toggle display to show all articles as unthreaded
  863. X               or threaded.
  864. X
  865. X     UU         Untag all articles that were tagged.
  866. X
  867. X     vv         Print tin version number.
  868. X
  869. X     ww         Post an article to current group.
  870. X
  871. X     WW         List articles posted by user. The date posted, the
  872. X
  873. X
  874. X
  875. X
  876. NEWS-OS                   Release 4.1R                          7
  877. X
  878. X
  879. X
  880. X
  881. X
  882. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  883. X
  884. X
  885. X
  886. X               newsgroup and the subject are listed.
  887. X
  888. X     zz         Mark current article as unread.
  889. X
  890. X     ZZ         Mark current thread as unread.
  891. X
  892. X     //         Search forward for specified subject.
  893. X
  894. X     ??         Search backward for specified subject.
  895. X
  896. X     --         Show last message.
  897. X
  898. X     ||         Pipe current article / thread / articles matching
  899. X               pattern / tagged articles into command.
  900. X
  901. TTHHRREEAADD LLIISSTTIINNGG CCOOMMMMAANNDDSS
  902. X     44         Select article 4 within thread.
  903. X
  904. X     ^^LL        Redraw page.
  905. X
  906. X     <<CCRR>>      Read current article within thread.
  907. X
  908. X     <<TTAABB>>     View next unread article within thread.
  909. X
  910. X     hh         help screen of thread listing commands.
  911. X
  912. X     II         Toggle inverse video.
  913. X
  914. X     KK         Mark thread as read and return to group index
  915. X               level.
  916. X
  917. X     qq         Quit thread listing level.
  918. X
  919. X     tt         Return to group index level.
  920. X
  921. X     vv         Print tin version number.
  922. X
  923. X     zz         Mark current article in thread as unread.
  924. X
  925. X     ZZ         Mark all articles in thread as unread.
  926. X
  927. AARRTTIICCLLEE VVIIEEWWEERR CCOOMMMMAANNDDSS
  928. X     00         Read the base article in this thread.
  929. X
  930. X     44         Read response 4 in this thread.
  931. X
  932. X     ^^HH        Show all of the articles mail header.
  933. X
  934. X     ^^KK        Kill current article (for more information read
  935. X               section Kill Article Menu).
  936. X
  937. X     ^^LL        Redraw page.
  938. X
  939. X
  940. X
  941. X
  942. 8                         Release 4.1R                    NEWS-OS
  943. X
  944. X
  945. X
  946. X
  947. X
  948. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  949. X
  950. X
  951. X
  952. X     <<CCRR>>      Goto next base article.
  953. X
  954. X     <<TTAABB>>     Goto next unread article.
  955. X
  956. X     aa         Author forward search.
  957. X
  958. X     AA         Author backward search.
  959. X
  960. X     BB         Mail a bug report or comment to the author. This
  961. X               is the best way of getting bugs fixed and features
  962. X               added/changed.
  963. X
  964. X     cc         Mark all articles as read.
  965. X
  966. X     dd         Toggle rot-13 decoding for this article.
  967. X
  968. X     ff         Post a followup to current article.
  969. X
  970. X     FF         Post a followup with a copy of the current article
  971. X               included.
  972. X
  973. X     hh         Help screen of article page commands.
  974. X
  975. X     HH         Help screen of context sensitive help about arti-
  976. X               cle page level.
  977. X
  978. X     ii         Return to index page.
  979. X
  980. X     II         Toggle inverse video.
  981. X
  982. X     kk         Mark article as read and advance to next unread
  983. X               article.
  984. X
  985. X     KK         Mark thread as read and advance to next unread
  986. X               thread.
  987. X
  988. X     mm         Mail current article / thread / articles matching
  989. X               pattern / tagged articles to someone.
  990. X
  991. X     MM         User configurable options menu (for more informa-
  992. X               tion see section Options Menu).
  993. X
  994. X     nn         Go to the next article.
  995. X
  996. X     NN         Go to the next unread article.
  997. X
  998. X     oo         Output current article / thread / articles match-
  999. X               ing pattern / tagged articles to printer.
  1000. X
  1001. X     oo         Output article/thread/tagged articles to printer.
  1002. X
  1003. X     pp         Go to the previous article.
  1004. X
  1005. X
  1006. X
  1007. X
  1008. NEWS-OS                   Release 4.1R                          9
  1009. X
  1010. X
  1011. X
  1012. X
  1013. X
  1014. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1015. X
  1016. X
  1017. X
  1018. X     PP         Go to the previous unread article.
  1019. X
  1020. X     qq         Quit tin.
  1021. X
  1022. X     rr         Reply through mail to author.
  1023. X
  1024. X     RR         Reply through mail to author with a copy of the
  1025. X               current article included.
  1026. X
  1027. X     ss         Save current article / thread / articles matching
  1028. X               pattern / tagged articles to file / files / mail-
  1029. X               box. To save to a mailbox enter '=' or '=mailbox'
  1030. X               when asked for filename to save to. To save in
  1031. X               <newsgroup name>/<filename> format enter
  1032. X               '+filename'. Environment variables are allowed
  1033. X               within a filename (ie. $SOURCES/dir/filename).
  1034. X
  1035. X     tt         Return to group selection index.
  1036. X
  1037. X     vv         Print tin version number.
  1038. X
  1039. X     ww         Post an article to current group.
  1040. X
  1041. X     WW         List articles posted by user. The date posted, the
  1042. X               newsgroup and the subject are listed.
  1043. X
  1044. X     zz         Mark article as unread.
  1045. X
  1046. X     //         Article forward search.
  1047. X
  1048. X     ??         Article backward search
  1049. X
  1050. X     ||         Pipe current article / thread / articles matching
  1051. X               pattern / tagged articles into command.
  1052. X
  1053. X     <<         Goto the first article in the current thread.
  1054. X
  1055. X     >>         Goto the last article in the current thread.
  1056. X
  1057. OOPPTTIIOONNSS MMEENNUU
  1058. X     This menu is accessed by pressing 'M' at all levels. It
  1059. X     allows the user to customize the behaviour of tin. The
  1060. X     options are saved to the file $_H_O_M_E/._t_i_n/_t_i_n_r_c. Use <SPACE>
  1061. X     to toggle the required option and <CR> to set.
  1062. X
  1063. X     AAuuttoo ssaavvee
  1064. X         Automatically save articles/threads by Archive-name:
  1065. X         line in article header. This is useful to set ON in con-
  1066. X         junction with 'Save separate'.
  1067. X
  1068. X     SSaavvee sseeppaarraattee
  1069. X         Save articles/threads to separate files. Set ON if
  1070. X
  1071. X
  1072. X
  1073. X
  1074. 10                        Release 4.1R                    NEWS-OS
  1075. X
  1076. X
  1077. X
  1078. X
  1079. X
  1080. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1081. X
  1082. X
  1083. X
  1084. X         saving source code.  Set OFF if saving a conversational
  1085. X         thread.
  1086. X
  1087. X     MMaarrkk ssaavveedd rreeaadd
  1088. X         This allows saved articles/threads to be automatically
  1089. X         marked as having been read.
  1090. X
  1091. X     KKiillll aarrttiicclleess
  1092. X         This allows the user to kill articles that match entries
  1093. X         in the kill file $_H_O_M_E/._t_i_n/_k_i_l_l.
  1094. X
  1095. X     DDrraaww aarrrrooww
  1096. X         Allows groups/articles to be selected by an arrow '->'
  1097. X         if set ON or by an highlighted bar if set OFF.
  1098. X
  1099. X     PPrriinntt hheeaaddeerr
  1100. X         This allows the complete mail header or only the Siub-
  1101. X         ject: and From: fields to be output when printing arti-
  1102. X         cles.
  1103. X
  1104. X     GGoottoo 11sstt uunnrreeaadd
  1105. X         This allows the cursor to be placed at the first / last
  1106. X         unread article upon entering a newsgroup with unread
  1107. X         news.
  1108. X
  1109. X     SSccrroollll ffuullll ppaaggee
  1110. X         If set ON scrolling of groups/articles will be a full
  1111. X         page at a time, otherwise half a page at a time.
  1112. X
  1113. X     CCaattcchhuupp oonn qquuiitt
  1114. X         If set ON the user is asked when quitting if all groups
  1115. X         read during the current session should be marked read.
  1116. X
  1117. X     TThhrreeaadd aarrttiicclleess
  1118. X         If set ON articles will be threaded in all groups
  1119. X         (default), otherwise articles will be shown unthreaded.
  1120. X         If set ON but certain user specified groups are in
  1121. X         $_H_O_M_E/._t_i_n/_u_n_t_h_r_e_a_d, the specified groups will be
  1122. X         unthreaded and the rest will be threaded.
  1123. X
  1124. X     SShhooww oonnllyy uunnrreeaadd
  1125. X         If set ON show only new/unread articles, otherwise show
  1126. X         all articles.
  1127. X
  1128. X     SShhooww AAuutthhoorr
  1129. X         If set 'None' only the Subject: line will be displayed.
  1130. X         If set 'Addr' Subject: line & the address part of the
  1131. X         From: line are displayed. If set 'Name' Subject: line &
  1132. X         the authors full name part of the From: line are
  1133. X         displayed. If set 'Both' Subject: line & all of the
  1134. X         From: line are displayed.
  1135. X
  1136. X
  1137. X
  1138. X
  1139. X
  1140. NEWS-OS                   Release 4.1R                         11
  1141. X
  1142. X
  1143. X
  1144. X
  1145. X
  1146. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1147. X
  1148. X
  1149. X
  1150. X     PPrroocceessss ttyyppee
  1151. X         This specifies the default type of post processing to
  1152. X         perform on saved articles. The following types of pro-
  1153. X         cessing are allowed:
  1154. X             -none.
  1155. X             -unpacking of multi-part shell archives.
  1156. X             -unpacking of multi-part uuencoded files.
  1157. X             -unpacking of multi-part uuencoded files that pro-
  1158. X              duce a *.zoo archive whose contents is listed.
  1159. X             -unpacking of multi-part uuencoded files that pro-
  1160. X              duce a *.zoo archive whose contents is extracted.
  1161. X
  1162. X     SSoorrtt aarrttiicclleess bbyy
  1163. X         This specifies how articles should be sorted. The fol-
  1164. X         lowing sort types are allowed:
  1165. X             -don't sort articles (default).
  1166. X             -sort articles by Subject: field (ascending & des-
  1167. X              cending).
  1168. X             -sort articles by From: field (ascending & descend-
  1169. X              ing).
  1170. X             -sort articles by Date: field (ascending & descend-
  1171. X              ing).
  1172. X
  1173. X     SSaavvee ddiirreeccttoorryy
  1174. X         The directory where articles/threads are to be saved.
  1175. X         Default is $_H_O_M_E/_N_e_w_s.
  1176. X
  1177. X     MMaaiill ddiirreeccttoorryy
  1178. X         The directory where articles/threads are to be saved in
  1179. X         mailbox format.  This feature is mainly for use with the
  1180. X         Elm mail program. It allows the user to save
  1181. X         articles/threads/groups simply by giving '=' as the
  1182. X         filename to save to.
  1183. X
  1184. X     PPrriinntteerr
  1185. X         The printer program with options that is to be used to
  1186. X         print articles. Default is lpr for BSD machines and lp
  1187. X         for SysV machines.
  1188. X
  1189. KKIILLLL AARRTTIICCLLEE MMEENNUU
  1190. X     This menu is accessed by pressing '^K' at the group and page
  1191. X     levels. It allows the user to kill an article that matches
  1192. X     the current Subject: line, From: line or a string entered by
  1193. X     the user. The user entered string can be applied to the Sub-
  1194. X     ject: or From: lines of an article. The kill description can
  1195. X     be limited to the current newsgroup or it can apply to all
  1196. X     newsgroups.  Once entered the user can abort the command and
  1197. X     not save the kill description, edit the kill file or save
  1198. X     the kill description.
  1199. X
  1200. X     On starting tin the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read
  1201. X     and on entering a newsgroup any kill descriptions are
  1202. X
  1203. X
  1204. X
  1205. X
  1206. 12                        Release 4.1R                    NEWS-OS
  1207. X
  1208. X
  1209. X
  1210. X
  1211. X
  1212. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1213. X
  1214. X
  1215. X
  1216. X     applied. Articles that match a kill description are marked
  1217. X     killed and are not displayed.
  1218. X
  1219. X     The 'Kill articles' option needs to be set ON in the Options
  1220. X     Menu (selected by 'M' at any level) to activate this com-
  1221. X     mand.
  1222. X
  1223. PPOOSSTTIINNGG AARRTTIICCLLEESS
  1224. X     Tin allows posting of articles, follow-up to already posted
  1225. X     articles and replying direct through mail to the author of
  1226. X     an article.
  1227. X
  1228. X     Use the 'w' command to post an article to a newsgroup. After
  1229. X     entering the post subject the default editor (ie. vi) or the
  1230. X     editor specified by the $EDITOR enviroment variable will be
  1231. X     started and the article can be entered. To crosspost arti-
  1232. X     cles simply add a comma and the name of the newsgroup(s) to
  1233. X     the end of the Newsgroups: line at the beginning of the
  1234. X     article. After saving and exiting the editor you are asked
  1235. X     if you wish to a)bort posting the article, e)dit the article
  1236. X     again or p)ost the article to the specified newsgroup(s).
  1237. X
  1238. X     Use the 'W' command to display a history of the articles you
  1239. X     have posted.  The date the article was posted, which news-
  1240. X     groups the article was posted to and the articles subject
  1241. X     line are displayed.
  1242. X
  1243. X     Use the 'f' / 'F' command to post a follow-up article to an
  1244. X     already posted article. The 'F' command will copy the text
  1245. X     of the original article into the editor. The editing pro-
  1246. X     cedure is the same as when posting an article with the 'w'
  1247. X     command.
  1248. X
  1249. X     Use the 'r' / 'R' command to reply direct through mail to
  1250. X     the author of an already posted article. The 'R' command
  1251. X     will copy the text of the original article into the editor.
  1252. X     The editing procedure is the same as when posting an article
  1253. X     with the 'w' command. After saving and exiting the editor
  1254. X     you are asked if you wish to a)bort sending the article,
  1255. X     e)dit the article again or s)end the article to the author.
  1256. X
  1257. MMAAIILLIINNGG PPIIPPIINNGG PPRRIINNTTIINNGG AANNDD SSAAVVIINNGG AARRTTIICCLLEESS
  1258. X     The command interface to mail ('m'), pipe ('|'), print ('o')
  1259. X     and save ('s') articles is the same for ease of use.
  1260. X
  1261. X     The initial command will ask you to select which a)rticle,
  1262. X     t)hread, r)egex pattern, t)agged articles you wish to mail,
  1263. X     pipe etc.
  1264. X
  1265. X     Tagged articles must have already been tagged with the 'T'
  1266. X     command.  All tagged articles can be untagged by the 'U'
  1267. X     untag command.
  1268. X
  1269. X
  1270. X
  1271. X
  1272. NEWS-OS                   Release 4.1R                         13
  1273. X
  1274. X
  1275. X
  1276. X
  1277. X
  1278. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1279. X
  1280. X
  1281. X
  1282. X     If regex pattern matching is selected you are asked to enter
  1283. X     a regular expression (ie. to match all articles subject
  1284. X     lines containing 'net News' you must enter '*net News*').
  1285. X     Any articles that match the entered expression will be
  1286. X     mailed, piped etc.
  1287. X
  1288. X     To save articles to a mailbox with the name of the current
  1289. X     newsgroup (ie. Alt.sources) enter '=' or '=<mailbox name>'
  1290. X     when asked for the save filename.
  1291. X
  1292. X     To save articles in <newsgroup name>/<filename> format enter
  1293. X     '+<filename>'.
  1294. X
  1295. X     When saving articles you can specify whether the saved files
  1296. X     should be post processed (ie. unshar shell archive, uudecode
  1297. X     multiple parts etc).  A default process type can be set by
  1298. X     the 'Process type:' in the 'M' options menu.
  1299. X
  1300. AAUUTTOOMMAATTIICC MMAAIILLIINNGG AANNDD SSAAVVIINNGG NNEEWW NNEEWWSS
  1301. X     Tin allows new/unread news articles to be mailed (-M
  1302. X     option)/saved (-S option) in batch mode for later reading.
  1303. X     Useful when going on holiday and you don't want to return
  1304. X     and find that expire has removed a whole load of unread
  1305. X     articles. Best to run from crontab everyday while away,
  1306. X     after which you will be mailed a report of which articles
  1307. X     were mailed/saved from which newsgroups and the total number
  1308. X     of articles mailed/saved.  Articles are saved in a private
  1309. X     news structure under your <savedir> directory (default is
  1310. X     $_H_O_M_E/_N_e_w_s). Be careful of using this option if you read a
  1311. X     lot of groups because you could overflow your filesystem. If
  1312. X     you only want to save a few groups it would be best to
  1313. X     backup your full $_H_O_M_E/._n_e_w_s_r_c and create a new one that
  1314. X     only contains the newsgroups you want to mail/save.  Saved
  1315. X     news can be read later by starting tin with the -R option.
  1316. X
  1317. X     tin -M iain -f newsrc.mail (mail any unread articles in new-
  1318. X     groups specified in file newsrc.mail)
  1319. X
  1320. X     tin -S -f newsrc.save (save any unread articles in newgroups
  1321. X     specified in file newsrc.save)
  1322. X
  1323. X     tin -R (read any unread articles saved by tin -S option)
  1324. X
  1325. SSIIGGNNAATTUURREESS
  1326. X     Tin will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
  1327. X     $_H_O_M_E/._S_i_g. If $_H_O_M_E/._s_i_g_n_a_t_u_r_e exists, then the signature
  1328. X     will be pulled into the editor for Tin mail commands.  A
  1329. X     signature in $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the
  1330. X     editor for posting commands since the inews program will
  1331. X     append the signature itself.
  1332. X
  1333. X
  1334. X
  1335. X
  1336. X
  1337. X
  1338. 14                        Release 4.1R                    NEWS-OS
  1339. X
  1340. X
  1341. X
  1342. X
  1343. X
  1344. TIN(1)             NEWS-OS Programmer's Manual             TIN(1)
  1345. X
  1346. X
  1347. X
  1348. X     A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for
  1349. X     both posting and mailing commands.
  1350. X
  1351. X     The following is an example of a $_H_O_M_E/._S_i_g file:
  1352. X          NAME   Iain Lea
  1353. X          EMAIL  iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE
  1354. X          SNAIL  Bruecken Strasse 12, 8500 Nuernberg 90, Germany
  1355. X          PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  1356. X
  1357. EENNVVIIRROOMMEENNTT VVAARRIIAABBLLEESS
  1358. X     TTIINNDDIIRR
  1359. X          Define this variable if you do not want tin's .tin
  1360. X          directory in $HOME/.tin.  (ie. if you want all tin's
  1361. X          private files in /tmp/.tin you would set TINDIR to con-
  1362. X          tain /tmp.
  1363. X
  1364. X     NNNNTTPPSSEERRVVEERR
  1365. X          The default NNTP server to remotely read news from.
  1366. X          This variable only needs to be set if the -r command
  1367. X          line option is specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r
  1368. X          does not exist.
  1369. X
  1370. X     OORRGGAANNIIZZAATTIIOONN
  1371. X          Set the mail header field Organization: to the contents
  1372. X          of the variable instead of the system default. This
  1373. X          variable has precedence over the file
  1374. X          $_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n that may also contain an organ-
  1375. X          ization string.
  1376. X
  1377. X     RREEPPLLYYTTOO
  1378. X          Set the mail header field Reply-To: to the return
  1379. X          address specified by the variable.  This is useful if
  1380. X          the machine is not registered in the UUCP mail maps or
  1381. X          if you wish to recieve replies at a different machine.
  1382. X          This variable has precedence over the file
  1383. X          $_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o that may also contain a return
  1384. X          address.
  1385. X
  1386. X     AADDDD_AADDDDRREESSSS
  1387. X          This can contain an address to append to the return
  1388. X          address when replying directly through mail to somebody
  1389. X          whose mail address is not directly recognized by the
  1390. X          local host. For example say the return address is
  1391. X          _u_s_e_r@_b_i_g_v_a_x, but _b_i_g_v_a_x is not recognized by your host,
  1392. X          so therfore the mail will not reach _u_s_e_r. But the host
  1393. X          _l_i_t_t_e_v_a_x is known to recognize your host and _b_i_g_v_a_x, so
  1394. X          if ADD_ADDRESS is set (ie. 'setenv ADD_ADDRESS @lit-
  1395. SHAR_EOF
  1396. true || echo 'restore of tin.nrf failed'
  1397. fi
  1398. echo 'End of tin1.1 part 2'
  1399. echo 'File tin.nrf is continued in part 3'
  1400. echo 3 > _shar_seq_.tmp
  1401. exit 0
  1402.  
  1403. --
  1404. NAME   Iain Lea
  1405. EMAIL  iain%estevax.uucp@unido.Informatik.Uni-Dortmund.DE
  1406. SNAIL  Bruecken Strasse 12, 8500 Nuernberg 90, Germany
  1407. PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  1408. -- 
  1409.  Dr. med. dipl.-math Dieter Becker           Tel.: (0 / +49) 6841 - 16 3046
  1410.  Medizinische Universitaets- und Poliklinik  Fax.: (0 / +49) 6841 - 16 3369
  1411.  Innere Medizin III                         
  1412.  D - 6650 Homburg / Saar                     Email: becker@med-in.uni-sb.de
  1413. exit 0 # Just in case...
  1414.