runtime/doc/kcontrol/desktopbehavior/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <articleinfo>
  10
  11 <authorgroup>
  12 <author>&Mike.McBride; &Mike.McBride.mail;</author>
  13 <author>&Jost.Schenck; &Jost.Schenck.mail;</author>
  14 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  15 </authorgroup>
  16
  17 <date>2005-02-20</date>
  18 <releaseinfo>3.4</releaseinfo>
  19
  20 <keywordset>
  21 <keyword>KDE</keyword>
  22 <keyword>KControl</keyword>
  23 <keyword>desktop</keyword>
  24 </keywordset>
  25 </articleinfo>
  26
  27 <sect1 id="desktop">
  28
  29 <title>Desktop Behavior</title>
  30
  31 <sect2 id="desktop-desktop">
  32 <title><guilabel>Desktop</guilabel> Tab</title>
  33
  34 <variablelist>
  35 <varlistentry>
  36 <term><guilabel>Show icons on desktop</guilabel></term>
  37 <listitem>
  38 <para>Uncheck this option if you do not want to have icons on the
  39 desktop.  Without icons the desktop may be somewhat faster, but you
  40 will no longer be able to drag files to the desktop.</para>
  41 <para>This will not remove any files already stored on the desktop,
  42 they will instead be hidden.</para>
  43
  44 <para>If this is enabled, you may also enable the ability to <guilabel>Allow programs in desktop window</guilabel>.</para>
  45
  46 <para>Enabling this option allows you to set a program as your desktop
  47 background, for example <command>xearth</command>, or &kworldclock;</para>
  48
  49 </listitem>
  50 </varlistentry>
  51
  52 <varlistentry>
  53 <term><guilabel>Show tooltips</guilabel></term>
  54 <listitem>
  55 <para>Check this option if you would like to see tooltips for icons on
  56 the desktop as you hover the mouse over them.  These tooltips display
  57 information about the file represented by the icon.  Depending on the
  58 type of file, the information can range from simple file size and
  59 creation dates for unfamiliar file types, to complete meta information
  60 such as the content of tags for music files.</para>
  61 </listitem>
  62 </varlistentry>
  63
  64 <varlistentry>
  65 <term><guilabel>Menu Bar at Top of Screen:</guilabel></term>
  66 <listitem>
  67 <para>This option determines whether there is a menu across
  68 the top of the &kde; Desktop similar to the style of &MacOS;.</para>
  69
  70 <para>The default is <guilabel>None</guilabel>.  If you select
  71 <guilabel>Desktop menu bar</guilabel> one static menu is shown at the
  72 top of the screen, displaying the desktop menu.  Finally there is
  73 <guilabel>Current application's menu bar (Mac OS-style)</guilabel>.
  74 If this option is selected, applications won't have their menu bar
  75 attached to their own window anymore. Instead, there is one menu bar
  76 at the top of the screen which shows the menus of the currently active
  77 application. You might recognize this behavior from &MacOS;.
  78 </para>
  79
  80 </listitem>
  81 </varlistentry>
  82
  83 <varlistentry>
  84 <term><guilabel>Mouse button actions:</guilabel></term>
  85 <listitem>
  86
  87 <para>The mouse button section allows you to determine what happens when
  88 you click one of the three mouse buttons on the Desktop (where there is
  89 no window).</para>
  90
  91 <note><para>Not all mice have three buttons.  Two button mice can
  92 usually activate the <mousebutton>Middle</mousebutton> button by
  93 pressing both the <mousebutton>Left</mousebutton> and
  94 <mousebutton>Right</mousebutton> mouse buttons at the same
  95 time.</para></note>
  96
  97 <para>For each of the three mouse buttons, you can select:</para>
  98
  99 <variablelist>
 100 <varlistentry>
 101 <term>No Action</term>
 102 <listitem><para>When you use this mouse button, nothing
 103 happens.</para></listitem>
 104 </varlistentry>
 105
 106 <varlistentry>
 107 <term>Window list menu</term>
 108 <listitem><para>This brings up a submenu with all the virtual desktops.
 109 Under each virtual desktop, you can select any window currently located
 110 on that desktop.  Once selected, &kde; will switch to that desktop, and
 111 place the focus on that window.</para></listitem>
 112 </varlistentry>
 113
 114 <varlistentry>
 115 <term>Desktop Menu.</term>
 116 <listitem><para>This brings up a submenu with commands specific to
 117 &kde;. You can create icons, edit bookmarks, cut and paste,
 118 run commands, configure &kde;, arrange icons, lock the session and log
 119 out of &kde;.  The exact content of the menu varies depending on the
 120 current status of &kde;. </para></listitem>
 121 </varlistentry>
 122
 123 <varlistentry>
 124 <term>Application Menu</term>
 125 <listitem><para>This brings up the <guimenu>Application</guimenu> Menus
 126 (also know as the <guimenu>K</guimenu> Menus), so you can start a new
 127 application.</para></listitem>
 128 </varlistentry>
 129
 130 <varlistentry>
 131 <term>Custom Menu 1</term>
 132 <term>Custom Menu 2</term>
 133 <listitem>
 134 <para>You may also configure up to two custom menus.  If you choose either of these, the <guibutton>Edit...</guibutton> becomes available, allowing you to edit the contents of the custom menus.</para>
 135 <!-- FIXME: Need to find out what else can be added here (for instance, it lets me type 'emacsclient' which isn't available in the K menu) -->
 136 </listitem>
 137 </varlistentry>
 138 </variablelist>
 139
 140 </listitem>
 141 </varlistentry>
 142 </variablelist>
 143
 144 </sect2>
 145
 146 <sect2 id="desktop-behavior-file-icons">
 147 <title><guilabel>File Icons</guilabel></title>
 148
 149 <para>First are two options regarding the placement of icons:</para>
 150
 151 <variablelist>
 152 <varlistentry>
 153 <term><guilabel>Automatically line up icons</guilabel></term>
 154 <listitem><para>If this option is enabled, &kde; will align icons on a
 155 grid on the desktop. If it is not enabled, you may drop icons
 156 anywhere, and they will not be aligned for you.</para></listitem>
 157 </varlistentry>
 158 <varlistentry>
 159 <term><guilabel>Show hidden files</guilabel></term>
 160 <listitem><para>If this option is enabled, then all hidden files will
 161 appear on the desktop. Generally this only clutters your desktop area,
 162 but if you are often working with hidden files or folders, this can
 163 be useful.</para>
 164 <warning><para>Be very careful when deleting or modifying hidden files.
 165 Many of these files are configuration files and are essential for the
 166 correct operation of your computer.</para></warning>
 167 </listitem>
 168 </varlistentry>
 169 </variablelist>
 170
 171 <para>The &kde; desktop has a preview feature for many file types,
 172 including <acronym>HTML</acronym>  files, images, &PostScript; and
 173 <acronym>PDF</acronym>, sound, web archives (if you have the
 174 appropriate &konqueror; plugin installed) and text files.</para>
 175
 176 <para>if you enable previews for one of these, files of that particular
 177 file type will not be represented by standard icons on the desktop, but
 178 will instead be shown as miniature previews.  On slow computers, the
 179 previews can take some time to show up, so you might not want to enable
 180 this feature.</para>
 181
 182 </sect2>
 183
 184 <sect2 id="desktop-behavior-device-icons">
 185 <title><guilabel>Device Icons</guilabel></title>
 186
 187 <para>On some operating systems (&Linux; and FreeBSD, so far) &kde; can
 188 dynamically display icons for each <firstterm>mountable</firstterm>
 189 device you have available.  This could be &CD-ROM; drives, floppy disk
 190 drives, or network shares.</para>
 191
 192 <para>If you enable this, you can choose what kind, if any, of these
 193 devices you would like quick access icons to be displayed for.</para>
 194
 195 </sect2>
 196 </sect1>
 197
 198 </article>