Projects/Oxygen/namingSpec/actions: Difference between revisions

From KDE TechBase
m (Formatting.)
(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.)
 
(202 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>
  add-user                      -> edit-add-user **
  address-book-new              OK
                                  (In case edit-add is approved.)
appointment-new                OK (since 4.1)
  application-exit              OK
  application-exit              OK (KDE 3 name: exit)
  centrejust                     -> svn rm,
  arrow-down                    -> svn rm
                                  there's already text-center
arrow-down-double              -> svn rm
  delete-user                   -> edit-delete-user **
arrow-left                     -> svn rm
                                   (In case edit-delete is approved.)
arrow-left-double              -> svn rm
  dialog-apply                  -> dialog-ok
  arrow-right                   -> svn rm
  dialog-cancel                  OK
arrow-right-double            -> svn rm
  dialog-close                  OK
arrow-up                      -> svn rm
  document-new                  OK
arrow-up-double                -> svn rm
  document-open                  OK
archive-insert-directory      OK ** (KDE 3 name: ark_adddir)
  document-open-recent          OK
archive-insert                OK * (KDE 3 name: ark_addfile)
  document-print                OK
archive-remove                OK * (KDE 3 name: ark_delete)
  document-print-preview        OK
archive-extract                OK * (KDE 3 name: ark_extract)
  document-properties            OK
bookmark-new                  OK * (KDE 3 name: bookmark_add)
  document-revert                OK
bookmark-new-list              -> bookmark-list-new **
  document-save                  OK
                                  (or rather bookmarks-new **?)
  document-save-as              OK
                                   (KDE 3 name: bookmark_list_add)
  edit                          OK *
bookmark-toolbar              ?? (use case: "Set as toolbar folder")
  edit-add                      OK *
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,
  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
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)
  go-last                        OK
games-config-background        ?? (probably a candidate for apps/)
  go-next                        OK
games-config-board            ?? (probably a candidate for apps/)
  go-previous                    OK
games-config-custom            ?? (probably a candidate for apps/)
  go-top                        OK
games-config-tiles            ?? (probably a candidate for apps/)
  go-up                          OK
games-config-options          ?? (probably a candidate for apps/)
  help-contents                  OK
games-config-theme            ?? (probably a candidate for apps/)
  identity                       -> contact-new
games-difficult                ??
                                  (maybe add a "new" sparkle?)
games-endturn                  ??
  list-add                       OK
games-highscores              ??
  list-remove                    OK
games-hint                    -> help-hint-game
  mail-delete                    -> edit-delete-mail
games-solve                    ??
  mail-forward                  OK
get-hot-new-stuff              probably OK **, even if highly
  mail-ham                      -> mail-mark-notjunk
                                non-standard. is pretty unique
  mail-message-new              OK
                                and used as an action icon
  mail-reply-all                OK
                                (with no associated executable).
  mail-reply-sender              OK
  go-bottom                      OK (KDE 3 name: bottom)
  mail-send                      OK
  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-eject                    OK
  media-playback-pause          OK
  media-playback-pause          OK
Line 76: Line 202:
  media-skip-backward            OK
  media-skip-backward            OK
  media-skip-forward            OK
  media-skip-forward            OK
  object-rotate-left            OK
network-connect                OK ** (KDE 3 name: connect_established)
  object-rotate-right            OK
network-disconnect            OK ** (KDE 3 name: connect_no)
  save-all                       -> document-save-all *
news-subscribe                OK **
  system-lock-screen            OK
news-unsubscribe              OK **
  system-log-out                OK
object-flip-horizontal        OK
  system-run                    OK
object-flip-vertical          OK
  system-search                  OK
  object-rotate-left            OK (KDE 3 name: rotate_ccw)
  tab-breakoff                  -> tab-detach *
  object-rotate-right            OK (KDE 3 name: rotate_cw)
  tab-duplicate                  OK *
object-group                  OK ** (since 4.2) (16x16 only?)
  tab-new                       -> tab-new-background **
object-ungroup                OK ** (since 4.2) (16x16 only?)
  tab-new-raised                 -> tab-new *
object-order-back              OK ** (since 4.2) (16x16 only?)
  tab-remove                     -> tab-close *
object-order-front            OK ** (since 4.2) (16x16 only?)
                                   (in accordance to window-close)
object-order-lower            OK ** (since 4.2) (16x16 only?)
  text-center                   -> format-justify-center
object-order-raise            OK ** (since 4.2) (16x16 only?)
  text-left                      -> format-justify-left
page-zoom                      OK ** (KDE 3 name: viewmag)
  text-right                    -> format-justify-right
player-time                    ?? (view-media-player-time?)
  tools-check-spelling          OK
                                  (use cases?)
  viewmag1                      -> zoom-original
player-volume                  ?? (view-media-player-volume?)
  view-fullscreen                OK
                                  (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-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                  -> svn rm, or zoom *
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 113: 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
  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.)


  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.
  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
  document-page-setup
Line 126: Line 372:
   The icon for the find and replace action.
   The icon for the find and replace action.


  edit-select-all
  help-faq
   The icon for the select all action.
  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.
</pre>
</pre>


Line 135: Line 392:


<pre>
<pre>
  edit
  archive-extract
   The icon for the generic edit action.
   The icon used for the action that extracts files and directories
   (Rationale: There are a lot of things that need to be edited:
   from an archive.
    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.)


  edit-add
  archive-insert
   The icon for the add action.
   The icon used for the action that inserts files and directories
   (The icon for the add to list action would
  into an archive.
    subsequently be named edit-add-list.)
 
   (Rationale: There are a good number of things that need to be
archive-remove
    added - not created - but still cannot necessarily be counted
   The icon used for the action that removes files and directories
    as list items: breakpoints, files in an archive, bookmarks,
  from an archive.
    fonts, friends' accounts in instant messaging, ...
 
    There should be a generic add icon as a common ground and
document-export
    fallback for these use cases, also as an opposite to
  The icon used for the action that saves all or part of
    edit-delete.)
   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
  tab-detach
  The icon used for the "Detach Tab" action.
  tab-duplicate
  tab-duplicate
tab-new (or possibly new-tab, see below)
  The icon used for the "Duplicate Tab" action.
  tab-remove (or possibly close-tab, see below)
 
zoom-fit-height
  tab-move-left
zoom-fit-width
  The icon for the menu action "Window -> Move Tab Left"
  zoom-fit-best (instead of zoom-best-fit)
 
view-next
  tab-move-right
view-previous
  The icon for the menu action "Window -> Move Tab Right"
</pre>


And now for the radical stuff:
tab-new
  The icon used for the "New Tab" action.


<pre>
  tab-close
  new
   The icon used for the "Close Tab" action.
   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
    window-new      -> new-window)


Of course, doing that breaks the current namespacing scheme
tab-close-other
of the spec's actions category, as for example document-new
  The icon used for the "Close Other Tabs" action.
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":
system-suspend
  The icon used for the "Suspend Computer" action.


  close
  zoom-fit-height
   The icon for the close action.
   The icon used for the "Zoom to Height" item
   (Consequences for existing icons in the spec:
   in the application's "View" menu.
    dialog-close -> close-dialog
 
    window-close -> close-window)
zoom-fit-width
   (Opens up opportunities for:
   The icon used for the "Zoom to Width" item
    close-document
  in the application's "View" menu.
    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.
Retrieved from "https://techbase.kde.org/index.php?title=Projects/Oxygen/namingSpec/actions&oldid=37346"