Projects/Oxygen/namingSpec/devices: Difference between revisions

From KDE TechBase
(Techbasification of an improved oxygen-naming-devices-1.3.txt.)
 
(Better wikification)
Line 1: Line 1:
<pre>
== Concrete renaming suggestions ==
---
Concrete renaming suggestions


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


<pre>
  *-mount                -> svn rm, right now. See below (*)
  *-mount                -> svn rm, right now. See below (*)
                             for the explanation.
                             for the explanation.
Line 49: Line 47:
  *** 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
</pre>


== To do for Oxygen ==


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


<pre>
  audio-card
  audio-card
   The icon used for the audio rendering device.
   The icon used for the audio rendering device.
Line 94: Line 92:
   metaphor for this fallback icon should be a generic
   metaphor for this fallback icon should be a generic
   PDA device icon.
   PDA device icon.
</pre>




---
== To do for Oxygen *and* the spec ==
Icons that are neither in the spec nor in Oxygen's devices/
(after renaming) but still should be added to both.


Icons that are neither in the spec nor in Oxygen's devices/ (after renaming) but still should be added to both.
<pre>
  media-optical-video
  media-optical-video
   The icon used for physical optical media such as CD and DVD
   The icon used for physical optical media such as CD and DVD
   containing video content.
   containing video content.
</pre>


== Don't know what to do with... ==


---
<pre>
Don't know what to do with...
 
  cpu
  cpu
   The specification does not contain any low-level processing
   The specification does not contain any low-level processing
Line 116: Line 116:
   devices category in the spec and extensible enough.
   devices category in the spec and extensible enough.
   Input and better ideas appreciated.
   Input and better ideas appreciated.
</pre>


== Summary of the suggested 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.
Summary of the suggested additions to the icon naming specification
 
The ones marked with **, in a shorter list for a better overview.
Including a suggested short description text like needed for
inclusion in the spec.


<pre>
  audio-headset
  audio-headset
   The icon used for handsfree headset devices that combine a pair
   The icon used for handsfree headset devices that combine a pair

Revision as of 01:32, 18 June 2007

Concrete renaming suggestions

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

 *-mount                 -> svn rm, right now. See below (*)
                            for the explanation.
 3floppy-unmount         -> media-floppy
 audio-headset           OK **
 audio-input-line        OK **
 audio-input-microphone  OK
 camera-unmount          -> camera-photo
 cdaudio-unmount         -> media-optical-audio **
 cdwriter-unmount        -> media-optical-recordable **
 cellular-phone-unmount  -> phone
 cpu                     ??
 drive-optical           -> media-optical
 dvd-unmount             -> svn rm, as media should be represented
                            by their contents, not their disc format.
 hdd-external-unmount    -> drive-removable-media
 hdd-unmount             -> drive-harddisk
 hdd-usb-unmount         -> drive-removable-media-usb ***
 ipod-unmount            -> multimedia-player-ipod
 joystick                -> input-gaming
 keyboard                -> input-keyboard
 laptop                  -> computer-laptop **
 memory-stick-unmount    -> media-flash-memory-stick ***
 mouse                   -> input-mouse
 nfs-unmount             -> drive-remote **
 printer                 OK
 projector               -> video-projector **
 scanner                 OK
 screen                  -> video-display
 sd-mmc-unmount          -> media-flash-sd-mmc ***
 smart-media-unmount     -> media-flash-smart-media ***
 system                  -> computer
 tablet                  -> input-tablet
 usbpendrive-unmount     -> media-flash-usb **
 video-television        OK **
 webcam                  -> camera-web

 * The specification's way of doing "*-mounted" icons would be
   mount emblems, overlaying the standard ones. Kévin and Aaron
   claim to have a solution at hand right now, so let's kill all
   "*-mounted" icons instantly.
 ** 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 devices/ (after renaming) so they need to be added. Descriptions taken from the specification.

 audio-card
   The icon used for the audio rendering device.

 battery
   The icon used for the system battery device.
   (Let's just move actions/battery.svg to devices/.)

 camera-video
   The fallback icon for video cameras

 drive-optical
   The icon used for optical media drives such as CD and DVD.

 media-flash
   The fallback icon used for flash media, such as memory stick
   and SD.

 media-tape
   The icon used for generic physical tape media.

 modem
   The icon used for modem devices.

 multimedia-player
   The icon used for generic multimedia playing devices.

 network-wired
   The icon used for wired network connections.

 network-wireless
   The icon used for wireless network connections.

 pda
   This is the fallback icon for Personal Digial Assistant devices.
   Primary use of this icon is for PDA devices connected to the PC.
   Connection medium is not an important aspect of the icon. The 
   metaphor for this fallback icon should be a generic
   PDA device icon.


To do for Oxygen *and* the spec

Icons that are neither in the spec nor in Oxygen's devices/ (after renaming) but still should be added to both.

 media-optical-video
   The icon used for physical optical media such as CD and DVD
   containing video content.

Don't know what to do with...

 cpu
   The specification does not contain any low-level processing
   units, such as CPUs or RAM. I can't think of an appropriate
   "category" name for those. The only word that I found which
   comes close was "internal-*" (internal-cpu, internal-memory, ...)
   but I'm not sure if this consistent with the rest of the
   devices category in the spec and extensible enough.
   Input and better ideas appreciated.

Summary of the suggested 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.

 audio-headset
   The icon used for handsfree headset devices that combine a pair
   of headphones or earphones with a microphone.

 audio-input-line
   The icon used for audio line input devices.

 media-optical-audio
   The icon used for physical optical media such as CD and DVD
   containing audio content.

 media-optical-video
   The icon used for physical optical media such as CD and DVD
   containing video content.

 media-optical-recordable
   The icon used for recordable physical optical media,
   such as CD-R and DVD-R.

 media-flash-usb
   The icon used for physical USB flash drive media.

 computer-laptop
   The icon used for a portable computing device as a whole.

 drive-remote
   The icon used for remotely accessed drives, such as
   NFS or WebDAV mounts.

 video-projector
   The icon used for a projector that video gets displayed to.

 video-television
   The icon used for a television device, such as
   CRT or flat panel displays.