dad (12oct14)

git-svn-id: svn://tug.org/texlive/trunk@35362 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 79 insertions, 28 deletions

diff --git a/Master/texmf-dist/doc/fonts/dad/README b/Master/texmf-dist/doc/fonts/dad/README
index 592210cab65..ebb9f2adbdc 100644
--- a/Master/texmf-dist/doc/fonts/dad/README
+++ b/Master/texmf-dist/doc/fonts/dad/README
@@ -1,4 +1,4 @@
-README for ض (dad) package, 2014/09/08, v1.0
+README for ض (dad) package, 2014/10/11, v1.1
 
 TABLE OF CONTENTS
 =================
@@ -22,8 +22,8 @@ The ض system operates with both Unicode and transliterated input, allowing the
 A paper describing the package has been submitted to TUGboat.
 
 This material is subject to the LaTeX Project Public License
-(LPPL). See http://www.latex-project.org/lppl.txt for the
-details of that license.
+(LPPL). See http://www.ctan.org/tex-archive/help/Catalogue/
+licenses.lppl.html for the details of that license.
 
 2 DOWNLOAD
 ==========
@@ -118,15 +118,10 @@ A bug report should contain:
 
 Bug address
 -----------
-Bug reports can be sent to the maintainer:
+Bug reports can be send to the maintainer:
   Yannis Haralambous
   <yannis [dot] haralambous [at] telecom-bretagne [dot] eu>
 
 
 8 KNOWN PROBLEMS
 =================
-
-LuaTeX has a bug which will result in bad typesetting and crashes.
-The bug has been reported in July 2014 under the following number:
-http://tracker.luatex.org/view.php?id=912&history=1#history
-We are still waiting for the LuaTeX team to do something about it...
diff --git a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.bib b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.bib
index 1c05c8a7783..89c54ed9783 100644
--- a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.bib
+++ b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.bib
@@ -1,3 +1,17 @@
+%%% ====================================================================
+%%%  BibTeX-file{
+%%%     filename        = "dad-user-guide.bib",
+%%%     version         = "1.1",
+%%%     date            = "2014/10/11",
+%%%     author          = "Yannis Haralambous",
+%%%     copyright       = "This file is part of the dad package, released
+%%%                        under the LPPL."
+%%%     keywords        = "TeX, file header",
+%%%     supported       = "yes",
+%%%     abstract        = "This is the BIB file of the user's guide of the dad
+%%%       system for typesetting in the Arabic language.",
+%%%  }
+%%% ====================================================================
 %% This BibTeX bibliography file was created using BibDesk.
 %% http://bibdesk.sourceforge.net/
 
@@ -186,11 +200,13 @@ title={Introduction to {Q}uranic script},
 publisher={Curzon Press},
 year={1984}}
 
-@unpublished{tugboat,
+@article{tugboat,
 author={Haralambous, Yannis},
-title={{\arab{D} (\emph{\d{d}\=ad})}, a Simple Arabic Typesetting System for Mixed Latin/Arabic Alphabet Documents},
+title={A simple Arabic typesetting system for mixed Latin/Arabic alphabet documents: \emph{\d{d}\=ad}},
 year={2014},
-note={Submitted to \emph{TUGboat}}
+journal={TUGboat},
+volume = {35},
+number = {3}
 }
 
 @unpublished{agl,
@@ -204,4 +220,12 @@ author={\mbox{\arab{sAHrAlbsmt*}}},
 title={{\arab{Am klcUm klmAt ARAnY kUkb Alshrq AlsYd-h Am klcUm mUsU`h kAmlh}}},
 year={2008},
 note={\url{http://alsabbah.yoo7.com/t417-topic}}
-}
\ No newline at end of file
+}
+
+@book{ryding2014,
+	Address = {Cambridge},
+	Author = {Ryding, Karin C.},
+	Publisher = {Cambridge University Press},
+	Title = {Arabic. A linguistic introduction},
+       Isbn = {978-1-107-02331},
+	Year = {2014}}
diff --git a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.pdf b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.pdf
index 6f747f92a70..5c0d2406006 100644
--- a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.pdf
+++ b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.pdf
diff --git a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.tex b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.tex
index 2d336180c64..3d3fad6af01 100644
--- a/Master/texmf-dist/doc/fonts/dad/dad-user-guide.tex
+++ b/Master/texmf-dist/doc/fonts/dad/dad-user-guide.tex
@@ -1,7 +1,21 @@
+%%% ====================================================================
+%%%  @LaTeX-file{
+%%%     filename        = "dad-user-guide.tex",
+%%%     version         = "1.1",
+%%%     date            = "2014/10/11",
+%%%     author          = "Yannis Haralambous",
+%%%     copyright       = "This file is part of the dad package, released
+%%%                        under the LPPL."
+%%%     keywords        = "TeX, file header,
+%%%     supported       = "yes",
+%%%     abstract        = "This is the user's guide of the dad
+%%%       system for typesetting in the Arabic language.",
+%%%  }
+%%% ====================================================================
 % needs lualatex to be processed
-\documentclass[11pt]{article}
+\documentclass[11pt,a4paper]{article}
 \pdfmapfile{/hom/yannis/projets/smf/0/smfpdftex.map}
-\usepackage{graphicx,color,framed}
+\usepackage{graphicx,color,framed,a4wide}
 \usepackage{ifpdf}
 %\usepackage[utf8]{inputenc}
 \ifpdf
@@ -18,7 +32,7 @@
 
 %%% Start of metadata %%%
 
-\title{User's Guide of \arab{D} (\emph{\d{d}\=ad}),\\ a Simple Arabic Typesetting System\\ for Mixed Latin/Arabic Alphabet Documents\\[12pt]Version 1.0/2014-09-06}
+\title{User's Guide of \arab{D} (\emph{\d{d}\=ad}),\\ a Simple Arabic Typesetting System\\ for Mixed Latin/Arabic Alphabet Documents\\[12pt]Version 1.1/2014-10-11}
 
 % repeat info for each author.
 \author{Yannis Haralambous\thanks{Institut Mines T\'el\'ecom, T\'el\'ecom Bretagne,
@@ -38,15 +52,15 @@ CS 83818, 29238~Brest~Cedex~3, France, \url{yannis.haralambous@telecom-bretagne.
 \begin{itemize}
 \item it is compatible with all \LaTeX\ style files, since the code is minimal and all the complexity is in the font;
 \item input can be done in Unicode or in transliteration, the latter being often the best choice when mixing left-to-right and right-to-left scripts;
-\item the only \TeX nical requirement is Lua\TeX, not because of the Lua language (which is not used, for the moment), but because of features that have survived from lua\TeX's $\Omega$ origins: bidirectionality and use of large fonts (OVF, OFM).
+\item the only \TeX nical requirement is Lua\TeX, not because of the Lua language (which is not used, for the moment), but because of features that have survived from Lua\TeX's $\Omega$ origins: bidirectionality and use of large fonts (OVF, OFM).
 \end{itemize}
-Choose lua\TeX\ as your \TeX\ engine, load the package into your document, and \arab{AhlAaN wshlAaN!}, just start writing in Arabic using command \verb=\arab=.
+Choose Lua\TeX\ as your \TeX\ engine, load the package into your document, and \arab{AhlAaN wshlAaN!}, just start writing in Arabic using command \verb=\arab=.
 
 More information about \arab{D} (history, evolution, rationale of technical choices, \TeX nicalities) can be found in \cite{tugboat}.
 
-\begin{framed}
-\noindent ATTENTION! \textbf{\arab{xTr!}} Because of bugs in lua\TeX, in some cases appear mysterious blank spaces on the left of the text, word parts are duplicated, and sometimes \TeX\ breaks with an error message \texttt{This can't happen (sub\_disc\_widths).} These errors have been submitted to the lua\TeX\ team (\url{http://tracker.luatex.org/view.php?id=912&history=1#history}), which will provide the necessary corrections \arab{'in shA| ALLh}.
-\end{framed}
+%\begin{framed}
+%\noindent ATTENTION! \textbf{\arab{xTr!}} Because of bugs in Lua\TeX, in some cases appear mysterious blank spaces on the left of the text, word parts are duplicated, and sometimes \TeX\ breaks with an error message \texttt{This can't happen (sub\_disc\_widths).} These errors have been submitted to the Lua\TeX\ team (\url{http://tracker.luatex.org/view.php?id=912&history=1#history}), which will provide the necessary corrections \arab{'in shA| ALLh}.
+%\end{framed}
 
 \section{The name}
 
@@ -54,7 +68,7 @@ Thanks to the Internet, search engines, social media, and the like, people are b
 
 The author has chosen letter \arab{D}, called \emph{\d{d}\=ad}, because Arabic is traditionally called the ``language of the \emph{\d{d}\=ad},'' since this sound was considered as being unique to Arabic.
 
-The reader is probably wondering how to pronounce this letter, technically called a ``pharyngealized voiced alveolar plosive'' (dixit Wikipedia). Here is how \cite[p.~10]{learn2} describes its pronunciation:
+The reader is probably wondering how to pronounce this letter,technically a ``voiced velarized alveolar stop'' \cite[p.~16]{ryding2014}. Here is how \cite[p.~10]{learn2} describes its pronunciation:
 
 \begin{quotation}
 Pronounce the regular sound `d' and you will find that the tip of your tongue will touch in the region of the upper front teeth/gum. Now pronounce the sound again and at the same time depress the \emph{middle} of the tongue. This has the effect of creating a larger space between the tongue and the roof of the mouth and gives the sound produced a distinctive `hollow' characteristic, which also effects the surrounding vowels. It is difficult to find a parallel in English, but the difference between `Sam' and `psalm' (standard English pronunciation) gives a clue. Tense the tongue muscles in pronouncing `psalm' and you are nearly there. Now pronounce the a-vowel of `psalm' before and after `\d{d}', saying `a\d{d}a', keeping the tongue tense, and that's as near as we can get to describing it in print.
@@ -107,9 +121,13 @@ Arabic text can be input in transliteration, as described in Table~\ref{trans} o
 
 Here are the rules of the proposed transliteration: 
 \begin{enumerate}
-\item emphatic consonants (\arabttexample{H}, \arabttexample{T}, \arabttexample{S}, \arabttexample{S}, \arabttexample{D}) as well as long vowels (\arabttexample{A}, \arabttexample{U}, \arabttexample{Y}) and \emph{\hamza$\!$alif maq\d s\=ura} (\arabttexample{I}) are \emph{uppercased};
+\item pharyngeal \arabttexample{H}, emphatic \arabttexample{S}, \arabttexample{D}, \arabttexample{T},
+\arabttexample{Z} and velar \arabttexample{R} are \emph{uppercased}---do not confuse them with glottal \arabttexample{h}, non-emphatic \arabttexample{s}, \arabttexample{d}, \arabttexample{t}, \arabttexample{z}, and alveolar \arabttexample{r};
+\item long vowels (\arabttexample{A}, \arabttexample{U}, \arabttexample{Y}) and
+\emph{\hamza$\!$alif maq\d s\=ura} (\arabttexample{I}) are also
+\emph{uppercased};
 
-\item some consonants are modified by adding a character \texttt{h} (\arabttexample{dh}, \arabttexample{th}, \arabttexample{sh}, \arabttexample{kh}, \arabttexample{zh});
+\item some consonants are modified by adding a character \texttt{h} (\arabttexample{dh}, \arabttexample{th}, \arabttexample{sh});
 
 \item the stand-alone \emph{hamza} is obtained by a vertical bar \texttt{|} and letter ayn by a grave accent (which, in legacy \TeX\ produces an inverted curly apostrophe, which is sometimes used to transliterate this letter);
 
@@ -125,10 +143,10 @@ Here are the rules of the proposed transliteration:
 
 %\def\kesh{\leavevmode\leaders\hrule height\fontdimen8\hfill\kern0pt}
 
-\item finally, there is yet another use of the dash: when doubled, it produces a keshideh
+\item finally, there is yet another use of the dash: when doubled, it produces a kashida
 %tatweel
-%(also known as ``keshideh'') 
-stroke: compare \arabttexample{lYl} and \arabttexample{l--Y--l}. There is also a \verb=\kesh= command for extensible keshideh (it is equivalent to a \verb=\hrulefill= using the default rule thickness font dimension \verb=\fontdimen8=): \verb=l--\kesh--Y--\kesh--l.= will produce:
+%(also known as ``kashida'') 
+stroke: compare \arabttexample{lYl} and \arabttexample{l--Y--l}. There is also a \verb=\kesh= command for extensible kashida (it is equivalent to a \verb=\hrulefill= using the default rule thickness font dimension \verb=\fontdimen8=): \verb=l--\kesh--Y--\kesh--l.= will produce:
 
 \noindent\arab{l--\kesh--Y--\kesh--l.}
 
@@ -351,7 +369,7 @@ Input can be transliterated or provided directly in Unicode Arabic: \texttt{\tex
 
 All cells of Table~\ref{trans} can be obtained by the corresponding Unicode characters (mostly via a single character, except for \emph{\v{s}adda} + vowel combinations which require two characters). There is a special case, though: the \arab{LLh} ligature (see next section).
 
-For the convenience of the user who wants to write keshideh (so that Arabic input is not disrupted) we have defined a command (in Arabic characters) \arabtt{tT}\textbackslash{} (\arab{tT} are the first two letters of \arab{tTUYl} = \emph{ta\d{t}wyl}, the Arabic name of keshideh) which is exactly equivalent to \verb=\kesh= and has to be placed between Unicode \textsc{U+0640 arabic tatwell} characters.
+For the convenience of the user who wants to write kashida (so that Arabic input is not disrupted) we have defined a command (in Arabic characters) \arabtt{tT}\textbackslash{} (\arab{tT} are the first two letters of \arab{tTUYl} = \emph{ta\d{t}wyl}, the Arabic name of kashida) which is exactly equivalent to \verb=\kesh= and has to be placed between Unicode \textsc{U+0640 arabic tatwell} characters.
 
 \subsubsection{The \arab{LLh} ligature and Unicode}\label{allah}
 
diff --git a/Master/texmf-dist/doc/fonts/dad/make-dad-font.pl b/Master/texmf-dist/doc/fonts/dad/make-dad-font.pl
index f082d2d21e5..82fb82a37c6 100644
--- a/Master/texmf-dist/doc/fonts/dad/make-dad-font.pl
+++ b/Master/texmf-dist/doc/fonts/dad/make-dad-font.pl
@@ -1,3 +1,17 @@
+# %%% ====================================================================
+# %%%  @Perl-file{
+# %%%     filename        = "make-dad-font.pl",
+# %%%     version         = "1.1",
+# %%%     date            = "2014/10/11",
+# %%%     author          = "Yannis Haralambous",
+# %%%     copyright       = "This file is part of the dad package, released
+# %%%                        under the LPPL."
+# %%%     keywords        = "TeX, file header,
+# %%%     supported       = "yes",
+# %%%     abstract        = "This is the Perl script that creates
+# %%%       the dad fonts out of their AFM and ADJUST files.",
+# %%%  }
+# %%% ====================================================================
 $MAXHEIGHT=560;
 $MAXDEPTH=-360;
 if ($ARGV[0] ne "") { $STYLE_="-".$ARGV[0]; $STYLE=$ARGV[0]; } else { $STYLE=""; }