summaryrefslogtreecommitdiff
path: root/texmf-dist/doc/latex/fetchbibpes/examples
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2018-06-16 14:43:57 +0900
committerNorbert Preining <norbert@preining.info>2018-06-16 14:43:57 +0900
commita343e3a55036d618f1ebcc52b94838a6d9ba352f (patch)
tree7949818cb0aa0447f303d35f4e36654d9d7d5071 /texmf-dist/doc/latex/fetchbibpes/examples
parent5bf15133ae1a0745a8a5093950961c4e23dd8f5b (diff)
add fetchbibpes
Diffstat (limited to 'texmf-dist/doc/latex/fetchbibpes/examples')
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_alt-star.tex95
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_red.tex127
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replace.tex125
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replaces.tex129
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sf.tex97
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sr.tex59
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_substr.tex98
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/bibpes_tst.tex269
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/combpkgs.tex50
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/exmpldefs/verses.def74
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/fetchverses-to-end.tex66
-rw-r--r--texmf-dist/doc/latex/fetchbibpes/examples/makebibpes.tex15
12 files changed, 1204 insertions, 0 deletions
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_alt-star.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_alt-star.tex
new file mode 100644
index 00000000..a3af2d28
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_alt-star.tex
@@ -0,0 +1,95 @@
+\documentclass{article}
+\usepackage{xcolor}
+% useverses=none avoids a warning in the log when there is not value for
+% userverses. In this document we define our verses 'by hand' using the
+% declareBVs environment.
+\usepackage[ignorecfg,useverses=none]{fetchbibpes}[2016/09/21]
+\usepackage{fancyvrb}
+
+
+\providecommand\cs[1]{\texttt{\char`\\#1}}
+\let\pkg\texttt
+\def\ameta#1{$\langle\textit{\texttt{#1}}\rangle$}
+
+\addtoBibles{NKJV}
+\defaultBible{NKJV}
+
+\begin{declareBVs}
+\BV(Heb 1:2 NKJV) Heb 1:2 (default version)\null
+\BV(Heb 1:3 NKJV Alt) Heb 1:3 (alt version)\null
+\BV(Heb 1:4 NKJV Alt) Heb 1:4 (alt version)\null
+\BV(Heb 1:5 NKJV) Heb 1:5 (default version)\null
+%
+\BV(Mat 2:1 NKJV) Mat 2:1\null
+\BV(Mat 2:1 NKJV Alt) Mat 2:1 (Alt)\null
+\BV(Mat 2:2 NKJV) Mat 2:2\null
+\BV(Mat 2:3 NKJV) Mat 2:3\null
+\BV(Mat 2:4 NKJV) Mat 2.4\null
+\BV(Mat 2:4 NKJV Paul) Mat 2.4 (Paul)\null
+\BV(Mat 2:5 NKJV) Mat 2:5\null
+\BV(Mat 2:6 NKJV) Mat 2:6\null
+\BV(Mat 2:6 NKJV Special) Mat 2:6 (Special)\null
+\BV(Mat 2:7 NKJV) Mat 2:7\null
+\BV(Mat 2:8 NKJV) Mat 2:8\null
+\BV(Mat 2:9 NKJV) Mat 2:9\null
+\BV(Mat 2:10 NKJV) Mat 2:10\null
+\end{declareBVs}
+
+\begin{document}
+
+\noindent
+This is a short file to demonstrate the \texttt{alt} and \texttt{alt*} keys.
+
+\paragraph{The new behavior of \texttt{alt}} The new behavior of the \texttt{alt} key
+to typeset the verse with the specified \texttt{alt} key, if the verse is
+undefined, typeset that same verse without \texttt{alt} key specified.
+\begin{verbatim}
+ \fetchverses[alt=Alt]{Heb 1:2-6}
+\end{verbatim}
+The results of which are seen next.
+\begin{quote}
+\fetchverses*[alt=Alt]{Heb 1:2-6}
+\end{quote}
+The previous behavior of \texttt{alt} can be recovered by expanded the command
+\cs{useOldAlt},
+\begin{verbatim}
+ \useOldAlt
+ \fetchverses[alt=Alt]{Heb 1:2-6}
+\end{verbatim}
+The results of which are found next.
+\begin{quote}
+\useOldAlt
+\fetchverses[alt=Alt]{Heb 1:2-6}
+\end{quote}
+The new behavior for the \texttt{alt} key is available for the \cs{fetchverse} command.
+\begin{quote}
+\verb!\fetchverse[alt=Alt]{Mat 2:2}!\\[3pt]
+\fetchverse[alt=Alt]{Mat 2:2} (Alt not defined for this verse)\\[6pt]
+\cs{useOldAlt}\\
+\verb!\fetchverse[alt=Alt]{Mat 2:2}!\\[3pt]
+\useOldAlt
+\fetchverse[alt=Alt]{Mat 2:2}
+\end{quote}
+The counterpart to \cs{useOldAlt} is \cs{useNewAlt}, which is the default setting.
+
+\paragraph*{The \texttt{alt*} key} With this key, we can pass a comma-delimited list
+of `\texttt{alt}' values to consecutive verses.
+We now test \verb!alt*={Alt,,,Paul,,Special,,,}!.
+\begin{quote}
+\verb!\fetchverses[alt*={Alt,,,Paul,,Special,,,}]{Mat 2:1-11}!\\[3pt]
+\fetchverses[alt*={Alt,,,Paul,,Special,,,}]{Mat 2:1-11}
+\end{quote}
+Notice that if we remove the trailing commas,
+\begin{quote}
+\verb!\fetchverses[alt*={Alt,,,Paul,,Special}]{Mat 2:1-11}!\\[3pt]
+\fetchverses[alt*={Alt,,,Paul,,Special}]{Mat 2:1-11}
+\end{quote}
+we get the same result. Thus, when we reach the end of the \texttt{alt*}
+list, the behavior reverts back to normal.
+
+The \cs{useOldAlt} and \cs{useNewAlt} commands are obeyed by \texttt{alt*} key as well.
+
+
+
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_red.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_red.tex
new file mode 100644
index 00000000..1fff3edb
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_red.tex
@@ -0,0 +1,127 @@
+\documentclass{article}
+\usepackage{xcolor}
+% useverses=none avoids a warning in the log when there is not value for
+% userverses. In this document we define our verses 'by hand' using the
+% declareBVs environment.
+\usepackage[ignorecfg,useverses=none]{fetchbibpes}[2016/09/21]
+\usepackage{fancyvrb}
+
+
+\providecommand\cs[1]{\texttt{\char`\\#1}}
+\let\pkg\texttt
+\def\ameta#1{$\langle\textit{\texttt{#1}}\rangle$}
+
+\addtoBibles{NKJV}
+\defaultBible{NKJV}
+
+\begin{declareBVs}
+\BV(Mat 4:19 NKJV) Then He said to them, "Follow Me, and I will make you fishers of men."\null
+\BV(Mat 5:2 NKJV) Then He opened His mouth and taught them, saying:\null
+\BV(Mat 5:3 NKJV) "Blessed are the poor in spirit, For theirs is the kingdom of heaven.\null
+\BV(Mat 5:4 NKJV) Blessed are those who mourn, For they shall be comforted.\null
+\BV(Mat 5:5 NKJV) Blessed are the meek, For they shall inherit the earth.\null
+\BV(Mat 5:6 NKJV) Blessed are those who hunger and thirst for righteousness, For they shall be filled.\null
+\BV(Mat 5:7 NKJV) Blessed are the merciful, For they shall obtain mercy.\null
+\BV(Mat 5:8 NKJV) Blessed are the pure in heart, For they shall see God.\null
+\BV(Mat 5:9 NKJV) Blessed are the peacemakers, For they shall be called sons of God.\null
+\BV(Mat 5:10 NKJV) Blessed are those who are persecuted for righteousness' sake,
+ For theirs is the kingdom of heaven.\null
+\BV(Mat 5:11 NKJV) "Blessed are you when they revile and persecute you,
+ and say all kinds of evil against you falsely for My sake.\null
+\BV(Mat 5:12 NKJV) Rejoice and be exceedingly glad, for great is your reward in heaven,
+ for so they persecuted the prophets who were before you.\null
+\end{declareBVs}
+
+\begin{document}
+
+\noindent This document discusses techniques for typesetting rich text from the plain text Bible quotes
+supplied by \textsf{e-Sword}. The major tool used is the \texttt{replace} option key of the fetch commands.
+
+Concerning putting quotations of Jesus in red (NKJV), there are two
+situations: (1) a verse has a mixture of black and red text; (2) a passage is
+all red.
+
+In the first case, it might be easier to make all text red using \texttt{pcolor=red}, and use
+\texttt{replace} to make the non-Jesus quotes in black.
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\fetchverse[pcolor=red,
+ replace={Then He}{\textcolor{black}\bgroup Then He}
+ {to them,}{to them,\egroup}
+]{Mat 4:19}
+\end{Verbatim}
+This command code expands as follows:
+\begin{quote}
+\fetchverse[
+ pcolor=red,
+ replace=
+ {Then He}{\textcolor{black}\bgroup Then He}
+ {to them,}{to them,\egroup}
+]{Mat 4:19}
+\end{quote}
+\textbf{RULE:} Avoid interacting with quote marks (as part of arguments
+of the \ameta{find} text) of any type, for they are active characters within
+a Bible passage.
+
+\medskip\noindent
+Using \textsf{Mat 5:2-12} as an example, for the second type, it is easier to break
+the passage up into passages of type (1) and passages that are all red.
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\renewcommand\verseFmt[1]{{\normalcolor\verseFmtDef{#1}}}
+\fetchverses[showfirst]{Mat 5:2}
+\bDQ\eSQ\fetchverses[showfirst,pcolor=red]{Mat 5:3-10}
+\bDQ\fetchverses[showfirst,pcolor=red]{Mat 5:11-12}\bDQ
+\end{Verbatim}
+Additional breaking of the passage is needed to get the quotes correct by
+placing \cs{bDQ} and \cs{eSQ} appropriately.
+\begin{quote} %\sloppy
+\renewcommand\verseFmt[1]{{\normalcolor\verseFmtDef{#1}}}%
+\makebox[\linewidth][c]{\sffamily\bfseries The Beatitudes (Mat 5:2-12)}\\[3pt]
+\fetchverses[showfirst]{Mat 5:2}
+\bDQ\eSQ\fetchverses[showfirst,pcolor=red]{Mat 5:3-10}
+\bDQ\fetchverses[showfirst,pcolor=red]{Mat 5:11-12}\bDQ
+\end{quote}
+I've made a redefinition of \cs{verseFmt} so that the verse numbers
+are in black.
+
+\newpage
+
+\begin{declareBVs}
+\BV(Mat 16:13 NKJV) When Jesus came into the region of Caesarea Philippi,
+ He asked His disciples, saying, "Who do men say that I, the Son of Man, am?"\null
+\BV(Mat 16:14 NKJV) So they said, "Some say John the Baptist, some Elijah,
+ and others Jeremiah or one of the prophets."\null
+\BV(Mat 16:15 NKJV) He said to them, "But who do you say that I am?"\null
+\BV(Mat 16:16 NKJV) Simon Peter answered and said, "You are the Christ, the Son of the living God."\null
+\BV(Mat 16:17 NKJV) Jesus answered and said to him, "Blessed are you, Simon Bar-Jonah,
+ for flesh and blood has not revealed this to you, but My Father who is in heaven.\null
+\BV(Mat 16:18 NKJV) And I also say to you that you are Peter,
+ and on this rock I will build My church, and the gates of Hades shall not prevail against it.\null
+\BV(Mat 16:19 NKJV) And I will give you the keys of the kingdom of heaven,
+ and whatever you bind on earth will be bound in heaven, and whatever you loose on earth will be loosed in heaven."\null
+\BV(Mat 16:20 NKJV) Then He commanded His disciples that
+ they should tell no one that He was Jesus the Christ.\null
+\end{declareBVs}
+
+\begin{quote}\sloppy
+\makebox[\linewidth][c]{\sffamily\bfseries Peter Confesses Jesus as the Christ (Mat 16:13-20)}\\[3pt]
+\renewcommand\verseFmt[1]{{\normalcolor\verseFmtDef{#1}}}
+\noindent\fetchverses[showfirst,
+ pcolor=red,
+ replace={When Jesus}{\bgroup\protect\normalcolor When Jesus}
+ {saying,}{saying,\egroup}
+]{Mat 16:13}
+\fetchverses[showfirst,
+ replace={Some say}{Some \emph{say}}
+]{Mat 16:14}
+\fetchverses[showfirst,
+ replace={He said to them,}{\protect\textcolor{black}{He said to them,}}
+]{Mat 16:16}
+\fetchverses[showfirst,pcolor=red,
+ replace={Jesus answered and said to him,}{\protect\textcolor{black}{Jesus answered and said to him,}}
+]{Mat 16:17-19}
+\fetchverses[showfirst]{Mat 16:20}
+\end{quote}
+The above quotation is an example of a rich text Bible quotation, having replaced
+the plain text of \textsf{e-Sword} with color, and italics (verse~14).
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replace.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replace.tex
new file mode 100644
index 00000000..7fd9f1d4
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replace.tex
@@ -0,0 +1,125 @@
+\documentclass{article}
+%\usepackage{array,calc}
+\usepackage{xcolor}
+% useverses=none avoids a warning in the log when there is not value for
+% userverses. In this document we define our verses 'by hand' using the
+% declareBVs environment.
+\usepackage[ignorecfg,useverses=none]{fetchbibpes}[2016/09/19]
+
+\providecommand\cs[1]{\texttt{\char`\\#1}}
+\let\pkg\texttt
+
+\addtoBibles{NKJV}
+
+\begin{document}
+
+\section{Highlighting the replace key.}
+
+As described in the \texttt{fetchbibpes\_man.pdf}, we can search and replace
+text for a single passage created by \cs{fetchverse}. In this document, we
+demonstrate the basic features of the \texttt{replace} key and demonstrate
+some `radical' applications as well.
+
+We begin with an environment not documented in \texttt{fetchbibpes\_man.pdf},
+the \texttt{declareBVs} environment.
+\begin{verbatim}
+\begin{declareBVs}
+\BV(Mat 2:1 KJV) Now when Jesus was born in Bethlehem of Judaea
+in the days of Herod the king, behold, there came wise men from
+the east to Jerusalem,\null
+\end{declareBVs}
+\end{verbatim}
+Its used to define a Bible passage as seen in the DEF file. It is useful
+declaring a passage or two under discussion. The syntax for the argument of
+\cs{BV} is explained in the reference manual of \pkg{fetchbibpes}. Once
+declared, we can use it.
+\begin{declareBVs}
+\BV(Mat 2:1 KJV) Now when Jesus was born in Bethlehem of Judaea in the days
+of Herod the king, behold, there came wise men from the east to Jerusalem,\null
+\end{declareBVs}
+
+This verse is fetched as follows.
+\begin{quote}
+\fetchverse{Mat 2:1}
+\end{quote}
+The verse continues to the next passage (Mat 2:2) and ends with a comma. As
+this is a stand alone quotation, we want to end the passage with a period
+instead. There are two commas in the verse, we replace the comma that follows
+`Jerusalem'.
+\begin{quote}
+\verb|\fetchverse[replace={Jerusalem,}{Jerusalem.}]{Mat 2:1}|\\[3pt]
+\fetchverse[replace={Jerusalem,}{Jerusalem.}]{Mat 2:1}
+\end{quote}
+For the second example, we do two replacements: (1) replace the comma
+following `\texttt{Jerusalem}' with a period; and (2) change every instance
+of `\texttt{Jesus}' to `\verb|\textbf{\textcolor{red}{Jesus}}|', just because
+we can.
+\begin{quote}
+\verb|\fetchverse[replace={Jerusalem,}{Jerusalem.}|\\
+\null\hskip20pt\verb|{Jesus}{\textbf{\textcolor{red}{Jesus}}}]{Mat 2:1}|\\[3pt]
+\fetchverse[replace={Jerusalem,}{Jerusalem.}
+{Jesus}{\textbf{\textcolor{red}{Jesus}}}]{Mat 2:1}
+\end{quote}
+\let\bMrk\relax\let\eMrk\relax
+\begin{declareBVs}
+\BV(Gen 1:1 KJV Mrk) In the \bMrk beginning God \eMrk %
+created the heaven and the earth.\null
+\end{declareBVs}
+Generally, commands in the first argument are discouraged, but they can be
+used very carefully. In the example below, we test a couple of things. We
+defined a new passage
+\begin{verbatim}
+\letEach\bit\eit\bCol\eCol\to\relax
+\BV(Gen 1:1 KJV Mrk) In the \bMrk beginning God \eMrk created %
+ the heaven and the earth.\null
+\end{verbatim}
+We've marked off arbitrary text for manipulation. In the example below, we
+(1)~change all text between the markers to bold and red; (2) change the bold
+(\cs{bfseries}) to san-serif (\cs{sffamily}); (3)~convert \cs{sffamily} to
+\cs{ttfamily}. The code is,
+\begin{verbatim}
+\fetchverse[%
+ replace={\bMrk}{\bgroup\protect\bfseries\protect\color{red}}
+ {\eMrk}{\egroup}{\bfseries}{\sffamily}{\sffamily}{\ttfamily},
+alt=Mrk]{Gen 1:1}
+\end{verbatim}
+Note the use of \cs{protect} in the first replacement text, this prevents \cs{bfseries}
+and \cs{color} from being expanded into their primitive definitions; consequently, the
+tokens \cs{bfseries} and \cs{color} are still present by the time of the second search.
+
+Will it work? I wouldn't have wasted my time typing this out
+if it didn't! Here goes!
+\begin{fpquote}[rightmargin=0pt]
+\fetchverse[replace={\bMrk}{\bgroup\protect\bfseries\protect\color{red}}{\eMrk}{\egroup}
+{\bfseries}{\sffamily}{\sffamily}{\ttfamily},alt=Mrk]{Gen 1:1}
+\end{fpquote}
+Ho, ho, it worked!
+
+\letEach\bit\eit\bCol\eCol\to\relax
+\begin{declareBVs}
+\BV(Mat 8:10 NKJV Mrk) When Jesus heard \bit it\eit, %
+He marveled, and said to those who followed, \bCol"Assuredly, %
+I say to you, I have not found such great faith, not even in %
+Israel!\eCol\null
+\end{declareBVs}
+
+\medskip\noindent
+Here's another crazy idea. Consider the following passage:
+\begin{verbatim}
+\letEach\bit\eit\bCol\eCol\to\relax
+\begin{declareBVs}
+\BV(Mat 8:10 NKJV Mrk) When Jesus heard \bit it\eit, He marveled,
+and said to those who followed, \bCol"Assuredly, I say to you,
+I have not found such great faith, not even in Israel!\eCol\null
+\end{declareBVs}
+\end{verbatim}
+The passage is marked up several commands \cs{let} to \cs{relax}. If no replacement occurs, the passage should
+appear normally, without any special formatting. However, if we do a nice replacement, we get formatting.
+\begin{quote}
+\fetchverse[replace={\bit}{\textit\bgroup}{\eit}{\egroup}
+{\bCol}{\bgroup\color{red}}{\eCol}{\egroup}{!}{!''},from*=NKJV,alt=Mrk]{Mat 8:10}\bDQ
+\end{quote}
+The Words of Jesus continue on to the next verse, not displayed, so we'll replace the final exclamation
+point (\texttt{!}) with `\verb|!''|'.
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replaces.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replaces.tex
new file mode 100644
index 00000000..9febecf3
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_replaces.tex
@@ -0,0 +1,129 @@
+\documentclass{article}
+% useverses=none avoids a warning in the log when there is not value for
+% userverses. In this document we define our verses 'by hand' using the
+% declareBVs environment.
+\usepackage[ignorecfg,useverses=none]{fetchbibpes}[2016/09/21]
+\usepackage{fancyvrb}
+
+\providecommand\cs[1]{\texttt{\char`\\#1}}
+\let\pkg\texttt
+\def\ameta#1{$\langle\textit{\texttt{#1}}\rangle$}
+
+
+\addtoBibles{NKJV}
+\defaultBible{NKJV}
+
+
+\begin{declareBVs}
+\BV(Gal 1:15 NKJV) But when it pleased God, who separated me from my mother's womb and called me through His grace,\null
+\BV(Gal 1:16 NKJV) to reveal His Son in me, that I might preach Him among the Gentiles, I did not immediately confer with flesh and blood,\null
+\end{declareBVs}
+
+\begin{document}
+
+\section{Testing replace with \cs{fetchverses}}
+
+This demonstration file features the \texttt{replace} key within the
+optional argument of \cs{fetchverses}. We use as our test passes \textsf{Gal
+1:15-16}.
+
+\medskip\noindent\textbf{Unmodified passage}
+\begin{quote}
+\eSQ\fetchverses*{Gal 1:15-16}
+\end{quote}
+
+\medskip\noindent
+We declare the following verses:
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\fetchverses[%
+ replace={But when}{\leavevmode\ldots when}
+ {blood,}{blood, \ldots (\textit{continues with verse 17})}
+]{Gal 1:15-16}
+\end{Verbatim}
+which displays as,
+\begin{quote}
+\fetchverses[%
+ replace={But when}{\leavevmode\ldots when}
+ {blood,}{blood, \ldots (\textit{continues with verse 17})}
+]{Gal 1:15-16}
+\end{quote}
+
+\medskip\noindent
+A more extensive example of \texttt{replace} is the following one, which requires
+special techniques.
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\gobbleto{and}{\gobbletoand}%
+\fetchverses*[replace={But when}{\leavevmode\ldots when}
+ {who separated}{who\gobbletoand}
+% {who separated me from my mother's womb and}{who}
+ {, that I might preach Him among the Gentiles,
+ I did not immediately confer with flesh and blood,}
+ { \ldots}
+]{Gal 1:15-16}
+\end{Verbatim}
+\begin{quote}
+\gobbleto{and}{\gobbletoand}%
+\fetchverses*[replace={But when}{\leavevmode\ldots when}
+ {who separated}{who\gobbletoand}
+% {who separated me from my mother's womb and}{\textbf{who}}
+ {, that I might preach Him among the Gentiles,
+ I did not immediately confer with flesh and blood,}{ \ldots}
+]{Gal 1:15-16}
+\end{quote}
+The original \ameta{find} text is `\texttt{who separated me from my mother's
+womb and}'. The fact that this \ameta{find} text contains an apostrophe is a
+problem. Apostrophises (right single quotes), left single quotes, and double
+quotes are \emph{active characters} (within the Bible passages);
+consequently, they prevent a correct match. To circumvent this problem, we
+gobble all text past any active characters (an apostrophe, in this example).
+This is where \cs{gobbleto} comes in. Declare
+\verb|\gobbleto{and}{\gobbletoand}|, this defines a macro \cs{gobbletoand}
+that gobbles all text from where it is placed to the next occurrence of the
+word `and', in this example. Now, instead of using a \ameta{find} text
+containing an apostrophe, we use `\texttt{who separated}' as the \ameta{find}
+text, and for the \ameta{replace} text, we use `\texttt{who\cs{gobbletoand}},
+which, incredibly, works!
+
+\medskip
+The use of the gobble trick is not restricted to passages containing active
+characters. For example, the third \ameta{find} text is rather long. We can do the
+following:
+\begin{Verbatim}[xleftmargin=\leftmargini]
+\gobbleto{and}{\gobbletoand}%
+\gobbleto{blood,}{\gobbletoblood}%
+\fetchverses*[replace=
+ {But when}{\leavevmode\ldots when}
+ {who separated me}{who\gobbletoand}
+ {, that I might}{\ldots{}.\gobbletoblood}
+]{Gal 1:15-16}
+\end{Verbatim}
+\begin{quote}\eSQ
+\gobbleto{and}{\gobbletoand}\gobbleto{blood,}{\gobbletoblood}
+\fetchverses*[replace=
+ {But when}{\leavevmode\ldots when}
+ {who separated me}{who\gobbletoand}
+ {, that I might}{ \ldots\gobbletoblood}
+]{Gal 1:15-16}
+\end{quote}
+
+To make the `\cs{gobbleto}' definitions local, put them in a group, as in the \texttt{quote} environment as above, or
+they can be passed into a group in which \cs{fetchverse} and \cs{fetchverses} operate using the \texttt{localdefs} key.
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\fetchverses*[%
+ localdefs={\gobbleto{and}{\gobbletoand}%
+ \gobbleto{blood,}{\gobbletoblood}},
+ replace={But when}{\leavevmode\ldots when}
+ {who separated me}{who\gobbletoand}
+ {, that I might}{\ldots{}.\gobbletoblood}
+]{Gal 1:15-16}
+\end{Verbatim}
+\eSQ
+\fetchverses*[%
+ localdefs={\gobbleto{and}{\gobbletoand}%
+ \gobbleto{blood,}{\gobbletoblood}},
+ replace={But when}{\leavevmode\ldots when}
+ {who separated me}{who\gobbletoand}
+ {, that I might}{ \ldots\gobbletoblood}
+]{Gal 1:15-16}
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sf.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sf.tex
new file mode 100644
index 00000000..e977bb0b
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sf.tex
@@ -0,0 +1,97 @@
+\documentclass{article}
+
+\usepackage[deffolder=exmpldefs,ignorecfg,
+ useselverses,useverses=verses]{fetchbibpes}
+
+\title{The \textsf{fetchbibpes} package\\[3pt]Inputting selected verses only}
+\author{D. P. Story}
+\date{\today}
+
+
+\selectedVersesFrom
+{
+ {onlyverses={Col 1:6}}
+ {alt=Alt,onlyverses={Col 1:6}}
+ {from=ISV,alt=Alt,onlyverses={Gen 1:1}}
+ {onlyverses=1Ki} % exclude all verses from 1Ki KJV
+% {from=ISV,onlyverses=1Ki} % uncomment to exclude 1Ki ISV
+% {from=ISV,onlyverses={Gen 1:1}} % uncomment to fetch Gen 1:1 ISV
+}
+
+\useBookStyle{abbr=long,roman=false}
+
+\addtolength{\marginparwidth}{36pt}
+\parindent0pt \parskip6pt
+
+\begin{document}
+
+\maketitle
+
+In the preamble, we declare:
+\small
+\begin{verbatim}
+\selectedVersesFrom
+{
+ {onlyverses={Col 1:6}}
+ {alt=Alt,onlyverses={Col 1:6}}
+ {from=ISV,alt=Alt,onlyverses={Gen 1:1}}
+ {onlyverses=1Ki} % exclude all verses from 1Ki KJV
+% {from=ISV,onlyverses=1Ki} % uncomment to exclude 1Ki ISV
+% {from=ISV,onlyverses={Gen 1:1}} % uncomment to fetch Gen 1:1 ISV
+}
+\end{verbatim}
+\normalsize
+The way the system works is that any combination of
+\texttt{book\symbol{32}bible[\symbol{32}alt]} specified by the
+\texttt{onlyverses}, \texttt{from} and \texttt{alt} keys are
+`registered'. (The \texttt{alt} key is optional so the third
+component may not appear.) What does registered mean? Well, using the first
+grouping above as an example, among all verses in the \textsf{DEF} files
+input that use a combination of \texttt{Col KJV} (\texttt{KJV}, not specified
+by the \texttt{from} key, it the default in this case), only \texttt{Col 1:6
+KJV} is defined. From the third grouping, \texttt{Gen ISV Alt} is registered,
+so only \texttt{Gen 1:1 ISV Alt} is defined.
+
+Now we fetch some verses with comments in the margin.\marginpar{\bfseries Comments}
+
+\verb|\fetchverse[from*=KJV]{Col 1:6}|\marginpar{\footnotesize\texttt{Col KJV} is
+registered with valid `only verse'}\\[3pt]
+\fetchverse[from*=KJV]{Col 1:6}
+
+\verb|\fetchverse[alt=Alt,transl=KJV Alt]{Col 1:6}|\marginpar{\footnotesize\texttt{Col KJV Alt}
+is registered, valid `only verse'}\\[2pt]
+\fetchverse[alt=Alt,transl=KJV Alt]{Col 1:6}
+
+\verb|\fetchverse[transl=KJV]{Col 1:8}|\marginpar{\footnotesize\texttt{Col KJV} is registered, but
+the verse is not one of the `only verses'}\\[3pt]
+\fetchverse[transl=KJV]{Col 1:8}
+
+\bigskip
+\verb|\fetchverse[transl=KJV]{Mat 2:1}|\marginpar{\footnotesize\texttt{Mat KJV} not registered so any passage
+from \texttt{Mat KJV} is permitted}\\[3pt]
+\fetchverse[transl=KJV]{Mat 2:1}
+
+\verb|\fetchverse[from=ISV,alt=Alt,transl=ISV Alt]{Gen 1:1}|\marginpar{\footnotesize\texttt{Gen ISV Alt}
+is registered, valid `only verse'}\\[3pt]
+\fetchverse[from=ISV,alt=Alt,transl=ISV Alt]{Gen 1:1}
+
+\bigskip
+\verb|\fetchverse[from*=ISV]{Gen 1:1}|\marginpar{\footnotesize\texttt{Gen ISV} is registered, but
+the verse is not an `only verse' }\\[3pt]
+\fetchverse[from*=ISV]{Gen 1:1}
+
+Additional comments on the last two are needed. We \emph{explicitly} registered
+\texttt{Gen~ISV~Alt}; however, to make this system work in the way desired,
+\texttt{Gen~ISV} is \emph{implicitly} registered too.
+
+\verb|\fetchverse{1Ki 1:1}|\marginpar{\footnotesize\texttt{1Ki KJV} is registered, but none of the
+verses are `only verses' }\\[3pt]
+\fetchverse{1Ki 1:1}
+
+\bigskip
+
+\verb|\fetchverse[from*=ISV]{1Ki 1:1}|\marginpar{\footnotesize\texttt{1Ki ISV} is not register so
+any passage from \texttt{1Ki ISV} is permitted}\\[3pt]
+\fetchverse[from*=ISV]{1Ki 1:1}
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sr.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sr.tex
new file mode 100644
index 00000000..50af534e
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_sr.tex
@@ -0,0 +1,59 @@
+\documentclass{article}
+\usepackage{etoolbox}
+\usepackage{bibleref-parse}
+\usepackage[deffolder=exmpldefs,usesr,
+ useverses=verses]{fetchbibpes}
+\usepackage{makeidx}
+\usepackage[columns=1]{idxlayout}
+
+\makeatletter
+\renewcommand{\l@section}{\@dottedtocline{1}{1.5em}{4.75em}}
+\makeatother
+\renewcommand{\indexname}{Index to Scriptures}
+
+\setbooktitle{Genesis}{Gen}
+\setindexbooktitle{Gen}{Genesis (Gen)}
+\biblerefmap{Gen}{01}
+\setbooktitle{Matthew}{Mat}
+\setindexbooktitle{Matt}{Matthew (Mat)}
+\biblerefmap{Mat}{40}
+\setbooktitle{ICorinthians}{1Co}
+\setindexbooktitle{1Cor}{1 Corinthians (1Co)}
+\biblerefmap{1Co}{46}
+
+
+\makeindex
+
+\title{The \textsf{fetchbibpes} package\\[3pt]Illustrating the \textsf{sr} command}
+\author{D. P. Story}
+\date{\today}
+
+\begin{document}
+
+\maketitle
+
+\tableofcontents
+
+\section{Verses from Genesis}
+
+ Moses, the author of the Book of Genesis, describes creation, \sr{for it is
+ written}{Gen 1:1-10}: \fetchverses[showfirst]{Gen 1:1-10}
+
+ \sr{}{Php 2:13} ``\fetchverses{Php 2:13}''
+
+\section{Some words from Matthew}
+
+ \sr{In the times of old}{Mat 2:1-6, 2:9-10} \fetchverses[showfirst]{Mat 2:1-6}
+ \emph{And the passage continues with verse 9}, \fetchverses[showfirst]{Mat 2:9-10}
+
+
+\section{Passages from I Corinthians}
+
+Paul greets the Church at Corinthian \sr{}{1Co 1:1-3} \fetchverses{1Co 1:1-3}
+
+
+% Index to Scriptures
+ \newpage
+ \printindex
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_substr.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_substr.tex
new file mode 100644
index 00000000..500f0d06
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_substr.tex
@@ -0,0 +1,98 @@
+\documentclass{article}
+\usepackage[useverses=none,fetchsubstr]{fetchbibpes}
+\usepackage{fancyvrb}
+
+\addtoBibles{NKJV}
+\defaultBible{NKJV}
+
+\def\cs#1{\texttt{\char`\\#1}}
+
+%\parindent0pt \parskip6pt
+
+\begin{document}
+
+\begin{declareBVs*}
+\BV(Mat 6:31 NKJV) ``Therefore do not worry, saying, `What shall we eat?'
+ or `What shall we drink?' or `What shall we wear?'\null
+\BV(Mat 6:32 NKJV) For after all these things the Gentiles seek.
+ For your heavenly Father knows that you need all these things.\null
+\BV(Mat 6:33 NKJV) But seek first the kingdom of God and His righteousness,
+ and all these things shall be added to you.\null
+\end{declareBVs*}
+
+\noindent We use the following verses:
+\begin{Verbatim}[fontsize=\small]
+\begin{declareBVs*}
+\BV(Mat 6:31 NKJV) ``Therefore do not worry, saying, `What shall we eat?'
+ or `What shall we drink?' or `What shall we wear?'\null
+\BV(Mat 6:32 NKJV) For after all these things the Gentiles seek.
+ For your heavenly Father knows that you need all these things.\null
+\BV(Mat 6:33 NKJV) But seek first the kingdom of God and His
+ righteousness, and all these things shall be added to you.\null
+\end{declareBVs*}
+\end{Verbatim}
+
+\parindent0pt \parskip6pt
+
+\textbf{Important Note:} The command \cs{markverse} only supports
+\emph{one verse at a time}, not a range of verses.
+
+\textbf{Declare:} \verb!\markverse[name=don,marks={}{seek.}{}{drink}!,\\
+\null\qquad\qquad\verb!{C}{D}{For your}{things.}]{Mat 6:32}!
+
+Above, we include some bogus marks (\verb~{}{drink}~ and \verb~{C}{D}~), ones
+that are not found. The package works hard to identify marks that do not
+exist, and to recover correctly. The pairs of marks \verb~{}{drink}~ and
+\verb~{C}{D}~ are still indexed, the results are seen in \texttt{alt=don2}
+and \texttt{alt=don3}.
+
+\markverse[name=don,marks={}{seek.}{}{drink}{C}{D}{For your}{things.}]{Mat 6:32} %{}{drink?'}{C}{D}{For your}{things.}
+
+\fetchverse[alt=don1]{Mat 6:32}
+
+\fetchverse[alt=don2]{Mat 6:32}
+
+\fetchverse[alt=don3]{Mat 6:32}
+
+\fetchverse[alt=don4]{Mat 6:32}
+
+\textbf{Declare:} \verb~\markverse[name=tom,~\\
+\null\qquad\qquad\qquad\verb~marks={}{eat?'}{}{drink?'}{}{wear?'}]{Mat 6:31}~
+\markverse[name=tom,marks={}{eat?'}{}{drink?'}{}{wear?'}]{Mat 6:31}
+
+The package writes to the hard drive and inputs the definitions back in at
+the top of the file. The auxiliary file is \cs{jobname-bv.cut}
+(\texttt{\jobname-bv.cut} for this particular file). In this way, you can
+inspect the file to see if the substrings are correct. The
+\texttt{\jobname-bv.cut} contains \cs{BV} definitions; consequently, the
+\cs{fetchverse} or \cs{fetchverses} commands can be used to access the
+substrings.
+
+With \cs{fetchverse} or \cs{fetchverses} use the \texttt{alt} key to access
+any of the defined substrings:
+
+\verb~\fetchverses[from=NKJV,alt=tom1]{Mat 6:31}~\\[3pt]
+\fetchverses[from=NKJV,alt=tom1]{Mat 6:31}
+
+Since NKJV is the default, the use of the \texttt{from} key is not needed.
+
+You can use the key-values of \cs{fetchverses} to add in stuff at the
+beginning and end of the passage.
+
+\verb~\fetchverse[nocite,enclosewith={Begin-}{-End},alt=tom2]{Mat 6:31}~\\[3pt]
+\fetchverse[nocite,enclosewith={Begin-}{-End},alt=tom2]{Mat 6:31}
+
+\verb~\fetchverse[alt=tom4]{Mat 6:31}~\\[3pt]
+\fetchverse[alt=tom4]{Mat 6:31}
+
+This last fetch, for \texttt{alt=tom4}, is undefined, but the new \texttt{alt} convention
+then says to typeset the verse `Mat 6:31' without the \texttt{alt} specification. As a
+result, we get the whole of verse 31.
+
+If expand \cs{useOldAlt}, we get the old behavior:\\[3pt]\useOldAlt
+\fetchverses[alt=tom4]{Mat 6:31}\useNewAlt
+
+That's all for now. dps
+
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_tst.tex b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_tst.tex
new file mode 100644
index 00000000..1f8304ee
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/bibpes_tst.tex
@@ -0,0 +1,269 @@
+\documentclass{article}
+\usepackage{array,calc,fancyvrb}
+
+\usepackage[deffolder=exmpldefs,ignorecfg,
+ useverses=verses]{fetchbibpes}
+
+\title{Illustrating the \textsf{fetchbibpes} package}
+\author{D. P. Story}
+\date{\today}
+
+\addtoBibles{ASV}
+\useBookStyle{abbr=long,roman=false}
+
+\addtolength{\marginparwidth}{6pt}
+\providecommand\meta[1]{\textsl{\texttt{#1}}}
+\def\ameta#1{$\langle\meta{#1}\rangle$}
+\providecommand\marg[1]{%
+ {\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}}
+\def\cs#1{{\ttfamily\char`\\#1}}
+
+\begin{document}
+
+\maketitle
+
+\section{The fetch commands}
+
+This package defines two fetching commands, the syntax for these are,
+\begin{quote}\ttfamily
+ \string\fetchverse[\ameta{opts}]\marg{\meta{book}\symbol{32}\meta{ch}:\meta{vrs}}\\[3pt]
+ \string\fetchverses*[\ameta{opts}]\marg{\meta{book}\symbol{32}\meta{ch}:\meta{vrs}} or\\[3pt]
+ \string\fetchverses*[\ameta{opts}]\marg{\meta{book}\symbol{32}\meta{ch}:\meta{vrs\ensuremath{{}_1}}-\meta{vrs\ensuremath{{}_2}}}
+\end{quote}
+The \texttt{*} parameter is optional, when present the book and verse
+references are shown, otherwise they are not.
+
+\verb!\fetchverses*{Gen 1:1-2}! produces ``\fetchverses*{Gen 1:1-2}'' While
+\verb!\fetchverses{Gen 1:1-2}! produces ``\fetchverses{Gen 1:1-2}'' Notice in
+the first case \texttt{(Gen 1:1-2)} is included with the passage.
+
+With the \ameta{opts} optional arguments, you can typeset the
+passage reference in various styles.
+
+There are options for abbreviating the passage reference, as you see below,
+different methods are used. An option for capitalizing the passage reference, and formatting
+to your heart's desire.
+
+\section{Formatting of passage references}
+
+The default passage reference format was illustrated in the previous section,
+we present variations in this section.
+
+\medskip\noindent
+\fetchverse[caps,format={\bfseries\sffamily},abbr=none,from*=KJV]{Gen 1:1}
+
+\medskip\noindent
+\fetchverse[delims,caps,format={\bfseries\sffamily},abbr=none,transl=(KJV)]{Gen 1:1}
+
+\medskip\noindent
+\fetchverse[delims,caps,format={\bfseries\sffamily},abbr=none,from=ISV,transl=(ISV)]{Gen 1:1}
+
+\medskip\noindent
+The passage reference may be placed at the end of the passage using the \texttt{citetend}
+option. The \cs{priorRefSpc} may be used here to aid placement.
+\begin{quote}
+\priorRefSpc{\fbFillRght}\afterBookSpc{\ }\fetchverses*[showfirst,citeatend]{Gen 1:1-3}
+
+\priorRefSpc{\fbFitItIn}\afterBookSpc{\nobreak\ }
+\fetchverses*[showfirst,citeatend]{Gen 1:1-3}
+\end{quote}
+
+\noindent
+\verb|\fetchverse[abbr=none,delims={According to }{,},|\\\null
+\qquad\verb|enclosewith=\quote]{Gen 1:1}|\\[3pt]
+\fetchverse[abbr=none,delims={According to }{,},enclosewith=\quote]{Gen 1:1}
+
+\section{Various abbreviations for books}
+
+\useBookStyle{abbr=none,roman=true}
+
+Here we don't use an abbreviation (full book names are used) and we use
+roman numerals for the book number. (I Corinthians versus 1 Corinthians).
+
+\medskip\noindent
+\fetchverse{1Co 1:1}
+
+\useBookStyle{abbr=short,roman=false}
+
+
+\medskip\noindent
+\fetchverses*[useperiod=false]{1Co 1:1-5}
+
+\begin{itemize}
+\item\fetchverse{Gen 1:11} (This verse is undefined, if you want to
+ reference it you need to included it in one of the \textsf{DEF} files.)
+
+\item \fetchverse{Gen 1:10}
+
+\item \fetchverse[from*=ISV]{Gen 1:10}
+\end{itemize}
+
+\section{Special formatting a long passage}
+
+%\newcommand{\verseFmt}[1]{${}^{\fb@sc{#1}}$}
+\newlength\verseBoxLength
+\settowidth{\verseBoxLength}{\normalsize\normalfont0000}
+\renewcommand{\verseFmt}[1]{\par\noindent\makebox[\verseBoxLength][c]{#1}}
+\afterRef{\par\kern3pt}
+
+In the next passage, I've changed the formatting style of the multiple
+passages, it looks more like my own Bible given to me back in the 1980's.
+
+\begin{quote}
+\fetchverses*[showfirst,delims,caps,format={\bfseries\sffamily},abbr=none]{Gen 1:1-10}
+\end{quote}
+
+\medskip\noindent Now we switch back to the default presentation style
+by expanding the command pair \verb|\afterRef{}\verseFmtReset|, needed only if a change
+in format occurred outside a group.
+
+\afterRef{}\verseFmtReset
+
+\begin{quote}
+\fetchverses*[abbr=none]{Gen 1:2-3}
+\end{quote}
+
+\noindent
+\fetchverse{Mat 2:1}
+
+\begin{quote}
+\fetchverses*[abbr=none]{Mat 2:1-6}
+\end{quote}
+
+\noindent
+In this next passage, \texttt{KJV+} is used, which includes \textsl{Strong's
+Concordance} numbers.\\[3pt]
+\fetchverses*[useperiod=false,abbr=short,from*=KJV+]{Rom 1:1}
+
+
+\paragraph*{Period or no Period.} When an abbreviation is used, you can include
+or exclude the period (1 Co. versus 1 Co).
+\begin{quote}
+\verb|\fetchverse[abbr=long]{1Co 1:1}|\\[3pt]
+\fetchverse[abbr=long]{1Co 1:1}
+
+\verb|\fetchverse[abbr=long,useperiod=false]{1Co 1:1}|\\[3pt]
+\fetchverse[abbr=long,useperiod=false]{1Co 1:1}
+\end{quote}
+
+\section{Side-by-side comparison of passages}
+
+\newlength\fvlength
+\begin{flushleft}
+\footnotesize \tabcolsep=3pt %.5\columnsep
+\setlength{\fvlength}{.5\linewidth-\tabcolsep}
+\renewcommand{\verseFmt}[1]{\par\noindent\makebox[\verseBoxLength][c]{{#1}}}%
+\settowidth{\verseBoxLength}{000}%\medskip\noindent
+\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}>{\footnotesize}p{\fvlength}>{\footnotesize}p{\fvlength}@{}}
+\multicolumn{2}{@{}>{\normalsize}c@{}}{\textbf{\textsf{I Kings 1:1-5}:} A Comparison of Versions}\\[3pt]
+\multicolumn{1}{@{}>{\small}c@{}}{King James Version (KJV)}&%
+\multicolumn{1}{@{}>{\small}c@{}}{International Standard Version (ISV)}\\[3pt]
+\fetchverses[showfirst]{1Ki 1:1}&\fetchverses[showfirst,from=ISV]{1Ki 1:1}\\
+\fetchverses[showfirst]{1Ki 1:2}&\fetchverses[showfirst,from=ISV]{1Ki 1:2}\\
+\fetchverses[showfirst]{1Ki 1:3}&\fetchverses[showfirst,from=ISV]{1Ki 1:3}\\
+\fetchverses[showfirst]{1Ki 1:4}&\fetchverses[showfirst,from=ISV]{1Ki 1:4}\\
+\fetchverses[showfirst]{1Ki 1:5}&\fetchverses[showfirst,from=ISV]{1Ki 1:5}%
+\end{tabular*}
+\end{flushleft}
+
+\verseFmtReset
+
+\section{Roman versus arabic numbers}
+
+\begin{itemize}
+ \item \fetchverse{1Co 1:1}
+ \item \fetchverse[roman]{1Co 1:1}
+\end{itemize}
+
+\section{Adding Bibles}
+
+The next example uses \verb~\addtoBibles{ASV}~ in the preamble. The
+\textsf{fetchbibpes} package only recognizes three Bible translations, KJV,
+KJV+, and ISV, as values of the \texttt{from} or \texttt{from*} key. If you
+reference a Bible other than these three, the KJV is used and a warning
+appears in the {\TeX} log. However, you can add to the selection of Bibles
+with the \texttt{\string\addtoBibles} command in the preamble. I downloaded
+the American Standard Version (ASV), copied the first ten verses from
+Genesis, and created the \texttt{Gen-ASV.def} file. After placing
+\verb~\addtoBibles{ASV}~ in the preamble, I can fetch the verses in the usual
+way: \verb!\fetchverses*[from*=ASV]{Gen 1:1-10}!, as seen below with the
+passage reference in the margin.
+
+\useBookStyle{abbr,roman=false}
+
+\def\mpfmt#1{\afterRef{{}}\marginpar{\small\raggedright#1}}
+
+\medskip\noindent
+\fetchverses*[showfirst,priorref=\mpfmt,delims,from*=ASV]{Gen 1:1-5}
+
+\section{Marginal notes}
+
+By ``clever'' manipulation of the parameters, you can make
+marginal notes of the verses. We declare,
+\begin{Verbatim}[xleftmargin=\leftmargini,fontsize=\small]
+\fbMarNotesOn
+\verseCmts
+{%
+ {In the beginning} % v1
+ {Earth void} % v2
+ {Light!} % v3
+ {} % v4
+ {First day} % v5
+}
+\end{Verbatim}
+\fbMarNotesOn
+\verseCmts
+{%
+ {In the beginning} % v1
+ {Earth void} % v2
+ {Light!} % v3
+ {} % v4
+ {First day} % v5
+}
+\afterRef{\par\kern3pt}
+
+\noindent
+We use the \texttt{fpquote} environment with \texttt{rightmargin=0pt}.
+\begin{fpquote}[rightmargin=0pt]\marginparpush0pt
+\fetchverses*[showfirst,delims,caps,format={\bfseries\sffamily},abbr=none]{Gen 1:1-5}
+\end{fpquote}
+\afterRef{}\verseCmts{}\fbMarNotesOff
+
+\medskip\noindent Or, with a little more effort, place passage and reference within the margins.
+\fbMarNotesOn
+\verseCmts{%
+ {In the beginning God creates the heaven and the earth\dots}
+ {Earth void}
+ {Light!}
+ {}
+ {First day}
+}
+\newlength\fbrightmargin \fbrightmargin=80pt
+\newlength\vrseNumlength
+\settowidth\vrseNumlength{\verseFmt{0}}
+\renewcommand{\fbMarParFmt}[1]{\marginpar{\footnotesize
+ \makebox[0pt][r]{\verseFmt{\vrseNum}%
+ \parbox[t]{\fbrightmargin}{\raggedright\strut#1\strut}%
+ \hspace{\marginparsep}}\hfill}}
+\afterRef{\par\kern3pt}
+\begin{fpquote}[leftmargin=0pt,rightmargin=\marginparsep+\fbrightmargin+\vrseNumlength]
+\marginparpush0pt
+\fetchverses*[showfirst,delims,caps,format={\bfseries\sffamily},abbr=none]{Gen 1:1-5}
+\end{fpquote}
+\fbResetMarParFmt\verseCmts{}\afterRef{}\fbMarNotesOff
+
+
+%\newpage
+\noindent
+We now test the inverse lookup of the full book names (e.g., Genesis $\rightarrow$ Gen)
+
+\medskip\noindent\verb~\fetchverse{Genesis 1:1}~\\
+\fetchverse{Genesis 1:1}
+
+\medskip\noindent\verb~\fetchverses{Genesis 1:1-4}~\\
+\fetchverses{Genesis 1:1-4}
+
+\medskip\noindent\verb~\fetchverses{ICorinthians 1:1-3}~\\
+\fetchverses{ICorinthians 1:1-3}
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/combpkgs.tex b/texmf-dist/doc/latex/fetchbibpes/examples/combpkgs.tex
new file mode 100644
index 00000000..5c647f99
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/combpkgs.tex
@@ -0,0 +1,50 @@
+%
+% Download and install aeb_mobile (aeb-mobile), the spdef is part of that package.
+% use=builddefs creates a switch \ifbuilddefs set to true
+% !use=builddefs creates a switch \ifbuilddefs set to false
+%
+% Use use=builddefs to create new DEF files from TXT files
+% Use !use=builddefs to compile the rest of the document, skipping over
+% the use of bibpes.
+%
+\RequirePackage[use=builddefs]{spdef}
+\ifbuilddefs
+%
+% The bibpes portion of the document
+%
+\documentclass{article}
+%
+% Uncomment the options as needed, only the
+% txtfilein is required
+%
+\usepackage[%!build,% after building the DEF file, you can get a listing without rebuilding by specifying the !build option
+% infolder=<folder>,
+% outfolder=<folder>,
+% txtfilein=<file>
+]{bibpes}
+
+\bibpesBody\fi
+
+%
+% Begin the fetchbibpes portion of the document
+%
+\documentclass{article}
+
+\usepackage[
+ deffolder=mydefs,
+ useverses={Col,Gen1,Gen-YLT}
+]{fetchbibpes}
+
+\useBookStyle{abbr=long,roman=false}
+
+\parindent0pt \parskip6pt
+
+\begin{document}
+
+\fetchverse{Col 1:6}
+
+\fetchverse[from=Alt]{Col 1:6}
+
+\fetchverse[from=YLT]{Gen 1:1}
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/exmpldefs/verses.def b/texmf-dist/doc/latex/fetchbibpes/examples/exmpldefs/verses.def
new file mode 100644
index 00000000..1b41cf89
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/exmpldefs/verses.def
@@ -0,0 +1,74 @@
+%
+% Old testament
+%
+% Genesis 1:1-10, King James Version (KJV)
+\BV(Gen 1:1 KJV) In the beginning God created the heaven and the earth.\null
+\BV(Gen 1:1 KJV Alt) \dots \emph{God created the heaven and the earth}.\null
+\BV(Gen 1:2 KJV) And the earth was without form, and void; and darkness was upon the face of the deep. And the Spirit of God moved upon the face of the waters.\null
+\BV(Gen 1:3 KJV) And God said, Let there be light: and there was light.\null
+\BV(Gen 1:4 KJV) And God saw the light, that it was good: and God divided the light from the darkness.\null
+\BV(Gen 1:5 KJV) And God called the light Day, and the darkness he called Night. And the evening and the morning were the first day.\null
+\BV(Gen 1:6 KJV) And God said, Let there be a firmament in the midst of the waters, and let it divide the waters from the waters.\null
+\BV(Gen 1:7 KJV) And God made the firmament, and divided the waters which were under the firmament from the waters which were above the firmament: and it was so.\null
+\BV(Gen 1:8 KJV) And God called the firmament Heaven. And the evening and the morning were the second day.\null
+\BV(Gen 1:9 KJV) And God said, Let the waters under the heaven be gathered together unto one place, and let the dry land appear: and it was so.\null
+\BV(Gen 1:10 KJV) And God called the dry land Earth; and the gathering together of the waters called he Seas: and God saw that it was good.\null
+% Genesis 1:1-10, International Standard Version (ISV)
+\BV(Gen 1:1 ISV) In the beginning, God created the universe.\null
+\BV(Gen 1:1 ISV Alt) \emph{In the beginning}, God created the universe.\null
+\BV(Gen 1:2 ISV) When the earth was as yet unformed and desolate, with the surface of the ocean depths shrouded in darkness, and while the Spirit of God was hovering over the surface of the waters,\null
+\BV(Gen 1:3 ISV) God said, "Let there be light!" So there was light.\null
+\BV(Gen 1:4 ISV) God saw that the light was beautiful. He separated the light from the darkness,\null
+\BV(Gen 1:5 ISV) calling the light "day," and the darkness "night." The twilight and the dawn were day one.\null
+\BV(Gen 1:6 ISV) Then God said, "Let there be a canopy between bodies of water, separating bodies of water from bodies of water!"\null
+\BV(Gen 1:7 ISV) So God made a canopy that separated the water beneath the canopy from the water above it. And that is what happened:\null
+\BV(Gen 1:8 ISV) God called the canopy "sky." The twilight and the dawn were the second day.\null
+\BV(Gen 1:9 ISV) Then God said, "Let the water beneath the sky come together into one area, and let dry ground appear!" And that is what happened:\null
+\BV(Gen 1:10 ISV) God called the dry ground "land," and he called the water that had come together "oceans." And God saw how good it was.\null
+% Genesis 1:1-2, Young's Literal Translation (YLT)
+\BV(Gen 1:1 YLT) In the beginning of God's preparing the heavens and the earth--\null
+\BV(Gen 1:2 YLT) the earth hath existed waste and void, and darkness is on the face of the deep, and the Spirit of God fluttering on the face of the waters,\null
+% Genesis 1:1-5, American Standard Version (ASV)
+\BV(Gen 1:1 ASV) In the beginning God created the heavens and the earth.\null
+\BV(Gen 1:2 ASV) And the earth was waste and void; and darkness was upon the face of the deep: and the Spirit of God moved upon the face of the waters.\null
+\BV(Gen 1:3 ASV) And God said, Let there be light: and there was light.\null
+\BV(Gen 1:4 ASV) And God saw the light, that it was good: and God divided the light from the darkness.\null
+\BV(Gen 1:5 ASV) And God called the light Day, and the darkness he called Night. And there was evening and there was morning, one day.\null
+% I Kings 1:1-5, KJV
+\BV(1Ki 1:1 KJV) Now king David was old and stricken in years; and they covered him with clothes, but he gat no heat.\null
+\BV(1Ki 1:2 KJV) Wherefore his servants said unto him, Let there be sought for my lord the king a young virgin: and let her stand before the king, and let her cherish him, and let her lie in thy bosom, that my lord the king may get heat.\null
+\BV(1Ki 1:3 KJV) So they sought for a fair damsel throughout all the coasts of Israel, and found Abishag a Shunammite, and brought her to the king.\null
+\BV(1Ki 1:4 KJV) And the damsel was very fair, and cherished the king, and ministered to him: but the king knew her not.\null
+\BV(1Ki 1:5 KJV) Then Adonijah the son of Haggith exalted himself, saying, I will be king: and he prepared him chariots and horsemen, and fifty men to run before him.\null
+% I Kings 1L1-5, ISV
+\BV(1Ki 1:1 ISV) When David had grown very old, they covered him with blankets, but he could not keep warm,\null
+\BV(1Ki 1:1 ISV Alt) When David had grown \emph{very old}, they covered him with blankets, but he could not keep warm,\null
+\BV(1Ki 1:2 ISV) so his servants suggested to him, "Let's look for a young virgin woman to take care of you, your majesty. She will be of use to you if you have her lie down near you so that your majesty may keep warm."\null
+\BV(1Ki 1:3 ISV) So they conducted a search throughout the territory of Israel for a beautiful young woman, and Abishag the Shunammite was located and brought to the king.\null
+\BV(1Ki 1:4 ISV) The young woman was absolutely beautiful. She served the king and was very useful to him. The king was not sexually involved with her.\null
+\BV(1Ki 1:5 ISV) Meanwhile, about this time Haggith's son Adonijah began to seek a reputation for himself and decided, "I'm going to be king!" So he prepared chariots, cavalry, and 50 soldiers to serve as a security detail to guard him.\null
+%
+% New testament
+%
+% Colassians 1:6, KJV
+\BV(Col 1:6 KJV) that has come to you. Just as it is bearing fruit and spreading all over the world, so it has been doing among you from the day you heard it and came to know the grace of God in truth.\null
+\BV(Col 1:6 KJV Alt) \dots Just as it is bearing fruit and spreading all over the world, so it has been doing among you from the day you heard it and came to know the grace of God in truth.\null
+% Matthew 2:1-10, KJV
+\BV(Mat 2:1 KJV) Now when Jesus was born in Bethlehem of Judaea in the days of Herod the king, behold, there came wise men from the east to Jerusalem,\null
+\BV(Mat 2:2 KJV) Saying, Where is he that is born King of the Jews? for we have seen his star in the east, and are come to worship him.\null
+\BV(Mat 2:3 KJV) When Herod the king had heard these things, he was troubled, and all Jerusalem with him.\null
+\BV(Mat 2:4 KJV) And when he had gathered all the chief priests and scribes of the people together, he demanded of them where Christ should be born.\null
+\BV(Mat 2:5 KJV) And they said unto him, In Bethlehem of Judaea: for thus it is written by the prophet,\null
+\BV(Mat 2:6 KJV) And thou Bethlehem, in the land of Juda, art not the least among the princes of Juda: for out of thee shall come a Governor, that shall rule my people Israel.\null
+\BV(Mat 2:7 KJV) Then Herod, when he had privily called the wise men, enquired of them diligently what time the star appeared.\null
+\BV(Mat 2:8 KJV) And he sent them to Bethlehem, and said, Go and search diligently for the young child; and when ye have found him, bring me word again, that I may come and worship him also.\null
+\BV(Mat 2:9 KJV) When they had heard the king, they departed; and, lo, the star, which they saw in the east, went before them, till it came and stood over where the young child was.\null
+\BV(Mat 2:10 KJV) When they saw the star, they rejoiced with exceeding great joy.\null
+% Romans 1:1 King James version w/Strongs Numbers (KJV+)
+\BV(Rom 1:1 KJV+) Paul,\G{3972} a servant\G{1401} of Jesus\G{2424} Christ,\G{5547} called\G{2822} to be an apostle,\G{652} separated\G{873} unto\G{1519} the gospel\G{2098} of God,\G{2316}\null
+% I Corinthians 1:1-5 KJV
+\BV(1Co 1:1 KJV) Paul, called to be an apostle of Jesus Christ through the will of God, and Sosthenes our brother,\null
+\BV(1Co 1:2 KJV) Unto the church of God which is at Corinth, to them that are sanctified in Christ Jesus, called to be saints, with all that in every place call upon the name of Jesus Christ our Lord, both theirs and ours:\null
+\BV(1Co 1:3 KJV) Grace be unto you, and peace, from God our Father, and from the Lord Jesus Christ.\null
+\BV(1Co 1:4 KJV) I thank my God always on your behalf, for the grace of God which is given you by Jesus Christ;\null
+\BV(1Co 1:5 KJV) That in every thing ye are enriched by him, in all utterance, and in all knowledge;\null
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/fetchverses-to-end.tex b/texmf-dist/doc/latex/fetchbibpes/examples/fetchverses-to-end.tex
new file mode 100644
index 00000000..1e103ddf
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/fetchverses-to-end.tex
@@ -0,0 +1,66 @@
+\documentclass{article}
+\usepackage[useverses=none]{fetchbibpes}[2018/03/21]
+
+\parindent0pt \parskip6pt
+
+\begin{document}
+
+\begin{declareBVs*}
+\BV(Gen 1:1 KJV) In the beginning God created the heaven and the earth.\null
+%
+\BV(Joh 3:1 KJV)  There was a man of the Pharisees, named Nicodemus, a ruler of the Jews:\null
+\BV(Joh 3:2 KJV)  The same came to Jesus by night, and said unto him, Rabbi, we know that thou art a teacher come from God: for no man can do these miracles that thou doest, except God be with him.\null
+\BV(Joh 3:3 KJV)  Jesus answered and said unto him, Verily, verily, I say unto thee, Except a man be born again, he cannot see the kingdom of God.\null
+\BV(Joh 3:4 KJV)  Nicodemus saith unto him, How can a man be born when he is old? can he enter the second time into his mother's womb, and be born?\null
+\BV(Joh 3:5 KJV)  Jesus answered, Verily, verily, I say unto thee, Except a man be born of water and of the Spirit, he cannot enter into the kingdom of God.\null
+\BV(Joh 3:6 KJV)  That which is born of the flesh is flesh; and that which is born of the Spirit is spirit.\null
+\BV(Joh 3:7 KJV)  Marvel not that I said unto thee, Ye must be born again.\null
+\BV(Joh 3:8 KJV)  The wind bloweth where it listeth, and thou hearest the sound thereof, but canst not tell whence it cometh, and whither it goeth: so is every one that is born of the Spirit.\null
+\BV(Joh 3:9 KJV)  Nicodemus answered and said unto him, How can these things be?\null
+\BV(Joh 3:10 KJV)  Jesus answered and said unto him, Art thou a master of Israel, and knowest not these things?\null
+\BV(Joh 3:11 KJV)  Verily, verily, I say unto thee, We speak that we do know, and testify that we have seen; and ye receive not our witness.\null
+\BV(Joh 3:12 KJV)  If I have told you earthly things, and ye believe not, how shall ye believe, if I tell you of heavenly things?\null
+\BV(Joh 3:13 KJV)  And no man hath ascended up to heaven, but he that came down from heaven, even the Son of man which is in heaven.\null
+\BV(Joh 3:14 KJV)  And as Moses lifted up the serpent in the wilderness, even so must the Son of man be lifted up:\null
+\BV(Joh 3:15 KJV)  That whosoever believeth in him should not perish, but have eternal life.\null
+\BV(Joh 3:16 KJV)  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.\null
+\BV(Joh 3:17 KJV)  For God sent not his Son into the world to condemn the world; but that the world through him might be saved.\null
+\BV(Joh 3:18 KJV)  He that believeth on him is not condemned: but he that believeth not is condemned already, because he hath not believed in the name of the only begotten Son of God.\null
+\BV(Joh 3:19 KJV)  And this is the condemnation, that light is come into the world, and men loved darkness rather than light, because their deeds were evil.\null
+\BV(Joh 3:20 KJV)  For every one that doeth evil hateth the light, neither cometh to the light, lest his deeds should be reproved.\null
+\BV(Joh 3:21 KJV)  But he that doeth truth cometh to the light, that his deeds may be made manifest, that they are wrought in God.\null
+\BV(Joh 3:22 KJV)  After these things came Jesus and his disciples into the land of Judaea; and there he tarried with them, and baptized.\null
+\BV(Joh 3:23 KJV)  And John also was baptizing in Aenon near to Salim, because there was much water there: and they came, and were baptized.\null
+\BV(Joh 3:24 KJV)  For John was not yet cast into prison.\null
+\BV(Joh 3:25 KJV)  Then there arose a question between some of John's disciples and the Jews about purifying.\null
+\BV(Joh 3:26 KJV)  And they came unto John, and said unto him, Rabbi, he that was with thee beyond Jordan, to whom thou barest witness, behold, the same baptizeth, and all men come to him.\null
+\BV(Joh 3:27 KJV)  John answered and said, A man can receive nothing, except it be given him from heaven.\null
+\BV(Joh 3:28 KJV)  Ye yourselves bear me witness, that I said, I am not the Christ, but that I am sent before him.\null
+\BV(Joh 3:29 KJV)  He that hath the bride is the bridegroom: but the friend of the bridegroom, which standeth and heareth him, rejoiceth greatly because of the bridegroom's voice: this my joy therefore is fulfilled.\null
+\BV(Joh 3:30 KJV)  He must increase, but I must decrease.\null
+\BV(Joh 3:31 KJV)  He that cometh from above is above all: he that is of the earth is earthly, and speaketh of the earth: he that cometh from heaven is above all.\null
+\BV(Joh 3:32 KJV)  And what he hath seen and heard, that he testifieth; and no man receiveth his testimony.\null
+\BV(Joh 3:33 KJV)  He that hath received his testimony hath set to his seal that God is true.\null
+\BV(Joh 3:34 KJV)  For he whom God hath sent speaketh the words of God: for God giveth not the Spirit by measure unto him.\null
+\BV(Joh 3:35 KJV)  The Father loveth the Son, and hath given all things into his hand.\null
+\BV(Joh 3:36 KJV)  He that believeth on the Son hath everlasting life: and he that believeth not the Son shall not see life; but the wrath of God abideth on him.\null
+\end{declareBVs*}
+
+\fetchverse{Gen 1:1}
+
+% This will expand until the first undefined verse is encountered. It may not be the last verse in the chapter.
+% As a result, you may not know that all the verses are there unless you check; for example suppose verse 35 and 36
+% are commented out, then Joh 3:27- brings back verses 27-34.
+\verb~\fetchverses*[abbr=none]{Joh 3:27-}~\\
+\fetchverses*[abbr=none]{Joh 3:27-}
+
+The package calculates the last verse number and writes it to the AUX file, which is then input the next time
+you compile the file; as a result, even though you specified `\texttt{Joh 3:27-}', what is typeset is what you see above.
+
+I don't know how this new feature will effect all the many other capabilities of the package, as you and other use the package,
+those problems will come to light. If something breaks down, simply specify the ending value of the range and things should work
+as before. Report any problems with a simple example file. dps
+
+
+
+\end{document}
diff --git a/texmf-dist/doc/latex/fetchbibpes/examples/makebibpes.tex b/texmf-dist/doc/latex/fetchbibpes/examples/makebibpes.tex
new file mode 100644
index 00000000..865327b6
--- /dev/null
+++ b/texmf-dist/doc/latex/fetchbibpes/examples/makebibpes.tex
@@ -0,0 +1,15 @@
+\documentclass{article}
+\usepackage[%!build,
+% infolder=<folder>,
+% outfolder=<folder>,
+ txtfilein=<basename_txt>
+% deffileout=<basename_def>
+]{bibpes}
+
+\begin{document}
+
+\reportOnBibPes
+
+\readbackDefFile
+
+\end{document}