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.

3rd Berkeley Distribution                    19 October 2022 (2.7.0)                              FvwmConsole(1)