1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
|
<!-- ############### Tasklist ############### -->
<sect2 id="tasklist-applet">
<title>Tasklist Applet</title>
<para>
<application>Tasklist</application> applet, shown in <xref
linkend="tasklist-applet-fig">, displays a table showing windowed
applications running on your computer. Depending on the options
chosen, you can display either those on the desktop currently in
use, or on all virtual desktops. To add this applet to a
<interface>Panel</interface>, right-click on the panel and choose
<menuchoice>
<guimenu>Applets</guimenu>
<guisubmenu>Utility</guisubmenu>
<guimenuitem>Tasklist</guimenuitem>
</menuchoice>.
</para>
<figure id="tasklist-applet-fig">
<title>Tasklist</title>
<screenshot>
<screeninfo>Tasklist</screeninfo>
<graphic format="png" fileref="figures/tasklist-fig" srccredit="John Fleck">
</graphic>
</screenshot>
</figure>
<sect3 id="tasklist-applet-usage">
<title>Usage</title>
<para><application>Tasklist</application> allows you to quickly
navigate the applications running on your computer, displaying
icons and application names for each application that meets the
criteria you've set in the <link
linkend="tasklist-applet-properties">properties window</link>. Clicking
on an icon or application name gives focus to that application,
bringing it to the foreground so it accepts your keyboard input.</para>
<para>Right-clicking with the mouse on an application's icon or
text in the applet brings up the following menu:</para>
<figure id="tasklist-rightclick-fig">
<title>Tasklist Right-Click Options</title>
<screenshot>
<screeninfo>Tasklist Right-Click Options</screeninfo>
<graphic format="png" fileref="figures/tasklist-rightclick-fig"
srccredit="John Fleck">
</graphic>
</screenshot>
</figure>
<para>
<itemizedlist>
<listitem>
<para><guilabel>Iconify</guilabel> — reduce the
selected application to a panel icon. When an application
already has been iconified, the menu item changes to
<guilabel>Restore</guilabel>. Clicking on it restores the
application to your desktop.</para>
</listitem>
<listitem>
<para><guilabel>Shade</guilabel> — minimize the
application to a single window bar. When an application
has been Shaded, the menu item changes to
<guilabel>Unshade</guilabel>. Clicking on
<guilabel>Unshade</guilabel> restores the application to
full size.</para>
</listitem>
<listitem>
<para><guilabel>Stick</guilabel> — make application
"sticky", which means it remains in your field of view when
you change virtual desktops, following you as you go. When
an application is sticky, the menu option
<guilabel>Unstick</guilabel> is displayed, allowing you to
leave an application behind as you continue your virtual
desktop travels.</para>
</listitem>
<listitem>
<para><guilabel>Kill</guilabel> — kills the
application. The <link
linkend="tasklist-applet-properties">properties
dialog</link> allows you to
have <application>Tasklist</application> prompt you for
confirmation before causing an application's untimely death.</para>
</listitem>
</itemizedlist>
</para>
</sect3>
<sect3 id="tasklist-task-grouping">
<title>Task Grouping</title>
<para><application>Tasklist</application> can group icons together when
multiple instances of a program are running. A number in parentheses
appears to next to the application. Clicking on the icon brings up a menu
listing all of the running instances.</para>
<figure id="tasklist-applet-grouping-fig">
<title>Task Grouping</title>
<!--
<screenshot>
<screeninfo>Task Grouping</screeninfo>
<graphic format="png" fileref="figures/tasklist-grouping"
srccredit="John Fleck">
</graphic>
</screenshot>
-->
</figure>
<para>Clicking on an item in the list brings that window to the foreground
and gives it focus.</para>
<para>By default, <application>Tasklist</application> groups four or more
applications. You can change this in the <link
linkend="tasklist-applet-properties">properties window</link>.</para>
</sect3>
<sect3 id="tasklist-applet-right-click">
<title>Right-Click Pop-Up Menu Items</title>
<para>
In addition to the standard menu items (see <xref
linkend="tasklist-standard-right-click-items">), the
right-click pop-up menu has
<guimenuitem>Properties...</guimenuitem> item — This menu
item opens the <interface>Properties</interface> dialog (see <xref
linkend="tasklist-applet-properties">) which allows you to
customize the appearance and behavior of this applet.
</para>
</sect3>
<sect3 id="tasklist-applet-properties">
<title>Properties</title>
<para>
You can configure <application>Tasklist</application> applet by
right-clicking on the applet and choosing the
<guimenuitem>Properties...</guimenuitem> menu item. This will open the
<interface>Properties</interface> dialog, shown in <xref
linkend="tasklist-applet-properties-fig">.
</para>
<figure id="tasklist-applet-properties-fig">
<title>Properties Dialog</title>
<screenshot>
<screeninfo>Properties Dialog</screeninfo>
<graphic format="png" fileref="figures/tasklist-properties"
srccredit="John Fleck">
</graphic>
</screenshot>
</figure>
<para>The <interface>Properties dialog</interface> allows to you
control which tasks are displayed:
<itemizedlist>
<listitem>
<para><guilabel>Show normal applications</guilabel> —
display, in the applet, all applications on the current
desktop that have not been minimized.</para>
</listitem>
<listitem>
<para><guilabel>Show iconified (minimized) applications
</guilabel> — show all applications on the current
desktop that have been minimized</para>
</listitem>
<listitem>
<para><guilabel>Show normal applications on all
desktops</guilabel> — show all full-sized,
non-minimized applications on all desktops. For this to
work, you must also have checked the <guilabel>Show normal
applications</guilabel> checkbox above.</para>
</listitem>
<listitem>
<para><guilabel>Show iconified (minimized) applications on
all desktops</guilabel> — show all applications that
have been minimized on all desktops. For this to work, you
must also have checked <guilabel>Show iconified (minimized)
applications</guilabel> above.</para>
</listitem>
</itemizedlist>
</para>
<para>
<itemizedlist>
<listitem>
<para><guilabel>Show mini icons</guilabel> — Some
applications support a miniature icon. This option displays
it on the <application>Tasklist</application> panel.</para>
</listitem>
<listitem>
<para><guilabel>Confirm before killing windows</guilabel>
— have the applet prompt you before you're permitted
to <link linkend="tasklist-rightclick-fig">kill an
application</link>.</para>
</listitem>
<listitem>
<para><guilabel>Move iconified tasks to current workspace
when restoring</guilabel> — automatically switches
the desktop work area on your screen to the one containing
the application you click on in the
<application>Tasklist</application> panel.</para>
</listitem>
<listitem>
<para><guilabel>Enable task grouping</guilabel> — Turns on
<application>Tasklist's</application> <ulink
url="tasklist-task-grouping">grouping feature</ulink> and controls the number of instances of an application that must be running before they are grouped.</para>
</listitem>
</itemizedlist>
</para>
<figure id="tasklist-applet-size-fig">
<title>Properties Dialog - Size</title>
<screenshot>
<screeninfo>Properties Dialog - Size</screeninfo>
<graphic format="png" fileref="figures/tasklist-properties-size"
srccredit="John Fleck">
</graphic>
</screenshot>
</figure>
<para>The <interface>size properties dialog</interface> controls
how much space <application>Tasklist</application> takes up on
your panel:
<itemizedlist>
<listitem>
<para><guilabel>Follow panel size</guilabel>
— have <application>Tasklist</application> size
determined automatically based on panel size. This overrides
other size options.</para>
</listitem>
<listitem>
<para><guilabel>Tasklist width (height)</guilabel>
— width (or height in vertical panel) of
<application>Tasklist</application> in pixels.</para>
</listitem>
<listitem>
<para><guilabel>Rows of tasks</guilabel>
— determines how many rows of task icons
<application>Tasklist</application> displays.</para>
</listitem>
<listitem>
<para><guilabel>Default task size</guilabel>
— set the default size for display of a task
item. (This only has effect if <guilabel>Tasklist width is
dynamic</guilabel> is checked below.)</para>
</listitem>
<listitem>
<para><guilabel>Tasklist width (height) is fixed
(dynamic)</guilabel> — Have the size of the tasklist
fixed or established by the applet dynamically. Setting it
to "fixed" means that the applet will always take the amount
of space set in "tasklist width", even if there are no
tasks. Setting it to <guilabel>dynamic</guilabel> means that
the applet will take as much space as needed to show all tasks (zero if
there are no tasks), but not more than the value set in
<guilabel>Tasklist width</guilabel>.</para>
</listitem>
<listitem>
<para><guilabel>Only use empty space</guilabel> — If width or
height is set to be dynamic, this option forces
<application>Tasklist</application> to use only the available space
on your screen, preventing it from pushing other applets out
of the way and off of your screen.</para>
</listitem>
</itemizedlist>
</para>
</sect3>
<sect3 id="basicPropertiesOptions">
<title>Basic Properties Options</title>
<para>All <interface>Properties</interface> dialogs have the following
buttons at the bottom of the dialog:
<itemizedlist>
<listitem>
<para>
<guibutton>OK</guibutton> —
Pressing <guibutton>OK</guibutton> will activate any changes
in the properties you have made and close the
<interface>Properties</interface> dialog.
</para>
</listitem>
<listitem>
<para>
<guibutton>Apply</guibutton> —
Pressing <guibutton>Apply</guibutton> at any time will
make your changes active without closing the
<interface>Properties</interface> dialog. This is helpful if
you would like to test the effects of the changes you have
made but may want to continue changing the properties.
</para>
</listitem>
<listitem>
<para>
<guibutton>Close</guibutton> —
Pressing <guibutton>Close</guibutton> will close the
<interface>Properties</interface> dialog. Only changes in the
configuration which were previously applied with the
<guibutton>Apply</guibutton> button will persist. Other
changes will be discarded.
</para>
</listitem>
<listitem>
<para>
<guibutton>Help</guibutton> —
Pressing <guibutton>Help</guibutton> brings up the manual for
the application, opening it to the page describing the
<interface>Properties</interface> dialog.
</para>
</listitem>
</itemizedlist>
</para>
</sect3>
<sect3 id="tasklist-standard-right-click-items">
<title>Standard Pop-Up Items</title>
<para>
All applets should have the following items in their right-click
<guimenu>pop-up menu</guimenu>:
<variablelist>
<varlistentry>
<term>Remove from panel</term>
<listitem>
<para>
The <guimenuitem>Remove from panel</guimenuitem> menu item
removes the applet from the <interface>Panel</interface>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Move</term>
<listitem>
<para>
After selecting <guimenuitem>Move</guimenuitem>, your mouse
pointer will change appearance (typically to a cross with
arrows in each direction). As you move your mouse, the applet
will move with it. When you have finished moving the applet,
click any mouse button and the applet will anchor in its
current position. Note that applets can be moved between two
<interface>Panels</interface> this way.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Panel</term>
<listitem>
<para>
The <guisubmenu>Panel</guisubmenu> submenu contains various
items and submenus for adding and removing
<interface>Panels</interface> and applets and for changing
the configuration.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>About</term>
<listitem>
<para>
The <guimenuitem>About...</guimenuitem> menu item brings up a
dialogue box containing various information about the applet,
typically including the applet's name, version, author,
copyright, license and description.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Help</term>
<listitem>
<para>
The <guimenuitem>Help</guimenuitem> menu item brings up the help
manual for the applet.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect3>
<sect3 id="tasklist-applet-bugs">
<title> Known Bugs and Limitations</title>
<para>
There are no known bugs in the
<application>Tasklist</application> applet.
</para>
</sect3>
<!-- ============= Authors ================================ -->
<sect3 id="tasklist-authors">
<title>Authors</title>
<para>
The <application>Tasklist</application> applet was written by Anders Carlsson
(<email>andersca@gnu.org</email>). Please send all comments,
suggestions, and bug
reports to the <ulink url="http://bugs.gnome.org/" type="http">GNOME
bug tracking database</ulink>. (Instructions for submitting bug
reports can be found <ulink
url="http://bugs.gnome.org/Reporting.html" type="http">
on-line</ulink>. If you are using
GNOME 1.1 or later, you can also use <application>Bug Report
Tool</application> (<command>bug-buddy</command>), available in the
<guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
Menu</guimenu>, for submitting bug reports.
</para>
<para>
This manual was written by John Fleck
(<email>jfleck@inkstain.net</email>). Please send all comments and
suggestions regarding this manual to the <ulink type="http"
url="http://developer.gnome.org/projects/gdp/">GNOME Documentation Project</ulink>
by sending an email to <email>docs@gnome.org</email>. You can also
submit comments online by using the <ulink type="http"
url="http://developer.gnome.org/projects/gdp/doctable/">GNOME Documentation Status
Table</ulink>.
</para>
<!-- For translations: uncomment this:
<para>
Latin translation was done by ME
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
suggestions regarding this translation to SOMEWHERE.
</para>
-->
</sect3>
<!-- ============= Application License ============================= -->
<!--
<sect3 id="license">
<title>License</title>
<para>
This program is free software; you can redistribute it and/or
modify it under the terms of the <ulink type="help"
url="gnome-help:gpl"><citetitle>GNU General Public
License</citetitle></ulink> as published by the Free Software
Foundation; either version 2 of the License, or (at your option)
any later version.
</para>
<para>
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<ulink type="help" url="gnome-help:gpl"><citetitle>GNU General
Public License</citetitle></ulink> for more details.
</para>
<para>
A copy of the <ulink type="help"
url="gnome-help:gpl"><citetitle>GNU General Public
License</citetitle></ulink> is included with the GNOME documentation. You
may also obtain a
copy of the <ulink type="help" url="gnome-help:gpl"><citetitle>GNU
General Public License</citetitle></ulink> from the Free Software
Foundation by visiting <ulink type="http"
url="http://www.fsf.org/">their Web site</ulink> or by writing to
<address>
Free Software Foundation, Inc.
<street>59 Temple Place</street> - Suite 330
<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
<country>USA</country>
</address>
</para>
</sect3>
-->
</sect2>
|