home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / edit / jade / man / jade.info-1 (.txt) < prev    next >
GNU Info File  |  1994-10-16  |  50KB  |  1,026 lines
  1. This is Info file jade.info, produced by Makeinfo-1.55 from the input
  2. file jade.texi.
  3. START-INFO-DIR-ENTRY
  4. * Jade: (jade).            An editor for X11 and AmigaDOS
  5. END-INFO-DIR-ENTRY
  6.    This is Edition 1.3, last updated 7 October 1994, of `The Jade
  7. Manual', for Jade, Version 3.2.
  8.    Jade is a text editor for X11 (on Unix) and the Amiga.
  9.    Copyright 1993, 1994 John Harper.
  10.    Permission is granted to make and distribute verbatim copies of this
  11. manual provided the copyright notice and this permission notice are
  12. preserved on all copies.
  13.    Permission is granted to copy and distribute modified versions of
  14. this manual under the conditions for verbatim copying, provided that
  15. the entire resulting derived work is distributed under the terms of a
  16. permission notice identical to this one.
  17. File: jade.info,  Node: Top,  Next: Copying,  Prev: (dir),  Up: (dir)
  18.    Jade is a highly flexible Emacs-style text editor for X11 (on Unix)
  19. and AmigaDOS.
  20.    This is Edition 1.3 of its documentation, last updated 7 October
  21. 1994 for Jade version 3.2.
  22. * Menu:
  23. * Copying::                     Distribution conditions
  24. * Introduction::                Brief introduction to Jade
  25. * News::                        New features in this release
  26. * Systems Supported::           The operating systems Jade supports
  27. * Editor Concepts::             Some ideas you should understand
  28. * Key Names::                   How keys are described in this manual
  29. * Starting Jade::               How to start the editor
  30. * Using Jade::                  Instructions for using the editor
  31. * Programming Jade::            How to extend Jade -- its Lisp system
  32. * Reporting Bugs::              How to contact me
  33. * Function Index::              Menu of all documented functions
  34. * Variable Index::              All variables which have been mentioned
  35. * Key Index::                   Menu of all key bindings
  36. * Concept Index::               Main index, references to all sections
  37. File: jade.info,  Node: Copying,  Next: Introduction,  Prev: Top,  Up: Top
  38. Copying
  39. *******
  40.    Jade is distributed under the terms of the GNU General Public
  41. License, this basically means that you can give it to anyone for any
  42. price as long as full source code is included. For the actual legalese
  43. see the file `COPYING' in the distribution. I reserve the right to use
  44. a different licence in future releases.
  45.    The only parts of Jade which are not my own work are the regexp
  46. code, this is by Henry Spencer (though I have made some small
  47. modifications) and is distributed under his conditions, and the ARexx
  48. interface in the Amiga version which is based on `MinRexx' by Radical
  49. Eye Software.
  50.    Be aware that there is absolutely NO WARRANTY for this program, you
  51. use it at your own risk. Obviously I hope there are no bugs, but I make
  52. no promises regarding the reliability of this software.
  53. File: jade.info,  Node: Introduction,  Next: News,  Prev: Copying,  Up: Top
  54. Introduction
  55. ************
  56.    Jade is a text editor primarily designed for programmers. It is
  57. easily customised through a Lisp-style extension language and can be
  58. tailored to the user's own requirements.
  59.    Jade is designed to run under a graphical windowing system, systems
  60. currently supported are the Commodore Amiga and the X Window System
  61. version 11 (but only under Unix).
  62.    It is the successor to the editor `Jed 2.10' which I released for the
  63. Amiga in early 1993. I have decided to rename it now that I have made an
  64. X11 version since there is already an editor called `Jed' available
  65. (there is no connection between the two, I haven't even looked at the
  66. other one). "Jade" is an anagram of "A Jed", if you want an acronym you
  67. could use "Just Another Damn Editor", if you can think of anything
  68. better please tell me.
  69.    Jade is compatible with GNU Emacs in terms of key presses and
  70. command names to a certain extent but it is not intended as a simple
  71. copy of Emacs (indeed, when I started this I had never actually used
  72. Emacs!). I have tried to take my favourite aspects of all the editors I
  73. have used as well as adding features that I have not found elsewhere.
  74. Consequently, it is very much the editor that *I* want -- you may not
  75. find it so appealing.
  76. File: jade.info,  Node: News,  Next: Systems Supported,  Prev: Introduction,  Up: Top
  77.    This chapter lists the major changes to Jade and which release they
  78. occurred in. Only changes relevant to you, the user, are detailed; for
  79. more explicit history see the `ChangeLog' files with the sources.
  80. Version 3.2
  81. ===========
  82.    * The programmer's manual has finally be written.
  83.    * Undo; devote as much memory as you want to keep track of all
  84.      modifications to a buffer which can then be wound back.
  85.    * Arguments can be given to commands as they're invoked.
  86.    * Buffer menu for interactive buffer manipulation.
  87.    * An Emacs-style local variables section can be embedded in a file;
  88.      replaces the naff `::jade-code::' thing.
  89.    * `Ctrl-k' (`kill-line') works at last.
  90.    * Now possible to interrupt jade while it's working (i.e. to let you
  91.      kill infinite loops).
  92.    * The Help system now has commands to list key bindings, display
  93.      what is bound to any key sequence.
  94.    * Use of the Latin-1 character set is now controlled by the minor
  95.      mode `latin-1-mode'.
  96.    * Can load and save compressed (compress or gzip) files into/out of
  97.      buffers transparently when running on Unix.
  98.    * Transposing commands; `transpose-chars', `transpose-words',
  99.      `transpose-exps'. Bound to `Ctrl-t', `Meta-t' and `Ctrl-Meta-t'
  100.      respectively.
  101.    * Can now run a shell in an editor buffer, very basic (no
  102.      completion) but it works okay.
  103.    * Support for using gdb through the shell interface, the current
  104.      frame's source code is highlighted in a separate window.
  105.    * `Ctrl-z' moves to `Ctrl-W' so that `Ctrl-z' can (de)iconify the
  106.      current window.
  107.    * Some programs written for the previous incarnation will need to be
  108.      altered; all will have to be recompiled.
  109. Version 3.1
  110. ===========
  111.    * Now properly supports characters which print as more than one
  112.      character (i.e. proper tabs, `^L', `\123', etc...). In general any
  113.      character can print as any sequence of up to four character-images.
  114.    * Doesn't expand tabs to spaces anymore, this means that loading and
  115.      saving of largish files is noticeably quicker.
  116.    * Files containing NUL characters can be edited (more or less)
  117.      successfully.  Some commands (notably the regexp matcher) still
  118.      don't like these characters but, in the main, binary files can be
  119.      edited successfully.
  120.    * Searching and replacing has changed, it's easier to use now and
  121.      replacing globally is built in.
  122.    * Many improvements to the Info viewer, not least, the dir file
  123.      doesn't have to have a tag-table anymore.
  124.    * Client editing. This lets you load files into a running editor
  125.      from a shell. For example, if your mailer runs an editor on the
  126.      message you're writing you can use the client to edit the message
  127.      in a Jade that you are running.
  128.    * The buffer prompt's completion is now controllable by the mouse as
  129.      well as the keyboard. Click the right button to complete the
  130.      current word.  Double-clicking the left mouse button on one of the
  131.      lines under the `::Completions::' line selects that completion.
  132.    * `text-mode' and `indented-text-mode' major-modes for editing
  133.      English language (as opposed to programming languages).
  134.    * Minor-modes. These provide small variations to the major-modes.
  135.      For example, `overwrite-mode' makes typed keys overwrite
  136.      whatever's under the cursor.  Also included is a minor mode to do
  137.      auto-filling (word wrap).
  138.    * On Unix, a tilde (`~') in a filename is handled properly in most
  139.      cases
  140.    * It is now possible to Meta qualify a key press and it will pretend
  141.      that you pressed ESC then the un-Meta'd key.
  142. File: jade.info,  Node: Systems Supported,  Next: Editor Concepts,  Prev: News,  Up: Top
  143. Requirements
  144. ************
  145.    Jade will only run on certain operating systems, this chapter
  146. details just what it needs as well as some notes relevant to each
  147. system.
  148. Amiga Jade
  149. ==========
  150.    The only real requirement for Jade running on an Amiga is that it
  151. must run an oper