.\" t .\" @(#)FvwmCommand.1 7/19/97 .de EX \"Begin example .ne 5 .if n .sp 1 .if t .sp .5 .nf .in +.25i .. .de EE .fi .in -.25i .if n .sp 1 .if t .sp .5 .. .ta .2i .4i .6i .8i 1i 1.2i 1.4i .TH FvwmCommand 1x "July 19 1997" .UC .SH NAME FvwmCommand \- FVWM command external interface .SH SYNOPSIS In .fvwm2rc file: .EX Module FvwmCommandS [name] .EE Then, in script file or from shell: .EX FvwmCommand [-mrvw] [-i level] [-f name] [command...] .EE .SH DESCRIPTION FvwmCommand lets you monitor fvwm transaction and issue fvwm command from a shell command line or scripts. FvwmCommand takes each argument as a fvwm command. Quotes can be used to send commands including spaces. .br FvwmCommand.pm is for perl scripts in order to keep the syntax similar to fvwm configuration file. .EX use FvwmCommand; if( $ARGV[0] eq 'home' ) { Desk 0,0; GotoPage '1 1'; }elsif( $ARGV[0] eq 'jump' ) { Desk "0 2"; GotoPage 1, 1; } .EE Commas can be used to separate Fvwm commands' arguments or quotes can be used combine them. The commands are case sensitive. .br FvwmCommand.sh is collection of functions for bourn shell or its cousines. It is to be sourced: .EX \&. FvwmCommand.sh .br DesktopSize 5x5 .EE The commands in FvwmCommand.sh and FvwmCommand.pl are case sensitive. .SH INVOCATION FvwmCommandS should be spawned once by fvwm, either in .fvwm2rc file, from menu, or from FvwmConsole. From then on, FvwmCommand can be called from a shell or script to execute fvwm commands. .SH OPTIONS .IP "\fI-f \fR" 0.4i Specifies an alternative fifo set to communicate with FvwmCommandS. The default fifo set is ~/.FvwmCommand, in which ~/.FvwmCommandC is used to send commands and ~/.FvwmCommandM is to receive messages. FvwmCommandS must have been invoked with the same as its first argument prior to FvwmCommand invokation. This option is useful when a dedicated connection is necessary to run a background job while another connection is kept for interactive use. .IP "\fI-i \fR" Specified the level of information FvwmCommand outputs. .sp .RS .IP 0 0.4i Error messages only. Note that Fvwm doesn't return any error messages in cases like below since 'windowid' itself is a valid command. .sp .EX FvwmCommand -i 0 'windowid abcd move' .EE .IP 1 Errors and window configuration information. This is the default. .EX FvwmCommand FvwmIconMan .EE The following infomation will show up. .EX 0x03400003 window FvwmIconMan 0x03400003 icon FvwmIconMan 0x03400003 class FvwmModule 0x03400003 resource FvwmIconMan .EE The first column shows the window ID number, which can be used in 'windowid' command. The second column shows the information types. The last column shows the information contents. If no information is returned, add -w