diff options
Diffstat (limited to 'editors/mg2a/patches/patch-ak')
-rw-r--r-- | editors/mg2a/patches/patch-ak | 1067 |
1 files changed, 0 insertions, 1067 deletions
diff --git a/editors/mg2a/patches/patch-ak b/editors/mg2a/patches/patch-ak deleted file mode 100644 index a78f76c6e99..00000000000 --- a/editors/mg2a/patches/patch-ak +++ /dev/null @@ -1,1067 +0,0 @@ -$NetBSD: patch-ak,v 1.2 2000/07/10 18:26:54 tron Exp $ - ---- mg.1.orig Wed May 31 16:36:35 2000 -+++ mg.1 Wed May 31 16:36:35 2000 -@@ -0,0 +1,1062 @@ -+.Dd January 28, 2000 -+.Dt MG 1 -+.Os -+.Sh NAME -+.Nm mg -+.Nd an emacs clone (formerly named MicroGnuEmacs) -+.Sh SYNOPSIS -+.Nm -+.Op Ar file ... -+.Sh DESCRIPTION -+MG is a small, fast, and portable Emacs-style text editor intended to -+be used by people who can't run a real Emacs for one reason or another. -+.Pp -+We've made MG compatible with GNU Emacs because that is the big, -+full-featured editor that many use regularly and are most -+familiar with. -+.Pp -+MG runs on many different kinds of hardware under many different -+operating systems. A small and fast version compiled for MSDOS -+is available at ftp://ftp.cdrom.com/pub/simtelnet/msdos/editor/mg2a_exe.zip. -+.Sh Notation and Conventions -+To type a control character, use the control key on your -+keyboard like a shift key: hold down the control key while typing the -+character. We will indicate control characters as: -+C-x ie, type the character x while holding down the control key. -+.Pp -+Some keyboards also have a meta key that works like the control -+key. You can also use the escape key as a meta -+prefix; first type the escape, and then the character. Meta -+characters will be indicated as M-x. -+.Pp -+Besides the meta prefix, two other characters are used as prefixes: -+C-x and C-h. A few keys have special notation: SPC is -+the space character, DEL is the delete or rubout character, RET -+is carriage return, and ESC is the escape character. NUL is -+the null character (ASCII 0), which is usually equivalent to either -+C-SPC or C-@. -+.Pp -+Uppercase and lowercase characters are generally equivalent in command -+keystrokes. -+.Pp -+When you run MG from a shell, command line arguments are interpreted as the -+names of files you want to visit, or edit. Each file is -+read into a buffer in memory. No changes are actually made to -+the file until you ask it to be written out to disk. -+.Pp -+Within MG, the large top part of the screen serves as a window into -+the buffer being edited. Below this is the mode line, which -+displays the name of the buffer. Finally, at the very bottom of the screen, -+there is a one-line minibuffer which is used for displaying -+messages and answering questions. -+.Pp -+MG keeps track of two pointers into each window, the point and the -+mark. The cursor appears at the point in the current -+window, and we often speak of moving the cursor rather than of moving the -+point. The text between the point and the mark is referred to as the -+region. -+.Pp -+Some commands deal with words and paragraphs. -+Generally, whitespace and punctuation separate words. Lines that are -+empty or that contain only spaces or tabs separate paragraphs without -+being part of a paragraph. A non-empty line that starts with a space -+or tab also begins a new paragraph. -+.Pp -+A number of commands are defined as toggles. If no prefix argument -+is supplied, these commands toggle an action. The action is turned on if a -+negative or zero argument is supplied, and turned on if a positive argument -+is supplied. -+.Sh Frequently used commands -+.Pp -+C-p move the cursor to the previous line -+.Pp -+C-n move the cursor to the next line -+.Pp -+C-b move the cursor backwards -+.Pp -+C-f move the cursor forwards -+.Pp -+C-v scroll forwards one screenful -+.Pp -+M-v scroll backwards one screenful -+.Pp -+M-< go to the beginning of the buffer -+.Pp -+M-> go to the end of the buffer -+.Pp -+C-a go to the beginning of the line -+.Pp -+C-e go to the end of the line -+.Pp -+DEL delete the previous character -+.Pp -+C-k kill (delete) to the end of line -+.Pp -+C-y reinsert killed text. -+.Pp -+C-x C-c exit MG -+.Pp -+C-x C-s save the current buffer -+.Sh Command Arguments -+MG prompts for command arguments in the minibuffer. Within the minibuffer, -+the following characters can be used for editing: -+.Pp -+DEL or C-h erase the last character. -+.Pp -+C-x or C-u erase the entire input line. -+.Pp -+C-w erase to the beginning of the previous word. -+.Pp -+C-q or \\ quote the next character typed. -+.Pp -+RET signifies that you have completed typing in the argument. -+.Pp -+C-g abort the command in progress. -+.Sh Prefix Arguments -+All commands accept an optional numeric prefix argument. This is -+often interpreted as a repetition count. For example, the function -+next-line, if given a prefix argument, will move the cursor -+forward that many lines; without an argument, it will move the cursor -+forward one line. A few commands behave differently if given a prefix -+argument than they do without one, and others ignore the prefix -+argument entirely. -+.Bl -tag -width indent -+.It digit-argument, M-# & negative-argument, M-- -+One way to specify a command argument is to use the escape key -+as a meta prefix, and then type one or more digits. A dash may be -+used for a negative argument (# = 0,1,2,3,4,5,6,7,8,9). -+.It universal-argument, C-u -+Another way to specify a command prefix is to type C-u. -+Typing one C-u is equivalent to a prefix argument of 4, typing -+two gives a value of 16, and so on. In addition, you can type digits -+following C-u to form a numeric prefix argument. -+.Sh Aborting -+.It keyboard-quit, C-g -+Typing C-g cancels any command. It is particularly useful -+for cancelling a command when MG is prompting for input in the minibuffer. -+.Sh Extended commands -+.It execute-extended-command, M-x -+Commands that are not bound to keys can be executed through -+execute-extended-command. If a prefix argument is supplied, it -+is passed to the command being executed. -+.Sh Moving the cursor -+.It backward-char, C-b -+Moves the cursor backward (left) one character. If the cursor -+is at the left margin, it will be moved to the end of the previous line. -+.It backward-paragraph, M-[ -+Moves the cursor backwards to the beginning of the current -+paragraph, or to the beginning of the previous paragraph if the cursor -+is already at the beginning of a paragraph. -+.It backward-word, M-b -+Moves the cursor backwards to the beginning of the current word, -+or to the beginning of the previous word if the cursor is already at -+the beginning of a word. -+.It beginning-of-buffer, M-< -+Moves the cursor backwards to the beginning of the buffer. -+.It beginning-of-line, C-a -+Moves the cursor backwards to the beginning of the current -+line. This command has no effect if the cursor is already at the beginning -+of the line. -+.It end-of-buffer, M-> -+Moves the cursor forwards to the end of the buffer. -+.It end-of-line, C-e -+Moves the cursor forwards to the end of the current line. This -+command has no effect if the cursor is already at the end of the line. -+.It exchange-point-and-mark, C-x C-x -+Set the mark at the current cursor position, and move the cursor -+to the old location of the mark. -+.It forward-char, C-f -+Moves the cursor forwards one character. If the cursor is at the -+end of a line, it will be moved to the first character on the next line. -+.It forward-paragraph, M-] -+Moves the cursor forwards to the next paragraph delimiter. -+.It forward-word, M-f -+Moves the cursor forwards to the end of the current word, or to -+the end of the next word if the cursor is already at the end of a word. -+.It goto-line -+Moves the cursor to the beginning of line the line number in -+the buffer. -+.It next-line, C-n -+Moves the cursor down one line. The cursor remains in the same -+column unless it would be past the end of the line, in which case it is -+moved to the end of the line. At the end of the buffer, C-n will -+create new lines. -+.It previous-line, C-p -+Moves the cursor up one line. The cursor remains in the same -+column unless it would be past the end of the line, in which case it is -+moved to the end of the line. -+.It recenter, C-l -+Redraws the entire screen, scrolling the current window if necessary -+so that the cursor is near the center. With a positive prefix argument -+n, the window is scrolled so that the cursor is n lines -+from the top. A negative prefix argument puts the cursor that many lines -+from the bottom of the window. -+.It redraw-display -+Redraws the entire screen, but never scrolls. -+.It scroll-down, M-v -+Scrolls the display down (moving backward through the -+buffer). Without -+an argument, it scrolls slightly less than one windowful. A prefix argument -+scrolls that many lines. -+.It scroll-one-line-down & scroll-one-line-up -+These functions are similar to scroll-down and scroll-up, but when -+invoked without an argument, cause the display -+to scroll by one line only. These functions are enabled by defining the -+compile-time option GOSMACS. -+.It scroll-other-window, M-C-v -+Scrolls the other window forward as for scroll-up. -+.It scroll-up, C-v -+Scrolls the display up (moving forward through the buffer). Without an -+an argument, it scrolls slightly less than one windowful. A prefix argument -+scrolls that many lines. -+.It set-mark-command -+Set the mark at the current cursor position. -+.It what-cursor-position, C-x = -+Prints some information in the minibuffer about where the cursor is. -+.Sh Text Insertion Commands -+The usual way to insert text into a buffer is simply to type the -+characters. The default binding for all of the printing characters -+self-insert-command causes them to be inserted literally at -+the cursor position. -+.It insert -+Insert typed string into the current buffer at the cursor position. -+.It newline, RET -+Insert a line break into the current buffer at the cursor position, -+moving the cursor forward to the beginning of the new line. -+.It newline-and-indent, C-j -+Insert a line break into the current buffer at the cursor position, -+then add extra whitespace so that the cursor is aligned in the same -+column as the first non-whitespace character in the previous line. -+.It open-line, C-o -+Inserts a line break into the current buffer at the current position, -+but does not move the cursor forward. -+.It quoted-insert, C-q -+This command acts as a prefix to -+cancel the normal interpretation of the next keystroke. If C-q -+is followed by one to three octal digits, it is interpreted as the -+code of the character to insert. Otherwise a single key is read and -+the character typed is inserted into the buffer instead of interpreted -+as a command. This is used for inserting literal control characters -+into a buffer. -+.It self-insert-command -+This is the default binding for keys representing printable -+characters. The character is inserted into the buffer at the cursor -+position, and the cursor moved forward. -+.Sh Killing, Deleting, and Moving Text -+When text is deleted, it is erased completely. Killing text, on the -+other hand, moves it into a temporary storage area called the kill -+buffer. The saved text in the kill buffer is erased when another -+block of text is killed. Until then, however, you can retrieve text -+from the kill buffer. This can be used to move or copy blocks of -+text, as well as to restore accidentally killed text. -+.It backward-kill-word, M-DEL -+Kill the text backwards from the cursor position to the beginning -+of the current word. Typing M-DEL several times in succession -+prepends each killed word to the kill buffer. -+.It copy-region-as-kill, M-w -+Copies the text in the region into the kill buffer, without removing -+it from the current buffer. -+.It delete-backward-char, DEL -+Deletes the character to the left of the cursor. -+.It delete-blank-lines, C-x C-o -+Deletes all blank lines after the current line, and if the current -+line is blank, deletes it and all blank lines preceeding it as well. -+.It delete-char, C-d -+Deletes the character underneath the cursor. -+.It delete-horizontal-space, M-backslash -+Deletes all spaces and tabs on either side of the cursor. -+.It just-one-space, M-SPC -+This is like delete-horizontal-space, except it leaves a single -+space at the cursor position. -+.It kill-line, C-k -+If no prefix argument is specified, this function kills text up -+to the next newline; or if the cursor is at the end of a line, the newline -+is killed. A prefix argument specifies how many lines to kill. Typing -+C-k several times in succession appends each line to the kill buffer. -+.It kill-paragraph -+This command kills the entire paragraph containing the cursor. -+If the cursor is positioned between paragraphs, the next paragraph is killed. -+.It kill-region, C-w -+The region (all text between point and mark) is killed. -+.It kill-word, M-d -+Text is killed forward from the cursor position to the next -+end of word. If the cursor is at the end of the word, then the next -+word is killed. Typing M-d several times appends the killed -+text to the kill buffer. -+.It yank, C-y -+Text is copied from the kill buffer into the current buffer at -+the cursor position. The cursor is moved to the end of the inserted -+text. -+.Sh Searching and Replacing -+The ordinary search command in MG differs from that in many other editors -+in that it is incremental: it begins searching as soon as you begin -+typing the search string, instead of waiting for you to type the entire -+string. All of the search commands described in this section are -+case-insensitive. -+.It isearch-backward, C-r & isearch-forward, C-s -+These commands perform an incremental search backward and -+forward, respectively, for a typed pattern. MG will move the cursor -+to the place in the buffer that matches as much of the pattern as you -+have typed so far, as each character is entered. -+.Pp -+Within the incremental search, the following characters are interpreted -+specially: -+.Pp -+\ DEL Erase the last character in the search string. -+.Pp -+\ ESC Stop searching; exit from incremental search -+mode, leaving the cursor where the search brought it. -+.Pp -+\ C-g If a match has been found, exits from -+incremental search but leaves the cursor in its original position. If -+the search has failed, this will just erase the characters which have -+not been found from the end of the search pattern. In this case, you -+must type C-g again to abort the search. -+.Pp -+\ C-s Search forward for the next occurrence of the -+same pattern. -+.Pp -+\ C-r Search backward for the previous occurrence of -+the same pattern. -+.Pp -+\ C-q Quotes the next character typed, forcing it -+to be interpreted as a literal character in the search pattern. -+.Pp -+In addition, normal commands such as C-a that do not have special -+meanings within incremental search cause the search to be terminated, and -+then are executed in the ordinary way. -+.It search-again & search-backward, M-r & search-forward, M-s -+These commands perform ordinary, non-incremental searches. -+Search-again uses the same pattern and direction as the previous -+search. -+.Sh Replacing -+.It query-replace, M-% -+The primary replace command in MG is an interactive query replace. -+MG searches forward for occurrences of pattern, and asks you what -+to do about each one. The choices are: -+.Pp -+SPC Replace this match with replacement, -+and go on to the next. -+.Pp -+DEL Skip to the next match without replacing this one. -+.Pp -+\ . Replace this match, and then quit. -+.Pp -+! Replace all remaining occurrences without asking again. -+.Pp -+ESC Quit. -+.Pp -+By default, query-replace adjusts the case of lower-case letters -+in the replacement string to match that of the -+particular occurrence of the pattern; for example, replacing Foo -+with bar results in Bar. Upper case letters in the replacement -+string are always left uppercase. In addition, supplying a prefix argument -+will also tell query-replace to leave the case of the replacement -+string as-is. -+.Pp -+Note that query-replace always performs a case-insensitive search. -+.Sh Regular Expressions -+Regular expressions provide a means for specifying complex search -+patterns, instead of just a literal string. The commands in this -+section are available only if MG is compiled with the REGEX option -+defined. -+.Pp -+Regular expression syntax uses the following rules. Most characters -+in a regular expression are considered to be ordinary characters, -+and will match themselves and nothing else. The exceptions are the -+special characters listed below. -+.Pp -+\ . Matches any single character except a newline. -+.Pp -+* A suffix operator that matches zero or more -+repetitions of the (smallest) preceding regular expression. -+.Pp -++ A suffix operator that matches one or more -+repetitions of the (smallest) preceding regular expression. -+.Pp -+? A suffix operator that matches either zero or one -+occurence of the (smallest) preceding regular expression. -+.Pp -+[...] Matches any one character listed in the -+character set between the square brackets. See examples below. -+.Pp -+^ Matches at the beginning of a line. -+.Pp -+dollar Matches at the end of a line. -+.Pp -+\\ Except for the situations listed -+below, acts as a prefix operator which causes the character following -+to be treated as an ordinary character. -+.Pp -+\\bar An infix binary or operator. -+It applies to the two largest surrounding expressions. -+.Pp -+\\(...\\) A grouping construct, -+usually used to specify a larger expression for postfix operators such -+as * or to limit the scope of operands to \|. -+.Pp -+\\# Matches the same text -+matched by the #_th \\(...\\) construct. These are -+numbered from 1 to 9 in the order that the open-parentheses appear. -+.It count-matches & count-non-matches -+These commands count the number of lines which do or do not -+(respectively) match the specified pattern. -+.It delete-matching-lines & delete-non-matching-lines -+These commands delete all lines which do or do not (respectively) -+match the specified pattern. -+.It query-replace-regexp -+This is the regular expression version of query-replace. -+The replacement string may be a constant, or it can refer to -+all or part of the string matched by the pattern. \& in -+the replacement string expands into the entire text being replaced, -+while n (where n is a number) replaces the -+n_th parenthesized expression in pattern. -+.It re-search-again & re-search-backward & re-search-forward -+These are the regular expression equivalents of the ordinary -+non-incremental search commands. -+.It set-case-fold-search -+This command toggles an internal variable that controls whether -+the regular expression search and replace commands pay attention to -+case. By default, regular expression searches are case-insensitive. -+Ordinary searches are always case-insensitive and are not affected by -+the setting of this variable. -+.Pp -+See the latex version for the documentation for better description. -+.Sh Windows -+MG initially has only one text window displayed. However, you can have -+as many windows as will fit on the screen. Each window has its own mode -+line and must display at least two lines of text. (Note that MG's -+windows are distinct from the windows handled by screen managers -+such as the X Window System.) -+.Pp -+Multiple windows may be used to display different buffers. You can also -+have the same buffer displayed in more than one window, which is useful -+if you want to see one part of a file at the same time as you are editing -+another part. -+.Pp -+Although many windows can be displayed at once, only one window is active -+at any given time. This is the window where the cursor appears. -+.Pp -+Some commands refer to the other window. This is the window directly -+below the current window, or the top window if you are in the bottom window. -+.It delete-other-windows, C-x 1 -+Makes the current window the only window. -+.It delete-window, C-x 0 -+Deletes the current window, making the other window the -+current window. This command doesn't do anything useful if there is only -+one window being displayed. -+.It enlarge-window C-^ -+Makes the current window larger. Without a prefix argument, the -+window grows one line; otherwise, the prefix argument specifies how many -+lines to grow. -+.It other-window, C-x o -+Makes the other window the current window. -+.It previous-window -+This is like other-window, except that it cycles through -+the windows in reverse order. This command is available only if MG was -+compiled with the GOSMACS option defined. -+.It shrink-window -+Makes the current window smaller. Without a prefix argument, the -+window loses one line; otherwise, the prefix argument specifies how many -+lines go away. -+.It split-window-vertically, C-x 2 -+Split the current window into two windows, both using the same -+buffer. -+.Sh Files and Buffers -+Most buffers are used to contain a file being edited. It is -+also possible to have buffers that are not associated with any file; -+MG uses these for purposes such as displaying help text, for example. -+However, since most commands for dealing with files also deal with -+buffers, we have grouped all of these commands together into one chapter. -+.It insert-buffer -+Inserts the contents of the named buffer into the current buffer -+at the cursor location. The cursor moves to the end of the inserted -+text. -+.It kill-buffer C-x k -+The named buffer and its contents are deleted. If the buffer has -+been marked as modified, MG will ask you if you really want to delete it. -+Note that, contrary to its name, this command does not save the -+buffer contents in the kill buffer. -+If a buffer is being displayed in a window when it is deleted, MG will -+find some other buffer to display in the same window. -+.It list-buffers, C-x C-b -+This command writes information about the buffers currently in -+use to a buffer named Buffer List. This buffer is then displayed -+in the other window; if there is only one window, this command will -+split the screen into two windows. -+.It not-modified, M-~ -+This command makes MG think that the current buffer has not been -+modified, even if it really has been changed. This affects the behavior -+of the kill-buffer and the buffer-saving commands described below. -+.Pp -+MG indicates modified buffers with two stars at the left end of the mode -+line. -+.It switch-to-buffer, C-x b -+The current window is mapped onto the named buffer. If there -+isn't already a buffer with that name around, MG will create one. -+.It switch-to-buffer-other-window, C-x 4 b -+This command works like switch-to-buffer, except that the -+other window is used. If there is only one window, this command -+splits the screen into two windows and maps the named buffer onto one -+of them. -+.Sh Reading and Writing Files -+.It find-file C-x f & find-file-other-window C-x 4 C-f -+These commands are analagous to switch-to-buffer and -+switch-to-buffer-other-window, respectively. The difference is that -+these commands look for a buffer associated with the named file. If no -+matching buffer is found, MG will create a new buffer with a name -+derived from the filename, and attempt to read the file into the buffer. -+If the named file cannot be opened, the buffer remains empty. -+.It insert-file C-x i -+This command reads in the contents of the named file into the -+current buffer at the cursor position. The cursor remains in the same -+place. -+.It save-buffer, C-x C-s -+If the current buffer has been modified, it is saved. Buffers -+that are not associated with files cannot be written out with this -+command. -+.It save-buffers-kill-emacs, C-x C-c -+This command is used to leave MG and return control to the shell -+or other program that was used to start MG. If there are modified buffers, -+MG will ask you if you want to save them before exiting. -+.It save-some-buffers, C-x s -+MG will ask you if you want to save modified buffers that are -+associated with files. -+.It write-file C-x C-w -+The current buffer is written out using the file name supplied. -+This is useful for saving buffers that are not associated with files, or -+for writing out a file with a different name than what was used to read -+it in. -+.Sh Backup Files -+MG provides a way to save a copy of the original version of files which -+have been modified and then written out again. The backup copy reflects -+the state of the file as it existed the first time it was read into MG. -+The name used for the backup file varies, depending on the operating -+system. -+.Pp -+This feature is disabled if MG is compiled with NO_BACKUP defined. -+.It make-backup-files -+This command is a toggle which -+controls the state of an internal variable that determines whether MG -+creates backup files. -+.Sh Changing the Directory -+The commands in this section are disabled by defining NO_DIR. -+.It cd -+This command changes MG's notion of the current directory -+or pathname. This is used to supply defaults for functions that read -+or write files. -+.It pwd -+Display what MG thinks is the current directory. -+.Sh Modes -+Modes are used to locally alter the bindings of keys on a -+buffer-by-buffer basis. MG is normally in fundamental mode, and these -+are the bindings that are listed with the command descriptions in -+this manual. Modes define additional keymaps that are searched for -+bindings before the fundamental mode bindings are examined; see the -+section on key binding below for more details on how this works. -+.It set-default-mode -+Normally, when MG visits a file, it puts the associated buffer -+into fundamental mode. Using the set-default-mode command, you -+can specify that MG should default to use some other mode on all subsequent -+buffers that are created. This command is a toggle. With no prefix -+argument, if the named mode is not already on the list of -+default modes, then it will be added to the list; otherwise, it is removed -+from the list. -+.It no-tab-mode -+This command is a toggle to control whether notab mode is in effect. -+In notab mode, tabs are expanded into spaces instead of inserted -+literally into the buffer. Literal tab characters are displayed as -+^I (much like other control characters). These commands are -+available if MG is compiled with the symbol NOTAB defined. (This mode -+is mainly for use on systems such as PRIMOS that do not treat tab as a -+series of spaces.) -+.It space-to-tabstop -+Insert enough spaces to move the cursor to the next tab stop. In -+notab mode, this function is bound to C-i. -+.It overwrite-mode -+This command is a toggle which controls whether overwrite mode is -+in effect. -+Normally, when characters are inserted into the buffer, they are spliced -+into the existing text. In overwrite mode, inserting a character causes -+the character already at the cursor position to be replaced. This is -+useful for editing pictures, tables, and the like. -+.It auto-fill-mode -+This command is a toggle which controls whether fill mode is -+in effect. -+Fill mode causes newlines to be added automatically at word -+breaks when text is added at the end of a line, extending past the -+right margin. Auto fill is useful for editing text and documentation -+files. -+.It insert-with-wrap -+This command works like self-insert, except that it checks -+to see if the cursor has passed the right margin. If so, it fills -+the line by inserting a line break between words. This command is bound to -+SPC in fill mode. -+.It fill-paragraph, M-q -+Fill the paragraph containing the cursor. -+.It set-fill-column, C-x f -+Without a prefix argument, this command sets the right margin -+at the current cursor column. If a prefix argument is supplied, it is used -+instead as the line width. -+.It auto-indent-mode -+This command is a toggle which controls whether auto-indent mode -+is in effect. -+Indent mode binds RET to newline-and-indent, so -+that each new line is indented to the same level as the preceeding -+line. This mode is useful for editing code. -+.It blink-matching-paren -+This command is a toggle which controls whether blink mode is -+in effect. -+Blink mode makes it easier to match parentheses, brackets, and other -+paired delimiters. When the closing delimiter is typed, the cursor -+moves momentarily to the matching opening delimiter (if it is on the -+screen), or displays the line containing the matching delimiter on the -+echo line. This is useful for editing Lisp or C code, or for -+preparing input files for text processors such as LaTeX that use -+paired delimiters. -+.It blink-matching-paren-hack -+This function behaves like self-insert, except that it -+finds the matching delimiter as described above. In blink mode, this -+function is bound to ), which flashes the matching (. This -+function also knows about the pairs {}, [], and <>. -+All other characters match with themselves. -+.Sh Dired Mode -+Dired is an abbreviation for directory editor, and it provides a way -+to browse through the contents of a directory from with MG. Dired puts -+a directory listing into a buffer; you can use normal editing commands to -+move around the buffer, and a special group of commands to manipulate -+the files. For example, there are commands to delete and rename files, -+and to read a file into an MG buffer. -+.Pp -+Since dired mode rebinds many keys, a table may be helpful: -+.Pp -+ C-d dired-flag-file-deleted -+.Pp -+ SPC next-line -+.Pp -+ c dired-copy-file -+.Pp -+ d dired-flag-file-deleted -+.Pp -+ e dired-find-file -+.Pp -+ f dired-find-file -+.Pp -+ n next-line -+.Pp -+ o dired-find-file-other-window -+.Pp -+ p previous-line -+.Pp -+ r dired-renamefile -+.Pp -+ u dired-unflag -+.Pp -+ x dired-do-deletions -+.Pp -+ DEL dired-backup-unflag -+.Pp -+The commands in this section are disabled by defining NO_DIRED. -+.It dired C-x d -+Creates a dired buffer for the given directory name, and displays -+it in the current window. The files -+in the directory are listed, usually along with information about the -+file such as its size and timestamp. The exact format of the information -+is system-specific. -+.It dired-backup-unflag -+This function removes the deletion flag from the file listed on -+the previous line of the dired buffer. -+.It dired-copy-file -+Copy the file listed on the current line of the dired buffer. -+.It dired-do-deletions -+Deletes the files that have been flagged for deletion. -+.It dired-find-file & dired-find-file-other-window -+These function works like find-file and find-file-other-window, -+except that the filename is taken -+from the current line in the dired buffer. -+.It dired-flag-file-deleted -+Flag the file listed on the current line for deletion. This is -+indicated in the buffer by putting a D at the left margin. No -+files are not actually deleted until the function dired-do-deletions -+is executed. -+.It dired-other-window -+This function works just like dired, except that it puts the -+dired buffer in the other window. -+.It dired-rename-file -+Renames the file listed on the current line of the dired buffer. -+Note that the dired buffer is not updated to reflect the change. -+.It dired-unflag -+Remove the deletion flag for the file on the current line. -+.Sh Help -+Most of the commands in this section write useful information to the -+*help* buffer, which is then displayed in the other window. -+.Pp -+These commands can be disabled at compile-time by defining NO_HELP. -+.It apropos, C-h a -+This command lists all functions whose names contain a string -+matching topic in the help buffer. -+.It describe-bindings, C-h b -+Information about the key bindings in effect in the current buffer -+is listed in the help buffer. -+.It describe-key-briefly, C-h c -+Information about the binding of ke is printed in the -+minibuffer. -+.It help-help, C-h C-h -+This command lists all of the help options available and -+prompts for which one to run. Currently, these include only a -+to run apropos, b to run describe-bindings, and c -+to run describe-key-briefly. -+.Sh Keyboard Macros -+A keyboard macro is a saved set of commands from the keyboard that can be -+reexecuted later on. There can only be one keyboard macro defined at -+any one time. -+.Pp -+The commands in this section are available unless they have been disabled -+by defining NO_MACRO. -+.It call-last-kbd-macro, C-x e -+Execute the saved keyboard macro. A prefix argument can be used -+to specify a repetition count. -+.It end-kbd-macro, C-x ) & start-kbd-macro, C-x ( -+These functions are used to define a keyboard macro. All keys -+entered after start-kbd-macro is executed, up to a end-kbd-macro, -+are remembered as they are executed. You can then reexecute the same -+sequence of operations using call-last-kbd-macro. -+.Sh Changing Case -+MG provides a number of functions for changing the case of text. -+.It -+capitalize-word, M-c -+.It -+downcase-region, C-x C-l -+.It -+downcase-word, M-l -+.It -+upcase-region, C-x C-u -+.It -+upcase-word, M-u -+.Sh Odds and Ends -+This section describes miscellaneous commands that don't fit into any -+particular category. -+.It emacs-version -+Prints information about the version of MG you are running in -+the minibuffer. -+.It meta-key-mode -+If the particular version of MG you are running supports a meta key, -+this function can be used to determine whether MG actually pays attention -+to it or not. If no prefix argument is supplied, the internal variable -+that controls the use of the meta key is toggled; a positive value enables -+the meta key, while a negative value disables it. -+.It prefix-region & set-prefix-string -+Prefix-region is used to prefix each line of the region -+with a string. This is useful for indenting quoted text, making block -+comments, and the like. The function set-prefix-string can be -+used to set the string used as the prefix. -+.It suspend-emacs, C-z -+This command temporarily suspends -+MG so that you can run other programs, and later resume editing. The -+exact behavior depends on which operating system you are running MG -+under. Typically, MG will either spawn a new shell as a subprocess, or -+return you to the parent process. -+.It transpose-chars, C-t -+This command transposes the previous two characters. -+.Sh Customization -+MG provides a limited support for customization. However, unlike real -+Emacs, there is no extension language for interpretively defining new -+functions. -+.Sh Key Bindings -+MG allows keys to be rebound locally or globally. To understand the -+difference between the two, some discussion on how modes are implemented -+is necessary. -+.Pp -+An internal data structure called a keymap is used to look up the -+function that is bound to a particular key. The keymap for -+fundamental mode contains all of the default bindings which are listed -+with the command descriptions in this manual. Modes define additional -+keymaps that are searched for a binding before the fundamental mode -+keymap is examined. Keymaps have the same name as the mode they are -+associated with. -+.Pp -+MG does not provide commands for defining new modes, but you can alter -+the keymaps for existing modes. -+.It define-key -+This command can be used to modify the keymap for the named mode. -+.It global-set-key & global-unset-key -+These commands modify the keymap for fundamental mode. Bindings -+established by global-set-key will be inherited by all other modes, -+as long as they do not establish local rebindings of the same key. -+.It local-set-key & local-unset-key -+These commands modify the keymap currently in effect. -+.Sh Startup Files -+Although MG does not include a general-purpose extension language, it -+does provide a way to read and evaluate commands using a somewhat -+different syntax than that used for executing extended commands. This -+is typically used in a startup file to modify key bindings. -+.Pp -+A startup file consists of one or more expressions. Each expression must -+appear on a separate line in the file; there may not be more than one -+expression per line, nor may expressions span across line breaks. -+Whitespace (spaces and tabs) separate the tokens in an expression. For -+historical reasons, parentheses are also considered to be whitespace in -+this context. A semicolon acts as a comment character, causing the rest -+of the line to be discarded. -+.Pp -+An expression consists of a function name, an optional prefix argument -+(given as an integer constant), and arguments to be passed to the -+function. If an argument includes literal whitespace or nonprintable -+characters (for example, as in a keystroke argument to one of the key -+binding functions described in the previous section), it must be -+supplied as a string constant enclosed in double quotes. -+.Pp -+The following commands which deal with evaluation of expressions are -+disabled by defining the compile-time option NO_STARTUP. See the -+implementation notes for your particular version of MG for information -+on how it handles startup files. -+.It eval-current-buffer -+Evaluate the expressions in the current buffer. -+.It eval-expression -+Evaluate the expression supplied. -+.It load -+Read in the specified file and evaluate its contents. -+.El -+.Sh Fundamental Mode Key Bindings -+.Pp -+NUL set-mark-command -+.Pp -+C-a beginning-of-line -+.Pp -+C-b backward-char -+.Pp -+C-d delete-char -+.Pp -+C-e end-of-line -+.Pp -+C-f forward-char -+.Pp -+C-g keyboard-quit -+.Pp -+C-h help -+.Pp -+TAB self-insert-command -+.Pp -+C-j newline-and-indent -+.Pp -+C-k kill-line -+.Pp -+C-l recenter -+.Pp -+RET newline -+.Pp -+C-n next-line -+.Pp -+C-o open-line -+.Pp -+C-p previous-line -+.Pp -+C-q quoted-insert -+.Pp -+C-r isearch-backward -+.Pp -+C-s isearch-forward -+.Pp -+C-t transpose-chars -+.Pp -+C-u universal-argument -+.Pp -+C-v scroll-up -+.Pp -+C-w kill-region -+.Pp -+C-x c-x prefix -+.Pp -+C-y yank -+.Pp -+C-z suspend-emacs -+.Pp -+ESC meta prefix -+.Pp -+SPC .. ~ self-insert-command -+.Pp -+DEL delete-backward-char -+.Pp -+C-h C-g keyboard-quit -+.Pp -+C-h C-h help-help -+.Pp -+C-h a apropos -+.Pp -+C-h b describe-bindings -+.Pp -+C-h c describe-key-briefly -+.Pp -+C-x C-b list-buffers -+.Pp -+C-x C-c save-buffers-kill-emacs -+.Pp -+C-x C-f find-file -+.Pp -+C-x C-g keyboard-quit -+.Pp -+C-x C-l downcase-region -+.Pp -+C-x C-o delete-blank-lines -+.Pp -+C-x C-s save-buffer -+.Pp -+C-x C-u upcase-region -+.Pp -+C-x C-w write-file -+.Pp -+C-x C-x exchange-point-and-mark -+.Pp -+C-x ( start-kbd-macro -+.Pp -+C-x ) end-kbd-macro -+.Pp -+C-x 0 delete-window -+.Pp -+C-x 1 delete-other-windows -+.Pp -+C-x 2 split-window-vertically -+.Pp -+C-x 4 c-x 4 prefix -+.Pp -+C-x = what-cursor-position -+.Pp -+C-x ^ enlarge-window -+.Pp -+C-x b switch-to-buffer -+.Pp -+C-x d dired -+.Pp -+C-x e call-last-kbd-macro -+.Pp -+C-x f set-fill-column -+.Pp -+C-x i insert-file -+.Pp -+C-x k kill-buffer -+.Pp -+C-x o other-window -+.Pp -+C-x s save-some-buffers -+.Pp -+C-x 4 C-f find-file-other-window -+.Pp -+C-x 4 C-g keyboard-quit -+.Pp -+C-x 4 b switch-to-buffer-other-window -+.Pp -+C-x 4 f find-file-other-window -+.Pp -+M-C-g keyboard-quit -+.Pp -+M-C-v scroll-other-window -+.Pp -+M-SPC just-one-space -+.Pp -+M-% query-replace -+.Pp -+M-- negative-argument -+.Pp -+M-0 digit-argument -+.Pp -+M-1 digit-argument -+.Pp -+M-2 digit-argument -+.Pp -+M-3 digit-argument -+.Pp -+M-4 digit-argument -+.Pp -+M-5 digit-argument -+.Pp -+M-6 digit-argument -+.Pp -+M-7 digit-argument -+.Pp -+M-8 digit-argument -+.Pp -+M-9 digit-argument -+.Pp -+M-< beginning-of-buffer -+.Pp -+M-> end-of-buffer -+.Pp -+M-[ backward-paragraph -+.Pp -+M-\ delete-horizontal-space -+.Pp -+M-] forward-paragraph -+.Pp -+M-b backward-word -+.Pp -+M-c capitalize-word -+.Pp -+M-d kill-word -+.Pp -+M-f forward-word -+.Pp -+M-l downcase-word -+.Pp -+M-q fill-paragraph -+.Pp -+M-r search-backward -+.Pp -+M-s search-forward -+.Pp -+M-u upcase-word -+.Pp -+M-v scroll-down -+.Pp -+M-w copy-region-as-kill -+.Pp -+M-x execute-extended-command -+.Pp -+M-~ not-modified -+.Pp -+M-DEL backward-kill-word -+.Pp -+.Sh Bugs and Limitations -+Some listed in the LaTeX documentation. A few path-length issues, -+like not being able to handle files with too great a path length. -+An irritating behavior that arrow keys leave their control characters -+(sans the leading escape) when pressed during incremental-search. -+.Sh History -+The original authors of mg2a were -+Bob Larson, Mic Kaczmarczik, Mike Meyer, Sandra Loosemore, -+Michael Portuesi, Stephen Walton, Marion Hakanson, Dave Brower, -+Jeff Siegal, and John P. Nelson. -+It was posted to the comp.sources.misc mailing list of Usenet -+sometime around 1988. Original sources -+available at ftp://ftp.cdrom.com/pub/c-unix/editors/mg2a.tar.Z -+or in ftp://www.leo.org/pub/comp/usenet/comp.sources.misc/mg2a. -+.Pp -+Modified for NetBSD by John P. Refling as follows: -+.Pp -+December 1999 (version 1.00) -+.Pp -+Port to NetBSD (not much to do there) and a change to the -+mg.rc startup file name and search paths (searches the directory -+where the executable is first). -+Also hastily turned the LaTeX documentation written by Sandra J -+Loosemore in 1987 into this manpage. -+.Pp -+January 2000 (version 1.10): -+.Pp -+Journaling: -+if a subdirectory named .journal exists in the directory of the -+edited file fn, the edited file is copied into the .journal -+subdirectory as fn-@# before the new version is written out. -+The # is the system time in seconds since January 1, 1970. -+This feature creates a transparent backup chain of all files -+edited within a selected directory. If the edited file did not exist -+at the start of the editing session, a zero length fn-@# file is created. -+.Pp -+If the environment variable MG_DOT_ORIG is set, then the edited -+file fn is copied to a fn.orig file, only if a fn.orig file does not already exist. -+Helpful for creating diffs. If the edit file itself does not exist -+prior to the editing session, a fn.orig file is touched. -+.Pp -+All these actions are indicated in the information bar when the -+file is being saved: `Wrote (o+j) filename....' o indicates that a -+fn.orig was created, and j indicates that a time stamped copy was -+made in the .journal directory. |