This is a GNOME program to manage devices and device drivers. It's
inspired by hal-device-manager, from the HAL project, but rewritten in
C for efficiency and an outlook to actually make it manage devices
rather than just show information.

ICON MANIFEST
-------------

As there are a bunch of different hardware, gnome-device-manager uses
a lot of icons. Some icons are defined in the icon-naming-spec [1] as
they are also used in the standard desktop, some are shipped with
gnome-device-manager itself as they are specific to this program.

The following is a description of all the icons used; this is provided
for graphic designers wanting to provide theme-specific verions of the
icons. Both 24x24 (for a tree view) and 48x48 (for details page)
versions of the icons are needed.


LEGEND:

           *: name is proposed for icon naming spec addendum
              for storage devices

          **: name is proposed for core icon naming spec

          OK: we have the icon in either this tarball or through
              the icon naming spec; e.g. a theme that is compliant
              with the icon naming spec will supply the icon

        HOLD: Wait; don't spend time drawing icons just yet; we're
              unsure what we need. Should be resolved quickly

   OK[<dep>]: we use the icon shipped in the "<dep>" package; for
              example OK[gpm] means that gnome-device-manager relies
              on the gnome-power-manager to be installed and supply
              the icon. If this is undesirable for distributors they
              can either patch gnome-device-manager to use a local
              copy e.g. gnome-device-manager-copy-<iconname> and make
              sure these icons are copied in.

--
gnome-device-manager
  the icon for the gnome-device-manager application; appears in menus
  and the task bar when the device manager is running
--
gnome-device-manager-device-pci
  this icon represents a PCI device
  http://en.wikipedia.org/wiki/Peripheral_Component_Interconnect
  http://www.pcisig.com/developers/procedures/logos/Trademark_and_Logo_Usage_Guidelines_updated_112206.pdf
--
gnome-device-manager-device-pci-express
  this icon represents a PCI Express device
  http://en.wikipedia.org/wiki/PCI_Express
--
gnome-device-manager-device-pccard
  this icon represents PCMCIA and Cardbus devices; typically used
  in laptops
  http://en.wikipedia.org/wiki/PC_Card
--
gnome-device-manager-device-expresscard
  this icon represents ExpressCard devices; the replacement
  for PC Cards; typically used in laptops
  http://en.wikipedia.org/wiki/ExpressCard
--
gnome-device-manager-device-usb
  this icon represents a USB device; note that this is a top-level
  device; every USB device got one or more "USB interface" objects
  as childs
  http://en.wikipedia.org/wiki/USB
--
gnome-device-manager-device-usb-interface
  this icon represents a USB interface; these are childs of the
  USB device and each interface represents a particular function;
  icon should look similar, yet distinct from, to the 
  gnome-device-manager-device-usb icon
--
gnome-device-manager-device-usb-hub
  this icon represents a USB hub
  http://en.wikipedia.org/wiki/USB_Hub
--
gnome-device-manager-device-firewire
  this icon represents a Firewire device. As with USB, this is
  used for the top-level device - each Firewire device will have
  one or more Units (equiv to USB interfaces)
  http://en.wikipedia.org/wiki/Firewire
--
gnome-device-manager-device-firewire-unit
  this icon represents an unit of a Firewire device; these are
  always childs of the Firewire device and represent a particular
  function; icon should look similar, yet distinct from, to the 
  gnome-device-manager-device-firewire icon
--
gnome-device-manager-device-firewire-hub
  this icon represents a Firewire hub
  http://www.usbfirewire.com/Parts/rr-fw-hub-6portbig.jpg
--
gnome-device-manager-device-pnp
  represents PNP capable devices on the ISA bus
  http://en.wikipedia.org/wiki/Plug-And-Play
  http://en.wikipedia.org/wiki/Industry_Standard_Architecture
--
gnome-device-manager-device-platform
  represents devices wired to a system using a non-standard bus; 
  typically hard-wired to the system (not hotpluggable)
--
OK[gpm] gpm-ac-adapter
  represents an AC Adapter / power supply
--
OK[gpm] gpm-primary-100
  represents a battery
--
OK[gpm] gpm-ups-100
  represents a battery from an UPS
  http://en.wikipedia.org/wiki/Uninterruptible_power_supply
--
HOLD gnome-device-manager-device-processor
  represents a system processor; e.g. CPU and/or CPU core
  http://en.wikipedia.org/wiki/CPU
--
gnome-device-manager-device-button
  represents a special button on the computer that
  the user can push one or more times. Is _not_ part
  of a keyboard/input device.
  http://en.wikipedia.org/wiki/Button_%28control%29
--
gnome-device-manager-device-button-switch
  Represents a button with state; e.g. it can be in two
  states; either switched on or off. Examples: lid
  switch (for closing the laptop lid)
  http://en.wikipedia.org/wiki/Switch
--
gnome-device-manager-device-sound-mixer
  represents the mixer part of a sound card
--
gnome-device-manager-device-sound-playback
  represents the playback part of a sound card
--
gnome-device-manager-device-sound-capture
  represents the capture part of a sound card
--
gnome-device-manager-device-sound-midi
  represents the MIDI part of a sound card
  http://en.wikipedia.org/wiki/MIDI
--
gnome-device-manager-device-sound-timer
  represents the global timing sound device; 
  (unsure about metaphor; suggest to use something that
  looks like gnome-device-manager-device-sound-playback)
--
gnome-device-manager-device-sound-sequencer
  represent the global sequencer audio device; 
  (unsure about metaphor; suggest to use something that
  looks like gnome-device-manager-device-sound-playback)
  http://en.wikipedia.org/wiki/Music_sequencer
--
OK[gpm] gpm-brightness-lcd
  represents the device used to set backlight; typically of
  a laptop screen
--
OK[gpm] gpm-brightness-kbd
  represents the device used to set backlight of a keyboard
  as seen on e.g. Macbook Pro and 15", 17" Powerbooks
--
gnome-device-manager-device-lightsensor
  represents the device used to measure the amount of ambient
  light in the environment the system is used; found in some
  Apple and Dell laptops
--
gnome-device-manager-device-led
  represents the LED devices; e.g. light emitting diode's on
  the system, visible to the end user, that can be turned on/off
  either manually or triggered by some system action (such as
  disk activity). Includes a wide range of different LED's from
  the thinklight on the ThinkPad to regular LED's for disk or
  network activity.
  http://en.wikipedia.org/wiki/LED
  http://en.wikipedia.org/wiki/ThinkLight
--
gnome-device-manager-input
  represents an input device; used for non-standard input
  devices.
  http://en.wikipedia.org/wiki/Input_device
--
OK input-keyboard
  represents a standard keyboard
  http://en.wikipedia.org/wiki/Alphanumeric_keyboard
--
OK input-mouse
  represents a pointing device, either a mouse or
  trackball etc.
  http://en.wikipedia.org/wiki/Pointing_device
  http://en.wikipedia.org/wiki/Computer_mouse
  http://en.wikipedia.org/wiki/Trackball
--
** input-touchpad
  represents a touch pad as commonly found on laptops
  http://en.wikipedia.org/wiki/Touchpad
--
** input-tablet
  represents a graphics tablet, e.g. Wacom has some products
  http://en.wikipedia.org/wiki/Graphics_tablet
--
gnome-device-manager-device-scsi
  represents SCSI (glue) devices (host, target, device)
  http://en.wikipedia.org/wiki/SCSI
  http://en.wikipedia.org/wiki/Image:Scsi_logo.svg
--
gnome-device-manager-device-ata
  represents PATA/SATA/ATAPI glue devices (host, device)
  http://en.wikipedia.org/wiki/AT_Attachment
  http://www.ata-atapi.com/
  (appears there is no standard logo; maybe just use
   the letters ATA)
--
gnome-device-manager-device-serial
  represents a serial port (still very much in use; just
  tunneled over USB and/or Bluetooh; e.g. cell phones / )
  http://en.wikipedia.org/wiki/Serial_Port
--
gnome-device-manager-device-serial-modem
  (TODO: icon naming spec mentions 'modem' but it's not in
  Tango just yet)
  represents a modem at the other end of a serial connection
  http://en.wikipedia.org/wiki/Modem
--
gnome-device-manager-device-parallel
  represents a parallel port (still somewhat used through
  USB adapters)
  http://en.wikipedia.org/wiki/Parallel_Port
--
gnome-device-manager-bluetooth-controller
  represents a Bluetooth host controller interface
  http://en.wikipedia.org/wiki/Bluetooth
--
gnome-device-manager-bluetooth-device
  represents a remote Bluetooth device associated with the system
  http://en.wikipedia.org/wiki/Bluetooth
--


XXXTODO: finish icon manifest



---

Current deps for OK[<dep>] are listed here. This essentially
constitutes what GNOME packages are needed for gnome-device-manager
to work icon-wise

 gpm: gnome-power-manager

and of course one or more "Icon Naming Spec 0.8" compliant icon
themes.