Diff of /doc/users-guide.xml [9b252d] .. [b3a22b] Maximize Restore

  Switch to side-by-side view

--- a/doc/users-guide.xml
+++ b/doc/users-guide.xml
@@ -1,24 +1,23 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE article 
         PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <article>
-<articleinfo>
-<title>Accents Plugin</title>
+<title>Accents Plugin</title><articleinfo>
 <author>
 <othername>Ollie Rutherfurd</othername>
 </author>
 <edition>Version $Version$</edition>
-<date>$Date$</date>
+<date>2004-05-02</date>
 </articleinfo>
 <section id="about">
 <title>About</title>
-<para><citetitle>Accents</citetitle> makes inserting characters like <literal>ˇ</literal> easy.  As you 
-type, <citetitle>Accents</citetitle> watches for character abbreviations and 
-converts them as you type them.  For example, if you enter 
-<literal>'a</literal> <citetitle>Accents</citetitle> converts it to <literal>ˇ</literal> when you enter the 
-<literal>a</literal>.</para><para>However, with this convenience comes a cost.  If you actually 
-wanted to enter <literal>'a</literal>, not <literal>ˇ</literal>, you must enter <literal>' a</literal>,
+<para><citetitle>Accents</citetitle> enables one to enter non-ascii characters using 
+abbreviations. <citetitle>Accents</citetitle> converts the abbreviations to the 
+characters they represent, as you type. For example, if you 
+enter <literal>&quot;a</literal>, <citetitle>Accents</citetitle> converts it to <literal>ä</literal> when you type the
+&quot;a&quot; character.</para><para>However, with this convenience comes a cost.  If you actually 
+wanted to enter <literal>'a</literal>, not <literal>ĂĄ</literal>, you must enter <literal>' a</literal>,
 which <citetitle>Accents</citetitle> will convert to <literal>'a</literal> (it removes the space).</para><para>NOTE: At present, <citetitle>Accents</citetitle> assumes one is using the
 ISO-8859-1 character encoding (also known as Latin-1).</para></section>
 <section id="character-abbreviations">
@@ -36,379 +35,379 @@
 </thead>
 <tbody>
 <row>
-<entry><para>Ŕ</para></entry>
+<entry><para>À</para></entry>
 <entry><para>`A</para></entry>
 </row>
 <row>
-<entry><para>Á</para></entry>
+<entry><para>Á</para></entry>
 <entry><para>'A</para></entry>
 </row>
 <row>
-<entry><para>Â</para></entry>
+<entry><para>Â</para></entry>
 <entry><para>^A</para></entry>
 </row>
 <row>
-<entry><para>Ä</para></entry>
+<entry><para>Ä</para></entry>
 <entry><para>&quot;A</para></entry>
 </row>
 <row>
-<entry><para>Ă</para></entry>
+<entry><para>Ã</para></entry>
 <entry><para>~A</para></entry>
 </row>
 <row>
-<entry><para>Ĺ</para></entry>
+<entry><para>Å</para></entry>
 <entry><para>/A</para></entry>
 </row>
 <row>
-<entry><para>Ć</para></entry>
+<entry><para>Æ</para></entry>
 <entry><para>/E</para></entry>
 </row>
 <row>
-<entry><para>Ç</para></entry>
+<entry><para>Ç</para></entry>
 <entry><para>~C</para></entry>
 </row>
 <row>
-<entry><para>Đ</para></entry>
+<entry><para>Ð</para></entry>
 <entry><para>~D</para></entry>
 </row>
 <row>
-<entry><para>Č</para></entry>
+<entry><para>È</para></entry>
 <entry><para>`E</para></entry>
 </row>
 <row>
-<entry><para>É</para></entry>
+<entry><para>É</para></entry>
 <entry><para>'E</para></entry>
 </row>
 <row>
-<entry><para>Ę</para></entry>
+<entry><para>Ê</para></entry>
 <entry><para>^E</para></entry>
 </row>
 <row>
-<entry><para>Ë</para></entry>
+<entry><para>Ë</para></entry>
 <entry><para>&quot;E</para></entry>
 </row>
 <row>
-<entry><para>Ě</para></entry>
+<entry><para>Ì</para></entry>
 <entry><para>`I</para></entry>
 </row>
 <row>
-<entry><para>Í</para></entry>
+<entry><para>Í</para></entry>
 <entry><para>'I</para></entry>
 </row>
 <row>
-<entry><para>Î</para></entry>
+<entry><para>Î</para></entry>
 <entry><para>^I</para></entry>
 </row>
 <row>
-<entry><para>Ď</para></entry>
+<entry><para>Ï</para></entry>
 <entry><para>&quot;I</para></entry>
 </row>
 <row>
-<entry><para>Ń</para></entry>
+<entry><para>Ñ</para></entry>
 <entry><para>~N</para></entry>
 </row>
 <row>
-<entry><para>Ň</para></entry>
+<entry><para>Ò</para></entry>
 <entry><para>`O</para></entry>
 </row>
 <row>
-<entry><para>Ó</para></entry>
+<entry><para>Ó</para></entry>
 <entry><para>'O</para></entry>
 </row>
 <row>
-<entry><para>Ô</para></entry>
+<entry><para>Ô</para></entry>
 <entry><para>^O</para></entry>
 </row>
 <row>
-<entry><para>Ö</para></entry>
+<entry><para>Ö</para></entry>
 <entry><para>&quot;O</para></entry>
 </row>
 <row>
-<entry><para>Ř</para></entry>
+<entry><para>Ø</para></entry>
 <entry><para>/O</para></entry>
 </row>
 <row>
-<entry><para>Ő</para></entry>
+<entry><para>Õ</para></entry>
 <entry><para>~O</para></entry>
 </row>
 <row>
-<entry><para>Œ</para></entry>
+<entry><para>Œ</para></entry>
 <entry><para>/U</para></entry>
 </row>
 <row>
-<entry><para>Ţ</para></entry>
+<entry><para>Þ</para></entry>
 <entry><para>~T</para></entry>
 </row>
 <row>
-<entry><para>Ú</para></entry>
+<entry><para>Ú</para></entry>
 <entry><para>'U</para></entry>
 </row>
 <row>
-<entry><para>Ů</para></entry>
+<entry><para>Ù</para></entry>
 <entry><para>`U</para></entry>
 </row>
 <row>
-<entry><para>Ű</para></entry>
+<entry><para>Û</para></entry>
 <entry><para>^U</para></entry>
 </row>
 <row>
-<entry><para>Ü</para></entry>
+<entry><para>Ü</para></entry>
 <entry><para>&quot;U</para></entry>
 </row>
 <row>
-<entry><para>Ý</para></entry>
+<entry><para>Ý</para></entry>
 <entry><para>'Y</para></entry>
 </row>
 <row>
-<entry><para>Ÿ</para></entry>
+<entry><para>Ÿ</para></entry>
 <entry><para>&quot;Y</para></entry>
 </row>
 <row>
-<entry><para>Ž</para></entry>
+<entry><para>Ĺ˝</para></entry>
 <entry><para>^Z</para></entry>
 </row>
 <row>
-<entry><para>ŕ</para></entry>
+<entry><para>Ă </para></entry>
 <entry><para>`a</para></entry>
 </row>
 <row>
-<entry><para>á</para></entry>
+<entry><para>ĂĄ</para></entry>
 <entry><para>'a</para></entry>
 </row>
 <row>
-<entry><para>â</para></entry>
+<entry><para>â</para></entry>
 <entry><para>^a</para></entry>
 </row>
 <row>
-<entry><para>ä</para></entry>
+<entry><para>ä</para></entry>
 <entry><para>&quot;a</para></entry>
 </row>
 <row>
-<entry><para>ă</para></entry>
+<entry><para>ĂŁ</para></entry>
 <entry><para>~a</para></entry>
 </row>
 <row>
-<entry><para>ĺ</para></entry>
+<entry><para>ĂĽ</para></entry>
 <entry><para>/a</para></entry>
 </row>
 <row>
-<entry><para>ć</para></entry>
+<entry><para>ĂŚ</para></entry>
 <entry><para>/e</para></entry>
 </row>
 <row>
-<entry><para>ç</para></entry>
+<entry><para>ç</para></entry>
 <entry><para>~c</para></entry>
 </row>
 <row>
-<entry><para>đ</para></entry>
+<entry><para>Ă°</para></entry>
 <entry><para>~d</para></entry>
 </row>
 <row>
-<entry><para>č</para></entry>
+<entry><para>è</para></entry>
 <entry><para>`e</para></entry>
 </row>
 <row>
-<entry><para>é</para></entry>
+<entry><para>ĂŠ</para></entry>
 <entry><para>'e</para></entry>
 </row>
 <row>
-<entry><para>ę</para></entry>
+<entry><para>ĂŞ</para></entry>
 <entry><para>^e</para></entry>
 </row>
 <row>
-<entry><para>ë</para></entry>
+<entry><para>ĂŤ</para></entry>
 <entry><para>&quot;e</para></entry>
 </row>
 <row>
-<entry><para>ě</para></entry>
+<entry><para>ĂŹ</para></entry>
 <entry><para>`i</para></entry>
 </row>
 <row>
-<entry><para>í</para></entry>
+<entry><para>Ă­</para></entry>
 <entry><para>'i</para></entry>
 </row>
 <row>
-<entry><para>î</para></entry>
+<entry><para>ĂŽ</para></entry>
 <entry><para>^i</para></entry>
 </row>
 <row>
-<entry><para>ď</para></entry>
+<entry><para>ĂŻ</para></entry>
 <entry><para>&quot;i</para></entry>
 </row>
 <row>
-<entry><para>ń</para></entry>
+<entry><para>Ăą</para></entry>
 <entry><para>~n</para></entry>
 </row>
 <row>
-<entry><para>ň</para></entry>
+<entry><para>ò</para></entry>
 <entry><para>`o</para></entry>
 </row>
 <row>
-<entry><para>ó</para></entry>
+<entry><para>Ăł</para></entry>
 <entry><para>'o</para></entry>
 </row>
 <row>
-<entry><para>ô</para></entry>
+<entry><para>Ă´</para></entry>
 <entry><para>^o</para></entry>
 </row>
 <row>
-<entry><para>ö</para></entry>
+<entry><para>Ăś</para></entry>
 <entry><para>&quot;o</para></entry>
 </row>
 <row>
-<entry><para>ř</para></entry>
+<entry><para>ø</para></entry>
 <entry><para>/o</para></entry>
 </row>
 <row>
-<entry><para>ő</para></entry>
+<entry><para>Ăľ</para></entry>
 <entry><para>~o</para></entry>
 </row>
 <row>
-<entry><para>œ</para></entry>
+<entry><para>œ</para></entry>
 <entry><para>/u</para></entry>
 </row>
 <row>
-<entry><para>ß</para></entry>
+<entry><para>ß</para></entry>
 <entry><para>&quot;s</para></entry>
 </row>
 <row>
-<entry><para>š</para></entry>
+<entry><para>ĹĄ</para></entry>
 <entry><para>^s</para></entry>
 </row>
 <row>
-<entry><para>ţ</para></entry>
+<entry><para>Ăž</para></entry>
 <entry><para>~t</para></entry>
 </row>
 <row>
-<entry><para>ů</para></entry>
+<entry><para>Ăš</para></entry>
 <entry><para>`u</para></entry>
 </row>
 <row>
-<entry><para>ú</para></entry>
+<entry><para>Ăş</para></entry>
 <entry><para>'u</para></entry>
 </row>
 <row>
-<entry><para>ű</para></entry>
+<entry><para>Ăť</para></entry>
 <entry><para>^u</para></entry>
 </row>
 <row>
-<entry><para>ü</para></entry>
+<entry><para>Ăź</para></entry>
 <entry><para>&quot;u</para></entry>
 </row>
 <row>
-<entry><para>ý</para></entry>
+<entry><para>Ă˝</para></entry>
 <entry><para>'y</para></entry>
 </row>
 <row>
-<entry><para>ž</para></entry>
+<entry><para>Ĺž</para></entry>
 <entry><para>^z</para></entry>
 </row>
 <row>
-<entry><para>×</para></entry>
+<entry><para>×</para></entry>
 <entry><para>~*</para></entry>
 </row>
 <row>
-<entry><para>÷</para></entry>
+<entry><para>á</para></entry>
 <entry><para>~/</para></entry>
 </row>
 <row>
-<entry><para>•</para></entry>
+<entry><para>•</para></entry>
 <entry><para>~.</para></entry>
 </row>
 <row>
-<entry><para>—</para></entry>
+<entry><para>—</para></entry>
 <entry><para>~-</para></entry>
 </row>
 <row>
-<entry><para>ś</para></entry>
+<entry><para>Âś</para></entry>
 <entry><para>/P</para></entry>
 </row>
 <row>
-<entry><para>§</para></entry>
+<entry><para>§</para></entry>
 <entry><para>/S</para></entry>
 </row>
 <row>
-<entry><para>™</para></entry>
+<entry><para>™</para></entry>
 <entry><para>/T</para></entry>
 </row>
 <row>
-<entry><para>Š</para></entry>
+<entry><para>Š</para></entry>
 <entry><para>/C</para></entry>
 </row>
 <row>
-<entry><para>Ž</para></entry>
+<entry><para>ÂŽ</para></entry>
 <entry><para>/R</para></entry>
 </row>
 <row>
-<entry><para>°</para></entry>
+<entry><para>°</para></entry>
 <entry><para>/d</para></entry>
 </row>
 <row>
-<entry><para>ş</para></entry>
+<entry><para>Âş</para></entry>
 <entry><para>/D</para></entry>
 </row>
 <row>
-<entry><para>ą</para></entry>
+<entry><para>Âą</para></entry>
 <entry><para>+-</para></entry>
 </row>
 <row>
-<entry><para>š</para></entry>
+<entry><para>š</para></entry>
 <entry><para>^1</para></entry>
 </row>
 <row>
-<entry><para>˛</para></entry>
+<entry><para>²</para></entry>
 <entry><para>^2</para></entry>
 </row>
 <row>
-<entry><para>ł</para></entry>
+<entry><para>Âł</para></entry>
 <entry><para>^3</para></entry>
 </row>
 <row>
-<entry><para>´</para></entry>
+<entry><para>´</para></entry>
 <entry><para>~'</para></entry>
 </row>
 <row>
-<entry><para>ź</para></entry>
+<entry><para>Âź</para></entry>
 <entry><para>/4</para></entry>
 </row>
 <row>
-<entry><para>˝</para></entry>
+<entry><para>½</para></entry>
 <entry><para>/2</para></entry>
 </row>
 <row>
-<entry><para>ž</para></entry>
+<entry><para>ž</para></entry>
 <entry><para>/3</para></entry>
 </row>
 <row>
-<entry><para>Ť</para></entry>
+<entry><para>ÂŤ</para></entry>
 <entry><para>~&lt;</para></entry>
 </row>
 <row>
-<entry><para>ť</para></entry>
+<entry><para>Âť</para></entry>
 <entry><para>~&gt;</para></entry>
 </row>
 <row>
-<entry><para>Ą</para></entry>
+<entry><para>ÂĄ</para></entry>
 <entry><para>~!</para></entry>
 </row>
 <row>
-<entry><para>ż</para></entry>
+<entry><para>Âż</para></entry>
 <entry><para>~?</para></entry>
 </row>
 <row>
-<entry><para>˘</para></entry>
+<entry><para>¢</para></entry>
 <entry><para>/c</para></entry>
 </row>
 <row>
-<entry><para>€</para></entry>
+<entry><para>€</para></entry>
 <entry><para>~E</para></entry>
 </row>
 <row>
-<entry><para>Ł</para></entry>
+<entry><para>ÂŁ</para></entry>
 <entry><para>~L</para></entry>
 </row>
 <row>
-<entry><para>Ľ</para></entry>
+<entry><para>ÂĽ</para></entry>
 <entry><para>~Y</para></entry>
 </row>
 </tbody>
@@ -423,6 +422,14 @@
 <varname><citetitle>Enabled</citetitle>:</varname></term>
 <listitem>
 <para>Enable or disable <citetitle>Accents</citetitle>.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<varname><citetitle>Convert Abbreviation before Caret</citetitle>:</varname></term>
+<listitem>
+<para>Convert the abbreviation before the caret.  This works
+regardless of whether <citetitle>Accents</citetitle> is enabled to convert
+abbreviations as you type them.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term>