Jump to content

Projects/Oxygen/namingSpec/actions: Difference between revisions

From KDE TechBase
← Older edit
Jpetso (talk | contribs)
KDEDevelopers
584 edits
Renamed help-whatsthis, and "exit" as KDE 3 name of application-exit.
Jpetso (talk | contribs)
KDEDevelopers
584 edits
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.
 
(177 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Only partially ready for consumption. We 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>
  help-about-kde                OK ** (KDE 3 name: about_kde)
  address-book-new              OK
  list-add-user                  OK ** (KDE 3 name: add_user)
  appointment-new                OK (since 4.1)
  application-exit              OK (KDE 3 name: exit)
  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-directory      OK ** (KDE 3 name: ark_adddir)
  archive-insert                OK * (KDE 3 name: ark_addfile)
  archive-insert                OK * (KDE 3 name: ark_addfile)
  archive-remove                OK * (KDE 3 name: ark_delete)
  archive-remove                OK * (KDE 3 name: ark_delete)
  archive-extract                OK * (KDE 3 name: ark_extract)
  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-preview-archive      OK ** (KDE 3 name: ark_view)
  battery-discharging-000        -> status/battery-low-000 **
  document-print                 OK (KDE 3 name: fileprint)
battery-discharging-020        -> status/battery-low
  document-print-preview        OK (KDE 3 name: filequickprint)
battery-discharging-040        -> status/battery-caution
  document-print-frame          OK ** (KDE 3 name: frameprint)
battery-discharging-060        -> status/battery-060 **
  document-properties            OK (KDE 3 names:
battery-discharging-080        -> status/battery-080 **
                                    documentinfo, edit)
battery-discharging-100        -> status/battery-100 **
  document-revert                OK (KDE 3 name: revert)
battery-charging-000          -> status/battery-charging-low-000 **
  document-save                 OK (KDE 3 name: filesave)
battery-charging-020          -> status/battery-charging-low **
  document-save-as              OK (KDE 3 name: filesaveas)
battery-charging-040          -> status/battery-charging-caution **
  document-save-all              OK * (KDE 3 name: save_all)
battery-charging-060          -> status/battery-charging-060 **
  document-send                  Needed (CVS version of the spec)
battery-charging-080          -> status/battery-charging-080 **
  document-sign                 OK ** (KDE 3 name: signature)
battery-charging-100          -> status/battery-charging-100 **
  draw-brush                    OK ** (ArtLibreSet)
run-build-file                 OK ** (KDE 3 name: compfile)
  draw-eraser                    OK ** (ArtLibreSet)
  list-remove-user              OK ** (KDE 3 name: delete_user)
  draw-freehand                  OK ** (ArtLibreSet)
  dialog-apply                  OK *
  draw-text                      OK ** (ArtLibreSet)
dialog-cancel                  OK
  edit-bomb                      ?? (since 4.1)
dialog-close                  OK
dialog-ok                      OK
document-export                OK ** (KDE 3 name: fileexport)
  document-import                OK ** (KDE 3 name: fileimport)
  document-new                  OK
  document-open                 OK
  document-open-recent          OK
  document-print                OK
document-print-preview        OK
  document-properties            OK
  document-revert                OK
document-save                 OK
  document-save-as              OK
  document-start-presentation    OK **
  edit                          OK *
  edit-delete-shred              OK ** (KDE 3 name: editshred)
  edit-add                      OK *
  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
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-less            OK
  format-indent-more            OK
  format-indent-more            OK
Line 65: Line 106:
  format-justify-right          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
  format-font-size-less          OK **
  format-text-direction-ltr      OK
  format-font-size-more         OK **
  format-text-direction-rtl      OK
  format-line-spacing-double    OK **
format-text-subscript         OK ** (ArtLibreSet)
  format-line-spacing-normal    OK **
  format-text-superscript        OK ** (ArtLibreSet)
  format-line-spacing-triple    OK **
games-config-background        ?? (probably a candidate for apps/)
  format-text-subscript          OK **
games-config-board            ?? (probably a candidate for apps/)
  format-text-superscript        OK **
  games-config-custom            ?? (probably a candidate for apps/)
  go-bottom                      OK
games-config-tiles            ?? (probably a candidate for apps/)
  go-down                        OK
games-config-options          ?? (probably a candidate for apps/)
  go-first                      OK
games-config-theme            ?? (probably a candidate for apps/)
  go-home                        OK
  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                        OK (KDE 3 name: goto)
  go-last                        OK
go-jump-locationbar            OK ** (KDE 3 name: key_enter)
  go-next                        OK
go-jump-today                  OK ** (KDE 3 name: today)
  go-previous                    OK
  go-last                        OK (KDE 3 name: finish)
  go-top                        OK
go-last-view                  OK ** (KDE 3 name: finish/2rightarrow)
  go-up                          OK
go-last-view-page              OK ** (KDE 3 name: finish/2rightarrow)
  help-contents                  OK
  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-contextual                OK * (KDE 3 name: contexthelp)
  identity                       -> contact-new
  help-faq                       Needed (but not used in KDE currently)
                                  (maybe add a "new" sparkle?)
help-hint                      OK ** (KDE 3 name: idea)
  list-add                       OK
insert-horizontal-rule        OK **
  list-remove                    OK
insert-image                  OK
  mail-delete                    -> edit-delete-mail
insert-link                    OK
  mail-forward                  OK
insert-table                  OK *
  mail-get                      -> mail-receive *
insert-text                    OK
  mail-ham                      -> mail-mark-notjunk
insert-object                  Needed
  mail-message-new              OK
list-add                      OK (KDE 3 names: add, edit_add)
  mail-new                      -> svn rm,
list-add-font                  OK ** (KDE 3 name: newfont)
                                   in favor of mail-message-new
  list-add-user                  OK ** (KDE 3 name: add_user)
  mail-reply-all                OK
  list-remove                    OK (KDE 3 name: remove, edit_remove)
  mail-reply-sender              OK
  list-remove-user              -> edit-delete-user? or OK **
  mail-replylist                -> mail-reply-list **
                                  (KDE 3 name: delete_user)
  mail-send                      OK
mail-flag                      ?? (use cases?)
  run-build                      OK ** (KDE 3 name: make_kdevelop)
  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 115: 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)
  switchuser                    -> system-switch-user *
rating                        ?? (use cases?)
  system-lock-screen            OK
roll                          ?? (used in games for dice rolls)
  system-log-out                OK
run-build                      OK ** (KDE 3 name: make_kdevelop)
  system-run                    OK
run-build-file                OK ** (KDE 3 name: compfile)
  system-search                  OK (suggest to rename to
select-rectangular            OK ** (ArtLibreSet)
                                    system-find, for consistency)
services                       ?? (use cases?)
  tab-breakoff                  -> tab-detach *
                                  (-> places/user-services **?)
  tab-duplicate                  OK *
                                  (-> view-services **?)
  tab-new                       -> tab-new-background **
  show-menu                      ?? (-> view-menu-show **?)
  tab-new-raised                 -> tab-new *
                                  (-> view-menu-toggle **?)
  tab-remove                    -> tab-close *
                                  (-> view-menu **?)
                                  (in accordance to window-close)
speaker                        ?? (use cases?)
  tools-check-spelling          OK
  system-lock-screen            OK (KDE 3 name: lock)
  viewmag1                      -> svn rm, either this or
  system-log-out                OK (KDE 3 origin: back)
                                   the current zoom-original
system-restart                -> system-reboot * (agreed upon
  view-fullscreen                OK
                                  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-refresh                  OK
  view-restore                  OK
  view-restore                  OK
  window-close                  OK
view-sidetree                  -> view-sidebar-right **
  window-new                    OK
view-sort-ascending            OK
  zoom-original                  OK
view-sort-descending          OK
  zoom-best-fit                 -> zoom-fit-best *
view-list-details              OK **
  zoom-in                        OK
view-list-icons                OK **
  zoom-out                      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
  *  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 155: 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
  similar to the standard cellular call pickup icon, a green
    of the discussion.)
  handset with ear and mouth pieces facing upward.
   (Says the spec... I think we can be more flexible.)


  appointment-new
  call-stop
   The icon used for the action to create a new appointment
   The icon used for stopping a current call. Should be similar
   in a calendaring application. (or "new-appointment",
  to the standard cellular call hangup icon, a red handset
   depending on the outcome of the discussion)
   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
  document-page-setup
Line 170: 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 221: 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.
 
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.
</pre>
 
== To do for Oxygen *and* the spec ==
 
Icons that are neither in the spec nor in Oxygen but should be added to both.
 
<pre>
insert-table
  The icon for the insert table action of an application.
</pre>
</pre>


Line 264: Line 404:
   from an archive.
   from an archive.


  dialog-apply
  document-export
   The icon used for the "Apply" button that might appear
   The icon used for the action that saves all or part of
   in dialog windows.
   the current document, often in a format that cannot be
  opened again with this application.


  edit
  document-import
   The icon for the generic edit action.
   The icon used for the action that adds the contents of
   (Rationale: There are a lot of things that need to be edited:
  external files to the current document.
    bookmarks, contacts, todos, away messages, fill/stroke colors,
 
    app specific item properties of any kind, ...
document-preview
    There should be a generic edit icon as a common ground
   The icon used for previewing a document in read-only mode.
    and fallback for these use cases.)
 
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
Line 286: Line 431:
   The icon for the receive action of an
   The icon for the receive action of an
   electronic mail application.
   electronic mail application.
mail-reply-sender -> mail-reply
  (Rationale: In order to support more reply methods than
    the expected ones. KMail, at least, has "Reply" as
    "intelligent reply" - automatically do the right thing -
    and also "Reply to all", "Reply to author" and
    "Reply to mailing list". The latter is not in the spec,
    and doesn't need to be, but in order to enable
    mail-reply-list, we need a mail-reply fallback.)


  system-switch-user
  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 312: 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 322: 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>
</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.
Retrieved from "https://techbase.kde.org/index.php?title=Projects/Oxygen/namingSpec/actions&oldid=37346"