From: haen@veces.stgt.sub.org (Herbert Neugebauer)
Newsgroups: comp.os.os2.apps
Subject: TRN, Newsreader for OS/2
Date: 27 Sep 92 18:10:39 GMT
Organization: TRN Porting Labs

Hello,

it's a few weeks later than I first expected, but
the OS/2 port of the unix-newsreader TRN should
now be available at rusmv1 (Stuttgart, Germany) and
ftp-os2.

Have fun, and nice reading

    Herbert
    
------------------------------TRN readme------------------------------------
TRN for OS/2 is based the Unix-Version 2.2. Is was
ported using the EMX 0.8d (GCC) 32-bit-C-Compiler.

The program requires at least OS/2 2.0, it will not run
together with the EMX-extender for DOS (not tested).
It was designed to run together with the UUPC-Package
by Drew Derbyshire. Because UUPC does not have real
News-Support until version 1.11q, we included our own
Rnews-program. If you have another package which
produces Unix-compatible News-Database, it may run
together with TRN. If you have UUPC 1.11v installed,
you have to replace the orignial rnews.exe and expire.exe
with the ones in this package.

**REMARK**:  You need a hpfs-partition, where the news
     will be stored, where your personal file will
     be located (your home-directory) and where temporary
     files can be created (the uupc-temp-directory).
     The reason are the long filenames, which are
     hardcoded in the TRN-Source. Also we will use
     a completely unix-compatible filestructure to
     store the news. So there will be directory-names
     like 'c:/usr/uupc/news/alt/cyberpunk' or even longer
     ones. If there is enough desire for a FAT-version,
     we will built one later, if the HPFS-version runs
     correctly (it is a betatest-version at the moment).


This package includes:
  TRN        --  the newsreader
  MThreads   --  it generates the thread-database
  TmpThread  --  this program is called by TRN for temporary thread files
  ActTimes   --  this program generates and updates the active.times file

  Rnews      --  this replaces original Rnews of UUPC
  Expire     --  removes old news articles
  compress   --  decompresses newsbatches, called from within rnews


Installation:

 - Put the executables into a directory listed in your path.
   The full name of the directory (including drive) must be
   listed in the TRN-rc-file. The best thing seams to be
   your UUPC-binaries-directory. The rnews.exe of UUPC must
   be replaced by the one provided in this package, if you
   have already installed an expire-program, you must also
   replace it with the one in this package.

 - Put the emx.dll into a directory listed in your LIBPATH.
   If you already have an emx.dll, check if yours is newer
   that this one. If your's is newer, don't replace it,
   TRN should work with it.

 - The directory, where the TRN-executables are located and
   the one, where the UUPC-execs can be found MUST be in
   to PATH-variable, so that they can be found by TRN.
   Also the external editor (and perhaps the lister) MUST
   be in everybodies path.

 - Edit your config.sys and add the following setting:
         UUPCTRNRC
   The setting must include the whole path to the file, like
   UUPCSYSRC or UUPCUSRRC  (e.g.: SET UUPCTRNRC=C:/USR/UUPC/CONFIG/TRN.RC)
   You may use either "/" or "\" in this path.

 - Look through your UUPC-rc-files, and check if the information
   is complete and correct. The following settings are required
   (they are NOT optional):
   UUPCSYSRC:
       MailServ, NodeName, NewsDir, Domain, TempDir, MailDir, rmail
   UUPCUSRRC:
       Mailbox, Signature, Name, Home, Organization, Editor
   UUPCTRNRC:
       Newsadmin, TrnLib, LocalDist, OrganizationDist, CityDist,
       StateDist, Countrydist, ContinentDist

   Don't forget, these settings are required, not optional!

   Please use the normal "/" instead of the "\" for the
   following settings: NewsDir, TempDir, MailDir, TrnLib.

   UUPCTRNRC: The variable Newsadmin ist the name of the mailbox
              of the person which does sysadmin on the machine,
              this may be the same as the variable Mailbox in the
              UUPCUSRRC-file.

              TrnLib is the directory, where the executables
              are located.

              The other 6 settings are the values for the
              distributions you want to use for postings.

   If you use the environment-variable HOME, it will overwrite
   the setting Home in the UUPCUSRRC.

 - copy the file TERMCAP.DAT to one of your directories
   for example the config-directory of UUPC.

 - set another environmentvariable: TERMCAP. This is the value
   for the terminal-definition-file you want to use. The setting
   must include the whole path to the TERMCAT.DAT-file
   (SET TERMCAP=C:/USR/UUPC/CONFIG/TERMCAP.DAT).
   You may use either "/" or "\" in this path.

 - Now with your TERMCAP.DAT installed, you must set the
   TERM-variable. (e.g. SET TERM=ansi or SET TERM=window).


Now you can get some news-batches with UUPC. If your settings
are correct, and your using the rnews provided with TRN,
the news will be delivered to the directory listed in the
NewsDir-Variable in your UUPCSYSRC. Rnews will also create
and maintain the active-file. Now you must create the active.times
file. This is done simply by typing acttimes to the command line.
The active.times file should be located in the same directory
as the active file.

Now you can either start TRN or first create thread files
for specific newsgroups. This can be done by using
   mthreads news.group     to thread a specific group, or
   mthreads all            to thread every group.

For more information on the programs please refer to
the original documentation.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

--
~~~~~~ Herbert Neugebauer ~~~ Eberhard Str. 5 ~~~~~~ W-7038 Holzgerlingen ~~
~~ haen@veces.stgt.sub.org ~~~ phone:  07031-603164 ~~~~~    Germany	  ~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~  This sentence in English is difficult to translate into German.	 ~~~
~~					   -  D. R. Hofstadter		 ~~~