Subject: v14i072: Jove, an emacs variant, version 4.9, Part16/21 Newsgroups: comp.sources.unix Sender: sources Approved: rsalz@uunet.UU.NET Submitted-by: Jonathan Payne Posting-number: Volume 14, Issue 72 Archive-name: jove4.9/part16 #! /bin/sh # This is a shell archive. Remove anything before this line, then unpack # it by saving it into a file and typing "sh file". To overwrite existing # files, type "sh file -c". You can also feed this as standard input via # unshar, or by typing "sh './doc/jove.5' <<'END_OF_FILE' X.dc "make-backup-files" "(variable)" If this variable is set, then whenever \s-2JOVE\s0 writes out a file, it will move the previous version of the file (if there was one) to "#filename". This is often convenient if you save a file by accident. The default value of this variable is "off". X.IQ Note: this is an optional part of X\s-2JOVE\s0, and your guru may not have it enabled, so it may not work. X.dc "make-buffer-unmodified" "ESC ~" This makes \s-2JOVE\s0 think the selected buffer hasn't been changed even if it has. Use this when you accidentally change the buffer but don't want it considered changed. Watch the mode line to see the * disappear when you use this command. X.dc "make-macro-interactive" "Not Bound" This command is meaningful only while you are defining a keyboard macro, and when you are in the minibuffer. Ordinarily, when a command in a macro definition requires a trailing text argument (file name, search string, etc.), the argument you supply becomes part of the macro definition. If you want to be able to supply a different argument each time the macro is used, then while you are defining it, you should give the make-macro-interactive command just before typing the argument which will be used during the definition process. Note: you must bind this command to a key in order to use it; you can't say "ESC X make-macro-interactive". X.dc "mark-threshold" "(variable)" This variable contains the number of lines point may move by before the mark is set. If, in a search or something, point moves by more than this many lines, the mark is set so that you may return easily. The default value of this variable is 22 (one screenful, on most terminals). X.dc "marks-should-float" "(variable)" When this variable is "off", the position of a mark is remembered as a line number within the buffer and a character number within the line. If you add or delete text before the mark, it will no longer point to the text you marked originally because that text is no longer at the same line and character number. When this variable is "on", the position of a mark is adjusted to compensate for each insertion and deletion. This makes marks much more sensible to use, at the cost of slowing down insertion and deletion somewhat. The default value is "on". X.dc "match-regular-expressions" "(variable)" When set, \s-2JOVE\s0 will match regular expressions in search patterns. This makes special the characters ., *, [, ], ^, and $, and the two-character sequences \e<, \e>, \e\|{, \e\|} and \e\||. See the X.IQ ed(1) manual page, the tutorial "Advanced Editing in X.UX X", and the section above "Searching with Regular Expressions" for more information. X.dc "meta-key" "(variable)" You should set this variable to "on" if your terminal has a real Meta key. If your terminal has such a key, then a key sequence like ESC Y can be entered by holding down Meta and typing Y. NOTE: This disables interrupting noninteractive shell commands. X.dc "mode-line" "(variable)" The format of the mode line can be determined by setting this variable. The items in the line are specified using a printf(3) format, with the special things being marked as "%x". Digits may be used between the X'%' and the 'x' to mean repeat that many times. X\&'x' may be: X.DS I X.ta .5i 1i 1.5i X C check for new mail, and displays "[New mail]" if there X is any (see also the mail-check-interval and disable-biff X variables) X F the current file name, with leading path stripped X M the current list of major and minor modes X b the current buffer name X c the fill character (-) X d the current directory X e end of string--this must be the last item in the string X f the current file name X l the current load average (updated automatically) X mxy x, when the buffer is modified or y, when not X n the current buffer number X s space, but only if previous character is not a space X t the current time (updated automatically) X [ ] the square brackets printed when in a recursive edit X ( ) items enclosed in %( ... %) will only be printed on X the bottom mode line, rather than copied when the X window is split X.DE In addition, any other character is simply copied into the mode line. Characters may be escaped with a backslash. To get a feel for all this, try typing "ESC X print mode-line" and compare the result with your current mode line. X.dc "mode-line-color" "(variable)" This specifies the color of the modeline (PC version only). Its default value is 0, and in that case it is drawn in reverse video. If it has any other value, this value is used as the attribute in the Bios calls. X.dc "mode-line-should-standout" "(variable)" If set, the mode line will be printed in reverse video, if your terminal supports it. The default for this variable is "off". X.dc "name-kbd-macro" "Not Bound" This copies the keyboard macro and gives it a name freeing up the keyboard macro so you can define some more. Keyboard macros with their own names can be bound to keys just like built in commands can. See the X.IQ define-macro, X.IQ source and X.IQ write-macros-to-file commands. X.dc "newline" "Return" This divides the current line at point moving all the text to the right of point down onto the newly created line. Point moves down to the beginning of the new line. X.dc "newline-and-backup" "C-O" This divides the current line at point moving all the text to the right of point down onto the newly created line. The difference between this and "newline" is that point does not move down to the beginning of the new line. X.dc "newline-and-indent" "LineFeed" This behaves the same was as Return does when in Auto Indent mode. This makes Auto Indent mode obsolete but it remains in the name of backward compatibility. X.dc "next-error" "C-X C-N" This moves to the next error in the list of errors that were parsed with X.IQ parse-errors. In one window the list of errors is shown with the current one always at the top. In another window is the file that contains the error. Point is positioned in this window on the line where the error occurred. X.dc "next-line" "C-N" This moves down to the next line. X.dc "next-page" "C-V" This displays the next page of the buffer by taking the bottom line of the window and redrawing the window with it at the top. If there isn't another page in the buffer \s-2JOVE\s0 rings the bell. If a numeric argument is supplied the screen is scrolled up that many lines; if the argument is negative the screen is scrolled down. X.dc "next-window" "C-X N" This moves into the next window. Windows live in a circular list so when you're in the bottom window and you try to move to the next one you are moved to the top window. It is an error to use this command with only one window. X.dc "number-lines-in-window" "Not Bound" This displays the line numbers for each line in the buffer being displayed. The number isn't actually part of the text; it's just printed before the actual buffer line is. To turn this off you run the command again; it toggles. X.dc "over-write-mode" "Not Bound" This turns Over Write mode on (or off if it's currently on) in the selected buffer. When on, this mode changes the way the self-inserting characters work. Instead of inserting themselves and pushing the rest of the line over to the right, they replace or over-write the existing character. Also, Rubout replaces the character before point with a space instead of deleting it. When Over Write mode is on "OvrWt" is displayed on the mode line. X.dc "page-next-window" "ESC C-V" This displays the next page in the next window. This is exactly the same as "C-X N C-V C-X P". X.dc "paren-flash" ") } ]" This handles the C mode curly brace indentation, the Lisp mode paren indentation, and the Show Match mode paren/curly brace/square bracket flashing. X.dc "paren-flash-delay" "(variable)" How long, in tenths of seconds, \s-2JOVE\s0 should pause on a matching parenthesis in X.IQ Show Match mode. The default is 5. X.dc "parse-errors" "Not Bound" This takes the list of C compilation errors (or output from another program in the same format) in the current buffer and parses them for use with the X.IQ next-error and X.IQ previous-error and X.IQ current-error commands. This is a very useful tool and helps with compiling C programs and when used in conjunction with the "grep" UNIX command very helpful in making changes to a bunch of files. This command understands errors produced by cc, cpp, and lint; plus any other program with the same format (e.g., "grep -n"). X\s-2JOVE\s0 visits each file that has an error and remembers each line that contains an error. It doesn't matter if later you insert or delete some lines in the buffers containing errors; \s-2JOVE\s0 remembers where they are regardless. X.IQ current-error is automatically executed after one of the parse commands, so you end up at the first error. See also X.IQ error-format-string to make it possible to parse errors of a different format. X.dc "parse-spelling-errors-in-buffer" "Not Bound" This parses a list of words in the current buffer and looks them up in another buffer that you specify. This will probably go away soon. X.dc "pause-jove" "ESC S" This stops \s-2JOVE\s0 and returns control to the parent shell. This only works for users using the C-shell, and on systems that have the job control facility. To return to \s-2JOVE\s0 you type "fg" to the C-shell. X.dc "physical-tabstop" "(variable)" How many spaces your terminal prints when it prints a tab character. X.dc "pop-mark" "Not Bound" This gets executed when you run X.IQ set-mark with a numeric argument. X\s-2JOVE\s0 remembers the last 16 marks and you use X.IQ pop-mark to go backward through the ring of marks. If you execute X.IQ pop-mark enough times you will eventually get back to where you started. X.dc "popd" "Not Bound" This pops one entry off the directory stack. Entries are pushed with the X.IQ pushd command. The names were stolen from the C-shell and the behavior is the same. X.dc "previous-error" "C-X C-P" This is the same as X.IQ next-error except it goes to the previous error. See X.IQ next-error for documentation. X.dc "previous-line" "C-P" This moves up to the previous line. X.dc "previous-page" "ESC V" This displays the previous page of the current buffer by taking the top line and redrawing the window with it at the bottom. If a numeric argument is supplied the screen is scrolled down that many lines; if the argument is negative the screen is scrolled up. X.dc "previous-window" "C-X P and C-X O" This moves into the next window. Windows live in a circular list so when you're in the top window and you try to move to the previous one you are moved to the bottom window. It is an error to use this command with only one window. X.dc "print" "Not Bound" This prints the value of a \s-2JOVE\s0 variable. X.dc "process-bind-to-key" "Not Bound" This command is identical to bind-to-key, except that it only affects your bindings when you are in a buffer attached to a process. When you enter the process buffer, any keys bound with this command will automatically take their new values. When you switch to a non-process buffer, the old bindings for those keys will be restored. For example, you might want to execute X.DS I process-bind-to-key stop-process ^Z process-bind-to-key interrupt-process ^C X.DE Then, when you start up an interactive process and switch into that buffer, C-Z will execute stop-process and C-C will execute interrupt- process. When you switch back to a non-process buffer, C-Z will go back to executing scroll-up (or whatever you have it bound to). X.dc "process-newline" "Return" This this only gets executed when in a buffer that is attached to an interactive-process. \s-2JOVE\s0 does two different things depending on where you are when you hit Return. When you're at the end of the I-Process buffer this does what Return normally does, except it also makes the line available to the process. When point is positioned at some other position that line is copied to the end of the buffer (with the prompt stripped) and point is moved there with it, so you can then edit that line before sending it to the process. This command X.IQ must be bound to the key you usually use to enter shell commands (Return), or else you won't be able to enter any. X.dc "process-prompt" (variable) What a prompt looks like from the shell and i-shell-command processes. The default is "% ", the default C-shell prompt. This is actually a regular expression search string. So you can set it to be more than one thing at once using the \\| operator. For instance, for LISP hackers, the prompt can be X.DS X"% \\|-> \\|<[0-9]>: ". X.DE X.dc "process-send-data-no-return" "Not Bound" This is like X.IQ process-newline except it sends everything to the process without the newline. Normally, when you type return in a process buffer it sends everything you typed including the Return. This command just provides a way to send data to the process without having to send a newline as well. X.dc "push-shell" "Not Bound" This spawns a child shell and relinquishes control to it. This works on any version of UNIX, but this isn't as good as X.IQ pause-jove because it takes time to start up the new shell and you get a brand new environment every time. To return to \s-2JOVE\s0 you type "C-D". X.dc "pushd" "Not Bound" This pushes a directory onto the directory stack and cd's into it. It asks for the directory name but if you don't specify one it switches the top two entries no the stack. It purposely behaves the same as C-shell's X.IQ pushd. X.dc "pwd" "Not Bound" This prints the working directory. X.dc "query-replace-string" "ESC Q" This replaces the occurrences of a specified string with a specified replacement string. When an occurrence is found point is moved to it and then \s-2JOVE\s0 asks what to do. The options are: X.DS I X.ta \w'Rubout111'u Space to replace this occurrence and go on to the next one. Period to replace this occurrence and then stop. Rubout to skip this occurrence and go on to the next one. C-R to enter a recursive edit. This lets you temporarily X suspend the replace, do some editing, and then return X to continue where you left off. To continue with the X Query Replace type "C-X C-C" as if you were trying to X exit \s-2JOVE\s0. Normally you would but when you are in a X recursive edit all it does is exit that recursive X editing level. C-W to delete the matched string and then enter a recursive X edit. U to undo the last replacement. P or ! to go ahead and replace the remaining occurrences without X asking. Return to stop the Query Replace. X.DE The search for occurrences starts at point and goes to the end of the buffer, so to replace in the entire buffer you must first go to the beginning. X.dc "quit-process" "Not Bound" This is the same as typing "C-\\" (the Quit character) to a normal UNIX process, except it sends it to the current process in \s-2JOVE\s0. This is only for versions of \s-2JOVE\s0 that have the interactive processes feature. This only works when you are inside a buffer that's attached to a process. X.dc "quoted-insert" "C-Q" This lets you insert characters that normally would be executed as other \s-2JOVE\s0 commands. For example, to insert "C-F" you type "C-Q C-F". X.dc "read-word-abbrev-file" "Not Bound" This reads a specified file that contains a bunch of abbreviation definitions, and makes those abbreviations available. If the selected buffer is not already in Word Abbrev mode this command puts it in that mode. X.dc "recursive-edit" "Not Bound" This enters a recursive editing level. This isn't really very useful. I don't know why it's available for public use. I think I'll delete it some day. X.dc "redraw-display" "C-L" This centers the line containing point in the window. If that line is already in the middle the window is first cleared and then redrawn. If a numeric argument is supplied, the line is positioned at that offset from the top of the window. For example, "ESC 0 C-L" positions the line containing point at the top of the window. X.dc "rename-buffer" "Not Bound" This lets you rename the current buffer. X.dc "replace-in-region" "Not Bound" This is the same as X.IQ replace-string except that it is restricted to occurrences between Point and Mark. X.dc "replace-string" "ESC R" This replaces all occurrences of a specified string with a specified replacement string. This is just like X.IQ query-replace-string except it replaces without asking. X.dc "right-margin" "(variable)" Where the right margin is for X.IQ "Auto Fill" mode and the X.IQ justify-paragraph and X.IQ justify-region commands. The default is 78. X.dc "right-margin-here" "Not Bound" This sets the X.IQ right-margin variable to the current position of point. This is an easy way to say, "Make the right margin begin here," without having to count the number of spaces over it actually is. X.dc "save-file" "C-X C-S" This saves the current buffer to the associated file. This makes your changes permanent so you should be sure you really want to. If the buffer has not been modified X.IQ save-file refuses to do the save. If you really do want to write the file you can use "C-X C-W" which executes X.IQ write-file. X.dc "scroll-all-lines" "(variable)" When this is turned on, the entire window will be scrolled left or right when the current line scrolls. The default value is OFF, which will cause \s-2JOVE\s0 to behave in the familiar way, namely to scroll only the current line. X.dc "scroll-down" "ESC Z" This scrolls the screen one line down. If the line containing point moves past the bottom of the window point is moved up to the center of the window. If a numeric argument is supplied that many lines are scrolled; if the argument is negative the screen is scrolled up instead. X.dc "scroll-left" "Not Bound" This scrolls the text in the current window 10 character positions to the left. If a numeric argument is specified then the text is scrolled that number of character positions. If the variable X.IQ scroll-all-lines is ON then X.IQ scroll-left may actually do nothing if the scrolling would cause Point not to be visible. X.dc "scroll-next-page" "Not Bound" This continuously scrolls up screen-full lines (PC version only). X.dc "scroll-previous-page" "Not Bound" This continuously scrolls down screen-full lines (PC version only). X.dc "scroll-right" "Not Bound" This scrolls the text in the current window 10 character positions to the right. If a numeric argument is specified then the text is scrolled that number of character positions. If the variable X.IQ scroll-all-lines is ON then X.IQ scroll-right may actually do nothing if the scrolling would cause Point not to be visible. X.dc "scroll-step" "(variable)" How many lines should be scrolled if the X.IQ previous-line or X.IQ next-line commands move you off the top or bottom of the screen. You may wish to decrease this variable if you are on a slow terminal. The default value is 0, which means to center the current line in the window. If the value is negative, the behavior is slightly different. If you move off the top of the window, and X.IQ scroll-step is, say, -5 then the new line will be displayed 5 lines from the bottom of the window. If you move off the bottom of the window, the new line will be positioned 5 lines from the top of the window. X.dc "scroll-up" "C-Z" This scrolls the screen one line up. If the line containing point moves past the top of the window point is moved down to the center of the window. If a numeric argument is supplied that many lines are scrolled; if the argument is negative the screen is scrolled down instead. X.dc "search-exit-char" "(variable)" Set this to the character you want to use to exit incremental search. The default is Newline, which makes i-search compatible with normal string search. X.dc "search-forward" "C-S" This searches forward for a specified search string and positions point at the end of the string if it's found. If the string is not found point remains unchanged. This searches from point to the end of the buffer, so any matches before point will be missed. X.dc "search-forward-nd" "Not Bound" This is just like X.IQ search-forward except that it doesn't assume a default search string, and it doesn't set the default search string. This is useful for defining macros, when you want to search for something, but you don't want it to affect the current default search string. X.dc "search-reverse" "C-R" This searches backward for a specified search string and positions point at the beginning if the string if it's found. If the string is not found point remains unchanged. This searches from point to the beginning of the buffer, so any matches after point will be missed. X.dc "search-reverse-nd" "Not Bound" This is just like X.IQ search-reverse except that it doesn't assume a default search string, and it doesn't set the default search string. This is useful for defining macros, when you want to search for something, but you don't want it to affect the current default search string. X.dc "select-buffer" "C-X B" This selects a new or already existing buffer making it the current one. You can type either the buffer name or number. If you type in the name you need only type the name until it is unambiguous, at which point typing Escape or Space will complete it for you. If you want to create a new buffer you can type Return instead of Space, and a new empty buffer will be created. X.dc "select-buffer-1" "-1" This selects buffer number 1, if it exists (PC version only). X.dc "select-buffer-2" "-2" This selects buffer number 2, if it exists (PC version only). X.dc "select-buffer-3" "-3" This selects buffer number 3, if it exists (PC version only). X.dc "select-buffer-4" "-4" This selects buffer number 4, if it exists (PC version only). X.dc "select-buffer-5" "-5" This selects buffer number 5, if it exists (PC version only). X.dc "select-buffer-6" "-6" This selects buffer number 6, if it exists (PC version only). X.dc "select-buffer-7" "-7" This selects buffer number 7, if it exists (PC version only). X.dc "select-buffer-8" "-8" This selects buffer number 8, if it exists (PC version only). X.dc "select-buffer-9" "-9" This selects buffer number 9, if it exists (PC version only). X.dc "self-insert" "Most Printing Characters" This inserts the character that invoked it into the buffer at point. Initially all but a few of the printing characters are bound to X.IQ self-insert. X.dc "send-typeout-to-buffer" "(variable)" When this is set \s-2JOVE\s0 will send output that normally overwrites the screen (temporarily) to a buffer instead. This affects commands like X.IQ list-buffers, X.IQ list-processes, and commands that use completion. The default value is "off". X.dc "set" "Not Bound" This gives a specified variable a new value. Occasionally you'll see lines like "set this variable to that value to do this". Well, you use the X.IQ set command to do that. X.dc "set-mark" "C-@" This sets the mark at the current position in the buffer. It prints the message "Point pushed" on the message line. It says that instead of "Mark set" because when you set the mark the previous mark is still remembered on a ring of 16 marks. So "Point pushed" means point is pushed onto the ring of marks and becomes the value of "the mark". To go through the ring of marks you type "C-U C-@", or execute the X.IQ pop-mark command. If you type this enough times you will get back to where you started. X.dc "shell" "(variable)" The shell to be used with all the shell commands command. If your SHELL environment variable is set, it is used as the value of X.IQ shell; otherwise "/bin/csh" is the default. X.dc "shell" "Not Bound" This starts up an interactive shell in a window. \s-2JOVE\s0 uses X"*shell*" as the name of the buffer in which the interacting takes place. See the manual for information on how to use interactive processes. X.dc "shell-command" "C-X !" This runs a UNIX command and places the output from that command in a buffer. \s-2JOVE\s0 creates a buffer that matches the name of the command you specify and then attaches that buffer to a window. So, when you have only one window running this command will cause \s-2JOVE\s0 to split the window and attach the new buffer to that window. Otherwise, \s-2JOVE\s0 finds the most convenient of the available windows and uses that one instead. If the buffer already exists it is first emptied, except that if it's holding a file, not some output from a previous command, \s-2JOVE\s0 prints an error message and refuses to execute the command. If you really want to execute the command you should delete that buffer X(saving it first, if you like) or use X.IQ shell-command-to-buffer, and try again. X.dc "shell-command-no-buffer" "Not Bound" This is just like X.IQ shell-command except it just runs the command without saving the output to any buffer. It will report the success of the command in the usual way. X.dc "shell-command-to-buffer" "Not Bound" This is just like X.IQ shell-command except it lets you specify the buffer to use instead of \s-2JOVE\s0. X.dc "shell-command-with-typeout" "Not Bound" This is just like X.IQ shell-command except that instead of saving the output to a buffer, and displaying it in a window, this just types out the output in the same way that X.IQ list-buffers does. Actually, how this behaves depends on the value of the variable X.IQ send-typeout-to-buffer. If it is on then shell-command-with-typeout will behave just like X.IQ shell-command. X.dc "shell-flags" "(variable)" This defines the flags that are passed to shell commands. The default is X"-c". See the X.IQ shell variable to change the default shell. X.dc "show-match-mode" "Not Bound" This turns on Show Match mode (or off if it's currently on) in the selected buffer. This changes "}" and ")" so that when they are typed the are inserted as usual, and then the cursor flashes back to the matching "{" or "(" (depending on what was typed) for about half a second, and then goes back to just after the "}" or ")" that invoked the command. This is useful for typing in complicated expressions in a program. You can change how long the cursor sits on the matching paren by setting the "paren-flash-delay" variable in tenths of a second. If the matching "{" or "(" isn't visible nothing happens. X.dc "shrink-window" "Not Bound" This makes the current window one line shorter, if possible. Windows must be at least 2 lines high, one for the text and the other for the mode line. X.dc "source" "Not Bound" This reads a bunch of \s-2JOVE\s0 commands from a file. The format of the file is the same as that in your initialization file (your ".joverc") in your main directory. There should be one command per line and it should be as though you typed "ESC X" while in \s-2JOVE\s0. For example, here's part of my initialization file: X.DS I bind-to-key i-search-reverse ^R bind-to-key i-search-forward ^S bind-to-key pause-jove ^[S X.DE What they do is make "C-R" call the X.IQ i-search-reverse command and X"C-S" call X.IQ i-search-forward and "ESC S" call X.IQ pause-jove. X.dc "spell-buffer" "Not Bound" This runs the current buffer through the UNIX X.IQ spell program and places the output in buffer "Spell". Then \s-2JOVE\s0 lets you edit the list of words, expecting you to delete the ones that you don't care about, i.e., the ones you know are spelled correctly. Then the X.IQ parse-spelling-errors-in-buffer command comes along and finds all the misspelled words and sets things up so the error commands work. X.dc "split-current-window" "C-X 2" This splits the current window into two equal parts (providing the resulting windows would be big enough) and displays the selected buffer in both windows. Use "C-X 1" to go back to 1 window mode. If a numeric argument is supplied, the window is split "evenly" that many times (when possible). X.dc "start-remembering" "C-X (" This is just another name for the X.IQ begin-kbd-macro name. It is included for backward compatibility. X.dc "stop-remembering" "C-X )" This is just another name for the X.IQ end-kbd-macro command. It is included for backward compatibility. X.dc "stop-process" "Not Bound" This sends a stop signal (C-Z, for most people) to the current process. It only works if you have the interactive process feature, and you are in a buffer attached to a process. X.dc "string-length" "Not Bound" This prints the number of characters in the string that point sits in. Strings are surrounded by double quotes. \s-2JOVE\s0 knows that "\\007" is considered a single character, namely "C-G", and also knows about other common ones, like "\\r" (Return) and "\\n" (LineFeed). This is mostly useful only for C programmers. X.dc "suspend-jove" "ESC S" This is a synonym for X.IQ pause-jove. X.dc "sync-frequency" "(variable)" The temporary files used by \s-2JOVE\s0 are forced out to disk every X.IQ sync-frequency modifications. The default is 50, which really makes good sense. Unless your system is very unstable, you probably shouldn't fool with this. X.dc "tag-file" "(variable)" This the name of the file in which \s-2JOVE\s0 should look up tag definitions. The default value is "./tags". X.dc "text-mode" "Not Bound" This sets the major mode to Text. Currently the other modes are Fundamental, C and Lisp mode. X.dc "tmp-file-pathname" "(variable)" This tells JOVE where to put the tmp files, which is where JOVE stores buffers internally. The default is usually in /tmp, but if you want to store them somewhere else, you can set this variable. If your system crashes a lot it might be a good idea to set this variable to somewhere other than /tmp because the system removes all the files in /tmp upon reboot, and so you would not be able to recover editor buffers using the X"jove -r" command. X NOTE: In order for this to work correctly you must set this variable BEFORE JOVE creates the tmp file. You can set this in your .joverc (the closer to tbe beginning the better), or as soon as you start up JOVE before you visit any files. X.dc "transpose-characters" "C-T" This switches the character before point with the one after point, and then moves forward one. This doesn't work at the beginning of the line, and at the end of the line it switches the two characters before point. Since point is moved forward, so that the character that was before point is still before point, you can use "C-T" to drag a character down the length of a line. This command pretty quickly becomes very useful. X.dc "transpose-lines" "C-X C-T" This switches the current line with the one above it, and then moves down one so that the line that was above point is still above point. This, like X.IQ transpose-characters, can be used to drag a line down a page. X.dc "unbind-key" "Not Bound" Use this to unbind X.IQ any key sequence. You can use this to unbind even a prefix command, since this command does not use "key-map completion". For example, "ESC X unbind-key ESC [" unbinds the sequence "ESC [". This is useful for "turning off" something set in the system-wide ".joverc" file. X.dc "update-time-frequency" "(variable)" How often the mode line is updated (and thus the time and load average, if you display them). The default is 30 seconds. X.dc "use-i/d-char" "(variable)" If your terminal has insert/delete character capability you can tell \s-2JOVE\s0 not to use it by setting this to "off". In my opinion it is only worth using insert/delete character at low baud rates. WARNING: if you set this to X"on" when your terminal doesn't have insert/delete character capability, you will get weird (perhaps fatal) results. X.dc "version" "Not Bound" Displays the version number of this \s-2JOVE\s0. X.dc "visible-bell" "(variable)" Use the terminal's visible bell instead of beeping. This is set automatically if your terminal has the capability. X.dc "visible-spaces-in-window" "Not Bound" This displays an underscore character instead of each space in the window and displays a greater-than followed by spaces for each tab in the window. The actual text in the buffer is not changed; only the screen display is affected. To turn this off you run the command again; it toggles. X.dc "visit-file" "C-X C-V" This reads a specified file into the current buffer replacing the old text. If the buffer needs saving \s-2JOVE\s0 will offer to save it for you. Sometimes you use this to start over, say if you make lots of changes and then change your mind. If that's the case you don't want \s-2JOVE\s0 to save your buffer and you answer "NO" to the question. X.dc "window-find" "C-X 4" This lets you select another buffer in another window three different ways. This waits for another character which can be one of the following: X.DS I X.ta .5i 1i 1.5i T Finds a tag in the other window. F Finds a file in the other window. B Selects a buffer in the other window. X.DE This is just a convenient short hand for "C-X 2" (or "C-X O" if there are already two windows) followed by the appropriate sequence for invoking each command. With this, though, there isn't the extra overhead of having to redisplay. In addition, you don't have to decide whether to type "C-X 2" or X"C-X O" since "C-X 4" does the right thing. X.dc "word-abbrev-mode" "Not Bound" This turns on Word Abbrev mode (or off if it's currently on) in the selected buffer. Word Abbrev mode lets you specify a word (an abbreviation) and a phrase with which \s-2JOVE\s0 should substitute the abbreviation. You can use this to define words to expand into long phrases, e.g., "jove" can expand into "Jonathan's Own Version of Emacs"; another common use is defining words that you often misspell in the same way, e.g., "thier" => "their" or "teh" => "the". See the information on the X.IQ auto-case-abbrev variable. X.sp 1 There are two kinds of abbreviations: mode specific and global. If you define a Mode specific abbreviation in C mode, it will expand only in buffers that are in C mode. This is so you can have the same abbreviation expand to different things depending on your context. Global abbreviations expand regardless of the major mode of the buffer. The way it works is this: \s-2JOVE\s0 looks first in the mode specific table, and then in the global table. Whichever it finds it in first is the one that's used in the expansion. If it doesn't find the word it is left untouched. \s-2JOVE\s0 tries to expand words as they are typed, when you type a punctuation character or Space or Return. If you are in Auto Fill mode the expansion will be filled as if you typed it yourself. X.dc "wrap-search" "(variable)" If set, searches will "wrap around" the ends of the buffer instead of stopping at the bottom or top. The default is "off". X.dc "write-file" "C-X C-W" This saves the current buffer to a specified file, and then makes that file the default file name for this buffer. If you specify a file that already exists you are asked to confirm over-writing it. X.dc "write-files-on-make" "(variable)" When set, all modified files will be written out before calling make when the X.IQ compile-it command is executed. The default is "on". X.dc "write-macros-to-file" "Not Bound" This writes the currently defined macros to a specified file in a format appropriate for reading them back in with the X.IQ source command. The purpose of this command is to allow you to define macros once and use them in other instances of JOVE. X.dc "write-modified-files" "C-X C-M" This saves all the buffers that need saving. If you supply a numeric argument it asks for each buffer whether you really want to save it. X.dc "write-region" "Not Bound" This writes the text in the region to a specified file. If the file already exists you are asked to confirm over-writing it. X.dc "write-word-abbrev-file" "Not Bound" This writes the currently defined abbreviations to a specified file. They can be read back in and automatically defined with X.IQ read-word-abbrev-file. X.dc "yank" "C-Y" This undoes the last kill command. That is, it inserts the killed text at point. When you do multiple kill commands in a row, they are merged so that yanking them back with "C\-Y" yanks back all of them. X.dc "yank-pop" "ESC Y" This yanks back previous killed text. \s-2JOVE\s0 has a kill ring on which the last 10 kills are stored. X.IQ yank yanks a copy of the text at the front of the ring. If you want one of the last ten kills you use "ESC Y" which rotates the ring so another different entry is now at the front. You can use "ESC Y" only immediately following a "C-Y" or another "ESC Y". If you supply a negative numeric argument the ring is rotated the other way. If you use this command enough times in a row you will eventually get back to where you started. Experiment with this. It's extremely useful. END_OF_FILE if test 36685 -ne `wc -c <'./doc/jove.5'`; then echo shar: \"'./doc/jove.5'\" unpacked with wrong size! fi # end of './doc/jove.5' fi echo shar: End of archive 16 \(of 21\). cp /dev/null ark16isdone MISSING="" for I in 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 ; do if test ! -f ark${I}isdone ; then MISSING="${MISSING} ${I}" fi done if test "${MISSING}" = "" ; then echo You have unpacked all 21 archives. rm -f ark[1-9]isdone ark[1-9][0-9]isdone else echo You still need to unpack the following archives: echo " " ${MISSING} fi ## End of shell archive. exit 0