NAME

       FvwmConsole - an fvwm command input interface

SYNOPSIS

       Module FvwmConsole [options]

       FvwmConsole  can  only  be  invoked  by fvwm.  Command line invocation of the FvwmConsole module will not
       work.

DESCRIPTION

       FvwmConsole allows the user to type fvwm configuration commands interactively,  and  have  them  executed
       immediately.   This  tool is particularly useful for testing new configuration ideas, or for implementing
       temporary changes to your environment.

INVOCATION

       FvwmConsole must be spawned as a module by fvwm.  FvwmConsole takes all xterm(1) options.

       FvwmConsole can be invoked by inserting the line 'Module FvwmConsole' in the .fvwm2rc file.  This can  be
       placed on a line by itself, if FvwmConsole is to be spawned during fvwm's initialization, or can be bound
       to a menu or mouse button or keystroke to invoke it later.

CONFIGURATION OPTIONS

       FvwmConsole uses xterm(1).  All resources set for xterm are inherited unless overridden by  command  line
       options.

              Module FvwmConsole -g 40x10 -fg black -bg green3

       A  different  terminal  emulator  can  be  specified  with  the -terminal option.  However, only terminal
       programs that understand the options -name, -title and -e can be used. Debian specific:  hardcoded  xterm
       is  changed  to  x-terminal-emulator. To be policy compliant -name option is removed from default options
       and -title is changed to -T.

              Module FvwmConsole -terminal rxvt

       Previous versions of FvwmConsole supported a -e option to choose a different  front-end.   Although  this
       option  is still provided for backwards compatibility its use is discouraged unless you know exactly what
       you are doing.

              Module FvwmConsole -e FvwmConsoleC.pl

       (see FvwmConsoleC.pl(1)).

       Also X resources can be set in your ~/.Xdefaults file:

              FvwmConsole*VT100*geometry: 40x4
              FvwmConsole*font: 7x14

       Debian specific: Since -name is not included by default, the default resource  will  be  set  by  the  x-
       terminal-emulator  used  and not be FvwmConsole. You can change the resource to match the terminal, or if
       supported by the terminal, run FvwmConsole with the -name option:

              Module FvwmConsole -name FvwmConsole

COMMAND EDITING

       There are a few options.  If the GNU readline library is available, it can be used.

       If Perl5 is installed, FvwmConsoleC.pl can be used as a command editor.   This  can  be  accomplished  by
       either  copying  FvwmConsoleC.pl  to  fvwmlib  directory  as FvwmConsoleC or invoking FvwmConsole with -e
       option.  For example:

              Module FvwmConsole -e FvwmConsoleC.pl

       If neither one is installed, a simple input reading function which doesn't have editing  capabilities  is
       used.

       GNU  readline  and FvwmConsoleC.pl have some frequent used commands in common as default.  These commands
       are similar to emacs.  For more details, refer GNU readline man and info pages, and  FvwmConsoleC.pl  man
       page.

              Ctrl-A  - beginning of line
              Ctrl-B  - previous char
              Ctrl-D  - delete char
              Ctrl-E  - end of line
              Ctrl-F  - next char
              Ctrl-H  - backspace
              Ctrl-K  - erase to the end of line
              Ctrl-N  - next line
              Ctrl-P  - previous line
              Ctrl-R  - search reverse
              Ctrl-U  - delete line
              Meta-B  - previous word
              Meta-F  - next word
              Esc <   - beginning of history
              Esc >   - end of history

EXITING

       FvwmConsole can be stopped by entering the EOF character (usually CTRL-D).

       Note! Do not use the "quit" command, as this is an fvwm builtin: typing "quit" at the FvwmConsole command
       line will cause fvwm to exit.

SEE ALSO

       xterm(1), FvwmConsoleC.pl(1), GNU Readline library

AUTHOR

       FvwmConsole is the original work of Toshi Isogai.