Updated for CVS 2.5.32 now.
[fvwm.git] / tests / hints / README
blob6493a882095218d8c6fb1f4a2945a08ed758787d
1 This directory contains only the hints_test.c program. To compile it
2 either try "make" or something like
4   % gcc -g -O2 -Wall -I/usr/X11R6/include -L/usr/X11R6/lib -c hints_test.c
5   % gcc -g -O2 -Wall -o hints_test hints_test.o -I/usr/X11R6/include -L/usr/X11R6/lib -lX11
7 should work.
9 The program does nothing: it is just a 170x100 black window. However,
10 using options you can set various hints (XSizeHints, XWMHints, MWM hints,
11 EWMH hints) on the window. Here are the options:
13 --help
14         Show usage
16 --min-size w h
17         Set the min_width and min_height XSizeHints to w and h
19 --max-size w h
20         Set the max_width and max_height XSizeHints to w and h
22 --inc-size w h
23         Set the inc_width and inc_height XSizeHints to w and h
25 --p-geometry geometry
26         Set the program geometry and the gravity accordingly.
27         geometry is a standard X geometry (not a F geometry)
29 --us-geometry geometry
30         Set the user geometry and the gravity accordingly.
31         geometry is a standard X geometry (not a F geometry)
33 --input Bool
34         Set the InputHint to Bool where Bool is either true or false
36 --focus-proto
37         Respect the WM_TAKE_FOCUS protocol
39 --no-delete-proto
40         By default the program respect the WM_DELETE_WINDOW protocol. This
41         option forces the program to do not use it at all.
43 --wm-state state
44         Set the initial wm state to state, where state can be withdrawn,
45         iconic or normal
47 --wm-urgency
48         Set the wm urgency flags
50 --wm-group win
51         Set the window group leader to win where win can be root,
52         window or the id of an window.
54 --transient win
55         Set the WM_TRANSIENT_FOR window to win where win can be root
56         or the id of an window.
58 --mwm-decor args
59         where args is a non empty space separated list of the following
60         key words: all, border, resizeh, title, menu, minimize, maximize
62 --mwm-func args
63         where args is a non empty space separated list of the following
64         key words: all, resize, move, maximize, minimize, close
66 --mwm-input arg
67         where arg can be: modless, app_modal, sys_modal, full_app_modal
69 --ewmh-type type
70         Set the EWMH window type to type where type can be: normal, dock,
71         toolbar, desktop, menu, dialog, splash, utility
72         
73 --ewmh-state states
74         Set the EWMH window states to states where states is a non empty
75         space separated list of the following key words: hidden, shaded,
76         sticky, skippager, skiptaskbar, maxhoriz, maxvert, modal, staysontop,
77         fullscreen
79 --ewmh-desktop int
80         Set desktop initial state
82 This is just a test program there is no full checking when the options
83 are parsed. Do not forget to use xprop and xwininfo.
85 Have Fun!