[BACK]Return to mg.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / mg

Diff for /src/usr.bin/mg/mg.1 between version 1.132 and 1.133

version 1.132, 2023/04/25 13:32:20 version 1.133, 2023/04/28 09:50:50
Line 103 
Line 103 
 character appended to the file name and  character appended to the file name and
 are created in the current working directory by default.  are created in the current working directory by default.
 Whether to create backup files or not can be toggled with the  Whether to create backup files or not can be toggled with the
 make-backup-files command.  .Ic make-backup-files
   command.
 The backup file location can either be in the current  The backup file location can either be in the current
 working directory, or all backups can be moved to a  working directory, or all backups can be moved to a
 .Pa ~/.mg.d  .Pa ~/.mg.d
 directory where files retain their path name to retain uniqueness.  directory where files retain their path name to retain uniqueness.
 Use the backup-to-home-directory to alternate between these two locations.  Use the
   .Ic backup-to-home-directory
   command to alternate between these two locations.
 Further, if any application creates backup files in  Further, if any application creates backup files in
 .Pa /tmp ,  .Pa /tmp ,
 these can be left with the leave-tmpdir-backups command.  these can be left with the
   .Ic leave-tmpdir-backups
   command.
 .Sh TAGS  .Sh TAGS
 .Nm  .Nm
 supports tag files created by  supports tag files created by
Line 380 
Line 385 
 Otherwise, it is forced to off.  Otherwise, it is forced to off.
 .\"  .\"
 .Bl -tag -width xxxxx  .Bl -tag -width xxxxx
 .It apropos  .It Ic apropos
 Help Apropos.  Help Apropos.
 Prompt the user for a string, open the *help* buffer,  Prompt the user for a string, open the *help* buffer,
 and list all  and list all
 .Nm  .Nm
 commands that contain that string.  commands that contain that string.
 .It audible-bell  .It Ic audible-bell
 Toggle the audible system bell.  Toggle the audible system bell.
 .It auto-execute  .It Ic auto-execute
 Register an auto-execute hook; that is, specify a filename pattern  Register an auto-execute hook; that is, specify a filename pattern
 (conforming to the shell's filename globbing rules) and an associated  (conforming to the shell's filename globbing rules) and an associated
 function to execute when a file matching the specified pattern  function to execute when a file matching the specified pattern
 is read into a buffer.  is read into a buffer.
 .It auto-fill-mode  .It Ic auto-fill-mode
 Toggle auto-fill mode (sometimes called mail-mode) in the current buffer,  Toggle auto-fill mode (sometimes called mail-mode) in the current buffer,
 where text inserted past the fill column is automatically wrapped  where text inserted past the fill column is automatically wrapped
 to a new line.  to a new line.
 Can be set globally with set-default-mode.  Can be set globally with
 .It auto-indent-mode  .Ic set-default-mode .
   .It Ic auto-indent-mode
 Toggle indent mode in the current buffer,  Toggle indent mode in the current buffer,
 where indentation is preserved after a newline.  where indentation is preserved after a newline.
 Can be set globally with set-default-mode.  Can be set globally with
 .It back-to-indentation  .Ic set-default-mode .
   .It Ic back-to-indentation
 Move the dot to the first non-whitespace character on the current line.  Move the dot to the first non-whitespace character on the current line.
 .It backup-to-home-directory  .It Ic backup-to-home-directory
 Save backup copies to a  Save backup copies to a
 .Pa ~/.mg.d  .Pa ~/.mg.d
 directory instead of working directory.  directory instead of working directory.
 Requires make-backup-files to be on.  Requires
 .It backward-char  .Ic make-backup-files
   to be on.
   .It Ic backward-char
 Move cursor backwards one character.  Move cursor backwards one character.
 .It backward-kill-word  .It Ic backward-kill-word
 Kill text backwards by  Kill text backwards by
 .Va n  .Va n
 words.  words.
 .It backward-paragraph  .It Ic backward-paragraph
 Move cursor backwards  Move cursor backwards
 .Va n  .Va n
 paragraphs.  paragraphs.
 Paragraphs are delimited by <NL><NL> or <NL><TAB> or <NL><SPACE>.  Paragraphs are delimited by <NL><NL> or <NL><TAB> or <NL><SPACE>.
 .It backward-word  .It Ic backward-word
 Move cursor backwards by the specified number of words.  Move cursor backwards by the specified number of words.
 .It beginning-of-buffer  .It Ic beginning-of-buffer
 Move cursor to the top of the buffer.  Move cursor to the top of the buffer.
 If set, keep mark's position, otherwise set at current position.  If set, keep mark's position, otherwise set at current position.
 A numeric argument  A numeric argument
 .Va n  .Va n
 will move n/10th of the way from the top.  will move n/10th of the way from the top.
 .It beginning-of-line  .It Ic beginning-of-line
 Move cursor to the beginning of the line.  Move cursor to the beginning of the line.
 .It blink-and-insert  .It Ic blink-and-insert
 Self-insert a character, then search backwards and blink its  Self-insert a character, then search backwards and blink its
 matching delimiter.  matching delimiter.
 For delimiters other than  For delimiters other than
 parenthesis, brackets, and braces, the character itself  parenthesis, brackets, and braces, the character itself
 is used as its own match.  is used as its own match.
 Can be used in the startup file with the global-set-key command.  Can be used in the startup file with the
 .It bsmap-mode  .Ic global-set-key
   command.
   .It Ic bsmap-mode
 Toggle bsmap mode, where DEL and C-h are swapped.  Toggle bsmap mode, where DEL and C-h are swapped.
 .It c-mode  .It Ic c-mode
 Toggle a KNF-compliant mode for editing C program files.  Toggle a KNF-compliant mode for editing C program files.
 .It call-last-kbd-macro  .It Ic call-last-kbd-macro
 Invoke the keyboard macro.  Invoke the keyboard macro.
 .It capitalize-word  .It Ic capitalize-word
 Capitalize  Capitalize
 .Va n  .Va n
 words; i.e. convert the first character of the word to  words; i.e. convert the first character of the word to
 upper case, and subsequent letters to lower case.  upper case, and subsequent letters to lower case.
 .It cd  .It Ic cd
 Change the global working directory.  Change the global working directory.
 See also global-wd-mode.  See also
 .It column-number-mode  .Ic global-wd-mode .
   .It Ic column-number-mode
 Toggle whether the column number is displayed in the modeline.  Toggle whether the column number is displayed in the modeline.
 .It copy-region-as-kill  .It Ic copy-region-as-kill
 Copy all of the characters in the region to the kill buffer,  Copy all of the characters in the region to the kill buffer,
 clearing the mark afterwards.  clearing the mark afterwards.
 This is a bit like a kill-region followed by a yank.  This is a bit like a
 .It count-matches  .Ic kill-region
   followed by a
   .Ic yank .
   .It Ic count-matches
 Count the number of lines matching the supplied regular expression.  Count the number of lines matching the supplied regular expression.
 .It count-non-matches  .It Ic count-non-matches
 Count the number of lines not matching the supplied regular expression.  Count the number of lines not matching the supplied regular expression.
 .It cscope-find-this-symbol  .It Ic cscope-find-this-symbol
 List the matches for the given symbol.  List the matches for the given symbol.
 .It cscope-find-global-definition  .It Ic cscope-find-global-definition
 List global definitions for the given literal.  List global definitions for the given literal.
 .It cscope-find-called-functions  .It Ic cscope-find-called-functions
 List functions called from the given function.  List functions called from the given function.
 .It cscope-find-functions-calling-this-function  .It Ic cscope-find-functions-calling-this-function
 List functions calling the given function.  List functions calling the given function.
 .It cscope-find-this-text-string  .It Ic cscope-find-this-text-string
 List locations matching the given text string.  List locations matching the given text string.
 .It cscope-find-egrep-pattern  .It Ic cscope-find-egrep-pattern
 List locations matching the given extended regular expression pattern.  List locations matching the given extended regular expression pattern.
 .It cscope-find-this-file  .It Ic cscope-find-this-file
 List filenames matching the given filename.  List filenames matching the given filename.
 .It cscope-find-files-including-file  .It Ic cscope-find-files-including-file
 List files that #include the given filename.  List files that #include the given filename.
 .It cscope-next-symbol  .It Ic cscope-next-symbol
 Navigate to the next match.  Navigate to the next match.
 .It cscope-prev-symbol  .It Ic cscope-prev-symbol
 Navigate to the previous match.  Navigate to the previous match.
 .It cscope-next-file  .It Ic cscope-next-file
 Navigate to the next file.  Navigate to the next file.
 .It cscope-prev-file  .It Ic cscope-prev-file
 Navigate to the previous file.  Navigate to the previous file.
 .It cscope-create-list-of-files-to-index  .It Ic cscope-create-list-of-files-to-index
 Create cscope's List and Index in the given directory.  Create cscope's List and Index in the given directory.
 .It define-key  .It Ic define-key
 Prompts the user for a named keymap (mode),  Prompts the user for a named keymap (mode),
 a key, and an  a key, and an
 .Nm  .Nm
 command, then creates a keybinding in the appropriate  command, then creates a keybinding in the appropriate
 map.  map.
 .It delete-backward-char  .It Ic delete-backward-char
 Delete backwards  Delete backwards
 .Va n  .Va n
 characters.  characters.
 Like delete-char, this actually does a kill if presented  Like
   .Ic delete-char ,
   this actually does a kill if presented
 with an argument.  with an argument.
 .It delete-blank-lines  .It Ic delete-blank-lines
 Delete blank lines around dot.  Delete blank lines around dot.
 If dot is sitting on a blank line, this command  If dot is sitting on a blank line, this command
 deletes all the blank lines above and below the current line.  deletes all the blank lines above and below the current line.
 Otherwise, it deletes all of the blank lines after the current line.  Otherwise, it deletes all of the blank lines after the current line.
 .It delete-char  .It Ic delete-char
 Delete  Delete
 .Va n  .Va n
 characters forward.  characters forward.
 If any argument is present, it kills rather than deletes,  If any argument is present, it kills rather than deletes,
 saving the result in the kill buffer.  saving the result in the kill buffer.
 .It delete-horizontal-space  .It Ic delete-horizontal-space
 Delete any whitespace around the dot.  Delete any whitespace around the dot.
 .It delete-leading-space  .It Ic delete-leading-space
 Delete leading whitespace on the current line.  Delete leading whitespace on the current line.
 .It delete-trailing-space  .It Ic delete-trailing-space
 Delete trailing whitespace on the current line.  Delete trailing whitespace on the current line.
 .It delete-matching-lines  .It Ic delete-matching-lines
 Delete all lines after dot that contain a string matching  Delete all lines after dot that contain a string matching
 the supplied regular expression.  the supplied regular expression.
 .It delete-non-matching-lines  .It Ic delete-non-matching-lines
 Delete all lines after dot that don't contain a string matching  Delete all lines after dot that don't contain a string matching
 the supplied regular expression.  the supplied regular expression.
 .It delete-other-windows  .It Ic delete-other-windows
 Make the current window the only window visible on the screen.  Make the current window the only window visible on the screen.
 .It delete-window  .It Ic delete-window
 Delete current window.  Delete current window.
 .It describe-bindings  .It Ic describe-bindings
 List all global and local keybindings, putting the result in  List all global and local keybindings, putting the result in
 the *help* buffer.  the *help* buffer.
 .It describe-key-briefly  .It Ic describe-key-briefly
 Read a key from the keyboard, and look it up in the keymap.  Read a key from the keyboard, and look it up in the keymap.
 Display the name of the function currently bound to the key.  Display the name of the function currently bound to the key.
 .It diff-buffer-with-file  .It Ic diff-buffer-with-file
 View the differences between buffer and its associated file.  View the differences between buffer and its associated file.
 .It digit-argument  .It Ic digit-argument
 Process a numerical argument for keyboard-invoked functions.  Process a numerical argument for keyboard-invoked functions.
 .It dired-jump  .It Ic dired-jump
 Open a dired buffer containing the current buffer's directory location.  Open a dired buffer containing the current buffer's directory location.
 .It downcase-region  .It Ic downcase-region
 Set all characters in the region to lower case.  Set all characters in the region to lower case.
 .It downcase-word  .It Ic downcase-word
 Set characters to lower case, starting at the dot, and ending  Set characters to lower case, starting at the dot, and ending
 .Va n  .Va n
 words away.  words away.
 .It emacs-version  .It Ic emacs-version
 Return an  Return an
 .Nm  .Nm
 version string.  version string.
 .It end-kbd-macro  .It Ic end-kbd-macro
 Stop defining a keyboard macro.  Stop defining a keyboard macro.
 .It end-of-buffer  .It Ic end-of-buffer
 Move cursor to the end of the buffer.  Move cursor to the end of the buffer.
 If set, keep mark's position, otherwise set at current position.  If set, keep mark's position, otherwise set at current position.
 A numeric argument  A numeric argument
 .Va n  .Va n
 will move n/10th of the way from the end.  will move n/10th of the way from the end.
 .It end-of-line  .It Ic end-of-line
 Move cursor to the end of the line.  Move cursor to the end of the line.
 .It enlarge-window  .It Ic enlarge-window
 Enlarge the current window by shrinking either the window above  Enlarge the current window by shrinking either the window above
 or below it.  or below it.
 .It eval-current-buffer  .It Ic eval-current-buffer
 Evaluate the current buffer as a series of  Evaluate the current buffer as a series of
 .Nm  .Nm
 commands.  commands.
 Useful for testing  Useful for testing
 .Nm  .Nm
 startup files.  startup files.
 .It eval-expression  .It Ic eval-expression
 Get one line from the user, and run it.  Get one line from the user, and run it.
 Useful for testing expressions in  Useful for testing expressions in
 .Nm  .Nm
 startup files.  startup files.
 .It exchange-point-and-mark  .It Ic exchange-point-and-mark
 Swap the values of "dot" and "mark" in the current window.  Swap the values of "dot" and "mark" in the current window.
 Return an error if no mark is set.  Return an error if no mark is set.
 .It execute-extended-command  .It Ic execute-extended-command
 Invoke an extended command; i.e. M-x.  Invoke an extended command; i.e. M-x.
 Call the message line routine to read in the command name and apply  Call the message line routine to read in the command name and apply
 autocompletion to it.  autocompletion to it.
 When it comes back, look the name up in the symbol table and run the  When it comes back, look the name up in the symbol table and run the
 command if it is found, passing arguments as necessary.  command if it is found, passing arguments as necessary.
 Print an error if there is anything wrong.  Print an error if there is anything wrong.
 .It fill-paragraph  .It Ic fill-paragraph
 Justify a paragraph, wrapping text at the current fill column.  Justify a paragraph, wrapping text at the current fill column.
 .It find-file  .It Ic find-file
 Select a file for editing.  Select a file for editing.
 First check if the file can be found  First check if the file can be found
 in another buffer; if it is there, just switch to that buffer.  in another buffer; if it is there, just switch to that buffer.
 If the file cannot be found, create a new buffer, read in the  If the file cannot be found, create a new buffer, read in the
 file from disk, and switch to the new buffer.  file from disk, and switch to the new buffer.
 .It find-file-read-only  .It Ic find-file-read-only
 Same as find-file, except the new buffer is set to read-only.  Same as
 .It find-alternate-file  .Ic find-file ,
   except the new buffer is set to read-only.
   .It Ic find-alternate-file
 Replace the current file with an alternate one.  Replace the current file with an alternate one.
 Semantics for finding the replacement file are the same as  Semantics for finding the replacement file are the same as
 find-file, except the current buffer is killed before the switch.  .Ic find-file ,
   except the current buffer is killed before the switch.
 If the kill fails, or is aborted, revert to the original file.  If the kill fails, or is aborted, revert to the original file.
 .It find-file-other-window  .It Ic find-file-other-window
 Opens the specified file in a second buffer.  Opens the specified file in a second buffer.
 Splits the current window if necessary.  Splits the current window if necessary.
 .It find-tag  .It Ic find-tag
 Jump to definition of tag at dot.  Jump to definition of tag at dot.
 .It forward-char  .It Ic forward-char
 Move cursor forwards (or backwards, if  Move cursor forwards (or backwards, if
 .Va n  .Va n
 is negative)  is negative)
 .Va n  .Va n
 characters.  characters.
 Returns an error if the end of buffer is reached.  Returns an error if the end of buffer is reached.
 .It forward-paragraph  .It Ic forward-paragraph
 Move forward  Move forward
 .Va n  .Va n
 paragraphs.  paragraphs.
 Paragraphs are delimited by <NL><NL> or <NL><TAB> or <NL><SPACE>.  Paragraphs are delimited by <NL><NL> or <NL><TAB> or <NL><SPACE>.
 .It forward-word  .It Ic forward-word
 Move the cursor forward by the specified number of words.  Move the cursor forward by the specified number of words.
 .It global-set-key  .It Ic global-set-key
 Bind a key in the global (fundamental) key map.  Bind a key in the global (fundamental) key map.
 .It global-unset-key  .It Ic global-unset-key
 Unbind a key from the global (fundamental) key map; i.e. set it to 'rescan'.  Unbind a key from the global (fundamental) key map; i.e. set it to 'rescan'.
 .It global-wd-mode  .It Ic global-wd-mode
 Toggle global working-directory mode.  Toggle global working-directory mode.
 When enabled,  When enabled,
 .Nm  .Nm
 defaults to opening files (and executing commands like compile and grep)  defaults to opening files (and executing commands like
   .Ic compile
   and
   .Ic grep )
 relative to the global working directory.  relative to the global working directory.
 When disabled, a working directory is set for each buffer.  When disabled, a working directory is set for each buffer.
 .It goto-line  .It Ic goto-line
 Go to a specific line.  Go to a specific line.
 If an argument is present, then  If an argument is present, then
 it is the line number, else prompt for a line number to use.  it is the line number, else prompt for a line number to use.
 .It help-help  .It Ic help-help
 Prompts for one of (a)propos, (b)indings, des(c)ribe key briefly.  Prompts for one of (a)propos, (b)indings, des(c)ribe key briefly.
 .It insert  .It Ic insert
 Insert a string, mainly for use from macros.  Insert a string, mainly for use from macros.
 .It insert-buffer  .It Ic insert-buffer
 Insert the contents of another buffer at dot.  Insert the contents of another buffer at dot.
 .It insert-file  .It Ic insert-file
 Insert a file into the current buffer at dot.  Insert a file into the current buffer at dot.
 .It insert-with-wrap  .It Ic insert-with-wrap
 Insert the bound character with word wrap.  Insert the bound character with word wrap.
 Check to see if we're past the fill column, and if so,  Check to see if we're past the fill column, and if so,
 justify this line.  justify this line.
 .It isearch-backward  .It Ic isearch-backward
 Use incremental searching, initially in the reverse direction.  Use incremental searching, initially in the reverse direction.
 isearch ignores any explicit arguments.  isearch ignores any explicit arguments.
 If invoked during macro definition or evaluation, the non-incremental  If invoked during macro definition or evaluation, the non-incremental
 search-backward is invoked instead.  .Ic search-backward
 .It isearch-forward  is invoked instead.
   .It Ic isearch-forward
 Use incremental searching, initially in the forward direction.  Use incremental searching, initially in the forward direction.
 isearch ignores any explicit arguments.  isearch ignores any explicit arguments.
 If invoked during macro definition or evaluation, the non-incremental  If invoked during macro definition or evaluation, the non-incremental
 search-forward is invoked instead.  .Ic search-forward
 .It join-line  is invoked instead.
   .It Ic join-line
 Join the current line to the previous.  Join the current line to the previous.
 If called with an argument,  If called with an argument,
 join the next line to the current one.  join the next line to the current one.
 .It just-one-space  .It Ic just-one-space
 Delete any whitespace around dot, then insert a space.  Delete any whitespace around dot, then insert a space.
 .It keyboard-quit  .It Ic keyboard-quit
 Abort the current action.  Abort the current action.
 .It kill-buffer  .It Ic kill-buffer
 Dispose of a buffer, by name.  Dispose of a buffer, by name.
 If the buffer name does not start and end with an asterisk,  If the buffer name does not start and end with an asterisk,
 prompt the user if the buffer  prompt the user if the buffer
 has been changed.  has been changed.
 .It kill-line  .It Ic kill-line
 Kill line.  Kill line.
 If called without an argument, it kills from dot to the end  If called without an argument, it kills from dot to the end
 of the line, unless it is at the end of the line, when it kills the  of the line, unless it is at the end of the line, when it kills the
Line 679 
Line 704 
 If called with a negative argument  If called with a negative argument
 it kills any text before dot on the current line, then it kills back  it kills any text before dot on the current line, then it kills back
 abs(n) lines.  abs(n) lines.
 .It kill-paragraph  .It Ic kill-paragraph
 Delete  Delete
 .Va n  .Va n
 paragraphs starting with the current one.  paragraphs starting with the current one.
 .It kill-region  .It Ic kill-region
 Kill the currently defined region.  Kill the currently defined region.
 .It kill-word  .It Ic kill-word
 Delete forward  Delete forward
 .Va n  .Va n
 words.  words.
 .It leave-tmpdir-backups  .It Ic leave-tmpdir-backups
 Modifies the behaviour of backup-to-home-directory.  Modifies the behaviour of
   .Ic backup-to-home-directory .
 Backup files that would normally reside in  Backup files that would normally reside in
 .Pa /tmp  .Pa /tmp
 are left there and not moved to the  are left there and not moved to the
 .Pa ~/.mg.d  .Pa ~/.mg.d
 directory.  directory.
 .It line-number-mode  .It Ic line-number-mode
 Toggle whether the line number is displayed in the modeline.  Toggle whether the line number is displayed in the modeline.
 .It list-buffers  .It Ic list-buffers
 Display the list of available buffers.  Display the list of available buffers.
 The first column in the output indicates which buffer is active with a '>'  The first column in the output indicates which buffer is active with a '>'
 character.  character.
 The second column indicates which buffers are modified.  The second column indicates which buffers are modified.
 The third column indicates which buffers are read-only.  The third column indicates which buffers are read-only.
 The remaining columns are self-explanatory.  The remaining columns are self-explanatory.
 .It load  .It Ic load
 Prompt the user for a filename, and then execute commands  Prompt the user for a filename, and then execute commands
 from that file.  from that file.
 .It local-set-key  .It Ic local-set-key
 Bind a key mapping in the local (topmost) mode.  Bind a key mapping in the local (topmost) mode.
 .It local-unset-key  .It Ic local-unset-key
 Unbind a key mapping in the local (topmost) mode.  Unbind a key mapping in the local (topmost) mode.
 .It make-backup-files  .It Ic make-backup-files
 Toggle generation of backup files.  Toggle generation of backup files.
 Enabled by default.  Enabled by default.
 .It make-directory  .It Ic make-directory
 Prompt the user for a path or directory name which is then created.  Prompt the user for a path or directory name which is then created.
 .It mark-paragraph  .It Ic mark-paragraph
 Mark  Mark
 .Va n  .Va n
 paragraphs.  paragraphs.
 .It mark-whole-buffer  .It Ic mark-whole-buffer
 Marks whole buffer as a region by putting dot at the beginning and mark  Marks whole buffer as a region by putting dot at the beginning and mark
 at the end of buffer.  at the end of buffer.
 .It meta-key-mode  .It Ic meta-key-mode
 When disabled, the meta key can be used to insert extended-ascii (8-bit)  When disabled, the meta key can be used to insert extended-ascii (8-bit)
 characters.  characters.
 When enabled, the meta key acts as usual.  When enabled, the meta key acts as usual.
 .It negative-argument  .It Ic negative-argument
 Process a negative argument for keyboard-invoked functions.  Process a negative argument for keyboard-invoked functions.
 .It newline  .It Ic newline
 Insert a newline into the current buffer.  Insert a newline into the current buffer.
 .It newline-and-indent  .It Ic newline-and-indent
 Insert a newline, then enough tabs and spaces to duplicate the indentation  Insert a newline, then enough tabs and spaces to duplicate the indentation
 of the previous line.  of the previous line.
 Assumes tabs are every eight characters.  Assumes tabs are every eight characters.
 .It next-line  .It Ic next-line
 Move forward  Move forward
 .Va n  .Va n
 lines.  lines.
 .It no-tab-mode  .It Ic no-tab-mode
 Toggle notab mode.  Toggle notab mode.
 In this mode, spaces are inserted rather than tabs.  In this mode, spaces are inserted rather than tabs.
 .It not-modified  .It Ic not-modified
 Turn off the modified flag in the current buffer.  Turn off the modified flag in the current buffer.
 .It open-line  .It Ic open-line
 Open up some blank space.  Open up some blank space.
 Essentially, insert  Essentially, insert
 .Va n  .Va n
 newlines, then back up over them.  newlines, then back up over them.
 .It other-window  .It Ic other-window
 The command to make the next (down the screen) window the current  The command to make the next (down the screen) window the current
 window.  window.
 There are no real errors, although the command does nothing if  There are no real errors, although the command does nothing if
 there is only 1 window on the screen.  there is only 1 window on the screen.
 .It overwrite-mode  .It Ic overwrite-mode
 Toggle overwrite mode in the current buffer,  Toggle overwrite mode in the current buffer,
 where typing overwrites existing characters rather than inserting them.  where typing overwrites existing characters rather than inserting them.
 Can be set globally with set-default-mode.  Can be set globally with
 .It prefix-region  .Ic set-default-mode .
   .It Ic prefix-region
 Inserts a prefix string before each line of a region.  Inserts a prefix string before each line of a region.
 The prefix string is settable by using 'set-prefix-string'  The prefix string is settable by using
   .Ic set-prefix-string
 or by invoking this command with a prefix argument.  or by invoking this command with a prefix argument.
 .It previous-line  .It Ic previous-line
 Move backwards  Move backwards
 .Va n  .Va n
 lines.  lines.
 .It previous-window  .It Ic previous-window
 This command makes the previous (up the screen) window the  This command makes the previous (up the screen) window the
 current window.  current window.
 There are no errors, although the command does not do  There are no errors, although the command does not do
 a lot if there is only 1 window.  a lot if there is only 1 window.
 .It pop-tag-mark  .It Ic pop-tag-mark
 Return to position where find-tag was previously invoked.  Return to position where find-tag was previously invoked.
 .It push-shell  .It Ic push-shell
 Suspend  Suspend
 .Nm  .Nm
 and switch to alternate screen, if available.  and switch to alternate screen, if available.
 .It pwd  .It Ic pwd
 Display current (global) working directory in the status area.  Display current (global) working directory in the status area.
 .It query-replace  .It Ic query-replace
 Query Replace.  Query Replace.
 Search and replace strings selectively, prompting after each match.  Search and replace strings selectively, prompting after each match.
 .It replace-regexp  .It Ic replace-regexp
 Replace regular expression globally without individual prompting.  Replace regular expression globally without individual prompting.
 .It replace-string  .It Ic replace-string
 Replace string globally without individual prompting.  Replace string globally without individual prompting.
 .It query-replace-regexp  .It Ic query-replace-regexp
 Replace strings selectively.  Replace strings selectively.
 Does a search and replace operation using regular  Does a search and replace operation using regular
 expressions for both patterns.  expressions for both patterns.
 .It quoted-insert  .It Ic quoted-insert
 Insert the next character verbatim into the current buffer; i.e. ignore  Insert the next character verbatim into the current buffer; i.e. ignore
 any function bound to that key.  any function bound to that key.
 .It re-search-again  .It Ic re-search-again
 Perform a regular expression search again, using the same search  Perform a regular expression search again, using the same search
 string and direction as the last search command.  string and direction as the last search command.
 .It re-search-backward  .It Ic re-search-backward
 Search backwards using a regular expression.  Search backwards using a regular expression.
 Get a search string from the user, and search, starting at dot  Get a search string from the user, and search, starting at dot
 and proceeding toward the front of the buffer.  and proceeding toward the front of the buffer.
 If found, dot is left  If found, dot is left
 pointing at the first character of the pattern [the last character that  pointing at the first character of the pattern [the last character that
 was matched].  was matched].
 .It re-search-forward  .It Ic re-search-forward
 Search forward using a regular expression.  Search forward using a regular expression.
 Get a search string from the user and search for it starting at dot.  Get a search string from the user and search for it starting at dot.
 If found, move dot to just after the matched characters.  If found, move dot to just after the matched characters.
 display does all  display does all
 the hard stuff.  the hard stuff.
 If not found, it just prints a message.  If not found, it just prints a message.
 .It recenter  .It Ic recenter
 Reposition dot in the current window.  Reposition dot in the current window.
 By default, the dot is centered.  By default, the dot is centered.
 If given a positive argument (n), the display is repositioned to line  If given a positive argument (n), the display is repositioned to line
Line 819 
Line 847 
 If  If
 .Va n  .Va n
 is negative, it is that line from the bottom.  is negative, it is that line from the bottom.
 .It redraw-display  .It Ic redraw-display
 Refresh the display.  Refresh the display.
 Recomputes all window sizes in case something has changed.  Recomputes all window sizes in case something has changed.
 .It revert-buffer  .It Ic revert-buffer
 Revert the current buffer to the latest file on disk.  Revert the current buffer to the latest file on disk.
 .It save-buffer  .It Ic save-buffer
 Save the contents of the current buffer if it has been changed,  Save the contents of the current buffer if it has been changed,
 optionally creating a backup copy.  optionally creating a backup copy.
 .It save-buffers-kill-emacs  .It Ic save-buffers-kill-emacs
 Offer to save modified buffers and quit  Offer to save modified buffers and quit
 .Nm .  .Nm .
 .It save-some-buffers  .It Ic save-some-buffers
 Look through the list of buffers, offering to save any buffer that  Look through the list of buffers, offering to save any buffer that
 has been changed.  has been changed.
 Buffers that are not associated with files (such  Buffers that are not associated with files (such
 as *scratch*, *grep*, *compile*) are ignored.  as *scratch*, *grep*, *compile*) are ignored.
 .It scroll-down  .It Ic scroll-down
 Scroll backwards  Scroll backwards
 .Va n  .Va n
 pages.  pages.
 A two-line overlap between pages is  A two-line overlap between pages is
 assumed.  assumed.
 If given a repeat argument, scrolls back lines, not pages.  If given a repeat argument, scrolls back lines, not pages.
 .It scroll-one-line-down  .It Ic scroll-one-line-down
 Scroll the display down  Scroll the display down
 .Va n  .Va n
 lines without changing the cursor position.  lines without changing the cursor position.
 .It scroll-one-line-up  .It Ic scroll-one-line-up
 Scroll the display  Scroll the display
 .Va n  .Va n
 lines up without moving the cursor position.  lines up without moving the cursor position.
 .It scroll-other-window  .It Ic scroll-other-window
 Scroll the next window in the window list window forward  Scroll the next window in the window list window forward
 .Va n  .Va n
 pages.  pages.
 .It scroll-up  .It Ic scroll-up
 Scroll forward one page.  Scroll forward one page.
 A two-line overlap between pages is  A two-line overlap between pages is
 assumed.  assumed.
 If given a repeat argument, scrolls back lines, not pages.  If given a repeat argument, scrolls back lines, not pages.
 .It search-again  .It Ic search-again
 Search again, using the same search string and direction as the last  Search again, using the same search string and direction as the last
 search command.  search command.
 .It search-backward  .It Ic search-backward
 Reverse search.  Reverse search.
 Get a search string from the user, and search, starting  Get a search string from the user, and search, starting
 at dot and proceeding toward the front of the buffer.  at dot and proceeding toward the front of the buffer.
 If found, dot is  If found, dot is
 left pointing at the first character of the pattern (the last character  left pointing at the first character of the pattern (the last character
 that was matched).  that was matched).
 .It search-forward  .It Ic search-forward
 Search forward.  Search forward.
 Get a search string from the user, and search for it  Get a search string from the user, and search for it
 starting at dot.  starting at dot.
 If found, dot gets moved to just after the matched  If found, dot gets moved to just after the matched
 characters, if not found, print a message.  characters, if not found, print a message.
 .It self-insert-command  .It Ic self-insert-command
 Insert a character.  Insert a character.
 .It sentence-end-double-space  .It Ic sentence-end-double-space
 Toggle double or single spaces for end of sentences.  Toggle double or single spaces for end of sentences.
 Double is the default.  Double is the default.
 Currently only affects fill-paragraph.  Currently only affects fill-paragraph.
 .It set-case-fold-search  .It Ic set-case-fold-search
 Set case-fold searching, causing case not to matter  Set case-fold searching, causing case not to matter
 in regular expression searches.  in regular expression searches.
 This is the default.  This is the default.
 .It set-case-replace  .It Ic set-case-replace
 Preserve the case of the replaced string.  Preserve the case of the replaced string.
 This is the default.  This is the default.
 .It set-default-mode  .It Ic set-default-mode
 Append the supplied mode to the list of default modes  Append the supplied mode to the list of default modes
 used by subsequent buffer creation.  used by subsequent buffer creation.
 Built in modes include: fill, indent and overwrite.  Built in modes include: fill, indent and overwrite.
 .It set-fill-column  .It Ic set-fill-column
 Prompt the user for a fill column.  Prompt the user for a fill column.
 Used by auto-fill-mode.  Used by
 .It set-mark-command  .Ic auto-fill-mode .
   .It Ic set-mark-command
 Sets the mark in the current window to the current dot location.  Sets the mark in the current window to the current dot location.
 .It set-prefix-string  .It Ic set-prefix-string
 Sets the prefix string to be used by the 'prefix-region' command.  Sets the prefix string to be used by the
 .It set-tab-width  .Ic prefix-region
   command.
   .It Ic set-tab-width
 Set the tab width for the current buffer, or the default for new buffers  Set the tab width for the current buffer, or the default for new buffers
 if called with a prefix argument or from the startup file.  if called with a prefix argument or from the startup file.
 .It shell-command  .It Ic shell-command
 Execute external command from mini-buffer.  Execute external command from mini-buffer.
 .It shell-command-on-region  .It Ic shell-command-on-region
 Provide the text in region to the shell command as input.  Provide the text in region to the shell command as input.
 .It shrink-window  .It Ic shrink-window
 Shrink current window by one line.  Shrink current window by one line.
 The window immediately below is expanded to pick up the slack.  The window immediately below is expanded to pick up the slack.
 If only one window is present, this command has no effect.  If only one window is present, this command has no effect.
 .It split-window-vertically  .It Ic split-window-vertically
 Split the current window.  Split the current window.
 A window smaller than 3 lines cannot be split.  A window smaller than 3 lines cannot be split.
 .It start-kbd-macro  .It Ic start-kbd-macro
 Start defining a keyboard macro.  Start defining a keyboard macro.
 Macro definition is ended by invoking end-kbd-macro.  Macro definition is ended by invoking end-kbd-macro.
 .It suspend-emacs  .It Ic suspend-emacs
 Suspend  Suspend
 .Nm  .Nm
 and switch back to alternate screen, if in use.  and switch back to alternate screen, if in use.
 .It switch-to-buffer  .It Ic switch-to-buffer
 Prompt and switch to a new buffer in the current window.  Prompt and switch to a new buffer in the current window.
 .It switch-to-buffer-other-window  .It Ic switch-to-buffer-other-window
 Switch to buffer in another window.  Switch to buffer in another window.
 .It toggle-read-only  .It Ic toggle-read-only
 Toggle the read-only flag on the current buffer.  Toggle the read-only flag on the current buffer.
 .It toggle-read-only-all  .It Ic toggle-read-only-all
 Toggle the read-only flag on all non-ephemeral buffers.  Toggle the read-only flag on all non-ephemeral buffers.
 A simple toggle that switches a global read-only flag either on  A simple toggle that switches a global read-only flag either on
 or off.  or off.
 .It transpose-chars  .It Ic transpose-chars
 Transpose the two characters in front of and under dot,  Transpose the two characters in front of and under dot,
 then move forward one character.  then move forward one character.
 Treat newline characters the same as any other.  Treat newline characters the same as any other.
 .It transpose-paragraphs  .It Ic transpose-paragraphs
 Transpose adjacent paragraphs.  Transpose adjacent paragraphs.
 If multiple iterations are requested, the current paragraph will  If multiple iterations are requested, the current paragraph will
 be moved  be moved
 .Va n  .Va n
 paragraphs forward.  paragraphs forward.
 .It transpose-words  .It Ic transpose-words
 Transpose adjacent words.  Transpose adjacent words.
 .It undo  .It Ic undo
 Undo the most recent action.  Undo the most recent action.
 If invoked again without an intervening command,  If invoked again without an intervening command,
 move the undo pointer to the previous action and undo it.  move the undo pointer to the previous action and undo it.
 .It undo-boundary  .It Ic undo-boundary
 Add an undo boundary.  Add an undo boundary.
 This is not usually done interactively.  This is not usually done interactively.
 .It undo-boundary-toggle  .It Ic undo-boundary-toggle
 Toggle whether undo boundaries are generated.  Toggle whether undo boundaries are generated.
 Undo boundaries are often disabled before operations that should  Undo boundaries are often disabled before operations that should
 be considered atomically undoable.  be considered atomically undoable.
 .It undo-enable  .It Ic undo-enable
 Toggle whether undo information is kept.  Toggle whether undo information is kept.
 .It undo-list  .It Ic undo-list
 Show the undo records for the current buffer in a new buffer.  Show the undo records for the current buffer in a new buffer.
 .It universal-argument  .It Ic universal-argument
 Repeat the next command 4 times.  Repeat the next command 4 times.
 Usually bound to C-u.  Usually bound to C-u.
 This command may be stacked; e.g.\&  This command may be stacked; e.g.\&
 C-u C-u C-f moves the cursor forward 16 characters.  C-u C-u C-f moves the cursor forward 16 characters.
 .It upcase-region  .It Ic upcase-region
 Upper case region.  Upper case region.
 Change all of the lower case characters in the region to  Change all of the lower case characters in the region to
 upper case.  upper case.
 .It upcase-word  .It Ic upcase-word
 Move the cursor forward by the specified number of words.  Move the cursor forward by the specified number of words.
 As it moves, convert any characters to upper case.  As it moves, convert any characters to upper case.
 .It visible-bell  .It Ic visible-bell
 Toggle the visible bell.  Toggle the visible bell.
 If this toggle is on, the modeline will flash.  If this toggle is on, the modeline will flash.
 .It visit-tags-table  .It Ic visit-tags-table
 Load tags file to be used for subsequent find-tag.  Load tags file to be used for subsequent
 .It what-cursor-position  .Ic find-tag .
   .It Ic what-cursor-position
 Display a bunch of useful information about the current location of  Display a bunch of useful information about the current location of
 dot.  dot.
 The character under the cursor (in octal), the current line, row,  The character under the cursor (in octal), the current line, row,
Line 982 
Line 1014 
 percentage) is displayed.  percentage) is displayed.
 The column position assumes an infinite  The column position assumes an infinite
 position display; it does not truncate just because the screen does.  position display; it does not truncate just because the screen does.
 .It write-file  .It Ic write-file
 Ask for a file name and write the contents of the current buffer to  Ask for a file name and write the contents of the current buffer to
 that file.  that file.
 Update the remembered file name and clear the buffer  Update the remembered file name and clear the buffer
 changed flag.  changed flag.
 .It yank  .It Ic yank
 Yank text from kill-buffer.  Yank text from
   .Ic kill-buffer .
 Unlike emacs, the  Unlike emacs, the
 .Nm  .Nm
 kill buffer consists only  kill buffer consists only
 of the most recent kill.  of the most recent kill.
 It is not a ring.  It is not a ring.
 .It zap-to-char  .It Ic zap-to-char
 Ask for a character and delete text from the current cursor position  Ask for a character and delete text from the current cursor position
 until the next instance of that character, including it.  until the next instance of that character, including it.
 .It zap-up-to-char  .It Ic zap-up-to-char
 Like zap-to-char but doesn't delete the target character.  Like
   .Ic zap-to-char
   but doesn't delete the target character.
 .El  .El
 .Sh MG DIRED KEY BINDINGS  .Sh MG DIRED KEY BINDINGS
 Specific key bindings are available in dired mode.  Specific key bindings are available in dired mode.
Line 1044 
Line 1079 
 .Sh MG DIRED COMMANDS  .Sh MG DIRED COMMANDS
 The following are a list of the commands specific to dired mode:  The following are a list of the commands specific to dired mode:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It dired-create-directory  .It Ic dired-create-directory
 Create a directory.  Create a directory.
 .It dired-do-copy  .It Ic dired-do-copy
 Copy the file listed on the current line of the dired buffer.  Copy the file listed on the current line of the dired buffer.
 .It dired-do-flagged-delete  .It Ic dired-do-flagged-delete
 Delete the files that have been flagged for deletion.  Delete the files that have been flagged for deletion.
 .It dired-do-rename  .It Ic dired-do-rename
 Rename the file listed on the current line of the dired buffer.  Rename the file listed on the current line of the dired buffer.
 .It dired-find-alternate-file  .It Ic dired-find-alternate-file
 Replace the current dired buffer with an alternate one as specified  Replace the current dired buffer with an alternate one as specified
 by the position of the cursor in the dired buffer.  by the position of the cursor in the dired buffer.
 .It dired-find-file  .It Ic dired-find-file
 Open the file on the current line of the dired buffer.  Open the file on the current line of the dired buffer.
 If the cursor is on a directory, it will be opened in dired mode.  If the cursor is on a directory, it will be opened in dired mode.
 .It dired-flag-file-deletion  .It Ic dired-flag-file-deletion
 Flag the file listed on the current line for deletion.  Flag the file listed on the current line for deletion.
 This is indicated in the buffer by putting a D at the left margin.  This is indicated in the buffer by putting a D at the left margin.
 No files are actually deleted until the function dired-do-flagged-delete  No files are actually deleted until the function
   .Ic dired-do-flagged-delete
 is executed.  is executed.
 .It dired-find-file-other-window  .It Ic dired-find-file-other-window
 Open the file on the current line of the dired buffer in a  Open the file on the current line of the dired buffer in a
 different window.  different window.
 .It dired-goto-file  .It Ic dired-goto-file
 Move the cursor to a file name in the dired buffer.  Move the cursor to a file name in the dired buffer.
 .It dired-next-line  .It Ic dired-next-line
 Move the cursor to the next line.  Move the cursor to the next line.
 .It dired-other-window  .It Ic dired-other-window
 This function works just like dired, except that it puts the  This function works just like dired, except that it puts the
 dired buffer in another window.  dired buffer in another window.
 .It dired-previous-line  .It Ic dired-previous-line
 Move the cursor to the previous line.  Move the cursor to the previous line.
 .It dired-revert  .It Ic dired-revert
 Refresh the dired buffer while retaining any flags.  Refresh the dired buffer while retaining any flags.
 .It dired-scroll-down  .It Ic dired-scroll-down
 Scroll down the dired buffer.  Scroll down the dired buffer.
 .It dired-scroll-up  .It Ic dired-scroll-up
 Scroll up the dired buffer.  Scroll up the dired buffer.
 .It dired-shell-command  .It Ic dired-shell-command
 Pipe the file under the current cursor position through a shell command.  Pipe the file under the current cursor position through a shell command.
 .It dired-unmark  .It Ic dired-unmark
 Remove the deletion flag for the file on the current line.  Remove the deletion flag for the file on the current line.
 .It dired-unmark-backward  .It Ic dired-unmark-backward
 Remove the deletion flag from the file listed on the previous line  Remove the deletion flag from the file listed on the previous line
 of the dired buffer, then move up to that line.  of the dired buffer, then move up to that line.
 .It quit-window  .It Ic quit-window
 Close the current dired buffer.  Close the current dired buffer.
 .El  .El
 .Sh CONFIGURATION FILES  .Sh CONFIGURATION FILES
Line 1147 
Line 1183 
 .Pp  .Pp
 In order to use 8-bit characters (such as German umlauts), the Meta key  In order to use 8-bit characters (such as German umlauts), the Meta key
 needs to be disabled via the  needs to be disabled via the
 .Dq meta-key-mode  .Ic meta-key-mode
 command.  command.
 .Pp  .Pp
 Multi-byte character sets, such as UTF-8, are not supported.  Multi-byte character sets, such as UTF-8, are not supported.
Legend:
Removed from v.1.132  
changed lines
  Added in v.1.133