home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / thesrc15.zip / readme.src < prev    next >
Text File  |  1993-12-07  |  5KB  |  125 lines
  1.                       Welcome to THE, The Hessling Editor.
  2.  
  3. INTRODUCTION
  4. ------------
  5.  
  6. THE is a full-screen character mode text editor based on the VM/CMS editor
  7. XEDIT and some features of KEDIT for DOS written by Mansfield Software.
  8.  
  9. THE has currently been ported to SUNOS 4.1.x, Xenix-386, DOS (using both
  10. Borland C++ 3.0, Microsoft C v6.00ax and DJGPP) Esix 4.0.3a, ATT SystemV 3.2,
  11. Linux,386BSD and to OS/2 2.0/2.1 (using Microsoft C v6.00, C Set/2 and
  12. Borland C++ for OS/2).
  13. An attempt has been made to port THE to VAX/VMS. Some major work is still
  14. required. A port to the Amiga is currently being undertaken.
  15.  
  16. The SUNOS port has options for the BSD, System V, acc and gcc compilers.
  17. THE is known to run on SUNOS 4.1.3, Solaris 2.x, Xenix-386, DOS, 
  18. OS/2 2.x, Esix 4.0.3a, ATT SystemV 3.2, Linux, 386BSD, AIX, HP-UX, 
  19. Ultrix, Sequent. THE should compile on any Unix system.
  20.  
  21. The DOS and OS/2 port requires the use of PDCURSES 2.1; a public domain
  22. library of curses screen handling routines, of which I am the current
  23. maintainer. PDCurses 2.1 is also available from the Australian anon ftp 
  24. site mentioned below in /src/PDCurses
  25.  
  26. THE OS/2 port is similar to EPM, runs within an OS/2 command window and is
  27. HPFS aware. THE also uses the OS/2 REXX interpreter to execute macro files.
  28. An extensive interface exists between THE and REXX giving THE the complete
  29. power of REXX.
  30.  
  31. REXX support is also avaliable on Unix systems and with DJGPP using Regina 
  32. 0.05, a free REXX interpreter available from flipper.pvv.unit.no in pub/rexx.
  33. Details on integrating THE and Regina are included in the makefile.
  34.  
  35. THE uses curses as its screen handler. This makes it portable but not the
  36. best for fast screen refreshes.
  37.  
  38. See the makefile for more information on compiling THE.
  39.  
  40. To get detailed descriptions of each command;
  41.  
  42.  make manual
  43.  
  44. This will create a file called the.man.
  45.  
  46. If you find bugs or major inconsistencies, please let me know. If you
  47. manage to compile and run on a different platform to the above, please
  48. send me any changes to the code and the makefile, so I can include the
  49. patches in the official release.
  50.  
  51. A mailing list has been created for discussion of THE. You can subscribe
  52. to it by sending an email message to listproc@gu.edu.au with the body of
  53. the email message containing:
  54.  
  55. SUBSCRIBE THELIST Your Name
  56.  
  57. To send messages to other subscribers, send an email message to
  58. thelist@gu.edu.au.
  59.  
  60. THE is distributed under the terms of the GNU General Public License.
  61. For more details see the file COPYING that should have accompanied this.
  62.  
  63. THE is available via anonymous ftp from the following sites:
  64.  
  65.  North America: rexx.uwaterloo.ca
  66.                 /pub/editors/the
  67.  Europe:        flipper.pvv.unit.no
  68.                 /pub/the
  69.  Australia:     ftp.gu.edu.au
  70.                 /src/THE
  71.  
  72. thedos??.zip            - version ?.? DOS executable and documentation
  73. thedjg??.zip            - version ?.? extended DOS executable and documentation
  74. theos2??.zip            - version ?.? OS/2 executable and documentation
  75. thesrc??.zip            - source code for version ?.?
  76. thesrc??.tar.Z          - source code for version ?.?
  77.  
  78. You will need Info-Zip's Unzip 5.0 or equivalent to unzip this archive. 
  79. Also note that the source files will be in Unix format (LF only to end line)
  80. so unzipping under DOS or OS/2 use the -a switch.
  81.  
  82. MANIFEST
  83. --------
  84.  
  85. COPYING         - GNU General Public License
  86. *.c             - source files in C (will support K&R or ANSI C)
  87.                   use -DPROTO to use prototypes
  88. *.h             - various header files
  89. the.his         - release history
  90. readme.src      - this file
  91. readme.exc      - readme file for executable distribution
  92. overview        - documentation overview
  93. appendix.1      - Appendix 1 for THE Reference Manual
  94. files.rcs       - A list of all source files.
  95. makefile        - makefile containing various sample setups
  96. *.rsp           - linker response files
  97. *.def           - linker definition files
  98. *.hlp           - help files
  99. PROFILE.THE     - sample profile file which immitates KEDIT
  100. *.the           - sample THE macro files (only useful with a supported 
  101.                   REXX interpreter)
  102.  
  103.  
  104. See the makefile for details on how to compile THE for your platform.
  105. Read the.his to see what has been added or changed in the latest release.
  106. Default values for some system limits are defines in defines.h. Change
  107. these values if you require.
  108.  
  109. ********************* Note to Users of Borland C++ 2.0 *****************
  110. There is a bug in the stat() function that returns an error if you call
  111. stat() with the root directory. This causes any sos_edit of a directory
  112. that will resolve to the root directory to think it is a new file.
  113. The bug in stat() has been fixed in release 3.0.
  114. ********************* Note to Users of Borland C++ 2.0 *****************
  115.  
  116. Enjoy, Mark.
  117.  
  118. ------------------------------------------------------------------------
  119.    Mark Hessling                     email: M.Hessling@gu.edu.au
  120.    36 David Road                     Phone: +61 7 849 7731
  121.    Holland Park                      Fax:   +61 7 875 7877
  122.    QLD 4121
  123.    Australia                         ** PDCurses maintainer **
  124. ------------------------------------------------------------------------
  125.