home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume23 / tin / patch03d < prev    next >
Text File  |  1991-10-19  |  43KB  |  1,154 lines

  1. Newsgroups: comp.sources.misc
  2. From: iain@norisc.siemens.de (Iain J. Lea)
  3. Subject:  v23i081:  tin - threaded full screen newsreader, Patch03d/4
  4. Message-ID: <1991Oct20.032103.24769@sparky.imd.sterling.com>
  5. X-Md4-Signature: 8bfe35cbc10c7c3ca75d497a10840ec1
  6. Date: Sun, 20 Oct 1991 03:21:03 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: iain@norisc.siemens.de (Iain J. Lea)
  10. Posting-number: Volume 23, Issue 81
  11. Archive-name: tin/patch03d
  12. Environment: BSD, SCO, ISC, SUNOS, SYSVR3, SYSVR4, ULTRIX, XENIX
  13. Patch-To: tin: Volume 23, Issue 15-23
  14.  
  15. #!/bin/sh
  16. # this is tin.patch.04 (part 4 of tin1.0)
  17. # do not concatenate these parts, unpack them in order with /bin/sh
  18. # file tin.patch03 continued
  19. #
  20. if touch 2>&1 | fgrep '[-amc]' > /dev/null
  21.  then TOUCH=touch
  22.  else TOUCH=true
  23. fi
  24. if test ! -r shar3_seq_.tmp; then
  25.     echo "Please unpack part 1 first!"
  26.     exit 1
  27. fi
  28. (read Scheck
  29.  if test "$Scheck" != 4; then
  30.     echo "Please unpack part $Scheck next!"
  31.     exit 1
  32.  else
  33.     exit 0
  34.  fi
  35. ) < shar3_seq_.tmp || exit 1
  36. echo "x - Continuing file tin.patch03"
  37. sed 's/^X//' << 'SHAR_EOF' >> tin.patch03 &&
  38. X! extern char postfile[LEN+1];
  39. X  
  40. X! extern char msg[LEN+1];
  41. X! extern char userid[LEN+1];
  42. X! extern char homedir[LEN+1];
  43. X! extern char add_addr[LEN+1];
  44. X! extern char bug_addr[LEN+1];
  45. X! extern char txt_help_bug_report[LEN+1];
  46. X! extern char reply_to[LEN+1];
  47. X! extern char my_org[LEN+1];
  48. X! extern char active_file[LEN+1];
  49. X! extern char newsrc[LEN+1];
  50. X! extern char newnewsrc[LEN+1];
  51. X! extern char delgroups[LEN+1];
  52. X  
  53. X  extern char *version;
  54. X! extern char cvers[LEN+1];
  55. X! extern char progname[LEN+1];
  56. X! extern char article[LEN+1];
  57. X! extern char dead_article[LEN+1];
  58. X! extern char mailer[LEN+1];
  59. X! extern char printer[LEN+1];
  60. X! extern char spooldir[LEN+1];
  61. X! extern char savedir[LEN+1];
  62. X! extern char maildir[LEN+1];
  63. X! extern char mailbox[LEN+1];
  64. X! extern char page_header[LEN+1];
  65. X! extern char signature[LEN+1];
  66. X! extern char sig[LEN+1];
  67. X! extern char killsubj[LEN+1];
  68. X! extern char killfrom[LEN+1];
  69. X! extern char author_search_string[LEN+1];
  70. X! extern char group_search_string[LEN+1];
  71. X! extern char subject_search_string[LEN+1];
  72. X! extern char art_search_string[LEN+1];
  73. X  extern char default_mail_address[LEN];
  74. X  extern char default_pipe_command[LEN];
  75. X  extern char default_regex_pattern[LEN];
  76. X  extern char default_save_file[LEN];
  77. X  extern char proc_ch_default;                /* set in change_rcfile () */
  78. X  
  79. X  extern char *help_select[];
  80. X--- 346,397 ----
  81. X  extern int num_of_tagged_files;
  82. X  extern int compiled_with_nntp;
  83. X  extern int save_news;
  84. X+ extern int thread_arts;
  85. X  
  86. X! extern char rcdir[LEN];
  87. X! extern char rcfile[LEN];
  88. X! extern char indexdir[LEN];
  89. X! extern char killfile[LEN];
  90. X! extern char postfile[LEN];
  91. X  
  92. X! extern char msg[LEN];
  93. X! extern char userid[LEN];
  94. X! extern char homedir[LEN];
  95. X! extern char add_addr[LEN];
  96. X! extern char bug_addr[LEN];
  97. X! extern char txt_help_bug_report[LEN];
  98. X! extern char reply_to[LEN];
  99. X! extern char my_org[LEN];
  100. X! extern char active_file[LEN];
  101. X! extern char newsrc[LEN];
  102. X! extern char newnewsrc[LEN];
  103. X! extern char delgroups[LEN];
  104. X  
  105. X  extern char *version;
  106. X! extern char cvers[LEN];
  107. X! extern char progname[LEN];
  108. X! extern char article[LEN];
  109. X! extern char dead_article[LEN];
  110. X! extern char mailer[LEN];
  111. X! extern char printer[LEN];
  112. X! extern char spooldir[LEN];
  113. X! extern char savedir[LEN];
  114. X! extern char maildir[LEN];
  115. X! extern char mailbox[LEN];
  116. X! extern char page_header[LEN];
  117. X! extern char signature[LEN];
  118. X! extern char sig[LEN];
  119. X! extern char killsubj[LEN];
  120. X! extern char killfrom[LEN];
  121. X! extern char author_search_string[LEN];
  122. X! extern char group_search_string[LEN];
  123. X! extern char subject_search_string[LEN];
  124. X! extern char art_search_string[LEN];
  125. X  extern char default_mail_address[LEN];
  126. X  extern char default_pipe_command[LEN];
  127. X  extern char default_regex_pattern[LEN];
  128. X  extern char default_save_file[LEN];
  129. X+ extern char default_shell_command[LEN];
  130. X  extern char proc_ch_default;                /* set in change_rcfile () */
  131. X  
  132. X  extern char *help_select[];
  133. XOnly in 103: tin.nrf
  134. XOnly in 102: tmp
  135. XFiles 102/wildmat.3 and 103/wildmat.3 are identical
  136. XFiles 102/wildmat.c and 103/wildmat.c are identical
  137. SHAR_EOF
  138. echo "File tin.patch03 is complete" &&
  139. $TOUCH -am 0930190991 tin.patch03 &&
  140. chmod 0600 tin.patch03 ||
  141. echo "restore of tin.patch03 failed"
  142. set `wc -c tin.patch03`;Wc_c=$1
  143. if test "$Wc_c" != "141957"; then
  144.     echo original size 141957, current size $Wc_c
  145. fi
  146. # ============= tin.nrf ==============
  147. echo "x - extracting tin.nrf (Text)"
  148. sed 's/^X//' << 'SHAR_EOF' > tin.nrf &&
  149. X
  150. X
  151. X
  152. X     Version 1.0 PL3                                                 TIN(1)
  153. X
  154. X
  155. X
  156. X     NAME
  157. X          tin - Visual threaded Usenet news reader
  158. X
  159. X     SYNOPSIS
  160. X          tin [options] [newsgroups]
  161. X
  162. X     DESCRIPTION
  163. X          _T_i_n is a full-screen threaded Usenet newsreader.  It can read
  164. X          news locally (ie. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (-r option) via a
  165. X          NNTP (Network News Transport Protocol) server.
  166. X
  167. X          Tin has three newsreading levels: the newsgroup selection page,
  168. X          the group index page and the article viewer.  Use the 'h' (help)
  169. X          command to view a list of the commands available at a particular
  170. X          level, or the 'H' command to view context sensitive help.
  171. X
  172. X          On startup Tin will show a list of the newsgroups found in
  173. X          $_H_O_M_E/._n_e_w_s_r_c.  An arrow '->' or highlighted bar will point to
  174. X          the first newsgroup.  Move to a group by using the terminal arrow
  175. X          keys (ansi/at386/vt100 only) or page up/down. Enter a newsgroup
  176. X          by pressing RETURN.
  177. X
  178. X          The TAB key may be used to advance to the next newsgroup with
  179. X          unread articles and enter it.
  180. X
  181. X     OPTIONS
  182. X
  183. X          -c        create/update index files for every group in
  184. X                    $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and mark
  185. X                    all articles as read.
  186. X
  187. X          -d dir    save articles to directory. Default is $_H_O_M_E/_N_e_w_s.
  188. X
  189. X          -f file   Use the indicated file in place of $_H_O_M_E/._n_e_w_s_r_c.
  190. X
  191. X          -h        help.
  192. X
  193. X          -m file   mail program to use for sending mail. Default is
  194. X                    /_u_s_r/_u_c_b/_m_a_i_l.
  195. X
  196. X          -M dir    mailbox directory to use. Default is $_H_O_M_E/_M_a_i_l.
  197. X
  198. X          -n        notify the user of any new newsgroups since last ses-
  199. X                    sion.
  200. X
  201. X          -p file   print program with options. Default is /_u_s_r/_u_c_b/_l_p_r.
  202. X
  203. X          -r        read news remotely from the default NNTP server speci-
  204. X                    fied in the environment variable NNTPSERVER or con-
  205. X                    tained in the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
  206. X
  207. X          -s dir    spool directory where news is stored. Default is
  208. X                    /_u_s_r/_s_p_o_o_l/_n_e_w_s.
  209. X
  210. X
  211. X                                                                          1
  212. X
  213. X
  214. X
  215. X
  216. X
  217. X
  218. X     TIN(1)                                                 Version 1.0 PL3
  219. X
  220. X
  221. X          -S        save news articles for later reading. Useful when going
  222. X                    on holiday and you don't want to return and find that
  223. X                    expire has removed a whole load of unread articles.
  224. X                    Best to run from crontab everyday while away. After
  225. X                    each run the user will be mailed a report of which
  226. X                    articles were saved in which groups and the total
  227. X                    number of articles saved. To keep your $_H_O_M_E/._n_e_w_s_r_c
  228. X                    upto date specify the -u option as well. Articles are
  229. X                    saved in a private news structure under your <savedir>
  230. X                    directory (default is $_H_O_M_E/_N_e_w_s). Be careful of using
  231. X                    this option if you read a lot of groups because you
  232. X                    could overflow your filesystem. If you only want to
  233. X                    save a few groups it would be best to backup your full
  234. X                    $_H_O_M_E/._n_e_w_s_r_c and create a new one that only contains
  235. X                    the groups you want to save. Saved news can be read
  236. X                    later by starting tin with the -s <savedir> option.
  237. X
  238. X          -u        create/update index files for every group in
  239. X                    $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option.
  240. X
  241. X          -U        start tin in the background to update index files while
  242. X                    reading news in the foreground.
  243. X
  244. X          -v        verbose mode for -c -u and -Z options.
  245. X
  246. X          -z        only start tin if there is any new/unread news. If
  247. X                    there is news tin will position cursor at first group
  248. X                    with unread news. Useful for putting in login file.
  249. X
  250. X          -Z        check if there is any new/unread news and exit with
  251. X                    appropiate status.  If -v option is specified the
  252. X                    number of unread articles in each group is printed. An
  253. X                    exit code 0 indicates no news, 1 that an error occurred
  254. X                    and 2 that new/unread news exists. Useful for writing
  255. X                    scripts.
  256. X
  257. X          Tin can also dynamically change its options by the 'M' menu com-
  258. X          mand.  Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
  259. X
  260. X     INDEX FILES
  261. X          In order to keep track of threads, Tin maintains an index for
  262. X          each group.  If Tin is made setuid to news, the indexes will be
  263. X          stored in the news spool directory (typically /_u_s_r/_s_p_o_o_l/_n_e_w_s).
  264. X          If Tin is not setuid, it will store index files in the subdirec-
  265. X          tory $_H_O_M_E/._t_i_n/._i_n_d_e_x.  Do not make Tin setuid news if news will
  266. X          be obtained via NNTP and not from /_u_s_r/_s_p_o_o_l/_n_e_w_s.
  267. X
  268. X          Entering a group the first time tends to be slow because the
  269. X          index file must be built from scratch.  Subsequent readings of a
  270. X          group will cause Tin to incrementally update the index file,
  271. X          adding or removing entries as new articles come in or as news
  272. X          expires. If reading news remotely indexing will be somewhat
  273. X          slower because the articles must be retrieved via the NNTP.
  274. X
  275. X
  276. X
  277. X     2
  278. X
  279. X
  280. X
  281. X
  282. X
  283. X
  284. X     Version 1.0 PL3                                                 TIN(1)
  285. X
  286. X
  287. X          A good way to keep Tin index files current is to run tin -u from
  288. X          cron:
  289. X               20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/tin_groups
  290. X          This would update the index files for those groups appearing in
  291. X          /_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 the sys-
  292. X          tem, run tin -u with -f indicating the active file:
  293. X               20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/active
  294. X
  295. X     SCREEN FORMAT
  296. X          Tin has three separate levels of operation: Selection Group
  297. X          level, Group level and Article level.
  298. X
  299. X          At the Selection Group level the title displays the number of
  300. X          subscribed groups. The newsgroups are displayed on the left of
  301. X          the screen with the number of unread articles displayed on the
  302. X          same line in the middle of the screen.
  303. X                    <Selection Num> <Newsgroup> <Num of unread articles>
  304. X               i.e.,
  305. X                    1  alt.sources            10
  306. X                    2  comp.sources.misc      3
  307. X                    3  news.software.readers  12
  308. X
  309. X          At the Group level the title contains the name of the group, the
  310. X          number of conversation threads and total number of articles i.e.,
  311. X          alt.sources (7 23).  If the group has been setup not to thread
  312. X          articles (i.e., alt.sources is in $(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the
  313. X          title will be alt.sources (U 23).  There are two possible display
  314. X          formats as shown below:
  315. X                    288<Selection Num> <Unread> <Responses> <Subject> <Author>
  316. X               i.e.,
  317. X                    1  +3Bnews sources?iain@estevax
  318. X                    2  1This question hasether@net
  319. X               or
  320. X                    <Selection Num> <Unread> <Responses> <Subject (longer)>
  321. X               i.e.,
  322. X                    1  +    3                                      Bnews sources?
  323. X                    2       1                                      This question has a longer subject line
  324. X
  325. X          At the Article level the page header has the following format:
  326. X                    <Date posted> <Newsgroup>    <Thread 1 of n>
  327. X                    <Article Num> <Subject>      <Num of responses in thread>
  328. X                    <Author>                     <Organization>
  329. X
  330. X                    <Article body>
  331. X               i.e.,
  332. X                    24 Jul 15:20:03 GMT   alt.sources      Thread 1 of 2
  333. X                    Article 452           Bnews sources?   3 responses
  334. X                    iain@estevax                           Siemens AG, Germany
  335. X
  336. X                    <Article boby>
  337. X
  338. X
  339. X
  340. X
  341. X
  342. X
  343. X                                                                          3
  344. X
  345. X
  346. X
  347. X
  348. X
  349. X
  350. X     TIN(1)                                                 Version 1.0 PL3
  351. X
  352. X
  353. X     COMMON MOVING KEYS
  354. X          This table shows the common keys/commands for moving at all three
  355. X          levels within Tin.
  356. X                                          ansi/at386/vt100  Other Terminals
  357. X               Beginning of list/article  Home              1 (^R or g at article level)
  358. X               End of list/article        End               $ (also G at article level)
  359. X               Page Up                    PgUp              ^U or b
  360. X               Page Down                  PgDn              ^D or <SPACE>
  361. X               Line Up                    Up arrow          k (not at article level)
  362. X               Line Down                  Down arrow        j (not at article level)
  363. X
  364. X     NEWSGROUP SELECTION COMMANDS
  365. X
  366. X          4         Select group 4.
  367. X
  368. X          ^K        Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
  369. X
  370. X          ^L        Redraw page.
  371. X
  372. X          ^R        Reset $_H_O_M_E/._n_e_w_s_r_c file.
  373. X
  374. X          <CR>      Read current group.
  375. X
  376. X          <TAB>     View next unread group.
  377. X
  378. X          B         Mail a bug/gripe/comment to the author of tin. This is
  379. X                    the best way of getting bugs fixed and features
  380. X                    added/changed.
  381. X
  382. X          c         Mark current group as all read and goto next group in
  383. X                    group selection list.
  384. X
  385. X          C         Mark current group as all read and goto next unread
  386. X                    group in group selection list.
  387. X
  388. X          g         Choose a new group by name. The position of the group
  389. X                    within the group list will also be asked for. By enter-
  390. X                    ing '1' the new group will be the first group in the
  391. X                    displayed list, by entering '8' the group will be the
  392. X                    eighth group in the list etc. By entering '$' the group
  393. X                    will be the last group displayed.
  394. X
  395. X          h         help screen of newsgroup selection commands.
  396. X
  397. X          H         help screen of context sensitive help about newsgroup
  398. X                    selection level.
  399. X
  400. X          I         Toggle inverse video.
  401. X
  402. X          m         Move the current group within the group selection list.
  403. X                    By entering '1' the group will become the first
  404. X                    displayed group in the list, by entering '8' the eighth
  405. X                    group in the list etc. By entering '$' the group will
  406. X                    be the last group displayed.
  407. X
  408. X
  409. X     4
  410. X
  411. X
  412. X
  413. X
  414. X
  415. X
  416. X     Version 1.0 PL3                                                 TIN(1)
  417. X
  418. X
  419. X          M         User configurable options menu (for more information
  420. X                    see section Options Menu).
  421. X
  422. X          q         Quit tin.
  423. X
  424. X          s         Subscribe to current group.
  425. X
  426. X          S         Subscribe to groups matching user specified pattern.
  427. X
  428. X          u         Unsubscribe to current group.
  429. X
  430. X          U         Unsubscribe to groups matching user specified pattern.
  431. X
  432. X          v         Print tin version number.
  433. X
  434. X          w         Post an article to current group.
  435. X
  436. X          W         List articles posted by user. The date posted, the
  437. X                    newsgroup and the subject are listed.
  438. X
  439. X          y         The first time this command is called it will yank in
  440. X                    all groups from /_u_s_r/_l_o_c_a_l/_n_e_w_s/_a_c_t_i_v_e that are not in
  441. X                    $_H_O_M_E/._n_e_w_s_r_c.  After any groups have been
  442. X                    subscribed/unsubscribed to, this command if pressed
  443. X                    again will reread $_H_O_M_E/._n_e_w_s_r_c and display only sub-
  444. X                    scribed groups.
  445. X
  446. X          Y         Reread group list from $_H_O_M_E/._n_e_w_s_r_c file.
  447. X
  448. X          z         Mark all articles in the current group as unread.
  449. X
  450. X          Z         Undelete previously deleted group from $_H_O_M_E/._n_e_w_s_r_c
  451. X                    file.
  452. X
  453. X          /         Group forward search.
  454. X
  455. X          ?         Group backward search.
  456. X
  457. X     GROUP INDEX COMMANDS
  458. X
  459. X          4         Select article 4.
  460. X
  461. X          ^K        Kill current article (for more information read section
  462. X                    Kill Article Menu).
  463. X
  464. X          ^L        Redraw page.
  465. X
  466. X          <CR>      Read current article.
  467. X
  468. X          <TAB>     View next unread article or group.
  469. X
  470. X          a         Author forward search.
  471. X
  472. X          A         Author backward search.
  473. X
  474. X
  475. X                                                                          5
  476. X
  477. X
  478. X
  479. X
  480. X
  481. X
  482. X     TIN(1)                                                 Version 1.0 PL3
  483. X
  484. X
  485. X          B         Mail a bug/gripe/comment to the author of tin. This is
  486. X                    the best way of getting bugs fixed and features
  487. X                    added/changed.
  488. X
  489. X          c         Mark all articles as read.
  490. X
  491. X          C         Cancel current article. It must have been posted by the
  492. X                    same user. The cancel message can be seen in the news-
  493. X                    group 'control'.
  494. X
  495. X          g         Choose a new group by name.
  496. X
  497. X          h         help screen of group index commands.
  498. X
  499. X          H         help screen of context sensitive help about group index
  500. X                    level.
  501. X
  502. X          I         Toggle inverse video.
  503. X
  504. X          K         Mark article/thread as read and advance to next unread
  505. X                    article/thread.
  506. X
  507. X          m         Mail current article / thread / articles matching pat-
  508. X                    tern / tagged articles to someone.
  509. X
  510. X          M         User configurable options menu (for more information
  511. X                    see section Options Menu).
  512. X
  513. X          n         Go to next group.
  514. X
  515. X          N         Go to next unread group.
  516. X
  517. X          o         Output current article / thread / articles matching
  518. X                    pattern / tagged articles to printer.
  519. X
  520. X          p         Go to previous group.
  521. X
  522. X          P         Go to previous unread group.
  523. X
  524. X          q         Quit tin.
  525. X
  526. X          s         Save current article / thread / articles matching pat-
  527. X                    tern / tagged articles to file / files / mailbox. To
  528. X                    save to a mailbox enter '=' or '=mailbox' when asked
  529. X                    for filename to save to. To save to <newsgroup
  530. X                    name>/<filename> enter '+<filename>'.
  531. X
  532. X          T         Tag current article for mailing ('m') / piping ('|') /
  533. X                    printing ('o') / saving ('s').
  534. X
  535. X          t         Return to group selection index.
  536. X
  537. X          U         Untag all articles that were tagged for saving.
  538. X
  539. X
  540. X
  541. X     6
  542. X
  543. X
  544. X
  545. X
  546. X
  547. X
  548. X     Version 1.0 PL3                                                 TIN(1)
  549. X
  550. X
  551. X          v         Print tin version number.
  552. X
  553. X          w         Post an article to current group.
  554. X
  555. X          W         List articles posted by user. The date posted, the
  556. X                    newsgroup and the subject are listed.
  557. X
  558. X          z         Mark current article as unread.
  559. X
  560. X          Z         Mark current thread as unread.
  561. X
  562. X          /         Search forward for specified subject.
  563. X
  564. X          ?         Search backward for specified subject.
  565. X
  566. X          -         Show last message.
  567. X
  568. X          |         Pipe current article / thread / articles matching pat-
  569. X                    tern / tagged articles into command.
  570. X
  571. X     ARTICLE COMMANDS
  572. X
  573. X          0         Read the base article in this thread.
  574. X
  575. X          4         Read response 4 in this thread.
  576. X
  577. X          ^H        Show all of the articles mail header.
  578. X
  579. X          ^K        Kill current article (for more information read section
  580. X                    Kill Article Menu).
  581. X
  582. X          ^L        Redraw page.
  583. X
  584. X          <CR>      Skip to next base article.
  585. X
  586. X          <TAB>     Advance to next page or unread article.
  587. X
  588. X          a         Author forward search.
  589. X
  590. X          A         Author backward search.
  591. X
  592. X          B         Mail a bug/gripe/comment to the author of tin. This is
  593. X                    the best way of getting bugs fixed and features
  594. X                    added/changed.
  595. X
  596. X          c         Mark all articles as read.
  597. X
  598. X          d         Toggle rot-13 decoding for this article.
  599. X
  600. X          f         Post a followup to current article.
  601. X
  602. X          F         Post a followup with a copy of the current article
  603. X                    included.
  604. X
  605. X
  606. X
  607. X                                                                          7
  608. X
  609. X
  610. X
  611. X
  612. X
  613. X
  614. X     TIN(1)                                                 Version 1.0 PL3
  615. X
  616. X
  617. X          h         Help screen of article page commands.
  618. X
  619. X          H         Help screen of context sensitive help about article
  620. X                    page level.
  621. X
  622. X          i         Return to index page.
  623. X
  624. X          I         Toggle inverse video.
  625. X
  626. X          k         Mark article as read and advance to next unread arti-
  627. X                    cle.
  628. X
  629. X          K         Mark thread as read and advance to next unread thread.
  630. X
  631. X          m         Mail current article / thread / articles matching pat-
  632. X                    tern / tagged articles to someone.
  633. X
  634. X          M         User configurable options menu (for more information
  635. X                    see section Options Menu).
  636. X
  637. X          n         Go to to the next article.
  638. X
  639. X          N         Go to to the next unread article.
  640. X
  641. X          o         Output current article / thread / articles matching
  642. X                    pattern / tagged articles to printer.
  643. X
  644. X          o         Output article/thread/tagged articles to printer.
  645. X
  646. X          p         Go to the previous article.
  647. X
  648. X          P         Go to the previous unread article.
  649. X
  650. X          q         Quit tin.
  651. X
  652. X          r         Reply through mail to author.
  653. X
  654. X          R         Reply through mail to author with a copy of the current
  655. X                    article included.
  656. X
  657. X          s         Save current article / thread / articles matching pat-
  658. X                    tern / tagged articles to file(s) / mailbox. To save to
  659. X                    a mailbox enter '=' or '=mailbox' when asked for
  660. X                    filename to save to. To save to <newsgroup
  661. X                    name>/<filename> enter '+<filename>'.
  662. X
  663. X          t         Return to group selection index.
  664. X
  665. X          v         Print tin version number.
  666. X
  667. X          w         Post an article to current group.
  668. X
  669. X          W         List articles posted by user. The date posted, the
  670. X                    newsgroup and the subject are listed.
  671. X
  672. X
  673. X     8
  674. X
  675. X
  676. X
  677. X
  678. X
  679. X
  680. X     Version 1.0 PL3                                                 TIN(1)
  681. X
  682. X
  683. X          z         Mark article as unread.
  684. X
  685. X          /         Article forward search.
  686. X
  687. X          ?         Article backward search
  688. X
  689. X          |         Pipe current article / thread / articles matching pat-
  690. X                    tern / tagged articles into command.
  691. X
  692. X          <         Goto the first article in the current thread.
  693. X
  694. X          >         Goto the last article in the current thread.
  695. X
  696. X     OPTIONS MENU
  697. X          This menu is accessed by pressing 'M' at all levels. It allows
  698. X          the user to customize the behaviour of tin. The options are saved
  699. X          to the file $_H_O_M_E/._t_i_n/_t_i_n_r_c. The following options are settable:
  700. X
  701. X          Auto save
  702. X              Automatically save articles/threads by Archive-name: line in
  703. X              article header. This is useful to set ON in conjunction with
  704. X              'Save separate'.  Use <SPACE> to toggle ON/OFF and <CR> to
  705. X              set.
  706. X
  707. X          Save separate
  708. X              Save articles/threads to separate files. Set ON if saving
  709. X              source code.  Set OFF if saving a coversational thread. Use
  710. X              <SPACE> to toggle ON/OFF and <CR> to set.
  711. X
  712. X          Mark saved read
  713. X              This allows saved articles/threads to be automatically marked
  714. X              as having been read. Use <SPACE> to toggle ON/OFF and <CR> to
  715. X              set.
  716. X
  717. X          Kill articles
  718. X              This allows the user to kill articles that match entries in
  719. X              the kill file $_H_O_M_E/._t_i_n/_k_i_l_l. Use <SPACE> to toggle ON/OFF
  720. X              and <CR> to set.
  721. X
  722. X          Show Author
  723. X              If set ON the Subject: & From: (author) lines from the arti-
  724. X              cles header are displayed. If set OFF longer Subject: lines
  725. X              are displayed. Use <SPACE> to toggle ON/OFF and <CR> to set.
  726. X
  727. X          Draw arrow
  728. X              Allows groups/articles to be selected by an arrow '->' if set
  729. X              ON or by an highlighted bar if set OFF. Use <SPACE> to toggle
  730. X              ON/OFF and <CR> to set.
  731. X
  732. X          Print header
  733. X              This allows the complete mail header or only the Siubject:
  734. X              and From: fields to be output when printing articles. Use
  735. X              <SPACE> to toggle ON/OFF and <CR> to set.
  736. X
  737. X
  738. X
  739. X                                                                          9
  740. X
  741. X
  742. X
  743. X
  744. X
  745. X
  746. X     TIN(1)                                                 Version 1.0 PL3
  747. X
  748. X
  749. X          Goto 1st unread
  750. X              This allows the cursor to be placed at the first / last
  751. X              unread article upon entering a newsgroup with unread news.
  752. X              Use <SPACE> to toggle ON/OFF and <CR> to set.
  753. X
  754. X          Process type
  755. X              This specifies the default type of post processing to perform
  756. X              on saved articles. The following types of processing are
  757. X              allowed:
  758. X                  -none.
  759. X                  -unpacking of multi-part shell archives.
  760. X                  -unpacking of multi-part uuencoded files.
  761. X                  -unpacking of multi-part uuencoded files that produce a
  762. X                   *.zoo archive whose contents is listed.
  763. X                  -unpacking of multi-part uuencoded files that produce a
  764. X                   *.zoo archive whose contents is extracted.
  765. X                  -unpacking of multi-part patches for use by _p_a_t_c_h and
  766. X                   applying them to specified source files.
  767. X              Use <SPACE> to toggle the required type and <CR> to set.
  768. X
  769. X          Sort articles by
  770. X              This specifies how articles should be sorted. The following
  771. X              sort types are allowed:
  772. X                  -don't sort articles (default).
  773. X                  -sort articles by Subject: field (ascending & descend-
  774. X                   ing).
  775. X                  -sort articles by From: field (ascending & descending).
  776. X                  -sort articles by Date: field (ascending & descending).
  777. X              Use <SPACE> to set the required type.
  778. X
  779. X          Save directory
  780. X              The directory where articles/threads are to be saved. Default
  781. X              is $_H_O_M_E/_N_e_w_s.
  782. X
  783. X          Mail directory
  784. X              The directory where articles/threads are to be saved in mail-
  785. X              box format.  This feature is mainly for use with the Elm mail
  786. X              program. It allows the user to save articles/threads/groups
  787. X              simply by giving '=' as the filename to save to.
  788. X
  789. X          Printer
  790. X              The printer program with options that is to be used to print
  791. X              articles. Default is lpr for BSD machines and lp for SysV
  792. X              machines.
  793. X
  794. X     KILL ARTICLE MENU
  795. X          This menu is accessed by pressing '^K' at the group and page lev-
  796. X          els. It allows the user to kill an article that matches the
  797. X          current Subject: line, From: line or a string entered by the
  798. X          user. The user entered string can be applied to the Subject: or
  799. X          From: lines of an article. The kill description can be limited to
  800. X          the current newsgroup or it can apply to all newsgroups.  Once
  801. X          entered the user can abort the command and not save the kill
  802. X          description, edit the kill file or save the kill description.
  803. X
  804. X
  805. X     10
  806. X
  807. X
  808. X
  809. X
  810. X
  811. X
  812. X     Version 1.0 PL3                                                 TIN(1)
  813. X
  814. X
  815. X          On starting tin the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read and on
  816. X          entering a newsgroup any kill descriptions are applied. Articles
  817. X          that match a kill description are marked killed and are not
  818. X          displayed.
  819. X
  820. X          The 'Kill articles' option needs to be set ON in the Options Menu
  821. X          (selected by 'M' at any level) to activate this command.
  822. X
  823. X     POSTING ARTICLES
  824. X          Tin allows posting of articles, follow-up to already posted arti-
  825. X          cles and replying direct through mail to the author of an arti-
  826. X          cle.
  827. X
  828. X          Use the 'w' command to post an article to a newsgroup. After
  829. X          entering the post subject the default editor (ie. vi) or the edi-
  830. X          tor specified by the $EDITOR enviroment variable will be started
  831. X          and the article can be entered. To crosspost articles simply add
  832. X          a comma and the name of the newsgroup(s) to the end of the News-
  833. X          groups: line at the beginning of the article. After saving and
  834. X          exiting the editor you are asked if you wish to a)bort posting
  835. X          the article, e)dit the article again or p)ost the article to the
  836. X          specified newsgroup(s).
  837. X
  838. X          Use the 'W' command to display a history of the articles you have
  839. X          posted.  The date the article was posted, which newsgroups the
  840. X          article was posted to and the articles subject line are
  841. X          displayed.
  842. X
  843. X          Use the 'f' / 'F' command to post a follow-up article to an
  844. X          already posted article. The 'F' command will copy the text of the
  845. X          original article into the editor. The editing procedure is the
  846. X          same as when posting an article with the 'w' command.
  847. X
  848. X          Use the 'r' / 'R' command to reply direct through mail to the
  849. X          author of an already posted article. The 'R' command will copy
  850. X          the text of the original article into the editor. The editing
  851. X          procedure is the same as when posting an article with the 'w'
  852. X          command. After saving and exiting the editor you are asked if you
  853. X          wish to a)bort sending the article, e)dit the article again or
  854. X          s)end the article to the author.
  855. X
  856. X     MAILING PIPING PRINTING AND SAVING ARTICLES
  857. X          The command interface to mail ('m'), pipe ('|'), print ('o') and
  858. X          save ('s') articles is the same for ease of use.
  859. X
  860. X          The initial command will ask you to select which a)rticle,
  861. X          t)hread, r)egex pattern, t)agged articles you wish to mail, pipe
  862. X          etc.
  863. X
  864. X          Tagged articles must have already been tagged with the 'T' com-
  865. X          mand.  All tagged articles can be untagged by the 'U' untag com-
  866. X          mand.
  867. X
  868. X
  869. X
  870. X
  871. X                                                                         11
  872. X
  873. X
  874. X
  875. X
  876. X
  877. X
  878. X     TIN(1)                                                 Version 1.0 PL3
  879. X
  880. X
  881. X          If regex pattern matching is selected you are asked to enter a
  882. X          regular expression (ie. to match all articles subject lines con-
  883. X          taining 'net News' you must enter '*net News*'). Any articles
  884. X          that match the entered expression will be mailed, piped etc.
  885. X
  886. X          To save articles to a mailbox with the name of the current news-
  887. X          group (ie. Alt.sources) enter '=' or '=<mailbox name>' when asked
  888. X          for the save filename.
  889. X
  890. X          To save articles in <newsgroup name>/<filename> format enter
  891. X          '+<filename>'.
  892. X
  893. X          When saving articles you can specify whether the saved files
  894. X          should be post processed (ie. unshar shell archive, uudecode mul-
  895. X          tiple parts etc).  A default process type can be set by the 'Pro-
  896. X          cess type:' in the 'M' options menu.
  897. X
  898. X     SIGNATURES
  899. X          Tin will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
  900. 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 will
  901. X          be pulled into the editor for Tin mail commands.  A signature in
  902. X          $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the editor for posting
  903. X          commands since the inews program will append the signature
  904. X          itself.
  905. X
  906. X          A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for both
  907. X          posting and mailing commands.
  908. X
  909. X          The following is an example of a $_H_O_M_E/._S_i_g file:
  910. X               NAME   Iain Lea
  911. X               EMAIL  iain@estevax.uucp    ...!unido!estevax!iain
  912. X               SNAIL  Siemens AG, ANL 433SZ, 8510 Fuerth-Bislohe, Germany
  913. X               PHONE  +49-911-331963 (home)  +49-911-3089-407 (work)
  914. X
  915. X     ENVIROMENT VARIABLES
  916. X
  917. X          TINDIR
  918. X               Define this variable if you do not want tin's .tin directory
  919. X               in $HOME/.tin.  (ie. if you want all tin's private files in
  920. X               /tmp/.tin you would set TINDIR to contain /tmp.
  921. X
  922. X          NNTPSERVER
  923. X               The default NNTP server to remotely read news from. This
  924. X               variable only needs to be set if the -r command line option
  925. X               is specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r does not exist.
  926. X
  927. X          ORGANIZATION
  928. X               Set the mail header field Organization: to the contents of
  929. X               the variable instead of the system default. This variable
  930. X               has precedence over the file $_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n that
  931. X               may also contain an organization string.
  932. X
  933. X          REPLYTO
  934. X               Set the mail header field Reply-To: to the return address
  935. X
  936. X
  937. X     12
  938. X
  939. X
  940. X
  941. X
  942. X
  943. X
  944. X     Version 1.0 PL3                                                 TIN(1)
  945. X
  946. X
  947. X               specified by the variable.  This is useful if the machine is
  948. X               not registered in the UUCP mail maps or if you wish to
  949. X               recieve replies at a different machine.  This variable has
  950. X               precedence over the file $_H_O_M_E/._t_i_n/_r_e_p_l_y__t_o that may also
  951. X               contain a return address.
  952. X
  953. X          ADD_ADDRESS
  954. X               This can contain an address to append to the return address
  955. X               when replying directly through mail to somebody whose mail
  956. X               address is not directly recognized by the local host. For
  957. X               example say the return address is _u_s_e_r@_b_i_g_v_a_x, but _b_i_g_v_a_x is
  958. X               not recognized by your host, so therfore the mail will not
  959. X               reach _u_s_e_r. But the host _l_i_t_t_e_v_a_x is known to recognize your
  960. X               host and _b_i_g_v_a_x, so if ADD_ADDRESS is set (ie. 'setenv
  961. X               ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS @lit-
  962. X               tevax' and 'export ADD_ADDRESS' for sh) the address
  963. X               _u_s_e_r@_b_i_g_v_a_x@_l_i_t_t_l_e_v_a_x will be used and the mail will reach
  964. X               _u_s_e_r@_b_i_g_v_a_x.  This variable has precedence over the file
  965. X               $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s that may also contain an address.
  966. X
  967. X          BUG_ADDRESS
  968. X               If the 'B' command bug report mail address is not correct
  969. X               this variable should be set to the correct mail address.
  970. X               This variable has precedence over the file
  971. X               $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s that may also contain a mail address.
  972. X
  973. X          EDITOR
  974. X               This variable has precedence over the default editor (ie.
  975. X               vi) that is used in all editing operations within tin (ie.
  976. X               posting 'w', replying 'rR', follow-ups 'fF' and bug reports
  977. X               'B').
  978. X
  979. X     TIPS AND TRICKS
  980. X          The following newsgroups provide useful information concerning
  981. X          news software:
  982. X              -news.software.readers (info. about news user agents
  983. X               tin,rn,nn,vn etc.)
  984. X              -news.software.nntp (info. about NNTP)
  985. X              -news.software.b (info. about news transport agents Bnews &
  986. X               Cnews)
  987. X
  988. X          Many prompts (ie. 'Mark everything as read? (y/n): y') within tin
  989. X          offer a default choice that the cursor is positioned on. By
  990. X          pressing <CR> the default value is taken.
  991. X
  992. X          When tin is run in an xterm window it will resize itself each
  993. X          time the xterm is resized.
  994. X
  995. X     FILES
  996. X          $_H_O_M_E/._n_e_w_s_r_c             newgroups subscribed to.
  997. X          $_H_O_M_E/._t_i_n/_t_i_n_r_c          options.
  998. X          $_H_O_M_E/._t_i_n/._i_n_d_e_x         newsgroup index files directory.
  999. X          $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s    address to add to when replying through mail.
  1000. X          $_H_O_M_E/._t_i_n/_a_c_t_i_v_e         used by -n option for notifying user of new groups.
  1001. X
  1002. X
  1003. X                                                                         13
  1004. X
  1005. X
  1006. X
  1007. X
  1008. X
  1009. X
  1010. X     TIN(1)                                                 Version 1.0 PL3
  1011. X
  1012. X
  1013. X          $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s    address to send bug reports to.
  1014. X          $_H_O_M_E/._t_i_n/_k_i_l_l           kill file.
  1015. X          $_H_O_M_E/._t_i_n/_o_r_g_a_n_i_z_a_t_i_o_n   string to replace default organization.
  1016. X          $_H_O_M_E/._t_i_n/_p_o_s_t_e_d         history of articles posted by user.
  1017. X          $_H_O_M_E/._t_i_n/_r_e_p_l_y__t_o       host address to use in Reply-To: mail header.
  1018. X          $_H_O_M_E/._t_i_n/_u_n_t_h_r_e_a_d       contains groups that are not to be threaded.
  1019. X          $_H_O_M_E/._s_i_g_n_a_t_u_r_e          signature.
  1020. X          $_H_O_M_E/._S_i_g                signature.
  1021. X
  1022. X     BUGS
  1023. X          There are bugs somewhere among the creeping featurism. Any bugs
  1024. X          found should be reported by the 'B' (bug report) command.
  1025. X
  1026. X          There is a bug when article killing is switched ON/OFF at article
  1027. X          page level and the 't' command is used to return to group selec-
  1028. X          tion index.
  1029. X
  1030. X          When articles have been unkilled, all articles will be marked
  1031. X          unread even if they have already been read.
  1032. X
  1033. X          Killing articles when tin is setuid causes strange behaviour.
  1034. X
  1035. X          Will not uudecode some of the images in alt.binaries.pictures
  1036. X          because more than one image is in the multi-part file to
  1037. X          uudecode. Only the first image will be uudecoded.
  1038. X
  1039. X          Does not handle Xref: headers for cross-posted articles.
  1040. X
  1041. X     HISTORY
  1042. X          Based on the tass newsreader that was developed by Rich Skrenta
  1043. X          and posted to alt.sources in March 1991. Tass was itself heavily
  1044. X          infleuenced by NOTES which was developed at the University of
  1045. X          Illinois in the 1970's.
  1046. X
  1047. X     CREDITS
  1048. X
  1049. X          Rich Skrenta
  1050. X               author of tass v3.2 which this newsreader used as its base.
  1051. X
  1052. X          Syd Weinstein
  1053. X               curses.c is taken from the elm mailreader
  1054. X
  1055. X          Rich Salz
  1056. X               author of wildmat.c pattern matching routines.
  1057. X
  1058. X          Chris Smith
  1059. X               author of multi-part uudecode routine.
  1060. X
  1061. X          I wish to thank the following people for bug reports/patchs and
  1062. X          comments:
  1063. X
  1064. X          Klaus Arzig, Anton Aylward, Reiner Balling, Volker Beyer, Roger
  1065. X          Binns, Georg Biehler, Andreas Brosig, Peter Dressler, Gerhard
  1066. X          Ermer, Hugh Fader, Joachim Feld, Bernhard Gmelch, Viet Hoang,
  1067. X
  1068. X
  1069. X     14
  1070. X
  1071. X
  1072. X
  1073. X
  1074. X
  1075. X
  1076. X     Version 1.0 PL3                                                 TIN(1)
  1077. X
  1078. X
  1079. X          Torsten Homeyer, Andy Jackson, Joe Johnson, Cyrill Jung, Karl-
  1080. X          Koenig Koenigsson, Hans-Juergen Knopp, Bob Lukas, Clifford Luke,
  1081. X          Phillip Molloy, Toni Metz, Greg Miller, Klaus Neuberger, Otto
  1082. X          Niesser, Wolf Paul, Nickolay Saukh, Rich Salz, Fredy Schwatz,
  1083. X          Bernd Schwerin, Klamer Schutte, Karl-Olav Serrander, Chris Smith,
  1084. X          Steve Spearman, Cliff Stanford, Adri Verhoef, Cary Whitney
  1085. X
  1086. X     AUTHOR
  1087. X
  1088. X          Iain Lea
  1089. X               (iain@estevax.uucp or ...!unido!estevax!iain)
  1090. X
  1091. X
  1092. X
  1093. X
  1094. X
  1095. X
  1096. X
  1097. X
  1098. X
  1099. X
  1100. X
  1101. X
  1102. X
  1103. X
  1104. X
  1105. X
  1106. X
  1107. X
  1108. X
  1109. X
  1110. X
  1111. X
  1112. X
  1113. X
  1114. X
  1115. X
  1116. X
  1117. X
  1118. X
  1119. X
  1120. X
  1121. X
  1122. X
  1123. X
  1124. X
  1125. X
  1126. X
  1127. X
  1128. X
  1129. X
  1130. X
  1131. X
  1132. X
  1133. X
  1134. X
  1135. X                                                                         15
  1136. SHAR_EOF
  1137. $TOUCH -am 0930190191 tin.nrf &&
  1138. chmod 0600 tin.nrf ||
  1139. echo "restore of tin.nrf failed"
  1140. set `wc -c tin.nrf`;Wc_c=$1
  1141. if test "$Wc_c" != "36817"; then
  1142.     echo original size 36817, current size $Wc_c
  1143. fi
  1144. rm -f shar3_seq_.tmp
  1145. echo "You have unpacked the last part"
  1146. exit 0
  1147.  
  1148. exit 0 # Just in case...
  1149. -- 
  1150. Kent Landfield                   INTERNET: kent@sparky.IMD.Sterling.COM
  1151. Sterling Software, IMD           UUCP:     uunet!sparky!kent
  1152. Phone:    (402) 291-8300         FAX:      (402) 291-4362
  1153. Please send comp.sources.misc-related mail to kent@uunet.uu.net.
  1154.