improved syntax highlighting, tidied up the code

1 files changed, 333 insertions, 322 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 7eb5ce7..8c1d7f6 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -204,20 +204,19 @@
 \usepackage{booktabs}
 \usepackage[defaultlines=3,all]{nowidow}
 \usepackage{needspace}
+\usepackage{addlines}
 \usepackage{relsize}
 \usepackage{tikz}
 \usepackage[breakable, skins, xparse, minted]{tcolorbox}
-\tcbset{colback=white, boxrule=.15mm, colframe=red!50!white, left=6mm,
+\tcbset{colback=white, boxrule=.15mm, colframe=red!50!white,
   breakable}
-\DeclareTCBListing{arabluacode}{s O{}}{listing engine=minted, minted
-  language=latex, minted options={linenos, fontsize=\relsize{-0.5}},
-  IfBooleanTF={#1}{listing side text}{#2}}
-\DeclareTCBListing{arabluaverbatim}{}{listing engine=minted, minted
-  language=latex, minted options={linenos, fontsize=\relsize{-0.5}},
-  listing only}
-\DeclareTotalTCBox{\arabluaverb}{v}{verbatim}{#1}
-\DeclareTotalTCBox{\arabluabox}{m}{left=0mm, right=0mm, top=0mm,
-  bottom=0mm}{#1}
+\newtcbox{\arabluabox}{boxrule=.3mm, left=0mm, right=0mm, top=0mm,
+  bottom=0mm}
+\newtcblisting{example}{minted options={linenos, numbersep=0mm,
+    fontsize=\smaller}}
+\newtcblisting{code}{minted options={linenos, numbersep=0mm,
+    fontsize=\smaller}, listing
+  only}
 \newcommand{\package}[1]{\textsf{#1}\index{#1=#1 (package)}}
 \usepackage[contents]{colordoc}
 \usepackage{csquotes}
@@ -506,7 +505,7 @@
 % \section{The basics of \package{arabluatex}}
 % \subsection{Activating \package{arabluatex}}
 % \package{arabluatex} is loaded the usual way:\\
-% \arabluaverb{\usepackage{arabluatex}}\\
+% \tcboxverb{\usepackage{arabluatex}}\\
 % The only requirement of \package{arabluatex} is {\LuaLaTeX};
 % it will complain if the document is compiled with another
 % engine. That aside, \package{arabluatex} does not load packages such
@@ -525,7 +524,7 @@
 % By default, if no Arabic font is selected, \package{arabluatex} will
 % issue a warning message and attempt to load the Amiri
 % font\footnote{\textcite{pkg:amiri}.} like so:---\\
-% \arabluaverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic]}
+% \tcboxverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic]}
 % \begin{quoting}
 %   \textsc{Rem.} By default Amiri places the \arb[trans]{kasraT} in
 %   combination with the \arb[trans]{ta^sdId} below the consonant,
@@ -537,7 +536,7 @@
 %   selecting the |ss05| feature of the Amiri font, like
 %   so:---\footnote{See the documentation of \package{amiri},
 %   \textcite[6]{pkg:amiri}.}\\
-%   \arabluaverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic,RawFeature={+ss05}]}
+%   \tcboxverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic,RawFeature={+ss05}]}
 %
 %   Other Arabic fonts may behave differently.
 % \end{quoting}
@@ -548,7 +547,7 @@
 % first four of which are mutually exclusive and may be overriden at
 % any point of the document (see below \vref{sec:local-options}):
 % 
-% \DescribeOption{voc}\hfill\arabluaverb{Default}\\ In this mode,
+% \DescribeOption{voc}\hfill\tcboxverb{Default}\\ In this mode,
 % which is the one selected by default, every short vowel written
 % generates its corresponding diacritical mark: \arb[trans]{.dammaT}
 % (\arb{Bu}), \arb[trans]{fat.haT} (\arb{Ba}) and \arb[trans]{kasraT}
@@ -584,7 +583,7 @@
 %
 % \label{ref:export-global-opt}
 % \DescribeOption{export} |export|$=$|true|\verb+|+|false|
-% \hfill\arabluaverb{Default: false}\\ \label{export-mode}
+% \hfill\tcboxverb{Default: false}\\ \label{export-mode}
 % \NEWfeature{v.1.13} This option acts as a named argument and does
 % not need a value as it defaults to |true| if it is used. It enables
 % \package{arabluatex} to produce a duplicate of the original |.tex|
@@ -623,11 +622,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
-Please note that only few Arabic fonts provide such contrivances. In
-case this feature is not supported by some Arabic font, it is
-advisable to use \cs{SetArbEasy}.
-\end{arabluacode}
+\begin{tcblisting}{text only}
+  Please note that only few Arabic fonts provide such contrivances. In
+  case this feature is not supported by some Arabic font, it is
+  advisable to use \cs{SetArbEasy}.
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -690,9 +689,10 @@ advisable to use \cs{SetArbEasy}.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
-Please note that this document is typeset with \cs{SetArbDflt} throughout.
-\end{arabluacode}
+\begin{tcblisting}{text only}
+  Please note that this document is typeset with \cs{SetArbDflt}
+  throughout.
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -704,15 +704,15 @@ Please note that this document is typeset with \cs{SetArbDflt} throughout.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-From \textcite[i. 1 A]{Wright}:--- Arabic, like Hebrew and
-Syriac, is written and read from right to left. The letters
-of the alphabet (\arb{.hurUf-u 'l-hijA'-i}, \arb{.hurUf-u
-'l-tahajjI}, \arb{al-.hurUf-u 'l-hijA'iyyaT-u}, or
-\arb{.hurUf-u 'l-mu`jam-i}) are twenty-eight in number and
-are all consonants, though three of them are also used as
-vowels (see §~3).
-\end{arabluacode}
+\begin{example}
+  From \textcite[i. 1 A]{Wright}:--- Arabic, like Hebrew and
+  Syriac, is written and read from right to left. The letters
+  of the alphabet (\arb{.hurUf-u 'l-hijA'-i}, \arb{.hurUf-u
+    'l-tahajjI}, \arb{al-.hurUf-u 'l-hijA'iyyaT-u}, or
+  \arb{.hurUf-u 'l-mu`jam-i}) are twenty-eight in number and
+  are all consonants, though three of them are also used as
+  vowels (see §~3).
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -731,7 +731,7 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{enumerate}[label=\Roman*., start=16]
   \item \indent\arb{fawA`ilu}*.
     \begin{enumerate}[label=\arabic*.]
@@ -739,7 +739,7 @@ vowels (see §~3).
         signet-ring}, ...
     \end{enumerate}
   \end{enumerate}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -750,11 +750,11 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   \begin{arab}
   [...]
   \end{arab}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -763,7 +763,7 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
  \begin{arab}
    'at_A .sadIquN 'il_A ju.hA ya.tlubu min-hu .himAra-hu
    li-yarkaba-hu fI safraTiN qa.sIraTiN fa-qAla la-hu:
@@ -778,7 +778,7 @@ vowels (see §~3).
    'amru-ka yA .sadIqI 'a-tu.saddiqu 'l-.himAr-a
    wa-tuka_d_diba-nI?}
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -810,7 +810,7 @@ vowels (see §~3).
 % \Cref{tab:arabtex-consonants} gives the Arab\TeX\ equivalents for
 % all of the Arabic consonants.
 %
-% \needspace{7\baselineskip}
+% \addlines[2]
 % \newcommand{\dmg}[1]{%
 %   \SetTranslitConvention{dmg}%
 %   \arb[trans]{#1}}
@@ -844,7 +844,6 @@ vowels (see §~3).
 % \vref{ref:hamza}.} & \dmg{'u 'a 'i} &
 % \loc{|'u, |'a, |'i} & \brill{|'u, |'a, |'i} & |'u| or |'a| or |'i| \\
 % \arb[novoc]{b} & \dmg{b} & \loc{b} & \brill{b} & |b| \\
-% \pagebreak[1]
 % \arb[novoc]{t} & \dmg{t} & \loc{t} & \brill{t} & |t| \\
 % \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & \brill{_t} & |_t| \\
 % \arb[novoc]{j} & \dmg{j} & \loc{j} & \brill{j} & |^g| or |j| \\
@@ -959,7 +958,6 @@ vowels (see §~3).
 % \Cref{tab:arabtex-long-vowels} gives the Arab\TeX\ equivalents for
 % the Arabic long vowels.
 %
-% \needspace{8\baselineskip}
 % \begin{longtable}{lllll}
 % \bottomrule
 % \caption*{\Cref*{tab:arabtex-long-vowels}: Standard Arab\TeX\ (long
@@ -1057,11 +1055,11 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   However, it may be wise to always write the vowels, leaving to the
   various modes provided by \package{arabluatex} to take care of
   showing or not showing the vowels.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -1363,11 +1361,11 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   Hence one should keep to this distinction and encode |'a'kulu|
   \arb[voc]{'a'kulu} \arb[trans]{'a'kulu} and |'AkiluN|
   \arb[voc]{'AkiluN} \arb[trans]{'AkiluN} respectively.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -1415,7 +1413,7 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   Unlike \package{arabtex} and \package{arabxetex},
   \package{arabluatex} \emph{never requires the solar letter to be
     written twice}, as it automatically generates the euphonic
@@ -1423,7 +1421,7 @@ vowels (see §~3).
   article be written in the assimilated form or not, e.g. |al-^sams-u|
   \arb[voc]{al-^sams-u} \arb[trans]{al-^sams-u}, or |a^s-^sams-u|
   \arb[voc]{a^s-^sams-u} \arb[trans]{a^s-^sams-u}.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -1452,14 +1450,14 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   \textsc{Rem.} This particular feature must be put into operation by
   the \cs{SetArbDflt*} command explicitly. See above
   \vref{sec:classic-modern-typesetting} for further details. Other
   kinds of assimilations, including the various cases of
   \arb[trans]{'id.gAm}, will be included in \package{arabluatex}
   gradually.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -1493,11 +1491,11 @@ vowels (see §~3).
 % encoded, like so:---
 % \begin{enumerate}
 % \item Definite article at the beginning of a sentence is encoded\\
-%   \arabluaverb{al-}, or \arabluaverb{a<solar letter>-}\\ if one
+%   \tcboxverb{al-}, or \tcboxverb{a<solar letter>-}\\ if one
 %   wishes to mark the assimilation---which is in no way required, as
 %   \package{arabulatex} will detect all cases of assimilation.
-% \item Definite article inside sentences is encoded\\ \arabluaverb{'l-}
-%   or \arabluaverb{'<solar letter>-}.
+% \item Definite article inside sentences is encoded\\ \tcboxverb{'l-}
+%   or \tcboxverb{'<solar letter>-}.
 % \item In all remaining cases of elision, the \arb[trans]{'alifu
 % 'l-wa.sli} is expressed by the vowel that accompanies the omitted
 % \arb[trans]{hamzaT}: \meta{u, a, i}.
@@ -1941,13 +1939,13 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   This is wrong:
   \begin{arab}[fullvoc]
-    fa-lammA ra'aW\LRfootnote{A footnote which interferes with the
-      contextual analysis.} 'l-na^gma...
+    fa-lammA ra'aW\LRfootnote{A footnote which interferes with
+      the contextual analysis.} 'l-na^gma...
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -1965,10 +1963,10 @@ vowels (see §~3).
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
-In any case, \emph{no space must be left} after or before the Arabic
-word that \cs{arbnull} is applied to.
-\end{arabluacode}
+\begin{tcblisting}{text only}
+  In any case, \emph{no space must be left} after or before the Arabic
+  word that \cs{arbnull} is applied to.
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi%
@@ -1978,13 +1976,14 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{arab}[fullvoc]
-    fa-lammA ra'aW\arbnull{'l-na^gma}\LRfootnote{A footnote which
-      interferes with the contextual analysis.} 'l-na^gma...
+    fa-lammA ra'aW\arbnull{'l-na^gma}\LRfootnote{A footnote
+      which interferes with the contextual analysis.}
+    'l-na^gma...
 
-    qAla\LRfootnote{A footnote which interferes with the contextual
-      analysis.} \arbnull{qAla}uhrub fa-lan tuqtala.
+    qAla\LRfootnote{A footnote which interferes with the
+      contextual analysis.} \arbnull{qAla}uhrub fa-lan tuqtala.
 
     \uc{z}ayduN\arbnull{ibnu}\LRfootnote{A footnote which
       interferes with the contextual analysis.}
@@ -1998,7 +1997,7 @@ word that \cs{arbnull} is applied to.
     \arbnull{zayduN}ibn-u \uc{`a}mriNU.\LRfootnote{See
       \vref{fn:zayd-is-son}.}
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2080,10 +2079,10 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   The \arb[trans]{'ab^gad} number for the current page (\thepage) is
   \abjad{\thepage}.
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2093,8 +2092,8 @@ word that \cs{arbnull} is applied to.
 %
 % \subsection{Additional characters}
 % \label{sec:additional-characters}
-% In the manuscripts, the unpointed letters, \arb[trans]{al-.hurUfu
-% 'l-muhmalaTu}, are sometimes further distinguished from the pointed
+% In the manuscripts, the unpointed letters, \arb[trans]{al-.hurUf-u
+% 'l-muhmalaT-u}, are sometimes further distinguished from the pointed
 % by various contrivances, as explained in \textcite[i. 4
 % B--C]{Wright}. One may find these letters written in a smaller size
 % below the line, or with a dot or another mark below. As representing
@@ -2125,9 +2124,9 @@ word that \cs{arbnull} is applied to.
 % \arb[novoc]{.f} & \dmg{.f} & \loc{.f} & \brill{.f} & |.f| \\
 % \arb[novoc]{.q} & \dmg{.q} & \loc{.q} & \brill{.q} & |.q| \\
 % \arb[novoc]{.k} & \dmg{.k} & \loc{.k} & \brill{.k} & |.k| \\
+% \pagebreak[1]
 % \arb[novoc]{.n} & \dmg{.n} & \loc{.n} & \brill{.n} & |.n| \\
 % \arb[novoc]{((} & \dmg{((} & \loc{((} & \brill{((} & |((| \\
-% \pagebreak[1]
 % \arb[novoc]{))} & \dmg{))} & \loc{))} & \brill{))} & |))| \\
 % \end{longtable}
 % 
@@ -2178,11 +2177,11 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   \begin{arabverse}[key1=value1, key2=value2, ...]
     <verses>
   \end{arabverse}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -2194,7 +2193,7 @@ word that \cs{arbnull} is applied to.
 % time as already seen \vref{sec:options}.
 %
 % \DescribeOption{width} |width|$=$\meta{length}
-% \hfill\arabluaverb{Default: 0.3\linewidth}\\ The default width of
+% \hfill\tcboxverb{Default: 0.3\linewidth}\\ The default width of
 % each hemistich that the verse consists of. It may be expressed in
 % any accepted unit of measurement, such as |4cm| or |2in|. However,
 % one must keep in mind that the total length of the two hemistichs
@@ -2203,18 +2202,18 @@ word that \cs{arbnull} is applied to.
 % hemistichs distributed on subsequent lines.
 %
 % \DescribeOption{gutter} |gutter|$=$\meta{width}
-% \hfill\arabluaverb{Default: 0.15 x (hemistich width)}\\ The gutter
+% \hfill\tcboxverb{Default: 0.15 x (hemistich width)}\\ The gutter
 % consists of the blank space that is between the two hemistichs. By
 % default, it is commensurate with the width of the hemistich, but it
 % may be expressed in any accepted unit of measurement as well.
 %
 % \DescribeOption{metre} |metre|$=$\meta{name}
-% \hfill\arabluaverb{Default: none}\\ If the name of the metre is
+% \hfill\tcboxverb{Default: none}\\ If the name of the metre is
 % expressed, it is printed after the lines and set flush left in
 % |voc|, |fullvoc| and |novoc| modes or flush right in |trans| mode.
 %
 % \DescribeOption{delim} |delim|$=$|true|\verb+|+|false|
-% \hfill\arabluaverb{Default: false}\\ This named argument does not
+% \hfill\tcboxverb{Default: false}\\ This named argument does not
 % need a value as it defaults to |true| if it is used. If so, a
 % delimiter is printed between each of the hemistichs. By default, it
 % is set to the \enquote*{star} character \enquote*{*}. The
@@ -2223,20 +2222,20 @@ word that \cs{arbnull} is applied to.
 % default setting.
 %
 % \DescribeOption{utf} |utf|$=$|true|\verb+|+|false|
-% \hfill\arabluaverb{Default: false}\\ As the preceding one, this
+% \hfill\tcboxverb{Default: false}\\ As the preceding one, this
 % named argument does not need a value as it defaults to |true| if it
 % is used. If so, Unicode Arabic input is expected in the |arabverse|
 % environment instead of \textsc{ascii} Arab\TeX\ or Buckwalter input
 % schemes. See \vref{sec:unicode-input} for more details.
 %
 % \DescribeOption{color} |color|$=$\meta{color name}
-% \hfill\arabluaverb{Default: not set}\\
+% \hfill\tcboxverb{Default: not set}\\
 % \NEWfeature{v1.13} The color in which lines of poetry are to be
 % rendered.
 %
 % \label{ref:poetry-export}
 % \DescribeOption{export} |export|$=$|true|\verb+|+|false|
-% \hfill\arabluaverb{Default: false}\\
+% \hfill\tcboxverb{Default: false}\\
 % \NEWfeature{v.1.13} This named argument does not need a value as it
 % defaults to |true| if it is used. If |export| is set as a global
 % option as well (see above \vpageref{export-mode}), all the lines
@@ -2256,10 +2255,10 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   \cs{bayt}\marg{\arb[trans]{.sadr}}\oarg{\arb[trans]{tadwIr}}%
   \marg{\arb[trans]{`ajuz}}|\\|
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -2282,12 +2281,12 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\begin{arabverse}[mode=fullvoc, width=.3\linewidth]
-  \bayt{lA 'ar_A man `ahidtu fI-hA fa-'abkI 'l---}[--]{---yawma
-    dalhaN wa-mA yaruddu 'l-bukA'u}\\
-\end{arabverse}
-\end{arabluacode}
+\begin{example}
+  \begin{arabverse}[mode=fullvoc, width=.3\linewidth]
+    \bayt{lA 'ar_A man `ahidtu fI-hA fa-'abkI 'l---}[--]{---yawma
+      dalhaN wa-mA yaruddu 'l-bukA'u}\\
+  \end{arabverse}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2304,12 +2303,12 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\begin{arabverse}[mode=trans, width=.4\linewidth]
-  \bayt{lA 'ar_A man `ahidtu fI-hA fa-'abkI 'l---}[--]{---yawma
-    dalhaN wa-mA yaruddu 'l-bukA'u}\\
-\end{arabverse}
-\end{arabluacode}
+\begin{example}
+  \begin{arabverse}[mode=trans, width=.4\linewidth]
+    \bayt{lA 'ar_A man `ahidtu fI-hA fa-'abkI 'l---}[--]{---yawma
+      dalhaN wa-mA yaruddu 'l-bukA'u}\\
+  \end{arabverse}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2320,14 +2319,15 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\begin{arabverse}[mode=fullvoc, width=.25\linewidth, gutter=1cm]
-  \bayt{.gayra 'annI qad 'asta`Inu `al_A 'l-ha--}[--mmi ]{'i_dA
-  _haffa bi-'l-_tawiyyi 'l-na^gA'u}\\
-  \bayt{bi-zaf--UfiN ka-'anna-hA hiq--laTuN}[ 'ummu ]{ri'AliN
-  dawwiyyaTuN saqfA'u}\\
-\end{arabverse}
-\end{arabluacode}
+\begin{example}
+  \begin{arabverse}[mode=fullvoc, width=.25\linewidth,
+    gutter=1cm]
+    \bayt{.gayra 'annI qad 'asta`Inu `al_A 'l-ha--}[--mmi ]{'i_dA
+      _haffa bi-'l-_tawiyyi 'l-na^gA'u}\\
+    \bayt{bi-zaf--UfiN ka-'anna-hA hiq--laTuN}[ 'ummu ]{ri'AliN
+      dawwiyyaTuN saqfA'u}\\
+  \end{arabverse}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2394,30 +2394,30 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\begin{arab}[fullvoc]
-  qAla imru'u 'l-\uc{q}aysi fI mu`allaqati-hi:
-\end{arab}
+\begin{code}
+  \begin{arab}[fullvoc]
+    qAla imru'u 'l-\uc{q}aysi fI mu`allaqati-hi:
+  \end{arab}
 
-\begin{arabverse}[mode=fullvoc, metre={(al-.darbu 'l-_tAnI mina
-  'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}]
-  \SetArbDflt*
-  \begin{linenumbers*}
-    \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
-      'l-liw_A bayna \uc{'l-d}a_hUli fa-\uc{.h}awmali}\\
-    \bayt{fa-\uc{t}U.di.ha fa-'l-\uc{m}iqrATi lam ya`fu
-      rasmu-hA}{limA nasa^gat-hA min ^ganUbiN wa-^sam'ali}\\
-    \bayt{tar_A ba`ara 'l-'ar'Ami fI `ara.sAti-hA}{wa-qI`Ani-hA
-      ka-'anna-hu .habbu fulfuli}\\
-    \bayt{ka-'annI .gadATa 'l-bayni yawma ta.hammalUA}{lad_A
-      samurAti 'l-.hayyi nAqifu .han.zali}\\
-    \bayt{wuqUfaN bi-hA .sa.hbI `alayya ma.tiyya-hum}{yaqUlUna lA
-      tahlik 'asaN_A wa-ta^gammali}\\
-    \bayt{wa-'inna ^sifA'I `abraTuN muharAqaTuN}{fa-hal `inda rasmiN
-      dAsiriN min mu`awwali}\\
-  \end{linenumbers*}
-\end{arabverse}
-\end{arabluaverbatim}
+  \begin{arabverse}[mode=fullvoc, metre={(al-.darbu 'l-_tAnI mina
+      'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}]
+    \SetArbDflt*
+    \begin{linenumbers*}
+      \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+        'l-liw_A bayna \uc{'l-d}a_hUli fa-\uc{.h}awmali}\\
+      \bayt{fa-\uc{t}U.di.ha fa-'l-\uc{m}iqrATi lam ya`fu
+        rasmu-hA}{limA nasa^gat-hA min ^ganUbiN wa-^sam'ali}\\
+      \bayt{tar_A ba`ara 'l-'ar'Ami fI `ara.sAti-hA}{wa-qI`Ani-hA
+        ka-'anna-hu .habbu fulfuli}\\
+      \bayt{ka-'annI .gadATa 'l-bayni yawma ta.hammalUA}{lad_A
+        samurAti 'l-.hayyi nAqifu .han.zali}\\
+      \bayt{wuqUfaN bi-hA .sa.hbI `alayya ma.tiyya-hum}{yaqUlUna
+        lA tahlik 'asaN_A wa-ta^gammali}\\
+      \bayt{wa-'inna ^sifA'I `abraTuN muharAqaTuN}{fa-hal `inda
+        rasmiN dAsiriN min mu`awwali}\\
+    \end{linenumbers*}
+  \end{arabverse}
+\end{code}
 % \iffalse
 %</example>
 % \fi%
@@ -2508,12 +2508,12 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{arab}
     \abraces{wa-qAla} 'inna 'abI kAna mina 'l-muqAtilaTi
     wa-kAna--<--t> 'ummI min `u.zamA'i buyUti 'l-zamAzimaTi.
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -2563,12 +2563,12 @@ word that \cs{arbnull} is applied to.
 %
 % As regards the right-to-left codepoint, it may be either typed in
 % Unicode or selected as Unicode codepoint. To that end, the \LaTeX\
-% command \arabluaverb{\symbol{"XYZT}} or its plain \TeX\ variant
-% \arabluaverb{\char"XYZT\relax} may be used, where |XYZT| are
+% command \tcboxverb{\symbol{"XYZT}} or its plain \TeX\ variant
+% \tcboxverb{\char"XYZT\relax} may be used, where |XYZT| are
 % uppercase hex digits (|0| to |9| or |A| to |F|).
 %
 % It is also possible to use the so-called `|^^^^| notation' like so:
-% \arabluaverb{^^^^xyzt}, where |xyzt| are lowercase hex digits (|0|
+% \tcboxverb{^^^^xyzt}, where |xyzt| are lowercase hex digits (|0|
 % to |9| or |a| to |f|).
 %
 % As regards the third argument (left-to-right rendition), it may be
@@ -2578,11 +2578,11 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   It must be noted that \cs{newarbmark} expects Arab\TeX\ input scheme
   inside \cs{arb}|[trans]{}| to the exclusion of \textsf{buckwalter}
   input scheme.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi%
@@ -2593,7 +2593,7 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \SetArbDflt*
   \newarbmark{sly}{\arbcolor[red]{^^^^06d6}}{}
   \newarbmark{jim}{\arbcolor[red]{^^^^06da}}{}
@@ -2614,7 +2614,7 @@ word that \cs{arbnull} is applied to.
     'an takrahUA ^say'aN wa-ya^g`ala 'l-l_ahu fI-hi _hayraN
     ka_tIraN ((19))
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -2640,7 +2640,7 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \SetArbDflt*
   \newarbmark{alifsp}{^^^^0627}{\arb[trans]{'alif} }
   \newarbmark{lamsp}{^^^^0644^^^^0653}{\arb[trans]{lAm} }
@@ -2655,8 +2655,8 @@ word that \cs{arbnull} is applied to.
     wa-yuqImUna 'l-.sal_aUTa wa-mimmA razaqn_a-hum
     yunfiqUna~\ayah{3}
   \end{arab}
-\end{arabluacode}
-\begin{arabluacode}[text only]
+\end{example}
+\begin{tcblisting}{text only}
   \SetArbDflt*
   \begin{arab}[trans]
     min ((sUraTi \uc{'l-b}aqaraTi)):
@@ -2668,7 +2668,7 @@ word that \cs{arbnull} is applied to.
     wa-yuqImUna 'l-.sal_aUTa wa-mimmA razaqn_a-hum
     yunfiqUna~\ayah{3}
   \end{arab}
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi
@@ -2707,7 +2707,7 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{arab}
     \arbcolor[red]{al-bAbu 'l-_hAmisu} fI .tabaqAti 'l-'a.tibbA'i
     'lla_dIna kAnUA mun_du zamAni \uc{^gAlInUsa} wa-qarIbaN
@@ -2722,7 +2722,7 @@ word that \cs{arbnull} is applied to.
     kalAmaN kulliyyaN fI 'a_hbAri \uc{^gAlInUsa} wa-mA kAna
     `alay-hi...
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -2891,11 +2891,11 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \newarbmark{Y}{^^^^0649}{}
   \arb{hud\arbcolor[red]{aN\arbnull{_A}}\arbmark{Y}}
   \arb[trans]{hud\arbcolor[red]{aN\arbnull{_A}}\arbmark{Y}}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2928,12 +2928,12 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \newarbmark{alifmaddahred}{^^^^0627\arbcolor[red]{^^^^0653}}%
   {\arb[trans]{\arbcolor[red]{'a'\arbnull{k}}}}
   \arb{\arbmark{alifmaddahred}kulu}
   \arb[trans]{\arbmark{alifmaddahred}kulu}.
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2954,11 +2954,11 @@ word that \cs{arbnull} is applied to.
 %\iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\newarbmark{lamshaddah}{^^^^0651}{l}
-\arb[fullvoc]{al-mu`al"\arbcolor[red]{\arbmark{lamshaddah}}.imUna}
-\arb[trans]{al-mu`al"\arbcolor[red]{\arbmark{lamshaddah}}.imUna}.
-\end{arabluacode}
+\begin{example}
+  \newarbmark{lamshaddah}{^^^^0651}{l}
+  \arb[fullvoc]{al-mu`al"\arbcolor[red]{\arbmark{lamshaddah}}.imUna}
+  \arb[trans]{al-mu`al"\arbcolor[red]{\arbmark{lamshaddah}}.imUna}.
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -2981,13 +2981,13 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \newarbmark{lnn}{^^^^0644^^^^0646^^^^0651}{n-n}
   \arb[fullvoc]{fI\arbnull{al-}
     \arbcolor[red]{\arbnull{al-}a}\arbmark{lnn}Asi}
   \arb[trans]{fI\arbnull{al-}
     \arbcolor[red]{\arbnull{al-}a}\arbmark{lnn}Asi}.
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi%
@@ -3055,10 +3055,10 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\usepackage{arabluatex}
-\SetTranslitConvention{loc}
-\end{arabluaverbatim}
+\begin{code}
+  \usepackage{arabluatex}
+  \SetTranslitConvention{loc}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3080,10 +3080,10 @@ word that \cs{arbnull} is applied to.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\newfontfamily\translitfont{Gentium Plus}[Ligatures=TeX]
-\SetTranslitFont{\translitfont}
-\end{arabluaverbatim}
+\begin{code}
+  \newfontfamily\translitfont{Gentium Plus}[Ligatures=TeX]
+  \SetTranslitFont{\translitfont}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3160,14 +3160,14 @@ word that \cs{arbnull} is applied to.
 %\iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-From \textcite[i. 23 C]{Wright}:--- If the name following
-\arb[fullvoc]{ibnuN} be that of the mother or the grandfather, the
-\arb[fullvoc]{"a} is retained; as \arb[fullvoc]{`Is_A ibnu maryama},
+\begin{example}
+  From \textcite[i. 23 C]{Wright}:--- If the name following
+  \arb[fullvoc]{ibnuN} be that of the mother or the grandfather, the
+  \arb[fullvoc]{"a} is retained; as \arb[fullvoc]{`Is_A ibnu maryama},
   \enquote{Jesus the son of Mary}; \arb[fullvoc]{`ammAru ibnu
     man.sUriN}, \enquote{\prname{`ammAr} the (grand)son of
     \prname{man.sUr}}.
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3180,17 +3180,17 @@ From \textcite[i. 23 C]{Wright}:--- If the name following
 %\iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\begin{nameauth}
-  \< Hunayn & \prname{'abU zayd} & \prname{.hunayn}, \prname{{i}bn
-    'is.h_aq al-`ibAdiyy} & > %
-  \< Razi & \prname{'abU bakr mu.hammad ibn zakariyyA'} &
-  \prname{al-rAziyy} & > %
-\end{nameauth}
+\begin{example}
+  \begin{nameauth}
+    \< Hunayn & \prname{'abU zayd} & \prname{.hunayn}, \prname{{i}bn
+      'is.h_aq al-`ibAdiyy} & > %
+    \< Razi & \prname{'abU bakr mu.hammad ibn zakariyyA'} &
+    \prname{al-rAziyy} & > %
+  \end{nameauth}
 
-On first occurrence, proper names are printed as \Hunayn, \Razi.
-Then as \Hunayn, \Razi.
-\end{arabluacode}
+  On first occurrence, proper names are printed as \Hunayn, \Razi.
+  Then as \Hunayn, \Razi.
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3234,12 +3234,12 @@ Then as \Hunayn, \Razi.
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\SetArbUp{\textsubscript{#1}}
-Arabic |dmg| transliteration for \arb{ra'aytu ^gAmi`aN
-muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
-^gAmi`aN muhaddamaTaN mi'_danatu-hu.}
-\end{arabluacode}
+\begin{example}
+  \SetArbUp{\textsubscript{#1}}
+  Arabic |dmg| transliteration for \arb{ra'aytu ^gAmi`aN
+    muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
+    ^gAmi`aN muhaddamaTaN mi'_danatu-hu.}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3409,10 +3409,10 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\usepackage{arabluatex}
-\SetInputScheme{buckwalter}
-\end{arabluaverbatim}
+\begin{code}
+  \usepackage{arabluatex}
+  \SetInputScheme{buckwalter}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3436,7 +3436,8 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % are currently used by \package{arabluatex}. The additional
 % characters that are defined in \vref{tab:additional-arabic-codings}
 % are also available.
-% 
+%
+% \enlargethispage{\baselineskip}
 % \begin{longtable}{llllll}
 % \bottomrule
 % \caption*{\Cref*{tab:buckwalter-scheme}: Buckwalter scheme}
@@ -3456,6 +3457,7 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \endhead \footnotetext{See \vref{sec:transliteration}.}
 % \label{tab:buckwalter-scheme}
 % \arb[novoc]{a} & \dmg{a} & \loc{a} & \brill{a} & |A| & |A| \\
+% \pagebreak[1]
 % \arb[novoc]{b} & \dmg{b} & \loc{b} & \brill{b} & |b| & |b| \\
 % \arb[novoc]{t} & \dmg{t} & \loc{t} & \brill{t} & |t| & |t| \\
 % \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & \brill{_t} & |v| & |v| \\
@@ -3483,7 +3485,6 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| & |h| \\
 % \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| & |w| \\
 % \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y| & |y| \\
-% \pagebreak
 % \arb[novoc]{Y} & \dmg{Y} & \loc{Y} & \brill{Y} & |Y| & |Y| \\
 % \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |p| & |p| \\
 % \midrule
@@ -3566,11 +3567,11 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   \begin{txarab}
     <Unicode Arabic text>
   \end{txarab}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3608,16 +3609,16 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\renewcommand{\footnoterule}%
-   {\hfill\noindent\rule[1mm]{.4\textwidth}{.15mm}}
-\begin{arab}
-'inna 'abI kAna mina 'l-muqAtilaT-i\footnote{al-muqAtilaT-i:
-al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
-'l-zamAzimaT-i\footnote{al-zamAzimaT-u: .tA'ifaT-u mina
-'l-furs-i.}.
-\end{arab}
-\end{arabluacode}
+\begin{example}
+  \renewcommand{\footnoterule}%
+  {\hfill\noindent\rule[1mm]{.4\textwidth}{.15mm}}
+  \begin{arab}
+    'inna 'abI kAna mina 'l-muqAtilaT-i\footnote{al-muqAtilaT-i:
+      al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
+    'l-zamAzimaT-i\footnote{al-zamAzimaT-u: .tA'ifaT-u mina
+      'l-furs-i.}.
+  \end{arab}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3650,7 +3651,7 @@ al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{arab}[fullvoc]
     \uc{z}ayd-uN\arbnull{ibnu}\LRfootnote{%
       \enquote{\arb[trans]{\uc{z}ayd} is the son of
@@ -3658,7 +3659,7 @@ al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
       apposition to the first, but forms part of the
       predicate\ldots} \arbnull{zayduN}ibn-u \uc{`a}mr-iNU
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3669,7 +3670,7 @@ al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
 % number 18, one may get 81. \package{arabluatex} is not responsible
 % for that, but should it happen, it may be necessary to redefine in
 % the preamble the \LaTeX\ macro \cs{thefootnote} like so:---\\
-% \arabluaverb{\renewcommand*{\thefootnote}{\textsuperscript{\LR{\arabic{footnote}}}}}
+% \tcboxverb{\renewcommand*{\thefootnote}{\textsuperscript{\LR{\arabic{footnote}}}}}
 % \DescribeMacro{\FixArbFtnmk} Another solution is to put in the
 % preamble, below the line that loads \package{arabluatex}, the
 % \cs{FixArbFtnmk} command. However, for more control over the layout
@@ -3694,14 +3695,14 @@ al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\setRL
-\section*{\arb{barzawayhi li-buzurjumihra bn-i 'l-buxtikAni}}
-\setLR
-\begin{arab}
-qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
-\end{arab}
-\end{arabluacode}
+\begin{example}
+  \setRL
+  \section*{\arb{barzawayhi li-buzurjumihra bn-i 'l-buxtikAni}}
+  \setLR
+  \begin{arab}
+    qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
+  \end{arab}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3716,7 +3717,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % in its argument which \package{arabluatex} will process as such
 % before passing it on to the command itself for any further
 % processing. As a result of this feature, such a command as:\\
-% \arabluaverb{\newcommand{\fvarabic}[1]{\arb[fullvoc]{#1}}}\\
+% \tcboxverb{\newcommand{\fvarabic}[1]{\arb[fullvoc]{#1}}}\\
 % will work as expected, but will always output non-vocalized Arabic
 % if it is inserted in a |novoc| Arabic environment because its
 % argument will have been processed by the |novoc| rules before the
@@ -3729,7 +3730,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % argument a comma-separated list of commands each of which must be
 % stripped of its leading character
 % |\|, like so:---\\
-% \arabluaverb{\MkArbBreak{onecmd, anothercmd, yetanothercmd, ...}}
+% \tcboxverb{\MkArbBreak{onecmd, anothercmd, yetanothercmd, ...}}
 % 
 % For example, here follows a way to define a new command |\fvred| to
 % distinguish words with a different color and always print them in
@@ -3737,15 +3738,15 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \MkArbBreak{fvred}
   \newcommand{\fvred}[1]{\arbcolor[red]{\arb[fullvoc]{#1}}}
-\begin{arab}[voc]
-  _tumma "intalaqa _dU 'l-qarn-ayni 'il_A 'ummaT-iN 'u_hr_A fI
-  \fvred{((ma.tli`-i 'l-^sams-i))} wa-lA binA'-a la-hum
-  yu'amminu-hum mina 'l-^sams-i.
-\end{arab}
-\end{arabluacode}
+  \begin{arab}[voc]
+    _tumma "intalaqa _dU 'l-qarn-ayni 'il_A 'ummaT-iN 'u_hr_A fI
+    \fvred{((ma.tli`-i 'l-^sams-i))} wa-lA binA'-a la-hum
+    yu'amminu-hum mina 'l-^sams-i.
+  \end{arab}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3783,35 +3784,34 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}[text only]
+\begin{tcblisting}{text only}
   It must be noted that \cs{MkArbBreak*} must be used with the utmost
   care and \emph{should never be used} if \cs{MkArbBreak} gives
   satisfaction. At any rate, the latter must always be tested before
   the former.
-\end{arabluacode}
+\end{tcblisting}
 % \iffalse
 %</example>
 % \fi%
-% 
 %
 % \subsection{Environments}
 % \label{sec:environments}
 % \changes{v1.5}{2016/11/14}{Environments may be nested inside the
 %   \texttt{arab} environment}
 % \NEWfeature{v1.5} Environments such as
-% \arabluaverb{\begin{quote}... \end{quote}} may be nested inside the
+% \tcboxverb{\begin{quote} ... \end{quote}} may be nested inside the
 % |arab| environment. Up to one optional argument may be passed to
 % each nested environment, like so:---
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\begin{arab}
-  \begin{<environment>}[<options>]
-    <Arabic text>
-  \end{<environment>}
-\end{arab}
-\end{arabluaverbatim}
+\begin{code}
+  \begin{arab}
+    \begin{<environment>}[<options>]
+      <Arabic text>
+    \end{<environment>}
+  \end{arab}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3820,7 +3820,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \setquotestyle{arabic}
   \begin{arab}[fullvoc]
     kAna \uc{'abU} \uc{'l-hu_dayli} 'ahd_A 'il_A \uc{muwaysiN}
@@ -3841,7 +3841,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
     fa-lA yazAlu fI h_a_dA wa-'l-'A_haru ya.d.haku .da.hkaN
     na`rifu-hu na.hnu wa-lA ya`rifu-hu \uc{'abU} \uc{'l-hu_dayli}.
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3859,18 +3859,18 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
- \setRL\paragraph{\arb[novoc]{rumUzi 'l-kitAbi}}\setLR
- \begin{arab}[novoc]
-  \begin{description}
-   \item[b] max.tU.tu 'l-maktabaTi 'l-'ahliyyaTi bi-\uc{bArIs} 2860
-    `arabiyyuN.
-   \item[s] max.tU.tu 'l-maktabaTi 'l-'ahliyyaTi bi-\uc{bArIs} 2859
-    `arabiyyuN.
-   \item[m] max.tU.tu majlisi \arb[novoc]{^sUrAY malY} .tahrAna 521.
-  \end{description}
- \end{arab}
-\end{arabluacode}
+\begin{example}
+  \setRL\paragraph{\arb[novoc]{rumUzi 'l-kitAbi}}\setLR
+  \begin{arab}[novoc]
+    \begin{description}
+    \item[b] max.tU.tu 'l-maktabaTi 'l-'ahliyyaTi bi-\uc{bArIs} 2860
+      `arabiyyuN.
+    \item[s] max.tU.tu 'l-maktabaTi 'l-'ahliyyaTi bi-\uc{bArIs} 2859
+      `arabiyyuN.
+    \item[m] max.tU.tu majlisi \arb[novoc]{^sUrAY malY} .tahrAna 521.
+    \end{description}
+  \end{arab}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3880,7 +3880,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \setRL\centerline{\arb{\textbf{al-qAnUnu fI 'l-.tibbi}}}\setLR
   \begin{arab}
     \begin{itemize}
@@ -3895,7 +3895,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
       \end{itemize}
     \end{itemize}
   \end{arab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3908,14 +3908,14 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   % preamble:---
   \usepackage{enumitem}
   \newlist{enumabjad}{enumerate}{10}
   \setlist[enumabjad]{nosep, label={\abjad{\arabic*}}}
   \usepackage{multicol}
-\end{arabluaverbatim}
-\begin{arabluacode}
+\end{code}
+\begin{example}
   From \textcite[i. 29 B--C]{Wright}:--- The derived forms of the
   triliteral verb are usually reckoned fifteen in number, but the
   learner may pass over the last four, because (with the exception
@@ -3942,7 +3942,7 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
       \end{enumabjad}
     \end{arab}
   \end{multicols}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -3957,10 +3957,10 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\usepackage[french]{babel}
-\frenchsetup{StandardLists=true}
-\end{arabluaverbatim}
+\begin{code}
+  \usepackage[french]{babel}
+  \frenchsetup{StandardLists=true}
+\end{code}
 % \iffalse
 %</example>
 % \fi%
@@ -3978,12 +3978,12 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\usepackage{csquotes}
-\DeclareQuoteStyle{arabic}
-{\textquotedblright}{\textquotedblleft}
-{\textquoteright}{\textquoteleft}
-\end{arabluaverbatim}
+\begin{code}
+  \usepackage{csquotes}
+  \DeclareQuoteStyle{arabic}
+  {\textquotedblright}{\textquotedblleft}
+  {\textquoteright}{\textquoteleft}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -3991,14 +3991,14 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\setquotestyle{arabic}
-\begin{arab}
-  fa-qAla la-hu ju.hA: \enquote{.garIb-uN 'amru-ka yA .sadIqI
-    'a-tu.saddiqu 'l-.himAr-a wa-tuka_d_diba-nI?}
-\end{arab}
-\setquotestyle{english}
-\end{arabluacode}
+\begin{example}
+  \setquotestyle{arabic}
+  \begin{arab}
+    fa-qAla la-hu ju.hA: \enquote{.garIb-uN 'amru-ka yA .sadIqI
+      'a-tu.saddiqu 'l-.himAr-a wa-tuka_d_diba-nI?}
+  \end{arab}
+  \setquotestyle{english}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -4022,24 +4022,24 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
-\begin{arab}
-  \textcolor{red}{\uc{m}uha_d_dabu \uc{'l-d}Ini \uc{`a}bdu
-    \uc{'l-r}a.hImi bnu \uc{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
-  'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \uc{m}uha_d_dabu
-  \uc{'l-d}Ini \uc{'a}bU \uc{m}u.hammadiN \uc{`a}bdu
-  \uc{'l-r}a.hImi bnu \uc{`a}liyyi bni \uc{.h}AmidiN wa-yu`rafu
-  bi-\uc{'l-d}a_hwari.
-\end{arab}
-\begin{arab}[trans]
-  \textcolor{red}{\uc{m}uha_d_dabu \uc{'l-d}Ini \uc{`a}bdu
-    \uc{'l-r}a.hImi bnu \uc{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
-  'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \uc{m}uha_d_dabu
-  \uc{'l-d}Ini \uc{'a}bU \uc{m}u.hammadiN \uc{`a}bdu
-  \uc{'l-r}a.hImi bnu \uc{`a}liyyi bni \uc{.h}AmidiN wa-yu`rafu
-  bi-\uc{'l-d}a_hwari.
-\end{arab}
-\end{arabluacode}
+\begin{example}
+  \begin{arab}
+    \textcolor{red}{\uc{m}uha_d_dabu \uc{'l-d}Ini \uc{`a}bdu
+      \uc{'l-r}a.hImi bnu \uc{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
+    'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \uc{m}uha_d_dabu
+    \uc{'l-d}Ini \uc{'a}bU \uc{m}u.hammadiN \uc{`a}bdu
+    \uc{'l-r}a.hImi bnu \uc{`a}liyyi bni \uc{.h}AmidiN wa-yu`rafu
+    bi-\uc{'l-d}a_hwari.
+  \end{arab}
+  \begin{arab}[trans]
+    \textcolor{red}{\uc{m}uha_d_dabu \uc{'l-d}Ini \uc{`a}bdu
+      \uc{'l-r}a.hImi bnu \uc{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
+    'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \uc{m}uha_d_dabu
+    \uc{'l-d}Ini \uc{'a}bU \uc{m}u.hammadiN \uc{`a}bdu
+    \uc{'l-r}a.hImi bnu \uc{`a}liyyi bni \uc{.h}AmidiN wa-yu`rafu
+    bi-\uc{'l-d}a_hwari.
+  \end{arab}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -4055,16 +4055,16 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
-\beginnumbering
-\pstart
-\begin{arab}
-wa-ya.sIru ta.hta 'l-jild-i
-\edtext{\arb{.sadId-uN}}{\Afootnote{M: \arb{.sadId-aN} E1}}
-\end{arab}
-\pend
-\endnumbering
-\end{arabluaverbatim}
+\begin{code}
+  \beginnumbering
+  \pstart
+  \begin{arab}
+    wa-ya.sIru ta.hta 'l-jild-i
+    \edtext{\arb{.sadId-uN}}{\Afootnote{M: \arb{.sadId-aN} E1}}
+  \end{arab}
+  \pend
+  \endnumbering
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4089,10 +4089,10 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   \usepackage{arabluatex}
   \usepackage[nopar]{quran}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4102,11 +4102,11 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluacode}
+\begin{example}
   \begin{txarab}
     \quransurah[1]
   \end{txarab}
-\end{arabluacode}
+\end{example}
 % \iffalse
 %</example>
 % \fi
@@ -4131,12 +4131,12 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   % preamble
   \usepackage[export]{arabluatex}
   % or:
   \usepackage[export=true]{arabluatex}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4156,11 +4156,11 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   \begin{arabexport}
     <Running paragraphs of either Arabic or non-Arabic text>
   \end{arabexport}
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4218,11 +4218,11 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   Package arabluatex Warning: There are still 'arabtex' strings
   to be converted. Please open <jobname><suffix>.tex and compile
   it one more time.
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4240,9 +4240,9 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   pandoc file_out.tex -s -o file_out.odt
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4254,7 +4254,7 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \iffalse
 %<*example>
 % \fi
-\begin{arabluaverbatim}
+\begin{code}
   % preamble:
   \usepackage{arabluatex} % note that 'export' has been removed
   \renewcommand{\txarb}[1]{#1}
@@ -4264,7 +4264,7 @@ wa-ya.sIru ta.hta 'l-jild-i
   % be safe to say:
   \renewcommand{\prname}[2]{#2}
   % &c
-\end{arabluaverbatim}
+\end{code}
 % \iffalse
 %</example>
 % \fi
@@ -4347,7 +4347,6 @@ wa-ya.sIru ta.hta 'l-jild-i
 \RequirePackage{fontspec}
 \RequirePackage{luacode}
 \RequirePackage{xparse}
-\RequirePackage{environ}
 \RequirePackage{adjustbox}
 \RequirePackage{xstring}
 \PassOptionsToPackage{normalem}{ulem}
@@ -4372,13 +4371,15 @@ wa-ya.sIru ta.hta 'l-jild-i
 % \begin{macro}{\setRL}
 %   This neutralizes what may be defined by other packages:
 %    \begin{macrocode}
-\AtBeginDocument{\def\setRL{\booltrue{al@rlmode}\pardir TRT\textdir TRT}}
+\AtBeginDocument{\def\setRL{\booltrue{al@rlmode}\pardir TRT%
+    \textdir TRT}}
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\setLR}
 %   The same applies to \cs{setLR}:
 %    \begin{macrocode}
-\AtBeginDocument{\def\setLR{\boolfalse{al@rlmode}\pardir TLT\textdir TLT}}
+\AtBeginDocument{\def\setLR{\boolfalse{al@rlmode}\pardir TLT%
+    \textdir TLT}}
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\LR} This command typesets its argument from left to
@@ -4437,12 +4438,16 @@ wa-ya.sIru ta.hta 'l-jild-i
 \AtBeginDocument{\ifdef{\aemph}%
   {\RenewDocumentCommand{\aemph}{s m}{%
       \IfBooleanTF{#1}{%
-        \luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2}, "over"))}}
-      {\luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2}, "dflt"))}}}}
+        \luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2},
+          "over"))}}
+      {\luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2},
+          "dflt"))}}}}
   {\NewDocumentCommand{\aemph}{s m}{%
       \IfBooleanTF{#1}{%
-        \luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2}, "over"))}}
-      {\luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2}, "dflt"))}}}}}
+        \luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2},
+          "over"))}}
+      {\luadirect{tex.sprint(arabluatex.aemph(\luastringN{#2},
+          "dflt"))}}}}}
 %    \end{macrocode}
 % \end{macro}
 % \end{macro}
@@ -4531,7 +4536,8 @@ wa-ya.sIru ta.hta 'l-jild-i
 %   the transliteration convention, which is |dmg| by default:
 %    \begin{macrocode}
 \def\al@trans@convention{dmg}
-\NewDocumentCommand{\SetTranslitConvention}{m}{\def\al@trans@convention{#1}}
+\NewDocumentCommand{\SetTranslitConvention}{m}{%
+  \def\al@trans@convention{#1}}
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\arbup}
@@ -4556,7 +4562,8 @@ wa-ya.sIru ta.hta 'l-jild-i
 \NewDocumentCommand{\arbup}{m}{\al@arbup{#1}}
 \NewDocumentCommand{\ArbUpDflt}{}{\let\al@arbup=\al@arbup@dflt}
 \NewDocumentCommand{\NoArbUp}{}{\RenewDocumentCommand{\al@arbup}{m}{##1}}
-\NewDocumentCommand{\SetArbUp}{m}{\RenewDocumentCommand{\al@arbup}{m}{#1}}
+\NewDocumentCommand{\SetArbUp}{m}{%
+  \RenewDocumentCommand{\al@arbup}{m}{#1}}
 %    \end{macrocode}
 % \end{macro}
 % \end{macro}
@@ -4853,12 +4860,14 @@ wa-ya.sIru ta.hta 'l-jild-i
   \ifdefined\abjad%
   \RenewDocumentCommand{\abjad}{m}%
   {\ifbool{al@rlmode}%
-    {\oline*{\luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
+    {\oline*{%
+        \luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
     {\luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
   \else%
   \NewDocumentCommand{\abjad}{m}%
   {\ifbool{al@rlmode}%
-    {\oline*{\luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
+    {\oline*{%
+        \luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
     {\luadirect{tex.sprint(arabluatex.abjadify(\luastring{#1}))}}}
   \fi}
 %    \end{macrocode}
@@ -4925,9 +4934,11 @@ wa-ya.sIru ta.hta 'l-jild-i
 %    \begin{macrocode}
 \NewDocumentCommand{\FixArbFtnmk}{}{%
   \@ifpackageloaded{scrextend}%
-  {\AtBeginDocument{\deffootnote{2em}{1.6em}{\LR{\thefootnotemark}.\enskip}}}%
+  {\AtBeginDocument{%
+      \deffootnote{2em}{1.6em}{\LR{\thefootnotemark}.\enskip}}}%
   {\RequirePackage{scrextend}
-  \AtBeginDocument{\deffootnote{2em}{1.6em}{\LR{\thefootnotemark}.\enskip}}}}
+    \AtBeginDocument{%
+      \deffootnote{2em}{1.6em}{\LR{\thefootnotemark}.\enskip}}}}
 %    \end{macrocode}
 % \end{macro}
 %