fvwmdebug1(1) [debian man page]

FvwmDebug(1)						      General Commands Manual						      FvwmDebug(1)

NAME

       FvwmDebug - the FVWM module debugger

SYNOPSIS

       FvwmDebug is spawned by fvwm, so no command line invocation will work.

DESCRIPTION

       The FvwmDebug captures the stream of module packets coming from fvwm, and displays them on stderr.

COPYRIGHTS

       The FvwmDebug program, and the concept for interfacing this module to the Window Manager, are all original work by Robert Nation

       Copyright  1994,  Robert Nation. No guarantees or warranties or anything are provided or implied in any way whatsoever. Use this program at
       your own risk. Permission to use this program for any purpose is given, as long as the copyright is kept intact.

INITIALIZATION

       During initialization, the FvwmDebug requests that fvwm dump a complete window list into its pipe. These packets are  terminated  with  and
       "end Send_WindowList" message.

INVOCATION

       FvwmDebug can be invoked by inserting the line 'Module FvwmDebug' in the .fvwmrc file. This can be placed on a line by itself, if FvwmDebug
       is to be spawned during fvwm's initialization, or can be bound to a menu or mouse button or keystroke to invoke it later. Fvwm will  search
       directory specified in the ModulePath configuration option to attempt to locate FvwmDebug.

CONFIGURATION OPTIONS

       There are no configuration options.

AUTHOR

       Robert Nation

3rd Berkeley Distribution					    Jan 28 1994 						      FvwmDebug(1)

FvwmDebug(1)							   Fvwm Modules 						      FvwmDebug(1)

NAME

       FvwmDebug - the fvwm module debugger

SYNOPSIS

       FvwmDebug should be spawned by fvwm(1) for normal functionality.

       To run this module, place this command somewhere in the configuration:

	   Module FvwmDebug [optional-params]

       To stop this module, execute:

	   KillModule FvwmDebug

DESCRIPTION

       This module persistently dumps all fvwm event details and optionally some other information into the standard error stream or a file, good
       for debugging purposes. The output may be optionally redirected to xconsole or similar window.

INVOCATION

       There are several command line switches:

       FvwmDebug [ --args|--noargs ] [ --events|--noevents ] [ --log file ] [ --xconsole ] [ --mask mask ] [ --xmask mask ] [ --debug level ] [
       --track tracker-name ] [ --send-configinfo ] [ --send-windowlist ]

       Long switches may be abbreviated to shorter switches.

       --noargs - do not print all arguments of the event, just its name. --args is the default.

       --noevents - do not print even event names, implies --noargs. It is similar in effect to setting both --mask and --xmask to 0, but the
       events are actually received by the module, they are just not printed.

       This option may be useful if --track or/and --debug is used.

       The default is --events normally, and --noevents if one or more --track options specified.

       -l|--log file - specify the log file name instead of the standard error stream. If the log file can't be open for writting, the default
       standard error stream is used.

       The file may start with a pipe '|', this is similar to the usual meaning of a pipe, the output is piped to the specified command. See also
       --xconsole option.

       -xc|--xconsole - this is a shortcut for:

	   FvwmDebug --log '|xconsole -file /dev/stdin -geometry 600x400 -notify'

       That shows the module output in the xconsole window rather than the standard error stream.

       -m|--mask mask - set the module mask, 31 bit integer. By default almost all events are monitored (except for some flood events like
       CONFIGURE_WINDOW or FOCUS_WINDOW. The special value of -1 sets the maximal mask.

       -x|--xmask mask - set the module extended mask, 31 bit integer. By default almost all events are monitored (except for some flood events
       like ENTER_WINDOW or LEAVE_WINDOW. The special value of -1 sets the maximal extended mask.

       -d|--debug level - use the Perl library debugging mechanism. The useful levels are 2 to 4.

       -t|--track tracker-name - create the given Perl library tracker and observe its main observable. This option may be specified multiple
       times. This options implies --noevents unless explicitely overwritten. You may optionally try --debug, for example:

	   FvwmDebug -xc --track PageInfo --track GlobalConfig --debug 3

       Run "fvwm-perllib man" to get the names of all existing trackers in your installed Perl library.

       -sc|--send-configinfo - send Send_ConfigInfo command to fvwm on startup, this results in a lot of events received.

       -sw|--send-windowlist - send Send_WindowList command to fvwm on startup, this results in a lot of events received.

SEE ALSO

       See also FvwmGtkDebug.

AUTHOR

       Mikhael Goikhman <migo@homemail.com>.

2.5.28 (from cvs)						    2009-03-22							      FvwmDebug(1)