home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / religion / bvd404.zip / BIBLEV.DOC < prev    next >
Text File  |  1992-06-16  |  13KB  |  307 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.               /--------------------------------------------------------\
  10.               | BIBLEV.DOC - Documentation for BIBLEV.EXE Version 4.04 |
  11.               |              (C)opyright 1992 MorriSoft                |
  12.               \--------------------------------------------------------/
  13.  
  14.  
  15.      PURPOSE
  16.      -------
  17.  
  18.           BIBLEV is a program that will display  a BIBLE Verse on your IBM PC or
  19.           other  MS-DOS  compatible  computer,   utilizing  a  variety  of  user
  20.           configurable output options.
  21.  
  22.  
  23.      REQUIRED FILES
  24.      --------------
  25.  
  26.           BIBLEV.EXE   - The main program file.
  27.           BIBLEV.DAY   - The verse file.
  28.           BIBLEV.CFG   - The  configuration   file  used  to  store  your  color
  29.                          preferences, font choices, etc.
  30.           VGA16.BGI    - Graphics  device  driver used  for  SVGA,  VGA and  EGA
  31.                          graphics modes.   CGA, Hercules, and  Text mode support
  32.                          are built into the program file.
  33.           BIBLEV.DOC   - This documentation file.
  34.           REVISION.DOC - File listing changes to BIBLEV  from previous versions.
  35.                          Look here to find what's new.
  36.           REGISTER.DOC - Registration form for BIBLEV.
  37.  
  38.  
  39.      RUNNING BIBLEV.EXE
  40.      ------------------
  41.  
  42.           The program can be run from the command prompt by  typing "BIBLEV", or
  43.           can easily be added  to a batch file.  BIBLEV must either  be in the  
  44.           current directory,  or in  a directory  specified as  part of the  DOS
  45.           path.
  46.  
  47.           In a batch file, such  as the AUTOEXEC.BAT file, you could  run BIBLEV
  48.           in the following fashion. This example assumes that you have copied   
  49.           all of the files for BIBLEV  into a directory called "C:\BIBLEV",  but
  50.           any directory can be used.
  51.  
  52.           For example:
  53.                          .
  54.                          .
  55.                          PATH = C:\;C:\DOS;C:\BIBLEV;C:\UTILITY
  56.                          BIBLEV
  57.                          .
  58.                          .
  59.  
  60.  
  61.  
  62.                                           1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           By  setting the  DOS  path to  include  the directory  containing  the
  71.           program, BIBLEV can now be run from any directory on your hard disk.
  72.  
  73.           Note  that BIBLEV will search all directories  in the DOS path for its
  74.           data  files.  Therefore, for fastest performance, if  you use a long  
  75.           PATH statement, try  to place the directory containing  BIBLEV towards
  76.           the beginning of the PATH.
  77.  
  78.           NOTE:     If you are replacing an older version of BIBLEV (any version
  79.                     prior to 3.00), you will need to delete the old 'BIBLEV.COM'
  80.                     program file before you can use the new program.
  81.  
  82.  
  83.      USER SELECTABLE OPTIONS
  84.      -----------------------
  85.  
  86.           Two user selectable modes of operation:
  87.           --------------------------------------
  88.  
  89.                "Daily Verse" mode
  90.                ------------------
  91.                When in this mode, BIBLEV  will use the DOS date on your PC  to  
  92.                determine the verse to use, and then will print that verse from  
  93.                the BIBLEV.DAY verse file.  The verse will be the same each time 
  94.                run that day.  After using all of the verses in BIBLEV.DAY, the  
  95.                program will start over again.
  96.  
  97.                "Random Verse" mode
  98.                -------------------
  99.                In  random mode BIBLEV.EXE will randomly select one of the tagged
  100.                verses  in the verse file.  Since  it is entirely random, and not
  101.                based on date, the verse will be different each time run, even on
  102.                the same day.
  103.  
  104.           User selectable time-out value:
  105.           ------------------------------
  106.           After  displaying a  verse,  BIBLEV normally  waits for  a  key to  be
  107.           pressed before exiting.  Also, if a verse is longer than one screen, a
  108.           "MORE"  prompt is  displayed, and the  program waits  for the  user to
  109.           press  a key.  The user can  specify the number of minutes and seconds
  110.           to  wait for  a keypress,  or even  specify that BIBLEV  wait forever.
  111.           This option is useful if you use BIBLEV in your AUTOEXEC.BAT file, and
  112.           want the  computer to be  able to boot up  without you being  there to
  113.           press a key.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                           2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           Three different user selectable output modes:
  132.           --------------------------------------------
  133.  
  134.                Standard Text (BIOS) output:
  135.                ---------------------------
  136.                This  mode of output uses  the standard BIOS  routines built into
  137.                your  computer  to perform  text screen  output.   The  colors in
  138.                effect at  the DOS  prompt when BIBLEV  is invoked will  be used.
  139.                This output mode should be used if you are redirecting the output
  140.                of BIBLEV to  a file or printer.   Also use this mode  if you are
  141.                using a "screen reader" program of some type, such  as those used
  142.                by vision impaired members  of the computing community.   For use
  143.                in this mode of operation  is the command line parameter  "N" (No
  144.                Title),  which  will suppress  the  program  title and  copyright
  145.                display.   Also available is  the "D" (Don't  Wait) option, which
  146.                will suppress the "More" and "Press any key" prompts.
  147.  
  148.                Color Text (Direct Video) output:
  149.                --------------------------------
  150.                This mode of output requires 100% IBM compatible video hardware, 
  151.                and utilizes  direct video  writes to  provide color  text screen
  152.                output.  This mode is available for Monochrome displays, but will
  153.                only provide black  and white output.  The  primary users of this
  154.                mode will probably by the  owners of CGA displays and  adapters. 
  155.                Owners of higher  resolution Super  VGA, VGA, EGA  and Hercules  
  156.                display adapters  will probably want  to use the  Graphics output
  157.                mode.
  158.  
  159.                Graphics output:
  160.                ---------------
  161.                BIBLEV  provides an  optional graphics-based  interface!   If you
  162.                select this option,  you will  be provided  with a  menu of  nine
  163.                attractive vector  screen fonts, with user  configurable size and
  164.                color.  An on-screen menu and sample output assist you in  making
  165.                a  selection.   Support  is provided  for  Super VGA,  VGA,  EGA,
  166.                Hercules  MGA, and CGA display  adapters.  With  the exception of
  167.                Super VGA, the display type is automatically detected by  BIBLEV.
  168.                If you  do not desire to  use this feature, simply  choose one of
  169.                the text mode display options when in the configuration menus.
  170.  
  171.                NOTE:     The  graphics mode  fonts  were  designed  for  optimum
  172.                          appearance on  a high  resolution video display.   Some
  173.                          fonts may be unreadable  on a CGA adapter.  Due  to the
  174.                          limited pixels on a CGA  display, the parameter "N" can
  175.                          be used to suppress Title and Copyright Display.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                           3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      RUNNING SETUP
  193.      -------------
  194.  
  195.           To configure BIBLEV.EXE, run with the command line option "S".  I.e.,
  196.  
  197.                C> BIBLEV S
  198.  
  199.           This will invoke BIBLEV in the 'Setup' mode.  You will first be  asked
  200.           for the  mode of operation.   After selecting the 'Daily'  or 'Random'
  201.           mode, you will then be asked to enter a time-out  value in minutes and
  202.           seconds.   Enter the length of time that you would like BIBLEV to wait
  203.           for a key to be pressed, or enter '0:0' to wait forever.  Next, choose
  204.           the display output mode: 'Standard Text',  'Color Text' or 'Graphics'.
  205.           If  'Standard Text'  is chosen,  you are  done with  setup.   Choosing
  206.           'Color Text' brings up a screen that allows you  to set the colors you
  207.           prefer  in text mode.  If 'Graphics' mode is chosen, you will be given
  208.           a choice  of ten  fonts or  typestyles, as  well as  a the  ability to
  209.           change  the  size  of  the  displayed  characters.    After  making  a
  210.           selection,  you  will  then  be  given  a  choice  of  foreground  and
  211.           background colors.
  212.  
  213.           The  program will then count the number  of tagged verses in the verse
  214.           file, and write this information to the BIBLEV.CFG file.
  215.  
  216.  
  217.      ADDING OR CHANGING VERSES
  218.      -------------------------
  219.  
  220.           All  verses are contained in  the file BIBLEV.DAY  (for BIBLE Verse of
  221.           the Day).  This file is simply  an ASCII text file, and can be  edited
  222.           with any ASCII  text editor (almost any text editor  or word processor
  223.           for the  PC can edit ASCII files).   Just make sure  that you save the
  224.           file again in ASCII format  - if in some other strange  format, BIBLEV
  225.           will NOT work properly!
  226.  
  227.           Each verse in the file MUST be marked, or tagged, with an asterisk (*)
  228.           if you want it to  be used by BIBLEV.  The file is  very freeform, and
  229.           has no strict format.  Verses can  be as long as you desire, as BIBLEV
  230.           will pause when a verse is longer than one screen.  I  would recommend
  231.           not  setting the margins wider than 80 if you are using text mode.  If
  232.           you are using graphics mode, automatic word-wrap has been implemented,
  233.           so margins won't matter as much.
  234.  
  235.           BIBLEV now  automatic detects changes  in the size of  the Verse file!
  236.           After adding new verses, or deleting old verses, the next time  BIBLEV
  237.           is run, it will go into an automatic setup mode to count the number of
  238.           verses  in the  verse file.    The program  will then  proceed to  run
  239.           normally.
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                           4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.      COMMAND LINE PARAMETERS
  254.      -----------------------
  255.  
  256.           S    -    <Setup> Starts BIBLEV in Setup mode.
  257.  
  258.           N    -    <No  Title> Runs BIBLEV  in normal mode,  and suppresses the
  259.                     display  of  Title and  Copyright  notices.   Only  valid if
  260.                     configured for  Standard Text output or  if running Graphics
  261.                     mode on a CGA display.
  262.  
  263.           D    -    <Don't Wait>  Runs BIBLEV in normal mode, and suppresses the
  264.                     "More" and "Press any key" messages, and ignores the timeout
  265.                     setting.   The program  exits immediately, without  pausing.
  266.                     This option is only available in Standard (BIOS)  Text mode,
  267.                     and is intended primarily for use when redirecting output to
  268.                     a DOS file or printer.
  269.  
  270.           ND   -    Combine the "Don't Wait" and "No Title" options.
  271.  
  272.  
  273.      TECHNICAL SUPPORT
  274.      -----------------
  275.  
  276.           Questions, comments and  suggestions concerning BIBLEV can be  sent to
  277.           GEnie address JMORRIS or  CompuServe address 73670,762.  If you do not
  278.           have access to either of these two services, write to:
  279.  
  280.                                       MorriSoft
  281.                                  206 Attleboro Court
  282.                             Meridianville, AL  35759-2244
  283.  
  284.  
  285.      REMARKS
  286.      -------
  287.  
  288.           BIBLEV  and its associated programs  are written in  C++, and compiled
  289.           with Borland's Turbo C++ Compiler.
  290.  
  291.           BIBLEV and all associated programs and data files are provided 'as is'
  292.           with no expressed warranty of any kind.  MorriSoft is in no way liable
  293.           for any damages, real or imagined, received thereof.
  294.  
  295.  
  296.      P.S.
  297.      ----
  298.  
  299.           Lastly, ENJOY!  I hope many people find this program of some use,  and
  300.           that it helps you grow in the Word even while using your computer!
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                           5
  307.