home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / emacs / src / z80emacs.doc < prev    next >
Encoding:
Text File  |  1994-07-07  |  6.0 KB  |  143 lines
  1. This is a CP/M, Z80 version of emacs, derived from 
  2. microemacs version 3.6; the CP/M version was created by 
  3. Ralph Betza in 1989.
  4.  
  5. Z80EMACS is an editor, not a word processor. 
  6. It's also not really finished, although as it stands it works quite 
  7. well and is more feature-rich than any other CP/M editor.
  8. ( No, it doesn't have wordprocessing features; it's an editor, not... ).
  9.  
  10. This is a good place for a commercial: Z80EMACS isn't quite finished; 
  11. it lacks several features that I think any decent editor really ought 
  12. to have ( but few do ). If enough people send checks to 
  13.  
  14.     Ralph Betza
  15.     646 11th Avenue
  16.     New Hyde Park, NY, 11040
  17.  
  18. there will be another release of Z80EMACS, with new features, and with 
  19. fixes ( if any are needed ;-) I won't do it if nobody cares, but I'll
  20. work for a buck an hour on it if enough people do care. This isn't 
  21. shareware, so don't feel guilty...
  22.  
  23. End of commercial.
  24.  
  25. Z80EMACS is a so-called "modeless" editor, like WordStar and VDE;
  26. control characters are commands, and printable characters get put into 
  27. the file.
  28.  
  29. Here are some of the features of Z80EMACS that make it so much more 
  30. powerful than what you're used to seeing on CP/M:
  31.  
  32. 1. As in any version of emacs, you can use Z80EMACS to edit more than 
  33. one file at a time; not all of the files being edited need to be on
  34. the screen at the same time, but more than one of them can be --
  35. Given that there are 24 screen lines available, and each file shown 
  36. must get at least 2 lines of the screen, you could get up to 12 files 
  37. shown at once. ( You wouldn't want to, but you could ).
  38.  
  39.    Two files at once on the screen is usually enough -- an include file 
  40.    and a program. Two files at once being edited is often not enough; 
  41.    the number of files in Z80EMACS is limited only by available memory.
  42.  
  43.    In EMACS, we like to call each file a "buffer". You can be editing 
  44.    text that doesn't have a filename. ( You'll find there are uses for 
  45.    this ).
  46.  
  47.    It's easy to copy or move text from one file to another.
  48.    
  49. 2. You can reconfigure Z80EMACS; if you want ^N to be the down-arrow 
  50. key, you can have what you want.
  51.  
  52.    See MAPKEYS.DOC for details.
  53.  
  54. 3. When you delete text, you can get it back; this is great if you
  55. made a mistake, and it's also part of the method used to move or copy 
  56. text.
  57.  
  58. 4. Up-arrow and down-arrow move straight up and down the screen -- 
  59. like WordStar, not like VDE ( unless VDE fixed this since 1989 ).
  60.  
  61. 5. Variable tabs ( sorry, only by inserting N spaces, not by
  62. displaying tabs as different numbers of spaces on the screen while 
  63. having tabs in the file -- next release, maybe ).
  64.  
  65. 6. "Word" commands can work in any of 4 ways, at your pleasure.
  66. There are 7 different "word" commands.
  67.  
  68. 7. Z80EMACS can remember one position in each window, and one 
  69. position in each file that's not shown on the screen.
  70.  
  71.    In EMACS, we like to call this remembered position a "mark".
  72.    
  73. 8. Lots of "region" commands: the area between the cursor and the 
  74. "mark" is called the "current region". There are currently only
  75. 5 things you can do to the current region, but wait for next 
  76. release...
  77.  
  78.    The emacs "region" concept is similar to the WordStar "block" 
  79.    concept. Each way of doing things has its own advantages and 
  80.    disadvantages.
  81.  
  82. 9. The emacs "keyboard macro": you tell Z80EMACS to start remembering
  83. what you type, do your normal editing commands, tell it to stop 
  84. remembering, and you can execute the same sequence again. Much better 
  85. than VDE macros. Z80EMACS saves its keyboard macro in a file, so you 
  86. can use it again tomorrow.
  87.  
  88. 10. When you try to exit, Z80EMACS asks for confirmation if any of 
  89. your files are modified -- and it's smart enough to keep its mouth shut
  90. if you already saved everything.
  91.  
  92. 11. Z80EMACS has 9 "Display Control" commands, to let you control 
  93. windows, a bunch of "session control" commands ( some are mistakenly 
  94. labeled as editing comands in ZMECMDS.LST, I'd say there are about 10
  95. session control commands in all ), to let you control the buffers and 
  96. the files in them, and more editing commands than you're likely to use.
  97.  
  98. 12. Z80EMACS lets you give parameters to the commands. The parameters 
  99. are numeric. For example, if you type ^U60+ at the start of a line,
  100. you get
  101. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  102. ( notice that even the printable characters are ordinary commands ).
  103.  
  104. 13. Source code for Z80EMACS is available. You should be able to find
  105. it in the same place you found the binaries.
  106.  
  107. ============================================================
  108.  
  109. There are other advantages, but these are the most important.
  110.  
  111. The rest of what I'm going to say is good news/bad news:
  112.  
  113. Z80EMACS is a big program, and it uses overlays; that's bad if you use 
  114. floppies, good if you have a ramdisk. It's good in either case because
  115. it makes it easier to expand Z80EMACS; you could even add an overlay 
  116. without recompiling, using MAPKEYS.COM to get the new overlay invoked.
  117.  
  118. Despite the overlays, performance is good; all the most-frequently-used 
  119. commands are in the same overlay, and the overlays are small, so they 
  120. don't take a lot of time to read in.
  121.  
  122. Z80EMACS keeps all file data in memory, in linked lists of lines.
  123.  
  124. "In memory" is faster than a temporary file, but limits the size; with
  125. my 60KB TPA, I can edit 22542 bytes in 824 lines of one file ( the
  126. same file I always use to test this after I've tried to improve these 
  127. figures ), or fewer bytes spread over more files. 
  128.  
  129.    Of course, the size limit encourages modular programming...
  130.  
  131. "Linked lists" are okay because most operations on the file use 
  132. sequential access. A pointer array would have plusses and minuses.
  133.  
  134. If there is more than one window on the screen showing the same file 
  135. that you're typing in, and if you type at all quickly, you will lose 
  136. characters. This only happens if more than one window is showing the
  137. current buffer, which is an uncommon situation.
  138.  
  139. Documentation could be better, but then, it could be worse.
  140.  
  141. Ralph Betza, October 4, 1991
  142.  
  143.