a few additional remarks in the documentation; updated to v1.9.2v1.9.2

2 files changed, 39 insertions, 15 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 24e7e1f..5e4cf33 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -27,7 +27,7 @@
 %<package-info>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package-info>\ProvidesPackage{arabluatex}
 %<*package-info>
-    [2017/07/28 v1.9.1 An ArabTeX-like interface for LuaLaTeX]
+    [2017/10/24 v1.9.2 An ArabTeX-like interface for LuaLaTeX]
 %</package-info>
 %
 %<*driver>
@@ -155,7 +155,7 @@
 \defaultfontfeatures{RawFeature={+liga}}
 \setmainfont{Old Standard}[SmallCapsFont={Latin Modern Roman Caps},
   RawFeature={+mark;+ccmp;+ss05;+ss06}]
-\usepackage{arabluatex}[2017/07/28]
+\usepackage{arabluatex}[2017/10/24]
 \usepackage[nopar]{quran}
 \usepackage{varioref}
 \usepackage{hyperxmp}
@@ -227,7 +227,7 @@
 %</driver>
 % \fi
 %
-% \CheckSum{0}
+% \CheckSum{707}
 %
 % \CharacterTable
 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -558,6 +558,22 @@
 % \item The euphonic \arb[trans]{ta^sdId} is generated (see
 %   \vpageref{ref:euphonic-tashdid}).
 % \item In |fullvoc| mode, the \arb[trans]{sukUn} is expressed.
+% \item In such words as \arb{^say'aN}, \arb{.zim'aN} and the like,
+%   the \arb[trans]{hamzaT} alone is not written over the letter
+%   \arb[trans]{yA'} with no diacritical points below as in
+%   \arb{sayy"'aN}, \arb{.zimy"'aN}, but over a horizontal stroke
+%   placed in the continuation of the preceding letter. %
+% \iffalse
+%<*example>
+% \fi
+\begin{arabluacode}[text only]
+Please note that only few Arabic fonts provide such contrivances. In
+case this feature is not supported by some Arabic font, it is
+advisable to use \cs{SetArbEasy}.
+\end{arabluacode}
+% \iffalse
+%</example>
+% \fi
 % \end{compactitem}
 % 
 % \DescribeMacro{\SetArbEasy} \NEWfeature{v1.4.4}
@@ -793,7 +809,7 @@ vowels (see §~3).
 % \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| \\
 % \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| \\
 % \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y|\footnote{For
-% the letter \arb[novoc]{.y} with no diacritical point below, see
+% the letter \arb[novoc]{.y} with no diacritical points below, see
 % \emph{Rem{.} b.} below.} \\
 % \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |T| \\
 % \bottomrule
@@ -2036,11 +2052,16 @@ word that \cs{arbnull} is applied to.
 % \end{quote}
 % 
 % \begin{quoting}
-%   \textsc{Rem.} As the above example shows, \package{arabluatex}
-%   places the horizontal stroke \emph{under} the emphasized words in
-%   any of the transliteration modes.
-%
-%   \DescribeMacro{\aemph*}\NEWfeature{v1.9.2} 
+%   \textsc{Rem.}~\emph{a.} As the above example shows,
+%   \package{arabluatex} places the horizontal stroke \emph{under} the
+%   emphasized words in any of the transliteration modes.
+%
+%   \textsc{Rem.}~\emph{b.} \NEWfeature{v1.9.2}\DescribeMacro{\aemph*}
+%   \cs{aemph*} is also provided should one wish to always have the
+%   horizontal stroke printed over the emphasized words, like so:
+%   |\abjad{45}:| |kitAbu-hu| |\aemph*{fI| |'l-`AdAt-i}|
+%   \arb[voc]{\abjad{45}: kitAbu-hu \aemph*{fI 'l-`AdAt-i}}
+%   \arb[trans]{\abjad{45}: kitAbu-hu \aemph*{fI 'l-\cap{`AdAt-i}}}.
 % \end{quoting}
 % 
 % \section{Arabic poetry}
@@ -3329,7 +3350,7 @@ wa-ya.sIru ta.hta 'l-jild-i
 %    \begin{macrocode}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{arabluatex}%
-[2017/07/28 v1.9.1 An ArabTeX-like interface for LuaLaTeX]
+[2017/10/24 v1.9.2 An ArabTeX-like interface for LuaLaTeX]
 \RequirePackage{ifluatex}
 %    \end{macrocode}
 % \package{arabluatex} requires \LuaLaTeX\ of course. Issue a warning
@@ -3433,9 +3454,11 @@ wa-ya.sIru ta.hta 'l-jild-i
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\aemph} Arabic emphasis. Needs to be redefined as
-%   well. The function is actually coded in
-%   Lua. \changes{v1.9.2}{2017/10/24}{\cs{aemph*} Starred version
-%   which always puts the stroke over its argument}
+%   well. The function is actually coded in Lua.
+% \begin{macro}{\aemph*} The \enquote*{starred} version of this
+%   command alway puts the stroke over its argument.
+%   \changes{v1.9.2}{2017/10/24}{Starred version which always puts the
+%   stroke over its argument}
 %    \begin{macrocode}
 \AtBeginDocument{\ifdef{\aemph}%
   {\RenewDocumentCommand{\aemph}{s m}{%
@@ -3447,6 +3470,8 @@ wa-ya.sIru ta.hta 'l-jild-i
         $\overline{\text{#2}}$}
       {\luadirect{tex.sprint(aemph(\luastringN{#2}))}}}}}
 %    \end{macrocode}
+% \end{macro}
+% \end{macro}
 % \begin{macro}{\SetInputScheme}
 %   \changes{v1.4}{2016/07/05}{\cs{SetInputScheme} may be used to
 %   process other input schemes such as \enquote*{Buckwalter}}
@@ -3459,7 +3484,6 @@ wa-ya.sIru ta.hta 'l-jild-i
 \NewDocumentCommand{\SetInputScheme}{m}{\def\al@input@scheme{#1}}
 %    \end{macrocode}
 % \end{macro}
-% \end{macro}
 % \begin{macro}{\SetArbEasy}
 %   \changes{v1.2}{2016/05/09}{New \cs{SetArbEasy}/\cs{SetArbDflt} for
 %   \enquote*{modern} or \enquote*{classic} Arabic styles.}
diff --git a/samples/al-Jahiz.tex b/samples/al-Jahiz.tex
index 3fa94b6..7089be5 100644
--- a/samples/al-Jahiz.tex
+++ b/samples/al-Jahiz.tex
@@ -147,7 +147,7 @@ on p.~\pageref{source})}
 \maketitle
 \vspace{-1in}
 
-\label{source}
+\phantomsection\label{source}
 Here follows the exact source code that has been used to produce the
 above presented outputs. Discretionary hyphens
 (\mintinline{latex}|\-|) may have been inserted at some points to