added distinction between dmg|dmg+ and \SetArbNumbers (either Indian [default] or Arabic). updated copyright dates.

1 files changed, 140 insertions, 81 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 22c5099..c281001 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 % ArabLuaTeX -- Processing ArabTeX notation under LuaLaTeX
-% Copyright (C) 2016--2020  Robert Alessi
+% Copyright (C) 2016--2022  Robert Alessi
 %
 % Please send error reports and suggestions for improvements to Robert
 % Alessi <alessi@robertalessi.net>
@@ -27,7 +27,7 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{arabluatex}
 %<*package>
-    [2020/03/23 v1.20 ArabTeX for LuaLaTeX]
+    [2022/06/15 v1.21-dev ArabTeX for LuaLaTeX]
 %</package>
 %
 %<*driver>
@@ -37,7 +37,7 @@
 % This file is part of the `arabluatex' package
 %
 % ArabLuaTeX -- Processing ArabTeX notation under LuaLaTeX
-% Copyright (C) 2016--2020  Robert Alessi
+% Copyright (C) 2016--2022  Robert Alessi
 %
 % Please send error reports and suggestions for improvements to Robert
 % Alessi <alessi@robertalessi.net>
@@ -158,16 +158,27 @@
 }
 \end{filecontents}
 \usepackage[letterpaper,margin=1.25in,left=50mm,nohead]{geometry}
-\usepackage{fontspec}
-\usepackage[default]{fontsetup}
+\usepackage[no-math]{fontspec}
 \defaultfontfeatures{Renderer=Harfbuzz}
 \usepackage[english]{babel}
-\usepackage{dox}
-\doxitem{Option}{option}{options}
+%^^A dox does not work with the latest latex-dev:
+\ifdefined\SpecialMacroIndex
+  \NewDocElement{Option}{option}
+\else
+  \usepackage{dox}
+  \doxitem{Option}{option}{options}
+\fi
 \usepackage{microtype}
 \babelfont{rm}{Old Standard}
+\babelfont{sf}{NewComputerModernSans10}
+\babelfont{tt}{NewComputerModernMono10}
+\usepackage[Old Standard]{mathfont}
+\usepackage{manfnt}
+\usepackage{lettrine}
+\newcommand\danger{\lettrine[loversize=-.5]{\textdbend}{\hskip6pt}}
 \usepackage{metalogox}
-\usepackage{arabluatex}[2020/03/23]
+\usepackage{arabluatex}[2022/06/15]
+\SetTranslitConvention{dmg+}
 \SetArbUp{\textsuperscript{\thinspace#1}} % Old Standard needs this
 \usepackage[nopar]{quran}
 \usepackage[noindex]{nameauth}
@@ -175,7 +186,9 @@
 \usepackage{latexcolors}
 \PassOptionsToPackage{bookmarks=true}{hyperref}
 \usepackage[numbered]{hypdoc}
+\newcommand{\phts}{\phantomsection}
 \usepackage{uri}
+\usepackage[obeyspaces]{xurl}
 \usepackage[loadlang=en]{metastr}
 \hypersetup{
   colorlinks,
@@ -205,6 +218,7 @@
 \metaset[sep]{draft}{ -- }
 \metasetlang{en-US}
 \metaset{title}{arabluatex}
+\metaset[print]{title}{\textsf{arabluatex}}
 \metaset{date}{\filedate}
 \metaset{draft}{\fileversion}
 \metaset{subject}{ArabTeX}
@@ -219,7 +233,7 @@
 \metaset{partof}{The arabluatex Package}
 \metaset[print]{partof}{The \textsf{arabluatex} Package}
 \metaset{copyrightowner}{\metapick[#1]{author}}
-\metaset{copyrightdate}{2016--2020}
+\metaset{copyrightdate}{2016--2022}
 \metaset{licensemessage}{Permission is granted to copy, distribute
   and/or modify this document under the terms of the GNU Free
   Documentation License, Version 1.3 or any later version published by
@@ -267,7 +281,7 @@
   bottom=0mm}
 \newtcblisting{example}{minted options={linenos, numbersep=0mm,
     fontsize=\smaller}}
-\newtcblisting{code}{minted options={linenos, numbersep=0mm,
+\newtcblisting{alcode}{minted options={linenos, numbersep=0mm,
     fontsize=\smaller}, listing only}
 \newcommand{\package}[1]{\textsf{#1}\index{#1=#1 (package)}}
 \usepackage[contents]{colordoc}
@@ -581,7 +595,7 @@
 % font\footnote{\textcite{pkg:amiri}.} like so:---\\
 % \tcboxverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic]}
 % \begin{quoting}
-%   \textsc{Rem.} By default Amiri places the \arb[trans]{kasraT} in
+%   \textsc{Rem.~1} By default Amiri places the \arb[trans]{kasraT} in
 %   combination with the \arb[trans]{ta^sdId} below the consonant,
 %   like so: \arb{BBi}\,. That is correct, as at least in the oldest
 %   manuscripts {\renewfontfamily\arabicfont{Amiri}[Script=Arabic,
@@ -594,6 +608,10 @@
 %   \tcboxverb{\newfontfamily\arabicfont{Amiri}[Script=Arabic,RawFeature={+ss05}]}
 %
 %   Other Arabic fonts may behave differently.
+%
+%   \noindent\textsc{Rem.~2} \cs{newfontfamily} can be used to have
+%   either Indian of Arabic numbers printed. See
+%   \vpageref{ref:arabic-numbers} for more information.
 % \end{quoting}
 %
 % \subsection{Options}
@@ -628,8 +646,8 @@
 % standards. At present, three standards are supported (see below
 % \vref{sec:transliteration} for more details):
 % \begin{description}
-% \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which is
-%   selected by default;
+% \item[dmg/dmg+] \emph{Deutsche Morgenländische Gesellschaft} |dmg|
+%   is selected by default;
 % \item[loc] \emph{Library of Congress};
 % \item[arabica] \emph{Arabica}.
 % \end{description}
@@ -796,11 +814,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{arab}
   [...]
   \end{arab}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -857,14 +875,14 @@
 % all of the Arabic consonants.
 %
 % \newcommand{\dmg}[1]{%
-%   \SetTranslitConvention{dmg}%
+%   \SetTranslitConvention{dmg+}%
 %   \arb[trans]{#1}}
 % \newcommand{\loc}[1]{%
 %   \SetTranslitConvention{loc}%
-%   \arb[trans]{#1}\SetTranslitConvention{dmg}}
+%   \arb[trans]{#1}\SetTranslitConvention{dmg+}}
 % \newcommand{\brill}[1]{%
 %   \SetTranslitConvention{arabica}%
-%   \arb[trans]{#1}\SetTranslitConvention{dmg}}
+%   \arb[trans]{#1}\SetTranslitConvention{dmg+}}
 % \begin{longtable}{lllll}
 % \bottomrule
 % \caption[]{Standard Arab\TeX\ (consonants)}
@@ -873,19 +891,19 @@
 % \captionlistentry{Standard Arab\TeX\ (consonants)}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:arabtex-consonants}
 % \arb[voc]{'i 'a 'u}\footnote{See below, \emph{Rem{.} a.} For
 % \arb[trans]{'alif} as a consonant, see \textcite[i. 16
 % D]{Wright}. The \arb[trans]{hamzaT} itself is encoded \texttt{<'>}
 % and may be followed by either \meta{u, a} or \meta{i}. See below
-% \vref{ref:hamza}.} & \dmg{'u, 'a, 'i} &
+% \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| \\
 % \arb[novoc]{t} & \dmg{t} & \loc{t} & \brill{t} & |t| \\
@@ -957,7 +975,8 @@
 % now available}
 % \newfeature[v1.8.5]\Vref{tab:arabtex-additional-characters} gives
 % the Arab\TeX\ equivalents for some additional Persian characters.
-% 
+%
+% \enlargethispage{2\baselineskip}
 % \begin{longtable}{lllll}
 % \bottomrule
 % \caption[]{Standard Arab\TeX\ (additional characters)}
@@ -966,13 +985,13 @@
 % \captionlistentry{Standard Arab\TeX\ (additional characters)}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica}\footnotemark
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica}\footnotemark
 %        & \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead
 % \addtocounter{footnote}{-1}
 % \footnotetext{See below \vref{sec:transliteration}.}
@@ -1011,12 +1030,12 @@
 % \captionlistentry{Standard Arab\TeX\ (long vowels)}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:arabtex-long-vowels}
 % \arb[novoc]{A} & \dmg{A} & \loc{A} & \brill{A} & \verb|A| \\
@@ -1072,12 +1091,12 @@
 % \captionlistentry{Standard Arab\TeX\ (short vowels)}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:arabtex-short-vowels}
 % \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \brill{Ba} & \verb|a| \\
@@ -1911,11 +1930,11 @@
 % \captionlistentry{\enquote{Quoted} \arb[trans]{hamzaT}}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+% & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+% & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead
 % \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:quoted-hamza}
@@ -2070,6 +2089,34 @@
 %   |sanaT-i| |1024| \arb[voc]{fI sanaT-i 1024}
 % \end{quote}
 %
+% \needspace{2\baselineskip}
+% \DescribeMacro{\SetArbNumbers}\newfeature[v1.21]
+% \phts\label{ref:arabic-numbers}
+% \cs{SetArbNumbers}\verb+{Indian|Arabic}+ %
+% \hfill\tcboxverb{Default: Indian}\\
+% As described above, \package{arabluatex} prints Indian numbers by
+% default. \cs{SetArbNumbers}|{Arabic}| can be used at any point of
+% the document to have Arabic numbers printed.  Furthermore,
+% \cs{SetArbNumbers}|{Arabic}| gives control over the way numbers are
+% to be printed by means of the |anum| font feature, like so:---
+% 
+% \iffalse
+%<*example>
+% \fi
+\begin{alcode}
+  \usepackage{arabluatex}
+  \SetArbNumbers{Arabic}
+  % use '+anum' for Arabic numbers or '-anum' for Indian numbers:
+  \newfontfamily\arabicfont{Amiri}[Script=Arabic, RawFeature={+anum}]
+\end{alcode}
+% \iffalse
+%</example>
+% \fi
+%
+% \danger \cs{SetArbNumbers} must be used \emph{outside} Arabic
+% environments. Once used, this commands operates on subsequent Arabic
+% environments.
+%
 % \subsubsection{The \emph{abjad}}
 % \label{sec:abjad}
 % The numbers may also be expressed with letters from right to left
@@ -2153,12 +2200,12 @@
 % \captionlistentry{Additional Arabic codings}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:additional-arabic-codings}
 % \arb[novoc]{.b} & \dmg{.b} & \loc{.b} & \brill{.b} & |.b| \\
@@ -2234,11 +2281,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{arabverse}[key1=value1, key2=value2, ...]
     <verses>
   \end{arabverse}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -2465,7 +2512,7 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{arab}[fullvoc]
     qAla imru'u 'l-\uc{q}aysi fI mu`allaqati-hi:
   \end{arab}
@@ -2474,7 +2521,7 @@
       'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}]
     \SetArbDflt*
     \begin{linenumbers*}
-      \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+      \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-siq.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}\\
@@ -2488,7 +2535,7 @@
         rasmiN dArisiN min mu`awwali}\\
     \end{linenumbers*}
   \end{arabverse}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi%
@@ -2503,7 +2550,7 @@
 %  'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}, width=.25\linewidth]
 %  \SetArbDflt*
 %   \begin{linenumbers*}
-%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-siq.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}\\
@@ -2528,7 +2575,7 @@
 %  'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}, width=.4\linewidth]
 %  \SetArbDflt*
 %   \begin{linenumbers*}
-%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-siq.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}\\
@@ -2557,7 +2604,7 @@
 %  'l-`arU.di 'l-'_Ul_A mina 'l-.tawIli)}, width=.3\linewidth]
 %  \SetArbDflt*
 %   \begin{linenumbers*}
-%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-siq.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 mi--n ^gan----UbiN wa-^sam'ali}\\
@@ -2585,7 +2632,7 @@
 %  \SetArbDflt*
 %  \scriptsize
 %   \begin{linenumbers*}
-%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-saq.ti
+%     \bayt{qifA nabki min _dikr_A .habIbiN wa-manzili}{bi-siq.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}\\
@@ -2945,12 +2992,12 @@
 % \captionlistentry{Arab\TeX\ diacritics for \cs{arbcolor}}
 % Diacritic & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
 % Diacritic & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
+%        & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:arbcolor-diacritics}
 % \arb{B.a} & \dmg{.a} & \loc{.a} & \brill{.a} & \verb|.a| \\
@@ -3196,6 +3243,9 @@
 % adopted by the International Convention of Orientalist Scholars in
 % Rome in 1935.\footnote{See \textcite{dmg}.} |dmg| transliteration
 % convention is selected by default;
+% \item[dmg+] This is the same as above, with the difference that the
+%   hamza is always printed, even in words preceded by the definite
+%   article, as in \arb[trans]{al-'asadu}.
 % \item[loc] \emph{Library of Congress}: this standard is part of a
 %   large set of standards for romanization of non-roman scripts
 %   adopted by the American Library Association and the Library of
@@ -3218,16 +3268,16 @@
 % transliteration mode, which is set to |dmg| by default, may be
 % changed at any point of the document by the
 % \cs{SetTranslitConvention}\marg{mode} command , where \meta{mode}
-% may be either |dmg|, |loc| or |arabica|. This command is also
+% may be either |dmg|, |dmg+|, |loc| or |arabica|. This command is also
 % accepted in the preamble should one wish to set the transliteration
 % mode globally, e.g.:---%
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \usepackage{arabluatex}
   \SetTranslitConvention{loc}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -3249,10 +3299,10 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \newfontfamily\translitfont{Gentium Plus}[Ligatures=TeX]
   \SetTranslitFont{\translitfont}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -3510,9 +3560,9 @@
 % \arb[trans]{\uc{ju.hA}} and his donkey (\arb[voc]{\uc{ju.hA
 % wa-.himAru-hu}}). See the code \vpageref{ref:juha-code}:---
 %
-% \SetTranslitConvention{dmg}
+% \SetTranslitConvention{dmg+}
 % \begin{arab}[trans]
-%   \LR{\textbf{\emph{\enquote*{dmg}} standard:}} 'at_A .sadIquN 'il_A
+%   \LR{\textbf{\emph{\enquote*{dmg+}} standard:}} 'at_A .sadIquN 'il_A
 %   \uc{ju.hA} ya.tlubu min-hu .himAra-hu li-yarkaba-hu fI safraTiN
 %   qa.sIraTiN fa-qAla la-hu: \enquote{sawfa 'u`Idu-hu 'ilay-ka fI
 %   'l-masA'-i wa-'adfa`u la-ka 'ujraTaN.} fa-qAla \uc{ju.hA}:
@@ -3539,7 +3589,7 @@
 %   \enquote{.garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu 'l-.himAr-a
 %   wa-tuka_d_diba-nI?}
 % \end{arab}
-% \SetTranslitConvention{dmg}
+% \SetTranslitConvention{dmg+}
 %
 % \SetTranslitConvention{arabica}
 % \begin{arab}[trans]
@@ -3555,7 +3605,7 @@
 %   \uc{ju.hA}: \enquote{.garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu
 %   'l-.himAr-a wa-tuka_d_diba-nI?}
 % \end{arab}
-% \SetTranslitConvention{dmg}
+% \SetTranslitConvention{dmg+}
 %
 % \section{Buckwalter input scheme}
 % \label{sec:buckwalter-scheme}
@@ -3579,10 +3629,10 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \usepackage{arabluatex}
   \SetInputScheme{buckwalter}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -3615,13 +3665,13 @@
 % \captionlistentry{Buckwalter input scheme}
 % Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & \multicolumn{2}{l}{Buckwalter notation} \\
-% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
+% & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & |base/xml| &
 % |safe| \\ \midrule
 % \endfirsthead
 % \toprule
 % Letter & \multicolumn{3}{l}{Transliteration}
 % & \multicolumn{2}{l}{Buckwalter notation} \\
-% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
+% & \texttt{dmg+} & \texttt{loc} & \texttt{arabica} & |base/xml| &
 % |safe| \\ \midrule
 % \endhead \footnotetext{See \vref{sec:transliteration}.}
 % \label{tab:buckwalter-scheme}
@@ -3735,11 +3785,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{txarab}
     <Unicode Arabic text>
   \end{txarab}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -3838,6 +3888,7 @@
 % for that, but should it happen, it may be necessary to redefine in
 % the preamble the \LaTeX\ macro \cs{thefootnote} like so:---\\
 % \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
@@ -3972,13 +4023,13 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{arab}
     \begin{<environment>}[<options>]
       <Arabic text>
     \end{<environment>}
   \end{arab}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4075,13 +4126,13 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   % preamble:---
   \usepackage{enumitem}
   \newlist{enumabjad}{enumerate}{10}
   \setlist[enumabjad]{nosep, label={\abjad{\arabic*}}}
   \usepackage{multicol}
-\end{code}
+\end{alcode}
 \begin{example}
   From \textcite[i. 29 B--C]{Wright}:--- The derived forms of the
   triliteral verb are usually reckoned fifteen in number, but the
@@ -4124,10 +4175,10 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \usepackage[french]{babel}
   \frenchsetup{StandardLists=true}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi%
@@ -4145,12 +4196,12 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \usepackage{csquotes}
   \DeclareQuoteStyle{arabic}
   {\textquotedblright}{\textquotedblleft}
   {\textquoteright}{\textquoteleft}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4222,7 +4273,7 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \beginnumbering
   \pstart
   \begin{arab}
@@ -4231,7 +4282,7 @@
   \end{arab}
   \pend
   \endnumbering
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4256,10 +4307,10 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \usepackage{arabluatex}
   \usepackage[nopar]{quran}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4298,12 +4349,12 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   % preamble
   \usepackage[export]{arabluatex}
   % or:
   \usepackage[export=true]{arabluatex}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4323,11 +4374,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   \begin{arabexport}
     <Running paragraphs of either Arabic or non-Arabic text>
   \end{arabexport}
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4385,11 +4436,11 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   Package arabluatex Warning: There are still 'arabtex' strings
   to be converted. Please open <jobname><suffix>.tex and compile
   it one more time.
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4407,9 +4458,9 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   pandoc file_out.tex -s -o file_out.odt
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -4421,7 +4472,7 @@
 % \iffalse
 %<*example>
 % \fi
-\begin{code}
+\begin{alcode}
   % preamble:
   \usepackage{arabluatex} % note that 'export' has been removed
   \renewcommand{\txarb}[1]{#1}
@@ -4431,7 +4482,7 @@
   % be safe to say:
   \renewcommand{\prname}[2]{#2}
   % &c
-\end{code}
+\end{alcode}
 % \iffalse
 %</example>
 % \fi
@@ -5092,6 +5143,14 @@
   {\NewDocumentCommand{\LR}{m}{\bgroup\textdir TLT\rmfamily#1\egroup}}}
 %    \end{macrocode}
 % \end{macro}
+% \begin{macro}{\SetArbNumbers}
+% \changes{v1.21}{2022/06/15}{select Indian or Arabic numbers}
+%    \begin{macrocode}
+\NewDocumentCommand{\SetArbNumbers}{m}{%
+  \luadirect{arabluatex.setnums(\luastringN{#1})}%
+}
+%    \end{macrocode}
+% \end{macro}
 % \begin{macro}{\RL} This one typesets its argument from right to
 % left. Same remark as above regarding the need of redefinition.
 %    \begin{macrocode}
@@ -5248,7 +5307,7 @@
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\altrfont}
-%   \changes{v1.21}{2020/07/13}{new command \cs{altrfont} to store
+%   \changes{v1.21}{2022/06/15}{new command \cs{altrfont} to store
 %   font and shape information (trans mode)} Finally \cs{altrfont}
 %   is used internally by \package{arabluatex} to store family and
 %   shape information about the font to be used for transliterated