home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-10-19 | 41.9 KB | 1,154 lines |
- Newsgroups: comp.sources.misc
- From: iain@norisc.siemens.de (Iain J. Lea)
- Subject: v23i081: tin - threaded full screen newsreader, Patch03d/4
- Message-ID: <1991Oct20.032103.24769@sparky.imd.sterling.com>
- X-Md4-Signature: 8bfe35cbc10c7c3ca75d497a10840ec1
- Date: Sun, 20 Oct 1991 03:21:03 GMT
- Approved: kent@sparky.imd.sterling.com
-
- Submitted-by: iain@norisc.siemens.de (Iain J. Lea)
- Posting-number: Volume 23, Issue 81
- Archive-name: tin/patch03d
- Environment: BSD, SCO, ISC, SUNOS, SYSVR3, SYSVR4, ULTRIX, XENIX
- Patch-To: tin: Volume 23, Issue 15-23
-
- #!/bin/sh
- # this is tin.patch.04 (part 4 of tin1.0)
- # do not concatenate these parts, unpack them in order with /bin/sh
- # file tin.patch03 continued
- #
- if touch 2>&1 | fgrep '[-amc]' > /dev/null
- then TOUCH=touch
- else TOUCH=true
- fi
- if test ! -r shar3_seq_.tmp; then
- echo "Please unpack part 1 first!"
- exit 1
- fi
- (read Scheck
- if test "$Scheck" != 4; then
- echo "Please unpack part $Scheck next!"
- exit 1
- else
- exit 0
- fi
- ) < shar3_seq_.tmp || exit 1
- echo "x - Continuing file tin.patch03"
- sed 's/^X//' << 'SHAR_EOF' >> tin.patch03 &&
- X! extern char postfile[LEN+1];
- X
- X! extern char msg[LEN+1];
- X! extern char userid[LEN+1];
- X! extern char homedir[LEN+1];
- X! extern char add_addr[LEN+1];
- X! extern char bug_addr[LEN+1];
- X! extern char txt_help_bug_report[LEN+1];
- X! extern char reply_to[LEN+1];
- X! extern char my_org[LEN+1];
- X! extern char active_file[LEN+1];
- X! extern char newsrc[LEN+1];
- X! extern char newnewsrc[LEN+1];
- X! extern char delgroups[LEN+1];
- X
- X extern char *version;
- X! extern char cvers[LEN+1];
- X! extern char progname[LEN+1];
- X! extern char article[LEN+1];
- X! extern char dead_article[LEN+1];
- X! extern char mailer[LEN+1];
- X! extern char printer[LEN+1];
- X! extern char spooldir[LEN+1];
- X! extern char savedir[LEN+1];
- X! extern char maildir[LEN+1];
- X! extern char mailbox[LEN+1];
- X! extern char page_header[LEN+1];
- X! extern char signature[LEN+1];
- X! extern char sig[LEN+1];
- X! extern char killsubj[LEN+1];
- X! extern char killfrom[LEN+1];
- X! extern char author_search_string[LEN+1];
- X! extern char group_search_string[LEN+1];
- X! extern char subject_search_string[LEN+1];
- X! extern char art_search_string[LEN+1];
- X extern char default_mail_address[LEN];
- X extern char default_pipe_command[LEN];
- X extern char default_regex_pattern[LEN];
- X extern char default_save_file[LEN];
- X extern char proc_ch_default; /* set in change_rcfile () */
- X
- X extern char *help_select[];
- X--- 346,397 ----
- X extern int num_of_tagged_files;
- X extern int compiled_with_nntp;
- X extern int save_news;
- X+ extern int thread_arts;
- X
- X! extern char rcdir[LEN];
- X! extern char rcfile[LEN];
- X! extern char indexdir[LEN];
- X! extern char killfile[LEN];
- X! extern char postfile[LEN];
- X
- X! extern char msg[LEN];
- X! extern char userid[LEN];
- X! extern char homedir[LEN];
- X! extern char add_addr[LEN];
- X! extern char bug_addr[LEN];
- X! extern char txt_help_bug_report[LEN];
- X! extern char reply_to[LEN];
- X! extern char my_org[LEN];
- X! extern char active_file[LEN];
- X! extern char newsrc[LEN];
- X! extern char newnewsrc[LEN];
- X! extern char delgroups[LEN];
- X
- X extern char *version;
- X! extern char cvers[LEN];
- X! extern char progname[LEN];
- X! extern char article[LEN];
- X! extern char dead_article[LEN];
- X! extern char mailer[LEN];
- X! extern char printer[LEN];
- X! extern char spooldir[LEN];
- X! extern char savedir[LEN];
- X! extern char maildir[LEN];
- X! extern char mailbox[LEN];
- X! extern char page_header[LEN];
- X! extern char signature[LEN];
- X! extern char sig[LEN];
- X! extern char killsubj[LEN];
- X! extern char killfrom[LEN];
- X! extern char author_search_string[LEN];
- X! extern char group_search_string[LEN];
- X! extern char subject_search_string[LEN];
- X! extern char art_search_string[LEN];
- X extern char default_mail_address[LEN];
- X extern char default_pipe_command[LEN];
- X extern char default_regex_pattern[LEN];
- X extern char default_save_file[LEN];
- X+ extern char default_shell_command[LEN];
- X extern char proc_ch_default; /* set in change_rcfile () */
- X
- X extern char *help_select[];
- XOnly in 103: tin.nrf
- XOnly in 102: tmp
- XFiles 102/wildmat.3 and 103/wildmat.3 are identical
- XFiles 102/wildmat.c and 103/wildmat.c are identical
- SHAR_EOF
- echo "File tin.patch03 is complete" &&
- $TOUCH -am 0930190991 tin.patch03 &&
- chmod 0600 tin.patch03 ||
- echo "restore of tin.patch03 failed"
- set `wc -c tin.patch03`;Wc_c=$1
- if test "$Wc_c" != "141957"; then
- echo original size 141957, current size $Wc_c
- fi
- # ============= tin.nrf ==============
- echo "x - extracting tin.nrf (Text)"
- sed 's/^X//' << 'SHAR_EOF' > tin.nrf &&
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X
- X NAME
- X tin - Visual threaded Usenet news reader
- X
- X SYNOPSIS
- X tin [options] [newsgroups]
- X
- X DESCRIPTION
- X _T_i_n is a full-screen threaded Usenet newsreader. It can read
- X news locally (ie. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (-r option) via a
- X NNTP (Network News Transport Protocol) server.
- X
- X Tin has three newsreading levels: the newsgroup selection page,
- X the group index page and the article viewer. Use the 'h' (help)
- X command to view a list of the commands available at a particular
- X level, or the 'H' command to view context sensitive help.
- X
- X On startup Tin will show a list of the newsgroups found in
- X $_H_O_M_E/._n_e_w_s_r_c. An arrow '->' or highlighted bar will point to
- X the first newsgroup. Move to a group by using the terminal arrow
- X keys (ansi/at386/vt100 only) or page up/down. Enter a newsgroup
- X by pressing RETURN.
- X
- X The TAB key may be used to advance to the next newsgroup with
- X unread articles and enter it.
- X
- X OPTIONS
- X
- X -c create/update index files for every group in
- X $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and mark
- X all articles as read.
- X
- X -d dir save articles to directory. Default is $_H_O_M_E/_N_e_w_s.
- X
- X -f file Use the indicated file in place of $_H_O_M_E/._n_e_w_s_r_c.
- X
- X -h help.
- X
- X -m file mail program to use for sending mail. Default is
- X /_u_s_r/_u_c_b/_m_a_i_l.
- X
- X -M dir mailbox directory to use. Default is $_H_O_M_E/_M_a_i_l.
- X
- X -n notify the user of any new newsgroups since last ses-
- X sion.
- X
- X -p file print program with options. Default is /_u_s_r/_u_c_b/_l_p_r.
- X
- X -r read news remotely from the default NNTP server speci-
- X fied in the environment variable NNTPSERVER or con-
- X tained in the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
- X
- X -s dir spool directory where news is stored. Default is
- X /_u_s_r/_s_p_o_o_l/_n_e_w_s.
- X
- X
- X 1
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X -S save news articles for later reading. Useful when going
- X on holiday and you don't want to return and find that
- X expire has removed a whole load of unread articles.
- X Best to run from crontab everyday while away. After
- X each run the user will be mailed a report of which
- X articles were saved in which groups and the total
- X number of articles saved. To keep your $_H_O_M_E/._n_e_w_s_r_c
- X upto date specify the -u option as well. Articles are
- X saved in a private news structure under your <savedir>
- X directory (default is $_H_O_M_E/_N_e_w_s). Be careful of using
- X this option if you read a lot of groups because you
- X could overflow your filesystem. If you only want to
- X save a few groups it would be best to backup your full
- X $_H_O_M_E/._n_e_w_s_r_c and create a new one that only contains
- X the groups you want to save. Saved news can be read
- X later by starting tin with the -s <savedir> option.
- X
- X -u create/update index files for every group in
- X $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option.
- X
- X -U start tin in the background to update index files while
- X reading news in the foreground.
- X
- X -v verbose mode for -c -u and -Z options.
- X
- X -z only start tin if there is any new/unread news. If
- X there is news tin will position cursor at first group
- X with unread news. Useful for putting in login file.
- X
- X -Z check if there is any new/unread news and exit with
- X appropiate status. If -v option is specified the
- X number of unread articles in each group is printed. An
- X exit code 0 indicates no news, 1 that an error occurred
- X and 2 that new/unread news exists. Useful for writing
- X scripts.
- X
- X Tin can also dynamically change its options by the 'M' menu com-
- X mand. Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
- X
- X INDEX FILES
- X In order to keep track of threads, Tin maintains an index for
- X each group. If Tin is made setuid to news, the indexes will be
- X stored in the news spool directory (typically /_u_s_r/_s_p_o_o_l/_n_e_w_s).
- X If Tin is not setuid, it will store index files in the subdirec-
- X tory $_H_O_M_E/._t_i_n/._i_n_d_e_x. Do not make Tin setuid news if news will
- X be obtained via NNTP and not from /_u_s_r/_s_p_o_o_l/_n_e_w_s.
- X
- X Entering a group the first time tends to be slow because the
- X index file must be built from scratch. Subsequent readings of a
- X group will cause Tin to incrementally update the index file,
- X adding or removing entries as new articles come in or as news
- X expires. If reading news remotely indexing will be somewhat
- X slower because the articles must be retrieved via the NNTP.
- X
- X
- X
- X 2
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X A good way to keep Tin index files current is to run tin -u from
- X cron:
- X 20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/tin_groups
- X This would update the index files for those groups appearing in
- 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-
- X tem, run tin -u with -f indicating the active file:
- X 20 6 * * * /usr/local/bin/tin -u -f /usr/lib/news/active
- X
- X SCREEN FORMAT
- X Tin has three separate levels of operation: Selection Group
- X level, Group level and Article level.
- X
- X At the Selection Group level the title displays the number of
- X subscribed groups. The newsgroups are displayed on the left of
- X the screen with the number of unread articles displayed on the
- X same line in the middle of the screen.
- X <Selection Num> <Newsgroup> <Num of unread articles>
- X i.e.,
- X 1 alt.sources 10
- X 2 comp.sources.misc 3
- X 3 news.software.readers 12
- X
- X At the Group level the title contains the name of the group, the
- X number of conversation threads and total number of articles i.e.,
- X alt.sources (7 23). If the group has been setup not to thread
- X articles (i.e., alt.sources is in $(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the
- X title will be alt.sources (U 23). There are two possible display
- X formats as shown below:
- X 288<Selection Num> <Unread> <Responses> <Subject> <Author>
- X i.e.,
- X 1 +3Bnews sources?iain@estevax
- X 2 1This question hasether@net
- X or
- X <Selection Num> <Unread> <Responses> <Subject (longer)>
- X i.e.,
- X 1 + 3 Bnews sources?
- X 2 1 This question has a longer subject line
- X
- X At the Article level the page header has the following format:
- X <Date posted> <Newsgroup> <Thread 1 of n>
- X <Article Num> <Subject> <Num of responses in thread>
- X <Author> <Organization>
- X
- X <Article body>
- X i.e.,
- X 24 Jul 15:20:03 GMT alt.sources Thread 1 of 2
- X Article 452 Bnews sources? 3 responses
- X iain@estevax Siemens AG, Germany
- X
- X <Article boby>
- X
- X
- X
- X
- X
- X
- X 3
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X COMMON MOVING KEYS
- X This table shows the common keys/commands for moving at all three
- X levels within Tin.
- X ansi/at386/vt100 Other Terminals
- X Beginning of list/article Home 1 (^R or g at article level)
- X End of list/article End $ (also G at article level)
- X Page Up PgUp ^U or b
- X Page Down PgDn ^D or <SPACE>
- X Line Up Up arrow k (not at article level)
- X Line Down Down arrow j (not at article level)
- X
- X NEWSGROUP SELECTION COMMANDS
- X
- X 4 Select group 4.
- X
- X ^K Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
- X
- X ^L Redraw page.
- X
- X ^R Reset $_H_O_M_E/._n_e_w_s_r_c file.
- X
- X <CR> Read current group.
- X
- X <TAB> View next unread group.
- X
- X B Mail a bug/gripe/comment to the author of tin. This is
- X the best way of getting bugs fixed and features
- X added/changed.
- X
- X c Mark current group as all read and goto next group in
- X group selection list.
- X
- X C Mark current group as all read and goto next unread
- X group in group selection list.
- X
- X g Choose a new group by name. The position of the group
- X within the group list will also be asked for. By enter-
- X ing '1' the new group will be the first group in the
- X displayed list, by entering '8' the group will be the
- X eighth group in the list etc. By entering '$' the group
- X will be the last group displayed.
- X
- X h help screen of newsgroup selection commands.
- X
- X H help screen of context sensitive help about newsgroup
- X selection level.
- X
- X I Toggle inverse video.
- X
- X m Move the current group within the group selection list.
- X By entering '1' the group will become the first
- X displayed group in the list, by entering '8' the eighth
- X group in the list etc. By entering '$' the group will
- X be the last group displayed.
- X
- X
- X 4
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X M User configurable options menu (for more information
- X see section Options Menu).
- X
- X q Quit tin.
- X
- X s Subscribe to current group.
- X
- X S Subscribe to groups matching user specified pattern.
- X
- X u Unsubscribe to current group.
- X
- X U Unsubscribe to groups matching user specified pattern.
- X
- X v Print tin version number.
- X
- X w Post an article to current group.
- X
- X W List articles posted by user. The date posted, the
- X newsgroup and the subject are listed.
- X
- X y The first time this command is called it will yank in
- 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
- X $_H_O_M_E/._n_e_w_s_r_c. After any groups have been
- X subscribed/unsubscribed to, this command if pressed
- X again will reread $_H_O_M_E/._n_e_w_s_r_c and display only sub-
- X scribed groups.
- X
- X Y Reread group list from $_H_O_M_E/._n_e_w_s_r_c file.
- X
- X z Mark all articles in the current group as unread.
- X
- X Z Undelete previously deleted group from $_H_O_M_E/._n_e_w_s_r_c
- X file.
- X
- X / Group forward search.
- X
- X ? Group backward search.
- X
- X GROUP INDEX COMMANDS
- X
- X 4 Select article 4.
- X
- X ^K Kill current article (for more information read section
- X Kill Article Menu).
- X
- X ^L Redraw page.
- X
- X <CR> Read current article.
- X
- X <TAB> View next unread article or group.
- X
- X a Author forward search.
- X
- X A Author backward search.
- X
- X
- X 5
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X B Mail a bug/gripe/comment to the author of tin. This is
- X the best way of getting bugs fixed and features
- X added/changed.
- X
- X c Mark all articles as read.
- X
- X C Cancel current article. It must have been posted by the
- X same user. The cancel message can be seen in the news-
- X group 'control'.
- X
- X g Choose a new group by name.
- X
- X h help screen of group index commands.
- X
- X H help screen of context sensitive help about group index
- X level.
- X
- X I Toggle inverse video.
- X
- X K Mark article/thread as read and advance to next unread
- X article/thread.
- X
- X m Mail current article / thread / articles matching pat-
- X tern / tagged articles to someone.
- X
- X M User configurable options menu (for more information
- X see section Options Menu).
- X
- X n Go to next group.
- X
- X N Go to next unread group.
- X
- X o Output current article / thread / articles matching
- X pattern / tagged articles to printer.
- X
- X p Go to previous group.
- X
- X P Go to previous unread group.
- X
- X q Quit tin.
- X
- X s Save current article / thread / articles matching pat-
- X tern / tagged articles to file / files / mailbox. To
- X save to a mailbox enter '=' or '=mailbox' when asked
- X for filename to save to. To save to <newsgroup
- X name>/<filename> enter '+<filename>'.
- X
- X T Tag current article for mailing ('m') / piping ('|') /
- X printing ('o') / saving ('s').
- X
- X t Return to group selection index.
- X
- X U Untag all articles that were tagged for saving.
- X
- X
- X
- X 6
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X v Print tin version number.
- X
- X w Post an article to current group.
- X
- X W List articles posted by user. The date posted, the
- X newsgroup and the subject are listed.
- X
- X z Mark current article as unread.
- X
- X Z Mark current thread as unread.
- X
- X / Search forward for specified subject.
- X
- X ? Search backward for specified subject.
- X
- X - Show last message.
- X
- X | Pipe current article / thread / articles matching pat-
- X tern / tagged articles into command.
- X
- X ARTICLE COMMANDS
- X
- X 0 Read the base article in this thread.
- X
- X 4 Read response 4 in this thread.
- X
- X ^H Show all of the articles mail header.
- X
- X ^K Kill current article (for more information read section
- X Kill Article Menu).
- X
- X ^L Redraw page.
- X
- X <CR> Skip to next base article.
- X
- X <TAB> Advance to next page or unread article.
- X
- X a Author forward search.
- X
- X A Author backward search.
- X
- X B Mail a bug/gripe/comment to the author of tin. This is
- X the best way of getting bugs fixed and features
- X added/changed.
- X
- X c Mark all articles as read.
- X
- X d Toggle rot-13 decoding for this article.
- X
- X f Post a followup to current article.
- X
- X F Post a followup with a copy of the current article
- X included.
- X
- X
- X
- X 7
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X h Help screen of article page commands.
- X
- X H Help screen of context sensitive help about article
- X page level.
- X
- X i Return to index page.
- X
- X I Toggle inverse video.
- X
- X k Mark article as read and advance to next unread arti-
- X cle.
- X
- X K Mark thread as read and advance to next unread thread.
- X
- X m Mail current article / thread / articles matching pat-
- X tern / tagged articles to someone.
- X
- X M User configurable options menu (for more information
- X see section Options Menu).
- X
- X n Go to to the next article.
- X
- X N Go to to the next unread article.
- X
- X o Output current article / thread / articles matching
- X pattern / tagged articles to printer.
- X
- X o Output article/thread/tagged articles to printer.
- X
- X p Go to the previous article.
- X
- X P Go to the previous unread article.
- X
- X q Quit tin.
- X
- X r Reply through mail to author.
- X
- X R Reply through mail to author with a copy of the current
- X article included.
- X
- X s Save current article / thread / articles matching pat-
- X tern / tagged articles to file(s) / mailbox. To save to
- X a mailbox enter '=' or '=mailbox' when asked for
- X filename to save to. To save to <newsgroup
- X name>/<filename> enter '+<filename>'.
- X
- X t Return to group selection index.
- X
- X v Print tin version number.
- X
- X w Post an article to current group.
- X
- X W List articles posted by user. The date posted, the
- X newsgroup and the subject are listed.
- X
- X
- X 8
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X z Mark article as unread.
- X
- X / Article forward search.
- X
- X ? Article backward search
- X
- X | Pipe current article / thread / articles matching pat-
- X tern / tagged articles into command.
- X
- X < Goto the first article in the current thread.
- X
- X > Goto the last article in the current thread.
- X
- X OPTIONS MENU
- X This menu is accessed by pressing 'M' at all levels. It allows
- X the user to customize the behaviour of tin. The options are saved
- X to the file $_H_O_M_E/._t_i_n/_t_i_n_r_c. The following options are settable:
- X
- X Auto save
- X Automatically save articles/threads by Archive-name: line in
- X article header. This is useful to set ON in conjunction with
- X 'Save separate'. Use <SPACE> to toggle ON/OFF and <CR> to
- X set.
- X
- X Save separate
- X Save articles/threads to separate files. Set ON if saving
- X source code. Set OFF if saving a coversational thread. Use
- X <SPACE> to toggle ON/OFF and <CR> to set.
- X
- X Mark saved read
- X This allows saved articles/threads to be automatically marked
- X as having been read. Use <SPACE> to toggle ON/OFF and <CR> to
- X set.
- X
- X Kill articles
- X This allows the user to kill articles that match entries in
- X the kill file $_H_O_M_E/._t_i_n/_k_i_l_l. Use <SPACE> to toggle ON/OFF
- X and <CR> to set.
- X
- X Show Author
- X If set ON the Subject: & From: (author) lines from the arti-
- X cles header are displayed. If set OFF longer Subject: lines
- X are displayed. Use <SPACE> to toggle ON/OFF and <CR> to set.
- X
- X Draw arrow
- X Allows groups/articles to be selected by an arrow '->' if set
- X ON or by an highlighted bar if set OFF. Use <SPACE> to toggle
- X ON/OFF and <CR> to set.
- X
- X Print header
- X This allows the complete mail header or only the Siubject:
- X and From: fields to be output when printing articles. Use
- X <SPACE> to toggle ON/OFF and <CR> to set.
- X
- X
- X
- X 9
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X Goto 1st unread
- X This allows the cursor to be placed at the first / last
- X unread article upon entering a newsgroup with unread news.
- X Use <SPACE> to toggle ON/OFF and <CR> to set.
- X
- X Process type
- X This specifies the default type of post processing to perform
- X on saved articles. The following types of processing are
- X allowed:
- X -none.
- X -unpacking of multi-part shell archives.
- X -unpacking of multi-part uuencoded files.
- X -unpacking of multi-part uuencoded files that produce a
- X *.zoo archive whose contents is listed.
- X -unpacking of multi-part uuencoded files that produce a
- X *.zoo archive whose contents is extracted.
- X -unpacking of multi-part patches for use by _p_a_t_c_h and
- X applying them to specified source files.
- X Use <SPACE> to toggle the required type and <CR> to set.
- X
- X Sort articles by
- X This specifies how articles should be sorted. The following
- X sort types are allowed:
- X -don't sort articles (default).
- X -sort articles by Subject: field (ascending & descend-
- X ing).
- X -sort articles by From: field (ascending & descending).
- X -sort articles by Date: field (ascending & descending).
- X Use <SPACE> to set the required type.
- X
- X Save directory
- X The directory where articles/threads are to be saved. Default
- X is $_H_O_M_E/_N_e_w_s.
- X
- X Mail directory
- X The directory where articles/threads are to be saved in mail-
- X box format. This feature is mainly for use with the Elm mail
- X program. It allows the user to save articles/threads/groups
- X simply by giving '=' as the filename to save to.
- X
- X Printer
- X The printer program with options that is to be used to print
- X articles. Default is lpr for BSD machines and lp for SysV
- X machines.
- X
- X KILL ARTICLE MENU
- X This menu is accessed by pressing '^K' at the group and page lev-
- X els. It allows the user to kill an article that matches the
- X current Subject: line, From: line or a string entered by the
- X user. The user entered string can be applied to the Subject: or
- X From: lines of an article. The kill description can be limited to
- X the current newsgroup or it can apply to all newsgroups. Once
- X entered the user can abort the command and not save the kill
- X description, edit the kill file or save the kill description.
- X
- X
- X 10
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X On starting tin the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read and on
- X entering a newsgroup any kill descriptions are applied. Articles
- X that match a kill description are marked killed and are not
- X displayed.
- X
- X The 'Kill articles' option needs to be set ON in the Options Menu
- X (selected by 'M' at any level) to activate this command.
- X
- X POSTING ARTICLES
- X Tin allows posting of articles, follow-up to already posted arti-
- X cles and replying direct through mail to the author of an arti-
- X cle.
- X
- X Use the 'w' command to post an article to a newsgroup. After
- X entering the post subject the default editor (ie. vi) or the edi-
- X tor specified by the $EDITOR enviroment variable will be started
- X and the article can be entered. To crosspost articles simply add
- X a comma and the name of the newsgroup(s) to the end of the News-
- X groups: line at the beginning of the article. After saving and
- X exiting the editor you are asked if you wish to a)bort posting
- X the article, e)dit the article again or p)ost the article to the
- X specified newsgroup(s).
- X
- X Use the 'W' command to display a history of the articles you have
- X posted. The date the article was posted, which newsgroups the
- X article was posted to and the articles subject line are
- X displayed.
- X
- X Use the 'f' / 'F' command to post a follow-up article to an
- X already posted article. The 'F' command will copy the text of the
- X original article into the editor. The editing procedure is the
- X same as when posting an article with the 'w' command.
- X
- X Use the 'r' / 'R' command to reply direct through mail to the
- X author of an already posted article. The 'R' command will copy
- X the text of the original article into the editor. The editing
- X procedure is the same as when posting an article with the 'w'
- X command. After saving and exiting the editor you are asked if you
- X wish to a)bort sending the article, e)dit the article again or
- X s)end the article to the author.
- X
- X MAILING PIPING PRINTING AND SAVING ARTICLES
- X The command interface to mail ('m'), pipe ('|'), print ('o') and
- X save ('s') articles is the same for ease of use.
- X
- X The initial command will ask you to select which a)rticle,
- X t)hread, r)egex pattern, t)agged articles you wish to mail, pipe
- X etc.
- X
- X Tagged articles must have already been tagged with the 'T' com-
- X mand. All tagged articles can be untagged by the 'U' untag com-
- X mand.
- X
- X
- X
- X
- X 11
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X If regex pattern matching is selected you are asked to enter a
- X regular expression (ie. to match all articles subject lines con-
- X taining 'net News' you must enter '*net News*'). Any articles
- X that match the entered expression will be mailed, piped etc.
- X
- X To save articles to a mailbox with the name of the current news-
- X group (ie. Alt.sources) enter '=' or '=<mailbox name>' when asked
- X for the save filename.
- X
- X To save articles in <newsgroup name>/<filename> format enter
- X '+<filename>'.
- X
- X When saving articles you can specify whether the saved files
- X should be post processed (ie. unshar shell archive, uudecode mul-
- X tiple parts etc). A default process type can be set by the 'Pro-
- X cess type:' in the 'M' options menu.
- X
- X SIGNATURES
- X Tin will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
- 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
- X be pulled into the editor for Tin mail commands. A signature in
- X $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the editor for posting
- X commands since the inews program will append the signature
- X itself.
- X
- X A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for both
- X posting and mailing commands.
- X
- X The following is an example of a $_H_O_M_E/._S_i_g file:
- X NAME Iain Lea
- X EMAIL iain@estevax.uucp ...!unido!estevax!iain
- X SNAIL Siemens AG, ANL 433SZ, 8510 Fuerth-Bislohe, Germany
- X PHONE +49-911-331963 (home) +49-911-3089-407 (work)
- X
- X ENVIROMENT VARIABLES
- X
- X TINDIR
- X Define this variable if you do not want tin's .tin directory
- X in $HOME/.tin. (ie. if you want all tin's private files in
- X /tmp/.tin you would set TINDIR to contain /tmp.
- X
- X NNTPSERVER
- X The default NNTP server to remotely read news from. This
- X variable only needs to be set if the -r command line option
- X is specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r does not exist.
- X
- X ORGANIZATION
- X Set the mail header field Organization: to the contents of
- X the variable instead of the system default. This variable
- 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
- X may also contain an organization string.
- X
- X REPLYTO
- X Set the mail header field Reply-To: to the return address
- X
- X
- X 12
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X specified by the variable. This is useful if the machine is
- X not registered in the UUCP mail maps or if you wish to
- X recieve replies at a different machine. This variable has
- X precedence over the file $_H_O_M_E/._t_i_n/_r_e_p_l_y__t_o that may also
- X contain a return address.
- X
- X ADD_ADDRESS
- X This can contain an address to append to the return address
- X when replying directly through mail to somebody whose mail
- X address is not directly recognized by the local host. For
- 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
- X not recognized by your host, so therfore the mail will not
- X reach _u_s_e_r. But the host _l_i_t_t_e_v_a_x is known to recognize your
- X host and _b_i_g_v_a_x, so if ADD_ADDRESS is set (ie. 'setenv
- X ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS @lit-
- X tevax' and 'export ADD_ADDRESS' for sh) the address
- 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
- X _u_s_e_r@_b_i_g_v_a_x. This variable has precedence over the file
- X $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s that may also contain an address.
- X
- X BUG_ADDRESS
- X If the 'B' command bug report mail address is not correct
- X this variable should be set to the correct mail address.
- X This variable has precedence over the file
- 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.
- X
- X EDITOR
- X This variable has precedence over the default editor (ie.
- X vi) that is used in all editing operations within tin (ie.
- X posting 'w', replying 'rR', follow-ups 'fF' and bug reports
- X 'B').
- X
- X TIPS AND TRICKS
- X The following newsgroups provide useful information concerning
- X news software:
- X -news.software.readers (info. about news user agents
- X tin,rn,nn,vn etc.)
- X -news.software.nntp (info. about NNTP)
- X -news.software.b (info. about news transport agents Bnews &
- X Cnews)
- X
- X Many prompts (ie. 'Mark everything as read? (y/n): y') within tin
- X offer a default choice that the cursor is positioned on. By
- X pressing <CR> the default value is taken.
- X
- X When tin is run in an xterm window it will resize itself each
- X time the xterm is resized.
- X
- X FILES
- X $_H_O_M_E/._n_e_w_s_r_c newgroups subscribed to.
- X $_H_O_M_E/._t_i_n/_t_i_n_r_c options.
- X $_H_O_M_E/._t_i_n/._i_n_d_e_x newsgroup index files directory.
- 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.
- X $_H_O_M_E/._t_i_n/_a_c_t_i_v_e used by -n option for notifying user of new groups.
- X
- X
- X 13
- X
- X
- X
- X
- X
- X
- X TIN(1) Version 1.0 PL3
- X
- X
- X $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s address to send bug reports to.
- X $_H_O_M_E/._t_i_n/_k_i_l_l kill file.
- 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.
- X $_H_O_M_E/._t_i_n/_p_o_s_t_e_d history of articles posted by user.
- X $_H_O_M_E/._t_i_n/_r_e_p_l_y__t_o host address to use in Reply-To: mail header.
- X $_H_O_M_E/._t_i_n/_u_n_t_h_r_e_a_d contains groups that are not to be threaded.
- X $_H_O_M_E/._s_i_g_n_a_t_u_r_e signature.
- X $_H_O_M_E/._S_i_g signature.
- X
- X BUGS
- X There are bugs somewhere among the creeping featurism. Any bugs
- X found should be reported by the 'B' (bug report) command.
- X
- X There is a bug when article killing is switched ON/OFF at article
- X page level and the 't' command is used to return to group selec-
- X tion index.
- X
- X When articles have been unkilled, all articles will be marked
- X unread even if they have already been read.
- X
- X Killing articles when tin is setuid causes strange behaviour.
- X
- X Will not uudecode some of the images in alt.binaries.pictures
- X because more than one image is in the multi-part file to
- X uudecode. Only the first image will be uudecoded.
- X
- X Does not handle Xref: headers for cross-posted articles.
- X
- X HISTORY
- X Based on the tass newsreader that was developed by Rich Skrenta
- X and posted to alt.sources in March 1991. Tass was itself heavily
- X infleuenced by NOTES which was developed at the University of
- X Illinois in the 1970's.
- X
- X CREDITS
- X
- X Rich Skrenta
- X author of tass v3.2 which this newsreader used as its base.
- X
- X Syd Weinstein
- X curses.c is taken from the elm mailreader
- X
- X Rich Salz
- X author of wildmat.c pattern matching routines.
- X
- X Chris Smith
- X author of multi-part uudecode routine.
- X
- X I wish to thank the following people for bug reports/patchs and
- X comments:
- X
- X Klaus Arzig, Anton Aylward, Reiner Balling, Volker Beyer, Roger
- X Binns, Georg Biehler, Andreas Brosig, Peter Dressler, Gerhard
- X Ermer, Hugh Fader, Joachim Feld, Bernhard Gmelch, Viet Hoang,
- X
- X
- X 14
- X
- X
- X
- X
- X
- X
- X Version 1.0 PL3 TIN(1)
- X
- X
- X Torsten Homeyer, Andy Jackson, Joe Johnson, Cyrill Jung, Karl-
- X Koenig Koenigsson, Hans-Juergen Knopp, Bob Lukas, Clifford Luke,
- X Phillip Molloy, Toni Metz, Greg Miller, Klaus Neuberger, Otto
- X Niesser, Wolf Paul, Nickolay Saukh, Rich Salz, Fredy Schwatz,
- X Bernd Schwerin, Klamer Schutte, Karl-Olav Serrander, Chris Smith,
- X Steve Spearman, Cliff Stanford, Adri Verhoef, Cary Whitney
- X
- X AUTHOR
- X
- X Iain Lea
- X (iain@estevax.uucp or ...!unido!estevax!iain)
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X
- X 15
- SHAR_EOF
- $TOUCH -am 0930190191 tin.nrf &&
- chmod 0600 tin.nrf ||
- echo "restore of tin.nrf failed"
- set `wc -c tin.nrf`;Wc_c=$1
- if test "$Wc_c" != "36817"; then
- echo original size 36817, current size $Wc_c
- fi
- rm -f shar3_seq_.tmp
- echo "You have unpacked the last part"
- exit 0
-
- exit 0 # Just in case...
- --
- Kent Landfield INTERNET: kent@sparky.IMD.Sterling.COM
- Sterling Software, IMD UUCP: uunet!sparky!kent
- Phone: (402) 291-8300 FAX: (402) 291-4362
- Please send comp.sources.misc-related mail to kent@uunet.uu.net.
-