Provided by: bible-kjv_4.20_i386 bug
 

NAME

        bible - Lookup words and verses in the Bible (King James version)
 

SYNOPSIS

        bible [-f] [-l columns] [-m memlimit] [-p path-list] [-d datafile-name]
        [verse-reference(s)]
 

DESCRIPTION

        Bible writes the text of specified Bible verses to  stdout.   The  text
        used  is  the  Authorized  (King James) version.  Commands may be given
        either on the command line,  or  interactively.   Bible  also  supports
        instant  searches  for verses containing a particular word, or combina‐
        tion of words.  The program uses a  specially-compressed  form  of  the
        text  that  allows for rapid random access, while still compressing the
        original 4.4 Mbyte text into less than 1.8 Mbytes  (plus  the  "concor‐
        dance" data file, which requires nearly 900 Kbytes).
 
    Options
        The options to bible are:
 
        -f             Toggles special output formatting (pretty-printing).  By
                       default, pretty-printing is on (a  change  from  earlier
                       versions).   When pretty-printing is off, bible precedes
                       each verse with its book/chapter/verse reference.   When
                       pretty-printing  is  on,  the  book name and chapter are
                       printed on a line by themselves, and only when the chap‐
                       ter  or  book  changes.   The  start  of  each  verse is
                       indented and preceded by the verse number.  The book and
                       chapter names are separated from the text by blank lines
                       to facilitate post-processing by  other  tools  such  as
                       adjust.  Pretty-printing activates automatic line breaks
                       ( -l)
 
        -l columns     When pretty-printing is off, bible prints one verse  per
                       line,  even though the text may be much longer than will
                       fit on a single line of a display.  This is  very  handy
                       when the output will be processed by other programs, but
                       it doesn’t look very nice.  The -l option sets  a  limit
                       on  the length of an output line, causing bible to break
                       lines (only between words) to fit.  The columns argument
                       is  optional; if it is not specified, bible will use the
                       value of the COLUMNS environment variable minus one.  If
                       COLUMNS is not set a default value of 79 is used.
 
        -m memlimit    Bible normally allocates up to 1 megabyte for buffers to
                       store uncompressed text.  If the -m option  is  present,
                       bible will set the limit to memlimit kilobytes.
 
        -p path-list   Bible  normally searches for the text data file first in
                       the current directory, and then  in  /usr/lib.   The  -p
                       option may be used to change the search path.  Path-list
                       should be a list of directories,  each  separated  by  a
                       space (be sure to escape them from the shell).
 
        -d filename    Bible  normally  expects to find the text data in a file
                       named  bible.data,   and   the   concordance   data   in
                       bible.data.conc.   If  the  -d  option is present, bible
                       will look for a text data file  named  filename,  and  a
                       concordance data file named filename.conc instead.
 
    Verse References
        Bible  accepts verse references in a variety of forms, including single
        verses and verse ranges.  For example:
 
            Jn3:16, john3:16,17 ps1:1-6
 
        Most recognizable abbreviations are allowed, and  spelling  errors  are
        ignored  if  the  book can be made out in the first few characters.  No
        distinction is made between upper and lower case.  Multiple  references
        may be provided on an input line, delimited by spaces or commas.
 
        Verse and chapter will be silently coerced into a realistic range, e.g.
        "Ps1:87" will be treated as Psalm 1:6 since there are only  six  verses
        in  Psalm  1,  and  "Rev99:99" will be treated as Revelation 22:21 (the
        last verse in the Bible).  A book name by itself is  assumed  to  be  a
        reference  to  chapter 1, verse 1 of that book, i.e. "Acts" is the same
        as "Acts1:1".  Similarly, a book and chapter without a verse is assumed
        to refer to verse one of that chapter.
 
        A range of verses may be printed by giving a starting and ending refer‐
        ence, separated by a hyphen ("-").  For example, "Gen1:1-Rev22:21" will
        dump the entire text (about 4.4 MB).
 
        Bible keeps track of your current context and will attempt to interpret
        references in that context.  For example if you request "John1:1", fol‐
        lowed  by  "3:16", and then "17", the second reference is assumed to be
        within the book of John, and the third is assumed to be within  chapter
        3  of  that  book.  An empty reference, e.g. a blank line on the input,
        will show the next verse following the last one displayed.
 
        More examples of legal verse references:
 
            psalms1
 
            Psalms
 
            Romans3:23 5:8 6:23
 
            1
 
            5:1
 
            1-22
 
    Concordance (Word Searches)
        Bible includes a concordance, with which you can immediately  find  all
        the verses in which a word appears.  The ??word command will select all
        the references that include word.  Bible will  display  the  number  of
        matching references, if any, but since the number could be quite large,
        it won’t actually list the references until you ask.
 
        In order to list the references from a word search, the ?list  (or  ?l)
        command  is  used.   Likewise,  to  print  the  full text of the verses
        selected by a word search, use the ?view (or ?v) command.
 
        The lists for multiple words may be combined using the  ?and  word  and
        ?or  word  commands.   First create a reference list using the ??  com‐
        mand.  For example,
 
            ??faith
 
        will find 231 references to the word "faith".  To narrow the list  fur‐
        ther, the command
 
            ?and love
 
        will  inform  you that, while there were 281 references to "love", only
        16 of them were also in the previous  reference  list  (i.e.  contained
        both words).  The "combined list" of 16 references produced by the ?and
        word command is the intersection of the two  lists,  and  replaces  the
        original reference list.
 
        The  ?list and ?view commands will now apply to the combined list.  You
        can continue to apply the ?and command to the combined list.  For exam‐
        ple,
 
            ?and hope
 
        will  further  narrow the combined list to only two references.  Typing
        ?view then displays the full text:
 
            1 Thessalonians 1
 
              3 Remembering without ceasing your work of faith, and labour of
            love, and patience of hope in our Lord Jesus Christ, in the
            sight of God and our Father;
 
            1 Thessalonians 5
 
              8 But let us, who are of the day, be sober, putting on the
            breastplate of faith and love; and for an helmet, the hope of  sal‐
        vation.
 
        The  ?or  word  command  is similar to ?and, but it produces a combined
        reference list that is the union of the two lists.  In other words, the
        list  includes  those verses in which either of the words appears.  For
        example
 
            ??angels
            ?or angel
 
        will find all 283 verses in wich either word is used.
 
        By default, reference lists cover the  entire  Bible.   But  for  those
        times  when  it  is useful to limit them to a particular section of the
        text, bible provides the ?in verse range command.  For example
 
            ?in mt1:1-rev22:21
 
        will limit future reference lists to the New Testament.  If you have  a
        current reference list, references that fall outside the limits will be
        dropped.  Note that only a contiguous range of verses may be used.   To
        reset the limits so that the whole text is searched, the command is ?in
        all.
 
    Interactive Use
        For interactive use, invoke bible without any verse references  on  the
        command line.  You should see a prompt displayed:
 
            Bible(KJV) [Gen1:1]>
 
        Typing ?  will print a command summary.
 
        The program accepts three types of interactive command input:
 
               ·  Bible verse references, as described above.
               ·  Concordance  (word  search)  commands,  also described above.
                  These commands are: ??, ?list, ?view, ?and, ?or, and ?in.
               ·  Miscellaneous program control commands:
 
               ?, ?h, ?help   Prints help text.
               ?f             Toggles output formatting modes.
               ?wfile         Begin writing program output to a file.  If  file
                              exists,   output  is  appended  to  what’s  there
                              already.
               ?w             Stop writing to a file.
               >, <           Toggle the direction  (forward  or  backward)  in
                              which  bible  will  move  through the text when a
                              blank line is entered.
               q, ?bye, ?exit, ?quit, ?q
                              End the program.
 

BUGS

        References to the one-chapter books of Philemon and  3  John  are  non-
        standard in that they require a dummy chapter number.  For example, use
        Phm1:5 instead of Phm5 to get verse 5.
 
        The possessive form      s is handled strangely by  the  Concordance.   The
        apostrophe  has been removed and the s has been treated as if it were a
        separate word.  So, for example, if you wanted to find  all  references
        to  "refiner’s" you would have to first search for "refiner" (using the
        command ??refiner) and then combine it with a search for "s" (?and  s).
 
        The convention for handling partial verse specifications can be clumsy.
        A book name by itself, e.g. "Matthew" is taken as a reference to  verse
        1:1  of  that  book.   So ?in matt results in a range limit of a single
        verse (Mt1:1) instead of the whole book as one might hope.   Similarly,
        ?in mt-rev results in a range of Matthew 1:1 to Revelation 1:1, instead
        of extending all the way to Revelation 22:21.
 

FILES

        /usr/lib/bible.data
        /usr/lib/bible.data.conc
        Rev3:20
 

AUTHOR

        Chip Chapin, Hewlett Packard Company (chip@cup.hp.com).
 
        The current version uses Lempel-Ziv-Welch compression on the data file,
        though  I  modified the "compress" program to emit checkpoints at known
        intervals to facilitate random access to the data.  I call this  simple
        technique  "windowed compression", and it could be used for any similar
        application.  The data file can still be uncompressed using  the  stan‐
        dard "compress" utility if my file header is removed.
 
        I  would like to gratefully acknowledge the contribution of the authors
        of the compress program, which I modified for use in the  text  storage
        component  of  bible.   As  listed  in  the  compress sources they are:
        Spencer W. Thomas, Jim McKie, Steve Davies,  Ken  Turkowski,  James  A.
        Woods, Joe Orost.
 
        Matthew  Vernon  <matthew@debian.org>  has  substantially updated a the
        code of this package. His alterations  are  made  available  under  the
        terms  of  the  GNU General Public Licence, version 2 or later, as pub‐
        lished by the Free Software Foundation.
 
                                 January 8, 1993                       BIBLE(1)