home *** CD-ROM | disk | FTP | other *** search
Text File | 1992-09-05 | 49.6 KB | 1,387 lines |
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- NNAAMMEE
- tin, rtin, cdtin, tind - A threaded Netnews reader
-
- SSYYNNOOPPSSIISS
- ttiinn//rrttiinn//ccddttiinn//ttiinndd [ _o_p_t_i_o_n_s ] [ _n_e_w_s_g_r_o_u_p_s ]
-
- DDEESSCCRRIIPPTTIIOONN
- _T_i_n is a full-screen threaded Netnews reader. It can read news
- locally (i.e. /_u_s_r/_s_p_o_o_l/_n_e_w_s) or remotely (rtin or tin -r option)
- via a NNTP (Network News Transport Protocol) server. A special
- version of tin called cdtin can also read locally active news and
- news archived on CD-ROM.
-
- Tin has four newsreading levels: the newsgroup selection page, the
- group index page, the thread listing page and the article viewer.
- Use the 'h' (help) command to view a list of the commands available
- at a particular level.
-
- On startup Tin will show a list of the newsgroups found in
- $_H_O_M_E/._n_e_w_s_r_c. An arrow '->' or highlighted bar will point to the
- first newsgroup. Move to a group by using the terminal arrow keys
- (ansi/at386/vt100 only) or 'j' and 'k'. Use PgUp/PgDn
- (ansi/at386/vt100 only) or Ctrl-U and Ctrl-D to page up/down.
- Enter a newsgroup by pressing RETURN.
-
- The TAB key may be used to advance to the next newsgroup with
- unread articles and enter it.
-
- OOPPTTIIOONNSS
- --cc create/update index files for every group in
- $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option and mark all
- articles as read.
-
- --ff _f_i_l_e use the specified file of subscribed to newsgroups in
- place of $_H_O_M_E/._n_e_w_s_r_c.
-
- --hh help listing all command line options.
-
- --HH brief introduction to tin that is also shown the first
- time it is started.
-
- --II _d_i_r directory to store newsgroup index files. Default is
- $_H_O_M_E/._t_i_n/._i_n_d_e_x.
-
- --mm _d_i_r mailbox directory to use. Default is $_H_O_M_E/_M_a_i_l.
-
- --MM _u_s_e_r mail unread articles to specified user for later reading.
- For more information read section Automatic Mailing and
- Saving New News.
-
- --nn notify the user of any newly created newsgroups since the
- last session.
-
-
-
-
- NEWS-OS Release 4.1R 1
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- --pp _f_i_l_e print program with options..
-
- --rr read news remotely from the default NNTP server specified
- in the environment variable NNTPSERVER or contained in
- the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r.
-
- --RR read news saved by -S option (not yet implemented).
-
- --ss _d_i_r save articles to directory. Default is $_H_O_M_E/_N_e_w_s.
-
- --SS save unread articles for later reading by -R option. For
- more information read section Automatic Mailing and
- Saving New News.
-
- --uu create/update index files for every group in
- $_H_O_M_E/._n_e_w_s_r_c or file specified by -f option. This
- option does not work if tin retrieves its index files via
- a NNTP server.
-
- --UU start tin in the background to update index files while
- reading news in the foreground. This option does not
- work if tin retrieves its index files via a NNTP server.
-
- --vv verbose mode for -c -M -S -u and -Z options.
-
- --zz only start tin if there is any new/unread news. If there
- is news tin will position cursor at first group with
- unread news. Useful for putting in login file.
-
- --ZZ check if there is any new/unread news and exit with
- appropiate status. If -v option is specified the number
- of unread articles in each group is printed. An exit
- code 0 indicates no news, 1 that an error occurred and 2
- that new/unread news exists. Useful for writing scripts.
-
- Tin can also dynamically change its options by the 'M' menu
- command. Any changes are written to $_H_O_M_E/._t_i_n/_t_i_n_r_c.
-
- The index daemon version, tind, only supports the -f, -h, and -v
- options.
-
- IINNDDEEXX FFIILLEESS
- In order to keep track of threads, Tin maintains an index for each
- newsgroup. There are a number of methods in which index files can
- be created and updated.
-
- The simplest method is that each user creates/updates there own
- index files that are stored in $HOME/.tin/.index. This has the
- advantage that any user can compile and install tin, but the
- disadvantage is that each user is going to be creating duplicate
- files and using precious disk space. A good way to keep index
- files updated is to start tin with the -U option that will update
-
-
-
-
- 2 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- index files in the background while you are reading news in the
- foreground. You can also update index files via the system batcher
- cron with the -u option:
- 30 6 * * * /usr/local/bin/tin -u
-
- A slightly better method is to set tin setuid news and have all
- index files created and updated in the news spool directory (i.e.
- /usr/spool/news/.index). This has the advantage that there will
- only be one copy of the index files on each machine on your
- network, but the disadvantage is that you will have tin running
- setuid news and killing articles will change the central index file
- for a group for all users (Needs fixing!).
-
- A better method is to install the tind index file updating daemon
- and have it create and update index files for all groups in your
- active file at regular intervals in the news spool directory (i.e.
- /usr/spool/news/.index). This has the advantage that there will
- only be one copy of the index files on each machine on your network
- and tin must not be setuid news, but the disadvantage is that you
- will have to have news permissions to install tind and root
- permissions to install an entry in the cron batcher system to have
- tind regularly update index files.
-
- The best method is to install the tind index file updating daemon
- on your NNTP server and have it create and update index files for
- all groups in your active file at regular intervals in the news
- spool directory (i.e. /usr/spool/news/.index). This has the
- advantage that there will only be one copy of the index files on
- the NNTP server for the whole of your network and tin clients must
- not be setuid news, but the disadvantage is that you will have to
- install my NNTP server patches to allow tin to retreive index file
- from your NNTP server and and you must install an entry in the cron
- batcher system to have tind regularly update index files (Note that
- this is the method we use on our network of 40-50 machines and have
- not had any problems).
-
- Entering a group the first time tends to be slow because the index
- file must be built from scratch unless the tind update daemon is
- being used. Subsequent readings of a group will cause incremental
- updating of the index file.
-
- If reading news remotely and locally updating index files operation
- will be somewhat slower because the articles must be retrieved from
- the NNTP server.
-
- NNEEWWSS AADDMMIINNIISSTTRRAATTIIOONN
- Maintaining Netnews on large networks of machines can be a pretty
- time consuming job as I recently discovered when I was given the
- job of maintaining our news system and news users.
-
- Tin is a News User Agent and so most of the users were always
- asking questions or doing things that could be frowned upon by
-
-
-
-
- NEWS-OS Release 4.1R 3
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- there departments. To relieve news admins (and especially me) of
- this features have been added to Tin to make life easier.
-
- If my NNTP XUSER patch has been applied to your NNTP server you
- will be able to log the username and machine to your NNTP logfile
- for usage statistics.
-
- A user starting tin for the first time can be automatically
- subscribed to a list of newsgroups that are deemed appropiate by
- the news administrator. At our site the subscriptions file has 125
- groups (our active file conatains over 400 groups with many only
- being marginally interesting to most people). The subscriptions
- file should be created in your news lib directory (i.e.
- /usr/lib/news/subscriptions) and should have file permissions set
- to 0644. If reading news via NNTP my NNTP LIST SUBSCRIPTIONS patch
- will have to have been applied to your NNTP server.
-
- SSCCRREEEENN FFOORRMMAATT
- Tin has five separate levels of operation: Group selection level,
- Spooldir selection level, Group level, Thread level and Article
- level.
-
- At the Group Selection level the title displays the number of
- subscribed groups. The newsgroups are displayed on the left of the
- screen with the number of unread articles displayed on the same
- line in the middle of the screen.
- <Selection Num> <Newsgroup> <Num of unread articles>
- i.e.,
- 1 alt.sources 10
- 2 comp.sources.misc 3
- 3 news.software.readers 12
-
- At the Group level the title contains the name of the group, the
- number of conversation threads and total number of articles i.e.,
- alt.sources (7 23). If the group has been setup not to thread
- articles (i.e., alt.sources is in $(_H_O_M_E)/._t_i_n/_u_n_t_h_r_e_a_d) the title
- will be alt.sources (U 23). There are two possible display formats
- as shown below:
- <Selection Num> <Unread> <Responses> <Subject> <Author>
- i.e.,
- 1 + 3 Bnews sources? iain@estevax.uucp
- 2 1 This question has ether@net
- or
- <Selection Num> <Unread> <Responses> <Subject (longer)>
- i.e.,
- 1 + 3 Bnews sources?
- 2 1 This question has a longer subject line
-
- At the Article level the page header has the following format:
- <Date posted> <Newsgroup> <Thread 1 of n>
- <Article Num> <Subject> <Num of responses in thread>
- <Author> <Organization>
-
-
-
-
- 4 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- <Article body>
- i.e.,
- 24 Jul 15:20:03 GMT alt.sources Thread 1 of 2
- Article 452 Bnews sources? 3 responses
- iain@anl433.uucp Organization name
-
- <Article boby>
-
- CCOOMMMMOONN MMOOVVIINNGG KKEEYYSS
- This table shows the common keys/commands for moving at all three
- levels within Tin.
- ansi/at386/vt100 Other Terminals
- Beginning of list/article HHoommee 11 (^^RR or gg at article level)
- End of list/article EEnndd $$ (also GG at article level)
- Page Up PPggUUpp ^^UU or ^^BB or bb
- Page Down PPggDDnn ^^DD or ^^FF or <<SSPPAACCEE>>
- Line Up UUpp aarrrrooww kk (not at article level)
- Line Down DDoowwnn aarrrrooww jj (not at article level)
-
- CCOOMMMMOONN EEDDIITTIINNGG CCOOMMMMAANNDDSS
- An emacs style editing package allows the easy editing of input
- strings. An history list allows the easy re-use of previously
- entered strings. The following commands are available when editing
- a string:
-
- ^^AA,,^^EE move to beginnning or end of line, respectively.
-
- ^^FF,,^^BB nondestructive move forward or back one location,
- respectively.
-
- ^^DD delete the character currently under the cursor, or send
- EOF if no characters in the buffer.
-
- ^^HH,,<<DDEELL>> delete character left of the cursor.
-
- ^^KK delete from cursor to end of line.
-
- ^^PP,,^^NN move through history, previous and next, respectively.
-
- ^^LL,,^^RR redraw the current line.
-
- <<CCRR>> places line on history list if nonblank, appends newline
- and returns to the caller.
-
- <<EESSCC>> aborts the present editing operation.
-
- NNEEWWSSGGRROOUUPP SSEELLEECCTTIIOONN CCOOMMMMAANNDDSS
- 44 Select group 4.
-
- ^^KK Delete current group from $_H_O_M_E/._n_e_w_s_r_c file.
-
- ^^LL Redraw page.
-
-
-
-
- NEWS-OS Release 4.1R 5
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- ^^RR Reset $_H_O_M_E/._n_e_w_s_r_c file.
-
- <<CCRR>> Read current group.
-
- <<TTAABB>> View next unread group.
-
- BB Mail a bug report or comment to the author. This is the
- best way of getting bugs fixed and features
- added/changed.
-
- cc Mark current group as all read with confirmation and goto
- next group in group selection list.
-
- CC Mark current group as all read and goto next unread group
- in group selection list.
-
- gg Choose a new group by name. The position of the group
- within the group list will also be asked for. By
- entering '1' the new group will be the first group in the
- displayed list, by entering '8' the group will be the
- eighth group in the list etc. By entering '$' the group
- will be the last group displayed.
-
- hh help screen of newsgroup selection commands.
-
- II Toggle inverse video.
-
- ll List and allow selection of the available spool
- directories. This feature requires a special library to
- be linked with tin to create cdtin which can then read
- news from an active news feed and also from multiple CD-
- ROMs.
-
- mm Move the current group within the group selection list.
- By entering '1' the group will become the first displayed
- group in the list, by entering '8' the eighth group in
- the list etc. By entering '$' the group will be the last
- group displayed.
-
- MM User configurable options menu (for more information see
- section Options Menu).
-
- qq Quit tin.
-
- QQ Quit tin.
-
- ss Subscribe to current group.
-
- SS Subscribe to groups matching user specified pattern.
-
- uu Unsubscribe to current group.
-
-
-
-
-
- 6 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- UU Unsubscribe to groups matching user specified pattern.
-
- vv Print tin version information.
-
- ww Post an article to current group.
-
- WW List articles posted by user. The date posted, the
- newsgroup and the subject are listed.
-
- yy The first time this command is called it will yank in all
- groups from $_L_I_B_D_I_R/_a_c_t_i_v_e that are not in $_H_O_M_E/._n_e_w_s_r_c.
- After any groups have been subscribed/unsubscribed to,
- this command if pressed again will reread $_H_O_M_E/._n_e_w_s_r_c
- and display only the subscribed groups.
-
- YY Reread the active file to see if any new news has arrived
- since starting tin.
-
- zz Mark all articles in the current group as unread.
-
- ZZ Undelete previously deleted group by ^K command from
- $_H_O_M_E/._n_e_w_s_r_c.
-
- // Group forward search.
-
- ?? Group backward search.
-
- SSPPOOOOLL DDIIRREECCTTOORRYY SSEELLEECCTTIIOONN CCOOMMMMAANNDDSS
- 44 Select spool directory 4.
-
- ^^LL Redraw page.
-
- <<CCRR>> Read news from selected spool directory.
-
- BB Mail a bug report or comment to the author. This is the
- best way of getting bugs fixed and features
- added/changed.
-
- hh help screen of spool directory selection commands.
-
- II Toggle inverse video. qq Return to previous level.
-
- QQ Quit tin.
-
- vv Print tin version information.
-
- GGRROOUUPP IINNDDEEXX CCOOMMMMAANNDDSS
- 44 Select article 4.
-
- ^^KK Kill current article (for more information read section
- Kill Article Menu).
-
-
-
-
-
- NEWS-OS Release 4.1R 7
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- ^^LL Redraw page.
-
- <<CCRR>> Read current article.
-
- <<TTAABB>> View next unread article or group.
-
- aa Author forward search.
-
- AA Author backward search.
-
- BB Mail a bug report or comment to the author. This is the
- best way of getting bugs fixed and features
- added/changed.
-
- cc Mark all articles as read with confirmation.
-
- CC Cancel current article. It must have been posted by the
- same user. The cancel message can be seen in the
- newsgroup 'control'.
-
- dd Toggle display to show just the subject or the subject
- and author.
-
- gg Choose a new group by name.
-
- hh help screen of group index commands.
-
- II Toggle inverse video.
-
- KK Mark article/thread as read and advance to next unread
- article/thread.
-
- ll List the author of each response in current thread and
- enter thread selection level.
-
- mm Mail current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- someone.
-
- MM User configurable options menu (for more information see
- section Options Menu).
-
- nn Go to next group.
-
- NN Go to next unread article.
-
- oo Output current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- printer.
-
- pp Go to previous group.
-
-
-
-
-
- 8 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- PP Go to previous unread article.
-
- qq Return to previous level.
-
- QQ Quit tin.
-
- ss Save current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- file / files / mailbox. To save to a mailbox enter '='
- or '=mailbox' when asked for filename to save to. To
- save in <newsgroup name>/<filename> format enter
- '+filename'. Environment variables are allowed within a
- filename (i.e. $SOURCES/dir/filename).
-
- TT Tag current article for mailing ('m') / piping ('|') /
- printing ('o') / saving ('s') / crossposting ('x').
-
- uu Toggle display to show all articles as unthreaded or
- threaded.
-
- UU Untag all articles that were tagged.
-
- vv Print tin version information.
-
- ww Post an article to current group.
-
- WW List articles posted by user. The date posted, the
- newsgroup and the subject are listed.
-
- xx Crosspost already posted current article / thread / auto
- selected (hot) articles / articles matching pattern /
- tagged articles to another newsgroup(s). Useful for
- reposting from global to local newsgroups.
-
- XX Mark all unread articles that have not been selected as
- read, redo screen to reflect changes and put index at the
- first thread to begin reading. Pressing 'X' again will
- toggle back to the way it was before. See '~' command for
- clearing the toggle effect.
-
- zz Mark current article as unread.
-
- ZZ Mark current thread as unread.
-
- // Search forward for specified subject.
-
- ?? Search backward for specified subject.
-
- -- Show last message.
-
- || Pipe current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles
-
-
-
-
- NEWS-OS Release 4.1R 9
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- into command.
-
- ** Select current thread for later processing.
-
- TTooggggllee sseelleeccttiioonn ooff ccuurrrreenntt tthhrreeaadd.. IIff aatt lleeaasstt oonnee uunnrreeaadd aarrtt,,
- but not all unread arts, in thread is selected, then all
- unread arts become selected.
-
- @@ Reverse all selections on all articles.
-
- ~~ Undo all selections on all articles. It clears the toggle
- effect of 'X' command. Thus after first doing a 'X', one
- can then do '~' to reset articles. Thus, one can
- iteratively whittle down uninteresting threads.
-
- ++ Perform auto-selection on current group.
-
- ;; For each thread in current group, if it at least one
- unread art is selected, all unread arts become selected.
- This is useful for auto-selection on author where reader
- wants to see entire thread.
-
- == Prompts for a pattern with which to match on. All threads
- whose subjects match the pattern will be selected. A
- pattern of "*" will match all subjects. Entering just
- <CR> will cause the previous pattern to be used.
-
- TTHHRREEAADD LLIISSTTIINNGG CCOOMMMMAANNDDSS
- 44 Select article 4 within thread.
-
- ^^LL Redraw page.
-
- <<CCRR>> Read current article within thread.
-
- <<TTAABB>> View next unread article within thread.
-
- BB Mail a bug report or comment to the author. This is the
- best way of getting bugs fixed and features
- added/changed.
-
- cc Mark thread as read after confirmation and return to
- previous level.
-
- dd Toggle display to show just the subject or the subject
- and author.
-
- hh help screen of thread listing commands.
-
- II Toggle inverse video.
-
- KK Mark thread as read and return to previous level.
-
-
-
-
-
- 10 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- qq Return to previous level.
-
- QQ Quit tin.
-
- rr Toggle display to show all articles or only unread
- articles.
-
- tt Return to group index level.
-
- TT Tag current article for mailing ('m') / piping ('|') /
- printing ('o') / saving ('s') / crossposting ('x').
-
- vv Print tin version information.
-
- zz Mark current article in thread as unread.
-
- ZZ Mark all articles in thread as unread.
-
- AARRTTIICCLLEE VVIIEEWWEERR CCOOMMMMAANNDDSS
- 00 Read the base article in this thread.
-
- 44 Read response 4 in this thread.
-
- ^^HH Show all of the articles mail header.
-
- ^^KK Kill current article (for more information read section
- Kill Article Menu).
-
- ^^LL Redraw page.
-
- <<CCRR>> Goto next base article.
-
- <<TTAABB>> Goto next unread article.
-
- aa Author forward search.
-
- AA Author backward search.
-
- BB Mail a bug report or comment to the author. This is the
- best way of getting bugs fixed and features
- added/changed.
-
- cc Mark all articles as read with confirmation.
-
- dd Toggle rot-13 decoding for this article.
-
- ff Post a followup to current article.
-
- FF Post a followup with a copy of the current article
- included.
-
- hh Help screen of article page commands.
-
-
-
-
- NEWS-OS Release 4.1R 11
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- II Toggle inverse video.
-
- kk Mark article as read and advance to next unread article.
-
- KK Mark thread as read and advance to next unread thread.
-
- mm Mail current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- someone.
-
- MM User configurable options menu (for more information see
- section Options Menu).
-
- nn Go to the next article.
-
- NN Go to the next unread article.
-
- oo Output current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- printer.
-
- oo Output article/thread/tagged articles to printer.
-
- pp Go to the previous article.
-
- PP Go to the previous unread article.
-
- qq Return to previous level.
-
- QQ Quit tin.
-
- rr Reply through mail to author.
-
- RR Reply through mail to author with a copy of the current
- article included.
-
- ss Save current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles to
- file / files / mailbox. To save to a mailbox enter '='
- or '=mailbox' when asked for filename to save to. To
- save in <newsgroup name>/<filename> format enter (i.e.
- $SOURCES/dir/filename).
-
- tt Return to group selection level.
-
- TT Tag current article for mailing ('m') / piping ('|') /
- printing ('o') / saving ('s') / crossposting ('x').
-
- vv Print tin version information.
-
- ww Post an article to current group.
-
-
-
-
-
- 12 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- WW List articles posted by user. The date posted, the
- newsgroup and the subject are listed.
-
- xx Crosspost already posted current article / thread / auto
- selected (hot) articles / articles matching pattern /
- tagged articles to another newsgroup(s). Useful for
- reposting from global to local newsgroups.
-
- zz Mark article as unread.
-
- // Article forward search.
-
- ?? Article backward search
-
- || Pipe current article / thread / auto selected (hot)
- articles / articles matching pattern / tagged articles
- into command.
-
- << Goto the first article in the current thread.
-
- >> Goto the last article in the current thread.
-
- ** Select current thread for later processing.
-
- TTooggggllee sseelleeccttiioonn ooff ccuurrrreenntt aarrttiiccllee..
-
- @@ Reverse article selections.
-
- ~~ Undo all selections on current thread.
-
- OOPPTTIIOONNSS MMEENNUU
- This menu is accessed by pressing 'M' at all levels. It allows the
- user to customize the behaviour of tin. The options are saved to
- the file $_H_O_M_E/._t_i_n/_t_i_n_r_c. Use <SPACE> to toggle the required
- option and <CR> to set.
-
- AAuuttoo ssaavvee
- Automatically save articles/threads by ``Archive-name:'' line
- in article header and post process them if process type is not
- set to None.
-
- EEddiittoorr ooffffsseett
- Set ON if the editor used for posting, follow-ups and bug
- reports has the capability of starting and positioning the
- cursor at a specified line within a file.
-
- MMaarrkk ssaavveedd rreeaadd
- Allows saved articles/threads to be automatically marked as
- read.
-
- CCoonnffiirrmm CCoommmmaanndd
- Allows certain commands (i.e. 'c' catchup) that require user
-
-
-
-
- NEWS-OS Release 4.1R 13
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- confirmation to be executed immediately if set OFF.
-
- DDrraaww aarrrrooww
- Allows groups/articles to be selected by an arrow '->' if set
- ON or by an highlighted bar if set OFF.
-
- PPrriinntt hheeaaddeerr
- This allows the complete mail header or only the ``Subject:''
- and ``From:'' fields to be output when printing articles.
-
- GGoottoo 11sstt uunnrreeaadd
- This allows the cursor to be placed at the first / last unread
- article upon entering a newsgroup with unread news.
-
- SSccrroollll ffuullll ppaaggee
- If set ON scrolling of groups/articles will be a full page at a
- time, otherwise half a page at a time.
-
- CCaattcchhuupp oonn qquuiitt
- If set ON the user is asked when quitting if all groups read
- during the current session should be marked read.
-
- TThhrreeaadd aarrttiicclleess
- If set ON articles will be threaded in all groups (default),
- otherwise articles will be shown unthreaded. If set ON but
- certain user specified groups are in $_H_O_M_E/._t_i_n/_u_n_t_h_r_e_a_d, the
- specified groups will be unthreaded and the rest will be
- threaded.
-
- SShhooww oonnllyy uunnrreeaadd
- If set ON show only new/unread articles, otherwise show all
- articles.
-
- SShhooww ddeessccrriippttiioonn
- If set ON show a short descriptive text for each displayed
- newsgroup. The text used is taken from the $LIBDIR/newsgroups
- file.
-
- SShhooww AAuutthhoorr
- If set 'None' only the ``Subject:'' line will be displayed. If
- set 'Addr' ``Subject:'' line & the address part of the
- ``From:'' line are displayed. If set 'Name' ``Subject:'' line
- & the authors full name part of the ``From:'' line are
- displayed. If set 'Both' ``Subject:'' line & all of the
- ``From:'' line are displayed.
-
- PPrroocceessss ttyyppee
- This specifies the default type of post processing to perform
- on saved articles. The following types of processing are
- allowed:
- -none.
- -unpacking of multi-part shell archives.
-
-
-
-
- 14 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- -unpacking of multi-part uuencoded files.
- -unpacking of multi-part uuencoded files that produce a
- *.zoo archive whose contents is listed.
- -unpacking of multi-part uuencoded files that produce a
- *.zoo archive whose contents is extracted.
-
- SSoorrtt aarrttiicclleess bbyy
- This specifies how articles should be sorted. The following
- sort types are allowed:
- -don't sort articles (default).
- -sort articles by ``Subject:'' field (ascending &
- descending).
- -sort articles by ``From:'' field (ascending & descending).
- -sort articles by ``Date:'' field (ascending & descending).
-
- SSaavvee ddiirreeccttoorryy
- The directory where articles/threads are to be saved. Default
- is $_H_O_M_E/_N_e_w_s.
-
- MMaaiill ddiirreeccttoorryy
- The directory where articles/threads are to be saved in mailbox
- format. This feature is mainly for use with the Elm mail
- program. It allows the user to save articles/threads/groups
- simply by giving '=' as the filename to save to.
-
- PPrriinntteerr
- The printer program with options that is to be used to print
- articles. Default is lpr for BSD machines and lp for SysV
- machines.
-
- KKIILLLL AARRTTIICCLLEE MMEENNUU
- This menu is accessed by pressing '^K' at the group and page
- levels. It allows the user to kill an article that matches the
- current ``Subject:'' line, ``From:'' line or a string entered by
- the user. The user entered string can be applied to the
- ``Subject:'' or ``From:'' lines of an article. The kill
- description can be limited to the current newsgroup or it can apply
- to all newsgroups. Once entered the user can abort the command and
- not save the kill description, edit the kill file or save the kill
- description.
-
- On starting tin the users killfile $_H_O_M_E/._t_i_n/_k_i_l_l is read and on
- entering a newsgroup any kill descriptions are applied. Articles
- that match a kill description are marked killed and are not
- displayed.
-
- PPOOSSTTIINNGG AARRTTIICCLLEESS
- Tin allows posting of articles, follow-up to already posted
- articles and replying direct through mail to the author of an
- article.
-
-
-
-
-
-
- NEWS-OS Release 4.1R 15
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- Use the 'w' command to post an article to a newsgroup. After
- entering the post subject the default editor (i.e. vi) or the
- editor specified by the $VISUAL environment variable will be
- started and the article can be entered. To crosspost articles
- simply add a comma and the name of the newsgroup(s) to the end of
- the ``Newsgroups:'' line at the beginning of the article. After
- saving and exiting the editor you are asked if you wish to a)bort
- posting the article, e)dit the article again or p)ost the article
- to the specified newsgroup(s).
-
- Use the 'W' command to display a history of the articles you have
- posted. The date the article was posted, which newsgroups the
- article was posted to and the articles subject line are displayed.
-
- Use the 'f' / 'F' command to post a follow-up article to an already
- posted article. The 'F' command will copy the text of the original
- article into the editor. The editing procedure is the same as when
- posting an article with the 'w' command.
-
- Use the 'r' / 'R' command to reply direct through mail to the
- author of an already posted article. The 'R' command will copy the
- text of the original article into the editor. The editing
- procedure is the same as when posting an article with the 'w'
- command. After saving and exiting the editor you are asked if you
- wish to a)bort sending the article, e)dit the article again or
- s)end the article to the author.
-
- MMAAIILLIINNGG PPIIPPIINNGG PPRRIINNTTIINNGG RREEPPOOSSTTIINNGG AANNDD SSAAVVIINNGG AARRTTIICCLLEESS
- The command interface to mail ('m'), pipe ('|'), print ('o'),
- crosspost ('x') and save ('s') articles is the same for ease of
- use.
-
- The initial command will ask you to select which a)rticle, t)hread,
- h)ot (auto selected) r)egex pattern, t)agged articles you wish to
- mail, pipe etc.
-
- Tagged articles must have already been tagged with the 'T' command.
- All tagged articles can be untagged by the 'U' untag command.
-
- If regex pattern matching is selected you are asked to enter a
- regular expression (i.e. to match all articles subject lines
- containing 'net News' you must enter '*net News*'). Any articles
- that match the entered expression will be mailed, piped etc.
-
- To save articles to a mailbox with the name of the current
- newsgroup (i.e. Alt.sources) enter '=' or '=<mailbox name>' when
- asked for the save filename.
-
- To save articles in <newsgroup name>/<filename> format enter
- '+<filename>'.
-
-
-
-
-
-
- 16 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- When saving articles you can specify whether the saved files should
- be post processed (i.e. unshar shell archive, uudecode multiple
- parts etc). A default process type can be set by the 'Process
- type:' in the 'M' options menu.
-
- AAUUTTOOMMAATTIICC MMAAIILLIINNGG AANNDD SSAAVVIINNGG NNEEWW NNEEWWSS
- Tin allows new/unread news articles to be mailed (-M option)/saved
- (-S option) in batch mode for later reading. Useful when going on
- holiday and you don't want to return and find that expire has
- removed a whole load of unread articles. Best to run from crontab
- everyday while away, after which you will be mailed a report of
- which articles were mailed/saved from which newsgroups and the
- total number of articles mailed/saved. Articles are saved in a
- private news structure under your <savedir> directory (default is
- $_H_O_M_E/_N_e_w_s). Be careful of using this option if you read a lot of
- groups because you could overflow your filesystem. If you only
- want to save a few groups it would be best to backup your full
- $_H_O_M_E/._n_e_w_s_r_c and create a new one that only contains the
- newsgroups you want to mail/save. Saved news can be read later by
- starting tin with the -R option.
-
- tin -M iain -f newsrc.mail (mail any unread articles in newgroups
- specified in file newsrc.mail)
-
- tin -S -f newsrc.save (save any unread articles in newgroups
- specified in file newsrc.save)
-
- tin -R (read any unread articles saved by tin -S option)
-
- SSIIGGNNAATTUURREESS
- Tin will recognize a signature in either $_H_O_M_E/._s_i_g_n_a_t_u_r_e or
- $_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 be
- pulled into the editor for Tin mail commands. A signature in
- $_H_O_M_E/._s_i_g_n_a_t_u_r_e will not be pulled into the editor for posting
- commands since the inews program will append the signature itself.
-
- A signature in $_H_O_M_E/._S_i_g will be pulled into the editor for both
- posting and mailing commands.
-
- The following is an example of a $_H_O_M_E/._S_i_g file:
- NAME Iain Lea
- EMAIL iain%anl433.uucp@Germany.EU.net
- SNAIL Bruecken Strasse 12, 8500 Nuernberg 90, Germany
- PHONE +49-911-331963 (home) +49-911-3089-407 (work)
-
- EENNVVIIRROOMMEENNTT VVAARRIIAABBLLEESS
- TTIINNDDIIRR
- Define this variable if you do not want tin's .tin directory
- in $HOME/.tin. (i.e. if you want all tin's private files in
- /tmp/.tin you would set TINDIR to contain /tmp.
-
- NNNNTTPPSSEERRVVEERR
-
-
-
-
- NEWS-OS Release 4.1R 17
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- The default NNTP server to remotely read news from. This
- variable only needs to be set if the -r command line option is
- specified and the file /_e_t_c/_n_n_t_p_s_e_r_v_e_r does not exist.
-
- DDIISSTTRRIIBBUUTTIIOONN
- Set the article header field ``Distribution:'' to the contents
- of the variable instead of the system default.
-
- OORRGGAANNIIZZAATTIIOONN
- Set the article header field ``Organization:'' to the contents
- of the variable instead of the system default. This variable
- 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 may
- also contain an organization string. If reading news on an
- Apollo DomainOS machine the environment variable NEWSORG has
- to be used instead of ORGANIZATION.
-
- RREEPPLLYYTTOO
- Set the article header field ``Reply-To:'' to the return
- address specified by the variable. This is useful if the
- machine is not registered in the UUCP mail maps or if you wish
- to recieve replies at a different machine. This variable has
- precedence over the file $_H_O_M_E/._t_i_n/_r_e_p_l_y_t_o that may also
- contain a return address.
-
- AADDDD_AADDDDRREESSSS
- This can contain an address to append to the return address
- when replying directly through mail to somebody whose mail
- address is not directly recognized by the local host. For
- example say the return address is _u_s_e_r@_b_i_g_v_a_x, but _b_i_g_v_a_x is
- not recognized by your host, so therfore the mail will not
- reach _u_s_e_r. But the host _l_i_t_t_e_v_a_x is known to recognize your
- host and _b_i_g_v_a_x, so if ADD_ADDRESS is set (i.e. 'setenv
- ADD_ADDRESS @littevax' for csh or 'set ADD_ADDRESS @littevax'
- and 'export ADD_ADDRESS' for sh) the address
- _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
- _u_s_e_r@_b_i_g_v_a_x. This variable has precedence over the file
- $_H_O_M_E/._t_i_n/_a_d_d__a_d_d_r_e_s_s that may also contain an address.
-
- BBUUGG_AADDDDRREESSSS
- If the 'B' command bug report mail address is not correct this
- variable should be set to the correct mail address. This
- variable has precedence over the file $_H_O_M_E/._t_i_n/_b_u_g__a_d_d_r_e_s_s
- that may also contain a mail address.
-
- MMAAIILLEERR
- This variable has precedence over the default mailer that is
- used in all mailing operations within tin (i.e. replying 'rR',
- and bug reports 'B').
-
- VVIISSUUAALL
- This variable has precedence over the default editor (i.e. vi)
- that is used in all editing operations within tin (i.e.
-
-
-
-
- 18 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- posting 'w', replying 'rR', follow-ups 'fF' and bug reports
- 'B').
-
- TTIIPPSS AANNDD TTRRIICCKKSS
- The following newsgroups provide useful information concerning news
- software:
- -news.software.readers (info. about news user agents
- tin,rn,nn,vn etc.)
- -news.software.nntp (info. about NNTP)
- -news.software.b (info. about news transport agents Bnews &
- Cnews)
- -news.answers (Frequently Asked Questions (FAQ) about many
- different themes)
-
- Many prompts (i.e. 'Mark everything as read? (y/n): y') within tin
- offer a default choice that the cursor is positioned on. By
- pressing <CR> the default value is taken.
-
- When tin is run in an xterm window it will resize itself each time
- the xterm is resized.
-
- Tin will reread the active file at set intervals to show any new
- news.
-
- FFIILLEESS
- $HOME/.newsrc subscribed to newgroups.
-
- $HOME/.tin/tinrc options.
-
- $HOME/.tin/.index newsgroup index files directory.
-
- $HOME/.tin/add_address
- address to add to when replying through mail.
-
- $HOME/.tin/active used by -n option for notifying user of new
- groups.
-
- $HOME/.tin/bug_address
- address to send bug reports to.
-
- $HOME/.tin/kill kill file.
-
- $HOME/.tin/organization
- string to replace default organization.
-
- $HOME/.tin/posted history of articles posted by user.
-
- $HOME/.tin/replyto host address to use in ``Reply-To:'' mail
- header.
-
- $HOME/.tin/unthread contains groups that are not to be threaded.
-
-
-
-
-
- NEWS-OS Release 4.1R 19
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- $HOME/.signature signature.
-
- $HOME/.Sig signature.
-
- BBUUGGSS
- There are bugs somewhere among the creeping featurism. Any bugs
- found should be reported by the 'B' (bug report) command.
-
- Will not uudecode some of the images in alt.binaries.pictures
- because more than one image is in the multi-part file to uudecode.
- Only the first image will be uudecoded.
-
- Does not yet handle ``Xref:'' headers for cross-posted articles.
-
- HHIISSTTOORRYY
- Based on the tass newsreader that was developed by Rich Skrenta and
- posted to alt.sources in March 1991. Tass was itself heavily
- infleuenced by NOTES which was developed at the University of
- Illinois by Ray Essick and Rob Kolstad in 1982.
-
- Tin v1.00 (full distribution) was posted in 8 parts to alt.sources
- on 23 Aug 1991.
- Tin v1.0 PL1 (full distribution) was posted in 8 parts to
- alt.sources on 03 Sep 1991.
- Tin v1.0 PL2 (full distribution) was posted in 9 parts to
- alt.sources on 24 Sep 1991.
- Tin v1.0 PL3 (patch) was posted in 4 parts to alt.sources on 30 Sep
- 1991.
- Tin v1.0 PL4 (patch) was posted in 2 parts to alt.sources on 02 Oct
- 1991.
- Tin v1.0 PL5 (patch) was posted in 4 parts to alt.sources on 17 Oct
- 1991.
- Tin v1.0 PL6 (patch) was posted in 5 parts to alt.sources on 27 Nov
- 1991.
- Tin v1.0 PL7 (patch) was posted in 2 parts to alt.sources on 27 Nov
- 1991.
- Tin v1.1 PL0 (full distribution) was posted in 11 parts to
- alt.sources on 13 Feb 1992.
- Tin v1.1 PL1 (full distribution) was posted in 12 parts to
- alt.sources on 24 Mar 1992.
- Tin v1.1 PL2 (patch) was posted in 4 parts to alt.sources on 30 Mar
- 1992.
- Tin v1.1 PL3 (full distribution) was posted in 15 parts to
- alt.sources on 13 May 1992.
- Tin v1.1 PL4 (full distribution) was posted in 15 parts to
- alt.sources on 22 Jun 1992.
-
- CCRREEDDIITTSS
- Rich Skrenta
- author of tass v3.2 which this newsreader used as its base.
-
- Dave Taylor
-
-
-
-
- 20 Release 4.1R NEWS-OS
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- author of curses.c from the elm mailreader.
-
- Rich Salz
- author of wildmat.c pattern matching routine.
-
- Chris Thewalt
- author of getline.c emacs style editing routine.
-
- Dieter Becker
- for generously posting certain versions and patches for me
- when my net connection was removed by a group of very short
- sighted people.
-
- I wish to thank the following people for supplying patchs:
-
- Anton Aylward, Paul Bauwens, Dieter Becker, Dan Berry, Marc
- Boucher, Leila Burrell-Davis, Robert Claeson, Steven Cogswell, Ned
- Danieley, Chris Davies, Brent Ermlick, Callum Gibson, Carl Hage,
- Paul Halsema, Ed Hanway, Daniel Hermans, Tom Hite, Torsten Homeyer,
- Nelson Kading, Fritz Kleeman, Karl-Koenig Koenigsson, Kris Kugel,
- Hakan Lennestal, Clifford Luke, Michael Faurot, David MacKenzie,
- James Nugen, Jeb Palmer, Tom Parry, Bill Poitras, Wolfgang
- Prediger, Jim Robinson, Stephen Roseman, Nickolay Saukh, Rich Salz,
- John Sauter, Bart Sears, Karl-Olav Serrander, Doug Sewell, Cliff
- Stanford, Steve Starck, Michael Traub, Adri Verhoef, Paul Vickers,
- Cary Whitney, Greg Woods, Lloyd Wright
-
- I wish to thank the following people for bug reports/comments:
-
- Klaus Arzig, Scott Babb, Reiner Balling, Preston Bannister, Bill de
- Beabien, Volker Beyer, Etienne Bido, Roger Binns, Georg Biehler,
- Jean-Marc Bonnaudet, Sean Brady, Ian Brown, Andreas Brosig, Tom
- Czarnik, David Donovan, Peter Dressler, Gerhard Ermer, Hugh Fader,
- Joachim Feld, Paul Fox, Bernhard Gmelch, Viet Hoang, Andy Jackson,
- Joe Johnson, Cyrill Jung, Kuo-Chein Kai, Hans-Juergen Knopp,
- Bernhard Kroenung, Murray Laing, Marty Leisner, Per Lindqvist, Bob
- Lukas, Kazushi Marukawa, Phillip Molloy, Toni Metz, Greg Miller,
- Klaus Neuberger, Otto Niesser, Reiner Oelhaf, Alex Pakter, John
- Palkovic, Wolf Paul, Andrew Phillips, Stefan Rathmann, Ted
- Richards, David Ross, Jonas Rwgmyr, Daemon Schaefer, John Schmitz,
- Dean Schrimpf, Klamer Schutte, Fredy Schwatz, Bernd Schwerin, Chris
- Smith, Daniel Smith, Steve Spearman, Hironobu Takahashi, Ken
- Taylor, Tony Travis, Sven Werner, G. Woodbury, Orest Zboroski
-
- AAUUTTHHOORR
- Iain Lea
- (iain%anl433.uucp@Germany.EU.net)
-
-
-
-
-
-
-
-
-
- NEWS-OS Release 4.1R 21
-
-
-