home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Educate / Educate.zip / bibdayo1.zip / BIBDAY2.DOC < prev    next >
Text File  |  1993-11-18  |  14KB  |  304 lines
  1. BIBDAY/2 - Bible verse of the day program for OS/2 - (c) 1993 by Robert Woeger
  2.                                                           All rights reserved
  3. OS/2 Specific Version                               
  4. [DOS Version available separately]                
  5.  
  6.  
  7. *** Summary of BIBDAY/2 ***
  8.  
  9. BIBDAY/2 Version 1.0 is a useful Bible Verse of the day program.  It displays
  10. a random Bible Verse each time it is run.  It will help to brighten your day
  11. and pick you up.  You can set the BIBDAY/2 program to run every time you boot
  12. your system if you like.  That way your PC will greet you with a message
  13. of encouragement and inspiration each time you turn it on.  You can also
  14. use it to display a verse when you run certain applications or batch files
  15. also.  It has many uses.  You can configure the color of the text of the
  16. Bible Verses also.  You can optionally have it clear the screen before the
  17. verses are displayed.  You can add your own Bible Verses by using a standard
  18. ASCII text editor such as EPM.  That way you can see your favorite verses
  19. each time you run BIBDAY/2.  You can choose to pause the screen after the
  20. verse is displayed or let the screen scroll.
  21.  
  22.  
  23.  
  24.  
  25. *** Distribution of BIBDAY/2/Cost of BIBDAY/2 ***
  26.  
  27. This version, BIBDAY/2 1.0, is distributed using the shareware software
  28. distribution method.  The author, Robert Woeger, owns the copyright on this
  29. program and will allow anyone to distribute the BIBDAY/2 program as long as the
  30. following simple rules are followed:
  31.  
  32.         1)  All people are encouraged to give copies of this shareware
  33.         version of BIBDAY/2 away to others.  You may charge a reasonable disk
  34.         duplication fee if you are a shareware vendor (not to exceed $8/disk).
  35.         CD-ROM publishers are free to include BIBDAY/2 on their shareware
  36.         CD-ROMs.  On-line services and bulletin board systems may freely
  37.         distribute the shareware version of BIBDAY/2 even if they charge an
  38.         access fee to use their systems.  You may not sell copies of BIBDAY/2 -
  39.         only the author may receive payment for use of BIBDAY/2.
  40.        
  41.         2)  You may use this program for a trial period not to exceed 30
  42.         days.  At the end of the 30 day trial period you must either pay
  43.         the author, Robert Woeger, for the right to continue to use the
  44.         program or stop using BIBDAY/2 altogether.  Upon payment to the author
  45.         you will receive a special registered version of BIBDAY/2 that does
  46.         not have the "Unregistered shareware version line" at the top of the
  47.         screen, plus you will receive the latest version of BIBDAY/2.  Also
  48.         you will know that you have done the right moral and legal thing.
  49.         As the Bible says "For the worker is worth his wages" Luke 10:7, and
  50.         the author has the legal right to expect payment for his work in
  51.         writing this program.
  52.  
  53.         3)  Tell others about BIBDAY/2!  Give it away to help spread God's
  54.         Word into other people's lives.  If you or your church or ministry
  55.         would like a special registered version of BIBDAY/2 to distribute as
  56.         part of your evangelism or fund raising program(s) please contact the
  57.         author for details.  I am very receptive to working with ministries
  58.         and churches about licensing BIBDAY/2 for your fund-raising or
  59.         evangelism needs.  This special registered version of BIBDAY/2 I have
  60.         available is a pre-paid license so people you send it to or give it
  61.         to don't have to pay me an additional shareware fee.
  62.  
  63.         4)  You MAY NOT distribute any other versions of BIBDAY/2 to others
  64.         (i.e. Registered version, Special Evangelism version, etc.) unless
  65.         you have a special license from the author to do so.  This shareware
  66.         version is the ONLY version that you may distribute.  If the logo on
  67.         the top of the display says registered copy, please do not distribute
  68.         it.  Thank You.
  69.  
  70.         5) This program and all its files are distributed on an "AS IS" basis
  71.         with no warranties provided.  The author has tested the programs on
  72.         his PC but can not vouch to how they will act on your computer.  The
  73.         author will in no way be liable for any accidental damage or misuse
  74.         caused by these programs.
  75.  
  76.         6)  When you distribute this shareware version of BIBDAY/2 to others,
  77.         you MUST ONLY distribute the original files that came with BIBDAY/2.
  78.         You MAY NOT add, remove, or modify any of the files you give to
  79.         others!  That includes the BIBVERSE.DAY text verse file!  You may
  80.         modify the BIBVERSE.DAY file for use on your own PC and for use
  81.         on machines you have a registered licensed copy of BIBDAY/2 for, but
  82.         you MAY NOT distribute modified copies of BIBVERSE.DAY or the other
  83.         program files included with the BIBDAY/2 package.  Disk vendors may add
  84.         their own supplemental documentation or information files to the disk
  85.         but may not modify or delete any of the original distribution files.
  86.  
  87.  
  88.  
  89.  
  90. *** Note:  The following references are made immediately following the
  91. Bible verse reference to specify which version of the Bible the verse is
  92. taken from.  Each version except the King James Version is copyrighted
  93. and is used by permission of the respective publisher of that version.
  94.  
  95. [KJV] - King James Version
  96. [NKJV] - New King James Version
  97. [NIV] - New International Version
  98.  
  99.  
  100. You may contact the author in the following ways:
  101.  
  102. Mail:  Robert Woeger, 2423 Hagerman St., Colorado Springs, CO 80904-3228  USA
  103. Phone:  (719) 471-8306  days or evenings
  104. CompuServe Email address:  71204,605
  105. Internet Email:  71204.605@compuserve.com
  106.  
  107. See the PAYFORME.DOC file to register (pay for) your copy of BIBDAY/2.
  108.  
  109. The BIBDAY/2 program is shipping in both DOS and native OS/2 versions.  In
  110. the near future a Windows specific version is planned to be released.  Look
  111. on your favorite BBS for new versions of all the BIBDAY programs.
  112.  
  113. Filename formats for distribution are currently:
  114.  
  115. BIBDAYD1.ZIP    Bibday Version 1 -  DOS Specific version (available in a
  116.                                                           separate package)
  117.  
  118. BIBDAYO1.ZIP    Bibday/2 Version 1 -  OS/2 Specific version (this package)
  119.                                                            
  120. BIBDAYW1.ZIP    Future Windows version of BIBDAY.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. *** Documentation for BIBDAY/2's features and how to set it up ***
  129.  
  130. BIBDAY/2 is very easy to set up.  It is all ready to run and go as is.  You
  131. should have the following files on your disk when you receive BIBDAY/2 (OS/2
  132. version):
  133.  
  134. BIBDAY2.EXE  -  OS/2 executable - main BIBDAY/2 verse display program
  135.                 * run in OS/2 fullscreen mode *
  136. BIBVERSE.DAY  -  text ASCII file containing verses to be displayed (this is
  137.                  the same file format as used by the DOS version of BIBDAY so
  138.                  you can interchange the BIBVERSE.DAY files between versions)
  139. BIBDAY2.DOC  -  Documentation (this file) for BIBDAY/2
  140. BIBCNT2.EXE  -  simple utility to run to count the number of verses in your
  141.                  BIBVERSE.DAY file  (useful when you have added some verses)
  142.                  OS/2 native (fullscreen only)
  143. PAYFORME.DOC  -  text file to be used to order a registered copy of BIBDAY/2
  144.  
  145. If you obtained BIBDAY/2 as a .ZIP format, you will need to unzip it first to
  146. get the above files.
  147.  
  148.  
  149. BIBDAY/2 may be run by simply typing the word BIBDAY2 in the directory where
  150. both the BIBDAY2.EXE program and the BIBVERSE.DAY file reside.
  151.  
  152. BIBDAY2.EXE may also be called from any other directory, batch file, your
  153. startup.cmd file, etc.   Simply specify the program in your PATH statement
  154. or type the complete drive and path to the directory where BIBDAY2.EXE
  155. resides.
  156.  
  157. BIBDAY2.EXE has an optional parameter that can be specified to tell BIBDAY/2
  158. where its BIBVERSE.DAY file is located.  This is useful so you don't have
  159. to have the BIBVERSE.DAY file in the same path/directory where BIBDAY2.EXE is.
  160. Simply use the following format:
  161.  
  162.         BIBDAY2 C:\BIBDAY
  163.  
  164. This command will call up BIBDAY/2 and use the BIBVERSE.DAY file from the
  165. C:\BIBDAY directory.  This is useful if you have different BIBVERSE.DAY files
  166. you want displayed (place them in different directories).  Or you can use
  167. the above line in a batch file to call a special verse file.  Note:  DO NOT
  168. specify the file name as a parameter (only the drive and pathname).  BIBDAY/2
  169. always looks for a file called BIBVERSE.DAY in the directory you specify.
  170.  
  171.  
  172.  
  173. To have a verse be displayed every time you boot up your PC:
  174.  
  175. Place the following line in your startup.cmd file which resides in the
  176. SYSTEM folder under the OS/2 System ICON.  Be sure to use a PAUSE command
  177. to make sure you read your verse display, unless you have other things in your
  178. startup.cmd batch file that will be executing and you can read the display
  179. before it gets erased.  I would run the startup.cmd (or whatever you call
  180. your batch file in the STARTUP directory) in full screen OS/2 mode.
  181. Example of lines in startup.cmd file:
  182.  
  183. C:\BIBDAY\BIBDAY2 C:\BIBDAY
  184. PAUSE
  185.  
  186. assuming that you made a subdirectory on drive C named BIBDAY that contains
  187. both the BIBDAY2.EXE program and the BIBVERSE.DAY file.
  188.  
  189.  
  190.  
  191. To make BIBDAY/2 PAUSE at end of its verse display:
  192. Create a small batch file using an ASCII text editor which runs BIBDAY/2 then
  193. executes the PAUSE command as the next line.  When run, the batch file will
  194. run BIBDAY/2 to display a verse, then will say "Press any key to continue" and
  195. wait for a key to be pressed.  Sample batch file to do this:
  196.  
  197. C:\BIBDAY\BIBDAY2 C:\BIBDAY
  198. PAUSE
  199.  
  200.  
  201.  
  202. Modify the COLORS of the verse text:
  203. You may easily modify the colors that BIBDAY/2 uses to display the text of your
  204. verses.  Using an ASCII text editor change line 3 of the BIBVERSE.DAY file
  205. to be a number from the list below representing the color you want used.
  206. Valid color code numbers are 0 through 31.  Place the number on line 3 by
  207. itself (no other data).  Example:    14
  208. This would use color 14 (Yellow) to display the Bible verse text.  Choose
  209. the color from the following color code table:
  210.  
  211. 0 = Black  (be careful or you may not see black text on a black background)
  212. 1 = Blue   (colors 1-6 are dark versions of colors 9-14)
  213. 2 = Green
  214. 3 = Aqua
  215. 4 = Red
  216. 5 = Purple
  217. 6 = Amber
  218. 7 = White
  219. 8 = Gray
  220. 9 = Light blue
  221. 10 = Light green
  222. 11 = Light aqua
  223. 12 = Light red
  224. 13 = Light purple
  225. 14 = Yellow
  226. 15 = Bright White
  227.  
  228. Colors 16 to 31 are BLINKING versions of the corresponding 0-15 colors.
  229. Example 16 = Blinking Black, 17 = Blinking Blue, 31 = Blinking Bright White.
  230.  
  231. Do not use a color code greater than 31 or less than 0!
  232. Also make sure the color code is on line 3 of the BIBVERSE.DAY file!
  233. If you get all black text then make sure you DO NOT have any invalid text
  234. or number on line 3, it must just have the color number and nothing else.
  235.  
  236.  
  237.  
  238.  
  239. To ADD/DELETE verses from the verse file:
  240. You must make sure that line 4 of the BIBVERSE.TXT file has a single number
  241. alone on the line (nothing else) and it contains the maximum number of
  242. verses in the BIBVERSE.DAY file.  This number starts at 129 when you get
  243. BIBDAY/2 as there are 129 verses in the file.  If you add or delete any verses,
  244. you must manually change this number to reflect the number of verses there
  245. are, or else BIBDAY/2 will not know the correct number of verses to use.  You
  246. may run the BIBCNT2.EXE program to determine the number of valid verses in
  247. the BIBVERSE.DAY file.  The BIBCNT2 program looks for the BIBVERSE.DAY file
  248. in the current directory ONLY.  If it does not find the BIBVERSE.DAY file,
  249. you will get a file not found error message.
  250.  
  251. So to add verses:
  252. Add as many verses as you like in the following format:
  253. verse text may be as many lines as you like, then put a @ character on a line
  254. by itself immediately following each new verse.  This tells BIBDAY/2 when the
  255. end of each verse is.  Make sure you add one @ character per end of verse.
  256. Save your updated BIBVERSE.DAY file and run BIBCNT2 to count the number of
  257. verses.  Then modify Line 4 of the BIBVERSE.DAY to reflect the new number of
  258. verses.  Now you are ready to run BIBDAY/2 with the new verses.
  259.  
  260.  
  261.  
  262. To ENABLE or DISABLE CLEAR SCREEN option:
  263. BIBDAY/2 allows you to either ENABLE CLS or have no CLS before the verse text
  264. is displayed.  This is personal preference and depends when you run BIBDAY/2.
  265. This option is specified in Line 2 of the BIBVERSE.DAY file.  On line 2 put
  266. either CLS or NOCLS.  These are case sensative, they must be upper case only.
  267. Put CLS by itself on line 2 to clear the screen before the verse is displayed
  268. and put NOCLS to not clear the screen before the verse is displayed.
  269.  
  270.  
  271.  
  272. Format of your BIBVERSE.DAY file(s):
  273.  
  274. Line 1         Copyright message - DO NOT CHANGE THIS LINE
  275. Line 2         CLS    or    NOCLS   (left justified)
  276. Line 3         14                         Color number only (no text)
  277. Line 4         129                        Maximum number of verses (number)
  278. Line 5-end     Verse text
  279.  
  280. ***  Make sure your put an @ character on a line by itself after every
  281. verse to be displayed when adding new verses to the BIBVERSE.DAY file.
  282.  
  283.  
  284. --------
  285. This BIBDAY/2 program is dedicated to GOD, who through His Son, Jesus Christ,
  286. has saved all who will call on the name of Jesus.  It is my sincere desire
  287. that you will be blessed by God's Word as presented in these scripture
  288. verses, and you will call on Jesus Christ as your personal Lord and Saviour.
  289. It is also dedicated to my loving and supportive wife, Jodi.
  290. --------
  291.  
  292.  
  293.  
  294. Please send your comments, registrations, inquiries to the author:
  295.  
  296. Robert Woeger
  297. 2423 Hagerman St.
  298. Colorado Springs, CO 80904-3328  USA         Phone (719) 471-8306
  299.                                              CompuServe 71204, 605
  300.  
  301. Please share this shareware version with others and register it yourself
  302. if you like it (see PAYFORME.DOC to register).  Thank You! - Robert Woeger
  303.  
  304.