indent the sgml file
[lxde/lxpanel.git] / man / lxpanel.sgml
1 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2
3 <!-- Process this file with docbook-to-man to generate an nroff manual
4      page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
5      the manual page with: `docbook-to-man manpage.sgml | nroff -man |
6      less'.  A typical entry in a Makefile or Makefile.am is:
7
8 manpage.1: manpage.sgml
9         docbook-to-man $< > $@
10
11     
12         The docbook-to-man binary is found in the docbook-to-man package.
13         Please remember that if you create the nroff version in one of the
14         debian/rules file targets (such as build), you will need to include
15         docbook-to-man in your Build-Depends control field.
16
17   -->
18
19   <!-- Fill in your name for FIRSTNAME and SURNAME. -->
20   <!ENTITY dhfirstname "<firstname>Ying-Chun</firstname>">
21   <!ENTITY dhsurname   "<surname>Liu</surname>">
22   <!-- Please adjust the date whenever revising the manpage. -->
23   <!ENTITY dhdate      "<date>March  2, 2008</date>">
24   <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
25        allowed: see man(7), man(1). -->
26   <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
27   <!ENTITY dhemail     "<email>grandpaul@gmail.com</email>">
28   <!ENTITY dhusername  "paulliu">
29   <!ENTITY dhucpackage "<refentrytitle>LXPANEL</refentrytitle>">
30   <!ENTITY dhpackage   "lxpanel">
31
32   <!ENTITY debian      "<productname>Debian</productname>">
33   <!ENTITY gnu         "<acronym>GNU</acronym>">
34   <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
35 ]>
36
37 <refentry>
38   <refentryinfo>
39     <address>
40       &dhemail;
41     </address>
42     <author>
43       &dhfirstname;
44       &dhsurname;
45     </author>
46     <copyright>
47       <year>2008</year>
48       <holder>&dhusername;</holder>
49     </copyright>
50     &dhdate;
51   </refentryinfo>
52   <refmeta>
53     &dhucpackage;
54
55     &dhsection;
56   </refmeta>
57   <refnamediv>
58     <refname>&dhpackage;</refname>
59
60     <refpurpose>a lightweight GTK2-based panel for LXDE desk-
61        top.</refpurpose>
62   </refnamediv>
63   <refsynopsisdiv>
64     <cmdsynopsis>
65       <command>&dhpackage;</command>
66     </cmdsynopsis>
67   </refsynopsisdiv>
68   <refsect1>
69     <title>DESCRIPTION</title>
70
71     <para>This manual page documents briefly the
72       <command>&dhpackage;</command> command.</para>
73
74     <para><command>&dhpackage;</command> is a program that provides a panel
75     for desktop, usually for LXDE. It is lightweight GTK+ 2.x based desktop 
76     panel.
77     </para>
78    
79     <para>
80     <itemizedlist spacing='normal' mark='bullet'>
81         <title>Features</title>
82         <listitem><para>User-friendly application menu automatically generated from <filename>.desktop</filename>
83                 files on the system.
84                 </para>
85         </listitem>
86         <listitem><para>Launcher bar (small icons clicked to launch apps)</para></listitem>
87         <listitem><para>Task bar supporting urgency hint (can be flash when gaim gets new
88                 incoming messages)</para>
89         </listitem>
90         <listitem><para>Notification area (system tray)</para></listitem>
91         <listitem><para>Digital clock</para></listitem>
92         <listitem><para>Run dialog (a dialog let you type a command and run, can be called
93                 in external programs)</para>
94         </listitem>
95         <listitem><para>Net status icon plug-in (optional)</para></listitem>
96         <listitem><para>Volume control plug-in (optional)</para></listitem>
97         <listitem><para>lxpanelctl, an external controller let you control lxpanel in
98                 other programs. For example, "lxpanelctl run" will show the Run
99                 dialog in lxpanel, and "lxpanelctl menu" will show the application
100                 menu. This is useful in key bindings provided by window managers.</para>
101         </listitem>
102     </itemizedlist>
103     </para>
104   </refsect1>
105   <refsect1>
106     <title>FILES</title>
107     <variablelist>
108      <varlistentry>
109        <term><filename>~/.config/lxpanel</filename></term>
110        <listitem>
111          <para>config file, can be edited by preference dialog.</para>
112        </listitem>
113       </varlistentry>
114     </variablelist>
115   </refsect1>
116   <refsect1>
117     <title>SEE ALSO</title>
118
119     <para>lxsession (1).</para>
120
121   </refsect1>
122   <refsect1>
123     <title>AUTHOR</title>
124
125     <para>This manual page was written by &dhusername; &dhemail; for
126       the &debian; system (but may be used by others).  Permission is
127       granted to copy, distribute and/or modify this document under
128       the terms of the &gnu; General Public License, Version 2 any 
129       later version published by the Free Software Foundation.
130     </para>
131     <para>
132           On Debian systems, the complete text of the GNU General Public
133           License can be found in /usr/share/common-licenses/GPL.
134     </para>
135
136   </refsect1>
137 </refentry>
138
139 <!-- Keep this comment at the end of the file
140 Local variables:
141 mode: sgml
142 sgml-omittag:t
143 sgml-shorttag:t
144 sgml-minimize-attributes:nil
145 sgml-always-quote-attributes:t
146 sgml-indent-step:2
147 sgml-indent-data:t
148 sgml-parent-document:nil
149 sgml-default-dtd-file:nil
150 sgml-exposed-tags:nil
151 sgml-local-catalogs:nil
152 sgml-local-ecat-files:nil
153 End:
154 -->