<?xml version="1.0"?>
<!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.4.2">
  <!ENTITY manrevision "2.2">
  <!ENTITY date "November 2003">
  <!ENTITY applet "Sticky Notes">
]>

<!-- (Do not remove this comment block.)
Maintained by the GNOME Documentation Project
http://developer.gnome.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; Applet Manual V&manrevision;</title> 
	
	<copyright> 
	    <year>2003</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> 
	    <publishername>GNOME Documentation Project</publishername> 
	</publisher> 
	
	&legal;

	<authorgroup> 
            <author>
               <firstname>Sun</firstname>
               <surname>GNOME Documentation Team</surname>
               <affiliation>
                  <orgname>Sun Microsystems</orgname>
              </affiliation>
            </author>
	    <author> 
		<firstname>Loban</firstname> 
		<surname>Rahman</surname> 
		<affiliation> 
		    <!-- <orgname></orgname> --> 
		    <address> <email>loban@earthling.net</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>translator@gnome.org</email> </address> 
		</affiliation>
		<contrib>Latin translation</contrib>
	    </othercredit>
	    -->
	</authorgroup>

	<revhistory>
	    <revision> 
		<revnumber>&applet; Applet Manual V&manrevision;</revnumber> 
		<date>&date;</date> 
		<revdescription> 
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">GNOME Documentation Project</para>
		</revdescription> 
	    </revision>
	    <revision> 
		<revnumber>&applet; Applet Manual V2.1</revnumber> 
		<date>August 2003</date> 
		<revdescription> 
                    <para role="author">Sun GNOME Documentation Team</para>
                    <para role="publisher">GNOME 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>loban@earthling.net</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> applet or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>. </para>
	</legalnotice> 
    </articleinfo> 
    
    <indexterm> 
	<primary>Sticky Notes</primary> 
    </indexterm> 

    <!-- ============= Document Body ============================= -->
    
    <!-- ============= Introduction ============================== -->
    <sect1 id="stickynotes-introduction">
	<title>Introduction</title>
	<figure id="stickynotes-fig"> 
	    <title>&applet; Applet</title> 
	    <screenshot> 
		<mediaobject> 
		    <imageobject><imagedata fileref="figures/stickynotes_applet.png" format="PNG"/></imageobject>
		    <textobject><phrase>Shows Sticky Notes applet.</phrase></textobject> 
		</mediaobject> 
	    </screenshot> 
	</figure> 
	<para>The <application>&applet;</application> applet enables you to create, view, and manage sticky notes on the GNOME Desktop. You can edit the title, contents, dimensions, and style of sticky notes. When the applet 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 
	    <menuchoice>
		<guimenu>Add to Panel</guimenu>
		<guisubmenu>Accessories</guisubmenu>
		<guimenuitem>Sticky Notes</guimenuitem>
	    </menuchoice>.
	</para>
    </sect1>
    
    <!-- ============= Basic Usage ============================ -->
    <sect1 id="stickynotes-usage"> 
	<title>Usage</title>
    <sect2 id="stickynotes-create-note">
        <title>To Create a Sticky Note</title>
	    <para>You can create a sticky note in the following ways:</para>
             <itemizedlist>
               <listitem><para>Choose <guimenuitem>New Note</guimenuitem> from the applet menu. </para></listitem>
               <listitem><para>Right-click on the title of an existing note, then choose <guimenuitem>New Note</guimenuitem> from the popup menu. </para></listitem>
             </itemizedlist>
    </sect2>
    <sect2 id="stickynotes-show-notes">
        <title>To Show or Hide Sticky Notes</title>
	    <para>To hide all sticky notes, choose <guimenuitem>Show Notes</guimenuitem> from the applet menu.</para>
	    <para>To show all sticky notes, choose <guimenuitem>Show Notes</guimenuitem> from the applet menu again.</para>
    </sect2>
    <sect2 id="stickynotes-lock-notes">
        <title>To Lock or Unlock 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.</para>
    <sect3 id="stickynotes-lock-notes-all">
        <title>To Lock or Unlock All Sticky Notes</title>
	    <para>To lock all sticky notes so that the notes cannot be edited, choose <guimenuitem>Lock Notes</guimenuitem> from the applet menu. </para>
            <para>To unlock all sticky notes, choose <guimenuitem>Lock Notes</guimenuitem> from the applet menu again.</para>
    </sect3>
    <sect3 id="stickynotes-lock-notes-individual">
        <title>To Lock or Unlock Individual Sticky Notes</title>
	    <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. </para>
            <para>To unlock an individual note, right-click on the title of the note, then choose <guimenuitem>Lock Note</guimenuitem> from the popup menu again.</para>
    </sect3>
    </sect2>
    <sect2 id="stickynotes-delete-notes">
        <title>To Delete Sticky Notes</title>
            <para>You can delete all sticky notes at the same time, or you can delete individual sticky notes.</para>
    <sect3 id="stickynotes-delete-notes-all">
        <title>To Delete All Sticky Notes</title>
	    <para>To delete all sticky notes, perform the following steps:</para>
              <orderedlist>
                <listitem><para>Choose <guimenuitem>Delete Notes</guimenuitem> from the applet menu.</para></listitem>
                <listitem><para>Click on the <guibutton>Delete ALL</guibutton> button to confirm the deletion.</para></listitem>
              </orderedlist>
    </sect3>
    <sect3 id="stickynotes-delete-notes-individual">
        <title>To Delete Individual Sticky Notes</title>
	    <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.</para>
    </sect3>
    </sect2>
    </sect1>

    <!-- ============= Advanced Settings ============================ -->
    <sect1 id="stickynotes-advanced-settings"> 
	<title>Preferences</title>
    <sect2 id="stickynotes-settings-all"> 
	<title>General Preferences</title>
	<para>To configure the settings for all sticky notes, right-click on the applet, then choose <guimenu>Preferences</guimenu> from the applet menu.</para>
	<variablelist> 
	    <varlistentry> 
		<term>Width</term> 
		<listitem><para>Use this spin box to specify the default width of new sticky notes, in pixels.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Height</term> 
		<listitem><para>Use this spin box to specify the default height of new sticky notes, in pixels.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Color</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 of uncustomized sticky notes.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Use color from the system theme</term> 
		<listitem><para>Select this option to use the current system theme to determine the default base color of uncustomized sticky notes.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Font</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 of uncustomized sticky notes.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Use font from the system theme</term> 
		<listitem><para>Select this option to use the current system theme to determine the default font of uncustomized sticky notes.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Click</term> 
		<listitem><para>Select one of the following options to specify what happens when you click on the applet:</para>
                  <itemizedlist>
                    <listitem><para>create a new note</para></listitem>
                    <listitem><para>show/hide all notes</para></listitem>
                    <listitem><para>lock/unlock all notes</para></listitem>
                  </itemizedlist>
               </listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Put notes on all workspaces</term> 
		<listitem><para>Select this option to specify that sticky notes are visible on all workspaces on the desktop.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Force default color and font on notes</term> 
		<listitem><para>Select this option to specify that all sticky notes, including customized notes, must use the default style.</para></listitem>
	    </varlistentry>
	</variablelist> 
    </sect2>
    <sect2 id="stickynotes-settings-individual"> 
	<title>Individual Preferences</title>
	<para>To configure the settings for an individual sticky note, right-click on the note, then choose <guimenu>Properties</guimenu> from the popup menu.</para>
	<variablelist> 
	    <varlistentry> 
		<term>Title</term> 
		<listitem><para>Use this text box to specify the title of the sticky note.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Color</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 of this sticky note.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Use default color</term> 
		<listitem><para>Select this option to use the default base color of this sticky note.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Font</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 of this sticky note.</para></listitem>
	    </varlistentry>
	    <varlistentry> 
		<term>Use default font</term> 
		<listitem><para>Select this option to use the default font of this sticky note.</para></listitem>
	    </varlistentry>
	</variablelist> 
    </sect2>
    </sect1>
</article> 
