***************************************
*** Holy Bible for GP32             ***
***             by David Weisgerber ***
***                                 ***
*** Version 0.01                    ***
***************************************

(1) Copyright Information and how to contact the author
----------------------------------------------------------

This program is distributed under the terms of the
General Public License Version 2. You can find this
license agreement in the file 'COPYING'.
Author: David Weisgerber <tnt@md.2y.net>
                         <tnt@4gewinnt.org>
The bible translations included in this distributions
origin from the SWORD Project <www.crosswire.org>
This program is dedicated to the SWORD Project.

(2) How to install
----------------------------------------------------------
See the install.txt file

(2.1) How to use
----------------------------------------------------------
After starting it, it will load the .def file in to the
memory and after that it will show the first verse of the
first book (mostly Genesis 1,1 ;-) ).
* -R- will bring you to the next verse
* -L- will bring you to the previous verse
* With -select- you can enter a menu where you can select
a certain verse. Here you use these keys:
* Up/Down to change the selection in the combo boxes
* -A- holds the selection and brings you to the next combo
      box. After the Vers-Box the verse will be shown
* -B- brings you to the previous combo box
* -Start- shows you the currently selected verse

(3) How to bring your own bible text to the gpbible format
----------------------------------------------------------
--- All files to do this included in the scripts/
--- directory

First you need the text in a 'Verse per Line' format which
means that your text should have each single verse in its
own line. Your text also should not include any formating
tags or anything other than the text in the file.
Now use the script "text2bib.pl"
to strip special signs from the text.
USAGE: ./text2bib.pl <INFILE> <OUTFILE>
Example: ./text2bib.pl kingjames.txt bible.bib

Maybe you have to
edit this script on your own to make it usable with your 
language.
Next have a look at brefspec.txt which helds the information
what line belongs to what verse. Maybe you are able to
generate this file from your own bible text. Else you
can use either the brespec.txt or brefspec.hfa.txt (better)
which are delivered with this distribution.
For the next step you have to specify what names your bible
books have. For German and Englisch you can find the files
german.spec and english.spec. If you are using another
language you might use english.spec as template and
generate the spec file you need.
To generate the .def file use the script 'makespec.pl'
USAGE: ./makespec.pl <BREFFILE> <SPECFILE> <BIBLE> <OUTFILE>
Example: ./makespec.pl brefspec.txt english.spec bible.bib bible.def

Now you can upload bible.bib and bible.def as described in
install.txt

If it works correctly please let me know and send me the
bible.bib and bible.def file if it is free to redistribute.
If not send me an e-mail and I will help you.

(3.1) For customers of BibleCards by Brunnen Verlag
---------------------------------------------------
I was even able to bring my Hoffnung fr Alle translation
to the GP32. If you own a BibleCard your own I will help
you to do the same.

(4) Sources
---------------------------------------------------
There is always much to do. If you are willing to help
improving this program please let me know.
The Combo-Box implementation I made might also help
you on your GP32 projects. Have phun.

(5) Known Bugs
---------------------------------------------------
None yet :-)

(6) TODO
---------------------------------------------------
* Check string implementation (works but it is ugly)
* Implement bible references
* Implement skins and colour
* Implement Splash Screen
* Implement Comments

