home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / ue312os2.zip / README.OS2 < prev    next >
Encoding:
Text File  |  1994-11-18  |  5.6 KB  |  150 lines
  1.  
  2.  
  3.  
  4. MICRO-EMACS for OS/2 2.x 
  5.  
  6. This is a 32 Bit version of µ-emacs 3.12 for OS/2 2.X with mouse and
  7. (emacs)-window-support
  8.  
  9. It can be now compiled by two different Compilers: EMX-GNU-GCC and
  10. IBM-ICC. 
  11.  
  12. Both versions act nearly the same, with only (we hope) one difference:
  13. the gcc-version can be started using wildcards for the filenames at the
  14. command-line, the icc- version don't. 
  15.  
  16. This package contains a ready-to-run icc-version of µemacs in the
  17. os2/bin-directory.
  18.  
  19.  
  20. INSTALLING THE GCC/EMX-VERSION OF EMX
  21.  
  22. To install the Gcc -Version, you should put the runtime libraries
  23. emx.dll and emxlibc.dll into a dircetory, which is mentioned in your
  24. LIBPATH-statement in the config.sys. The Executable-File (which is
  25. called MEMACS.EXE to avoid interference with the REAL emacs (eight
  26. megabytes always constantly swapping ;-) ) should find its place
  27. somewhere in a path which is in your PATH. Actually this package does
  28. NOT contain this file! (read at the end of this file) . To use the
  29. command files of emacs (*.cmd - this are no batch jobs or REXX command
  30. files) or the online help the environment variable DPATH has to point to
  31. the directory where they are installed.
  32.  
  33. INSTALLING THE ICC-VERSION OF EMX
  34.  
  35. To install the ICC-Version, copy the executable whereever you want, it
  36. is statically linked, you don't need any runtime library.
  37.  
  38.  
  39. COMPILING MICROEMACS
  40.  
  41. This Zip-file is an excerpt of the original UE312DEV.ZIP-package, with
  42. some differences in os2.c, os2npm.c, dolock.c and estruct.h. It contains
  43. every file (and some more) which are necessary to recompile it.
  44. Try Latin as language!
  45.  
  46. estruct.h is a very important file for the generation of µemacs. 
  47. It controls the compilerswitches, the target OS and selects the features
  48. for the editor (including the language).
  49.  
  50. We added a new Compiler-definition for the IBM-Compiler, ICC.
  51. Also we enhanced the operating-switch: OS2 
  52. you can now define it to 1 or 2, so it is compatible to good old OS/2 1.x .
  53.  
  54. COMPILING MICRO_EMACS USING GCC 
  55.  
  56. So if you want to create the EMX-GNU-GCC-based product, set OS2 as 2 and
  57. enable the GCC switch in estruct.h .
  58.  
  59. Then change to the emacs/os2-directory
  60. and start your favorite make: make makefile.gcc. Now you can lean back,
  61. drink one (or two (computer-dependend)) cups of coffee.
  62.  
  63. Afterward you will find a memacs.exe in the os2/bin-directory!
  64.  
  65. COMPILING MICRO_EMACS USING ICC
  66.  
  67. if you want to create the ICC-based product, set OS2 to 2, too, but be
  68. shure to set GCC to 0 and ICC to 1! You can use IBM C-SET++ 2.0 to 2.1
  69. and probably IBM FIRSTSTEP (there you should delete the /O+ optimize
  70. switch in the makefile.icc), perhaps it works with IBM C-SET 1.0, I
  71. don't know. You also must have correctly installed 2.x Toolkit 2.x.
  72.  
  73.  
  74. Change to the emcs/os2 directory and start compiling:  nmake
  75. makefile.icc. Don't be alarmed by the warnings and information-messages!
  76. The creation of emacs will go a little bit faster, but you will be
  77. easily be able to empty your cup of coffee (or tea). 
  78.  
  79. The output you will find in os2/bin, it is called emacs.exe
  80.  
  81. ADVICE FOR OTHER COMPILERS
  82.  
  83. If you want to use another compiler you will have to add some
  84. code for a 16:16 bit to a 32 bit pointer conversion in the file
  85. src/os2npm.c.
  86.  
  87. STUFF
  88.  
  89. Note: We are NOT the authors of this program. Please send any questions
  90. or comments (and donations) about the editor itself to Daniel Lawrence
  91. mentioned in the file "readme" in the src directory. 
  92.  
  93.     Ralf Seidel 
  94.     eMail: seidel3@wrcs3.urz.uni-wuppertal.de
  95.  
  96.     Wulf Bramesfeld
  97.     eMail: bramesf@ist319.ist.rwth-aachen.de
  98.  
  99.  
  100. P.S.: As you will have recognized our english isn't the best. Comments
  101. and/or corrections are welcome.
  102.  
  103. P.P.S.:    The adaptions were done indepently in autumn 1993.
  104. Ralf did it for GCC in 10.93 and Wulf did it for ICC in 9.93
  105. We put both streams together in april 1994, because nothings better than
  106. a fullscreen editor!
  107.  
  108. P.P.P.S.: Because I cant get in contact to Ralf, he is not responding
  109. anymore, I couldn't test this version with gcc. But it should work.
  110. Pleas contact me, if you have problems.
  111.  
  112. FIXED AND ENHANCED FEATURES:
  113.  
  114. In summer '94 I fixed some bugs in the screen-management routines, so
  115. you are able to open, move, duplicate, resize and close emacs-screens
  116. like it is described in the documentation. Also I enhanced the
  117. video-interface for SVGA-cards. 
  118.  
  119. So if you do not set the $SRES-variable, emacs does not change the
  120. resolution of the video-screen, it uses the current screen-dimensions.
  121. Example: If you change your screen using the mode-command like mode
  122. co132,25, µEmacs will use this mode. In windowed-sessions, OS/2 (2.11)
  123. does not allow to change to a 132-columns mode, but you can define as
  124. much rows as you like. 
  125.  
  126. Because I didn't change the DOS-µemacs, I added the following lines to
  127. my emacs.rc, which is used by both programms:
  128.  
  129. !if ¬ &sequal $os "OS2"
  130.     set $sres "CGA"
  131. !endif
  132. This enables the OS/2-µemacs to use the current video-mode, and enables a
  133. colored, 80x25-screen for DOS-µemacs.
  134.  
  135. Also I added two new parameters for $SRES: SVGA1 for 132x25 and SVGA2
  136. for 132x43. This modi will not work in an PM-window. So normally the
  137. Screen-resolution-macro will report an error, if emacs is started in a
  138. window with a set $sres "SVGAx" in the RC-file. So, if the
  139. window-setting fails, I changed the behaviour a little bit, it now
  140. changes to CGA-mode without complaining. So you can use only one
  141. EMACS.RC File for window and fullscreen emacs-sessions.
  142.  
  143. Known Problems:
  144.  
  145. If the Screen is set to a enhanced mode (132xRow) and Emacs is started
  146. with a set $SRES not equal to SVGAx, a protection violation happens. I
  147. Know WHERE it happens but I don't know exactly WHY.
  148.  
  149. Wulf
  150.