Projects/Oxygen/namingSpec/apps

From KDE TechBase

Specification compliance of icon names

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

Generic Application Names:

 accessories-calculator             OK (KDE 3 name: kcalc)
 accessories-character-map          OK (KDE 3 name: kcharselect)
 accessories-dictionary             OK (KDE 3 name: kdict)
 internet-web-browser               OK *** (did not exist
                                        in this form in KDE 3)
 help-browser                       OK (KDE 3 name: khelpcenter)
 internet-telephony                 OK ** (KDE 3 name: kcall)
 internet-mail                      OK *** (KDE 3 name: kmail)
 ksnapshot                          -> accessories-screen-shot **
 accessories-text-editor            OK (KDE 3 name: kwrite)
 multimedia-volume-control          OK
 graphics-viewer-document           OK **
 office-address-book                OK ** (KDE 3 name: kaddressbook)
 office-calendar                    OK *** (KDE 3 name: korganizer)
 preferences-contact-list           ?? (likely ok, but I don't
                                        remember the use case)
 preferences-desktop-accessibility  OK (KDE 3 name: access)
 preferences-desktop-color          OK ** (KDE 3 name: colors)
 preferences-desktop-cryptography   OK ** 
 preferences-desktop-default-applications OK ** (did not exist in KDE 3)
 preferences-desktop-display        OK **
 preferences-desktop-filetype-association OK **
                                       (KDE 3 name: filetypes)
 preferences-desktop-font           OK (KDE 3 name: font)
 preferences-desktop-font-installer OK ** (in workspace/kcontrol/kfontinst)
                                       (KDE 3 name: kcmfontinst)
 preferences-desktop-gaming         OK ** (KDE 3 name: devices/joystick)
 preferences-desktop-icons          OK ** (KDE 3 name: icons)
 preferences-desktop-keyboard       OK (KDE 3 name: keyboard)
 preferences-desktop-launch-feedback OK ** (KDE 3 name: actions/launch)
 preferences-desktop-locale         OK (KDE 3 name: locale)
 preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
 preferences-desktop-multimedia     Needed
 preferences-desktop-notification   OK ** (KDE 3 name: knotify)
 preferences-desktop-notification-bell OK ** (KDE 3 name: actions/bell)
 preferences-desktop-printer        OK ** (KDE 3 name: printmgr)
 preferences-desktop-screensaver    OK (KDE 3 name: kscreensaver)
 preferences-desktop-sound          OK *** (KDE 3 name: kcmsound)
 preferences-desktop-text-to-speech OK ** (KDE 3 name: kttsd)
 preferences-desktop-theme          OK (KDE 3 name: looknfeel)
 preferences-desktop-user           OK ** (KDE 3 name: userconfig)
 preferences-desktop-user-password  OK ** (KDE 3 name: password)
 preferences-desktop-wallpaper      OK (KDE 3 name: background)
 preferences-kcalc-constants        ?? also used by kmplot? (says Pino)
 preferences-plugin                 OK **
 preferences-plugin-script          OK **
 preferences-system-bluetooth       OK ** (KDE 3 name: kdebluetooth)
 preferences-system-login           OK ** (KDE 3 name: kdmconfig)
 preferences-system-network-sharing -> ...-share instead of sharing?
                                       that was the initial plan,
                                       check back what's better.
                                       apart from that:
                                    OK ** (only used the "share"
                                           overlay in KDE 3)
 preferences-system-performance     OK ** (KDE 3 origin: launch)
 preferences-system-power-management OK ** (KDE 3 name: energy)
 preferences-system-session-services OK ** (KDE 3 name: services)
 preferences-system-time            OK ** (KDE 3 name: date)
 preferences-system-windows         OK *** (KDE 3 name: kwin)
 preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
 preferences-web-browser-cache      OK ** (KDE 3 name: cache)
 preferences-web-browser-cookies    OK ** (KDE 3 name: cookie)
 preferences-web-browser-identification OK ** (KDE 3 name: agent)
 preferences-web-browser-stylesheets OK ** (KDE 3 name: stylesheet)
 preferences-web-browser-shortcuts  OK ** (KDE 3 name: enhanced_browsing)
 system-file-manager                OK (KDE 3 name: kfm)
 system-users                       OK *** (KDE 3 name - private
                                            to KUser: add_group)
 system-software-update             OK (KDE 3 name: kpackage)
 system-diagnosis                   -> svn rm? probably not needed,
                                       pinheiro added it without any
                                       given use case (since 4.2)
 utilities-file-archiver            OK ** (KDE 3 name: ark)
 utilities-log-viewer               OK ** (KDE 3 name: ksystemlog)
 utilities-system-monitor           OK (KDE 3 name: ksysguard)
 utilities-terminal                 OK (KDE 3 name: konsole)
* suggesting this for inclusion into the icon naming specification
** not in the spec, but let's keep it out of there anyways,
   it's not really suited to be a standard icon
*** exists in the Tango icon set, but not in the spec

Generic Tango icons in Oxygen:

 krfb        -> preferences-desktop-remote-desktop
                (also used in GNOME under that name)

Other application icons:

Most other application icons should go to their home modules instead of residing in kdelibs - this not only makes for a better overview but also reduces disk space in case not all modules are installed. And, of course, prevents icons being misused for wrong usages.

 acroread                      ?? newer Reader versions are named
                                  differently (how again?), and
                                  use upper-case characters in
                                  the name of the executable.
 akonadi                       OK, as it an independent app that
                                  doesn't make use of kdelibs and thus
                                  can't provide the icon by itself
                                  (since 4.1)
 basket                        -> move to wherever basket lives
 digikam                       -> move to extragear/graphics/digikam
 fontforge                     OK
 java                          OK
 k3b                           -> move to extragear/multimedia/k3b
 kaffeine                      -> move to extragear/kaffeine
 kblogger                      -> move to wherever kblogger lives
 kbugbuster                    -> move to kdesdk/kbugbuster
 kchart                        -> move to koffice/kchart
 kcolorchooser                 -> move to kdegraphics/kcolorchooser
 kde                           OK (KDE 3 name: actions/about_kde)
 kexi                          -> move to koffice/kexi
 kjournal                      ?? does it still exist? if no, svn rm.
                                  if yes, move to wherever it lives.
 klipper                       -> move to kdebase/klipper
 kmplayer                      -> move to extragear/multimedia/kmplayer
 knewsticker                   -> svn rm, doesn't even exist anymore
                                  to the best of jpetso's knowledge
 knotes                        -> move to kdepim/knotes
                                  (and to the notes plasmoid?)
 kolf                          -> move to kdegames/kolf
 konqueror                     OK
 kontact                       -> move to kdepim/kontact
 konversation                  -> move to extragear/network/konversation
 krita                         -> move to koffice/krita
 ksniffer                      -> move to playground/network/ksniffer
 ktip                          -> move to wherever ktip lives
 ktorrent                      -> move to extragear/network/ktorrent
 kuickshow                     -> move to wherever kuickshow lives
 kverbos                       -> move to wherever kverbos lives
 kwallet                       OK
 kword                         -> move to koffice/kword
 nepomuk                       OK
 oxygen                        OK
 okteta                        -> move to kdeutils/okteta
                                  (since 4.1)
 plasma                        OK
 plasmagik                     -> move to
                                  playground/base/plasma/plasmagik
 quassel                       OK, as quassel has a hicolor icon in
                                  its own sources. Moving it upstream
                                  would still be a good idea.
                                  (since 4.2)
 strigi                        OK
 wine                          OK
 xorg                          OK

To do for Oxygen

Icons that are in the spec, but not yet in Oxygen's apps/ (after renaming) so they need to be added. Descriptions taken from the specification.

 preferences-desktop-multimedia
   The icon used for the desktop's multimedia preferences.

To do for Oxygen - not in the spec

Icons that are not specified and do not currently exist as well, but are needed for KDE applications (and not blatantly obvious). Yes, I am aware that some of those are bad (if not outright evil) names. That comes from preferences-desktop-peripherals being classified in the "desktop" preferences subgroup, which is very wrong imho. We need to fix this in the spec (see the suggestions of the categories page), but until then, I stay with specification conform names.

 preferences-desktop-effect **
   The icon for the "Desktop Effects" KCM. (New in KDE 4.)

 preferences-desktop-panel **
   The icon for the "Panels" KCM.

 preferences-desktop-theme-style **
   The icon for the "Style" KCM (widget style, in "Appearance").

 preferences-system-network-discovery **
   The icon for the "Service Discovery"
   (= DNSSD / Zeroconf / Bonjour / Rendezvous) KCM.

 preferences-system-network-proxy ***
   The icon for the "Proxy" KCM. (Also exists in the Tango set.)

 preferences-system-session ***
   The icon for the "Session Manager" KCM.
   (This icon also exists in the Tango set.)

 preferences-system-splash **
   The icon for the "Splash Screen" KCM.

Optional icons

We don't absolutely need those because they are covered by fallbacks: if these icons don't exist, they've got a sensible fallback.

 preferences-desktop-display-multiple
   The icon for the "Multiple Monitors" (aka Xinerama) KCM.

 preferences-desktop-display-randr
   The icon for the "Size & Orientation" KCM.

 preferences-desktop-keyboard-khotkeys
   The icon for the "KHotKeys" KCM.

 preferences-desktop-multiple
   The icon for the "Multiple Desktops"
   (a.k.a. virtual desktops) KCM.

 preferences-desktop-panel-taskbar
   The icon for the "Taskbar" KCM.

 preferences-desktop-user-account
   The icon for the "Password & User Account" KCM.

 preferences-desktop-user-smartcard
   The icon for the "Smartcards" KCM.
   (Was "identity" in KDE 3, and is really not necessary.)

 preferences-system-solid
   The icon for the "Solid" KCM. (New in KDE 4.)

 preferences-system-network-connection
   The icon for the "Connection Preferences" KCM.

 preferences-system-network-share-windows
   The icon for the "Windows Shares" KCM.

 preferences-system-network-share-windows-status
   The icon for the "Samba Status" KCM (in KInfoCenter).

 preferences-system-windows-effect
   The icon for the "Window Effects" KCM. (New in KDE 4.)

 preferences-system-windows-decoration
   The icon for the "Window Decorations" KCM.

 preferences-system-windows-specific
   The icon for the "Window-Specific Settings" KCM.

Even more optional

Draw those only if you feel like wasting time for little outcome. I haven't got KDE 4 compiled at the moment, so I don't even know if those are visible at all.

 preferences-system-windows-focus
   The icon for the KWin's "Focus" settings, which
   belong to the "Window Behaviour" KCM.

 preferences-system-windows-action
   The icon for the KWin's "Actions" settings, which
   belong to the "Window Behaviour" KCM.

 preferences-system-windows-movement
   The icon for the KWin's "Moving" settings, which
   belong to the "Window Behaviour" KCM.

 preferences-system-windows-advanced
   The icon for the KWin's "Advanced" settings, which
   belong to the "Window Behaviour" KCM.

Icons in Tango, but not in the spec

We don't need to have those, but if we do they should be named this way:

 internet-group-chat
   For a possible generic instant messager icon.
   *Very* optional though, as we already have branded
   Kopete and Konversation icons.

 internet-mail
   Used in KDE 4 instead of "kmail". (Done.)

 internet-news-reader
   Instead of "knode".

 internet-web-browser
   For a possible generic browser icon. *Very* optional though,
   as we already have a branded Konqueror icon. (Done.)

 office-calendar
   We already have this from the previous "korganizer" icon.
   (Done.)

 preferences-desktop-assistive-technology
   Tango does this as preferences-desktop-accessibility
   plus an emblem-style gear icon at the lower right.
   Hardly necessary to have.

 preferences-desktop-sound
   Go Phonon go. (Done.)

 preferences-system-network-proxy
   We do have proxy settings in KDE 3, this might make sense.
   (Done.)

 preferences-system-session
   The icon for the session management settings.

 preferences-system-windows
   KWin settings. (Done.)

 system-installer
   Adept, Yast, Pirut, Smart, or whatever else is out there.

 system-users
   Seems to fit KUser or Guidance's "User Management" module.
   (Done.)