1 files changed, 12 insertions, 11 deletions

diff --git a/arabluatex.dtx b/arabluatex.dtx
index 52ae732..e194185 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -1389,9 +1389,9 @@ consonants, though three of them are also used as vowels
 % \arb[trans]{'abjad} numbers are usually distinguished from the
 % surrounding words by a stroke placed over them.
 %
-% For time being, \package{arabluatex} inserts those numbers with the
-% help of \package{polyglossia}. If you wish to use the
-% \arb[trans]{abjad} system, put in your preamble:---
+% For the time being, \package{arabluatex} inserts those numbers with the
+% help of \package{polyglossia}. If one wishes to use the
+% \arb[trans]{abjad} system, he may put in his preamble:---
 % \iffalse
 %<*example>
 % \fi
@@ -1403,7 +1403,7 @@ consonants, though three of them are also used as vowels
 % \iffalse
 %</example>
 % \fi %
-% \DescribeMacro{\abjad} Then you may use the command
+% \DescribeMacro{\abjad} Then one may use the command
 % \cs{abjad}\marg{number} in any of the |voc|, |fullvoc| and |novoc|
 % modes, where \meta{number} may be any number between 1 and 1999,
 % like so:---
@@ -1667,10 +1667,11 @@ al-muqAtilIna.}, wa-kAnat 'ummI min `u.zamA'i buyUti
 % \DescribeMacro{\LR} \cs{LR}\marg{arg} is designed to typeset its
 % argument from left to right. It may be used in an Arabic
 % environment, either \cs{arb}\marg{Arabic text} or \cs{begin}|{arab}|
-% \meta{Arabic text} \cs{end}|{arab}|, for short insertions of left to
-% right text, or to insert any \LaTeX\ command that would otherwise be
-% rejected by \package{arabluatex}, such as commands the argument of
-% which is expected to be a dimension or a unit of measurement.
+% \meta{Arabic text} \cs{end}|{arab}|, for short insertions of
+% left-to-right text, or to insert any \LaTeX\ command that would
+% otherwise be rejected by \package{arabluatex}, such as commands the
+% argument of which is expected to be a dimension or a unit of
+% measurement.
 %
 % \DescribeMacro{\RL} \cs{RL}\marg{arg} does the same as
 % \cs{LR}\marg{arg}, but typesets its argument from left to right. Even
@@ -1871,7 +1872,7 @@ wa-ya.sIru ta.hta 'l-jildi
 % and attempt to load the Amiri font which is included in \TeX{}live:
 %    \begin{macrocode}
 \AtBeginDocument{\ifdefined\arabicfont\relax\else
-\PackageWarning{arabluatex}{\string\arabicfont\ is not defined!^^JI
+\PackageWarning{arabluatex}{\string\arabicfont\ is not defined.^^JI
   will try to load Amiri}%
 \newfontfamily\arabicfont[Script=Arabic]{Amiri}\fi}%
 %    \end{macrocode}
@@ -1921,8 +1922,8 @@ wa-ya.sIru ta.hta 'l-jildi
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\SetTranslitConvention}
-% \cs{SetTranslitConvention}\marg{convention} may be used to change
-% the convention, which is |dmg| by default:
+%   \cs{SetTranslitConvention}\marg{convention} may be used to change
+%   the transliteration convention, which is |dmg| by default:
 %    \begin{macrocode}
 \def\al@trans@convention{dmg}
 \NewDocumentCommand{\SetTranslitConvention}{m}{\def\al@trans@convention{#1}}