1 files changed, 30 insertions, 6 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index c9db780..471ff5a 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -2009,6 +2009,24 @@ word that \cs{arbnull} is applied to.
 %   \end{quote}
 % \end{quoting}
 %
+% \NEWfeature{v1.12}\cs{abjad} may also be used to convert values of
+% counters into \arb[trans]{'ab^gad} numbers, like so:--- %
+% \changes{v1.12}{2018/05/29}{\cs{abjad} can now process \LaTeX\
+% counters}%
+% \iffalse
+%<*example>
+% \fi
+\begin{arabluacode}
+  The \arb[trans]{'ab^gad} number for the current page (\thepage) is
+  \abjad{\thepage}.
+\end{arabluacode}
+% \iffalse
+%</example>
+% \fi%
+%
+% This technique can be used to produce abjad-numbered lists as will
+% be demonstrated \vpageref{ref:abjad-list}.
+%
 % \subsection{Additional characters}
 % \label{sec:additional-characters}
 % In the manuscripts, the unpointed letters, \arb[trans]{al-.hurUfu
@@ -2255,9 +2273,11 @@ word that \cs{arbnull} is applied to.
 % there are two easy ways to have them printed.
 %
 % If they are little in number, each footnote may be split into pairs
-% of \cs{footnote\allowbreak{}mark}|{}| (please mind the braces) in
-% the argument of the \cs{bayt} command and \cs{footnotetext} outside
-% the \cs{bayt} command.
+% of \cs{footnote\allowbreak{}mark}|{}| (please mind the braces or
+% \enquote{declare} |footnotemark| using \cs{MkArbBreak} to take it
+% out of the Arabic environment\footnote{See
+% \vref{sec:declare-new-commands}.}) in the argument of the \cs{bayt}
+% command and \cs{footnotetext} outside the \cs{bayt} command.
 %
 % If the footnotes are abundant in number, it is advised to load the
 % \package{footnotehyper} package which \package{arabluatex} will then
@@ -3270,9 +3290,9 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \label{sec:lists}
 % Lists environments are also accepted inside the |arab|
 % environment. One may either use any of the three standard list
-% environments, viz. |itemize|, |enumerate| and |description| or use a
-% package that provides additional refinements such as
-% \package{paralist}.
+% environments, viz. |itemize|, |enumerate| and |description| or use
+% packages that provide additional refinements such as
+% \package{paralist} or \package{enumitem}.
 %
 % To take a first example, should one wish to typeset a list of
 % manuscripts, the |description| environment can be used like so:---
@@ -3320,6 +3340,10 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 %</example>
 % \fi
 %
+% \label{ref:abjad-list}
+% As a third example, abjad-numbered lists can be typeset in
+% conjunction with the \package{enumitem} package, like so:---
+% 
 % \paragraph{Caveat}
 % The various French definition files of the \package{babel} package
 % viz. |acadian|, |canadien|, |francais|, |frenchb| or |french| all