Projects/Oxygen/namingSpec/apps: Difference between revisions

    From KDE TechBase
    (The kcall icon is gone, using internet-telephony instead.)
    (I thought the quassel icon doesn't belong here, but it's not wrong at least.)
     
    (15 intermediate revisions by the same user not shown)
    Line 15: Line 15:
      internet-mail                      OK *** (KDE 3 name: kmail)
      internet-mail                      OK *** (KDE 3 name: kmail)
      ksnapshot                          -> accessories-screen-shot **
      ksnapshot                          -> accessories-screen-shot **
    kuickshow                          -> graphics-viewer-image **
      accessories-text-editor            OK (KDE 3 name: kwrite)
      accessories-text-editor            OK (KDE 3 name: kwrite)
      multimedia-volume-control          OK
      multimedia-volume-control          OK
    Line 21: Line 20:
      office-address-book                OK ** (KDE 3 name: kaddressbook)
      office-address-book                OK ** (KDE 3 name: kaddressbook)
      office-calendar                    OK *** (KDE 3 name: korganizer)
      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-accessibility  OK (KDE 3 name: access)
      preferences-desktop-color          OK ** (KDE 3 name: colors)
      preferences-desktop-color          OK ** (KDE 3 name: colors)
      preferences-desktop-cryptography  OK **  
      preferences-desktop-cryptography  OK **  
    preferences-desktop-default-applications OK ** (did not exist in KDE 3)
      preferences-desktop-display        OK **
      preferences-desktop-display        OK **
    preferences-desktop-icons          OK ** (KDE 3 name: icons)
      preferences-desktop-filetype-association OK **
      preferences-desktop-filetype-association OK **
                                           (KDE 3 name: filetypes)
                                           (KDE 3 name: filetypes)
    Line 32: Line 33:
                                           (KDE 3 name: kcmfontinst)
                                           (KDE 3 name: kcmfontinst)
      preferences-desktop-gaming        OK ** (KDE 3 name: devices/joystick)
      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-keyboard      OK (KDE 3 name: keyboard)
    preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
      preferences-desktop-launch-feedback OK ** (KDE 3 name: actions/launch)
      preferences-desktop-launch-feedback OK ** (KDE 3 name: actions/launch)
      preferences-desktop-locale        OK (KDE 3 name: locale)
      preferences-desktop-locale        OK (KDE 3 name: locale)
    preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
      preferences-desktop-multimedia    Needed
      preferences-desktop-multimedia    Needed
      preferences-desktop-notification  OK ** (KDE 3 name: knotify)
      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-printer        OK ** (KDE 3 name: printmgr)
      preferences-desktop-screensaver    OK (KDE 3 name: kscreensaver)
      preferences-desktop-screensaver    OK (KDE 3 name: kscreensaver)
    Line 44: Line 47:
      preferences-desktop-theme          OK (KDE 3 name: looknfeel)
      preferences-desktop-theme          OK (KDE 3 name: looknfeel)
      preferences-desktop-user          OK ** (KDE 3 name: userconfig)
      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-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-bluetooth      OK ** (KDE 3 name: kdebluetooth)
      preferences-system-login          OK ** (KDE 3 name: kdmconfig)
      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-performance    OK ** (KDE 3 origin: launch)
      preferences-system-power-management OK ** (KDE 3 name: energy)
      preferences-system-power-management OK ** (KDE 3 name: energy)
    Line 52: Line 65:
      preferences-system-time            OK ** (KDE 3 name: date)
      preferences-system-time            OK ** (KDE 3 name: date)
      preferences-system-windows        OK *** (KDE 3 name: kwin)
      preferences-system-windows        OK *** (KDE 3 name: kwin)
    preferences-system-network-share  OK ** (only used the "share"
                                              overlay in KDE 3)
      preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
      preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
      preferences-web-browser-cache      OK ** (KDE 3 name: cache)
      preferences-web-browser-cache      OK ** (KDE 3 name: cache)
    Line 64: Line 75:
                                                 to KUser: add_group)
                                                 to KUser: add_group)
      system-software-update            OK (KDE 3 name: kpackage)
      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-file-archiver            OK ** (KDE 3 name: ark)
      utilities-log-viewer              OK ** (KDE 3 name: ksystemlog)
      utilities-log-viewer              OK ** (KDE 3 name: ksystemlog)
    Line 91: Line 105:
                                       use upper-case characters in
                                       use upper-case characters in
                                       the name of the executable.
                                       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
      basket                        -> move to wherever basket lives
      digikam                      -> move to extragear/graphics/digikam
      digikam                      -> move to extragear/graphics/digikam
      fontforge                    OK
      fontforge                    OK
    gwenview                      -> move to kdegraphics/gwenview
      java                          OK
      java                          OK
      k3b                          -> move to extragear/multimedia/k3b
      k3b                          -> move to extragear/multimedia/k3b
      kaffeine                      -> move to extragear/kaffeine
      kaffeine                      -> move to extragear/kaffeine
    kalzium                      -> move to kdeedu/kalzium
    kanagram                      -> move to kdeedu/kanagram
    kate                          -> move to kdesdk/kate
      kblogger                      -> move to wherever kblogger lives
      kblogger                      -> move to wherever kblogger lives
    kbruch                        -> move to kdeedu/kbruch
      kbugbuster                    -> move to kdesdk/kbugbuster
      kbugbuster                    -> move to kdesdk/kbugbuster
      kchart                        -> move to koffice/kchart
      kchart                        -> move to koffice/kchart
      kcolorchooser                -> move to kdegraphics/kcolorchooser
      kcolorchooser                -> move to kdegraphics/kcolorchooser
    kde                          OK (KDE 3 name: actions/about_kde)
      kexi                          -> move to koffice/kexi
      kexi                          -> move to koffice/kexi
    kgeography                    -> move to kdeedu/kgeography
    kget                          -> move to kdenetwork/kget
    khangman                      -> move to kdeedu/khangman
    kiten                        -> move to kdeedu/kiten
      kjournal                      ?? does it still exist? if no, svn rm.
      kjournal                      ?? does it still exist? if no, svn rm.
                                       if yes, move to wherever it lives.
                                       if yes, move to wherever it lives.
    klettres                      -> move to kdeedu/klettres
      klipper                      -> move to kdebase/klipper
      klipper                      -> move to kdebase/klipper
      kmplayer                      -> move to extragear/multimedia/kmplayer
      kmplayer                      -> move to extragear/multimedia/kmplayer
      kmplot                        -> move to kdeedu/kmplot
      knewsticker                  -> svn rm, doesn't even exist anymore
                                      to the best of jpetso's knowledge
      knotes                        -> move to kdepim/knotes
      knotes                        -> move to kdepim/knotes
                                       (and to the notes plasmoid?)
                                       (and to the notes plasmoid?)
    Line 123: Line 133:
      kontact                      -> move to kdepim/kontact
      kontact                      -> move to kdepim/kontact
      konversation                  -> move to extragear/network/konversation
      konversation                  -> move to extragear/network/konversation
    konv-message                  -> status/konversation-dock-flashing
    kopete                        -> move to kdenetwork/kopete
    kpercentage                  -> move to kdeedu/kpercentage
      krita                        -> move to koffice/krita
      krita                        -> move to koffice/krita
    kruler                        -> move to kdegraphics/kruler
      ksniffer                      -> move to playground/network/ksniffer
      ksniffer                      -> move to playground/network/ksniffer
      kstars                        -> move to kdeedu/kstars
      ktip                          -> move to wherever ktip lives
    kteatime                      -> move to kdetoys/kteatime
      ktorrent                      -> move to extragear/network/ktorrent
      ktorrent                      -> move to extragear/network/ktorrent
      kverbos                      -> parley, and move to
      kuickshow                    -> move to wherever kuickshow lives
                                      playground/edu/parley
      kverbos                      -> move to wherever kverbos lives
      kvoctrain                    -> svn rm, KVocTrain is Parley now
                                      and that already has an icon
      kwallet                      OK
      kwallet                      OK
    kwordquiz                    -> move to kdeedu/kwordquiz
      kword                        -> move to koffice/kword
      kword                        -> move to koffice/kword
      laptop-battery                ?? another battery icon? svn rm,
      nepomuk                      OK
                                      or replace devices/battery
    oxygen                        OK
                                      with this one
      okteta                       -> move to kdeutils/okteta
      marble                       -> move to kdeedu/marble
                                      (since 4.1)
    plasma                        OK
      plasmagik                    -> move to
      plasmagik                    -> move to
                                       playground/base/plasma/plasmagik
                                       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
      strigi                        OK
      wine                          OK
      wine                          OK
      x                            OK [see Discussion]
      xorg                          OK
    </pre>
    </pre>


    Line 273: Line 280:


      internet-mail
      internet-mail
       We already have this from the previous "kmail" icon.
       Used in KDE 4 instead of "kmail". (Done.)


      internet-news-reader
      internet-news-reader
    Line 296: Line 303:
      preferences-system-network-proxy
      preferences-system-network-proxy
       We do have proxy settings in KDE 3, this might make sense.
       We do have proxy settings in KDE 3, this might make sense.
      (Done.)


      preferences-system-session
      preferences-system-session
    Line 308: Line 316:
      system-users
      system-users
       Seems to fit KUser or Guidance's "User Management" module.
       Seems to fit KUser or Guidance's "User Management" module.
       (Evaluate if actions/users can be moved here.)
       (Done.)
    </pre>
    </pre>

    Latest revision as of 12:34, 13 January 2009

    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.)