<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.0//EN"[
<!ENTITY version "1.2.0">
<!ENTITY gcolor "<application>GNOME Color Browser</application>">
]>


<!-- =============Document Header ============================= -->

<article id="index"> 

 <artheader>
  <title>GNOME Color Browser manual</title>
  <copyright>
   <year>2000</year>
   <holder>Alexander Kirillov</holder>
  </copyright>

  <legalnotice>
   <para>
    Permission is granted to copy, distribute and/or modify this
    document under the terms of the <citetitle>GNU Free Documentation
    License</citetitle>, Version 1.1 or any later version published
    by the Free Software Foundation with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy
    of the <citetitle>GNU Free Documentation License</citetitle> from
    the Free Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to:
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>


 </artheader>

 <!-- ============= Document Body ============================= -->

 <!-- ============= Introduction ============================== -->
  <sect1 id="intro">
    <title>Introduction</title>
    
    <para>
      &gcolor; is a utility for selecting screen (i.e., X Window
      System) color. X Window System comes with many pre-defined
      colors, from Alice Blue to Pale Goldenrod to Yellow
      Green. &gcolor; lets you browse these colors and select one of
      them to be used by an application. It also allows you define
      your own collection of favorite colors, or find a pre-defined
      color most closely matching a given one.
    </para>
    <para>
      To run &gcolor; select <guimenuitem>Color Browser</guimenuitem>
      from the <guisubmenu>Utilities</guisubmenu> submenu of the
      <guimenu>Main Menu</guimenu>, or type
      <command>gcolorsel</command> on the command line.
    </para>

    <para>
      &gcolor; is included in the
      <filename>gnome-utils</filename> package, which is part of the
      GNOME desktop environment. This document describes version
      &version; of &gcolor;. 
    </para>

  </sect1>


 <!-- ================ Usage ================================ -->
 

  <sect1 id="usage">
    <title>Using GNOME Color Browser</title>
    <para>
      &gcolor; is used for manipulating palettes, i.e. collections of
      screen colors. It allows you to browse the system palette (list
      of colors that come pre-defined with your system), define and
      edit your own palettes, select a color from any of these
      palettes to be used by an application, or find best matches for
      a given color in these palettes.
    </para>
    <para>
      &gcolor; can also be used to define new colors; however, it only
      makes sense to do so if you plan on using this color many
      times. In this case, you can use &gcolor; to define a new color
      and add it to your personal palette. If you only want to use a
      color once, it is easier to use the default GNOME Color
      Selector.
    </para>

    <sect2 id="multdocs">
      <title>Working with multiple documents</title>
      <para>
	The main &gcolor; window may contain several sub-windows
	("views"). Each of these views shows either a contents of a
	<link linkend="simple">palette</link> (system or your personal
	one) or a <link linkend="search">search window</link>, used
	for finding matching colors. For example, in the default
	configuration &gcolor; starts with 4 views: two showing the
	system palette (one listing colors by name, the other using
	small color squares to represent them), a view of the users
	palette (originally empty), and a search window.  Having
	multiple views can be very convenient if you want to work with
	several palettes at the same time, use drag and drop to move a
	color from one palette to another, etc.
      </para>
      <para>
	To switch between views, click on the views tab at the
	top (provided that you are using default GTK theme) of the
	window.  If there are too many open views so that the tabs
	do not fit the screen, you will see 2 arrows at the top right
	of &gcolor; window; these arows allow you to scroll
	through the tabs.
      </para>
      <para>
	Every time you open a new view, a new
	sub-window is added to the existing ones.  To close a view,  select
	<menuchoice><guimenu>File</guimenu>
	<guimenuitem>Close</guimenuitem> <guimenuitem>Close
	view</guimenuitem></menuchoice> or click on the
	<guibutton>Close</guibutton> in the toolbar. If you have
	several views showing the same document,  you can close all of
	them by selecting <menuchoice><guimenu>File</guimenu>
	<guimenuitem>Close</guimenuitem> <guimenuitem>Close
	document</guimenuitem></menuchoice> (do not forget
	to save it first if you made any changes). Finally, you can
	also drag a view tab out of &gcolor; window; this will
	create a new &gcolor; window, showing this view. 
      </para>
    </sect2>

    <sect2 id="usingforapps">
      <title>Using a color for an application</title>
      <para>
	Once you have found a color you like, there are two ways you
	can use this color in an application. The easiest way is to
	utilize drag and drop: all the color bars you see in the
	&gcolor; window can be drag-and-dropped onto any GNOME
	component which has configurable colors. For example, you can
	drag a color onto GNOME <interface>Panel</interface> to change
	Panel's background color, or onto <application>GNOME
	Terminal</application> to change its background.
      </para>
      <para>
	You can also use the color with many X Window applications
	which are not GNOME-compliant, for example with
	<application>emacs</application> text editor. Most of X
	applications accept command line options <command>-bg
	<replaceable>COLOR</replaceable></command> and <command>-fg
	<replaceable>COLOR</replaceable></command> to specify the
	background and foreground
	color. <replaceable>COLOR</replaceable> can be either a system
	color name, as shown by &gcolor; or its description by a
	triple of numbers, Red, Green, and Blue (RGB) values.  For
	example, the command
	<programlisting>
	  <command>emacs -bg lightblue -fg darkgreen</command>
	</programlisting>
	will start <application>emacs</application> with light blue
	background and dark green foreground. Note that contrary to
	common UNIX conventions, color names are case-insensitive.  More
	information about colors in X Window System, RGB values, color
	depth, etc. is given in <xref linkend="xcolors">.
      </para>
    </sect2>
      
  </sect1>
 

 <!-- ============= Menus ================================== -->
  <sect1 id="menus">
   <title>Menus and toolbar</title>
    
    

    <sect2 id="menubar">
      <title>Menubar</title>
      <para>
	The menu bar, located at the top of the &gcolor; window, contains
	the following menus: 
      </para>

      <variablelist>
	<varlistentry>
	  <term><guimenu>File</guimenu></term>
	  <listitem>
	    <para>
	      This menu contains the following commands:
	    </para>
	    <itemizedlist> <listitem><para>
              <guimenuitem>New</guimenuitem>: this command allows you
              to create a new empty palette (see <xref
              linkend="newpalette">) or a new view of an existing
              palette in a different window.
		</para>
	      </listitem>

	      <listitem><para>
		  <menuchoice>
		    <shortcut> <keysym>F3</keysym></shortcut>
		    <guimenuitem>Open</guimenuitem>
		  </menuchoice>: this command opens an existing  palette,
		  prompting you to select a file containing this palette. 
		</para>
	      </listitem>

	      <listitem><para>
		  <menuchoice>
		    <shortcut> <keysym>Ctrl-S</keysym></shortcut>
		    <guimenuitem>Save palette</guimenuitem> </menuchoice>:
		    saves current palette. Note that system palette
		    can not be changed by a user, so this command has
		    no effect in the system palette view. It also has
		    no effect in search documents.
		</para>
	      </listitem>

	      <listitem><para>
		  <menuchoice>
		    <guimenuitem>Save palette as</guimenuitem>
		  </menuchoice>: saves the current palette under a new
		  name. Has no effect in search documents.  
		</para>
	      </listitem>

	      <listitem><para>
		  <menuchoice>
		    <guimenuitem>Revert</guimenuitem>
		  </menuchoice>: discard the changes you made to the
		  current document,
		  restoring  the palette to the original state.  
		</para>
	      </listitem>

	      <listitem><para>
		  <menuchoice>
		    <shortcut> <keysym>Ctrl-W</keysym></shortcut>
		    <guimenuitem>Close</guimenuitem>
		  </menuchoice>: allows you to close the current view
		    or all views of the current document. 
		</para>
	      </listitem>
	      
	      <listitem><para>
		  <menuchoice>
		    <shortcut> <keysym>Ctrl-Q</keysym></shortcut>
		    <guimenuitem>Exit</guimenuitem>
		  </menuchoice>: exits the program. 
		</para>
	      </listitem>
	    </itemizedlist>
	  </listitem>
	</varlistentry>
<!--
    <varlistentry>
     <term><guimenu>Settings</guimenu></term>
     <listitem>
      <para>
       This menu contains commands for changing various settings and
       preferences of &gcolor;: 
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>Format</guimenuitem>
           &mdash; this option allows you to change the format used by
           &gcolor; for showing Red, Green and Blue (RGB) values for
           each color (see details in <xref linkend="xcolors">). Unless
           you know what you are doing, it is best to use the default
           format (8-bit decimal). 
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>Search update</guimenuitem>
          &mdash;this command is described in <xref linkend="search">.
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>Search in </guimenuitem>
          &mdash;this command is described in <xref linkend="search">.
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>On drop</guimenuitem>
          &mdash;this command allows you to choose the default action
          to perform when you drop into &gcolor; window a color from
          some different source, such as the default GNOME color
          selector. Possible options are <guilabel>Search
          it</guilabel>, i.e. automatically switch to
          <guilabel>Search</guilabel> window and show the best matches
          to the dropped color among the system colors and favorites,
          or <guilabel>Add to favorites</guilabel>, i.e. add the
          dropped color to your list of favorites.  
         </para>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
-->

	<varlistentry>
	  <term><guimenu>Edit</guimenu></term>
	  <listitem>
	    <para>This menu contains the following commands:
	    </para>
	    
	    <itemizedlist> 
	      <listitem><para>
		   <menuchoice>
		    <shortcut> <keysym>Ctrl-C</keysym></shortcut>
		    <guimenuitem>Copy</guimenuitem>
		  </menuchoice>: copies the currently selected
		    color(s) to the clipboard
		</para>
	      </listitem>


	      <listitem><para>
		   <menuchoice>
		    <shortcut> <keysym>Ctrl-V</keysym></shortcut>
		    <guimenuitem>Paste</guimenuitem>
		  </menuchoice>: pastes the contents of the clipboard
		    into current document. 
		</para>
	      </listitem>

	      <listitem><para>
		  <guimenuitem>Insert color</guimenuitem>: creates a
		  new <link linkend="editcolor">edit</link> sub-window allowing
		  you to define a new color and add it to the current
		  document. 
		</para>
	      </listitem>


	      <listitem><para>
		  <guimenuitem>Remove selected colors</guimenuitem>: remove
		  selected colors from the palette.
		</para>
	      </listitem>


	      <listitem><para> <guimenuitem>Edit selected
		  colors</guimenuitem>: this command launches a new
		  sub-window in which you can change the properties of
		  selected colors (see <xref linkend="editcolor">).
		</para>
	      </listitem>


	      <listitem><para> <guimenuitem>Document/View
		  properties</guimenuitem>: launches
		  <interface>Properties</interface> dialog<!--, described
		  in <xref linkend="properties"> -->
		</para>
	      </listitem>

	      <listitem><para> <guimenuitem>Preferences
		  </guimenuitem>: launches
		  <interface>Preferences</interface> dialog<!--, described
		  in <xref linkend="prefs">-->
		</para>
	      </listitem>
	    </itemizedlist>
	    
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guimenu>Help</guimenu></term>
	  <listitem>
	    <para>
	      This menu contains:
	      <itemizedlist>
		<listitem>
		  <para>
		    <guimenuitem>Manual</guimenuitem>: shows this manual.
		  </para>
		</listitem>

		<listitem>
		  <para>
		    <guimenuitem>About</guimenuitem>: shows basic
		    information about &gcolor;, such as the author's
		    name and the application version number.
		  </para>
		</listitem>
	      </itemizedlist>
	      
	    </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2>


    <sect2 id="toolbar">
      <title>Toolbar</title> 
      <para>
	The toolbar is located under the menubar and contains the
	following buttons:
      </para>
      <itemizedlist>

	<listitem>
	  <para>
	    <guibutton>Exit</guibutton>: exits the program.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guibutton>Open</guibutton>: opens an existing  palette,
		  prompting you to select a file containing this palette
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guibutton>Close</guibutton>: closes the current
	    view sub-window. 
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guibutton>Grab</guibutton>: allows you to select a
	    color anywhere on the screen for matching (see <xref
	    linkend="search"> for detailed description). 
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guibutton>About</guibutton>: shows basic
		    information about &gcolor;, such as the author's
		    name and the application version number.
		  </para>
	  </listitem>
	  </itemizedlist>
    </sect2> 


  </sect1> 





<!-- ============================Documents and views ================ -->
  <sect1 id="documents">
    <title>Documents and views</title> 
    
    <para>
       &gcolor; uses the term "document" to refer to any collection of
       colors, each each color given a name. The simplest type of
       document is a palette, which is just a collection of colors
       listed in a file; this is described in <xref
       linkend="simple">. Another type of document is <link
       linkend="search">search document</link>, which is a list of
       colors closely matching a given one found in various palettes.
       In addition, &gcolor; provides a number of different ways, or
       "view modes" to show the same document. Available view modes
       include: 
    </para>
	  <itemizedlist>
            <listitem> <para>
              <guilabel>List</guilabel>: in this
                  mode, &gcolor; lists all colors in a document
                  showing a small sample, Red, Green and Blue (RGB)
                  values and name for each color (see <xref
                  linkend="xcolors"> for detailed information about
                  RGB values).
             </para>
	  <para>
	    By default, the colors are listed in the same order in
	    which they appear in the file, which is indicated by a
	    small downward triangle next to the label
	    <guilabel>Color</guilabel>.  As with all GNOME
	    applications, you can reverse the order by clicking on the
	    word <guilabel>Color</guilabel> once. You can also have
	    the list ordered alphabetically by name by clicking on
	    <guilabel>Name</guilabel> label.
	  </para>
	  
	  <para> 
	    You can change the default width of 
	    <guilabel>Value</guilabel> and <guilabel>Name</guilabel> fields by
	    dragging the separator between these fields with the left mouse
	    button. 
	  </para>



	  <figure id="bynamefig">
	    <title>List view</title>
	    <screenshot>
	      <screeninfo>Color Browser System colors list view</screeninfo>
	      <graphic fileref="figures/list" format="png"
		       srccredit="sasha">
	      </graphic>
	    </screenshot>
	  </figure>

            </listitem> 
       
             <listitem> <para>
                  <guilabel>Grid </guilabel>: in this mode, &gcolor;
                  shows just a small square color  sample for each
                  color, arranging this squares in a grid.  
             </para>


	  <figure id="palettefig">
	    <title>Grid view</title>
	    <screenshot>
	      <screeninfo>Color Browser System colors by name</screeninfo>
	      <graphic fileref="figures/grid" format="png"
		       srccredit="sasha">
	      </graphic>
	    </screenshot>
	  </figure>
 

            </listitem> 
       
           <listitem> <para>
                  <guilabel>Edit </guilabel> TODO
             </para>
            </listitem> 
       
         </itemizedlist>

      <para> 
      Regardless of the view you use, you can drag any of the color
      sample rectangles to GNOME Panel, GNOME Terminal, and many other
      GNOME applications windows to change their background colors.
    </para>


        </sect1>



<!-- ============================Palette documents ================ -->
  <sect1 id="simple">
    <title>Working with palettes</title> 
    
    <para>
      A palette is just a list of colors, each one given a name. For
      example, X Window System comes with pre-defined system palette,
      containing hundreds of colors, from simple ones such as "red" or
      "blue" to exotic ones such as "LavenderBlush". You can also
      define your own palette, or several of them, as described
      below. Each palette is saved as a separate file; for example,
      the system palette is defined by the file
      <filename>rgb.txt</filename>, located in X11 library directory,
      usually <filename
      class="directory">/usr/lib/X11R6/lib/X11</filename>).
    </para>
      


   <sect2>
     <title> Opening and closing palettes</title>

    <para>
      By default, &gcolor; shows you 2 views of the system palette:
      one list view and one grid view. You can also open any other
      existing palette file by selecting <menuchoice><guimenu>File</guimenu>
	<guimenuitem>Open</guimenuitem> </menuchoice> or using the
      <guibutton>Open</guibutton> button in the toolbar. You can also
      open another window containing one more view of the current
      palette by selecting
      <menuchoice><guimenu>File</guimenu> <guisubmenu>New</guisubmenu>
       <guimenuitem>New view</guimenuitem></menuchoice>. 

      </para>
      <para>  To close the current view of a document, select
      <menuchoice><guimenu>File</guimenu>
      <guisubmenu>Close</guisubmenu><guimenuitem>Close
      view</guimenuitem></menuchoice>; to close all views of the
      current palette, choose <menuchoice><guimenu>File</guimenu>
      <guisubmenu>Close</guisubmenu><guimenuitem>Close
      document</guimenuitem></menuchoice>.  
      </para>
    </sect2>

    <sect2 id="newpalette">
      <title>Creating new palettes</title>
      <para>
	In addition to system colors which an ordinary user can not
	change, you can also create your own color lists. To do so,
	select
	<menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
	<guimenuitem>New Document</guimenuitem> </menuchoice>. This
	will launch a dialog allowing you to select a new document
	type (choose <guilabel>File</guilabel>), short description,
	and a short name (this will be used for the tab label). YOu
	will also have to select a view mode for the new document (you
	can select several if you want to). After you click
	<guibutton>Finish</guibutton>, a new document view sub-window
	will appear in the main window of &gcolor;.  Originally this
	window is empty; you can add any colors to it as described
	below. 
      </para>
    </sect2>



    <sect2 id="editingpalette"> 
     <title>Editing and saving palettes</title>
     <para>
	Once you have created your own palettes, you can add and remove
	colors to them, change palettes' name etc. Note that unless
	you are logged in as system administrator (root), you can not
	change system palette. 
      </para>
      <para>
	To add a new color to a palette, right-click anywhere in the
	palette and select <guimenuitem>Insert color</guimenuitem>
	from the <guimenu>pop-up</guimenu> menu, or select
	<guimenuitem>Insert color</guimenuitem> from the
	<guimenu>Edit</guimenu> menu. This will create a new <link
	linkend="editcolor">dialog</link>, allowing you to specify the
	name and RGB values for the color.  </para> <para> To copy a
	color form one palette to another, select this color in the
	first palette, copy it to the clipboard using
	<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem>
	</menuchoice> switch to the second palette and select
	<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem>
	</menuchoice>. You can also use keyboard shrotcuts
	<keysym>Ctrl-C</keysym> and <keysym>Ctrl-V</keysym> for
	copying and pasting respectively.
      </para>
       <para>
	To remove a color from the palette, select this color by
	clicking on it and select <menuchoice><guimenu>Edit</guimenu>
	<guimenuitem>Remove selected colors</guimenuitem>
	</menuchoice>. An easier way of removing a color is to
	right-click on it and select <guimenuitem>Remove selected
	colors</guimenuitem> from the <guimenu>pop-up</guimenu>
	menu. In the same way, you can select several colors and
	remove them all: to do so, click on the colors you want to
	select while pressing <keycap>CTRL</keycap> key. You can also
	select a continuous block of colors by clicking on the first
	color, and then clicking on the last color of the block while
	pressing <keycap>SHIFT</keycap> key.
      </para>
      <para> 
        Finally, you can change other properties of the document,
        such as the name and view mode used by selecting
        <guimenuitem>Document/View Properties</guimenuitem> from
        <guimenu>Edit</guimenu> or <guimenu>pop-up</guimenu>
        menus. This will launch <interface>Properties</interface> dialog<!--,
        described in <xref linkend="properties">-->.  
      </para>
      <para> 
	After modifying a palette, you can save your changes by
	selecting <menuchoice><guimenu>File</guimenu>
                    <guimenuitem>Save palette</guimenuitem>
	</menuchoice>. You can also change modified palette under a
	new name by using <guimenuitem>Save palette as...</guimenuitem>
	command; this will prompt you for a new file name and
	location. 
      </para>

    </sect2>

    <sect2 id="editcolor">
      <title>Editing a color</title>
      <para>
	To change a color in a palette, select it by clicking on it
	and select <menuchoice><guimenu>Edit</guimenu>
	  <guimenuitem>Edit selected color</guimenuitem> </menuchoice>,
	or just right click on the color and select <guimenuitem>Edit
	selected color</guimenuitem> from the
	<guimenu>pop-up</guimenu> menu.
      </para>
    </sect2>
  </sect1> 

<!-- =================Search windows ==================== -->
  <sect1 id="search">
    <title> Search</title> 
    <para>
      This window, labelled <guilabel>Search</guilabel>, is used to
      find a system color most closely matching a given one. You can
      specify a color to match in several ways: by explicitly giving
      the RGB values using the sliders, by dragging and dropping a
      color from some other color source, such as default GNOME color
      selector (if you have selected the option
      <menuchoice><guisubmenu>On drop</guisubmenu>
      <guimenuitem>Search</guimenuitem> </menuchoice> in
      <guimenu>Settings</guimenu> menu), or by grabbing a color of any
      pixel on the screen. To use this last method, click on
      <guibutton>Grab</guibutton> button in the toolbar. Your mouse
      cursor will turn into a dropper. Place the tip of this dropper  over
      any point of the screen and click. &gcolor; will analyze the
      color of this point, determine the RGB values, and show this
      color and the RGB values in the <guilabel>Search</guilabel>
      window. It will also show all system colors closely matching
      this one.
    </para>
    

    <figure id="searchfig">
      <title>Search Window</title>
      <screenshot>
	<screeninfo>Color Browser Search Window</screeninfo>
	<graphic fileref="figures/search" format="png"
		 srccredit="sasha">
	</graphic>
      </screenshot>
    </figure>

    <para> 
      &gcolor; shows only those colors which match the given one
      "close enough", and orders them by how close they are, so that
      the best matches are shown first. You can adjust its tolerance
      by using the <guilabel>Tolerance</guilabel> slider: smaller
      values make &gcolor; to be more selective, so that only very close
      matches are shown. Setting the tolerance value to 0 will show
      only exact matches; setting tolerance to 100 will show all the
      colors. 
    </para> 
    <para> 
      By default, &gcolor; only looks for matches among the system
      colors. This can be changed TODO
    </para>
    <para>Another configurable option is the update mode. By default,
    &gcolor; continuously 
    updates matches when you change the color (for example, by using
    the RGB sliders) &mdash;. If you find that this is slow on your
    system, you can use <menuchoice><guimenu>Settings</guimenu>
     <guimenuitem>Search update</guimenuitem>
      </menuchoice> to change the update mode to
    <guilabel>Discontinuous</guilabel> (&gcolor; will only update
    matches after you released the slider) or
    <guilabel>Delayed</guilabel> ((&gcolor; will  update
    matches with a delay of about 1/2 second). 
    </para>
  </sect1>
 
<!-- ================Properties Dialog =================== -->
<!--

  <sect1 id="properties">
    <title>Properties dialog</title>
    <para>
      FIXME
    </para>
  </sect1>
-->

<!-- ================Preferences Dialog =================== -->
<!--

  <sect1 id="prefs">
    <title>Preferences  dialog</title>
    <para>
      FIXME
    </para>
  </sect1>
-->

 <!-- ============= Colors and RGB================================== -->  
  <sect1 id="xcolors">
    <title>Colors in X Window System</title> 

    <para> In X Window system, each color is described by 3 numbers,
      namely the contents of Red, Green and Blue (as is well known,
      every color can be obtained by combining these three primary
      colors). These 3 values are commonly called the RGB
      values. Usually each of them is allowed to range from 0 to 255;
      for example, triple (0,0,0) is black, (255,0,0) is pure red, and
      (255, 255, 255) is white.  
      </para> 
      <para> The total number of possible colors is thus
      256&times;256&times;256=2<superscript>24</superscript>=16,777,216.
      Of course, whether or not your system is actually able to show
      that many different colors depends on the configuration of X
      Window system, which is limited by the capabilities of your
      video card. Most modern video cards are capable of showing all
      these colors; some older cards will only be able to use
      2<superscript>16</superscript>=64,536 (colordepth 16) or even
      2<superscript>8</superscript>=256 (colordepth 8) colors. In this
      case, X Window System will still use triples like (234, 112,
      243) for describing RGB values, but some of these triples will
      produce identical colors. More information about colors can be
      found in the manual page for X. 
  </para>
  </sect1>
 <!-- ============= Bugs ================================== -->

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   At the moment, too many to list. 
  </para>
 </sect1>


<!-- ============= Authors ================================ -->

  <sect1 id="authors">
    <title>Authors</title>
    <para>
      &gcolor; was written by Tim Gerla and Eric Brayeur.  Please send
      all comments, suggestions, and bug reports to the <ulink
      url="http://bugs.gnome.org" type="http">GNOME bug tracking
      database</ulink>. (Instructions for submitting bug reports can
      be found <ulink url="http://bugs.gnome.org/Reporting.html"
      type="http"> on-line</ulink>.) You can also use <application>Bug Report
      Tool</application> (<command>bug-buddy</command>), available in
      the <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
      Menu</guimenu>, for submitting bug reports.
    </para>

    <para>
      This manual was written by Alexander Kirillov
      (<email>kirillov@math.sunysb.edu</email>). Please send all
      comments and suggestions regarding this manual to the <ulink
      type="http" url="http://www.gnome.org/gdp">GNOME Documentation
      Project</ulink> by sending an email to
      <email>docs@gnome.org</email>. You can also add your comments
      online by using the <ulink type="http"
      url="http://www.gnome.org/gdp/doctable/">GNOME Documentation
      Status Table</ulink>.
    </para>
  </sect1>


 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>License</title>
  <para>
      This program is free software; you can redistribute it and/or
      modify it under the terms of the <citetitle>GNU General Public
	License</citetitle> as published by the Free Software Foundation;
      either version 2 of the License, or (at your option) any later
      version.
    </para>
    <para>
      This program is distributed in the hope that it will be useful, but
      WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      <citetitle>GNU General Public License</citetitle> for more details.
    </para>
    <para>
      A copy of the <citetitle>GNU General Public License</citetitle>
      is included as an appendix to the <citetitle>GNOME Users
      Guide</citetitle>.  You may also obtain a copy of the
      <citetitle>GNU General Public License</citetitle> from the Free
      Software Foundation by visiting <ulink type="http"
      url="http://www.fsf.org">their Web site</ulink> or by writing to
      <address>
	Free Software Foundation, Inc.
	<street>59 Temple Place</street> - Suite 330
	<city>Boston</city>, 
	<state>MA</state> <postcode>02111-1307</postcode>
	<country>USA</country>
      </address>
    </para>
  </sect1>
</article>




