<?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 introduction SYSTEM "introduction.xml">
<!ENTITY start SYSTEM "start.xml">
<!ENTITY interface SYSTEM "interface.xml">
<!ENTITY preferences SYSTEM "preferences.xml">
<!ENTITY modules SYSTEM "modules.xml">
<!ENTITY search SYSTEM "search.xml">
<!ENTITY studypad SYSTEM "studypad.xml">
<!ENTITY personal SYSTEM "personal.xml">
<!ENTITY journals SYSTEM "journals.xml">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY onlinehelp SYSTEM "onlinehelp.xml">
<!ENTITY originallanguage SYSTEM "originallanguage.xml">
<!ENTITY appversion "4.0.0">
<!ENTITY manrevision "4.0.0">
<!ENTITY date "09 December 2014">
<!ENTITY app "<application>Xiphos</application>">
<!ENTITY appname "Xiphos">
<!ENTITY xiphos "the Xiphos Team">
<!-- Information about the entities
       The legal.xml file contains legal information, there is no need to edit the file.
       Use the appversion entity to specify the version of the application.
       Use the manrevision entity to specify the revision number of this manual.
       Use the date entity to specify the release date of this manual.
       Use the app entity to specify the name of the application. -->]>
<!--
This is a GNOME documentation template, designed by the GNOME
Documentation Project Team. Please use it for writing GNOME
documentation, making obvious changes. In particular, all the words
written in UPPERCASE (with the exception of GNOME) should be
replaced. As for "legalnotice", please leave the reference
unchanged.

Remember that this is a guide, rather than a perfect model to follow
slavishly. Make your manual logical and readable.  And don't forget
to remove these comments in your final documentation!  ;-)
-->
<!--
    (Do not remove this comment block.)
Maintained by the GNOME Documentation Project
http://developer.gnome.org/projects/gdp
Template version: 2.0 beta
Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="fa">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo>
    <title><application>Xiphos</application> راهنما</title>
    <abstract role="description">
      <para>زیفوس برنامه‏ای است که به منظور کمک رسانی در مطالعۀ کتاب‏مقدس تهیه شده است.</para>
    </abstract>
    <copyright>
      <year>2003</year>
      <year>2010</year>
      <holder>تیم زیفوس</holder>
    </copyright>

    <!-- translators: uncomment this:

    <copyright>
      <year>2006</year>
      <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>

    -->
    <!-- An address can be added to the publisher information.  If a role is
    not specified, the publisher/author is the same for all versions of the
    document.  -->
    <publisher role="maintainer">
      <publishername>تیم زیفوس</publishername>
    </publisher>

     <legalnotice>
       <title>پیشنهادات و نظرات شما</title>
	<para>
    	For more information on <application>Xiphos</application>, please visit
    	the project website at <ulink type="http" url="http://xiphos.org">http://xiphos.org</ulink>.
	</para>

	 <para>To report a bug or make a suggestion regarding the Xiphos
	   application or this manual, Use
	   the <ulink url="http://sourceforge.net/tracker/?group_id=5528">
	   Tracker on SourceForge</ulink> or the mailing
	   lists <email>gnomesword-developers@lists.sourceforge.net</email>
	 </para>
    </legalnotice>
    
       <legalnotice id="legalnotice">
         <para>
           Permission is granted to copy, distribute and/or modify this
           document under the terms of the GNU General Public License
           (GPL), Version 2 or any later version published
           by the Free Software Foundation. You can find
           a copy of the GPL at this <ulink type="help" url="ghelp:gpl">link</ulink> or in the file COPYING
           distributed with this manual.
          </para>
 
         <para>
           DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
           UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
           WITH THE FURTHER UNDERSTANDING THAT:
 
           <orderedlist>
                 <listitem>
                   <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                     EXCEPT UNDER THIS DISCLAIMER; AND
                   </para>
                 </listitem>
                 <listitem>
                   <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                        THE POSSIBILITY OF SUCH DAMAGES.
                   </para>
                 </listitem>
           </orderedlist>
         </para>
   </legalnotice>

    <!-- 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>
        <firstname>اندی</firstname>
        <surname>پایپر</surname>
      </author>
      <author>
        <firstname>پیر</firstname>
        <surname>بنز</surname>
      </author>
      <author>
        <firstname>دکتر پیتر</firstname>
        <surname>فن کاهن</surname>
      </author>
      <author>
        <firstname>کارل</firstname>
        <surname>کلاین‏پیست</surname>
      </author>
      <author>
	<firstname>متیو</firstname>
	<surname>تالبرت</surname>
      </author>
      <othercredit role="translator">
	<firstname>Dominique</firstname>
	<surname>Corbex</surname>
	<affiliation>
	  <orgname>Xiphos Development team</orgname>
	</affiliation>
	<contrib>French translation</contrib>
      </othercredit>


      <!-- 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>


    <!-- According to GNU FDL, revision history is mandatory if you are -->
    <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
    <!-- Remember to remove the &manrevision; entity from the revision entries other
    -->
    <!-- than the current revision. -->
    <!-- The revision numbering system for GNOME manuals is as follows: -->
    <!-- * the revision number consists of two components -->
    <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
    <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
    <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
    <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
    <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
    <!-- to V3.0, and so on. -->

    <releaseinfo>This manual describes version 4.0.0 of Xiphos.
    </releaseinfo>
     <revhistory> 
	<revision> 
          <revnumber>Xiphos Manual V4.0.0</revnumber> 
          <date>December 2014</date> 
          <revdescription> 
             <para role="author">تیم زیفوس</para>
             <para role="publisher">تیم زیفوس</para>
          </revdescription> 
        </revision>
     </revhistory> 

    <keywordset>
      <keyword>گنوم</keyword>
      <keyword>زیفوس</keyword>
      <keyword>سورد</keyword>
      <keyword>کراس وایر</keyword>
      <keyword>هلپ دایالوگ</keyword>
    </keywordset>

  </articleinfo>

  <indexterm zone="index">
    <primary>زیفوس</primary>
  </indexterm>


  <!-- ============= Document Body ============================= -->

  <!-- Please note: the headers of the included files (introduction.xml,
  start.xml and so on) must be into this main help file. If they are not,
  the table of contents is not displayed by yelp.
  -->

  <!-- ============= Introduction ============================== -->
  <!-- Use the Introduction section to give a brief overview of what
  the application is and what it does. -->
  <sect1 id="xiphos-introduction">
    <title>مقدمه</title>
    <!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
 
    <para><application>Xiphos</application> is a Bible study and research tool based upon the "SWORD Project" libraries
    and the GTK libraries. You can use <application>Xiphos</application> to do the following:</para>
    <itemizedlist>
       <listitem>
          <para>مشاهدۀ آیات مورد علاقه</para>
       </listitem>
       <listitem>
          <para>یادداشتهای موعظه و یادداشتهای شخصی خود را در مورد آیات مورد نظر می‏توانید تایپ کنید</para>
       </listitem>
       <listitem>
           <para>بصورت اتوماتیک پانویس‏های کتاب‏مقدس و سایر کتب مرجع را دنبال کنید </para>
       </listitem>
       <listitem>
           <para>ترجمه‏های گوناگون را بصورت موازی مقایسه کنید</para>
       </listitem>
       <listitem>
           <para>با بهره برداری از متون عبری و یونانی روی زبان‏های اصلی کتاب‏مقدس کارهای مطالعاتی و تحقیقاتی انجام دهید</para>
        </listitem>
      </itemizedlist>
      <para><application>زیفوس</application> این را هدف خود قرار داده است که یک محیط کاری ساده در اختیار کاربران قرار دهد، در عین حال با در اختیار قرار دادن ابزاری بسیار قوی به کاربر اجازه دهد که کارهای مطالعاتی-تحقیقاتی خود را بر روی کتاب‏مقدّس انجام دهد.</para>

      <!-- ==== Figure ==== -->
      <figure id="sword-logo">
      <title>علامت انحصاری پروژۀ شمشیر</title> 	
      <screenshot>
        <mediaobject> 
	    <imageobject>
              <imagedata fileref="figures/sword3.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/sword3.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>علامت انحصاری پروژۀ شمشیر</phrase> 
	    </textobject> 
        </mediaobject> 
      </screenshot>
      </figure>

      <para>"The SWORD Project" is based at <ulink type="http" url="http://www.crosswire.org">http://www.crosswire.org</ulink>.  Other
      applications under the same banner are <application>MacSword</application> for the Macintosh, <application>BibleDesktop</application>,
      a Java application, <application>BibleTime</application> (another Linux program), and <application>The SWORD Project for
      Windows</application> (aka <application>BibleCS</application> or <application>WinSword</application>).</para>

      <para>
      <figure id="main-screenshot">
      <title>زیفوس در حال اجرا می‏باشد</title>
      <screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>زیفوس در حال اجرا می‏باشد</phrase> 
	    </textobject> 
	  </mediaobject> 
         </screenshot>
       </figure>
       </para>

       <!-- Where important notices are kept regarding Xiphos  -->
       <warning>
         <para><application>زیفوس</application> در حال حاضر تحت گسترش است، به همین دلیل ممکن است در بخشی از برنامه مشکلاتی به چشمتان بخورد، که در اینصورت لطفاً آن مورد را از لینک زیر به ما اطلاع دهید <ulink type="http" url="http://sourceforge.net/projects/xiphos"> وب‏سایت پروژه</ulink>، یا ایمیل <email>xiphos-developers@lists.sourceforge.net</email>. از هرگونه راهنمایی و کمک شما پیشاپیش سپاسگزاریم</para>
       </warning>


  </sect1>

  <!-- =========== Getting Started ============================== -->
  <!-- Use the Getting Started section to describe the steps required
  to start the application and to describe the user interface components
  of the application. If there is other information that it is important
  for readers to know before they start using the application, you should
  also include this information here.
  If the information about how to get started is very short, you can
  include it in the Introduction and omit this section. -->
  <sect1 id="familiar">
    <title>شروع به استفاده از زیفوس</title>
    
<!-- ============= Getting Started with Xiphos  ============-->
	<sect2 id="xiphos-getting-started">
  		<title>زیفوس در حال بارگذاری</title>
			<para>شما می‏توانید برنامۀ <application>زیفوس</application> را به یکی از روش‏های زیر اجرا نمایید:</para>
			<variablelist>
				<varlistentry>
					<term>فهرست برنامه‏ها</term>
					<listitem>
						<para>
						Choose <menuchoice><guisubmenu>Education</guisubmenu>
						<guimenuitem>Xiphos Bible Guide</guimenuitem>
						</menuchoice>.
			            </para>
    				</listitem>
    			</varlistentry>
    			<varlistentry>
    				<term>خط فرمان</term>
    				<listitem>
    					<para>عبارت <command>زیفوس</command>,  را وارد نموده، سپس کلید <keycap>اینتر</keycap>را بزنید.</para>
    				</listitem>
    			</varlistentry>
			<varlistentry>
				<term>پنجره‏ها</term>
				<listitem>
					<para>گزینۀ <menuchoice><guisubmenu>تمام برنامه‏ها</guisubmenu><guisubmenu>زیفوس </guisubmenu><guimenuitem>زیفوس</guimenuitem></menuchoice>را برگزیند.</para>
				</listitem>
			</varlistentry>

  		  	</variablelist>
    </sect2>
<!--Starting Xiphos for the First Time  -->
  	<sect2 id="xiphos-first-start">
  		<title>شروع برنامۀ زیفوس برای اولین مرتبه</title>
		<para>
		When you start <application>Xiphos</application> for the first time, <application>Xiphos</application> creates a default
		selection of options for display.  Also, if no other Sword application has ever been run, and thus there are no Bible
		modules installed, then <application>Xiphos</application> starts the Module Manager so that you can select and install a
		Bible module in your language preference.
		</para>
		<figure id="xiphos-start-question">
			<title>پرسش‏های مرتبط با دانلود کردن زیفوس</title>
			<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/first_start.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/first_start.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Xiphos Download Instruction</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
		<para><application>زیفوس</application> در ابتدای اجرای آن یک محیط کاری دارای یک برگه باز می‏کند، که در آن آیۀ رومیان 8: 28 به چشم می‏خورد. کاربر در این محیط کاری، می‏تواند در  بخش <menuchoice><guimenuitem>ویرایش</guimenuitem><guimenuitem>فرمان ترجیحات</guimenuitem></menuchoice> را برگزیند و بدینوسیله تغییرات دلخواه را در قسمت‏هایی که بصورت اتوماتیک ایجاد شده‏اند، بدهد.</para>
	 </sect2>
<!-- Xiphos on first time use -->
   	 <sect2 id="xiphos-when-you-start">
	 <title>بارگذاری زیفوس</title>
		<para>هر زمان که برنامۀ <application>زیفوس</application>را باز کنید، محیط کاری زیر را مشاهده خواهید کرد:</para>
		<figure id="xiphos-start-interface">
			<title>محیط کاری زیفوس</title>
			<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>محیط کاری زیفوس</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
                <para>محیط کاری <application>زیفوس</application>دارای عناصر زیر می‏باشد.</para>
		<variablelist>
			<varlistentry>
				<term>خط فرمان</term>
				<listitem>
					<para>خط فرمان دارای چند فرمان است که کاربرد<application>زیفوس</application>را گسترش می‏بخشد. این فرامین شامل محلی برای یادداشت‏های مطالعه و نیز توابع جستجوی پیشرفته می‏باشد. فرامی همچنین به شما کمک می‏کنند تا بتوانید استفاده از برنامۀ <application>زیفوس </application>را بسیار شخصی و به دلخواه خود بنمایید.</para>
				</listitem>
		 	</varlistentry>
	        <varlistentry>
				<term>ستون ابزار</term>
					<listitem>
						<para>ستون<interface>ابزار</interface>شامل کلیدهایی است که به شما کمک می‏کند تا به سرعت و سهولت بتوانید از کتاب‏مقدس استفاده نمایید.</para>
					</listitem>
		 		</varlistentry>
                <varlistentry>
					<term>ستون جانبی</term>
					<listitem>
						<para>ستون<interface>جانبی</interface>دستیابی به چندین کاربرد اساسی را ممکن می‏سازذ. این ستون شامل تمام علائم و نیز لیست کتابهایی است که نصب کرده‏اید. این ابزار همچنین برای جستجوهای ساده نیز قابل استفاده است.</para>
				</listitem>
		  	</varlistentry>
		  	<varlistentry>
				<term>چارچوب متن کتاب‏مقدس</term>
				<listitem>
					<para>چارچوب<interface>متن کتاب‏مقدس</interface>متن کتاب‏مقدسی را که باز دارید نشان می‏دهد.</para>
			    </listitem>
		  	 </varlistentry>
			<varlistentry>
				<term>پیش‏نگر</term>
				<listitem>
					<para>فرمان <interface>پیش‏نگر</interface>گزینه‏های مدول متن کتاب‏مقدس را نشان می‏دهد. این شامل اعداد مرتبط با کشف‏الآیات استرانگ، پانویس‏ها و نیز علائم زبان‏شناسی می‏باشند. این فرمان در زیر چاچوب متن کتاب‏مقدس قرار دارد.</para>
				</listitem>
			 </varlistentry>
		  	 <varlistentry>
			 	<term>چارچوب تفاسیر</term>
			 	<listitem>
					<para>فرمان<interface>چارچوب تفسیر</interface>کتابهای تفسیری را که در مرتبط با متن کتاب‏مقدس در حال استفاده است، نشان می‏دهد.</para>
			 	</listitem>
		         </varlistentry>
			 <varlistentry>
			 	<term>چارچوب کتاب</term>
			 	<listitem>
					<para>فرمان <interface>چارچوب کتاب</interface>کتابهای عمومی را که از طریق سورد در اختیار کاربر قرار دارند، نشان می‏دهد. این شامل مدول‏هایی از قبیل کتابهایی چون: "قوانین کالوین", "ژوزفوس: سری کامل نوشتجات " و غیره. این چارچوب را می‏توان از طریق فرمان مشاهدۀ مرور کتاب که در زیر فرمان چارچوب تفسیر است مورد استفاده قرار داد.</para>
			 	</listitem>
		         </varlistentry>
			 <varlistentry>
			 	<term>چارچوب فرهنگ واژه‏ها/کتاب</term>
			 	<listitem>
					<para>گزینه <interface>دیکشنری</interface> تعریف واژه های برگزیده شده را نشان می دهد در در بخش <interface>متن کتاب مقدس</interface>. نشان می دهد این گزینه پس از گزینه تفسیر قرار دارد.</para>
			 	</listitem>
		     </varlistentry>
			 </variablelist>
		     <para>
			When you right-click in the different interface sections, the interface displays a context popup menu, which
			provides access to more module-specific options, including display controls and printing services.
		     </para>
	</sect2>


  </sect1>

  <!-- Interface -->
  <sect1 id="interface">
    <title>محیط کاری</title>
    <!-- ============= Interface ============================== -->
	
 <!-- ============= Menubar  ============-->
	<sect2 id="menubar">
   		<title>خط فرمان</title>
   		<para>در بخش بالایی برنامۀ<application>زیفوس</application>خط فرمان قرار دارد.تقریباً تمامی کاربردها توسط انتخاب منوی درست اجرا می‏شوند. این کابردها بسته به نوع کاری که انجام می‏دهند گروه‏بندی شده‏اند. بعنوان نمونه، گروه فرامین کاربردی مرتبط با فایل، زیر فرمان<guisubmenu>پرونده</guisubmenu>دسته‏بندی شده‏اند.</para>
	        <figure id="menubar_figure">
			<title>خط فرمان</title>
	  		<screenshot> 
			  <mediaobject> 
			    <imageobject><imagedata fileref="figures/interface_menubar.png" format="PNG"/> 
			    </imageobject>
	    		<!-- EPS versions of the figures are not required at the moment. -->
          		<!-- 
		    <imageobject>
      			<imagedata fileref="figures/interface_menubar.eps" format="EPS"/>
    		    </imageobject>
		    -->
	    <textobject> 
	      <phrase>خط فرمان زیفوس</phrase> 
	    </textobject> 
	  </mediaobject> 
	
		      	</screenshot>
	    	</figure>
	</sect2>
	
<!-- ============= Toolbars  ============-->
	<sect2 id="toolbars">
   		<title>ستون‏فرمان</title>
   		<para>The function of the Toolbar is to provide control over the Bible and Commentary Panes. Activation of the Toolbar option is done by moving the mouse cursor over the desired toolbar button and selecting it. A tooltip will appear if the mouse cursor is held stationary over a toolbar button, describing the function of the button.کاربرد ستون ابزار اینست که کنترل‏های مربویط به چارچوب‏های کتاب‏مقدس و تفسیر را فراهم نماید. با حرکت دادن نشانگر ماوس بر روی دکمۀ ابزار مورد نظرتان و انتخاب آن، این گزینه فعال خواهد شد. اگر نشانگر ماوس را برای چند لحظه بر روی ابزار نگاه دارید، یک راهنمای کوچک باز خواهد شد که کاربرد آن کلید را توضیح خواهد داد. </para>
		<figure id="toolbar_figure">
			<title>ابزار</title>
			<screenshot> 
	  <mediaobject> 
	    <imageobject>
		<imagedata fileref="figures/interface_toolbar.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_toolbar.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>ابزار</phrase> 
	    </textobject> 
	  </mediaobject> 
	</screenshot>
		</figure>	
		<para>گزینۀ <interface>ابزار</interface>شامل کاربردهای زیر است:</para>
		<itemizedlist>
			<listitem>
				<para>تاریخچه مرور انتخاب و لیست</para>
			</listitem>
			<listitem>
				<para>انتخاب بخشی از کتاب‏مقدس</para>
			</listitem>
			<listitem>
				<para>انتخاب فصلی از کتاب‏مقدس</para>
			</listitem>
			<listitem>
				<para>انتخاب آیه‏ای از کتاب‏مقدس</para>
			</listitem>
			<listitem>
				<para>خلاصۀ بخش بخصوصی از کتاب‏مقدس</para>
			</listitem>
		</itemizedlist>
		
		<sect3>
			<title>انتخاب کردن تاریخچۀ پیشین/پسین</title>
			<para>حرکت بین قسمت برگزیده شدۀ فعلی و پیشین.</para>
		</sect3>
			
		<sect3 id="xiphos-toolbar-book">
			<title>انتخاب بخشی از کتاب‏مقدس</title>
			<para>این فرمان یک کتاب از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
		</sect3>
			
		<sect3 id="xiphos-toolbar-chapter">
			<title>انتخاب فصلی از کتاب‏مقدس</title>
			<para>این فرمان فصلی از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
		</sect3>
			
		<sect3 id="xiphos-toolbar-verse">
			<title>انتخاب آیه‏ای از کتاب‏مقدس</title>
			<para>این فرمان یک آیه از کتاب‏مقدس را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>نشان می‏دهد. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
		</sect3>
		
		<sect3 id="xiphos-toolbar-summary">
			<title>خلاصۀ بخش بخصوصی از کتاب‏مقدس</title>
			<para>Allows manual editing of passages which are displayed in the <interface>Bible Text Pane</interface> and <interface>Commentary Pane</interface>. Changes take effect once Enter is typed.این فرمان، اجازه می‏دهد که شما قسمتهایی  را که مایل هستید در بخش <interface>چارچوب متن کتاب‏مقدس</interface> و <interface>چارچوب تفسیر</interface>ویرایش کنید. هرگونه تغییری در این قسمت بلافاصله اعمال خواهد شد.</para>
			<warning>
				<para>لطفا اطمینان حاصل کنید که کتاب، فصل، و یا آیه‏ای که آنرا ویرایش کرده‏اید به درستی نامگذاری شده است، در غیر اینصورت اطلاعات اشتباه نمایش داده خواهد شد.</para>
			</warning>
		</sect3>
	</sect2>
   
<!-- ============= Sidebar  ============-->  
	<sect2 id="xiphos-sidebar">
   	 	<title>ابزار جانبی</title>
		<figure id="sidebar_figure">
			<title>ستون جانبی</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject>
		<imagedata fileref="figures/interface_sidepane.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_sidepane.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>ابزار جانبی</phrase> 
	    </textobject> 
	  </mediaobject> 
	   </screenshot>

	    	</figure>
		<para>
	     	On the left hand side of <application>Xiphos</application> there is the Sidebar. Here the user can switch between the different Sword modules,
	     	view bookmarks, do simple searches and view verse lists. In the Modules listing, a module may be chosen for viewing in the current tab of the
	     	main window by clicking it.  Using the context (right-click) menu, other options are to open a new tab using the module, open a separate
	     	(i.e. detached) window, or to view the "About" information for the module.
		</para>
		<para>
		To switch between all Sidebar functions, buttons have been placed at the top of the Sidebar.
		</para>
		<figure id="shortcut_figure">
			<title>میان‏بر به ابزار جانبی</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject>
		<imagedata fileref="figures/interface_shortcut.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_shortcut.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>میان‏بر به ابزار جانبی</phrase> 
	    </textobject> 
	  </mediaobject> 
			</screenshot>
	    	</figure>
	</sect2>
<!-- ============= Bible Text Pane  ============--> 
	<sect2 id="xiphos-bible">
   		<title>چارچوب متن کتاب‏مقدس</title>
  		<figure id="textpane_figure">
			<title>چارچوب متن کتاب‏مقدس</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject>
		<imagedata fileref="figures/interface_biblepane.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_biblepane.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>چارچوب متن کتاب‏مقدس</phrase> 
	    </textobject> 
	  </mediaobject> 
	
			</screenshot>
	    	</figure>
		<para>
		Positioned to the right of the Shortcut bar is the Bible text pane. All translations are displayed here.  When starting
		<application>Xiphos</application>, the translation last used in the leftmost tab will be displayed.
		</para>
		
		<sect3 id="xiphos-bible-open">
			<title>باز کردن ترجمۀ خاصی از کتاب‏مقدس</title>
			<para>به منظور تعویض ترجمۀ فعلی کتاب‏مقدس به یکی دیگر از ترجمه‏ها:</para>
			<itemizedlist>
				<listitem>
					<para>بر روی <interface>چارچوب متن کتاب‏مقدس</interface>رایت‏کلیک کنید. از صفحۀ فهرستی که باز شد، گزینۀ <menuchoice><guimenuitem>پرونده</guimenuitem><guimenuitem>بازکردن مدول</guimenuitem></menuchoice>را برگزینید و سپس ترجمه‏ای را دوست دارید، استفاده کنید، باز نمایید.</para>
				</listitem>
				<listitem>
					<para>زیر عنوان<guibutton> مدول‏ها،</guibutton>در بخش <interface>ستون جانبی</interface>،گزینۀ<menuchoice><guimenuitem>متون کتابمقدس</guimenuitem><guimenuitem>،زبان مورد علاقه</guimenuitem></menuchoice>، و ترجمۀ خاصی را که دوست دارید، می‏توانید انتخاب کنید.</para>
				</listitem>
			</itemizedlist>
		</sect3>
		
		<sect3 id="xiphos-bible-parallel">
			<title>استفاده از کاربرد موازی</title>
			<para>
			A nice function in <application>Xiphos</application> is the ability to view your specified bible text in several
			parallel translations of your choice.  The Parallel View mode can be accessed by selecting <guimenuitem>Parallel
			View</guimenuitem> just below the <interface>Bible Text Pane</interface>, next to the <guimenuitem>Standard
			View</guimenuitem> tab.
			</para>
			<para>
			You must choose which modules to display in parallel with the <guibutton>Preferences</guibutton> dialog found under
			the <guimenuitem>Edit</guimenuitem> menu.  In the dialog, choose Modules, then Parallel.  You can add or subtract
			from the list of modules that will be shown in the parallel view.  The toolbar gives you a selector tool to erase
			the list, delete a module from the list, and add modules to the list.
			</para>
			<para>
			The <guimenuitem>Parallel View</guimenuitem> shows just one verse at a time.  You can change the verse by selecting
			another verse, chapter, or book at the toolbar. Also note that modules that are Old Testament or New Testament only
			(e.g. Westminster Leningrad Codex, Byzantine Majority Text) will not be able to display books that they don't have.
			</para>
		<figure id="parallel_figure">
			<title>چارچوب متن کتاب‏مقدس- نگرش موازی</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_parallel.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_parallel.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>چارچوب متن کتاب‏مقدس- نگرش موازی</phrase> 
	    </textobject> 
	  </mediaobject> 
	
		      	</screenshot>
	    	</figure>
			<para>
			Additionally, a separate Parallel View window can be selected from the right click menu with <guimenuitem>Detach/Attach</guimenuitem>.
			Your Bible pane will return to its normal single text view, and the new Parallel View window will show the complete
			chapter, showing the same translations.
			</para>
		<figure id="parallel_figure_separate">
			<title>نگرش موازی - پنجره‏ای دیگر</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_parallel-separate.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_parallel-separate.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>نگرش موازی - پنجره‏ای دیگر</phrase> 
	    </textobject> 
	  </mediaobject> 
	
		      	</screenshot>
		</figure>
		</sect3>
		
		<sect3 id="xiphos-bible-open-separate">
			<title>ترجمۀ دیگری از کتاب‏مقدس را باز می‏کند</title>
			<para>
			In order to view a Bible translation separate from the <application>Xiphos</application> main window interface, under the
			<guibutton>Modules</guibutton> option in the <interface>Sidebar</interface>, choose <menuchoice><guimenuitem>Biblical
			Texts</guimenuitem><guimenuitem>language choice</guimenuitem></menuchoice>.  Then right-click on a translation and choose
			<guimenuitem>Open in dialog</guimenuitem>. The module will open in a separate, detached window of its own.
			</para>
			<para>
			Detached Bible and commentary windows have a synchronization button in the upper-left position beside the navigation bar.  When this
			button is depressed, the main window Bible and commentary will synchronize with detached Bible and commentary windows.  The
			synchronization goes both ways: Any detached window will synchronize navigation with all other detached Bibles and commentaries plus the
			main window, and the main window will drive all detached Bibles and commentaries whose synchronization button is depressed.
			</para>
		</sect3>
		
		<sect3 id="xiphos-bible-about">
			<title>Finding Out About The Current Translation</title>
			<para>
			To find out about the Bible translation currently being displayed:
			</para>
			<itemizedlist>
				<listitem>
					<para>
					right-click in the <interface>Bible Text pane</interface>. In the popup menu choose
					<guimenuitem>About </guimenuitem> module name.
					</para>
				</listitem>
				<listitem>
					<para>تحت <guibutton>مدول‏های</guibutton>موجود در<interface>ستون جانبی،</interface>گزینۀ<menuchoice><guimenuitem>متون کتاب‏مقدس</guimenuitem><guimenuitem>گزینۀ زبان‏ها</guimenuitem></menuchoice>را برگزینید. سپس روی یک ترجمه کلیک سمت راست ماوس را فشار دهید و در این قسمت گزینۀ<guimenuitem>در بارۀ</guimenuitem>را برگزینید.</para>
				</listitem>
			</itemizedlist>
		</sect3>
		
		<sect3 id="xiphos-bible-options">
			<title>گزینه‏های مدول</title>
			<para>
			Most Bible translations have additional options which the user can select.
			</para>
			<itemizedlist>
				<listitem>
					<para>کلمات عیسی مسیح به رنگ قرمز</para>
				</listitem>
				<listitem>
					<para>شماره‏های کشف‏الآیات استرانگ</para>
				</listitem>
				<listitem>
					<para>علائم واژه‏شناسی</para>
				</listitem>
				<listitem>	
					<para>پانویس‏ها</para>
				</listitem>
				<listitem>	
					<para>ارجاعات به کتاب‏مقدس</para>
				</listitem>
				<listitem>	
					<para>سر تیترها</para>
				</listitem>
				<listitem>	
					<para>محتویات تصویر</para>
				</listitem>
			</itemizedlist>
			<note>
				<para>
				Translations in other languages such as Greek or Hebrew have specific options which deal only with the specific language.
				</para>
			</note>
			<para>به منظور دستیابی به این گزینه‏ها:</para>
			<itemizedlist>
				<listitem>
					<para>روی ماوس رایت کلیک کنید،<interface>چارچوب متن کتابمقدس باز خواهد شد.</interface>در منویی که باز خواهد شد (مانند نمونۀ زیر)،<guibutton>گزینۀ مدول</guibutton>را انتخاب و کاربرد مورد نظر را علامت گذاری کنید.</para>
				</listitem>
			</itemizedlist>
			<figure id="module_options">
				<title>گزینه‏های مدول</title>
		  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_biblepane-options.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_biblepane-options.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>گزینه‏های مدول</phrase> 
	    </textobject> 
	  </mediaobject> 
	
			      	</screenshot>
		    	</figure>
		</sect3>
		
		<sect3 id="xiphos-view-options">
			<title>گزینه‏های مرور</title>
			<para>
			There are several additional modes that can be selected from the menubar's <guimenuitem>View</guimenuitem> pulldown.
			</para>
			<figure id="view_options">
				<title>گزینه‏های مرور</title>
		  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_menubar-view.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_menubar-view.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>گزینه‏های مرور</phrase> 
	    </textobject> 
	  </mediaobject> 
	
			      	</screenshot>

		    	</figure>
			<para>
			The first 4 checkboxes control whether each named subwindow is displayed.  The viewable state of the subwindows is remembered on a
			per-tab basis.  This makes it possible, for example, to have a tab dedicated to a maps module alone (in a dictionary module, having
			alphabetically-listed places), by turning off the display of Bible, Previewer, and Commentary for that tab.
			</para>
			<para>
			The remaining checkboxes control these other display features:
			</para>
			<itemizedlist>
				<listitem>	
					<para>
					Link Tabs - When more than one tab is open, each one's verse is navigated separately in the disabled
					case.  If tab linking is enabled, then all tabs navigate together, keeping all translations on the
					same verse.
					</para>
				</listitem>
				<listitem>	
					<para>
					Read Aloud - If you enable this, then <application>Xiphos</application> will funnel all selected verses
					through the <application>festival</application> text-to-speech system.  <application>Festival</application> is
					a widely-available TTS, often installed by default in Linux distributions.
					</para>
					<para>
					Also, mouse-selected text may be read aloud from Bibles, commentaries, and general books, using the
					right-click menu, regardless of whether Read Aloud is selected.
					</para>

				</listitem>
				<listitem>	
					<para>
					Show Verse Numbers - Normally enabled, this toggle can be disabled to prevent display of verse
					numbers within the text.
					</para>
				</listitem>
				<listitem>	
					<para>
					Highlight Current Verse - Initially disabled, this toggle replaces mere alternate colorization of
					the current verse with a substitute high-contrast highlight.  The colors used may be selected from
					the Preferences dialog.
					</para>
				</listitem>
			</itemizedlist>
		</sect3>
		
		<sect3 id="xiphos-default-css">
			<title>Display Control with CSS</title>
			<para>
			Users familiar with CSS (cascading style sheets) may wish to create the file "default-style.css" in the .xiphos
			directory to contain whatever CSS controls are desired.  Beware, it is very easy to shoot oneself in the foot with CSS, and this
			will affect all modules' display.  The facility exists to provide the capability that advanced users may wish.
			</para>
		</sect3>
		
		<sect3 id="xiphos-user-annotation">
			<title>User Annotation</title>
			<para>
			Many users wish to make personal annotations on individual verses, without the need to put a full "personal
			commentary" module to use.  <application>Xiphos</application> provides this in the right-click context menu in the
			Bible pane.  This brings up a dialog showing the current verse reference and offering a text box into which to enter
			a brief personal note.  Once the user closes the dialog with "Annotate Verse," the verse will be displayed in
			reverse-highlight (default, blue on yellow) and a marker <guibutton>*u</guibutton> will be inserted at the verse's
			beginning.  This is metaphorically similar for users who mark verses in paper Bibles with a yellow highlighter and
			write personal notes in the margins.
			</para>
			<para>
			Selecting an already-annotated verse will (in the usual case) bring up the existing content for re-editing.  An
			already-annotated verse can be unmarked; the verse will cease to show in reverse-highlight.
			</para>
			<para>
			If the user deletes the module name from the reference at the top of the dialog, then the annotation will apply to any Bible
			module at the selected verse.  However, in this case, re-selecting the annotated verse will not initialize with the existing
			content, because the dialog is created based on the specific module reference.
			</para>
		</sect3>
		
		<sect3 id="xiphos-geography-support">
			<title>Geography Support</title>
			<para>
			A connection to browsing BibleMap.org is available by mouse-selecting a place name in any text.  Use the right-click context
			menu to select <menuchoice><guimenuitem>Lookup Selection</guimenuitem><guimenuitem>Browse in
			BibleMap.org</guimenuitem></menuchoice>.  A web browser will be brought up to show the selected name's geography via
			BibleMap, which provides Biblical detail overlaid on a Google Maps interface.
			</para>
			<para>
			</para>
		</sect3>
		
		<sect3 id="xiphos-bible-dictionary">
			<title>Specific Word Meanings</title>
			<para>
			In order to check the meaning of a specific word, double-click on the word you wish to lookup. The word should then highlight itself and the
			explanation should be displayed, if available, in the <interface>Dictionary Pane</interface>. 
			</para>
		</sect3>
		
		<sect3 id="xiphos-bible-find">
			<title>Finding A Specific Word</title>
			<para>
			To find a specific word within a passage:
			</para>
			<itemizedlist>
				<listitem>
					<para>
					right-click in the <interface>Bible Text Pane</interface>. In the popup menu, choose
					<menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Find</guimenuitem></menuchoice>. A dialog will
					appear, which provides text searches. Fill out dialog and click the <guibutton>Find</guibutton> and
					<guibutton>Find Next</guibutton> buttons.  </para>
				</listitem>
			</itemizedlist>
		</sect3>
	</sect2>
<!-- ============= Previewer	================ -->
	<sect2 id="xiphos-viewer">
		<title>پیش‏نگر</title>
		<figure id="viewer_figure">
			<title>PreViewer</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_viewer.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>پیش‏نگر</phrase> 
	    </textobject> 
	  </mediaobject> 
	
		      	</screenshot>
		</figure>
		<para>
		The Previewer is where the user sees Strong's numbers, morphological tags, footnotes, and cross-references that the
		<interface>Bible Text Pane</interface> provides.
		</para>
		<para>
		Footnote content is displayed in the Previewer when you hover over the indicator <guibutton>*n</guibutton> in the Bible text;
		it remains visible until your mouse moves over another indicator, Strong's number, etc. Sometimes you may want the text to
		remain anchored until you can move the mouse to the previewer to click on a link or to read large footnotes. To anchor the text so
		that you can scroll it in the Previewer, middle-click the indicator (or hold down the <guibutton>Shift key</guibutton>)
		and move to the Previewer.
		</para>
		<para>
		Cross-reference indicators <guibutton>*x</guibutton> work much the same way.  Clicking the
		indicator will send the set of references to the <guibutton>Verse List</guibutton> in the
		<interface>Sidebar</interface>, where you can click them individually for reading in the Previewer.
                Alternately, a Preferences selector is available, so that cross-reference lists are sent to the
                verse list instead.
		</para>
		<para>
		Any verses shown in reverse-highlight have personal annotation associated with them, and such verses will include
		<guibutton>*u</guibutton> at the beginning of the verse.  Hovering on this marker will show the annotation in the previewer, just as
		for publisher's footnotes.
		</para>
		<para>
		If a devotional has been set via the Preferences dialog, then the day's devotional reference will also appear in the
		previewer, either on program startup or when the user requests it via the <guimenuitem>View</guimenuitem> menu.
		</para>
	</sect2>	
<!-- ============= Commentary Pane  ============--> 
	<sect2 id="xiphos-commentaries">
   		<title>The Commentary Pane</title>
		<figure id="commentary_figure">
			<title>The Commentary Pane</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_commentarypane.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_commentarypane.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>چارچوب تفاسیر</phrase> 
	    </textobject> 
	  </mediaobject> 
	
	      		</screenshot>
    		</figure>
		<para>
		The <interface>Commentary pane</interface> is where the commentary modules are displayed. This provides easy
		reading, reference, and access to different commentaries currently installed. The passage viewed by the 
		<interface>Commentary pane</interface> is directly controlled by the current passage viewed in the <interface>Bible
		Text pane</interface>, so in order to change to a different passage commentary, select the desired passage
		on the <interface>Toolbar</interface>.
		</para>
		<para>
		If there are images that are part of a commentary, general book, or dictionary/lexicon, they may be clicked to invoke a
		viewer on that single image, in order to get a better view.  This is particularly useful if image resizing has been enabled
		with the result that images are made very small in the subwindow.
		</para>
		<note>
			<para>
			By changing to passage settings on the <interface>Toolbar</interface>, the contents in the 
			<interface>Bible Text pane</interface> and the <interface>Commentary Pane</interface> will be changed. 	
			</para>
		</note>
		
		<sect3 id="xiphos-commentary-about">
			<title>Finding Out About The Commentary Module</title>
			<para>
			To find out about the commentary currently being displayed:
			</para>
			<itemizedlist>
				<listitem>
					<para>
					right-click in the <interface>Commentary Pane</interface>. In the popup menu choose
					<guimenuitem>About </guimenuitem> module name.
					</para>
				</listitem>
			</itemizedlist>
		</sect3>

		<sect3 id="xiphos-commentary-headings">
			<title>Commentary Headings.</title>
			<para>
			Many commentaries have additional headings which enable introductory information about the book and chapter currently
			being displayed in the <interface>Bible Text pane</interface>. In order to view them:
			</para>
			<itemizedlist>
				<listitem>
					<para>
					right-click in the <interface>Commentary Pane</interface>. In the popup menu choose
					<guimenuitem>Display Book Heading</guimenuitem> or <guimenuitem>Display Chapter Heading</guimenuitem>.
					</para>
				</listitem>
			</itemizedlist>
		</sect3>
	</sect2>

	<sect2 id="xiphos-dictionary">
		<title>Dictionary Pane</title>
		<figure id="dict_figure">
			<title>The Dictionary Pane</title>
	  		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_dictionary.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/image.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Dictionary Pane</phrase> 
	    </textobject> 
	  </mediaobject> 
	
	      		</screenshot>
    		</figure>

		<para>
		The Dictionary Pane's content is driven by its up/down selectors, typing in its navbar text, or double-clicks in the Bible, Commentary, or Book Panes.
		</para>
	</sect2>

	<sect2 id="xiphos-shortcut">
		<title>Keyboard Shortcuts</title>
		<para>
		Several keyboard shortcuts exist in <application>Xiphos</application>, listed below in rough functional groupings.
		</para>
		<para>
		Window selection/opening and navbar selection:
		</para>
		<itemizedlist>
			<listitem>
				<para>
					<guibutton>Ctrl-L</guibutton> focuses and selects the main verse navbar text.  You can then immediately type
					in new verse selection text.  Be aware that, as is the case with most Sword applications,
					<application>Xiphos</application> understands many abbreviations: "G" is adequate to specify Genesis,
					for example, and any book name by itself implies 1:1.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-C</guibutton> brings the Commentary View forward when previously obscured by the Book View.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-G</guibutton> is the opposite of Alt-C, focusing on the general book.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-D</guibutton> focuses on the dictionary navbar text.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-T</guibutton> opens a new tab.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-[1-9]</guibutton> makes the Nth tab current.
				</para>
			</listitem>
		</itemizedlist>
		<para>
		Verse navigation and Bible features:
		</para>
		<itemizedlist>
			<listitem>
				<para><guibutton>Ctrl-p/Ctrl-n</guibutton>: Verse previous/next. Also <guibutton>k/j</guibutton>.</para>
			</listitem>
			<listitem>
				<para><guibutton>p/n</guibutton>: Chapter previous/next.</para>
			</listitem>
			<listitem>
				<para><guibutton>P/N</guibutton>: Book previous/next.</para>
			</listitem>
			<listitem>
				<para><guibutton>Shift-F10</guibutton> brings up the context menu for the Bible pane.</para>
			</listitem>
			<listitem>
				<para><guibutton>Alt-S</guibutton>: Toggle Strong's display.</para>
			</listitem>
			<listitem>
				<para><guibutton>Alt-M</guibutton>: Toggle morphology display.</para>
			</listitem>
			<listitem>
				<para><guibutton>Alt-R</guibutton>: Toggle "red words of Christ" display.</para>
			</listitem>
		</itemizedlist>
		<para>
		Opening special windows:
		</para>
		<itemizedlist>
		        <listitem>
				<para>
					<guibutton>F1</guibutton> opens this manual.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>F2</guibutton>: opens the <guibutton>Preferences</guibutton> dialog.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>F3</guibutton>: opens <guibutton>Advanced Search</guibutton>.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-F3</guibutton>: brings forward the simple sidebar search.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>F4</guibutton>: opens the <guibutton>Module Manager</guibutton>.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-A</guibutton> opens an annotation dialog on the current verse.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-B</guibutton> opens a bookmark dialog on the current verse.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-F</guibutton> opens the "Find" dialog.  The subwindow to which it applies depends on which
					of them are visible: The Bible is first preference, then the commentary or general book, then the
					dictionary.  So a tab can be dedicated to just a book, and Ctrl-F will perform "Find" within that pane.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-P</guibutton> detaches/re-attaches the parallel view dialog.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Alt-Z</guibutton> opens editor on the personal commentary named Personal.
				</para>
			</listitem>
		</itemizedlist>
		<para>
		Font size control:
		</para>
		<itemizedlist>
			<listitem>
				<para>
					<guibutton>Ctrl-Plus/Ctrl-Minus</guibutton> increases/decreases the base font size.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-0</guibutton> (zero) sets the base font size to zero.
				</para>
			</listitem>
		</itemizedlist>
		<para>
		BibleSync:
		</para>
		<itemizedlist>
			<listitem>
				<para>
					<guibutton>Ctrl-Alt-Shift-P</guibutton> puts BibleSync into Personal mode.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-Alt-Shift-S</guibutton> puts BibleSync into Speaker mode.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-Alt-Shift-A</guibutton> puts BibleSync into Audience mode.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-Alt-Shift-O</guibutton> turns off BibleSync.
				</para>
			</listitem>
			<listitem>
				<para>
					<guibutton>Ctrl-Alt-Shift-N</guibutton> causes BibleSync to navigate your current main window point
					transiently as a one-shot event.  BibleSync must be transmit-ready, that is, in Personal or Speaker mode.
				</para>
			</listitem>
		</itemizedlist>
	</sect2>

  </sect1>

  <!-- Preferences -->
  <sect1 id="preferences">
    <title>Preferences</title>
    <!-- Preferences -->


<!-- Introduction -->
	<sect2 id="preferences-introduction">
  		<title>Introduction To Preferences</title>
		<figure>
			<title>The Preference Dialog</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Preferences Dialog</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>
                </figure>
               </sect2>
	
<!-- General Settings -->
	<sect2 id="general-settings">
		<title>General Settings</title>
		<sect3 id="tab-pane2">
			<title>Locale, General Preferences and StudyPad directory</title>
		<figure>
			<title>Locale, General Preferences and StudyPad directory</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_general-misc.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_general-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>General Preferences and StudyPad directory</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
		<para>
                If you wish <application>Xiphos</application> to display its interface in a language other than the default, you may select
                one here.  A restart will be required, so that the locale can be initialized.
		</para>
		<para>
                If you enable <guilabel>Default Dictionary</guilabel>, then that named dictionary (see <guimenuitem>Special</guimenuitem>
                below) module will always be used when double-clicking a word anywhere in <application>Xiphos</application>.
		</para>
		<para>
		Certain dictionary-style modules are <guilabel>Daily Devotionals</guilabel> whose keys are numerically in the form "Month.Day".  If you have
		such a module installed and it has been selected as your preferred devotional, then you can ask that <application>Xiphos</application>
		display today's selection during startup.
		</para>
		<para>
		If you enable <guilabel>Resize images</guilabel>, <application>Xiphos</application> will automatically resize image
		content in commentaries, general books, and dictionaries so as to fit the subwindow which contains them.
		</para>
		<para>
		<guilabel>Highlight current verse</guilabel>, if enabled, will cause <application>Xiphos</application> to substitute
		mere current verse colorization with a high-contrast alternate color scheme on the current verse.  The colors used may be
		chosen from the color selector pane (see below).
		</para>
		<para>
                <guilabel>Highlight user annotations</guilabel> uses inverted highlight color choices when marking user-annotated
                verses.
		</para>
		<para>
                By default, <guilabel>Cross-references</guilabel> go into the Previewer.  Selecting this checkbox puts them into the verse
                list instead.
		</para>
		<para>
                Verse number display can be offset in several ways provided by the checkboxes.
		</para>
                </sect3>
	</sect2>
	
<!-- General Settings -->
	<sect2 id="biblesync">
		<title>BibleSync Settings</title>
		<sect3 id="tab-bsp">
			<title>Controls for BibleSync</title>
		<figure>
			<title>Controls for BibleSync</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_general-biblesync.png" format="PNG"/>
	    </imageobject>
	    <textobject> 
	      <phrase>BibleSync Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
		<para>
		BibleSync is a shared navigation protocol using LAN multicast.  It is useful for a single person when running Bible programs on
		multiple machines or devices, all of which you wish to navigate through the Bible together, or for a group working closely together,
		such as translators.  Also, it has a "lecture" mode, where a speaker's Bible program induces the audience's programs to follow along.
		The difference in the modes regards who transmits and who receives navigation.  In Personal mode, BibleSync navigation is both
		transmitted and received; as Speaker, it transmits only; as Audience, it receives only.
		</para>
		<para>
		To enable BibleSync, select a mode from the radio buttons.  Also, choose whether to accept navigation directly, so that Xiphos moves
		immediately to a specified verse, or whether incoming navigation is instead sent to the verse list, where you can decide whether to
		follow.
		</para>
		<para>
		If you use a firewall, you must punch a hole in it for UDP port 22272.
		</para>
		<para>
		If you run more than one BibleSync-compatible program on your computer and do not wish your activity among them to be shared on the
		local net, you can use Personal mode combined with the Private checkbox.  This will tell <application>Xiphos</application> not to
		broadcast outside your system.
		</para>
		<para>
		You can send a verse list from the sidebar search or Advanced Search window via BibleSync; see the context (right-click) menu.  A
		particularly good use case for this is when using a simpler Bible program, such as on a mobile device, with another such as
		<application>Xiphos</application> that has significant search capability: Do searches in <application>Xiphos</application> and send
		the resulting verse list to the mobile device.  Be aware that size limitations on the protocol are small, and though a search may
		generate hundreds of results in the verse list, at most a few dozen will pass in the protocol to the receivers.  For
		<application>Xiphos</application>, receipt of multi-references always induces indirect verse list navigation.
		</para>
		<para>
		<application>Xiphos</application> is the first Bible program with a BibleSync implementation; as such, its utility may be limited for
		now.  But a number of other programs' authors and support organizations have indicated their intention to support BibleSync as well,
		including Laridian, theWord, BibleAnalyzer, and Accordance, as well as other Sword Project applications.
		</para>
                </sect3>
	</sect2>
	
<!-- Fonts And Colors -->
	<sect2 id="fonts-and-colors">
		<title>Fonts And Colors</title>
		<sect3 id="font-color">
			<title>Setting Font Colors</title>
			<figure>
			<title>Font Colour Settings</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_fonts-color.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/image.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Font Colour Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>

                </figure>
		<para>
		The <guibutton>Invert color pairs</guibutton> buttons are provided to make it easy, for example, to move the main window
		into "night mode," with white text on black background.
		</para>

                </sect3>
		
		<sect3 id="font-misc">
			<title>Miscellaneous Font Settings</title>
			<figure>
			<title>Miscellaneous Font Settings</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_fonts-misc.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_fonts-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Miscellaneous Font Settings</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>
                </figure>

		<para>
		In individual modules' display, the right-click menu's <guimenuitem>Module Options</guimenuitem> selector provides font name
		and size selection.
		</para>

		<para>
		The base font size is the size initially chosen for all modules displayed by <application>Xiphos</application>.  The
		verse number and individual modules' font size choices are relative to the base font size.
		</para>

		<para>
                The font name and size used for display is chosen from this order:
		</para>
                <itemizedlist>
                        <listitem>
                                <para>
                                The selection made via the context menu for the specific module, under <guimenuitem>Module
                                Options</guimenuitem>.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The per-language selection made under Preferences, here.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The module's own default selection, in its configuration file.
                                </para>
                        </listitem>
                        <listitem>
                                <para>
                                The application default.
                                </para>
                        </listitem>
                </itemizedlist>

		</sect3>
	</sect2>
	
<!-- Module Settings -->
	<sect2 id="module-settings">
		<title>Module Settings</title>
		<figure>
			<title>Parallel Preferences</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_modules-parallel.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_modules-parallel.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Parallel Preferences</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>

                </figure>
                <figure>
			<title>Various preferences Modules </title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/preferences_modules-misc.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/preferences_modules-misc.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Various Preferences Modules</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
	</sect2>


  </sect1>

  <!-- Modules -->
  <sect1 id="module-manager">
    <title>Module Manager</title>
    <!-- Modules -->

<!-- Introduction To Module Manager -->
	<sect2 id="module-introduction">
  		<title>Introduction To The Module Manager</title>
		<para>
		The "module" is the unit of content in <application>Xiphos</application>, and Sword generally; a Sword module is a resource
		available for viewing in Sword applications.  There are several varieties: Most importantly, Bible texts, as well as
		dictionaries and lexicons, commentaries, and general books, any of which may include image content (e.g. atlases).  They are
		installed either from a local directory structure (typically on removable media, such as a CDROM distribution) or remotely
		via ftp from a repository such as Crosswire, which is the home of Sword, and from which all officially Sword-sanctioned
		modules are available.  Also, many other modules are available from non-Crosswire repositories.  In particular, there is the
		Xiphos repository, containing a variety of otherwise-unofficial modules produced primarily by contributors to
		<application>Xiphos</application> itself.
		</para>
		<para>
		If you have other Sword applications installed, they will all share the same set of Sword modules that you install through
		the Module Manager.
		</para>
		<figure>
			<title>The Module Manager Dialog</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/module.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/module.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Module Manager Dialog</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>
		</figure>
		<para>
                Notice the <guibutton>View Intro</guibutton> button above.  You may see an introductory explanation of Module Manager
                operation at any time.
		</para>
	</sect2>
	
<!-- Sword Configure-->
	<sect2 id="sword-config">
	<title>Sword Module Configurations</title>
		<sect3 id="sword-sources">
			<title>Module Sources Settings</title>
			<figure>
				<title>Module Sources Settings</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/sword_sources.png" format="PNG"/>
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/sword_sources.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Module Installation</phrase> 
	    </textobject> 
	  </mediaobject> 
                        	</screenshot>

			</figure>
		<para>
		There are other repositories available besides CrossWire's own, though the modules available from other repositories do not
		represent content officially sanctioned by Crosswire.  On the web, see this page for list of those repositories known:
		<ulink type="http" url="http://www.crosswire.org/wiki/Module_Repositories">http://www.crosswire.org/wiki/Module_Repositories</ulink>		
		</para>
		<para>
		The list of standard repositories is maintained at CrossWire.  Xiphos normally auto-synchronizes with that list one time,
		when the user first puts the Module Manager to use.  The list may change, as new repositories come into existence;
		occasional re-synchronization with the list is suggested, which is accomplished by clicking <guibutton>Load Standard</guibutton>.
		</para>
		</sect3>
		<sect3 id="installation">
			<title>Sword Module Installations</title>
			<figure>
				<title>Sword Module Installations</title>
	        	<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/sword_config.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/sword_config.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Module Installation</phrase> 
	    </textobject> 
	  </mediaobject> 
                        </screenshot>
			</figure>
			<para>
			After you have selected your Install Source, click the <guimenuitem>Refresh</guimenuitem> button to cause
			<application>Xiphos</application> to find the module summary available from that source before moving on.
			</para>

			<para>
			Take note of the "Install Destination". In most cases, you will have a choice of a personal area or a system area. 
			The details vary according to your operating system.
			</para>
			
			<sect4 id="destination-linux">
				<title>Linux</title>
				<para>
    				Unless you run as root (via su or sudo) you will only be able to install in your personal area, under ~/.sword.
				If you run as root, or change permissions on the shared directory, you will also be able to install modules for
				all users, typically in /usr/share/sword. There have been some requests for Xiphos to provide a means by which
				an ordinary (non-root) user could start the program, gain temporary write access to the system area while installing
				modules, and then revoke that access after installation is complete.  Attempting to devise a scheme to do this has
				proven quite difficult, given the different superuser management schemes employed by various Linux distributions. 
				Therefore, at this time there are no ongoing plans to try to solve this problem, and users are advised to enable 
				write access to the system area outside Xiphos.
				</para>
			</sect4>
			
			<sect4 id="destination-xp">
				<title>Windows XP</title>
				<para>
				You may install modules to a shared folder so the modules are available to all users. If you have previously used
				"The Sword Project for Windows", this folder will be "C:\Program Files\Crosswire\The Sword Project\Sword". Otherwise
				it will be "C:\Documents and Settings\All Users\Application Data\Sword". You may also install modules to a location
				that can only be seen by you. This location is "C:\Documents and Settings\YOUR NAME\Application Data\Sword".
				</para>
			</sect4>
			
			<sect4 id="destination-vista">
				<title>Windows Vista</title>
				<para>
				Vista works much the same as XP, except for the locations. The private location is 
				"C:\Users\YOUR NAME\AppData\Roaming\Sword". The shared location is "C:\ProgramData\Sword".
				</para>
			</sect4>
			
		</sect3>
	</sect2>
	
<!-- Installing, Updating, and Maintaining Modules -->
	<sect2 id="module-management">
		<title>Installing, Updating, and Maintaining Modules</title>
		<sect3 id="add-module">
			<title>Installing, Updating, and Maintaining Modules</title>
			<figure>
				<title>Installing and Updating Modules</title>
	       		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/sword_install.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/image.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Module Installation</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>
			</figure>
		<para>
		The module manager generates both a per-type module list as well as a parallel availability list.  The latter is
		intended to make it easier to find new items without having to work one's way through the per-type list, one subtree at a
		time.  Modules which are either not yet installed or updated beyond what is currently installed will appear in both lists.
		</para>
		<para>
		Modules that are already installed will show a checkmark beside them.  If a fast search ("lucene") index is available, a magnifying glass will be
		displayed, otherwise an "X" will be shown; creation of the index is available on the Maintenance pane.  Locked modules, which require that you
		purchase an unlock key from the module's copyright holder, will show a lock symbol.  If there are modules installed for which a more recent
		version is available, a refresh icon will appear between the differing old and new version stamps.  There may be an approximate size displayed,
		if the repository management provides this information, otherwise a question mark ("-?-") will be shown.
		</para>
		<para>
		Select new modules to be installed by clicking the checkboxes and then the Install button at the bottom.  Any number of
		modules may be requested for installation at one time.
		</para>
		<para>
		If you acquire a locked module and have obtained the cipher key for it, the module is then unlocked in the main window: Open
		the module, which will probably appear blank, then using the right-click context menu, choose "Unlock This Module."
		</para>
		</sect3>
		<sect3 id="remove-module">
			<title>Module Maintenance</title>
			<figure>
				<title>Module Maintenance</title>
	       		<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/sword_remove.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/sword_remove.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>Module Maintenance</phrase> 
	    </textobject> 
	  </mediaobject> 
                        	</screenshot>
			</figure>
		<para>
		Several maintenance functions are available: Removal, archival, index, and index deletion.
		</para>
		<para>
		Removal disposes of a module entirely.  There is no recovery of the module unless you have previously archived a copy of it.
		</para>
		<para>
		Archival is available for any module, although it is provided with personal commentaries specifically in mind.  A *.zip of
		the module is left in the directory ~/.sword/zip.  Archival prior to removal of personal commentaries is recommended, in
		order to be available for future re-install if the subject matter of the personal commentary becomes important again.
		</para>
		<para>
		Indexing is provided so that the underlying Sword search support can create the index needed for the "lucene" fast-search
		functions.  If the index is not created, plain multi-word search will still be available, but it will be much slower.  With
		the index in place, searches through an entire Bible can take just a few seconds.
		</para>
		<para>
		Indexes may be deleted as well.
		</para>
		</sect3>
	</sect2>

<!-- Installing Non-Standard Modules -->
	<sect2 id="non-standard-modules">
		<title>Installing Non-Standard Modules</title>
		<para>
		Some resource modules in Sword Project format are available from sources other than Crosswire and not from a module manager-ready repository.
		Necessarily, installing such a module is a manual task.
		</para>
		<para>
		Modules are normally packaged as *.zip files; they contain a configuration file plus a number of data files.  Installation
		of such a module is done by cd'ing to your personal Sword (not <application>Xiphos</application>) configuration
		directory, ~/.sword, and unzipping the file there.  The configuration file will be left in "mods.d", and the module's data
		files will go into a subdirectory of "modules".  Alternatively, if you have write access to the system Sword directory,
		typically /usr/share/sword, you may cd there instead before unzipping.
		</para>
		<para>
		Restart <application>Xiphos</application> after installing such a module, so that a fresh instance of the program can
		notice the new module in place.
		</para>
	</sect2>

  </sect1>

  <!-- Searching -->
  <sect1 id="search">
    <title>The Search Function</title>
    <!-- ============= Search  ============--> 

	<sect2 id="xiphos-searchpane">
		<title>Simple Searches</title>
		<para>
		To conduct a quick search within the current Bible or commentary module, the Search Bar in the Sidebar should usually be
		adequate. Click either in the menu bar
		<menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Search</guimenuitem></menuchoice> or in the Sidebar
		<menuchoice><guisubmenu>Modules</guisubmenu><guimenuitem>Search</guimenuitem></menuchoice> to access it.  </para>
	
		<figure>
		<title>The Search Bar</title>
                       <screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/interface_searchpane.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/interface_searchpane.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Search Bar</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                       </screenshot>

                </figure>
              <para>
		The <interface>Search Dialog</interface> consists of the following parts:
		</para>
			<itemizedlist>
				<listitem>
					<para>
					Search Key Entry box
					</para>
				</listitem>
				<listitem>
					<para>
					Search Module Selector
					</para>
				</listitem>
				<listitem>
					<para>
					Search Type Selector
					</para>
				</listitem>
				<listitem>
					<para>
					Search Options Checkbox
					</para>
				</listitem>
				<listitem>
					<para>
					Search Scope Selector
					</para>
				</listitem>
				<listitem>
					<para>
					Search Results View
					</para>
				</listitem>
			</itemizedlist>			
		<sect3 id="xiphos-search-key">
			<title>Search Key Entry Box</title>
			<para>Allows entry of the key for which you would like to search. The 
			search key can be a word, part of a word, several words, a phrase, or 
			a regular expression depending on the type of search selected. When 
			the search key is entered and all other selections in the search dialog 
			are complete, click the <guibutton>Find</guibutton> button to begin 
			the search.
			</para>
			<para>
			This search uses the optimized search method (see next section) if
			the module has previously been indexed, and will use AND semantics by default 
			(matched verses contain all words you entered).
			</para>
			</sect3>
		
		<sect3 id="xiphos-search-modselect">
			<title>Search Module Selector</title>
			<para>Allows selection of which modules	you would like to search. 
			Select <guibutton>Bible</guibutton> to search Bible versions or 
			<guibutton>Commentary</guibutton> to search commentaries. Only 
			the currently active module will be searched.</para>
		</sect3>
		
		<sect3 id="xiphos-search-typeselect">
		<title>Search Type Selector</title>
		<para>Allows selection of the type of search. There are three search
		types available:
		</para>
			<variablelist>
				<varlistentry>
					<term><guibutton>Multi word</guibutton></term> 
					<listitem><para>This type will match any verse that has 
					all the words in the search key, regardless of where 
					they appear in the verse.  By default, "lucene" fast search
                                        will be used, with fallback to the slower plain version of
                                        multi-word search in the absence of an index.</para></listitem>
				</varlistentry>
				<varlistentry>
					<term><guibutton>Regular expression</guibutton></term> 
					<listitem><para>This search uses a regular expression
					as a search key. A regular expression is a pattern used 
					to match a string of text. A regular expression can be 
					used to find verses with words that match a particular 
					pattern. For example the regular expression
					<userinput>[a-z]*iah </userinput> will match verses that contain
					the words Aiah, Ahaziah, Athaliah and Amariah.</para>
					<para>A complete discussion of regular expressions is 
					beyond the scope of this manual, but more information 
					can be found in the grep man page.</para></listitem>
				</varlistentry>
				<varlistentry>
					<term><guibutton>Exact phrase</guibutton></term> 
					<listitem><para>This type will match the search key
					exatly as entered. If the search key is <userinput>
					it is good</userinput>, this search would match a verse
					which contains "<emphasis>it is good</emphasis>," but 
					would not match a verse	which contains "<emphasis>
					good</emphasis>, and doeth <emphasis>it</emphasis> not, 
					to him it <emphasis>is</emphasis> sin."</para></listitem>
				</varlistentry>
			</variablelist>
 		</sect3>

		<sect3 id="xiphos-search-options">
			<title>Search Options Checkbox</title>
			<para>Allows selecting of search options. The only available option 
			is <guibutton>Match case</guibutton>. Check this box to make the 
			search case sensitive.</para>
		</sect3>
		
		<sect3 id="xiphos-search-scopeselect">
			<title>Search Scope Selector</title>
			<para>Allows defining the range within the specificed module that will
			be searched. There are three search scopes available:</para>
			<variablelist>
				<varlistentry>
					<term><guibutton>No scope</guibutton></term>
					<listitem><para>This button causes the search to
					to include the entire module.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guibutton>Use bounds</guibutton></term>
					<listitem><para>Selecting this button produces two dropdown
					selector boxes marked <guilabel>Lower</guilabel> and
					<guilabel>Upper</guilabel>. Select the first book
					to search in the <guilabel>Lower</guilabel> box and
					the last book to search in the <guilabel>Upper</guilabel>
					box. The search will begin with the <guilabel>Lower
					</guilabel> book and end with the <guilabel>Upper
					</guilabel> book and include all books in between.
					</para>
					<para>Chapter and verse numbers can be entered into
					the search bound boxes as well to further narrow the
					search. </para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term><guibutton>Last search</guibutton></term>
					<listitem><para>Select this button to do a new 
					search including only the verses returned as a 
					result of the last search. Use this with a new 
					search key to narrow the search further.</para>
					</listitem>
				</varlistentry>
			</variablelist> 
		</sect3>
		<sect3 id="xiphos-search-results">
			<title>Search Results View</title>
			<para>This shows a list of the current search results for previewing, navigation, or saving.</para>
			<variablelist>
				<varlistentry>
					<term>Preview</term>
					<listitem><para>To preview the search result, simply click on an individual result.
					The entry will show in the preview pane.
					</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>Navigation</term>
					<listitem><para>Navigation to the search result can be done in two ways. To open the result
					in a new tab, middle-click the mouse. To open the result in the current tab, double-click the result.
					</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term>Save Results</term>
					<listitem><para>You may save your results as a list of bookmarks. To do this, right-click and select
					<guilabel>Save List</guilabel>. You will be prompted to enter a name for the folder that your results
					will be saved to. After you have saved the results, you may view them by going to your bookmarks and
					finding the folder you just named.
					</para>
					</listitem>
				</varlistentry>
			</variablelist>
	</sect3>
	</sect2>
	<sect2 id="xiphos-advanced-search">
	   <title>Advanced Searches</title> 
	   <para>
		More complicated searches might require the use of the advanced search functions, found under
		<menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Advanced Search</guimenuitem></menuchoice>.
	   </para>
	 
	  <figure>
	  <title>The Advanced Search Dialogue</title>
	  <screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/search_search.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/search_search.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Advanced Search  Dialog</phrase> 
	    </textobject> 
	  </mediaobject> 
	
          </screenshot>	

          </figure>
           
	   <para>
		In <guimenuitem>Advanced Search</guimenuitem>, much more complex queries can be constructed, involving custom search ranges,
		custom lists of modules over which to search, regular expression matching (see next section), and attribute-based searches
		such as are found in footnotes or Strong's Hebrew and Greek dictionary references.
	   </para>

	   <para>
                The default search uses "lucene" fast searching.  It is an optimized search requiring a pre-built index; see the
                <guilabel>Module Manager's</guilabel> Maintenance page for index creation.  In the absence of an index, fallback to the
                slower, plain multi-word search will be done, or can be selected deliberately here.  A web search will provide several
                references to the syntax needed to put to use the power of optimized Lucene search. A few examples follow:
	   </para>
	   
	   <para>
		Simple Searches: just type in the words you want to search for. To return only verses that include all of the words,
		prefix the word with "+". So, in the KJV, you could find Psalm 23 by searching for "+Lord +shepherd +want". To search for
		an entire phrase, surround the entire phrase with quotes, like "maketh me to lie down" (note that quotes are unnecessary
		in all of the other examples).
	   </para>
	   
	   <para>
		Single Letter Wildcard: to search for "veil" or "vail", use this syntax "v?il". The "?" represents a single character
		that could be anything. A more complex example returns both spellings for Isaiah used in the KJV. "?saia?" will return
		results for "Isaiah" and "Esaias".
	   </para>

	   <para>
		Multiple Letter Wildcard: to search for "prophet" or "prophesy" or "prophecy" or "prophesied", use this syntax "prophe*".
	   </para>

	  <para>
		AND syntax: in the advanced search to return results for all of the search terms, you must put "AND" in between the terms.
		To continue our example, if we wish to search for any occurrence of Isaiah or Esaias that also mention either prophet, or
		prophecy, or prophesy, we can do a search like this: "?saia? AND prophe*". 
	  </para>

	   <para>
		By default, two standard search ranges are defined, for Old and New Testament; you may wish to define others for
		e.g. "Gospels" or "Paul's Epistles". One custom module list containing only the first Bible found will be present.
		If desired, new searches can be performed across only the current results of the previous search.  Any modules may be
		searched, including general books and even dictionaries, in any combination.
	   </para>

	   <para>
		Note the tooltip in the screenshot above, for Attributes search.  This qualifier is used to perform searches on attributes
		that are carried with verses, instead of verse content proper, such as footnote content or Strong's Hebrew and Greek
		references.  If this button is selected, specific attribute qualifiers must be made in the Attribute Search tab, at the
		right end of the tab set.  Strong's references are identified with a leading "H" or "G" and the numeric Strong's identifier.
		Thus, a search of KJV for Strong's Greek #140, using "G140", will return the single result of Matthew 12:18.
	   </para>
		
	   <para>
		If you have indexed your modules, there is a much faster way to search for Strong's references. Enter your search preceded by 
		"lemma:", so to search for Strong's Greek #140, enter "lemma:G140". You must have selected <guibutton>Optimized ("Lucene")</guibutton>
		for this to work.
	  </para>

	   <para>
		Explanations of search syntax are available when either Optimized or Attribute search is selected.
	   </para>

	   <para>
		The "Find" button also stops an in-progress search, as its tooltip indicates.
	   </para>

	   <para>
		Results will show in the <guibutton>Results</guibutton> tab. If you wish to show Strongs, Morphology, or Footnote tags,
		make those selections on the <guibutton>Attributes Search</guibutton> tab. Clicking once on the result will show the result
		in the <guibutton>Advanced Search</guibutton> previewer. Hovering over Strongs, Morphology, Footnote, or Cross-reference
		tags will show the results in the main previewer. Double-clicking a result will cause the current tab to navigate to that
		result. This applies to search results in general books and commentaries as well, but note that the respective tab must
		be visible.
	   </para>

	   <warning>
	   	<para>
		 Changes to some of the settings (e.g. scope of search, searched modules, etc.) in Advanced Search will 	affect the simple search via the side pane but not vice versa.
		</para>
	   </warning>  
	   </sect2>

	<sect2 id="hdbk-op-search-dialog-text-regexp">
		<title>Search Syntax using Regular Expression</title>

		<para>
			Regular expression searches provide a way to do simple or complex searches for strings that match a pattern or set of patterns (branches) separated by vertical bars "|". While a pattern can be built to look for a word or phrase, a simple pattern that consists of a word does not look for only that word but for any place the string of letters that make that word are found. A search for "right" will return verses that contain the word "right", but also "<emphasis>right</emphasis>eous", "<emphasis>right</emphasis>eousness", "un<emphasis>right</emphasis>eous", "up<emphasis>right</emphasis>" and even "b<emphasis>right</emphasis>". A search for "hall not" is not a search for "hall" AND "not" but for the string "hall not" with a space between the second "l" and the "n". The search for "hall not" will find occurrences of "s<emphasis>hall not</emphasis>".
		</para>
		<para>
			The power of Regular Expressions is in the patterns (or templates) used to define a search. A pattern consists of
ordinary characters and some special characters that are used and interpreted by a set of rules. Special characters include
.\[^*$?+. Ordinary (or simple) characters are any characters that are not special. The backslash, "\", is used to convert special characters to ordinary and ordinary characters to special.
		 </para>
		<para>
			Example: the pattern "<emphasis>i. love\.</emphasis>" will find sentences that end with "h<emphasis>i</emphasis>s <emphasis>love</emphasis>" or "<emphasis>i</emphasis>n <emphasis>love</emphasis>" or "<emphasis>i</emphasis>s <emphasis>love</emphasis>" followed by
a period. The first period in "i. love\." is a special character that means allow any character in this position. The
backslash in "i. love\." means that the period following it is not to be considered a special character, but is
an ordinary period. 
		</para>

		<sect3 id="hdbk-op-search-dialog-text-regexp-rules">
			<title>Rules for Regular Expression Search Requests</title>
			<itemizedlist>
<listitem><para>. The period matches any character.</para></listitem>
<listitem><para>* The asterisk matches 0 or more characters of the
	preceding: set, character or indicated character.</para></listitem>
<listitem><para>+ The plus sign matches 1 or more characters of the
	preceding: set, character or indicated character.</para></listitem>
<listitem><para>? The question mark matches 0 or 1 character of the
	preceding: set, character or indicated character.</para></listitem>
<listitem><para>[ ] Square brackets match any one of the characters
	specified inside [ ].</para></listitem>
<listitem><para>^ A caret as the first character inside [ ] means NOT.</para></listitem>
<listitem><para>^ A caret beginning a pattern anchors the beginning of a
	line.</para></listitem>
<listitem><para>$ A dollar at the end of a pattern anchors the end of a
	line.</para></listitem>
<listitem><para>| A vertical bar means logical OR.</para></listitem>
<listitem><para>( ) Parentheses enclose expressions for grouping.
<emphasis>Not supported!</emphasis></para></listitem>
<listitem><para>\ A backslash can be used prior to any special character
	to match that character.</para></listitem>
<listitem><para>\ A backslash can be used prior to an ordinary character
	to make it a special character.</para></listitem>
</itemizedlist>

<sect4 id="period">
<title>The Period</title>

<para>The Period "." will match any single character even
a space or other non-alphabet character.
<emphasis>s.t</emphasis> matches <emphasis>s</emphasis>i<emphasis>t</emphasis>,
<emphasis>s</emphasis>e<emphasis>t</emphasis>,<emphasis> s</emphasis>o<emphasis>t</emphasis>,
etc., which could be located in <emphasis>s</emphasis>i<emphasis>t</emphasis>ting,
compas<emphasis>s</emphasis>e<emphasis>t</emphasis>h and <emphasis>s</emphasis>o<emphasis>t</emphasis>tish
<emphasis>b..t</emphasis> matches <emphasis>b</emphasis>oo<emphasis>t</emphasis>,
<emphasis>b</emphasis>oa<emphasis>t</emphasis> and <emphasis>b</emphasis>ea<emphasis>t
foot.tool </emphasis>matches <emphasis>foot</emphasis>s<emphasis>tool </emphasis>and
<emphasis>foot tool</emphasis></para>
</sect4>


<sect4 id="asterisk">
<title>The Asterisk</title>

<para>The asterisk "*" matches zero or more characters of the preceding:
set, character or indicated character. Using
a period asterisk combination ".*" after a commonly
found pattern can cause the search to take a very long time,
making the program seem to freeze.
<emphasis>be*n</emphasis> matches<emphasis> beeen, been, ben</emphasis>,
and <emphasis>bn</emphasis> which could locate Reu<emphasis>ben</emphasis>
and She<emphasis>bn</emphasis>a.</para>
</sect4>


<sect4 id="plus">
<title>The Plus Sign</title>
<para>The Plus Sign "+" matches one or more characters of the preceding:
set, character or indicated character. Using
a period and plus sign combination ".+" after a
commonly found pattern can cause the search to take a very long
time, making the program seem to freeze.
<emphasis>be+n</emphasis> matches <emphasis>beeen, been</emphasis> and <emphasis>ben</emphasis>,
but not <emphasis>bn</emphasis>.</para>
</sect4>


<sect4 id="question">
<title>The Question Mark</title>
<para>The Question Mark "?"matches zero or one character of the
preceding: set, character or indicated character.
<emphasis>be?n</emphasis> matches <emphasis>ben</emphasis> and <emphasis>bn</emphasis>
but not <emphasis>been</emphasis>.
<emphasis>trees?</emphasis> matches <emphasis>trees</emphasis> or <emphasis>tree</emphasis>.</para>
</sect4>


<sect4 id="bracket">
<title>The Square Brackets </title>
<para>The Square Brackets "[]" enclose a set of characters that can
match. The period, asterisk, plus sign and question mark are not
special inside the brackets. A minus sign can be used to indicate
a range. If you want a caret "^" to be part of the
range do not place it first after the left bracket or it will be
a special character. To include a "]" in the set make
it the first (or second after a special "^") character
in the set. To include a minus sign in the set make it the first
(or second after a special "^") or last character in
the set.
<emphasis>s[eia]t</emphasis> matches <emphasis>set</emphasis>, <emphasis>sit</emphasis>,
and <emphasis>sat</emphasis>, but not <emphasis>s</emphasis>o<emphasis>t</emphasis>.
<emphasis>s[eia]+t </emphasis>matches as above but also, <emphasis>seat,
seet, siet</emphasis>, etc.
<emphasis>[a-d]</emphasis> matches <emphasis>a, b, c,</emphasis> or <emphasis>d</emphasis>.
<emphasis>[A-Z]</emphasis> matches any uppercase letter.
[.;:?!] matches ., ;, :, ?, or ! but not a comma.
[ ]^-] matches ] or ^ or -</para>
</sect4>


<sect4 id="caret">
<title>The Caret first in Square Brackets </title>
<para>If the Caret is the first character after the left bracket ("[^") it
means NOT.
<emphasis>s[^io]t</emphasis> matches <emphasis>set, sat</emphasis>, etc.,
but not <emphasis>s</emphasis>i<emphasis>t</emphasis> and <emphasis>s</emphasis>o<emphasis>t</emphasis>.</para>
</sect4>

<sect4 id="caret-s">
<title>The Caret as Start of Line Anchor </title>
<para>If the Caret is the first character in a pattern ("^xxx") it anchors
the pattern to the start of a line. Any match must be at the
beginning of a line. Because of unfiltered
formatting characters in some texts, this feature does not always
work, but may if a few periods are placed after the caret to
account for the formatting characters.
<emphasis>^In the beginning</emphasis> matches lines that
start with "<emphasis>In the beginning</emphasis>".
(May need to use: <emphasis>^.....In the beginning</emphasis>)</para>
</sect4>


<sect4 id="dollar">
<title>The Dollar Sign as End of Line Anchor </title>
<para>If the Dollar Sign is the last character ("xxx$") in a pattern it
anchors the pattern to the end of a line. Any match must be at
the end of a line. Because of unfiltered
formatting characters in some texts, this feature does not always
work, but may if a few periods are placed before the dollar sign
to account for the formatting characters.
<emphasis>Amen\.$</emphasis> matches lines that end with
"<emphasis>Amen.</emphasis>" (May
need to use Amen\....$, Amen\..........$, or even
Amen\....................$)</para>
</sect4>


<sect4 id="bar">
<title>The Vertical Bar </title>
<para>The Vertical Bar "|" between patterns means OR.
<emphasis>John|Peter</emphasis> matches <emphasis>John</emphasis> or <emphasis>Peter.
John .*Peter|Peter .*John</emphasis> matches <emphasis>John</emphasis>
... <emphasis>Peter</emphasis> or <emphasis>Peter</emphasis> ... <emphasis>John</emphasis>.
(.* slows a search)
<emphasis>pain|suffering|sorrow</emphasis> matches <emphasis>pain</emphasis>,
or <emphasis>suffering</emphasis>, or <emphasis>sorrow</emphasis>.</para>
</sect4>


<sect4 id="parenth">
<title>The Parentheses</title>
<para><emphasis>The use of Parentheses "( )" is
not supported!</emphasis></para>
</sect4>


<sect4 id="backslash">
<title>The Backslash Prior to a Special Character</title>
<para>The Backslash prior to a special character ("\*") indicates that the
character is not being used in its special meaning, but is just
to match itself.
<emphasis>amen\.</emphasis> matches <emphasis>amen.</emphasis> but not <emphasis>amen</emphasis>t
and will not locate firm<emphasis>amen</emphasis>t.</para>
</sect4>

<sect4 id="backslash-o">
<title>The Backslash Prior to an Ordinary Character </title>

<para>The Backslash prior to an ordinary character ("\o") indicates that
the character is not being used to match itself, but has special
meaning.</para>

<itemizedlist>
<listitem><para>
\b if use outside [ ] means word boundary. If used inside [ ] means backspace.
<emphasis>\brighteous\b</emphasis> matches <emphasis>righteous</emphasis> but
not un<emphasis>righteous</emphasis> or <emphasis>righteous</emphasis>ness</para></listitem>
<listitem><para>\B means non-word boundary.  <emphasis>\Brighteous\B</emphasis>
matches un<emphasis>righteous</emphasis>ness and un<emphasis>righteous</emphasis>ly
but not <emphasis>righteous</emphasis>, un<emphasis>righteous</emphasis> or <emphasis>
righteous</emphasis>ness.</para></listitem>
<listitem><para>\d means digit; same as [0-9].</para></listitem>
<listitem><para>\D means non-digit, same as [^0-9].</para></listitem>
<listitem><para>\s means space. </para></listitem>
<listitem><para>\S means not a space. </para></listitem>
<listitem><para>\w means alphanumeric; same as [a-zA-Z0-9_].</para></listitem>
<listitem><para>\W means not alphanumeric; same as [^a-zA-Z0-9_].</para></listitem>
</itemizedlist>
</sect4>
</sect3>
</sect2>


  </sect1>

  <!-- Studypad -->
  <sect1 id="studypad">
    <title>The Studypad</title>
    
<!-- ============= The Studypad ============================= -->
    <sect2 id="xiphos-studypad">
		<title>Using The Studypad</title>
		<para>
		The Studypad can be opened by choosing <menuchoice><guisubmenu>File</guisubmenu><guimenuitem>Open StudyPad</guimenuitem></menuchoice>
		</para>
		<para>
		This is what the Studypad typically looks like:
		</para>
		<figure>
			<title>The Studypad</title>
			<screenshot> 
	  <mediaobject> 
	    <imageobject><imagedata fileref="figures/studypad.png" format="PNG"/> 
	    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/studypad.eps" format="EPS"/>
    		    </imageobject>
	    -->
	    <textobject> 
	      <phrase>The Studypad</phrase> 
	    </textobject> 
	  </mediaobject> 
	
                        </screenshot>

                </figure>
                                        
		<para> The Studypad will save into your working directory, making it useful for collecting and exporting information and Bible study material from Xiphos into other programmes.</para>
		<para> Toolbar 1</para>
			        	<itemizedlist>
			     		<listitem><para>Font Size and Environment</para></listitem>
			     		<listitem><para>Font Type</para></listitem>
			     		<listitem><para>Bold, Italics, Underscored, Crossed Out</para></listitem>
			     		<listitem><para>Left, Centre and Right  Bound</para></listitem>
			     		<listitem><para>Shift Paragraph Right or Left</para></listitem>
			     		<listitem><para>Colour Selector</para></listitem>
			     		</itemizedlist>
		<para> Toolbar 2</para>
			        	<itemizedlist>
			        	<listitem><para>New, Save, Delete and Print</para></listitem>
			        	<listitem><para>Cut, Copy, Paste and Undo</para></listitem>
			        	<listitem><para>Find and 'Find and Replace'</para></listitem>
			        	<listitem><para>Spellcheck</para></listitem>
			        	</itemizedlist>

	        <para>
		In order for spellcheck to be available, one of the languages under
		<menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Current languages</guimenuitem></menuchoice> must be set.
	        </para>

	</sect2>


  </sect1>

  <!-- Personal Commentary -->
  <sect1 id="personal">
    <title>The Personal Commentary</title>
    <!-- Personal Commentary-->

		<para>
		To build up a personal commentary you will need to install the
		editable 'Personal' sword module from the English Commentaries
		section. Right click it and choose
		<menuchoice><guisubmenu>Edit</guisubmenu><guisubmenu>Note</guisubmenu><guimenuitem>Personal</guimenuitem></menuchoice>
		in the menu.
		</para>

		<para>
		An editor window similar to the
		<guimenuitem>Study Pad</guimenuitem>
		will appear. Edit your comment and save it; in the future it will
		appear as your comment to the relevant verse.
		</para>
		<figure>
    		<title>The Personal Commentary Editor </title>
     		<screenshot> 
		  <mediaobject> 
		    <imageobject><imagedata fileref="figures/personal.png" format="PNG"/>
		    </imageobject>
	    <!-- EPS versions of the figures are not required at the moment. -->
            <!-- 
		    <imageobject>
      		<imagedata fileref="figures/personal.eps" format="EPS"/>
    		    </imageobject>
	    -->
		    <textobject> 
		      <phrase>The Personal Commentary</phrase> 
		    </textobject> 
		  </mediaobject> 
	        </screenshot>
	        </figure>

	        <para>
		Locationbar
		</para>
	        	<itemizedlist>
	        	<listitem><para> Synchronise Button</para></listitem>
	        	<listitem><para>Bible Book, Chapter and Verse Selectors</para></listitem>
	        	<listitem><para>Location Summary</para></listitem>
	        	</itemizedlist>

	        <para>
		Use the <guimenuitem>Synchronise Button</guimenuitem> to
		quickly change location of your editor to that of the
		underlying Bibletext or use the
		<guimenuitem>Book</guimenuitem>,
		<guimenuitem>Chapter</guimenuitem>, and
		<guimenuitem>Verse</guimenuitem>
		selectors to choose to edit your comment to one particular
		verse.
		</para>

		<para>Toolbar 1</para>
	        	<itemizedlist>
	     		<listitem><para>Font Size and Environment</para></listitem>
	     		<listitem><para>Font Type</para></listitem>
	     		<listitem><para>Bold, Italics, Underscored, Crossed Out</para></listitem>
	     		<listitem><para>Left, Centre and Right  Bound</para></listitem>
	     		<listitem><para>Shift Paragraph Right or Left</para></listitem>
	     		<listitem><para>Colour Selector</para></listitem>
	     		</itemizedlist>
	        <para>Toolbar 2</para>
	        	<itemizedlist>
	        	<listitem><para>Save, Delete and Print</para></listitem>
	        	<listitem><para>Cut, Copy, Paste and Undo</para></listitem>
	        	<listitem><para>Find and 'Find and Replace'</para></listitem>
	        	<listitem><para>Spellcheck</para></listitem>
	        	</itemizedlist>

	        <para>
		In order for spellcheck to be available, one of the languages
		under <menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Current
                languages</guimenuitem></menuchoice> must be set.
	        </para>

	        <para>
		To create a link to other verses right click the text and
		choose <guimenuitem>Link..</guimenuitem>. In the pop-up window
		enter the link location and the module linked to.
		</para>

		<para>
		It is possible to rename a personal commentary to suit a
		particular subject of study for that commentary.  Thus,
		multiple personal commentaries may be installed: Rename the
		existing personal commentary, and then re-install another
		instance of the personal commentary if desired.  Personal
		commentary names can consist only of letters and digits, and
		cannot duplicate an existing module's name.  Rename is
		accessible off the right-click menu.
		</para>

		<para>
		If the study embodied in a particular personal commentary is
		no longer needed, archival is available in the module manager,
		prior to removal, for possible future re-installation.  See
		the module manager's Remove/Archive page.  Any module may be
		archived, not just personal commentaries.
		</para>

		<para>
		Although there are 31,102 verses in standard versification, it
		is unlikely that more than a tiny fraction of all verses will
		have personal commentary attached to them.  A verse list
		showing where personal commentary notes exist is available
		from <menuchoice><guisubmenu>Right Click</guisubmenu><guimenuitem>
		Dump Pers.Comm.</guimenuitem></menuchoice>.
		</para>
			        
	        <tip>
        	<para>
		The created commentary page will be attached to an individual
		verse only. To write commentary pages from within
		Xiphos, attached to longer stretches of text use the
		<guimenuitem>Link..</guimenuitem> function to link several
		pages together
		</para>
		</tip>

  </sect1>

  <!-- Journals and Prayer Lists -->
  <sect1 id="journals">
    <title>Journals and Prayer Lists</title>
    <!-- Journals and Prayer Lists -->

		<para>
		<application>Xiphos</application> supports
		user-created and -editable modules to contain general
		content.  Initially conceived as simple prayer lists,
		they have expanded to include daily journals and
		topic-outline content.  The user can maintain prayer
		lists, or prepare sermons, or write any structured
		content desired.
		</para>

		<para>
		To enable prayer list and journal support, see the
		Preferences dialog as previously described.  There, in
                <menuchoice><guisubmenu>General</guisubmenu><guimenuitem>
		Options</guimenuitem></menuchoice>, check the
		item labeled
		<guimenuitem>Enable Prayer Lists</guimenuitem>.
		You will see a new item appear at the bottom of the
		sidebar's module list for "Prayer Lists/Journals".
		</para>

		<para>
		Right-click on this entry, and you will be offered a
		context menu to create new modules.  All the offered
		options are of the same type, but what is offered is a
		variety of templates from which to work.  There are 5
		templates at this time.
		</para>

		<figure>
    		<title>Creating a journal or prayer list</title>
     		<screenshot> 
		  <mediaobject> 
		    <imageobject><imagedata fileref="figures/journal.png" format="PNG"/>
		    </imageobject>
		    <textobject> 
		      <phrase>New journal or prayer list</phrase> 
		    </textobject> 
		  </mediaobject> 
	        </screenshot>
	        </figure>

		<para>
		Their structure is the same, but the offered templates
		provide a variety of hints regarding ways to organize
		content.  <guimenuitem>Simple</guimenuitem> is
		trivial, and can be considered a mental Post-It
		note.  <guimenuitem>Subject</guimenuitem> is useful as
		a more organized version.
		<guimenuitem>Monthly</guimenuitem> provides a
		per-month structure in which to track needed content.
		<guimenuitem>Daily Journal</guimenuitem> is a full
		365-day calendar in which to track a personal journal
		or ongoing prayer needs.  And finally,
		<guimenuitem>Outlined Topic</guimenuitem> is a full,
		expandable outline suitable for topics and subtopics.
		</para>

		<para>
		Journals and prayer lists have the structure of a
		general book: If simply selected for display from the
		module list, they will appear in the usual subwindow
		for general books.
		</para>

		<para>
		Editing a journal or prayer list is done by
		right-clicking the module name to get its context
		menu, whose middle item is <guimenuitem>Open in
		Editor</guimenuitem>.  The sections and subsections
		will be listed in the left margin.  Click one, and the
		editor navigates to that section.  The context menu on
		right-click of section keys provides for adding,
		deleting, and editing the names of sections and
		subsections.
		</para>

		<para>
		If the general book subwindow is currently displaying
		the journal or prayer list being edited, it will
		synchronize with new content when
		<guimenuitem>Save</guimenuitem> is used.
		</para>

		<para>
		As mentioned, these user-edited modules are in effect
		general books.  This means they can be viewed in any
		Sword Project application.  Thus, you can use these
		modules immediately in
		<application>BibleTime</application>, for example; or
		from the Module Manager's
		<guimenuitem>Maintenance</guimenuitem> page, you can
		archive a zip file to copy to a Windows system where
		you can then install the zip content as a module for
		the Windows user interface.  Few other Sword Project
		applications provide for editing these modules,
		however, meaning that they will appear in such other
		applications as just ordinary general books.
		</para>

		<para>
		In the future, it is planned that a module sharing
		facility will become available, by which user-edited
		modules such as these can be uploaded to become
		available to a wide audience.  The current install
		repository facility will be expanded to provide upload
		as well as the existing download capability in order
		to support this.  Thus, users will be able to share
		their sermons, Bible studies, and other
		personally-authored content with other Sword
		application users.
		</para>

  </sect1>

  <!-- Getting Help Online -->
  <sect1 id="onlinehelp">
    <title>Getting Help Online</title>
    <!-- ============= Online Help  ============--> 

	<sect2 id="xiphos-mailing-list">
		<title>Users Mailing List</title>
		<para>One way you can get help with Xiphos is using our low-traffic users' mailing list.
		You can sign up by clicking <ulink url="https://lists.sourceforge.net/lists/listinfo/gnomesword-users/">
		this link</ulink>. Once you are signed up, you can email the list with any problems you are having
		and other users or the developers will respond, typically within a day.
		</para>
	</sect2>
 
	<sect2 id="xiphos-live-chat">
		<title>Live Chat</title>
		<para>Another way to get help is with online chat. Xiphos has an IRC channel on freenode, #xiphos.
		If you don't know what that means, it's ok. Just click <ulink url="http://webchat.freenode.net/?randomnick=1&amp;channels=xiphos&amp;prompt=1">this link</ulink> (it will open your web browser), type a nickname or accept the default, and click "Click to join chatroom".
		This will take you to a chatroom where the developers and other users are available to help you with issues
		you may be having. Although many times someone will answer your question immediately, sometimes you may
		have to wait a few minutes or longer.
		</para>
	</sect2>

  </sect1>

  <!-- Original Language Research -->
  <sect1 id="originallanguage">
     <title>Original Language Research</title>
     <!-- ============= Original Language Research  ============--> 

	<sect2 id="orig-lang-install-modules">
		<title>Installing Needed Modules</title>
		<para>Xiphos is ideally suited for studying the original Greek and Hebrew. 
		To get started, you will want the following modules:
		</para>
		<para>
		From Crosswire Repository:
		</para>
    		<itemizedlist>
			<listitem>
				<para>
        			StrongsHebrew Dictionary (or get StrongsRealHebrew from the Xiphos Repository)
				</para>
			</listitem>
			<listitem>
				<para>
        			StrongsGreek Dictionary (or get StrongsRealGreek from the Xiphos Repository)
				</para>
			</listitem>
			<listitem>
				<para>
				Robinson Dictionary
				</para>
			</listitem>
			<listitem>
				<para>
				KJV Bible
				</para>
			</listitem>
		</itemizedlist>
		<para>
		From Xiphos Repository:
		</para>
		<itemizedlist>
			<listitem>
				<para>
				StrongsRealGreek Dictionary (same as StrongsGreek, but with Greek characters, B-Greek transliteration, and self-referencing links)
				</para>
			</listitem>
			<listitem>
				<para>
				StrongsRealHebrew Dictionary (same as StrongsHebrew, but with Hebrew characters and self-referencing links)
				</para>
			</listitem>
			<listitem>
				<para>
				InvertedStrongsRealGreek (key in or copy actual Greek word, rather than number)
				</para>
			</listitem>
		</itemizedlist>
	</sect2>

	<sect2 id="orig-lang-setup">
	 	<title>Setting Up</title>
		<para>While still in the module manager, create indexes for all of the modules you just installed. 
		Then close the module manager and open <menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>
		Preferences</guimenuitem></menuchoice> and go to <menuchoice><guisubmenu>Modules</guisubmenu>
		<guimenuitem>Misc</guimenuitem></menuchoice>. Set your Hebrew and Greek lexicons according to what you installed.
		Close preferences and open the KJV module. Turn on the module options <menuchoice>
		<guisubmenu>Right Click</guisubmenu><guisubmenu>Module Options</guisubmenu><guimenuitem>Show Strongs
		</guimenuitem></menuchoice> and <menuchoice><guisubmenu>Right Click</guisubmenu><guisubmenu>Module Options
		</guisubmenu><guimenuitem>Show Morphology</guimenuitem></menuchoice>. You should see the Bible text
		change to show Strongs numbers underneath the appropriate English words. Hover over the numbers 
		(or letters for morphology) with the mouse and you will see the definition displayed in the previewer pane. 
		Click on the link and the definition will show in the dictionary pane. If you are using StrongsRealGreek or
		StrongsRealHebrew, you can click on any other number referenced in the definition and you will be taken to that entry.
		</para>
	</sect2>

	<sect2 id="orig-lang-search">
		<title>Searching for Strongs Numbers</title>
		<para>Choose <menuchoice><guisubmenu>Edit</guisubmenu><guimenuitem>Advanced Search</guimenuitem></menuchoice>or press
		<keycap>F3</keycap>. Under <interface>Search Type</interface>, select <guibutton>Optimized ("Lucene")</guibutton>.
		Click on the <interface>Attribute Search</interface> tab, and make check the box that says <guibutton>
		Strongs Numbers</guibutton>. Now click in the entry field at the top and search for the number you are looking for
		preceded by "lemma:" and "G" for Greek or "H" for Hebrew. So to look for the Hebrew word tsad-deek (6662), enter 
		"lemma:H6662". Once the search is done, the results pane will be shown. Notice that when you click on a result, 
		it will show the result in the preview pane, and the strong's numbers will show as well, following immediately 
		after the words they match. Also note that hovering over these numbers will show the definition in the main preview pane.
		</para>
	</sect2>
	
	<sect2 id="orig-lang-additional">
		<title>Additional Modules</title>
		<para>For more advanced research, the following modules are also available:</para>

		<itemizedlist>
			<listitem>
				<para>   
    				2TGreek (Xiphos Repository) : This module contains the entire Bible in Greek. It combines the LXX
				and Tischendorf8 NT into one easy-to-use module. In addition, it contains Strongs, Morphology,Greek Accents,
				and primary/secondary readings. As with all modules that include Strongs, Xiphos displays 2TGreek in 
				beautiful interlinear form.
				</para>
			</listitem>
			<listitem>
				<para>
   				Elzevir Textus Receptus (Crosswire Beta Repository as of this writing) : 1624 edition with Strongs and Morphology
				</para>
			</listitem>
			<listitem>
				<para>
				LXX (Crosswire Repository) : the Septuagint with Strongs, Morphology, and footnotes
				</para>
			</listitem>
			<listitem>
				<para>
				MorphGNT (Crosswire Beta Repository as of this writing) : This is derived from the morphologically parsed GNT
				provided by UPenn's CCAT. It was reformatted and error-corrected by James Tauber. It includes Greek accents
				and Morphology.
				</para>
			</listitem>
			<listitem>
				<para>
				TR (Crosswire Repository) : This is the Textus Receptus with Strongs and Morphology
				</para>
			</listitem>
			<listitem>
				<para>
				TischMorph (Xiphos Repository) : As described above, this has Strongs, Morphology, accents, and alternate readings.
				</para>
			</listitem>
			<listitem>
				<para>
				WHNU (Crosswire Repository) : Westcott-Hort of 1881 with Strongs and Morphology
				</para>
			</listitem>
			<listitem>
				<para>
				GreekHebrew (Crosswire Repository) : This is a dictionary keyed to Strongs. It contains words in the LXX 
				that are also found in the New Testament. In addition, it contains the equivalent Hebrew words also keyed
				to Strongs.
				</para>
			</listitem>
			<listitem>
				<para>
				Didache (Crosswire Beta Repository as of this writing) : This is an early Christian treatise in Greek dated
				to the late first or early second century. It includes Strongs, Morphology, and Greek accents.
				</para>
			</listitem>
		</itemizedlist>
	</sect2>


  </sect1>

</article>
