Projects/Oxygen/namingSpec/actions

From KDE TechBase
Revision as of 19:03, 2 December 2007 by Jpetso (talk | contribs) (If it's for me, we can keep get-hot-new-stuff.)

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")
 camera-test                    -> svn rm (has no use case, and usage
                                    as "Manually added cameras" -
                                    in Digikam only - is wrong)
 cd-data                        -> svn rm, in favor
                                   of media-optical-data
 cd                             -> svn rm, in favor of media-optical
 character-set                  ?? (use cases?)
 chronometer                    ?? (use cases?)
 color-fill                     -> fill-color **
                                   (change proposed for ArtLibreSet)
 color-line                     -> draw-line-color **
                                   (draw-line is in ArtLibreSet)
 color-picker                   OK ** (ArtLibreSet)
 configure                      OK **
 configure-shortcuts            OK **
 configure-toolbars             OK **
 connection-established         -> status/network-idle
 connect-no                     -> status/network-offline
 contact-new                    OK
 datashow                       ?? (use cases?) (view-[something]?)
 datashowchart                  ?? (use cases?) (view-[something]?)
 dialog-apply                   -> dialog-ok-apply **
 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 (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-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 name: documentinfo)
 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)
 domtreeviewer                  -> view-web-browser-dom-tree **
 edit                           -> rename all usages to object-edit
                                   (and then needs to be removed
                                    under all circumstances, so that
                                    it's not used as fallback)
 edit-add                       ?? (probably remove in favor of
                                    list-add) (KDE 3 name: edit_add)
 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         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-next                 OK ** (did not exist in KDE 3)
 edit-find-previous             OK ** (did not exist in KDE 3)
 edit-find-user                 OK (-> unused... delete?) **
                                   (KDE 3 name: search_user)
 editinput                      -> svn rm, after porting usages
                                   to "edit-rename"
 edit-paste                     OK (KDE 3 name: editpaste)
 edit-redo                      OK (KDE 3 name: redo)
 edit-rename                    OK **
 edit-select-all                Needed (KDE 3 name: ark_selectall)
 edit-undo                      OK (KDE 3 name: undo)
 edit-user                      ?? (KDE 3 name: edit_user)
 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                           OK **
 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-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                     ??
 games-solve                    ??
 gear                           ?? (eeevil!) (use cases?)
 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
 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                        -> view-history **
 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                   ??
 konv-message2                  ??
 kscd-dock                      ??
 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                     OK ** (use case: "Send later")
 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-playback-pause           OK
 media-playback-start           OK
 document-start-presentation    -> media-playback-start-presentation **
 media-playback-stop            OK
 media-record                   OK
 media-scripts                  ??
 media-seek-backward            OK
 media-seek-forward             OK
 media-skip-backward            OK
 media-skip-forward             OK
 network                        ?? (places/network **?) (use cases?)
 news-subscribe                 OK **
 news-unsubscribe               OK **
 object-edit                    OK ** (KDE 3 name: edit)
 object-flip-horizontal         Needed
 object-flip-vertical           Needed
 object-rotate-left             OK
 object-rotate-right            OK
 ok                             ?? (probably remove in favor of
                                    dialog-ok)
 player-time                    ?? (use cases?)
 player-volume                  ?? (use cases?)
 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)
 rss                            ?? (use cases?)
 rss-tag                        ?? (use cases?)
 run-build                      OK ** (KDE 3 name: make_kdevelop)
 run-build-file                 OK ** (KDE 3 name: compfile)
 services                       ?? (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
 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)
 tools-check-spelling           OK
 tools-media-optical-burn       OK **
 tools-media-optical-copy       -> move to (lib?)k3b
 transform-rotate               OK ** (ArtLibreSet)
                                   (KDE 3 name: rotate)
 trash-empty                    OK ** (KDE 3 name: emptytrash)
 user                           ?? (places/user-identity?) (use cases?)
 user-female                    ?? (places/user-identity-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-filter                    OK **
 view-fullscreen                OK
 view-icon                      ?? (duplicate of fileview-icon?)
 view-left-right                OK ** (copy to view-split **?)
 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-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-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-sort-ascending            Needed
 view-sort-descending           Needed
 view-tree                      ??
 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.

 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.

 edit-select-all
   The icon for the select all 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-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.

 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.

 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)