FvwmConsole(1)							   Fvwm Modules 						    FvwmConsole(1)

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 particu-
       larly 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.

	      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  back-
       wards 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

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				       09 May 2010 (2.5.30)						    FvwmConsole(1)