home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / uqwk18.zip / README.OS2 < prev    next >
Text File  |  1994-09-12  |  4KB  |  108 lines
  1.  
  2.                                  UQWK/2
  3.  
  4.                     Copyright 1993-1994, steve belczyk
  5.  
  6.                         OS/2 port by Claudio Fahey
  7.                         claudio@uclink.berkeley.edu
  8.  
  9.  
  10. INSTALLING:
  11.  
  12.     To install UQWK, copy UQWK.EXE, INEWS.EXE, and MAIL.CMD to a
  13.     directory in your path.  You also need the emx run-time DLLs.  You 
  14.     can get these from ftp-os2.nmsu.edu:/os2/2_x/unix/emx08h/emxrt.zip.
  15.     Then make sure your environment variables are set correctly (see 
  16.     below).  If you don't already have a .newsrc file in your home 
  17.     directory, then create one.  
  18.  
  19.     To test it, run "uqwk +L -m +n +r".  This will create a SOUP packet
  20.     in your home directory with news only.  It won't update your .newsrc
  21.     file.
  22.  
  23.     Here's a typical batch file designed to import news into Yarn:
  24.         cd \home
  25.         uqwk +L -m +n
  26.         zip -0m soup.zip *.msg areas
  27.         import soup.zip
  28.     And to export messages from Yarn:
  29.         cd \temp
  30.         unzip -o \home\soup.zip
  31.         del \home\soup.zip
  32.         uqwk +L -m -Rreplies
  33.  
  34. ENVIRONMENT VARIABLES:
  35.  
  36.     In addition to the environment variables mentioned in the man page,
  37.     the following variables are used:
  38.  
  39.     HOME    Specifies the users home directory.  This is where the
  40.             .newsrc file is located and where news packets are stored.
  41.             This defaults to the current directory.
  42.  
  43.     USER    The user's login name.  This could be anything you want in OS/2.
  44.             This defaults to "unknown"
  45.  
  46.     NNTPSERVER  Specifies the NNTP news server.  This is required unless news
  47.                 is being read from a news spool file.
  48.  
  49.     MAILER  Command to send mail.  This defaults to "sendmail".  If
  50.             using LamPOP, this could also be set to "lampop -s myhost.domain
  51.             myname mypasswd"
  52.  
  53.     POSTER  Command to post news.  This defaults to "inews".
  54.  
  55.     TEMP    Directory where temporary files are stored.  This defaults
  56.             to the current directory.
  57.  
  58. LIMITATIONS:
  59.  
  60.     Receiving mail is not supported since OS/2 does not spool mail the 
  61.     way Unix does.  
  62.  
  63.     Sending mail from ZipMail packets does not work because
  64.     OS/2's sendmail command does not support a command of the form:
  65.         sendmail 'joe@host.domain'
  66.     This could probably easily be fixed by adding a few lines or using
  67.     MAIL.CMD to add the To: address.
  68.  
  69.     The included UQWK.EXE was compiled with NNTP support.  This support 
  70.     requires IBM TCP/IP 2.0.  
  71.  
  72. CHANGES TO THE SOURCE:
  73.  
  74.     Changed fopen modes to binary except for the following files:
  75.         nrc_file    (.newsrc file)
  76.         trn_file    (translate file)
  77.         ng_file     (newsgroup file)
  78.         sum_file    (summary file)
  79.         sel_file    (selection file)
  80.  
  81.     Put temporary files in TEMPDIR instead of "/tmp".  TEMPDIR is
  82.     defined as getenv(TEMP) or the current directory.  
  83.  
  84.     Sendmail and inews commands are taken from MAILER and POSTER
  85.     environment variables, respectively.
  86.  
  87.     Modified reply.c to support the way the sendmail and inews paths
  88.     and command line parameters are specified.  For example, the
  89.     following line: 
  90.         sprintf (buf, "%s", XPRT_MAILER);
  91.     was changed to:
  92.         sprintf (buf, "%s -t", SENDMAIL_PATH);
  93.  
  94.     Modified nntplib.c so that it accesses the socket directly instead
  95.     of through a FILE stream.  This is because, in OS/2, fdopen can't be
  96.     used to open a socket, only a file.  The file sockstream.c includes
  97.     some functions such as sockgets() which should replace fgets() calls
  98.     when referring to a socket.
  99.  
  100. BUGS, ETC:
  101.  
  102.     Feel free to send comments, bug reports, or suggestions related to 
  103.     this OS/2 port to me.
  104.  
  105.     Claudio Fahey
  106.     claudio@uclink.berkeley.edu
  107.  
  108.