home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / emacs / emacsp2.doc < prev    next >
Lisp/Scheme  |  1992-06-28  |  5KB  |  147 lines
  1. =======================================================================
  2. emacsp2.doc GNU Emacs 18.58.3 for OS/2 2.0 -- Patch 2      23-June-1992
  3. =======================================================================
  4.  
  5. This is the second patch for GNU Emacs 18.58.3 for OS/2 (as far as
  6. I know). It really is a little collection of patches. It includes
  7. the following files:
  8.  
  9. doc.cmd           Updated version of doc.cmd
  10. emacsp2.diff      Patches
  11. emacsp2.doc       This file
  12. lib.el            Updated version of lib.el
  13. os2.c             New source module emacs/src/os2.c
  14. site-init.ex      Example site-init file
  15.  
  16. You need the GNU patch utility to apply the patches and emx/gcc to
  17. recompile Emacs.
  18.  
  19. Some of the patches have already been posted to emx-list, but these
  20. are newer versions.
  21.  
  22.  
  23.  
  24. 1. Installation
  25. ---------------
  26.  
  27. - Unpack the file (UNZIP NOT PKUNZIP!) in a temporary directory.
  28.  
  29. - Copy lib.el to emacs/lisp and os2.c and doc.cmd to emacs/src.
  30.  
  31. - If you did apply the older patches posted to emx-list, substitute
  32.   the appropriate files by the old ones.
  33.  
  34. - CD to emacs/src and apply the patches. If GNU patch is reachable
  35.   under patch and /tmp is the temporary directory, for example:
  36.   cd emacs/src
  37.   patch </tmp/emacsp2.diff
  38.   del *.orig
  39.   The following files will be changed:
  40.   editfns.c, emacs.c, fileio.c, keyboard.c, s-os2.h, ymakefile
  41.  
  42. - Recompile Emacs. Look at emacs.doc for information about how to
  43.   do it. You certainly need emx/gcc.
  44.  
  45. - Have a look at site-init.ex, DO NOT REPLACE SITE-INIT.EL WITH IT!
  46.  
  47. Here are the problems solved:
  48.  
  49.  
  50.  
  51. 2. Ctrl-Break-Problem
  52. ---------------------
  53.  
  54. Emacs for OS/2 18.58.3 terminates without any requests when you press
  55. Ctrl-Break. Though this behavior is perhaps not surprising, you can
  56. loose data after pressing this key accidently.
  57.  
  58. A new variable has been introduced: ctrl-break-action. Its values have
  59. the following meanings:
  60.  
  61. 0 : Do nothing, just return C-@.
  62. 1 : Like C-g C-g, termination with request.
  63. 2 : Terminate program immediatly without request.
  64. 3 : Force an abnormal program termination (dump core) without request.
  65.  
  66. The default value is 1. It is strongly recommended not to use a value
  67. of 2 or higher unless you do exactly know what you do.
  68. You can change this variable in the usual way, adding a line like the
  69. following to your .emacs file:
  70.  
  71. (setq ctrl-break-action 0)
  72.  
  73. Because C-@ is not binded to any command, Emacs signals an error after
  74. pressing it (certainly only in cases 0 and 1!).
  75.  
  76.  
  77.  
  78. 3. File Names
  79. -------------
  80.  
  81. Under Unix, Emacs detects the sequence "//" in file names you entered.
  82. It then throws away all characters before and starts at the root.
  83.  
  84. Under OS/2, several other sequences should have the same effect. This
  85. patch enables, the following ones:
  86. //, \\, /\, \/, /x:, \x:
  87. where x is an arbitrary character. Note that "abc/x:def" does NOT start
  88. at the root of drive x:, but at the current path of it: "x:def". Enter
  89. "abc/x:/def" if you want to start at the root.
  90.  
  91. The sequences //, \\, /\, \/ at the start of a name have special meaning
  92. under some network software, thus they are NOT changed!
  93.  
  94.  
  95.  
  96. 4. Compiling Lisp Libraries
  97. ---------------------------
  98.  
  99. The former code to compile the important Lisp Libraries had several
  100. problems. The Library path was hard wired, every Library was recompiled
  101. and em-keys.el and os2.el were not compiled.
  102.  
  103. After replacing it with the new one, the Libraries are always searched
  104. in emacs/lisp, only changed or not yet compiled Libraries are compiled
  105. and the OS/2 extension Libraries are compiled, too.
  106.  
  107.  
  108.  
  109. 5. Adding Libraries to the dumped Emacs
  110. ---------------------------------------
  111.  
  112. The file site-init.ex is an example how to load big Lisp Packages into
  113. dumped Emacs. In this example, emacs/lisp/local/dired.elc is quite a big
  114. package. If you just add the line
  115. (load "local/dired")
  116. to site-init.el, you will get a "Pure Lisp Storage Exhausted" Error.
  117. If you had such problems, look at site-init.ex.
  118.  
  119. DO NOT OVERWRITE YOUR SITE-INIT.EL WITH THIS FILE !!!!!!
  120.  
  121.  
  122. 6. User Full Name
  123. -----------------
  124.  
  125. OS/2 is not a multi-user system, so emx supports no user-administration
  126. facilities. It may, though, perhaps sometimes useful to have the user's
  127. full name available (for example when creating an entry to a ChangeLog
  128. file). You can now set the environment variable USERFULLNAME to your
  129. full name. The function user-full-name then returns its value. If you do
  130. not set this variable, the function returns "unknown".
  131.  
  132.  
  133.  
  134.  
  135. Any comments welcome.
  136.  
  137. No warranty.
  138.  
  139. Joerg Viola
  140. Potstiege 7
  141. D-4400 Muenster
  142. Germany
  143.  
  144. joerg_viola@ms.maus.de
  145.  
  146. ---------------------------------- END ---------------------------------------
  147.