Updated for XML and the new user interface.

2002-02-08  Kevin Breit  <mrproper@ximian.com>

	* C/config-mouse.xml: Updated for XML and the new user interface.

	* C/config-kbd.xml: Reworded things.
	Updated to be Gnome 2.0 ready.

	* C/config-hints.xml: Added to CVS

4 files changed, 361 insertions, 0 deletions

diff --git a/help/C/config-hints.xml b/help/C/config-hints.xml
new file mode 100644
index 000000000..4ae5ad067
--- /dev/null
+++ b/help/C/config-hints.xml
@@ -0,0 +1,64 @@
+<sect1 id="config-hints">
+  <title>Startup Hints</title>
+  <para>
+    Startup hints have become a common occurance in a lot of
+    applications, and <application>Gnome</application> is one of
+    them.  Startup hints open when a program is started, it displays
+    tips for the application to make the user's experience more
+    fruitful.
+  </para>
+  <para>
+    In <application>Gnome</application>, the startup hints can be
+    configured.  This configuration takes place in the
+    <application>Startup Hint</application> capplet of
+    <application>Gnome Control Center</application>.
+  </para>
+  <sect2 id="config-hints-window">
+    <title>Configuration</title>
+    <para>
+      Sometimes the user desires the hints window to not show up.  To
+      enable or disable, click the <guibutton>Enable login
+      hints</guibutton> button.
+      <variablelist>
+	<varlistentry>
+	  <term>Display normal hints</term>
+	  <listitem>
+	    <para>
+	      The startup hints will show the regular startup hints.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Display fortunes insetad of hints</term>
+	  <listitem>
+	    <para>
+	      <application>fortunes</application> is a small program
+	      that displays random quotes.  The gnome startup hints
+	      application can display
+	      <application>fortunes</application> quotes instead of
+	      tips.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Display message of the day instead of hints</term>
+	  <listitem>
+	    <para>
+	      Often times administrators will create a "message of the
+	      day" ("MOTD") to notify users of important events.  The
+	      gnome startup hints application can display these
+	      instead of tips.
+	    </para>
+	    <para>
+	      Most of the time, <filename>/etc/motd</filename> holds the
+	      motd.  If the file is different from
+	      <filename>/etc/motd</filename>, you can edit that in the
+	      <guilabel>Message of the day file to use</guilabel>
+	      field.
+	    </para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
+    </para>
+  </sect2>
+</sect1>
\ No newline at end of file
diff --git a/help/C/config-kbd.xml b/help/C/config-kbd.xml
new file mode 100644
index 000000000..f96ae5e75
--- /dev/null
+++ b/help/C/config-kbd.xml
@@ -0,0 +1,173 @@
+<sect1 id="config-keyboard">
+  <title>Keyboard</title>
+  <para>
+    Everyone uses the keyboard for their daily tasks.  Most people
+    think that there isn't much to configuring a keyboard.  Quite the
+    contrary.  There are numerous keyboard options which can be set to
+    make your experience more comfortable.
+  </para>
+  <sect2 id="config-keyboard-keyboard">
+    <title>Keyboard Behavior Configuration</title>
+    <para>
+      The keyboard's behavior is controlled thorugh the
+      <guilabel>Keyboard</guilabel> tab.  The following options are
+      available:
+      <variablelist>
+	<varlistentry>
+	  <term>Keyboard repeats when key is held down</term>
+	  <listitem>
+	    <para>
+	      All keyboards have the ability to rapidly repeat a
+	      keystroke on the screen if a key is held down.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Delay before repeat:</term>
+	  <listitem>
+	    <para>
+	      There is normally a delay between when the keyboard key
+	      is pressed and when the repeat is displayed on the
+	      screen.  You can choose:
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    Short
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Medium
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Long
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Very Long
+		  </para>
+		</listitem>
+	      </itemizedlist>
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Repeat speed</term>
+	  <listitem>
+	    <para>
+	      While a keystroke is being repeated, you can control how
+	      fast the repeat is.  The available speeds are:
+	      <itemizedlist>
+		<listitem>
+		  <para>
+		    Slow
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Medium
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Fast
+		  </para>
+		</listitem>
+		<listitem>
+		  <para>
+		    Very Fast
+		  </para>
+		</listitem>
+	      </itemizedlist>
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Cursor blinks in text fields</term>
+	  <listitem>
+	    <para>
+	      The keyboard cursor sometimes blinks to help show you
+	      where it is located.  The blinking can be turned off
+	      entirely by deselecting this option.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Blink speed</term>
+	  <listitem>
+	    <para>
+	      You can configure the speed at which the cursor blinks.
+	      Sliding this right will cause the cursor to blink
+	      faster, while sliding it left will cause the cursor to
+	      blink at a slower speed.
+	    </para>
+	  </listitem>
+	</varlistentry>
+      </variablelist>
+    </para>
+  </sect2>
+  <sect2 id="config-kbd-sound">
+    <title>Keyboard Sound Options</title>
+    <para>
+      The keyboard sometimes emits sounds to get the user's
+      attention.  The sounds can be configured in the
+      <guilabel>Sound</guilabel> tab.
+      <variablelist>
+	<varlistentry>
+	  <term>Keypress makes sound</term>
+	  <listitem>
+	    <para>
+	      You can set your keyboard up so when you hit a key, it
+	      will make a sound.  Click this button to enable it.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Volume</term>
+	  <listitem>
+	    <para>
+	      You can also control the volume that the click happens
+	      at.  Move the slider to the right for maximum volume,
+	      and left for minimum volume.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Keyboard bell off</term>
+	  <listitem>
+	    <para>
+	      If you wish to disable the keyboard bell, select this
+	      radio box.  This is good for situations where you need
+	      quiet, like a class or a library.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Keyboard bell enabled</term>
+	  <listitem>
+	    <para>
+	      Select this radio box to enable the keyboard bell.  This
+	      will make the computer speaker beep when it needs to get
+	      your attention.
+	    </para>
+	  </listitem>
+	</varlistentry>
+	<varlistentry>
+	  <term>Custom keyboard bell</term>
+	  <listitem>
+	    <para>
+	      You can have the system play a customized sound instead
+	      of the default system beep.  Select this radio button
+	      and press the <guibutton>Browse</guibutton> button to
+	      select the file you want.  Press the
+	      <guibutton>Done</guibutton> button to apply your changes.
+	    </para>
+	  </listitem>
+	</varlistentry>	  
+      </variablelist>
+    </para>
+  </sect2>
+</sect1>
\ No newline at end of file
diff --git a/help/C/config-mouse.xml b/help/C/config-mouse.xml
new file mode 100644
index 000000000..3e8b5516e
--- /dev/null
+++ b/help/C/config-mouse.xml
@@ -0,0 +1,117 @@
+<sect1 id="config-mouse">
+  <title>Mouse</title>
+  <sect2 id="mouse-config-introduction">
+    <title>Introduction</title>
+    <para>
+      The mouse capplet in the <application>GNOME Control
+	Center</application> helps to configure properties of the mouse,
+      such as: whether you're left handed or right handed, sensitivity,
+      and mouse speed.
+    </para>
+  </sect2>
+  <sect2 id="config-mouse-buttons">
+    <title>The Buttons Tab</title>
+    <para>
+      The buttons tab controls properties for the mouse buttons.
+    </para>      
+    <sect3 id="config-mouse-buttons-orientation">
+      <title>Mouse Orientation</title>
+      <para>
+	A mouse behaves differently based on whether the user is right
+	or left handed.  If they're right handed, the left button is the
+	action button, while the right button is the menu button.  The
+	mouse also typically sits on the right hand side of the desk.
+	If the user is left handed, they use the right button as the
+	action button, while the left button is the menu button.  It
+	also sits on the left hand of the desk.
+      </para>
+      <para>
+	To configure the hand orientation, select the
+	<guibutton>Left-handed mouse</guibutton> button.  If you're
+	right handed, deselect that button.  Press
+	<guibutton>Apply</guibutton> to apply your changes.
+      </para>
+    </sect3>
+    <sect3 id="config-mouse-buttons-dclick">
+      <title>Double-click Delay</title>
+      <para>
+	Double-clicking speed can be configured, to let you set how
+	fast you want to double-click.  This can be good for disabled
+	people who can't click fast.
+      </para>
+      <para>
+	Select the delay you wish to use on the slider.  The more
+	right it is, the longer the delay allowed.
+      </para>
+      <para>
+	You can test the speed by double-clicking on the cake at
+	right.  The candle will light on fire if it detected a
+	double-click.
+      </para>
+    </sect3>
+  </sect2>
+  <sect2 id="config-mouse-cursors">
+    <title>The Mouse Cursors Tab</title>
+    <para>
+      Cursors are the part on the desktop that represents where the
+      mouse is.  The cursor can be changed for easier use.
+    </para>
+    <sect3 id="config-mouse-cursors-theme">
+      <title>Cursor Themes</title>
+      <para>
+	<application>Gnome</application>'s mouse cursors can be
+	configured to look different.  For example, if you have a dark
+	desktop, you may want to use the white cursor.
+      </para>
+      <para>
+	To select a theme, simply click the theme you wish to use and
+	click <guibutton>Apply</guibutton>.  You will need to logout
+	for this change to occur.
+      </para>
+    </sect3>
+    <sect3 id="config-mouse-cursors-locate">
+      <title>Locating Cursors Option</title>
+      <para>
+	Sometimes, you'll lose where the cursor is.  If you select the
+	<guibutton>Show position of cursor when the Control key is
+	pressed</guibutton>, the cursor will be animated when you
+	press and release the control key.
+      </para>
+    </sect3>
+  </sect2>
+  <sect2 id="config-mouse-motion">
+    <title>The Motion Tab</title>
+    <para>
+      The mouse cursor can be set to move at different speeds and
+      sensitivities.  The following options are available for you to
+      edit:
+    </para>
+    <sect3 id="config-mouse-motion-speed">
+      <title>Speed</title>
+      <para>
+	The mouse pointer can move at different speeds across the
+	screen.  Everyone has their favorite speed, so the ability to
+	configure this is important.
+      </para>
+<!-- Figure out what acceleration and sensitivity is -->
+      <para>
+	To set your mouse speed, move the bar to either faster or slower
+	in the <guilabel>Mouse speed</guilabel> section.  Afterwards,
+	click <guibutton>Apply</guibutton> to test the speed.  Once you
+	select your desired speed, click <guibutton>Close</guibutton>.
+      </para>
+    </sect3>
+    <sect3 id="config-mouse-motion-dnd">
+      <title>Drag and Drop</title>
+      <para>
+	Drag and drop is clicking an object, and dragging it to
+	another place on the screen, causing an event to occur.
+      </para>
+      <para>
+	You need to drag it a certain amount of distance before the
+	system will recognize it as a drag and drop operation.  To
+	configure how far to drag it, move the slider left or right.
+      </para>
+    </sect3>
+  </sect2>
+</sect1>
diff --git a/help/ChangeLog b/help/ChangeLog
index 3e6239540..f943e46f0 100644
--- a/help/ChangeLog
+++ b/help/ChangeLog
@@ -1,5 +1,12 @@
 2002-02-08  Kevin Breit  <mrproper@ximian.com>
 
+	* C/config-mouse.xml: Updated for XML and the new user interface.
+
+	* C/config-kbd.xml: Reworded things.
+	Updated to be Gnome 2.0 ready.
+
+	* C/config-hints.xml: Added to CVS
+
 	* C/config-default-apps.xml: Added to CVS.  It's ready to go for XML.
 
 	* C/control-center.xml: Changed this to use xml files instead of sgml