# GnomeSword2 Manual

Gnomesword is an application to aid in study of the Bible.

2003
2007
The GnomeSword Team
The GnomeSword Team

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS distributed with this manual.

This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the license to the manual, as described in section 6 of the license.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.

DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE WITH THE FURTHER UNDERSTANDING THAT:

1. 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

2. 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.

Andy
Piper
Pierre
Benz
Dr Peter
von Kaehne
Karl
Kleinpaste
GnomeSword Manual 2.2.2
February 2007
This manual describes version 2.2.2 of GnomeSword.

## Feedback

To report a bug or make a suggestion regarding the Gnomesword2 application or this manual, Use the Tracker on SourceForge or the mailing lists.

gnome
gnomesword
gnomesword2
sword
crosswire
help dialog

## Introduction

Gnomesword2 is a Bible study and research tool based upon the "SWORD Project" libraries and the GNOME Desktop libraries. You can use Gnomesword2 to do the following:

- View your favorite Scripture verse

- Make sermon or personal notes on selected passages

- Automatically follow Bible footnotes and cross-references

- Compare translations in parallel

- Work in original language study using the available Hebrew and Greek translations

Gnomesword2 aims to provide a simple and clean user interface whilst providing a powerful tool allowing a personalized Bible study environment.

### The SWORD Project logo

The SWORD Project logo

"The SWORD Project" is based at http://www.crosswire.org. Other applications under the same banner are The SWORD Project for Windows (aka BibleCS or WinSword), MacSword for the Macintosh, and BibleTime, another Linux program.

### GnomeSword in action

GnomeSword in action

Gnomesword2 is currently in development, so this manual may not reflect the program as you see it. If it does not, please file a bug at the project website, or email gnomesword-developers@lists.sourceforge.net. All help is appreciated, as it will improve the software.

## Getting Started with GnomeSword

### Starting GnomeSword

You can start GnomeSword in the following ways:

Applications menu

  Choose Accessories Gnomesword2 Bible Guide .

Command line

  Type `gnomesword2`, then press Return.

### Starting GnomeSword For The First Time

When you start GnomeSword for the first time, GnomeSword 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 GnomeSword asks permission to start the Module Manager so that you can select and install a Bible module in your language preference.

#### GnomeSword Download Question

Gnomesword Download Question

GnomeSword then opens its interface with one tab displayed, showing Romans 8:28. Once the interface is open, you can use EditPreferences to change any of the selections already made by default.

### Launching GnomeSword

When you start GnomeSword, the following interface is displayed:

#### GnomeSword interface

The Gnomesword Interface

The GnomeSword interface contains the following elements:

Menubar

  The menus on the menubar contain several commands which extend the use of GnomeSword . These include the StudyPad and advanced search functions. The menus also help you to customize your use of GnomeSword.

Toolbar

  The toolbar contains buttons that let you quickly navigate through the Bible.

Sidebar

  The Sidebar provides access to several features. It contains your bookmarks and the list of installed books. It can also be used to perform simple searches.

Bible Text Pane

  The Bible Text pane displays the Bible text which is currently being viewed.

Viewer

  The Viewer displays Bible text module options. These include Strong's numbers, footnotes and morphological tags. It is located below the Bible Text Pane.

Commentary Pane

  The Commentary pane displays commentaries on the current Bible Text being used.

Book Pane

  The Book Pane displays general books available from the Sword Project. These include modules like "Calvin's Institutes", "Josephus: The Complete Works" etc. This Pane can be accessed via the Book View tab just below the Commentary Pane.

Dictionary/Book Pane

  The Dictionary/Book Pane displays dictionary information on selected words in the Bible Text Pane. It is located just below the Commentary Pane

When you right-click in the different interface sections, the interface displays a popup menu, which provides access to more module-specific options, including printing services.

## Interface

### Menubar

At the top of the GnomeSword main window is the menubar. Almost all of the functions are available by activating the appropriate menu item. The functions have been grouped according to their type. For example, the file operations have been grouped into the File menu.

#### Menubar

GnomeSword menubar

### Toolbars

The function of the Toolbar is to provide control over the Bible Pane. 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.

#### ToolBar

The Toolbar

The Toolbar consists of the following functions:

- History View Toggle

- Bible Book Selector

- Bible Chapter Selector

- Bible Verse Selector

- Bible Passage Summary

#### History Forward/Backward Selector

Switches between current and previous passage selections.

#### Bible Book Selector

Selects the Biblical book to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

#### Bible Chapter Selector

Selects the Biblical chapter of current book to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

#### Bible Verse Selector

Selects the Biblical verse of current chapter to be displayed in the Bible Text Pane and Commentary Pane. Changes take immediate effect.

#### Bible Passage Summary

Allows manual editing of passages which are displayed in the Bible Text Pane and Commentary Pane. Changes take effect once Enter is typed.

Ensure that edited book,chapter and verse naming is correct, otherwise the wrong or no information will be displayed.

### The Sidebar

#### Sidepane

The Sidepane

On the left hand side of GnomeSword there is the Side Pane. Here the user can switch between the different Sword modules, view bookmarks, do simple searches and view verse lists. To switch between all Side Pane functions, shortcuts have been placed at the bottom of the Side Pane. Clicking on the shortcut activates the option.

#### Sidepane Shortcuts

Sidepane shortcuts

### The Bible Text Pane

#### The Bible Textpane

The Bible textpane

Positioned to the right of the Shortcut bar is the Bible text pane. All your different translations will be displayed for full viewing. When starting GnomeSword either your default Bible translation or the translation last used will be displayed.

#### Opening A Specific Bible Translation

In order to change the current Bible translation to another of your choice:

- right-click in the Bible Text Pane. In the popup menu choose FileOpen Module and select your specific translation that you want to view.

- under the Modules option in the Sidebar, choose Biblical Textslanguage choice and select your specific translation.

#### Using the Parallel View Mode

A nice function in GnomeSword is the ability to view your specified bible text in parallel in five translations of your choice. The Parallel View mode can be accessed by selecting Parallel View just below the Bible Text Pane, next to the Standard View tab. Please note that you can only view 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 (eg Westminster Leningrad Codex and Byzantine Majority Text ) will not be able to display books, chapters, or verses that they don't have.

##### Bible textpane - parallel view

Bible textpane - parallel view

Additionally, a separate Parallel View window can be selected from the right click menu with Detach/Attach. Your Bible pane will return to its normal single text view, and the new Parallel View window will show the complete chapter, in all 5 translations.

##### Parallel View - separate window

Parallel View - separate window

#### Opening A Separate Bible Translation

In order to view a Bible translation separate from the GnomeSword interface:

- Under the Modules option in the Sidebar,choose Biblical Textslanguage choice . Then right-click on your specific translation and choose the Open in dialog option.

#### Finding Out About The Current Translation

To find out about the Bible translation currently being displayed:

- right-click in the Bible Text pane. In the popup menu choose About module name.

#### Module Options

Most Bible translations have additional options which the user can select.

- Words Of Christ In Red

- Strong's Numbers

- Morphological Tags

- Footnotes

- Scripture Cross-Reference

- Headings

Translations in other languages such as Greek or Hebrew have specific options which deal only with the specific language.

In order to access these options:

- right-click in the Bible Text pane. In the popup menu (example shown), choose Module Options and select the specific option.

##### Module Options

Module Options

#### View Options

There are several additional modes that can be selected from the menubar's View pulldown.

##### View Options

View Options

- Verse Style - Toggles between Bible text display in separate verses, or in paragraphs instead. This is set on a per-module basis.

- Pin Tabs - When more than one tab is open, each one's verse is navigated separately in the disabled case. If tab pinning is enabled, then all tabs navigate together, keeping all translations on the same verse.

- Read Aloud - If you enable this, then GnomeSword will funnel all selected verses through the festival text-to-speech system. Festival is a widely-available TTS, often installed by default in Linux distributions.

  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.

- Show Verse Numbers - Normally enabled, this toggle can be disabled to prevent display of verse numbers within the text.

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

#### Specific Word Meanings

In order to check the meaning of a specific word, click on the desired word you wish to lookup. The word should then highlight itself and the explanation should be displayed, if available, in the Dictionary Pane.

#### Finding A Specific Word

To find a specific word within a passage:

- right-click in the Bible Text Pane. In the popup menu, choose Edit-> Find. A separate dialog will appear, which will allow single or multi word searches. Fill out dialog and click the Find button.

### Viewer Pane

#### Viewer Panel

Viewer Panel

The Viewer Pane is where the user sees Strong's numbers, morphological tags, footnotes, and cross-references that the Bible Text Pane provides.

Footnote content is normally transient in the Viewer Pane: It is displayed while your mouse hovers over the footnote indicator *n in the Bible text, and then disappears when your mouse moves off. But some translations' footnotes (e.g. NET Bible's) can be very large, so that not all the text is visible. To anchor the text so that you can scroll it in the Viewer Pane, middle-click the indicator and move to the Viewer Pane.

Cross-reference indicators *x also display transiently in the Viewer Pane. Left-clicking the indicator will send the set of references to the Verse List in the Sidebar, where you can click them individually for reading in the Viewer Pane.

### The Commentary Pane

#### The Commentary Pane

Commentary Pane

The Commentary pane is where the commentary modules are displayed. This provides easy reading, reference and access to different commentaries currently installed. The passage viewed by the Commentary pane is directly controlled by the current passage viewed in the Bible Text pane, so in order to change to a different passage commentary, select the desired passage on the Toolbar.

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. (This feature requires underlying Sword support beyond its 1.5.9 public release, at revision "SVN 2035" or later.)

By changing to passage settings on the Toolbar, the contents in the Bible Text pane and the Commentary Pane will be changed.

#### Finding Out About The Commentary Module

To find out about the commentary currently being displayed:

- right-click in the Commentary Pane. In the popup menu choose About module name.

#### Commentary Headings.

Most commentaries have additional headings which enable introductory information about the book and chapter currently being displayed in the Bible Text pane. In order to view them:

- right-click in the Commentary Pane. In the popup menu choose Display Book Heading or Display Chapter Heading.

### Dictionary Pane

#### The Dictionary Pane

The Dictionary Pane

### Keyboard Shortcuts

Several keyboard shortcuts exist in GnomeSword:

- Ctrl-L focuses and selects the main verse navbar text. You can then immediately type in new verse selection text, or the arrow keys can be used to select the spinners (left/right) and change them (up/down). Be aware that GnomeSword, as is the case with most Sword applications, understands many abbreviations: "G" is adequate to specify Genesis, for example, and any book name by itself implies 1:1.
- Alt-C brings the Commentary View forward when previously obscured by the Book View.
- Alt-G is the opposite of Alt-C, and the arrow keys can then drive the navbar buttons.

## Preferences

### Introduction To Preferences

#### The Preference Dialog

The Preferences Dialog

### Fonts And Colors

#### Setting Font Colors

##### Font Colour Settings

Font Colour Settings

#### Miscellaneous Font Settings

##### Miscellaneous Font Settings

Miscellaneous Font Settings

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

### General Settings

#### Tabs and Pane Settings

##### Tab and Pane Settings

Tab and Pane Settings

#### General Preferences and StudyPad directory

##### General Preferences and StudyPad directory

General Preferences and StudyPad directory

Verse style indicates that each verse should begin on a separate line, or (when disabled) that verses should be allowed to group in paragraphs, according to the Bible module's internal markup. Not all Bible modules have such markup.

With Scroll to Previous/Next Chapter enabled, using the mouse to scroll to the beginning or end of a chapter will cause GnomeSword to move automatically to the appropriate chapter.

If you enable Resize images, GnomeSword will automatically resize image content in commentaries, general books, and dictionaries so as to fit the subwindow which contains them.

Highlight current verse, if enabled, will cause GnomeSword 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 above).

### Module Settings

#### Main Module Settings

##### The Module Preferences Dialog

The Module Preferences Dialog

##### Parallel Preferences

Parallel Preferences

##### Various preferences Modules

Various Preferences Modules

## Module Manager

### Introduction To The Module Manager

The "module" is the unit of content in GnomeSword, 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, including some which have graphical content (e.g. atlases). They are installed either from a local directory structure (such as a CDROM distribution) or remotely via ftp from a server such as Crosswire, which is the home of Sword, and from which all officially Sword-sanctioned modules are available.

If you have other Sword applications installed, they will all share the same set of Sword modules that you install through the Module Manager.

#### The Module Manager Dialog

The Module Manager Dialog

### Sword Module Configurations

#### Sword Module Installations

##### Sword Module Installations

Module Installation

After you have selected your Install Source, click the Refresh button to cause GnomeSword to find the module summary available from that source before moving on.

#### Sword Sources Settings

##### Sword Sources Settings

Module Installation

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: http://www.crosswire.org/wiki/index.php/Module_Repositories

### Add And Remove Modules

#### Adding Sword Modules

##### Adding Modules

Module Installation

Modules that are already installed have a checkmark beside them. Locked modules, which require that you purchase an unlock key from the module's copyright holder, will show a lock symbol.

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

#### Removing Sword Modules

##### Removing Modules

Removing Modules

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.

### Installing Non-Standard Modules

Some resource modules in Sword Project format are available from sources other than Crosswire. Necessarily, installing such a module is a manual task.

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 GnomeSword) 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.

Restart GnomeSword after installing such a module, so that a fresh instance of the program can notice the new module in place.

## The Search Function

### Simple Searches

To conduct a quick search within the current module the 'Search Bar' in the 'Side Pane' should usually be absolutely adequate. Click either in the menu bar Edit->Search or in the 'Side Pane' Modules ->Search to access it.

#### the Search Bar

The Search Bar

The Search Dialog consists of the following parts:

- Search Key Entry box

- Search Module Selector

- Search Type Selector

- Search Options Checkbox

- Search Scope Selector

#### Search Key Entry Box

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 Find button to begin the search.

#### Search Module Selector

Allows selection of which modules you would like to search. Select Bible to search Bible versions or Commentary to search commentaries. Only the currently active module will be searched.

#### Search Type Selector

Allows selection of the type of search. There are three search types available:

Multi word

  This type will match any verse that has all the words in the search key, regardless of where they appear in the verse.

Regular expression

  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 `\ A[a-z]*iah` will match verses that contain the words Aiah, Ahaziah, Athaliah and Amariah.

  A complete discussion of regular expressions is beyond the scope of this manual, but more information can be found in the grep man page.

Exact phrase

  This type will match the search key exatly as entered. If the search key is `it is good`, this search would match a verse which contains "it is good," but would not match a verse which contains " good, and doeth it not, to him it is sin."

#### Search Options Checkbox

Allows selecting of search options. The only available option is Match case. Check this box to make the search case sensitive.

#### Search Scope Selector

Allows defining the range within the specificed module that will be searched. There are three search scopes available:

No scope

  This button causes the search to to include the entire module.

Use bounds

  Selecting this button produces two dropdown selector boxes marked Lower and Upper. Select the first book to search in the Lower box and the last book to search in the Upper box. The search will begin with the Lower book and end with the Upper book and include all books in between.

  Chapter and verse numbers can be entered into the search bound boxes as well to further narrow the search.

Last search

  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.

### Advanced Searches

More complicated searches might require the use of the advanced search functions, found under Edit->Advanced Search.

#### The Advanced Search Dialogue

The Advanced Search Dialog

In Advanced Search, 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.

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 (fake) custom module list is present, as a placeholder to make obvious what is required: Since it cannot be known what modules a user will install, no real content for such a module list can be assumed. 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.

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.

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.

### Search Syntax using Regular Expression

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 "righteous", "righteousness", "unrighteous", "upright" and even "bright". 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 "shall not".

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.

Example: the pattern "i. love\." will find sentences that end with "his love" or "in love" or "is love" 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.

#### Rules for Regular Expression Search Requests

- . The period matches any character.

- * The asterisk matches 0 or more characters of the preceding: set, character or indicated character.

- + The plus sign matches 1 or more characters of the preceding: set, character or indicated character.

- ? The question mark matches 0 or 1 character of the preceding: set, character or indicated character.

- [ ] Square brackets match any one of the characters specified inside [ ].

- ^ A caret as the first character inside [ ] means NOT.

- ^ A caret beginning a pattern anchors the beginning of a line.

- $ A dollar at the end of a pattern anchors the end of a line.

- | A vertical bar means logical OR.

- ( ) Parentheses enclose expressions for grouping. Not supported!

- \ A backslash can be used prior to any special character to match that character.

- \ A backslash can be used prior to an ordinary character to make it a special character.

##### The Period

The Period "." will match any single character even a space or other non-alphabet character. s.t matches sit, set, sot, etc., which could be located in sitting, compasseth and sottish b..t matches boot, boat and beat foot.tool matches footstool and foot tool

##### The Asterisk

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. be*n matches beeen, been, ben, and bn which could locate Reuben and Shebna.

##### The Plus Sign

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. be+n matches beeen, been and ben, but not bn.

##### The Question Mark

The Question Mark "?"matches zero or one character of the preceding: set, character or indicated character. be?n matches ben and bn but not been. trees? matches trees or tree.

##### The Square Brackets

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. s[eia]t matches set, sit, and sat, but not sot. s[eia]+t matches as above but also, seat, seet, siet, etc. [a-d] matches a, b, c, or d. [A-Z] matches any uppercase letter. [.;:?!] matches ., ;, :, ?, or ! but not a comma. [ ]^-] matches ] or ^ or -

##### The Caret first in Square Brackets

If the Caret is the first character after the left bracket ("[^") it means NOT. s[^io]t matches set, sat, etc., but not sit and sot.

##### The Caret as Start of Line Anchor

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. ^In the beginning matches lines that start with "In the beginning". (May need to use: ^.....In the beginning)

##### The Dollar Sign as End of Line Anchor

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. Amen\.$ matches lines that end with "Amen." (May need to use Amen\....$, Amen\..........$, or even Amen\....................$)

##### The Vertical Bar

The Vertical Bar "|" between patterns means OR. John|Peter matches John or Peter. John .*Peter|Peter .*John matches John ... Peter or Peter ... John. (.* slows a search) pain|suffering|sorrow matches pain, or suffering, or sorrow.

##### The Parentheses

The use of Parentheses "( )" is not supported!

##### The Backslash Prior to a Special Character

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. amen\. matches amen. but not ament and will not locate firmament.

##### The Backslash Prior to an Ordinary Character

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

- \b if use outside [ ] means word boundary. If used inside [ ] means backspace. \brighteous\b matches righteous but not unrighteous or righteousness

- \B means non-word boundary. \Brighteous\B matches unrighteousness and unrighteously but not righteous, unrighteous or righteousness.

- \d means digit; same as [0-9].

- \D means non-digit, same as [^0-9].

- \s means space.

- \S means not a space.

- \w means alphanumeric; same as [a-zA-Z0-9_].

- \W means not alphanumeric; same as [^a-zA-Z0-9_].

## The Studypad

### Using The Studypad

The Studypad can be opened by choosing File->Open Studypad

This is what the Studypad typically looks like:

#### The Studypad

The Studypad

The Studypad will save into your working directory, making it useful for collecting and exporting information and Bible study material from Gnomesword into other programmes.

Toolbar 1

- Font Size and Environment

- Font Type

- Bold, Italics, Underscored, Crossed Out

- Left, Centre and Right Bound

- Shift Paragraph Right or Left

- Colour Selector

Toolbar 2

- New, Save, Delete and Print

- Cut, Copy, Paste and Undo

- Find and 'Find and Replace'

- Spellcheck

In order for spellcheck to be available, one of the languages under Edit->Current Languages must be set.

## The Personal Commentary

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 Edit->Note->Personal in the menu.

An editor window similar to the Study Pad will appear. Edit your comment and save it; in future it will appear as your comment to the relevant verse.

### The Personal Commentary Editor

The Personal Commentary

Locationbar

- Synchronise Button

- Bible Book, Chapter and Verse Selectors

- Location Summary

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

Toolbar 1

- Font Size and Environment

- Font Type

- Bold, Italics, Underscored, Crossed Out

- Left, Centre and Right Bound

- Shift Paragraph Right or Left

- Colour Selector

Toolbar 2

- Save, Delete and Print

- Cut, Copy, Paste and Undo

- Find and 'Find and Replace'

- Spellcheck

In order for spellcheck to be available, one of the languages under Edit->Current Languages must be set.

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

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.

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.

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 the right-click menu.

The created commentary page will be attached to an individual verse only. To write commentary pages from within the Gnomesword, attached to longer stretches of text use the Link.. function to link several pages together

## Authors

This manual was written by:

- Andy Piper

- Pierre Benz

- Dr Peter von Kaehne

- Karl Kleinpaste

- Dominique Corbex

Please send all comments and suggestions regarding this manual to GnomeSword Development list gnomesword-developers@lists.sourceforge.net. Comments may also be submitted via the project trackers at SourceForge.

For more information on GnomeSword, please visit the project website at http://gnomesword.sf.net. Bug reports should be made using the Bug Tracker at the project development site http://www.sourceforge.net/projects/gnomesword

## License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

         	Free Software Foundation, Inc.
         	59 Temple Place - Suite 330
         	Boston, MA 02111-1307
         	USA