home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume36 / uqwk / part01 / README < prev    next >
Encoding:
Text File  |  1993-03-11  |  3.0 KB  |  95 lines
  1. UQWK
  2.  
  3. Copyright 1993, steve belczyk
  4.  
  5. Uqwk is a program which collects all a user's unread mail or news
  6. and formats it into something called a "QWK" packet, which is then
  7. downloaded.  Mail and News can then be read offline, saving phone
  8. charges.  QWK readers exist for almost every machine.
  9.  
  10. Uqwk also accepts reply packets, so replies can be mailed (if your
  11. mailer understands "mail -s"), or posted (if you have a B-news type
  12. of inews that understands -n and -t), depending whether the message
  13. is marked private (email) or public (news).
  14.  
  15. Uqwk also supports a small offline command language, so the contents
  16. of the user's .newsrc file can be viewed and manipulated offline.
  17.  
  18. INSTALLATION
  19.  
  20. 1.  Create a directory for the uqwk source code.
  21.  
  22.     mkdir /usr/local/src/uqwk
  23.  
  24. 2.  Move the uqwk tar file to that directory.
  25.  
  26.     mv uqwk.tar.Z /usr/local/src/uqwk
  27.  
  28. 3.  Change to that directory, and unpack the tar file.
  29.  
  30.     cd /usr/local/src/uqwk; zcat uqwk.tar | tar xvf -
  31.  
  32. 4.  Compile the software.
  33.  
  34.     make
  35.  
  36.     If this doesn't work you may have to twiddle with the Makefile,
  37.     or, heaven forbid, the actual source code.
  38.  
  39. 5.  Move the binary and man pages to some public place.
  40.  
  41.     mv uqwk /usr/local/bin
  42.     mv uqwk.man /usr/man/man1/uqwk.1
  43.     mv uqwk.cat /usr/man/cat1/uqwk.1
  44.  
  45. 6.  The QWK specification allows for the name, location, etc., of
  46.     the BBS from which messages are being downloaded.  You should
  47.     configure this information.  The best way is probably to use
  48.     environment variables.  If you are using a Bourne shell, you
  49.     should add something like this to /etc/profile or .profile:
  50.  
  51.         UQ_BBS_NAME="My Super BBS"
  52.     UQ_BBS_CITY="Somewhere, PA"
  53.     UQ_BBS_PHONE="+1 215 555 1212"
  54.     UQ_BBS_SYSOP="Joe Shmoe"
  55.     UQ_BBS_ID="0,MYBBS"
  56.     export UQ_BBS_NAME UQ_BBS_CITY UQ_BBS_PHONE
  57.     export UQ_BBS_SYSOP UQ_BBS_ID
  58.  
  59.     If you use a C type shell, try something like this in your
  60.     .cshrc or .login:
  61.  
  62.         setenv UQ_BBS_NAME "My Super BBS"
  63.     setenv UQ_BBS_CITY "Somewhere, PA"
  64.     setenv UQ_BBS_PHONE "+1 215 555 1212"
  65.     setenv UQ_BBS_SYSOP "Joe Shmoe"
  66.     setenv UQ_BBS_ID "0,MYBBS"
  67.  
  68.     In both cases, the last entry, the "BBS ID", is the most important.
  69.     It always consists of an integer, a comma, and a string less than
  70.     nine characters, with no intervening spaces.  The string will be
  71.     used to identify reply packets.
  72.  
  73. 7.  Now you can try it.  Log in as a normal user who has some mail,
  74.     and issue:
  75.  
  76.     uqwk +r
  77.  
  78.     (The "+r" stops uqwk from clearing the user's mail spool file.)
  79.     This should create three new files in the current directory named
  80.     messages.dat, control.dat, and personal.ndx.  These are the files
  81.     which the offline reader will need.  (Not all readers need the
  82.     *.ndx files.  Also, some readers expect these files to have been
  83.     archived using an archiver like zip, lharc, or arj.  You may need
  84.     to obtain Unix versions of these archivers.)
  85.  
  86. 8.  Now it would be a good idea to read the man page.
  87.  
  88. Please inform me of any problems you run into:
  89.  
  90.     steve belczyk
  91.     steve1@genesis.nred.ma.us
  92.     seb3@gte.com
  93.     BBS: +1 508 664 0149
  94.  
  95.