Readline-8.1 distribution sources and documentationreadline-8.1

1 files changed, 256 insertions, 245 deletions

diff --git a/doc/readline.0 b/doc/readline.0
index 3654f6f..d32329b 100644
--- a/doc/readline.0
+++ b/doc/readline.0
@@ -14,14 +14,14 @@ READLINE(3)                Library Functions Manual                READLINE(3)
        readline (const char *prompt);
 
 COPYRIGHT
-       Readline is Copyright (C) 1989-2014 Free Software Foundation,  Inc.
+       Readline is Copyright (C) 1989-2020 Free Software Foundation,  Inc.
 
 DESCRIPTION
        readline will read a line from the terminal and return it, using prompt
-       as a prompt.  If prompt is NULL or  the  empty  string,  no  prompt  is
-       issued.  The line returned is allocated with malloc(3); the caller must
-       free it when  finished.   The  line  returned  has  the  final  newline
-       removed, so only the text of the line remains.
+       as a prompt.  If prompt is NULL or the empty string, no prompt  is  is-
+       sued.   The  line returned is allocated with malloc(3); the caller must
+       free it when finished.  The line returned has  the  final  newline  re-
+       moved, so only the text of the line remains.
 
        readline  offers  editing  capabilities  while the user is entering the
        line.  By default, the line editing commands are similar  to  those  of
@@ -62,8 +62,8 @@ READLINE(3)                Library Functions Manual                READLINE(3)
 INITIALIZATION FILE
        Readline  is  customized  by putting commands in an initialization file
        (the inputrc file).  The name of this file is taken from the  value  of
-       the  INPUTRC  environment  variable.   If  that  variable is unset, the
-       default is ~/.inputrc.  If that file  does not exist or cannot be read,
+       the  INPUTRC  environment variable.  If that variable is unset, the de-
+       fault is ~/.inputrc.  If that file  does not exist or cannot  be  read,
        the  ultimate  default  is /etc/inputrc.  When a program which uses the
        readline library starts up, the init file is read, and the key bindings
        and  variables  are set.  There are only a few basic constructs allowed
@@ -223,10 +223,10 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               ber of possible completions generated  by  the  possible-comple-
               tions  command.  It may be set to any integer value greater than
               or equal to zero.  If the  number  of  possible  completions  is
-              greater than or equal to the value of this variable, the user is
-              asked whether or not he wishes to view them; otherwise they  are
-              simply listed on the terminal.  A negative value causes readline
-              to never ask.
+              greater  than  or  equal to the value of this variable, readline
+              will ask whether or not the user wishes to view them;  otherwise
+              they are simply listed on the terminal.  A negative value causes
+              readline to never ask.
        convert-meta (On)
               If set to On, readline will convert characters with  the  eighth
               bit set to an ASCII key sequence by stripping the eighth bit and
@@ -254,7 +254,7 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               escapes  to  begin and end sequences of non-printing characters,
               which can be used to embed a terminal control sequence into  the
               mode string.
-       enable-bracketed-paste (Off)
+       enable-bracketed-paste (On)
               When  set  to  On, readline will configure the terminal in a way
               that will enable it to insert each paste into the editing buffer
               as a single string of characters, instead of treating each char-
@@ -263,15 +263,15 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               mands.
        enable-keypad (Off)
               When set to On, readline will try to enable the application key-
-              pad  when  it  is  called.  Some systems need this to enable the
-              arrow keys.
+              pad when it is called.  Some systems need this to enable the ar-
+              row keys.
        enable-meta-key (On)
               When set to On, readline will try to enable  any  meta  modifier
               key  the  terminal claims to support when it is called.  On many
               terminals, the meta key is used to send eight-bit characters.
        expand-tilde (Off)
-              If set  to  On,  tilde  expansion  is  performed  when  readline
-              attempts word completion.
+              If set to On, tilde expansion is  performed  when  readline  at-
+              tempts word completion.
        history-preserve-point (Off)
               If  set  to  On, the history code attempts to place point at the
               same location on each history line retrieved with  previous-his-
@@ -288,166 +288,167 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               When  set  to  On, makes readline use a single line for display,
               scrolling the input horizontally on a single screen line when it
               becomes  longer  than the screen width rather than wrapping to a
-              new line.
+              new line.  This setting is automatically enabled  for  terminals
+              of height 1.
        input-meta (Off)
-              If set to On, readline will enable eight-bit input (that is,  it
-              will  not  clear  the  eighth  bit  in the characters it reads),
-              regardless of what the terminal claims it can support.  The name
-              meta-flag  is  a synonym for this variable.  The default is Off,
-              but readline will set it to On if the locale contains  eight-bit
+              If  set to On, readline will enable eight-bit input (that is, it
+              will not clear the eighth bit in the characters it  reads),  re-
+              gardless  of  what the terminal claims it can support.  The name
+              meta-flag is a synonym for this variable.  The default  is  Off,
+              but  readline will set it to On if the locale contains eight-bit
               characters.
        isearch-terminators (``C-[ C-J'')
-              The  string  of  characters that should terminate an incremental
-              search without subsequently executing the character  as  a  com-
-              mand.   If this variable has not been given a value, the charac-
+              The string of characters that should  terminate  an  incremental
+              search  without  subsequently  executing the character as a com-
+              mand.  If this variable has not been given a value, the  charac-
               ters ESC and C-J will terminate an incremental search.
        keymap (emacs)
-              Set the current readline keymap.  The set of legal keymap  names
-              is  emacs,  emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move,
-              vi-command, and vi-insert.   vi  is  equivalent  to  vi-command;
-              emacs  is  equivalent  to  emacs-standard.  The default value is
-              emacs.  The value  of  editing-mode  also  affects  the  default
+              Set  the current readline keymap.  The set of legal keymap names
+              is emacs, emacs-standard, emacs-meta, emacs-ctlx,  vi,  vi-move,
+              vi-command,  and  vi-insert.   vi  is  equivalent to vi-command;
+              emacs is equivalent to emacs-standard.   The  default  value  is
+              emacs.   The  value  of  editing-mode  also  affects the default
               keymap.
        keyseq-timeout (500)
-              Specifies  the  duration readline will wait for a character when
-              reading an ambiguous key sequence (one that can form a  complete
+              Specifies the duration readline will wait for a  character  when
+              reading  an ambiguous key sequence (one that can form a complete
               key sequence using the input read so far, or can take additional
-              input to complete a  longer  key  sequence).   If  no  input  is
-              received  within  the timeout, readline will use the shorter but
-              complete key sequence.  The value is specified in  milliseconds,
-              so  a value of 1000 means that readline will wait one second for
-              additional input.  If this variable is set to a value less  than
-              or  equal to zero, or to a non-numeric value, readline will wait
-              until another key is pressed to decide  which  key  sequence  to
+              input  to  complete  a longer key sequence).  If no input is re-
+              ceived within the timeout, readline will  use  the  shorter  but
+              complete  key sequence.  The value is specified in milliseconds,
+              so a value of 1000 means that readline will wait one second  for
+              additional  input.  If this variable is set to a value less than
+              or equal to zero, or to a non-numeric value, readline will  wait
+              until  another  key  is  pressed to decide which key sequence to
               complete.
        mark-directories (On)
               If set to On, completed directory names have a slash appended.
        mark-modified-lines (Off)
-              If  set  to  On,  history lines that have been modified are dis-
+              If set to On, history lines that have  been  modified  are  dis-
               played with a preceding asterisk (*).
        mark-symlinked-directories (Off)
               If set to On, completed names which are symbolic links to direc-
-              tories   have   a  slash  appended  (subject  to  the  value  of
-              mark-directories).
+              tories have a slash appended (subject to the value  of  mark-di-
+              rectories).
        match-hidden-files (On)
-              This variable, when set to On, causes readline  to  match  files
-              whose  names  begin  with  a  `.' (hidden files) when performing
-              filename completion.  If set to Off, the  leading  `.'  must  be
+              This  variable,  when  set to On, causes readline to match files
+              whose names begin with a  `.'  (hidden  files)  when  performing
+              filename  completion.   If  set  to Off, the leading `.' must be
               supplied by the user in the filename to be completed.
        menu-complete-display-prefix (Off)
-              If  set to On, menu completion displays the common prefix of the
+              If set to On, menu completion displays the common prefix of  the
               list of possible completions (which may be empty) before cycling
               through the list.
        output-meta (Off)
-              If  set  to On, readline will display characters with the eighth
+              If set to On, readline will display characters with  the  eighth
               bit set directly rather than as a meta-prefixed escape sequence.
               The default is Off, but readline will set it to On if the locale
               contains eight-bit characters.
        page-completions (On)
-              If set to On, readline uses an internal more-like pager to  dis-
+              If  set to On, readline uses an internal more-like pager to dis-
               play a screenful of possible completions at a time.
        print-completions-horizontally (Off)
-              If  set  to  On,  readline will display completions with matches
-              sorted horizontally in alphabetical order, rather than down  the
+              If set to On, readline will  display  completions  with  matches
+              sorted  horizontally in alphabetical order, rather than down the
               screen.
        revert-all-at-newline (Off)
-              If  set  to  On, readline will undo all changes to history lines
+              If set to On, readline will undo all changes  to  history  lines
               before returning when accept-line is executed.  By default, his-
-              tory  lines  may  be  modified  and retain individual undo lists
+              tory lines may be modified  and  retain  individual  undo  lists
               across calls to readline.
        show-all-if-ambiguous (Off)
-              This alters the default behavior of  the  completion  functions.
+              This  alters  the  default behavior of the completion functions.
               If set to On, words which have more than one possible completion
-              cause the matches to be listed immediately  instead  of  ringing
+              cause  the  matches  to be listed immediately instead of ringing
               the bell.
        show-all-if-unmodified (Off)
-              This  alters the default behavior of the completion functions in
+              This alters the default behavior of the completion functions  in
               a fashion similar to show-all-if-ambiguous.  If set to On, words
-              which  have more than one possible completion without any possi-
-              ble partial completion (the possible completions don't  share  a
-              common  prefix)  cause  the  matches  to  be  listed immediately
-              instead of ringing the bell.
+              which have more than one possible completion without any  possi-
+              ble  partial  completion (the possible completions don't share a
+              common prefix) cause the matches to be  listed  immediately  in-
+              stead of ringing the bell.
        show-mode-in-prompt (Off)
-              If set to On, add a string to the beginning of the prompt  indi-
-              cating  the  editing  mode:  emacs, vi command, or vi insertion.
+              If  set to On, add a string to the beginning of the prompt indi-
+              cating the editing mode: emacs, vi  command,  or  vi  insertion.
               The mode strings are user-settable (e.g., emacs-mode-string).
        skip-completed-text (Off)
-              If set to On, this alters the default completion  behavior  when
-              inserting  a  single match into the line.  It's only active when
-              performing completion in the middle  of  a  word.   If  enabled,
-              readline  does  not  insert  characters from the completion that
-              match characters after point in the  word  being  completed,  so
+              If  set  to On, this alters the default completion behavior when
+              inserting a single match into the line.  It's only  active  when
+              performing  completion  in  the  middle  of a word.  If enabled,
+              readline does not insert characters  from  the  completion  that
+              match  characters  after  point  in the word being completed, so
               portions of the word following the cursor are not duplicated.
        vi-cmd-mode-string ((cmd))
-              If  the  show-mode-in-prompt variable is enabled, this string is
+              If the show-mode-in-prompt variable is enabled, this  string  is
               displayed immediately before the last line of the primary prompt
-              when  vi  editing mode is active and in command mode.  The value
+              when vi editing mode is active and in command mode.   The  value
               is expanded like a key binding, so the standard set of meta- and
-              control  prefixes  and  backslash escape sequences is available.
-              Use the \1 and \2 escapes to begin and  end  sequences  of  non-
-              printing  characters, which can be used to embed a terminal con-
+              control prefixes and backslash escape  sequences  is  available.
+              Use  the  \1  and  \2 escapes to begin and end sequences of non-
+              printing characters, which can be used to embed a terminal  con-
               trol sequence into the mode string.
        vi-ins-mode-string ((ins))
-              If the show-mode-in-prompt variable is enabled, this  string  is
+              If  the  show-mode-in-prompt variable is enabled, this string is
               displayed immediately before the last line of the primary prompt
               when vi editing mode is active and in insertion mode.  The value
               is expanded like a key binding, so the standard set of meta- and
-              control prefixes and backslash escape  sequences  is  available.
-              Use  the  \1  and  \2 escapes to begin and end sequences of non-
-              printing characters, which can be used to embed a terminal  con-
+              control  prefixes  and  backslash escape sequences is available.
+              Use the \1 and \2 escapes to begin and  end  sequences  of  non-
+              printing  characters, which can be used to embed a terminal con-
               trol sequence into the mode string.
        visible-stats (Off)
-              If  set to On, a character denoting a file's type as reported by
-              stat(2) is appended to the filename when listing  possible  com-
+              If set to On, a character denoting a file's type as reported  by
+              stat(2)  is  appended to the filename when listing possible com-
               pletions.
 
    Conditional Constructs
-       Readline  implements  a  facility  similar in spirit to the conditional
-       compilation features of the C preprocessor which  allows  key  bindings
-       and  variable  settings  to be performed as the result of tests.  There
+       Readline implements a facility similar in  spirit  to  the  conditional
+       compilation  features  of  the C preprocessor which allows key bindings
+       and variable settings to be performed as the result  of  tests.   There
        are four parser directives used.
 
-       $if    The $if construct allows bindings to be made based on the  edit-
-              ing  mode,  the  terminal  being  used, or the application using
-              readline.  The text of the test, after any comparison  operator,
+       $if    The  $if construct allows bindings to be made based on the edit-
+              ing mode, the terminal being  used,  or  the  application  using
+              readline.   The text of the test, after any comparison operator,
               extends to the end of the line; unless otherwise noted, no char-
               acters are required to isolate it.
 
-              mode   The mode= form of the  $if  directive  is  used  to  test
-                     whether  readline  is  in  emacs or vi mode.  This may be
-                     used in conjunction with  the  set  keymap  command,  for
-                     instance,  to  set  bindings  in  the  emacs-standard and
-                     emacs-ctlx keymaps only if readline is  starting  out  in
-                     emacs mode.
+              mode   The  mode=  form  of  the  $if  directive is used to test
+                     whether readline is in emacs or vi  mode.   This  may  be
+                     used  in conjunction with the set keymap command, for in-
+                     stance, to set bindings in the emacs-standard and  emacs-
+                     ctlx  keymaps  only  if readline is starting out in emacs
+                     mode.
 
-              term   The  term=  form may be used to include terminal-specific
+              term   The term= form may be used to  include  terminal-specific
                      key bindings, perhaps to bind the key sequences output by
                      the terminal's function keys.  The word on the right side
-                     of the = is tested against the full name of the  terminal
-                     and  the portion of the terminal name before the first -.
-                     This allows sun  to  match  both  sun  and  sun-cmd,  for
-                     instance.
+                     of  the = is tested against the full name of the terminal
+                     and the portion of the terminal name before the first  -.
+                     This  allows  sun  to match both sun and sun-cmd, for in-
+                     stance.
 
               version
-                     The  version  test  may  be  used  to perform comparisons
-                     against specific readline versions.  The version  expands
-                     to  the  current readline version.  The set of comparison
-                     operators includes =, (and ==), !=, <=,  >=,  <,  and  >.
-                     The  version  number  supplied  on  the right side of the
-                     operator consists of a major version number, an  optional
+                     The version test  may  be  used  to  perform  comparisons
+                     against  specific readline versions.  The version expands
+                     to the current readline version.  The set  of  comparison
+                     operators  includes  =,  (and  ==), !=, <=, >=, <, and >.
+                     The version number supplied on the right side of the  op-
+                     erator  consists  of  a major version number, an optional
                      decimal point, and an optional minor version (e.g., 7.1).
-                     If the minor version is omitted, it is assumed to  be  0.
+                     If  the  minor version is omitted, it is assumed to be 0.
                      The operator may be separated from the string version and
                      from the version number argument by whitespace.
 
               application
                      The application construct is used to include application-
-                     specific  settings.   Each  program  using  the  readline
-                     library sets the application name, and an  initialization
+                     specific settings.  Each program using the  readline  li-
+                     brary  sets  the  application name, and an initialization
                      file can test for a particular value.  This could be used
-                     to bind key sequences to functions useful for a  specific
-                     program.   For instance, the following command adds a key
-                     sequence that quotes the  current  or  previous  word  in
+                     to  bind key sequences to functions useful for a specific
+                     program.  For instance, the following command adds a  key
+                     sequence  that  quotes  the  current  or previous word in
                      bash:
 
                      $if Bash
@@ -457,12 +458,12 @@ READLINE(3)                Library Functions Manual                READLINE(3)
 
               variable
                      The variable construct provides simple equality tests for
-                     readline variables and values.  The permitted  comparison
-                     operators  are  =, ==, and !=.  The variable name must be
+                     readline  variables and values.  The permitted comparison
+                     operators are =, ==, and !=.  The variable name  must  be
                      separated from the comparison operator by whitespace; the
-                     operator  may  be  separated  from the value on the right
-                     hand side by whitespace.  Both string and  boolean  vari-
-                     ables  may  be  tested.  Boolean variables must be tested
+                     operator may be separated from the  value  on  the  right
+                     hand  side  by whitespace.  Both string and boolean vari-
+                     ables may be tested. Boolean  variables  must  be  tested
                      against the values on and off.
 
        $endif This command, as seen in the previous example, terminates an $if
@@ -472,53 +473,53 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               test fails.
 
        $include
-              This directive takes a single filename as an argument and  reads
-              commands  and bindings from that file.  For example, the follow-
+              This  directive takes a single filename as an argument and reads
+              commands and bindings from that file.  For example, the  follow-
               ing directive would read /etc/inputrc:
 
               $include  /etc/inputrc
 
 SEARCHING
-       Readline provides commands for searching through  the  command  history
-       for  lines  containing a specified string.  There are two search modes:
+       Readline  provides  commands  for searching through the command history
+       for lines containing a specified string.  There are two  search  modes:
        incremental and non-incremental.
 
-       Incremental searches begin before the  user  has  finished  typing  the
-       search  string.  As each character of the search string is typed, read-
+       Incremental  searches  begin  before  the  user has finished typing the
+       search string.  As each character of the search string is typed,  read-
        line displays the next entry from the history matching the string typed
-       so  far.   An  incremental  search  requires only as many characters as
-       needed to find the desired history entry.  To search  backward  in  the
+       so far.  An incremental search requires  only  as  many  characters  as
+       needed  to  find  the desired history entry.  To search backward in the
        history for a particular string, type C-r.  Typing C-s searches forward
-       through the history.  The  characters  present  in  the  value  of  the
-       isearch-terminators  variable  are  used  to  terminate  an incremental
-       search.  If that variable has not been assigned a value the Escape  and
+       through  the  history.   The  characters  present  in  the value of the
+       isearch-terminators variable  are  used  to  terminate  an  incremental
+       search.   If that variable has not been assigned a value the Escape and
        C-J characters will terminate an incremental search.  C-G will abort an
-       incremental search and restore the original line.  When the  search  is
-       terminated,  the history entry containing the search string becomes the
+       incremental  search  and restore the original line.  When the search is
+       terminated, the history entry containing the search string becomes  the
        current line.
 
-       To find other matching entries in the history list, type C-s or C-r  as
-       appropriate.   This  will search backward or forward in the history for
-       the next line matching the search string typed so far.  Any  other  key
+       To  find other matching entries in the history list, type C-s or C-r as
+       appropriate.  This will search backward or forward in the  history  for
+       the  next  line matching the search string typed so far.  Any other key
        sequence bound to a readline command will terminate the search and exe-
-       cute that command.  For instance, a newline will terminate  the  search
-       and  accept  the  line,  thereby executing the command from the history
+       cute  that  command.  For instance, a newline will terminate the search
+       and accept the line, thereby executing the  command  from  the  history
        list.  A movement command will terminate the search, make the last line
        found the current line, and begin editing.
 
-       Non-incremental  searches read the entire search string before starting
-       to search for matching history lines.  The search string may  be  typed
+       Non-incremental searches read the entire search string before  starting
+       to  search  for matching history lines.  The search string may be typed
        by the user or be part of the contents of the current line.
 
 EDITING COMMANDS
-       The  following  is  a list of the names of the commands and the default
+       The following is a list of the names of the commands  and  the  default
        key sequences to which they are bound.  Command names without an accom-
        panying key sequence are unbound by default.
 
        In the following descriptions, point refers to the current cursor posi-
-       tion, and mark refers to a cursor position saved by the  set-mark  com-
-       mand.   The  text  between  the  point  and  mark is referred to as the
-       region.
+       tion,  and  mark refers to a cursor position saved by the set-mark com-
+       mand.  The text between the point and mark is referred to  as  the  re-
+       gion.
 
    Commands for Moving
        beginning-of-line (C-a)
@@ -533,115 +534,125 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               Move forward to the end of the next word.  Words are composed of
               alphanumeric characters (letters and digits).
        backward-word (M-b)
-              Move  back  to the start of the current or previous word.  Words
+              Move back to the start of the current or previous  word.   Words
               are composed of alphanumeric characters (letters and digits).
        previous-screen-line
-              Attempt to move point to the same physical screen column on  the
-              previous  physical  screen  line. This will not have the desired
-              effect if the current Readline line does not take up  more  than
-              one  physical line or if point is not greater than the length of
+              Attempt  to move point to the same physical screen column on the
+              previous physical screen line. This will not  have  the  desired
+              effect  if  the current Readline line does not take up more than
+              one physical line or if point is not greater than the length  of
               the prompt plus the screen width.
        next-screen-line
-              Attempt to move point to the same physical screen column on  the
+              Attempt  to move point to the same physical screen column on the
               next physical screen line. This will not have the desired effect
-              if the current Readline line does not  take  up  more  than  one
-              physical  line  or if the length of the current Readline line is
+              if  the  current  Readline  line  does not take up more than one
+              physical line or if the length of the current Readline  line  is
               not greater than the length of the prompt plus the screen width.
+       clear-display (M-C-l)
+              Clear  the  screen  and,  if possible, the terminal's scrollback
+              buffer, then redraw the current line, leaving the  current  line
+              at the top of the screen.
        clear-screen (C-l)
-              Clear the screen leaving the current line  at  the  top  of  the
-              screen.   With  an  argument,  refresh  the current line without
-              clearing the screen.
+              Clear the screen, then redraw the current line, leaving the cur-
+              rent line at the top of the screen.  With an  argument,  refresh
+              the current line without clearing the screen.
        redraw-current-line
               Refresh the current line.
 
    Commands for Manipulating the History
        accept-line (Newline, Return)
               Accept the line regardless of where the cursor is.  If this line
-              is  non-empty,  it  may  be added to the history list for future
-              recall with add_history().  If the line is  a  modified  history
+              is non-empty, it may be added to the history list for future re-
+              call  with  add_history().   If  the  line is a modified history
               line, the history line is restored to its original state.
        previous-history (C-p)
               Fetch the previous command from the history list, moving back in
               the list.
        next-history (C-n)
-              Fetch the next command from the history list, moving forward  in
+              Fetch  the next command from the history list, moving forward in
               the list.
        beginning-of-history (M-<)
               Move to the first line in the history.
        end-of-history (M->)
-              Move  to  the end of the input history, i.e., the line currently
+              Move to the end of the input history, i.e., the  line  currently
               being entered.
        reverse-search-history (C-r)
-              Search backward starting at the current  line  and  moving  `up'
-              through  the  history  as  necessary.   This  is  an incremental
+              Search  backward  starting  at  the current line and moving `up'
+              through the  history  as  necessary.   This  is  an  incremental
               search.
        forward-search-history (C-s)
-              Search forward starting at the current line  and  moving  `down'
-              through  the  history  as  necessary.   This  is  an incremental
+              Search  forward  starting  at the current line and moving `down'
+              through the  history  as  necessary.   This  is  an  incremental
               search.
        non-incremental-reverse-search-history (M-p)
               Search backward through the history starting at the current line
-              using  a  non-incremental  search  for  a string supplied by the
+              using a non-incremental search for  a  string  supplied  by  the
               user.
        non-incremental-forward-search-history (M-n)
-              Search forward  through  the  history  using  a  non-incremental
+              Search  forward  through  the  history  using  a non-incremental
               search for a string supplied by the user.
        history-search-backward
               Search backward through the history for the string of characters
-              between the start of the current line  and  the  current  cursor
-              position  (the  point).   The  search  string  must match at the
-              beginning of a history line.  This is a non-incremental search.
+              between the start of the current line and the current cursor po-
+              sition (the point).  The search string must match at the  begin-
+              ning of a history line.  This is a non-incremental search.
        history-search-forward
-              Search forward through the history for the string of  characters
+              Search  forward through the history for the string of characters
               between the start of the current line and the point.  The search
               string must match at the beginning of a history line.  This is a
               non-incremental search.
        history-substring-search-backward
               Search backward through the history for the string of characters
-              between the start of the current line  and  the  current  cursor
-              position (the point).  The search string may match anywhere in a
+              between the start of the current line and the current cursor po-
+              sition (the point).  The search string may match anywhere  in  a
               history line.  This is a non-incremental search.
        history-substring-search-forward
-              Search forward through the history for the string of  characters
+              Search  forward through the history for the string of characters
               between the start of the current line and the point.  The search
-              string may match anywhere in a history line.   This  is  a  non-
-              incremental search.
+              string  may match anywhere in a history line.  This is a non-in-
+              cremental search.
        yank-nth-arg (M-C-y)
-              Insert  the  first argument to the previous command (usually the
+              Insert the first argument to the previous command  (usually  the
               second word on the previous line) at point.  With an argument n,
-              insert  the nth word from the previous command (the words in the
-              previous command  begin  with  word  0).   A  negative  argument
-              inserts the nth word from the end of the previous command.  Once
-              the argument n is computed, the argument is extracted as if  the
+              insert the nth word from the previous command (the words in  the
+              previous  command  begin  with word 0).  A negative argument in-
+              serts the nth word from the end of the previous  command.   Once
+              the  argument n is computed, the argument is extracted as if the
               "!n" history expansion had been specified.
        yank-last-arg (M-., M-_)
-              Insert  the last argument to the previous command (the last word
+              Insert the last argument to the previous command (the last  word
               of the previous history entry).  With a numeric argument, behave
-              exactly  like  yank-nth-arg.   Successive calls to yank-last-arg
-              move back through the history list, inserting the last word  (or
-              the  word  specified  by the argument to the first call) of each
+              exactly like yank-nth-arg.  Successive  calls  to  yank-last-arg
+              move  back through the history list, inserting the last word (or
+              the word specified by the argument to the first  call)  of  each
               line in turn.  Any numeric argument supplied to these successive
-              calls  determines  the direction to move through the history.  A
-              negative argument switches the  direction  through  the  history
+              calls determines the direction to move through the  history.   A
+              negative  argument  switches  the  direction through the history
               (back or forward).  The history expansion facilities are used to
-              extract the last argument, as if the "!$" history expansion  had
+              extract  the last argument, as if the "!$" history expansion had
               been specified.
+       operate-and-get-next (C-o)
+              Accept the current line for return to the calling application as
+              if  a newline had been entered, and fetch the next line relative
+              to the current line from the history for editing.  A numeric ar-
+              gument,  if supplied, specifies the history entry to use instead
+              of the current line.
 
    Commands for Changing Text
        end-of-file (usually C-d)
-              The  character  indicating  end-of-file  as set, for example, by
-              ``stty''.  If this character is read when there are  no  charac-
-              ters  on  the  line,  and point is at the beginning of the line,
+              The character indicating end-of-file as  set,  for  example,  by
+              ``stty''.   If  this character is read when there are no charac-
+              ters on the line, and point is at the  beginning  of  the  line,
               Readline interprets it as the end of input and returns EOF.
        delete-char (C-d)
               Delete the character at point.  If this function is bound to the
               same character as the tty EOF character, as C-d commonly is, see
               above for the effects.
        backward-delete-char (Rubout)
-              Delete the character behind the cursor.  When  given  a  numeric
+              Delete  the  character  behind the cursor.  When given a numeric
               argument, save the deleted text on the kill ring.
        forward-backward-delete-char
-              Delete  the  character under the cursor, unless the cursor is at
+              Delete the character under the cursor, unless the cursor  is  at
               the end of the line, in which case the character behind the cur-
               sor is deleted.
        quoted-insert (C-q, C-v)
@@ -652,32 +663,32 @@ READLINE(3)                Library Functions Manual                READLINE(3)
        self-insert (a, b, A, 1, !, ...)
               Insert the character typed.
        transpose-chars (C-t)
-              Drag the character before point forward over  the  character  at
-              point,  moving point forward as well.  If point is at the end of
-              the line, then this transposes the two characters before  point.
+              Drag  the  character  before point forward over the character at
+              point, moving point forward as well.  If point is at the end  of
+              the  line, then this transposes the two characters before point.
               Negative arguments have no effect.
        transpose-words (M-t)
-              Drag  the  word  before  point past the word after point, moving
-              point over that word as well.  If point is at  the  end  of  the
+              Drag the word before point past the  word  after  point,  moving
+              point  over  that  word  as well.  If point is at the end of the
               line, this transposes the last two words on the line.
        upcase-word (M-u)
-              Uppercase  the  current  (or  following)  word.  With a negative
-              argument, uppercase the previous word, but do not move point.
+              Uppercase the current (or following) word.  With a negative  ar-
+              gument, uppercase the previous word, but do not move point.
        downcase-word (M-l)
-              Lowercase the current (or  following)  word.   With  a  negative
-              argument, lowercase the previous word, but do not move point.
+              Lowercase  the current (or following) word.  With a negative ar-
+              gument, lowercase the previous word, but do not move point.
        capitalize-word (M-c)
-              Capitalize  the  current  (or  following) word.  With a negative
-              argument, capitalize the previous word, but do not move point.
+              Capitalize the current (or following) word.  With a negative ar-
+              gument, capitalize the previous word, but do not move point.
        overwrite-mode
-              Toggle overwrite mode.  With an explicit positive numeric  argu-
+              Toggle  overwrite mode.  With an explicit positive numeric argu-
               ment, switches to overwrite mode.  With an explicit non-positive
               numeric argument, switches to insert mode.  This command affects
-              only  emacs mode; vi mode does overwrite differently.  Each call
+              only emacs mode; vi mode does overwrite differently.  Each  call
               to readline() starts in insert mode.  In overwrite mode, charac-
-              ters  bound to self-insert replace the text at point rather than
-              pushing the text  to  the  right.   Characters  bound  to  back-
-              ward-delete-char  replace  the  character  before  point  with a
+              ters bound to self-insert replace the text at point rather  than
+              pushing  the  text  to  the  right.   Characters  bound to back-
+              ward-delete-char replace  the  character  before  point  with  a
               space.  By default, this command is unbound.
 
    Killing and Yanking
@@ -686,92 +697,91 @@ READLINE(3)                Library Functions Manual                READLINE(3)
        backward-kill-line (C-x Rubout)
               Kill backward to the beginning of the line.
        unix-line-discard (C-u)
-              Kill backward from point to the  beginning  of  the  line.   The
+              Kill  backward  from  point  to  the beginning of the line.  The
               killed text is saved on the kill-ring.
        kill-whole-line
-              Kill  all  characters on the current line, no matter where point
+              Kill all characters on the current line, no matter  where  point
               is.
        kill-word (M-d)
-              Kill from point the end of  the  current  word,  or  if  between
-              words,  to  the  end  of the next word.  Word boundaries are the
+              Kill  from  point  the  end  of  the current word, or if between
+              words, to the end of the next word.   Word  boundaries  are  the
               same as those used by forward-word.
        backward-kill-word (M-Rubout)
-              Kill the word behind point.  Word boundaries  are  the  same  as
+              Kill  the  word  behind  point.  Word boundaries are the same as
               those used by backward-word.
        unix-word-rubout (C-w)
-              Kill  the  word behind point, using white space as a word bound-
+              Kill the word behind point, using white space as a  word  bound-
               ary.  The killed text is saved on the kill-ring.
        unix-filename-rubout
-              Kill the word behind point, using  white  space  and  the  slash
-              character  as  the word boundaries.  The killed text is saved on
+              Kill  the  word  behind  point,  using white space and the slash
+              character as the word boundaries.  The killed text is  saved  on
               the kill-ring.
        delete-horizontal-space (M-\)
               Delete all spaces and tabs around point.
        kill-region
-              Kill the text between the point and  mark  (saved  cursor  posi-
+              Kill  the  text  between  the point and mark (saved cursor posi-
               tion).  This text is referred to as the region.
        copy-region-as-kill
               Copy the text in the region to the kill buffer.
        copy-backward-word
-              Copy  the word before point to the kill buffer.  The word bound-
+              Copy the word before point to the kill buffer.  The word  bound-
               aries are the same as backward-word.
        copy-forward-word
-              Copy the word following point to  the  kill  buffer.   The  word
+              Copy  the  word  following  point  to the kill buffer.  The word
               boundaries are the same as forward-word.
        yank (C-y)
               Yank the top of the kill ring into the buffer at point.
        yank-pop (M-y)
-              Rotate  the kill ring, and yank the new top.  Only works follow-
+              Rotate the kill ring, and yank the new top.  Only works  follow-
               ing yank or yank-pop.
 
    Numeric Arguments
        digit-argument (M-0, M-1, ..., M--)
-              Add this digit to the argument already accumulating, or start  a
+              Add  this digit to the argument already accumulating, or start a
               new argument.  M-- starts a negative argument.
        universal-argument
-              This  is another way to specify an argument.  If this command is
-              followed by one or more digits, optionally with a leading  minus
-              sign,  those digits define the argument.  If the command is fol-
-              lowed by digits, executing  universal-argument  again  ends  the
-              numeric  argument, but is otherwise ignored.  As a special case,
-              if this command is immediately followed by a character  that  is
-              neither  a  digit or minus sign, the argument count for the next
-              command is multiplied by four.  The argument count is  initially
-              one,  so  executing this function the first time makes the argu-
+              This is another way to specify an argument.  If this command  is
+              followed  by one or more digits, optionally with a leading minus
+              sign, those digits define the argument.  If the command is  fol-
+              lowed by digits, executing universal-argument again ends the nu-
+              meric argument, but is otherwise ignored.  As a special case, if
+              this command is immediately followed by a character that is nei-
+              ther a digit or minus sign, the argument count for the next com-
+              mand  is  multiplied  by  four.  The argument count is initially
+              one, so executing this function the first time makes  the  argu-
               ment count four, a second time makes the argument count sixteen,
               and so on.
 
    Completing
        complete (TAB)
-              Attempt  to  perform  completion  on the text before point.  The
-              actual completion performed is application-specific.  Bash,  for
-              instance,  attempts  completion  treating the text as a variable
-              (if the text begins with $), username (if the text  begins  with
-              ~),  hostname (if the text begins with @), or command (including
-              aliases and functions) in turn.  If none  of  these  produces  a
-              match,  filename  completion  is  attempted.   Gdb, on the other
-              hand, allows completion of program functions and variables,  and
+              Attempt to perform completion on the text before point.  The ac-
+              tual  completion  performed  is application-specific.  Bash, for
+              instance, attempts completion treating the text  as  a  variable
+              (if  the  text begins with $), username (if the text begins with
+              ~), hostname (if the text begins with @), or command  (including
+              aliases  and  functions)  in  turn.  If none of these produces a
+              match, filename completion is  attempted.   Gdb,  on  the  other
+              hand,  allows completion of program functions and variables, and
               only attempts filename completion under certain circumstances.
        possible-completions (M-?)
-              List  the  possible  completions of the text before point.  When
+              List the possible completions of the text  before  point.   When
               displaying completions, readline sets the number of columns used
-              for  display to the value of completion-display-width, the value
-              of the environment variable COLUMNS, or  the  screen  width,  in
+              for display to the value of completion-display-width, the  value
+              of  the  environment  variable  COLUMNS, or the screen width, in
               that order.
        insert-completions (M-*)
-              Insert  all completions of the text before point that would have
+              Insert all completions of the text before point that would  have
               been generated by possible-completions.
        menu-complete
-              Similar to complete, but replaces the word to be completed  with
-              a  single match from the list of possible completions.  Repeated
-              execution of menu-complete steps through the  list  of  possible
-              completions,  inserting  each  match in turn.  At the end of the
+              Similar  to complete, but replaces the word to be completed with
+              a single match from the list of possible completions.   Repeated
+              execution  of  menu-complete  steps through the list of possible
+              completions, inserting each match in turn.  At the  end  of  the
               list of completions, the bell is rung (subject to the setting of
               bell-style) and the original text is restored.  An argument of n
-              moves n positions forward in the list  of  matches;  a  negative
-              argument  may  be  used to move backward through the list.  This
-              command is intended to be  bound  to  TAB,  but  is  unbound  by
-              default.
+              moves n positions forward in the list of matches; a negative ar-
+              gument may be used to move backward through the list.  This com-
+              mand is intended to be bound to TAB, but is unbound by default.
        menu-complete-backward
               Identical  to menu-complete, but moves backward through the list
               of possible completions, as if menu-complete had  been  given  a
@@ -849,8 +859,8 @@ READLINE(3)                Library Functions Manual                READLINE(3)
               ning of the line.  In either case, the line is accepted as if  a
               newline  had  been  typed.   The  default value of comment-begin
               makes the current line a shell comment.  If a  numeric  argument
-              causes  the  comment  character  to be removed, the line will be
-              executed by the shell.
+              causes the comment character to be removed, the line will be ex-
+              ecuted by the shell.
        dump-functions
               Print all of the functions and their key bindings to  the  read-
               line output stream.  If a numeric argument is supplied, the out-
@@ -875,8 +885,8 @@ READLINE(3)                Library Functions Manual                READLINE(3)
 
 DEFAULT KEY BINDINGS
        The  following is a list of the default emacs and vi bindings.  Charac-
-       ters with the eighth bit set are  written  as  M-<character>,  and  are
-       referred to as metafied characters.  The printable ASCII characters not
+       ters with the eighth bit set are written as M-<character>, and are  re-
+       ferred  to  as metafied characters.  The printable ASCII characters not
        mentioned in the list of emacs  standard  bindings  are  bound  to  the
        self-insert  function,  which just inserts the given character into the
        input line.  In vi insertion mode, all characters not specifically men-
@@ -926,6 +936,7 @@ READLINE(3)                Library Functions Manual                READLINE(3)
              "M-C-H"  backward-kill-word
              "M-C-I"  tab-insert
              "M-C-J"  vi-editing-mode
+             "M-C-L"  clear-display
              "M-C-M"  vi-editing-mode
              "M-C-R"  revert-line
              "M-C-Y"  yank-nth-arg
@@ -1116,4 +1127,4 @@ READLINE(3)                Library Functions Manual                READLINE(3)
 
 
 
-GNU Readline 7.0               2017 December 28                    READLINE(3)
+GNU Readline 8.1                2020 October 29                    READLINE(3)