README.TXT for Version Beta 1.2L of CSLesson -2002/02/24 Copyright (C) 1997-2002 by Peter Zwick Please read the LEGAL STUFF section at the end of this document for Copyright information and requirements for distribution. BRIEF DESCRIPTION: CSLesson is a PC Windows 3.1 program that generates the full text of the Weekly Christian Science Bible Lesson. It is simple to install, easy to use, and generates highly formatted output to the printer or the screen and modestly formatted output to a text file. CSLessons can be a useful tool for those who like to read the Bible Lesson at a time or place where carrying the books is inconvenient or impossible. PURPOSE: I wrote CSLesson out of concern for the fact that there are people who are on an limited income and don't wish to purchase the commercial full-text version of the Bible Lesson as sold in the Christian Science Reading Rooms. Yet, many of these people need the convenience of a pamphlet form of the Bible Lesson in order to fit reading the Lesson into their daily life. Under the assumption that access to Christian Science must not be limited by financial status, I am providing CSLesson as freeware with very few restrictions (see LEGAL STUFF below). For those individuals who enjoy saving money by using CSLesson instead of a commercial product, I encourage you to consider putting some of the money you save into increased donations to your local church or other worthy causes. CONTENTS: This distribution consists of 10 files. They are supplied within a single self-installing file of 2,329,196 bytes called SETUP.EXE. The following 7 CSLesson files will be placed in a directory of your choosing: filename bytes date description README.TXT 15935 2002/02/05 (this file) CSLESSON.EXE 89628 2002/01/01 CSLesson program - version Beta 1.2L SAHHTML.TXT 1345647 2002/01/01 Science and Health (1910 edition) 19101218.CIT 1222 2000/07/11 Citations for Lesson of Dec 18, 1910* 19101225.CIT 1229 2000/07/11 Citations for Lesson of Dec 25, 1910* CSL_HIST.TXT 4402 2002/01/01 Modification history of CSLesson* BIBLE.TXT 4606591 2002/01/01 King James Version of Bible The following 3 system files will be placed in your Windows system directory if not already installed. CMDIALOG.VBX 18688 1994/03/09 VBX Common Dialog Box Control BLASTER.VBX 12480 1996/08/14 VBX Control providing Win3.1 functions VBRUN300.DLL 398416 1993/05/11 Visual Basic 3.0 Runtime Library (v03.00.0538) *indicates file that is optional INSTALLING CSLESSON: If installing from a CD: 1) Insert the CD in your drive. 2) If the installation does not automatically start, browse to your CD drive in File Manager (Win3.1), or in My Computer or Windows Explorer (Win95/98/98SE/ME/2000/NT/XL) and double click on the file Setup.exe (may only appear as "Setup" on your computer). If downloading from the Web or from an e-mail attachment: 1) Note the location of file during the download. 2) Browse to that location in File Manager (Win3.1), or in My Computer or Windows Explorer (Win95/98/98SE/ME/2000/NT/XL) and double click on the file CSL_B12L.EXE (may only appear as "CSL_B12L" on your computer). Complete the installation by following the onscreen prompts. In most cases, the defaults given will be satisfactory. RUNNING CSLESSON: The first time you run CSLesson, it will create index files SAH.IDX and BIBLE.IDX in the directory that contains CSLESSON.EXE. After that the index files will only be rebuilt if a new version of CSLesson is installed or if SAHHTML.TXT or BIBLE.TXT are changed. Citations: Citations for a weekly lesson can be created ("File"/"New.." Menu item), saved as .CIT files ("File"/"Save" and "File"/"Save as..." Menu items), and reloaded as desired ("File"/"Open.." Menu item or select one from the list of the most-recently-used citation files at the bottom of the "File" menu). You can also drag-and-drop a citation file from the File Manager into the running CSLessons main window to automatically load it. Entering citations is easy! To enter citations for a new weekly lesson, type them in just as they appear in the Christian Science Quarterly. After you type in a citation, advance to the next entry line with the Enter key (press twice to go from Bible to S&H and from S&H to the Bible in the next Section). Besides pressing the Enter key, you can press the Down (or Up) arrow key to go to the next (or previous) entry line. Tab (or Shift-Tab) will take you to the next (or previous) entry group, eg., from the Bible to Science and Health entry areas. Remember that when you have entered all of the citations for a book (Bible or Science and Health) in a Section, just press the Enter key a second time on the empty citation line to advance to the next Book (the Section will also change if necessary). Two citation files 19101218.CIT and 19101225.CIT (the Weekly Bible Lessons prepared by Mrs. Eddy for Dec. 18 and Dec. 25, 1910) have been included as examples. Others may be available from the download site from which you obtained the CSLesson distribution. When entering Bible citations, make sure that you put a space between the book of the Bible and it's chapter number. Other than that, spaces can be inserted as desired for visual clarity. CSLesson recognizes all common names and abbreviations of Bible books. However, it does not check your entries for syntax or existence of the citation until the citation is printed. You can first "Print to Screen" or preview a citation (see below) to make sure that your entries are accurate. Previewing: You can preview citations in CSLesson by using the right button of your mouse. To preview a single citation, right-click in the entry box containing the citation. To preview all the Bible or Science and Health passages in a Section, right-click on "Bible" or "Science and Health" at the top of the list of citations. And to preview a Section, right-click on the word "Section". In each case, the Viewing window will open up and display that citation(s) or you will get an error message if the program can't figure out an entry. Printing: The weekly lesson can be printed by using the "File"/"Print" Menu item or by pressing the "Print" Button at the bottom of the program window. After you select the destination for printing (Text file, Printer or Screen), the Print button defaults to print to that destination again. You can always reselect a print destination in the "File"/"Print" Menu. If you print to the Screen, the lesson will be displayed a page at a time. When you are through reading that page, press "Next" to advance to the next page, or "Prev" to return to the previous page. Because CSLessons only holds 4 pages in memory at a time and prepares up to two pages in advance for you to read, you can only go back one page (sometimes two) using the "Prev" button. If you wish to go back further than this, you will need to close the Viewing window and start over. To switch between the Main window and the Viewing window, use the keyboard shortcuts Alt-M and Alt-V (respectively) or use the mouse and click on the desired window. If you print to the Printer, you can vary between Portrait and Landscape mode (using the "Setup" button in the Print dialog box) to get two different layouts of the printed page. NOTE: Changing the Printer Setup will also change the system default settings that may be used by other programs. Options: Changes in the following options will be remembered between sessions of CSLesson. Options - Font: You can select from a list of fonts that are supported on both the Screen and the Printer. Note that the same font size in a different typeface usually produces a different printed character size. Some people have found that an Arial or Helvetica font between 9 and 12 point is easier to read than Times New Roman. The default font is 10 point Times New Roman because this results in printed page appearance very similar to that of the 1910 edition of Science and Health. Feel free to experiment. Options - Zoom: I suggest that you also experiment with the "Options"/"Zoom" Menu item when printing to the Screen and to a Printer to find the most pleasing and readable settings for your tastes. I find that Zoom scalings of 100% to 125% printed in Landscape mode are very pleasing. You will notice that changing the Font Size under the "Options"/"Font" item is an alternate way to change Zoom, although it doesn't offer as quite fine a degree of control. Default is 100%, corresponding to 10 Point font size. Options - Num of Sections: You can select the maximum number of Sections to include when entering citations for a lesson. The range is between 6 and 10. Some of Mrs. Eddy's pre-1910 Bible Lessons had up to 8 Sections. Default is 6. NOTE: A citation file with up to 10 Sections will be properly opened and all the Sections will print out, regardless of this setting. You can also safely set the "Num of Sections" to more than are in the Lesson. Sections that have no citations will not be printed. Options - Print All Bible 1st: Click on the "Print All Bible 1st" item to toggle On/Off what might be termed a "Wednesday Readings" mode. When this item is "On", all the Bible passages are printed before all the Science and Health passages. Section breaks and Section numbers are not even printed. Default is "Off". Options - Hints: Click on the "Hints" item to toggle On/Off the viewing of simple hints in a bar at the bottom of the Main window. Default is "On". **** FOLLOWING ARE DETAILS ON FILES IN CSLESSON **** CSLESSON.EXE (Beta Version): This executable program was developed in Visual Basic 3.0 to run under Windows 3.x. It will also run under Win95/98/98SE/NT/ME/2000. It has not yet been tested in WinXL. It allows the user to create full-text versions of the Christian Science Weekly Bible Lesson by entering the citations from the Bible and Science and Health as found in the Christian Science Quarterly. Output to the Printer and the Screen are highly formatted in a style that is identical to that of Science and Health. Output to a text file is in standard ASCII format but with line justification by adding spaces as required. This output might be suitable for importing into a word processor for adding notes, or for printing if your printer doesn't support the formatting or font type (Times New Roman) used in the output to the Printer. As a Beta Version, this program is still under development and comments or suggestions are very much appreciated. Please contact me at pzwick@krl.org if you encounter difficulties or have suggestions. KNOWN PROGRAM BUGS AND AREAS OF IMPROVEMENT: - A help system is not yet included but is planned for a later release. - The program is slow due to the programming language (Visual Basic) and the method used to accomplish word-wrapping and text justification. - There is no screen preview for the text appearance as it will be on a printer. - A Science and Health citation with an ending line number greater than the number of lines on the page may produce continuous output (As MicroSoft would say "This is a feature rather than a bug!"). - The 4 page buffer for viewing is inadequate because you can only go back one or two pages. Improving this behavior may also allow printing selected pages, rather than all pages, to the Printer. - The View window for previewing citations (right button click feature) does not do Zoom scaling perfectly or display multiple pages reliably. - Custom Zoom below about 75% results in very tiny print and only one column output in View window. SAHHTML.TXT: This is a text version of the 1910 edition of Science and Health with Key to the Scriptures by Mary Baker Eddy. It has HTML-like codes inserted to provide required formatting information for the program CSLESSON.EXE. SAHHTML.TXT was developed from SAH.DOC downloaded from http://www.ChristianScience.org/heal on 1997/09/14. The original SAH.DOC was converted to a fully-formatted version of Science and Health by careful comparison with a hardcopy edition of the book. The resulting fully-formatted MS-WORD 6.0 document was then used as the basis for the formatting that is used in SAHHTML.TXT. Although much effort has been made to ensure accuracy in both content and appearance, some errors may be found. The history of previously corrected errors is included as comment lines at the beginning of the file. Please notify me if you find any discrepancies in the current version. BIBLE.TXT: The King James Bible was downloaded from Simtel on 1997/09/14 as text-formated books of the Bible in files kbib_kj1.zip through kbib_kj5.zip. These were expanded and concatenated to form BIBLE.TXT. It appears that this is a British variant of the King James version because of the occurrence of several old British spellings of some words. I have updated some of the more noticeable of these as indicated below (these are the only modifications made to this original BIBLE.TXT): -All occurrences of "bason" have been changed to "basin". If you wish to change these back to "bason", note that "basin" occurred once in "abasing" in the original BIBLE.TXT. -All occurrences of "shew" and "Shew" were changed to "show" and "Show" respectively. If you wish to change "show" back to "shew", note that "show" occurred many times in the original BIBLE.TXT in "shower". -Occurrences of "lunatick" were changed to "lunatic" (only in Matt. 4:24; 17:15). -Occurrences of "astonied" were changed to "astonished" (many places). -Many contractions of "fellow" with a following word were split into two words. -Psalms 92:1 was changed from all small caps to mostly lower case. ACKNOWLEDGEMENTS: Many thanks to Michael Moore and David Keyston for encouragement and early Beta testing, to Ralph Proctor, Tom Linder, and several other users who have given many helpful suggestions, and to the Aequus Institute for a supporting grant. LEGAL STUFF: The program CSLESSON.EXE is Copyright (C) 1997-2002 by Peter Zwick. It is freeware and may be copied and distributed freely as long as this README.TXT file, and files BIBLE.TXT and SAHHTML.TXT are included in the distribution, and as long as no charge is made for the distribution other than a reasonable charge for the media. Both the Bible and the 1910 edition of the Science and Health are not Copyrighted and may be copied, sold or given away. The Christian Science Quarterly is Copyright (C) by The Christian Science Publishing Society. The Message Blaster Custom Control (BLASTER.VBX) is Copyright (C) 1993 by Ed Staffin and Kyle Marsh with modifications Copyright (C) 1993 by Arjen Broeze. CMDIALOG.VBX is Copyright (C) 1991-93 by Microsoft and VBRUN300.DLL is Copyright (C) 1987-93 by Microsoft. Although much effort has been made to ensure accuracy in the Science and Health (as contained in SAHHTML.TXT) and the Bible (as contained in BIBLE.TXT), I cannot guarantee 100% accuracy of these document files and assume no responsibility for errors other than my pledge to correct such errors upon receiving notification. I request that users notify me by E-mail if they detect errors in either of these document files or in the operation of the CSLesson program so that I can correct the copies in the distribution. With Love and best wishes - Peter Zwick E-mail address: pzwick@krl.org