Difference between revisions of "Projects/SystemSettings"

Revision as of 14:35, 18 June 2010

General Issues

No support for Administrator Mode in modules #151669
Hardcoded size and use of QScrollArea to prevent resizing on module load is worse than resizing #153283
Hardcoded layout (100px wide items) breaks when larger fonts are used #153285
The item model is always sorted alphabetically #153288
No menu, not sure if this is intentional, there is some menu code in the program.
No application icon. I have switched to "preferences-other" for now. User:Bille
Krush bug reports
Toolbar can be disabled and not reenabled. #151667
Apply/Reset button order is always reversed #140145

Design Documentation

el's Usability research for System Settings motivating its structure.
Simon Edwards' blog on KDE 3 Systemsettings for kubuntu
Systemsettings user documentation, may be useful for figuring out how it should work.
kubuntu System Settings project page
BR on organisation
KDE Wiki System Settings that this page replaces
Commit changing System Settings' menu placement, with comment that it may need changing again.

Work plan

DONE

Use XDG menu structures since these provide arbitrary ordering and extensibility (deferred to 4.1 because what we have in kbuildsyscoca requires that Settings are part of the main K menu, which caused horrible problems in KDE 3 with distros' broken XDG, users removing Settings with kmenuedit. The correct solution is to use XDG algorithms but store the resulting settings menu separately. This could be done in kbuildsycoca but it's too late for thse changes. Using the existing systemsettings metadata for now - Bille)
Port to Interview and use KCategorizedView from Dolphin (WIP - Bille )
- KCModuleModel
- Use KCategorizedView
- SortFilterProxyModel to replace KCMSearch. This should use X-KDE-Weight to set sort order and set a SearchHitRole on the items so that the custom delegate can dim them.
- Custom KCategoryDrawer with icon
- Custom Delegate
- Hook up to KCMultiWidget etc

TODO

Reimplement administrator mode modules using minimal reader/writer root processes
- See also commit r559289: "remove the ability to embed KCMs running as root: the GUI should run with user privileges and only the writing or calling of programs should run as root"
- See also PolicyKit and PolicyKit-KDE - looking through the API it seems to be overall complicated to implement that for e.g. the datetime-kcm compared to the KDE3-way plus it does NOT seem to be portable (so, we would need a portable wrapper-lib around it). All in all it sounds like a lot of overhead imho (sebsauer)
  - 2009-03-11: polkit-Qt is there meanwhile, yeah! Now we just could need a way to provide a more portable implementation :) (sebsauer)
Check that User:DarioAndres/SS3 is implemented.

Modules

Computer Administration

These modules are currently displayed in System Settings Y = Yes; N = No; M = Maybe

Category	Subcategory	Name	kcmodule	Icon	BRs	Comments	Advanced	Maintained	Needs Root	SVN path
Computer Administration				Y			N
		Date & Time	clock	Y		dbus call to update clock needs porting to Plasma	N		Y	kdebase/workspace/kcontrol/dateandtime
		Font Installer	fontinst	Y			N		M	kdebase/workspace/kcontrol/kfontinst
	Keyboard & Mouse			Y, no mouse			N
	Keyboard & Mouse	Joystick	joystick	Y			N			kdebase/workspace/kcontrol/hardware/joystick
	Keyboard & Mouse	Keyboard	keyboard	Y			N			kdebase/workspace/kcontrol/keyboard
	Keyboard & Mouse	Keyboard Shortcuts	keys	Y	153282		N			kdebase/workspace/kcontrol/keys
	Keyboard & Mouse	Mouse	mouse	Y	153202		N			kdebase/workspace/kcontrol/input
	Display			Y			N
	Display	Size and Orientation	randr	Y			Y			kdebase/workspace/kcontrol/randr
	Display	Power Control	energy	Y		Removed in KDE4.4 code (replaced by PowerDevil)	N	N		Removed
		Multimedia	sound	Y	Report bugs to systemsettings/kcm_phonon	overall Phonon config, like old "Sound System"	N			kdebase/runtime/phonon/kcm

Look & Feel

Category	Subcategory	Name	kcmodule	Icon	BRs	Comments	Advanced	Maintained
Look & Feel				Y			N
	Appearance			Y			N
	Appearance	Colors	colors	Y	153056		N	Yes, Matthew Woehlke	kdebase/workspace/kcontrol/colors
	Appearance	Fonts	fonts	Y			N		kdebase/workspace/kcontrol/fonts
	Appearance	Icons	icons	Y			N		kdebase/runtime/kcontrol/icons
	Appearance	Style	style	Y		153287	N		kdebase/runtime/kcontrol/style
	Appearance	Theme Manager	kthememanager	Y			N		kdebase/workspace/kcontrol/kthememanager
	Appearance	Windows	kwindecoration	Y			N		kdebase/workspace/kwin/kcmkwin/kwindecoration
	Desktop			Y			N
	Desktop	Desktop Effects	kwincompositing	Y			N		kdebase/workspace/kwin/kcmkwin/kwincompositing
	Desktop	Launch Feedback	kcmlaunch	Y			N		kdebase/workspace/kcontrol/launch
	Desktop	Screen Saver	screensaver	Y			N		kdebase/workspace/kcontrol/screensaver
	Notifications			Y			N
	Notifications	System Bell	bell	Y			N		kdebase/workspace/kcontrol/bell
	Notifications	System Notifications	kcmnotify	Y			N		kdebase/runtime/kcontrol/knotify
		Splash Screen	ksplashthememgr	Y			N		kdebase/workspace/kcontrol/ksplashthememgr
		Window Behaviour		Y			Y
	Window Behaviour	Window-Specific Settings	kwinrules	Y		accessible via window menu	Y		kdebase/workspace/kwin/kcmkwin/kwinrules
	Window Behaviour	Window Behaviour	kwinoptions	Y			N		kdebase/workspace/kwin/kcmkwin/kwinoptions

Network & Connectivity

Category	Subcategory	Name	kcmodule	Icon	BRs	Advanced	Needs Root	SVN Path
Network & Connectivity				generic		N
	Network Settings			generic		N
	Network Settings	Connection Preferences	netpref	generic	use bko component kio/settings	N		kdebase/apps/konqueror/settings/kio/
	Network Settings	Proxy	proxy	generic	use bko component kio/settings	N		kdebase/apps/konqueror/settings/kio/
	Network Settings	Service Discovery	kcmkdnssd	generic		N		kdebase/runtime/kcontrol/dnssd/
		Sharing	fileshare	generic		N	Y	kdenetwork/filesharing/simple

Personal

Category	Subcategory	Name	kcmodule	Icon	BRs	Comments	Advanced	SVN path
Personal				Y			N
	About Me			Y			N
	About Me	Password & User Account	kcm_useraccount	Y			N	kdebase/apps/kdepasswd/kcm/
	About Me	Paths	desktoppath	system-file-manager!			N	kdebase/apps/konqueror/settings/konq/
	Accessibility			Y			N
	Accessibility	Accessibility	accessibility	Y			N	kdebase/workspace/kcontrol/access
	Accessibility	Input Actions	khotkeys	keyboard, not gestures	153297	mentions DCOP	N	workspace/khotkeys/kcontrol/khotkeys.desktop
		Default Applications	componentchooser	Y			N	kdebase/runtime/kcontrol/componentchooser/
	Regional & Language			Y			N
	Regional & Language	Country/Region & Language	language	Y			N	kdebase/runtime/kcontrol/locale
	Regional & Language	Keyboard Layout	keyboard_layout	Y	151766		N	kdebase/workspace/kcontrol/kxkb

Advanced User Settings

Category	Name	kcmodule	Icon	BRs	Comments	Advanced	SVN Path
Advanced User Settings			Y			Y
	Audio CDs	audiocd	Y			Y	kdemultimedia/kioslave/audiocd/kcmaudiocd
	Autostart	autostart	Y			Y	kdebase/workspace/kcontrol/autostart
	CDDB Retrieval	libkcddb	Y			Y	kdemultimedia/libkcddb/kcmcddb
	Digital Camera	kamera	Y			Y	kdegraphics/kamera/kcontrol
	File Associations	filetypes	Y	151781	Not accessible via dolphin so we can show it here	Y	kdebase/apps/konqueror/settings/filetypes/
	KDE Resources	kresources	Y			Y	kdepimlibs/kresources/
	KDE Wallet	kwalletconfig	Y			Y	kdeutils/kwallet/konfigurator
	Service Manager	kcmkded	Y			Y	kdebase/runtime/kcontrol/kded/
	Session Manager	kcmsmserver	Y			Y	kdebase/workspace/ksmserver/kcm/
	Solid	kcm_solid	Y			Y	kdebase/workspace/solid/kcm/

Advanced/System

Category	Name	kcmodule	Icon	Advanced	Maintained	Needs Root	SVN Path
System			Y	Y
	Login Manager	kdm	Y	Y	Y, Oswald Buddenhagen (ossi)	Y	kdebase/workspace/kcontrol/kdm
	Samba	kcmsambaconf	Y	Y		Y	kdenetwork/filesharing/advanced/kcm_sambaconf

Missing Modules

These modules are present in a default openSUSE KDE 3.5.8 but are not in KDE 4 System Settings. Their absence needs to be investigated and explained. When moving a module from Missing to the table above, please also add a component to System Settings in bugs.kde.org. You can copy the details from the corresponding kcontrol component.

There are also some new-in-KDE4 configuration modules that are not in System Settings either, add these to this list.

Name	kcmodule	Icon	Comments	Advanced	Needs Root
Background		Y	deprecated or replace with plasma version	N
Behaviour		Y	gone in kcmshell4 --list; probably konq	N
Crypto		Y	in konq	N
Desktop Sharing	kcmkrfb	Y	not in 4.0, kdenetwork/krfb/kcm_krfb/kcmkrfb.desktop	N
Display		Y		Y
Display/Gamma	kgamma	Y	not in 4.0, kdegraphics/kgamma/kcmkgamma/kgamma.desktop	N
File Manager		Y	in konq	N
GTK Styles and Fonts		Y	not in KDE SVN	Y
IBM Thinkpad Laptop	thinkpad	Y		Y
KDE Performance		Y	in konq	N
Local Network Browsing		Y	Now Network & Connectivity/Sharing	N
Multiple Desktops		Y	in Plasma	N
Paired Bluetooth Devices		Y		N
Panels		Y	in Plasma TBD	N
Printers		Y	not in 4.0	N	M
Privacy		Y	not in 4.0	N
Remote Controls	kcmlirc	Y	not in 4.0, kdeutils/kdelirc/kcmlirc/kcmlirc.desktop	N
Spell Checker		Y	not in 4.0	N
Sony Vaio Laptop		Y		Y
Storage Media		Y	not in 4.0	Y
Taskbar		Y	in Plasma TBD	N
Web Browser		Y	in konq	N
Wireless Network		Y	not in 4.0	N

Missing Documentation

System Settings documentation is around 90 % up to date for 4.4.0. See also [[1]] This page displays the documentation state [[2]]. Please see [[3]] for the missing docs.

Bug Triaging

The table above gives the internal Name of the System Settings module. This is used as the bugzilla component. If you are triaging System Settings bugs in the general component, check the table to see if a bug can be reassigned to a specific bug. As System Settings is a shell for many KCModules, modules are maintained by many different people. Some modules should not be assigned to System Settings at all (eg network configuration -> Konqueror, window management -> KWin). This is indicated in the BR (Bug Report) column for most modules.

@@ Line 39: / Line 39: @@
 ** See also [http://hal.freedesktop.org/docs/PolicyKit/ PolicyKit] and [http://websvn.kde.org/trunk/playground/base/PolicyKit-kde/ PolicyKit-KDE] - looking through the API it seems to be overall complicated to implement that for e.g. the datetime-kcm compared to the KDE3-way plus it does NOT seem to be portable (so, we would need a portable wrapper-lib around it). All in all it sounds like a lot of overhead imho (sebsauer)
 *** 2009-03-11: polkit-Qt is there meanwhile, yeah! Now we just could need a way to provide a more portable implementation :) (sebsauer)
+* Check that [[User:DarioAndres/SS3]] is implemented.
 == Modules ==