Merge pull request #51 from infirit/yelptools

Use yelp-tools instead of mate-doc-utils

1 files changed, 474 insertions, 0 deletions

diff --git a/stickynotes/docs/C/index.docbook b/stickynotes/docs/C/index.docbook
new file mode 100644
index 00000000..983e415b
--- /dev/null
+++ b/stickynotes/docs/C/index.docbook
@@ -0,0 +1,474 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+  <!ENTITY legal SYSTEM "legal.xml">
+  <!ENTITY appletversion "2.12">
+  <!ENTITY applet "Sticky Notes">
+]>
+
+<!-- (Do not remove this comment block.)
+Maintained by the MATE Documentation Project
+http://developer.mate.org/projects/gdp
+Template version: 2.0 beta
+Template last modified Mar 12, 2002
+-->
+
+<article id="index" lang="en">
+<!-- please do not change the id; for translations, change lang to appropriate code -->
+    
+    <articleinfo> 
+      <title>&applet; Manual</title> 
+      <abstract role="description">
+	<para>&applet; enables you to create, view, and manage 
+          sticky notes on your desktop.</para>
+      </abstract>
+
+      <copyright>
+        <year>2005</year>
+	<holder>Davyd Madeley</holder>
+      </copyright>
+      <copyright>
+        <year>2004</year>
+        <holder>Shaun McCance</holder>
+      </copyright>
+      <copyright>
+        <year>2004</year>
+        <holder>Angela Boyle</holder>
+      </copyright>
+      <copyright> 
+        <year>2003</year>  
+        <year>2004</year>  
+        <holder>Sun Microsystems</holder> 
+      </copyright> 
+      <copyright> 
+        <year>2003</year>  
+        <holder>Loban A Rahman</holder> 
+      </copyright> 
+
+	<!-- Translators: uncomment this:
+	<copyright>
+	    <year>2002</year>
+	    <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
+	</copyright>
+	-->
+
+	<publisher role="maintainer"> 
+	    <publishername>MATE Documentation Project</publishername> 
+	</publisher> 
+	
+	&legal;
+
+	<authorgroup>
+          <author>
+            <firstname>Shaun</firstname>
+            <surname>McCance</surname>
+            <affiliation>
+              <orgname>MATE Documentation Project</orgname>
+	      <address><email>[email protected]</email></address>
+            </affiliation>
+          </author>
+          <author>
+            <firstname>Angela</firstname>
+            <surname>Boyle</surname>
+	    <affiliation>
+             <address><email>[email protected]</email></address>
+	    </affiliation>
+          </author>
+          <author> 
+            <firstname>Loban</firstname> 
+            <surname>Rahman</surname> 
+	    <affiliation>
+             <address><email>[email protected]</email></address>
+	    </affiliation>
+          </author>
+	  <author>
+	    <firstname>Davyd</firstname><surname>Madeley</surname>
+	    <affiliation>
+	     <orgname>MATE Project</orgname>
+	     <address><email>[email protected]</email></address>
+	    </affiliation>
+	  </author>
+
+	    <!-- This is appropriate place for other contributors: translators, maintainers, etc. Commented out by default.
+	    <othercredit role="translator">
+		<firstname>Latin</firstname> 
+		<surname>Translator 1</surname> 
+		<affiliation> 
+		    <orgname>Latin Translation Team</orgname> 
+		    <address> <email>[email protected]</email> </address> 
+		</affiliation>
+		<contrib>Latin translation</contrib>
+	    </othercredit>
+	    -->
+	</authorgroup>
+	
+	<releaseinfo revision="2.26" role="review"/>
+
+	<revhistory>
+	    <revision>
+	      <revnumber>Version 2.12</revnumber>
+	      <date>September 2005</date>
+	      <revdescription>
+	       <para role="author">Davyd Madeley</para>
+	      </revdescription>
+	    </revision>
+	    <revision>
+	      <revnumber>Version 2.10</revnumber>
+	      <date>March 2005</date>
+	      <revdescription>
+	       <para role="author">Davyd Madeley</para>
+	      </revdescription>
+	    </revision>
+	    <revision>
+		<revnumber>Version 2.8</revnumber> 
+		<date>September 2004</date> 
+		<revdescription> 
+                    <para role="author">Angela Boyle</para>
+                    <para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+	    </revision>
+	    <revision>
+		<revnumber>&applet; Applet Manual V2.3</revnumber> 
+		<date>February 2004</date> 
+		<revdescription> 
+                    <para role="author">Sun MATE Documentation Team</para>
+                    <para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+	    </revision>
+	    <revision> 
+		<revnumber>&applet; Applet Manual V2.2</revnumber> 
+		<date>November 2003</date> 
+		<revdescription>
+                    <para role="author">Sun MATE Documentation Team</para>
+                    <para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+	    </revision>
+	    <revision> 
+		<revnumber>&applet; Applet Manual V2.1</revnumber> 
+		<date>August 2003</date> 
+		<revdescription> 
+                    <para role="author">Sun MATE Documentation Team</para>
+                    <para role="publisher">MATE Documentation Project</para>
+		</revdescription> 
+	    </revision>
+	    <revision> 
+		<revnumber>&applet; Applet Manual V2.0</revnumber> 
+		<date>May 2003</date> 
+		<revdescription> 
+		    <para role="author">Loban A Rahman
+			<email>[email protected]</email></para> 
+		    <para role="publisher"></para> 
+		</revdescription> 
+	    </revision>
+	</revhistory> 
+	
+	<releaseinfo>This manual describes version &appletversion; of &applet;.</releaseinfo> 
+	
+	<legalnotice> 
+	    <title>Feedback</title> 
+	    <para>To report a bug or make a suggestion regarding the
+	    <application>&applet;</application> application or this manual, follow the directions in the <ulink url="help:mate-feedback" type="help">MATE Feedback Page</ulink>. </para>
+	</legalnotice> 
+    </articleinfo> 
+    
+    <indexterm> 
+	<primary>Sticky Notes</primary> 
+    </indexterm> 
+
+<sect1 id="stickynotes-introduction">
+  <title>Introduction</title>
+  <figure id="stickynotes-fig">
+    <title>&applet;</title>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/stickynotes_applet.png" format="PNG"/>
+        </imageobject>
+        <textobject><phrase>Shows Sticky Notes</phrase></textobject>
+      </mediaobject>
+    </screenshot>
+  </figure>
+
+  <para>The <application>&applet;</application> panel application enables you
+  to create,
+  view, and manage sticky notes on your desktop. You can edit the title,
+  contents, dimensions, and style of sticky notes. When the panel is
+  restarted, for example when you log out and log in again, all sticky
+  notes are saved and reopened in the same position with the same
+  dimensions and style.</para>
+
+  <para>To add <application>&applet;</application> to a panel,
+  right-click on the panel, then choose <guimenuitem>Add to
+  Panel</guimenuitem>.  Select <application>&applet;</application>
+  in the <application>Add to the panel</application> dialog, then
+  click <guibutton>OK</guibutton>.</para>
+</sect1>
+    
+<sect1 id="stickynotes-usage"> 
+  <title>Using Sticky Notes</title>
+
+  <sect2 id="stickynotes-show-hide">
+   <title>Showing and Hiding Sticky Notes</title>
+   <para>
+    To hide all your notes, either click on the desktop, or right-click the <application>&applet;</application> applet and choose <guimenuitem>Hide Notes</guimenuitem>.</para>
+    <para>To show all your notes, click the <application>&applet;</application> applet.</para>
+  </sect2>
+
+  <sect2 id="stickynotes-create-note">
+    <title>Creating a Sticky Note</title>
+  <figure id="stickynotes-using-right-new-fig">
+    <title>creating a new sticky note</title>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/stickynote-right-menu-new.png" format="PNG"/>
+        </imageobject>
+        <textobject><phrase>creating a new sticky note</phrase></textobject>
+      </mediaobject>
+    </screenshot>
+   </figure>
+    <para>You can create a sticky note by right-clicking on the sticky note icon and
+    selecting <guilabel>New Note</guilabel>, or by double-clicking the applet.</para>
+    <para>Creating a note causes all hidden notes to be shown.</para>
+  </sect2>
+
+  <sect2 id="stickynotes-lock-notes">
+    <title>Locking and Unlocking Sticky Notes</title>
+    <para>You can lock or unlock all sticky notes at the same time, or you can
+    lock or unlock individual sticky notes.  Locking a sticky note prevents you
+    from accidentally changing the contents of the note.</para>
+    <variablelist>
+      <varlistentry>
+        <term><phrase>To Lock or Unlock All Sticky Notes</phrase></term>
+        <listitem>
+  <figure id="stickynotes-using-right-lock-fig">
+    <title>Right Clicking on the Icon</title>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/stickynote-right-menu-lock.png" format="PNG"/>
+        </imageobject>
+        <textobject><phrase>Right Clicking on the Icon</phrase></textobject>
+      </mediaobject>
+    </screenshot>
+  </figure>
+          <para>To lock all sticky notes so that the notes cannot be edited,
+          choose <guimenuitem>Lock Notes</guimenuitem> from the icon
+          right-click menu so that there is a check mark next to it.  To
+          unlock all sticky notes, choose <guimenuitem>Lock Notes</guimenuitem>
+          from the icon right-click menu again so that there is not a check
+          mark next to it.</para>
+          <para>Note that all panel applications have the
+	  <guimenuitem>Lock to Panel</guimenuitem>
+          item in the right-click menu, which locks the position of the panel
+	  application
+          on the panel.  Do not confuse this with the
+          <guimenuitem>Lock Notes</guimenuitem> item.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><phrase>To Lock or Unlock Individual Sticky Notes</phrase></term>
+        <listitem><para>To lock an individual sticky note, right-click on the
+        title of the note, then choose <guimenuitem>Lock Note</guimenuitem>
+        from the popup menu.  To unlock an individual note, right-click on the
+        title of the note, then choose <guimenuitem>Lock Note</guimenuitem>
+        from the popup menu again. You can also toggle the lock/unlock state of
+	a sticky note by clicking the lock button in the top left corner of the
+	sticky note.
+	</para></listitem>
+      </varlistentry>
+    </variablelist>
+  </sect2>
+
+  <sect2 id="stickynotes-delete-notes">
+    <title>Deleting Sticky Notes</title>
+    <para>You can delete all sticky notes at the same time, or you can delete
+    individual sticky notes.</para>
+    <variablelist>
+      <varlistentry>
+        <term>To Delete All Sticky Notes</term>
+        <listitem><para>To delete all sticky notes, choose <guimenuitem>Delete
+        Notes</guimenuitem> from the icon right-click menu.  A confirmation
+        dialog will appear; click on the <guibutton>Delete All</guibutton>
+        button to confirm the deletion.</para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>To Delete Individual Sticky Notes</term>
+        <listitem><para>To delete an individual sticky note, right-click on the
+        title of the note, then choose <guimenuitem>Delete Note</guimenuitem>
+        from the popup menu. You can also delete a sticky note by clicking the
+	<guibutton>x</guibutton> in the top right corner.
+	</para></listitem>
+      </varlistentry>
+    </variablelist>
+  </sect2>
+
+</sect1>
+
+<sect1 id="stickynotes-advanced-settings"> 
+  <title>Preferences</title>
+  
+  <figure id="stickynotes-prefs-fig">
+    <title>&applet; Preferences</title>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/stickynotes-prefs.png" format="PNG"/>
+        </imageobject>
+        <textobject><phrase>Shows Sticky Notes preferences</phrase></textobject>
+      </mediaobject>
+    </screenshot>
+  </figure>
+
+  <sect2 id="stickynotes-size">
+    <title>Adjusting Size</title> 
+    <para>To configure the default size for all sticky notes, right-click on the
+    sticky notes icon, then choose <guimenu>Preferences</guimenu> from the popup menu. The
+    <application>Sticky Notes Preferences</application> dialog is displayed.</para>
+    <variablelist> 
+      <varlistentry> 
+        <term><guilabel>Width</guilabel></term> 
+        <listitem><para>Use this spin box to specify the default width of new
+        sticky notes, in pixels.</para></listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Height</guilabel></term> 
+        <listitem><para>Use this spin box to specify the default height of new
+        sticky notes, in pixels.</para></listitem>
+      </varlistentry>
+    </variablelist>
+  </sect2>
+
+  <sect2 id="stickynotes-color">
+    <title>Changing Color and Font</title>
+    <para>To configure the color and font for all sticky notes, right-click on
+    the icon, then choose <guimenu>Preferences</guimenu> from the popup menu.
+    The <application>Sticky Notes Preferences</application> dialog is
+    displayed.</para>
+    <variablelist>
+      <varlistentry>
+        <term><guilabel>Font Color</guilabel></term>
+	<listitem>
+	 <para>
+	  Click on the color selector button to display the color selector
+	  dialog. On the color selector dialog, use the color wheel or spin
+	  boxes to choose the default font color for stickynotes.
+	 </para>
+	 <para>
+	  If you have selected, <guilabel>Use color from the system
+	  theme</guilabel>, then the current theme colors will be used and you
+	  will not be able to select new defaults.
+	 </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Note Color</guilabel></term> 
+        <listitem>
+          <para>Click on the color selector button to display the color
+          selector dialog. On the color selector dialog, use the color wheel or
+          spin boxes to choose the default base color for sticky notes.</para>
+          <para>If you have selected, <guilabel>Use color from the system
+	  theme</guilabel>, then the current theme colors will be used and you
+	  will not able to select new defaults.
+	  </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Font</guilabel></term> 
+        <listitem>
+          <para>Click on the font selector button to display the font selector
+          dialog. On the font selector dialog, use the list boxes to choose the
+          default font for sticky notes.</para>
+	  <para>
+	   If you have selected, <guilabel>Use font from the system
+	   theme</guilabel>, then the current Application Font set in <!--
+	   FIXME: can I cross reference preferences? -->Font Preferences will be
+	   used and you will not be able to select new defaults.
+	  </para>
+        </listitem>
+      </varlistentry>
+    </variablelist> 
+  </sect2>
+  <sect2 id="stickynotes-behavior">
+    <title>Customizing Behavior</title>
+    <para>To customize the behavior of <application>&applet;</application>,
+    right-click on the icon, then choose <guimenu>Preferences</guimenu>
+    from the popup menu.  The <application>Sticky Notes Preferences</application>
+    dialog is displayed.</para>
+    <para>To specify that sticky notes are visible on all workspaces on the
+    desktop, select <guilabel>Put notes on all workspaces</guilabel> in the
+    <guilabel>Sticky Notes Preferences</guilabel> dialog.  If you are using
+    multiple workspaces, this will cause all sticky notes to be visible on
+    all workspaces.</para>
+
+    <para>
+     The option, <guilabel>Force default color and font on notes</guilabel>,
+     will force all sticky notes on your desktop to use the color and font
+     settings specified in the <guilabel>Default Note Properties</guilabel>
+     above (see <xref linkend="stickynotes-color"/>).
+    </para>
+  </sect2>
+
+  </sect1>
+
+  <sect1 id="stickynotes-settings-individual"> 
+    <title>Customizing Individual Notes</title>
+  <figure id="stickynotes-note-prefs-fig">
+    <title>Sticky Note Preferences</title>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="figures/stickynotes-note-prefs.png" format="PNG"/>
+        </imageobject>
+        <textobject><phrase>a Sticky Note's preferences</phrase></textobject>
+      </mediaobject>
+    </screenshot>
+  </figure>
+    <para>You can customize the look of each individual sticky note.  This
+    can be useful for visually distinguishing different types of notes
+    quickly.  To configure the settings for an individual sticky note,
+    right-click on the note's title, then choose <guimenu>Properties</guimenu>
+    from the popup menu.  The <application>Sticky Note Properties</application>
+    dialog is displayed.</para>
+    <variablelist> 
+      <varlistentry> 
+        <term><guilabel>Title</guilabel></term> 
+        <listitem><para>Use this text box to specify the title of the sticky
+        note.</para></listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Use default color</guilabel></term> 
+        <listitem><para>Select this option to use the default base color for
+        this sticky note.  For information on setting the default base color,
+        see <xref linkend="stickynotes-color"/>.</para></listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><guilabel>Font Color</guilabel></term>
+       <listitem>
+        <para>Click on the color selector button to display the color selector
+	dialog. On the color selector dialog, use the color wheel or spin boxes
+	to choose the font color for this sticky note.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Note Color</guilabel></term> 
+        <listitem><para>Click on the color selector button to display the
+        color selector dialog. On the color selector dialog, use the color
+        wheel or spin boxes to choose the base color for this sticky
+        note.</para></listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Use default font</guilabel></term> 
+        <listitem><para>Select this option to use the default font for this
+        sticky note.  For information on setting the default font, see
+        <xref linkend="stickynotes-color"/>.</para></listitem>
+      </varlistentry>
+      <varlistentry> 
+        <term><guilabel>Font</guilabel></term> 
+        <listitem><para>Click on the font selector button to display the font
+        selector dialog.  On the font selector dialog, use the list boxes to
+        choose the font for this sticky note.</para></listitem>
+      </varlistentry>
+    </variablelist> 
+</sect1>
+</article>