
BIBLEVRS v1.01 - Display a Bible verse at random.

    Purpose:
        This program is intended to provide a little inspiration by
        displaying a random Bible verse, and to help you memorize
        scripture by repeating special verses until you have them.

    Installation:
        None required, beyond putting BIBLEVRS.EXE and BIBLEVRS.TXT someplace
        where DOS can find it.

    Status:
        Freeware.

    Distribution:
        Distribute freely to whomever you want, for whatever reason.

    ______________________________________________________________________

    HOW TO USE BIBLEVRS:

    If you simply type BIBLEVRS with no arguments, you will get a bible
    verse selected at random from BIBLEVRS.TXT, which is presumed to be in
    either the current directory or the one where BIBLEVRS.EXE is located.

    When you see one you particularly like, you can select it for memoriz-
    ation (see -m switch, below) and it will be repeated each time the
    program runs.  Verses can be selected by number (see -n switch).

    The following is a summary of all recognized command line switches:

        -fX     Get verses out of file "X".
        -n123   Force verse no. 123 to be selected.
        -m      Memorize the last verse displayed.  Using this command
                will cause the last verse to be displayed repeatedly
                until you make it stop by using -r to return to random
                selection.  You can use -n to force a particular verse
                while memorization is in effect, and memorization will
                continue afterward.
        -m123   Memorize verse number 123.
        -r      Randomize (cancel memorization).
        -l      Repeat last verse.
        -s      Show verse number.
        -c      Count verses and update the COUNT=x line.
        -?      Display help information.
        -??     Display verse file information.


    Verse file format:

    The verse file is a simple text file containing commands and verses.
    The command section comes first, and may contain:
        CLS             Clear screen first.
        COUNT=nnnnn     Where nnnnn is the number of verses on file.
        LAST=nnnnn      Last verse displayed.  If this line is not present,
                        you will not be able to use the /m command to
                        memorize the last verse automatically.
        MEMORIZE=nnnnn  Verse number to memorize.  If this line is not
                        present, verse memorization will be disabled.
        Comments        Any line starting with '#'.  Comments can also be
                        included in the verse section.

    Please note that the COUNT, LAST, and MEMORIZE lines should not be
    changed by hand.  If you do change them, make sure they are entered
    exactly as shown, with a five-digit, zero-filled number on the right
    of the equal sign.

    Following the command section are verses. Each verse must be preceded
    by a line starting with '>' and the chapter/verse.  For example:

        >John 3:16
        For God so loved the world that he gave his only begotten Son,
        that whosoever believeth in him should not perish, but have
        everlasting life.

    All lines after the chapter/verse and before the next chapter/verse
    will be displayed as part of the verse.

    Put as many verses as you like, as long as it's no more than 32,767.
    (Actually, I don't think there are that many in the whole bible!)
    Use -c to update the count whenever you add or delete verses.

    ______________________________________________________________________

    DISCLAIMER:

    This program is not guaranteed to do anything except occupy space on
    your disk.  I will not be held responsible for your inability to use
    it, nor for my own bumbling ineptness in writing it, because after all,
    it's free.

    ______________________________________________________________________

    SOURCE CODE NOTES:

    This program was written on a clunky old AT (c.1985) under MSDOS v6,
    and it should run on any DOS machine known to man.  It was compiled
    with Zortech C++ v3.0r4.  I don't think there's any compiler-specific
    stuff (DOS-specific either, for that matter), with the exception of
    the random number selection routines in RANDDOS.CPP.  These are used
    because they are faster than those in RANDOM.CPP, which use functions
    from the ANSI C standard library.  If you use RANDOM.CPP, the code
    should compile and run on pretty much any system with a C++ compiler.

    I know there's a copyright message in the code, but that's just force
    of habit.  Feel free to use the executable or the source in any way
    you want.



    --Dave Nelson, 11-Aug-1999

      Comments or questions to: davidsnelson@yahoo.com



    BTW:    Jesus is coming soon -- get right, or get left!
