Adding upstream version 0.5.6.
[debian/lxpanel.git] / man / lxpanel.1
1 '\" t
2 .\"     Title: LXPANEL
3 .\"    Author: Ying-Chun Liu
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5 .\"      Date: March  2, 2008
6 .\"    Manual: http://LXDE.org
7 .\"    Source: http://LXDE.org
8 .\"  Language: English
9 .\"
10 .TH "LXPANEL" "1" "March 2, 2008" "http://LXDE\&.org" "http://LXDE.org"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
15 .nh
16 .\" disable justification (adjust text to left margin only)
17 .ad l
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
21 .SH "NAME"
22 lxpanel \- a lightweight GTK2\-based panel for the LXDE desktop\&.
23 .SH "SYNOPSIS"
24 .HP \w'\fBlxpanel\fR\ 'u
25 \fBlxpanel\fR
26 .SH "DESCRIPTION"
27 .PP
28 This manual page documents briefly the
29 \fBlxpanel\fR
30 command\&.
31 .PP
32 \fBlxpanel\fR
33 is a program that provides a panel for the desktop, usually for LXDE\&. It is a lightweight GTK+ 2\&.x based desktop panel\&.
34 .PP
35 .PP
36 \fBFeatures\fR
37 .sp
38 .RS 4
39 .ie n \{\
40 \h'-04'\(bu\h'+03'\c
41 .\}
42 .el \{\
43 .sp -1
44 .IP \(bu 2.3
45 .\}
46 User\-friendly application menu automatically generated from
47 \&.desktop
48 files on the system\&.
49 .RE
50 .sp
51 .RS 4
52 .ie n \{\
53 \h'-04'\(bu\h'+03'\c
54 .\}
55 .el \{\
56 .sp -1
57 .IP \(bu 2.3
58 .\}
59 Launcher bar (small icons clicked to launch apps)
60 .RE
61 .sp
62 .RS 4
63 .ie n \{\
64 \h'-04'\(bu\h'+03'\c
65 .\}
66 .el \{\
67 .sp -1
68 .IP \(bu 2.3
69 .\}
70 Task bar supporting ICCCM/EWMH `urgency\' hint (Pidgin IM windows can flash on new incoming messages)
71 .RE
72 .sp
73 .RS 4
74 .ie n \{\
75 \h'-04'\(bu\h'+03'\c
76 .\}
77 .el \{\
78 .sp -1
79 .IP \(bu 2.3
80 .\}
81 Notification area (system tray)
82 .RE
83 .sp
84 .RS 4
85 .ie n \{\
86 \h'-04'\(bu\h'+03'\c
87 .\}
88 .el \{\
89 .sp -1
90 .IP \(bu 2.3
91 .\}
92 Digital clock
93 .RE
94 .sp
95 .RS 4
96 .ie n \{\
97 \h'-04'\(bu\h'+03'\c
98 .\}
99 .el \{\
100 .sp -1
101 .IP \(bu 2.3
102 .\}
103 Run dialog (type command to run, without opening a terminal )
104 .RE
105 .sp
106 .RS 4
107 .ie n \{\
108 \h'-04'\(bu\h'+03'\c
109 .\}
110 .el \{\
111 .sp -1
112 .IP \(bu 2.3
113 .\}
114 Net status icon plug\-in (optional)
115 .RE
116 .sp
117 .RS 4
118 .ie n \{\
119 \h'-04'\(bu\h'+03'\c
120 .\}
121 .el \{\
122 .sp -1
123 .IP \(bu 2.3
124 .\}
125 Volume control plug\-in (optional)
126 .RE
127 .sp
128 .RS 4
129 .ie n \{\
130 \h'-04'\(bu\h'+03'\c
131 .\}
132 .el \{\
133 .sp -1
134 .IP \(bu 2.3
135 .\}
136 lxpanelctl, an external controller lets you control lxpanel in other programs\&. For example, "lxpanelctl run" will show the Run dialog in lxpanel, and "lxpanelctl menu" will show the application menu\&. This is useful in key bindings provided by window managers\&.
137 .RE
138 .sp
139 .RE
140 .SH "OPTIONS"
141 .PP
142 This program follows the usual
143 GNU
144 command line syntax, with long options starting with two dashes (`\-\')\&. A summary of options is included below\&.
145 .PP
146 \fB\-h\fR \fB\-\-help\fR
147 .RS 4
148 Print help on the options\&.
149 .RE
150 .PP
151 \fB\-v\fR \fB\-\-version\fR
152 .RS 4
153 Print the program version\&.
154 .RE
155 .PP
156 \fB\-\-log \fR\fB\fIlevel\fR\fR
157 .RS 4
158 Set the logging level in the range 0 (silent) through 5 (verbose)\&.
159 .RE
160 .PP
161 \fB\-p \fR\fB\fINAME\fR\fR, \fB\-\-profile \fR\fB\fINAME\fR\fR
162 .RS 4
163 Set the profile to be loaded\&.
164 .RE
165 .SH "FILES"
166 .PP
167 ~/\&.config/lxpanel/\fIPROFILE\fR
168 .RS 4
169 config file, can be edited by preference dialog\&.
170 .RE
171 .SH "SEE ALSO"
172 .PP
173 lxsession (1), lxpanelctl (1)\&.
174 .SH "AUTHOR"
175 .PP
176 This manual page was written by paulliu
177 grandpaul@gmail\&.com
178 for the
179 Debian
180 system (but may be used by others)\&. Permission is granted to copy, distribute and/or modify this document under the terms of the
181 GNU
182 General Public License, Version 2 any later version published by the Free Software Foundation\&.
183 .PP
184 On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL\&.
185 .SH "AUTHOR"
186 .PP
187 \fBYing\-Chun Liu\fR
188 .RS 4
189 Author.
190 .RE
191 .SH "COPYRIGHT"
192 .br
193 Copyright \(co 2008 paulliu
194 .br