Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 325 insertions, 0 deletions

diff --git a/doc/userguide/panel-and-desktop.docbook b/doc/userguide/panel-and-desktop.docbook
new file mode 100644
index 000000000..1e92d3a82
--- /dev/null
+++ b/doc/userguide/panel-and-desktop.docbook
@@ -0,0 +1,325 @@
+<chapter id="panel-and-desktop">
+
+<chapterinfo>
+<authorgroup>
+<author>
+&Philip.Rodrigues;
+</author>
+</authorgroup>
+</chapterinfo>
+
+
+<title>The Panel and the Desktop</title>
+
+<sect1 id="kicker-panel">
+<title>&kicker;, the &kde; Panel</title>
+
+<indexterm
+significance="preferred"><primary>Panel</primary></indexterm>
+<indexterm
+significance="preferred"><primary>&kicker;</primary></indexterm>
+
+<para>&kicker; is the application launcher panel of the K Desktop
+Environment.  By default, it appears along the bottom of the screen,
+and takes up the whole of the width of the screen, but this is
+configurable. &kicker; is something of a one-stop shop for (almost!)
+everything that you might want quick access to. Besides the &kicon;
+Menu, where you can start applications, &kicker; is also capable of
+running docked applets like the pager, the taskbar or the clock, and
+extensions, such as child panels. With all these options, you will
+probably want to configure &kicker; so that it works best for you. The
+next section describes some common ways to customize the panel.</para>
+<!-- TODO: steal screenies from kicker manual -->
+</sect1>
+
+<!-- FIXME: Titles and id's  in this section should be more consistent -->
+<sect1 id="kicker-configuring">
+<title>Configuring &kicker;</title>
+
+
+<sect2 id="customize-panel-icons">
+<title>Customizing the icons on the panel</title>
+
+<para>When you first start &kde;, kicker displays some icons next to
+the <guimenu>K</guimenu> menu. These can be used to start the
+applications that they represent. To see which application is launched
+ by each icon, hold the mouse cursor over the icon until a tooltip (a
+small popup label) appears telling you the name of the application.</para>
+
+<para>These default icons might not represent the applications you use
+most often, so you can remove the ones you do not want and add icons
+for other applications that you use. To remove an icon, &RMB;-click on
+the icon, and select <guilabel>Remove <replaceable>application
+name</replaceable> Button</guilabel> in the popup menu that
+appears. To add a new icon, &RMB;-click on an empty space on the
+panel, and follow the menu entry <guisubmenu>Add Application to Panel
+</guisubmenu>. This leads you to a copy of the
+<guimenu>K</guimenu> menu, where you can find all of the &kde;
+applications. For example, to add an icon for the &juk; music player,
+follow through the menus to <menuchoice><guisubmenu>Add Application
+to Panel</guisubmenu><guisubmenu>Multimedia</guisubmenu><guimenuitem>&juk; (Music
+Player)</guimenuitem></menuchoice>. The icon will appear on the
+panel in the space that you <mousebutton>right</mousebutton>-clicked on.</para>
+
+</sect2>
+
+
+<sect2 id="adding-extras-and-applets">
+<title>Adding extras and applets</title>
+
+<indexterm><primary>Applets</primary></indexterm>
+
+<para>&kicker; can add many types of items as well as application
+launch icons. You can find these items using the same menu as before,
+but this time selecting
+<guisubmenu>Add Applet to Panel...</guisubmenu>
+or
+<guisubmenu>Add New Panel</guisubmenu>.
+The items in the <guilabel>Add Applet</guilabel> window are small
+programs that can reside on the panel. An example of an applet is the
+<guilabel>Desktop Preview &amp; Pager</guilabel><indexterm><primary>Pager</primary></indexterm>, which shows a small image of each of your virtual
+desktops. (For more information about virtual desktops, see <xref
+linkend="using-multiple-desktops" />). You can switch to a different
+virtual desktop by clicking on its image in the desktop pager. 
+<!-- TODO: screenie --></para>
+<para>You can find information about the other applets available for
+&kicker; in the &kicker; manual. Just enter
+<userinput>help:/kicker</userinput> in the
+<guilabel>Location</guilabel> bar in &konqueror;. </para>
+</sect2>
+
+<sect2 id="the-system-tray">
+<sect2info>
+<authorgroup>
+<author>
+<personname>
+<firstname>Simon</firstname>
+<surname>Vermeersch</surname>
+</personname>
+<email>[email protected]</email>
+</author>
+</authorgroup>
+</sect2info>
+
+<title>The System Tray</title>
+
+<!-- Simon Vermeersch -->
+<para>The system tray is where programs that are run, but not directly needed are
+kept. Some programs (like music players) are shown there, because you
+probably want to keep them open, but so that it does not take too much space on
+your screen, it will put an icon in the system tray.</para>
+
+<para>When you <mousebutton>right</mousebutton> click on such an icon, a
+popup menu will appear where you can see some options of the program (like
+play, pause, stop, ... in a music player).</para>
+<para>When you <mousebutton>left</mousebutton> click on it, the main window
+of the program will appear. If you hover your mouse above the icon, a tool
+tip will appear with some information (in the music player case information
+like the current song). Programs that normally support system tray icons are
+music players, IRC clients, organizers, ...</para>
+
+<para>In most of these programs you can configure if you want an icon to be
+shown or not. For other tricks and tips with the system tray see the section on <xref linkend="system-tray" />.</para>
+
+</sect2>
+
+<sect2 id="removing-panel-items">
+<title>Removing Panel Items</title>
+
+<!-- TODO: Need a screenie to show the handles, since they're not very -->
+<!-- easy to describe (and also very small - possible -->
+<!-- accessibility/usability issue? -->
+<para>You can remove applets and other special items from the panel
+using the arrow on its handle on the applet's left. Right click on the
+arrow, and choose <guimenuitem>Remove <replaceable>applet
+name</replaceable></guimenuitem>.</para>
+</sect2>
+
+</sect1>
+
+<sect1 id="kicker-taskbar">
+<title>The Taskbar</title>
+<!-- TODO: Screenie (again), write more about why taskbar is useful -->
+<para>The taskbar is an item on the panel which displays an entry for
+each window that you have opened. You can use the taskbar to switch
+between windows by clicking on the entry of the window you want to
+activate. The taskbar has entries for windows on each virtual desktop,
+including windows which have been minimized.</para>
+
+</sect1>
+
+<sect1 id="using-the-clipboard">
+<sect1info>
+<authorgroup>
+<author>&Philip.Rodrigues;
+</author>
+</authorgroup>
+</sect1info>
+
+<title>Using the Clipboard</title>
+
+<indexterm><primary>Clipboard</primary></indexterm>
+
+<para>Very often, it's useful to move some text, or an object in a
+program, from one place to another. It's also very common to need to
+duplicate some text, for example, if you're typing the same thing
+several times. The system used for doing this is known as the
+<firstterm>clipboard</firstterm>. There are two slightly different ways to use this system,
+known technically as the <quote>selection</quote> and the
+<quote><glossterm>clipboard</glossterm></quote>. We'll look at them separately:
+</para>
+
+<!-- TODO: Describe how to select text -->
+
+<sect2 id="the-selection">
+<title>The Selection</title>
+<indexterm><primary>Selection</primary></indexterm>
+
+<para>This method uses the mouse to copy text from one place to
+another. The method is:
+<orderedlist>
+
+<listitem><para>Select the text you want to copy.</para>
+</listitem>
+
+<listitem><para>Click the &MMB; at the place you want the text to be
+copied to. This can be in the same program as you copied the text
+from, or in another program entirely.</para>
+</listitem>
+</orderedlist>
+If you have three buttons on your mouse, this is easy, but if not, all
+is not lost! If you have only two buttons, try clicking them both at
+the same time instead of the &MMB;. 
+<!-- Should we mention Emulate3Buttons in XF86Config here? -->
+</para>
+</sect2>
+
+<sect2 id="the-clipboard-proper">
+<title>The Clipboard</title>
+<indexterm><primary>Cut</primary></indexterm>
+<indexterm><primary>Paste</primary></indexterm>
+<para>With this method, you can copy text, or <quote>cut</quote> it
+(that is, remove it from one place and move it to another). You can
+use either the mouse and the menu entries, or the keyboard with this
+method. I'll list both ways, with the menu entry to use, followed by
+the keyboard shortcut which will do the same thing, like this:</para>
+<para>
+<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap>
+</keycombo>
+</shortcut><guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem>
+</menuchoice> </para>
+<para>
+<orderedlist>
+<title>Moving (<quote>Cutting</quote>) Text</title>
+<listitem><para>Select the text you want to cut.</para>
+</listitem>
+<listitem><para>From the menu, select
+<menuchoice><shortcut><keycombo
+                      action="simul">&Ctrl;<keycap>X</keycap>
+</keycombo>
+</shortcut><guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem>
+</menuchoice>, and the text will be removed from its current location.</para>
+</listitem>
+<listitem><para>Position the text cursor at the point you want to
+insert the text. This can be in the same application you got the text
+from, or another application entirely. Select
+<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap>
+</keycombo>
+</shortcut><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem>
+</menuchoice>, and the text will appear at the point where you placed
+the cursor.</para>
+</listitem>
+</orderedlist>
+</para>
+
+<para>
+Copying text from one place to another is very similar:
+<orderedlist>
+<title>Copying Text</title>
+<listitem><para>Select the text you want to copy.</para>
+</listitem>
+<listitem><para>From the menu, select
+<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap>
+</keycombo>
+</shortcut><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem>
+</menuchoice>, and the text will be copied in the clipboard.</para>
+</listitem>
+<listitem><para>Position the text cursor at the point you want to
+insert the text. This can be in the same application you got the text
+from, or another application entirely. Select
+<menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap>
+</keycombo>
+</shortcut><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem>
+</menuchoice></para>
+</listitem>
+</orderedlist>
+</para>
+
+
+</sect2>
+<sect2 id="klipper">
+<title>More Advanced Clipboard Use</title>
+<indexterm><primary>&klipper;</primary></indexterm>
+<indexterm><primary>Clipboard</primary><secondary>History</secondary></indexterm>
+<!-- Should we describe this advanced use, or just point to it? -->
+<para>The instructions above describe the default <glossterm>clipboard</glossterm>
+behavior. The &klipper; application, which you can add as an applet in
+the panel (see <xref linkend="kicker-configuring"/> for instructions
+on how to do this), provides some useful clipboard-related features,
+like a clipboard history, and the ability to change the behavior of
+the clipboard and selection. Take a look at the &klipper; Handbook for
+more information.</para>
+
+<!-- Add links to "further reading" here -->
+<itemizedlist>
+<title>Related Information</title> 
+
+<listitem><para>You can find more information about &kicker;, the
+&kde; Panel, in &khelpcenter; or by entering
+<userinput>help:/kicker</userinput> in &konqueror;'s
+<guilabel>Location</guilabel> bar.</para>
+</listitem>
+
+<listitem><para>The &klipper;
+Handbook has information about the advanced clipboard management
+features in &kde;. You can read it in &khelpcenter; or by entering
+<userinput>help:/klipper</userinput> in &konqueror;'s
+<guilabel>Location</guilabel> bar.</para>
+</listitem>
+
+</itemizedlist>
+
+
+</sect2>
+
+</sect1>
+
+<sect1 id="kicker-related-information">
+<title>Related Information</title>
+<itemizedlist>
+<title>Related Information</title>
+<listitem><para>Though some information has been presented here, there is a lot more information on &kicker; tips, options, tricks and hacks, in the &kicker; handbook. You can access it via the &khelpcenter; or by simply entering <userinput>help:/kicker</userinput> in the &konqueror; Location toolbar.</para>
+</listitem>
+</itemizedlist>
+
+</sect1>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: xml
+sgml-omittag:nil
+sgml-shorttag:nil
+sgml-namecase-general:nil
+sgml-general-insert-case:lower
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:0
+sgml-indent-data:true
+sgml-parent-document:("index.docbook" "book" "sect1")
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->