home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pmnews.zip / install.txt < prev    next >
Text File  |  1995-03-25  |  9KB  |  170 lines
  1. Some notes for PMNews ---
  2.  
  3. This program is a PM replacement for SNEWS.EXE, which means that
  4. you need the rest of Rommel's port or McCombs code plus UUPC
  5. to comtemplate using it.  However, I'm packaging OS/2 SNEWS
  6. programs with this.  They're all C Set++ statically linked
  7. so they'll take up some space.
  8.  
  9. The usual disclaimer is in effect:  no warranty, expressed or
  10. implied accompanies this code; if all your data, programs, and
  11. power-supply are destroyed by this program, I'm not liable.
  12.  
  13. Install the .exe and .ico files in a convenient subdirectory
  14. and create a WPS object which invokes it, specifying the residence
  15. directory as the working directory.
  16. In your PERSONAL.RC file, be sure that Editor and Aliases are
  17. specified with their full path and extension.
  18. The environment variables UUPCSYSRC, UUPCUSRRC, and UUPCNEWS
  19. must be available (usually means set in config.sys).
  20. UNBATCH, EXPIRE, ADDGROUP, RMGROUP suite of programs
  21. should be available in a directory named in the config.sys PATH.
  22. You MUST specify 'options=snews' in your UUPC.RC file.
  23. I'm including McCombs excellent original documentation for SNEWS.
  24.  
  25. 'unbatch' should be run after 'uuxqt' is run in your 'uuio'
  26. procedure.  It unpacks the batches into index and data files.
  27.  
  28. 'sthread.exe' is optional and should be run after each 'unbatch'
  29. or 'expire' to re-synchronize the .thr/.idx files.
  30. It provides 'References:' as well as subject-line threading.
  31. Removing all the .thr files in the newsbase directory will disable it.
  32.  
  33. Run 'expire' at any convenient interval.  The 'ng' file in your news
  34. directory can be used to specify the retention in days of articles
  35. for each group.  The value -1 is used to indicate a group such as
  36. 'junk', which is always expired.  This file is not supported for
  37. the current (DOS) version of SNEWS.  It's used to indicate which
  38. groups may be posted to (really a multi-user thing).  It has lines like:
  39.  
  40. comp.os.os2.setup             3
  41. comp.os.os2.networking.tcp-ip 3
  42. junk                          -1
  43.  
  44. ----------------------------------------------------------------------
  45. Source code is available upon request.  Arrange this via email.
  46. The program still suffers from being a first PM attempt.
  47. It's evident that just because a program is a GUI object does not
  48. mean that it is easier to use than a character-based application.
  49. Knowing  what I now know of PM, a rewrite would improve this.
  50.  
  51.  
  52. The program builds an .INI file after the first run, containing the
  53. locations of the group list dialog box and article window position
  54. and size. If you ever find that you're unable to open an article
  55. window, or the program stalls on takeoff, delete the PMNEWS.INI
  56. file and restart (make sure any hidden invocations of PMNEWS have
  57. been terminated).
  58.  
  59. If a tracked error occurs PMNews creates a file, pmnews.err.
  60. When an error occurs this file will contain some cryptic 'fprintf'
  61. information relevant to the error (if we're lucky).
  62.  
  63. There is no font support, so system proportional is what there is.
  64. This is particularly ugly in the mail-article listbox.
  65.  
  66. Send me e-mail for suggestions, complaints, etc.
  67.  
  68.  
  69. E-mail:  serls@dashs.denver.co.us
  70.  
  71.  
  72. Change log:
  73.  
  74.    11/23/92
  75.    Release 0.1  --  re-link with multi-thread libs
  76.                     add SNEWS style TAB/ESC/PGDN/PGUP/arrow keys
  77.                         for article window.
  78.                     Try to put real name of author on title bar.
  79.  
  80.    12/06/92
  81.    Release 0.2 --   primitive text search
  82.                     make header dialog select (double-click) acquire
  83.                         the first unread article.
  84.                     right-button on selected header gets 1st entry
  85.                         (but not in foreground!).
  86.                     On 101 keyboard, keypad plus and enter for
  87.                        next-unread and next article.
  88.    12/12/92
  89.    Release 0.3 --   fix search to allow post/mail
  90.                     implement 'prev' for previous article
  91.                        and map it to keypad '-'.
  92.    12/20/92
  93.    Release 0.4 --   was not erasing post.tmp file
  94.                     various bugs with multiple postings
  95.    02/08/93
  96.    Release 0.5 --   more elegant threading (might be slower).
  97.  
  98.    08/27/93
  99.    Release 0.6 --   releasing the source.  Note that there are
  100.                     duplicate SNEWS-named files:  active.c, history.c
  101.                                                   active.h, history.h
  102.                                                   defs.h
  103.                     these files are similar, but NOT quite the same
  104.                     as the originals.  Use another directory!
  105.                     Also, 2 threaders are provided (pmnthrd.c == original,
  106.                     pmmthrd.c is an adjustable threader, or provide a
  107.                     reference threader, please).
  108.    12/12/93
  109.    Release 0.7 --   provide some decent diagnostics for the error
  110.                     "Unable to load RC data".  Change from "***" to
  111.                     "---" for zero article value.
  112.    06/07/94
  113.    Release 0.8 --   help from group window (poor)
  114.                     change mouse button 2 to 'next unread thread'
  115.                       in header list
  116.                     provide case/in/sensitivity to group text search
  117.                     fix some small annoying things (group window seal)
  118.    Release 0.9 --   fixes article title-bar trash
  119.    Release 1.0 --   I'm sure the program has reached the minimum
  120.                     defect level by now -- no one is using it.
  121.                     If you do use it (there were a few UUCP users
  122.                     in Europe), please drop me a line if you have any
  123.                     nice modifications to include.
  124.                     Anyhow -- fixed the case sensitive search code;
  125.                               Just bad code.
  126.                     Added "real" header-reference threading; don't
  127.                     panic, it's optional and will cost you some disk
  128.                     space.  It produces a .THR file for each newsgroup
  129.                     which looks almost the same as the .IDX file
  130.                     (someday, they could be combined).  The program
  131.                     'sthread.exe' needs to be run after unbatching
  132.                     news, AND after expiring it.  I normally run expire
  133.                     after the overnight unbatching is done, so running
  134.                     'sthread' after 'expire' works for me.  The files
  135.                     are slightly smaller than the .IDX files.
  136.                     Since I'm wasting some bandwidth here, on the whole,
  137.                     subject line threading is more satisfying.  Some
  138.                     groups, unnamed, seem to revel in NOT providing
  139.                     'References:'; for them, only subject line will do.
  140.                     Some super-heuristic combination of the two would
  141.                     be best.
  142.    03/03/95
  143.    Release 1.1 --   Many bug fixes.  'sthread' has had several glaring
  144.                     errors fixed and seems operative except for the
  145.                     occasional 'loss' of an article.  I haven't isolated
  146.                     the reason for this.  'sthread' now combines both
  147.                     subject line and referential threading.
  148.                     The file 'post.log' is now maintained giving you a
  149.                     record of all the posts that you've sent.
  150.                     The annoying 'pmnews.err' file will ONLY be written
  151.                     when a error (or stray trace record) is written.
  152.                     Button 'NewPost' is offered on the thread header
  153.                     window. 'References:' header line is omitted when
  154.                     a 'new' post.  Bugfix:  when there were no unread
  155.                     articles, group window buttons terminated program.
  156.                     Added 'Groups' button on thread header window to
  157.                     return you to the Group window.  Now accepting '.cmd'
  158.                     files in the 'personal.rc' 'Editor' parameter.
  159.                     Fixed problems with new and followup posts not
  160.                     showing up when using 'sthread'.  Followups are
  161.                     shown out-of-sequence until next 'sthread' run.
  162.                     '.thr' file not used if not newer than corresponding
  163.                     '.idx' file.  Remove extra signature file inclusion
  164.                     when mailing article straightaway.  Properly obtain
  165.                     author's email address from article header when
  166.                     replying.
  167.    Release 1.2      Emit X-NewsReader header line
  168.                     Accept 'NewsServ=' keyword in UUPC.RC, if different
  169.                     from your MailServer; place it AFTER 'MailServ'.
  170.