home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / msq310.zip / READ.ME < prev    next >
Text File  |  1995-06-24  |  7KB  |  185 lines
  1.                MSGED/SQ 3.10   released 1995-06-24
  2.             
  3.                
  4.                      
  5. INTRODUCTION               
  6.  
  7. This archive is a message editor that works under both 16-bit DOS
  8. and 32-bit OS/2, and works with both *.MSG messagebases and
  9. Squish messagebases.
  10.  
  11.  
  12.  
  13. EVOLUTION
  14.  
  15. The original MSGED was written by Jim Nutt and released to the
  16. public domain.  It worked on *.MSG and Hudson messagebases (I
  17. think) under DOS 16-bit and OS/2 16-bit.  The latest release
  18. of this that I know of was 2.07.
  19.  
  20. MSGED/SQ was later created by John Dennis, who originally kept
  21. all his changes copyrighted, but later he then went and released 
  22. all his stuff to the public domain.  This version worked on 
  23. both *.MSG and Squish messagebases, and worked under 16-bit DOS 
  24. and 16-bit OS/2.  The last release from John was 2.2e, after 
  25. which he explicitly said he was no longer interested in maintaining 
  26. it.  The source was released in an archive called MSQ22SRC.LZH.
  27.  
  28. MSGED/SQ 2.2e was then modified by Paul Edwards to make it work
  29. with *.MSG and Squish under 16-bit DOS and 32-bit OS/2.  Plus
  30. a few bug fixes and enhancments.  The first version of this
  31. released was 3.00.
  32.  
  33.  
  34.  
  35. EXECUTABLES
  36.  
  37. The main DOS executable is MSGED.EXE.  The main OS/2 executable
  38. is MSGEDP.EXE.  There are a couple of ancillary support executables
  39. that are of little interest to anyone called HELP*.EXE.  Also there
  40. is a utility to tell you the hex code for a key, called KEYCODE*.EXE.
  41. There is one file that will be of interest to OS/2 users, and that's 
  42. a lovely MSGED.ICO created by Bill Grimsley, graphic artist and video
  43. repairman extraordinaire.
  44.  
  45.  
  46.  
  47. OTHER REQUIRED FILES
  48.  
  49. There is a configuration file MSGED.CFG which you will probably
  50. need to make a fair few changes to to get MSGED up and running.
  51. Other files include MSGED.COL, MSGHELP.DAT, TEMPLATE.MSQ.
  52.  
  53.  
  54.  
  55. DOCUMENTATION
  56.  
  57. See MSGED.DOC for the documentation.  Thanks to Bill Grimsley
  58. for updating it.  The MSGED documentation is lacking a hell of
  59. a lot of stuff, if someone would like to volunteer to update
  60. it, please contact me.  [note - Bill Whitehouse has indicated
  61. his intention to update the docs at this stage]
  62.  
  63.  
  64.  
  65. SOURCE
  66.  
  67. Full source code is included in the SRC subdirectory.  MSGED
  68. can be compiled using:
  69.  
  70. MAKEFILE.WAT - OS/2 makefile for Watcom
  71. MAKEFILE.IBM - OS/2 makefile for CSET
  72. MAKEFILE.EMX - OS/2 makefile for GNU/EMX
  73. MAKEFILE.BCC - OS/2 makefile for Borland
  74.  
  75. MAKEFILE.DOS - DOS makefile for Borland
  76. MAKEFILE.TCC - DOS makefile for Turbo C++
  77. MAKEFILE.W16 - DOS makefile for Watcom 16-bit [not thoroughly tested]
  78. MAKEFILE.W32 - DOS makefile for Watcom 32-bit [doesn't yet work]
  79.  
  80. As shipped, the OS/2 version has been compiled with Watcom 10.0b
  81. 32-bit compiler with full optimization, and the DOS version has
  82. been compiled with Borland C++ 3.1 with full optimization.  I
  83. would like to switch to Watcom for the DOS version, but the
  84. main problems are that spawn.asm doesn't compile under the Watcom
  85. assembler, which although isn't strictly necessary, would allow
  86. more free dos memory when doing a shell.  Also the amount of free 
  87. memory reported by Watcom is less than I would expect.  Also a 
  88. 32-bit DOS-extended version would be nice.  If someone would like 
  89. to volunteer to look at these technical assembler issues, please 
  90. speak up!
  91.  
  92. Both the DOS and OS/2 executables have been statically linked 
  93. with MSGAPI38, which is a modification of the original MSGAPI0.
  94. You can FREQ this from 3:711/934 as MSGAPI38.*.  The date of
  95. the version used to compile MSGED/SQ is 1995-06-07.
  96.  
  97.  
  98.  
  99. COPYRIGHT
  100.  
  101. All of the source code in this archive is public domain.
  102. However, to access Squish messagebases requires use of Scott
  103. Dudley's MSGAPI routines, which are copyrighted by him, and
  104. linked in to the executable.  This is allowed according to
  105. the license that the MSGAPI is distributed under.  If someone
  106. has some public domain C code to access the Squish messagebases,
  107. please let me know so that I can use that in MSGED.
  108.  
  109.  
  110.  
  111. SUPPORT
  112.  
  113. You can reach the current author, Paul Edwards at 3:711/934@fidonet.
  114. However, it would be preferable if you posted your questions in an
  115. appropriate echo so that people other than the current author can
  116. help you with your problem.  An appropriate echo would be
  117. MSGED_ECHO, but there doesn't currently appear to be a Zone 1 to
  118. Zone 3 link.  Another suitable place is PUBLIC_DOMAIN, but that 
  119. doesn't go the USA either.  Maybe what you should do is post in 
  120. MSGED_ECHO, and if you don't get any response, then send me netmail?  
  121. What I would REALLY like is for you to get a local C expert to find 
  122. the bug and just send me the bug fix so that I can incorporate it 
  123. into the next release.  However, if you can't do that, don't worry,
  124. just send me the bug report and I'll fix it myself.  I am very keen
  125. to eliminate all bugs from MSGED/SQ.  However, if I can't
  126. reproduce the problem here, I would appreciate it if you could try
  127. to find the bug yourself, as it is extremely difficult to fix bugs
  128. that I can't reproduce here.
  129.  
  130. As for enhancement requests, please send C source code that 
  131. implements the enhancement (and explicitly state that the code
  132. is public domain, too).  I have a long list of enhancements
  133. which I personally want, and when I have finished all of them,
  134. and all of my other public domain projects, I will start
  135. soliciting other enhancement requests.  Hell might freeze over
  136. before that time though.  If you don't know how to program in C,
  137. then get one of those 14 year-old's that spends most of their
  138. spare time hacking into the US DOD computers to spend 10 minutes
  139. of their expertise on your MSGED enhancement.  It takes me DAYS
  140. to add enhancements.
  141.  
  142.  
  143.  
  144. OBTAINING
  145.  
  146. You can obtain the latest version of MSGED/SQ by FREQing "MSGED"
  147. from 3:711/934.  I have a magic name set up so that you can get
  148. this.
  149.  
  150.  
  151.  
  152. OTHER VERSIONS
  153.  
  154. There are other versions of MSGED floating around, supported by
  155. different people.  Make sure that if you are reporting a bug with
  156. my version of MSGED that you really are using my version!  Go to
  157. the other authors for support for their version of MSGED.  I have
  158. heard about some vaporware versions of MSGED, but besides this
  159. one, the only real one that I know of is the one put out by Bill
  160. Bond.  Bill has sent me a lot of code updates, and I have 
  161. incorporated much of it into this version, but there are some
  162. things that I don't wish to incorporate.  Some of this includes
  163. letting the user muck around with control line such as tear and
  164. origin.  If you don't like my version of MSGED, you might like to
  165. try his instead.  He normally modifies whatever version I put out,
  166. so you will be getting most of the stuff I have done anyway.  Last
  167. I heard, you could obtain his version by FREQing "MSQ" from 
  168. 1:325/118.
  169.  
  170.  
  171.  
  172. HISTORY
  173.  
  174. 2.00 Jim Nutt's version that MSGED/SQ was cloned off
  175. 2.2e John Dennis's last release of MSGED/SQ
  176. 3.04 Paul Edwards's first widely-distributed version
  177. 3.05 Bug fixes to 3.04
  178. 3.10 Many random changes and many bug fixes
  179.  
  180.  
  181. BUGS
  182.  
  183. There have been some reported problems, but none that I have been
  184. able to reproduce here.
  185.