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/kdeutils@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

10 files changed, 400 insertions, 0 deletions

diff --git a/doc/kwallet/Makefile.am b/doc/kwallet/Makefile.am
new file mode 100644
index 0000000..085981d
--- /dev/null
+++ b/doc/kwallet/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kwallet/cr22-action-wallet_closed.png b/doc/kwallet/cr22-action-wallet_closed.png
new file mode 100644
index 0000000..57558ac
--- /dev/null
+++ b/doc/kwallet/cr22-action-wallet_closed.png
diff --git a/doc/kwallet/cr22-action-wallet_open.png b/doc/kwallet/cr22-action-wallet_open.png
new file mode 100644
index 0000000..55a447f
--- /dev/null
+++ b/doc/kwallet/cr22-action-wallet_open.png
diff --git a/doc/kwallet/edit1.png b/doc/kwallet/edit1.png
new file mode 100644
index 0000000..1d0fe7c
--- /dev/null
+++ b/doc/kwallet/edit1.png
diff --git a/doc/kwallet/edit2.png b/doc/kwallet/edit2.png
new file mode 100644
index 0000000..05b6dd8
--- /dev/null
+++ b/doc/kwallet/edit2.png
diff --git a/doc/kwallet/edit3.png b/doc/kwallet/edit3.png
new file mode 100644
index 0000000..9292870
--- /dev/null
+++ b/doc/kwallet/edit3.png
diff --git a/doc/kwallet/index.docbook b/doc/kwallet/index.docbook
new file mode 100644
index 0000000..34b779e
--- /dev/null
+++ b/doc/kwallet/index.docbook
@@ -0,0 +1,396 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kwallet "<application>KWallet</application>">
+  <!ENTITY kwalletmanager "<application>KWallet Manager</application>">
+  <!ENTITY package "kdeutils">
+  <!ENTITY kappname "&kwallet;">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE">
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>The &kwallet; Handbook</title>
+
+<authorgroup>
+<author>
+&George.Staikos; &George.Staikos.mail;
+</author>
+<author>
+&Lauri.Watts; &Lauri.Watts.mail;
+</author>
+<othercredit role="developer">
+<firstname>George</firstname><surname>Staikos</surname>
+<affiliation><address><email>staikos@kde.org</email></address></affiliation>
+<contrib>Developer</contrib>
+</othercredit>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2005-06-15</date>
+<releaseinfo>1.0</releaseinfo>
+
+<abstract>
+<para>
+The wallet subsytem provides a convenient and secure way to manage all your
+passwords.</para>
+
+</abstract>
+
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>Kwallet</keyword>
+<keyword>passwords</keyword>
+<keyword>forms</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>Computer users have a very large amount of data to manage, some of
+which is sensitive.  In particular, you will typically have many passwords
+to manage.  Remembering them is difficult, writing them down on paper or in
+a text file is insecure, and using tools such at PGP is tedious and
+inconvenient.</para>
+
+<para>&kwallet; saves this sensitive data for you in a strongly encrypted
+file, accessible by all applications, and protected with a master
+password that you define.</para>
+
+<tip>
+<para>&kwallet; supports multiple wallets, so 
+for the most secure operation, you should use one wallet for local
+passwords, and another for network passwords and form data.  You can
+configure this behavior in the &kwallet; &kcontrolcenter; module, however
+the default setting is to store everything in one wallet.</para>
+</tip>
+
+<para>A wallet is by default closed, which means that you must supply
+a password to open it. Once the wallet is opened, the contents can
+be accessed.</para>
+
+</chapter>
+
+<chapter id="kwalletmanager">
+<title>&kwalletmanager;</title>
+
+<para>&kwalletmanager; serves a number of functions.  Firstly it allows you to see if
+any wallets are open, which wallets those are, and which applications are
+using each wallet.  You can disconnect an application's access to a wallet
+from within the &kwalletmanager;.</para>
+
+<para>You may also manage the wallets installed on the system, creating and
+deleting wallets and manipulating their contents (changing keys, ...).</para>
+
+<para>Normally the &kwalletmanager; application is launched when
+&kde; starts and remains in iconic form in the system tray. Alternatively, 
+when a wallet is opened, the &kwalletmanager; application will be
+launched.  A system tray icon indicates that a wallet is open:
+ <mediaobject>
+   <imageobject>
+     <imagedata fileref="cr22-action-wallet_open.png"/>
+   </imageobject>
+ </mediaobject>
+
+When all
+wallets are closed, the icon will reflect this by showing a closed
+wallet:
+<mediaobject>
+ <imageobject>
+     <imagedata fileref="cr22-action-wallet_closed.png"/>
+  </imageobject>
+ </mediaobject> 
+
+</para>
+
+<para>Click once on the system tray wallet icon to display the &kwalletmanager;
+window showing all available wallets as icons which reflect their
+current status, either open or closed.</para>
+<para>
+<mediaobject>
+   <imageobject>
+     <imagedata fileref="kwalletmanager.png"/>
+   </imageobject>
+ </mediaobject></para>
+
+
+<sect1 id="kwalletmanager-context-menu">
+<title>The &kwalletmanager; Context Menu</title>
+
+<para><mousebutton>Right</mousebutton> clicking on a wallet in the
+&kwalletmanager; window offers 
+the following functions:</para>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>New Wallet...</guimenuitem></term>
+<listitem>
+<para>Create a new wallet. A dialog box will ask you
+for the name of the new wallet that you want to create.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut>&Enter;</shortcut>
+<guisubmenu>Open...</guisubmenu></menuchoice></term>
+<listitem>
+<para>Open the wallet. Opening the wallet causes the contents 
+of the wallet to be displayed in a new window where you can
+add, delete, or modify the contents of the wallet. You may also 
+double click the wallet icon to cause it to open. If the wallet
+is not already open, you will be requested to enter the password.
+See below for details of using the wallet window.
+</para>
+<para>
+<mediaobject>
+   <imageobject>
+     <imagedata fileref="edit1.png"/>
+   </imageobject>
+ </mediaobject></para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Change Password</guimenuitem></term>
+<listitem>
+<para>Change the master password for the wallet.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guisubmenu>Disconnect</guisubmenu></term>
+<listitem><para>Disconnect an application from the wallet. Currently
+connected applications will appear in a submenu.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Close</guimenuitem></term>
+<listitem><para>Force the wallet to be closed.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Delete</guimenuitem></term>
+<listitem>
+<para>Delete the wallet</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="kwalletmanager-wallet-window">
+<title>The Wallet Window</title>
+
+<para>Double clicking on a wallet in the &kwalletmanager; window will open a new
+window displaying that wallet's contents. A wallet may contain any number
+of folders, which allow storing of password information. By default a wallet
+will contain folders named Form Data and Passwords.
+</para>
+
+<para>The window has four panes:</para>
+<para>
+<mediaobject>
+   <imageobject>
+     <imagedata fileref="edit1.png"/>
+   </imageobject>
+ </mediaobject></para>
+
+
+<itemizedlist>
+<listitem><para>A summary of the contents of the current
+folder</para></listitem>
+<listitem><para>The folders contained in the wallet</para></listitem>
+<listitem><para>The entries in the currently selected
+folder</para></listitem>
+<listitem><para>The contents of the selected folder entry</para></listitem>
+</itemizedlist>
+
+<para>Folders may be added or deleted, and selecting a folder will update
+the folder entry list and the summary display.  Selecting a folder entry
+will update the entry contents pane, and allow you to edit that
+entry.</para>
+<para>
+<mediaobject>
+   <imageobject>
+     <imagedata fileref="edit2.png"/>
+   </imageobject>
+ </mediaobject></para>
+
+
+<para>Entries may also be created or deleted via the context menu for the
+folder contents.</para>
+
+<para>All folders and entries may be dragged and dropped into other wallets
+or folders respectively.  This allows a user to easily package up a new
+wallet for transfer to another environment.  For instance, a new wallet
+could be created and copied onto a removable flash memory device.  Important
+passwords could be transferred there, so you have them available in other
+locations.</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="kwallet-kcontrol-module">
+<title>Configuring &kwallet;</title>
+
+<sect1 id="wallet-preferences">
+<title><guilabel>Wallet Preferences</guilabel></title>
+
+<para>&kwallet; contains a small configuration panel with several options
+that allow you to tune &kwallet; to your personal preferences.  The
+default settings for &kwallet; are sufficient for most users.</para>
+
+<para>Check the box to enable or disable the &kde; wallet subsystem
+entirely.  If this box is unchecked, then &kwallet; is entirely disabled and
+none of the other options here have any effect, nor will &kwallet; record
+any information, or offer to fill in forms for you.</para>
+
+<variablelist>
+<title><guilabel>Close Wallet</guilabel></title>
+<varlistentry>
+<term><guilabel>Close when unused for:</guilabel></term>
+<listitem>
+<para>Close the current wallet after a period of inactivity. If you check this
+option, set the period in the box, default is 10 minutes. When a wallet is
+closed, the password is needed to access it again.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Close when screen saver starts</guilabel></term>
+<listitem>
+<para>Close the wallet as soon as the screensaver starts. When a wallet is
+closed, the password is needed to access it again.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Close when last application stops using it</guilabel></term>
+<listitem>
+<para>Close the wallet as soon as applications that use it have stopped. Note
+that your wallets will only be closed when all the applications that use it have
+stopped. When a wallet is closed, the password is needed to access it
+again.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<variablelist>
+<title><guilabel>Automatic Wallet Selection</guilabel></title>
+<varlistentry>
+<term><guilabel>Select wallet to use as default:</guilabel></term>
+<listitem>
+<para>Select which wallet you want to use as default wallet.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Different wallet for local passwords:</guilabel></term>
+<listitem>
+<para>If checked, choose a different wallet for local passwords.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<variablelist>
+<title><guilabel>Wallet Manager</guilabel></title>
+<varlistentry>
+<term><guilabel>Show manager in system tray</guilabel></term>
+<listitem>
+<para>Enable the wallet manager to have its icon in the system tray.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Hide System tray icon when last wallet
+closes</guilabel></term>
+<listitem>
+<para>When there is no wallet in use anymore, remove the wallet icon from the
+system tray.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>Finally, there is a button labelled <guibutton>Launch Wallet
+Manager</guibutton>, which does precisely that.</para>
+</sect1>
+
+<sect1 id="wallet-access-control">
+<title><guilabel>Access Control</guilabel></title>
+
+<para>There is only one option on this page:</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Prompt when an application accesses an open wallet</guilabel></term>
+<listitem>
+<para>Signal you when an application gains access to an open wallet.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>Next there is a tree style view of the access controls for your wallets.</para>
+
+<para>&LMB; click on the <guiicon>+</guiicon> symbol beside a wallet name to
+expand the tree. You will see the name of each application that has asked
+for access to the wallet, and the policy you set for it.  You cannot edit
+policies here, or add them, but it is possible to delete an entry by &RMB;
+clicking on it and choosing <guimenuitem>Delete</guimenuitem> From the
+context menu that appears, or by simply selecting it and pressing the
+<keycap>Delete</keycap> key.</para>
+
+</sect1>
+
+</chapter>
+
+<chapter id="advanced-features">
+<title>Advanced Features</title>
+
+<para>Wallets can be dragged from the &kwalletmanager; window.  This allows
+you to drag the wallet to a file browser window, where you can choose to
+copy, move, or link the wallet, as desired.</para>
+
+<para>You might use this to save a wallet to portable media, such as a
+USB keychain, so that you can take your passwords with you to work or
+on a vacation, and still have easy access to important sites.</para>
+
+<para>Future versions will have built-in functions for easy export or
+copying of data to portable devices.</para>
+
+</chapter>
+
+<chapter id="credits-and-licenses">
+<title>Credits and Licenses</title>
+
+<para>&kwallet; &copy; 2003 &George.Staikos;</para>
+<para>Documentation &copy; &Lauri.Watts; and &George.Staikos;</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
+
+</chapter>
+
+&documentation.index;
+
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+
+// vim:ts=2:sw=2:tw=78:noet
+-->
diff --git a/doc/kwallet/kwalletmanager.png b/doc/kwallet/kwalletmanager.png
new file mode 100644
index 0000000..67c7220
--- /dev/null
+++ b/doc/kwallet/kwalletmanager.png
diff --git a/doc/kwallet/password1.png b/doc/kwallet/password1.png
new file mode 100644
index 0000000..d5cb22a
--- /dev/null
+++ b/doc/kwallet/password1.png
diff --git a/doc/kwallet/password2.png b/doc/kwallet/password2.png
new file mode 100644
index 0000000..c116e93
--- /dev/null
+++ b/doc/kwallet/password2.png