Hi,
please have a look at our systemsettings documentation in khelpcenter and how
it is displayed in the navigation tree.
I think it is necessary to cleanup this.
We have 92 settings modules in trunk:
kdedev at rebutia:~/svn$ kcmshell4 --list|wc -l
93-1 = 92
1. On the top level in the navigation tree is an item "Control Center Modules"
with 58 subitems.
Why is it called "Control Center", this is from 3.5, but in kde4 there is no
Control Center any more.
The list with 58 (why only 58 and not 92?) items is unusable because:
Unordered list
Strange/confusing names like "General" (what is it? Konqui settings)
or "Fonts" twice (one is system fonts, the other Konqui fonts)
Most of these items are also in other places in the navigation tree.
Proposal: remove it.
2. In "Application Manuals" there is "Control Center" with the obsolete
documentation for kcontrol.
Proposal: remove it.
3. In "Application Manuals" there is "Settings" with:
Dgital Camera, KWalletManager, Menu Editor, Network Settings, Wallet
Management Tool (=same documentation as KWalletManager)
Why this separate group?
Proposal: remove the item "Settings" and move the subitems to an appropriate
place.
4. In "Application Manuals" there is "Settings-Modules" with 9 groups of items
in the structure from kcontrol 3.5.
Proposal: remove it.
5. In "Application Manuals" there is "System Settings" -> the Handbook.
Rename it to "System Settings Manual", then it is ok.
6. In "Application Manuals" there is "System Settings" with items in two
subgroups "General" + "Advanced". This is the same layout as in the
application systemsettings. There are only some documentations missing, all
docs have to be added here in an appropriate subgroup.
Proposal:
This should be the only item in the navigation tree with documentation for all
settings in kde4. It should have the same layout in the navigation tree as in
the application systemsettings.
Move it up to a top level item in khelpcenters navigation tree.
Attached a file with the layout of the application systemsettings with all
items, the available and missing documentation and other bugs regarding the
help.
There are 54 items, what is the difference to the 92 items reported by
kcmshell4 --list and where is the documentation for these items in
khelpcenter?
In the kcmshell4 list are additional:
Browser setting for Konqui - khtml_general, cookies, cache, ebrowsing,
khtml_filter, khtml_fonts, khtml_plugins, khtml_behavior, khtml_java_js,
kcmcss, useragent. 11 items.
These items are listed in No 1 the "Control Center Modules" I want to remove.
So where should they go in the navigation tree?
To "Application Manuals"->"Internet"->"Konqueror Settings"?
Next group of documentations not in System Settings is the KInfocenter stuff:
kcmview1394, nic, xserver, interrupts, devices, dma, scsi, opengl, kcm_pci,
sound, kcm_partition, kcm_memory, kcmusb, kcmsolidproc, ioports, smbstatus.
These 16 docs are in "KInfoCenter Modules" in the navigation tree.
Some moduls are not listed in the application systemsettings, like bookmarks,
kcm_knetworkconfmodule, kcmdolphin etc.
Launching kcmshell "modul" the window caption is "name of modul - KDE Control
Module", shoudn't this be changed to "KDE System Settings Module"?
--
Burkhard L?ck
-------------- next part --------------
General
Look & Feel
Appearance
Style (Tabs: Style, Fine Tunig)
help:/kcontrol/kcmstyle/index.html, docs ok
Colors (Tabs: Scheme, Options, Colors, Inactive,
Disabled) help:/kcontrol/colors/index.html, docs outdated
Icons (Tabs: Theme, Advanced)
help:/kcontrol/icons/index.html, docs ok
Fonts help:/kcontrol/fonts/index.html, docs ok
Windows (Tabs: Window Decoration, Buttons)
help:/kcontrol/kwindecoration/index.html, docs ok
Splash Screen help:/kcontrol/splashscreen/index.html,
docs ok
Emoticons help:/kcontrol/emoticons/index.html, docs ok
Desktop
Desktop Effects (Tabs: General, All Effects)
help:/kcontrol/kwincompositing/index.html, docs incomplete
Multiple Desktops
help:/kcontrol/desktop/index.html#desktop-number, docs outdated
Screen Saver help:/kcontrol/screensaver/index.html,
docs outdated
Launch Feedback help:/kcontrol/kcmlaunch/index.html,
docs outdated
Notifications
System Notifications (Tabs: Applications, Player
Settings) help:/kcontrol/kcmnotify/index.html, docs outdated
System Bell help:/kcontrol/bell/index.html, docs
outdated
Window Behaviour
Window Behaviour
(Tabs: Focus, Title Bar, Windows Actions, Moving,
Advanced) help:/kcontrol/windowbehaviour/index.html, docs outdated
Window Specific help:/kcontrol/windowspecific/index.html
Personal
About Me
Password & User Account help:/kdepasswd/index.html
Paths help:/kcontrol/paths/index.html
Accessibility
Text-to-Speech (Tabs: General, Talkers, Filters,
Interruption, Audio) help:/kttsd/index.html
Accessibility (Tabs: Bell, Modifier Keys, Keybord
Filters, Activation Gestures) help:/kcontrol/kcmaccess/index.html, docs outdated
Default Applications help button disabled
Regional & Language
Country/Region & Language (Tabs: Locale, Numbers,
Money, Times & Date, Other) help:/kcontrol/language/index.html, docs outdated
Keyboard Layout (Tabs: Layout, Switching Options,
Advanced) help:/kcontrol/kxkb/index.html
(There is no documentation available for
/kcontrol/kxkb/index.html, doc is in kxkb/index.html, wrong X-DocPath
Spellchecker help:/kcontrol/spellchecking/index.html,
docs outdated
Network & Connectivity
Network Settings
(missing: Network Settings (Tabs: Network Interfaces,
Routes, Domain Name System, Network Profiles), why?
help:/kcontrol/knetworkconf/index.html broken #163578)
Proxy (Tabs: Proxy, SOCKS)
help:/kcontrol/proxy/index.html
Connection Preferences help:/kcontrol/netpref/index.html
Service Discovery help button disabled
Sharing
Windows Shares help button enabled, does nothing
Computer Administration
Date & Time help:/kcontrol/clock/index.html
Display help:/kcontrol/energy/index.html, docs outdated
Font Installer help:/kcontrol/fontinst/index.html
Input Actions
Mouse Gestures ?
Input Actions help button disabled
Keyboard & Mouse
Keyboard help:/kcontrol/keyboard/index.html
Mouse (Tab: General, Cursor Theme, Advanced, Mouse
Navigation) help:/kcontrol/mouse/index.html, docs outdated
Joystick help:/kcontrol/joystick/index.html
Standard Keyboard Shortcuts help button disabled, but
in khelpcenter kcontrol/keys/index.html
Global Keyboard Shortcuts help button disabled, but in
khelpcenter kcontrol/keys/index.html
Multimedia
Tabs Device Preference + Backend both help buttons
disabled
Advanced
Advanced User Settings
Aconadi configuration help button enablede, no documentation
Audio CDs (Tabs: General. Names. Ogg Vorbis Encoder)
help:/kioslave/audiocd/index.html, kcontrol/audiocd/index.html missing
Autostart help:/kcontrol/autostart/index.html
CDDB Retrievial (Tabs: Lookup, Submit)
help:/kscd/index.html#cddb-page
Desktop Search (tabs Basic Settings + Advanced Settings) help
button disabled
Digital Camera help:/kamera/introduction.html (stubb, no
content)
File Associations help:/kcontrol/filetypes/index.html, docs
outdated
Hardware There is no documentation available for
/kcontrol/solid/index.htm
KDE Resources help:/kcontrol/kresources/index.html
KDE Wallet (Tabs: Wallet Preferences, Acces Control)
help:/kwallet/index.html needs anchors to kwallet-kcontrol-module
Service Manager help button disabled
Session Manager help:/kcontrol/kcmsmserver/index.html
System
Login Manager (Tabs: General (1), Dialog (2), Background (3),
Theme (4), Shutdoen (5), Users (6), Convenience (7)
help:/kdm/index.html#configuring-kdm
Power Management help:/kcontrol/powerdevilconfig/index.html
Samba (Tabs: Base Settings, Shares, Printers, Users, Advanced)
There is no documentation available for /kcontrol/kcmsambaconf/index.html
Task Scheduler help:/kcron/index.html
