Info Catalog octave: Customizing the Prompt octave: Command Line Editing

octave: Diary and Echo Commands

 
 2.4.8 Diary and Echo Commands
 -----------------------------
 
 Octave’s diary feature allows you to keep a log of all or part of an
 interactive session by recording the input you type and the output that
 Octave produces in a separate file.
 
  -- : diary
  -- : diary on
  -- : diary off
  -- : diary FILENAME
      Record a list of all commands _and_ the output they produce, mixed
      together just as they appear on the terminal.
 
      Valid options are:
 
      on
           Start recording a session in a file called ‘diary’ in the
           current working directory.
 
      off
           Stop recording the session in the diary file.
 
      FILENAME
           Record the session in the file named FILENAME.
 
      With no arguments, ‘diary’ toggles the current diary state.
 
      See also: history XREFhistory, evalc XREFevalc.
 
    Sometimes it is useful to see the commands in a function or script as
 they are being evaluated.  This can be especially helpful for debugging
 some kinds of problems.
 
  -- : echo
  -- : echo on
  -- : echo off
  -- : echo on all
  -- : echo off all
      Control whether commands are displayed as they are executed.
 
      Valid options are:
 
      ‘on’
           Enable echoing of commands as they are executed in script
           files.
 
      ‘off’
           Disable echoing of commands as they are executed in script
           files.
 
      ‘on all’
           Enable echoing of commands as they are executed in script
           files and functions.
 
      ‘off all’
           Disable echoing of commands as they are executed in script
           files and functions.
 
      With no arguments, ‘echo’ toggles the current echo state.
 
      See also: echo_executing_commands
      XREFecho_executing_commands.
 
  -- : VAL = echo_executing_commands ()
  -- : OLD_VAL = echo_executing_commands (NEW_VAL)
  -- : echo_executing_commands (NEW_VAL, "local")
      Query or set the internal variable that controls the echo state.
 
      It may be the sum of the following values:
 
      1
           Echo commands read from script files.
 
      2
           Echo commands from functions.
 
      4
           Echo commands read from command line.
 
      More than one state can be active at once.  For example, a value of
      3 is equivalent to the command ‘echo on all’.
 
      The value of ‘echo_executing_commands’ may be set by the ‘echo’
      command or the command line option ‘--echo-commands’.
 
      When called from inside a function with the "local" option, the
      variable is changed locally for the function and any subroutines it
      calls.  The original variable value is restored when exiting the
      function.
 
      See also: echo XREFecho.
 

Info Catalog octave: Customizing the Prompt octave: Command Line Editing