home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / rn38d.zip / readme.2nd < prev    next >
Text File  |  1993-06-11  |  8KB  |  209 lines
  1. Readme.2nd for RN 3.8 bugfixed version d                       1993/06/11
  2. =========================================================================
  3.  
  4. 1. How to contact me
  5. ---------------------
  6.  
  7. - during normal (sic!) working hours (mine, not yours!) from 7am to 7pm
  8.   GMT+0200
  9. - outside working hours try:
  10.   o  "ping eagle.rz-fh-ulm.de" to see if my machine is running; if you
  11.      get a response, I'm here. This might change in the near future
  12.      since I'm going to install SLIP on my machines at home and at work.
  13.   o  "finger va-klaus@charon2.rz.fh-ulm.de" (will show all users logged
  14.      to server VA-KLAUS)
  15.      or
  16.      "finger @charon2.rz.fh-ulm.de" (will show all users logged to all
  17.      our servers)
  18.      to see if I'm logged to my Novell network; lookout for user MSTAEDT;
  19.      (VA-KLAUS is one of our Novell servers, not a user ;-), CHARON2 is
  20.      our SMTP gateway)
  21.   o  "finger mittelst@felix.rz.fh-ulm.de" to see my .plan file if none
  22.      of the above methods works; this is my UNIX account, I'll try
  23.      to keep the .plan file up to date
  24. - mail gets replied immediately if it reaches me during working
  25.   hours, the next work day otherwise
  26.  
  27. 2. Changes & News
  28. ------------------
  29.  
  30. since version 3.8c:
  31.  
  32. - merely cosmetic: removed all diagnostic messages
  33. - file DDE4.MSG is not longer necessary; runtime error messages are 
  34.   directly bound to RN.EXE now
  35. - padded all headers/footers to 80 chars; looks rather nice
  36.  
  37. since version 3.8b:
  38.  
  39. - made ESC work like F3
  40. - made colors configurable
  41. - reply by mail goes to article's author only if you leave "To:" address
  42.   empty
  43. - SMTP header complies with minimal RFC82[12] header and has To:, From:,
  44.   Subject: and Date: fields
  45. - increased stack size for 16-Bit functions from default 4 KByte to
  46.   16 KByte
  47.  
  48. since version 3.8a:
  49.  
  50. - ported RN from TopSpeed-C for OS/2 1.3 to IBM's CSet/2 2.0
  51.  
  52. - quote char configurable through RNQUOTE=<charcode>, default is '>',
  53.   charcode has to be in the range between 32 and 127
  54.  
  55. - when replying by mail the article now is quoted with RNQUOTE; SMTP
  56.   header is quite not complete for sendmail, it has at least the 
  57.   To:, From: and Subject: fields
  58.  
  59. - distribution can be set by environment variable
  60.  
  61. - HPFS filename for signature file allowed
  62.  
  63. - stretched the limits:
  64.   o  up to 4000 subscriptions (our newsserver has about 3050
  65.      newsgroups!)
  66.   o  increased buffer size for reading from sockets to 128 KBytes
  67.      ("article too long" message should now be gone forever!)
  68.   o  changed buffer logic to use an 8 KByte temporary buffer, which is
  69.      copied to the read buffer; did this to handle a misbehaviour which
  70.      showed up when I increased buffer size beyond 64 KBytes; slows down
  71.      reading from socket a bit
  72.  
  73. 3. Bugs & Fixes
  74. ----------------
  75.  
  76. since version 3.8c:
  77.  
  78. BUG: RN crashes if RNSIGNATURE variable not set
  79. BUG: RN crashes when scrolling through article list of certain newsgroups
  80. FIX: format buffer for screen header line was too short; long group names
  81.      like alt.binaries.pictures.supermodels made buffer expand beyond its
  82.      end, thus overwriting the following variables with arbitrary values;
  83.      increased buffer size; changed sprintf() format specification to 
  84.      truncate group name if necessary; thanks to:
  85.      
  86.      Stefan Zollner, Bill (at tamvm1.tamu.edu) and Jon Gough for their
  87.      exact bug reports and their patience with testing countless debug
  88.      versions of RN
  89.  
  90. since version 3.8b:
  91.  
  92. BUG: RN crashes if RNSIGNATURE variable is not set
  93. FIX: not yet ...
  94.  
  95. BUG: RN seems to hang if a DOS application is running which consumes
  96.      lots of processor time; starting such an application while RN is
  97.      already running makes RN stop reading more article headers
  98. FIX: looked through Toolkit sample code; changed priority class in the
  99.      DosSetPriority() call from "Idle" to "Time-critical"
  100.  
  101. since version 3.8a:
  102.  
  103. BUG: plain internet address did not work
  104. FIX: my bug; simply forgot to #include <netlib.h>, so inet_addr() had
  105.      no cdecl prototype and the compiler assumed pascal calling convention
  106.  
  107. BUG: new groups and groups selections hanged because keystrokes were 
  108.      never removed from the keyboard buffer
  109. FIX: forgot to change two other calls of KbdCharIn with wrong arguments
  110.  
  111. BUG: RN died when reading all newsgroups from server; EOf not found when
  112.      reading groups from NEWS.ALL
  113. FIX: EOF handling corrected
  114.  
  115. BUG: article headers containing the mark char '*' couldn't be marked
  116. FIX: replaced mark char with 0xFE
  117.  
  118. BUG: marks on groups in group subscription weren't cleared and did show 
  119.      in group and article selection
  120. FIX: clear marks after processing newly subscribed groups
  121.  
  122. BUG: newly subscribed groups were shown as "being loaded" in the group
  123.      selection, although the headers were already loaded directly after
  124.      subscription
  125. FIX: corrected semaphore handling
  126.  
  127. 4. History
  128. ----------
  129.  
  130. After installing TCP 1.2.1 I was very pleased to find a newsreader for
  131. OS/2, and disappointed some minutes later because it didn't run. I tried
  132. everything, changed my installation, applied the latest CSD's,
  133. recompiled with EMX/GCC and CSET/2. No luck.
  134.  
  135. Last week I got an old Version of TopSpeed-C for OS/2 1.3 and I
  136. remebered RN. It compiled and linked fine (although it gave me about 300
  137. warnings), but when running it behaved exactly like the original
  138. version.
  139.  
  140. After countless debugging sessions with a lot of help from T.Gloeckler
  141. (our experienced TopSpeed wizard!) I discovered lot of bugs, which
  142. result from one of the worst C sources I've ever seen.
  143.  
  144. 5. Enhancements
  145. ---------------
  146.  
  147. After fixing all bugs found so far I've made several extensions:
  148.  
  149. a. added X-Newsreader line to postings and replies
  150. b. added simple signature file facility
  151. c. optional setting of 'Organization:' by environment variable
  152. d. editor configurable by environment variable
  153.  
  154. 6. Sources
  155. ----------
  156.  
  157. Sources for RN have undergone heavy changes, nevertheless they are
  158. proprietary of IBM and I don't know if I can give them away.
  159.  
  160. To be honest: I don't have the TCP/IP Programming Toolkit, I merely made
  161. use of the PROGCSD available on hobbes ;-) !
  162.  
  163. 7. Thanks
  164. ---------
  165.  
  166. - to Thomas Gloeckler for his unvaluable help with the TopSpeed-
  167.   Debugger
  168. - to Chris@csbh.com for his thorough testing of the multithread bugfix
  169. - to all people on the net who tried RN and sent bug reports and 
  170.   suggestions
  171.  
  172. 8. Notes & Odds
  173. ---------------
  174.  
  175. - somebody suggested making RN shareware. Don't worry about owing
  176.   me money for it, this version of RN is free and will remain free.
  177.   Sharing a (mostly) usable program with others having the same needs is
  178.   my only intention.
  179.  
  180. - the executables size did grow from about 60 KBytes to about 130 KBytes
  181.   when porting to CSet/2 (without debgging info); don't know why ...
  182.  
  183. - I'm a bit uncertain about version numbering, because RN says "RN version
  184.   3.28" in his banner, my versions are called 3.8[ab...]; according to
  185.   RCS conventions, version 3.8 is the 20th version BELOW version 3.28!
  186.   What should I do now?
  187.  
  188. 9. Future
  189. ----------
  190.  
  191. - I'm thinking about restructuring the souces and introducing
  192.   RCS version control, which I use for all my other projects;
  193.   unfortunately, RCS for OS/2 doesn't work on NetWare drives.
  194.  
  195.   And my harddisk is nearly full ...
  196.  
  197.  
  198.  
  199. Enjoy and kind regards,
  200.  
  201. Olaf
  202.  
  203. --
  204.  
  205. Olaf Mittelstaedt                 | Local Mail: mstaedt@va-klaus
  206. Fachhochschule Ulm                | Internet  : mittelst@fh-ulm.de
  207. Prittwitzstrasse 10               | Phone     : ++49 731 502 8220
  208. D-7900 Ulm/Donau                  | Fax       : ++49 731 502 8270
  209.