add more spacing
[personal-kdebase.git] / apps / doc / konqueror / filemanager.docbook
blob51277747eb8e1d3f87f4258c21772544590c5eb9
1 <chapter id="filemanager">
2 <chapterinfo>
3 <authorgroup>
4 <author>&Pamela.Roberts;</author>
5 <!-- TRANS:ROLES_OF_TRANSLATORS -->
6 </authorgroup> 
8 <date>2006-03-08</date>
9 <releaseinfo>3.5</releaseinfo>
10 </chapterinfo>
12 <title>&konqueror; the File Manager</title>
14 <sect1 id="dirfolders">
15 <title>Folders and Paths</title>
16 <para>In &UNIX; and &Linux; all folders are arranged in a simple 
17 hierarchy. Starting from a top level folder (also called the root directory), 
18 the structure descends and branches containing various files and subfolders. 
19 This means that you can get from any folder to any other by going <quote>up
20 </quote> until you reach a common point then <quote>down</quote> through 
21 the appropriate subfolders until you reach your target.</para>
23 <para>The position of any file or folder in the structure (also called a 
24 directory tree) can be described by its <quote>path</quote>, which is a simple 
25 list of the folders you would have to descend through to get to the target 
26 folder or file. For example <filename class="directory">/home/pam</filename> 
27 is the subfolder <filename class="directory">pam</filename> of the subfolder 
28 <filename class="directory">home</filename> of the top level folder, and 
29 <filename>/home/pam/words.txt</filename> is the file <filename>words.txt
30 </filename> in that subfolder. The leading <quote>/</quote> in these paths 
31 represents the top level folder.</para>
33 <para>Every folder accessible by your system &mdash; including those on
34 other hard disk partitions, your floppy and &CD-ROM; &mdash; will appear
35 in the tree descending from /, their exact paths will depend on how your system
36 was set up (see also the section on <link linkend="floppy-cd">Floppy and
37 &CD-ROM; Drives</link>).
38 </para>
39 <para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote> 
40 folder to hold their personal files and settings; for example
41 <filename class="directory">/home/john</filename> and  
42 <filename class="directory">/home/mary</filename>. The 
43 symbol <keycap>~</keycap> is often used to represent the user's home 
44 folder, so that <filename>~/letter.txt</filename> refers to the file 
45 <filename>letter.txt</filename> in my home folder.</para>
46 <para>Note that the term <quote>directory</quote> is often used instead of 
47 <quote>folder</quote>.</para>
48 </sect1>
50 <sect1 id="viewmode">
51 <title>View Modes</title>
52 <para>In File Manager mode, &konqueror; lists which files and subfolders are
53 contained within a given folder and can provide you with some information about
54 them. The <quote>path</quote> of the current folder is shown in the Location
55 Toolbar. The way that &konqueror; displays the files and folders depends mainly
56 on your choice of view mode which can be selected from the
57 <menuchoice><guimenu>View</guimenu><guisubmenu>View
58 Mode</guisubmenu></menuchoice > sub menu. The view modes &konqueror; provides
59 are outlined below.
60 </para>
62 <variablelist>
64 <varlistentry>
65 <term><guimenuitem>Icon View</guimenuitem></term>
66 <listitem><para>Displays an icon and a name for each file or subfolder in
67 the current folder.</para>
68 <para>Files of certain types may display a preview of their contents instead of
69 the default icon. The file types selected for preview are controlled by the
70 <menuchoice><guimenu>View</guimenu><guisubmenu>Preview</guisubmenu></menuchoice>
71 sub menu settings. See the section <link linkend="previews">
72 File Previews</link> of this handbook for more details.</para>
73 </listitem>
74 </varlistentry>
76 <varlistentry>
77 <term><guimenuitem>MultiColumn View</guimenuitem></term>
78 <listitem><para>Is similar to <guimenuitem>Icon View</guimenuitem> except that
79 the current folder contents are organized into columns instead of rows.
80 Files may be previewed in <guimenuitem>MultiColumn View</guimenuitem> as
81 they are in <guimenuitem>Icon View</guimenuitem>.</para>
82 </listitem>
83 </varlistentry>
85 <varlistentry>
86 <term><guimenuitem>Tree View</guimenuitem></term>
87 <listitem><para>Can be used to <link linkend="navigation">navigate</link> the
88 folder tree starting at the current folder. Each file and subfolder is
89 shown on its own line. Folders can be expanded to reveal their contents by
90 <mousebutton>left</mousebutton> clicking on the preceding <keycap>+</keycap>
91 sign. Similarly, an expanded folder's contents can be hidden by
92 <mousebutton>left</mousebutton> clicking on the <keycap>-</keycap> sign.</para>
93 <para>In addition to the file name, some file detail information is shown on
94 each line. The details are controlled by the <menuchoice>
95 <guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice>
96 sub menu settings.</para>
97 </listitem>
98 </varlistentry>
100 <varlistentry>
101 <term><guimenuitem>Info List View</guimenuitem></term>
102 <listitem><para>Displays each file on a separate line similar to the
103 <guimenuitem>
104 Detailed List View</guimenuitem> except that the detail information is 
105 specific to the file type. This feature is controlled by the
106 <menuchoice><guimenu>View</guimenu><guisubmenu>View As</guisubmenu></menuchoice>
107 sub menu.</para>
108 <para>For example: If the file type is <quote>Folder,</quote> then the contents
109 information is shown. Viewing as <quote>JPEG Images</quote> shows the pixel
110 dimensions and EXIF data if available, and viewing as <quote>Plain Text</quote>
111 shows the lines, words, characters, and format.
112 </para></listitem>
113 </varlistentry>
115 <varlistentry>
116 <term><guimenuitem>Detailed List View</guimenuitem></term>
117 <listitem><para>Displays each file or folder on a separate line, as an icon
118 followed by the file or folder name followed by information about the 
119 item. The amount of information shown is controlled by the <menuchoice>
120 <guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice> 
121 sub menu settings.
122 </para></listitem>
123 </varlistentry>
125 <varlistentry>
126 <term><guimenuitem>Text View</guimenuitem></term>
127 <listitem><para>Is similar to the <guimenuitem>Detailed List View</guimenuitem> 
128 except that icons are not shown and the first character in each line will be 
129 <quote>/</quote> if the item is a folder.
130 </para></listitem>
131 </varlistentry>
133 <varlistentry>
134 <term><guimenuitem>Photobook</guimenuitem></term>
135 <listitem><para>Transforms &konqueror; into a simple viewing
136 application for the current folder. Most of the main window renders a selected
137 image, and thumbnails of the image files in the current directory are previewed
138 along the side.</para></listitem>
139 </varlistentry>
141 <varlistentry>
142 <term><guimenuitem>File Size View</guimenuitem></term>
143 <listitem><para>Creates a visual representation of the folder tree that reflects
144 the file sizes of the folder contents. The window area represents all of the
145 disk space used by the contents of the current folder. Subfolders and their
146 contents are represented as rectangular blocks. The area of each block is
147 proportional to the size of its contents. Various modifications to this
148 visualization are controlled via the sub menus of the
149 <menuchoice><guimenu>View</guimenu></menuchoice> menu.
150 </para></listitem>
151 </varlistentry>
152 </variablelist>
155 <sect2 id="filetipinfo">
156 <title>File Tip Info</title>
157 <para>Checking the <guilabel>Show file tips</guilabel> box in the <guilabel>
158 Behavior</guilabel> page of the &konqueror; Configuration dialog causes a 
159 small pop up information window to appear when the mouse pointer is hovered over
160 a file or folder name or icon. 
161 </para>
162 <para>If the <guilabel>Show previews in file tips</guilabel> checkbox is 
163 checked the pop up window will also show a small image of the file contents.
164 </para>
165 </sect2>
167 <sect2 id="previews">
168 <title>File Previews</title>
169 <para>Selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Preview
170 </guisubmenu></menuchoice> from the Menubar will bring up a sub menu 
171 that lets you enable file previews for certain types of file.</para>
172 <para>Generally this means that the file's icon will be replaced by a small 
173 image showing the file contents.</para>
174 <para>If file preview is enabled for <guimenuitem>Sound Files</guimenuitem> 
175 the file will be played whenever the mouse cursor is hovering over the file 
176 name or icon.</para>
177 <para>Note that file previews are only available in <guimenuitem>Icon View
178 </guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes.</para>
179 <para>Because &konqueror; has to read much more data than just the file name 
180 details to generate a preview, file previews may not be appropriate 
181 when viewing files on a floppy or from a remote system. The <guilabel>Previews
182 </guilabel> page of the File Manager Configuration 
183 dialog allows you to disable file previews for protocols such as 
184 <link linkend="ftp">ftp</link> where reading the extra data would take too 
185 long.</para>
186 </sect2>
188 </sect1>
190 <sect1 id="navigation">
191 <title>Navigation</title>
192 <para>To get to a file with &konqueror; you first need to navigate 
193 through the folder tree to find the folder containing that 
194 file.</para>
196 <para>To move between folders you can simply step up and down the
197 tree:</para>
199 <itemizedlist>
200 <listitem><para>To descend into a subfolder <mousebutton>left
201 </mousebutton> click on its name or
202 icon -- or if you have already <quote>selected</quote> it (see below) -- then just press
203 <keycap>Enter</keycap>.</para></listitem> 
204 <listitem><para>To go up the folder tree you can click on the <guiicon>Up
205 </guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar
206 <menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice>
207 option.</para></listitem>
208 </itemizedlist>
210 <para>To <quote>select</quote> a file or folder in the displayed folder 
211 without opening it in any way use the <keysym>up</keysym> and <keysym>down
212 </keysym> arrow keys to move through the items. 
213 The selected item will be highlighted and some information about it 
214 will be displayed in the Status Bar.</para>
216 <para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem>
217 Tree View</guimenuitem> can help you locate folders in the tree below the 
218 current folder; in this mode each folder is shown with a small box at 
219 the left. If the box contains a <keycap>+</keycap> sign, <mousebutton>left
220 </mousebutton> clicking on the box (not on the folder name or icon) will 
221 display a sub tree showing files and subfolders contained in that folder. 
222 The small box will then change to show a <keycap>-</keycap> sign. 
223 <mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once 
224 you have found the folder you are looking for, <mousebutton>left
225 </mousebutton> click on the folder name or icon to open it.</para>
227 <para>The <link linkend="sidebar">Navigation Panel</link> can also help you 
228 find your way around the file system.</para>
230 <para>You can go directly to any folder by typing its path into the
231 Location Toolbar window or into the dialog box invoked by the Menubar
232 <menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem>
233 </menuchoice> item or by <keycombo action="simul">&Ctrl;<keycap>
234 O</keycap></keycombo>. &konqueror;'s <link linkend="path-complete">
235 Text Completion</link> feature may be useful when you do this. Don't forget
236 that in &Linux; / &UNIX; file and folder names are case sensitive.</para>
238 <para>When you have moved to a new folder you can go back to your
239 previous choice by using the Toolbar <guiicon>Back</guiicon> button, the
240 Menubar
241 <menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
242 item, or <keycombo action="simul">&Alt;<keysym>Left
243 Arrow</keysym></keycombo>. Once you have gone back you can go forward. Use the Toolbar
244 <guiicon>Forward</guiicon> button, the Menubar
245 <menuchoice><guimenu>Go</guimenu>
246 <guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo
247 action="simul">&Alt;<keysym>Right
248 Arrow</keysym></keycombo>.</para>
250 <para>Alternatively, you can also choose to enter the parent folder by clicking on the Toolbar <guiicon>Up</guiicon>, the <menuchoice><guimenu>Go</guimenu> <guimenuitem>Up</guimenuitem></menuchoice> item, or with <keycombo
251 action="simul">&Alt;<keysym>Up
252 Arrow</keysym></keycombo>.</para>
254 <tip><para>Holding the &LMB; pressed while the mouse pointer is
255 over the Toolbar <guiicon>Up</guiicon>, <guiicon>Back</guiicon> or
256 <guiicon>Forward</guiicon> buttons brings up a menu of recently visited
257 locations.</para></tip>
259 <sect2 id="file-find">
260 <title>Finding Files and Folders</title>
262 <para>If you don't know or can't remember where a file or folder is within
263 your system, then use the Toolbar <guiicon>Find File</guiicon> button or the
264 Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find 
265 File...</guimenuitem></menuchoice> option.  This will embed the file finder 
266 application &kfind; into &konqueror;'s window. See the &kfind; Handbook 
267 for help in using &kfind;.
268 </para>
270 <note><para>If the name of a file or folder begins with a period (dot), then
271 it is a <quote>hidden</quote> file or folder, and will not normally be shown
272 by &konqueror;. To see hidden files or folders use the Menubar <menuchoice>
273 <guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem>
274 </menuchoice> option.</para>
275 <para>Another reason &konqueror; may not show the file or folder you are 
276 looking for is that you may have the <link linkend="konq-plugin"><guisubmenu>
277 View Filter</guisubmenu></link> plugin set to display only certain types of 
278 file.</para></note>
280 </sect2>
282 <sect2 id="floppy-cd">
283 <title>Floppy and &CD-ROM; Drives</title>
285 <para>Any floppy disk, &CD; drive or other hard disk partition that you have 
286 on your system will usually appear in the <filename class="directory">/
287 </filename>,  <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or 
288 <filename class="directory">/auto</filename> folder, having a path something 
289 like <filename class="directory">/mnt/floppy</filename> or
290 <filename class="directory">/cdrom</filename>. The details will depend on
291 how your system was set up.</para>
293 <para>&UNIX; / &Linux; requires that you <command>mount</command> a floppy disk 
294 or &CD-ROM; when you have inserted it into the drive, and <command>mount
295 </command> other hard disk partitions when you want to access them. You also 
296 need to unmount a floppy disk or &CD-ROM; before removing it to register that 
297 it is no longer available. </para>
299 <para>How you do this will depend on how your system:</para>
301 <itemizedlist>
302 <listitem><para>You may have an <application>Automount</application> facility,
303 in which case you don't have to bother about explicitly mounting and
304 unmounting,
305 although you may find that the &CD-ROM; occasionally starts up by itself for no
306 apparent reason.</para></listitem>
308 <listitem><para>You may have <guiicon>Floppy</guiicon>, &CD-ROM; and hard disk 
309 icons on your desktop, in which case &LMB; click on the icon to mount it. 
310 Doing this should also bring up a &konqueror; window showing the contents of 
311 the floppy, &CD-ROM; or partition. To unmount, <mousebutton>right</mousebutton> 
312 click on the icon and choose the <guimenuitem>Unmount</guimenuitem> item.  
313 Visit the section <link linkend="making">Create New...</link> in this Handbook 
314 to see how to create such an icon.</para></listitem>
316 <listitem><para>Or you can do it the traditional way by typing into a text
317 console window:</para>
319 <para><userinput><command>mount /mnt/floppy</command></userinput></para>
321 <!-- This markup doesn't work properly, it puts 'mount' and '/mnt/floppy' 
322 on separate lines
323 <screen>
324 <userinput><command>mount</command>
325  <option><replaceable>/mnt/floppy</replaceable></option></userinput>
326 </screen> -->
328 <para>to mount, for example, the floppy drive, and</para>
330 <!-- Same as above
331 <screen>
332 <userinput><command>umount</command>
333  <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen>
336 <para><userinput><command>umount /mnt/floppy</command></userinput></para>
338 <para>to unmount it (<command>umount</command> not <command>unmount</command>).
339 </para>
341 <note><para>Rather than having to open a text console to type the
342 <command>mount
343 </command> or <command>umount</command> commands, you may prefer to use
344 &konqueror;'s <menuchoice><guimenu> Tools</guimenu><guimenuitem>Execute Shell
345 Command</guimenuitem></menuchoice>
346 (<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>)
347  feature.
348 </para></note>
350 </listitem>
352 </itemizedlist>
353 </sect2>
355 </sect1>
357 <sect1 id="deleting">
358 <title>Deleting Files and Folders</title>
360 <para>&konqueror; gives you two ways to dispose of an unwanted file or
361 folder:</para>
363 <itemizedlist>
364 <listitem><para>You can move it to the <filename>Trash</filename> folder, which
365 is the safest method as you can get it back if you realize that you have made a
366 mistake.</para></listitem> 
368 <listitem><para>You can just plain Delete it, which
369 removes the entry from the folder and adds the disk area occupied by the
370 file(s) to the system's list of free disk areas, in the same way as the
371 <command>rm</command> command.</para></listitem>
372 </itemizedlist>
374 <para>The simplest way to remove a file or folder is to position
375 the mouse pointer over its name or icon and press the &RMB;, which
376 will bring up a menu containing the options <guimenuitem>Move to
377 Trash</guimenuitem> and <guimenuitem>Delete</guimenuitem>.</para>
379 <para>Or, if you have <quote>selected</quote> the item, the Menubar
380 <guimenu>Edit</guimenu> menu will give you the choice of
381 <quote><guimenuitem>Move to Trash</guimenuitem></quote> and
382 <quote><guimenuitem>Delete</guimenuitem></quote> options.</para>
384 <para><keycap>Del</keycap> will move the selected item or items to Trash.</para>
386 <para><keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
387 will really, truly and irrevocably delete the selected item or
388 items.</para>
390 <note><para>You won't be able to remove a file or folder if you don't have
391 the necessary permissions; see the section on <link linkend="super-user">Super
392 User Mode</link> for further details.</para></note>
394 </sect1>
396 <sect1 id="moving">
397 <title>Moving and Copying</title>
399 <para>To copy a file or subfolder between folders you can:</para>
401 <itemizedlist>
402 <listitem><para>Position the mouse pointer over its name or icon and hold down
403 the &RMB;, which will bring up a menu containing the
404 <guimenuitem>Copy</guimenuitem> option. Choose that.</para>
406 <para>Or if the item is <quote>selected</quote> you can use the
407 <guiicon>Copy</guiicon> button on the Toolbar or the Menubar
408 <menuchoice><guimenu>Edit</guimenu>
409 <guimenuitem>Copy</guimenuitem></menuchoice>
410 item, or the <keycombo
411 action="simul">&Ctrl;<keycap>C</keycap></keycombo> 
412 shortcut key combination. You can also select <link linkend="multiple">multiple</link> files or folders to copy/move as well.</para></listitem>
414 <listitem><para>Navigate to the folder you want to copy the item into then
415 Paste the item into the new folder by using the Toolbar
416 <guiicon>Paste</guiicon> button or the Menubar
417 <menuchoice><guimenu>Edit</guimenu>
418 <guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo
419 action="simul">&Ctrl;<keycap>V</keycap></keycombo> shortcut, or by
420 moving the mouse pointer to a clear area of the window and holding the &RMB;
421 down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option.
422 </para></listitem>
423 </itemizedlist>
425 <para>Moving a file or subfolder between folders can be done in the
426 same
427 way as copying, except that you choose the <guimenuitem>Cut</guimenuitem>
428 option
429 or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
430 instead of <guimenuitem>Copy</guimenuitem>. The item that you have
431 <guimenuitem>Cut</guimenuitem> will be removed from the original folder when
432 you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para>
434 <para>You can also copy or move selected item(s) to another folder by using 
435 <menuchoice><guimenu>Edit</guimenu>
436 <guimenuitem>Copy Files</guimenuitem></menuchoice> (<keycap>F7</keycap>) or
437 <menuchoice><guimenu>Edit</guimenu><guimenuitem>Move Files</guimenuitem>
438 </menuchoice> (<keycap>F8</keycap>), or by selecting
439 <guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from
440 the drop down menu you get when you <mousebutton>right</mousebutton> click on
441 an file or folder name in the File Manager window.</para>
443 <note><para>You may not be able to copy or move a file or folder if
444 you don't have the necessary permissions. See the section on <link
445 linkend="super-user">Super User Mode</link> for further
446 details.</para></note>
448 <sect2 id="dnd">
449 <title>Using Drag 'n Drop</title>
451 <para>&konqueror; also supports Drag and Drop copying and moving of files and
452 folders.</para>
454 <para>You can do this by having two instances of &konqueror;, one showing the 
455 folder you want to copy from, the other showing the target folder. 
456 Position the mouse pointer over the item you wish to copy or move, then, 
457 holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the
458 target
460 folder. Release the button and you will be
461 presented with a menu choice of <guimenuitem>Copy</guimenuitem> or
462 <guimenuitem>Move</guimenuitem>. Take care to <quote>drop</quote> the item into
463  an empty area of the target
464 folder view - dropping it on top of another file name or icon can cause
465 problems.</para>
467 <para>You can also set up &konqueror; to show more than one folder within
468 its window and drag &amp; drop between them.</para>
470 <mediaobject>
471 <imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject>
472 <textobject>
473 <phrase>Split Views for Drag &amp; Drop</phrase>
474 </textobject>
475 </mediaobject>
477 <para>This screenshot illustrates the use of the Menubar
478 <menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
479 Left/Right</guimenuitem></menuchoice> option, also available with the shortcut 
480 <keycombo
481 action="simul">&Ctrl;&Shift;<keycap>L</keycap>
482 </keycombo>,
483 to split the main &konqueror; window into two views, each showing the contents
484 of a different folder.</para>
486 <para>To be able to show different folders in each view they should not be 
487 linked; the little boxes at the bottom right of each view should be empty.
488 </para>
490 <para>The <quote>active</quote> view, that is the one whose path is shown in
491 the Location Toolbar and which responds to navigation and Menubar commands, is
492 shown by the little green light in the bottom left corner. To make a view
493 active, <mousebutton>left</mousebutton> click on an empty area of the view or
494 on its Status Bar.</para>
496 <para>To remove an active view from &konqueror;'s window use the <keycombo
497 action="simul">&Ctrl;&Shift;<keycap>R</keycap>
498 </keycombo> shortcut, or the Menubar <menuchoice><guimenu>Window</guimenu>
499 <guimenuitem>Remove
500 Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar
501 and choose the <guimenuitem>Remove Active View</guimenuitem> option from the
502 resulting menu.</para>
504 <para>If you use &konqueror; tabs, you can drag and drop between tabs
505 by dragging the file to the tab label, without letting go yet.  The
506 destination tab will pop to the front, allowing you to continue
507 dragging and then drop the file.</para>
509 </sect2>
511 <sect2 id="dups">
512 <title>Duplicate File Names</title>
513 <para>If you try to paste a file into a folder that already 
514 contains a file with the same name, &konqueror; will pop up a dialog box warning 
515 you that the file already exists. You can then choose to:
516 </para>
517 <itemizedlist>
518 <listitem><para>
519 <guilabel>Overwrite</guilabel> the old file with the newly copied one. 
520 The <guibutton>Overwrite All</guibutton> button can be used if you have copied 
521 multiple items.</para></listitem>
522 <listitem><para>Cancel the paste operation by pressing the <guibutton>Skip
523 </guibutton> or <guibutton>Skip All</guibutton> button.</para></listitem>
524 <listitem><para>Give the file that is being copied a different name. You can 
525 do this by typing a new name into the text entry box or get &konqueror; to 
526 <guibutton>Propose</guibutton> one. When you have done this press the 
527 <guibutton>Rename</guibutton> button.</para></listitem>
528 </itemizedlist>
529 </sect2>
530 </sect1>
532 <sect1 id="multiple">
533 <title>Selecting Multiple Files</title>
535 <para>You sometimes want to delete, copy or move a number of files that are 
536 similar in some way. For example you may wish to move all of the .png graphics 
537 files from one folder to another. &konqueror; makes this easy by letting you 
538 select multiple files based on similarities in their file names.</para>
540 <para>Use the Menubar
541 <menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
542 <guimenuitem>Select...</guimenuitem></menuchoice> item or the shortcut
543 <keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>. This
544 brings up a little dialog box in which you enter a filename containing
545 the wildcard characters <keycap>*</keycap>, which matches any number
546 of characters, and <keycap>?</keycap> which matches a single
547 character. Press <guibutton>OK</guibutton> and &konqueror; will
548 highlight all files with matching names. For example;</para>
549       
550 <itemizedlist>
551 <listitem><para> <userinput><filename>flag*.png</filename></userinput> will
552 select all filenames starting with the letters <quote>flag</quote> and ending
553 with <quote><literal role="extension">.png</literal></quote>.</para></listitem>
554 <listitem><para><userinput><filename>memo?.txt</filename></userinput> will
555 select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but
556 not <filename>memo99.txt</filename>.</para></listitem>
557 </itemizedlist>
559 <para>When you have selected a range of files, you can narrow down the
560 selection
561 by using the Menubar <menuchoice><guimenu>Edit</guimenu>
562 <guimenuitem>Unselect...</guimenuitem></menuchoice> option or <keycombo
563 action="simul">&Ctrl;<keycap>-</keycap></keycombo> to specify
564 which of the selected files should be removed from the selection.</para>
566 <para>Use <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
567 or the Menubar <menuchoice><guimenu>Edit</guimenu>
568 <guimenuitem>Unselect All</guimenuitem></menuchoice> option or just
569 &LMB; click on a clear area of the view to cancel the
570 selection.</para>
572 <para>You can even invert the selection: that is, deselect all selected
573 files and select those that were previously unselected. Use the
574 Menubar <menuchoice><guimenu>Edit</guimenu><guimenuitem>Invert
575 Selection</guimenuitem></menuchoice> option or <keycombo
576 action="simul">&Ctrl;<keycap>*</keycap></keycombo> to do this.</para>
578 <para>You can also select multiple files and folders by holding the <keycap>&Ctrl;</keycap> button while you click on each individual file or folder. This enables you to then move or copy multiple files and folders to a different location at one time by using the same method above.</para>
580 <para>A number of useful shortcut keys can be used in list, tree and text 
581 view modes:</para>
582 <variablelist>
584 <varlistentry>
585 <term><keycap>Space</keycap></term>
586 <listitem>
587 <para>Toggle the current selection.
588 </para>
589 </listitem>
590 </varlistentry>
592 <varlistentry>
593 <term><keycap>Insert</keycap></term>
594 <listitem>
595 <para>Toggle the current selection and move down to the next item.
596 </para>
597 </listitem>
598 </varlistentry>
600 <varlistentry>
601 <term><keycombo action="simul">&Ctrl;<keysym>Up Arrow</keysym></keycombo>, 
602 <keycombo action="simul">&Ctrl;<keysym>Down Arrow</keysym></keycombo>, 
603 <keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>, 
604 <keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>, 
605 <keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo>, 
606 <keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo>
607 </term>
608 <listitem>
609 <para>Move the selection, toggling the selection of everything on the way.
610 </para>
611 </listitem>
612 </varlistentry>
614 <varlistentry>
615 <term><keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>, 
616 <keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo>, 
617 <keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo>, 
618 <keycombo action="simul">&Shift;<keycap>End</keycap></keycombo>, 
619 <keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo>, 
620 <keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo>
621 </term>
622 <listitem>
623 <para>Deselect everything, then move the selection, selecting everything on 
624 the way.
625 </para>
626 </listitem>
627 </varlistentry>
628 </variablelist>
630 <para>Once you have selected the right files then the normal delete, copy or
631 move commands will act on all of the selected files at once. </para>
633 <note><para>Depending on your keyboard type and locale, you may find
634 that the <keycombo
635 action="simul">&Ctrl;<keycap>+</keycap></keycombo>, <keycombo
636 action="simul">&Ctrl;<keycap>-</keycap></keycombo> and <keycombo
637 action="simul">&Ctrl;<keycap>*</keycap></keycombo> shortcuts 
638 only work with the Numeric keypad <keycap>+</keycap>, <keycap>-</keycap> and
639 <keycap>*</keycap> keys.</para></note>
641 </sect1>
643 <sect1 id="making">
644 <title>Create New</title>
646 <para>When &konqueror; is in File Manager mode, picking
647 <guisubmenu>Create New</guisubmenu> from the <guimenu>Edit</guimenu>
648 menu or from the context menu you get by &RMB; clicking on a free
649 area in a folder view gives you a submenu letting you create any
650 of the following in the current folder:</para>
652 <variablelist>
654 <varlistentry>
655 <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem>
656                   </menuchoice></term>
657 <listitem><para>This option is most useful if you want to create an icon that
658 will open a particular application. It opens a dialog box with three tabbed
659 pages. The first, <guilabel>General</guilabel>, is where you choose an icon and
660 the text that will appear with it. The second page,
661 <guilabel>Permissions</guilabel>, lets you select who can use or modify the
662 icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that
663 will run the application, for example, <userinput>kedit</userinput> to start up
664 the &kedit; text editor. <userinput>kedit /home/pam/todo.txt</userinput> would
665 open the file <filename>/home/pam/todo.txt</filename> in &kedit;. Advanced
666 options such as the file types which the application can open are also
667 available from this page.</para>
669 <para>To make the application icon appear on your desktop, create the link in
670 your <filename class="directory">~/Desktop</filename> folder (this may be 
671 called something slightly different depending on how &kde; was installed on 
672 your system) or get to the
673 <guisubmenu>Create New...</guisubmenu> sub menu by
674 <mousebutton>right</mousebutton> clicking on a free area of the desktop 
675 instead of within &konqueror;'s window.</para>
677 <para>If you have a lot of specialized application links and don't want to
678 clutter up the desktop, then why not create them in your Applications
679 folder. You can get there in &konqueror; by choosing
680 <menuchoice><guimenu>Go</guimenu>
681 <guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon
682 on your desktop to open your Applications folder, which is usually in
683 <filename class="directory">~/.kde/share/applnk</filename>.</para>
685 <para>To put an application link icon into the panel, first create it in the
686 Applications folder then drag the icon onto a clear area of the
687 panel.</para>
689 </listitem>
690 </varlistentry>
692 <varlistentry>
693 <term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term>
694 <listitem><para>This lets you create an icon to open &konqueror; at a
695 particular
696 folder or web page. As with <guimenuitem>Link To
697 Application...</guimenuitem>
698 you can make the application icon appear on your desktop by creating the link
700 your <filename>~/Desktop</filename> folder or going to the
701 <guisubmenu>Create
702 New...</guisubmenu> sub menu by right clicking on a free area of the
703 desktop. When you first create it the text shown with the icon will be the full
704 path or &URL;. You can change it by right clicking on the icon, selecting
705 <guimenuitem>Properties...</guimenuitem> and entering the preferred text in
707 <guilabel>General</guilabel> tab page.</para></listitem>
708 </varlistentry>
710 <varlistentry>
711 <term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></term>
712 <listitem><para>Use this option to create an icon that will mount a floppy disk
713 and open an instance of &konqueror; showing the disk's contents. To unmount the
714 disk when you have finished with it <mousebutton>right</mousebutton> click on
715 the icon and select <guimenuitem>Unmount</guimenuitem>. In practice it doesn't
716 have to be a floppy disk but can be any hard disk or partition on your system
717 that is not normally mounted.  However, in most cases you will want to create the icon
719 your desktop.</para></listitem>
720 </varlistentry>
722 <varlistentry>
723 <term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Hard Disk...</guimenuitem></menuchoice></term>
724 <listitem><para>This option is similar to <guimenuitem>Floppy Device...</guimenuitem> 
725 but for a hard disk drive or partition.</para></listitem>
726 </varlistentry>
728 <varlistentry>
729 <term><guimenuitem>CD/DVD-ROM Device...</guimenuitem></term>
730 <listitem><para>This option is similar to <guimenuitem>Floppy
731 Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym> 
732 drive.</para></listitem>
733 </varlistentry>
735 <varlistentry>
736 <term><guimenuitem>Folder...</guimenuitem></term>
737 <listitem><para>An easy way of creating a new (sub)folder.</para></listitem>
738 </varlistentry>
740 <varlistentry>
741 <term><guimenuitem>Text File...</guimenuitem></term>
742 <listitem><para>Use this to create an ordinary, empty, text file. A
743 dialog box will be opened for you to enter the name of your new
744 file.</para></listitem>
745 </varlistentry>
747 <varlistentry>
748 <term><guimenuitem>HTML File...</guimenuitem></term>
749 <listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When
751 type the new file's name into the dialog box it is probably best to give
752 it a <literal role="extension">.html </literal> extension to avoid
753 confusion.</para></listitem>
754 </varlistentry>
756 <varlistentry>
757 <term><guimenuitem>Presentation Document...</guimenuitem></term>
758 <listitem><para>Creates a skeleton &koffice; 
759 &kpresenter; document. Give its name a <literal role="extension">.kpr</literal>
760 extension.</para></listitem>
761 </varlistentry>
763 <varlistentry>
764 <term><guimenuitem>Text Document...</guimenuitem></term>
765 <listitem><para>Creates a skeleton <application>KOffice</application> &kword;
766 document using the standard &kword; style template. Give its name a <literal
767 role="extension">.kwd</literal> extension.</para></listitem>
768 </varlistentry>
770 <varlistentry>
771 <term><guimenuitem>Spread Sheet Document...</guimenuitem></term>
772 <listitem><para>Use this to create a new <application>KOffice</application>
773 &kspread; spreadsheet file, and name it with a <literal
774 role="extension">.ksp</literal> extension.</para></listitem>
775 </varlistentry>
777 <varlistentry>
778 <term><guimenuitem>Illustration Document...</guimenuitem></term>
779 <listitem><para>Creates a new <application>KOffice</application> &kontour;
780 document. Name it with the extension <literal
781 role="extension">.kil</literal>.</para></listitem>
782 </varlistentry>
784 </variablelist>
786 </sect1>
788 <sect1 id="newname">
789 <title>Changing Names and Permissions</title>
791 <para>The two easiest ways to change the name of a file or folder is to either 
792 <mousebutton>right</mousebutton> click on it and select 
793 <guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> button.</para>
795 <para>To change the name or permissions of a file or folder 
796 <mousebutton>right</mousebutton> click on its name or icon and select the 
797 <guimenuitem>Properties...</guimenuitem> item, or if you have 
798 <quote>selected</quote> the file or folder, then you can use the Menubar 
799 <menuchoice><guimenu>Edit</guimenu> 
800 <guimenuitem>Properties</guimenuitem></menuchoice> option.</para>
802 <para>This will bring up the Properties dialog box with two tabbed 
803 pages:</para>
805 <itemizedlist>
806 <listitem><para><guilabel>General</guilabel>, which gives you some
807 information about the item and lets you change its name and, for a folder,
808 the associated icon.</para></listitem>
809 <listitem><para><guilabel>Permissions</guilabel>, which shows you the item's
810 ownership and access permissions and lets you change the permissions.
811 </para></listitem>
812 </itemizedlist>
814 <sect2 id="copyrename">
815 <title>Copy and Rename</title>
816 <para>If you want to make a copy of an existing file with a different name -- 
817 perhaps as a backup -- in the same folder as the original file, do a normal 
818 <guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem> 
819 it a dialog box will pop up  complaining that the file already exists. 
820 Just type the new name into the dialog's text box and press the 
821 <guibutton>Rename</guibutton> button (or if you are feeling lazy pressing the 
822 <guibutton>Propose</guibutton> button will generate a new name for you).</para>
823 </sect2>
825 <sect2 id="super-user">
826 <title>Super User Mode</title>
828 <para>If you are running as a normal user and try to access files outside of
829 your own home folder you will often be prevented from doing so and get an
830 error message such as <errorname>Access Denied</errorname>. </para>
832 <para>To access these files you need to be logged in as the system
833 administrator, often known as the Super User or <systemitem class="username">root</systemitem>. </para>
835 <para>Rather than logging out then in again, you can launch &konqueror; from
837 <guimenu>K</guimenu> Menu in Super User mode by selecting
838 <menuchoice><guisubmenu>System</guisubmenu><guimenuitem>File Manager - Super
839  User Mode
840 </guimenuitem></menuchoice>. You will be asked for the <systemitem class="username">root</systemitem>
841 login password but as long as you can provide that &konqueror; will be started
842 up with full access privileges to all files on your system.</para>
844 <warning><para>Take care.  As Super User (<systemitem class="username">root</systemitem>), you have complete control of
845 your system, and a wrong command can easily do irrevocable damage.</para>
846 <para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it
847 seriously increases your vulnerability to malicious hacking.</para></warning>
849 </sect2>
850 </sect1>
852 <sect1 id="file-associations">
853 <title>Configuring File Associations</title>
855 <!-- TODO: The content should probably be here too, but this'll do for -->
856 <!-- now. -->
857 <para>&kde; provides many applications which can open many different
858 types of file. Most of the time, the defaults will work with no
859 problems, but &konqueror; provides a powerful system to allow you to
860 change the applications used to open each file type. For more details,
861 choose the
862 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
863 Konqueror...</guimenuitem></menuchoice> menu item, select
864 <guilabel>File Associations</guilabel> in the configuration dialog,
865 and click on <guibutton>Help</guibutton>.</para>
867 </sect1>
870 <sect1 id="commandline">
871 <title>At the Command Line</title>
873 <para>Although &konqueror; is a very powerful and flexible
874 <acronym>GUI</acronym> file manager, there are occasions when the experienced
875 &Linux; / &UNIX; user wants to get down to the basics and work at the text 
876 command line level.</para>
878 <para>You can, of course, open an instance of &konsole;, perhaps with
879 &konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open
880 Terminal</guimenuitem></menuchoice> option or with <keycombo
881 action="simul">&Ctrl;<keycap>T</keycap></keycombo>.</para>
882 <para>If you only want to launch a program or view a &URL;, the <menuchoice>
883 <guimenu>Tools</guimenu><guimenuitem>Run Command</guimenuitem></menuchoice> 
884 (<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) option may be 
885 easier.</para>
887 <para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command...
888 </guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
889 <keycap>E</keycap></keycombo>) opens a small command line dialog window where 
890 you can enter a shell command such as <userinput>ps -ax | grep kdeinit
891 </userinput>. Note that it does not support full featured terminal control 
892 characters, so applications such as <userinput>top</userinput> and <userinput>
893 less</userinput> will not work properly, but it is available immediately 
894 without the delay involved in starting &konsole;.
895 </para>
897 <para>For more complex operations, &konqueror; has another nice feature: the 
898 Menubar <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Terminal
899 Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as 
900 a new view within &konqueror;. As long as the link icon is visible at the 
901 bottom right corner of each view, the terminal will follow any folder changes 
902 you make in the normal file manager view.</para>
904 <mediaobject>
905 <imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject>
906 <textobject>
907 <phrase>Including the terminal emulator</phrase>
908 </textobject>
909 </mediaobject>
911 </sect1>
913 </chapter>
914 <!--
915 Local Variables:
916 mode: sgml
917 sgml-omittag: nil
918 sgml-shorttag: t
919 sgml-minimize-attributes: nil
920 sgml-general-insert-case: lower
921 sgml-parent-document:("index.docbook" "book" "chapter")
922 End: