<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY date        "<date>20 December,2008</date>">
  <!ENTITY package     "colormgr">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      <email>richard@hughsie.com</email>;
    </address>
    <author>
      <firstname>Richard</firstname>
      <surname>Hughes</surname>
    </author>
    <copyright>
      <year>2010</year>
      <holder>Richard Hughes</holder>
    </copyright>
    &date;
  </refentryinfo>
  <refmeta>
    <refentrytitle>colormgr</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>&package;</refname>
    <refpurpose>Color Manager Testing Tool</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&package;</command>
      <arg><option>--verbose</option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>
    <para>
      This manual page documents briefly the <command>&package;</command> command.
    </para>
    <para>
      <command>&package;</command> allows an administrator to view and
      change color profile to device mappings.
    </para>
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
    <para>
      This program follows the usual &gnu; command line syntax,
      with long options starting with two dashes (`-').  A summary of
      options is included below.
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <option>--help</option>
        </term>
        <listitem>
          <para>Show summary of options.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>COMMANDS</title>
    <para>
      This program takes commands with a variable number of arguments.
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <option>create-device</option>
	  <parameter>device_id</parameter>
	  <parameter>scope</parameter>
        </term>
        <listitem>
          <para>Creates a color managed device</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>create-profile</option>
	  <parameter>profile_id</parameter>
	  <parameter>scope</parameter>
        </term>
        <listitem>
          <para>Create a color profile</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>delete-device</option>
	  <parameter>device_path</parameter>
        </term>
        <listitem>
          <para>Deletes a color managed device</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>delete-profile</option>
	  <parameter>profile_path</parameter>
        </term>
        <listitem>
          <para>Deletes a color profile</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-add-profile</option>
	  <parameter>device_path</parameter>
	  <parameter>profile_path</parameter>
        </term>
        <listitem>
          <para>Add a profile to a device that already exists</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-get-default-profile</option>
	  <parameter>device_path</parameter>
        </term>
        <listitem>
          <para>Gets the default color profile for a device</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-get-profile-for-qualifier</option>
	  <parameter>device_path</parameter>
	  <parameter>qualifier</parameter>
        </term>
        <listitem>
          <para>Returns all the profiles that match a given qualifier</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-make-profile-default</option>
	  <parameter>device_path</parameter>
	  <parameter>profile_path</parameter>
        </term>
        <listitem>
          <para>Makes a profile default for a specific device</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-set-kind</option>
	  <parameter>device_path</parameter>
	  <parameter>kind</parameter>
        </term>
        <listitem>
          <para>Sets the device kind</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-set-model</option>
	  <parameter>device_path</parameter>
	  <parameter>model</parameter>
        </term>
        <listitem>
          <para>Sets the device model</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-set-serial</option>
	  <parameter>device_path</parameter>
	  <parameter>serial</parameter>
        </term>
        <listitem>
          <para>Sets the device serial</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>device-set-vendor</option>
	  <parameter>device_path</parameter>
	  <parameter>vendor</parameter>
        </term>
        <listitem>
          <para>Sets the device vendor</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>find-device</option>
	  <parameter>device_id</parameter>
        </term>
        <listitem>
          <para>Find a device from the device ID</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>find-device-by-property</option>
	  <parameter>key</parameter>
	  <parameter>value</parameter>
        </term>
        <listitem>
          <para>Find a device with a given property value</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>find-profile</option>
	  <parameter>profile_id</parameter>
        </term>
        <listitem>
          <para>Find a profile from the profile ID</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>find-profile-by-filename</option>
	  <parameter>filename</parameter>
        </term>
        <listitem>
          <para>Find a profile from the filename</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>get-devices</option>
        </term>
        <listitem>
          <para>Gets all the color managed devices</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>get-devices-by-kind</option>
	  <parameter>kind</parameter>
        </term>
        <listitem>
          <para>Gets all the color managed devices of a specific kind</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>get-profiles</option>
        </term>
        <listitem>
          <para>Gets all the available color profiles</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>profile-set-filename</option>
	  <parameter>profile_path</parameter>
	  <parameter>filename</parameter>
        </term>
        <listitem>
          <para>Sets the profile filename</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>profile-set-qualifier</option>
	  <parameter>profile_path</parameter>
	  <parameter>qualifier</parameter>
        </term>
        <listitem>
          <para>Sets the profile qualifier</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>
    <para>This manual page was written by Richard Hughes <email>richard@hughsie.com</email>.
    </para>
  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
