<?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">
  <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>

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

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

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

    <!-- 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> dialog 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> dialog.  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>
      dialog, 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 stylize 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> dialog 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>Synchronize Notes</term>

          <listitem>
            <para>Select this option to synchronize your notes with a
            central server.  For more information on note synchronization, 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 dialog.</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 dialog 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 dialog:
	</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>
  	 dialog or directly within a note.</para>

	<para>To move an existing note from the Search All Notes dialog:
	</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 
	<guimenu>Notebook</guimenu>	button. 
	The <guimenu>Notebook</guimenu> 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 Synchronization</title>
    
    <para>Tomboy can now keep your notes synchronized between multiple
    computers by relying on a central server.</para>

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

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

      <figure>
        <title>Tomboy Synchronization Preferences</title>

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

    <sect3 id="sync-configure-webdav">
      <title>Configure note synchronization service (WebDAV)</title>
        
      <para>In order to synchronize 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 synchronize your notes.</para>
    </sect3>

    <sect3 id="sync-configure-ssh">
      <title>Configure note synchronization 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>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.  You are now ready to synchronize your notes.</para>
    </sect3>

    <sect3 id="sync-configure-localfolder">
      <title>Configure note synchronization service (Local Folder)</title>
        
      <para>You may want to synchronize 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 synchronization <guilabel>Folder Path</guilabel>, and then select the
      <guibutton>Save</guibutton> button.  You are now ready to synchronize your notes.</para>
    </sect3>
    </sect2>

    <sect2 id="sync-initiate">
      <title>Synchronize your notes</title>
        
      <para>You can synchronize your notes at any time by selecting
        <menuchoice>
          <guimenu>Tools</guimenu>
          <guimenuitem>Synchronize Notes</guimenuitem>
        </menuchoice>
        from any note or from the <interface>Search All Notes</interface> dialog.
      </para>
    </sect2>
    
    <sect2 id="sync-conflicts">
      <title>Handling synchronization conflicts</title>
      
      <para>When synchronizing notes between multiple computers, conflicts may occur.
      Usually this is the result of not synchronizing 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 synchronization, the
      <interface>Note Conflict</interface> dialog 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 dialog 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> dialog.</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>Synchronization</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>Customize the icons that are used by editing the add-in
          preferences in the <link linkend="prefs-plugins">Preferences
          Dialog</link>.  After highlighting the Bugzilla Add-in, click
          <guibutton>Preferences</guibutton> to open the
          <interface>Bugzilla Add-in Settings</interface> dialog.  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
          dialog 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 customize 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 dialog.</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>
