Manual: Fvwm2Console

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 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 but‐
       ton 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	 un‐
       derstand the options -name, -title and -e can be used. Debian specific: hardcoded xterm is changed to x-terminal-emu‐
       lator. 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)