<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&knotes;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>The &knotes; Handbook</title>

<authorgroup>
<author>
<firstname>Fabian</firstname>
<surname>Dal Santo</surname>
<affiliation>
<address><email>linuxgnu@yahoo.com.au</email></address>
</affiliation>
</author>

<author>
<firstname>Greg</firstname>
<othername>M.</othername>
<surname>Holmes</surname>
</author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<contrib>Reviewer</contrib>
</othercredit>
<!-- TRANS:ROLES_OF_TRANSLATORS -->

</authorgroup>

<copyright>
<year>2000</year>
<holder>Greg M. Holmes</holder>
</copyright>
<copyright>
<year>2001</year>
<holder>Fabian Del Santo</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2002-02-05</date>
<releaseinfo>2.20.00</releaseinfo>

<abstract><para>&knotes; is a sticky notes application for the
desktop.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Knotes</keyword>
<keyword>kdeutils</keyword>
<keyword>notes</keyword>
<keyword>popup</keyword>
<keyword>pop-up</keyword>
<keyword>knotes</keyword>

</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&knotes; is a program that lets you write the computer
equivalent of sticky notes.  The notes are saved automatically when
you exit the program, and they display when you open the
program. </para>

<para>You may print and mail your notes if you configure &knotes; to
use helper applications. </para>

<para>Display features of notes such as color and font may be
customized for each note.  You may also customize the
defaults. </para>

</chapter>

<chapter id="configuration">
<title>Configuration</title>

<sect1 id="configuring-display">
<title>Configuring the Display in &knotes;</title>

<para>To configure the display:</para>

<procedure>
<step><para><mousebutton>Right</mousebutton> click on the panel icon.</para></step>
<step><para>Select <guimenuitem>Preferences...</guimenuitem></para>
<para>The &knotes; <guilabel>&knotes; Defaults</guilabel> dialog will
open.</para> </step>
<step><para>Choose the <guiicon>Display</guiicon> icon from the three icons at
the left.</para></step>
</procedure>

<para>The following choices are available:</para>

<variablelist>
<varlistentry>
<term><guilabel>Text Color</guilabel></term>
<listitem><para>The color square shows the current text color.  By clicking this
color square you open the standard &kde; color selection
dialog.</para></listitem> 
</varlistentry>
<varlistentry>
<term><guilabel>Background Color</guilabel></term>
<listitem><para>The color square shows the current background color.  By
clicking this color square you open the standard &kde; color selection
dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Default Width</guilabel></term>
<listitem><para>The width of the note in pixels.  Edit this number as
desired.</para></listitem> 
</varlistentry>

<varlistentry>
<term><guilabel>Default Height</guilabel></term>
<listitem><para>The height of the note in pixels.  Edit this number as
desired.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="configuring-editor">
<title>Configuring the Editor in &knotes;</title>
<para>To customize the editor:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the panel
icon.</para></step>
<step><para>Select <guimenuitem>Preferences...</guimenuitem></para>
<para>The &knotes; <guilabel>&knotes; Defaults</guilabel> dialog will
open.</para></step> 
<step><para>Choose the <guiicon>Editor</guiicon> icon from the three
icons at the left.</para></step>
</procedure>

<para>The following choices are available:</para>

<variablelist>
<varlistentry>
<term><guilabel>Tab Size</guilabel></term>
<listitem><para>This is the size of the tab in spaces.  Edit this number as
desired.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Auto Indent</guilabel></term>
<listitem><para>This is a check box.  If selected, auto-indenting is
on.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Edit Rich Text</guilabel></term>
<listitem>
<para>Not yet implemented</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Title Font: Click to Change</guilabel></term>
<listitem><para>You can change the font used for the title of your
notes.</para>

<para>Click this button to open the standard &kde; font selection
dialog.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Text Font: Click to Change</guilabel></term>
<listitem>
<para>You can change the font used for the text of your notes.</para>

<para>Click this button to open the standard &kde; font selection
dialog.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="configuring-actions">
<title>Configuring Actions in &knotes;</title>

<para>To configure actions in &knotes;:</para>
<procedure><step><para>Right-click on the &knotes; panel
icon.</para></step><step>
<para>Select <guimenuitem>Preferences...</guimenuitem></para>
<para>The &knotes; <guilabel>Defaults - KNotes</guilabel> dialog will
open.</para></step>
<step><para>Choose the <guiicon>Actions</guiicon> icon from the three icons at the
left.</para></step>
</procedure>

<para>The following choices are available:</para>

<variablelist>
<varlistentry>
<term><guilabel>Mail Action</guilabel></term>
<listitem><para>Type a mail command and any required command line switches in
this box.</para>
<para>By using <token>%f</token> in the command line you can pass
the filename of the note body to the mail command.</para>
</listitem>
</varlistentry>

<!-- 
<varlistentry>
<term><guilabel>Print</guilabel></term>
<listitem><para>Type a printing command and any required command line switches
in this box.</para>
<para>Use the following variables in the command line:</para>
<para><token>%p</token> is the printer name.</para>
<para><token>%t</token> is the title.</para>
<para><token>%f</token> is the filename of the note body.</para>
</listitem>
</varlistentry> -->

</variablelist>

</sect1>

</chapter>

<chapter id="using-knotes">
<title>Using &knotes;</title>

<sect1 id="create-new-note">
<title>Creating a New Note</title>

<para>To create a new note:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the &knotes; panel
icon.</para></step>
<step><para>Select <guimenuitem>New Note</guimenuitem>.</para></step>
</procedure>

</sect1>

<sect1 id="typing-the-note">
<title>Writing Your Note</title>

<para>To write your note, simply type the note in the space provided.  Normal
keyboard and mouse editing functions are supported.</para> 

<para><mousebutton>Right</mousebutton> clicking in the editing space provides the
following menu options:</para>

<itemizedlist>
<listitem><para><guimenuitem>Undo</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Redo</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Cut</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Copy</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Paste</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Clear</guimenuitem></para></listitem>
<listitem><para><guimenuitem>Select All</guimenuitem></para></listitem>
</itemizedlist>

<para>Text may be selected by holding down the <mousebutton>left</mousebutton>
mouse button and moving the mouse, or by holding down the &Shift;
key and using the <keycap>arrow</keycap> keys.</para>

</sect1>

<sect1 id="inserting-the-date">
<title>Inserting the Date</title>

<para>To insert the current date in the Note:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the title bar of the note.</para></step> 
<step><para>Select <guimenuitem>Insert Date</guimenuitem>.</para></step>
</procedure>

<para>The current date and time will be inserted at the cursor position in the
text of the note.</para>

</sect1>

<sect1 id="renaming-a-note">
<title>Renaming a Note</title>

<para>To rename a note:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the note title
bar.</para></step>
<step><para>Select <guimenuitem>Rename</guimenuitem>.</para></step>
</procedure>

<para>Type the new name of the note in the dialog that appears.  To accept the
new name, press the <guibutton>OK</guibutton> button.  To exit the dialog
without renaming the note, press the <guibutton>Cancel</guibutton> button.  To
clear what you have typed and start over, click the <guibutton>Clear</guibutton>
button.</para>

</sect1>
<sect1 id="mailing-a-note">
<title>Mailing a Note</title>

<para>To mail a note:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the note title
bar.</para></step>
<step><para>Select <guimenuitem>Mail</guimenuitem>.</para></step>
</procedure>

<para>What happens next depends on how you configured the Mail action in the
<guilabel>Preferences...</guilabel> dialog.</para>

</sect1>

<sect1 id="printing-a-note">
<title>Printing a Note</title>

<para>To print a note:</para>

<procedure>
<step><para><mousebutton>Right</mousebutton> click on the note title
bar.</para></step>
<step><para>Select <guimenuitem>Print</guimenuitem>.</para></step>
</procedure>
<!-- 
<para>What happens next depends on how you configured the Print action in the
<guilabel>Preferences...</guilabel> dialog.</para> -->

<para>A standard &kde; print dialog will open.</para>

</sect1>


<sect1 id="deleting-a-note">
<title>Deleting a Note</title>
<para>To delete a note:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the note title
bar.</para></step>
<step><para>Select <guimenuitem>Delete</guimenuitem>.</para></step>
</procedure>
</sect1>

<sect1 id="hiding-a-note">
<title>Hiding a Note</title>

<para>To hide a note, click the <guiicon>X</guiicon> in the upper right corner
of the title bar of the note.  The note will no longer be displayed on the
screen.  The note itself will not be deleted.</para>

</sect1>

<sect1 id="displaying-notes">
<title>Displaying Notes</title>

<para>When you start &knotes;, all notes will display on the screen.  If you
hide a note and later want to display it:</para>

<procedure>
<step><para><mousebutton>Right</mousebutton> click on the &knotes; panel icon.</para></step>
<step><para>Select <guimenuitem>Notes</guimenuitem>.</para></step>
<step><para>Choose the note you want to display.</para></step>
</procedure>

</sect1>

<sect1 id="desktop-functions">
<title>Desktop Functions</title>

<para>To send a note to a specific desktop:</para>

<procedure>
<step><para><mousebutton>Right</mousebutton> click on the title bar of the
note.</para></step>
<step><para>Select <guimenuitem>To Desktop</guimenuitem></para></step>
<step><para>Choose the desktop desired, or alternatively,
<guimenuitem>All desktops</guimenuitem></para></step> </procedure>

<para>To make the note remain on top of other windows:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the title bar of the
note.</para></step>
<step><para>Select <guimenuitem>Always On Top</guimenuitem>.</para></step>
</procedure>

<para>To return the note to more normal window behavior, simply repeat this
process.</para> 

</sect1>

<sect1 id="customizing-display">
<title>Customizing a Note Display</title>

<para>You can customize each note independently of the global
settings.  The settings you can customize are identical to those
described in the <link linkend="configuration">Configuration</link>
section, but they will apply only to the note you are changing.  Any
other open notes, and any new notes you create, will use the default
settings.</para>

<para>To customize a note display:</para>

<procedure>
<step><para><guimenuitem>Right</guimenuitem> click on the note
title bar.</para></step>
<step><para>Select <guimenuitem>Note Preferences...</guimenuitem>.</para>
<para>The <guilabel>Local Settings</guilabel> dialog will
open.</para></step>
<step><para>Choose the <guiicon>Display</guiicon> icon from the three icons at
the left.</para></step>
</procedure>

</sect1>

<sect1 id="quit-knotes">
<title>Quitting &knotes;</title>
<para>To quit &knotes;:</para>
<procedure>
<step><para><mousebutton>Right</mousebutton> click on the panel
icon.</para></step>
<step><para>Select <guimenuitem>Quit</guimenuitem>.</para></step>
</procedure>
</sect1>

</chapter>

<chapter id="credits">

<title>Credits and License</title>

<para>&knotes;</para>

<para>Program copyright 1997 Bernd Wuebben <email>wuebben@kde.org</email></para>

<para>Contributors:</para>
<itemizedlist>
<listitem><para>Wynn Wilkes<email>wynnw@calderasystems.com</email></para>
</listitem>
</itemizedlist>

<para>Documentation copyright 2000 Greg M. Holmes
<email>holmegm@earthlink.net</email></para>

<para>Documentation updated 2001 by Fabian Del Santo
<email>linuxgnu@yahoo.com.au</email>.</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-knotes">
<title>How to obtain &knotes;</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title>Requirements</title>

<para>In order to print or mail notes, you need to have helper
applications installed, such as <command>a2ps</command> and &kmail;.
You will need to configure &knotes; to use these helper applications.
</para>

</sect1>

<sect1 id="compilation">
<title>Compilation and Installation</title>

&install.compile.documentation;

</sect1>
</appendix>

&documentation.index; 

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
