home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / trn_197b.zip / readme.os2 < prev    next >
Text File  |  1995-01-31  |  12KB  |  279 lines
  1. TRN 1.97 (beta) for OS/2 is based the Unix-Version 3.5. Is was
  2. ported using the EMX 0.9a GCC 32-bit-C-Compiler.
  3.  
  4. This package is a    BETA   release.
  5.  
  6. The program requires at least OS/2 2.0, it will not run
  7. together with the EMX-extender for DOS (although this
  8. was not explicitely tested). It was designed to run
  9. together with the UUPC-Package by Drew Derbyshire.
  10.  
  11. If you use the NNTP version of TRN:
  12. -----------------------------------
  13. This package uses a REXX inews to post articles to the NNTP news
  14. server.  Because of this, you need to get the rxsock.dll package from
  15. software.watson.ibm.com:/pub/os2/ews/rxsock.zip and install it
  16. somewhere in your LIBPATH (\tcpip\dll is one place to put it).  The
  17. inews does NOT support the AUTHorization protocol that some nntpd
  18. servers require.  I'll consider implementing this if enough people
  19. require it.  
  20.  
  21. **REMARK**:  You need a hpfs-partition, where the news
  22.      will be stored, where your personal file will
  23.      be located (your home-directory) and where temporary
  24.      files can be created (the uupc-temp-directory and the
  25.      TMP environment variable).
  26.      The reason are the long filenames, that are
  27.      hardcoded in the TRN-Source. Also TRN will use
  28.      a completely unix-compatible filestructure to
  29.      store the news. So there will be directory-names
  30.      like 'c:/usr/uupc/news/alt/cyberpunk' or even longer
  31.      ones. If there is enough desire for a FAT-version,
  32.      I will perhaps do that later.
  33.  
  34.  
  35. Installation:
  36.  
  37.  - Put the executables into a directory listed in your path.
  38.    The full name of the directory (including drive) must be
  39.    listed in the TRN-rc-file. 
  40.  
  41.  - Put the emx*.dll files into a directory listed in your LIBPATH.
  42.    If you already have emx*.dll-Files, check if yours are newer
  43.    that the ones included in this package. If your's are newer, don't
  44.    replace then, TRN should work with them. At least emx 0.9a with the
  45.    first emxpatch is needed.
  46.    (hobbes.nmsu.edu:/pub/os2/32bit/unix/emx09a/emxrt.zip)
  47.  
  48.  - Edit your config.sys and add the following setting:
  49.          UUPCTRNRC
  50.          UUPCUSRRC
  51.          UUPCSYSRC
  52.    The setting must include the whole path to the file, like
  53.    UUPCSYSRC or UUPCUSRRC  (e.g.: SET UUPCTRNRC=C:/USR/UUPC/CONFIG/TRN.RC)
  54.    You may use either "/" or "\" in this path.
  55.    UUPCSYSRC and UUPCUSRRC can point to the same file, I've included a
  56.    sample system.rc which I use with elm as well as trn.
  57.  
  58.  - Set the environment variable NNTPSERVER.
  59.    This must be set to the name or IP address of the NNTP server you
  60.    use. 
  61.  
  62.  - Set the environment variable HOME to point where you want .newsrc
  63.    and other personal files to be stored.  This must be on HPFS.  Also
  64.    set TMP to where you want temp files stored.  It must be on HPFS
  65.    and the TempDir option in system.rc must match it.  
  66.  
  67.  - Look through your UUPC-rc-files, and check if the information
  68.    is complete and correct. The following settings are required
  69.    (they are NOT optional, and remember that UUPCSYSRC and UUPCUSRRC
  70.    can be the same file):
  71.    UUPCSYSRC:
  72.        MailServ, NodeName, ConfDir, NewsDir, Domain, TempDir, MailDir
  73.    UUPCUSRRC:
  74.        Mailbox, Signature, Name, Home, Organization, Editor
  75.    UUPCTRNRC:
  76.        Newsadmin, TrnLib, LocalDist, OrganizationDist, CityDist,
  77.        StateDist, Countrydist, ContinentDist
  78.  
  79.    Don't forget, these settings are required, not optional!
  80.  
  81.    Path-names in this settings may either use '/' or '\' as
  82.    directory separators. This didn't work in the previous version
  83.    of the OS/2 port (version 1.0) but this is (hopefully) fixed now.
  84.  
  85.    UUPCTRNRC: The variable Newsadmin is the name of the mailbox
  86.               of the person which does sysadmin on the machine,
  87.               this may be the same as the variable Mailbox in the
  88.               UUPCUSRRC-file.
  89.  
  90.               TrnLib is the directory, where the executables
  91.               are located (TRN looks for the file newsnews there
  92.               and also stores some configuration files there).
  93.  
  94.               The other 6 settings are the values for the
  95.               distributions you want to use for postings.
  96.  
  97.    If you use the environment-variable HOME, it will overwrite
  98.    the setting Home in the UUPCUSRRC.
  99.  
  100.    REMARK: If you use the UUPC version of TRN and you have UUPC already
  101.            installed and running, you only have to add UUPCTRNRC. The
  102.            other rc-files are probably already set up correctly.
  103.  
  104.            If you use the NNTP version, I suggest that you use the
  105.            supplied files system.rc and trn.rc and adapt the few
  106.            settings in the files to you need.
  107.  
  108.  - copy the file TERMCAP.DAT to one of your directories
  109.    for example the config-directory of UUPC.
  110.    The included termcap file also includes the correct settings
  111.    for the four cursor keys in the ANSI entry.  If you use the
  112.    "ansi-color-2" or "ansi" terminal setting, your arrow keys will
  113.    work.
  114.  
  115.  - set another environmentvariable: TERMCAP. This is the value
  116.    for the terminal-definition-file you want to use. The setting
  117.    must include the whole path to the TERMCAT.DAT-file
  118.    (SET TERMCAP=C:/USR/UUPC/CONFIG/TERMCAP.DAT).
  119.    You may use either "/" or "\" in this path.
  120.  
  121.  - Now with your TERMCAP.DAT installed, you must set the
  122.    TERM-variable. (e.g. SET TERM=ansi)
  123.  
  124.  - Copy the included .trnmac file to you home directory to enable
  125.    some default key mappings. This file defines a command for the
  126.    function keys F1 and F8 and for the keys <HOME> and <END>
  127.  
  128.  
  129. Remarks:
  130.  
  131.   -  TRN can not only save but also extract articles directly
  132.      by using the e-command when displaying the article. TRN
  133.      will try to determine the type of the file. It will
  134.      recognize uuendoded or shiped (zip-archiver) articles and
  135.      also SHAR'ed files. TRN will use it's own routines to
  136.      uudecode and unship articles. This will also work if
  137.      the archive consists of multiple articles (just type 'e /dirname'
  138.      on the first part and then only 'e' on the following ones).
  139.      If a shell-archive is detected, TRN will call the external
  140.      programs 'tail' and 'unshar' to extract the archive.
  141.  
  142.      You must ensure that you have the Unix-Tools 'tail' and
  143.      'unshar' installed and in the path. Tail will be used to strip 
  144.      off the header so that only the article-body is saved. tail is 
  145.      a unix-tool which was ported by Kai-Uwe Rommel and can be found 
  146.      in the "gnututil.zoo", the GNU Text Utilities on ftp-os2. Also 
  147.      the program "unshar" can be found on ftp-os2.
  148.  
  149.   -  XTHREAD support is the default, if your nntpd uses NOV thread
  150.      files, then add -Zo to your TRNINIT env. variable.
  151.  
  152.   -  A note about entries in *.rc -- try to make them match your system as
  153.      closely as possible, some entries are still used (amazing, eh?).  One
  154.      to watch out for is NodeName.  This should be set to whatever you want
  155.      to the right of the "@" in the From: line of your posts.  You can
  156.      always modify what you want in your headers by defining NNTPHEADERS,
  157.      but that is not for the faint of heart.
  158.      
  159.   -  If you are using tia on netcom, email me asking about a new nntpd so
  160.      you can use thread files on netcom.
  161.      
  162.   -  To use inews (so you can post newsgroups) you need the rxsock.dll from
  163.      software.watson.ibm.com:/pub/os2/ews/rxsock.zip  -- this was included
  164.      in tcpip 2.0 in the latest CSD, I don't know why it was not included
  165.      in Warps IAK. <shrug>  Inews was a quick hack done by me to get trn to
  166.      post to an nntp server.  Let me know if it fails with as much detail
  167.      as possible.  It is fairly dumb, but gets the job done.  It expects
  168.      one and ONLY one parameter (-h) which has to be used.  the second
  169.      parameter will be interpreted as the input file which can also be
  170.      stdin (as in a pipe).
  171.      
  172.   -  weird, it traps if I have optimization turned on -- this will be
  173.      tough to track down I suppose. :(  So it is being compiled w/out
  174.      optimization.
  175.  
  176.   -  TRN now uses the setting Rmail to invoke a mailer. Previously the
  177.      call to rmail was hardcoded in TRN. Now it is possible to specify
  178.      sendmail as mailer (I've not done this yet myself).  
  179.  
  180.        - The rmail setting may be omitted in which case
  181.         "rmail -f filename -t" is used.
  182.  
  183.        - The rmail setting may be defined as "sendmail" in
  184.          which case "sendmail -af %s -t" will be used.  This
  185.          makes it compatible with elm for OS/2.
  186.  
  187.        - A setting may be specified which does not contain the
  188.         option "%s", for example:
  189.         Rmail=c:\usr\uupc\bin\mymailer.exe
  190.         In this case the command
  191.         "c:\usr\uupc\bin\mymailer.exe -f filename -t"
  192.         would be used to send mail
  193.  
  194.        - Or a complete new rmail command can be specified where "%s"
  195.         is replaced with the filename of the mail to be sent, example:
  196.         RMail=c:\usr\uupc\bin\mymailer.exe -b -f %s -s
  197.         In this case the command
  198.         "c:\usr\uupc\bin\mymailer.exe -b -f filename -s"
  199.         would be used to send mail
  200.  
  201.   -  The news post command is configurable via environment parameter.
  202.      The default (if no environment setting is specified) is
  203.      "inews -h < filename"   where filename is the article to post.
  204.      The environment variable NEWSPOSTER can be set to specify a
  205.      different call, for example:
  206.      NEWSPOSTER=c:\usr\uupc\bin\myposter -h %h
  207.      The option "%h" will be replaced with the fully qualified filename
  208.      of the file to post and must be given somewhere in the setting.
  209.  
  210.  
  211.  
  212. *******************************************************************
  213. Thanks:
  214.  
  215.         Thanks to Herbert Neugebauer for the initial port of trn 3.5
  216.         to OS/2 with UUPC support.  Without his base code I wouldn't
  217.         have gotten this close to a finished product (NNTP was easy
  218.         due to all his original work).  
  219.  
  220.     Thanks to Eberhard Mattes for his excellent work on
  221.     the port of GNU GCC for OS/2. Porting TRN would have been
  222.     impossible to do without his GCC, because of lots of
  223.     unix-specific functions.
  224.     
  225.     Thanks also to Kai-Uwe Rommel for his betatest and
  226.     the resulting improvements. A lot of suggestions
  227.     he made will be in the next release.
  228.  
  229.     Thanks to Eric Veldhuyzen who did a lot of beta testing
  230.     on version 1.95b and who sent a lot of reports and
  231.     suggestions.
  232.  
  233.     Thanks also to the others who tested TRN.
  234.     
  235. ********************************************************************
  236.  
  237. Please send your suggestions, remarks or bug reports to
  238.  
  239. for NNTP stuff
  240. Rupa Schomaker          rupa@netcom.com
  241.  
  242. if it affects the base trn code maybe CC: it to 
  243. Herbert Neugebauer      haen@veces.bb.bawue.de
  244.  
  245. ********************************************************************
  246.  
  247. Remarks and ToDos:
  248. ------------------
  249.  
  250.  - I had some problems with the OS/2 filesystems. Or better
  251.    with the Un*x-filesystem. There are no file links under
  252.    OS/2. I avoided them using the DosCopy API-function.
  253.    In most cases this may be suitable, but this may cause
  254.    problems under certain circumstances.
  255.    *** such problems were never experience ...  ***
  256.  
  257.  - currently the commands s S w and W for saving articles
  258.    do the same, there is no difference between them.
  259.    TRN doesn't save via a shell, it does it directly on it's own
  260.    and this will not be fixed, so there will be no difference
  261.    between s and S (btw. w and W) in future.
  262.    But the stripping of the header (w and W) will be included
  263.    later.
  264.    ******* partly fixed at 08/15/92, now the stripping of
  265.       the header with the w-command is working. But there is still
  266.       no difference between s and S and between w and W. *****
  267.  
  268.  - There was also a Problem when a file was opened two times
  269.    simultaneously. This is not possible with the fopen
  270.    command in EMX. I fixed this temporarily by copying the
  271.    file first and then opening the copied one only for reading.
  272.    There is another way by using API-calls and fdopen, so
  273.    this may be fixed later.
  274.    *** this should work now, because the fopen in EMX now allows  ***
  275.    *** shared opening of files. Be sure not to have TRN running   ***
  276.    *** while rnews is executed. Though rnews in version 1.12j is  ***
  277.    *** able to avoid news loss, it might still cause problems.    *** 
  278.  
  279.