home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / KSPMTS31.ZIP / WHATSNEW.DOC < prev   
Encoding:
Text File  |  1996-09-07  |  41.2 KB  |  931 lines

  1.  
  2.  
  3.  
  4.                           WHAT'S NEW IN KSP-MAIL
  5.  
  6.  
  7.      3.1:  Major  Bug  Fix!:  If a timeout occured while receiving the
  8.            text  of  an inbound email message, KSP-Mail would send the
  9.            error  message  "421  Internal  problem, mail discarded" to
  10.            the  remote  client  and  go back to look for the next SMTP
  11.            command  from  the  client; however, the client would still
  12.            be  sending  the  remainder  of  the  message text and this
  13.            confused  the  command  interpreter, causing the program to
  14.            ultimately  crash.  Now, after KSP-Mail sends the 421 error
  15.            message  to  the  client,  it  logs  an  explanation of the
  16.            nature   of   the  internal  error,  and  then  aborts  the
  17.            connection.         The        default       value       of
  18.            "ksp-mail.server_timeout"  has  now  been increased from 60
  19.            seconds to 300 seconds (5 minutes) per RFC 1123.  
  20.  
  21.            Bug  Fix:  The  NNTP  server  implemented  by  the "pushed"
  22.            version  of  News-In  was  using  the  value of "sockdelay"
  23.            rather than "ksp-mail.server_timeout".  Corrected.  
  24.  
  25.            Bug  Fix:  The  wrong  time  stamp  was  being  recorded in
  26.            POSTED.IDX,  thus  affecting  removal  of  old news article
  27.            ID's.  Corrected.  
  28.  
  29.            Clean   Up:   Mail-In  log  files  have  been  renamed  for
  30.            consistency (e.g., MAIL-IN.001 is now MAIL-IN1.LOG).  
  31.  
  32.            Clean Up: Renamed PCBNEWSG.EXE to PCB-GRPS.EXE.  
  33.  
  34.            New  Feature:  Added  a  log  file  for  the  execution  of
  35.            external commands (EXT-CMDS.LOG).  
  36.  
  37.            New  Feature:  Added  six  new  configuration parameters to
  38.            limit       growth       of      log      files      (e.g.,
  39.            "ksp-mail.log_days_newsin=<days>").  (See KSP-MAIL.DOC) 
  40.  
  41.            New  Feature: Added support in Mail-In for the EXPN (Expand
  42.            Mailing   List)  command  of  SMTP.   (See  description  of
  43.            "ksp-mail.mailing_list") 
  44.  
  45.            New  Feature:  Added  support  for an external program that
  46.            implements  the  ESMTP  command  "VRFY" to check whether or
  47.            not  a  username is local to the BBS.  Program is specified
  48.            using the new parameter, "ksp-mail.vrfy_program".  
  49.  
  50.            New   Feature:  Added  ksp-mail.sitename_alias  to  support
  51.            situations  where  the  hostname  used  in  the destination
  52.            address  of  mail  sent to your local site differs from the
  53.            actual hostname of the machine.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                           WHAT'S NEW IN KSP-MAIL
  63.  
  64.  
  65.            New  Feature:  Added  support  to limit the size of inbound
  66.            news  articles.   The  default  is no limit, but can be set
  67.            using the parameter "ksp-mail.max_article_bytes".  
  68.  
  69.            New  Feature:  Created  KSP-PACK.EXE to pack the POSTED.IDX
  70.            file; loaded and executed by KSP-Mail at midnight.  
  71.  
  72.            Enhancement:   Mail-In  now  builds  recipient  list  in  a
  73.            temporary  file  (RCPT-TO#.$,  where  "#"  is  the  session
  74.            number  1-4) rather than in memory, eliminating any concern
  75.            of running out of available heap space.  
  76.  
  77.            Enhancement:  Replaced  configuration parameter "sockdelay"
  78.            by  "ksp-mail.client_timeout"  with  default  value  of 300
  79.            seconds  (5  minutes)  per  RFC  1123.   Used by all client
  80.            processes;  twice  this  value  is  used  by Mail-Out while
  81.            waiting  for  acknowledge reply after transmitting the text
  82.            of an email message.  
  83.  
  84.            Enhancement:  Added  "Return-Path:"  line  to  top  of  RFC
  85.            header on inbound email messages.  
  86.  
  87.            Change:  If  a  client  logs  into  the Mail-In or (pushed)
  88.            News-In  as  the  remote  systems  manager, the server will
  89.            switch  to  management  mode  and  only management commands
  90.            will  be  recognized.   Because  of this, these commands no
  91.            longer  begin  with  a  period; e.g., ".HELP" is now simply
  92.            "HELP".  
  93.  
  94.      3.0:  New   Feature:   Remote  Systems  Management  is  now  also
  95.            accessible through the NNTP server when news is "pushed".  
  96.  
  97.            Clean-Up:  Added "Max-Article-Days" and "Max-Message-Bytes"
  98.            to  the  set  of parameters that can be modified via remote
  99.            system management.  
  100.  
  101.            Enhancement:       Changed       default      value      of
  102.            "ksp-mail.max_article_days" from 14 to 7.  
  103.  
  104.      2.9:  New  Feature: Added support in Mail-In for the SMTP command
  105.            "VRFY".   This  optional  command  was  not required by the
  106.            original   SMTP   spec   (RFC  821),  but  has  since  been
  107.            designated  mandatory  by  STD 3, RFC 1123.  Since KSP-Mail
  108.            does  not have access to the usernames valid on the BBS, it
  109.            must  always  give a positive response to the VRFY command,
  110.            whether   the   user  exists  or  not;  responsibility  for
  111.            rejection   of  the  inbound  message  due  to  an  invalid
  112.            username is left to the UUCP import utility.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                           WHAT'S NEW IN KSP-MAIL
  121.  
  122.  
  123.            Enhancement:   The   inbound   email   message  size  limit
  124.            introduced  in version 2.8 now works even with clients that
  125.            do   not   support   the   ESMTP  "SIZE"  parameter.   Such
  126.            (non-compliant)  clients  still transmit the entire content
  127.            of  their  message,  but  KSP-Mail  simply rejects it after
  128.            transmission,  and  without  using  disk  space  beyond the
  129.            limit  specified;  compliant  clients,  however, cancel the
  130.            transfer and save transmission time.  
  131.  
  132.            Enhancement:  Mail-Out  now uses the ESMTP "SIZE" parameter
  133.            if the remote host supports it.  
  134.  
  135.      2.8:  New  Feature:  Added support for the ESMTP "SIZE" parameter
  136.            to  limit  the  size  of inbound mail messages delivered by
  137.            ESMTP-compliant  clients.  The default is no limit, but can
  138.            be set using the parameter "ksp-mail.max_message_bytes".  
  139.  
  140.            Bug  Fix:  Discovered  that  the  Waterloo  TCP/IP  library
  141.            routine  that  reads a line of text from the network failed
  142.            when the input buffer contained an ASCII NUL.  Corrected.  
  143.  
  144.      2.7:  New  Feature:  Added  parameter "ksp-mail.max_article_days"
  145.            to  limit on how many days the ID of a news article is kept
  146.            in  the  POSTED.IDX  database  file  to  prevent  import of
  147.            duplicate articles.  Default is 14 days.  
  148.  
  149.            Bug  Fix: News-Out was not looking at the first line of the
  150.            RFC  header.   If that line was a "From:", "Newgroups:", or
  151.            "Message-ID:"  line,  then  it  would  be  missed,  and the
  152.            article  would  be  rejected  thinking  it  had  a  bad RFC
  153.            header.  
  154.  
  155.            Bug  Fix:  News-In  was aborting in the middle of a batched
  156.            outbound  news  file if the NNTP server rejected an article
  157.            in  the  batch  because  (a) it already has the article, or
  158.            (b)  because  the  newsgroup  is not carried by the server.
  159.            Corrected.  
  160.  
  161.            Bug  Fix:  If  outbound  news  is  batched  and one or more
  162.            articles  within  a  batch  file  had  a  bad  RFC  header,
  163.            News-Out   would   abort   the   remainder   of  the  file.
  164.            Corrected:  now  it  merely bypasses such articles making a
  165.            notation  in the logs, continues posting the good ones, and
  166.            then renames the .XQT file as a .BAD file.  
  167.  
  168.            Clean  Up:  Mail-In  now  writes  a  single line at the top
  169.            (before  the  RFC  header) of each mail message as required
  170.            by uucp.  The format of the line is: 
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                           WHAT'S NEW IN KSP-MAIL
  179.  
  180.  
  181.                "From <sender> <day> <month> <date> <time> <year>"
  182.  
  183.            This  line  can  be  disabled setting the new configuration
  184.            parameter "ksp-mail.uucp_from_line" to "disabled".  
  185.  
  186.            Clean  Up:  No  longer aborts News-Out session when attempt
  187.            to post article is rejected by remote NNTP server.  
  188.  
  189.            Clean       Up:      Reversed      the      default      on
  190.            "ksp-mail.retrieve_hostnames".     The   default   now   is
  191.            disabled; the parameter may be used to set it to enabled.  
  192.  
  193.            Enhancement:  The  pushed  version of News-In processed the
  194.            received  news  when  the newsfeed client issued the "QUIT"
  195.            command   to   close   the  session.   However,  some  Unix
  196.            newsfeeds  never  close  the  connection  in  an attempt to
  197.            improve  throughput.   This  leads  to timeouts which abort
  198.            the  connection; the newsfeed then reopens a new connection
  199.            when  more  news  is  available  to  be pushed.  The pushed
  200.            version  of  News-In  now  processes the received news when
  201.            the  connection  is terminated, whether it's due to a valid
  202.            QUIT command or a timeout.  
  203.  
  204.            Enhancement:  Added ksp-mail.newnews_timeout to specify how
  205.            many  seconds  KSP-Mail  will  wait  for  a response to the
  206.            NEWNEWS  command  when  asking for the list of new articles
  207.            posted  to a newsgroup.  This option was added because this
  208.            time  delay can be quite long compared to other time delays
  209.            when  asking  for  news  from  a  date  several days in the
  210.            past.  
  211.  
  212.            Enhancement:  KSP-Mail  kept  track  of  which articles had
  213.            already  been  imported  in  a file called POSTED.NWS; only
  214.            articles  posted  to  multiple  newsgroups and those from a
  215.            partial  newsgroup  retrieval were recorded in this file to
  216.            minimize   file  size.   As  articles  were  imported,  new
  217.            articles   were   skipped   if   already  imported.   Since
  218.            POSTED.NWS  was a "flat" file, searching was sequential and
  219.            seriously  degraded performance near the end of a news pull
  220.            when  there  were  more  than  a thousand newsgroups.  This
  221.            file  has  now  been  replaced by a B+ database file called
  222.            POSTED.IDX;  all  posted article IDs are recorded, and then
  223.            removed  at  the  end  of  a  newspull  if  older  than all
  224.            date/time entries in the newsgroups list.  
  225.  
  226.            Enhancement:  KSP-Mail  previously detected the presence of
  227.            DESQview  and  released  time slices to it accordingly, but
  228.            was   not   changing   the   way  it  painted  the  screen;
  229.            corrected.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                           WHAT'S NEW IN KSP-MAIL
  237.  
  238.  
  239.  
  240.      2.6:  Enhancement:  Renamed  file  "NEW-GRPS.LOG" to "GROUPS.NEW"
  241.            and   moved   it  to  the  same  directory  pointed  to  by
  242.            ksp-mail.newsgroupslist.  
  243.  
  244.            Enhancement:   Increased   the  size  of  files  (lists  of
  245.            newsgroups  or  article  ids)  that  can  be  sorted by (1)
  246.            swapping  KSP-Mail  out  of  memory  while sorting, and (2)
  247.            creating  KSP-SORT.EXE,  which  sorts larger files than the
  248.            MS/DOS SORT.EXE program.  
  249.  
  250.            Enhancement:  Added  reverse  domain  name  lookup (from IP
  251.            address)  to obtain a reliable identification of the remote
  252.            host(s).    Set  "ksp-mail.retrieve_hostnames=disabled"  to
  253.            disable it; default is enabled.  
  254.  
  255.            Enhancement:  KSP-Mail  is  now  "OS/2 aware".  I.e., it no
  256.            longer  uses  100%  of  the  cpu  time,  but  rather it now
  257.            releases the cpu to other processes when it's not busy.  
  258.  
  259.            New   Feature:  KSP-Mail  will  now  optionally  creates  a
  260.            zero-byte  file  on  a periodic basis as an indication that
  261.            everything  is  still ok.  This allows you to setup a batch
  262.            file  on  another machine that continuously checks the date
  263.            stamp  on  the file and issues an alarm if it has been more
  264.            than  a  certain  amount  of  time  since the file was last
  265.            created.  (See "ksp-mail.ok_filespec".) 
  266.  
  267.            New  Feature: Remote system management.  Now you can telnet
  268.            into  KSP-Mail  from  a remote location to modify or view a
  269.            large  number  of  operating parameters!  This replaces the
  270.            old  "HELP  STATUS" and "RSET STATUS" commands with a whole
  271.            new  set  of  "extended" commands, and accordingly, the old
  272.            "ksp-mail.status_password"   configuration   parameter  has
  273.            been   renamed   to  "ksp-mail.remote_management_password".
  274.            Since  the  extended  commands permit run-time modification
  275.            of  operating  parameters, they are disabled unless (1) the
  276.            password  has been specified, and (2) the remote client has
  277.            identified   itself   to   KSP-Mail  at  login  with  "HELO
  278.            <password>".   See  the  new  chapter  in  KSP-MAIL.DOC  on
  279.            remote system management for more information.  
  280.  
  281.            New  Feature:  News-In now is able to run as a receive-only
  282.            NNTP  server.  This allows KSP-Mail to receive inbound news
  283.            via  a  news  "feed"  rather  than  polling  a  remote NNTP
  284.            server.   Receiving  a  news  feed  is  known as the "push"
  285.            method,  and  significantly  reduces the load on the remote
  286.            machine  compared  to  "pulling"  news.   If  configuration
  287.            parameter  "ksp-mail.newsgroups"  is  defined, then News-In
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                           WHAT'S NEW IN KSP-MAIL
  295.  
  296.  
  297.            runs  as  a  client  and pulls news; otherwise it runs as a
  298.            server  and  waits  for  a  news  feed client to push.  See
  299.            KSP-MAIL.DOC for further information.  
  300.  
  301.            Enhancement:   The   "ksp-mail.news_hour"   parameter   now
  302.            supports  a  list of hours, separated by commas; a range of
  303.            hours may also be specified by using a dash.  For example, 
  304.  
  305.                        ksp-mail.news_hour=2,4,6,7-12,20-22
  306.  
  307.            New  Feature:  Retrieval  of  hundreds  of newgroups is not
  308.            uncommon,  and  can  take several hours to complete.  Since
  309.            no  external UUCP import/export programs are allowed to run
  310.            until  all  TCP/IP processes (e.g., News-In) are idle, this
  311.            situation  can  seriously  delay  import/export of mail and
  312.            news.   In  this version, if the ",sort" option is appended
  313.            to  the  end  of  the parameter "ksp-mail.newsgroups", then
  314.            News-In  will  be  suspended  at  the  end  of  the current
  315.            newsgroup   if   an  external  program  is  waiting  to  be
  316.            executed.   Note  that if "ksp-mail.news_import_trigger" is
  317.            set  to "on_arrival", then this allows external programs to
  318.            be executed between each pair of newsgroups.  
  319.  
  320.            Enhancement:   Created   less-confusing   aliases  for  the
  321.            following configuration parameters: 
  322.  
  323.            Original Parameter Name         Alternative Parameter Name
  324.            ----------------------------    --------------------------
  325.            ksp-mail.bbsmail2uucp_command   ksp-mail.export_mail_command
  326.            ksp-mail.bbsmail2uucp_seconds   ksp-mail.export_mail_seconds
  327.            ksp-mail.bbsmail2uucp_trigger   ksp-mail.export_mail_trigger
  328.            ksp-mail.bbsnews2uucp_command   ksp-mail.export_news_command
  329.            ksp-mail.bbsnews2uucp_seconds   ksp-mail.export_news_seconds
  330.            ksp-mail.uucp2bbsmail_command   ksp-mail.import_mail_command
  331.            ksp-mail.uucp2bbsmail_seconds   ksp-mail.import_mail_seconds
  332.            ksp-mail.uucp2bbsmail_trigger   ksp-mail.import_mail_trigger
  333.            ksp-mail.uucp2bbsnews_command   ksp-mail.import_news_command
  334.            ksp-mail.uucp2bbsnews_trigger   ksp-mail.import_news_trigger
  335.  
  336.            Enhancement:  Created  additional  configuration  parameter
  337.            aliases   as   follows,  with  a  new  ability  to  specify
  338.            different NNTP servers for News-In and News-Out: 
  339.  
  340.            Original Parameter Name         Alternative Parameter Name
  341.            ----------------------------    --------------------------
  342.            ksp-mail.nntp_server            ksp-mail.news_server, or
  343.                                            ksp-mail.news_in_server, or
  344.                                            ksp-mail.news_out_server
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                           WHAT'S NEW IN KSP-MAIL
  353.  
  354.  
  355.            ksp-mail.smtp_server            ksp-mail.mail_server, or
  356.                                            ksp-mail.mail_out_server
  357.  
  358.            Enhancement:  Added six additional configuration parameters
  359.            that  enable/disable  individual  processes  and report any
  360.            missing   parameters  required  by  those  processes.   See
  361.            KSP-MAIL.DOC for more information.  
  362.  
  363.                    ksp-mail.import_news_process
  364.                    ksp-mail.import_news_process
  365.                    ksp-mail.import_mail_process
  366.                    ksp-mail.export_news_process
  367.                    ksp-mail.export_mail_process
  368.                    ksp-mail.command_shell_process
  369.                    ksp-mail.set_clock_process
  370.  
  371.            Enhancement:  If an SMTP or NNTP server rejects an outbound
  372.            message,  the  original  message preceded by an appropriate
  373.            explanation is returned to the sender.  
  374.  
  375.            New  Feature:  Added  "ksp-mail.smtp_greeting" to allow you
  376.            to  add  your  own  text  to  the  login  greeting  message
  377.            presented  by Mail-In to the remote client.  This parameter
  378.            may be repeated for multi-line messages.  
  379.  
  380.            New  Feature:  Added  a  new configuration parameter called
  381.            "ksp-mail.exit_spec=<filespec>[,<seconds>]".     If   used,
  382.            KSP-Mail  will  periodically  check  for  a  file  matching
  383.            <filespec>.   If  found, KSP-Mail deletes the file and then
  384.            exits  as  soon as it reaches a stable state, with an error
  385.            code  given by the three-character filename extension.  The
  386.            <filespec>  string  may  contain  wildcards.  The <seconds>
  387.            parameter  is  optional  and  specifies  how frequently the
  388.            check  is  made;  default  is  once  every 10 seconds.  For
  389.            example,  with "ksp-mail.exit_spec=c:\ksp\ksp-exit.*,5" the
  390.            file  c:\ksp\ksp-exit.015  will cause KSP-Mail to exit with
  391.            an error code of 15.  
  392.  
  393.            New  Feature: Some NNTP servers require the client to login
  394.            with  a username and password.  Since such commands are not
  395.            part  of  the  NNTP  standard,  they  have  been  added  to
  396.            KSP-Mail  as  strings  separated  by commas and appended to
  397.            the  end of the "ksp-mail.nntp_server" configuration entry,
  398.            as in: 
  399.  
  400.             ksp-mail.nntp_server=129.210.212.20,<string>,<string>,...
  401.  
  402.            where, for example, "<string>" might be: 
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                           WHAT'S NEW IN KSP-MAIL
  411.  
  412.  
  413.                    authinfo user ksp
  414.            or:     authinfo pass babyface
  415.  
  416.            If  blanks appear within one or more of the commands (as in
  417.            these  examples),  then  everything after the "=" sign must
  418.            be surrounded by a pair of quotation marks.  
  419.  
  420.            This  feature can be used in the specification of SMTP (but
  421.            not TIME) servers as well.  
  422.  
  423.            Bug  Fix:  Mail-Out  wasn't handling outbound mailing lists
  424.            properly.   It  used  the  "To:" field in the RFC header of
  425.            the  message  instead  of  the  recipient  list in the .XQT
  426.            file.  Corrected.  
  427.  
  428.            Bug  Fix:  UUCP  sometimes  puts  a  "From  ..." line in an
  429.            outbound  mail  message  or  news article at the top before
  430.            the  RFC  header.  This line is not a legal RFC header line
  431.            and was not being removed.  Corrected.  
  432.  
  433.            Bug  Fix:  Outbound  mail  or  news  with either a "To:" or
  434.            "From:" line of the format: 
  435.  
  436.                    John Smith (King of the Road) <jsmith@nowhere.com> 
  437.  
  438.            would    cause    the    address   parser   that   extracts
  439.            "jsmith@nowhere.com" to fail.  Corrected.  
  440.  
  441.            Bug  Fix:  Use  of domain names instead of IP addresses for
  442.            SMTP,  NNTP,  or TIME servers corrupted memory which caused
  443.            failures later while importing newsgroups.  Corrected.  
  444.  
  445.      2.5:  New   Feature:  If  a  timeout  occurs  in  the  middle  of
  446.            retrieving  articles  from  some newsgroup, a list of those
  447.            that  have  already  been  retrieved  will be recorded in a
  448.            file so that they will not be retrieved again.  
  449.  
  450.            New   Feature:  If  you  add  ",sort"  after  the  filename
  451.            specified  by  ksp-mail.newsgroups, then KSP-Mail will sort
  452.            the  file  before  retrieval so that it attempts to get the
  453.            oldest news first.  
  454.  
  455.            New  Feature:  Added  a  new configuration parameter called
  456.            "ksp-mail.close_timeout"  to  limit the amount of time used
  457.            to   close   a   connection  independent  of  other  limits
  458.            specified  by "sockdelay" and "server_timeout".  Default is
  459.            10 seconds.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                           WHAT'S NEW IN KSP-MAIL
  469.  
  470.  
  471.            Bug  Fix: If no *.XQT files were in the spool directory, it
  472.            would  sometimes  die  with an error message saying "out of
  473.            file handles".  Corrected.  
  474.  
  475.      2.4:  Enhancement:   You   no   longer  have  to  change  the  TZ
  476.            environment  variable  string  when  Daylight  Savings Time
  477.            (DST)  begins  or  ends.   If  the  TZ  environment  string
  478.            includes  a  DST  suffix  (e.g.,  "SET  TZ=PST8PDT"),  then
  479.            KSP-Mail  will  now  automatically  set the clock ahead one
  480.            hour  at 2am on the first Sunday in April and back one hour
  481.            at  2am  on  the  last Sunday in October.  If TZ does *NOT*
  482.            include  a DST suffix (e.g., "SET TZ=PST8"), then the clock
  483.            will not be changed.  
  484.  
  485.            Enhancement:  Added  a  new  configuration parameter called
  486.            "ksp-mail.outbound_retry_seconds".   If posting an outbound
  487.            mail  message  or news article fails due to a timeout while
  488.            waiting  for  the  remote  server  to  reply,  KSP-Mail now
  489.            delays   for   the   amount   of  time  specified  by  this
  490.            parameter.  
  491.  
  492.            Enhancement:  News-Out  tries  to post an article using the
  493.            "POST"  NNTP  command; if that is refused, it now tries the
  494.            "IHAVE" command.  
  495.  
  496.            Enhancement:   If  Mail-Out  or  News-Out  encountered  any
  497.            problem  while  trying  to  post  a message or article, the
  498.            corresponding  .XQT  file  was renamed to .BAD, even if the
  499.            problem  was  not due to errors in the file itself.  (E.g.,
  500.            a  server  timeout  would  also  result  in  the file being
  501.            renamed.)   Now, Mail-Out and News-Out only rename the file
  502.            if  there  is  actually  something wrong with its contents;
  503.            this allows the file to be resent at a later time.  
  504.  
  505.            Clean  Up:  News-In:  Eliminated the "skipping cross-posted
  506.            article.."  message-In,  and  the cross-posted article from
  507.            the  total  number  of  articles  to  be retrieved for that
  508.            newsgroup.   Improved  the  algorithm that detects feedback
  509.            articles;  rather  than importing and then discarding, they
  510.            are no longer imported.  
  511.  
  512.            Bug  Fix:  Running  external commands would sometimes cause
  513.            KSP-Mail to crash if swapping was allowed.  Corrected.  
  514.  
  515.      2.3:  Bug  Fix:  While  cleaning  up  the code for version 2.2, I
  516.            accidentally  reversed  the sense of a test which broke the
  517.            new  code  that  gets  a  list  of  new newsgroups (not new
  518.            articles) from the NNTP server.  Corrected.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                           WHAT'S NEW IN KSP-MAIL
  527.  
  528.  
  529.      2.2:  Enhancement:  News-In  article  list  no  longer  sorted if
  530.            there's only one article in the list. <g> 
  531.  
  532.            Bug  Fix: If the response to the NEWNEWS command of News-In
  533.            was  a  list  of  articles  containing only a single entry,
  534.            that article was not retrieved; corrected.  
  535.  
  536.      2.1:  Bug  Fix: At the end of a news retrieval, the date and time
  537.            computed    for   the   next   retrieval   was   incorrect.
  538.            Corrected.  
  539.  
  540.      2.0:  MAJOR  NEW  RELEASE:  This is the successor to version 1.8,
  541.            and  has  been  numbered  2.0  rather  than  1.9 because it
  542.            incorporates  a  large  number of significant improvements,
  543.            new features, and bug fixes.  
  544.  
  545.            Configuration  Change: Previous versions kept a single time
  546.            and  date  record  of  the  last  news  retrieval in a file
  547.            called  NEWS-IN.LST;  there  was  only  one  date  and time
  548.            recorded  for  all  newgroups.  Retrieving articles for any
  549.            one  group can take several minutes, so it became necessary
  550.            to  record  the  time  and  date on a group-by-group basis.
  551.            This  version  eliminates  the NEW-IN.LST file and replaces
  552.            the "ksp-mail.newsgroup" configuration parameter by: 
  553.  
  554.                    ksp-mail.newsgroups=<filespec> 
  555.  
  556.            as in: 
  557.  
  558.                    ksp-mail.newsgroups=c:\ksp\groups.lst 
  559.  
  560.            Note  the  added  's'  at  the  end  of  "newsgroups".   As
  561.            indicated,  this new parameter requires a filespec (without
  562.            a  leading  '@').  The file contains one line per newsgroup
  563.            (no  wildcards); each entry consists of a GMT date and time
  564.            followed  by  the  newgroup  name, with fields separated by
  565.            exactly one space: 
  566.  
  567.                    YYMMDD HHMMSS newgroup_name 
  568.  
  569.            as in: 
  570.  
  571.                    951001 120012 alt.bbs.internet 
  572.  
  573.            Note:  If you want to sort this new newsgroup list by name,
  574.            use the following DOS command: 
  575.  
  576.                    SORT /+14 < infile > outfile 
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.                           WHAT'S NEW IN KSP-MAIL
  585.  
  586.  
  587.            where  "infile"  is the name of the unsorted newsgroup list
  588.            and "outfile" is the name of the sorted list.  
  589.  
  590.            Note:  If  you create an entry where the newsgroup name has
  591.            been  replaced  by  the  IP address of your NNTP server, as
  592.            in: 
  593.  
  594.                    951001 120012 137.168.1.1 
  595.  
  596.            then  KSP-Mail will record new newsgroups whenever they are
  597.            created  on the server!  The list of new newsgroups will be
  598.            added  to the end of a log file called NEW-GRPS.LOG in your
  599.            log  directory.   If  you  have multiple NNTP servers, just
  600.            create  one  line for each server with the corresponding IP
  601.            addresses.  
  602.  
  603.            New  Feature: A Set-Clock thread has been added.  It uses a
  604.            time  server  on  the  Internet to set the time and date of
  605.            the  KSP-Mail  machine.  To use it, you must specify one or
  606.            more  time  servers  using  "ksp-mail.time_server"; you may
  607.            also  want  to  set  how  often  the  clock  is  set  using
  608.            "ksp-mail.set_clock_hours"  (the  default  is once every 24
  609.            hours).  
  610.  
  611.            New  Feature: You may now include more than one NNTP server
  612.            in  your  WATTCP.CFG  file. If the first NNTP server is not
  613.            available,  KSP-Mail will try the second, and so on.  Also,
  614.            if  one  or more of the specified newsgroups is not carried
  615.            by  a server, KSP-Mail will attempt to retrieve the missing
  616.            newsgroups from the remaining servers in the list.  
  617.  
  618.            New  Feature:  The  SMTP  server implemented by the Mail-In
  619.            processes  now  supports  an  extension  of SMTP's standard
  620.            "HELP"  and  "RSET"  commands  that can be used to remotely
  621.            retrieve  information  about the current status of KSP-Mail
  622.            via  telnet;  see chapter five of KSP-MAIL.DOC for details.
  623.            Access  to these commands can be password protected using a
  624.            new          configuration         parameter         called
  625.            "ksp-mail.status_password".  
  626.  
  627.            New  Feature:  UUCP  export utilities usually use temporary
  628.            names  while creating the spool files and then rename those
  629.            files  after  they  have been completely written.  However,
  630.            occassionally  this  design  practice  is not followed, and
  631.            can  cause  a  "file sharing violation" when other software
  632.            (such  as  KSP-Mail)  is  trying to read these files.  As a
  633.            workaround,    a   new   configuration   parameter   called
  634.            "ksp-mail.share_delay_seconds"  has  been  added  to  cause
  635.            KSP-Mail  to  delay  before  actually trying to process the
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                           WHAT'S NEW IN KSP-MAIL
  643.  
  644.  
  645.            file.   If set properly, this should allow the UUCP utility
  646.            time  to  finish  writing  to  the  file, thus avoiding the
  647.            access conflict.  
  648.  
  649.            Enhancement:  Pressing  Esc  once  now  exits  only  if all
  650.            processes   are   idle.   Pressing  it  twice  exits  after
  651.            gracefully  completing  any transfer in progress.  Pressing
  652.            it three times aborts and exits immediately.  
  653.  
  654.            Enhancement:  Additional information related to News-In and
  655.            News-Out  is  now displayed on the Summary Screen.  (1) the
  656.            current  NNTP  server's  IP  address,  (2)  the current and
  657.            total   number  of  newsgroups  being  retrieved,  (3)  the
  658.            current  and total number of articles in the current group,
  659.            and  (4)  the  time  and date of the previous retrieval for
  660.            the current group.  
  661.  
  662.            Enhancement:  News-In  now  sorts  the list of article id's
  663.            returned  by  the  "NEWNEWS"  command before retrieving the
  664.            articles.   This  helps  keep  multi-part  postings  (e.g.,
  665.            part1  of  3,  part  2  of  3,  etc.)  in the proper order.
  666.            (Note:  KSP-Mail loads and executes the DOS "SORT" command,
  667.            which must be in the current path.) 
  668.  
  669.            Enhancement:  News-In  now  retrieves  articles  using  the
  670.            faster  "ARTICLE" command rather than the slower "HEAD" and
  671.            "BODY" commands.  
  672.  
  673.            Enhancement:  News-In  now uses the "SLAVE" command to tell
  674.            the  NNTP  server  that KSP-Mail provides news to more than
  675.            one  person; this command is ignored by most servers, but a
  676.            few may give you higher priority.  
  677.  
  678.            Clean  Up:  Version  1.8  added a new feature to facilitate
  679.            mail   forwarding:   the  full  email  destination  address
  680.            (including  the  domain  name)  was written to the UUCP *.X
  681.            file  when  the  domain name was different from that of the
  682.            KSP-Mail  machine.   Some UUCP utilities can't forward mail
  683.            and  thus  accept  nothing  more  than  a user name.  A new
  684.            configuration  parameter  (ksp-mail.forwarding=enabled) has
  685.            been  added  to  solve  this problem; if not used, only the
  686.            user  name will be written to the *.X file.  THIS PARAMETER
  687.            MUST  BE  ENABLED  IF YOU WANT MAIL FOR ANOTHER DOMAIN NAME
  688.            TO BE FORWARDED.  
  689.  
  690.            Bug  Fix:  Mail-In  was  not  properly  handling  a  single
  691.            inbound  mail  message  posted  to  multiple recipients; it
  692.            only  delivered  a copy to the recipient specified with the
  693.            last  (of  multiple)  "RCPT  TO" command sent by the remote
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.                           WHAT'S NEW IN KSP-MAIL
  701.  
  702.  
  703.            SMTP client.  Corrected.  
  704.  
  705.            Bug  Fix:  The  "NEWNEWS"  command  issued  by  the News-In
  706.            process  to  the  remote  NNTP  server  did not specify the
  707.            "GMT" option (Greenich Mean Time); corrected.  
  708.  
  709.            Bug  Fix:  When articles were cross-posted to more than one
  710.            newsgroup,  duplicate  entries  would be posted by the uucp
  711.            utilities to the BBS message base.  Corrected.  
  712.  
  713.      1.8:  New  Feature:  KSP-Mail  now handles outbound news that has
  714.            been  batched by the UUCP software.  Such files contain one
  715.            or  more  news articles, each preceded within the same file
  716.            by  a line like "#! rnews <number>".  Most NNTP servers can
  717.            handle this anyway, but some do not.  
  718.  
  719.            New  Feature:  Some  UUCP  software  (like GIGO) can handle
  720.            .XQT    files    that    contain   a   line   like   "rmail
  721.            dan.lewis@ksp.com";  such  software  uses  the  domain name
  722.            information  to  implement  mail forwarding.  Less powerful
  723.            UUCP  software  (e.g.,  UUIN) tolerates nothing more than a
  724.            user  name,  such  as  "rmail dan.lewis", assuming that all
  725.            incoming  mail is for the local machine.  KSP-Mail has been
  726.            modified  so  that  now  if  the  domain  name  part of the
  727.            destination  address  of  an inbound e-mail message matches
  728.            that  of  the  KSP-Mail  machine (as configured in WATTCP),
  729.            then  the  domain  name  information  is removed as before;
  730.            otherwise  it  is  passed to the UUCP software on the rmail
  731.            command line in the .XQT file.  
  732.  
  733.            Bug  Fix:  External commands that required loading a second
  734.            copy  of  COMMAND.COM, such as .BAT files, or commands with
  735.            command    line   redirection   or   piping   would   fail.
  736.            Corrected.  
  737.  
  738.            Bug  Fix:  Discovered  a bug in the Waterloo TCP/IP library
  739.            function  that reads a line of text from the network.  This
  740.            caused   KSP-Mail  to  freeze  if  a  client  SMTP  process
  741.            submitted  an  e-mail message containing a line longer than
  742.            1024 characters.  Corrected.  
  743.  
  744.            Bug  Fix:  If  the  Mail-In  process  was disabled (no mail
  745.            directory  specified),  none  of  the  other processes were
  746.            able  to borrow one of the four network resources needed to
  747.            function.  Corrected.  
  748.  
  749.            Clean  Up:  The  Mail-In  process'  response  to  a  "HELP"
  750.            command    issued   by   the   remote   SMTP   client   was
  751.            double-spaced; corrected.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                           WHAT'S NEW IN KSP-MAIL
  759.  
  760.  
  761.  
  762.            Clean  Up:  Initiated  process  activity woke up the screen
  763.            saver,   but  sometimes  the  moving  screen  saver  string
  764.            "KSP-Mail"  would be written on top of the restored summary
  765.            screen; corrected.  
  766.  
  767.      1.7:  Bug  Fix:  If  the  "From:"  line  of  the RFC header on an
  768.            outbound  mail  message or news article appeared before the
  769.            "To:"  line  (as opposed to the other way around), KSP-Mail
  770.            would  issue  the  error  message,  "Bad RFC header in file
  771.            ...".  Corrected.  
  772.  
  773.      1.6:  Bug  Fix:  When swapping to EMS, the code that releases the
  774.            allocated  EMS  memory  (after  KSP-Mail's  memory image is
  775.            restored)  was  not  working.   This  caused  EMS memory to
  776.            eventually be depleted.  Corrected.  
  777.  
  778.            Enhancement:  If  an  error  occured  during  processing of
  779.            outbound  mail  or news, the corresponding uucp spool files
  780.            for  that  message  would  be  left in the spool directory,
  781.            causing  KSP-Mail  to  try  over  and  over again to export
  782.            them.    This   has   been   corrected   by   renaming  the
  783.            corresponding .XQT file with the extension .BAD.  
  784.  
  785.            Clean  Up:  Forgot  to  document  the  need  to set your TZ
  786.            (timezone)  environment  variable.   The  time standard for
  787.            both   SMTP  and  NNTP  is  Greenwich  Mean  Time;  the  TZ
  788.            environment  variable  tells  KSP-Mail  how to convert your
  789.            local   time  to  GMT  time.   If  you  don't  create  this
  790.            environment  variable,  KSP-Mail  will  think  (by default)
  791.            that  you  are on Pacific Standard Time (PST)!  See details
  792.            in section 1.6 of KSP-MAIL.DOC.  
  793.  
  794.            New  Feature:  Added  support  for  an environment variable
  795.            (ksp-ip)  to  set  the IP address.  Since the IP address is
  796.            often  the  only  parameter in WATTCP.CFG that changes from
  797.            one  BBS  node  to another, this allows using a single copy
  798.            of that file for all nodes.  
  799.  
  800.            Clarification:  Some  Internet  access  providers configure
  801.            their  dial-up  slip  and  ppp  accounts  with a very small
  802.            segment  size.   You  may  need to set mss as low as 212 if
  803.            your Internet connection is through such a connection.  
  804.  
  805.      1.5:  Bug  Fix:  If  an  error  occured when trying to execute an
  806.            external  command,  the command line displayed in the error
  807.            message  did not show anything after the first command line
  808.            parameter,   even   though   all   parameters   were  used;
  809.            corrected.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.                           WHAT'S NEW IN KSP-MAIL
  817.  
  818.  
  819.  
  820.            Bug  Fix:  The  search  algorithm  for locating an external
  821.            command  would  fail if a complete pathspec for the command
  822.            was provided; corrected.  
  823.  
  824.            Clean  Up:  The  documentation and the sample configuration
  825.            file  used  an example command line for PCBoard's UUIN that
  826.            looked  like  "UUIN  -c  5".   UUIN  does  not support this
  827.            command  line  parameter;  it  should have been shown using
  828.            the  "-s"  parameter,  as  in  "UUIN  -S  SMTP" or "UUIN -S
  829.            NNTP".  Corrected.  
  830.  
  831.            Clean  Up:  If  external  commands  were  specified  in the
  832.            configuration   file,   they  would  trigger  even  if  the
  833.            corresponding    process   (Mail-In,   Mail-Out,   News-In,
  834.            News-Out) was disabled.  Corrected.  
  835.  
  836.      1.4:  New   Feature:  Added  a  new  configuration  parameter  to
  837.            disable  certain  options when swapping out memory in order
  838.            to    run    an    external    command.     The   parameter
  839.            "ksp-mail.dont_swap_to"  can  be  set  to  "xms", "ems", or
  840.            "disk".   One  or more swapping options may be disabled; if
  841.            all  are  disabled then KSP-Mail's memory image will not be
  842.            swapped out.  
  843.  
  844.            Oops!   When  I  fixed  the  search  algorithm  in  1.3,  I
  845.            accidentally  broke  the "include" directive in WATTCP.CFG.
  846.            Corrected.  
  847.  
  848.            Bug  Fix:  Had  a problem parsing a command line to execute
  849.            when   it   did  not  contain  any  command  line  options;
  850.            corrected.  
  851.  
  852.      1.3:  Enhancement:  KSP-Mail  now  looks  in three directories to
  853.            locate   the  WATTCP.CFG  configuration  file.   First,  it
  854.            checks  for  an environment variable called WATTCP.CFG that
  855.            specifies  the  directory.  Second, it looks in the current
  856.            (default)  directory.   Third, if still not found, it looks
  857.            in    the    directory   that   contains   the   executable
  858.            (KSP-MAIL.EXE).  
  859.  
  860.            Enhancement:   Added  a  screen  saver  and  an  associated
  861.            configuration  parameter (ksp-mail.screen_saver_seconds) to
  862.            control its timing.   
  863.  
  864.      1.2:  Some  UUCP  import/export  utility  programs (notably Clark
  865.            Development's  UUOUT)  apparently require LOTS of memory to
  866.            run.   Since  KSP-Mail uses about 230K itself, that made it
  867.            impossible  to  load  and  execute  some of these programs.
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.                           WHAT'S NEW IN KSP-MAIL
  875.  
  876.  
  877.            KSP-Mail  now  copies  its  memory image to XMS memory, EMS
  878.            memory,  or  a file (in that order of preference), and then
  879.            shrinks  down  to a tiny "stub" of around 2kb before trying
  880.            to  load  and  execute  a  program.  When the child program
  881.            terminates, KSP-Mail reloads its image and continues.  
  882.  
  883.      1.1:  The  documentation  forgot  to  mention an important detail
  884.            about  the  following  four  configuration  parameters that
  885.            specify MS/DOS command lines! 
  886.  
  887.                    ksp-mail.uucp2bbsmail_command
  888.                    ksp-mail.bbsmail2uucp_command
  889.                    ksp-mail.bbsnews2uucp_command
  890.                    ksp-mail.uucp2bbsnews_command
  891.  
  892.            If  the  command  line  text  includes any spaces, then the
  893.            entire  text  of  the  command  line  must be surrounded by
  894.            quotation marks, as in: 
  895.  
  896.                    ksp-mail.bbsmail2uucp_command="UUOUT -C 5" 
  897.  
  898.      1.0:  Initial release.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.