<?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 date "February 2007">
<!ENTITY app "<application>Tomboy Notes</application>">
<!ENTITY appname "Tomboy">
<!ENTITY extappname "Tomboy Notes">
<!ENTITY manversion "2.0">
<!ENTITY version "0.10.0">
]>
<!-- 
  (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://live.gnome.org/DocumentationProject
  Template version: 3.0 beta
  Template last modified August 7th, 2006
-->
<!-- =============Document Header ============================= -->
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<article id="index" lang="en_GB">
  <articleinfo>
    <title>Tomboy Notes Manual</title>

    <abstract role="description">
      <para>Tomboy is a simple desktop note-taking application, with many features designed
to help organize ideas, such as spell checking, highlighting, auto-linking
URLs, lists, font stylizing, quick access with a table of contents for notes,
and add-ins to extend Tomboy's capabilities.
.</para>
    </abstract>

    <copyright>
      <year>2009</year>

      <holder>Alex Graveley</holder>
    </copyright>

    <copyright>
      <year>2009</year>

      <holder>Brent Smith</holder>
    </copyright>

    <copyright>
      <year>2009</year>

      <holder>Free Software Foundation</holder>
    </copyright>
    
    <copyright>
      <year>2009</year>
      
      <holder>Boyd Timothy</holder>
    </copyright>
    
    <copyright>
      <year>2009</year>
      
      <holder>Sandy Armstrong</holder>
    </copyright>
    
    <copyright>
      <year>2009</year>
      
      <holder>Paul Cutler</holder>
    </copyright><copyright><year>2007</year><holder>David Lodge (dave@cirt.net)</holder></copyright><copyright><year>2009</year><holder>Philip Withnall (philip@tecnocode.co.uk)</holder></copyright>

    <!-- translators: uncomment this:
    <copyright>
      <year>2002</year>
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
-->

    <publisher>
      <publishername>GNOME Documentation Project</publishername>
    </publisher>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <!-- This file  contains link to license for the documentation (GNU FDL), and 
         other legal stuff such as "NO WARRANTY" statement. Please do not change 
	 any of this. -->

    <authorgroup>
      <author role="maintainer">
        <firstname>Alex</firstname>

        <surname>Graveley</surname>

        <affiliation>
          <orgname>GNOME Documentation Project</orgname>

          <address><email>alex@beatniksoftware.com</email></address>
        </affiliation>
      </author>

      <author>
        <firstname>Brent</firstname>

        <surname>Smith</surname>

        <affiliation>
          <orgname>GNOME Documentation Project</orgname>

          <address><email>gnome@nextreality.net</email></address>
        </affiliation>
      </author>
      
      <author role="maintainer">
        <firstname>Boyd</firstname>
        
        <surname>Timothy</surname>
        
        <affiliation>
          <orgname>GNOME Documentation Project</orgname>

          <address><email>btimothy@gmail.com</email></address>
        </affiliation>
      </author>
      
      <author role="maintainer">
        <firstname>Sandy</firstname>
        
        <surname>Armstrong</surname>
        
        <affiliation>
          <orgname>GNOME Documentation Project</orgname>

          <address><email>sanfordarmstrong@gmail.com</email></address>
        </affiliation>
      </author>

      <author>
        <firstname>Paul</firstname>

        <surname>Cutler</surname>

        <affiliation>
          <orgname>GNOME Documentation Project</orgname>

          <address><email>pcutler@foresightlinux.org</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>
	
	  <releaseinfo revision="2.28" role="candidate">
		<ulink type="finalreview" url="http://bugzilla.gnome.org/show_bug.cgi?id=576487"/>
	</releaseinfo>
	
    <!-- According to GNU FDL, revision history is mandatory if you are -->

    <!-- modifying/reusing someone else's document.  If not, you can omit it. -->

    <revhistory>
      <!-- Remember to remove the &manrevision; entity from the revision entries other
   than the current revision. -->

      <revision>
        <revnumber>Tomboy Manual 2.1</revnumber>

        <date>2009-03-23</date>

        <revdescription>
          <para role="author">Paul Cutler</para>

          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>

      <revision>
        <revnumber>Tomboy Manual 4.0</revnumber>

        <date>2008-03-07</date>

        <revdescription>
          <para role="author">Paul Cutler</para>

          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>

      <revision>
        <revnumber>Tomboy Manual 3.0</revnumber>

        <date>2007-09-13</date>

        <revdescription>
          <para role="author">Sandy Armstrong</para>

          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>

      <revision>
        <revnumber>Tomboy Manual 2.0</revnumber>

        <date>2007-02-28</date>

        <revdescription>
          <para role="author">Boyd Timothy</para>

          <para role="publisher">GNOME Documentation Project</para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>This manual describes version 0.14.0 of Tomboy</releaseinfo>

    <legalnotice>
      <title>Feedback</title>

      <para>To report a bug or make a suggestion regarding the Tomboy application or this manual, follow the directions in the <ulink type="help" url="ghelp:gnome-feedback">GNOME Feedback Page</ulink>.</para>

      <!-- Translators may also add here feedback address for translations -->
    </legalnotice>
  </articleinfo>

  <indexterm zone="index">
    <primary>Tomboy Notes</primary>
  </indexterm>

  <indexterm zone="index">
    <primary>Tomboy</primary>
  </indexterm>

  <indexterm zone="index">
    <primary>notes</primary>
  </indexterm>

  <!-- ============= Introduction ============================== -->

  <sect1 id="tomboy-intro">
    <title>Introduction</title>

    <figure id="tomboy-panel">
      <title>Notes Application</title>

      <mediaobject>
        <imageobject>
          <imagedata fileref="figures/tomboy-panel.png"/>
        </imageobject>
      </mediaobject>
    </figure>

    <para>Tomboy is a desktop note-taking application for GNOME, Microsoft Windows, and Mac OS X. It is simple
    and easy to use, and allows you to organize the ideas and information you
    deal with every day. Tomboy has some very useful editing features to help
    you customize your notes, including:</para>

    <itemizedlist>
      <listitem>
        <para>Highlighting Search Text</para>
      </listitem>

      <listitem>
        <para>Inline Spell Checking</para>
      </listitem>

      <listitem>
        <para>Auto-linking Web &amp; Email Addresses</para>
      </listitem>

      <listitem>
        <para>Undo/Redo Support</para>
      </listitem>

      <listitem>
        <para>Font Styling &amp; Sizing</para>
      </listitem>

      <listitem>
        <para>Bulleted Lists</para>
      </listitem>
    </itemizedlist>

    <para>Tomboy is accessed through the GNOME panel, the taskbar in Microsoft Windows, or the dock in Mac OS X. To startup Tomboy
    automatically when you log into GNOME, see <xref linkend="add-to-panel"/>.</para>
  </sect1>

  <!--=========== Getting Started ============================== -->

  <sect1 id="getting-started">
    <title>Getting Started</title>

    <sect2 id="add-to-panel">
      <title>Adding Tomboy to the GNOME Panel</title>

      <para>To add Tomboy to a panel in GNOME, right-click on the panel, then choose
      <menuchoice>
          <guimenuitem>Add to Panel</guimenuitem>
        </menuchoice>. Select Tomboy Notes in the Add to the panel dialog,
      then click <menuchoice>
          <guibutton>Add</guibutton>
        </menuchoice>. You should see a yellow note icon appear in the panel,
      representing Tomboy. The panel icon is illustrated in <xref linkend="tomboy-panel"/>.</para>
	  <para>Tomboy is automatically added to the taskbar when run on Microsoft Windows, or the dock when run on Mac OS X.</para>
    </sect2>

    <sect2 id="creating-notes">
      <title>Creating Notes</title>

      <para>Once you have successfully added Tomboy to the panel, you can
      create new notes using one of the following methods.</para>

      <para>To create a new note using the mouse:</para>

      <orderedlist>
        <listitem>
          <para>Click on the Tomboy note icon present in the GNOME Panel or Windows taskbar. A
          menu will appear.</para>
        </listitem>

        <listitem>
          <para>Select the <menuchoice><guimenuitem>Create New Note</guimenuitem></menuchoice> option in the menu.</para>
        </listitem>
      </orderedlist>

      <para>To create a new note using the keyboard:</para>

      <orderedlist>
        <listitem>
          <para>Open the Tomboy menu using the key combination <keycombo><keycap>Alt</keycap><keycap>F12</keycap></keycombo>.</para>
        </listitem>

        <listitem>
          <para>Use the <keycap>N</keycap> key to select the menu option <menuchoice><guimenuitem>Create New Note</guimenuitem></menuchoice>.</para>
        </listitem>
      </orderedlist>
    </sect2>

    <sect2 id="editing-notes">
      <title>Editing Notes</title>

      <para>After creating a new note, a new window will appear with the title <literal>New Note <replaceable>N</replaceable></literal>. At the top of the note is a toolbar with several buttons and text. Directly below this toolbar is the content area of the note. This is illustrated in <xref linkend="new-note"/>.</para>

      <para>The note can be edited by clicking in the content area and using the keyboard to add and remove content. The first line is considered the title of the note. By default this is populated with the text <quote><literal>New Note <replaceable>N</replaceable></literal></quote>. The title is changed by clicking in the content area on the first line and using the keyboard to change the title. By default, focus is given to the content area upon creation of a new note, so you can immediately start editing the note without the need to click on the content area with the mouse.</para>

      <para>Using the toolbar available on each note is discussed in <xref linkend="working-with-notes"/>.</para>

      <figure id="new-note">
        <title>The default window for a New Note</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-new-note.png"/>
          </imageobject>
        </mediaobject>
      </figure>
    </sect2>

    <sect2 id="search-all-notes">
      <title>Table of Contents</title>

      <para>To get an overview of all the notes managed by Tomboy, select the <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice> menu item from the panel menu. By default, the <interface>Search All Notes</interface> dialogue will display the notes in the order that they were last modified. Click the <guilabel>Note</guilabel> or <guilabel>Last Changed</guilabel> column headings to change the sort order. Click the column heading a second time to toggle between ascending and descending order.</para>
      
      <para>You can find specific notes by entering text into the search field in the <interface>Search All Notes</interface> dialogue. The list of notes will automatically update to list only the notes which have matching text.</para>
      
      <para>To open a note in the <interface>Search All Notes</interface> dialogue, do one of the following:</para>

      <orderedlist>
        <listitem>
          <para>Double-click on a note.</para>
        </listitem>
        
        <listitem>
          <para>Highlight a note by selecting it and then select <menuchoice><guimenuitem>Open</guimenuitem></menuchoice> from the <guimenuitem>File</guimenuitem> menu.</para>
        </listitem>
        
        <listitem>
          <para>Right-click on a note and select <menuchoice><guimenuitem>Open</guimenuitem></menuchoice> from the context menu that appears.</para>
        </listitem>
        
        <listitem>
          <para>Highlight a note by selecting it and then press the key combination <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>.</para>
        </listitem>
      </orderedlist>
    </sect2>
  </sect1>

  <!--=========== Working With Notes ============================== -->

  <sect1 id="working-with-notes">
    <title>Working With Notes</title>

    <para>Notes are modified and edited through the main window for each note. The toolbar at the top of each note allows you to apply a style to the note and perform other note-related functions. We discuss the functions of each item on the toolbar in the following sections.</para>

    <sect2 id="search">
      <title>Search</title>

      <para>Clicking the <guibutton>Search</guibutton> button will open the <interface>Search All Notes</interface> dialogue described earlier (<xref linkend="search-all-notes"/>.)</para>
    </sect2>

    <sect2 id="link">
      <title>Link</title>

      <para>The <guibutton>Link</guibutton> button allows you to create a link to a new note from within the current note. For example, if your note contains the phrase <quote>FinalExam</quote>, you can select this text with the mouse and click the <guibutton>Link</guibutton> button to create a new note with the title <quote>FinalExam</quote>. A link will also be created in the current note that can be clicked to open the new <quote>FinalExam</quote> note.</para>

      <note>
        <para>Changing the title of a note will update links present in other notes. This prevents broken links from occurring when a note is renamed.</para>
      </note>
    </sect2>

    <sect2 id="text">
      <title>Text</title>

      <para>Formatting text within your notes can be done using the <guibutton>Text</guibutton> button. The <guibutton>Text</guibutton> button will display a menu with several options from which you can choose. Each menu item is explained next.</para>

      <variablelist>
        <varlistentry>
          <term>Undo</term>

          <listitem>
            <para>Support for <quote>Undo</quote> is available in Tomboy through this menu item. The Undo function allows you to revert previous changes made to your note during the current session. To undo your last change using the keyboard, use the standard keybinding, <keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Redo</term>

          <listitem>
            <para>The <quote>Redo</quote> function is used to put back changes that were removed using the <quote>Undo</quote> feature. To redo your last change using the keyboard, use the standard keybinding, <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Bold</term>

          <listitem>
            <para>To make text within your note bold, first select the text you want to modify. Then select the <menuchoice><guimenuitem>Bold</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu. You may also use the keybinding <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo> after selecting the text.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Italic</term>

          <listitem>
            <para>To make text within your note italic, first select the text you want to modify. Then select the <menuchoice><guimenuitem>Italic</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu. You may also use the keybinding <keycombo><keycap>Ctrl</keycap><keycap>I</keycap></keycombo> after selecting the text.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Strikeout</term>

          <listitem>
            <para>The strikeout style will put a line through the selected text. To add a strikeout, select the text and then select the <menuchoice><guimenuitem>Strikeout</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu. You may also use the keybinding <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo> after selecting the text.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Highlight</term>

          <listitem>
            <para>The highlight style will put a yellow background around the selected text. To add a highlight, select the text and then select the <menuchoice><guimenuitem>Highlight</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu. You may also use the keybinding <keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo> after selecting the text.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Fixed Width</term>

          <listitem>
            <para>The fixed width style allows text to use a fixed width font. To change existing text, first select the text you want to modify. Then select the <menuchoice><guimenuitem>Fixed Width</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu. You can also select the <menuchoice><guimenuitem>Fixed Width</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> before you start typing to have the text you type be in a fixed width style.</para>
            
            <para>The <menuchoice><guimenuitem>Fixed Width</guimenuitem></menuchoice> option is a feature provided by the Fixed Width Add-in. For more information on add-ins, see <xref linkend="plugins"/>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Font size</term>

          <listitem>
            <para>There are actually four options in this part of the menu: <simplelist type="inline">
                <member><guilabel>Small</guilabel></member>

                <member><guilabel>Normal</guilabel></member>

                <member><guilabel>Large</guilabel></member>

                <member><guilabel>Huge</guilabel></member>
              </simplelist>. Each one of these options represents a font size to use for the selected text in the note. To modify the font size, select the text and then select one of <simplelist type="inline">
                <member><guilabel>Small</guilabel></member>

                <member><guilabel>Normal</guilabel></member>

                <member><guilabel>Large</guilabel></member>

                <member><guilabel>Huge</guilabel></member>
              </simplelist> options from the <guibutton>Text</guibutton> menu.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Bullets</term>

          <listitem>
            <para>Select the <menuchoice><guimenuitem>Bullets</guimenuitem></menuchoice> option from the <guibutton>Text</guibutton> menu to begin or end a bulleted list. If the cursor is inside a bulleted list, the <simplelist type="inline">
                <member><guilabel>Increase Indent</guilabel></member>
                
                <member><guilabel>Decrease Indent</guilabel></member>
              </simplelist> options will be enabled.</para>
             
            <para>With the cursor on a bulleted list line, select the <menuchoice><guimenuitem>Increase Indent</guimenuitem></menuchoice> option to shift the current line to the right or the <menuchoice><guimenuitem>Decrease Indent</guimenuitem></menuchoice> option to shift the current line to the left.</para>
            
            <para>For more information on bullets, see <xref linkend="bullets"/>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Find in This Note</term>

          <listitem>
          	<para>Use this to search for text within the current note. A small find bar will open up at the bottom of the note. To open the find bar using the keyboard, use the standard keybinding, <keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>.</para>
            
            <para>Enter text to find. After entering text, the matches will be highlighted. Click <guibutton>Find Next</guibutton> to highlight the next match and place the cursor there. Click <guibutton>Previous</guibutton> to move to the previous match.</para>
          	
          	<para>To close the find bar, click <guibutton>X</guibutton> (Close Button) on the far left or press the <keycap>Escape</keycap> key.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="tools">
      <title>Tools (gear icon)</title>

      <para>The <guibutton>Tools</guibutton> button is represented by the <inlinegraphic fileref="figures/tomboy-tools.png"/> icon. When you click the <guiicon>Tools</guiicon> icon on the toolbar present on your note, a menu will appear with the following items:</para>

      <variablelist>
        <varlistentry>
          <term>Synchronise Notes</term>

          <listitem>
            <para>Select this option to synchronise your notes with a central server. For more information on note synchronisation, see <xref linkend="synchronization"/>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>What links here?</term>

          <listitem>
            <para>This option allows you to quickly see what other notes link to the current note. This feature is provided by the Backlinks Add-in. For more information on add-ins, see <xref linkend="plugins"/>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Export to HTML</term>

          <listitem>
            <para>You can create an <acronym>HTML</acronym> (Hypertext Markup Language) document from one or more notes by selecting this option. For more information, please see <xref linkend="plugins"/>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Print</term>

          <listitem>
            <para>Select this option to print the current note. You will be presented with the standard GNOME print dialogue.</para>
          </listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>Depending on the add-ins that you have installed for Tomboy, you may have more or less items available in the <guimenu>Tools</guimenu> menu.</para>
      </note>
    </sect2>

    <sect2 id="delete">
      <title>Delete</title>

      <para>The <guibutton>Delete</guibutton> button will pop up a dialogue box asking if you want to permanently delete the note and its contents. Click the <guibutton>Delete</guibutton> button to discard the note permanently, or <guibutton>Cancel</guibutton> to abort the process. Links to this note from other notes will still exist, but will re-create the note upon activation.</para>
    </sect2>
  </sect1>

  <!--=========== Panel Menu ====================================== -->

  <sect1 id="panel-menu">
    <title>Panel Menu</title>

    <para>Tomboy keeps the most recently used notes quickly available to you in
    a menu that appears when you click on the Tomboy Icon in the GNOME
    Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X.</para>

    <sect2 id="note-pinning">
      <title>Note Pinning</title>

      <para>To force a note to always be in the panel menu regardless of when you last accessed it, click the thumbtack icon to "pin" it to the menu. Notes that are pinned to the panel menu will have a thumbtack icons that look like this: <inlinegraphic fileref="figures/tomboy-pindown.png"/>. Notes that are not pinned to the panel menu will have thumbtack icons that look like this: <inlinegraphic fileref="figures/tomboy-pinup.png"/>.</para>

      <figure>
        <title>Tomboy Panel Menu</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-main-menu.png"/>
          </imageobject>
        </mediaobject>
      </figure>
    </sect2>
  </sect1>

  <!--=========== Bulleted Lists ================================== -->

  <sect1 id="bullets">
    <title>Bulleted Lists</title>

    <sect2 id="bullet-start">
      <title>Begin a bulleted list</title>
        
      <para>You may begin a bulleted list by using one of the following methods:</para>

      <orderedlist>
        <listitem>
          <para>Select <menuchoice><guimenuitem>Bullets</guimenuitem></menuchoice> from the <guibutton>Text</guibutton> menu.</para>
        </listitem>

        <listitem>
          <para>Begin a line with a single dash character (-), type some text immediately following the dash, and press <keycap>Enter</keycap>.</para>
        </listitem>
      </orderedlist>
    </sect2>
      
    <sect2 id="bullet-end">
      <title>End a bulleted list</title>

      <para>End a bulleted list by doing one of the following:</para>
      
      <orderedlist>
        <listitem>
          <para>Select <menuchoice><guimenuitem>Bullets</guimenuitem></menuchoice> from the <guibutton>Text</guibutton> menu.</para>
        </listitem>

        <listitem>
          <para>Press <keycap>Enter</keycap> on a blank bulleted line.</para>
        </listitem>

        <listitem>
          <para>Select <menuchoice><guimenuitem>Decrease Indent</guimenuitem></menuchoice> from the <guibutton>Text</guibutton> menu in succession until the current line is no longer part of the bulleted list.</para>
        </listitem>

        <listitem>
          <para>Using the key combination <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> in succession until the current line is no longer part of the bulleted list.</para>
        </listitem>
      </orderedlist>
    </sect2>
      
    <sect2 id="bullet-increase-indent">
      <title>Increase Indentation</title>
      
      <para>To increase the line indentation in a bulleted list with the mouse:</para>
      
      <itemizedlist>
        <listitem>
          <para>Select <menuchoice><guimenuitem>Increase Indent</guimenuitem></menuchoice> from the <guibutton>Text</guibutton> menu.</para>
        </listitem>
      </itemizedlist>

      <para>To increase the line indentation in a bulleted list with the keyboard:</para>
      
      <itemizedlist>
        <listitem>
          <para>Press the <keycap>Tab</keycap> key.</para>
        </listitem>
      </itemizedlist>
    </sect2>
      
    <sect2 id="bullet-decrease-indent">
      <title>Decrease Indentation</title>
        
      <para>To decrease the line indentation in a bulleted list with the mouse:</para>
      
      <itemizedlist>
        <listitem>
          <para>Select <menuchoice><guimenuitem>Decrease Indent</guimenuitem></menuchoice> from the <guibutton>Text</guibutton> menu.</para>
        </listitem>
      </itemizedlist>

      <para>To decrease the line indentation in a bulleted list with the keyboard:</para>
      
      <itemizedlist>
        <listitem>
          <para>Press the key combination <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo>.</para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>
  
  <!--=========== Working with Notebooks =========================== -->
  
  <sect1 id="notebooks">
  	<title>Working with Notebooks</title>
  
    <para>Notebooks allow you to group related notes together. You can add a note to a notebook in the Search All Notes window or directly inside of a Note.</para>
    
    <sect2 id="creating-noteboks">
    <title>Creating Notebooks</title>
    
    <para>You can create new notebooks using one of the following methods:</para>
    
      <orderedlist>
        <listitem> 
        <para>Click on the Tomboy note icon present in the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X.  
        A menu will appear</para>   
        </listitem>
        <listitem>
        <para>Select <menuchoice><guimenuitem>Notebooks</guimenuitem><guimenuitem>New Notebook</guimenuitem></menuchoice>.</para></listitem>
		<listitem>
		<para>Enter a name for the new notebook.</para>
		</listitem>
	</orderedlist>
	
	      <figure id="new-notebook">
        <title>Create a new notebook from the Tomboy note icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/new-notebook.png"/>
          </imageobject>
        </mediaobject>
      </figure>
		
	<para>To create a new notebook from the Search All Notes dialogue:</para>
	<orderedlist>
		<listitem> 
	<para>Open <menuchoice>
              <guimenuitem>Search All Notes</guimenuitem>
            </menuchoice> by choosing it from the Tomboy icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X,
	or click on Search from an open note.</para>
	</listitem>
	<listitem>
	<para>Using your mouse, right-click in the left-hand box and choose <menuchoice><guimenuitem>New Notebook</guimenuitem></menuchoice>.</para>
	</listitem>
	<listitem>
	<para>Enter a name for the new notebook.</para>
	</listitem>
	<listitem>
	<para>With <guilabel>Search All Notes</guilabel> open, choose <menuchoice><guimenuitem>File</guimenuitem><guimenuitem>Notebooks</guimenuitem><guimenuitem>New Notebook</guimenuitem></menuchoice>.</para>
	</listitem>
	<listitem>
	<para>Enter a name for the new notebook.</para>
	</listitem>

	</orderedlist>
  	      
  	      <figure id="create-new-notebook">
        <title>Create a new notebook from Search All Notes</title>
         
         <mediaobject>
         <imageobject>
            <imagedata fileref="figures/add-notebook-search.png"/>
          </imageobject>
        </mediaobject>
      </figure> 
  
  </sect2>
  
  <sect2 id="adding-notes-notebook">
  	<title>Adding Notes to a Notebook</title>
  	
  	<para>To add notes to a notebook, you can add a note from the <guilabel>Search All Notes</guilabel> dialogue or directly within a note.</para>

	<para>To move an existing note from the Search All Notes dialogue:</para>
	<orderedlist>
		<listitem> 
	<para>Open <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice>
	 by choosing it from the Tomboy icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X,
	or click on Search from an open note.</para>
	</listitem>
	<listitem>
	<para>Using your mouse, drag the note(s) onto a notebook on the left.</para>
	</listitem>
	</orderedlist>

	<para>As you type a note, you can add the note directly to an existing notebook using the <guibutton>Notebook</guibutton> button. The <guibutton>Notebook</guibutton> button is represented by the <inlinegraphic fileref="figures/notebook-icon.png"/> icon.</para> 
	
	  	      <figure id="add-to-notebook">
        <title>Adding a note to a notebook</title>
         
         <mediaobject>
         <imageobject>
            <imagedata fileref="figures/add-to-notebook.png"/>
          </imageobject>
        </mediaobject>
      </figure> 


	</sect2>
	
	<sect2 id="notebook-templates">
	<title>Creating Notebook Templates</title>
	
	<para>After you create a notebook, you can create a template for each new note that you create in a specific notebook.</para>

	<orderedlist>
	<listitem> 
	<para>Open <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice>
	 by choosing it from the Tomboy icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X,
	or click on Search from an open note.</para>
	</listitem>
	<listitem>
	<para>Using your mouse, right-click on a Notebook that you have created and choose <menuchoice><guimenuitem>Open Template Note</guimenuitem></menuchoice>.</para>
	</listitem>
	<listitem>
	<para>This will open a new note that will be used as the template. Any text typed in this note will appear in all notes created in this Notebook. Create a new note in the notebook by using your mouse, right-click on a notebook and select <menuchoice><guimenuitem>New Note</guimenuitem></menuchoice>.</para>
	</listitem>
	</orderedlist>

	  	      <figure id="notebook-template">
        <title>Creating a Notebook Template</title>
         
         <mediaobject>
         <imageobject>
            <imagedata fileref="figures/note-template.png"/>
          </imageobject>
        </mediaobject>
      </figure> 
	
	</sect2>

	
	<sect2 id="deleting-notebooks">
	<title>Deleting a Notebook</title>
	<para>Deleting a notebook will not delete any of the notes which are currently inside the notebook. After deleting a notebook, the notes will not be associated with any notebook and can be seen by highlighting <menuchoice><guimenuitem>Unfiled Notes</guimenuitem></menuchoice> in the <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice> window.</para>
	
	<para>You can delete a notebook you have created by one of two methods:</para>
	<para>To delete a notebook using your mouse:</para>
	<orderedlist>
	<listitem> 
	<para>Open <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice>
	 by choosing it from the Tomboy icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X,
	or click on Search from an open note.</para>
	</listitem>
	<listitem>
	<para>Using your mouse, right-click on a Notebook that you have created and choose <menuchoice><guimenuitem>Delete Notebook</guimenuitem></menuchoice>.</para>
	</listitem>
	</orderedlist>
		  	      <figure id="notebook-delete">
        <title>Deleting a Notebook</title>
         
         <mediaobject>
         <imageobject>
            <imagedata fileref="figures/delete-notebook.png"/>
          </imageobject>
        </mediaobject>
      </figure> 
	
	<para>To delete a Notebook from the <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice>
	menu, open <menuchoice><guimenuitem>Search All Notes</guimenuitem></menuchoice>
	 by choosing it from the Tomboy icon on the GNOME Panel, the taskbar in Microsoft Windows, or the dock in Mac OS X.
	</para>
	<orderedlist>
	<listitem>
	<para>Using your mouse, left-click on the Notebook you want to delete.</para>
	</listitem>
	<listitem>
	<para>From the menu, choose <menuchoice><guimenuitem>Edit</guimenuitem><guimenuitem>Delete Notebook</guimenuitem></menuchoice></para>
	</listitem>
	</orderedlist>

	
	</sect2>
	
	</sect1>
	
  <!--=========== Synchronization ================================== -->

  <sect1 id="synchronization">
    <title>Note Synchronisation</title>
    
    <para>Tomboy can now keep your notes synchronised between multiple computers by relying on a central server.</para>

    <sect2 id="sync-configure">
      <title>Configure note synchronisation</title>

      <para>You can configure your note synchronisation preferences in the <guilabel>Synchronisation</guilabel> tab of the <interface>Tomboy Preferences</interface> dialogue. Default conflict handling behavior can be configured by selecting the <guibutton>Advanced...</guibutton> button.</para>

      <figure>
        <title>Tomboy Synchronisation Preferences</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-preferences-synchronization.png"/>
          </imageobject>
        </mediaobject>
      </figure>

    <sect3 id="sync-configure-webdav">
      <title>Configure note synchronisation service (WebDAV)</title>
        
      <para>In order to synchronise your notes with a WebDAV server, you will need the wdfs FUSE file system installed. Follow the documentation for your operating system to set up FUSE for your user. You will also need the GNOME Keyring installed.</para>
      
      <para>Choose <guimenuitem>WebDAV</guimenuitem> from the <guilabel>Service</guilabel> drop-down list. Fill in the connection information for your server, and then select the <guibutton>Save</guibutton> button. You are now ready to synchronise your notes.</para>
    </sect3>

    <sect3 id="sync-configure-ssh">
      <title>Configure note synchronisation service (SSH)</title>
        
      <para>In order to synchronize your notes with an SSH server, you will need
      the sshfs FUSE file system installed.  Follow the documentation for your operating
      system to set up FUSE for your user.  You will also need an SSH key for your
      SSH server account, which should be added to a running SSH daemon.  This can be
      done using the GNOME <application>Seahorse</application> application, which is also 
	  known as <application>Passwords and Encryption Keys</application>.</para>
	  
	  <para>It is recommended to use a third computer or server as the remote computer
	  to store the syncronized notes that are to be synced between multiple computers.</para>
	  
	  <para>Open <application>Passwords and Encryption Keys</application> by choosing 
	  <menuchoice><guimenu>Applications</guimenu><guimenu>Accessories</guimenu>
	  <guimenu>Passwords and Encryption Keys</guimenu></menuchoice>.  Click on your key, 
	  and from the menu choose <menuchoice><guimenu>Remote</guimenu>
	  <guimenu>Configure Key for Secure Shell...</guimenu></menuchoice>  and enter the domain name or IP address
	  of the computer you want to sync to in <guimenu>Computer Name</guimenu>.  Enter the username 
	  of the remote computer in <guimenu>Computer Name:</guimenu> and click <guimenu>Set Up</guimenu>.
	  When prompted, enter the password, and setting up your key will be completed.</para>
      
      <para>In <application>Tomboy</application>, choose <guimenuitem>SSH</guimenuitem> from the <guilabel>Service</guilabel>
      drop-down list. Fill in the connection information for your server, and then select the
      <guibutton>Save</guibutton> button.  The <guimenuitem>Folder Path</guimenuitem>, while optional, 
	  should point at an empty folder. You are now ready to synchronize your notes.</para>
    </sect3>

    <sect3 id="sync-configure-localfolder">
      <title>Configure note synchronisation service (Local Folder)</title>
        
      <para>You may want to synchronise your notes to a local folder if that folder is available to your other systems, or if that folder represents a local mount of a remote server.</para>
      
      <para>Choose <guimenuitem>Local Folder</guimenuitem> from the <guilabel>Service</guilabel> drop-down list. Choose the desired synchronisation <guilabel>Folder Path</guilabel>, and then select the <guibutton>Save</guibutton> button. You are now ready to synchronise your notes.</para>
    </sect3>
    </sect2>

    <sect2 id="sync-initiate">
      <title>Synchronise your notes</title>
        
      <para>You can synchronise your notes at any time by selecting <menuchoice><guimenu>Tools</guimenu><guimenuitem>Synchronise Notes</guimenuitem></menuchoice> from any note or from the <interface>Search All Notes</interface> dialogue.</para>
    </sect2>
    
    <sect2 id="sync-conflicts">
      <title>Handling synchronisation conflicts</title>
      
      <para>When synchronising notes between multiple computers, conflicts may occur. Usually this is the result of not synchronising regularly when switching between systems. Tomboy will detect conflicts in the content of your notes and help you to avoid loss of important data.</para>
      
      <para>If a conflict is detected during note synchronisation, the <interface>Note Conflict</interface> dialogue will appear. If you do not need the changes you made in your local note, you can select <guilabel>Overwrite local note</guilabel>. If you would like to keep your local changes in a new note, select <guilabel>Rename local note</guilabel>.</para>
    </sect2>
  </sect1>

  <sect1>
    <title>Preferences</title>

    <para>To set preferences for Tomboy, right-click on the icon in the panel, and select <menuchoice><guimenuitem>Preferences</guimenuitem></menuchoice> from the menu. You will see a dialogue similar to the one displayed in <xref linkend="pref-editing"/>. There are two categories of preferences, <guilabel>Editing</guilabel> and <guilabel>Hotkeys</guilabel>. Preferences for each tab will be described below.</para>

    <sect2>
      <title>Editing</title>

      <para>The editing tab will allow you to set preferences related to editing notes. There are three checkboxes on this tab, which can either be turned on or off.</para>

      <variablelist>
        <varlistentry>
          <term>Spellcheck While Typing</term>

          <listitem>
            <para>Enable this checkbox to underline misspellings in red, and provide suggestions in the right-click context menu. Enable or disable the checkbox using the mouse or the key combination <keycombo><keycap>Alt</keycap><keycap>S</keycap></keycombo>.</para>

            <note>
              <para>The spellcheck option is only available if you have the
              <application>GtkSpell</application> package installed.</para>
            </note>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Highlight WikiWords</term>

          <listitem>
            <para>Enable this checkbox to create links for phrases <literal>ThatLookLikeThis</literal>. Clicking on the link will create a new note with the title corresponding to the link text. Enable or disable this checkbox using the mouse or the key combination <keycombo><keycap>Alt</keycap><keycap>W</keycap></keycombo>.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Use Custom Font</term>

          <listitem>
            <para>Enable this checkbox to set a custom font to be used in your notes. If this option is disabled, the default system font will be used. Enable or disable this checkbox using the mouse or the key combination <keycombo><keycap>Alt</keycap><keycap>F</keycap></keycombo>.</para>
          </listitem>
        </varlistentry>
      </variablelist>

      <figure id="pref-editing">
        <title>Tomboy Editing Preferences</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-preferences-editing.png"/>
          </imageobject>
        </mediaobject>
      </figure>
    </sect2>

    <sect2>
      <title>Hotkeys</title>

      <para>The hotkeys tab allows you to set global key combinations to perform different functions in Tomboy. In order to set key combinations, you must have the <guibutton>Listen for Hotkeys</guibutton> checkbox enabled. Use <keycombo><keycap>Alt</keycap><keycap>H</keycap></keycombo> to toggle this option.</para>

      <variablelist>
        <varlistentry>
          <term>Show notes menu</term>

          <listitem>
            <para>Enter the key combination to open the notes menu.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Open "Start Here"</term>

          <listitem>
            <para>Enter the key combination to open the <quote>Start Here</quote> note, which is preinstalled with Tomboy.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Create new note</term>

          <listitem>
            <para>Enter the key combination to create a new note.</para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>Search notes</term>

          <listitem>
            <para>Enter the key combination to open the <interface>Search All Notes</interface> dialogue.</para>
          </listitem>
        </varlistentry>
      </variablelist>

      <figure>
        <title>Tomboy Hotkey Preferences</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-preferences-hotkeys.png"/>
          </imageobject>
        </mediaobject>
      </figure>
    </sect2>

    <sect2 id="prefs-synchronization">
      <title>Synchronisation</title>
      
      <para>Please see <xref linkend="synchronization"/> for more details.</para>
    </sect2>

    <sect2 id="prefs-plugins">
      <title>Add-ins</title>

      <para>The add-ins tab allows you to enable and configure Tomboy Add-ins.</para>
      
      <para>The list of installed add-ins shows on the left. An add-in is enabled by selecting it from the list and then selecting <guibutton>Enable</guibutton>. Disable an add-in by selecting it from the list and then selecting <guibutton>Disable</guibutton>.</para>
      
      <para>Please see <xref linkend="plugins"/> for more information about the add-ins that are installed with Tomboy.</para>

      <figure>
        <title>Tomboy Add-in Preferences</title>

        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/tomboy-preferences-add-ins.png"/>
          </imageobject>
        </mediaobject>
      </figure>
    </sect2>
  </sect1>

  <sect1 id="plugins">
    <title>Add-ins</title>

    <para>By default, Tomboy comes with several pre-installed add-ins: <simplelist type="inline">
        <member>Backlinks</member>

        <member>Bugzilla URL Drop</member>

        <member>Evolution Mail Drop</member>

        <member>Export to HTML</member>

        <member>Fixed Width</member>

        <member>Note of the Day</member>

        <member>Print Notes</member>

        <member>and Sticky Notes Import.</member>
      </simplelist> Since these are preinstalled, they are ready to use and are automatically loaded into the Tomboy interface.</para>

    <note>
      <para>Some add-ins exist that are not installed by default.</para>
    </note>

    <variablelist>
      <varlistentry>
        <term>Backlinks (What links here?)</term>

        <listitem>
          <para>This add-in allows you to know which notes link to the note you are currently editing. It makes it easier to keep track of the relationships between notes. If this add-in is enabled, the <link linkend="tools">Tools</link> menu will have a <guimenuitem>What links here?</guimenuitem> option. When you select this option, it will list all the notes which link to the current note in a submenu. Select a note in the submenu to open it.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Bugzilla URL Drop</term>

        <listitem>
          <para>Allows you to drag a Bugzilla URL from your browser directly into a Tomboy note. The bug number is inserted as a link with a small bug icon next to it. Once the Bugzilla link has been inserted into the note, click on it to open the URL in your web browser.</para>
          
          <para>Customise the icons that are used by editing the add-in preferences in the <link linkend="prefs-plugins">Preferences Dialogue</link>. After highlighting the Bugzilla Add-in, click <guibutton>Preferences</guibutton> to open the <interface>Bugzilla Add-in Settings</interface> dialogue. To add a new icon, click <guibutton>Add</guibutton>, select an icon on your computer, provide a Bugzilla host name (e.g., bugzilla.gnome.org), and click <guibutton>Open</guibutton>. Any Bugzilla URL that is dragged and dropped from one of these custom host names will now use the icon you specified.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Evolution Mail Drop</term>

        <listitem>
          <para>This add-in allows you to drag and drag an e-mail message from the <application>Evolution</application> mail application to one of your Tomboy notes. Clicking on the mail icon in the note will then open the corresponding e-mail message in Evolution.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Export to HTML</term>

        <listitem>
          <para>When this add-in is installed, the <link linkend="tools">Tools</link> menu will have the <guimenuitem>Export to HTML</guimenuitem> option available.</para>

          <para>After selecting this option, you will be presented with a dialogue that allows you to choose where to save the <acronym>HTML</acronym> file. Enter the destination filename and click <guibutton>OK</guibutton> to save the file, or <guibutton>Cancel</guibutton> to abort the operation.</para>

          <para>To export any notes for which a link exists in the current note, select the <guibutton>Export linked notes</guibutton> button.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Fixed Width</term>

        <listitem>
          <para>Allows you to use a fixed-width font when creating/editing notes. If this add-in is enabled, the <link linkend="text">Text</link> menu will have a <guimenuitem>Fixed Width</guimenuitem> option.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Note of the Day</term>

        <listitem>
          <para>This add-in automatically creates a "Today" note for jotting daily thoughts down. The current date is used as a basis for the title of the note. As an example, the title of a "Today" note created on February 28, 2007, would be, "Today: Wednesday, February 28 2007"</para>
          
          <para>If you leave a "Today" note unmodified, the Note of the Day Add-in will automatically delete the note.</para>
          
          <para>To customise the content of the default "Today" note, create a new note and change the title of the note to be, "Today: Template". Change the content of the template note to whatever you like. When new "Today" notes are created, it will then use the content of your "Today: Template" note.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Print Notes</term>

        <listitem>
          <para>When this add-in is installed, the <link linkend="tools">Tools</link> menu will have the <guimenuitem>Print</guimenuitem> option available.</para>

          <para>Select this option to print the current note. You will be presented with the standard GNOME print dialogue.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Sticky Notes Import</term>

        <listitem>
          <para>When this add-in is installed, the <link linkend="tools">Tools</link> menu will have the <guimenuitem>Import from Sticky Notes</guimenuitem> option available.</para>

          <para>Use this option to import notes from the <application>Sticky Notes</application> application that is available in prior releases of GNOME. This option has been included in Tomboy to provide an upgrade path for users who would like to migrate from <application>Sticky Notes</application> to Tomboy for their note taking purposes.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect1>
</article>
