Projects/Oxygen/namingSpec/actions: Difference between revisions

From KDE TechBase
(Yay, all icons from the spec are covered. Now only the current Oxygen ones are still missing.)
(New color-picker-{white,grey,black} icons by johann_ol. Their purpose I don't know, but as the fallback is fine, nothing is lost having those.)
 
(197 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Only partially ready for consumption. JRT already found out about which Oxygen icons already conform to the spec, but the ones that don't conform are not yet listed in here, and there's not yet a plan at the moment on how to proceed with those.
== Specification compliance of icon names ==
== Specification compliance of icon names ==


Line 6: Line 4:


<pre>
<pre>
  about-kde                      -> help-about-kde **
  address-book-new              OK
  add-user                      -> list-add-user **
appointment-new                OK (since 4.1)
  application-exit              OK
application-exit              OK (KDE 3 name: exit)
  ark-adddir                    -> list-add-directory-archive **
arrow-down                    -> svn rm
  ark-addfile                    -> list-add-file-archive **
arrow-down-double              -> svn rm
  ark-delete                     -> list-remove-file-archive **
arrow-left                    -> svn rm
  centrejust                    -> svn rm,
arrow-left-double              -> svn rm
                                  there's already text-center
  arrow-right                    -> svn rm
  compfile                      -> run-build-file **
arrow-right-double            -> svn rm
  delete-user                   -> list-remove-user **
  arrow-up                      -> svn rm
  dialog-apply                   -> dialog-ok
  arrow-up-double                -> svn rm
  dialog-cancel                  OK
archive-insert-directory       OK ** (KDE 3 name: ark_adddir)
  dialog-close                  OK
archive-insert                OK * (KDE 3 name: ark_addfile)
  document-new                  OK (or "new-document", wait for the
archive-remove                OK * (KDE 3 name: ark_delete)
                                    outcome of the discussion)
archive-extract                OK * (KDE 3 name: ark_extract)
  document-open                  OK (or "open", wait for the
  bookmark-new                  OK * (KDE 3 name: bookmark_add)
                                    outcome of the discussion)
bookmark-new-list              -> bookmark-list-new **
  document-open-recent          OK (or "open-recent", wait for the
                                  (or rather bookmarks-new **?)
                                    outcome of the discussion)
                                  (KDE 3 name: bookmark_list_add)
  document-print                OK
bookmark-toolbar              ?? (use case: "Set as toolbar folder")
  document-print-preview        OK
bookmarks-organize            OK ** (KDE 3 origin: bookmark)
  document-properties            OK
  call-start                     Needed (CVS version of the spec)
  document-revert                OK
call-stop                      Needed (CVS version of the spec)
  document-save                  OK (or "save", wait for the
character-set                  ?? (use case: choose character set
                                    outcome of the discussion)
                                    in KWrite and Konqueror
  document-save-as              OK (or "save-as", wait for the
chronometer                    ?? (use cases?)
                                    outcome of the discussion)
color-picker                  OK ** (ArtLibreSet)
  edit                          OK *
color-picker-white            [...whatever] (since 4.2)
  editshred                      -> edit-delete-shred **
  color-picker-grey              [...whatever] (since 4.2)
  edit-add                      OK *
color-picker-black            [...whatever] (since 4.2)
  configure                      OK **? (-> configure-other?)
configure-shortcuts            OK **
  configure-toolbars            OK **
contact-new                   OK
dashboard-show                OK ** (did not exist in KDE 3)
  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-send                  Needed (CVS version of the spec)
  document-sign                  OK ** (KDE 3 name: signature)
  draw-brush                    OK ** (ArtLibreSet)
draw-eraser                    OK ** (ArtLibreSet)
draw-freehand                  OK ** (ArtLibreSet)
  draw-text                      OK ** (ArtLibreSet)
edit-bomb                      ?? (since 4.1)
  edit-clear                    OK (Note: Only in CVS,
  edit-clear                    OK (Note: Only in CVS,
                                     not yet in 0.8 of the spec.)
                                     not yet in 0.8 of the spec.)
  edit-copy                      OK
                                  (KDE 3 name: editclear)
  edit-cut                      OK
edit-clear-list                OK ** (KDE 3 origin: view_remove)
  edit-delete                    OK *
edit-clear-history            OK ** (KDE 3 name: history_clear)
  edit-find                      OK
edit-clear-locationbar-ltr    OK ** (KDE 3 name: locationbar_erase)
  edit-paste                    OK
edit-clear-locationbar-rtl    OK ** (KDE 3 name: clear_left)
  edit-redo                      OK
  edit-copy                      OK (KDE 3 name: editcopy)
  edit-undo                      OK
  edit-cut                      OK (KDE 3 name: editcut)
  edit-user                      OK **
  edit-delete                    OK * (KDE 3 name: editdelete)
                                  (In case "edit" is approved.)
edit-delete-shred              OK ** (KDE 3 name: editshred)
  folder-new                    OK (or "new-folder", wait for the
edit-delete-mail              OK ** (KDE 3 name: mail_delete)
                                    outcome of the discussion)
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-link                     OK ** (16x16 only, please fix)
                                  (KDE 3 origin: www)
  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)
  feed-subscribe                OK ** (KDE 3 name: rss_tag)
flag(-black,blue,...)          ?? (eeevil!) (use cases?)
  folder-new                    OK (KDE 3 name: folder_new)
fork                          ?? (use cases?)
format-fill-color              OK **
format-font-size-less          OK **
format-font-size-more          OK **
  format-indent-less            OK
  format-indent-less            OK
  format-indent-more            OK
  format-indent-more            OK
format-justify-center          OK
format-justify-left            OK
format-justify-right          OK
  format-justify-fill            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-stroke-color            OK **
  format-text-bold              OK
  format-text-bold              OK
format-text-color              ?? (since 4.2) (maybe ok, maybe rather
                                    format-stroke-color-text? oh well.)
  format-text-italic            OK
  format-text-italic            OK
  format-text-strikethrough      OK
  format-text-strikethrough      OK
  format-text-underline          OK
  format-text-underline          OK
  go-bottom                      OK
format-text-direction-ltr      OK
  go-down                        OK
format-text-direction-rtl      OK
  go-first                      OK
format-text-subscript          OK ** (ArtLibreSet)
  go-home                        OK
format-text-superscript        OK ** (ArtLibreSet)
  goto-page                      -> go-jump
games-config-background        ?? (probably a candidate for apps/)
  go-last                        OK
games-config-board            ?? (probably a candidate for apps/)
  go-next                        OK
games-config-custom            ?? (probably a candidate for apps/)
  go-previous                    OK
games-config-tiles            ?? (probably a candidate for apps/)
  go-top                        OK
games-config-options          ?? (probably a candidate for apps/)
  go-up                          OK
games-config-theme            ?? (probably a candidate for apps/)
  help-contents                  OK
games-difficult                ??
  help-whatsthis                -> help-contextual *
games-endturn                  ??
  identity                      -> contact-new
games-highscores              ??
                                  (maybe add a "new" sparkle?)
games-hint                    -> help-hint-game
  list-add                       OK
games-solve                    ??
  list-remove                    OK
get-hot-new-stuff              probably OK **, even if highly
  mail-delete                    -> edit-delete-mail
                                non-standard. is pretty unique
  mail-forward                  OK
                                and used as an action icon
  mail-get                      -> mail-receive *
                                (with no associated executable).
  mail-ham                      -> mail-mark-notjunk
  go-bottom                      OK (KDE 3 name: bottom)
  mail-message-new              OK (or "new-message-mail", wait for the
  go-down                        OK (KDE 3 name: down)
                                     outcome of the discussion)
go-down-search                OK ** (did not exist in KDE 3)
  mail-new                      -> svn rm, in favor of mail-message-new
  go-first                      OK (KDE 3 name: start)
  mail-reply-all                OK
go-first-view                  OK ** (KDE 3 name: start/2leftarrow)
  mail-reply-sender              OK with the current spec, but in order
go-first-view-page            OK ** (KDE 3 name: start/2leftarrow)
                                  to enale mail-reply-list, we rather
  go-home                        OK (KDE 3 name: gohome)
                                  want this to be mail-reply.
  go-jump                        OK (KDE 3 name: goto)
  mail-replylist                -> mail-reply-list ** (see above)
go-jump-locationbar            OK ** (KDE 3 name: key_enter)
  mail-send                      OK
go-jump-today                  OK ** (KDE 3 name: today)
  make-kdevelop                  -> run-build **
  go-last                        OK (KDE 3 name: finish)
go-last-view                  OK ** (KDE 3 name: finish/2rightarrow)
go-last-view-page              OK ** (KDE 3 name: finish/2rightarrow)
  go-next                        OK (KDE 3 name: forward)
go-next-view                  OK ** (KDE 3 name: forward/1rightarrow)
go-next-view-page              OK ** (KDE 3 name: forward/1rightarrow)
  go-previous                    OK (KDE 3 name: back)
go-previous-view              OK ** (KDE 3 name: back/1leftarrow)
go-previous-view-page          OK ** (KDE 3 name: back/1leftarrow)
  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-horizontal-rule        OK **
insert-image                  OK
insert-link                    OK
insert-table                  OK *
  insert-text                    OK
insert-object                  Needed
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                OK
  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-eject                    OK
  media-playback-pause          OK
  media-playback-pause          OK
  media-playback-start          OK
  media-playback-start          OK
  media-playback-stop            OK
  media-playback-stop            OK
media-playlist-clear          -> edit-clear-playlist **
media-playlist-refresh        -> view-refresh-playlist **
  media-record                  OK
  media-record                  OK
  media-seek-backward            OK
  media-seek-backward            OK
Line 97: Line 202:
  media-skip-backward            OK
  media-skip-backward            OK
  media-skip-forward            OK
  media-skip-forward            OK
  newfont                        -> list-add-font
  network-connect                OK ** (KDE 3 name: connect_established)
  object-rotate-left            OK
network-disconnect            OK ** (KDE 3 name: connect_no)
  object-rotate-right            OK
news-subscribe                OK **
  process-stop                  OK (Note: Only in CVS,
news-unsubscribe              OK **
object-flip-horizontal        OK
object-flip-vertical          OK
  object-rotate-left            OK (KDE 3 name: rotate_ccw)
  object-rotate-right            OK (KDE 3 name: rotate_cw)
object-group                  OK ** (since 4.2) (16x16 only?)
object-ungroup                OK ** (since 4.2) (16x16 only?)
object-order-back              OK ** (since 4.2) (16x16 only?)
object-order-front            OK ** (since 4.2) (16x16 only?)
object-order-lower            OK ** (since 4.2) (16x16 only?)
object-order-raise            OK ** (since 4.2) (16x16 only?)
page-zoom                      OK ** (KDE 3 name: viewmag)
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.)
                                     not yet in 0.8 of the spec.)
  save-all                       -> document-save-all *
  project-open                  OK ** (KDE 3 name: project_open)
                                   (or save-all *, wait for the
rating                        ?? (use cases?)
                                    outcome of the discussion)
roll                          ?? (used in games for dice rolls)
switchuser                    -> system-switch-user *
run-build                      OK ** (KDE 3 name: make_kdevelop)
  system-lock-screen            OK
run-build-file                OK ** (KDE 3 name: compfile)
  system-log-out                OK
select-rectangular            OK ** (ArtLibreSet)
  system-run                    OK (or "run", wait for the
services                       ?? (use cases?)
                                    outcome of the discussion)
                                  (-> places/user-services **?)
  system-search                  OK (suggest to rename to system-find,
                                   (-> view-services **?)
                                    for consistency)
show-menu                      ?? (-> view-menu-show **?)
  tab-breakoff                  -> tab-detach *
                                  (-> view-menu-toggle **?)
  tab-duplicate                  OK *
                                  (-> view-menu **?)
  tab-new                       -> tab-new-background **
speaker                        ?? (use cases?)
  tab-new-raised                 -> tab-new *
  system-lock-screen            OK (KDE 3 name: lock)
  tab-remove                     -> tab-close *
  system-log-out                OK (KDE 3 origin: back)
                                   (in accordance to window-close)
system-restart                -> system-reboot * (agreed upon
  text-center                   -> format-justify-center
                                  by GNOME, XFCE and KDE maintainers)
  text-left                      -> format-justify-left
                                  (KDE 3 origin: reload? i think)
  text-right                    -> format-justify-right
  system-run                    OK (KDE 3 name: exec)
  tools-check-spelling          OK
system-search                  OK (KDE 3 name: kfind)
  viewmag1                      -> zoom-original
system-shutdown                OK * (KDE 3 name: exit)
  view-fullscreen                OK
system-software-install        Needed (CVS version of the spec)
  system-suspend                OK * (KDE 3 name: suspend)
system-suspend-hibernate      -> system-hibernate (agreed upon
                                  by GNOME, XFCE and KDE maintainers)
                                  (KDE 3 name: hibernate)
  system-switch-user            OK * (KDE 3 name: switchuser)
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-move-left                  Needed * New icon (missing in KDE 3)
  tab-move-right                 Needed * New icon (missing in KDE 3)
tab-new                        OK * (KDE 3 name: tab_new)
                                  (KDE 3 name: tab_new_raised)
tab-close                      OK * (KDE 3 name: tab_remove)
  tab-close-other                Needed * (KDE 3 name: tab_remove_other)
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-move                OK ** (ArtLibreSet)
                                  (KDE 3 name: move)
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 ** (KDE 3 name: filter)
view-fullscreen                OK (KDE 3 name: window-fullscreen)
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            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-refresh                  OK
  view-restore                  OK
  view-restore                  OK
  window-close                  OK (or "close-window", wait for the
view-sidetree                  -> view-sidebar-right **
                                    outcome of the discussion)
view-sort-ascending            OK
  window-new                    OK (or "new-window", wait for the
view-sort-descending          OK
                                     outcome of the discussion)
view-list-details              OK **
  zoom-original                  -> svn rm, or zoom *
view-list-icons                OK **
  zoom-best-fit                 -> zoom-fit-best
view-list-text                OK **
  zoom-in                        OK
view-list-tree                OK **
  zoom-out                      OK
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-table-of-contents-ltr    OK ** (since 4.1)
view-table-of-contents-rtl    OK ** (since 4.1)
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)
zoom-original                  OK (KDE 3 name: viewmag1)
zoom-fit-best                  OK (as of the CVS version
                                     of the spec, 0.8.90)
                                  (KDE 3 names:
                                    view_fit_window, viewmagfit)
  zoom-fit-width                OK * (KDE 3 name: view_fit_width)
  zoom-fit-height                OK * (KDE 3 name: view_fit_height)
  zoom-in                        OK (KDE 3 name: viewmag+)
  zoom-out                      OK (KDE 3 name: viewmag-)
 
  *  suggesting this for inclusion into the icon naming specification
  *  suggesting this for inclusion into the icon naming specification
  ** 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 144: Line 349:


<pre>
<pre>
  address-book-new
  call-start
   The icon used for the action to create a new address book.
   The icon used for initiating or accepting a call. Should be
   (or "new-address-book", depending on the outcome of the discussion)
  similar to the standard cellular call pickup icon, a green
  handset with ear and mouth pieces facing upward.
   (Says the spec... I think we can be more flexible.)
 
call-stop
  The icon used for stopping a current call. Should be similar
  to the standard cellular call hangup icon, a red handset
  with ear and mouth pieces facing downward.
  (Says the spec... I think we can be more flexible.)


  appointment-new
  document-send
   The icon used for the action to create a new appointment
   The icon for the send action. Should be an arrow pointing up
   in a calendaring application.
   and away from a hard disk.
   (or "new-appointment", depending on the outcome of the discussion)
   (Says the spec... I think we can be more flexible.)


  document-page-setup
  document-page-setup
Line 158: Line 371:
  edit-find-replace
  edit-find-replace
   The icon for the find and replace action.
   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
  help-faq
   The icon for the FAQ item in the Help menu.
   The icon for the FAQ item in the Help menu.
   (Editor's note: not used in KDE either, at the moment.)
   (Editor's note: not used in KDE either, at the moment.)
insert-image
  The icon for the insert image action of an application.
insert-link
  The icon for the insert link action of an application.


  insert-object
  insert-object
   The icon for the insert object action of an application.
   The icon for the insert object action of an application.
insert-text
  The icon for the insert text 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
  mail-send-receive
Line 209: Line 383:
   electronic mail application.
   electronic mail application.


  object-flip-horizontal
  system-software-install
   The icon for the action to flip an object horizontally.
   The icon used for the desktop's software installer application.
</pre>


object-flip-vertical
== Summary of the suggested changes and additions ==
  The icon for the action to flip an object vertically.


view-sort-ascending
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.
  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
<pre>
   The icon used for the "Sort Descending" item in the
  archive-extract
   application's "View" menu, or in a button for
   The icon used for the action that extracts files and directories
  changing the sort method for a list.
   from an archive.
</pre>


== To do for Oxygen *and* the spec ==
archive-insert
  The icon used for the action that inserts files and directories
  into an archive.


Icons that are neither in the spec nor in Oxygen but should be added to both.
archive-remove
  The icon used for the action that removes files and directories
  from an archive.


<pre>
  document-export
  insert-table
   The icon used for the action that saves all or part of
   The icon for the insert table action of an application.
  the current document, often in a format that cannot be
</pre>
  opened again with this application.


== Summary of the suggested changes and additions ==
document-import
  The icon used for the action that adds the contents of
  external files to the current document.


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.
document-preview
  The icon used for previewing a document in read-only mode.


<pre>
  document-print-preview
  edit
   Should probably be document-preview-print, so that there's
   The icon for the generic edit action.
   a possibility of having document-preview (which is a better
   (Rationale: There are a lot of things that need to be edited:
  fallback anyways than document-print).
    bookmarks, contacts, todos, away messages, fill/stroke colors,
    app specific item properties of any kind, ...
    There should be a generic edit icon as a common ground
    and fallback for these use cases.)


  help-contextual
  help-contextual
Line 256: Line 429:


  mail-receive
  mail-receive
   The icon for the receive action of an electronic mail application.
   The icon for the receive action of an
  electronic mail application.


  system-switch-user
  system-switch-user
   The icon used for the "Switch User" item in the
   The icon used for the "Switch User" item in the
   desktop's panel application.
   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
  tab-detach
Line 274: Line 442:
   The icon used for the "Duplicate Tab" action.
   The icon used for the "Duplicate Tab" action.


  tab-new (or possibly new-tab, see below)
tab-move-left
  tab-remove (or possibly close-tab, see below)
  The icon for the menu action "Window -> Move Tab Left"
 
tab-move-right
  The icon for the menu action "Window -> Move Tab Right"
 
  tab-new
  The icon used for the "New Tab" action.
 
tab-close
  The icon used for the "Close Tab" action.
 
  tab-close-other
  The icon used for the "Close Other Tabs" action.
 
system-suspend
  The icon used for the "Suspend Computer" action.


  zoom-fit-height
  zoom-fit-height
Line 284: Line 467:
   The icon used for the "Zoom to Width" item
   The icon used for the "Zoom to Width" item
   in the application's "View" menu.
   in the application's "View" menu.
 
zoom-fit-best (instead of zoom-best-fit)
</pre>
And now for the radical stuff:
<pre>
new
  The icon for the create action.
  (Rationale: Right now, the spec has quite a number of *-new
    icons, but is totally unflexible when it comes to adding
    other stuff that can be created. I propose edit-create as a
    basis and fallback for all "new" icons, regardless if they
    create documents, mails, podcasts, windows, menu entries in
    the start menu editor, classes and functions in integrated
    development environments, whatever. If this icon is there,
    every app and KDE core library can have "new" items while
    staying specification compliant.)
  (Consequences for existing icons in the spec:
    address-book-new -> new-address-book
    appointment-new  -> new-appointment
    contact-new      -> new-contact
    document-new    -> new-document
    folder-new      -> new-folder
    mail-message-new -> new-message-mail
    window-new      -> new-window)
</pre>
Of course, doing that breaks the current namespacing scheme
of the spec's actions category, as for example document-new
is ripped apart from the other document icons. I think this
is ok for actions that are not solely specific to
documents/windows/dialogs, because it is important for
extensibility, hence the idea of fallbacks.
Consequently, there should be at least one more "generalization":
<pre>
close
  The icon for the close action.
  (Consequences for existing icons in the spec:
    dialog-close -> close-dialog
    window-close -> close-window)
  (Opens up opportunities for:
    close-document
    close-tab
    close-project)
</pre>
</pre>

Latest revision as of 12:13, 13 January 2009

Specification compliance of icon names

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

 address-book-new               OK
 appointment-new                OK (since 4.1)
 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              -> bookmark-list-new **
                                   (or rather bookmarks-new **?)
                                   (KDE 3 name: bookmark_list_add)
 bookmark-toolbar               ?? (use case: "Set as toolbar folder")
 bookmarks-organize             OK ** (KDE 3 origin: bookmark)
 call-start                     Needed (CVS version of the spec)
 call-stop                      Needed (CVS version of the spec)
 character-set                  ?? (use case: choose character set
                                    in KWrite and Konqueror
 chronometer                    ?? (use cases?)
 color-picker                   OK ** (ArtLibreSet)
 color-picker-white             [...whatever] (since 4.2)
 color-picker-grey              [...whatever] (since 4.2)
 color-picker-black             [...whatever] (since 4.2)
 configure                      OK **? (-> configure-other?)
 configure-shortcuts            OK **
 configure-toolbars             OK **
 contact-new                    OK
 dashboard-show                 OK ** (did not exist in KDE 3)
 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-send                  Needed (CVS version of the spec)
 document-sign                  OK ** (KDE 3 name: signature)
 draw-brush                     OK ** (ArtLibreSet)
 draw-eraser                    OK ** (ArtLibreSet)
 draw-freehand                  OK ** (ArtLibreSet)
 draw-text                      OK ** (ArtLibreSet)
 edit-bomb                      ?? (since 4.1)
 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)
 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-link                      OK ** (16x16 only, please fix)
                                   (KDE 3 origin: www)
 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)
 feed-subscribe                 OK ** (KDE 3 name: rss_tag)
 flag(-black,blue,...)          ?? (eeevil!) (use cases?)
 folder-new                     OK (KDE 3 name: folder_new)
 fork                           ?? (use cases?)
 format-fill-color              OK **
 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-stroke-color            OK **
 format-text-bold               OK
 format-text-color              ?? (since 4.2) (maybe ok, maybe rather
                                    format-stroke-color-text? oh well.)
 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)
 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-first-view                  OK ** (KDE 3 name: start/2leftarrow)
 go-first-view-page             OK ** (KDE 3 name: start/2leftarrow)
 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-last-view                   OK ** (KDE 3 name: finish/2rightarrow)
 go-last-view-page              OK ** (KDE 3 name: finish/2rightarrow)
 go-next                        OK (KDE 3 name: forward)
 go-next-view                   OK ** (KDE 3 name: forward/1rightarrow)
 go-next-view-page              OK ** (KDE 3 name: forward/1rightarrow)
 go-previous                    OK (KDE 3 name: back)
 go-previous-view               OK ** (KDE 3 name: back/1leftarrow)
 go-previous-view-page          OK ** (KDE 3 name: back/1leftarrow)
 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-horizontal-rule         OK **
 insert-image                   OK
 insert-link                    OK
 insert-table                   OK *
 insert-text                    OK
 insert-object                  Needed
 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                 OK
 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         OK
 object-flip-vertical           OK
 object-rotate-left             OK (KDE 3 name: rotate_ccw)
 object-rotate-right            OK (KDE 3 name: rotate_cw)
 object-group                   OK ** (since 4.2) (16x16 only?)
 object-ungroup                 OK ** (since 4.2) (16x16 only?)
 object-order-back              OK ** (since 4.2) (16x16 only?)
 object-order-front             OK ** (since 4.2) (16x16 only?)
 object-order-lower             OK ** (since 4.2) (16x16 only?)
 object-order-raise             OK ** (since 4.2) (16x16 only?)
 page-zoom                      OK ** (KDE 3 name: viewmag)
 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)
 run-build                      OK ** (KDE 3 name: make_kdevelop)
 run-build-file                 OK ** (KDE 3 name: compfile)
 select-rectangular             OK ** (ArtLibreSet)
 services                       ?? (use cases?)
                                   (-> places/user-services **?)
                                   (-> 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-restart                 -> system-reboot * (agreed upon
                                   by GNOME, XFCE and KDE maintainers)
                                   (KDE 3 origin: reload? i think)
 system-run                     OK (KDE 3 name: exec)
 system-search                  OK (KDE 3 name: kfind)
 system-shutdown                OK * (KDE 3 name: exit)
 system-software-install        Needed (CVS version of the spec)
 system-suspend                 OK * (KDE 3 name: suspend)
 system-suspend-hibernate       -> system-hibernate (agreed upon
                                   by GNOME, XFCE and KDE maintainers)
                                   (KDE 3 name: hibernate)
 system-switch-user             OK * (KDE 3 name: switchuser)
 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-move-left                  Needed * New icon (missing in KDE 3)
 tab-move-right                 Needed * New icon (missing in KDE 3)
 tab-new                        OK * (KDE 3 name: tab_new)
                                   (KDE 3 name: tab_new_raised)
 tab-close                      OK * (KDE 3 name: tab_remove)
 tab-close-other                Needed * (KDE 3 name: tab_remove_other)
 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-move                 OK ** (ArtLibreSet)
                                   (KDE 3 name: move)
 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 ** (KDE 3 name: filter)
 view-fullscreen                OK (KDE 3 name: window-fullscreen)
 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            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-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-table-of-contents-ltr     OK ** (since 4.1)
 view-table-of-contents-rtl     OK ** (since 4.1)
 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)
 zoom-original                  OK (KDE 3 name: viewmag1)
 zoom-fit-best                  OK (as of the CVS version
                                    of the spec, 0.8.90)
                                   (KDE 3 names:
                                    view_fit_window, viewmagfit)
 zoom-fit-width                 OK * (KDE 3 name: view_fit_width)
 zoom-fit-height                OK * (KDE 3 name: view_fit_height)
 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

 call-start
   The icon used for initiating or accepting a call. Should be
   similar to the standard cellular call pickup icon, a green
   handset with ear and mouth pieces facing upward.
   (Says the spec... I think we can be more flexible.)

 call-stop
   The icon used for stopping a current call. Should be similar
   to the standard cellular call hangup icon, a red handset
   with ear and mouth pieces facing downward.
   (Says the spec... I think we can be more flexible.)

 document-send
   The icon for the send action. Should be an arrow pointing up
   and away from a hard disk.
   (Says the spec... I think we can be more flexible.)

 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-object
   The icon for the insert object action of an application.

 mail-send-receive
   The icon for the send and receive action of an
   electronic mail application.

 system-software-install
   The icon used for the desktop's software installer application.

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-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-move-left
   The icon for the menu action "Window -> Move Tab Left"

 tab-move-right
   The icon for the menu action "Window -> Move Tab Right"

 tab-new
   The icon used for the "New Tab" action.

 tab-close
   The icon used for the "Close Tab" action.

 tab-close-other
   The icon used for the "Close Other Tabs" 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.