summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-07-03 21:45:54 +0000
committerManuel Pégourié-Gonnard <mpg@elzevir.fr>2008-07-03 21:45:54 +0000
commit60b4c4c10b1d3f17d0cfd874ee2aa0c760323848 (patch)
treea9bce5b79aea345a4bb9bb73c3bdeb42aa865708 /Master/texmf-dist/doc
parenta51e7b83ab266e1e51718bdb0f8007a4517a578a (diff)
velthuis v2.15
git-svn-id: svn://tug.org/texlive/trunk@9196 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/README24
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/changes45
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/examples.dn4
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/examples.pdfbin65265 -> 115549 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/hindi.dtx208
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/hindi.ins148
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/hindi.pdfbin0 -> 206162 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/manual.pdfbin516820 -> 555159 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/manual.tex336
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/misspaal.dn2
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/misspaal.pdfbin27874 -> 27098 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/xetex-examples.pdfbin0 -> 30634 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/xetex-examples.tex161
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.pdfbin0 -> 15279 bytes
-rw-r--r--Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.tex104
15 files changed, 988 insertions, 44 deletions
diff --git a/Master/texmf-dist/doc/generic/velthuis/README b/Master/texmf-dist/doc/generic/velthuis/README
index 8bcd55ffc63..539838d7e12 100644
--- a/Master/texmf-dist/doc/generic/velthuis/README
+++ b/Master/texmf-dist/doc/generic/velthuis/README
@@ -1,6 +1,6 @@
==============================================================================
Velthuis Devanagari for TeX Installation Notes
-Version 2.14 27 May 2006
+Version 2.15 22 June 2008
==============================================================================
@@ -137,7 +137,7 @@ Test your installation
The kpathsea library now should be able to find your files. Try the following
commands:
-kpsewhich dev.sty
+kpsewhich devanagari.sty
kpsewhich dvng10.tfm
kpsewhich dvng10.mf
kpsewhich dvng10.pfb
@@ -147,6 +147,24 @@ instead, there is something wrong with your installation. It makes no sense to
continue. Return to the previous step and fix the installation.
+Enable Hindi in Babel
+=====================
+
+Hindi support is not yet an official part of LaTeX. The installation files
+for Babel are included in the "doc" directory but the language definition
+file has been generated and installed. In order to enable Hindi add the
+following line to your language.dat:
+
+hindi zerohyph.tex
+
+Afterwards rebuild the formats by the coresponding butten in MikTeX or by the
+following commands in TeX Live:
+
+fmtutil --byfmt latex
+fmtutil --byfmt pdflatex
+fmtutil --byfmt xelatex
+
+
Make font information files
===========================
@@ -190,7 +208,7 @@ Frequent errors
TEXMF variable (teTeX, TeX Live) or selected in MikTeX options in the Roots
tab. Refresh the filename database (it never harms anything).
-* PostScript files created by dvips does not contain Type 1 fonts, they are
+* PostScript files created by dvips do not contain Type 1 fonts, they are
replaced by roman fonts although dv*.pfb were loaded
You probably have an old version of dvng.map earlier in the search path or
diff --git a/Master/texmf-dist/doc/generic/velthuis/changes b/Master/texmf-dist/doc/generic/velthuis/changes
index c539db11f42..dca9f93ab4f 100644
--- a/Master/texmf-dist/doc/generic/velthuis/changes
+++ b/Master/texmf-dist/doc/generic/velthuis/changes
@@ -1,8 +1,51 @@
=============================================================================
Devanagari for TeX Release Notes
-Version 2.14 14 May 2006
+Version 2.15 22 June 2007
=============================================================================
+= 9 March 2008: version 2.15
+
+ - Bibliography modified; cite.sty is no longer loaded as default
+ which enables usage of natbib as well as other packages. Macros
+ are moved to a specialized package dvngcite which can be loaded
+ on demand. The old package loads both devanagari.sty and dvngcite.sty
+ in order not to break legacy documents.
+
+ - Enumeration macros fixed so that they work well both in the \dn mode
+ and outside of it.
+
+ - Switch \ifdnmode implemented so that a user can safeley verify (within
+ macros) whether we are in the \dn mode.
+
+= 15 July 2007: version 2.15
+
+ - Added support for babel (hindi.ldf)
+
+ - Added TECkit maps for using Velthuis transliteration in XeTeX
+
+ - Added samples os use in XeTeX
+
+= 21 December 2006
+
+ - Definition \def\DevnagVersion{...} written to the beginning of the second
+ line if the first line starts with %& in order to preserve
+ %& -translate-file=...
+
+ - Error and warning messages written to stderr instead of stdout
+
+-----------------------------------------------------------------------------
+
+= 20 November 2006: version 2.14.1
+
+ - Language dependent strings defined in a way compatible with babel,
+ conflicts removed and some definitions made more robust
+
+ - \cmnum and \dnnum are again global
+
+ - Conflict with hyperref.sty fixed
+
+-----------------------------------------------------------------------------
+
= 14 May 2006: version 2.14
- The preprocessor can read files with any line endings on all platforms
diff --git a/Master/texmf-dist/doc/generic/velthuis/examples.dn b/Master/texmf-dist/doc/generic/velthuis/examples.dn
index 410c4b16b55..301c70c550c 100644
--- a/Master/texmf-dist/doc/generic/velthuis/examples.dn
+++ b/Master/texmf-dist/doc/generic/velthuis/examples.dn
@@ -1,6 +1,6 @@
@hyphen
\documentclass[12pt]{article}
-\usepackage{dev}
+\usepackage{devanagari}
\parindent=0pt
\begin{document}
@@ -43,7 +43,7 @@ sm.rta.m ma"ngalaacarana.m ce.s.tadevataapuujanaadi ca|
\begin{verbatim}
\documentclass[12pt]{article}
-\usepackage[hyphenate]{dev}
+\usepackage{devanagari}
\end{verbatim}
%\vspace*{-.45cm}
%\vspace*{-.40cm}
diff --git a/Master/texmf-dist/doc/generic/velthuis/examples.pdf b/Master/texmf-dist/doc/generic/velthuis/examples.pdf
index 5ba3405f86a..464d6ebd32e 100644
--- a/Master/texmf-dist/doc/generic/velthuis/examples.pdf
+++ b/Master/texmf-dist/doc/generic/velthuis/examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/hindi.dtx b/Master/texmf-dist/doc/generic/velthuis/hindi.dtx
new file mode 100644
index 00000000000..852299187bc
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/hindi.dtx
@@ -0,0 +1,208 @@
+% \iffalse meta-comment
+%
+% Copyright 1989-2004 Johannes L. Braams and any individual authors
+% listed elsewhere in this file. All rights reserved.
+%
+% This file is part of the Babel system.
+% --------------------------------------
+%
+% It may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2003/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+%
+% The Current Maintainer of this work is Johannes Braams.
+%
+% The list of all files belonging to the LaTeX base distribution is
+% given in the file `manifest.bbl. See also `legal.bbl' for additional
+% information.
+%
+% The list of derived (unpacked) files belonging to the distribution
+% and covered by LPPL is defined by the unpacking scripts (with
+% extension .ins) which are part of the distribution.
+% \fi
+% \CheckSum{72}
+%
+% \iffalse
+% Tell the \LaTeX\ system who we are and write an entry on the
+% transcript.
+%<*dtx>
+\ProvidesFile{hindi.dtx}
+%</dtx>
+%<+code>\ProvidesLanguage{hindi}
+%\fi
+%\ProvidesFile{hindi.dtx}
+ [2007/05/11 v1.0a Hindi support from the babel system]
+%\iffalse
+%% File `hindi.dtx'
+%% Babel package for LaTeX version 2e
+%% Copyright (C) 1989 -- 2004
+%% by Johannes Braams, TeXniek
+%
+%% Hindi language Definition File
+%% Copyright (C) 2006 -- 2007
+%% by Zdenek Wagner, Ice Bear Soft
+%% Johannes Braams, TeXniek
+%
+%% Please report errors to: Velthuis Devanagari for TeX project
+%% http://sarovar.org/projects/devnag/
+%
+% This file is part of the babel system, it provides the source
+% code for the hindi language definition file. The original
+% version of this file was written by Zdenek Wagner.
+% It is based on the Velthuis Devanagari for TeX project.
+%<*filedriver>
+\documentclass{ltxdoc}
+\usepackage{graphicx}
+\newcommand*{\TeXhax}{\TeX hax}
+\newcommand*{\babel}{\textsf{babel}}
+\newcommand*{\langvar}{$\langle \mathit lang \rangle$}
+\newcommand*{\note}[1]{}
+\newcommand*{\Lopt}[1]{\textsf{#1}}
+\newcommand*{\file}[1]{\texttt{#1}}
+\newcommand*{\pkg}[1]{\texttt{#1}}
+\DeclareRobustCommand\XeTeX{X\kern-.125em\lower.5ex\hbox{\csname
+ reflectbox\endcsname{E}}\kern-.1667em\TeX}
+\DeclareRobustCommand\XeLaTeX{X\kern-.125em\lower.5ex\hbox{\csname
+ reflectbox\endcsname{E}}\LaTeX}
+\begin{document}
+ \DocInput{hindi.dtx}
+\end{document}
+%</filedriver>
+%\fi
+% \newcommand*{\devnag}{Devan\=agar\=\i}
+% \GetFileInfo{hindi.dtx}
+%
+%
+% \section{The Hindi language}
+%
+% The file \file{\filename}\footnote{The file described in this
+% section has version number \fileversion\ and was last revised on
+% \filedate. The original author is Zdenek Wagner. The module is
+% based on the Velthuis \devnag\ for \TeX.} implements the language
+% features for Hindi in the \babel\ system. There are no hyphenation
+% patterns, therefore just the captions and Europian style date
+% are defined. It is difficult, or maybe even impossible, to convert
+% the \TeX's date into the traditional Indian date (tithi). Such
+% functionality will hardly ever be provided.
+%
+% Remember that the file does not work without the Velthuis \devnag\
+% for \TeX. Look into its manual for instructions how to use Hindi
+% with \babel.
+%
+% \StopEventually{}
+%
+% The macro |\LdfInit| takes care of preventing that this file is
+% loaded more than once, checking the category code of the
+% \texttt{@} sign, etc.
+% \begin{macrocode}
+%<*code>
+\LdfInit\CurrentOption{captions\CurrentOption}
+% \end{macrocode}
+% When the option \Lopt{modern} was used, redefine
+% |\CurrentOption| to prevent problems later on.
+% \begin{macrocode}
+\gdef\CurrentOption{hindi}%
+\edef\bbl@main@language{\CurrentOption}%
+% \end{macrocode}
+%
+% When this file is read as an option, i.e. by the |\usepackage|
+% command, \texttt{hindi} could be an `unknown' language in
+% which case we have to make it known. So we check for the
+% existence of |\l@hindi| to see whether we have to do
+% something here.
+%
+% \begin{macrocode}
+\ifx\l@hindi\@undefined
+ \@nopatterns{hindi}
+ \adddialect\l@hindi0\fi
+% \end{macrocode}
+%
+% Now we declare the |modernhindi| language attribute.
+% \begin{macrocode}
+\bbl@declare@ttribute{hindi}{modernhindi}{%
+ \let\captionshindi\captionsmodernhindi
+ \let\datehindi\datemodernhindi
+ }
+% \end{macrocode}
+%
+% The file supports both \XeTeX\ and traditional \TeX. We thus
+% check the engine first.
+%
+% \begin{macrocode}
+\expandafter\ifx\csname XeTeXrevision\endcsname\relax
+% \end{macrocode}
+%
+% Font styles are defined as language attributes. They make no
+% sense in \XeLaTeX.
+%
+% \begin{macrocode}
+ \bbl@declare@ttribute{hindi}{bombay}{\def\dnfamilydefault{dnb}}
+ \bbl@declare@ttribute{hindi}{calcutta}{\def\dnfamilydefault{dnc}}
+ \bbl@declare@ttribute{hindi}{nepali}{\def\dnfamilydefault{dnn}}
+ \bbl@declare@ttribute{hindi}{pen}{\def\dnfamilydefault{dnp}}
+ \bbl@declare@ttribute{hindi}{penbombay}{\def\dnfamilydefault{dnpb}}
+ \bbl@declare@ttribute{hindi}{pencalcutta}{\def\dnfamilydefault{dnpc}}
+ \bbl@declare@ttribute{hindi}{pennepali}{\def\dnfamilydefault{dnpn}}
+% \end{macrocode}
+%
+% Support for typesetting in the \devnag\ script as well as captions
+% names definitions for Hindi is loaded from \file{devanagari.sty}.
+% New version is needed, therefore the package date is checked. The
+% plain \TeX\ version currently does not define captions.
+%
+% \begin{macrocode}
+ \expandafter\ifx\csname RequirePackage\endcsname\relax
+ \input dnmacs
+ \else
+ \AtEndOfPackage{\RequirePackage[nocatcodes]{devanagari}[2006/06/21]}
+ \fi
+% \end{macrocode}
+%
+% The \XeLaTeX\ captions are written directly in UTF-8 and will be
+% unprintable in the documentation of this file. The file with
+% caption definitions (|hindicaptions.sty|) was therefore
+% placed to the Velthuis \devnag\ package and is only loaded here.
+%
+% \begin{macrocode}
+\else
+ \expandafter\ifx\csname RequirePackage\endcsname\relax
+ \input hindicaptions.sty
+ \else
+ \AtEndOfPackage{\RequirePackage{hindicaptions}[2007/05/11]}
+ \fi
+\fi
+% \end{macrocode}
+%
+% The macro |\ldf@finish| takes care of looking for a
+% configuration file, setting the main language to be switched on
+% at |\begin{document}| and resetting the category code of
+% \texttt{@} to its original value.
+% \begin{macrocode}
+\ldf@finish{\CurrentOption}
+%</code>
+% \end{macrocode}
+%
+% \Finale
+%\endinput
+%% \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
+%% Lower-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
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+%%
diff --git a/Master/texmf-dist/doc/generic/velthuis/hindi.ins b/Master/texmf-dist/doc/generic/velthuis/hindi.ins
new file mode 100644
index 00000000000..a6b74a0be9d
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/hindi.ins
@@ -0,0 +1,148 @@
+%%
+%% This file will generate fast loadable files and documentation
+%% driver files from the doc files in this package when run through
+%% LaTeX or TeX.
+%%
+%% Copyright 1989-2004 Johannes L. Braams and any individual authors
+%% listed elsewhere in this file. All rights reserved.
+%%
+%% This file is part of the Babel system.
+%% --------------------------------------
+%%
+%% It may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2003/12/01 or later.
+%%
+%% This work has the LPPL maintenance status "maintained".
+%%
+%% The Current Maintainer of this work is Johannes Braams.
+%%
+%% The list of all files belonging to the LaTeX base distribution is
+%% given in the file `manifest.bbl. See also `legal.bbl' for additional
+%% information.
+%%
+%% The list of derived (unpacked) files belonging to the distribution
+%% and covered by LPPL is defined by the unpacking scripts (with
+%% extension .ins) which are part of the distribution.
+%%
+%% --------------- start of docstrip commands ------------------
+%%
+\def\filedate{2006/06/30}
+\def\batchfile{hindi.ins}
+\input docstrip.tex
+
+{\ifx\generate\undefined
+\Msg{**********************************************}
+\Msg{*}
+\Msg{* This installation requires docstrip}
+\Msg{* version 2.3c or later.}
+\Msg{*}
+\Msg{* An older version of docstrip has been input}
+\Msg{*}
+\Msg{**********************************************}
+\errhelp{Move or rename old docstrip.tex.}
+\errmessage{Old docstrip in input path}
+\batchmode
+\csname @@end\endcsname
+\fi}
+
+\declarepreamble\mainpreamble
+This is a generated file.
+
+Copyright 1989-2004 Johannes L. Braams and any individual authors
+listed elsewhere in this file. All rights reserved.
+
+This file was generated from file(s) of the Babel system.
+---------------------------------------------------------
+
+It may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3
+of this license or (at your option) any later version.
+The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of LaTeX
+version 2003/12/01 or later.
+
+This work has the LPPL maintenance status "maintained".
+
+The Current Maintainer of this work is Johannes Braams.
+
+This file may only be distributed together with a copy of the Babel
+system. You may however distribute the Babel system without
+such generated files.
+
+The list of all files belonging to the Babel distribution is
+given in the file `manifest.bbl'. See also `legal.bbl for additional
+information.
+
+The list of derived (unpacked) files belonging to the distribution
+and covered by LPPL is defined by the unpacking scripts (with
+extension .ins) which are part of the distribution.
+\endpreamble
+
+\declarepreamble\fdpreamble
+This is a generated file.
+
+Copyright 1989-2004 Johannes L. Braams and any individual authors
+listed elsewhere in this file. All rights reserved.
+
+This file was generated from file(s) of the Babel system.
+---------------------------------------------------------
+
+It may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3
+of this license or (at your option) any later version.
+The latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of LaTeX
+version 2003/12/01 or later.
+
+This work has the LPPL maintenance status "maintained".
+
+The Current Maintainer of this work is Johannes Braams.
+
+This file may only be distributed together with a copy of the Babel
+system. You may however distribute the Babel system without
+such generated files.
+
+The list of all files belonging to the Babel distribution is
+given in the file `manifest.bbl'. See also `legal.bbl for additional
+information.
+
+In particular, permission is granted to customize the declarations in
+this file to serve the needs of your installation.
+
+However, NO PERMISSION is granted to distribute a modified version
+of this file under its original name.
+
+\endpreamble
+
+\keepsilent
+
+\usedir{tex/generic/babel}
+
+\usepreamble\mainpreamble
+\generate{\file{hindi.ldf}{\from{hindi.dtx}{code}}
+ }
+\usepreamble\fdpreamble
+
+\ifToplevel{
+\Msg{***********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* files into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space All *.def, *.fd, *.ldf, *.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the files ending with}
+\Msg{* '.dtx' and `.fdd' through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing}
+\Msg{***********************************************************}
+}
+
+\endinput
diff --git a/Master/texmf-dist/doc/generic/velthuis/hindi.pdf b/Master/texmf-dist/doc/generic/velthuis/hindi.pdf
new file mode 100644
index 00000000000..0c1e48a79b7
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/hindi.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/manual.pdf b/Master/texmf-dist/doc/generic/velthuis/manual.pdf
index be4e608daff..f4e8f216d0e 100644
--- a/Master/texmf-dist/doc/generic/velthuis/manual.pdf
+++ b/Master/texmf-dist/doc/generic/velthuis/manual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/manual.tex b/Master/texmf-dist/doc/generic/velthuis/manual.tex
index f9e928da856..afba7b6e55e 100644
--- a/Master/texmf-dist/doc/generic/velthuis/manual.tex
+++ b/Master/texmf-dist/doc/generic/velthuis/manual.tex
@@ -1,11 +1,14 @@
%
-% manual.tex v2.14
+% manual.tex v2.14.1
%
% LaTeX source file for the manual for the Devanagari for TeX" package.
-% Copyright (C) 1991-2003 University of Groningen, The Netherlands
+% Copyright (C) 1991-2006 University of Groningen, The Netherlands
%
% Author : Anshuman Pandey <apandey@u.washington.edu>
-% $Id: manual.tex,v 1.6 2006/05/29 09:00:12 icebearsoft Exp $
+% Maintainer : Kevin Carmody <i@kevincarmody.com>
+% Zdenek Wagner <zdenek.wagner@gmail.com>
+%
+% $Id: manual.tex,v 1.10 2008-03-09 15:57:59 icebearsoft Exp $
%
% This program is free software; you can redistribute it and/or modify
% it under the terms of the GNU General Public License as published by
@@ -16,10 +19,11 @@
% merchantability or fitness for a particular purpose. See the
% GNU General Public License for more details.
%
-
+\listfiles
\documentclass[10pt]{article}
\def\DevnagVersion{new}
-\usepackage{geometry,fancyhdr,multicol,mflogo,textcomp,parskip,array,color}
+\usepackage{ifpdf}
+\usepackage{geometry,fancyhdr,multicol,mflogo,textcomp,parskip,array,color,graphicx}
\usepackage{devanagari}
\renewcommand{\rmdefault}{ptm}
@@ -33,21 +37,31 @@
headsep=0pt,
}
+\newif\ifbug \bugtrue % bug in hyperref?
\usepackage{hyperref}
% High resolution pk fonts for pdfTeX
\ifx\pdfpkresolution\undefined \else
\pdfpkresolution 600
\fi
+% For better formating
+\ifpdf
+\usepackage[protrusion=false,expansion=true,stretch=8,shrink=24,step=4]{microtype}
+\fi
-\newcommand{\moddate}{27 May 2006}
-\newcommand{\version}{2.14}
+\newcommand{\moddate}{31 December 2007}
+\newcommand{\version}{2.14.1}
\renewcommand{\headrulewidth}{0pt}
\setcounter{secnumdepth}{3}
\setcounter{tocdepth}{3}
\setlength{\columnseprule}{0pt}
\newcommand{\devnag}{Devan\=agar{\=\i}}
+\DeclareRobustCommand\babel{\textsf{babel}}
+\DeclareRobustCommand\XeTeX{X\kern-.125em\lower.5ex\hbox{\csname
+ reflectbox\endcsname{E}}\kern-.1667em\TeX}
+\DeclareRobustCommand\XeLaTeX{X\kern-.125em\lower.5ex\hbox{\csname
+ reflectbox\endcsname{E}}\LaTeX}
\def\diatop[#1|#2]{{\leavevmode\setbox1=\hbox{{#1{}}}\setbox2=\hbox{{#2{}}}%
\dimen0=\ifdim\wd1>\wd2\wd1\else\wd2\fi%
@@ -114,7 +128,7 @@ John Smith & \verb+jds10@cam.ac.uk+ \\
Anshuman Pandey & \verb+apandey@u.washington.edu+ \\
Dominik Wujastyk & \verb+d.wujastyk@ucl.ac.uk+ \\
%Fran\c{c}ois Patte & \verb+patte@math-info.univ-paris5.fr+ \\
-Zden\v{e}k Wagner & \verb+wagner@cesnet.cz+ \\
+Zden\v{e}k Wagner & \verb+zdenek.wagner@gmail.com+ \\
Kevin Carmody & \verb+i@kevincarmody.org+
\end{tabular}
\end{quote}
@@ -307,11 +321,6 @@ Table~\ref{chars}, or by \verb+~m+.
% \item \verb+~a+ produces an `English a' Marathi style. For example,
% Hindi {\dn V\4?sF} and Marathi {\dn V\<?sF}.
-\item Numerals are printed as Arabic numerals by default. The command
-\verb+\dnnum+ switches to \devnag{} numerals. Every numeral after this
-command is printed as a \devnag{} numeral. The command \verb+\cmnum+
-switches back to Arabic numerals.
-
\item In Hindi mode the character \verb+&+ can be put at the end of a
word to produce a \textit{vir\={a}ma} sign under the final consonant.
For example, \verb+pari.sad&+ produces {\dn pErq\qq{d}} . The underscore
@@ -705,6 +714,26 @@ the preprocessor will operate on \texttt{dharmak.setre} and \texttt{kuruk.setre}
but will ignore \verb+\font\zzz=dvng10 at 18pt+ because it occurs within the
\verb+<+ and \verb+>+ delimiters.
+\subsection{Embedding Roman Text within \devnag{} Text}
+
+The font commands \verb+\rsize+ (Plain \TeX{}) and \verb+\NormalFont+
+(\LaTeX{}) put Roman text within \devnag{} Text. This is useful in
+conjuction with the text protection delimiters \verb+<+ and \verb+>+.
+Examples:
+
+\begin{quote}
+Plain \TeX{}: \verb+{\dn naama {\rsize <John>}}+
+
+\LaTeX{}: \verb+{\dn naama {\NormalFont <John>}}+
+\end{quote}
+
+By default, Roman text using \verb+\rsize+ and \verb+\NormalFont+ is printed
+in a Computer Modern font whose size matches the current \devnag{} font.
+Non-\devnag{} punctuation marks, such as comma, question mark, and
+exclamation mark, and Arabic numerals are automatically printed in this font.
+To change this font, redefine the \verb+\rsize+ or \verb+\NormalFont+
+command.
+
\subsection{Breaking Pre-Defined Conjuncts}
The preprocessor will automatically produce predefined ligatures
from certain sequences of consonants. Placing the \texttt{+} character
@@ -1031,6 +1060,12 @@ You should therefore use \verb=\datemodernhindi= in documents processed with
\texttt{\char92 datemodernhindi}}\label{months}
\end{table}
+If you use \verb=\datehindi= or \verb=\datemodernhindi=, you can also use the
+macros \verb+\hindidatearabic+ and \verb+\hindidatedevanagari+ to control
+whether the day number in \verb+\today+ is printed in Arabic or \devnag{},
+respectively. The \verb+\hindidatedevanagari+ mode is the default. The macros
+\verb+\cmnum+ and \verb+\dnnum+ have no effect in this case.
+
The captions are similarly switched to Hindi by \verb=\captionshindi= or
\verb=\captionsmodernhindi=, respectively. Again the texts differ only in the
ligatures used. The captions for the modern Hindi variant are given in
@@ -1083,7 +1118,7 @@ they cause the \verb=\dn= command to switch the caption text and date format as
well. The date format and captions may be switched back by macros
\verb=\dateenglish=, \verb=\dateUSenglish=, and \verb=\captionsenglish=.
-\subsection{Customizing the date and captions}
+\subsection{Customizing the date and captions (\LaTeX{} only)}\label{customizing}
The user might prefer different caption texts. If just a few texts are to be
changed, they can simply be redefined in the main document, for instace by:
@@ -1095,8 +1130,8 @@ This redefinition must appear \textbf{after} \verb=\captionshindi= or
\verb=\captionsmodernhindi= was invoked.
It is also possible to change all definitions. The source texts in the Velthuis
-transliteration can be found in the \texttt{input} directory
-(\verb=$TEXMF/tex/latex/devanagr=) in file
+transliteration can be found in the \texttt{documentation} directory
+(\verb=$TEXMF/doc/generic/velthuis=) in file
\texttt{captions.dn} with some suggested variants in comments. You can either
put modified definitions to your main document (after \textsf{devanagari.sty}) or to a
package of your own. Remember that the preprocessor will not see your package,
@@ -1108,9 +1143,14 @@ the latter case you will have to rebuild the database by running
Do not put your packages to standard distribution directories. You may lose
them when upgrading your \TeX{} distribution.
-\renewcommand\thepage{{\dn\arabic{page}}}
+Customization of the captions texts is easier in the \babel\ module. The module is described in
+section~\ref{babel}.
-\subsection{Using \texorpdfstring{{\dn d\?vnAgrF}}{Devanagari} in Sections and References}
+\ifbug \else
+\renewcommand\thepage{\devanagari{page}}
+\fi
+
+\subsection{Using \texorpdfstring{{\dn d\?vnAgrF}}{Devanagari} in Sections and References (\LaTeX{} only)}
All macros necessary for typesetting \devnag{} text are robust. The
section/chapter titles as well as figure and table captions can contain
\devnag{} words. However, the font is changed to the standard document
@@ -1121,29 +1161,84 @@ correctly while \verb+{\dn\chapter{mis paal}}+ will always
create garbage text. Section numbers as well as page numbers will be
printed in Roman numerals.
-\subsection{\devnag{} Page Numbers}
-Changing page numbers to print \devnag{} numerals is possible by
-redefining the \verb+\thepage+ macro. This redefinition places the
-\verb+page+ counter in the scope of the \verb+\dn+ delimiter. However,
-note that \verb+\arabic{page}+ is enclosed within angle brackets. This
-is required because the preprocessor does not recognize the counter
-as a command. The pagination for this page till the end of Chapter~\ref{spec}
-occurs in \devnag{} through
-the following redefintion of \verb+\thepage+:
+\subsection{\devnag{} and Arabic Numerals}
+Except when they are represented by commands, numerals are printed as Arabic
+numerals by default. The command \verb+\dnnum+ switches to \devnag{}
+numerals. The command \verb+\cmnum+ switches back to Arabic numerals.
+
+Numerals represented by commands are printed as \devnag{} numerals by
+default. If you want to use \verb+\cmnum+ or \verb+\dnnum+ to control whether
+numerals within commands are printed as Arabic or \devnag{}, use the command
+\verb+\rn+ around the numeral command. If the command contains a mix of
+letters and numerals, you may need to redefine the command with \verb+\rn+
+around the numeral part.
+
+Without \verb+\rn+, numerals in commands are always printed as \devnag{},
+even if \verb+\cmnum+ is in effect. For example, in Plain \TeX{}, the macro
+\verb+\folio+ contains the current page number. To make this respect
+\verb+\cmnum+, use a command such as \verb+{\dn p.r.s.tha \rn{\folio}}+.
+\LaTeX{} users can use the techniques described in the next section.
+
+Arabic numerals are printed in the font specified by the commands
+\verb+\rsize+ (Plain \TeX{}) or \verb+\NormalFont+ (\LaTeX{}). This font is
+also used for non-\devnag{} punctuation marks. By default, this is a Computer
+Modern font whose size matches the current \devnag{} font. To change this
+font, redefine the \verb+\rsize+ or \verb+\NormalFont+ command.
+
+\subsection{\devnag{} Page Numbers and Other Counters (\LaTeX{} only)}
+Changing page numbers and other counters to print \devnag{} numerals is
+possible with the \verb+devanagari+ numeral style. Page numbers can be
+set to \devnag{} with the following declaration:
+
+\begin{quote}
+\verb+\pagenumbering{devanagari}+
+\end{quote}
+
+The default is \verb+\pagenumbering{arabic}+.
+
+You can use the command \verb+\devanagari+ as an alternative to
+\verb+\arabic+ to control the style of a counter anywhere in the document.
+For example, \verb+\devanagari{page}+ prints the current page number in
+\devnag{} numerals, while \verb+\arabic{page}+ prints it in Arabic numerals.
+
+You can change the automatic display of other counters to \devnag{} by
+redefinition macros. For example, to change section numbering to \devnag{},
+redefine \verb+\thesection+:
+
+\begin{quote}
+\verb+\renewcommand\thesection{\devanagari{section}}+
+\end{quote}
+
+The macros \verb+\cmnum+ and \verb+\dnnum+ have no effect on counters, unless
+you also use the command \verb+\rn+. To make page numbering respect the
+settings of \verb+\cmnum+ and \verb+\dnnum+, use \verb+\rn+ as follows:
\begin{quote}
-\verb+\renewcommand\thepage{{\dn<\arabic{page}>}}+
+\verb+\renewcommand\thepage{\dn p.r.s.tha \rn{\arabic{<page>}}}+
\end{quote}
-Other counters can be printed in \devnag{} by redefinition macros. For
-example, to change section numbering to \devnag{}, redefine
-\verb+\thesection+ in a manner similar to \verb+\thepage+ above, using
-the \verb+section+ counter instead of \verb+page+:
+Note that \verb+page+ is enclosed within angle brackets. This is required
+because it is within the scope of the \verb+\dn+ command, and the
+preprocessor does not recognize counter names as commands.
+
+\ifbug
+\devnag\ page numbering unfortunatelly conflicts with some versions of the \textsc{hyperref}
+package. The source of the problem has not be resolved yet. Use this feature with caution.
+\else
+The pagination for this page until the end of Chapter~\ref{spec} occurs in
+\devnag{} through the command
\begin{quote}
-\verb+\renewcommand\thesection{{\dn<\arabic{section}>}}+
+\verb+\renewcommand\thepage{\devanagari{page}}+
\end{quote}
+and is reset to Arabic through
+
+\begin{quote}
+\verb+\renewcommand\thepage{\arabic{page}}+
+\end{quote}
+\fi
+
\subsection{Category Codes}
\label{catcodes}
\TeX{} assigns a category code (\verb+\catcode+) to each character. For
@@ -1191,11 +1286,162 @@ properly by \verb+\dn+, you can use the \textsf{compat} option. The
macro \verb+\UnDevCatcodes+ changes catcodes back to the normal values
within the \verb+\dn+ environment.
-\clearpage % forced page break, remove it if the next section does not start
- % at the same page as the previous subsection
-\section{Vedic Macros}
+%\clearpage % forced page break, remove it if the next section does not start
+ % at the same page as the previous subsection
+\section{Using \texorpdfstring{\devnag}{Devanagari} in \texorpdfstring{\XeLaTeX}{XeLaTeX}}
+
+\renewcommand\thepage{\arabic{page}}
-\renewcommand\thepage{{\arabic{page}}}
+This topic does not fully fit here but it is described in this manual because the module for
+\babel, which is also included in this package, can be used both in the traditional \TeX\ and
+\XeTeX.
+
+Using \devnag\ in \XeTeX\ does not require any preprocessor. Instead you should use a Unicode
+Open\-Type font and enter \devnag\ directly in your text editor. You do not install such fonts for
+\XeTeX, it takes the fonts installed in your operating system. Open\-Type fonts can have different
+features, the most important of them is ``Script''. You have to specify ``Script=Devanagari'' when
+loading the font so that conjuncts are properly formed and i-matras are moved before the consonant.
+In \XeLaTeX\ (the \LaTeX\ format in \XeTeX) you can easily achieve it by:
+
+\medskip
+\begin{verbatim}
+\usepackage{fontspec}
+...
+\fontspec[Script=Devanagari]{fontname}
+\end{verbatim}
+
+\medskip \noindent
+Replace ``fontname'' with the name of the font. You can query the font name in your operating
+system. The \textsc{fontspec} package maps the standard \LaTeX\ font switching commands to the \XeTeX\
+primitives. Look into its manual for more details.
+
+Unicode assigns special codes to \devnag\ numerals. Automatically created number, e.\,g.\@ the page
+number created by \verb;\thepage;, will be printed in Arabic numerals. \XeTeX\ contains the TECkit
+library for mapping characters. If you specify (as another option in the square brackets of the font
+switching command) ``Mapping=devanagarinumerals'', all Arabic numerals will be automatically
+converted to the corresponding \devnag\ numerals.
+
+Although the text may be entered directly in \devnag, it may be useful to process the source text
+in the Velthuis \devnag\ by \XeLaTeX. This can also be achieved by TECkit remapping. Two mapping
+files are available: Mapping=velthuis-sanskrit and Mapping=velthuis. The latter is intended for
+Hindi. They differ in the only feature that the Sanskrit map will append a virama if the word ends
+in a consonant while the Hindi map will not. Both maps convert numerals too. These maps are still
+rather experimental. Examples of their usage can be found in files \texttt{xetex-misspaal.tex} and
+\texttt{xetex-examples.tex} which are distributed in the document directory of this package. Under
+the \textsc{texmf} tree their directory should be \verb;doc/generic/velthuis;.
+
+Remember that Velthuis transliteration employs the tilde character which normally denotes a
+nonbreakable space. If you want to utilise TECkit maps, you have to change its \verb;\catcode; to
+12 inside the \devnag\ text, otherwise words like {\dn Ev\3E2wApn} will be printed
+incorrectly.
+
+\section{Using Hindi with \babel}\label{babel}
+Since the \textsc{devnag} package version~2.14.1 a new module for \babel\ is released. This unifies
+the interface for multiligual documents where Hindi is one of the languages. The module is
+available for use both in traditional \LaTeX\ and \XeLaTeX. Usage in plain \TeX\ is not yet
+supported but the module should work in plain \XeTeX. Usage with the traditional \LaTeX\ does
+require the full \textsc{devnag} package. The module is built upon its macros as well as the
+preprocessor and fonts.
+
+\subsection{Installation}
+The Hindi module is not yet included in the standard \babel\ distribution, you have to install it
+yourself. Fortunatelly installation is quite simple. It s not necessary to plug \texttt{hindi.dtx},
+which you find in the documentation directory, to \babel\ and generate all files. Instead the
+relevant files have been generated for you and are installed automatically with this package. The
+only thing you have to do is to inform \LaTeX\ and \XeLaTeX\ that the Hindi module is available. It
+is done in the \texttt{language.dat} file. Since we have no hyphenation patterns for
+Hindi\footnote{Some time ago hyphenation patterns for Sanskrit for \XeLaTeX\ have been released on
+CTAN. Their usability for Hindi in \XeLaTeX\ should be evaluated.}, just append the following line
+to the end of the file:
+
+\medskip
+\begin{verbatim}
+hindi zerohyph.tex
+\end{verbatim}
+
+If you do not have permission to edit this file, you can make its copy in directory
+\verb;tex/generic/config; under \verb;texmf-var; which is usually world writable. Save the file and
+generate the formats. Unofficial but tested installation script can be found at
+\url{http://icebearsoft.euweb.cz/tex/csh_babel.php}.
+
+\subsection{Usage}
+If you want to use Hindi as a \babel\ module, put the following command into the preamble of your
+document:
+
+\medskip
+\begin{verbatim}
+\usepackage[hindi]{babel}
+\end{verbatim}
+
+\medskip
+Do not load \texttt{devanagari.sty}. The above mentioned syntax is valid both for \LaTeX\ and
+\XeLaTeX. The \babel\ module knows that \texttt{devanagari.sty} is required in \LaTeX\ and will
+load it automatically. Moreover, \babel\ will not work correctly with older version of the
+\textsc{devnag} package. It therefore employs version checking.
+
+You may enter more comma separated languages in the square brackets. The last language will be the
+default. You can then switch languages by standard \babel\ commands as
+\verb;\selectlanguage{hindi}; and
+
+\begin{verbatim}
+\begin{otherlanguage}{hindi}
+...
+\end{otherlanguage}
+\end{verbatim}
+
+\medskip
+If traditional \LaTeX\ is used, you must still insert the source text inside the \verb;{\dn };
+group, otherwise the preprocessor will not recognize it.
+
+\subsection{Language attributes}
+Package \texttt{devanagari/sty} can be loaded with some options. When using the \babel\ module this
+functionality is available only indirectly by specifying these options in the \verb;documentclass;
+declaration. This is not preferred because these options should not be treated as document
+properties. Instead these options were reimplemented as \babel\ language attributes. The attributes
+are selected by invoking:
+
+\begin{quote}
+\verb;\languageattribute{hindi}{;$\langle$\itshape list of attributes$\rangle$\verb;};
+\end{quote}
+
+The command must appear after loading \babel.
+
+\subsubsection{Attribute modernhindi}
+This attribute switches to the Modern Hindi captions. Remember that the preprocessor does not
+understand the language attributes and \babel\ cannot read the preprocessor directives. You must
+therefore correctly insert either \texttt{@hindi} or \texttt{@modernhindi} directive in addition to
+the language attribute. The attribute has no effect in \XeLaTeX\ because conjunct building is
+defined in the tables inside the Open\-Type font.
+
+\subsubsection{Font style attributes}
+The module implements attributes \texttt{bombay}, \texttt{calcutta}, \texttt{nepali}, \texttt{pen},
+\texttt{penbombay}, \texttt{pencalcutta}, \texttt{pennepali} that serve the same purpose of the
+package options with the same name. These attributes are connected with the Velthuis fonts and are
+thus unavailable in \XeLaTeX.
+
+\subsection{Customizing captions}
+The \babel\ module makes use of the same definitions of date and captions as shown in
+tables~\ref{months} and~\ref{captions}. Their redefinition within the framework of \babel\ is easy.
+Suppose that we want to change the title of Index to {\dn a\7{n}\387wmEZkA} as we did in
+section~\ref{customizing}. We achieve it by placing the following command to the preamble after
+loading \babel:
+
+\medskip
+\begin{verbatim}
+\addto\captionshindi{\def\indexname{{\dn anukrama.nikaa}}}
+\end{verbatim}
+
+\medskip
+The same can be done for \verb;\cationsmodernhindi;. Notice that the command will be seen by the
+preprocessor.
+
+If you want to do the same in \XeLaTeX, enter the changed text directly in Unicode:
+
+\medskip
+\verb;\addto\captionshindi{\def\indexname{;{\dn a\7{n}\387wmEZkA}\verb;}};
+
+
+\section{Vedic Macros}
These macros put Vedic intonation marks above and below individual
Devanagari letters and construct other characters generally used only in
@@ -1539,6 +1785,8 @@ Nepali (\texttt{dvpnn}) & {\dn \dnnum \large \dnpennepali a \31Bw C f l \rn{5}
\label{specs}
\end{table}
\newpage
+\thispagestyle{empty}
+\enlargethispage{\footskip}
\begin{table}[pt]
@@ -1585,6 +1833,20 @@ to eEXkA\2g n\? {\itshape pFW pkw kr} u\306wh\?{\qva} DFr\? s\?
\bigskip
\begin{center}
+Devanagari Nepali
+\end{center}
+
+{\dn \dnnepali b\7{h}t s\? CoV\? CoV\? rAjAao\2 kF bol cAl kA Y\2g
+BF{\rs ,\re} {\itshape Ejs smy v\? vA{}isrAy} s\? Emln\? aAe T\?{\rs ,\re}
+{\bfseries s\2"\?p k\? sAT} ElKn\? k\? yo`y h\4. koI to
+\8{d}r hF s\? {\itshape hAT jow\?} aAe{\rs ,\re} {\bfseries aOr do ek e\?s\?
+T\? Ek} jb eEXkA\2g k\? bdn {\bfseries \itshape \7{J}kAkr
+ifArA krn\?} pr BF u\306who{\qva} n\? {\bfseries slAm n EkyA}
+to eEXkA\2g n\? {\itshape pFW pkw kr} u\306wh\?{\qva} DFr\? s\?
+\7{J}kA EdyA.\par}
+\bigskip
+
+\begin{center}
Devanagari Pen Regular
\end{center}
diff --git a/Master/texmf-dist/doc/generic/velthuis/misspaal.dn b/Master/texmf-dist/doc/generic/velthuis/misspaal.dn
index b8970daba90..e327784ebfa 100644
--- a/Master/texmf-dist/doc/generic/velthuis/misspaal.dn
+++ b/Master/texmf-dist/doc/generic/velthuis/misspaal.dn
@@ -1,5 +1,5 @@
\documentclass[11pt]{article}
-\usepackage{dev}
+\usepackage{devanagari}
\def\portraitpage{%
\setlength{\topmargin}{-0.50in} % real margin == this + 1in
diff --git a/Master/texmf-dist/doc/generic/velthuis/misspaal.pdf b/Master/texmf-dist/doc/generic/velthuis/misspaal.pdf
index 9d533eae052..429c78a5258 100644
--- a/Master/texmf-dist/doc/generic/velthuis/misspaal.pdf
+++ b/Master/texmf-dist/doc/generic/velthuis/misspaal.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/xetex-examples.pdf b/Master/texmf-dist/doc/generic/velthuis/xetex-examples.pdf
new file mode 100644
index 00000000000..4735e644986
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/xetex-examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/xetex-examples.tex b/Master/texmf-dist/doc/generic/velthuis/xetex-examples.tex
new file mode 100644
index 00000000000..8149743f95a
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/xetex-examples.tex
@@ -0,0 +1,161 @@
+%% $Id: xetex-examples.tex,v 1.3 2008-03-12 19:41:03 icebearsoft Exp $
+% Requires font Nakula by John Smith,
+% see http://bombay.indology.info/software/fonts/devanagari/index.html
+\documentclass[12pt]{article}
+\usepackage{ifxetex}
+\RequireXeTeX
+\usepackage{fontspec}
+\newcommand\dn{\catcode`\~=12
+ \fontspec[Script=Devanagari,Mapping=velthuis-sanskrit]{Nakula}}
+
+\let\origlabelitemi\labelitemi
+\renewcommand\labelitemi{{\normalfont\origlabelitemi}}
+
+\parindent=0pt
+
+\begin{document}
+
+\section{Examples}
+
+{\dn
+\begin{center}
+\setlength{\fboxrule}{2pt}
+\framebox[3.2cm][s]{.o ga.ne"saaya nama.h}
+\end{center}
+}
+
+\verb+{\+{\tt dn}
+\begin{verbatim}
+\begin{center}
+\setlength{\fboxrule}{2pt}
+\framebox[4cm][s]{.o ga.ne"saaya nama.h}
+\end{center}
+}
+\end{verbatim}
+
+\hrule
+\medskip
+
+{\dn
+atha ga.nitapraarambhe.abhii.s.tadevataa.m namaskaroti|
+\begin{itemize}
+\setlength{\itemsep}{0mm}
+\item nanu pratyadhyaayamabhii.s.tadevataapra.natipratij~nota
+granthaarambhe k.rtanamaskaare.naabhii.s.tasiddhirbhavati|
+punari.s.tadevataanamaskaare.na ki.m saadhya.m|
+\item ucyate divya.m hyatiindriya.m j~naana.m ga.nita.m
+munibhirmata.m para.m brahmeva durj~neya.m vidyaanaamuttama.m
+tata.h| atho vidyottamatvaatpraarambhe.abhii.s.tadevataasmarana.m
+tathaa caadau madhye tathaa caante granthe kaarye.svapi
+sm.rta.m ma"ngalaacarana.m ce.s.tadevataapuujanaadi ca|
+\end{itemize}
+}
+
+\begin{verbatim}
+\documentclass[12pt]{article}
+\usepackage{fontspec}
+\newcommand\dn{\catcode`\~=12
+ \fontspec[Script=Devanagari,%
+ Mapping=velthuis-sanskrit]{Nakula}}
+\end{verbatim}
+%\vspace*{-.45cm}
+%\vspace*{-.40cm}
+%\begin{verbatim}
+\verb+\+\verb+begin{document}+ \\
+%\end{verbatim}
+%\vspace*{-.35cm}
+\verb+{\+{\tt dn}
+\begin{verbatim}
+atha ga.nitapraarambhe.abhii.s.tadevataa.m namaskaroti|
+\begin{itemize}
+\setlength{\itemsep}{0mm}
+\item nanu pratyadhyaayamabhii.s.tadevataapra.natipratij~nota
+granthaarambhe k.rtanamaskaare.naabhii.s.tasiddhirbhavati|
+punari.s.tadevataanamaskaare.na ki.m saadhya.m|
+\item ucyate divya.m hyatiindriya.m j~naana.m ga.nita.m
+munibhirmata.m para.m brahmeva durj~neya.m vidyaanaamuttama.m
+tata.h|
+atho vidyottamatvaatpraarambhe.abhii.s.tadevataasmarana.m
+tathaa caadau madhye tathaa caante granthe kaarye.svapi
+sm.rta.m ma"ngalaacarana.m ce.s.tadevataapuujanaadi ca|
+\end{itemize}
+}
+\end{verbatim}
+
+\hrule
+\medskip
+
+{\dn
+ata ubhayathaa smara.na.m yuktatara.m|
+\begin{verse}
+liilaagalalulallolakaalavyaalavilaasine|\\
+\hspace*{10mm} ga.ne"saaya namo niilakamalaamalakaantaye|| 12||
+\end{verse}
+}
+
+\verb+{\+{\tt dn}
+\begin{verbatim}
+ata ubhayathaa smara.na.m yuktatara.m|
+\begin{verse}
+liilaagalalulallolakaalavyaalavilaasine|\\
+\hspace*{10mm} ga.ne"saaya namo niilakamalaamalakaantaye|| 12||
+\end{verse}
+}
+\end{verbatim}
+
+\hrule
+\medskip
+
+{\dn \bfseries
+ata ubhayathaa smara.na.m yuktatara.m|
+}
+
+\verb+{\+{\tt dn}
+\begin{verbatim}
+ \bfseries ata ubhayathaa smara.na.m yuktatara.m|}
+\end{verbatim}
+
+\hrule
+\medskip
+
+{\dn \Large ata ubhayathaa smara.na.m yuktatara.m|}
+
+\verb+{\+{\tt dn}
+\begin{verbatim}
+ \Large ata ubhayathaa smara.na.m yuktatara.m|}
+\end{verbatim}
+
+\newpage
+\hrule
+\medskip
+
+{\dn
+"sriibhaaskaraacaaryaga.nita"saastrebhya udaahara.naani
+\begin{enumerate}
+\item liilavaatii
+\item biijaga.nita.m
+\item grahaga.nita.m
+\end{enumerate}
+}
+
+\verb+{\+{\tt dn}
+\begin{verbatim}
+"sriibhaaskaraacaaryaga.nita"saastrebhya udaahara.naani
+\begin{enumerate}
+\item liilavaatii
+\item biijaga.nita.m
+\item grahaga.nita.m
+\end{enumerate}
+}
+\end{verbatim}
+
+\hrule
+\medskip
+
+{\dn \centerline{.o tatsat}}
+
+\medskip
+\verb+{\dn \centerline{{.o tatsat}}+
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.pdf b/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.pdf
new file mode 100644
index 00000000000..ddd81ba576c
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.tex b/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.tex
new file mode 100644
index 00000000000..d47631f30ae
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/velthuis/xetex-misspaal.tex
@@ -0,0 +1,104 @@
+%% $Id: xetex-misspaal.tex,v 1.2 2007-07-17 11:52:00 icebearsoft Exp $
+% Requires font Gargi_1.7 which is often installed in Linux
+% see http://salrc.uchicago.edu/resources/fonts/available/hindi/
+% for Hindi, Marathi and Nepali fonts
+\documentclass[11pt]{article}
+\usepackage{ifxetex}
+\RequireXeTeX
+\usepackage{fontspec}
+\setmainfont[Script=Devanagari,Mapping=velthuis]{Gargi_1.7}
+
+\def\portraitpage{%
+ \setlength{\topmargin}{-0.50in} % real margin == this + 1in
+ \setlength{\oddsidemargin}{-0.0in} % real margin == this + 1in
+ \setlength{\evensidemargin}{-0.0in} % real margin == this + 1in
+ \setlength{\headsep}{-0.0in}
+ \setlength{\footskip}{-0.50in}
+
+ % Use Portrait Size Page
+ \setlength{\textwidth}{6.5in}
+ \setlength{\textheight}{9.75in}%
+}
+\portraitpage
+
+\begin{document}
+\pagestyle{empty}
+
+\catcode`\~=12 % Important for characters ~o and ~n !!!
+
+\begin{center}
+{\LARGE mis paal}
+\end{center}
+
+\begin{center}
+{\large mohan raake"s}
+\end{center}
+
+vah duur se dikhaayii detii aak.rti mis paal hii ho sakatii thii|
+phir bhii vi"svaas karane ke lie maiMne apanaa ca"smaa .thiik kiyaa|
+ni.hsaMdeh, vah mis paal hii thii| yah to khair mujhe pataa thaa ki
+vah un dinoM kulluu meM hii kahiiM rahatii hai, par is tarah acaanak usase
+bheM.t ho jaayegii, yah nahiiM socaa thaa| aur use saamane dekhakar bhii
+mujhe vi"svaas nahiiM huaa ki vah sthaayii ruup se kulluu aur manaalii
+ke biic us cho.te-se gaa/v meM rahatii hogii| jab vah dillii se naukarii
+choRakar aayii thii, to logoM ne usake baare meM kyaa-kyaa nahiiM socaa
+thaa!
+
+bas raayasan ke .daakakhaane ke paas pahuMcakar ruk gayii| mis paal
+.daakakhaane ke baahar khaRii pos.tamaas.tar se kuch baat kar rahii thii|
+haath meM vah ek thailaa liye thii| bas ke rukane par na jaane kis baat ke
+lie pos.tamaas.tar ko dhanyavaad detii huii vah bas kii taraph muRii|
+tabhii maiM utarakar usake saamane pahu/c gayaa| ek aadamii ke acaanak
+saamane aa jaane se mis paal thoRaa acakacaa gayii, magar mujhe pahacaanate
+hii usakaa ceharaa khu"sii aur utsaah se khil gayaa|
+
+``ra.najiit tum?'' usane kahaa, ``tum yahaa/ se .tapak paRe?''
+
+``maiM is bas se manaalii se aa rahaa huu/|'' maiMne kahaa|
+
+``acchaa! manaalii tum kab se aaye hue the?''
+
+``aa.th-das din hue, aayaa thaa| aaj vaapas jaa rahaa huu/|''
+
+``aaj hii jaa rahe ho?'' mis paal ke cehare se aadhaa utsaah gaayab ho
+gayaa, ``dekho, kitanii burii baat hai ki aa.th-das din se tum yahaa/
+ho aur mujhase milane kii tumane ko"si"s bhii nahiiM kii| tumheM yah to
+pataa hii thaa ki maiM aajakal kulluu meM huu/|''
+
+``haa/, yah to pataa thaa, par yah nahiiM pataa thaa ki kulluu ke kis
+hisse meM ho| ab bhii tum acaanak hii dikhaayii de gayiiM, nahiiM
+mujhe kahaa/ se pataa calataa ki tum is jaMgal ko aabaad kar rahii ho?''
+
+``sacamuc bahut burii baat hai,'' mis paal ulaahane ke svar meM bolii,
+``tum itane dinoM se yahaa/ ho aur mujhase tumhaarii bheM.t huii aaj
+jaane ke vaqt@@@|''
+
+.draaivar jor-jor se h~orn bajaane lagaa| mis paal ne kuch ciRhakar
+.draaivar kii taraf dekhaa aur ekasaath jhiRakane k.samaa maa/gane
+ke svar meM kahaa, ``bas jii ek mina.t| maiM bhii isii bas se kulluu
+cal rahii huu/| mujhe kulluu kii ek sii.t de diijie| thaiMk yuu verii
+mac!'' aur phir merii taraf muRakar bolii, ``tum is bas se kahaa/ tak
+jaa rahe ho?''
+
+``aaj to is bas se jogindaranagar jaauu/gaa| vahaa/ ek din rahakar kal
+subah aage kii bas pakaRuu/gaa|''
+
+.draaivar ab aur jor se h~orn bajaane lagaa| mis paal ne ek baar krodh
+aur bebasii ke saath usakii taraf dekhaa aur bas ke daravaaze kii
+taraf baRhatii huii bolii, ``acchaa, kulluu tak to ham logoM kaa saath
+hai hii, aur baat kulluu pahu/cakar kareMge| maiM to kahatii huu/ ki
+tum do-caar din yahiiM ruko, phir cale jaanaa|''
+
+bas meM pahale hii bahut bhiiR thii| do-tiin aadamii vahaa/ se aur caRh
+gaye the, jisase andar khaRe hone kii jagah bhii nahiiM rahii thii|
+mis paal daravaaze se andar jaane lagii to ka.n.dak.tar ne haath
+baRhaakar use rok diyaa| maiMne ka.n.dak.tar se bahuteraa kahaa ki
+andar mere vaalii jagah khaalii hai, mis saahab vahaa/ bai.th
+jaaeMgii aur maiM bhiiR meM kisii tarah khaRaa hokar calaa jaauu/gaa,
+magar ka.n.dak.tar ek baar jid par aRaa to aRaa hii rahaa ki aur
+savaarii vah nahiiM le sakataa| maiM abhii usase baat kar hii rahaa
+thaa ki .draaivar ne bas s.taar.t kar dii| meraa saamaan bas meM thaa,
+isalie maiM dauRakar calatii bas meM savaar ho gayaa| {\rm\ldots{}}\par
+
+\end{document}
+