gl_get_line.3

BCAST Implementation for NS2

                        support all of these text
                        attributes, and that some substitute
                        a different attribute for missing
                        ones.

  GL_LITERAL_PROMPT  -  In this style, the prompt string is
                        printed literally. This is the
                        default style.
.fi
.sp

.SH THE AVAILABLE KEY BINDING FUNCTIONS

The \f3gl_get_line()\f1 function provides a number of functions which
can be bound to key sequences. The names of these functions, and what
they do, are given below.

.nf
  user-interrupt           -  Send a SIGINT signal to the
                              parent process.
  abort                    -  Send a SIGABRT signal to the
                              parent process.
  suspend                  -  Suspend the parent process.
  stop-output              -  Pause terminal output.
  start-output             -  Resume paused terminal output.
  literal-next             -  Arrange for the next character
                              to be treated as a normal
                              character. This allows control
                              characters to be entered.
  cursor-right             -  Move the cursor one character
                              right.
  cursor-left              -  Move the cursor one character
                              left.
  insert-mode              -  Toggle between insert mode and
                              overwrite mode.
  beginning-of-line        -  Move the cursor to the
                              beginning of the line.
  end-of-line              -  Move the cursor to the end of
                              the line.
  delete-line              -  Delete the contents of the
                              current line.
  kill-line                -  Delete everything that follows
                              the cursor.
  backward-kill-line       -  Delete all characters between
                              the cursor and the start of the
                              line.
  forward-word             -  Move to the end of the word
                              which follows the cursor.
  forward-to-word          -  Move the cursor to the start of
                              the word that follows the
                              cursor.
  backward-word            -  Move to the start of the word
                              which precedes the cursor.
  goto-column              -  Move the cursor to the
                              1-relative column in the line
                              specified by any preceding
                              digit-argument sequences (see
                              ENTERING REPEAT COUNTS below).
  find-parenthesis         -  If the cursor is currently
                              over a parenthesis character,
                              move it to the matching
                              parenthesis character. If not
                              over a parenthesis character
                              move right to the next close
                              parenthesis.
  forward-delete-char      -  Delete the character under the
                              cursor.
  backward-delete-char     -  Delete the character which
                              precedes the cursor.
  list-or-eof              -  This is intended for binding
                              to ^D. When invoked when the
                              cursor is within the line it
                              displays all possible
                              completions then redisplays
                              the line unchanged. When
                              invoked on an empty line, it
                              signals end-of-input (EOF) to
                              the caller of gl_get_line().
  del-char-or-list-or-eof  -  This is intended for binding
                              to ^D. When invoked when the
                              cursor is within the line it
                              invokes forward-delete-char.
                              When invoked at the end of the
                              line it displays all possible
                              completions then redisplays
                              the line unchanged. When
                              invoked on an empty line, it
                              signals end-of-input (EOF) to
                              the caller of gl_get_line().
  forward-delete-word      -  Delete the word which follows
                              the cursor.
  backward-delete-word     -  Delete the word which precedes
                              the cursor.
  upcase-word              -  Convert all of the characters
                              of the word which follows the
                              cursor, to upper case.
  downcase-word            -  Convert all of the characters
                              of the word which follows the
                              cursor, to lower case.
  capitalize-word          -  Capitalize the word which
                              follows the cursor.
  change-case              -  If the next character is upper
                              case, toggle it to lower case
                              and vice versa.
  redisplay                -  Redisplay the line.
  clear-screen             -  Clear the terminal, then
                              redisplay the current line.
  transpose-chars          -  Swap the character under the
                              cursor with the character just
                              before the cursor.
  set-mark                 -  Set a mark at the position of
                              the cursor.
  exchange-point-and-mark  -  Move the cursor to the last
                              mark that was set, and move
                              the mark to where the cursor
                              used to be.
  kill-region              -  Delete the characters that lie
                              between the last mark that was
                              set, and the cursor.
  copy-region-as-kill      -  Copy the text between the mark
                              and the cursor to the cut
                              buffer, without deleting the
                              original text.
  yank                     -  Insert the text that was last
                              deleted, just before the
                              current position of the cursor.
  append-yank              -  Paste the current contents of
                              the cut buffer, after the
                              cursor.
  up-history               -  Recall the next oldest line
                              that was entered. Note that
                              in vi mode you are left in
                              command mode.
  down-history             -  Recall the next most recent
                              line that was entered. If no
                              history recall session is
                              currently active, the next
                              line from a previous recall
                              session is recalled. Note that
                              in vi mode you are left in
                              command mode.
  history-search-backward  -  Recall the next oldest line
                              who's prefix matches the string
                              which currently precedes the
                              cursor (in vi command-mode the
                              character under the cursor is
                              also included in the search
                              string).  Note that in vi mode
                              you are left in command mode.
  history-search-forward   -  Recall the next newest line
                              who's prefix matches the string
                              which currently precedes the
                              cursor (in vi command-mode the
                              character under the cursor is
                              also included in the search
                              string).  Note that in vi mode
                              you are left in command mode.
  history-re-search-backward -Recall the next oldest line
                              who's prefix matches that
                              established by the last
                              invocation of either
                              history-search-forward or
                              history-search-backward.
  history-re-search-forward - Recall the next newest line
                              who's prefix matches that
                              established by the last
                              invocation of either
                              history-search-forward or
                              history-search-backward.
  complete-word            -  Attempt to complete the
                              incomplete word which
                              precedes the cursor. Unless
                              the host program has customized
                              word completion, filename
                              completion is attempted. In vi
                              commmand mode the character
                              under the cursor is also
                              included in the word being
                              completed, and you are left in
                              vi insert mode.
  expand-filename          -  Within the command line, expand
                              wild cards, tilde expressions
                              and dollar expressions in the
                              filename which immediately
                              precedes the cursor. In vi
                              commmand mode the character
                              under the cursor is also
                              included in the filename being
                              expanded, and you are left in
                              vi insert mode.
  list-glob                -  List any filenames which match
                              the wild-card, tilde and dollar
                              expressions in the filename
                              which immediately precedes the
                              cursor, then redraw the input
                              line unchanged.
  list-history             -  Display the contents of the
                              history list for the current
                              history group. If a repeat
                              count of > 1 is specified,
                              only that many of the most
                              recent lines are displayed.
                              See the "ENTERING REPEAT
                              COUNTS" section.
  read-from-file           -  Temporarily switch to reading
                              input from the file who's
                              name precedes the cursor.
  read-init-files          -  Re-read teclarc configuration
                              files.
  beginning-of-history     -  Move to the oldest line in the
                              history list. Note that in vi
                              mode you are left in command
                              mode.
  end-of-history           -  Move to the newest line in the
                              history list (ie. the current
                              line). Note that in vi mode
                              this leaves you in command
                              mode.
  digit-argument           -  Enter a repeat count for the
                              next key-binding function.
                              For details, see the ENTERING
                              REPEAT COUNTS section.
  newline                  -  Terminate and return the
                              current contents of the
                              line, after appending a
                              newline character. The newline
                              character is normally '\\n',
                              but will be the first
                              character of the key-sequence
                              that invoked the newline
                              action, if this happens to be
                              a printable character. If the
                              action was invoked by the
                              '\\n' newline character or the
                              '\\r' carriage return
                              character, the line is
                              appended to the history
                              buffer.
  repeat-history           -  Return the line that is being
                              edited, then arrange for the
                              next most recent entry in the
                              history buffer to be recalled
                              when \f3gl_get_line()\f1 is
                              next called. Repeatedly
                              invoking this action causes
                              successive historical input
                              lines to be re-executed. Note
                              that this action is equivalent
                              to the 'Operate' action in
                              ksh.
  ring-bell                -  Ring the terminal bell, unless
                              the bell has been silenced via
                              the \f3nobeep\f1 configuration
                              option (see the THE TECLA
                              CONFIGURATION FILE section).
  forward-copy-char        -  Copy the next character into
                              the cut buffer (NB. use repeat
                              counts to copy more than one).
  backward-copy-char       -  Copy the previous character
                              into the cut buffer.
  forward-copy-word        -  Copy the next word into the cut
                              buffer.
  backward-copy-word       -  Copy the previous word into the
                              cut buffer.
  forward-find-char        -  Move the cursor to the next
                              occurrence of the next
                              character that you type.
  backward-find-char       -  Move the cursor to the last
                              occurrence of the next
                              character that you type.
  forward-to-char          -  Move the cursor to the
                              character just before the next
                              occurrence of the next
                              character that the user types.
  backward-to-char         -  Move the cursor to the
                              character just after the last
                              occurrence before the cursor
                              of the next character that the
                              user types.
  repeat-find-char         -  Repeat the last
                              backward-find-char,
                              forward-find-char,
                              backward-to-char or
                              forward-to-char.
  invert-refind-char       -  Repeat the last
                              backward-find-char,
                              forward-find-char,
                              backward-to-char, or
                              forward-to-char in the
                              opposite direction.
  delete-to-column         -  Delete the characters from the
                              cursor up to the column that
                              is specified by the repeat
                              count.
  delete-to-parenthesis    -  Delete the characters from the
                              cursor up to and including