1 files changed, 38 insertions, 4 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index bfd42ba..a83cd73 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -890,6 +890,13 @@ vowels (see §~3).
 %   \arb[voc]{al-mal_a'ikaT-u 'l-ra.hm_an-u}, |.hu_dayfaT-u| |bn-u|
 %   |'l-yamAn_i| \arb[fullvoc]{.hu_dayfaT-u bn-u 'l-yamAn_i} for
 %   \arb[trans]{\cap{.hu_dayfaT-u} bn-u 'l-\cap{yamAn_i}}, etc.
+%
+%   \textsc{Rem.}~\emph{c.} The letter \arb[novoc]{y} with two points
+%   below, \arb{al-yA'u 'l-mu_tannATu min ta.hti-hA}, may also be
+%   written without diacritical points as \arb[novoc]{Y}. When it is
+%   used as a long vowel, it is encoded |iY| because a
+%   \arb[trans]{kasraT} has to be placed below the preceding letter in
+%   vocalized Arabic: \arb[fullvoc]{liY} \arb{qay"|'uN. ^say'uN}
 % \end{quoting}
 % 
 % \subsubsection{Short vowels}
@@ -2795,8 +2802,9 @@ al-muqAtil-Ina.}, wa-kAnat 'ummI min `u.zamA'-i buyUt-i
 % \cs{LR}\marg{arg}, but typesets its argument from right to left. Even
 % in an Arabic environment, this command may be useful.
 % 
-% For example, to distinguish words with a different color, one may
-% proceed like so:---
+% For example, to distinguish words with a different
+% color,\footnote{See below \vref{sec:textcolor} for more information
+% on two-argument commands.} one may proceed like so:--- %
 % \iffalse
 %<*example>
 % \fi
@@ -3042,9 +3050,35 @@ qAla barzawayhi bn-u 'azhar-a, ra's-u 'a.tibbA'-i fAris-a...
 % \subsection{Two-argument commands}
 % \label{sec:two-arg-cmds}
 %
-% \paragraph{\cs{textcolor}\marg{color}\marg{Arabic text}}
+% \paragraph{Color}
 % \label{sec:textcolor}
-% This command
+% The two-argument command \cs{textcolor}\marg{color}\marg{Arabic
+% text} is supported inside \cs{begin}|{arab}| \ldots\
+% \cs{end}|{arab}|. One simple example follows:--- %
+% \iffalse
+%<*example>
+% \fi
+\begin{arabluacode}
+\begin{arab}
+  \textcolor{red}{\cap{m}uha_d_dabu \cap{'l-d}Ini \cap{`a}bdu
+    \cap{'l-r}a.hImi bni \cap{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
+  'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \cap{m}uha_d_dabu
+  \cap{'l-d}Ini \cap{'a}bU \cap{m}u.hammadiN \cap{`a}bdu
+  \cap{'l-r}a.hImi bni \cap{`a}liyyi bni \cap{.h}AmidiN wa-yu`rafu
+  bi-\cap{'l-d}a_hwari.
+\end{arab}
+\begin{arab}[trans]
+  \textcolor{red}{\cap{m}uha_d_dabu \cap{'l-d}Ini \cap{`a}bdu
+    \cap{'l-r}a.hImi bni \cap{`a}liyyiN} huwa ^say_hu-nA 'l-'imAmu
+  'l-.sadru 'l-kabIru 'l-`Alimu 'l-fA.dilu \cap{m}uha_d_dabu
+  \cap{'l-d}Ini \cap{'a}bU \cap{m}u.hammadiN \cap{`a}bdu
+  \cap{'l-r}a.hImi bni \cap{`a}liyyi bni \cap{.h}AmidiN wa-yu`rafu
+  bi-\cap{'l-d}a_hwari.
+\end{arab}
+\end{arabluacode}
+% \iffalse
+%</example>
+% \fi
 %
 % \paragraph{\package{reledmac}}
 % \label{sec:reledmac}