# KDE System Settings

This document describes how the System Settings is layed out.

This document was inspired partially by the TODO file located at kdebase/kcontrol/TODO. Most of the changed are the exact same and were planned to be done for KDE4. This document is simply a little bit more fleshed out version. I recomend checking out that document if you havn't already.

The reason for this document is:

1) To categorize the settings together in a user friendly manor.
2) To explain why a setting is where it is and to determine where new settings should go.
3) Because of #2 stop the constant reorganization of KControl at every release confusing users and developers because there isn't a documented location for where thing go with explanations of why.

The System Settings Center is divided into four sections.

- Personal
- Hardware
- System
- Other

Within KDE there are over 50 kcm modules designed for the Control Center and many more for konquror and other applications. With so many modules there is no way for a users to find what they are looking for by scanning. To solve this there are three levels, the last one isn't normally visable to the user and groups very similar items.

Modules in the System Settings should configure things not do things. Some examples include the theme manager. It sets/saves themes. Although it configures settings it is a seperate application because it does actions rather then just setting/getting values. Items that

Modules that exists within multiple applications configuration menu such as spell check and cddb should not be in the menu.

# Personal

Personal is made up of two parts. The simplest differece between the two are theme settings will be shared amung friends while users settings wont be.

- Theme Goodies
- User Settings

### Theme Goodies

which can be changed without affecting productivity and often doesn't directly apply to a specific user, but to a user base (Theme of the month crowd). These deal with how applications are presented to users and how users interact with them. These don't deal with anything that isn't directly seen/heard or interacted with.

Every setting in this category must be able to be locked for example in an government enviornment where they determine exactly how a desktop is to look for every user. It may look ugly, but users should still be able to acomplish tasks no matter what these settings are set to.

A separate application (Theme Manager) can set the items in this category on mass to give an overall theme for the user. This application can also save the current settings.

### User Settings

Such as that apply to this computer such as language and personal choice for default web browser. These settings determine how a user interacts with a computer, but is personal to that user and typically isn't shared like a theme or icons set is.

## Appearance

The Appearance deals with the look of the applications and desktop. These settings typically will be settings that can be replaced by alternatives created outside of KDE. These settings will most likely be also set/used by other Unix desktop enviornments so that all the applications can integration together (and look consistant to the user). It contains the following items:
Colors, Fonts, Icons, Style, Window Decorations

## Desktop

These items discus how the desktop behaves. How the windows interact with each other, the very bottom of the screen (desktop), the very top (screensaver), and loading of the desktop. These are all separate setting from KDE (or Gnome) applications and the applications shouldn't need to access them or know about them. It contains the following items:
Background, Screensaver, Behavior, Window Behavior, Window-Specific Settings, Login Screen

Panel. These settings all deal with when users perform actions dealing with or originating from the panel. It contains the following items:
Panels, Taskbar, Launch Feedback, Multiple Desktops

## KDE Components

Specific actuall KDE components which users will probably never actually touch.

## Accessibility

- International - KHotKeys etc

## Security

-kdewallet

## Sound

Sounds, flashes, logs or other events that happen when KDE applications. System Bell System Notifications

## User Account

- Password changer, paths, Default Applications, Session Manager

# Hardware

Hardware deals with physical hardware configuration. Configuration is not only for the hardware, but the required supporting systems that use the hardware.

## Network

File Sharing Local Network Browsing Preferences / Proxy Wireless Firewall

## Display

It contains the following items:
Size & Orientation, Gamma

## Power

Display power control laptop battery, cpu temp etc

## Keyboard & Mouse

Keyboard, Keyboard Layout, Keyboard Shortcuts, Mouse, KHotKeys

## Printer

## Joystick

## Audio

Mixer, SoundSystem (arts)

# System

System deals with settings relating to this computer.

## Date & Time

Date, Time, Time zone

## Fonts

## Book Disk

Lilo, Grub

## Packages

System update / rpm manager etc

## Login Manager

Login Manger

# Other

A default KDE install should contain nothing here. If there is something here than this document has failed and needs to be revised. Until that can happen its temporary home is here. A user should never see this catagory.