arabica: updated documentation

1 files changed, 174 insertions, 145 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 941387b..30e1af6 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -27,7 +27,7 @@
 %<package-info>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package-info>\ProvidesPackage{arabluatex}
 %<*package-info>
-    [2017/03/18 v1.7.3 An ArabTeX-like interface for LuaLaTeX]
+    [2017/03/30 v1.8 An ArabTeX-like interface for LuaLaTeX]
 %</package-info>
 %
 %<*driver>
@@ -145,7 +145,7 @@
 \defaultfontfeatures{RawFeature={+liga}}
 \setmainfont{Old Standard}[SmallCapsFont={Latin Modern Roman Caps},
   RawFeature={+mark;+ccmp;+ss05;+ss06}]
-\usepackage{arabluatex}[2017/03/18]
+\usepackage{arabluatex}[2017/03/30]
 \usepackage[nopar]{quran}
 \usepackage{varioref}
 \usepackage{hyperxmp}
@@ -511,12 +511,13 @@
 %
 % \DescribeOption{trans} \\ \label{ref:describe-trans}This mode
 % transliterates the Arab\TeX\ input into one of the accepted
-% standards. At present, two standards are supported (see below
+% standards. At present, three standards are supported (see below
 % \vref{sec:transliteration} for more details):
 % \begin{compactdesc}
 % \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which is
 %   selected by default;
-% \item[loc] \emph{Library of Congress}.
+% \item[loc] \emph{Library of Congress};
+% \item[arabica] \emph{Arabica}.
 % \end{compactdesc}
 % More standards will be included in future releases of
 % \package{arabluatex}.
@@ -730,51 +731,54 @@ vowels (see §~3).
 % \newcommand{\loc}[1]{%
 %   \SetTranslitConvention{loc}%
 %   \arb[trans]{#1}\SetTranslitConvention{dmg}}
-% \begin{longtable}{llll}
+% \newcommand{\brill}[1]{%
+%   \SetTranslitConvention{arabica}%
+%   \arb[trans]{#1}\SetTranslitConvention{dmg}}
+% \begin{longtable}{lllll}
 % \captionlistentry{Arab\TeX\ consonants}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:arabtex-consonants}
 % \arb[novoc]{a}\footnote{For \arb[trans]{'alif} as a consonant, see
 % \textcite[i. 16 D]{Wright}. The \arb[trans]{hamzaT} itself is
 % encoded \texttt{<'>}. See below \vref{ref:hamza}.} & \dmg{a} &
-% \loc{a} & \verb|a| \\
-% \arb[novoc]{b} & \dmg{b} & \loc{b} & |b| \\
-% \arb[novoc]{t} & \dmg{t} & \loc{t} & |t| \\
-% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & |_t| \\
-% \arb[novoc]{j} & \dmg{j} & \loc{j} & |^g| or |j| \\
-% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & |.h| \\
-% \arb[novoc]{x} & \dmg{x} & \loc{x} & |_h| or |x|\\
-% \arb[novoc]{d} & \dmg{d} & \loc{d} & |d| \\
-% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & |_d| \\
-% \arb[novoc]{r} & \dmg{r} & \loc{r} & |r| \\
-% \arb[novoc]{z} & \dmg{z} & \loc{z} & |z| \\
-% \arb[novoc]{s} & \dmg{s} & \loc{s} & |s| \\
-% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & |^s| \\
-% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & |.s| \\
-% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & |.d| \\
-% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & |.t| \\
-% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & |.z| \\
-% \arb[novoc]{`} & \dmg{`} & \loc{`} & |`| \\
-% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & |.g| \\
-% \arb[novoc]{f} & \dmg{f} & \loc{f} & |f| \\
-% \arb[novoc]{q} & \dmg{q} & \loc{q} & |q| \\
-% \arb[novoc]{k} & \dmg{k} & \loc{k} & |k| \\
-% \arb[novoc]{l} & \dmg{l} & \loc{l} & |l| \\
-% \arb[novoc]{m} & \dmg{m} & \loc{m} & |m| \\
-% \arb[novoc]{n} & \dmg{n} & \loc{n} & |n| \\
-% \arb[novoc]{h} & \dmg{h} & \loc{h} & |h| \\
-% \arb[novoc]{w} & \dmg{w} & \loc{w} & |w| \\
-% \arb[novoc]{y} & \dmg{y} & \loc{y} & |y| \\
-% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & |T| \\
+% \loc{a} & \brill{a} & \verb|a| \\
+% \arb[novoc]{b} & \dmg{b} & \loc{b} & \brill{b} & |b| \\
+% \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| \\
+% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & \brill{.h} & |.h| \\
+% \arb[novoc]{x} & \dmg{x} & \loc{x} & \brill{x} & |_h| or |x|\\
+% \arb[novoc]{d} & \dmg{d} & \loc{d} & \brill{d} & |d| \\
+% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & \brill{_d} & |_d| \\
+% \arb[novoc]{r} & \dmg{r} & \loc{r} & \brill{r} & |r| \\
+% \arb[novoc]{z} & \dmg{z} & \loc{z} & \brill{z} & |z| \\
+% \arb[novoc]{s} & \dmg{s} & \loc{s} & \brill{s} & |s| \\
+% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & \brill{^s} & |^s| \\
+% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & \brill{.s} & |.s| \\
+% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & \brill{.d} & |.d| \\
+% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & \brill{.t} & |.t| \\
+% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & \brill{.z} & |.z| \\
+% \arb[novoc]{`} & \dmg{`} & \loc{`} & \brill{`} & |`| \\
+% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & \brill{.g} & |.g| \\
+% \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| \\
+% \arb[novoc]{l} & \dmg{l} & \loc{l} & \brill{l} & |l| \\
+% \arb[novoc]{m} & \dmg{m} & \loc{m} & \brill{m} & |m| \\
+% \arb[novoc]{n} & \dmg{n} & \loc{n} & \brill{n} & |n| \\
+% \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| \\
+% \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| \\
+% \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y| \\
+% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |T| \\
 % \bottomrule
 % \caption*{\Cref*{tab:arabtex-consonants}: Standard Arab\TeX\ (consonants)}
 % \end{longtable}
@@ -784,27 +788,27 @@ vowels (see §~3).
 % \Cref{tab:arabtex-long-vowels} gives the Arab\TeX\ equivalents for
 % the Arabic long vowels.
 % 
-% \begin{longtable}{llll}
+% \begin{longtable}{lllll}
 % \captionlistentry{Arab\TeX\ long vowels}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \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} & \verb|A| \\
-% \arb[novoc]{U} & \dmg{U} & \loc{U} & \verb|U| \\
-% \arb[novoc]{I} & \dmg{I} & \loc{I} & \verb|I| \\
+% \arb[novoc]{A} & \dmg{A} & \loc{A} & \brill{A} & \verb|A| \\
+% \arb[novoc]{U} & \dmg{U} & \loc{U} & \brill{U} & \verb|U| \\
+% \arb[novoc]{I} & \dmg{I} & \loc{I} & \brill{I} & \verb|I| \\
 % \arb[novoc]{_A}\footnote{$=$ \arb[trans]{al-'alif-u 'l-maq.sUraT-u}.}
-%            & \dmg{_A} & \loc{_A} & \verb|_A| or \verb|Y| \\
-% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \verb|_a| \\
-% \arb[novoc]{B_u} & \dmg{B_u} & \loc{B_u} & \verb|_u| \\
-% \arb[novoc]{B_i} & \dmg{B_i} & \loc{B_i} & \verb|_i| \\
+%            & \dmg{_A} & \loc{_A} & \brill{_A} & \verb|_A| or \verb|Y| \\
+% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \brill{B_a} & \verb|_a| \\
+% \arb[novoc]{B_u} & \dmg{B_u} & \loc{B_u} & \brill{B_u} & \verb|_u| \\
+% \arb[novoc]{B_i} & \dmg{B_i} & \loc{B_i} & \brill{B_i} & \verb|_i| \\
 % \bottomrule
 % \caption*{\Cref*{tab:arabtex-long-vowels}: Standard Arab\TeX\ (long vowels)}
 % \end{longtable}
@@ -834,25 +838,25 @@ vowels (see §~3).
 % \Cref{tab:arabtex-short-vowels} gives the Arab\TeX\ equivalents for
 % the Arabic short vowels.
 % 
-% \begin{longtable}{llll}
+% \begin{longtable}{lllll}
 % \captionlistentry{Arab\TeX\ short vowels}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \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} & \verb|a| \\
-% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \verb|u| \\
-% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \verb|i| \\
-% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \verb|aN| \\
-% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \verb|uN| \\
-% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \verb|iN| \\
+% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \brill{Ba} & \verb|a| \\
+% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \brill{Bu} & \verb|u| \\
+% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \brill{Bi} & \verb|i| \\
+% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \brill{BaN} & \verb|aN| \\
+% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \brill{BuN} & \verb|uN| \\
+% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \brill{BiN} & \verb|iN| \\
 % \bottomrule
 % \caption*{\Cref*{tab:arabtex-short-vowels}: Standard Arab\TeX\ (short vowels)}
 % \end{longtable}
@@ -1630,26 +1634,26 @@ vowels (see §~3).
 % context. \Cref{tab:quoted-hamza} gives the equivalents for all the
 % possible carriers the \arb[trans]{hamzaT} may take.
 % 
-% \begin{longtable}{llll}
+% \begin{longtable}{lllll}
 % \captionlistentry{\enquote{Quoted} \arb[trans]{hamzaT}}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endhead \footnotetext{See below \vref{sec:transliteration}.}
 % \label{tab:quoted-hamza}
-% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \verb+|"'+ \\
-% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \verb|A"'| \\
-% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \verb|a"'| \\
-% \arb[novoc]{u"'} & \dmg{u"'} & \loc{u"'} & \verb|u"'| \\
-% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \verb|w"'| \\
-% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \verb|i"'| \\
-% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \verb|y"'| \\
+% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \brill{|"'} & \verb+|"'+ \\
+% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \brill{A"'} & \verb|A"'| \\
+% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \brill{a"'} & \verb|a"'| \\
+% \arb[novoc]{u"'} & \dmg{u"'} & \loc{u"'} & \brill{u"'} & \verb|u"'| \\
+% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \brill{w"'} & \verb|w"'| \\
+% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \brill{i"'} & \verb|i"'| \\
+% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \brill{y"'} & \verb|y"'| \\
 % \bottomrule
 % \caption*{\Cref*{tab:quoted-hamza}: \enquote{Quoted} \arb[trans]{hamzaT}}
 % \end{longtable}
@@ -1843,27 +1847,27 @@ word that \cs{arbnull} is applied to.
 % proposed and gradually included as \package{arabluatex} will mature.
 %
 % For the time being, the following is included:---
-% \begin{longtable}{llll}
+% \begin{longtable}{lllll}
 % \captionlistentry{Additional Arabic codings}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \midrule
+%        & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & Arab\TeX\ notation \\
-%        & \texttt{dmg} & \texttt{loc} & \\ \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} & |.b| \\
-% \arb[novoc]{^d} & \dmg{^d} & \loc{^d} & |^d| \\
-% \arb[novoc]{.f} & \dmg{.f} & \loc{.f} & |.f| \\
-% \arb[novoc]{.q} & \dmg{.q} & \loc{.q} & |.q| \\
-% \arb[novoc]{.k} & \dmg{.k} & \loc{.k} & |.k| \\
-% \arb[novoc]{.n} & \dmg{.n} & \loc{.n} & |.n| \\
-% \arb[novoc]{((} & \dmg{((} & \loc{((} & |((| \\
-% \arb[novoc]{))} & \dmg{))} & \loc{))} & |))| \\
+% \arb[novoc]{.b} & \dmg{.b} & \loc{.b} & \brill{.b} & |.b| \\
+% \arb[novoc]{^d} & \dmg{^d} & \loc{^d} & \brill{^d} & |^d| \\
+% \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| \\
+% \arb[novoc]{.n} & \dmg{.n} & \loc{.n} & \brill{.n} & |.n| \\
+% \arb[novoc]{((} & \dmg{((} & \loc{((} & \brill{((} & |((| \\
+% \arb[novoc]{))} & \dmg{))} & \loc{))} & \brill{))} & |))| \\
 % \bottomrule
 % \caption*{\Cref*{tab:additional-arabic-codings}: Additional Arabic
 % codings}
@@ -2228,8 +2232,8 @@ word that \cs{arbnull} is applied to.
 % the \enquote{transliteration mode} may be selected globally or locally.
 %
 % This mode transliterates the Arab\TeX\ input into one of the
-% accepted standards. As said above \vpageref{ref:describe-trans}, two
-% standards are supported at present:
+% accepted standards. As said above \vpageref{ref:describe-trans},
+% three standards are supported at present:
 % \begin{compactdesc}
 % \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which was
 % adopted by the International Convention of Orientalist Scholars in
@@ -2238,10 +2242,17 @@ word that \cs{arbnull} is applied to.
 % \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
-%   Congress.\footnote{See
+%   Congress;\footnote{See
 %   \url{http://www.loc.gov/catdir/cpso/roman.html} for the
 %   \href{http://www.loc.gov/catdir/cpso/romanization/arabic.pdf}{source
 %   document concerning Arabic language}.}
+% \item[arabica] \NEWfeature{v1.8}
+%   \changes{v1.8}{2017/03/30}{\texttt{arabica} is now supported as a
+%   standard of transliteration} \emph{Journal of Arabic and Islamic
+%   Studies}/\emph{Revue d'études arabes et islamiques}: this standard
+%   is most widely used by scholars in the field of Arabic
+%   studies.\footnote{See
+%   \url{http://www.brill.nl/files/brill.nl/specific/authors_instructions/ARAB.pdf}.}
 % \end{compactdesc}
 % More standards will be included in future releases of
 % \package{arabluatex}.
@@ -2250,9 +2261,9 @@ word that \cs{arbnull} is applied to.
 % 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| or |loc|. This command is also accepted in the
-% preamble should one wish to set the transliteration mode globally,
-% eg.:---%
+% may be either |dmg|, |loc| or |arabica|. This command is also
+% accepted in the preamble should one wish to set the transliteration
+% mode globally, eg.:---%
 % \iffalse
 %<*example>
 % \fi
@@ -2470,6 +2481,22 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % \end{arab}
 % \SetTranslitConvention{dmg}
 %
+% \SetTranslitConvention{arabica}
+% \begin{arab}[trans]
+%   \LR{\textbf{\emph{\enquote*{arabica}} standard}:} 'at_A .sadIquN
+%   'il_A \cap{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
+%   \cap{ju.hA}: \enquote{'anA 'AsifuN jiddaN 'annI lA 'asta.tI`u 'an
+%   'u.haqqiqa la-ka ra.gbata-ka fa-'l-.himAr-u laysa hunA 'l-yawm-a.}
+%   wa-qabla 'an yutimma \cap{ju.hA} kalAma-hu bada'a 'l-.himAr-u
+%   yanhaqu fI 'i.s.tabli-hi. fa-qAla la-hu .sadIqu-hu: \enquote{'innI
+%   'asma`u .himAra-ka yA \cap{ju.hA} yanhaqu.} fa-qAla la-hu
+%   \cap{ju.hA}: \enquote{.garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu
+%   'l-.himAr-a wa-tuka_d_diba-nI?}
+% \end{arab}
+% \SetTranslitConvention{dmg}
+%
 % \section{Buckwalter input scheme}
 % \label{sec:buckwalter-scheme}
 % \NEWfeature{v1.4} Even though \package{arabluatex} is primarily
@@ -2520,71 +2547,73 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 % characters that are defined in \vref{tab:additional-arabic-codings}
 % are also available.
 % 
-% \begin{longtable}{lllll}
+% \begin{longtable}{llllll}
 % \captionlistentry{Buckwalter scheme}\\[-1em]
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration\footnotemark}
+% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
 % & \multicolumn{2}{l}{Buckwalter notation} \\
-% & \texttt{dmg} & \texttt{loc} & |base/xml| & |safe| \\ \midrule
+% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
+% |safe| \\ \midrule
 % \endfirsthead
 % \toprule
-% Letter & \multicolumn{2}{l}{Transliteration}
+% Letter & \multicolumn{3}{l}{Transliteration}
 % & \multicolumn{2}{l}{Buckwalter notation} \\
-% & \texttt{dmg} & \texttt{loc} & |base/xml| & |safe| \\ \midrule
+% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
+% |safe| \\ \midrule
 % \endhead \footnotetext{See \vref{sec:transliteration}.}
 % \label{tab:buckwalter-scheme}
-% \arb[novoc]{a} & \dmg{a} & \loc{a} & |A| & |A| \\
-% \arb[novoc]{b} & \dmg{b} & \loc{b} & |b| & |b| \\
-% \arb[novoc]{t} & \dmg{t} & \loc{t} & |t| & |t| \\
-% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & |v| & |v| \\
-% \arb[novoc]{j} & \dmg{j} & \loc{j} & |j| & |j| \\
-% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & |H| & |H| \\
-% \arb[novoc]{x} & \dmg{x} & \loc{x} & |x| & |x| \\
-% \arb[novoc]{d} & \dmg{d} & \loc{d} & |d| & |d| \\
-% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & |*| & |V| \\
-% \arb[novoc]{r} & \dmg{r} & \loc{r} & |r| & |r| \\
-% \arb[novoc]{z} & \dmg{z} & \loc{z} & |z| & |z| \\
-% \arb[novoc]{s} & \dmg{s} & \loc{s} & |s| & |s| \\
-% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & |$| & |c| \\
-% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & |S| & |S| \\
-% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & |D| & |D| \\
-% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & |T| & |T| \\
-% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & |Z| & |Z| \\
-% \arb[novoc]{`} & \dmg{`} & \loc{`} & |E| & |E| \\
-% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & |g| & |g| \\
-% \arb[novoc]{f} & \dmg{f} & \loc{f} & |f| & |f| \\
-% \arb[novoc]{q} & \dmg{q} & \loc{q} & |q| & |q| \\
-% \arb[novoc]{k} & \dmg{k} & \loc{k} & |k| & |k| \\
-% \arb[novoc]{l} & \dmg{l} & \loc{l} & |l| & |l| \\
-% \arb[novoc]{m} & \dmg{m} & \loc{m} & |m| & |m| \\
-% \arb[novoc]{n} & \dmg{n} & \loc{n} & |n| & |n| \\
-% \arb[novoc]{h} & \dmg{h} & \loc{h} & |h| & |h| \\
-% \arb[novoc]{w} & \dmg{w} & \loc{w} & |w| & |w| \\
-% \arb[novoc]{y} & \dmg{y} & \loc{y} & |y| & |y| \\
-% \arb[novoc]{Y} & \dmg{Y} & \loc{Y} & |Y| & |Y| \\
-% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & |p| & |p| \\
+% \arb[novoc]{a} & \dmg{a} & \loc{a} & \brill{a} & |A| & |A| \\
+% \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| \\
+% \arb[novoc]{j} & \dmg{j} & \loc{j} & \brill{j} & |j| & |j| \\
+% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & \brill{.h} & |H| & |H| \\
+% \arb[novoc]{x} & \dmg{x} & \loc{x} & \brill{x} & |x| & |x| \\
+% \arb[novoc]{d} & \dmg{d} & \loc{d} & \brill{d} & |d| & |d| \\
+% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & \brill{_d} & |*| & |V| \\
+% \arb[novoc]{r} & \dmg{r} & \loc{r} & \brill{r} & |r| & |r| \\
+% \arb[novoc]{z} & \dmg{z} & \loc{z} & \brill{z} & |z| & |z| \\
+% \arb[novoc]{s} & \dmg{s} & \loc{s} & \brill{s} & |s| & |s| \\
+% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & \brill{^s} & |$| & |c| \\
+% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & \brill{.s} & |S| & |S| \\
+% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & \brill{.d} & |D| & |D| \\
+% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & \brill{.t} & |T| & |T| \\
+% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & \brill{.z} & |Z| & |Z| \\
+% \arb[novoc]{`} & \dmg{`} & \loc{`} & \brill{`} & |E| & |E| \\
+% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & \brill{.g} & |g| & |g| \\
+% \arb[novoc]{f} & \dmg{f} & \loc{f} & \brill{f} & |f| & |f| \\
+% \arb[novoc]{q} & \dmg{q} & \loc{q} & \brill{q} & |q| & |q| \\
+% \arb[novoc]{k} & \dmg{k} & \loc{k} & \brill{k} & |k| & |k| \\
+% \arb[novoc]{l} & \dmg{l} & \loc{l} & \brill{l} & |l| & |l| \\
+% \arb[novoc]{m} & \dmg{m} & \loc{m} & \brill{m} & |m| & |m| \\
+% \arb[novoc]{n} & \dmg{n} & \loc{n} & \brill{n} & |n| & |n| \\
+% \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| \\
+% \arb[novoc]{Y} & \dmg{Y} & \loc{Y} & \brill{Y} & |Y| & |Y| \\
+% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |p| & |p| \\
 % \midrule
-% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \verb|'| & |C| \\
-% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \verb+|+ & |M| \\
-% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \verb|>| & |O| \\
-% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \verb|&| & |W| \\
-% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \verb|<| & |I| \\
-% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \verb|]| & |Q| \\
+% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \brill{|"'} & \verb|'| & |C| \\
+% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \brill{A"'} & \verb+|+ & |M| \\
+% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \brill{a"'} & \verb|>| & |O| \\
+% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \brill{w"'} & \verb|&| & |W| \\
+% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \brill{i"'} & \verb|<| & |I| \\
+% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \brill{y"'} & \verb|]| & |Q| \\
 % \midrule
-% \arb[novoc]{BB} & --- & --- & \verb|~| & |~| \\
-% \arb[novoc]{"a} & ' & ' & |[| & |L| \\
+% \arb[novoc]{BB} & --- & --- & --- & \verb|~| & |~| \\
+% \arb[novoc]{"a} & ' & ' & --- & |[| & |L| \\
 % \midrule
-% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \verb|a| & |a| \\
-% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \verb|u| & |u| \\
-% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \verb|i| & |i| \\
-% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \verb|F| & |F| \\
-% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \verb|N| & |N| \\
-% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \verb|K| & |K| \\
-% \arb[voc]{B"} & --- & --- & \verb|o| & |o| \\
+% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \brill{Ba} & \verb|a| & |a| \\
+% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \brill{Bu} & \verb|u| & |u| \\
+% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \brill{Bi} & \verb|i| & |i| \\
+% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \brill{BaN} & \verb|F| & |F| \\
+% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \brill{BuN} & \verb|N| & |N| \\
+% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \brill{BiN} & \verb|K| & |K| \\
+% \arb[voc]{B"} & --- & --- & --- & \verb|o| & |o| \\
 % \midrule
-% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & |`| & |e| \\
+% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \brill{B_a} &  |`| & |e| \\
 % \midrule
-% \arb[novoc]{--} (\arb[trans]{ta.twIl}) & --- & --- & |_| & |_| \\
+% \arb[novoc]{--} (\arb[trans]{ta.twIl}) & --- & --- & --- & |_| & |_| \\
 % \bottomrule
 % \caption*{\Cref*{tab:buckwalter-scheme}: Buckwalter scheme}
 % \end{longtable}
@@ -3055,7 +3084,7 @@ wa-ya.sIru ta.hta 'l-jild-i
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{arabluatex}%
-[2017/03/18 v1.7.3 An ArabTeX-like interface for LuaLaTeX]
+[2017/03/30 v1.8 An ArabTeX-like interface for LuaLaTeX]
 \RequirePackage{ifluatex}
 %    \end{macrocode}
 % \package{arabluatex} requires \LuaLaTeX\ of course. Issue a warning