Projects/Oxygen/namingSpec/actions: Difference between revisions

From KDE TechBase
(java is gone to apps.)
(media-playlist-refresh is gone. Not used by any app except for KSystemLog in playground, where another icon was more reasonable.)
Line 249: Line 249:
  media-playlist                ??
  media-playlist                ??
  media-playlist-clear          -> edit-clear-playlist **
  media-playlist-clear          -> edit-clear-playlist **
media-playlist-refresh        -> view-refresh-playlist **
  media-podcast                  ??
  media-podcast                  ??
  media-record                  OK
  media-record                  OK

Revision as of 00:40, 22 October 2007

Specification compliance of icon names

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

 1day                           ?? (view-calendar-day?) **
 5day                           ?? (view-calendar-work-week?) **
 7day                           ?? (view-calendar-week?) **
 list                           ?? (view-calendar-list?) **
 month                          ?? (view-calendar-month?) **
 todo                           ?? (view-calendar-tasks?) **
 whatsnext                      ?? (view-calendar-upcoming-events?) **
 xdays                          ?? (view-calendar-upcoming-days?) **
 go-jump-today                  OK ** (KDE 3 name: today)
 address-book-new               Needed
 alarmclock                     ?? (use cases?)
 appointment-new                Needed
 application-exit               OK (KDE 3 name: exit)
 arrow-down                     ??
 arrow-down-double              ??
 arrow-left                     ??
 arrow-left-double              ??
 arrow-right                    ??
 arrow-right-double             ??
 arrow-up                       ??
 arrow-up-double                ??
 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)
 battery-discharging-000        -> status/battery-low-000 **
 battery-discharging-020        -> status/battery-low
 battery-discharging-040        -> status/battery-caution
 battery-discharging-060        -> status/battery-060 **
 battery-discharging-080        -> status/battery-080 **
 battery-discharging-100        -> status/battery-100 **
 battery-charging-000           -> status/battery-charging-low-000 **
 battery-charging-020           -> status/battery-charging-low **
 battery-charging-040           -> status/battery-charging-caution **
 battery-charging-060           -> status/battery-charging-060 **
 battery-charging-080           -> status/battery-charging-080 **
 battery-charging-100           -> status/battery-charging-100 **
 book                           ??
 book2                          ??
 bookmark                       ??
 bookmark-new                   OK *
 bookmark-new-list              OK **
 bookmark-toolbar               ?? (use case: "Set as toolbar folder")
 camera-test                    ??
 cdburn                         ??
 cdcopy                         ??
 cd-data                        -> svn rm
 cd                             -> svn rm
 character-set                  ?? (use cases?)
 chronometer                    ?? (use cases?)
 color-fill                     ??
 color-line                     ??
 commandprompt                  ?? (duplicate of openterm?)
                                   (use cases?)
 configure                      ??
 configure-shortcuts            ??
 configure-toolbars             ??
 connection-established         ?? (should probably go into status/)
 connect-no                     ?? (should probably go into status/)
 contact                        ??
 contact-new                    OK
 datashow                       ?? (use cases?)
 datashowchart                  ?? (use cases?)
 decrypted                      ?? (should probably go into status/)
 dialog-apply                   OK *
 dialog-cancel                  OK
 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-page-setup            Needed
 document-preview-archive       OK ** (KDE 3 name: ark_view)
 document-print                 OK
 document-print-preview         OK
 document-properties            OK
 document-revert                OK
 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-start-presentation    OK **
 domtreeviewer                  ??
 edit                           ??
 edit-add                       OK *
 edit-clear                     OK (Note: Only in CVS,
                                    not yet in 0.8 of the spec.)
 edit-clear-locationbar         OK ** (KDE 3 name: locationbar_erase)
 edit-clear-locationbar-rtl     OK ** (KDE 3 name: clear_left)
 edit-copy                      OK
 edit-cut                       OK
 edit-delete                    OK *
 edit-delete-shred              OK ** (KDE 3 name: editshred)
 edit-delete-mail               OK ** (KDE 3 name: mail_delete)
 edit-find                      OK
 edit-find-replace              Needed
 edit-find-mail                 OK **
 edit-find-next                 OK **
 edit-find-previous             OK **
 editinput                      ?? (use cases?)
 edit-paste                     OK
 edit-redo                      OK
 edit-select-all                Needed
 edit-undo                      OK
 edit-user                      ??
 edit-trash                     ??
 emptytrash                     -> edit-clear-trash **
 encrypted                      ?? (should probably go to status/)
 eraser                         ??
 exec                           ?? (use cases?)
 favorites                      ?? (use cases?)
 fileview-close-left            ?? (view-close-left?) **
 fileview-close-right           ?? (view-close-right?) **
 fileview-column                ?? (view-mode-columns?) **
 fileview-detailed              ?? (view-mode-details?) **
 fileview-icon                  ?? (duplicate of view-icon?)
                                   (view-mode-icons?) **
 fileview-multicolumn           ?? (view-mode-multicolumn?) **
 fileview-preview               ?? (view-mode-preview?) **
 fileview-text                  ?? (view-mode-text?) **
 fileview-split                 ?? (view-split?) **
 fill                           ??
 flag(-black,blue,...)          ?? (eeevil!) (use cases?)
 folder-new                     OK
 footprint                      ?? (use cases?)
 fork                           ?? (use cases?)
 format-font-size-less          OK **
 format-font-size-more          OK **
 format-indent-less             OK
 format-indent-more             OK
 format-justify-center          OK
 format-justify-left            OK
 format-justify-right           OK
 format-justify-fill            OK
 format-line-spacing-double     OK **
 format-line-spacing-normal     OK **
 format-line-spacing-triple     OK **
 format-text-bold               OK
 format-text-italic             OK
 format-text-strikethrough      OK
 format-text-underline          OK
 format-text-direction-ltr      Needed
 format-text-direction-rtl      Needed
 format-text-subscript          OK **
 format-text-superscript        OK **
 frame-edit                     ??
 games-difficult                ??
 games-highscores               ??
 games-hint                     ??
 gear                           ?? (eeevil!) (use cases?)
 get-hot-new-stuff              ??
 go-bottom                      OK
 go-down                        OK
 go-first                       OK
 go-home                        OK
 go-jump                        OK (KDE 3 name: goto)
 go-jump-locationbar            OK ** (KDE 3 name: key_enter)
 go-last                        OK
 go-next                        OK
 go-previous                    OK
 go-top                         OK
 go-up                          OK
 halfencrypted                  ?? (should probably go to status/)
 help-about                     OK
 help-about-kde                 OK ** (KDE 3 name: about_kde)
 help-contents                  OK (KDE 3 name: contents, or contents2)
 help-contextual                OK * (KDE 3 name: contexthelp)
 help-faq                       Needed (but not used in KDE currently)
 history                        ?? (use cases?)
 history-clear                  -> edit-clear-history
 history-kdeprint               ?? (use cases?)
 images-display                 ?? (use cases?)
 inktube                        ??
 insert-image                   OK
 insert-link                    Needed
 insert-table                   OK *
 insert-text                    OK
 insert-object                  Needed
 kdeprint-addprinter            ??
 kdeprint-addpseudo             ??
 kdeprint-printer-infos         ??
 kdeprint-enableprinter-kdeprint ??
 kdeprint-queuestate-kdeprint   ??
 kdeprint-testprinter           ??
 kgpg-export-kgpg               ??
 kgpg-identity-kgpg             ??
 kgpg-import-kgpg               ??
 kgpg-info-kgpg                 ??
 kgpg-key1-kgpg                 ??
 kgpg-key1-kopete               ??
 kgpg-key2-kgpg                 ??
 kgpg-key2-kopete               ??
 kgpg-key3-kgpg                 ??
 kgpg-key3-kopete               ??
 kgpg-key4-kgpg                 ??
 kgpg-sign-kgpg                 ??
 kgpg-term-kgpg                 ?? (use cases?)
 knotes-delete-knotes           ??
 kontact-contacts               ??
 kontact-date                   ??
 kontact-journal                ??
 kontact-mail                   ??
 kontact-news                   ??
 kontact-notes                  ??
 kontact-summary                ??
 kontact-todo                   ??
 konv-message                   ??
 konv-message2                  ??
 kscd-dock                      ??
 laptop-charge-klaptopdaemon    ?? (probably remove in favor
                                    of battery-charging)
 laptop-nobattery-klaptopdeamon ?? (probably status/battery-error?)
 laptop-nocharge-klaptopdaemon  ?? (probably remove in favor
                                    of battery)
 launch                         ?? (use cases?)
 list-add                       OK (KDE 3 name: add)
 list-add-font                  OK ** (KDE 3 name: newfont)
 list-add-user                  OK ** (KDE 3 name: add_user)
 list-remove                    OK (KDE 3 name: remove)
 list-remove-user               OK ** (KDE 3 name: delete_user)
 mail                           ??
 mail-flag                      ?? (use cases?)
 mail-forward                   OK
 mail-mark-important            Needed
 mail-mark-notjunk              OK (KDE 3 names: mail_ham, kmmsg_ham)
 mail-mark-junk                 Needed
 mail-mark-read                 Needed
 mail-mark-unread               Needed
 mail-message-new               OK
 mail-queue                     ?? (use cases?)
 mail-receive                   OK *
 mail-reply-all                 OK
 mail-reply-sender              OK
 mail-reply-list                OK **
 mail-send                      OK
 mail-send-receive              Needed
 matrix                         ?? (use cases?)
 media-eject                    OK
 media-equalizer                ??
 media-playback-pause           OK
 media-playback-start           OK
 media-playback-stop            OK
 media-playlist                 ??
 media-playlist-clear           -> edit-clear-playlist **
 media-podcast                  ??
 media-record                   OK
 media-scripts                  ??
 media-seek-backward            OK
 media-seek-forward             OK
 media-skip-backward            OK
 media-skip-forward             OK
 network                        ?? (use cases?)
 network-wired-database         ?? (use cases?)
 news-subscribe                 OK **
 news-unsubscribe               OK **
 none                           svn rm, in favor of whatever becomes
                                of kdeprint-addprinter
 no                             ?? (probably remove in favor of
                                    status/dialog-error)
 note2                          ?? (use cases?)
 note                           ?? (use cases?)
 object-flip-horizontal         Needed
 object-flip-vertical           Needed
 object-rotate-left             OK
 object-rotate-right            OK
 ok                             ?? (probably remove in favor of
                                    dialog-ok)
 openterm                       ?? (duplicate of commandprompt?)
 paintbrush                     ??
 paperbag                       ?? (use cases?)
 paperclipreal                  ?? (use cases?)
 pencil                         ??
 pencil2                        ?? (use cases?)
 pen                            ?? (use cases?)
 player-time                    ?? (use cases?)
 player-volume                  ?? (use cases?)
 plus                           svn rm, in favor of list-add or whatever
 print-frame                    ??
 process-stop                   OK (Note: Only in CVS,
                                    not yet in 0.8 of the spec.)
 project-open                   OK ** (KDE 3 name: project_open)
 rating                         ?? (use cases?)
 rebuild                        ?? (run-build-rebuild?)
 roll                           ?? (use cases?)
 rotate                         svn rm (right?) (use cases?)
 rss                            ?? (use cases?)
 rss-tag                        ?? (use cases?)
 ruler                          ?? (use cases?)
 run-build                      OK ** (KDE 3 name: make_kdevelop)
 run-build-file                 OK ** (KDE 3 name: compfile)
 screwdriver                    ?? (use cases?)
 search-filter                  ?? (use cases?)
 search-user                    ?? (use cases?)
 services                       ?? (use cases?)
 show-offliners                 ?? (use cases?)
 signature                      ?? (use cases?)
 smiley                         ?? (use cases?)
 speaker                        ?? (use cases?)
 spread                         ?? (use cases?)
 stamp                          ?? (use cases?)
 system-lock-screen             OK
 system-log-out                 OK
 system-run                     OK
 system-search                  OK (suggest to rename to
                                    system-find, for consistency)
 system-switch-user             OK * (KDE 3 name: switchuser)
 table                          ?? (use cases?)
 tab-detach                     OK * (KDE 3 name: tab_breakoff)
 tab-duplicate                  OK * (KDE 3 name: tab_duplicate)
 tab-new                        -> tab-new-background **
                                   (KDE 3 name: tab_new_bg)
 tab-new-raised                 -> tab-new *
                                   (KDE 3 names: tab_new, tab_new_raised)
 tab-close                      OK * (KDE 3 name: tab_remove)
 text                           ?? (use cases?)
 thumbnail-show                 ?? (use cases?)
 tool, tool2                    ?? (use cases?)
 tools-check-spelling           OK
 underconstruction              ?? (use cases?)
 user                           ?? (use cases?)
 user-female                    ?? (use cases?)
 users                          ?? (use cases?)
 view-choose                    ??
 view-fullscreen                OK
 view-icon                      ?? (duplicate of fileview-icon?)
 view-left-right                OK **
 view-process-all               ??
 view-process-all-tree          ??
 view-process-own               ??
 view-process-system            ??
 view-process-users             ??
 view-refresh                   OK
 view-restore                   OK
 view-remove                    ?? (make sure to be consistent with
                                    fileview-close-{left,right})
 view-sidetree                  ??
 view-sort-ascending            Needed
 view-sort-descending           Needed
 view-tree                      ??
 wallet-closed                  ?? (should probably go to status/)
 wallet-open                    ?? (should probably go to status/)
 window-close                   OK
 window-new                     OK
 window-suppressed              ?? (should probably go to status/)
 world                          ?? (eeevil!) (use cases?)
 zoom-original                  OK
 zoom-best-fit                  -> zoom-fit-best *
 zoom-in                        OK
 zoom-out                       OK

 *  suggesting this for inclusion into the icon naming specification
 ** not in the spec, but let's keep it out of there anyways,
    it's not really suited to be a standard icon

To do for Oxygen

Icons that are in the spec, but not yet in Oxygen's actions/ (after renaming) so they need to be added. Descriptions taken from the specification

 address-book-new
   The icon used for the action to create a new address book.
   (or "new-address-book", depending on the outcome
    of the discussion.)

 appointment-new
   The icon used for the action to create a new appointment
   in a calendaring application. (or "new-appointment",
   depending on the outcome of the discussion)

 document-page-setup
   The icon for the page setup action of a document editor.

 edit-find-replace
   The icon for the find and replace action.

 edit-select-all
   The icon for the select all action.

 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
   The icon for the FAQ item in the Help menu.
   (Editor's note: not used in KDE either, at the moment.)

 insert-link
   The icon for the insert link action of an application.

 insert-object
   The icon for the insert object action of an application.

 mail-mark-important
   The icon for the mark as important action of an
   electronic mail application.

 mail-mark-junk
   The icon for the mark as junk action of an
   electronic mail application.

 mail-mark-read
   The icon for the mark as read action of an
   electronic mail application.

 mail-mark-unread
   The icon for the mark as unread action of an
   electronic mail application.

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

 object-flip-horizontal
   The icon for the action to flip an object horizontally.

 object-flip-vertical
   The icon for the action to flip an object vertically.

 view-sort-ascending
   The icon used for the "Sort Ascending" item in the
   application's "View" menu, or in a button for
   changing the sort method for a list.

 view-sort-descending
   The icon used for the "Sort Descending" item in the
   application's "View" menu, or in a button for
   changing the sort method for a list.

Summary of the suggested changes and additions

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.

 archive-extract
   The icon used for the action that extracts files and directories
   from an archive.

 archive-insert
   The icon used for the action that inserts files and directories
   into an archive.

 archive-remove
   The icon used for the action that removes files and directories
   from an archive.

 dialog-apply
   The icon used for the "Apply" button that might appear
   in dialog windows.

 edit
   The icon for the generic edit action.
   (Rationale: There are a lot of things that need to be edited:
    bookmarks, contacts, todos, away messages, fill/stroke colors,
    app specific item properties of any kind, ...
    There should be a generic edit icon as a common ground
    and fallback for these use cases.)

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

 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
   The icon used for the "Switch User" item in the
   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
   The icon used for the "Detach Tab" action.

 tab-duplicate
   The icon used for the "Duplicate Tab" action.

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

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

 zoom-fit-height
   The icon used for the "Zoom to Height" item
   in the application's "View" menu.
   
 zoom-fit-width
   The icon used for the "Zoom to Width" item
   in the application's "View" menu.
   
 zoom-fit-best (instead of zoom-best-fit)