Projects/Oxygen/namingSpec/actions: Difference between revisions

From KDE TechBase
(edit-find-{next,previous} is bad because it falls back to edit-find. Plan to rename those.)
(Suggest to rename document-print-preview to document-preview-print.)
Line 58: Line 58:
  document-preview-archive      OK ** (KDE 3 name: ark_view)
  document-preview-archive      OK ** (KDE 3 name: ark_view)
  document-print                OK (KDE 3 name: fileprint)
  document-print                OK (KDE 3 name: fileprint)
  document-print-preview        OK (KDE 3 name: filequickprint)
  document-print-preview        OK *** (KDE 3 name: filequickprint)
  document-print-frame          OK ** (KDE 3 name: frameprint)
  document-print-frame          OK ** (KDE 3 name: frameprint)
  document-properties            OK (KDE 3 names:
  document-properties            OK (KDE 3 names:
Line 332: Line 332:
  ** not in the spec, but let's keep it out of there anyways,
  ** not in the spec, but let's keep it out of there anyways,
     it's not really suited to be a standard icon
     it's not really suited to be a standard icon
*** badly named in the spec imho, let's try to get this changed
</pre>
</pre>


Line 412: Line 413:
   The icon used for the action that adds the contents of
   The icon used for the action that adds the contents of
   external files to the current document.
   external files to the current document.
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
  help-contextual

Revision as of 10:32, 25 December 2007

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 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)
 domtreeviewer                  -> view-web-browser-dom-tree **
 draw-brush                     OK ** (ArtLibreSet)
 draw-eraser                    OK ** (ArtLibreSet)
 draw-freehand                  OK ** (ArtLibreSet)
 edit                           -> rename all usages to
                                   document-properties or 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                 -> go-down-search **
                                   (did not exist in KDE 3)
 edit-find-previous             -> go-up-search **
                                   (did not exist in KDE 3)
 edit-find-user                 OK (-> unused... delete?) **
                                   (KDE 3 name: search_user)
 edit-paste                     OK (KDE 3 name: editpaste)
 edit-redo                      OK (KDE 3 name: redo)
 edit-rename                    OK **
 edit-select-all                OK (KDE 3 name: ark_selectall)
 edit-undo                      OK (KDE 3 name: undo)
 edit-user                      -> user-properties **
                                   (KDE 3 name: edit_user)
 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                        -> svn rm, after porting all usages
                                   to 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            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
 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 **? possible to replace
                                    with document-properties?)
 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?)
 show-menu                      ?? (-> view-menu-show **?)
                                   (-> view-menu-toggle **?)
 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)
 text-speak                     OK ** (KDE 3 name: speak?)
 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 **
 user-female                    -> places/user-identity-female **
 user-group-new                 OK ** (KDE 3 name - private
                                       to KUser: add_group)
 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-icon                      ?? (duplicate of fileview-icon?)
 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-left-right                -> view-split-horizontal **
 view-top-bottom                -> view-split-vertical **
 view-statistics                OK **
 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
 *** 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.

 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.

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

 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)