added a couple of examples in the documentation

1 files changed, 11 insertions, 5 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index cb3287b..6b498fc 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -1019,7 +1019,9 @@ vowels (see §~3).
 %
 %   \arb[trans]{hamzaT} followed by the long vowel \arb[novoc]{I} is
 %   encoded |'_I|: |'_ImAnuN| \arb[voc]{'_ImAnuN}
-%   \arb[trans]{'_ImA\-nuN}.
+%   \arb[trans]{'_ImA\-nuN}\footnote{For another way of encoding the
+%   initial \arb[trans]{hamzaT} followed by a long vowel, see the
+%   \arb[trans]{ta_hfIf-u 'l-hamzaT-i}\vpageref{ref:taxfif-hamzah}.}.
 %
 %   \textbf{Middle \arb[trans]{hamzaT}}: |xA.ti'-Ina|
 %   \arb[voc]{xA.ti'-Ina} \arb[trans]{xA.ti'-Ina}, |ru'UsuN|
@@ -1032,9 +1034,11 @@ vowels (see §~3).
 %   \arb[voc]{yatasA'alUna}\linebreak \arb[trans]{yatasA'alUna},
 %   |murU'aTuN| \arb[voc]{murU'aTuN} \arb[trans]{murU'aTuN},
 %   |ta'xIruN| \arb[fullvoc]{ta'xIruN} \arb[trans]{ta'xIruN},
-%   |ta'axxara| \arb[voc]{ta'axxara} \arb[trans]{ta'axxara},
-%   |ji'tu-ka| \arb[voc]{ji'tu-ka} \arb[trans]{ji'tu-ka}, |qA'iluN|
-%   \arb[voc]{qA'iluN} \arb[trans]{qA'iluN}.
+%   |ta'ax|\allowbreak|xara| \arb[voc]{ta'axxara}
+%   \arb[trans]{ta'axxara}, |ji'tu-ka| \arb[voc]{ji'tu-ka}
+%   \arb[trans]{ji'tu-ka}, |qA'iluN| \arb[voc]{qA'iluN}
+%   \arb[trans]{qA'iluN}, |.hIna'i_diN| \arb[trans]{.hIna'i_diN}
+%   \arb[voc]{.hIna'i_diN}.
 %
 %   From \textcite[i. 14 B]{Wright}:--- All consonants, whatsoever,
 %   not even \arb[trans]{'alif} \emph{hèmzatum} excepted, admit of
@@ -1061,7 +1065,8 @@ vowels (see §~3).
 %   \arb[trans]{radI'iN}, |sU'uN| \arb[voc]{sU'uN} \arb[trans]{sU'uN},
 %   |.daw'uN| \arb[voc]{.daw'uN} \arb[trans]{.daw'uN}, |qay'iN|
 %   \arb[voc]{qay'iN} \arb[trans]{qay'iN}, |^sifA'I|
-%   \arb[voc]{^sifA'I} \arb[trans]{^sifA'I}.
+%   \arb[voc]{^sifA'I} \arb[trans]{^sifA'I}, |man^sa'I|
+%   \arb[trans]{man^sa'I} \arb[voc]{man^sa'I}.
 %
 %   |^say'uN| \arb[voc]{^say'uN} \arb[trans]{^say'uN}, |^say'aN|
 %   \arb[voc]{^say'aN} \arb[trans]{^say'aN}, |^say'iN|
@@ -1071,6 +1076,7 @@ vowels (see §~3).
 %   \arb[voc]{'a^syA'-a} \arb[trans]{'a^syA'-a}, |.zim'aN|
 %   \arb[voc]{.zim'aN} \arb[trans]{.zim'aN}.
 %
+%   \label{ref:taxfif-hamzah}
 %   \textbf{\arb[trans]{ta_hfIf-u 'l-hamzaT-i}}: if the
 %   \arb[trans]{hamzaT} has \arb[trans]{jazmaT} and is preceded by
 %   \emph{\arb[trans]{'alif} hamzatum}, it must be changed into the