This swordreader application is a sword (www.crosswire.org/sword) frontend for the Pocket PC platform (2002 and newer)

This file is a short introduction on how to build the application and how to develop it further.

BUILDING THE APPLICATION

To build the application, do the following
- check out the main sword library (http://crosswire.org/svn/sword/trunk) in a 'sword' directory next to this ('swordreader') directory.
- Use Microsoft eMbedded Visual C++ (freely downloadable from microsoft) to open the workspace in the src directory.
- This will result in the gui.exe, simplegui.exe and the sword.dll
- For other files needed to run the application, see the instructions in the INSTALL file.

DEVELOPING THE APPLICATION FURTHER

The simplegui is a complete application for people who are just interested in reading the bible. The gui application is meant to become a 'full' sword frontend, using the same sword.dll and some of the code from the simplegui application. There is still a lot of work needed to complete this application.

Some directives to get started:
- The application consists of different pages, accessable from the menu-bar in the bottom of the screen. New pages can be built by extending the NavPage class. An instance can be added to the Navigator. There are a lot of comments in the NavPage.h file to get started
- A good example of a page, which has quite a lot of comments in it is the NavFind page.
- The TextControl and VerseTextControl can be used to display HTML
- If compiled with -DNOHTML, both controls above will switch to a simpler display. This switch is somehow necessary to get the debugger of eVC working.
- The Navigator is the main class. Interfacing with the Pocket PC operating system goed through the main.h and applicationinterface.h files, to keep this interface simple.
- The Navigator has one instance of SwordIndex, which is meant to be an adapter/delegate/facade for the sword library. 

POINTS TO CONSIDER

- As the gui application progresses, the SwordIndex class may become more trouble than it is worth.
- The gui works with STL unicode strings, while sword works with its own type of buffer. It would probably be good to work with the same buffer in the gui as well.
- Most IPAQs nowadays have the 2003 operating system. This operating system supports the .net framework and the STL does not have to be hacked into it. Focussing on the 2003 operating system will probably make development easier.