Fix crash if key bindings specified in profile cannot be found. Improve

[personal-kdebase.git] / apps / doc / konqueror / filemanager.docbook

<chapter id="filemanager">
<chapterinfo>
<authorgroup>
<author>&Pamela.Roberts;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup> 

<date>2006-03-08</date>
<releaseinfo>3.5</releaseinfo>
</chapterinfo>

<title>&konqueror; the File Manager</title>

<sect1 id="dirfolders">
<title>Folders and Paths</title>
<para>In &UNIX; and &Linux; all folders are arranged in a simple 
hierarchy. Starting from a top level folder (also called the root directory), 
the structure descends and branches containing various files and subfolders. 
This means that you can get from any folder to any other by going <quote>up
</quote> until you reach a common point then <quote>down</quote> through 
the appropriate subfolders until you reach your target.</para>

<para>The position of any file or folder in the structure (also called a 
directory tree) can be described by its <quote>path</quote>, which is a simple 
list of the folders you would have to descend through to get to the target 
folder or file. For example <filename class="directory">/home/pam</filename> 
is the subfolder <filename class="directory">pam</filename> of the subfolder 
<filename class="directory">home</filename> of the top level folder, and 
<filename>/home/pam/words.txt</filename> is the file <filename>words.txt
</filename> in that subfolder. The leading <quote>/</quote> in these paths 
represents the top level folder.</para>

<para>Every folder accessible by your system &mdash; including those on
other hard disk partitions, your floppy and &CD-ROM; &mdash; will appear
in the tree descending from /, their exact paths will depend on how your system
was set up (see also the section on <link linkend="floppy-cd">Floppy and
&CD-ROM; Drives</link>).
</para>
<para>Every user on a &UNIX; / &Linux; system has their own <quote>home</quote> 
folder to hold their personal files and settings; for example
<filename class="directory">/home/john</filename> and  
<filename class="directory">/home/mary</filename>. The 
symbol <keycap>~</keycap> is often used to represent the user's home 
folder, so that <filename>~/letter.txt</filename> refers to the file 
<filename>letter.txt</filename> in my home folder.</para>
<para>Note that the term <quote>directory</quote> is often used instead of 
<quote>folder</quote>.</para>
</sect1>

<sect1 id="viewmode">
<title>View Modes</title>
<para>In File Manager mode, &konqueror; lists which files and subfolders are
contained within a given folder and can provide you with some information about
them. The <quote>path</quote> of the current folder is shown in the Location
Toolbar. The way that &konqueror; displays the files and folders depends mainly
on your choice of view mode which can be selected from the
<menuchoice><guimenu>View</guimenu><guisubmenu>View
Mode</guisubmenu></menuchoice > sub menu. The view modes &konqueror; provides
are outlined below.
</para>

<variablelist>

<varlistentry>
<term><guimenuitem>Icon View</guimenuitem></term>
<listitem><para>Displays an icon and a name for each file or subfolder in
the current folder.</para>
<para>Files of certain types may display a preview of their contents instead of
the default icon. The file types selected for preview are controlled by the
<menuchoice><guimenu>View</guimenu><guisubmenu>Preview</guisubmenu></menuchoice>
sub menu settings. See the section <link linkend="previews">
File Previews</link> of this handbook for more details.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>MultiColumn View</guimenuitem></term>
<listitem><para>Is similar to <guimenuitem>Icon View</guimenuitem> except that
the current folder contents are organized into columns instead of rows.
Files may be previewed in <guimenuitem>MultiColumn View</guimenuitem> as
they are in <guimenuitem>Icon View</guimenuitem>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Tree View</guimenuitem></term>
<listitem><para>Can be used to <link linkend="navigation">navigate</link> the
folder tree starting at the current folder. Each file and subfolder is
shown on its own line. Folders can be expanded to reveal their contents by
<mousebutton>left</mousebutton> clicking on the preceding <keycap>+</keycap>
sign. Similarly, an expanded folder's contents can be hidden by
<mousebutton>left</mousebutton> clicking on the <keycap>-</keycap> sign.</para>
<para>In addition to the file name, some file detail information is shown on
each line. The details are controlled by the <menuchoice>
<guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice>
sub menu settings.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Info List View</guimenuitem></term>
<listitem><para>Displays each file on a separate line similar to the
<guimenuitem>
Detailed List View</guimenuitem> except that the detail information is 
specific to the file type. This feature is controlled by the
<menuchoice><guimenu>View</guimenu><guisubmenu>View As</guisubmenu></menuchoice>
sub menu.</para>
<para>For example: If the file type is <quote>Folder,</quote> then the contents
information is shown. Viewing as <quote>JPEG Images</quote> shows the pixel
dimensions and EXIF data if available, and viewing as <quote>Plain Text</quote>
shows the lines, words, characters, and format.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Detailed List View</guimenuitem></term>
<listitem><para>Displays each file or folder on a separate line, as an icon
followed by the file or folder name followed by information about the 
item. The amount of information shown is controlled by the <menuchoice>
<guimenu>View</guimenu><guisubmenu>Show Details</guisubmenu></menuchoice> 
sub menu settings.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text View</guimenuitem></term>
<listitem><para>Is similar to the <guimenuitem>Detailed List View</guimenuitem> 
except that icons are not shown and the first character in each line will be 
<quote>/</quote> if the item is a folder.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Photobook</guimenuitem></term>
<listitem><para>Transforms &konqueror; into a simple viewing
application for the current folder. Most of the main window renders a selected
image, and thumbnails of the image files in the current directory are previewed
along the side.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>File Size View</guimenuitem></term>
<listitem><para>Creates a visual representation of the folder tree that reflects
the file sizes of the folder contents. The window area represents all of the
disk space used by the contents of the current folder. Subfolders and their
contents are represented as rectangular blocks. The area of each block is
proportional to the size of its contents. Various modifications to this
visualization are controlled via the sub menus of the
<menuchoice><guimenu>View</guimenu></menuchoice> menu.
</para></listitem>
</varlistentry>
</variablelist>


<sect2 id="filetipinfo">
<title>File Tip Info</title>
<para>Checking the <guilabel>Show file tips</guilabel> box in the <guilabel>
Behavior</guilabel> page of the &konqueror; Configuration dialog causes a 
small pop up information window to appear when the mouse pointer is hovered over
a file or folder name or icon. 
</para>
<para>If the <guilabel>Show previews in file tips</guilabel> checkbox is 
checked the pop up window will also show a small image of the file contents.
</para>
</sect2>

<sect2 id="previews">
<title>File Previews</title>
<para>Selecting <menuchoice><guimenu>View</guimenu><guisubmenu>Preview
</guisubmenu></menuchoice> from the Menubar will bring up a sub menu 
that lets you enable file previews for certain types of file.</para>
<para>Generally this means that the file's icon will be replaced by a small 
image showing the file contents.</para>
<para>If file preview is enabled for <guimenuitem>Sound Files</guimenuitem> 
the file will be played whenever the mouse cursor is hovering over the file 
name or icon.</para>
<para>Note that file previews are only available in <guimenuitem>Icon View
</guimenuitem> and <guimenuitem>MultiColumn View</guimenuitem> modes.</para>
<para>Because &konqueror; has to read much more data than just the file name 
details to generate a preview, file previews may not be appropriate 
when viewing files on a floppy or from a remote system. The <guilabel>Previews
</guilabel> page of the File Manager Configuration 
dialog allows you to disable file previews for protocols such as 
<link linkend="ftp">ftp</link> where reading the extra data would take too 
long.</para>
</sect2>

</sect1>

<sect1 id="navigation">
<title>Navigation</title>
<para>To get to a file with &konqueror; you first need to navigate 
through the folder tree to find the folder containing that 
file.</para>

<para>To move between folders you can simply step up and down the
tree:</para>

<itemizedlist>
<listitem><para>To descend into a subfolder <mousebutton>left
</mousebutton> click on its name or
icon -- or if you have already <quote>selected</quote> it (see below) -- then just press
<keycap>Enter</keycap>.</para></listitem> 
<listitem><para>To go up the folder tree you can click on the <guiicon>Up
</guiicon> button in the Toolbar, use<keycombo action="simul">&Alt;<keysym>Up Arrow</keysym></keycombo>, or use the Menubar
<menuchoice><guimenu>Go</guimenu><guimenuitem>Up</guimenuitem></menuchoice>
option.</para></listitem>
</itemizedlist>

<para>To <quote>select</quote> a file or folder in the displayed folder 
without opening it in any way use the <keysym>up</keysym> and <keysym>down
</keysym> arrow keys to move through the items. 
The selected item will be highlighted and some information about it 
will be displayed in the Status Bar.</para>

<para>Setting the <link linkend="viewmode">View Mode</link> to <guimenuitem>
Tree View</guimenuitem> can help you locate folders in the tree below the 
current folder; in this mode each folder is shown with a small box at 
the left. If the box contains a <keycap>+</keycap> sign, <mousebutton>left
</mousebutton> clicking on the box (not on the folder name or icon) will 
display a sub tree showing files and subfolders contained in that folder. 
The small box will then change to show a <keycap>-</keycap> sign. 
<mousebutton>Left</mousebutton> click on that to collapse the sub tree. Once 
you have found the folder you are looking for, <mousebutton>left
</mousebutton> click on the folder name or icon to open it.</para>

<para>The <link linkend="sidebar">Navigation Panel</link> can also help you 
find your way around the file system.</para>

<para>You can go directly to any folder by typing its path into the
Location Toolbar window or into the dialog box invoked by the Menubar
<menuchoice><guimenu>Location</guimenu><guimenuitem>Open Location</guimenuitem>
</menuchoice> item or by <keycombo action="simul">&Ctrl;<keycap>
O</keycap></keycombo>. &konqueror;'s <link linkend="path-complete">
Text Completion</link> feature may be useful when you do this. Don't forget
that in &Linux; / &UNIX; file and folder names are case sensitive.</para>

<para>When you have moved to a new folder you can go back to your
previous choice by using the Toolbar <guiicon>Back</guiicon> button, the
Menubar
<menuchoice><guimenu>Go</guimenu> <guimenuitem>Back</guimenuitem></menuchoice>
item, or <keycombo action="simul">&Alt;<keysym>Left
Arrow</keysym></keycombo>. Once you have gone back you can go forward. Use the Toolbar
<guiicon>Forward</guiicon> button, the Menubar
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Forward</guimenuitem></menuchoice> item or <keycombo
action="simul">&Alt;<keysym>Right
Arrow</keysym></keycombo>.</para>

<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
action="simul">&Alt;<keysym>Up
Arrow</keysym></keycombo>.</para>

<tip><para>Holding the &LMB; pressed while the mouse pointer is
over the Toolbar <guiicon>Up</guiicon>, <guiicon>Back</guiicon> or
<guiicon>Forward</guiicon> buttons brings up a menu of recently visited
locations.</para></tip>

<sect2 id="file-find">
<title>Finding Files and Folders</title>

<para>If you don't know or can't remember where a file or folder is within
your system, then use the Toolbar <guiicon>Find File</guiicon> button or the
Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Find 
File...</guimenuitem></menuchoice> option.  This will embed the file finder 
application &kfind; into &konqueror;'s window. See the &kfind; Handbook 
for help in using &kfind;.
</para>

<note><para>If the name of a file or folder begins with a period (dot), then
it is a <quote>hidden</quote> file or folder, and will not normally be shown
by &konqueror;. To see hidden files or folders use the Menubar <menuchoice>
<guimenu>View</guimenu><guimenuitem>Show Hidden Files</guimenuitem>
</menuchoice> option.</para>
<para>Another reason &konqueror; may not show the file or folder you are 
looking for is that you may have the <link linkend="konq-plugin"><guisubmenu>
View Filter</guisubmenu></link> plugin set to display only certain types of 
file.</para></note>

</sect2>

<sect2 id="floppy-cd">
<title>Floppy and &CD-ROM; Drives</title>

<para>Any floppy disk, &CD; drive or other hard disk partition that you have 
on your system will usually appear in the <filename class="directory">/
</filename>,  <filename class="directory">/media</filename>, <filename class="directory">/mnt</filename> or 
<filename class="directory">/auto</filename> folder, having a path something 
like <filename class="directory">/mnt/floppy</filename> or
<filename class="directory">/cdrom</filename>. The details will depend on
how your system was set up.</para>

<para>&UNIX; / &Linux; requires that you <command>mount</command> a floppy disk 
or &CD-ROM; when you have inserted it into the drive, and <command>mount
</command> other hard disk partitions when you want to access them. You also 
need to unmount a floppy disk or &CD-ROM; before removing it to register that 
it is no longer available. </para>

<para>How you do this will depend on how your system:</para>

<itemizedlist>
<listitem><para>You may have an <application>Automount</application> facility,
in which case you don't have to bother about explicitly mounting and
unmounting,
although you may find that the &CD-ROM; occasionally starts up by itself for no
apparent reason.</para></listitem>

<listitem><para>You may have <guiicon>Floppy</guiicon>, &CD-ROM; and hard disk 
icons on your desktop, in which case &LMB; click on the icon to mount it. 
Doing this should also bring up a &konqueror; window showing the contents of 
the floppy, &CD-ROM; or partition. To unmount, <mousebutton>right</mousebutton> 
click on the icon and choose the <guimenuitem>Unmount</guimenuitem> item.  
Visit the section <link linkend="making">Create New...</link> in this Handbook 
to see how to create such an icon.</para></listitem>

<listitem><para>Or you can do it the traditional way by typing into a text
console window:</para>

<para><userinput><command>mount /mnt/floppy</command></userinput></para>

<!-- This markup doesn't work properly, it puts 'mount' and '/mnt/floppy' 
on separate lines
<screen>
<userinput><command>mount</command>
 <option><replaceable>/mnt/floppy</replaceable></option></userinput>
</screen> -->

<para>to mount, for example, the floppy drive, and</para>

<!-- Same as above
<screen>
<userinput><command>umount</command>
 <option><replaceable>/mnt/floppy</replaceable></option></userinput></screen>
-->

<para><userinput><command>umount /mnt/floppy</command></userinput></para>

<para>to unmount it (<command>umount</command> not <command>unmount</command>).
</para>

<note><para>Rather than having to open a text console to type the
<command>mount
</command> or <command>umount</command> commands, you may prefer to use
&konqueror;'s <menuchoice><guimenu> Tools</guimenu><guimenuitem>Execute Shell
Command</guimenuitem></menuchoice>
(<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>)
 feature.
</para></note>

</listitem>

</itemizedlist>
</sect2>

</sect1>

<sect1 id="deleting">
<title>Deleting Files and Folders</title>

<para>&konqueror; gives you two ways to dispose of an unwanted file or
folder:</para>

<itemizedlist>
<listitem><para>You can move it to the <filename>Trash</filename> folder, which
is the safest method as you can get it back if you realize that you have made a
mistake.</para></listitem> 

<listitem><para>You can just plain Delete it, which
removes the entry from the folder and adds the disk area occupied by the
file(s) to the system's list of free disk areas, in the same way as the
<command>rm</command> command.</para></listitem>
</itemizedlist>

<para>The simplest way to remove a file or folder is to position
the mouse pointer over its name or icon and press the &RMB;, which
will bring up a menu containing the options <guimenuitem>Move to
Trash</guimenuitem> and <guimenuitem>Delete</guimenuitem>.</para>

<para>Or, if you have <quote>selected</quote> the item, the Menubar
<guimenu>Edit</guimenu> menu will give you the choice of
<quote><guimenuitem>Move to Trash</guimenuitem></quote> and
<quote><guimenuitem>Delete</guimenuitem></quote> options.</para>

<para><keycap>Del</keycap> will move the selected item or items to Trash.</para>

<para><keycombo action="simul">&Shift;<keycap>Del</keycap></keycombo>
will really, truly and irrevocably delete the selected item or
items.</para>

<note><para>You won't be able to remove a file or folder if you don't have
the necessary permissions; see the section on <link linkend="super-user">Super
User Mode</link> for further details.</para></note>

</sect1>

<sect1 id="moving">
<title>Moving and Copying</title>

<para>To copy a file or subfolder between folders you can:</para>

<itemizedlist>
<listitem><para>Position the mouse pointer over its name or icon and hold down
the &RMB;, which will bring up a menu containing the
<guimenuitem>Copy</guimenuitem> option. Choose that.</para>

<para>Or if the item is <quote>selected</quote> you can use the
<guiicon>Copy</guiicon> button on the Toolbar or the Menubar
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem></menuchoice>
item, or the <keycombo
action="simul">&Ctrl;<keycap>C</keycap></keycombo> 
shortcut key combination. You can also select <link linkend="multiple">multiple</link> files or folders to copy/move as well.</para></listitem>

<listitem><para>Navigate to the folder you want to copy the item into then
Paste the item into the new folder by using the Toolbar
<guiicon>Paste</guiicon> button or the Menubar
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem></menuchoice> option or the <keycombo
action="simul">&Ctrl;<keycap>V</keycap></keycombo> shortcut, or by
moving the mouse pointer to a clear area of the window and holding the &RMB;
down to bring up a menu containing the <guimenuitem>Paste</guimenuitem> option.
</para></listitem>
</itemizedlist>

<para>Moving a file or subfolder between folders can be done in the
same
way as copying, except that you choose the <guimenuitem>Cut</guimenuitem>
option
or <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
instead of <guimenuitem>Copy</guimenuitem>. The item that you have
<guimenuitem>Cut</guimenuitem> will be removed from the original folder when
you do the <guimenuitem>Paste</guimenuitem> into the new folder.</para>

<para>You can also copy or move selected item(s) to another folder by using 
<menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Copy Files</guimenuitem></menuchoice> (<keycap>F7</keycap>) or
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Move Files</guimenuitem>
</menuchoice> (<keycap>F8</keycap>), or by selecting
<guimenuitem>Copy To</guimenuitem> or <guimenuitem>Move To</guimenuitem> from
the drop down menu you get when you <mousebutton>right</mousebutton> click on
an file or folder name in the File Manager window.</para>

<note><para>You may not be able to copy or move a file or folder if
you don't have the necessary permissions. See the section on <link
linkend="super-user">Super User Mode</link> for further
details.</para></note>

<sect2 id="dnd">
<title>Using Drag 'n Drop</title>

<para>&konqueror; also supports Drag and Drop copying and moving of files and
folders.</para>

<para>You can do this by having two instances of &konqueror;, one showing the 
folder you want to copy from, the other showing the target folder. 
Position the mouse pointer over the item you wish to copy or move, then, 
holding the &LMB; pressed, <quote>drag</quote> it to a clear space in the
target
 
folder. Release the button and you will be
presented with a menu choice of <guimenuitem>Copy</guimenuitem> or
<guimenuitem>Move</guimenuitem>. Take care to <quote>drop</quote> the item into
 an empty area of the target
folder view - dropping it on top of another file name or icon can cause
problems.</para>

<para>You can also set up &konqueror; to show more than one folder within
its window and drag &amp; drop between them.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="dragdrop.png"/></imageobject>
<textobject>
<phrase>Split Views for Drag &amp; Drop</phrase>
</textobject>
</mediaobject>

<para>This screenshot illustrates the use of the Menubar
<menuchoice><guimenu>Window</guimenu> <guimenuitem>Split View
Left/Right</guimenuitem></menuchoice> option, also available with the shortcut 
<keycombo
action="simul">&Ctrl;&Shift;<keycap>L</keycap>
</keycombo>,
to split the main &konqueror; window into two views, each showing the contents
of a different folder.</para>

<para>To be able to show different folders in each view they should not be 
linked; the little boxes at the bottom right of each view should be empty.
</para>

<para>The <quote>active</quote> view, that is the one whose path is shown in
the Location Toolbar and which responds to navigation and Menubar commands, is
shown by the little green light in the bottom left corner. To make a view
active, <mousebutton>left</mousebutton> click on an empty area of the view or
on its Status Bar.</para>

<para>To remove an active view from &konqueror;'s window use the <keycombo
action="simul">&Ctrl;&Shift;<keycap>R</keycap>
</keycombo> shortcut, or the Menubar <menuchoice><guimenu>Window</guimenu>
<guimenuitem>Remove
Active View</guimenuitem></menuchoice> option, or &RMB; click on the Status Bar
and choose the <guimenuitem>Remove Active View</guimenuitem> option from the
resulting menu.</para>

<para>If you use &konqueror; tabs, you can drag and drop between tabs
by dragging the file to the tab label, without letting go yet.  The
destination tab will pop to the front, allowing you to continue
dragging and then drop the file.</para>

</sect2>

<sect2 id="dups">
<title>Duplicate File Names</title>
<para>If you try to paste a file into a folder that already 
contains a file with the same name, &konqueror; will pop up a dialog box warning 
you that the file already exists. You can then choose to:
</para>
<itemizedlist>
<listitem><para>
<guilabel>Overwrite</guilabel> the old file with the newly copied one. 
The <guibutton>Overwrite All</guibutton> button can be used if you have copied 
multiple items.</para></listitem>
<listitem><para>Cancel the paste operation by pressing the <guibutton>Skip
</guibutton> or <guibutton>Skip All</guibutton> button.</para></listitem>
<listitem><para>Give the file that is being copied a different name. You can 
do this by typing a new name into the text entry box or get &konqueror; to 
<guibutton>Propose</guibutton> one. When you have done this press the 
<guibutton>Rename</guibutton> button.</para></listitem>
</itemizedlist>
</sect2>
</sect1>

<sect1 id="multiple">
<title>Selecting Multiple Files</title>

<para>You sometimes want to delete, copy or move a number of files that are 
similar in some way. For example you may wish to move all of the .png graphics 
files from one folder to another. &konqueror; makes this easy by letting you 
select multiple files based on similarities in their file names.</para>

<para>Use the Menubar
<menuchoice><guimenu>Edit</guimenu><guisubmenu>Selection</guisubmenu>
<guimenuitem>Select...</guimenuitem></menuchoice> item or the shortcut
<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>. This
brings up a little dialog box in which you enter a filename containing
the wildcard characters <keycap>*</keycap>, which matches any number
of characters, and <keycap>?</keycap> which matches a single
character. Press <guibutton>OK</guibutton> and &konqueror; will
highlight all files with matching names. For example;</para>
      
<itemizedlist>
<listitem><para> <userinput><filename>flag*.png</filename></userinput> will
select all filenames starting with the letters <quote>flag</quote> and ending
with <quote><literal role="extension">.png</literal></quote>.</para></listitem>
<listitem><para><userinput><filename>memo?.txt</filename></userinput> will
select <filename>memo1.txt</filename> and <filename>memo9.txt</filename> but
not <filename>memo99.txt</filename>.</para></listitem>
</itemizedlist>

<para>When you have selected a range of files, you can narrow down the
selection
by using the Menubar <menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Unselect...</guimenuitem></menuchoice> option or <keycombo
action="simul">&Ctrl;<keycap>-</keycap></keycombo> to specify
which of the selected files should be removed from the selection.</para>

<para>Use <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
or the Menubar <menuchoice><guimenu>Edit</guimenu>
<guimenuitem>Unselect All</guimenuitem></menuchoice> option or just
&LMB; click on a clear area of the view to cancel the
selection.</para>

<para>You can even invert the selection: that is, deselect all selected
files and select those that were previously unselected. Use the
Menubar <menuchoice><guimenu>Edit</guimenu><guimenuitem>Invert
Selection</guimenuitem></menuchoice> option or <keycombo
action="simul">&Ctrl;<keycap>*</keycap></keycombo> to do this.</para>

<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>

<para>A number of useful shortcut keys can be used in list, tree and text 
view modes:</para>
<variablelist>

<varlistentry>
<term><keycap>Space</keycap></term>
<listitem>
<para>Toggle the current selection.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycap>Insert</keycap></term>
<listitem>
<para>Toggle the current selection and move down to the next item.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Ctrl;<keysym>Up Arrow</keysym></keycombo>, 
<keycombo action="simul">&Ctrl;<keysym>Down Arrow</keysym></keycombo>, 
<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>, 
<keycombo action="simul">&Ctrl;<keycap>End</keycap></keycombo>, 
<keycombo action="simul">&Ctrl;<keycap>Page Up</keycap></keycombo>, 
<keycombo action="simul">&Ctrl;<keycap>Page Down</keycap></keycombo>
</term>
<listitem>
<para>Move the selection, toggling the selection of everything on the way.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><keycombo action="simul">&Shift;<keysym>Up Arrow</keysym></keycombo>, 
<keycombo action="simul">&Shift;<keysym>Down Arrow</keysym></keycombo>, 
<keycombo action="simul">&Shift;<keycap>Home</keycap></keycombo>, 
<keycombo action="simul">&Shift;<keycap>End</keycap></keycombo>, 
<keycombo action="simul">&Shift;<keycap>Page Up</keycap></keycombo>, 
<keycombo action="simul">&Shift;<keycap>Page Down</keycap></keycombo>
</term>
<listitem>
<para>Deselect everything, then move the selection, selecting everything on 
the way.
</para>
</listitem>
</varlistentry>
</variablelist>

<para>Once you have selected the right files then the normal delete, copy or
move commands will act on all of the selected files at once. </para>

<note><para>Depending on your keyboard type and locale, you may find
that the <keycombo
action="simul">&Ctrl;<keycap>+</keycap></keycombo>, <keycombo
action="simul">&Ctrl;<keycap>-</keycap></keycombo> and <keycombo
action="simul">&Ctrl;<keycap>*</keycap></keycombo> shortcuts 
only work with the Numeric keypad <keycap>+</keycap>, <keycap>-</keycap> and
<keycap>*</keycap> keys.</para></note>

</sect1>

<sect1 id="making">
<title>Create New</title>

<para>When &konqueror; is in File Manager mode, picking
<guisubmenu>Create New</guisubmenu> from the <guimenu>Edit</guimenu>
menu or from the context menu you get by &RMB; clicking on a free
area in a folder view gives you a submenu letting you create any
of the following in the current folder:</para>

<variablelist>

<varlistentry>
<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Application...</guimenuitem>
                  </menuchoice></term>
<listitem><para>This option is most useful if you want to create an icon that
will open a particular application. It opens a dialog box with three tabbed
pages. The first, <guilabel>General</guilabel>, is where you choose an icon and
the text that will appear with it. The second page,
<guilabel>Permissions</guilabel>, lets you select who can use or modify the
icon. In the <guilabel>Application</guilabel> page you must enter the <guilabel>Command</guilabel> that
will run the application, for example, <userinput>kedit</userinput> to start up
the &kedit; text editor. <userinput>kedit /home/pam/todo.txt</userinput> would
open the file <filename>/home/pam/todo.txt</filename> in &kedit;. Advanced
options such as the file types which the application can open are also
available from this page.</para>

<para>To make the application icon appear on your desktop, create the link in
your <filename class="directory">~/Desktop</filename> folder (this may be 
called something slightly different depending on how &kde; was installed on 
your system) or get to the
<guisubmenu>Create New...</guisubmenu> sub menu by
<mousebutton>right</mousebutton> clicking on a free area of the desktop 
instead of within &konqueror;'s window.</para>

<para>If you have a lot of specialized application links and don't want to
clutter up the desktop, then why not create them in your Applications
folder. You can get there in &konqueror; by choosing
<menuchoice><guimenu>Go</guimenu>
<guimenuitem>Applications</guimenuitem></menuchoice>. Then create a single icon
on your desktop to open your Applications folder, which is usually in
<filename class="directory">~/.kde/share/applnk</filename>.</para>

<para>To put an application link icon into the panel, first create it in the
Applications folder then drag the icon onto a clear area of the
panel.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Link To Location (URL)...</guimenuitem></menuchoice></term>
<listitem><para>This lets you create an icon to open &konqueror; at a
particular
folder or web page. As with <guimenuitem>Link To
Application...</guimenuitem>
you can make the application icon appear on your desktop by creating the link
in
your <filename>~/Desktop</filename> folder or going to the
<guisubmenu>Create
New...</guisubmenu> sub menu by right clicking on a free area of the
desktop. When you first create it the text shown with the icon will be the full
path or &URL;. You can change it by right clicking on the icon, selecting
<guimenuitem>Properties...</guimenuitem> and entering the preferred text in
the
<guilabel>General</guilabel> tab page.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Floppy Device...</guimenuitem></menuchoice></term>
<listitem><para>Use this option to create an icon that will mount a floppy disk
and open an instance of &konqueror; showing the disk's contents. To unmount the
disk when you have finished with it <mousebutton>right</mousebutton> click on
the icon and select <guimenuitem>Unmount</guimenuitem>. In practice it doesn't
have to be a floppy disk but can be any hard disk or partition on your system
that is not normally mounted.  However, in most cases you will want to create the icon
on
your desktop.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guisubmenu>Device</guisubmenu><guimenuitem>Hard Disk...</guimenuitem></menuchoice></term>
<listitem><para>This option is similar to <guimenuitem>Floppy Device...</guimenuitem> 
but for a hard disk drive or partition.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>CD/DVD-ROM Device...</guimenuitem></term>
<listitem><para>This option is similar to <guimenuitem>Floppy
Device...</guimenuitem> but for a <acronym>CD</acronym> or <acronym>DVD</acronym> 
drive.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Folder...</guimenuitem></term>
<listitem><para>An easy way of creating a new (sub)folder.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text File...</guimenuitem></term>
<listitem><para>Use this to create an ordinary, empty, text file. A
dialog box will be opened for you to enter the name of your new
file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>HTML File...</guimenuitem></term>
<listitem><para>Creates a skeleton <acronym>HTML</acronym> source file. When
you
type the new file's name into the dialog box it is probably best to give
it a <literal role="extension">.html </literal> extension to avoid
confusion.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Presentation Document...</guimenuitem></term>
<listitem><para>Creates a skeleton &koffice; 
&kpresenter; document. Give its name a <literal role="extension">.kpr</literal>
extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Text Document...</guimenuitem></term>
<listitem><para>Creates a skeleton <application>KOffice</application> &kword;
document using the standard &kword; style template. Give its name a <literal
role="extension">.kwd</literal> extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Spread Sheet Document...</guimenuitem></term>
<listitem><para>Use this to create a new <application>KOffice</application>
&kspread; spreadsheet file, and name it with a <literal
role="extension">.ksp</literal> extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Illustration Document...</guimenuitem></term>
<listitem><para>Creates a new <application>KOffice</application> &kontour;
document. Name it with the extension <literal
role="extension">.kil</literal>.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="newname">
<title>Changing Names and Permissions</title>

<para>The two easiest ways to change the name of a file or folder is to either 
<mousebutton>right</mousebutton> click on it and select 
<guimenuitem>Rename</guimenuitem>, or select the file or folder and then press the <keycap>F2</keycap> button.</para>

<para>To change the name or permissions of a file or folder 
<mousebutton>right</mousebutton> click on its name or icon and select the 
<guimenuitem>Properties...</guimenuitem> item, or if you have 
<quote>selected</quote> the file or folder, then you can use the Menubar 
<menuchoice><guimenu>Edit</guimenu> 
<guimenuitem>Properties</guimenuitem></menuchoice> option.</para>

<para>This will bring up the Properties dialog box with two tabbed 
pages:</para>

<itemizedlist>
<listitem><para><guilabel>General</guilabel>, which gives you some
information about the item and lets you change its name and, for a folder,
the associated icon.</para></listitem>
<listitem><para><guilabel>Permissions</guilabel>, which shows you the item's
ownership and access permissions and lets you change the permissions.
</para></listitem>
</itemizedlist>

<sect2 id="copyrename">
<title>Copy and Rename</title>
<para>If you want to make a copy of an existing file with a different name -- 
perhaps as a backup -- in the same folder as the original file, do a normal 
<guimenuitem>Copy</guimenuitem> then when you <guimenuitem>Paste</guimenuitem> 
it a dialog box will pop up  complaining that the file already exists. 
Just type the new name into the dialog's text box and press the 
<guibutton>Rename</guibutton> button (or if you are feeling lazy pressing the 
<guibutton>Propose</guibutton> button will generate a new name for you).</para>
</sect2>

<sect2 id="super-user">
<title>Super User Mode</title>

<para>If you are running as a normal user and try to access files outside of
your own home folder you will often be prevented from doing so and get an
error message such as <errorname>Access Denied</errorname>. </para>

<para>To access these files you need to be logged in as the system
administrator, often known as the Super User or <systemitem class="username">root</systemitem>. </para>

<para>Rather than logging out then in again, you can launch &konqueror; from
the
<guimenu>K</guimenu> Menu in Super User mode by selecting
<menuchoice><guisubmenu>System</guisubmenu><guimenuitem>File Manager - Super
 User Mode
</guimenuitem></menuchoice>. You will be asked for the <systemitem class="username">root</systemitem>
login password but as long as you can provide that &konqueror; will be started
up with full access privileges to all files on your system.</para>

<warning><para>Take care.  As Super User (<systemitem class="username">root</systemitem>), you have complete control of
your system, and a wrong command can easily do irrevocable damage.</para>
<para>Also, connecting to the internet as <systemitem class="username">root</systemitem> is an extremely bad idea, as it
seriously increases your vulnerability to malicious hacking.</para></warning>

</sect2>
</sect1>

<sect1 id="file-associations">
<title>Configuring File Associations</title>

<!-- TODO: The content should probably be here too, but this'll do for -->
<!-- now. -->
<para>&kde; provides many applications which can open many different
types of file. Most of the time, the defaults will work with no
problems, but &konqueror; provides a powerful system to allow you to
change the applications used to open each file type. For more details,
choose the
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Konqueror...</guimenuitem></menuchoice> menu item, select
<guilabel>File Associations</guilabel> in the configuration dialog,
and click on <guibutton>Help</guibutton>.</para>

</sect1>


<sect1 id="commandline">
<title>At the Command Line</title>

<para>Although &konqueror; is a very powerful and flexible
<acronym>GUI</acronym> file manager, there are occasions when the experienced
&Linux; / &UNIX; user wants to get down to the basics and work at the text 
command line level.</para>

<para>You can, of course, open an instance of &konsole;, perhaps with
&konqueror;'s Menubar <menuchoice><guimenu>Tools</guimenu><guimenuitem>Open
Terminal</guimenuitem></menuchoice> option or with <keycombo
action="simul">&Ctrl;<keycap>T</keycap></keycombo>.</para>
<para>If you only want to launch a program or view a &URL;, the <menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Run Command</guimenuitem></menuchoice> 
(<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) option may be 
easier.</para>

<para><menuchoice><guimenu>Tools</guimenu><guimenuitem>Execute Shell Command...
</guimenuitem></menuchoice> (<keycombo action="simul">&Ctrl;
<keycap>E</keycap></keycombo>) opens a small command line dialog window where 
you can enter a shell command such as <userinput>ps -ax | grep kdeinit
</userinput>. Note that it does not support full featured terminal control 
characters, so applications such as <userinput>top</userinput> and <userinput>
less</userinput> will not work properly, but it is available immediately 
without the delay involved in starting &konsole;.
</para>

<para>For more complex operations, &konqueror; has another nice feature: the 
Menubar <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Terminal
Emulator</guimenuitem></menuchoice> option, which opens up a terminal window as 
a new view within &konqueror;. As long as the link icon is visible at the 
bottom right corner of each view, the terminal will follow any folder changes 
you make in the normal file manager view.</para>

<mediaobject>
<imageobject><imagedata format="PNG" fileref="cmndline.png"/></imageobject>
<textobject>
<phrase>Including the terminal emulator</phrase>
</textobject>
</mediaobject>

</sect1>

</chapter>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-parent-document:("index.docbook" "book" "chapter")
End:
-->