Compilation and installation notes for tin - 01-02-92 
-----------------------------------------------------

Tin has been compiled on a wide range of Unix machines with cc and gcc.
A list of these machines can be found at the bottom of this file.  

It can be compiled to read news in any of the following ways:
  o  locally from your machines news spool dir, usually /usr/spool/news.
  o  remotely from another machine via NNTP.
  o  locally and remotely (rtin or tin -r option).

The NNTP (NetNews Transport Protocol RFC 977) software needs to be
installed on your machine if want to read news remotely. It is a
SEPERATE PACKAGE that is available from many FTP and mailserver
sites. The file that has to be linked with tin is clientlib.o. 

Building Tin
------------

1)  type 'make' and a few system types will be displayed
2)  edit Makefile if you want to add/change -D<dfines>
3)  type 'make <system type>' to compile for your system
4)  type 'make install' / 'make install_setuid' to install
    
Compiler flags (-D<name> define directives)
-------------------------------------------
News directory structure
------------------------

LIBDIR
Define if news software is not in /usr/lib/news.

INEWSDIR
Define if bnews/cnews program 'inews' is not in LIBDIR.

SPOOLDIR
Define if news articles are not in /usr/spool/news.


Reading news via NNTP
--------------------- 

USE_NNTP
Define if reading news remotely via an NNTP server.

NNTP_SERVER_FILE
Only define if your nntpserver file is other than /etc/nntpserver.

NNTPLIB
Contains the path of the file clientlib.o that is part of NNTP software.

NETLIBS
Contains the networking libraries needed to link with clientlib.o file.


Miscellaneous options
---------------------

POSIX_JOB_CONTROL
Define if your machine uses Posix style sigaction() signal handling.

USE_MKDIR
Define if your machine does not have the mkdir() system call.

USE_LONG_FILENAMES
Define if your machines filesystem supports filenames longer than 14
chars (default for BSD type systems).

USE_INVERSE_HACK
Define if you want inverse video and highlighted bar disabled. (default
for SCO Unix & SysVR4).  Can be toggled in tin by the 'I' command and
highlight bar by 'M' command.

USE_CLEARSCREEN
Define if the you wish screen to use ClearScreen() and not MoveCursor()
and CleartoEOLN(). This is perhaps faster on slow terminals but I have
not really run any speed tests recently.

SLOW_SCREEN_UPDATE
Define if running over a low speed connection (ie. 2400baud). It stops
the percentage info being shown at bottom of select and group menus and
stops the groupname being displayed at the bottom of the screen as it is
subscribed/unsubscribed.

NO_REGEX
Define if you do not want to use regular expression pattern matching.

NO_START_LINE
Do not start editor with line offset into file.

NO_SHELL_ESCAPE
Do not allow shell escapes.

NO_POSTING
Do not allow posting/followup of articles.

LOG_USER
Log user info each time tin is started to /tmp/.tin_log for usage statistics.

Compiled & installed on the following machines
----------------------------------------------

1) * Dec 5000/Vax & Ultrix 4.1/4.2
2) * Vax 11/785 & BSD 4.3
3) * 386 PC & Xenix 2.3/ATT SysVr4.0/SCO SysVR3.2/ISC SysVR3.2
3) * Sun 3/4/IPC/SS1/SS2 & SunOS 4.0.3/4.1/4.1.1 
4) * Sony News & SysVR4/BSD 4.3
5) * SNI MX300/MX500 & Sinix 5.22/5.23/5.24
6)   ICL DRS6000 & SysVR4.0 
7)   Atari STe & Minix 1.5.10.3b
8)   Apricot VX/FT & SCO 3.2.2
9)   DIAB DS90 & D-NIX 5.3
10)  Amdahl & SysVR3
11)  HP 9000/845 & HP-UX 7.0
12)  IBM RS/6000 & AIX 3.1.5
13)  NCR Tower & SysV
14)  Atari STe & Minix 1.5.10.3b
15)  386 PC & Minix 386
16)  DG Aviion & DG-UX

* = compiled, installed and used by author 
