Projects/Oxygen/namingSpec/actions: Difference between revisions

    From KDE TechBase
    (Discussed the RSS feed icons with dobey, here is the result. Also update some other removals and plans, seems I'm making progress after all.)
    (signature has been moved to document-sign.)
    Line 55: Line 55:
      document-save-as              OK (KDE 3 name: filesaveas)
      document-save-as              OK (KDE 3 name: filesaveas)
      document-save-all              OK * (KDE 3 name: save_all)
      document-save-all              OK * (KDE 3 name: save_all)
    document-sign                  OK ** (KDE 3 name: signature)
      draw-brush                    OK ** (ArtLibreSet)
      draw-brush                    OK ** (ArtLibreSet)
      draw-eraser                    OK ** (ArtLibreSet)
      draw-eraser                    OK ** (ArtLibreSet)
    Line 222: Line 223:
                                       (-> view-menu-toggle **?)
                                       (-> view-menu-toggle **?)
                                       (-> view-menu **?)
                                       (-> view-menu **?)
    signature                      ?? (-> document-sign **?)
                                      (-> status/mail-signed?)
                                      (use cases?)
      speaker                        ?? (use cases?)
      speaker                        ?? (use cases?)
      system-lock-screen            OK (KDE 3 name: lock)
      system-lock-screen            OK (KDE 3 name: lock)

    Revision as of 17:33, 2 January 2008

    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                     -> svn rm
     arrow-down-double              -> svn rm
     arrow-left                     -> svn rm
     arrow-left-double              -> svn rm
     arrow-right                    -> svn rm
     arrow-right-double             -> svn rm
     arrow-up                       -> svn rm
     arrow-up-double                -> svn rm
     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)
     bookmark-new                   OK * (KDE 3 name: bookmark_add)
     bookmark-new-list              OK ** (KDE 3 name: bookmark_list_add)
     bookmark-toolbar               ?? (use case: "Set as toolbar folder")
     character-set                  ?? (use cases?)
     chronometer                    ?? (use cases?)
     color-fill                     -> object-fill-color **
     color-line                     -> object-stroke-color **
     color-picker                   OK ** (ArtLibreSet)
     configure                      OK **? (-> configure-other?)
     configure-shortcuts            OK **
     configure-toolbars             OK **
     contact-new                    OK
     dialog-cancel                  OK (KDE 3 name: button_cancel)
     dialog-close                   OK (KDE 3 name: fileclose)
     dialog-ok                      OK (KDE 3 names: button_ok, ok)
     dialog-ok-apply                OK ** (KDE 3 name: apply)
     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 (KDE 3 name: filenew)
     document-open                  OK (KDE 3 name: fileopen)
     document-open-recent           OK (did not exist in KDE 3)
     document-open-remote           OK ** (did not exist in KDE 3)
     document-page-setup            Needed
     document-preview               OK * (did not exist in KDE 3)
     document-preview-archive       OK ** (KDE 3 name: ark_view)
     document-print                 OK (KDE 3 name: fileprint)
     document-print-preview         OK (KDE 3 name: filequickprint)
     document-print-frame           OK ** (KDE 3 name: frameprint)
     document-properties            OK (KDE 3 names:
                                        documentinfo, edit)
     document-revert                OK (KDE 3 name: revert)
     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-sign                  OK ** (KDE 3 name: signature)
     draw-brush                     OK ** (ArtLibreSet)
     draw-eraser                    OK ** (ArtLibreSet)
     draw-freehand                  OK ** (ArtLibreSet)
     edit-clear                     OK (Note: Only in CVS,
                                        not yet in 0.8 of the spec.)
                                       (KDE 3 name: editclear)
     edit-clear-list                OK ** (KDE 3 origin: view_remove)
     edit-clear-history             OK ** (KDE 3 name: history_clear)
     edit-clear-locationbar-ltr     OK ** (KDE 3 name: locationbar_erase)
     edit-clear-locationbar-rtl     OK ** (KDE 3 name: clear_left)
     edit-copy                      OK (KDE 3 name: editcopy)
     edit-cut                       OK (KDE 3 name: editcut)
     edit-delete                    OK * (KDE 3 name: editdelete)
     edit-delete-shred              OK ** (KDE 3 name: editshred)
     edit-delete-mail               OK ** (KDE 3 name: mail_delete)
     knotes-delete-knotes           -> edit-delete-note
     edit-find                      OK (KDE 3 name: find)
     edit-find-replace              Needed (KDE 3 name: apps/kfilereplace)
     edit-find-mail                 OK ** (KDE 3 name: mail_find)
     edit-find-user                 OK ** (KDE 3 name: search_user)
     edit-paste                     OK (KDE 3 name: editpaste)
     edit-redo                      OK (KDE 3 name: redo)
     edit-rename                    OK ** (KDE 3 name: editinput)
     edit-select-all                OK (KDE 3 name: ark_selectall)
     edit-undo                      OK (KDE 3 name: undo)
     favorites                      ?? (view-favorites?)
                                       (svn rm, in favor of view-bookmarks?)
                                       (use cases?)
     flag(-black,blue,...)          ?? (eeevil!) (use cases?)
     folder-new                     OK (KDE 3 name: folder_new)
     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-list-ordered            OK **
     format-list-unordered          OK **
     format-text-bold               OK
     format-text-italic             OK
     format-text-strikethrough      OK
     format-text-underline          OK
     format-text-direction-ltr      OK
     format-text-direction-rtl      OK
     format-text-subscript          OK ** (ArtLibreSet)
     format-text-superscript        OK ** (ArtLibreSet)
     frame-edit                     ?? (use cases?)
     games-config-background        ?? (probably a candidate for apps/)
     games-config-board             ?? (probably a candidate for apps/)
     games-config-custom            ?? (probably a candidate for apps/)
     games-config-tiles             ?? (probably a candidate for apps/)
     games-config-options           ?? (probably a candidate for apps/)
     games-config-theme             ?? (probably a candidate for apps/)
     games-difficult                ??
     games-endturn                  ??
     games-highscores               ??
     games-hint                     -> help-hint-game
     games-solve                    ??
     get-hot-new-stuff              probably OK **, even if highly
                                     non-standard. is pretty unique
                                     and used as an action icon
                                     (with no associated executable).
     go-bottom                      OK (KDE 3 name: bottom)
     go-down                        OK (KDE 3 name: down)
     go-down-search                 OK ** (did not exist in KDE 3)
     go-first                       OK (KDE 3 name: start)
     go-home                        OK (KDE 3 name: gohome)
     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 (KDE 3 name: finish)
     go-next                        OK (KDE 3 name: forward)
     go-previous                    OK (KDE 3 name: back)
     go-top                         OK (KDE 3 name: top)
     go-up                          OK (KDE 3 name: up)
     go-up-search                   OK ** (did not exist in KDE 3)
     help-about                     OK
     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)
     help-hint                      OK ** (KDE 3 name: idea)
     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-key2-kgpg                 ??
     kgpg-key3-kgpg                 ??
     kgpg-key4-kgpg                 ??
     kgpg-sign-kgpg                 ??
     kgpg-term-kgpg                 ?? (use cases?)
     konv-message                   -> status/dock-konversation-flashing **
     konv-message2                  ??
     kscd-dock                      -> status/dock-kscd
                                       (or use the standard
                                        kscd icon altogether)
     list-add                       OK (KDE 3 names: add, edit_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, edit_remove)
     list-remove-user               -> edit-delete-user? or OK **
                                       (KDE 3 name: delete_user)
     mail-flag                      ?? (use cases?)
     mail-forward                   OK (KDE 3 name: mail_forward)
     mail-mark-important            OK
     mail-mark-notjunk              OK (KDE 3 names: mail_ham, kmmsg_ham)
     mail-mark-junk                 Needed
     mail-mark-read                 OK
     mail-mark-unread               OK
     mail-message-new               OK (KDE 3 names: mail_new, mail_new3,
                                        mail_post_to, mail_post_to3)
     mail-queue                     OK ** (use case: "Send later")
                                       (KDE 3 name: queue)
     mail-receive                   OK * (KDE 3 name: mail_get)
     mail-reply-all                 OK (KDE 3 name: mail_replyall)
     mail-reply-sender              OK (did not exist in KDE 3)
     mail-reply-list                OK ** (KDE 3 name: mail_replylist)
     mail-send                      OK (KDE 3 name: mail_send)
     mail-send-receive              Needed (did not exist in KDE 3)
     media-eject                    OK
     media-playback-pause           OK
     media-playback-start           OK
     media-playback-stop            OK
     media-record                   OK
     media-seek-backward            OK
     media-seek-forward             OK
     media-skip-backward            OK
     media-skip-forward             OK
     network-connect                OK ** (KDE 3 name: connect_established)
     network-disconnect             OK ** (KDE 3 name: connect_no)
     news-subscribe                 OK **
     news-unsubscribe               OK **
     object-flip-horizontal         Needed
     object-flip-vertical           Needed
     object-rotate-left             OK (KDE 3 name: rotate_ccw)
     object-rotate-right            OK (KDE 3 name: rotate_cw)
     player-time                    ?? (view-media-player-time?)
                                       (use cases?)
     player-volume                  ?? (view-media-player-volume?)
                                       (use cases?)
     process-stop                   OK (KDE 3 name: stop)
                                       (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)
     rss                            -> mimetypes/application-rss+xml
     rss-tag                        -> feed-subscribe **
                                       (KDE 3 name: rss_tag)
     run-build                      OK ** (KDE 3 name: make_kdevelop)
     run-build-file                 OK ** (KDE 3 name: compfile)
     services                       ?? (use cases?)
                                       (-> view-services **?)
     show-menu                      ?? (-> view-menu-show **?)
                                       (-> view-menu-toggle **?)
                                       (-> view-menu **?)
     speaker                        ?? (use cases?)
     system-lock-screen             OK (KDE 3 name: lock)
     system-log-out                 OK (KDE 3 origin: back)
     system-run                     OK (KDE 3 name: exec)
     system-search                  OK
     system-suspend                 OK * (KDE 3 name: suspend)
     system-suspend-hibernate       OK (KDE 3 name: hibernate)
     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)
     text-speak                     OK ** (KDE 3 name: speak?)
     tools-check-spelling           OK (KDE 3 name: spellcheck)
     tools-media-optical-burn       OK **
     tools-media-optical-copy       -> move to (lib?)k3b
     tools-report-bug               OK ** (KDE 3 origin: kbugbuster)
     transform-rotate               OK ** (ArtLibreSet)
                                       (KDE 3 name: rotate)
     trash-empty                    OK ** (KDE 3 name: emptytrash)
     user-group-new                 OK ** (KDE 3 name - private
                                           to KUser: add_group)
     user-properties                OK ** (KDE 3 name: edit_user)
     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-filter                    OK **
     view-fullscreen                OK
     view-history                   OK ** (KDE 3 name: history)
     view-media-artist              OK ** (KDE 3 origin: identity)
     view-media-equalizer           OK ** (KDE 3 name: equalizer)
     view-media-lyrics              OK ** (KDE 3 origin: text_center)
     view-media-visualization       OK ** (KDE 3 name: visualizations)
     view-media-playlist            -> move to extragear/multimedia/amarok,
                                       or OK ** (KDE 3 names:
                                         player_playlist, player_playlist_2)
     view-pim-contacts              OK ** (KDE 3 name: kontact_contacts)
     view-pim-calendar              OK ** (KDE 3 name: kontact_date)
     view-pim-journal               OK ** (KDE 3 name: kontact_journal)
     view-pim-mail                  OK ** (KDE 3 name: kontact_mail)
     view-pim-news                  OK ** (KDE 3 name: kontact_news)
     view-pim-notes                 OK ** (KDE 3 name: kontact_notes)
     view-pim-summary               OK ** (KDE 3 name: kontact_summary)
     view-pim-tasks                 OK ** (KDE 3 name: kontact_todo)
     view-presentation              OK ** (KDE 3 name: kpresentation_kpr)
     view-preview                   OK **
     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-sidebar-right **
     view-sort-ascending            OK
     view-sort-descending           OK
     view-list-details              OK **
     view-list-icons                OK **
     view-list-text                 OK **
     view-list-tree                 OK **
     view-file-columns              -> move to Dolphin
     view-left-close                -> move to Dolphin
     view-right-close               -> move to Dolphin
     view-right-new                 -> move to Dolphin
     view-split-left-right          -> view-split-horizontal **
     view-split-top-bottom          -> view-split-vertical **
     view-statistics                OK **
     view-web-browser-dom-tree      -> move to extragear/base/[domtree-plugin]
     window-close                   OK (KDE 3 origin: fileclose)
     window-new                     OK (KDE 3 name: window_new)
     window-suppressed              ?? (-> status/popup-suppressed?)
                                    (Epiphany uses popup-hidden, but I
                                     think that's not a really good name)
     zoom-original                  OK (KDE 3 name: viewmag1)
     zoom-best-fit                  -> zoom-fit-best (in the CVS version
                                       of the spec, 0.8.90)
                                       (KDE 3 name: viewmagfit)
     zoom-in                        OK (KDE 3 name: viewmag+)
     zoom-out                       OK (KDE 3 name: viewmag-)
    
     *  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
     *** badly named in the spec imho, let's try to get this changed
    

    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.
    
     appointment-new
       The icon used for the action to create a new appointment
       in a calendaring application.
    
     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.
    
     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-junk
       The icon for the mark as junk 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.
    

    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.
    
     document-export
       The icon used for the action that saves all or part of
       the current document, often in a format that cannot be
       opened again with this application.
    
     document-import
       The icon used for the action that adds the contents of
       external files to the current document.
    
     document-preview
       The icon used for previewing a document in read-only mode.
    
     document-print-preview
       Should probably be document-preview-print, so that there's
       a possibility of having document-preview (which is a better
       fallback anyways than document-print).
    
     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-mark-notjunk
       ...ok from my point of view, but notify the Tango people
       that they use mail-mark-not-junk (note the additional dash)
       in their theme, as opposed to the spec.
    
     mail-receive
       The icon for the receive action of an
       electronic mail application.
    
     system-switch-user
       The icon used for the "Switch User" item in the
       desktop's panel application.
    
     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.
    
     system-suspend
       The icon used for the "Suspend Computer" 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)