1 files changed, 16 insertions, 0 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 1aa9d7d..bd9810c 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -770,11 +770,16 @@ consonants, though three of them are also used as vowels
 %   \arb[trans]{'iqlIduN}, |'anna| \arb[voc]{'anna}
 %   \arb[trans]{'anna}, |'inna| \arb[voc]{'inna} \arb[trans]{'inna}.
 %
+%   \label{ref:initial-hamza}
 %   \arb[trans]{hamzaT} followed by the long vowel \arb[novoc]{U} is
 %   encoded |'_U|: |'_Ul_A| \arb[voc]{'_Ul_A} \arb[trans]{'_Ul_A}, |'_UlU|
 %   \arb[voc]{'_UlU} \arb[trans]{'_UlU}, |'_UlA'ika|
 %   \arb[voc]{'_UlA'ika} \arb[trans]{'_UlA'ika}.
 %
+%   \arb[trans]{hamzaT} followed by the long vowel \arb[novoc]{I} is
+%   encoded |'_I|: |'_ImAnuN| \arb[voc]{'_ImAnuN}
+%   \arb[trans]{'_ImAnuN}.
+%
 %   \textbf{Middle \arb[trans]{hamzaT}}: |xA.ti'Ina|
 %   \arb[voc]{xA.ti'Ina} \arb[trans]{xA.ti'Ina}, |ru'UsuN|
 %   \arb[voc]{ru'UsuN}, \arb[trans]{ru'UsuN}, |xa.tI'aTuN|
@@ -823,6 +828,17 @@ consonants, though three of them are also used as vowels
 %   \arb[voc]{'a^syA'u} \arb[trans]{'a^syA'u}, |'a^syA'a|
 %   \arb[voc]{'a^syA'a} \arb[trans]{'a^syA'a}, |.zim'aN| \arb[voc]{.zim'aN}
 %   \arb[trans]{.zim'aN}.
+%
+%   \textbf{\arb[trans]{ta_hfIfu 'l-hamzaTi}}: if the
+%   \arb[trans]{hamzaT} has \arb[trans]{jazmaT} and is preceded by
+%   \emph{\arb[trans]{'alif} hamzatum}, it must be changed into the
+%   letter of prolongation that is homogeneous with the preceding
+%   vowel; hence: |'a'mana| \arb[voc]{'a'mana} \arb[trans]{'a'mana},
+%   |'u'minu| \arb[voc]{'u'minu} \arb[trans]{'u'minu}, |'i'mAnuN|
+%   \arb[voc]{'i'mAnuN} \arb[trans]{'i'mAnuN}. For other possible ways
+%   of encoding such sequences, see \vpageref{ref:initial-hamza}
+%   (\arb[trans]{hamzaT} followed by \arb[novoc]{U} and \arb[novoc]{I})
+%   and the \arb[trans]{maddaT} \vpageref{ref:madda}.
 % \end{quote}
 %
 % \paragraph{\arb[trans]{maddaT}} \label{ref:madda}At the beginning of