home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / edit / jade / man / jade.info-3 (.txt) < prev    next >
GNU Info File  |  1994-10-16  |  50KB  |  1,067 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: Using Marks,  Next: Interrupting Jade,  Prev: Using the Prompt,  Up: Using Jade
  18. Using Marks
  19. ===========
  20.    Marks are used to record a position in a file, as the file's buffer
  21. is modified so does the position that the mark points to -- a mark will
  22. keep pointing at the same character no matter what happens (unless the
  23. character is deleted!).
  24.    The other good thing about marks is that they point to files *not*
  25. buffers. This means that you can set a mark in a buffer, delete the
  26. buffer and then move to the position of the mark, the file will be
  27. reloaded and the cursor will point at the original character.
  28.    Normally there are three user-accessible marks (1) and one special
  29. `auto-mark' which is used, amongst other things, to record the
  30. "previous" position of the cursor, allowing you to retrace your last
  31. major step.
  32.    The commands available on marks are,
  33.      Move to the mark #1, #2 or #3, depending on which function key is
  34.      pressed (F1 means mark #1, etc...). If the file pointed to is not
  35.      in memory it will be loaded into a new buffer.
  36. `Shift-F1'
  37. `Shift-F2'
  38. `Shift-F3'
  39.      Set the position of mark #1, #2 or #3, depending on the function
  40.      key.
  41. `Ctrl-x Ctrl-x'
  42.      Swap the positions of the cursor and the `auto-mark'.
  43. `Ctrl-@'
  44.      Set the position of the `auto-mark'.
  45.    ---------- Footnotes ----------
  46.    (1)  There is no reason why you can't have more, the editor sets no
  47. limitation on the number of marks available. This is just how I have
  48. set the editor up.
  49. File: jade.info,  Node: Interrupting Jade,  Next: Recursive Editing,  Prev: Using Marks,  Up: Using Jade
  50. Interrupting Jade
  51. =================
  52.    It is often useful to be able to tell Jade to quit whatever it is
  53. doing and wait for more commands; this is called "interrupting" Jade.
  54. When the editor receives an interrupt signal it will abort what it is
  55. doing and rewind itself back to the inner-most recursive edit (see
  56. *note Recursive Editing::.).
  57.    The interrupt signal differs with the operating system being used,
  58.    * Under Unix the `SIGINT' signal is used, this can be sent via the
  59.      `intr' character (get the editor into the foreground of the shell
  60.      it was started from and type `Ctrl-c' in the shell's terminal), or
  61.      directly through the `kill' shell command. For example, look at
  62.      the following shell session extract,
  63.           /var/src/jade/man$ ps
  64.             PID TT STAT  TIME COMMAND
  65.              60  1 SW    0:02 (xinit)
  66.              87  1 S     0:08 fvwm
  67.             127 p0 S     0:00 /bin/bash
  68.             155 p0 S     0:04 jade
  69.             156 p1 S     0:00 /bin/bash
  70.             159 p1 R     0:00 ps
  71.           /var/src/jade/man$ kill -INT 155
  72.      First the `ps' command is used to find the Jade process' pid (155),
  73.      then the `kill' command is used to send the `INT' signal to this
  74.      process.
  75.    * The `Ctrl-c' signal is also used on Amigas, either type this in
  76.      the console window that Jade was launched from or use the `break'
  77.      (or possibly `breaktask') command to send the signal.
  78. File: jade.info,  Node: Recursive Editing,  Next: Character Images,  Prev: Interrupting Jade,  Up: Using Jade
  79. Recursive Editing
  80. =================
  81.    Recursive editing is the act of editing a file while the current
  82. command is still being evaluated. For example, when using the
  83. `query-replace' command (`Meta-%') the `Ctrl-r' command enters a
  84. recursive edit to let you edit the buffer, even though you are still
  85. doing a query-replace (which will be resumed when the recursive edit
  86. finishes).
  87.    As the name suggests a recursive edit calls the editor's main command
  88. loop recursively from within a command. Any number of recursive edits
  89. may be stacked up and then unwound back to the top-level of the editor.
  90.    When a recursive edit is in progress the name of the mode being used
  91. to edit the buffer is shown in *square brackets*, not parentheses as in
  92. the top-level instance.
  93.    The commands for manipulating recursive edits are as follows,
  94. `Ctrl-]'
  95. `Ctrl-Meta-c'
  96.      Exit the innermost recursive edit, this has no effect at the
  97.      top-level.
  98. `Meta-x top-level'
  99.      Return to the outermost edit -- the top-level. This is useful when
  100.      you get "lost" inside a sequence of recursive edits.
  101. `Meta-x recursive-edit'
  102.      Enter a new recursive edit; this command is usually best avoided to
  103.      save confusion.
  104.    In general, recursive editing is rarely used except in unavoidable
  105. circumstances (i.e. in the Lisp debugger).
  106. File: jade.info,  Node: Character Images,  Next: Client Editing,  Prev: Recursive Editing,  Up: Using Jade
  107. Character Images
  108. ================
  109.    In general any character can be mapped to any sequence of up to four
  110. character sized images (called glyphs) when it is drawn into a window.
  111. The TAB character is a notable exception; it expands to as many spaces
  112. as are needed to fill up to the next tab stop.
  113.    By default, the editor is set up to display the following,
  114. 0 to 31
  115.      A caret (`^') followed by the ASCII value of the character
  116.      exclusive-or'd with 0x40, i.e. `^@' to `^_'.
  117. 32 to 126
  118.      Printed literally, this includes all "normal" characters and
  119.      punctuation.
  120.      `^?'
  121. 128 to 255
  122.      Represented by the octal escape sequence (i.e. `\200') for that
  123.      character's numeric value.
  124.    If you want to edit files containing characters in the `Latin1'
  125. character set (numerically, from 160 to 255) you can put the following
  126. in your `.jaderc' file,
  127.      (latin-1-mode)
  128. this will redefine the necessary characters.
  129.    If you want more details about this sort of thing see *Note Glyph
  130. Tables::.
  131. File: jade.info,  Node: Client Editing,  Next: Compiling Programs,  Prev: Character Images,  Up: Using Jade
  132. Client Editing
  133. ==============
  134.    Normally you will only have one instance of Jade executing at a
  135. single time. Often though, another program will want you to edit a
  136. file, for example when you are composing a mail message. There is
  137. normally a way to specify which editor you want to use, for example the
  138. `EDITOR' environment variable.
  139.    If you were to ask to edit the file in `jade' an *additional*
  140. process executing Jade would be started, totally separate from the
  141. original. It is possible to use the original instance.
  142.    Firstly Jade must be set up to listen for clients wanting files
  143. edited, this is done with the `server-open' command. You can either put
  144. this in your `.jaderc' file (with a line like `(server-open)') or call
  145. it manually with the command `Meta-x server-open'.
  146.    Only one instance of Jade may be a server at once. If you know that
  147. there is no other Jade running but it still won't let you open a
  148. server, and you are running on Unix, look for a dead socket called
  149. `~/.Jade_rendezvous' and delete it if necessary.
  150.    Once the editor is listening for client messages the separate program
  151. `jadeclient' may be used to load files into the server from an external
  152. source. The format of `jadeclient' invocation is,
  153.      jadeclient [+LINE-NUMBER] FILE-NAME ...
  154. When invoked, it will ask the server to edit each FILE-NAME (initially
  155. positioned at line LINE-NUMBER) in turn, exiting only after each file
  156. has finished being edited.
  157.    If when the `jadeclient' program is invoked their is no server open
  158. (i.e. either Jade is not running or you haven't used the `server-open'
  159. function) a message `Jade not running, waiting...' will be printed and
  160. `jadeclient' will sit waiting for you to open a Jade server.
  161.    So, simpl