Mostly workarounded MWM issue with panel resizing.
[lxde/lxpanel.git] / man / lxpanel.1
CommitLineData
b8846481
AG
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.\"
28a7cc0a 10.TH "LXPANEL" "1" "February, 2016" "http://LXDE\&.org" "http://LXDE.org"
b8846481
AG
11.\" -----------------------------------------------------------------
12.\" * Define some portability stuff
13.\" -----------------------------------------------------------------
14.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15.\" http://bugs.debian.org/507673
16.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18.ie \n(.g .ds Aq \(aq
19.el .ds Aq '
20.\" -----------------------------------------------------------------
21.\" * set default formatting
22.\" -----------------------------------------------------------------
23.\" disable hyphenation
24.nh
25.\" disable justification (adjust text to left margin only)
26.ad l
27.\" -----------------------------------------------------------------
28.\" * MAIN CONTENT STARTS HERE *
29.\" -----------------------------------------------------------------
30.SH "NAME"
31lxpanel \- a lightweight GTK2\-based panel for the LXDE desktop\&.
32.SH "SYNOPSIS"
33.HP \w'\fBlxpanel\fR\ 'u
34\fBlxpanel\fR
28a7cc0a 35[ options ]
b8846481
AG
36.SH "DESCRIPTION"
37.PP
38This manual page documents briefly the
39\fBlxpanel\fR
40command\&.
41.PP
42\fBlxpanel\fR
43is a program that provides a panel for the desktop, usually for LXDE\&. It is a lightweight GTK+ 2\&.x based desktop panel\&.
44.PP
45.PP
46\fBFeatures\fR
47.sp
48.RS 4
49.ie n \{\
50\h'-04'\(bu\h'+03'\c
51.\}
52.el \{\
53.sp -1
54.IP \(bu 2.3
55.\}
56User\-friendly application menu automatically generated from
57\&.desktop
58files on the system\&.
59.RE
60.sp
61.RS 4
62.ie n \{\
63\h'-04'\(bu\h'+03'\c
64.\}
65.el \{\
66.sp -1
67.IP \(bu 2.3
68.\}
69Launcher bar (small icons clicked to launch apps)
70.RE
71.sp
72.RS 4
73.ie n \{\
74\h'-04'\(bu\h'+03'\c
75.\}
76.el \{\
77.sp -1
78.IP \(bu 2.3
79.\}
80Task bar supporting ICCCM/EWMH `urgency\*(Aq hint (Pidgin IM windows can flash on new incoming messages)
81.RE
82.sp
83.RS 4
84.ie n \{\
85\h'-04'\(bu\h'+03'\c
86.\}
87.el \{\
88.sp -1
89.IP \(bu 2.3
90.\}
91Notification area (system tray)
92.RE
93.sp
94.RS 4
95.ie n \{\
96\h'-04'\(bu\h'+03'\c
97.\}
98.el \{\
99.sp -1
100.IP \(bu 2.3
101.\}
102Digital clock
103.RE
104.sp
105.RS 4
106.ie n \{\
107\h'-04'\(bu\h'+03'\c
108.\}
109.el \{\
110.sp -1
111.IP \(bu 2.3
112.\}
113Run dialog (type command to run, without opening a terminal )
114.RE
115.sp
116.RS 4
117.ie n \{\
118\h'-04'\(bu\h'+03'\c
119.\}
120.el \{\
121.sp -1
122.IP \(bu 2.3
123.\}
124Net status icon plug\-in (optional)
125.RE
126.sp
127.RS 4
128.ie n \{\
129\h'-04'\(bu\h'+03'\c
130.\}
131.el \{\
132.sp -1
133.IP \(bu 2.3
134.\}
135Volume control plug\-in (optional)
136.RE
137.sp
138.RS 4
139.ie n \{\
140\h'-04'\(bu\h'+03'\c
141.\}
142.el \{\
143.sp -1
144.IP \(bu 2.3
145.\}
146lxpanelctl, 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\&.
147.RE
148.sp
149.SH "OPTIONS"
150.PP
151This program follows the usual
152GNU
153command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&.
154.PP
155\fB\-h\fR \fB\-\-help\fR
156.RS 4
157Print help on the options\&.
158.RE
159.PP
160\fB\-v\fR \fB\-\-version\fR
161.RS 4
162Print the program version\&.
163.RE
164.PP
b8846481
AG
165\fB\-p \fR\fB\fINAME\fR\fR, \fB\-\-profile \fR\fB\fINAME\fR\fR
166.RS 4
167Set the profile to be loaded\&.
168.RE
169.SH "FILES"
170.PP
28a7cc0a 171~/\&.config/lxpanel/\fIPROFILE\fR/
b8846481 172.RS 4
28a7cc0a 173config files directory, can be edited by preference dialog\&.
b8846481 174.RE
b8846481 175.PP
28a7cc0a
AG
176~/\&.config/lxpanel/\fIPROFILE\fR/gtkrc
177.RS 4
178optional GTK+ 2.0 RC file to alterate appearance, can be used to create custom panel style\&.
179.RE
180.SH "SEE ALSO"
181.BR lxpanelctl (1)
b8846481
AG
182.SH "AUTHOR"
183.PP
28a7cc0a
AG
184The \fBlxpanel\fR is written by great LXDE developers team under lead of
185Hong Jen Yee (PCMan) since 2006.
186.PP
187This manual page was written by paulliu (\fBYing\-Chun Liu\fR)
188<grandpaul@gmail\&.com> for the Debian system (but may be used by others)\&.
189Permission is granted to copy, distribute and/or modify this document under the terms of the
190GNU General Public License, Version 2 any later version published by the Free Software Foundation\&.
b8846481 191.PP
7c2c60fb 192On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL-2\&.
b8846481 193.PP
28a7cc0a 194Updated by Andriy Grytsenko (LStranger)\&.
b8846481
AG
195.SH "COPYRIGHT"
196.br
197Copyright \(co 2008 paulliu
198.br
28a7cc0a
AG
199Copyright \(co 2016 LStranger
200.br