home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / misc / volume29 / tin / part02 < prev    next >
Encoding:
Text File  |  1992-03-27  |  50.4 KB  |  1,575 lines

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