<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>

<authorgroup>
<author>
<firstname>Mike</firstname>
<surname>McBride</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<date>2002-10-16</date>
<releaseinfo>3.1</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>KControl</keyword>
<keyword>file manager</keyword>
</keywordset>
</articleinfo>
<sect1 id="file-manager">
<title>File Manager</title>

<para>In this module, you can configure various aspects of
&konqueror;'s file manager functionality. </para>

<note><para>&konqueror;'s web browser functionality has its <ulink
url="help:/kcontrol/khtml/index.html">own configuration
modules</ulink>.</para></note>

<sect2 id="fileman-use">
<title>Use</title> 

<para> The configuration options for the file manager are
organized under tabs as follows:</para>

<variablelist>
<varlistentry>
<term><guilabel>Appearance</guilabel></term>
<listitem><para>This tab contains options customizing the appearance of
&konqueror; windows, such as the default font
text color.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Behavior</guilabel></term>
<listitem><para>This tab contains a couple of &konqueror;
global options</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Previews</guilabel></term>
<listitem>
<para>On this tab, you can customize when &konqueror; should show
previews.</para>
</listitem>
</varlistentry>
</variablelist>

<sect3 id="fileman-appearance">	
<title>Appearance</title>
					
<para>The following settings determine how text and colors are displayed in
&konqueror; File Manager mode windows.</para>

<variablelist>
<varlistentry>
<term><guilabel>Standard font:</guilabel></term>
<listitem>
<para>This is the font used to display text such as file names in
&konqueror; windows.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Font size:</guilabel></term>
<listitem>

<para>Lets you control the size of text, while the <guilabel>Standard
Font</guilabel> setting determines the font face used.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Normal text color:</guilabel></term>
<listitem>
<para>Determines the standard text color.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Word-wrap icon text:</guilabel></term>
<listitem>
<para>When checked, long filenames will be wrapped onto multiple lines,
rather than showing only the part of the filename that fits on a
single line.</para>

<tip> <para> If you uncheck this option, you can still see
word-wrapped filenames by pausing the mouse pointer over the
icon.</para></tip>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Underline filenames:</guilabel></term>
<listitem>
<para>When <guilabel>Underline filenames</guilabel> is checked,
 filenames will be underlined so that they look like links on a web
 page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Display filesizes in bytes:</guilabel></term>
<listitem>
<para>The final check box on this page determines how &konqueror;
displays file sizes, when you are in one of the file manager modes
that normally shows this information.  If you check the
<guilabel>Display filesizes in bytes</guilabel> box, then file sizes
are always shown in bytes.  If you leave it unchecked, then file sizes
are shown in bytes, kilobytes, and Megabytes, depending on their
size.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="fileman-behav">
<title>Behavior</title>
			
<variablelist>
<title><guilabel>Misc Options</guilabel></title>
<varlistentry>
<term>Open directories in separate windows</term>
<listitem> <para>If this option is checked, a new
&konqueror; window will be created when you open a
directory, rather than simply showing that directory's contents in the
 current
window.</para></listitem>
</varlistentry>
					
<varlistentry>
<term>Show network operations in a single window</term>
<listitem>
<para>If unchecked, and you download a
file, a dialog box will appear that shows the status of the
download.</para>

<screenshot>
  <screeninfo>Download Dialog Box</screeninfo>
  <mediaobject>
  <imageobject><imagedata fileref="kfileman2.png"
 format="PNG"/></imageobject>
  <textobject> <phrase>Download Dialog Box</phrase> </textobject>
  <caption>
  <para>Individual Download Dialog Box</para>
  </caption>
  </mediaobject>
</screenshot>

<para>If you start a new transfer, another dialog box will
appear. (&Netscape; users will be familiar with
this behavior) </para>

<para>If checked, all transfer status windows will be grouped
together under a single dialog box.</para>
<screenshot>
  <screeninfo>Download Dialog Box</screeninfo>
  <mediaobject>
  <imageobject><imagedata fileref="kfileman1.png"
 format="PNG"/></imageobject>
  <textobject><phrase>Download Dialog Box</phrase></textobject>
  <caption>
  <para>Collected Download Dialog Box</para>
  </caption>
  </mediaobject>
</screenshot> 

<para>If you choose to use the Collected download dialog box, you can
delete transfers by clicking once on the transfer you want to cancel,
then clicking the <guibutton>Delete</guibutton> Button on the
left.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show file tips</guilabel></term>
<listitem>
<para> Here you can control if, when moving the mouse over a file, you
want to see a small popup window with additional information about
that file.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Number of file tip entries</guilabel></term>
<listitem>
<para>Here you can set how many items of information are displayed.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Home URL</guilabel></term>
<listitem><para>This is the &URL; (&eg; a
directory or a web page) where &konqueror; will jump to
when the <guibutton>Home</guibutton> button is pressed.</para><para>The
default is the users home directory, indicated with a
<literal>~</literal>.</para></listitem>
</varlistentry>
</variablelist>

<para>You can set a path that is your <guilabel>Home URL</guilabel> by
typing into the text field, or using the <guiicon>browse</guiicon>
icon.  The default is <literal>~</literal> which is a standard
shortcut for your $<envar>HOME</envar> direcory.  When you choose the
<guiicon>home</guiicon> icon on your panel, in a file open or save
dialog, or from within &konqueror; in file manager mode, this is the
folder you will be shown.</para>

<para>The <guilabel>Ask confirmation for</guilabel> setting tells
&konqueror; what to do when you choose to <quote>Delete</quote>,
<quote>Trash</quote>, or <quote>Shred</quote> a file in a &konqueror;
window.  If any box is checked, &konqueror; asks for confirmation before
performing the corresponding action.</para>

<para>The next setting determines &konqueror;'s behavior when it comes
to memory management.  You can choose between the following
options:</para>

<variablelist>
<title>Minimize memory usage</title>
<varlistentry>
<term><guilabel>Never</guilabel></term>
<listitem>
<para>Disables the minimization of memory usage and allows you to make
each browsing activity independent from the others.</para>
<para>&konqueror; will make no attempts whatsoever to minimize it's use
of memory.  If you have a very large amount of <acronym>RAM</acronym>,
this might make &konqueror; faster.  If you have insufficient
<acronym>RAM</acronym>, it might make &konqueror; run much slower, as
more information is paged to disk.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>For local browsing only (recommended)</guilabel></term>
<listitem>
<para>&konqueror; will try to minimize memory usage when you are
browsing local filesystems, including network drives.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>For Web browsing only</guilabel></term>
<listitem>
<para>&konqueror; will only try to minimize memory usage when you are
browsing the web.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Always (use with care)</guilabel></term>
<listitem>
<para>This setting is not recommended, and should only be used if you
are very low on resources.</para>
</listitem>
</varlistentry>

</variablelist>

<note><para>A word on minimizing memory usage in &konqueror;</para>

<para>With this option activated, only one instance of &konqueror;
will exist in the memory of your computer at any moment, no matter how
many browsing windows you open, thus reducing resource
requirements.</para>

<para>Be aware that this also means that, if something goes wrong, all
your browsing windows will be closed simultaneously.</para>
</note>

</sect3>

<sect3>
<title>Previews</title>

<para>&konqueror; has a
preview feature for many file types, including <acronym>HTML</acronym>
files, images, &PostScript; and <acronym>PDF</acronym>, sound, web
archives (if you have the appropriate &konqueror; plugin installed)
and text files.</para>

<para>if you enable previews for one of these, files of that particular
file type will not be represented by standard icons in the filemanager, but
will instead be shown as miniature previews.  On slow computers, the
previews can take some time to show up, so you might not want to enable
this feature.</para>

<para>In this module you can specify which <quote>protocols</quote>
you wish the previews to be available for.  Creating the previews
requires that &konqueror; download at least part of the file, in order
to create the preview.  &konqueror;, like the rest of &kde; is
entirely network transparent, and will treat a remote &FTP; directory
just as if it was on your local hard drive.  This can result in a
delay, especially if you are viewing, for example, a directory full of
images over a slow network connection.</para>

<para>For each protocol, you can independently enable or disable
previews.  For example, you might enable previews for
<acronym>NFS</acronym> mounted drives if you have a fast network, but
disable them for &FTP; because your internet connection is via a
modem.</para>

<para>You can further refine the maximum size file that &konqueror;
will attempt to show a preview for.  The default is 1 MB.  In other
words, by default, if a file is 900 kb in size, and the protocol you
are viewing the directory with is enabled, then &konqueror; will
create a preview icon for it.  If the file is 1.1 MB in size,
&konqueror; will not make a preview, even if the protocol is
enabled.</para>

<para>You can turn on and off previews <quote>on the fly</quote> from
within &konqueror;, using the <guimenu>View</guimenu> menu. For
example, if you normally want to see image previews on every protocol,
but find a particular server is very slow to send you the data, you
might turn it off for the present, and turn it on again later.</para>

<para>You may also like to enable the checkbox <guilabel>Increase size
of previews relative to icons</guilabel>, in order to see more
information in the thumbnails.</para>

<para>Many image files already contain a thumbnail.  You can enable
the <guilabel>Use thumbnails embedded in files</guilabel> to make use
of these. This will save time waiting for thumbnails to be created
when viewing a folder full of images you have not previously seen in
&konqueror;.</para>

</sect3>

</sect2>

<sect2 id="file-author"><title>Section Author</title>
<para>Ellis Whitehead <email>kde@ellisw.net</email></para>
<para>Updated by Mike McBride <email>mpmcbride7@yahoo.com</email></para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

</sect2>
</sect1>

</article>