home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / religion / bvd410.zip / BIBLEV.DOC < prev    next >
Text File  |  1993-10-01  |  22KB  |  524 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 BIBLE Verse of the Day
  10.  
  11.                                      Version 4.10
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                      User's Guide
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                       MorriSoft
  34.                                  206 Attleboro Court
  35.                              Meridianville, AL 35759-2244
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.           BIBLE Verse of the Day Version 4.10                  User's Guide
  44.  
  45.           Introduction
  46.  
  47.                Greetings, and  welcome to BIBLEV  4.10!  BIBLEV  (short for
  48.                BIBLE Verse of  the day) is  a program that  will display  a
  49.                BIBLE Verse  on  your  IBM PC  or  other  MS-DOS  compatible
  50.                computer.   BIBLEV has  many customizable  options, allowing
  51.                you  to tailor its  operation to  suit your  personal taste,
  52.                with  its primary goal being  to give you  a spiritual boost
  53.                periodically, as you use your computer.
  54.  
  55.           Features
  56.  
  57.                -    Automated installation.
  58.                -    Virtually  unlimited verse  capacity  (up to  2 billion
  59.                     verses).
  60.                -    Verse file can be modified with any ASCII text editor.
  61.                -    Choice of  random or  daily  verse display.   In  daily
  62.                     mode,  the  same verse  will  be  displayed every  time
  63.                     BIBLEV is run on a specific date.
  64.                -    A  selection  of  favorite verses  supplied,  from  the
  65.                     Revised Standard Version (RSV).
  66.                -    Current date and time display.
  67.                -    Support for BIOS text, color text, and graphics display
  68.                     modes.
  69.                -    Colors  are  customizable  in color  text  and graphics
  70.                     display modes.
  71.                -    Variety of attractive screen fonts available in graphic
  72.                     display mode.
  73.                -    Super  VGA support  for 800x600  and 1024x768  graphics
  74.                     modes.
  75.                -    User specified time-out allows unattended  reboot, when
  76.                     BIBLEV is executed from AUTOEXEC.BAT.
  77.                -    Screen-reader  compatible (in BIOS  text mode), for the
  78.                     visually impaired.
  79.                -    Options  that  aid  use  by  BBS  sysops  (i.e.  can be
  80.                     redirected to a DOS file or device).
  81.  
  82.  
  83.           System Requirements
  84.  
  85.                -    8088, 80x86 or Pentium based PC.
  86.                -    MS-DOS  3.1 or greater, PC-DOS 3.1 or later, DR DOS 5.0
  87.                     or later.
  88.                -    360KB or greater floppy drive, although a hard disk  is
  89.                     strongly recommended.
  90.                -    Any PC compatible video display.
  91.                -    512KB RAM.
  92.  
  93.  
  94.  
  95.  
  96.                                                                      Page 1
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.           BIBLE Verse of the Day Version 4.10                  User's Guide
  105.  
  106.           Required Files
  107.  
  108.                INSTALL.EXE    -    Install program for BIBLEV.
  109.                BIBLEV.EXE     -    The main program file.
  110.                BIBLEV.DAY     -    The verse file.
  111.                BIBLEV.CFG     -    The  configuration  file  used to  store
  112.                                    your  color  preferences, font  choices,
  113.                                    etc.
  114.                SVGA16.BGI     -    Graphics  device  driver used  for SVGA,
  115.                                    VGA  and  EGA  graphics  modes.     CGA,
  116.                                    Hercules,  and  Text  mode  support  are
  117.                                    built into the program file.
  118.                BIBLEV.DOC     -    This documentation file,  in ASCII  text
  119.                                    format.
  120.                REVISION.DOC   -    File  listing  changes  to  BIBLEV  from
  121.                                    previous versions, in ASCII text format.
  122.                                    Look here to find what's new.
  123.                REGISTER.DOC   -    Registration form for  BIBLEV, in  ASCII
  124.                                    text format.
  125.  
  126.  
  127.           Installation
  128.  
  129.                BIBLEV 4.10 is  the first version of BIBLEV to  ship with an
  130.                automated installation utility.   To install BIBLEV,  follow
  131.                one of the following two procedures:
  132.  
  133.                1.   If  installing from  a  register BIBLEV  floppy, simply
  134.                     insert  the  floppy   diskette  into  the   appropriate
  135.                     diskette drive,  change to that drive  letter, and type
  136.                     "INSTALL".    For example,  if the  BIBLEV installation
  137.                     floppy  is  in  drive  A:,  then  you  would  type  the
  138.                     following:
  139.  
  140.                          C:\> A:                  [PRESS ENTER]
  141.                          A:\> INSTALL             [PRESS ENTER]
  142.  
  143.                2.   If you downloaded BIBLEV from a BBS or other electronic
  144.                     service, you  have obviously unzipped  the distribution
  145.                     file at this point.  Simply change to the directory you
  146.                     unzipped BIBLEV into, and type "INSTALL".  For example,
  147.                     if you  unzipped the files into  the directory C:\TEMP,
  148.                     you would type:
  149.  
  150.                          C:\> CD \TEMP                 [PRESS ENTER]
  151.                          C:\TEMP> INSTALL              [PRESS ENTER]
  152.  
  153.  
  154.  
  155.  
  156.  
  157.                                                                      Page 2
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.           BIBLE Verse of the Day Version 4.10                  User's Guide
  166.  
  167.                INSTALL will walk you though installing BIBLEV.  Simply read
  168.                and follow the directions on the screen.  If in doubt, press
  169.                ENTER to take the default answer (if there is one), or refer
  170.                to the Options section of this document.
  171.  
  172.  
  173.           Configuration
  174.  
  175.                BIBLEV  has  many user-configurable  options.    If you  are
  176.                installing BIBLEV using the automated  INSTALL program, then
  177.                BIBLEV  Setup  will  be  run  automatically  (with  possible
  178.                exceptions on systems with limited free DOS memory).  If you
  179.                are manually installing BIBLEV, or simply want to change the
  180.                original choices you  made, you can  invoke BIBLEV in  Setup
  181.                mode by typing the following at the DOS prompt:
  182.  
  183.                          BIBLEV S
  184.  
  185.                This will invoke BIBLEV in the 'Setup'  mode.  You will then
  186.                be  prompted  with  a series  of  screens,  allowing you  to
  187.                customize  the operation and appearance of  BIBLEV.  In most
  188.                cases,  the  on-screen  text  should   be  self-explanatory.
  189.                However, if you are  unsure of what to  do, please refer  to
  190.                the  next section: "OPTIONS".  Please note that based on the
  191.                detected  hardware on  your  system, and  the decisions  you
  192.                make, not all of these options may be available.
  193.  
  194.  
  195.           Options
  196.  
  197.                Two user selectable modes of operation:
  198.  
  199.  
  200.                     "Daily Verse" mode
  201.  
  202.                     When in this mode, BIBLEV will use the DOS date on your
  203.                     PC to     determine  the verse  to use,  and then  will
  204.                     display that verse from the BIBLEV.DAY verse file.  The
  205.                     verse will be the same each  time  run that day.  After
  206.                     using  all of the verses  in BIBLEV.DAY, the    program
  207.                     will cycle back to the beginning of the verse file.
  208.  
  209.                     "Random Verse" mode
  210.  
  211.                     In random mode BIBLEV  will randomly select one of  the
  212.                     verses in  the verse  file.   Since verse  selection is
  213.                     entirely random, and not based on  date, the verse will
  214.                     be different  each  time  run,  even on  the  same  day
  215.                     (unless the same verse is randomly selected twice!).
  216.  
  217.  
  218.                                                                      Page 3
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.           BIBLE Verse of the Day Version 4.10                  User's Guide
  227.  
  228.                User selectable time-out value:
  229.  
  230.                     After displaying  a verse, BIBLEV normally  waits for a
  231.                     key to be pressed before exiting.  Also, if a  verse is
  232.                     longer than  one screen, a "MORE"  prompt is displayed,
  233.                     and the program waits for the user to press a key.  The
  234.                     user can specify the number  of minutes and seconds  to
  235.                     wait  for a key press, or even specify that BIBLEV wait
  236.                     forever (by  entering '0:0'). This option  is useful if
  237.                     you use BIBLEV in your  AUTOEXEC.BAT file, and want the
  238.                     computer  to be able to boot up without you being there
  239.                     to press a key.
  240.  
  241.                Three different user selectable output modes:
  242.  
  243.                     Standard Text (BIOS) output:
  244.  
  245.                     This  mode of  output uses  the standard  BIOS routines
  246.                     built into your computer to perform text screen output.
  247.                     The colors in effect  at the DOS prompt when  BIBLEV is
  248.                     invoked  will be used. This output  mode should be used
  249.                     if you are redirecting  the output of BIBLEV to  a file
  250.                     or printer.   Also  use this  mode if  you are using  a
  251.                     "screen  reader" program  of some  type, such  as those
  252.                     used  by  vision  impaired  members  of  the  computing
  253.                     community,  or   if  you   intend  to  use   BIBLEV  in
  254.                     conjunction  with a  BBS.   For  use  in this  mode  of
  255.                     operation is the command line parameter "N" (No Title),
  256.                     which  will suppress  the program  title and  copyright
  257.                     display.    Also  available  is the  "D"  (Don't  Wait)
  258.                     option, which  will suppress the "More"  and "Press any
  259.                     key" prompts.
  260.  
  261.  
  262.                     Color Text (Direct Video) output:
  263.  
  264.                     This mode of output  requires 100% IBM compatible video
  265.                     hardware,  and utilizes  direct video writes to provide
  266.                     color  text screen output.  This  mode is available for
  267.                     Monochrome  displays, but will  only provide  black and
  268.                     white  output.   The primary  users of  this  mode will
  269.                     probably by  the owners  of CGA displays  and adapters.
  270.                     Owners  of higher  resolution Super  VGA, VGA,  EGA and
  271.                     Hercules   display adapters  will probably want  to use
  272.                     the  Graphics output  mode.   Date and time  display is
  273.                     provided in this mode.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.                                                                      Page 4
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.           BIBLE Verse of the Day Version 4.10                  User's Guide
  288.  
  289.                     Graphics output:
  290.  
  291.                     BIBLEV provides an  optional graphics-based  interface!
  292.                     If  you select this option, you will be provided with a
  293.                     menu of nine attractive  vector screen fonts, with user
  294.                     configurable  size and  color.   An on-screen  menu and
  295.                     sample  output  assist  you  in  making  a   selection.
  296.                     Support is  provided for Super VGA,  VGA, EGA, Hercules
  297.                     MGA, and CGA display  adapters.  With the exception  of
  298.                     Super VGA, the  display type is automatically  detected
  299.                     by  BIBLEV. If you do  not desire to  use this feature,
  300.                     simply choose one of the text mode display options when
  301.                     in the configuration  menus.  Date and time  display is
  302.                     provided in this mode.
  303.  
  304.                     NOTE:     The graphics  mode  fonts were  designed  for
  305.                               optimum appearance on a high resolution video
  306.                               display.   Some fonts may be  unreadable on a
  307.                               CGA adapter.  Due to  the limited pixels on a
  308.                               CGA display, the parameter "N" can be used to
  309.                               suppress Title and Copyright Display.
  310.  
  311.  
  312.           Verse File Modification
  313.  
  314.                All verses  are contained in the file  BIBLEV.DAY (for BIBLE
  315.                Verse of the Day).  This  file is simply an ASCII text file,
  316.                and can be  edited with  any ASCII text  editor (almost  any
  317.                text  editor or  word processor  for the  PC can  edit ASCII
  318.                files).  Just  make sure  that you  save the  file again  in
  319.                ASCII  format - if in some other strange format, BIBLEV will
  320.                NOT work properly!
  321.  
  322.                Each verse in the  file MUST be marked,  or tagged, with  an
  323.                asterisk (*)  if you want it to be used by BIBLEV.  The file
  324.                is very freeform, and has  no strict format.  Verses can  be
  325.                as long  as you desire, as BIBLEV will pause when a verse is
  326.                longer than one screen.   I would recommend not  setting the
  327.                margins wider  than 80 if you  are using text mode.   If you
  328.                are  using  graphics  mode,  automatic  word-wrap  has  been
  329.                implemented, so margins won't matter as much.
  330.  
  331.                BIBLEV now automatically detects changes in the  size of the
  332.                Verse file! After adding new verses, or deleting old verses,
  333.                the next time BIBLEV  is run, it will  go into an  automatic
  334.                setup mode to count the number  of verses in the verse file.
  335.                The program will then proceed to run normally.
  336.  
  337.  
  338.  
  339.  
  340.                                                                      Page 5
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.           BIBLE Verse of the Day Version 4.10                  User's Guide
  349.  
  350.           Command Reference
  351.  
  352.                Running INSTALL:
  353.  
  354.                The INSTALL program  can be  used to install  BIBLEV into  a
  355.                subdirectory on  a computer's hard  drive.  To  run INSTALL,
  356.                you must change to the directory or  diskette containing the
  357.                BIBLEV distribution files, and type:
  358.  
  359.                          INSTALL   [Press ENTER]
  360.  
  361.                INSTALL  will walk you though all of the steps of installing
  362.                BIBLEV into  the hard disk directory  of your choice.   If a
  363.                previous  version  of BIBLEV  is  found, you  will  be asked
  364.                whether or  not to save your  old verse file (a  must if you
  365.                have  added your own verses).  If there is sufficient system
  366.                memory, INSTALL will  automatically invoke BIBLEV Setup  for
  367.                you.  And last of all, you will be asked if you want INSTALL
  368.                to  add  BIBLEV  to your  AUTOEXEC.BAT  file.    If you  are
  369.                upgrading from an earlier version of BIBLEV, this should not
  370.                be necessary.
  371.  
  372.  
  373.                Running BIBLEV:
  374.  
  375.                The program can  be run  from the command  prompt by  typing
  376.                "BIBLEV",  or can easily be  added to a  batch file.  BIBLEV
  377.                must either be in  the current directory, or in  a directory
  378.                specified as part of the DOS path.
  379.  
  380.                In  a batch file, such  as the AUTOEXEC.BAT  file, you could
  381.                run BIBLEV  in the  following fashion. This  example assumes
  382.                that you have installed all  of the files for BIBLEV  into a
  383.                directory called "C:\BIBLEV", but any directory can be used.
  384.  
  385.                For example:
  386.                               .
  387.                               .
  388.                               PATH = C:\;C:\DOS;C:\BIBLEV;C:\UTILITY
  389.                               BIBLEV
  390.                               .
  391.                               .
  392.  
  393.                By setting the DOS path to include the directory  containing
  394.                the program, BIBLEV  can now  be run from  any directory  on
  395.                your hard disk.
  396.  
  397.  
  398.                Note that BIBLEV will search all directories in the DOS path
  399.                for its data  files.  Therefore, for fastest performance, if
  400.  
  401.                                                                      Page 6
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.           BIBLE Verse of the Day Version 4.10                  User's Guide
  410.  
  411.                you use  a long   PATH statement, try to place the directory
  412.                containing BIBLEV towards the beginning of the PATH.
  413.  
  414.                NOTE:     If you  are replacing  an older version  of BIBLEV
  415.                          (any  version prior  to  3.00), you  will need  to
  416.                          delete  the old  'BIBLEV.COM' program  file before
  417.                          you can use the new program.
  418.  
  419.  
  420.                Command Line Options:
  421.  
  422.                S    -    <Setup> Starts BIBLEV in Setup mode.
  423.  
  424.                N    -    <No  Title>  Runs  BIBLEV  in  normal  mode,   and
  425.                          suppresses  the  display  of Title  and  Copyright
  426.                          notices.   Only  valid if configured  for Standard
  427.                          Text output  or if running Graphics mode  on a CGA
  428.                          display.
  429.  
  430.                D    -    <Don't  Wait>  Runs  BIBLEV in  normal  mode,  and
  431.                          suppresses   the  "More"   and  "Press   any  key"
  432.                          messages, and  ignores the time-out setting.   The
  433.                          program exits immediately,  without pausing.  This
  434.                          option is only  available in Standard (BIOS)  Text
  435.                          mode,  and is  intended  primarily  for  use  when
  436.                          redirecting output to a DOS file or printer.
  437.  
  438.                ND   -    Combine the "Don't Wait" and "No Title" options.
  439.  
  440.  
  441.           Trouble Shooting
  442.  
  443.                It is  highly unlikely that you will run into a problem with
  444.                BIBLEV.  However, if you do, check the following items:
  445.  
  446.                1.   Make sure that you  are you running MS-DOS 3.1,  PC-DOS
  447.                     3.1, DR DOS 5.0 or later.
  448.  
  449.                2.   Make sure  that the FILES statement  in your CONFIG.SYS
  450.                     is  set to at least  20.  You may need  more if you are
  451.                     running BIBLEV under a multitasking environment (DR DOS
  452.                     TaskMax, GeoWorks, Windows, OS/2, etc.).
  453.  
  454.                3.   Is the directory into which you installed BIBLEV listed
  455.                     in  your  DOS  PATH  statement?    If  not,  edit  your
  456.                     AUTOEXEC.BAT  to   add  that  directory  to  your  PATH
  457.                     statement, and reboot.
  458.  
  459.  
  460.  
  461.  
  462.                                                                      Page 7
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.           BIBLE Verse of the Day Version 4.10                  User's Guide
  471.  
  472.                4.   If   having   problems   running   BIBLEV   from   your
  473.                     AUTOEXEC.BAT  (when booting),  make sure that  the line
  474.                     that executes  the "BIBLEV"  command is after  the PATH
  475.                     statement.
  476.  
  477.                5.   If you have selected Super VGA graphics, and the screen
  478.                     is blank  or unreadable  (or otherwise messed  up), try
  479.                     reconfiguring  BIBLEV  (by executing  "BIBLEV  S"), and
  480.                     either select a lower  Super VGA resolution, or disable
  481.                     Super VGA graphics support.
  482.  
  483.  
  484.           Technical Support
  485.  
  486.                Questions, comments and suggestions concerning BIBLEV can be
  487.                sent to CompuServe address 73670,762 or via Internet mail to
  488.                73670.762@compuserve.com.  If you have access to any of  the
  489.                major  commercial information  networks, odds  are  that you
  490.                have  Internet mail capabilities.  If you do not have access
  491.                to any of these services, write to:
  492.  
  493.                                       MorriSoft
  494.                                  206 Attleboro Court
  495.                             Meridianville, AL  35759-2244
  496.  
  497.  
  498.           Closing Remarks
  499.  
  500.                BIBLEV and its associated  programs are written in  C++, and
  501.                compiled with Borland's Turbo  C++ Compiler for DOS, Version
  502.                3.0.
  503.  
  504.                BIBLEV  and  all  associated  programs and  data  files  are
  505.                provided  'as is' with  no expressed  warranty of  any kind.
  506.                MorriSoft  is  in no  way liable  for  any damages,  real or
  507.                imagined, received thereof.
  508.  
  509.                Lastly, ENJOY!  I hope many people find this program of some
  510.                use, and that it helps you grow in the Word even while using
  511.                your computer!
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.                                                                      Page 8
  524.