$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.