Projects/Oxygen/namingSpec/devices: Difference between revisions

    From KDE TechBase
    (Have drive-removable-media-usb-pendrive instead of media-flash-usb, as discussed on the list)
    (KDE 3 names for all of devices, yay!)
     
    (43 intermediate revisions by 3 users not shown)
    Line 1: Line 1:
    == Concrete renaming suggestions ==
    == Specification compliance of icon names ==


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


    <pre>
    <pre>
      *-mount                -> svn rm, right now. See below (*)
      audio-card                    OK (did not exist in KDE 3 - right?)
                                for the explanation.
      audio-headset                 OK * (did not exist in KDE 3)
    3floppy-unmount        -> media-floppy
      audio-input-line             OK * (did not exist in KDE 3)
      audio-headset           OK **
      audio-input-microphone       OK (did not exist in KDE 3)
      audio-input-line       OK **
      battery                      OK (KDE 3 names: battery,
      audio-input-microphone  OK
                                      apps/laptop_battery)
      camera-unmount          -> camera-photo
      camera-photo                  OK (KDE 3 names:
      cdaudio-unmount        -> media-optical-audio **
                                      camera_unmount, camera)
      cdwriter-unmount        -> media-optical-recordable **
    camera-video                  Needed
      cellular-phone-unmount  -> phone
    camera-web                    OK (Not yet in 0.8 of the spec,
    cpu                    ??
                                      only in CVS.)
      drive-optical           -> media-optical
      cpu                          OK ** (did not exist in KDE 3 - right?)
      dvd-unmount            -> svn rm, as media should be represented
    computer                      OK (KDE 3 name: system)
                                by their contents, not their disc format.
      computer-laptop              OK ** (KDE 3 name: laptop)
      hdd-external-unmount    -> drive-removable-media
      drive-harddisk                OK (KDE 3 name: hdd_unmount)
    hdd-unmount            -> drive-harddisk
      drive-optical                 OK (did not exist in KDE 3)
      hdd-usb-unmount        -> drive-removable-media-usb ***
      drive-removable-media         OK (did not exist in KDE 3)
    ipod-unmount            -> multimedia-player-ipod
      drive-removable-media-usb    OK ** (did not exist in KDE 3)
      joystick                -> input-gaming
      drive-removable-media-usb-pendrive  OK **
      keyboard                -> input-keyboard
                                      (KDE 3 name: usbpendrive_unmount)
      laptop                  -> computer-laptop **
      input-gaming                 OK (KDE 3 name: joystick)
      memory-stick-unmount    -> media-flash-memory-stick ***
      input-keyboard                OK (KDE 3 name: keyboard)
      mouse                  -> input-mouse
    input-mouse                  OK (KDE 3 name: mouse)
      nfs-unmount            -> drive-remote **
    input-tablet                  OK (KDE 3 name: tablet)
      printer                OK
      media-flash                  OK (did not exist in KDE 3)
      projector              -> video-projector **
      media-flash-memory-stick     OK ** (KDE 3 name: memory_stick_unmount)
    scanner                 OK
      media-flash-sd-mmc            OK ** (KDE 3 name: sd_mmc_unmount)
      screen                  -> video-display
      media-flash-smart-media      OK ** (KDE 3 name: smart_media_unmount)
      sd-mmc-unmount          -> media-flash-sd-mmc ***
      media-floppy                  OK (KDE 3 name: 3floppy_unmount)
      smart-media-unmount    -> media-flash-smart-media ***
      media-optical                 OK (KDE 3 name: cdrom_unmount)
      system                  -> computer
      media-optical-audio          -> svn rm, and replace with a
      tablet                  -> input-tablet
                                      combination of media-optical
      usbpendrive-unmount    -> drive-removable-media-usb-pendrive ***
                                      and emblem-audio
      video-television       OK **
                                      (KDE 3 name: cdaudio_unmount)
    webcam                  -> camera-web
      media-optical-recordable      OK ** (KDE 3 name: cdwriter_unmount)
      media-tape                    OK (KDE 3 name: mo_unmount)
    modem                        OK (did not exist in KDE 3 - right?)
    multimedia-player            OK (did not exist in KDE 3)
    multimedia-player-apple-ipod  OK ** (KDE 3 name: ipod_unmount)
      network-wired                OK (did not exist in KDE 3)
      network-wireless              OK (did not exist in KDE 3)
    pda                          OK (KDE 3 names: pda_black, pda_blue)
    phone                        OK (did not exist in KDE 3 - right?)
    printer                      OK (KDE 3 names: printer1, printer)
    scanner                      OK (KDE 3 name: scanner)
      video-display                OK (did not exist in KDE 3)
    video-projector              OK * (did not exist in KDE 3)
      video-television             OK * (KDE 3 name: tv)


      * The specification's way of doing "*-mounted" icons would be
      * suggesting this for inclusion into the icon naming specification
      mount emblems, overlaying the standard ones. Kévin and Aaron
      ** not in the spec, but let's keep it out of there anyways,
      claim to have a solution at hand right now, so let's kill all
        it's not really suited or necessary for it to be in there
      "*-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
    </pre>
    </pre>


    Line 54: Line 63:


    <pre>
    <pre>
    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
      camera-video
       The fallback icon for video cameras
       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.
    </pre>
    </pre>


    == Icons in Tango, but not in the spec ==


    == To do for Oxygen *and* the spec ==
    We don't need to have those, but if we do they should be named this way:
     
    Icons that are neither in the spec nor in Oxygen's devices/ (after renaming) but still should be added to both.


    <pre>
    <pre>
      media-optical-video
      media-zip
       The icon used for physical optical media such as CD and DVD
       The icon for Iomega Zip media.
      containing video content.
    </pre>
     
    == Don't know what to do with... ==
     
    <pre>
    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.
    </pre>
    </pre>


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


    <pre>
    <pre>
    Line 129: Line 87:
      audio-input-line
      audio-input-line
       The icon used for audio line input devices.
       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
      video-projector

    Latest revision as of 18:53, 11 May 2008

    Specification compliance of icon names

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

     audio-card                    OK (did not exist in KDE 3 - right?)
     audio-headset                 OK * (did not exist in KDE 3)
     audio-input-line              OK * (did not exist in KDE 3)
     audio-input-microphone        OK (did not exist in KDE 3)
     battery                       OK (KDE 3 names: battery,
                                       apps/laptop_battery)
     camera-photo                  OK (KDE 3 names:
                                       camera_unmount, camera)
     camera-video                  Needed
     camera-web                    OK (Not yet in 0.8 of the spec,
                                       only in CVS.)
     cpu                           OK ** (did not exist in KDE 3 - right?)
     computer                      OK (KDE 3 name: system)
     computer-laptop               OK ** (KDE 3 name: laptop)
     drive-harddisk                OK (KDE 3 name: hdd_unmount)
     drive-optical                 OK (did not exist in KDE 3)
     drive-removable-media         OK (did not exist in KDE 3)
     drive-removable-media-usb     OK ** (did not exist in KDE 3)
     drive-removable-media-usb-pendrive  OK **
                                      (KDE 3 name: usbpendrive_unmount)
     input-gaming                  OK (KDE 3 name: joystick)
     input-keyboard                OK (KDE 3 name: keyboard)
     input-mouse                   OK (KDE 3 name: mouse)
     input-tablet                  OK (KDE 3 name: tablet)
     media-flash                   OK (did not exist in KDE 3)
     media-flash-memory-stick      OK ** (KDE 3 name: memory_stick_unmount)
     media-flash-sd-mmc            OK ** (KDE 3 name: sd_mmc_unmount)
     media-flash-smart-media       OK ** (KDE 3 name: smart_media_unmount)
     media-floppy                  OK (KDE 3 name: 3floppy_unmount)
     media-optical                 OK (KDE 3 name: cdrom_unmount)
     media-optical-audio           -> svn rm, and replace with a
                                      combination of media-optical
                                      and emblem-audio
                                      (KDE 3 name: cdaudio_unmount)
     media-optical-recordable      OK ** (KDE 3 name: cdwriter_unmount)
     media-tape                    OK (KDE 3 name: mo_unmount)
     modem                         OK (did not exist in KDE 3 - right?)
     multimedia-player             OK (did not exist in KDE 3)
     multimedia-player-apple-ipod  OK ** (KDE 3 name: ipod_unmount)
     network-wired                 OK (did not exist in KDE 3)
     network-wireless              OK (did not exist in KDE 3)
     pda                           OK (KDE 3 names: pda_black, pda_blue)
     phone                         OK (did not exist in KDE 3 - right?)
     printer                       OK (KDE 3 names: printer1, printer)
     scanner                       OK (KDE 3 name: scanner)
     video-display                 OK (did not exist in KDE 3)
     video-projector               OK * (did not exist in KDE 3)
     video-television              OK * (KDE 3 name: tv)
    
     * 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 or necessary for it to be in there
    

    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.

     camera-video
       The fallback icon for video cameras
    

    Icons in Tango, but not in the spec

    We don't need to have those, but if we do they should be named this way:

     media-zip
       The icon for Iomega Zip media.
    

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