[gnome-color-manager] Update Help Preferences Text

[Richard Hughes <rhughes src gnome org>]

commit c038d0ce5b2eab4e4f103c382323e127fa8d50c7
Author: Paul Finnigan <paul fincc com>
Date:   Mon Feb 22 12:02:55 2010 +0000

    Update Help Preferences Text

 help/C/gnome-color-manager.xml |  115 ++++++++++++++++++++++++++++++++++------
 1 files changed, 99 insertions(+), 16 deletions(-)
---
diff --git a/help/C/gnome-color-manager.xml b/help/C/gnome-color-manager.xml
index c420838..06f07e1 100644
--- a/help/C/gnome-color-manager.xml
+++ b/help/C/gnome-color-manager.xml
@@ -92,7 +92,7 @@
       <title>Feedback</title>
       <para>
         To report a bug or make a suggestion regarding the &app; application or
-        this manual, follow the directions in the 
+        this manual, follow the directions in the
         <ulink url="http://projects.gnome.org/gnome-color-manager/bugs.html";
 	  type="http">&application; Contact Page</ulink>.
       </para>
@@ -121,25 +121,25 @@
   </indexterm>
 
   <para>
-    The &app; is a framework that helps the user generate, install and manage 
-    device color on a <systemitem>GNOME desktop</systemitem>. It does this to 
-    help a user match color across all devices. This gives a consistent color 
-    to an image or document, wherever it is output.  
+    The &app; is a framework that helps the user generate, install and manage
+    device color on a <systemitem>GNOME desktop</systemitem>. It does this to
+    help a user match color across all devices. This gives a consistent color
+    to an image or document, wherever it is output. 
   </para>
   <para>
-    The &app; communicates the selected profiles to aware applications, 
+    The &app; communicates the selected profiles to aware applications,
     maintaining the color across applications.
   </para>
   <para>
     The &app; uses <ulink url="http://www.color.org"; type="http">
     International Color Consortium</ulink> (ICC) profiles to map device
-    color characteristics onto a standard color space used by the 
-    <systemitem>GNOME desktop</systemitem>.  
+    color characteristics onto a standard color space used by the
+    <systemitem>GNOME desktop</systemitem>. 
   </para>
   <warning>
-    &app; should NOT be used to alter the appearance of your desktop. 
+    &app; should NOT be used to alter the appearance of your desktop.
     The Appearance preference tool lets you configure various aspects
-    of how your desktop looks. 
+    of how your desktop looks.
   </warning>
 
 </section>
@@ -151,21 +151,21 @@
     you can manually start <application>&app;</application> using:
   </para>
   <screen>
-    <prompt>bash$ </prompt><userinput>gcm-apply <parameter>--verbose</parameter></userinput> 
+    <prompt>bash$ </prompt><userinput>gcm-apply <parameter>--verbose</parameter></userinput>
   </screen>
   <para>
-    <application>&app;</application> preferences dialog can be started from 
+    <application>&app;</application> preferences dialog can be started from
     the GNOME Preferences Menu, but you can start this using:
   </para>
   <screen>
-    <prompt>bash$ </prompt><userinput>gcm-prefs <parameter>--verbose</parameter></userinput> 
+    <prompt>bash$ </prompt><userinput>gcm-prefs <parameter>--verbose</parameter></userinput>
   </screen>
   <para>
-    ICC profiles should be imported into the <application>&app;</application> 
+    ICC profiles should be imported into the <application>&app;</application>
     by selecting a file in a nautilus window. You can import the file using:
   </para>
   <screen>
-    <prompt>bash$ </prompt><userinput>gcm-import <filename><![CDATA[<filepath>]]></filename></userinput> 
+    <prompt>bash$ </prompt><userinput>gcm-import <filename><![CDATA[<filepath>]]></filename></userinput>
   </screen>
 </section>
 
@@ -204,7 +204,7 @@
   <itemizedlist>
     <listitem>
       <para>
-        The monitor profile.
+        A device profile.
       </para>
     </listitem>
     <listitem>
@@ -226,6 +226,51 @@
         </mediaobject>
       </screenshot>
     </figure>
+    <para>
+      To alter a profile for a device.
+      <orderedlist>
+        <listitem>
+          <para>
+            Select the device.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Select the required profile from the list in the color
+            profile drop down box.
+          </para>
+        </listitem>
+      </orderedlist>
+      <tip>
+        <para>
+          If the required profile is not in the list then
+          <orderedlist>
+            <listitem>
+              <para>
+                Select "Other profile..."
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                Find the ICC profile file using the GNOME Open
+                File dialog presented.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                Press the Open button on the dialog.
+              </para>
+            </listitem>
+          </orderedlist>
+        </para>
+      </tip>
+      <tip>
+        <para>
+          If the profile is invalid then the profile selected for the
+          device will not alter. Messages may be shown.
+        </para>
+      </tip>
+    </para>
   </section>
 
   <section id="preferences-advanced">
@@ -243,6 +288,44 @@
     <para>
       This allows you to adjust a calibrated or generated profile.
     </para>
+    <tip>
+      <para>
+        The Fine Tuning Option is only available if you configure GConf
+        to enable it (
+        <menuchoice>
+          <guimenu>apps</guimenu>
+          <guisubmenu>gnome-color-manager</guisubmenu>
+          <guimenuitem>show-fine-tuning</guimenuitem>
+        </menuchoice>).
+      </para>
+    </tip>
+    <para>
+      CRT monitors have native gamma around 2.4 - 2.5 and LCD monitors
+      usually emulate the same value.
+    </para>
+    <para>
+      Traditionally, Linux and MS Windows operating systems use image encoding
+      of 1/2.2 and do not apply any gamma adjustment to the image or video
+      card LUT. Therefore the overall gamma is expected to be around 1.1
+      (which is useful to allow for dim viewing conditions at home
+      environment).
+    </para>
+    <para>
+      Apple used to use image encoding gamma close to 1/1.8 to naturally match
+      the native gamma of printing devices (and therefore internally applied
+      gamma adjustment of 1/1.45 before displaying images on monitor so that
+      the images displayed correctly).
+    </para>
+    <para>
+      Nonetheless, since OS X (v10.6 Snow Leopard) the default image encoding
+      gamma has also the value of 1/2.2 to meet the requirements of consumer
+      imaging industry.
+    </para>
+    <para>
+      Before fine tuning the gamma in &app;, you should know what your monitor
+      native gamma is, what display gamma you want to reach and then do the
+      math yourself.
+    </para>
   </section>
 
   <section id="preferences-profiles">