home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / TIN121.ZIP / README.OS2 < prev    next >
Text File  |  1993-08-20  |  7KB  |  192 lines
  1. This is the OS/2 port of TIN.
  2.  
  3. To build TIN, you need the following:
  4.  
  5.   - IBM C Set/2 or Borland C++ for OS/2
  6.   - PDCurses 2.0 build for the compiler of your choice
  7.  
  8.   For the NNTP version of TIN:
  9.     - IBM TCP/IP 1.2.1 CSD UN37938 or higher,
  10.     - IBM TCP/IP 1.2.1 Programmers's Kit CSD UN37942 of higher, with 
  11.       modifications as outlined below.
  12.  
  13. To run it you need:
  14.  
  15.   - set environment variables
  16.   To read news via NNTP
  17.     - TCP/IP access to an nntp server,
  18.     - some free space on a HPFS or NFS volume (FAT will not work, due to 8.3 file
  19.       name restriction)
  20.  
  21.   optional:
  22.     - uudecode and uushar utilities
  23.       Note: uudecode is posted regularly to comp.binaries.os2 in the
  24.             "OS/2 Binaries Starter's Kit" by mykek@miller.cs.uwm.edu
  25.             (OS/2 binaries moderator)
  26.  
  27. Building TIN for OS/2
  28.  
  29. 1. Make sure that all source files (*.c and *.h) have <CR><LF> as their 
  30.    line-ends. If not, use 'unix2os2 < original >newfile' to correct this.
  31.  
  32. 2. Select the makefile appropriate for your compiler:
  33.     Makefile.bcc for Borland C++ for OS/2
  34.     Makefile.icc for IBM's C Set/2 Compiler
  35.     Note: Borland C is prefered. You may have to make some adjustments when you
  36.           use IBM's C.
  37.  
  38. 3. Edit the makefile, changing location of include and library files to
  39.    match your installation
  40.  
  41. 4. Correct bugs in \tcpip\include\netdb.h
  42.      find all occurrences of 'char *' that are not followed by '_Seg16' and add
  43.      '_Seg16'. For example change
  44.        SERVENT * _Seg16 _Far16 _Cdecl getservbyname( char *, char * );
  45.      to
  46.        SERVENT * _Seg16 _Far16 _Cdecl getservbyname( char * _Seg16, char * _Seg16 );
  47.      You will also correct the prototype for getservbyport and getprotobyname.
  48.  
  49. 5. If you are using Borland C++, edit the TCP/IP header files:
  50.     in netdb.h, netlib.h sys/socket.h do the following:
  51.       - find the #ifndef __32BIT__ near the top of each file
  52.  
  53.       - change the conditional section as follows:
  54.         #ifndef __32BIT__
  55.         #ifdef __TURBOC__
  56.         #define _Packed
  57.         #define _Seg16 _far16
  58.         #define _Far16 _far16
  59.         #define _Cdecl _cdecl
  60.         #define __32BIT__
  61.         #else
  62.         #define _Packed
  63.         #define _Seg16
  64.         #define _Far16
  65.         #define _Cdecl
  66.         #endif
  67.         #endif
  68.  
  69.       - add the following below the second #endif
  70.         #ifdef __TURBOC__
  71.         #define FAR16P _far16 *
  72.         #else
  73.         #define FAR16P * _Seg16
  74.         #endif
  75.                           
  76.       - throughout the files change '* _Seg16' and '*  _Seg16'  to 'FAR16P'
  77.    After these changes, the TCP/IP package can be used with the Borland C
  78.    compiler.
  79.  
  80. 6. If you are using Borland C++ type 'make -f makefile.bcc'
  81.    If you are using IBM's C Set/2 type 'nmake -f makefile.icc'
  82.    Ignore warnings, especially re _Cdecl and _Seg16 re-definition.
  83.  
  84.  
  85. Using TIN under OS/2
  86.  
  87. To run the local newsspool version, start TIN. To run the NNTP version, 
  88. start TIN -r, or rename TIN.EXE to RTIN.EXE and run RTIN.
  89.  
  90. TIN runs in an OS/2 windowed session. It is not a PM application. TIN needs to
  91. know who you are, in order to create headers for posts and mail correctly.
  92. There are two ways in which you can specify this information:
  93.  
  94. - through environment variables
  95. - through a Unix-style passwd file
  96.  
  97. Environment Variables
  98.  
  99. If only one person is using TIN to post articles, set the following variables
  100. in your config.sys file:
  101.  
  102.   USER userid                           set USER=andreas
  103.   REALNAME Your Full Name               set REALNAME=Andreas Wrede
  104.   HOME \your\home\directory             set HOME=c:\home\andreas
  105.  
  106. Note that you HOME directory must be on a HPFS or NFS disk. FAT will
  107. probably not work, due to the 8.3 file name restriction. 
  108.  
  109.  
  110. Unix-style passwd file
  111.  
  112. If a number of users use TIN to post articles, for example via telnet to the OS/2
  113. machine, it might be easier to use the Unix-style passwd file. The passwd file is
  114. located in the directory set by the environment variable ETC, usually c:\tcpip\etc.
  115. The same passwd file is used by ftp and telnet (via loginunx.exe). See your TCP/IP 
  116. User's Guide for more information. 
  117.  
  118. TIN does no use the password field, but the full user name, the home directory and 
  119. the shell are taken from the passwd file entry. The environment variable USER is 
  120. used to locate the correct entry in the passwd file. If it is not set, an error 
  121. message is issued by TIN. Two sample passwd entries follow:
  122.  
  123. andreas:x:1:1:Andreas Wrede:/home/andreas:/os2/cmd.exe
  124. guest:x:2:2:Guest User:/home/guest:/ksh/ksh
  125.  
  126.  
  127. Other Environment Variables
  128.  
  129. Required for NNTP version:
  130.  
  131. NNTPSERVER - either the fully qualified domain name of the nntp server or
  132.              the dotted internet address of the nntp server.
  133.  
  134. HOSTNAME   - specifies the name of your machine. It is used to identify your 
  135.              machine to the nntp server.
  136.  
  137. Required for local newspool version:
  138.  
  139. TINSPOOLDIR   - path to the root of the news spool
  140.  
  141. TINLIBDIR     - path to news control: active file, newsgroups file etc.
  142.  
  143. TINNOVROOTDIR - path to overview files
  144.  
  145. Optional:
  146. LINES  - specify how many lines you display window has. If LINES is not set,
  147.          TIN will use the actual height of the display window. You might need
  148.          to set this if you run TIN from a telnet session.
  149.  
  150. EDITOR -
  151. VISUAL - specify the editor to use for composing articles and replies. 
  152.          Defaults to 'epm'.
  153.  
  154. SHELL -  specify command process to use for shell escapes - defaults to 
  155.          whatever is set by COMSPEC
  156.  
  157.  
  158. For other environment variables, see ENVIRONMENT VARIABLES in tin.man.
  159.  
  160. FTP sites that carry the latest version of tin source are:
  161.  
  162.    Reference site:
  163.      Germany  [192.76.144.129]  ftp.Germany.EU.net:pub/news/tin
  164.  
  165.    Mirror sites:
  166.      UK  [146.169.2.1]  src.doc.ic.ac.uk:computing/usenet/software/readers/tin
  167.      USA [131.210.1.4]  ftp.uwp.edu:pub/tin
  168.      Oz  [130.194.9.1]  yoyo.cc.monash.edu.au:pub/tin
  169.  
  170. CHANGES  tin v1.2 PL0 -> tin 1.2 PL1 [OS/2]
  171.  
  172. 1)  Olaf Mittelstaedt <mstaedt@eagle.rz.fh-ulm.de>
  173.     BUG. tin needs c:\tmp on a HPFS partition
  174.     FIX. use envvar TMPDIR for location of tmp directory
  175.  
  176. 2)  Malkani Sanjay <sanjay@uxmail.ust.hk>
  177.     ASK. support for local newsspool
  178.     ADD. support for local newsspool
  179.  
  180. 3)  Richard Stanton <stanton@haas.berkeley.edu>
  181.     BUG. Cannot use C:\ as HOME.
  182.     FIX. checking for trailing '\' in path before adding '\'
  183.  
  184. 4)  Andreas Wrede <andreas@scilink.org>
  185.     BUG. archive not placed in "Archive: " directory
  186.     FIX. changed S_IFDIR check in save.c
  187.  
  188.  
  189. Enjoy!
  190.  
  191. Andreas Wrede (andreas@scilink.org)
  192.