home *** CD-ROM | disk | FTP | other *** search
Text File | 1992-05-18 | 46.0 KB | 1,387 lines |
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- NAME
- tin, rtin, tind - A threaded Netnews reader
-
- SYNOPSIS
- tin/rtin/cdtin/tind [options] [newsgroups]
-
- DESCRIPTION
- Tin is a full-screen threaded Netnews reader. It can read
- news locally (ie. /usr/spool/news) 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
- $HOME/.newsrc. 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.
-
- OPTIONS
- -c create/update index files for every group in
- $HOME/.newsrc or file specified by -f option and
- mark all articles as read.
-
- -f file use the specified file of subscribed to newsgroups
- in place of $HOME/.newsrc.
-
- -h help listing all command line options.
-
- -H brief introduction to tin that is also shown the
- first time it is started.
-
- -I dir directory to store newsgroup index files. Default
- is $HOME/.tin/.index.
-
- -m dir mailbox directory to use. Default is $HOME/Mail.
-
- -M user mail unread articles to specified user for later
- reading. For more information read section
- Automatic Mailing and Saving New News.
-
- -n notify the user of any newly created newsgroups
- since the last session.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 1
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- -p file print program with options..
-
- -r read news remotely from the default NNTP server
- specified in the environment variable NNTPSERVER
- or contained in the file /etc/nntpserver.
-
- -R read news saved by -S option (not yet
- implemented).
-
- -s dir save articles to directory. Default is $HOME/News.
-
- -S save unread articles for later reading by -R
- option. For more information read section
- Automatic Mailing and Saving New News.
-
- -u create/update index files for every group in
- $HOME/.newsrc or file specified by -f option. This
- option does not work if tin retrieves its index
- files via a NNTP server.
-
- -U 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.
-
- -v verbose mode for -c -M -S -u and -Z options.
-
- -z 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.
-
- -Z 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 $HOME/.tin/tinrc.
-
- The index daemon version Tind only supports the -f, -h and
- -v options.
-
- INDEX FILES
- 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
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 2
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- 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 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 (ie. /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 (ie. /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 (ie.
- /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
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 3
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- be retrieved from the NNTP server.
-
- NEWS ADMINISTRATION
- 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 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 (ie.
- /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.
-
- SCREEN FORMAT
- 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
- $(HOME)/.tin/unthread) the title will be alt.sources (U 23).
- There are two possible display formats as shown below:
- <Selection Num> <Unread> <Responses> <Subject> <Author>
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 4
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- 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>
-
- <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>
-
- COMMON MOVING KEYS
- This table shows the common keys/commands for moving at all
- three levels within Tin.
- ansi/at386/vt100 Other Terminals
- Beginning of list/article Home 1 (^R or g at article level)
- End of list/article End $ (also G at article level)
- Page Up PgUp ^U or b
- Page Down PgDn ^D or <SPACE>
- Line Up Up arrow k (not at article level)
- Line Down Down arrow j (not at article level)
-
- COMMON EDITING COMMANDS
- 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:
-
-
- ^A,^E move to beginnning or end of line, respectively.
-
- ^F,^B nondestructive move forward or back one location,
- respectively.
-
- ^D delete the character currently under the cursor,
- or send EOF if no characters in the buffer.
-
- ^H,<DEL> delete character left of the cursor.
-
- ^K delete from cursor to end of line.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 5
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- ^P,^N move through history, previous and next,
- respectively.
-
- ^L,^R redraw the current line.
-
- <CR> places line on history list if nonblank, appends
- newline and returns to the caller.
-
- <ESC> aborts the present editing operation.
-
- NEWSGROUP SELECTION COMMANDS
- 4 Select group 4.
-
- ^K Delete current group from $HOME/.newsrc file.
-
- ^L Redraw page.
-
- ^R Reset $HOME/.newsrc file.
-
- <CR> Read current group.
-
- <TAB> View next unread group.
-
- B Mail a bug report or comment to the author. This
- is the best way of getting bugs fixed and features
- added/changed.
-
- c Mark current group as all read with confirmation
- and goto next group in group selection list.
-
- C Mark current group as all read and goto next
- unread group in group selection list.
-
- g 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.
-
- h help screen of newsgroup selection commands.
-
- I Toggle inverse video.
-
- l 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.
-
- m Move the current group within the group selection
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 6
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- 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.
-
- M User configurable options menu (for more
- information see section Options Menu).
-
- q Quit tin.
-
- Q Quit tin.
-
- s Subscribe to current group.
-
- S Subscribe to groups matching user specified
- pattern.
-
- u Unsubscribe to current group.
-
- U Unsubscribe to groups matching user specified
- pattern.
-
- v Print tin version information.
-
- w Post an article to current group.
-
- W List articles posted by user. The date posted, the
- newsgroup and the subject are listed.
-
- y The first time this command is called it will yank
- in all groups from $LIBDIR/active that are not in
- $HOME/.newsrc. After any groups have been
- subscribed/unsubscribed to, this command if
- pressed again will reread $HOME/.newsrc and
- display only the subscribed groups.
-
- Y Reread the active file to see if any new news has
- arrived since starting tin.
-
- z Mark all articles in the current group as unread.
-
- Z Undelete previously deleted group by ^K command
- from $HOME/.newsrc.
-
- / Group forward search.
-
- ? Group backward search.
-
- SPOOL DIRECTORY SELECTION COMMANDS
- 4 Select spool directory 4.
-
- ^L Redraw page.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 7
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- <CR> Read news from selected spool directory.
-
- B Mail a bug report or comment to the author. This
- is the best way of getting bugs fixed and features
- added/changed.
-
- h help screen of spool directory selection commands.
-
- I Toggle inverse video. q Return to previous level.
-
- Q Quit tin.
-
- v Print tin version information.
-
- GROUP INDEX COMMANDS
- 4 Select article 4.
-
- ^K Kill current article (for more information read
- section Kill Article Menu).
-
- ^L Redraw page.
-
- <CR> Read current article.
-
- <TAB> View next unread article or group.
-
- a Author forward search.
-
- A Author backward search.
-
- B Mail a bug report or comment to the author. This
- is the best way of getting bugs fixed and features
- added/changed.
-
- c Mark all articles as read with confirmation.
-
- C Cancel current article. It must have been posted
- by the same user. The cancel message can be seen
- in the newsgroup 'control'.
-
- d Toggle display to show just the subject or the
- subject and author.
-
- g Choose a new group by name.
-
- h help screen of group index commands.
-
- I Toggle inverse video.
-
- K Mark article/thread as read and advance to next
- unread article/thread.
-
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 8
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- l List the author of each response in current thread
- and enter thread selection level.
-
- m Mail current article / thread / auto selected
- (hot) articles / articles matching pattern /
- tagged articles to someone.
-
- M User configurable options menu (for more
- information see section Options Menu).
-
- n Go to next group.
-
- N Go to next unread article.
-
- o Output current article / thread / auto selected
- (hot) articles / articles matching pattern /
- tagged articles to printer.
-
- p Go to previous group.
-
- P Go to previous unread article.
-
- q Return to previous level.
-
- Q Quit tin.
-
- s 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 (ie. $SOURCES/dir/filename).
-
- T Tag current article for mailing ('m') / piping
- ('|') / printing ('o') / saving ('s') /
- crossposting ('x').
-
- u Toggle display to show all articles as unthreaded
- or threaded.
-
- U Untag all articles that were tagged.
-
- v Print tin version information.
-
- w Post an article to current group.
-
- W List articles posted by user. The date posted, the
- newsgroup and the subject are listed.
-
- x Crosspost already posted current article / thread
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 9
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- /
-
- auto selected (hot) articles / articles matching
- pattern / tagged articles to another newsgroup(s).
- Useful for reposting from global to local
- newsgroups.
-
- z Mark current article as unread.
-
- Z 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 into command.
-
- THREAD LISTING COMMANDS
- 4 Select article 4 within thread.
-
- ^L Redraw page.
-
- <CR> Read current article within thread.
-
- <TAB> View next unread article within thread.
-
- B Mail a bug report or comment to the author. This
- is the best way of getting bugs fixed and features
- added/changed.
-
- c Mark thread as read after confirmation and return
- to previous level.
-
- d Toggle display to show just the subject or the
- subject and author.
-
- h help screen of thread listing commands.
-
- I Toggle inverse video.
-
- K Mark thread as read and return to previous level.
-
- q Return to previous level.
-
- Q Quit tin.
-
- r Toggle display to show all articles or only unread
- articles.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 10
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- t Return to group index level.
-
- T Tag current article for mailing ('m') / piping
- ('|') / printing ('o') / saving ('s') /
- crossposting ('x').
-
- v Print tin version information.
-
- z Mark current article in thread as unread.
-
- Z Mark all articles in thread as unread.
-
- ARTICLE VIEWER COMMANDS
- 0 Read the base article in this thread.
-
- 4 Read response 4 in this thread.
-
- ^H Show all of the articles mail header.
-
- ^K Kill current article (for more information read
- section Kill Article Menu).
-
- ^L Redraw page.
-
- <CR> Goto next base article.
-
- <TAB> Goto next unread article.
-
- a Author forward search.
-
- A Author backward search.
-
- B Mail a bug report or comment to the author. This
- is the best way of getting bugs fixed and features
- added/changed.
-
- c Mark all articles as read with confirmation.
-
- d Toggle rot-13 decoding for this article.
-
- f Post a followup to current article.
-
- F Post a followup with a copy of the current article
- included.
-
- h Help screen of article page commands.
-
- I Toggle inverse video.
-
- k Mark article as read and advance to next unread
- article.
-
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 11
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- K Mark thread as read and advance to next unread
- thread.
-
- m Mail current article / thread / auto selected
- (hot) articles / articles matching pattern /
- tagged articles to someone.
-
- M User configurable options menu (for more
- information see section Options Menu).
-
- n Go to the next article.
-
- N Go to the next unread article.
-
- o Output current article / thread / auto selected
- (hot) articles / articles matching pattern /
- tagged articles to printer.
-
- o Output article/thread/tagged articles to printer.
-
- p Go to the previous article.
-
- P Go to the previous unread article.
-
- q Return to previous level.
-
- Q Quit tin.
-
- r Reply through mail to author.
-
- R Reply through mail to author with a copy of the
- current article included.
-
- s 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 (ie.
- $SOURCES/dir/filename).
-
- t Return to group selection level.
-
- T Tag current article for mailing ('m') / piping
- ('|') / printing ('o') / saving ('s') /
- crossposting ('x').
-
- v Print tin version information.
-
- w Post an article to current group.
-
- W List articles posted by user. The date posted, the
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 12
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- newsgroup and the subject are listed.
-
- x 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.
-
- z 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.
-
- OPTIONS MENU
- 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 $HOME/.tin/tinrc. Use <SPACE>
- to toggle the required option and <CR> to set.
-
- Auto save
- Automatically save articles/threads by Archive-name:
- line in article header and post process them if process
- type is not set to None.
-
- Editor offset
- 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.
-
- Mark saved read
- Allows saved articles/threads to be automatically marked
- as read.
-
- Confirm Command
- Allows certain commands (ie. 'c' catchup) that require
- user confirmation to be executed immediately if set OFF.
-
- Draw arrow
- Allows groups/articles to be selected by an arrow '->'
- if set ON or by an highlighted bar if set OFF.
-
- Print header
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 13
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- This allows the complete mail header or only the
- Siubject: and From: fields to be output when printing
- articles.
-
- Goto 1st unread
- This allows the cursor to be placed at the first / last
- unread article upon entering a newsgroup with unread
- news.
-
- Scroll full page
- If set ON scrolling of groups/articles will be a full
- page at a time, otherwise half a page at a time.
-
- Catchup on quit
- If set ON the user is asked when quitting if all groups
- read during the current session should be marked read.
-
- Thread articles
- 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
- $HOME/.tin/unthread, the specified groups will be
- unthreaded and the rest will be threaded.
-
- Show only unread
- If set ON show only new/unread articles, otherwise show
- all articles.
-
- Show Author
- 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.
-
- Process type
- 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.
- -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.
-
- Sort articles by
- This specifies how articles should be sorted. The
- following sort types are allowed:
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 14
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- -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).
-
- Save directory
- The directory where articles/threads are to be saved.
- Default is $HOME/News.
-
- Mail directory
- 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.
-
- Printer
- The printer program with options that is to be used to
- print articles. Default is lpr for BSD machines and lp
- for SysV machines.
-
- KILL ARTICLE MENU
- 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 $HOME/.tin/kill 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.
-
- POSTING ARTICLES
- Tin allows posting of articles, follow-up to already posted
- articles and replying direct through mail to the author of
- an article.
-
- Use the 'w' command to post an article to a newsgroup. After
- entering the post subject the default editor (ie. 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
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 15
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- 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.
-
- MAILING PIPING PRINTING REPOSTING AND SAVING ARTICLES
- 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 (ie. 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 (ie. Alt.sources) enter '=' or '=<mailbox name>'
- when asked for the save filename.
-
- To save articles in <newsgroup name>/<filename> format enter
- '+<filename>'.
-
- When saving articles you can specify whether the saved files
- should be post processed (ie. unshar shell archive, uudecode
- multiple parts etc). A default process type can be set by
- the 'Process type:' in the 'M' options menu.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 16
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- AUTOMATIC MAILING AND SAVING NEW NEWS
- 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
- $HOME/News). 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 $HOME/.newsrc 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)
-
- SIGNATURES
- Tin will recognize a signature in either $HOME/.signature or
- $HOME/.Sig. If $HOME/.signature exists, then the signature
- will be pulled into the editor for Tin mail commands. A
- signature in $HOME/.signature will not be pulled into the
- editor for posting commands since the inews program will
- append the signature itself.
-
- A signature in $HOME/.Sig will be pulled into the editor for
- both posting and mailing commands.
-
- The following is an example of a $HOME/.Sig 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)
-
- ENVIROMENT VARIABLES
- TINDIR
- Define this variable if you do not want tin's .tin
- directory in $HOME/.tin. (ie. if you want all tin's
- private files in /tmp/.tin you would set TINDIR to
- contain /tmp.
-
- NNTPSERVER
- The default NNTP server to remotely read news from.
- This variable only needs to be set if the -r command
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 17
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- line option is specified and the file /etc/nntpserver
- does not exist.
-
- DISTRIBUTION
- Set the article header field Distribution: to the
- contents of the variable instead of the system default.
-
- ORGANIZATION
- Set the article header field Organization: to the
- contents of the variable instead of the system default.
- This variable has precedence over the file
- $HOME/.tin/organization 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.
-
- REPLYTO
- 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
- $HOME/.tin/replyto that may also contain a return
- address.
-
- ADD_ADDRESS
- 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
- user@bigvax, but bigvax is not recognized by your host,
- so therfore the mail will not reach user. But the host
- littevax is known to recognize your host and bigvax, so
- if ADD_ADDRESS is set (ie. 'setenv ADD_ADDRESS
- @littevax' for csh or 'set ADD_ADDRESS @littevax' and
- 'export ADD_ADDRESS' for sh) the address
- user@bigvax@littlevax will be used and the mail will
- reach user@bigvax. This variable has precedence over
- the file $HOME/.tin/add_address that may also contain
- an address.
-
- BUG_ADDRESS
- 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
- $HOME/.tin/bug_address that may also contain a mail
- address.
-
- MAILER
- This variable has precedence over the default mailer
- that is used in all mailing operations within tin (ie.
- replying 'rR', and bug reports 'B').
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 18
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- VISUAL
- This variable has precedence over the default editor
- (ie. vi) that is used in all editing operations within
- tin (ie. posting 'w', replying 'rR', follow-ups 'fF'
- and bug reports 'B').
-
- TIPS AND TRICKS
- 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 (ie. '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.
-
- FILES
- $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.
- $HOME/.signature signature.
- $HOME/.Sig signature.
-
- BUGS
- 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.
-
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 19
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- Does not yet handle Xref: headers for cross-posted articles.
-
- HISTORY
- 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 ?? parts to
- alt.sources on 13 May 1992.
-
- CREDITS
- Rich Skrenta
- author of tass v3.2 which this newsreader used as its
- base.
-
- Dave Taylor
- 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.
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 20
-
-
-
-
-
-
- TIN(1) LOCAL TIN(1)
-
-
-
- I wish to thank the following people for supplying patchs:
-
- Anton Aylward, Dieter Becker, Dan Berry, Marc Boucher, Leila
- Burrell-Davis, Robert Claeson, Steven Cogswell, Ned
- Danieley, Brent Ermlick, Carl Hage, Paul Halsema, Ed Hanway,
- Torsten Homeyer, Nelson Kading, Fritz Kleeman, Karl-Koenig
- Koenigsson, Kris Kugel, Hakan Lennestal, Clifford Luke,
- Michael Faurot, David MacKenzie, Bill Poitras, 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, Cary
- Whitney, 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, 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, Per Lindqvist, Bob Lukas, Kazushi Marukawa, Phillip
- Molloy, Toni Metz, Greg Miller, Klaus Neuberger, Otto
- Niesser, Reiner Oelhaf, Wolf Paul, John Palkovic, Andrew
- Phillips, Stefan Rathmann, Jonas Rwgmyr, Ted Richards,
- Daemon Schaefer, Klamer Schutte, Fredy Schwatz, Bernd
- Schwerin, Chris Smith, Daniel Smith, Steve Spearman,
- Hironobu Takahashi, Sven Werner, G. Woodbury, Orest Zboroski
-
- AUTHOR
- Iain Lea
- (iain%anl433.uucp@Germany.EU.net)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- May 18, 1992 Last change: Version 1.1 PL3 21
-
-
-
-