index.docbook 74.5 KB
Newer Older
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1
<?xml version="1.0" ?>
Laurent Montel's avatar
Laurent Montel committed
2
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE"><!-- change language only here -->
]>

<book id="dolphin" lang="&language;">

<bookinfo>
<title>The &dolphin; Handbook</title>

<authorgroup>
<author>
<firstname>Peter</firstname>
<othername></othername>
<surname>Penz</surname>
<affiliation>
<address><email>peter.penz@gmx.at</email></address>
</affiliation>
</author>
<author>
<firstname>Orville</firstname>
<surname>Bennett</surname>
<affiliation>
<address>&Orville.Bennett.mail;</address>
</affiliation>
</author>
<author>
<firstname>Michael</firstname>
<surname>Austin</surname>
<affiliation>
<address><email>tuxedup@users.sourceforge.net</email></address>
</affiliation>
</author>
<author>
<firstname>David</firstname>
<surname>Edmundson</surname>
<affiliation>
<address><email>kde@davidedmundson.co.uk</email></address>
</affiliation>
</author>
<author>
<firstname>Alan</firstname>
<surname>Blanchflower</surname>
</author>
<author>
<firstname>Frank</firstname>
<surname>Reininghaus</surname>
<affiliation>
<address><email>frank78ac@googlemail.com</email></address>
</affiliation>
</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2006</year>
<holder>Peter Penz</holder>
</copyright>
<copyright>
<year>2006</year>
<holder>&Orville.Bennett;</holder>
<holder>Michael Austin</holder>
</copyright>
<copyright>
<year>2009</year>
<holder>Frank Reininghaus</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

73
74
<date>2021-04-08</date>
<releaseinfo>Applications 21.08</releaseinfo>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
75
76
77

<abstract>
<para>
78
&dolphin; is the default file manager by &kde;, designed with usability as a primary focus.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Dolphin</keyword>
<keyword>Filemanager</keyword>
<keyword>file</keyword>
<keyword>management</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>
96
&dolphin; is &plasma;'s default file manager. It aims to improve usability at the
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
user interface level. &dolphin; focuses only on being a file manager whereas
&konqueror;, which was &kde;'s default file manager in &kde; 3 and can still be
used for file management, is a universal viewer for many file types.
</para>

<para>
This design approach allows the developers to concentrate on optimizing the user
interface for the specific task of file management.
</para>

<para>
Please report any problems or feature requests to the &dolphin; author via the
bug report dialog. This is accessible either from the <guibutton>Control</guibutton> 
button at the right of the toolbar in the default mode without
menubar; or from <menuchoice><guimenu>Help</guimenu><guimenuitem>Report Bug...</guimenuitem></menuchoice>
menu of the application, if the menubar is shown.
</para>

</chapter>

<chapter id="using-dolphin">
<title>Using &dolphin;</title>

<sect1 id="dolphin-user-interface">
<title>&dolphin; User Interface</title>

<para>
The screenshot below shows &dolphin;'s default user interface:
</para>

<screenshot>
<screeninfo>Screenshot of &dolphin;'s default user interface</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="default-ui.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&dolphin;'s default user interface.</phrase>
</textobject>
<caption><para>&dolphin;'s default user interface.</para></caption>
</mediaobject>
</screenshot>

<para>
The elements of the default user interface are:

<itemizedlist>

<listitem><para>
The toolbar, which can be used for quick access to frequently used actions. The
toolbar can be customized by clicking it with the &RMB; and choosing
<menuchoice><guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>
from the context menu, with <guimenuitem>Configure Toolbars...</guimenuitem>
from the <guibutton>Control</guibutton> button at the 
right of the toolbar or via <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>
from the main menu.
</para>
<screenshot>
<screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The default toolbar.</phrase>
</textobject>
<caption>
<para>
Toolbar items where the icon is sufficient for knowing the command do not have text
alongside the icons. This can be changed by a &RMB; click and selecting the item text 
below <guilabel>Show Text</guilabel>. The <guibutton>Control</guibutton> 
button at the right side of the toolbar is only displayed if the menubar is hidden.
</para>
</caption>
</mediaobject>
</screenshot>
</listitem>

<listitem><para>
The location bar, which always displays the path to the current folder. It can
be switched between two different modes, see the
<link linkend="location-bar">section on the location bar</link> for details.
</para></listitem>

<listitem><para>
The <link linkend="dolphin-view">view</link>, which shows all files
and folders in the current folder.
</para></listitem>

<listitem><para>
The <link linkend="places-panel"><guilabel>Places</guilabel> panel</link>, which
provides quick access to bookmarked locations and disks or other media.
</para>
<para>If desktop search and file indexing are enabled in the <guilabel>Desktop Search</guilabel> 
192
module in the &systemsettings; the panel provides <guilabel>Recent</guilabel>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
items and allows you to search for <guilabel>Documents</guilabel>, <guilabel>Images</guilabel>,
<guilabel>Audio Files</guilabel> and <guilabel>Video</guilabel>.
</para></listitem>

<listitem><para>
The status bar. It displays the name, size and type of the file which is
currently hovered over with the mouse, or the number and size of the files which are
selected. At the right, there is a zoom slider that allows you to adjust the size
of the icons in the view.
</para></listitem>

<listitem><para>
The menubar (hidden by default), which provides access to all commands and configuration options.
See the <link linkend="commands-menubar">Command Reference</link> for a list of
all menu commands. The menubar can be toggled with 
<guimenuitem>Show Menubar</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>) 
from the <guimenu>Settings</guimenu> menu or the <guibutton>Control</guibutton> button.
</para>
<para>If the menubar is hidden, all its actions are available from the 
<guibutton>Control</guibutton> button.
</para></listitem>

<listitem><para>
The additional <guilabel>Information</guilabel>, <guilabel>Folders</guilabel> 
and <guilabel>Terminal</guilabel> panels are hidden
by default, for more information see <link linkend="panels"><guilabel>Panels</guilabel>.</link>
</para></listitem>

</itemizedlist>

</para>

</sect1>

<sect1 id="dolphin-view">
<title>The &dolphin; View</title>

<sect2 id="dolphin-view-using">
<title>Using the View</title>

<para>
The view displays all files and folders in the current folder. These items
can be accessed or manipulated in different ways:
</para>
<itemizedlist>

<listitem><para>
A file or folder can be opened by clicking it with the &LMB; (or
241
242
243
double-clicking, if <guilabel>Open by double-clicking instead</guilabel>
is enabled in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
<guimenuitem>General Behavior</guimenuitem></menuchoice> module).
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
</para></listitem>

<listitem><para>
Clicking any item or the white area around the items with the &RMB; opens a
context menu which provides access to many frequently used actions for the item
or the current folder, respectively.
</para></listitem>

<listitem><para>
If the &LMB; is pressed on an item, but not immediately released, the item can
be dragged and dropped in another folder in the current view or in another
&dolphin; view (in another &dolphin; window or in the same window if the
view is split, see below) to move or copy it or to create a symbolic link.
Items can even be dropped in another application to open them in that application.
</para></listitem>

</itemizedlist>
<para>
&dolphin; remembers the history of visited folders. To navigate backward or
forward in the history, the corresponding buttons in the toolbar can be used:
</para>

<screenshot>
<screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-navigation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The Back and Forward buttons in the toolbar.</phrase>
</textobject>
<caption>
<para>
The <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons in
the toolbar can be used to navigate in the history.
</para>
</caption>
</mediaobject>
</screenshot>

284
285
286
<para>If you click with the &MMB; the item in the history is opened in a new tab
thus keeping the current tab with its content.
</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
</sect2>

<sect2 id="dolphin-view-appearance">
<title>&dolphin; View Appearance</title>

<para>
The toolbar contains buttons to control the appearance of the view:
</para>

<screenshot>
<screeninfo>Screenshot of &dolphin;'s toolbar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="toolbar-view-appearance.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The buttons in the toolbar which control the appearance of the view.</phrase>
</textobject>
<caption><para>
The buttons in the toolbar which control the appearance of the view.
</para></caption>
</mediaobject>
</screenshot>

<para>
All the settings discussed below and other options concerning, &eg; the
sorting of the files in the current folder, can also be modified in the
<guimenu>View</guimenu> menu and in the
315
<link linkend="view-properties-dialog">View Display Style dialog</link>. By
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
default, these settings are remembered for each folder separately. This
behavior can be changed in the
<link linkend="preferences-dialog-general"><quote>General</quote></link> section of the settings.
</para>

<sect3 id="dolphin-view-modes">
<title>View Modes</title>

<para>
The first three buttons in the above screenshot switch between &dolphin;'s
view modes.
<!-- begin copy to konqueror filemanager.docbook -->
<itemizedlist>

<listitem><para>
In the <guibutton>Icons</guibutton> view, which is the default, files will be
represented by an icon that visualizes the file type, and a folder icon will be
shown for subfolders. The names of folders and files, and the items enabled in
<menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice>,
are displayed below the icons.
</para></listitem>

<listitem><para>
The <guilabel>Compact</guilabel> view shows the folder contents as icons with 
the name beside it and the items enabled in
<menuchoice><guimenu>View</guimenu><guisubmenu>Additional Information</guisubmenu></menuchoice> 
below the name. The items are grouped in columns similar to the <guilabel>Short View</guilabel> 
in the &kde; file dialog.
</para></listitem>

<listitem><para>
In the <guibutton>Details</guibutton> view, the folder contents are displayed
as a detailed list which contains the name, size and last modification time of
each item. Additional columns can be added by clicking a column header with the
&RMB;.
</para>
<para>In the context menu of the header line you can choose between custom or automatic 
column width. Automatic width adjusts the width of all columns once to display the longest 
item in the column completely, except for the <guilabel>Name</guilabel> column where 
the extension is replaced by <quote>...</quote> 
</para>
<para>The order of columns can be changed by drag and drop of column headers, except for
the <guilabel>Name</guilabel> header, which is always the first column in this view.
</para>
<para>
361
The details view allows you to view the current folder
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
362
in a tree-like fashion if <link linkend="preferences-dialog-viewmodes-details">
363
<guilabel>Expandable folders</guilabel></link> are enabled:
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
364
Each subfolder of the current folder can be
365
366
<quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>></guiicon>
or <guiicon>v</guiicon> icon next to it.</para></listitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
</itemizedlist>
</para>

<screenshot>
<screeninfo>Grouped View</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="grouping-view.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Grouped View</phrase>
</textobject>
<caption><para>All view modes support grouping by the sort type selected 
in <menuchoice><guimenu>View</guimenu><guisubmenu>Sort by</guisubmenu></menuchoice></para></caption>
</mediaobject>
</screenshot>
<!-- end copy to konqueror filemanager.docbook -->

</sect3>

<sect3 id="dolphin-view-information">
<title>Information in the View</title>
<para>
390
In all view modes &dolphin; shows at least an icon and a name for each item. 
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
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
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
Using <guisubmenu>Additional Information</guisubmenu> in the <guimenu>View</guimenu> 
menu or the context menu of the header in <guilabel>Details</guilabel> mode, you can select
more information for each item to be shown:
</para>

<para>
<guimenuitem>Size</guimenuitem>, <guimenuitem>Date</guimenuitem>,
<guimenuitem>Type</guimenuitem>, <guimenuitem>Rating</guimenuitem>,
<guimenuitem>Tags</guimenuitem> or <guimenuitem>Comment</guimenuitem>.
</para>

<para>Depending on the file type, additionally, sorting criteria can be selected:
<simplelist>
  <member><guimenuitem>Document</guimenuitem>: Number of words and lines</member>
  <member><guimenuitem>Image</guimenuitem>: Size and orientation</member>
  <member><guimenuitem>Audio</guimenuitem>: Artist, album, duration and track</member>
</simplelist>
</para>

<para>The <guisubmenu>Other</guisubmenu> submenu allows you to select
<guimenuitem>Path</guimenuitem>, <guimenuitem>Link Destination</guimenuitem>, 
<guimenuitem>Copied From</guimenuitem>,
<guimenuitem>Permissions</guimenuitem>, <guimenuitem>Owner</guimenuitem> or 
<guimenuitem>User Group</guimenuitem>.
</para>

</sect3>

<sect3 id="preview">
<title>Preview</title>

<para>
If <guibutton>Preview</guibutton> is enabled, the icons are based on the actual
file or folder contents; &eg; for images a scaled down preview of the image is
shown.
</para>

</sect3>

<sect3 id="split-view">
<title>Split</title>

<para>
If <guibutton>Split</guibutton> is clicked, two views are shown which can
display the contents of different folders. This can be convenient for moving or
copying files.
</para>

</sect3>

</sect2>
<!-- begin copy to konqueror filemanager.docbook -->
<sect2 id="selection">
<title>Selecting Items in the View</title>

<para>
There are several ways to select items in the view. Once a group of items
is selected, all actions, such as
<menuchoice><guimenuitem>Cut</guimenuitem></menuchoice>,
<menuchoice><guimenuitem>Copy</guimenuitem></menuchoice>,
<menuchoice><guimenuitem>Move to Trash</guimenuitem></menuchoice>,
and drag and drop operations, affect all selected items.
</para>

<sect3 id="selection-mouse">
<title>Selecting Items Using the Mouse</title>

<itemizedlist>

<listitem><para>
You can press the &LMB; somewhere in the view and draw a rectangle around
a group of items before releasing the button. This will select all items in the
rectangle and clear the previous selection. If the &Shift; key is pressed during
the selection process, the previous selection is kept.
</para></listitem>

<listitem><para>
If the &Ctrl; key is pressed while an item is clicked with the &LMB;, the
selection state of this item is toggled. If the &Ctrl; key is pressed while a
rectangle is drawn around a group of items as described above, the selection
state of all items in the rectangle will be toggled.
</para></listitem>

<listitem><para>
If the &Shift; key is pressed while an item is clicked with the &LMB;, all items
between the previous current item and the clicked item will be selected.
</para></listitem>

<listitem><para>
If <guilabel>Show selection marker</guilabel> is enabled in the
<link linkend="preferences-dialog-general-behavior"><quote>Behavior</quote>
tab of the <guilabel>General</guilabel> section of the settings</link>, a small
<guiicon>+</guiicon> or <guiicon>-</guiicon> button appears in the top
left corner of the item which is currently hovered over with the mouse. Clicking
this sign selects or deselects the item, respectively.
</para></listitem>

</itemizedlist>

</sect3>

<sect3 id="selection-keyboard">
<title>Selecting Items Using the Keyboard</title>

<itemizedlist>

<listitem><para>
If an arrow key, <keycap>Page Up</keycap>, <keycap>Page Down</keycap>,
<keycap>Home</keycap>, or <keycap>End</keycap> is pressed, the new current item
is selected, and the previous selection is cleared.
</para></listitem>

<listitem><para>
If the &Ctrl; key is held while one of the above keys is pressed, the selection
remains unchanged.
</para></listitem>

<listitem><para>
If the &Shift; key is held while one of the above keys is pressed, all items
between the previous current item and the new current item will be selected.
</para></listitem>

<listitem><para>
If <keycombo action="simul">&Ctrl;<keysym>Space</keysym></keycombo> is pressed,
the selection state of the current item is toggled.
</para></listitem>

<listitem><para>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> selects all items
in the view.
</para></listitem>

<listitem><para>
<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo> toggles the
selection state of all items in the view.
</para></listitem>

<listitem><para>
Select a file or folder by typing the first few letters of its name and the 
first matching item is selected. 
To clear the selection and cancel the keyboard search press &Esc; or wait longer than
the timeout of 1 second.
</para></listitem>
</itemizedlist>
<!-- END copy to konqueror filemanager.docbook -->
</sect3>

</sect2>

</sect1>

<!--FIXME replace with links to KDE Fundamentals when location bar in file dialog
has all features from dolphin ?-->

<sect1 id="location-bar">
<title>Location Bar</title>

<para>
The location bar, which can be found above &dolphin;'s view, displays
the path to the current folder. The location bar has two modes.
</para>

<sect2 id="location-bar-bread-crumb">
<title>Bread Crumb Mode</title>

<para>
In the <quote>bread crumb</quote> mode, which is the default, each folder name in
the path to the current folder is a button which can be clicked to quickly open
that folder. Moreover, clicking the <quote>&gt;</quote> sign to the right of a
folder opens a menu which allows you to quickly open a subfolder of that folder.
</para>

<screenshot>
<screeninfo>Screenshot of the location bar in bread crumb mode</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="locationbar-breadcrumb.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Location bar in bread crumb mode.</phrase>
</textobject>
<caption><para>Location bar in bread crumb mode.</para></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="location-bar-editable">
<title>Editable Mode</title>

<para>
When in bread crumb mode, clicking in the gray area to the right of the path
with the &LMB; switches the location bar to <quote>editable</quote> mode,
in which the path can be edited using the keyboard. To switch back to bread
crumb mode, click the check mark at the right of the location bar with the &LMB;.
</para>

<screenshot>
<screeninfo>Screenshot of the location bar in editable mode</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="locationbar-editable.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Location bar in editable mode.</phrase>
</textobject>
<caption><para>Location bar in editable mode.</para></caption>
</mediaobject>
</screenshot>

<sect3 id="location-bar-editable-kioslaves">
<title>Using Kioslaves</title>

<para>If the location bar is empty in editable mode, a drop down box appears in 
front of the bar listing all available kioslaves on your system. Kioslaves are 
programs built into &kde; which add support for many different protocols to 
&dolphin; and other &kde; applications.</para> 

<para>For example with the <quote>fish</quote> kioslave &dolphin; can be 
used to manage files and folders on a remote host that is accessible 
via <acronym>SSH</acronym>. To do this you would type <userinput>fish://username@remotehost</userinput> 
into the location bar. Similar remote file management can be done on 
Carl Schwan's avatar
Carl Schwan committed
613
remote hosts accessible via the &FTP;, &NFS;, SFTP, &SMB; (&CIFS;) or webdav protocols.</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
614

Carl Schwan's avatar
Carl Schwan committed
615
<para>It is also possible to use the kioslaves drop down box to access 
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
616
&systemsettings;, fonts, trash, other programs and devices attached to your computer. 
Carl Schwan's avatar
Carl Schwan committed
617
See the drop down box for the full list of capabilities available from kioslaves on your system.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
</para>
<screenshot>
<screeninfo>Screenshot of the list of kioslaves</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="locationbar-kioslaves-menu.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Location bar showing list of available kioslaves.</phrase>
</textobject>
<caption><para>List of available kioslaves.</para></caption>
</mediaobject>
</screenshot>

</sect3>
</sect2>

<sect2 id="location-place-context">
<title>Places and Context</title>
<!--FIXME this is now in file dialog in 4.11-->
<para>
If the <guilabel>Places</guilabel> panel is hidden; in both modes an additional icon 
in front of the path is displayed. This icon can be clicked with the &LMB; to open a 
menu which offers quick access to <quote>places</quote> and storage media. See the 
<link linkend="places-panel">section about the Places Panel</link> for details.
</para>

<screenshot>
<screeninfo>Location bar with Places icon</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="locationbar-places-icon.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Location bar with Places icon</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>The context menu of the location bar offers actions to switch between the modes and
to copy and paste the path using the clipboard. Check the last option in this context menu to
display either the full path starting with the root folder of the file system or to display 
the path starting with the current places entry.
</para>

<screenshot>
<screeninfo>Location bar context menu</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="locationbar-context-menu.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Location bar  context menu</phrase>
</textobject>
</mediaobject>
</screenshot>

</sect2>

</sect1>

<sect1 id="panels">
<title>Panels</title>

<para>
&dolphin; allows a number of panels to be placed next to the view. These can
Yuri Chornoivan's avatar
Yuri Chornoivan committed
684
be enabled in <menuchoice><guimenu>View</guimenu><guisubmenu>Show Panels</guisubmenu></menuchoice>.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
685
686
687
688
689
690
691
692
By unlocking the panels and clicking and dragging a panel title, the panel can be moved 
to a different position, even outside the window.
</para>

<sect2 id="places-panel">
<title>Places</title>
<!--FIXME difference between places panel in dolphin + kde filedialog + konqueror:
context menu Icon Size? No different entries ?-->
693
<!--Four groups: Places = Folders, Devices, Recent and with Baloo Search For -->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
<para>
The <guilabel>Places</guilabel> panel is located at the left of the window by
default. The <guilabel>Places</guilabel> panel shows any locations you have
bookmarked. It also shows any disk or media attached to the computer, recently accessed items
and allows you to search for certain type of files. The order of these entries can be changed by drag and drop.
</para>

<para>
The easiest way to add a folder to the <guilabel>Places</guilabel> panel is to
drag it and drop it in the panel. Moreover, you can click inside the panel with
the &RMB; and choose <menuchoice><guimenuitem>Add Entry...</guimenuitem></menuchoice>
from the context menu. The first procedure creates a system wide bookmark, the second
procedure can be used to add the current path of the location bar or any desired folder or device.
A dialog opens where label, location and icon can be edited and the usage of this entry 
can be restricted to &dolphin;. 
</para>

<para>A &RMB; click opens the context menu to edit, add, hide or remove entries
and change the icon size to one of the predefined values or lock/unlock the panels.
</para>
<para>The context menu has an action to open the entry in a new tab. 
Devices can be unmounted using the context menu.
</para>
</sect2>

<sect2 id="information-panel">
<title>Information</title>

<para>
The <guilabel>Information</guilabel> panel shows extended information about the
selected items(s) or about the current folder or the file which is currently hovered
over with the mouse, including size, type, and date of last modification. It also
features a large preview of the selected item and allows you to assign a rating,
tags, and comments to it.
</para>
729
<!--FIXME panel context menu-->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
730
731
732
733
734
735
736
737
738
739
</sect2>

<sect2 id="folders-panel">
<title>Folders</title>

<para>
The <guilabel>Folders</guilabel> panel shows a tree view structure of the file
system. It only shows folders. Clicking a folder with the &LMB; opens this folder
in the &dolphin; view.
</para>
740
741
742
<para>Use <guilabel>Limit to Home Directory</guilabel> to hide all folders from
the tree view except your <guilabel>Home</guilabel>.
</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
743
744
745
746
747
748
749
750
</sect2>

<sect2 id="terminal-panel">
<title>Terminal</title>

<para>
This panel contains a terminal. The terminal will open at the folder currently
shown in the &dolphin; view. Changing the folder in the active &dolphin;
751
752
753
view will update the working folder of the terminal. Changing the directory in
the terminal will update the working folder in the &dolphin; view.  The
terminal only works with local media.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
</para>

</sect2>

</sect1>

<sect1 id="quick-tips">
<title>Quick Tips</title>

<para>
The following are a number of tips to save time when using &dolphin;.
</para>

<sect2 id="quick-bookmarking">
<title>Quick Bookmarking</title>

<para>
To quickly create a bookmark in the <guilabel>Places</guilabel> panel for the
current folder, &RMB; click in the work space and click
<menuchoice><guimenuitem>Add to Places</guimenuitem></menuchoice> in the context menu.
</para>

776
777
778
779
780
781
782
<note>
    <para>
        The corresponding menu item visibility can be toggled via the
        <link linkend="preferences-dialog-context-menu">&dolphin; context menu settings</link>.
    </para>
</note>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
783
784
</sect2>

785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
<sect2 id="filter-files">
<title>Filtering Files</title>

<para>
&dolphin; is capable of filtering files, &ie; showing only those items in the
view whose name contains a given text. For example, if you wish to show
only the <acronym>MP3</acronym> files within a folder, you could filter for <quote>.mp3</quote>.
This would then filter out all files whose name does not contain <quote>.mp3</quote>.
</para>

<para>
To filter files, first enable the filter bar, either by pressing <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
or via the menu: <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Filter...</guimenuitem> </menuchoice>.
You can then enter the text to be filtered for in the filter bar. The filter bar can
be disabled either by pressing &Esc;, or with a &LMB; click on the 
<guiicon>Hide Filter Bar</guiicon> icon.
</para>

</sect2>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
805
806
807
<sect2 id="finding-searching-in-file">
<title>Finding Files and Searching in Files</title>
<!-- FIXME search in hidden files + folders View -> Show Hidden Files has to be enabled ? -->
808
<!-- https://bugs.kde.org/show_bug.cgi?id=361557 No clear way to open configuration dialog for Baloo search engine -->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
809
810
811
<para>
&dolphin; is capable of searching for files and for content in files. If <keycombo action="simul">
&Ctrl;<keycap>F</keycap></keycombo> is pressed or <menuchoice> <guimenu>Edit</guimenu> 
812
<guimenuitem>Search...</guimenuitem> </menuchoice> is used, the <guilabel>Search</guilabel>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
813
814
815
816
817
818
bar will open already set up to search for files within the current folder and any sub-folders.
Start to type into the find input box and the search starts immediately.
<screenshot>
<screeninfo>Search files and for content in files</screeninfo>
<mediaobject>
<imageobject>
819
<imagedata fileref="baloo-search.png" format="PNG"/>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
820
821
822
823
824
825
826
827
828
829
830
831
</imageobject>
<textobject>
<phrase>Search files and for content in files</phrase>
</textobject>
<caption><para>&dolphin; searching files and for content in files.</para></caption>
</mediaobject>
</screenshot>
</para>
<para>The search is case insensitive, and does not require surrounding wildcards 
(<userinput>*foo*</userinput> and <userinput>foo</userinput> are equivalent), 
but you can use wildcards inside the search term. <userinput>*</userinput> will match 
zero or more characters, <userinput>?</userinput> only one single character.</para>
832
<para>This feature can be used with running Baloo services; without these services
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
833
a KIOSlave is launched to provide the search results.</para>
834
835
<para>The option from <guilabel>Everywhere</guilabel> with activated Baloo 
services searches in all indexed folders, without Baloo this option  
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
836
837
838
839
840
starts the search from the user's <replaceable>Home</replaceable> folder.</para>
<screenshot>
<screeninfo>Search with More Options</screeninfo>
<mediaobject>
<imageobject>
841
<imagedata fileref="baloo-search-more-options.png" format="PNG"/>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
842
843
844
845
846
847
848
849
850
</imageobject>
<textobject>
<phrase>Search with More Options</phrase>
</textobject>
<caption><para>&dolphin; searching with More Options.</para></caption>
</mediaobject>
</screenshot>

<para>
851
Use the <guilabel>More Options</guilabel> button to extend the <guilabel>Search</guilabel>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
852
853
854
855
bar. This provides a very comfortable way for 
the user to shrink the number of search results.</para>
<para>To start a search select one or more file types (<guilabel>Documents</guilabel>, 
<guilabel>Audio</guilabel>, <guilabel>Video</guilabel>, <guilabel>Images</guilabel>),
856
857
858
859
a time period, rating, and tag, if you have defined any via
<userinput>tag:<replaceable>foo</replaceable></userinput> in the input box.</para>
 
 <para>It is possible to clear selection using the <guibutton>Clear Selection</guibutton> button.</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
860
861

<para>Alternatively you can use these options in the <guilabel>Places</guilabel> panel 
862
together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit 
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
863
864
the search to files matching the filter expression.</para>

865
866
867
868
<para>Use the Save icon to save a search to the <guilabel>Search For</guilabel>
section in the <guilabel>Places</guilabel> panel to quickly access it again in the future.
</para>

869
870
871
<para>
Use the <guilabel>More Search Tools</guilabel> drop-down list to select other search tools than Baloo.
</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
</sect2>

<sect2 id="mounting-storage-media">
<title>Mounting Storage Media</title>

<para>
A quick way to mount Storage Media is to click on the device in the
<guilabel>Places</guilabel> panel. This will mount and open the device in &dolphin;.
</para>

</sect2>

<sect2 id="undo-actions">
<title>Undo Actions</title>

<para>
&dolphin; is capable of undoing changes you have made to files. For example if
you moved a file to the Trash, &dolphin; can undo this and move it back to its
original location. To undo an action, press <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
or select <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Undo: (action name)</guimenuitem> </menuchoice>
in the menu, &eg; <guimenuitem>Undo: Rename</guimenuitem>.
</para>

</sect2>
896
<!-- FIXME https://phabricator.kde.org/D10698-->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
897
898
899
900
901
902
903
<sect2 id="batch-rename">
<title>Renaming A Batch Of Files</title>
<para>
&dolphin; is capable of renaming a number of files at the same time. Each file
will have the file name specified, including a number, &eg;, Image1.jpg,
Image2.jpg, Image3.jpg. This can be useful, &eg;, for pictures taken with a digital camera.
</para>
904
<!--double click-->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
<para>
If you wish to rename a batch of files, first select the files to be renamed.
This can be done by pressing the &LMB; and drawing a rectangle around the files
to be renamed before releasing it, or by holding &Ctrl; and clicking each file
to be renamed (see <link linkend="selection">Selecting Items in the View</link>
for more details on item selection). Then open the batch-rename dialog by pressing
<keycap>F2</keycap> or via the File menu:
<menuchoice> <guimenu>File</guimenu> <guimenuitem>Rename...</guimenuitem> </menuchoice>
</para>

<para>
Then enter the name you wish to give the files. The # character must be present
within the name. The files will then be renamed, where the <userinput>#</userinput> 
character is replaced by a different consecutive number for each file.
</para>

<para>If all file extensions in your selection are different, the name of all files 
can be changed without using a <userinput>#</userinput> placeholder while preserving 
the file extensions. This is &eg; useful to rename a video file and all associated 
subtitle files, which have the same filename, but different extensions.
</para>
</sect2>

<sect2 id="compare-files">
<title>Comparing A Selection Of Files or Folders</title>

<para>
If the &kompare; application is installed, you can use it to see the differences
between two files or folders.
</para>

<para>
First select the two files or folders to be compared. Then launch the &kompare; application
via the Tools menu: <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Compare Files</guimenuitem> </menuchoice>.
&kompare; will then open showing the differences between the files or folders.
</para>

</sect2>

</sect1>

</chapter>

<chapter id="configuring-dolphin">
<title>Configuring &dolphin;</title>

<para>
&dolphin; distinguishes two different kinds of settings:

<itemizedlist>

<listitem><para>
Settings which affect the general behavior of &dolphin;. These can be configured
using the <link linkend="preferences-dialog">Preferences Dialog</link>.
</para></listitem>

<listitem><para>
Settings which determine how the contents of a folder are displayed in &dolphin;.
963
These settings are called <link linkend="view-properties">View Display Styles</link>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
964
and can be controlled with toolbar buttons, via the <guimenu>View</guimenu> menu,
965
966
967
and with the <link linkend="view-properties-dialog">View Display Style dialog</link>.
In the default configuration, all folders use the same display style,
but &dolphin; can also be configured to remember each folder's display style separately
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
in the <link linkend="preferences-dialog-general-behavior"><quote>General</quote>
section of the settings</link>.
</para></listitem>

</itemizedlist>

</para>

<sect1 id="preferences-dialog">
<title>The &dolphin; Preferences Dialog</title>
<para>
The Preferences Dialog is opened via <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure &dolphin;...</guimenuitem></menuchoice> in the menu in
&dolphin;'s main window. The settings are divided into several groups which can
be accessed by clicking the corresponding icon on the left of the dialog.
</para>

<para>All settings except for the <guilabel>Startup</guilabel> page and the <guilabel>Status Bar</guilabel>
tab on the <guilabel>General</guilabel> page are shared with &konqueror; in filemanager mode.
</para>

Nate Graham's avatar
Nate Graham committed
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
<sect2 id="preferences-dialog-general">
<title>General</title>

<para>
This group contains settings which control the general behavior of &dolphin;.
The group is divided further into four subgroups which can be accessed using the
tab bar at the top.

<screenshot>
<screeninfo>Screenshot of the General settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-general-behavior.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>General Settings.</phrase>
</textobject>
<caption><para>General Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

</para>

<sect3 id="preferences-dialog-general-behavior">
<title>Behavior Tab</title>

<para>

<itemizedlist>

<listitem><para>
1020
In the <guilabel>View</guilabel> section, you can configure whether the same
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1021
<link linkend="view-properties">view display style</link> is shared among all folders
1022
or folders remember their own individual view display styles.
Nate Graham's avatar
Nate Graham committed
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
</para></listitem>

<listitem><para>
<guilabel>Sorting Mode</guilabel> controls how items are sorted in
the view. If <guilabel>Natural sorting</guilabel> is enabled, the sort order of three example files
will be
<orderedlist>
<listitem><para>File1,</para></listitem>
<listitem><para>File2,</para></listitem>
<listitem><para>File10.</para></listitem>
</orderedlist>
If this option is disabled, the normal alphabetical sorting case sensitive or case insensitive
will be used, which leads to the sort order
<orderedlist>
<listitem><para>File1,</para></listitem>
<listitem><para>File10,</para></listitem>
<listitem><para>File2.</para></listitem>
</orderedlist>
</para></listitem>

<listitem><para>
When hovering over a file or folder with the mouse, a small window with relevant
information is shown if <guilabel>Show tooltips</guilabel> is enabled.
</para></listitem>

<listitem><para>
<guilabel>Show selection marker</guilabel> shows a small <guibutton>+</guibutton>
or <guibutton>-</guibutton> button above an item's icon if the item is hovered over
with the mouse. These can be used to select or deselect the item.
</para></listitem>

<listitem><para>
Enable <guilabel>Rename inline</guilabel> to use this mode if only one item is currently selected.
If this option is disabled or several items are selected, a dialog will be displayed for renaming.
</para></listitem>

1059
<listitem><para>Enabling <guilabel>Switch between split panes with tab key</guilabel>
1060
1061
1062
1063
1064
allows to switch split views with the &Tab; key.
</para></listitem>

<listitem><para>Disable <guilabel>Turning off split view closes active pane</guilabel>
to close the inactive pane when you are turning off the split view mode, &eg; pressing <keycap>F3</keycap>.
Nate Graham's avatar
Nate Graham committed
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
</para></listitem>

</itemizedlist>

</para>

</sect3>

<sect3 id="preferences-dialog-general-previews">
<title>Previews Tab</title>

<para>
In this tab, you can configure for which file types previews are shown.
1078
Moreover, the maximum size of local and remote files for which previews are generated can be chosen.
Nate Graham's avatar
Nate Graham committed
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
</para>
<para>
If previews are enabled for folders, previews of some files in the folder will
be shown inside a folder's icon.
</para>
</sect3>

<sect3 id="preferences-dialog-general-confirmations">
<title>Confirmations Tab</title>
<para>
In the ask for confirmation section, you can enable warning dialogs that
1090
1091
1092
1093
are shown before potentially harmful actions.
</para>
<para>
It is also possible to choose the default action <guilabel>When opening an executable file</guilabel>. There are three options, namely <guimenuitem>Always ask</guimenuitem>, <guimenuitem>Open in application</guimenuitem>, and <guimenuitem>Run script</guimenuitem>.
Nate Graham's avatar
Nate Graham committed
1094
1095
1096
</para>
<warning><para>The confirmation settings for <guilabel>Moving files or folders to trash</guilabel> and
<guilabel>Deleting files or folders</guilabel> affect file operations in &dolphin;, &konqueror;, 
Carl Schwan's avatar
Carl Schwan committed
1097
&gwenview; and all &kde; applications using the default &kde; file dialog, 
Nate Graham's avatar
Nate Graham committed
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
whereas <guilabel>Closing Dolphin windows
with multiple tabs</guilabel> is a &dolphin; specific setting.</para></warning>
</sect3>

<sect3 id="preferences-dialog-general-statusbar">
<title>Status Bar Tab</title>

<para>
In this tab, some additional items can be enabled for the status bar, provided
the status bar is wide enough:

<itemizedlist>

<listitem><para>
1112
The <guilabel>Show status bar</guilabel> item can be used for toggling status bar visibility.
Nate Graham's avatar
Nate Graham committed
1113
1114
1115
</para></listitem>

<listitem><para>
1116
1117
1118
1119
1120
The <guilabel>Show zoom slider</guilabel> item allows switching visibility of the icon size widget.
</para></listitem>

<listitem><para>
The <guilabel>Show space information</guilabel> item can be used to switch on and off a bar that shows how much space is free on the current drive.
Nate Graham's avatar
Nate Graham committed
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
</para></listitem>

</itemizedlist>

</para>

</sect3>

</sect2>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
<sect2 id="preferences-dialog-startup">
<title>Startup</title>

<para>
This group contains settings which control the appearance of &dolphin; on startup.

<screenshot>
<screeninfo>Screenshot of the Startup settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-startup.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Startup Settings.</phrase>
</textobject>
<caption><para>Startup Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

<itemizedlist>

<listitem><para>
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
The <guilabel>Show on startup</guilabel> option allows choosing the folder which is opened on startup.
</para>
<para>
    If the <guimenuitem>Folders, tabs, and window state from last time</guimenuitem> item is selected then
</para>
<itemizedlist>
    <listitem>
        <para>When launched from the &GUI; or CLI without any &URL;s, &dolphin; restores session</para>
    </listitem>
    <listitem>
        <para>When rebooting with &dolphin; open, it restores session normally after the system comes back</para>
    </listitem>
    <listitem>
        <para>When launched with &URL;s, &dolphin; window is opened showing those &URL;s instead of restoring session</para>
    </listitem>
    <listitem>
        <para>When &dolphin; is already running and a new window is opened, that new window shows a single tab with the same &URL; as was visible in the previously-open &dolphin; instance</para>
    </listitem>
</itemizedlist>
<para>
The location of the folder can also be entered directly or chosen in a dialog which can
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1174
1175
be opened by clicking the button showing a <quote>folder</quote> icon. Moreover,
the current location or the default location (which is the user's home folder)
1176
can be used as the startup folder by clicking the corresponding button.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1177
1178
1179
</para></listitem>

<listitem><para>
1180
<guilabel>Begin in split view mode</guilabel> controls if the
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1181
<link linkend="dolphin-view">&dolphin; view</link> is split on startup
1182
or not for new windows.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1183
1184
1185
</para></listitem>

<listitem><para>
1186
1187
1188
1189
1190
1191
1192
<guilabel>Show filter bar</guilabel> controls if the filter bar is shown on
startup or not. See the <link linkend="filter-files">section on the filter bar</link>
for details.
</para></listitem>

<listitem><para>
<guilabel>Make location bar editable</guilabel> controls if the location bar is in
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1193
1194
1195
1196
1197
editable mode on startup. The bread crumb mode of the location bar is used
otherwise. See the <link linkend="location-bar">section about the location bar</link>
for details about the two modes.
</para></listitem>

1198
1199
1200
1201
<listitem><para>
<guilabel>Open new folders in tabs</guilabel> controls whether &dolphin; should open a new folder in a new tab of the current instance when called externally. If not enabled, the new folders will be opened in new instances of &dolphin;. By default this option is enabled.
</para></listitem>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1202
1203
1204
1205
1206
1207
1208
<listitem><para>
If <guilabel>Show full path inside location bar</guilabel> is enabled, the full
path of the current location is shown in the bread crumb mode of the location bar.
Otherwise, a shortened version of the path is shown if it begins with the path of
one of the places in the <guilabel>Places</guilabel> panel.
</para></listitem>

1209
<listitem><para>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1210
<guilabel>Show full path in title bar</guilabel> makes it easy to distinguish
1211
1212
between files or folders with the same name in different folders.
</para></listitem>
1213

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
</itemizedlist>

</para>

</sect2>

<sect2 id="preferences-dialog-viewmodes">
<title>View Modes</title>

<para>
This group contains settings which control the behavior of &dolphin;'s view
modes. The three view modes (Icons, Compact, and Details) are accessible via the
tab bar at the top.

<screenshot>
<screeninfo>Screenshot of the Icons View settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-viewmodes-icons.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>View Modes Settings.</phrase>
</textobject>
<caption><para>View Modes Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

</para>

<sect3 id="preferences-dialog-viewmodes-common">
<title>Common settings for all view modes</title>

<para>
All three view modes have some common settings:
</para>
<itemizedlist>

<listitem><para>
Sliders which control the size of the icons. The <guilabel>Default</guilabel> or
<guilabel>Preview</guilabel> sizes are used if previews are disabled or enabled,
respectively. Note that the icon size can be changed easily with the zoom slider
in the status bar if the corresponding option is enabled in the
<link linkend="preferences-dialog-general-statusbar"><quote>General</quote>
section of the settings</link>.
</para></listitem>

<listitem><para>
A setting for the font used in the view mode: either the system font or a
custom font can be chosen.
</para></listitem>

</itemizedlist>
<para>
The other settings in the <guilabel>Text</guilabel> section which apply to only 
one of the view modes are discussed below.
</para>

</sect3>

<sect3 id="preferences-dialog-viewmodes-icons">
<title>Icons</title>
<para>
<itemizedlist>
<listitem><para>
<guilabel>Width</guilabel> controls the minimum width that is reserved for
the text of a file item.
</para></listitem>
<listitem><para>
  <guilabel>Maximum lines</guilabel> means maximum number of text lines below the icon.
</para></listitem>
</itemizedlist>
</para>
</sect3>

<sect3 id="preferences-dialog-viewmodes-compact">
<title>Compact</title>
<para>
<itemizedlist>
<listitem><para>
<guilabel>Maximum width</guilabel> controls the maximum width that is reserved for
the text of a file item.
</para></listitem>
</itemizedlist>
</para>
</sect3>

<sect3 id="preferences-dialog-viewmodes-details">
<title>Details</title>
<para>
<itemizedlist>
<listitem><para>
<guilabel>Expandable folders</guilabel> determines whether any folders that have subfolders
are displayed in a tree view, where the sub items can be expanded by &LMB; clicking the
<guiicon>&gt;</guiicon> icon and collapsed by clicking the <guiicon>v</guiicon> icon.
1308
1309
1310
1311
</para>
<para>
<guilabel>Folder size displays</guilabel> allows defining the property to use then sorting folders by their size. It is possible to sort folders by <guilabel>Number of items</guilabel> or <guilabel>Size of contents</guilabel> and choose a limit to the recursive level (can be useful to constrain unneeded iterations in the deep folder structures or on the slow file systems).
</para>
1312
1313
1314
<para>
The <guilabel>Date style</guilabel> option can be used to configure the mode to display dates in &dolphin;. It is possible to choose between <guilabel>Relative</guilabel> (&eg;, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (&eg;, <quote>2020-12-23 15:00</quote>).
</para>
1315
</listitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
</itemizedlist>
</para>
</sect3>

</sect2>

<sect2 id="preferences-dialog-navigation">
<title>Navigation</title>

<para>
This group contains settings which control how navigation in the folder
structure and in archives works.

<screenshot>
<screeninfo>Screenshot of the Navigation settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-navigation.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Navigation Settings.</phrase>
</textobject>
<caption><para>Navigation Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

<itemizedlist>

<listitem><para>
1345
The option to open items with a single or double mouse click is a system wide setting and can be
1346
1347
changed in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
<guimenuitem>General Behavior</guimenuitem></menuchoice> module.</para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
</listitem>

<listitem><para>
Archives will be opened inside &dolphin;, and not in an external application, if
<guilabel>Open Archives as folder</guilabel> is enabled.
</para></listitem>

<listitem><para>
If <guilabel>Open folders during drag operations</guilabel> is enabled, dragging
an item with the mouse and hovering over a folder with it for a short time will open
that folder. This allows you to move or copy items quickly to folders which are
several levels deeper in the folder hierarchy.
</para></listitem>

</itemizedlist>

</para>

</sect2>

1368
<sect2 id="preferences-dialog-context-menu">
1369
<title>Services</title>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1370
1371
1372
1373
1374
1375
1376
1377

<para>
This group offers a selection of services that can be shown in the
<guisubmenu>Actions</guisubmenu> submenu of &dolphin;'s context menu which
appears when clicking a file or folder with the &RMB;.
</para>

<screenshot>
1378
<screeninfo>Screenshot of the Services Menu settings in &dolphin;'s preferences dialog</screeninfo>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1379
1380
<mediaobject>
<imageobject>
1381
<imagedata fileref="preferences-context-menu.png" format="PNG"/>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1382
1383
</imageobject>
<textobject>
1384
<phrase>Services Settings.</phrase>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1385
</textobject>
1386
<caption><para>Services Settings in &dolphin;'s Preferences Dialog.</para></caption>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
</mediaobject>
</screenshot>

<para>
Using the <guibutton>Download New Services</guibutton> you can fetch additional 
services for the context menu.
</para>
<para>
If you have installed &dolphin;'s plugins for <guilabel>Bazaar</guilabel>, 
<guilabel>Mercurial</guilabel>, <guilabel>Git</guilabel> or 
<guilabel>Subversion</guilabel> from the kdesdk module these services are shown in the list.
If these plugins are enabled and you enter a folder which is under version control, 
the version state (locally changed, up to date &etc;) is indicated by icons 
and you have additional entries in the 
context menu like commit, update, add, remove &etc;
</para>
<para>
1404
1405
1406
1407
1408
In the service list you can also choose if the <guimenuitem>Copy To</guimenuitem>,
<guimenuitem>Move To</guimenuitem>, <guimenuitem>Add to Places</guimenuitem>,
<guimenuitem>Sort By</guimenuitem>, <guimenuitem>View Mode</guimenuitem>,
<guimenuitem>Open in New Tab</guimenuitem>, <guimenuitem>Open in New Window</guimenuitem>,
<guimenuitem>Copy Location</guimenuitem>, and <guimenuitem>Duplicate Here</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
commands are shown in the context menu.
</para>
<para>
&dolphin; has to be restarted to activate the changes for some of these settings.
</para>

</sect2>

<sect2 id="preferences-dialog-trash">
<title>Trash</title>

<para>
This group contains settings which control the behavior of the trash.

<screenshot>
<screeninfo>Screenshot of the Trash settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-trash.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Trash Settings.</phrase>
</textobject>
<caption><para>Trash Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

<itemizedlist>

<listitem><para>
Files which are older than a configurable number of days can be deleted automatically.
</para></listitem>

<listitem><para>
The size of the trash can be limited to a configurable percentage of the disk
size. If this limit is reached, a warning can be issued, or the oldest or
largest files can be deleted automatically.
</para></listitem>

</itemizedlist>

</para>

</sect2>

1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
<sect2 id="preferences-user-feedback">
<title>Trash</title>

<para>
This group contains settings which control your contributing information on the &dolphin; usage to its developers.

<screenshot>
<screeninfo>Screenshot of the User Feedback settings in &dolphin;'s preferences dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="preferences-user-feedback.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>User Feedback Settings.</phrase>
</textobject>
<caption><para>User Feedback Settings in &dolphin;'s Preferences Dialog.</para></caption>
</mediaobject>
</screenshot>

<itemizedlist>

<listitem><para>
You can contribute some feedback on &dolphin; if you wish. Use sliders to configure your level of participation.
</para></listitem>

</itemizedlist>

</para>

</sect2>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1485
1486
1487
</sect1>
<!-- begin copy to konqueror filemanager.docbook -->
<sect1 id="view-properties">
1488
<title>Folder View Display Style</title>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1489
1490
1491

<para>
The following settings control how the contents of a folder are displayed in the
1492
&dolphin; view, and are stored on a per-folder basis by default:
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
</para>
<itemizedlist>

<listitem><para>
The view mode (Icons, Compact, Details)
</para></listitem>

<listitem><para>
The sorting of items, which is determined by the sort order (ascending,
descending) and the attribute (such as name, size,...) that the items are
sorted by
</para></listitem>

<listitem><para>
Sorting of folders and files &ndash; are folders shown first or not?
</para></listitem>

<listitem><para>
Previews &ndash; are they shown instead of icons (based on the settings made in
<link linkend="preferences-dialog-general-previews"><guilabel>Previews</guilabel>
1513
tab of &dolphin;'s General settings</link>) or not?
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
</para></listitem>

<listitem><para>
Are items shown in groups in the views?
</para></listitem>

<listitem><para>
Are hidden files shown?
</para></listitem>

<listitem><para>
What additional information (besides the name) is shown in the Icons or Details view?
</para></listitem>

</itemizedlist>
<para>
1530
The view display style can be configured in the
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1531
1532
1533
1534
1535
<menuchoice><guimenu>View</guimenu></menuchoice> menu, some (such as the view
mode) can also be changed using toolbar buttons.
</para>

<sect2 id="view-properties-dialog">
1536
<title>The View Display Style dialog</title>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1537
1538
1539
1540

<para>

<screenshot>
1541
<screeninfo>Screenshot of the View Display Style dialog</screeninfo>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1542
1543
1544
1545
1546
<mediaobject>
<imageobject>
<imagedata fileref="viewproperties-dialog.png" format="PNG"/>
</imageobject>
<textobject>
1547
<phrase>The View Display Style dialog.</phrase>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1548
</textobject>
1549
<caption><para>The View Display Style Dialog.</para></caption>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1550
1551
1552
</mediaobject>
</screenshot>

1553
1554
The <guilabel>View Display Style</guilabel> dialog can be used to quickly modify
the view display styles for many folders at once. This is done for the current folder, for the
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1555
current folder including all subfolders, or even for all folders, depending on
1556
the choice made in the <guilabel>Apply to</guilabel> section.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1557
1558
1559
</para>

<para>
1560
If <guilabel>Use as default view settings</guilabel> is enabled, the chosen view
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
properties will also be used for all folders which do not have customized view
properties yet.
</para>

</sect2>

</sect1>
<!-- end copy to konqueror filemanager.docbook -->
</chapter>

<chapter id="command-reference">
<title>Command Reference</title>
<para>By default the menubar is not shown. All actions described here either can 
be accessed with toolbar buttons or with items in the menu of the 
<guibutton>Control</guibutton> toolbar button.</para>

<sect1 id="commands-menubar">
<title>The Menubar in &dolphin;'s Main Window</title>

<sect2>
<title>The File Menu</title>
<para>
<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guisubmenu>Create New</guisubmenu>
</menuchoice></term>
<listitem><para><action>Creates a new object (such as a folder or a text file) in the current
folder.</action></para>
<para>You will find an explanation of all available objects in &konqueror;'s handbook in the chapter
<ulink url="help:/konqueror/making.html">Create New</ulink>.</para>
1594
1595
1596
1597
1598
<note>
    <para>
        It is possible to create your own <guisubmenu>Create New...</guisubmenu> submenu items. Use files from <ulink url="https://invent.kde.org/frameworks/kio/-/tree/master/src/new_file_templates">KIO source repository</ulink> as a reference and put the resulting <filename role="extension">.desktop</filename> file into the <filename role="directory">.local/share/templates</filename> in your home directory (the address can be determined using the <userinput>kf5-config --path templates</userinput> command in &konsole;), then restart &dolphin;.
    </para>
</note>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New Window</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a new &dolphin; window.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New Tab</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a new tab.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close Tab</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes the current tab.</action></para></listitem>
</varlistentry>

1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Undo close tab</guimenuitem>
</menuchoice></term>
<listitem><para><action>Reopens the last closed tab.</action></para></listitem>
</varlistentry>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F2</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Rename</guimenuitem>
</menuchoice></term>
<listitem><para><action>Renames one currently selected item inline.
Opens the <link linkend="batch-rename">batch rename dialog</link> if several 
items are selected.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Del</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Move to Trash</guimenuitem>
</menuchoice></term>
<listitem><para><action>Moves the currently selected item(s) to the
trash.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem><para><action>Permanently deletes the currently selected item(s). The items are not moved
to the trash and cannot be restored.</action></para></listitem>
</varlistentry>

1683
1684
1685
1686
1687
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Show Target</guimenuitem>
</menuchoice></term>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1688
<listitem><para>This action highlights a link target in a new &dolphin; window.
1689
1690
1691
</para></listitem>
</varlistentry>

1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Duplicate Here</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates duplicates of selected items appending <replaceable> copy</replaceable> to the end of their names.</action></para></listitem>
</varlistentry>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Return</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Properties</guimenuitem>
</menuchoice></term>
<listitem><para><action>Shows the properties dialog for the currently selected
item(s).</action></para></listitem>
</varlistentry>
1714
<!--FIXME http://www.aelog.org/checksums-made-easy in fundamentals? -->
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Exits &dolphin;.</action></para></listitem>
</varlistentry>
</variablelist>

</para>
</sect2>

<sect2>
<title>The Edit Menu</title>
<para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem><para><action>Undoes the last action performed by &dolphin;.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice></term>
<listitem><para><action>Cuts the currently selected item(s).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copies the currently selected item(s).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
1774
1775
1776
1777
<guimenuitem>Paste Clipboard Contents...</guimenuitem></menuchoice> or
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one File</guimenuitem></menuchoice> or
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one Folder</guimenuitem></menuchoice> or
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste x Items</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1778
1779
1780
1781
1782
1783
1784
1785
</menuchoice></term>
<listitem><para><action>Pastes the currently copied/cut items to the current
folder. If the clipboard does not contain files or folders, the clipboard
contents (such as text or image data) will be pasted into a new file.
The name of this file has to be entered in a dialog.
</action></para></listitem>
</varlistentry>

1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy to inactive split view</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copies the currently selected item(s) from the active split view to the inactive split view.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F6</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Move to inactive split view</guimenuitem>
</menuchoice></term>
<listitem><para><action>Moves the currently selected item(s) from the active split view to the inactive split view.
Is disabled if the current user does not have write permission on the selected item(s).</action></para></listitem>
</varlistentry>

1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Filter...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action>
You can also use the alternate shortcut <keycombo action="simul">&Shift;<keycap>/</keycap></keycombo>
for this action.</para></listitem>
</varlistentry>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1822
1823
1824
1825
1826
1827
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
1828
<guimenuitem>Search...</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
</menuchoice></term>
<listitem><para><action>Opens the find bar. Enter a search term into the edit box and select to search for filename
or in contents of files starting from the current folder or everywhere.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Select All</guimenuitem>
</menuchoice></term>
<listitem><para><action>Selects all files and folders in the current
folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Invert Selection</guimenuitem>
</menuchoice></term>
<listitem><para><action>
Selects all unselected items and deselects all selected items in the current folder.
</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title>The View Menu</title>
<para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom In</guimenuitem>
</menuchoice></term>
<listitem><para><action>Increases the size of icons in the view.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom Out</guimenuitem>
</menuchoice></term>
<listitem><para><action>Decreases the size of icons in the view.</action></para></listitem>
</varlistentry>

1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Zoom Reset</guimenuitem>
</menuchoice></term>
<listitem><para><action>Resets the size of icons in the view to default.</action></para></listitem>
</varlistentry>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>View Mode</guisubmenu>
</menuchoice></term>
<listitem><para><action>Changes the view mode to <guimenuitem>Icons</guimenuitem>
(<keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo>), <guimenuitem>Compact</guimenuitem>
(<keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo>) or <guimenuitem>Details</guimenuitem>
(<keycombo action="simul">&Ctrl;<keycap>3</keycap></keycombo>).</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guisubmenu>Sort By</guisubmenu>
</menuchoice></term>
<listitem><para><action>Changes whether items are sorted</action> by <guimenuitem>Name</guimenuitem>
or other criteria described in <link linkend="dolphin-view-information">Information in the View</link>.</para>
<para><guimenuitem>Descending</guimenuitem> reverses the sort order.
<guimenuitem>Folders First</guimenuitem> sorts folders before files.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1926
<guisubmenu>Show Additional Information</guisubmenu>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1927
1928
1929
1930
1931
1932
1933
1934
1935
</menuchoice></term>
<listitem><para><action>Displays additional information</action> 
described in <link linkend="dolphin-view-information">Information in the View</link>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1936
<guimenuitem>Show Previews</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
</menuchoice></term>
<listitem><para><action>Displays a symbolic preview of the file contents </action> in the different
view modes.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Show in Groups</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays</action> the content of the
current folder grouped by the option selected in <guimenuitem>Sort By</guimenuitem>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1958
<guimenuitem>Show Hidden Files</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1959
1960
</menuchoice></term>
<listitem><para><action>Shows all the hidden files and sub-folders within the current
1961
1962
folder.</action>There is an alternate shortcut <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
for this action.</para></listitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F3</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Split</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enables and disables the split view mode.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F5</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice></term>
<listitem><para><action>Reloads the current folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<guimenuitem>Stop</guimenuitem>
</menuchoice></term>
<listitem><para><action>Stops loading/reading the contents of the current
folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
Yuri Chornoivan's avatar
Yuri Chornoivan committed
1999
<guisubmenu>Show Panels</guisubmenu>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
</menuchoice></term>
<listitem><para><action>Enables and disables</action> the different <link linkend="panels">panels</link>:
<guimenuitem>Places</guimenuitem> (<keycap>F9</keycap>), <guimenuitem>Information</guimenuitem>
(<keycap>F11</keycap>), <guimenuitem>Folders</guimenuitem> (<keycap>F7</keycap>), 
<guimenuitem>Terminal</guimenuitem> (<keycap>F4</keycap>).
With <guimenuitem>Lock Panels</guimenuitem> the panel header with caption and two buttons is  
hidden to save space and the panels are immutable, with <guimenuitem>Unlock Panels</guimenuitem>
the header is visible and the panel can be moved to the right or left  or even
outside the main window.
<!-- FIXME Places header always visible ?-->
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F6</keycap>
</shortcut>
<guimenu>View</guimenu>
<guisubmenu>Location Bar</guisubmenu>
<guimenuitem>Editable Location</guimenuitem>
</menuchoice></term>
<listitem><para><action>Changes the location bar between the two modes; the
<link linkend="location-bar-bread-crumb">bread crumb mode</link> and the
<link linkend="location-bar-editable">editable mode</link>.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
<guisubmenu>Location Bar</guisubmenu>
<guimenuitem>Replace Location</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switches the location bar to <link linkend="location-bar-editable">editable mode</link>,
if necessary, and selects the location such that it can be replaced quickly.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
2045
<guimenuitem>Adjust View Display Style...</guimenuitem>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2046
</menuchoice></term>
2047
<listitem><para><action>Opens the <link linkend="view-properties-dialog">View Display Style
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
Dialog</link>.</action></para></listitem>
</varlistentry>
</variablelist>

</para>
</sect2>

<sect2>
<title>The Go Menu</title>
<para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Up</keycap></keycombo>
</shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Up</guimenuitem>
</menuchoice></term>
<listitem><para><action>Changes to the folder above the current folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo>
</shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Back</guimenuitem>
</menuchoice></term>
<listitem><para><action>Changes to the previously viewed folder.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo>
</shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para><action>Undoes</action> a <quote>Go Back</quote> action.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo>
</shortcut>
<guimenu>Go</guimenu>
<guimenuitem>Home</guimenuitem>
</menuchoice></term>
<listitem><para><action>Changes to the users home folder, &eg;
/home/Peter/.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Go</guimenu>
<guisubmenu>Recently Closed Tabs</guisubmenu>
</menuchoice></term>
<listitem><para><action>Shows a list of recently closed tabs which can
be reopened.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title>The Tools Menu</title>
<para>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Shift;<keycap>F4</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Open Terminal</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens &konsole; within the current folder.</action></para></listitem>
</varlistentry>

2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Tools</guimenu>
<guimenuitem>Open Preferred Search Tool</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens preferred search tool in the current folder.</action></para></listitem>
</varlistentry>

Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guimenuitem>Compare Files</guimenuitem>
</menuchoice></term>
<listitem><para><action>Compare the currently selected files or folders with
&kompare;. This action is only enabled if two files or folders are selected.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<guisubmenu>Select Remote Charset</guisubmenu>
</menuchoice></term>
<listitem><para><action>Allows you to choose the charset used by a remote
connection manually.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title>The Settings and Help Menu</title> 
<para>
&dolphin; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
2169
2170
menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
>Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
of the &kde; Fundamentals.
</para>
</sect2>

</sect1>
</chapter>

<chapter id="misc-questions">
<title>Miscellaneous Questions</title>

<qandaset id="misclist">
<qandaentry>
<question>
<para>Has &dolphin; replaced &konqueror;?</para>
</question>
<answer>
<para>
&dolphin; is not intended to be a competitor to &konqueror;: &konqueror; acts as
a universal viewer being able to show &HTML; pages, text documents, folders and a
lot more, whereas &dolphin; focuses on being only a file manager. This approach
allows the optimization of the user interface for the task of file management.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How can I get involved with the development of &dolphin;?</para>
</question>
<answer>
<para>
The easiest way to get involved with &dolphin; is to subscribe to the developer 
mailing list <ulink url="https://mail.kde.org/mailman/listinfo/kfm-devel">kfm-devel</ulink>
and drop an email to the developer mailing list. Email what you can do, how much time
you can devote &etc;, the developers will let you know what you can do in the
project. If you wish to contribute to the documentation please email the
<ulink url="mailto:kde-doc-english@kde.org">&kde; Documentation Team</ulink> list.
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How can I submit bug reports?</para>
</question>
<answer>
<para>
The official channel for submitting bug reports is via the &kde; bug tracking
system. The &kde; bug tracker can be found at
2220
<ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para>How can I submit feature requests?</para>
</question>
<answer>
<para>
The official channel for submitting feature requests is via the &kde; bug
tracking system. The &kde; bug tracker can be found at
2233
<ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
</para>

</answer>

</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>
&dolphin;
</para>
<para>
Burkhard Lück's avatar
Burkhard Lück committed
2250
2251
2252
Program copyright 2006&ndash;2014 Peter Penz <email>peter.penz@gmx.at</email>, 
Frank Reininghaus <email>frank78ac@googlemail.com</email> and Emmanuel Pescosta 
<email>emmanuelpescosta099@gmail.com</email> </para>
Christophe Giboudeaux's avatar
Christophe Giboudeaux committed
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
<para>
Contributors:
<itemizedlist>
<listitem><para>Cvetoslav Ludmiloff <email>ludmiloff@gmail.com</email></para></listitem>
<listitem><para>Stefan Monov <email>logixoul@gmail.com</email></para></listitem>
<listitem><para>Michael Austin <email>tuxedup@users.sourceforge.net</email></para></listitem>
<listitem><para>&Orville.Bennett; &Orville.Bennett.mail;</para></listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2005 Peter Penz <email>peter.penz@gmx.at</email>
</para>
<para>
Documentation copyright 2006 &Orville.Bennett; &Orville.Bennett.mail;
</para>
<para>
Documentation copyright 2006 Michael Austin <email>tuxedup@users.sourceforge.net</email>
</para>
<para>
Documentation copyright 2009 Frank Reininghaus <email>frank78ac@googlemail.com</email>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->

</chapter>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab 
-->