Updating debian/lxpanel.README.Debian removing section about lxpanel-dev.
[debian/lxpanel.git] / README
1 LXPanel is a lightweight X11 desktop panel.
2
3 To build this program you need some development packages:
4   libtool 2.2 or newer, intltool, libgtk 2.18 or newer,
5   libfm-gtk 1.2 or newer, libwnck, libkeybinder.
6 Optional development packages may be required to build some modules:
7   libmenu-cache,
8   libalsasound ('volumealsa' plugin isn't built if missing),
9   libindicator 0.3.0 ('indicator' plugin isn't built if missing),
10   wireless-tools (required to build 'netstat' plugin),
11   libxml-2.0 (required to build 'weather' plugin).
12
13 To install this program, three other packages are needed:
14   menu-cache, libfm-gtk, lxmenu-data.
15 Please install them before installing lxpanel.
16
17 There are 2 programs contained in the package.
18
19 1. lxpanel: the panel
20
21 2. lxpanelctl: the controller of lxpanel, can be used to control lxpanel in 
22                other programs.  The best place to use lxpanelctl is by far 
23                the numerous key bindings provided by window managers.
24                When the key combination is pressed, call lxpanelctl to popup
25                system menu, or to open run dialog in lxpanel.
26                Run lxpanelctl without any argument to see what command it 
27                currently recognizes.
28
29
30 About Netstat and Netstatus plugins:
31
32 1. netstatus was ported from netstatus panel applet of GNOME Project.  This
33    plugin has good support on Linux/BSD/other UNIX, and it is released under
34    GNU GPL. (the same as LxDE)
35
36 2. netstat is a new plugin written by LxDE developers as the lightweight
37    replacement of netstatus plugin.  It aims to be more usable and resource
38    efficient.  At the current stage, netstat runs only on Linux.
39
40
41 About theming & lxpanel:
42
43 1. LXPanel tries to use as much themed icons as possible.  Fallback icons
44    may be also provided if they are placed into $(datadir)/lxpanel/images
45    directory.  Few plugins already provide their fallback icons.
46
47 2. Current icon names that can be themed specifically for lxpanel include:
48         *"lxpanel-background"
49         *"clock"
50         *"capslock-on"
51         *"capslock-off"
52         *"numlock-on"
53         *"numlock-off"
54         *"scrllock-on"
55         *"scrllock-off"
56         *"window-manager"
57         *"ns-lock"
58         *"cpufreq-icon"
59         *possibly more, as yet unfound.
60
61 There are also a substantial amount of others, but they use the icon naming specification.
62
63 3. You can also set theme for any plugin specifically using it's widget name
64     which is equal to plugin type.
65
66 4. There is a specific RC file which can be loaded by LXPanel, it can be placed
67     as ~/.config/lxpanel/$PROFILE/gtkrc, where $PROFILE is the profile used on
68     the LXPanel start.
69
70
71 About keyboard options translations in xkb plugin:
72
73 The 'xkb' plugin can use translations from language packs that are present
74     in many distributions. To use it you should have language pack which
75     includes "xkeyboard-config" translations.