home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR46
/
BIBDAYO1.ZIP
/
BIBDAY2.DOC
< prev
next >
Wrap
Text File
|
1993-11-18
|
14KB
|
304 lines
BIBDAY/2 - Bible verse of the day program for OS/2 - (c) 1993 by Robert Woeger
All rights reserved
OS/2 Specific Version
[DOS Version available separately]
*** Summary of BIBDAY/2 ***
BIBDAY/2 Version 1.0 is a useful Bible Verse of the day program. It displays
a random Bible Verse each time it is run. It will help to brighten your day
and pick you up. You can set the BIBDAY/2 program to run every time you boot
your system if you like. That way your PC will greet you with a message
of encouragement and inspiration each time you turn it on. You can also
use it to display a verse when you run certain applications or batch files
also. It has many uses. You can configure the color of the text of the
Bible Verses also. You can optionally have it clear the screen before the
verses are displayed. You can add your own Bible Verses by using a standard
ASCII text editor such as EPM. That way you can see your favorite verses
each time you run BIBDAY/2. You can choose to pause the screen after the
verse is displayed or let the screen scroll.
*** Distribution of BIBDAY/2/Cost of BIBDAY/2 ***
This version, BIBDAY/2 1.0, is distributed using the shareware software
distribution method. The author, Robert Woeger, owns the copyright on this
program and will allow anyone to distribute the BIBDAY/2 program as long as the
following simple rules are followed:
1) All people are encouraged to give copies of this shareware
version of BIBDAY/2 away to others. You may charge a reasonable disk
duplication fee if you are a shareware vendor (not to exceed $8/disk).
CD-ROM publishers are free to include BIBDAY/2 on their shareware
CD-ROMs. On-line services and bulletin board systems may freely
distribute the shareware version of BIBDAY/2 even if they charge an
access fee to use their systems. You may not sell copies of BIBDAY/2 -
only the author may receive payment for use of BIBDAY/2.
2) You may use this program for a trial period not to exceed 30
days. At the end of the 30 day trial period you must either pay
the author, Robert Woeger, for the right to continue to use the
program or stop using BIBDAY/2 altogether. Upon payment to the author
you will receive a special registered version of BIBDAY/2 that does
not have the "Unregistered shareware version line" at the top of the
screen, plus you will receive the latest version of BIBDAY/2. Also
you will know that you have done the right moral and legal thing.
As the Bible says "For the worker is worth his wages" Luke 10:7, and
the author has the legal right to expect payment for his work in
writing this program.
3) Tell others about BIBDAY/2! Give it away to help spread God's
Word into other people's lives. If you or your church or ministry
would like a special registered version of BIBDAY/2 to distribute as
part of your evangelism or fund raising program(s) please contact the
author for details. I am very receptive to working with ministries
and churches about licensing BIBDAY/2 for your fund-raising or
evangelism needs. This special registered version of BIBDAY/2 I have
available is a pre-paid license so people you send it to or give it
to don't have to pay me an additional shareware fee.
4) You MAY NOT distribute any other versions of BIBDAY/2 to others
(i.e. Registered version, Special Evangelism version, etc.) unless
you have a special license from the author to do so. This shareware
version is the ONLY version that you may distribute. If the logo on
the top of the display says registered copy, please do not distribute
it. Thank You.
5) This program and all its files are distributed on an "AS IS" basis
with no warranties provided. The author has tested the programs on
his PC but can not vouch to how they will act on your computer. The
author will in no way be liable for any accidental damage or misuse
caused by these programs.
6) When you distribute this shareware version of BIBDAY/2 to others,
you MUST ONLY distribute the original files that came with BIBDAY/2.
You MAY NOT add, remove, or modify any of the files you give to
others! That includes the BIBVERSE.DAY text verse file! You may
modify the BIBVERSE.DAY file for use on your own PC and for use
on machines you have a registered licensed copy of BIBDAY/2 for, but
you MAY NOT distribute modified copies of BIBVERSE.DAY or the other
program files included with the BIBDAY/2 package. Disk vendors may add
their own supplemental documentation or information files to the disk
but may not modify or delete any of the original distribution files.
*** Note: The following references are made immediately following the
Bible verse reference to specify which version of the Bible the verse is
taken from. Each version except the King James Version is copyrighted
and is used by permission of the respective publisher of that version.
[KJV] - King James Version
[NKJV] - New King James Version
[NIV] - New International Version
You may contact the author in the following ways:
Mail: Robert Woeger, 2423 Hagerman St., Colorado Springs, CO 80904-3228 USA
Phone: (719) 471-8306 days or evenings
CompuServe Email address: 71204,605
Internet Email: 71204.605@compuserve.com
See the PAYFORME.DOC file to register (pay for) your copy of BIBDAY/2.
The BIBDAY/2 program is shipping in both DOS and native OS/2 versions. In
the near future a Windows specific version is planned to be released. Look
on your favorite BBS for new versions of all the BIBDAY programs.
Filename formats for distribution are currently:
BIBDAYD1.ZIP Bibday Version 1 - DOS Specific version (available in a
separate package)
BIBDAYO1.ZIP Bibday/2 Version 1 - OS/2 Specific version (this package)
BIBDAYW1.ZIP Future Windows version of BIBDAY.
*** Documentation for BIBDAY/2's features and how to set it up ***
BIBDAY/2 is very easy to set up. It is all ready to run and go as is. You
should have the following files on your disk when you receive BIBDAY/2 (OS/2
version):
BIBDAY2.EXE - OS/2 executable - main BIBDAY/2 verse display program
* run in OS/2 fullscreen mode *
BIBVERSE.DAY - text ASCII file containing verses to be displayed (this is
the same file format as used by the DOS version of BIBDAY so
you can interchange the BIBVERSE.DAY files between versions)
BIBDAY2.DOC - Documentation (this file) for BIBDAY/2
BIBCNT2.EXE - simple utility to run to count the number of verses in your
BIBVERSE.DAY file (useful when you have added some verses)
OS/2 native (fullscreen only)
PAYFORME.DOC - text file to be used to order a registered copy of BIBDAY/2
If you obtained BIBDAY/2 as a .ZIP format, you will need to unzip it first to
get the above files.
BIBDAY/2 may be run by simply typing the word BIBDAY2 in the directory where
both the BIBDAY2.EXE program and the BIBVERSE.DAY file reside.
BIBDAY2.EXE may also be called from any other directory, batch file, your
startup.cmd file, etc. Simply specify the program in your PATH statement
or type the complete drive and path to the directory where BIBDAY2.EXE
resides.
BIBDAY2.EXE has an optional parameter that can be specified to tell BIBDAY/2
where its BIBVERSE.DAY file is located. This is useful so you don't have
to have the BIBVERSE.DAY file in the same path/directory where BIBDAY2.EXE is.
Simply use the following format:
BIBDAY2 C:\BIBDAY
This command will call up BIBDAY/2 and use the BIBVERSE.DAY file from the
C:\BIBDAY directory. This is useful if you have different BIBVERSE.DAY files
you want displayed (place them in different directories). Or you can use
the above line in a batch file to call a special verse file. Note: DO NOT
specify the file name as a parameter (only the drive and pathname). BIBDAY/2
always looks for a file called BIBVERSE.DAY in the directory you specify.
To have a verse be displayed every time you boot up your PC:
Place the following line in your startup.cmd file which resides in the
SYSTEM folder under the OS/2 System ICON. Be sure to use a PAUSE command
to make sure you read your verse display, unless you have other things in your
startup.cmd batch file that will be executing and you can read the display
before it gets erased. I would run the startup.cmd (or whatever you call
your batch file in the STARTUP directory) in full screen OS/2 mode.
Example of lines in startup.cmd file:
C:\BIBDAY\BIBDAY2 C:\BIBDAY
PAUSE
assuming that you made a subdirectory on drive C named BIBDAY that contains
both the BIBDAY2.EXE program and the BIBVERSE.DAY file.
To make BIBDAY/2 PAUSE at end of its verse display:
Create a small batch file using an ASCII text editor which runs BIBDAY/2 then
executes the PAUSE command as the next line. When run, the batch file will
run BIBDAY/2 to display a verse, then will say "Press any key to continue" and
wait for a key to be pressed. Sample batch file to do this:
C:\BIBDAY\BIBDAY2 C:\BIBDAY
PAUSE
Modify the COLORS of the verse text:
You may easily modify the colors that BIBDAY/2 uses to display the text of your
verses. Using an ASCII text editor change line 3 of the BIBVERSE.DAY file
to be a number from the list below representing the color you want used.
Valid color code numbers are 0 through 31. Place the number on line 3 by
itself (no other data). Example: 14
This would use color 14 (Yellow) to display the Bible verse text. Choose
the color from the following color code table:
0 = Black (be careful or you may not see black text on a black background)
1 = Blue (colors 1-6 are dark versions of colors 9-14)
2 = Green
3 = Aqua
4 = Red
5 = Purple
6 = Amber
7 = White
8 = Gray
9 = Light blue
10 = Light green
11 = Light aqua
12 = Light red
13 = Light purple
14 = Yellow
15 = Bright White
Colors 16 to 31 are BLINKING versions of the corresponding 0-15 colors.
Example 16 = Blinking Black, 17 = Blinking Blue, 31 = Blinking Bright White.
Do not use a color code greater than 31 or less than 0!
Also make sure the color code is on line 3 of the BIBVERSE.DAY file!
If you get all black text then make sure you DO NOT have any invalid text
or number on line 3, it must just have the color number and nothing else.
To ADD/DELETE verses from the verse file:
You must make sure that line 4 of the BIBVERSE.TXT file has a single number
alone on the line (nothing else) and it contains the maximum number of
verses in the BIBVERSE.DAY file. This number starts at 129 when you get
BIBDAY/2 as there are 129 verses in the file. If you add or delete any verses,
you must manually change this number to reflect the number of verses there
are, or else BIBDAY/2 will not know the correct number of verses to use. You
may run the BIBCNT2.EXE program to determine the number of valid verses in
the BIBVERSE.DAY file. The BIBCNT2 program looks for the BIBVERSE.DAY file
in the current directory ONLY. If it does not find the BIBVERSE.DAY file,
you will get a file not found error message.
So to add verses:
Add as many verses as you like in the following format:
verse text may be as many lines as you like, then put a @ character on a line
by itself immediately following each new verse. This tells BIBDAY/2 when the
end of each verse is. Make sure you add one @ character per end of verse.
Save your updated BIBVERSE.DAY file and run BIBCNT2 to count the number of
verses. Then modify Line 4 of the BIBVERSE.DAY to reflect the new number of
verses. Now you are ready to run BIBDAY/2 with the new verses.
To ENABLE or DISABLE CLEAR SCREEN option:
BIBDAY/2 allows you to either ENABLE CLS or have no CLS before the verse text
is displayed. This is personal preference and depends when you run BIBDAY/2.
This option is specified in Line 2 of the BIBVERSE.DAY file. On line 2 put
either CLS or NOCLS. These are case sensative, they must be upper case only.
Put CLS by itself on line 2 to clear the screen before the verse is displayed
and put NOCLS to not clear the screen before the verse is displayed.
Format of your BIBVERSE.DAY file(s):
Line 1 Copyright message - DO NOT CHANGE THIS LINE
Line 2 CLS or NOCLS (left justified)
Line 3 14 Color number only (no text)
Line 4 129 Maximum number of verses (number)
Line 5-end Verse text
*** Make sure your put an @ character on a line by itself after every
verse to be displayed when adding new verses to the BIBVERSE.DAY file.
--------
This BIBDAY/2 program is dedicated to GOD, who through His Son, Jesus Christ,
has saved all who will call on the name of Jesus. It is my sincere desire
that you will be blessed by God's Word as presented in these scripture
verses, and you will call on Jesus Christ as your personal Lord and Saviour.
It is also dedicated to my loving and supportive wife, Jodi.
--------
Please send your comments, registrations, inquiries to the author:
Robert Woeger
2423 Hagerman St.
Colorado Springs, CO 80904-3328 USA Phone (719) 471-8306
CompuServe 71204, 605
Please share this shareware version with others and register it yourself
if you like it (see PAYFORME.DOC to register). Thank You! - Robert Woeger