done documenting for v1.9.2

1 files changed, 28 insertions, 1 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index c38feaf..24e7e1f 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -2510,7 +2510,7 @@ word that \cs{arbnull} is applied to.
 %   \NoArbUp\arb[trans]{\cap{`amruNU}}\ArbUpDflt\,;
 % \item \label{ref:dmg-up-rend}As superscript text:
 %   \arb[trans]{\cap{`amruNU}}\,;
-% \item Discarded: \arb[trans]{\cap{`amr}}.
+% \item \label{ref:irab-discarded}Discarded: \arb[trans]{\cap{`amr}}.
 % \end{compactenum}
 % \DescribeMacro{\arbup} By default, \package{arabluatex} applies rule
 % \ref{ref:dmg-up-rend}. Once delimited by a set of Lua functions,
@@ -2591,6 +2591,33 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
 %   min mu_hA.tabati-hi 'a.had-uN bi-sayyidi-nA} \arb[trans]{mana`a
 %   'l-nAs-a kAffaT-aN min mu_hA.tabati-hi 'a.had-uN bi-sayyidi-nA}.
 % \end{quoting}
+% 
+% \paragraph{Discarding the \arb[trans]{'i`rAb}}
+% As said above (\vref{ref:irab-discarded}), the \arb[trans]{'i`rAb}
+% may be discarded in some cases, as in transliterated proper names or
+% book titles. \package{arabluatex} is able to render words ending
+% with \arb[trans]{tA' marbU.taT} in different ways, depending on
+% their function:---
+% \begin{compactenum}[(a)]
+% \item Nouns followed by an adjective in apposition: |madInaT|
+%   |kabIraT| \arb[trans]{madInaT kabIraT}, |al-madInaT| |al-kabIraT|
+%   \arb[trans]{al-madInaT al-kabIraT}.
+% \item Nouns followed by another noun in the genitive (contruct
+%   state): |.hikmaT| |al-l_ah| \arb[trans]{.hikmaT al-\cap{l}_ah},
+%   |fi.d.daT| |al-darAhim| \arb[trans]{fi.d.daT al-darAhim}.
+% \end{compactenum}
+% \begin{quoting}
+%   \textsc{Rem.} It may so happen, as in the absence of the article
+%   before the annexed word, that \package{arabluatex} be unable to
+%   determine which of the above two cases the word ending with
+%   \arb[trans]{tA' marbU.taT} falls into. The \enquote*{pipe}
+%   character (see \vref{sec:pipe}) may be appended to that word to
+%   indicate that what follows is in the construct state:
+%   |\cap{r}isAlaT| |fI| |tartIb| \verb+qirA'aT|+ |kutub|
+%   |\cap{^g}AlInUs| \arb[trans]{\cap{r}isAlaT fI tartIb qirA'aT|
+%   kutub \cap{^g}AlInUs}.
+% \end{quoting}
+% 
 %
 % \paragraph{Uncertain short vowels}
 % In some printed books, it may happen that more than one short vowel