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, 230 insertions, 0 deletions

diff --git a/kpersonalizer/README b/kpersonalizer/README
new file mode 100644
index 000000000..96224a955
--- /dev/null
+++ b/kpersonalizer/README
@@ -0,0 +1,230 @@
+KPersonalizer - Whitepaper
+===================
+
+Questions & Answers:
+
+Torsten Rahn <torsten@kde.org>
+Carsten Wolff <wolff@kde.org>
+Ralf Nolden <nolden@kde.org>
+Daniel Molkentin <danimo@kde.org>
+
+
+Aim:
+-----
+When the user starts KDE for the very first time the very first impression is
+ critical and will decide whether the user likes or dislikes KDE. While this
+ might not sound very"fair" or "logical" it's the way people think and perceive
+ their environment.
+
+The aim of KPersonalizer is to provide the pleasant look & feel the user expects
+ on the very first startup. To determine which look and feel the user prefers he
+ is guided through a minimal set of steps.
+
+What Kpersonalizer is _not_ about:
+--------------------------------------------
+
+Kpersonalizer is not a wizard which configures your hardware, mount-points or
+any other distribution-related stuff. KPersonalizer is only meant to deal with
+the Look & Feel KDE provides. As soon as we would touch distribution-related
+stuff we risk that distributions might disable KPersonalizer. To encourage
+distributions to make use of it it should easily be possible to extend or change
+the behaviour of KPersonalizer.
+
+KPersonalizer is not meant to be part of KControl
+KControl is rather a graphical registry where you can change every little
+detail in a hierarchically arranged order. One really has to know about the
+details when changing stuff and one only changes things one by one.
+KPersonalizer on the other hand asks the user very basic questions
+that don't require much background-knowledge and tries to guess a set
+of configuration-settings which fit the users needs best.
+
+Layout: KPersonalizer consists of a window which is not set fullscreen.
+This has the advantage that the user sees on the fly which settings he has
+changed and can step back as he sees that something doesn't fit.
+On the left of each dialog there is a decorative 170x430-pixel-bitmap which
+sort of describes the step in a graphical manner.
+
+Step 1:
+=====
+Introduction:
+The Introduction should give the user a warm welcome. It should explain
+what KPersonalizer will do during the next step and that the user will be able
+to refine the settings  afterwards in the last step using kcontrol.
+
+Most distributions I am aware of generally set one language for all users as a
+first default. In certain situations the user might not speak the language
+of the default installation which was done by the Sysadmin.
+Therefore it makes sense to prompt the user for "his" country.
+Judging from the country Kpersonalizer will make all settings according to that
+country (language, currency, etc.).
+As distributions might take care of this step it should stay easy to disable
+that part of the dialog.
+
+Step 2:
+=====
+Here the user is asked for the way his computer should act like in the future.
+Once again this step only deals with the way the computer works - not with the
+look.
+
+Depending on the radiobutton which is enabled you get a description which
+lists the feautres of each setting:
+
+KDE (default):
+
+The default-setting which you would get if you would disable
+KPersonalizer.
+
+Microsoft Windows (TM):
+
+- Double Click
+- Busy Cursor
+- Windows keyboard scheme
+- use 2 clipboards for c&p (keyboard/mouse) (default)
+- Window-Behavior -> Focus on click
+- Titlebar doubleclick -> Maximize
+- WindowList-menu on MMB
+- Walk trough windows mode: KDE
+- NOT underline IconText
+- NOT change pointer shape over an icon
+
+UNIX (TM):
+- Single Click
+- No busy-cursor
+- UNIX -keyboard-scheme.
+- synchronize clipboards
+- Window-Behavior -> Focus follows mouse
+- Titlebar doubleclick -> Shade
+- Application-menu on MMB like in FVWM
+- Walk trough windows mode: CDE
+- NOT underline IconText
+- NOT change pointer shape over an icon
+
+MacOS:
+- Single Click
+- No Busy Cursor
+- Mac- Keyboard-Scheme
+- use 2 clipboards for c&p (keyboard/mouse) (default)
+- Window-Behavior -> Focus on click
+- Titlebar doubleclick -> Shade (for now. MacOS X has Minimize but this isn't offered by kwin yet)
+- Menubar on top
+- WindowList-menu on MMB
+- Walk trough windows mode: KDE
+- NOT underline IconText
+- change pointer shape over an icon
+
+Step 3: Eyecandy-O-Meter
+===================
+The most prominent part the user should see is a big slider. Using this slider
+he can easily choose the level of eyecandy. Some people prefer to have a Fast &
+Lean environment with small desktop-items and other prefer a Big, Beautiful and
+resource-wasting behaviour.
+
+To give the advanced user still some control over what is being changed all
+items affected are being displayed in a small listview below. In front of each
+listview-item there is a checkbox.
+These items are being checked or unchecked depending on the position of the
+slider. "Big & Beautiful" means that all items are checked, Fast and Lean means
+that all items are unchecked.
+As soon as the user touches the checkbox of one of the items directly the
+state of that particular checkbox is not being changed by the position of the
+slider anymore. Pressing a "Reset"-button will put all items back into the
+position/state where the dialog started from.
+
+Features which are affected by the slider are being mentioned in the
+following list of Levels:
+
+
+Level 0 (No Eyecandy):
+
+- No animations, no eyecandy, nothing :)
+
+Level 1:
+
+- Show Wallpaper
+- Animate Shading, Minimize & Restore (window effects)
+- Display content in moving/resizing windows
+
+Level 2:
+
+- Show Konqueror/Kicker-backgrounds
+
+Level 3:
+
+- Show Iconeffects (Highlightning)
+- Icon Zooming (ONLY MAC)
+
+Level 4 (Default for slow machines):
+
+- Icon Animations (mng)
+- Desktop-Iconsize = 48 (if  Resolution >= 1024x768) (ONLY MAC/CDE)
+- Panel- Iconsize = 56  (if Resolution >= 1280x1024) (ONLY MAC/CDE)
+
+Level 5:
+
+- Enable Image-Previews
+
+Level 6:
+
+- Enable Animated Combo boxes
+
+Level 7 (default for fast machines): 
+
+- Enable Antialiased Fonts
+- Enable Fade tool tips
+- Enable Fade menus
+
+Level 8: 
+
+- Enable Text-Previews
+- Icon Zooming (ALL SELECTIONS)
+- Desktop-Iconsize = 48 (if  Resolution >= 1024x768) (ALL SELECTIONS)
+- Panel- Iconsize = 56  (if Resolution >= 1280x1024) (ALL SELECTIONS)
+
+Level 9 (Maximum Eyecandy):
+
+- Enable Icons on PushButtons
+- Enable all kinds of File-Previews
+- Enable Sound
+
+(The number of events which offer a sound corresponds  directly to the
+"eyecandy-level".)
+
+Idea for the future: The default-position of the slider might depend on the
+measured performance/resources of the computer.
+
+Step 4: Theme-Selection
+=================
+The user can choose from 4-5 themes each of them representing a look and feel
+which is very different from each other and might correspond with the choice
+made in Step 2 a bit :-)
+Basically this changes Icons, the widgetstyle, the WM-decoration, the
+Colourscheme, tiles and Wallpapers.
+
+There is a preview for each theme.
+
+Step 5: Refinement
+==============
+The user is told how he can start KPersonalizer again if the user changes his
+mind on a certain setting later and the advanced user may launch kcontrol to
+refine certain settings.
+
+
+EOF
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+