Bible+ 3.2.0 http://palmbibleplus.sourceforge.net/ ======================== BEFORE USING THIS SOFTWARE ======================== - Please read copyright.txt and license.txt - This file contains installation instructions, information on where to obtain Bible+ bibles and crossreference databases, miscellaneous info, a changelog, and credits. - A manual is available at http://palmbibleplus.sourceforge.net/pbmanual.html or (possibly) in this zipfile as Manual.zip - After reading this file and the Manual, if you still have questions, please post on the Forums, just a click away from http://palmbibleplus.sourceforge.net/ ========================= COPYRIGHT AND LICENSING ========================== Copyright (c) 2004 Yih-Chun Hu Release Engineering by Gary Chan http://www.thechan.com Other Bible+ Team Developers: Alexander Pruss, Robert O'Connor, Josh Little, and Ricardo Ramírez R. Based on Bible Reader code copyright (c) 2001 Poetry H.C. Poon LowRes Fonts copyright (c) 2002 Michael Neuhold HiRes Fonts copyright (c) 2002 J. S. Park, NON-COMMERCIAL USE ONLY FREEWARE (GPL). Note that the fonts are for NON-COMMERCIAL USE ONLY; if you need a fully-GPL version, use a _xxlite, _xlite or _lite version. For example, PalmBible_eng_xlite.prc and PalmBible_eng_lite.prc is fully-GPL; PalmBible_eng.prc and PalmBible_eng_big.prc are for non-commercial use only, at least in countries where the bitmapped fonts are copyrighted. zipDB is by Alexander Pruss and uses zlib by Jean-loup Gailly and Mark Adler. syszlib.prc is a port of zlib by Tom Zerucha and Justin Clark. =============================== INSTALLATION =============================== - You need Bible+ (localized to your language); for example, for English, you need either PalmBible_eng.prc (OS5) or PalmBible_eng_lite.prc (OS3.5-4.2) PalmBible_eng_xlite.prc is for OS3.5-4.2 users who don't need the built-in Hebrew or Greek fonts (for example, for Clie users that will substitute fonts using FontHack123, as described in clieread.html), or for users who want a completely GPL program. Bible+ is designed for OS3.5, but some features MAY work on OS3.3. - If you want some preset snapshots for faster search book selection, install PBLPSnapshot.PDB - HiRes+ support is now available natively, and for OS4! - If you use a OS4 Clie with HiRes, and are interested in HiRes Greek/Hebrew fonts, please read clieread.html, included in cliefonts.zip Note that you now need to enable this feature under Misc prefs. - You also need one or more Bible PDB files. Install them in RAM, or on the memory card at \Palm\Programs\PPBL . Alternatively, you can use "Install Tool" to install them to the card. - You have the option of installing a cross-reference PDB file. Cross-reference files can be built using tsktopdr.exe and par (par is available from http://www.djw.org/) - You can install at most 48 Bibles by default. If you need more, go to the menu and choose OPTIONS | PREFERENCES | PERFORMANCE. Reducing the maximum number reduces memory usage somewhat. - If you have a Tungsten T3: installation of the T3 update is *strongly* recommended. It fixes major SD bugs, and increases battery life and perf: http://www.palmone.com/us/support/downloads/tungstent3/t3_update_memory.html If you install this update, or if you want to use the Dynamic Input Area, you need the Dynamic Input Area support files. These are required by most T3 DIA apps, such as DateBk5 and iSilo. These files are available in the Files section of the Bible+ web page. - For dictionary lookup, get and install ppi_en.prc from www.plkr.org/index.plkr?a=snaps and run PPI (Plucker Plugin Interface) to set up dictionary. (Note that RoadLingua from AbsoluteWord, see www.roadlingua.com, always acts as a registered version when it is called via PPI with a free dictionary text. Thank you, AbsoluteWord.) Then go to misc preferences in PalmBible+ and set it to lookup with PPI on double Get ppi_en.prc from www.plkr.org/index.plkr?a=snaps and run PPI to set up dictionary. (Note that RoadLingua--www.roadlingua.com--always acts as registered when it is called from PPI with a free dictionary text.) tap. Otherwise, double tap goes to clipboard. - To use anti-aliased fonts under OS5 or on Acer S50/60 units (these are fonts that look a lot smoother and nicer on hi-res displays), either download a Plucker anti-aliased font or generate your own from TrueType / Type1 fonts via PalmFontConv (PalmFontConv.sf.net). Note that Plucker-compatible font packages are by default disabled in the skin chooser, because there could be incompatibilities with older Plucker-compatible font packages. You need to enable each such font package directly in the Skin Chooser. There could be problems with simultaneously enabling an older Plucker aa font (not generated with the latest PalmFontConv) and another aa font. (New Plucker aa fonts are designed to co-exist.) ======================== BIBLES FOR USE WITH BIBLE+ ======================== - Note that Asaisoft purchased versions cannot be read by Bible+ (17 USC 1201) If this law is ever repealed, I'll consider implementing compatibility - Bible+ needs Bible PDB Files. The Bible+ web site features many sites from which you can download these files: http://palmbibleplus.sourceforge.net/bibles.html - Convert your own using BibleConverter. See http://palmbibleplus.sourceforge.net/bibles.html for details. - I now have a license to make the Message available for one year! Please sample verses from the message at Bible Gateway (www.gospelcom.net), and if you like this contemporary translation, purchase it from http://www.PDAGreen.com/software_detail.asp?id=8866&associateid=79 Please buy this if you're using the Message with Bible+; a worker earns his wages (Deut 25:4, Lev 19:13, Jer 22:13, Mt 10:10, Lk 10:7, Jas 5:4). In this case, the worker is Eugene Peterson, for his remarkable translation. Thanks to NavPress for their understanding as my channel costs have increased. (This doesn't support me very much at all; if you want to do that, you can send me money directly or buy MemHack or something...) ======================= CROSS-REFERENCES FOR BIBLE+ ======================== - If you want to have cross-references in Bible+, you need a cross-reference database. Then you can double-tap the verse number to get a list of related verses. Currently the only such file is the Treasury of Scripture Knowledge: http://prdownloads.sourceforge.net/palmbibleplus/tsk.pdb?download If you make other versions, please post about them on the Forum, accessable from http://palmbibleplus.sourceforge.net/ ============================ RANDOM INFORMATION ============================ - A number of tools are included in readme.tools. If you need a specialized Bible+ tool, download a _bin or _src distribution for all the tools I use to build Bible+. Readme.tools describes these tools in more detail. - A number of resources are user serviceable. All you need is pilrc and build-prc to make skins. See readme.skins - Download available at http://palmbibleplus.sourceforge.net/ Please type the URL carefully; cybersquatters hawking porn lie in wait. =============================== FEATURE LIST =============================== - Fast Display Engine - Cross-references (double-tap the verse number) - Fast book selector, completely-Graffiti Goto - Fast (ARMlet) search engine with transliteration, stop and resume - Notes page for fast notetaking (with export to MemoPad) - Built-in languages: Hebrew, Accented Greek, Interlinear Greek, "Thin" font - Simultaneous Hebrew or accented Greek with Chinese - Large Font option - Copy word/verse/screen to clipboard - Snapshots for search and navigation - Highlighted bookmarks on color devices - Extensive Graffiti shortcuts - Footnote support - Drag Scrolling - Dual Version Display - Browser-like operation - Customizable Preferences - Sony CLIE HiRes+, Landscape HiRes+, and HiRes (with FontHack123) - Palm Dynamic Input Area (320x480 and 480x320) - Runs on Palm OS 3.5 and up - Dictionary lookup on double tap via Plucker Plugin Interface (PPI) - Auto-off - Auto-scroll - Easy Goto from other applications. Simply put the reference in the clipboard and call Bible+. ================================ CHANGE LOG ================================ 3.2.0 - fixes crash bug in search results after PPI (or another operation that purges heap usage) - Added support to parse clipboard text at start up. If there is something starting with the ~ char it expects something like ~[version,] book chapter[:verse], i.e. ~ESV, Jhn 3:16 will go to John 3:16 in the ESV version. - Improved card search logic and speed. By default will search all of /PALM/Programs/Bible+, /PALM/Programs/PBLP and /PALM/Launcher on all cards. But with the "Search /PALM/Launcher always" flag off in the performance preferences, will skip searching /PALM/Launcher if a Bible is found in one of the other two directories: this will speed up the initial scan. - Text to speech. Requires 6 mb of RAM plus 2 mb of dynamic heap, an OS 5 device with Palm standard sound support, and the free Talking Moose (http://www.geocities.com/nagamatu/Moose/). Quality is surprisingly good. You can use the controls menu to assign speech to something sensible, and you can adjust the volume control via the Interface pane of the Preferences. - Many aspects of memory management revamped - By default don't show chapters/verses in search (but see Preferences | Interface). - Boolean search (Alexander Pruss) - Don't search footnotes when footnotes are hidden. - Lightspeed overclocking support for searching. If you have the Lightspeed overclock utility installed, Bible+ will automatically switch into HIGH speed mode when searching, and come back to the speed you set for Bible+ for all other operations. This lets you set a low CPU speed for Bible+ in Lightspeed to save battery power, but while searching, when high CPU speed is really needed, Bible+ will automatically switch to high speed. (Alexander Pruss) - Minor optimizations - Prev/next book shared action - Zlib compression for cross-references and Bibles. Make sure you hotsync syszlib.prc and then use the zipDB program on your desktop to compress databases. (Alexander Pruss) - Faster cross-reference lookup for Bibles in VFS. - Auto-scroll support. Start/Stop Tap on screen. Inc/Dec speed with PgDn/PgUp (Ricardo Ramírez) - Auto-off can be set within Bible+ (Ricardo Ramírez) - Highlighted bookmarks on color devices (Ricardo Ramírez) - Support Treo/Tapwave/Handera Jog/Sony Jog in fast book/verse selectors. - Support full screen (no status bar) mode on T3, T5 and Tapwave (previous versions supported it on Sony Clie devices with VG). To use, assign the "Toggle status bar" action to a hard key or icon. (Alexander Pruss) - Adjustable maximum number of Bibles (Alexander Pruss) - Tapwave rocker support (Alexander Pruss), acction buttons and triggers; can be configured. (Ricardo Ramírez) - embedded red/green/blue formatting and linebreak code (Alexander Pruss) and support for configuring the three colors (Ricardo Ramírez) - vocalized Hebrew support (Alexander Pruss) - control whether Bible+ starts in maximum depth mode (Alexander Pruss) - text justification (Alexander Pruss) - book picker for more than 74 books (Ricardo Ramírez) - preliminary pointed Hebrew support, so far hi-res only, and without necessary ligature-type support (Alexander Pruss) 3.00 - Handera screen and jogdial support (Alexander Pruss) - Grayscale color picking support - Start by default in maximum bit depth mode on color devices - Dana AlphaSmart support (Alexander Pruss) - Full DIA support withotu CollapseUtils (Alexander Pruss) - Active window indicator - Fully configurable on-screen buttons (icons) - Rotation (based on Plucker code) - Horizontal splitting (Alexander Pruss) - Support for hiding Sony status bar - Sony UX50 support - Keyboard/graffiti/control configuration (based on Plucker code) - Copy verse reference with 'c' - Multiple term in verse search - Faster searching on most ARM units - Graffiti gestures for incrementing/decrementing the current verse - Incorporated Robert O'Connor's Plucker-based shared action methodology - Verse separator and copy verse reference added to shared actions - In dual view, tapping on the split-line swaps the upper and lower views - Major UI enhancements by Robert O'Connor (incorporated by Josh Little) - Smart quotation mark spacing. This looks best if apostrophes are part of the word in the Bible source text, rather than separated by spaces as if they were separate words. - Some OS 3.3 support - Better chapter/verse selector (Ricardo Ramírez) - Yet Another English Build: _big. Enormous (double sized) Greek and Hebrew. You'll need to disable any font skins to use this. - Better handling of DIA in notes and version info pages - New shortcut: 'x' sets Custom1 langauge - Bugfix: Custom1 language now usable - Internal change: fix_sdk.pl included in CVS - Internal change: fonts handled via fontconv - Support for external dictionary lookup via Plucker Plugin Interface (PPI) - Support for anti-aliased fonts under OS5, including Plucker ones 2.47 (Released 11/9) - Added new language: Custom1 (NFNT 101 nfnt 101 prefix '1') - Bugfix: fixed bug from fixing crash mentioned last time 2.46 (Released 11/9) - Hidden footnotes options combined together - Codified reset requirements for FontHack support - Added a new VFS directory to search in: \Palm\Programs\Bible+ - Bugfix: Sony HiRes+ problems - Bugfix: Crash when upperviewer has more chapters/verses than lower - Internal changes: Better architecture for HiRes+/DIA 2.45 (Released 10/31) - Fixed some Graffiti2 compatibility issues - Completely revised to use SampleCollapse (PalmSource) code - Higher memory consumption, to fix bugs with tiny Chinese in 320x480 - Slightly better width handling in Bookmark form - New pref: Thin and Large consolidated to both be preferences - New pref: FontHack now supported for all pre-OS5 devices. Can turn on/off - New pref: Continuous Redraw; off is possible, on if draw starts breaking - New pref: History storage [off by default] (was causing crashes) - Bugfix: blink on double-tap to copy - Bugfix: asian languages/thin font line wrapping - Bugfix: color selector not being colorful - Bugfix: Pref saving - Bugfix: crash in delete version - Internal changes: much cleaner compiles, ever-so-slight perf hit 2.4 (Released 10/21) - Better hires-capable title (causes no screen blinking) - No blinking in prefs screen (John Supplee) - Better silk screen use (John Supplee) 2.39 (Released 10/6) - Bookmark Annotations - Config saved more often - HiRes-capable title (causes lots of screen blinking) - Collapsable Input Area support in several forms - Bugfix: Hold Tungsten middle button for home - Bugfix: Multi-VFS support (Thanks dextor ) 2.31 (Released 9/18) - Hires launch icon - Skin chooser (Menu->Options->Skin Chooser) - Skins now support title width - New pref: version info is/isn't in title bar - Bugfix: Version Info crash - Language Updates: French, Chinese, German 2.3 (Released 7/7) - Easier navigation of search results (Graffiti right/left arrows in main form) - Exchanged CodeDiver support for native HiRes+ support - Crossref support now optional - Large font support - No footnote marker support (can now choose degree, *, or nothing) - Added two new languages: Greek Interlinear ("ti/bi") and Thin ("tr/br") You need a skin to take advantage of these: http://www.thechan.com - Linespacing is now adaptive to font size (but potentially slower) - Option allows Uniform blank space for verse #s (1 digit and 2 digit) - Bugfix: crash on paste of nonexistant annotation - Bugfix: Handspring expansion card support 2.2 (Released 6/4) - Better CodeDiver support (scrolling) - Cross references (double-tap verse number) - Bookmark annotations displayed until the first newline - New languages: French, "Scriptures" (English non-denominational) - New pref: Footnotes appear as * (better Chinese compat) - New pref: alphabetize booklist - New pref: choose to always see book/verse in title - New pref: frmGotoYCH can popup frmGoto onClose - New pref: Scroll entire screen vs less-one-line - Bugfix: Graffiti indicator in notes page - Bugfix: no extra space in copy-verse 2.1 (Released 5/10) - Nondenominational version switcher now standard (thanks to J. S. Park for the icon); crossskin.prc restores the old (cross) icon - Jump screen is more spread out now - Keyboard support for bookmarks - Bookmarks now redraw the main form - Better memory management: memory error alert - Language emphasizes that not reading copyrighted versions is a legal issue - Notes page allows select all - Highlighted keyboard jump on color devices - "m" opens the notes screen - Bugfix: Notes page refresh issue - Bugfix: orphan-fixes line length issue (e.g. Rom 15:19 WEB) 2.01 (Released 5/1) - Bugfix: blank book after the last book no longer selectable - Bugfix: footnote redraw now happens 2.0 (Released 4/30) - Notes page - Copy and paste bookmark annotations - Fast search - Snapshots for search and viewer - breaks a line - Don't print same verse number twice - Bookmark export - Config option for smooth scrolling - New graffiti stroke for adding bookmark: a (or A) - Graffiti stroke for going to jump window (j or J) - Can type book name from jump window - OS5 HiRes+ support via CodeDiver - Improved bookmark highlighting (its faster now) - Improved fonts: better Hebrew hyphen and correct GreekKeys mapping - Bugfix: changing language redraws screen - Bugfix: some memory leak issues 1.5 (Released 4/14) - Fixed the orphaning - Transliterated search + ARMlet transliteration - Hyphenation works if - is a separately encoded word - Search form does more the "right" thing when setting a To book - Improved jump screen 1.4 (Released 4/11) - Vertical character spacing dependant on font size - Footnotes (in { }) can be hidden/unhidden by writing "n" - All fonts are now skinnable - New color selector (more colors!) - Configurable highlight color - Configurable hardkey use - Color NT in jump - Double-tap to copy word - Search now searches more of the verse (hopefully all of it...) - Search is now case insensitive - Can add comments to a bookmark (select it and write graffiti) - Support for larger bible versions - Bugfix: memory leak in Delete Versions - Bugfix: Jump form less crashy - Bugfix: clie jogdial, command shortcuts fixed (broken in 1.2) - Bugfix: search fonts somewhat improved (not completely fixed) - Numerous other bugfixes 1.21 (Released 4/3) - Bookmark bugfix - If you installed 1.2, completely uninstall Bible+. If Bible+ is installed on a memory card, copy it to memory first, then delete it. 1.2 (Released 4/2) - History is saved between sessions - Hard keys for history forward/backward - Faster startup - Added more main menu tools: swap top/bottom, set version, dual-view toggle - Graffiti shortcuts for above: "w" (swap), "v" (set version), "d" dual-view - Main interface skins - Can use multiple skins - New Goto interface named (Jump) and put in menu - Bookmark Categories - Bugfix: q and z names now work from memory - Bugfix: title redraw doesn't obscure back/forward - Bugfix: frmSearch/frmGoto no longer crashes on empty chapters 1.1 (Released 3/28) - Highlights bookmarks on color devices - Graffiti Goto is more forgiving; ":" need not be written precisely. - Retains last location in each book (except Genesis in some cases) - Space and Backspace now do previous/next chapter - Copy verse and copy page functions - Bugfix: going to a new book now resets the Graffiti goto mode 1.01 (Released 3/24) - Clie HR support using FontHack123: see readme.clie - Bugfix: Up and down now works on non-Tungsten devices. - Bugfix: Config file no longer conflicts with BibleReader - Bugfix: Modified 5-way behavior - Bugfix: Hebrew/Greek wordwrap now works with 2-character operating systems 1.0 (Released 3/21) - Skin support - Load bible from memory card: \Palm\Programs\PPBL and \Palm\Launcher - Hebrew written right-to-left - Hebrew and Greek forced to use single-character fonts (allows the concurrent use of original languages with 2-byte systems such as Chinese) - Font choice: files named q* on VFS assumed Hebrew, z* assumed Greek. Also choose font by writing two letters: the first represents location (either "t" for top or "b" for bottom) and the second represents a font ("h" for Hebrew, "g" for Greek, and "s" for standard). For example, "ts" sets the top-viewer to use the standard font. - Goto Book/Chapter by Graffiti (write 3:16 to go to ch3 vs16) - Improved book navigator. Old mechanism still available through menu - Typing "k" opens bookmarks, "f" opens search - Palm OS5: bugfixes, hires fonts, font conversion utils, 5way support ================================= CREDITS ================================== Original program - Written by Poetry H.C. Poon Significant UI Reworking - By Robert O'Connor integrated by Josh Little Greek Interlinear Coding and Fonts - From Gary Chan - Fonts based on those from J. S. Park Current Font Conversion Utility (fontconv), Dictionary Lookup Support, Anti-Aliased Fonts - From Alexander Pruss Control Configuration - From Alexander Pruss based on his Plucker keyboard configuration code Fast Chapter/Verse selector - From Ricardo Ramírez R. HiRes Fonts - From J. S. Park LowRes Fonts - From Michael Neuhold Greek and Hebrew Localization Tables - From the Online Bible , via Alexander Pruss BibleConverter Help File - Typed in by Wing-Kei Yip Minor Prefs patches - (c) 2003 John Supplee john _at_ supplee _dot_ com Hires Icon - Drawn by Harald Albrecht Old (now discarded) HiRes+ Code (v2.3-2.4) - Alexander Pruss www.georgetown.edu/faculty/ap85 - HiRes+ support modified from code (c) 2003 Adam McDaniel hires.plkr.org - Usability patches John Supplee john _at_ supplee _dot_ com and Translations (* = has CVS access; these should be current) Polish Version - Localized by Bartosz BtF Dreger* Dutch Version - Localized by Roel Knol* Korean Version - Localized by Jaeyoun Yi Swedish Version - Localized by Lars Eriksson (user zybler on sourceforge.net) Big5 Version - Localized by Isjacob Yip - Updated by Timothy German Version - Localized by Horst Roos - Updated by Harald Albrecht French Version - Localized by Justus H. Piater Japanese Version - Localized by Toshihiko Tokita Indonesian Version - Localized by Adison and Togar Toruan Italian Version - Localized by Gianluca Tassi Spanish Version - Localized by Ricardo Ramírez R. Russian Version - Localized by Slava Mikheyev