19 Command Line - Examples and Shortcuts |
|
This chapter provides a succinct reference to how to do searches on the Biblical text using the Command Line. It also contains tables of various shortcuts that can be used with the Command Line to perform various functions that would otherwise require the opening of a separate configuration window.
The following table gives you some examples of the types of searches you can enter on the BibleWorks Command Line. They are intended to illustrate the principles discussed in previous chapters. To try them, first change to the specified search version by entering the three-letter version name on the Command Line followed by <Enter>. Then enter the specified search parameters on the Search Window Command Line and press <Enter> again. In the following list KJV indicates the King James Version, BNT indicates the Greek New Testament, and BNM and WTM represent the Greek and Hebrew Morphology Database versions respectively. Note that, as discussed in the previous section, Command Lines must begin with a period (for AND searches), or a single quote (for phrase searches), or a forward slash (for OR searches), or a left parenthesis (for compound searches). You can use as many wildcard characters as you wish (a "*" to match any sequence of characters, and a "?" to match any single character). All of these searches except Hebrew morphology searches are case insensitive. The exclamation point character is used immediately preceding words in AND searches to indicate that verses including the word should not be included.
All Greek and Hebrew searches are done with vowel point and accent sensitivity turned off.
|
Ver |
Command Line |
Finds all verses with ... |
|
KJV |
gen 1:1 |
displays Genesis 1:1 |
|
KJV |
gen 1 1 |
displays Genesis 1:1 |
|
KJV |
gen 1:1-3 |
displays Genesis 1:1-3 |
|
KJV |
mat 1 |
displays Matthew 1 (entire chapter) |
|
KJV |
5 3 |
displays chapter 5, verse 3 in current book |
|
KJV |
.jesus |
containing the word Jesus |
|
KJV |
.jesus christ |
containing both "jesus" AND "christ" anywhere in the verse in any order |
|
KJV |
/jesus christ |
containing either "jesus" OR "christ" |
|
KJV |
.jesus !christ |
the word "jesus" but NOT the word "christ" |
|
KJV |
'jesus christ |
the phrase "jesus christ" |
|
KJV |
'christ jesus |
the phrase "christ jesus" |
|
KJV |
.paul |
the word "paul" |
|
KJV |
.paul barnabas |
"paul" AND "barnabas" |
|
KJV |
/paul barnabas |
either "paul" OR "barnabas" |
|
KJV |
.paul barnabas;5 |
"paul" AND "barnabas" within 5 verses of each other |
|
KJV |
.paul !barnabas |
the word "paul" but NOT the word "barnabas" |
|
KJV |
.paul !barnabas;5 |
the word "paul" but NOT the word "barnabas" within 5 verses |
|
KJV |
(/paul saul).(barnabas) |
either "paul" OR "saul" AND barnabas in the same verse |
|
KJV |
(/paul saul).5(barnabas) |
either "paul" OR "saul" AND barnabas within 5 verses |
|
KJV |
(/Martha Mary).!(.Martha Mary) |
either Mary OR Martha but NOT both (an exclusive OR search) |
| KJV | (christ).!('the christ).!(jesus) | Christ but neither "the Christ" nor Jesus |
|
KJV |
(.paul barnabas;2)/(.paul silas;3) |
"paul" AND "barnabas" within 2 verses OR "paul" AND "silas" within 3 verses. |
|
KJV |
'*dom of god |
phrases like "wisdom of god", "kingdom of god", and so on |
|
KJV |
/*ite *ites |
words ending in "...ite" or "...ites" |
|
KJV |
.*wom?n |
words of the form "women", "woman", "bondwoman", and so on |
|
KJV |
(/grac* faith*).5(/law* work*) |
a form of "grac..." OR "faith..." AND a form of "law..." OR "work..." within 5 verses |
|
BNT |
.*pist* |
words containing the substring "pist" (138 forms found) |
|
BNT |
'pistoj o logoj |
words pistoj o logoj ("faithful saying") |
|
BNT |
.pauloj barnabaj |
the words pauloj AND barnabaj (nominative forms only) |
|
BNT |
.paul* barnab* |
words of the form paul... AND barnab... |
|
BNT |
.paul* barnab*;5 |
words of the form paul... AND barnabaj... within 5 verses |
|
BNT |
.crist* ihs* |
words of the form crist* AND words of the form ihs* |
|
BNT |
.crist* !ihs* |
words of the form crist* but NOT words of the form ihs* |
|
BNT |
' ouk * * oude |
the words ouk and oude with any two intervening words between |
|
BNT |
' ouk *99 oude |
the words ouk and oude with any 99 or fewer words intervening |
|
BNM |
.pistij carij |
any form of pistij and any form of carij. In Greek morphology searches, words which do not contain an "@" are assumed to have a wildcard "@*" appended |
|
BNM |
.ihsouj |
any form of the lemma ihsouj. |
|
BNM |
.ihsouj cristoj |
any form of the lemma ihsouj AND any form of the lemma cristoj |
|
BNM |
.ihsouj !cristoj |
any form of the lemma ihsouj but NOT any form of the lemma cristoj |
|
BNM |
/ihsouj cristoj |
any form of the lemma ihsouj OR any form of the lemma cristoj |
|
BNM |
(/pauloj sauloj).5(barnabaj) |
any forms of the lemmas pauloj OR sauloj AND barnabaj within 5 verses |
|
BNM |
'en cristoj |
the preposition en followed by any form of the lemma cristoj |
|
BNM |
'*@p* cristoj |
any preposition followed by any form of the lemma cristoj |
|
BNM |
'*@p* cristoj@na* |
any preposition followed by an accusative form of the lemma cristoj |
|
BNM |
.*@v?y* |
all pluperfect verb forms |
|
BNM |
'*@d* *@n* kai *@n* |
all verses with article-noun-kai-noun phrases |
|
BNM |
' kaloj ergon |
any form of the word kaloj followed by any form of the word ergon |
|
BNM |
' kaloj *5 ergon |
any form of the word kaloj followed by any form of the word ergon within five words |
|
BNM |
' kaloj =gcn *5 ergon |
a word kaloj followed by a form of the word ergon within five words, with the two words agreeing in gender, case and number |
|
BNM |
;#1 *2 kai *2 #1 |
all verses with kai preceded and followed by the same lemma with the kai 2 or less words from the lemma. |
|
BNM |
;#1@n* *2 kai *2 #1@n* |
all verses with kai preceded and followed by the same noun lemma with the kai 2 or less words from the noun. |
|
BNM |
'!o *@n* eimi |
occurrences of any noun followed by a form of eimi but with no article preceding. |
|
BNM |
.a*@((nn) | (a))* |
any normal noun or adjective beginning with the letter a |
|
BNM |
.a*@&vi[ai]* |
any indicative verb in the aorist or imperfect beginning with a |
|
BNM |
;o *@n* *@a* =gcn |
any articular noun followed by an adjective agreeing in gender, case and number |
|
BNM |
;o *@n* *3 !o *@a* =gcn |
any articular noun followed within 1 to 4 words by an anarthrous adjective agreeing in gender, case and number |
|
WTT |
'myhla rmayw |
occurrences of the string myhla rmayw (and God said) (Note that medial characters can be used in a search even to match corresponding final characters) |
|
WTT |
.!rha hvm |
the forms !rha AND hvm |
|
WTT |
.!rha !hvm* |
the word !rha and NOT a word ending in hvm ... |
|
WTM |
'myhla rma |
any form of the lemma rma followed by any form of the lemma myhla. For Hebrew morphology searches, words which do not contain an "@'" (for Hebrew) or "%" (for Aramaic) are assumed to have a wildcard "@*" appended. |
|
WTM |
.nrha hvm |
any form of the lemma hvm AND any form of the lemma nrha |
|
WTM |
.hvm !nrha |
any form of the lemma hvm but NOT containing any form of the lemma nrha |
|
WTM |
(/rpk@vp* rpk@vt*).(/!w[ ajx) |
any piel OR hithpael form of the stem rpk AND any form of the stem !w[ OR ajx |
|
WTM |
.rpk@vpi3ms* |
the piel imperfect 3rd person singular of rpk |
|
WTM |
.rpk@vp?3ms*R{qx} |
a 3rd person masculine singular piel form of the verb rpk in any aspect (tense), Qere and normal forms only. |
A quick way to add a version to the Browse Window display list is to simply enter the three-letter abbreviation for the name on the Command Line and then press <Enter>. This will display the version and make it the default search version. If you precede the version name with the word "convert" the current Search Window verse list, if there is one, will be retained but remapped to match the new version. This is done automatically when you change versions if the "Remap Verse List on Change" option in the Tools | Options | Option Flags window is activated, but the "convert" command allows you to do this on a case-by-case basis if that option is disabled. For example
|
convert WTT |
will change the current search version to the WTT version and remap the current verse list to match that version. Remapping is necessary because not all versions are numbered the same.
There are also several "Command Line commands" that "power users" can use to activate groups of versions quickly. The first is the "display" command. To use it you enter the word "display" on the Command Line followed by the versions you want displayed. In addition to the BibleWorks version abbreviations you can also use special strings to set version groups. For example "all" displays all versions. "clear" will clear all versions. Entering a language name will activate all versions with the given language. A plus sign in front of a version name, or just the version name itself will add the version. A minus sign will remove a version from the Browse Window. For example:
|
Command Line Entry |
Results After Pressing <Enter> |
|
display all |
displays all versions |
|
display clear kjv bnt bnm |
displays only kjv, bnt and bnm versions |
|
display clear |
remove all but the current search version |
|
display kjv greek |
add display of the kjv and all Greek versions |
|
display german |
add display of all German versions |
|
display -kjv |
remove the kjv from the current display |
|
display kjv gnt |
add the kjv and gnt to the current display |
In addition, there is also a "parallel" command that permits you to open up a new parallel versions window with a specified list of versions. For example:
|
parallel kjv gnt bnm niv |
will open a parallel versions window with the versions indicated. The "parallel," "display," and "clear" commands can be abbreviated with "p", "d", and "c".
The term "keyboard focus" is a designator of the one window on the screen that will respond to current keyboard input. In particular, the window with the keyboard focus is usually the window in the foreground, and the particular object that has keyboard focus is the object that is highlighted or has a blinking cursor (if there is one).
The F2 and F3 keys provide a convenient way to switch keyboard focus back and forth between the Command Line and Editor (or Browse Window). F2 returns to the Command Line. F3 returns to the last Editor or Browse Window. Pressing ESC will also return you to the Command Line.
If you enter a full verse reference on the Command Line the verse will be looked up and displayed in the Browse Window. If you enter just a verse or a chapter and verse on the command line, the command will be processed using the last book (and chapter if you just enter the verse) accessed. The Command Line syntax has also been extended so that you can precede a verse reference with a version id. This tells the program that the verse number is from the specified version and must be remapped to the search version before being looked up. It will not change the search version.
Here is a small number of examples for setting search limits on the Command Line. Note that the first character ("l") is an "L" in lower case, not an "i" or a "1".
|
l |
removes all search limits |
|
l mat |
limits searches to the book of Matthew |
|
l mat-rom |
limits searches to Matthew through Romans |
|
l nt |
limits searches to the New Testament |
|
l ot |
limits searches to the Old Testament |
|
l gosp |
limits searches to the gospels ("gosp" being one of the existing "Predefined Ranges" (p. 240)) |
|
l rom 1-rom 2 |
limits searches to chapters 1 and 2 in the book of Romans |
|
l 1jo 1 |
limits searches to the first chapter of 1 John |
|
l heb 1:5-heb 1:8 |
limits searches to vv. 5, 6, 7, 8 of the first chapter of Hebrews |
|
l heb 1:5-heb 2:10 |
limits searches from chapter 1:5 to chapter 2:10 of Hebrews |
|
l mat 28:10-mar 1:10 |
limits searches from Matthew 28:10 to Mark 1:10 |
| l luk; act | limits searches to Luke and Acts |
| l mat 5-7; jam | limits searches to the Sermon on the Mount and James |
| l mat 1:2-17; luk 3:23-38 | limits searches to Jesus' birth narratives |