Projects/Oxygen/namingSpec/actions

    From KDE TechBase
    Revision as of 17:17, 10 November 2007 by Jpetso (talk | contribs) (For completeness, include the Konqueror settings category icons.)

    Specification compliance of icon names

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

     address-book-new               Needed
     appointment-new                Needed
     application-exit               OK (KDE 3 name: exit)
     arrow-down                     ??
     arrow-down-double              ??
     arrow-left                     ??
     arrow-left-double              ??
     arrow-right                    ??
     arrow-right-double             ??
     arrow-up                       ??
     arrow-up-double                ??
     archive-insert-directory       OK ** (KDE 3 name: ark_adddir)
     archive-insert                 OK * (KDE 3 name: ark_addfile)
     archive-remove                 OK * (KDE 3 name: ark_delete)
     archive-extract                OK * (KDE 3 name: ark_extract)
     battery-discharging-000        -> status/battery-low-000 **
     battery-discharging-020        -> status/battery-low
     battery-discharging-040        -> status/battery-caution
     battery-discharging-060        -> status/battery-060 **
     battery-discharging-080        -> status/battery-080 **
     battery-discharging-100        -> status/battery-100 **
     battery-charging-000           -> status/battery-charging-low-000 **
     battery-charging-020           -> status/battery-charging-low **
     battery-charging-040           -> status/battery-charging-caution **
     battery-charging-060           -> status/battery-charging-060 **
     battery-charging-080           -> status/battery-charging-080 **
     battery-charging-100           -> status/battery-charging-100 **
     bookmark-new                   OK *
     bookmark-new-list              OK **
     bookmark-toolbar               ?? (use case: "Set as toolbar folder")
     cache                          see the wiki page for apps
     cookies                        see the wiki page for apps
     browser_identification         see the wiki page for apps
     filter-page                    see the wiki page for apps
     stylesheets                    see the wiki page for apps
     camera-test                    ??
     cdburn                         ??
     cdcopy                         ??
     cd-data                        -> svn rm
     cd                             -> svn rm
     character-set                  ?? (use cases?)
     chronometer                    ?? (use cases?)
     color-fill                     OK ** (ArtLibreSet)
     color-line                     ??
     color-picker                   OK ** (ArtLibreSet)
     commandprompt                  ?? (duplicate of openterm?)
                                       (use cases?)
     configure                      ??
     configure-shortcuts            ??
     configure-toolbars             ??
     connection-established         ?? (should probably go into status/)
     connect-no                     ?? (should probably go into status/)
     contact-new                    OK
     datashow                       ?? (use cases?)
     datashowchart                  ?? (use cases?)
     dialog-apply                   OK *
     dialog-cancel                  OK
     dialog-close                   OK
     dialog-ok                      OK
     document-decrypt               OK ** (KDE 3 name: decrypted)
     document-encrypt               OK ** (KDE 3 name: encrypted)
     document-export                OK ** (KDE 3 name: fileexport)
     document-import                OK ** (KDE 3 name: fileimport)
     document-new                   OK
     document-open                  OK
     document-open-recent           OK **
     document-page-setup            Needed
     document-preview-archive       OK ** (KDE 3 name: ark_view)
     document-print                 OK
     document-print-preview         OK
     document-properties            OK
     document-revert                OK
     document-save                  OK (KDE 3 name: filesave)
     document-save-as               OK (KDE 3 name: filesaveas)
     document-save-all              OK * (KDE 3 name: save_all)
     document-start-presentation    OK **
     domtreeviewer                  ??
     edit                           ??
     edit-add                       ?? (probably remove in favor of
                                        list-add)
     edit-clear                     OK (Note: Only in CVS,
                                        not yet in 0.8 of the spec.)
     edit-clear-list                OK ** (KDE 3 origin: view_remove)
     edit-clear-history             OK ** (KDE 3 name: history_clear)
     edit-clear-locationbar         OK ** (KDE 3 name: locationbar_erase)
     edit-clear-locationbar-rtl     OK ** (KDE 3 name: clear_left)
     edit-copy                      OK
     edit-cut                       OK
     edit-delete                    OK *
     edit-delete-shred              OK ** (KDE 3 name: editshred)
     edit-delete-mail               OK ** (KDE 3 name: mail_delete)
     edit-find                      OK
     edit-find-replace              Needed
     edit-find-mail                 OK **
     edit-find-next                 OK **
     edit-find-previous             OK **
     edit-find-user                 OK (unused... delete?) **
     editinput                      ?? (use cases?)
     edit-paste                     OK
     edit-redo                      OK
     edit-select-all                Needed
     edit-undo                      OK
     edit-user                      ??
     trash-empty                    OK ** (KDE 3 name: emptytrash)
     eraser                         -> draw-eraser ** (ArtLibreSet)
     favorites                      ?? (use cases?)
     fileview-close-left            -> view-left-close **
     fileview-close-right           -> view-right-close **
     fileview-column                -> view-file-column **
     fileview-detailed              -> view-file-detailed **
     fileview-icon                  ?? (duplicate of view-icon?)
                                       (view-file-icons?) **
     fileview-multicolumn           -> view-file-multicolumn **
     fileview-preview               -> view-file-preview **
     fileview-text                  -> view-file-text **
     fileview-split                 -> view-right-new **
     fill                           -> draw-fill ** (not in ArtLibreSet,
                                       but consistent with the naming)
     flag(-black,blue,...)          ?? (eeevil!) (use cases?)
     folder-new                     OK
     fork                           ?? (use cases?)
     format-font-size-less          OK **
     format-font-size-more          OK **
     format-indent-less             OK
     format-indent-more             OK
     format-justify-center          OK
     format-justify-left            OK
     format-justify-right           OK
     format-justify-fill            OK
     format-line-spacing-double     OK **
     format-line-spacing-normal     OK **
     format-line-spacing-triple     OK **
     format-text-bold               OK
     format-text-italic             OK
     format-text-strikethrough      OK
     format-text-underline          OK
     format-text-direction-ltr      Needed
     format-text-direction-rtl      Needed
     format-text-subscript          OK ** (ArtLibreSet)
     format-text-superscript        OK ** (ArtLibreSet)
     frame-edit                     ??
     games-difficult                ??
     games-highscores               ??
     games-hint                     ??
     gear                           ?? (eeevil!) (use cases?)
     get-hot-new-stuff              ??
     go-bottom                      OK
     go-down                        OK
     go-first                       OK
     go-home                        OK
     go-jump                        OK (KDE 3 name: goto)
     go-jump-locationbar            OK ** (KDE 3 name: key_enter)
     go-jump-today                  OK ** (KDE 3 name: today)
     go-last                        OK
     go-next                        OK
     go-previous                    OK
     go-top                         OK
     go-up                          OK
     help-about                     OK
     help-about-kde                 OK ** (KDE 3 name: about_kde)
     help-contents                  OK (KDE 3 name: contents, or contents2)
     help-contextual                OK * (KDE 3 name: contexthelp)
     help-faq                       Needed (but not used in KDE currently)
     history                        ?? (use cases?)
     images-display                 ?? (use cases?)
     insert-image                   OK
     insert-link                    Needed
     insert-table                   OK *
     insert-text                    OK
     insert-object                  Needed
     kgpg-export-kgpg               ??
     kgpg-identity-kgpg             ??
     kgpg-import-kgpg               ??
     kgpg-info-kgpg                 ??
     kgpg-key1-kgpg                 ??
     kgpg-key1-kopete               ??
     kgpg-key2-kgpg                 ??
     kgpg-key2-kopete               ??
     kgpg-key3-kgpg                 ??
     kgpg-key3-kopete               ??
     kgpg-key4-kgpg                 ??
     kgpg-sign-kgpg                 ??
     kgpg-term-kgpg                 ?? (use cases?)
     knotes-delete-knotes           ??
     kontact-contacts               ??
     kontact-date                   ??
     kontact-journal                ??
     kontact-mail                   ??
     kontact-news                   ??
     kontact-notes                  ??
     kontact-summary                ??
     kontact-todo                   ??
     konv-message                   ??
     konv-message2                  ??
     kscd-dock                      ??
     laptop-charge-klaptopdaemon    ?? (probably remove in favor
                                        of battery-charging)
     laptop-nobattery-klaptopdeamon ?? (probably status/battery-error?)
     laptop-nocharge-klaptopdaemon  ?? (probably remove in favor
                                        of battery)
     launch                         ?? (use cases?)
     list-add                       OK (KDE 3 name: add)
     list-add-font                  OK ** (KDE 3 name: newfont)
     list-add-user                  OK ** (KDE 3 name: add_user)
     list-remove                    OK (KDE 3 name: remove)
     list-remove-user               OK ** (KDE 3 name: delete_user)
     mail-flag                      ?? (use cases?)
     mail-forward                   OK
     mail-mark-important            Needed
     mail-mark-notjunk              OK (KDE 3 names: mail_ham, kmmsg_ham)
     mail-mark-junk                 Needed
     mail-mark-read                 Needed
     mail-mark-unread               Needed
     mail-message-new               OK
     mail-queue                     ?? (use cases?)
     mail-receive                   OK *
     mail-reply-all                 OK
     mail-reply-sender              OK
     mail-reply-list                OK **
     mail-send                      OK
     mail-send-receive              Needed
     media-eject                    OK
     media-equalizer                ??
     media-playback-pause           OK
     media-playback-start           OK
     media-playback-stop            OK
     media-playlist                 ??
     media-podcast                  ??
     media-record                   OK
     media-scripts                  ??
     media-seek-backward            OK
     media-seek-forward             OK
     media-skip-backward            OK
     media-skip-forward             OK
     network                        ?? (use cases?)
     news-subscribe                 OK **
     news-unsubscribe               OK **
     object-flip-horizontal         Needed
     object-flip-vertical           Needed
     object-rotate-left             OK
     object-rotate-right            OK
     ok                             ?? (probably remove in favor of
                                        dialog-ok)
     openterm                       ?? (duplicate of commandprompt?)
     player-time                    ?? (use cases?)
     player-volume                  ?? (use cases?)
     print-frame                    -> document-print-frame **
     process-stop                   OK (Note: Only in CVS,
                                        not yet in 0.8 of the spec.)
     project-open                   OK ** (KDE 3 name: project_open)
     rating                         ?? (use cases?)
     roll                           ?? (used in games for dice rolls)
     transform-rotate               OK ** (ArtLibreSet)
                                       (KDE 3 name: rotate)
     rss                            ?? (use cases?)
     rss-tag                        ?? (use cases?)
     run-build                      OK ** (KDE 3 name: make_kdevelop)
     run-build-rebuild              -> unused, svn rm **
     run-build-file                 OK ** (KDE 3 name: compfile)
     search-filter                  ?? (use cases?)
     services                       ?? (use cases?)
     show-offliners                 ?? (use cases?)
     signature                      ?? (use cases?)
     speaker                        ?? (use cases?)
     system-lock-screen             OK
     system-log-out                 OK
     system-run                     OK (KDE 3 name: exec)
     system-search                  OK (suggest to rename to
                                        system-find, for consistency)
     system-switch-user             OK * (KDE 3 name: switchuser)
     table                          ?? (use cases?)
     tab-detach                     OK * (KDE 3 name: tab_breakoff)
     tab-duplicate                  OK * (KDE 3 name: tab_duplicate)
     tab-new-background             OK ** (KDE 3 name: tab_new_bg)
     tab-new                        OK * (KDE 3 names: tab_new, tab_new_raised)
     tab-close                      OK * (KDE 3 name: tab_remove)
     text                           -> draw-text ** (ArtLibreSet)
     thumbnail-show                 -> view-preview **
                                       (except for the KDEPIM .desktop files
                                        which get preferences-desktop-theme)
     tools-check-spelling           OK
     user                           ?? (places/user?) (use cases?)
     user-female                    ?? (places/user-female?) (use cases?)
     users                          ?? (use cases?)
     view-calendar-day              OK ** (KDE 3 name: 1day)
     view-calendar-workweek         OK ** (KDE 3 name: 5days)
     view-calendar-week             OK ** (KDE 3 name: 7days)
     view-calendar-list             OK ** (KDE 3 name: list)
     view-calendar-month            OK ** (KDE 3 name: month)
     view-calendar-tasks            OK ** (KDE 3 name: todo)
     view-calendar-upcoming-events  OK ** (KDE 3 name: whatsnext)
     view-calendar-upcoming-days    OK ** (KDE 3 name: xdays)
     view-choose                    ??
     view-close                     OK **? view-merge **?
                                       (KDE 3 name: view_remove)
     view-fullscreen                OK
     view-icon                      ?? (duplicate of fileview-icon?)
     view-left-right                OK ** (copy to view-split **?)
     view-process-all               OK **
     view-process-all-tree          OK **
     view-process-own               OK **
     view-process-system            OK **
     view-process-users             OK **
     view-refresh                   OK
     view-restore                   OK
     view-sidetree                  ??
     view-sort-ascending            Needed
     view-sort-descending           Needed
     view-tree                      ??
     wallet-closed                  -> move to status/
     wallet-open                    -> move to status/
     window-close                   OK
     window-new                     OK
     window-suppressed              ?? (should probably go to status/)
                                    (Epiphany uses popup-hidden, but I
                                     think that's not a really good name)
     zoom-original                  OK
     zoom-best-fit                  -> zoom-fit-best *
     zoom-in                        OK
     zoom-out                       OK
    
     *  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
    

    To do for Oxygen

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

     address-book-new
       The icon used for the action to create a new address book.
       (or "new-address-book", depending on the outcome
        of the discussion.)
    
     appointment-new
       The icon used for the action to create a new appointment
       in a calendaring application. (or "new-appointment",
       depending on the outcome of the discussion)
    
     document-page-setup
       The icon for the page setup action of a document editor.
    
     edit-find-replace
       The icon for the find and replace action.
    
     edit-select-all
       The icon for the select all action.
    
     format-text-direction-ltr
       The icon for the left-to-right text formatting action.
    
     format-text-direction-rtl
       The icon for the right-to-left formatting action.
    
     help-about
       The icon for the About item in the Help menu.
       (Editor's note: not used in KDE, probably a copy of
        the "(i)" icon is sufficient.)
    
     help-faq
       The icon for the FAQ item in the Help menu.
       (Editor's note: not used in KDE either, at the moment.)
    
     insert-link
       The icon for the insert link action of an application.
    
     insert-object
       The icon for the insert object action of an application.
    
     mail-mark-important
       The icon for the mark as important action of an
       electronic mail application.
    
     mail-mark-junk
       The icon for the mark as junk action of an
       electronic mail application.
    
     mail-mark-read
       The icon for the mark as read action of an
       electronic mail application.
    
     mail-mark-unread
       The icon for the mark as unread action of an
       electronic mail application.
    
     mail-send-receive
       The icon for the send and receive action of an
       electronic mail application.
    
     object-flip-horizontal
       The icon for the action to flip an object horizontally.
    
     object-flip-vertical
       The icon for the action to flip an object vertically.
    
     view-sort-ascending
       The icon used for the "Sort Ascending" item in the
       application's "View" menu, or in a button for
       changing the sort method for a list.
    
     view-sort-descending
       The icon used for the "Sort Descending" item in the
       application's "View" menu, or in a button for
       changing the sort method for a list.
    

    Summary of the suggested changes and additions

    The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

     archive-extract
       The icon used for the action that extracts files and directories
       from an archive.
    
     archive-insert
       The icon used for the action that inserts files and directories
       into an archive.
    
     archive-remove
       The icon used for the action that removes files and directories
       from an archive.
    
     dialog-apply
       The icon used for the "Apply" button that might appear
       in dialog windows.
    
     help-contextual
       The icon for the contextual help / "What's this" icon
       in the Help menu.
    
     insert-table
       The icon for the insert table action of an application.
    
     mail-receive
       The icon for the receive action of an
       electronic mail application.
    
     mail-reply-sender -> mail-reply
       (Rationale: In order to support more reply methods than
        the expected ones. KMail, at least, has "Reply" as
        "intelligent reply" - automatically do the right thing -
        and also "Reply to all", "Reply to author" and
        "Reply to mailing list". The latter is not in the spec,
        and doesn't need to be, but in order to enable
        mail-reply-list, we need a mail-reply fallback.)
    
     system-switch-user
       The icon used for the "Switch User" item in the
       desktop's panel application.
    
     system-search -> system-find
       The icon used for the "Find Files/Folders" item in the
       desktop's panel application.
       (Rationale: For consistency - edit-find also uses Find,
        and there's no good reason to use Search here.)
    
     tab-detach
       The icon used for the "Detach Tab" action.
    
     tab-duplicate
       The icon used for the "Duplicate Tab" action.
    
     tab-new
       The icon used for the "New Tab" action.
    
     tab-close
       The icon used for the "Close Tab" action.
    
     zoom-fit-height
       The icon used for the "Zoom to Height" item
       in the application's "View" menu.
       
     zoom-fit-width
       The icon used for the "Zoom to Width" item
       in the application's "View" menu.
       
     zoom-fit-best (instead of zoom-best-fit)