1wmpager(1x)                                                        wmpager(1x)
2
3
4

NAME

6       wmpager - Window Maker workspace pager docklet
7

SYNOPSIS

9       wmpager [options]
10

DESCRIPTION

12       wmpager is a Window Maker pager docklet that offers:
13       · workspace switching for up to nine workspaces
14       · automatic   configuration   according  to  the  number  of  available
15         workspaces
16       · automagic adjustment to the currently active workspace
17       · configurable look and feel
18

OPTIONS

20       -h --help
21              Display usage and version information.
22       -v --verbose
23              Enable verbose message output.
24       -d --display <name>
25              The display to use (defaults to the 'DISPLAY' environment  vari‐
26              able).
27       -s --size <w>x<h>
28              The  number  of  buttons  to display. The default depends on the
29              number of workspaces you have, i.e. 2x2 for  4  workspaces,  2x3
30              for 6, maximum is 3x3.
31       -w --workspaces <count>
32              The  number  of workspace buttons to display. The default is the
33              number of workspaces you have up to a maximum is 9.
34       -t --theme <theme.xpm>
35              The button theme to use. <theme.xpm> is either an absolute path‐
36              name  pointing  to an 'xpm' theme file or a filename relative to
37              the installation directory (see option --installdir). The exten‐
38              sion '.xpm' in the file or pathname is optional.
39              For  more information on theme files see the entry BUTTON THEMES
40              below.
41       -i --installdir <dir>
42              Specifies the location of the  installation  directory.  wmpager
43              looks  for  'xpm'  theme files at this location. The default are
44              '/usr/local/share/wmpager/' and the user  specific  '~/.wmpager'
45              directory.
46

BUTTON THEMES

48       Depending on your WindowMaker theme you might want to use another theme
49       for wmpager as well. Use option '-t' or '--theme' to specify the  loca‐
50       tion  of an XPM file (the extension '.xpm' is optional, it has to be an
51       XPM file though). If you use option '-i', '--installdir'  or  have  set
52       the  environment  variable  WMPAGER to the installation location of the
53       wmpager themes, then you may also skip the path to the theme.
54
55       Predefined themes: Well, I'm not much of an artist therefore I've  only
56       included some themes to give you an idea of how a real nice theme might
57       be done. Naturally, I use the built-in theme and theme support is  only
58       there because I have been asked to include it...
59
60       If you create a theme yourself please send it to me and I'll include it
61       in the next build.
62
63       The list of predefined themes in this release includes:
64       · blue (the built-in theme)
65       · fire
66       · gray
67       · steel
68
69       Creating your own themes: If you want to create your own  theme  simply
70       take  one  of the included XPM theme files and modify it to your needs.
71       If you really want to know, the format of the file is described below.
72
73       XPM file format: The XPM file has to be at least 102 by  71  pixels  in
74       size.  The  area 0,0 to 50,50 describes the background for the selected
75       workspace, the area 51,0 to 101,50 for unselected work spaces. The area
76       has  to  include a one-pixel border that is used for all workspace but‐
77       tons. From 0,51 to 89,60 are the digits used for the selected workspace
78       (each  10x10 pixels, 1-9 from left to right) and from 0,61 to 89,70 are
79       the digits for unselected workspaces. The digits may have a transparent
80       background.
81

REQUIREMENTS

83       In  order  for  wmpager  to  work properly you need to have your Window
84       Maker compiled with Gnome support. (I don't know if this  is  the  case
85       for  the precompiled Window Makers usually found in Linux distributions
86       since I usually build my Window Maker myself.)
87
88       wmpager uses the Gnome support messages sent out  by  Window  Maker  to
89       display the currently active workspace. Without Gnome support the pager
90       will not automatically adjust the currently active desktop.
91

BUGS

93       To file a bugreport please use the bug tracking system at:
94       http://sourceforge.net/projects/wmpager/
95

AUTHOR

97       Bruno Essmann <essmann@users.sourceforge.net>
98       http://wmpager.sourceforge.net/
99

ACKNOWLEDGEMENTS

101       Thanks to all at Ergon Informatik AG who are using wmpager  and  helped
102       improve it!
103       http://www.ergon.ch/
104

SEE ALSO

106       wmaker(1x)
107
108
109
110wmpager-1.2                       2002 Aug 16                      wmpager(1x)
Impressum