~ubuntu-branches/ubuntu/utopic/kde-workspace/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/systemsettings/index.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Michał Zając
  • Date: 2011-07-09 08:31:15 UTC
  • Revision ID: james.westby@ubuntu.com-20110709083115-ohyxn6z93mily9fc
Tags: upstream-4.6.90
Import upstream version 4.6.90

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" ?>
 
2
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 
3
  <!ENTITY kappname "&systemsettings;">
 
4
  <!ENTITY package "kdebase-workspace">
 
5
  <!ENTITY % addindex "IGNORE">
 
6
  <!ENTITY % English "INCLUDE">
 
7
]>
 
8
<book lang="&language;">
 
9
 
 
10
<bookinfo>
 
11
<title>The &systemsettings; Handbook</title>
 
12
 
 
13
<authorgroup>
 
14
<author>
 
15
&Richard.Johnson;
 
16
&Richard.Johnson.mail;
 
17
</author>
 
18
<!-- TRANS:ROLES_OF_TRANSLATORS -->
 
19
</authorgroup>
 
20
 
 
21
<copyright>
 
22
<year>2007</year>
 
23
<holder>&Richard.Johnson;</holder>
 
24
</copyright>
 
25
<legalnotice>&FDLNotice;</legalnotice>
 
26
 
 
27
<date>2010-10-05</date>
 
28
<releaseinfo>1.0 (&kde; 4.6)</releaseinfo>
 
29
 
 
30
<abstract>
 
31
<para>
 
32
This documentation describes &kde;&apos;s system configuration and administration center.
 
33
</para>
 
34
</abstract>
 
35
 
 
36
<keywordset>
 
37
<keyword>KDE</keyword>
 
38
<keyword>System</keyword>
 
39
<keyword>Settings</keyword>
 
40
<keyword>configuration</keyword>
 
41
<keyword>administration</keyword>
 
42
<keyword>config</keyword>
 
43
<keyword>admin</keyword>
 
44
</keywordset>
 
45
 
 
46
</bookinfo>
 
47
 
 
48
<chapter id="introduction">
 
49
<title>Introduction</title>
 
50
 
 
51
<para>
 
52
The &kde; &systemsettings; provides the user with a centralized and convenient way to configure all of the &kde; settings.
 
53
</para>
 
54
 
 
55
<para>
 
56
&systemsettings; is made up of multiple modules. Each module is a separate application, however the &kde; &systemsettings; organizes all of these applications into a single location.
 
57
</para>
 
58
 
 
59
<tip>
 
60
<para>
 
61
Each &systemsettings; module can be executed individually
 
62
</para>
 
63
<para>
 
64
See section entitled <link linkend="run-modules-individually">Running
 
65
individual &systemsettings; modules</link> for more information.
 
66
</para>
 
67
</tip>
 
68
 
 
69
<para>
 
70
&systemsettings; groups all of the configuration modules into several categories:
 
71
<itemizedlist>
 
72
<listitem><para><link linkend="application-appearance">Common Appearance and Behavior</link></para></listitem>
 
73
<listitem><para><link linkend="workspace-appearance">Workspace Appearance and Behavior</link></para></listitem>
 
74
<listitem><para><link linkend="network">Network and Connectivity</link></para></listitem>
 
75
<listitem><para><link linkend="hardware">Hardware</link></para></listitem>
 
76
<listitem><para><link linkend="system-administration">System Administration</link></para></listitem>
 
77
</itemizedlist>
 
78
</para>
 
79
 
 
80
<para>
 
81
The modules that make up &systemsettings; fall under one of the above categories, making it easier to locate the correct configuration module.
 
82
</para>
 
83
 
 
84
</chapter>
 
85
 
 
86
<chapter id="using-kapp">
 
87
<title>Using &systemsettings;</title>
 
88
 
 
89
<para>
 
90
This section details the use of &systemsettings; itself. For information on each individual module, please see <link linkend="modules">&systemsettings; Modules</link>.
 
91
</para>
 
92
 
 
93
<sect1 id="starting">
 
94
<title>Starting &systemsettings;</title>
 
95
 
 
96
<para>
 
97
The &kde; &systemsettings; can be started in one of three ways:
 
98
</para>
 
99
 
 
100
<orderedlist>
 
101
<listitem>
 
102
<para>
 
103
By selecting <menuchoice><guimenu>K Button</guimenu><guisubmenu>Applications</guisubmenu><guimenuitem>System Settings</guimenuitem></menuchoice>.
 
104
</para>
 
105
</listitem>
 
106
<listitem>
 
107
<para>
 
108
  By pressing <keycombo>&Alt;<keycap>F2</keycap></keycombo>. This will bring up the &krunner; dialog. Type <command>systemsettings</command>, and press &Enter;.
 
109
</para>
 
110
</listitem>
 
111
<listitem>
 
112
<para>
 
113
Type <command>systemsettings &amp;</command> at any command prompt.
 
114
</para>
 
115
</listitem>
 
116
</orderedlist>
 
117
 
 
118
<para>
 
119
All three of these methods are equivalent, and produce the same result.
 
120
</para>
 
121
</sect1>
 
122
 
 
123
<sect1 id="screen">
 
124
<title>The &kde; &systemsettings; Screen</title>
 
125
 
 
126
<para>
 
127
When you start &systemsettings;, you are presented with a window, which is divided into three functional parts.
 
128
</para>
 
129
 
 
130
<para>
 
131
Across the top is a toolbar. The toolbar provides the user with the ability to go back into the main view from within a module using the <guibutton>Overview</guibutton>.
 
132
You can also find a <guimenu>Help</guimenu> menu as well as a <guibutton>Configure</guibutton> button which provides you a dialog with alternate view settings.
 
133
</para>
 
134
<para>To search for something within all of the modules, start to type keywords into the search field at the right of the toolbar in the <guibutton>Overview</guibutton>. When you start typing, a list of matching topics will popup. Select one and only the groups with settings for this  keyword are enabled, the other are greyed out.</para>
 
135
 
 
136
<para>
 
137
Underneath the toolbar is an icon view of the individual modules that 
 
138
make up &systemsettings; grouped by different categories. By default, 
 
139
if your mouse stays a few seconds over an icon, a detailed tooltip 
 
140
appears, explaining the purpose of the module.
 
141
</para>
 
142
</sect1>
 
143
 
 
144
<sect1 id="general">
 
145
<title>&systemsettings; Categories and Modules</title>
 
146
<para>A brief overview of all categories and their modules:</para>
 
147
 
 
148
<variablelist>
 
149
<varlistentry id="application-appearance" >
 
150
<term>Common Appearance and Behavior</term>
 
151
<listitem>
 
152
<para><itemizedlist>
 
153
<listitem><para>
 
154
Account Details (Password &amp; User Account, Paths, KDE Wallet, Social Desktop, Web Shortcuts)
 
155
</para></listitem>
 
156
<listitem><para>
 
157
Application Appearance (Style, Colors, Icons, Fonts, Emoticons)
 
158
</para></listitem>
 
159
<listitem><para>
 
160
Application and System Notifications (Manage Notifications, System Bell, Launch Feedback)
 
161
</para></listitem>
 
162
<listitem><para>
 
163
File Associations
 
164
</para></listitem>
 
165
<listitem><para>
 
166
Locale (Country/Region &amp; Language, Spell Checker)
 
167
</para></listitem>
 
168
<listitem><para>
 
169
Personal Information (Akonadi Resources Configuration, KDE Resources)
 
170
</para></listitem>
 
171
<listitem><para>
 
172
Shortcuts and Gestures (Custom Shortcuts, Standard Keyboard Shortcuts, Global Keyboard Shortcuts)
 
173
</para></listitem>
 
174
</itemizedlist>
 
175
</para>
 
176
</listitem>
 
177
</varlistentry>
 
178
 
 
179
<varlistentry id="workspace-appearance" >
 
180
<term>Workspace Appearance and Behavior</term>
 
181
<listitem>
 
182
<para><itemizedlist>
 
183
<listitem><para>
 
184
Desktop Effects
 
185
</para></listitem>
 
186
<listitem><para>
 
187
Workspace Appearance (Window Decorations, Cursor Theme, Desktop Theme, Splash Screen)
 
188
</para></listitem>
 
189
<listitem><para>
 
190
Accessibility (Accessibility, Text-to-Speech)
 
191
</para></listitem>
 
192
<listitem><para>
 
193
Default Applications
 
194
</para></listitem>
 
195
<listitem><para>
 
196
Desktop Search
 
197
</para></listitem>
 
198
<listitem><para>
 
199
Window Behavior (Task Switcher, Window Behavior, Window Rules)
 
200
</para></listitem>
 
201
<listitem><para>
 
202
Workspace Behavior (Virtual Desktops, Screen Edges, Workspace)
 
203
</para></listitem>
 
204
</itemizedlist>
 
205
</para>
 
206
</listitem>
 
207
</varlistentry>
 
208
 
 
209
<varlistentry id="network" >
 
210
<term>Network and Connectivity</term>
 
211
<listitem>
 
212
<para><itemizedlist>
 
213
<listitem><para>
 
214
Network Settings (Proxy, Connection Preferences, Service Discovery)
 
215
</para></listitem>
 
216
<listitem><para>
 
217
Sharing (Windows Shares, Samba)
 
218
</para></listitem>
 
219
</itemizedlist>
 
220
</para>
 
221
</listitem>
 
222
</varlistentry>
 
223
 
 
224
<varlistentry id="hardware" >
 
225
<term>Hardware</term>
 
226
<listitem>
 
227
<para><itemizedlist>
 
228
<listitem><para>
 
229
Printer Configuration
 
230
</para></listitem>
 
231
<listitem><para>
 
232
Device Actions
 
233
</para></listitem>
 
234
<listitem><para>
 
235
Digital Camera
 
236
</para></listitem>
 
237
<listitem><para>
 
238
Display and Monitor (Size &amp; Orientation, Screen Saver, Gamma, Multiple Monitors)
 
239
</para></listitem>
 
240
<listitem><para>
 
241
Information Sources
 
242
</para></listitem>
 
243
<listitem><para>
 
244
Input Devices (Keyboard, Mouse, Joystick, Remote Controls)
 
245
</para></listitem>
 
246
<listitem><para>
 
247
Power Management
 
248
</para></listitem>
 
249
<listitem><para>
 
250
Removable Devices
 
251
</para></listitem>
 
252
<listitem><para>
 
253
Multimedia (Audio CDs, CDDB Retrieval, Phonon)
 
254
</para></listitem>
 
255
</itemizedlist>
 
256
</para>
 
257
</listitem>
 
258
</varlistentry>
 
259
 
 
260
<varlistentry id="system-administration" >
 
261
<term>System Administration</term>
 
262
<listitem>
 
263
<para><itemizedlist>
 
264
<listitem><para>
 
265
Date &amp; Time
 
266
</para></listitem>
 
267
<listitem><para>
 
268
Font Installer
 
269
</para></listitem>
 
270
<listitem><para>
 
271
Login Screen
 
272
</para></listitem>
 
273
<listitem><para>
 
274
Permissions (PolicyKit Authorization)
 
275
</para></listitem>
 
276
<listitem><para>
 
277
Startup and Shutdown (Autostart, Service Manager, Session Management)
 
278
</para></listitem>
 
279
<listitem><para>
 
280
Task Scheduler
 
281
</para></listitem>
 
282
</itemizedlist>
 
283
</para>
 
284
</listitem>
 
285
</varlistentry>
 
286
 
 
287
</variablelist>
 
288
 
 
289
<tip><para>Use the search field in <guibutton>Overview</guibutton> to find all matching modules for a given keyword.</para></tip>
 
290
</sect1>
 
291
<sect1 id="exiting">
 
292
<title>Exiting the &kde; &systemsettings;</title>
 
293
 
 
294
<para>
 
295
&systemsettings; can be exited in one of two ways:
 
296
</para>
 
297
 
 
298
<orderedlist>
 
299
<listitem>
 
300
<para>
 
301
Press <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> on the keyboard.
 
302
</para>
 
303
</listitem>
 
304
<listitem>
 
305
<para>
 
306
Click on the <guibutton>Close</guibutton> button located in the toolbar.
 
307
</para>
 
308
</listitem>
 
309
</orderedlist>
 
310
</sect1>
 
311
 
 
312
<sect1 id="configuring">
 
313
<title>Configuring &systemsettings;</title>
 
314
 
 
315
<para>
 
316
The <guiicon>Configure</guiicon> icon in the toolbar allows you to change some &systemsettings; parameters.
 
317
You can change from <guilabel>Icon View</guilabel> (default view) to <guilabel>Classic Tree View</guilabel>.
 
318
</para>
 
319
 
 
320
<para>
 
321
You can also turn off the detailed tooltips by unchecking <guilabel>Show detailed tooltips</guilabel>. 
 
322
You will then get only normal tooltips.
 
323
</para>
 
324
</sect1>
 
325
 
 
326
<sect1 id="run-modules-individually">
 
327
<title>Running Individual &systemsettings; Modules</title>
 
328
 
 
329
<para>
 
330
Individual modules can be run without running &systemsettings; using the command <command>kcmshell4</command> from the command line. Type <command>kcmshell4 --list</command> to see a list of the available &kde; &systemsettings; modules.
 
331
</para>
 
332
</sect1>
 
333
</chapter>
 
334
 
 
335
<chapter id="modules">
 
336
<title>The &kde; &systemsettings; Modules</title>
 
337
 
 
338
<para>
 
339
In order to make it as easy as possible, the &kde; &systemsettings; has organized options into five categories. Under each category, there are icons grouped together under subcategories. Each icon is called a module. When you click on a module icon, you will be presented with the options of the module in the main window.
 
340
</para>
 
341
 
 
342
<para>
 
343
Each module will have some or all of the following buttons:
 
344
</para>
 
345
 
 
346
<variablelist>
 
347
<varlistentry>
 
348
<term>Help</term>
 
349
<listitem>
 
350
<para>
 
351
This button will provide help specific to the current module. Clicking the button will open &khelpcenter; in a new window providing detailed information on the module.
 
352
</para>
 
353
</listitem>
 
354
</varlistentry>
 
355
 
 
356
<varlistentry>
 
357
<term>Defaults</term>
 
358
<listitem>
 
359
<para>
 
360
Clicking this button will restore this module to its default values. You must click <guibutton>Apply</guibutton> to save the options.
 
361
</para>
 
362
</listitem>
 
363
</varlistentry>
 
364
 
 
365
<varlistentry>
 
366
<term>Reset</term>
 
367
<listitem>
 
368
<para>
 
369
This button will &quot;Reset&quot; the module to the previous settings.
 
370
</para>
 
371
</listitem>
 
372
</varlistentry>
 
373
 
 
374
<varlistentry>
 
375
<term>Apply</term>
 
376
<listitem>
 
377
<para>
 
378
Clicking this button will save all changes to &kde;. If you have changed anything, clicking <guibutton>Apply</guibutton> will cause the changes to take effect.
 
379
</para>
 
380
</listitem>
 
381
</varlistentry>
 
382
</variablelist>
 
383
 
 
384
<note>
 
385
<para>
 
386
You must either &quot;Reset&quot; or &quot;Apply&quot; the any changes before changing to another module.
 
387
</para>
 
388
<para>
 
389
If you try to change without saving or resetting your options, you will be asked if you want to save your changes, or discard them.
 
390
</para>
 
391
</note>
 
392
 
 
393
</chapter>
 
394
 
 
395
<chapter id="credits">
 
396
 
 
397
<title>Credits and License</title>
 
398
 
 
399
<para>
 
400
&systemsettings;
 
401
</para>
 
402
<para>
 
403
Program copyright 2007 Benjamin C. Meyer.
 
404
</para>
 
405
<para>
 
406
Contributors:
 
407
<itemizedlist>
 
408
<listitem>
 
409
<para>
 
410
Will Stephenson <email>wstepheson@kde.org</email>
 
411
</para>
 
412
</listitem>
 
413
<listitem>
 
414
<para>Michael D. Stemle, Jr. <email>manchicken@notsosoft.net</email>
 
415
</para>
 
416
</listitem>
 
417
<listitem>
 
418
<para>
 
419
Matthias Kretz <email>kretz@kde.org</email>
 
420
</para>
 
421
</listitem>
 
422
<listitem>
 
423
<para>
 
424
&Daniel.Molkentin; &Daniel.Molkentin.mail;
 
425
</para>
 
426
</listitem>
 
427
<listitem>
 
428
<para>
 
429
&Matthias.Elter; &Matthias.Elter.mail;
 
430
</para>
 
431
</listitem>
 
432
<listitem>
 
433
<para>
 
434
Frans Englich <email>englich@kde.org</email>
 
435
</para>
 
436
</listitem>
 
437
<listitem>
 
438
<para>
 
439
Michael Jansen <email>kde@michael-jansen.biz</email>
 
440
</para>
 
441
</listitem>
 
442
</itemizedlist>
 
443
</para>
 
444
 
 
445
<para>
 
446
Documentation Copyright &copy; 2008 &Richard.Johnson; &Richard.Johnson.mail;
 
447
</para>
 
448
 
 
449
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 
450
 
 
451
&underFDL;
 
452
&underGPL;
 
453
</chapter>
 
454
 
 
455
&documentation.index;
 
456
</book>
 
457
 
 
458
<!--
 
459
Local Variables:
 
460
mode: xml
 
461
sgml-minimize-attributes:nil
 
462
sgml-general-insert-case:lower
 
463
sgml-indent-step:0
 
464
sgml-indent-data:nil
 
465
End:
 
466
 
 
467
vim:tabstop=2:shiftwidth=2:expandtab
 
468
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
 
469
-->