doc/latex

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

1 files changed, 1038 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/montex/mlsquick.tex b/Master/texmf-dist/doc/latex/montex/mlsquick.tex
new file mode 100644
index 00000000000..21fd6208f70
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/montex/mlsquick.tex
@@ -0,0 +1,1038 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%        File: mlsquick.tex
+%      Author: Oliver Corff
+%        Date: \VersionDate November 1st, 2001
+%     Version: \VersionRelease
+%   Copyright: Ulaanbaatar, Beijing, Berlin
+%
+% Description: MonTeX -- Mongolian for LaTeX2e
+%              Implementation Level \ImplementationLevel
+%              System Documentation
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% ----------------- identification ends here -------------------
+%
+\documentclass[11pt,a4paper]{article}
+\usepackage{longtable}
+\IfFileExists{ctib}{%
+	\usepackage{ctib}
+}{}
+\usepackage[latin1]{mls}
+\input{mtdocmac.tex}
+%\usepackage{pslatex}
+\usepackage{hyperref}
+\begin{document}
+\title{\MonTeX\\A Quick Guide\\(\emph{Draft})}
+\author{Oliver Corff}
+\maketitle
+\tableofcontents
+\section{General Settings}
+In order to access the commands of \MonTeX\ the package must be
+loaded in the document preamble by saying
+
+\begin{verbatim}
+\usepackage[<language options>,<encoding options>]{mls}
+\end{verbatim}
+
+The options include choices for the basic document language and
+input encodings.
+
+\subsubsection{Document Language}
+
+The document language can be set with one of
+	\verb"bicig",
+	\verb"bithe",
+	\verb"buryat",
+	\verb"english",
+	\verb"russian" or
+	\verb"xalx"
+like in
+\begin{verbatim}
+\usepackage[xalx]{mls}
+\end{verbatim}
+which issues all captions and the date in Modern Mongolian.
+
+The options \refcmda{bicig} and \refcmda{bithe} are introduced 
+in part~\ref{BicigandBithe}, ``Full Vertical Text Pages''.
+
+The options \cmda{buryat}, \cmda{russian} and \cmda{xalx}
+	produce captions in Buryat, Russian and Modern Mongolian.
+
+\begin{center}
+	\begin{tabular}{ll}
+	    \textbf{Buryat}	&\BuryatToday\\\label{BuryatToday}
+	    \textbf{Xalx}	&\XalxToday\\\label{XalxToday}
+	    \textbf{Russian}	&\RussianToday\\\label{RussianToday}
+	\end{tabular}
+\end{center}
+
+
+The option
+\cmda{english}, at least as a \verb"\usepackage" option, is
+essentially a do-nothing: it sets captions to English (which is
+the default of this package anyway).
+\section{Cyrillic Text -- \xalx{Kirill "us"ag}}
+
+\subsection{Cyrillic Text in Transliteration (\LMC) Mode%
+	\label{section:CyrillicTransliterationMode}}
+
+\MonTeX\ provides two basic modes of operation: in
+\begin{itemize}\label{SetDocumentEncoding}
+	\item Transliteration Mode (intimately linked to the \LMC\
+		encoding) all incoming text is regarded as
+		transliterated Cyrillic. This allows users to
+		compose Cyrillic documents on pure ASCII machines.
+		In contrast, the
+	\item Immediate Mode does nothing and waits for explicit
+		Cyrillic characters in the input in order to generate
+		Cyrillic output.
+\end{itemize}
+Two commands are used to switch between these modes:
+\begin{quote}
+\begin{verbatim}
+\SetDocumentEncodingLMC
+\SetDocumentEncodingNeutral
+\end{verbatim}
+\end{quote}
+
+The first command switches to Transliteration Mode, the second
+command deactivates the transliteration and thus, by definition,
+activates Immediate Mode.
+
+In the \LMC\ encoding, most Cyrillic characters are mapped directly to
+a single Latin character but for some characters there is a text
+command which became necessary since there are more Cyrillic than
+Latin characters. For convenience, a few ligatures were defined, too.
+Details are given in table~\ref{cyralpha}.
+
+\begin{table}
+\begin{center}
+\begin{tabular}{|r|cc|cc|ll|}
+\hline
+%\multicolumn{7}{|c|}{Cyrillic Alphabet Input Methods} \\\hline
+   &\multicolumn{2}{|c|}{Cyrillic Letter}&\multicolumn{2}{|c|}{\LMC\
+Input}&\multicolumn{2}{|c|}{Generic Command}\\\hline
+ 1 &\mnr A &\mnr a &\verb"A" &\verb"a" &\verb"\CYRA" &\verb"\cyra" \\\hline
+ 
+ 2 &\mnr B &\mnr b &\verb"B" &\verb"b" &\verb"\CYRB" &\verb"\cyrb" \\\hline
+ 
+ 3 &\mnr W &\mnr w &\verb"W" &\verb"w" &\verb"\CYRV" &\verb"\cyrw" \\\hline
+ 
+ 4 &\mnr G &\mnr g &\verb"G" &\verb"g" &\verb"\CYRG" &\verb"\cyrg" \\\hline
+ 
+ 5 &\mnr D &\mnr d &\verb"D" &\verb"d" &\verb"\CYRD" &\verb"\cyrd" \\\hline
+ 
+ 6 &\mnr E &\mnr e &\verb"E" &\verb"e" &\verb"\CYRE"&\verb"\cyre" \\\hline
+ 
+ 7 &\CYRYO &\cyryo &\texttt{\"E}/\verb'"E'&\texttt{\"e}/\verb'"e'&%
+ 			\verb"\CYRYO"&\verb"\cyryo"\rule{0mm}{2.25ex}\\ 
+   &       &       &\{\verb"\"\}\verb"YO"&\{\verb"\"\}\verb"yo"&  & \\\hline
+
+ 8 &\mnr J &\mnr j &\verb"J" &\verb"j" &\verb"\CYRZH" &\verb"\cyrzh" \\\hline
+ 
+ 9 &\mnr Z &\mnr z &\verb"Z" &\verb"z" &\verb"\CYRZ" &\verb"\cyrz" \\\hline
+
+10 &\mnr I &\mnr i &\verb"I" &\verb"i" &\verb"\CYRI" &\verb"\cyri" \\\hline
+
+11 &\CYRISHRT &\cyrishrt &\texttt{\"I}/\verb'"I'&\texttt{\"i}/\verb'"i'&%
+			\verb"\CYRISHRT"&\verb"\cyrishrt"\rule{0mm}{2.25ex} \\
+   &       &       &\{\verb"\"\}\verb"YI"&\{\verb"\"\}\verb"yi"&  & \\\hline
+
+12 &\mnr K &\mnr k &\verb"K" &\verb"k" &\verb"\CYRK" &\verb"\cyrk" \\\hline
+
+13 &\mnr L &\mnr l &\verb"L" &\verb"l" &\verb"\CYRL" &\verb"\cyrl" \\\hline
+
+14 &\mnr M &\mnr m &\verb"M" &\verb"m" &\verb"\CYRM" &\verb"\cyrm" \\\hline
+
+15 &\mnr N &\mnr n &\verb"N" &\verb"n" &\verb"\CYRN" &\verb"\cyrn" \\\hline
+
+16 &\mnr O &\mnr o &\verb"O" &\verb"o" &\verb"\CYRO" &\verb"\cyro" \\\hline
+
+17 &\CYROTLD &\cyrotld &\texttt{\"O}/\verb'"O'&\texttt{\"o}/\verb'"o'&%
+			\verb"\CYROTLD"&\verb"\cyrotld" \rule{0mm}{2.25ex}\\\hline
+
+18 &\mnr P &\mnr p &\verb"P" &\verb"p" &\verb"\CYRP" &\verb"\cyrp" \\\hline
+
+19 &\mnr R &\mnr r &\verb"R" &\verb"r" &\verb"\CYRR" &\verb"\cyrr" \\\hline
+
+20 &\mnr S &\mnr s &\verb"S" &\verb"s" &\verb"\CYRS" &\verb"\cyrs" \\\hline
+
+21 &\mnr T &\mnr t &\verb"T" &\verb"t" &\verb"\CYRT" &\verb"\cyrt" \\\hline
+
+22 &\mnr U &\mnr u &\verb"U" &\verb"u" &\verb"\CYRU" &\verb"\cyru" \\\hline
+
+23 &\mnr "U &\mnr "u &\texttt{\"U}/\verb'"U'&\texttt{\"u}/\verb'"u'&%
+			\verb"\CYRY"&\verb"\cyry" \rule{0mm}{2.25ex}\\\hline
+
+24 &\mnr F &\mnr f &\verb"F" &\verb"f" &\verb"\CYRF" &\verb"\cyrf" \\\hline
+
+25 &\mnr X &\mnr x &\verb"X" &\verb"x" &\verb"\CYRH" &\verb"\cyrh" \\\hline
+
+26 &\mnr H &\mnr h &\verb"H" &\verb"h" &\verb"\CYRHSHA" &\verb"cyrhsha" \\\hline
+
+27 &\mnr C &\mnr c &\verb"C" &\verb"c" &\verb"\CYRC" &\verb"\cyrc" \\\hline
+
+28 &\mnr Q &\mnr q &\verb"Q" &\verb"q" &\verb"\CYRCH" &\verb"\cyrch" \\
+   &       &       &\verb"\Ch"&\verb"\ch"&           &             \\\hline
+
+29 &\mnr\Sh&\mnr\sh&\verb"\Sh"&\verb"\sh"&\verb"\CYRSH"&\verb"\cyrsh"\\
+   &       &       &          &\verb"sh" &             &             \\\hline
+
+30 &\mnr\Sc&\mnr\sc&\verb"\Sc"&\verb"\sc"&\verb"\CYRSHCH"&\verb"\cyrshch"\\
+   &       &       &\verb"\Qh"&\verb"\qh"&             &             \\\hline
+
+31 &\mnr \CYRHRDSN &\mnr \cyrsftsn &\verb"\Y" &\verb"\y" &%
+			\verb"\CYRHRDSN" &\verb"\cyrhrdsn" \\\hline
+
+32 &\mnr Y &\mnr y &\verb"Y" &\verb"y" &\verb"\CYRERY" &\verb"\cyrery" \\\hline
+
+33 &\mnr \CYRSFTSN &\mnr \cyrsftsn &\verb"\I" &\verb"\i" &%
+			\verb"\CYRSFTSN" &\verb"\cyrsftsn" \\\hline
+
+34 &\CYREREV &\cyrerev &\texttt{\"A}/\verb'"A'&\texttt{\"a}/\verb'"a'&%
+			\verb"\CYREREV"&\verb"\cyrerev" \rule{0mm}{2.25ex}\\\hline
+
+35 &\mnr YU&\mnr yu&\{\verb"\"\}\verb"YU"&\{\verb"\"\}\verb"yu"&%
+			\verb"\CYRYU"&\verb"\cyryu"\\\hline
+
+36 &\mnr YA&\mnr ya&\{\verb"\"\}\verb"YA"&\{\verb"\"\}\verb"ya"&%
+			\verb"\CYRYA"&\verb"\cyrya"\\\hline
+\end{tabular}
+\caption{Cyrillic Alphabet Input Methods\label{cyralpha}}
+\end{center}
+\end{table}
+
+Front vowels can be entered directly using the encoding slot of a
+valid and active input encoding, or they can be expressed via an
+abbreviated \verb'"'\emph{v} notation where \emph{v} stands for any
+desired vowel. In the \LMC\ encoding used by \MonTeX, \verb'"' is not
+an active character; selecting the proper letter is done by ligature
+statements in the Metafont sources.
+ 
+Some letters can be entered with or without a preceding \verb"\",
+like \cyryu\ and \cyrya. Both \verb"\yu" and \verb"yu" will produce
+a \cyryu. While \verb"yu" is interpreted as a ligature, \verb"\yu"
+allows for the character \cyryu\ to be combined with accents.
+Accents are not commonly used in Mongolian since there are precise
+rules for word stress. This feature is taken from the \textsf{OT2} encoding 
+and is included mainly for the sake of completeness, convenience and
+compatibility\footnote{The magic triple-C!}.
+
+Here now a sample of Mongolian text:
+\exa
+	{\mnr<<Xalxyn gurwan "ond"or>> 
+	x"am"a"an aldarshsan, Z"u"un xyazgaaryg
+	toxinuulax sa"id N.~Dugarjaw ardyn
+	xuw\i sgalyn b"u"ur "ax"an "ue"as
+	xamgi"in "agz"agt"a"i am\i\ d"u"is"an
+	alband tomilogdox c"ar"ag da"iny olon
+	quxal daalgawryg xiq"a"ang"u"il"an
+	biel"u"ulj yawsan t"u"uxt"a"i x"un.}
+\exb
+\begin{verbatim}
+	{\mnr<<Xalxyn gurwan "ond"or>> 
+	x"am"a"an aldarshsan, Z"u"un xyazgaaryg
+	toxinuulax sa"id N.~Dugarjaw ardyn
+	xuw\i sgalyn b"u"ur "ax"an "ue"as
+	xamgi"in "agz"agt"a"i am\i\ d"u"is"an
+	alband tomilogdox c"ar"ag da"iny olon
+	quxal daalgawryg xiq"a"ang"u"il"an
+	biel"u"ulj yawsan t"u"uxt"a"i x"un.}
+\end{verbatim}
+\exc
+
+\subsection{Shorthands for embedding words in a different
+		typeface}\label{typefacecapsules}
+
+Sometimes it may be necessary to give short portions of text not
+only in a different encoding (for which the \cmd{lat}\verb:{...}:
+and \cmd{mnr}\verb:{...}: commands are
+useful) but it may also be necessary to switch the typeface
+temporarily. Usually capsules using \verb'\text'\emph{xx} do the
+work if only the typeface is concerned, and building nested commands
+like \verb'\textsf{\lat{...}}' is cumbersome if these changes have
+to be applied very often. \MonTeX\ provides an abbreviated style
+following the rule 
+\begin{quote}
+	\texttt{[k|l]}\emph{two letter font style code}\verb'{...}'
+\end{quote}
+where the font style code is one of
+	\verb'rm',
+	\verb'bf',
+	\verb'it',
+	\verb'sl',
+	\verb'sf',
+	\verb'sc' and
+	\verb'tt',
+like \verb'\ksl{...}', \verb'\lsc{...}', etc.
+
+
+\subsection{Shorthands for writing transliterated texts}
+
+\MonTeX\ provides shortcuts for writing certain accented symbols
+used in conventional transliterating of Mongolian by 
+haceks, the nasal and the gamma. These shortcuts are essentially
+mnemonics replacing the somewhat more tedious accent notation (see
+table~\ref{shortcuts}).
+
+\begin{table}
+\begin{center}\begin{tabular}{ll|ll}
+%\hline
+Letter	& Input 	& Letter	& Input \\
+	&		&		&\\
+\hline
+	&		&		&\\
+\ch 	& \verb"\ch"	& \Ch		& \verb"\Ch" \\
+\jh 	& \verb"\jh"	& \Jh		& \verb"\Jh" \\
+\sh 	& \verb"\sh"	& \Sh		& \verb"\Sh" \\
+\zh 	& \verb"\zh"	& \Zh		& \verb"\Zh" \\
+\ng 	& \verb"\ng"	& \Ng		& \verb"\Ng" \\
+\g	& \verb"\g"	& \G		& \verb"\G" \\
+%\hline
+\end{tabular}\end{center}
+\caption{Shortcuts for Mongolian Transliteration Symbols\label{shortcuts}}
+\end{table}
+
+It must be observed that these commands are by default dependent on
+the environment they are used in. \verb"\Sh" yields a \Sh\ when used
+in a Latin environment but results in a \mnr\Sh\rnm\ when used in a
+Cyrillic context\footnote{The authors wish to thank J.~Knappen for
+resolving one instability in the original code for these letters.}:
+
+\exa
+	\emph{\Sh agdar} and \emph{\Ch adraa}
+	are transliterations for
+	{\mnr\Sh agdar} and {\mnr\Ch adraa}.
+\exb
+	\begin{verbatim}
+	\emph{\Sh agdar} and \emph{\Ch adraa}
+	are transliterations for
+	{\mnr\Sh agdar} and {\mnr\Ch adraa}.
+	\end{verbatim}
+\exc
+
+
+\section{Uighur Mongolian and Manju Input}
+
+A comprehensive table of the Mongolian alphabet and its MLS
+transliteration, the input conventions of the MLS transliteration in
+\MonTeX\ and the Simplified Transliteration is given in
+table~\ref{table:bcgcagan}.
+
+\newcommand{\bcgcagan}[4]{%
+	\mbosoo{#1}	& \texttt{#2}	& \texttt{#3}	& \texttt{#4}	%\\
+	}
+
+\begin{table}[h]
+\begin{center}
+\begin{tabular}{cccc|cccc}
+%\hline
+Uighur&\multicolumn{2}{c}{MLS} &Simplified
+				&Uighur&\multicolumn{2}{c}{MLS}&Simplified\\
+Script&Transl.& Input	 &Input     &Script&Transl.& Input&Input\\
+\hline
+\bcgcagan{a}{a}{a}{a}		& \bcgcagan{s}{s}{s}{s} \\
+\bcgcagan{E}{\"a}{\"a, E}{e}	& \bcgcagan{S}{sh}{S}{sh}\\
+\bcgcagan{e}{e}{e}{v}		& \bcgcagan{t}{t}{t}{t}	 \\
+\bcgcagan{i}{i}{i}{i}		& \bcgcagan{d}{d}{d}{d, t}\\
+\bcgcagan{o}{o}{o}{u}		& \bcgcagan{l}{l}{l}{l}	\\
+\bcgcagan{u}{u}{u}{u}		& \bcgcagan{m}{m}{m}{m}	\\
+\bcgcagan{O}{\"o}{\"o, O}{ui, u}& \bcgcagan{c}{c}{c}{c}	\\
+\bcgcagan{U}{\"u}{\"u, U}{ui, u}& \bcgcagan{z}{z}{z}{z}	\\
+\bcgcagan{n}{n}{n}{n}		& \bcgcagan{y}{y}{y}{y}	\\
+\bcgcagan{|ng}{*ng}{ng}{ng}	& \bcgcagan{r}{r}{r}{r}	\\
+\bcgcagan{x}{x}{x}{x}		& \bcgcagan{v}{v}{v}{v}	\\
+\bcgcagan{G}{\g}{G}{g}		& \bcgcagan{h}{h}{h}{h}	\\
+\bcgcagan{k}{k}{k}{k}		& \bcgcagan{j}{j}{j}{j}	\\
+\bcgcagan{g}{g}{g}{g, k}	& \bcgcagan{K}{K}{K}{K}	\\
+\bcgcagan{b}{b}{b}{b}		& \bcgcagan{Q}{[--]}{Q}{q}\\
+\bcgcagan{p}{p}{p}{p}		& \bcgcagan{C}{C}{C}{C}	\\
+\bcgcagan{f}{f}{f}{f}		& \bcgcagan{Z}{Z}{Z}{Z}	\\
+%\hline
+\end{tabular}
+\end{center}
+\caption{Mongolian Script Transliterations\label{table:bcgcagan}}
+\end{table}
+
+The possible combinations of Mongolian writing input methods
+and display commands are listed in table~\ref{table:Combinations}.
+The columns stand for each possible input encoding, the rows contain
+the display command types. Each table cell at the contains the command
+that is available for a given combination of input method and
+command.
+
+\newcommand{\ComparisonTable}[4]{%
+	#1 &%			% Command Type
+	#2 &%			% MLS Command
+	#3 &%			% Simplified Command
+	#4 \\%			% Manju Command
+}
+\begin{table}[h]
+\begin{center}
+\begin{tabular}{p{2cm}|p{3.25cm}|p{3.25cm}|p{3.25cm}}
+Command		& \multicolumn{2}{c|}{Mongolian}& Manju	\\
+Type		& MLS		& Simplified	&	\\
+\hline
+\ComparisonTable{Document Encoding}
+		{only available as font encoding \LMS, not as
+		document encoding}
+		{\texttt{LMO}}
+		{\texttt{LMA}}
+\hline
+\ComparisonTable{Horizontal Capsules}
+		{\refcmd{bcg}}
+		{\refcmd{bicig}}
+		{\refcmd{bithe}}
+\hline
+\ComparisonTable{Horizontal Paragraphs}
+		{not available}
+		{\refcmda{bicigtext}}
+		{\refcmda{bithetext}}
+\hline
+\ComparisonTable{Vertical Capsules}
+		{\refcmd{mbosoo}}
+		{\refcmd{mobosoo}}
+		{\refcmd{mabosoo}}
+\hline
+\ComparisonTable{Vertical Paragraph Boxes}
+		{not available}
+		{\refcmd{mobox}}
+		{\refcmd{mabox}}
+\hline
+\ComparisonTable{Vertical Pages}
+		{not available}
+		{\refcmda{bicigpage}}
+		{\refcmda{bithepage}}
+%\hline
+\end{tabular}
+\caption{Mongolian Input and Display Commands\label{table:Combinations}}
+\end{center}
+\end{table}
+
+While the input method for the majority of characters matches the
+transliteration conventions, some letters require a slightly
+different treatment:
+\begin{enumerate}
+	\item	Although the diphtong \mobosoo{*aii*} is usually
+		rendered as \textit{ayi}, it must be entered
+		as \texttt{aii} in order to produce the desired
+		effect.
+	
+	\item	The back vowels \emph{o} and \emph{u} are both rendered
+		as \texttt{u}.
+
+	\item	The front vowels \emph{\"o} and \emph{\"u} are both
+		rendered as \texttt{ui} in first syllables and as
+		\texttt{u} in later syllables.
+
+	\item	Since \mobosoo{t} means both \emph{t} and \emph{d},
+		it is necessary to spell this letter as \texttt{t}
+		in the beginning of words, and \texttt{d} in the
+		middle of words, regardless of the actual meaning.
+
+	\item	The four consonants \emph{\g}, \emph{g}, \emph{x}
+		and \emph{k} are constrained with regard to the
+		following vowels. The Simplified Transliteration
+		renders these as \texttt{g} (before \emph{a}
+		and \emph{u} only), \texttt{g} (before \emph{a}
+		and \emph{u} only), \texttt{x} and \texttt{k}.
+\end{enumerate}
+
+
+As it was demonstrated in subsection~\ref{section:CyrillicTransliterationMode},
+it is technically possible to choose between an automatic document encoding
+and the neutral mode. In the case of Uighur Mongolian, the mode of choice
+activates the Simplified Transliteration Mode and is called with 
+\begin{quote}
+\begin{verbatim}
+\SetDocumentEncodingBicig
+\end{verbatim}
+\end{quote}
+
+
+With
+\verb"\SetDocumentEncodingBicig"\label{cmd:SetDocumentEncodingBicig} set,
+it is possible to switch to the Simplified Transliteration Mode anywhere
+in the document, not only in the preamble.
+
+\textit{Caveat:} Since switching to Uighur Mongolian text
+requires a lot of settings to be effected at the same time, there
+are high-level commands available (see below all kinds of  Mongolian
+and Manju Display Commands) which do all the work, including the definition of the
+document encoding. Thus, while \verb|\SetDocumentEncodingBicig|
+is indeed classified as a user-level command, it is certainly not
+necessary for everyday work.
+
+
+\subsection{Character Variants}
+
+With the assistance of special, non-printing characters like the
+Form Variant Selectors, the appearance of certain characters can be
+modified in order to display typographical and orthographical
+variants. Notably, the \emph{n} will loose its dot before vowels,
+as will \emph{\g}. Let's assume the word ``place'' is written in an
+old book as \bicig{g'azar}. It should be understood that this is a
+variant of \bicig{gazar} and should be spelled \emph{\g'azar}, not
+\emph{xazar}. With vowels, the Form Variant Selectors can change the
+shape that is usually required by graphical context. At present,
+only the first of two Form Variant Selectors actually does
+something, the exact behaviour of the second Form Variant Selector
+waits to be implemented.
+
+The following short example shows a concrete application of this
+method. It renders the six syllable mantra \emph{om ma ni padme hum}
+(tib.  {\tib \om, ma nxi pa\V{de}{ma} \hung}) as it is
+displayed on a huge bronze incense burner in front of the Gandan
+Monastery in Ulaanbaatar:
+
+\exa
+	\mobox{3cm}{\noindent\sffamily
+	\om	uva\\
+	\  	ma'=a\\
+	\  	n'i\\
+	\  	badmi'\\
+	\om	huu}
+\exb
+	\begin{verbatim}
+	\mobox{3cm}{\noindent\sffamily
+	\om	uva\\
+	\ 	ma'=a\\
+	\ 	n'i\\
+	\ 	badmi'\\
+	\om	huu}
+	\end{verbatim}
+\exc
+	
+\subsection{Special Characters\label{section:SpecialMLSCharacters}}
+
+For the correct operation of retransliterating systems processing
+Mongolian script additional symbols are needed. These include
+Form Variant Selectors (\textsf{FVS}), the Vowel Separator, and
+other symbols like the Mongolian Positional Indicator. As can be
+seen from its usage in table~\ref{table:bcgcagan}, entering \verb|*ng|
+tells the system to consider this \emph{ng} to be in non-initial
+position.\footnote{Unfortunately, though it is now commonly
+agreed in the scientific community that these symbols are needed,
+their definition is still in a state of flux, and thus the symbols
+given here are presented on a preliminary basis.}
+
+Besides these symbols, table~\ref{table:SpecialMLSCharacters} includes
+also some useful punctuation marks etc.\ as they are used in
+Mongolian Script.
+
+\begin{table}
+\begin{center}
+\begin{tabular}{c|l|l}
+%\hline
+ Symbol		& Name			& Input		\\
+ \hline
+  \bosoo{\glyphbcg{!}}	& Exclamation Mark	& \verb|!|	\\
+  \bosoo{\glyphbcg{?}}	& Question Mark		& \verb|?|	\\
+  \bosoo{\glyphbcg{!?}}	& Exclamation Question Mark& \verb|!?|	\\
+  \bosoo{\glyphbcg{?!}}	& Question Exclamation Mark& \verb|?!|	\\
+  \bosoo{\glyphbcg{*}}	& Mong. Positional Indicator& \verb|*|	\\
+  \bosoo{\glyphbcg{\char32}}	& Mongolian Space	& \verb*|-|	\\
+  \bosoo{\glyphbcg{(}}	& Opening Bracket	& \verb|(|	\\
+  \bosoo{\glyphbcg{)}}	& Closing Bracket	& \verb|)|	\\
+  \bosoo{\glyphbcg{<}}	& Opening Angle Bracket	& \verb|<|	\\
+  \bosoo{\glyphbcg{>}}	& Closing Angle Bracket	& \verb|>|	\\
+  \bosoo{\glyphbcg{<<}}	& Opening Guillemot	& \verb|<<|	\\
+  \bosoo{\glyphbcg{>>}}	& Closing Guillemot	& \verb|>>|	\\
+% \bosoo{\glyphbcg{\{}}	& Opening Parenthesis	& \verb|{|	\\
+% \bosoo{\glyphbcg{\}}}	& Closing Parenthesis	& \verb|}|	\\
+  \bosoo{\glyphbcg{'}}	& Form Variant Selector 1& \verb|'|	\\
+  \bosoo{\glyphbcg{"}}	& Form Variant Selector 2& \verb|"|	\\
+  \bosoo{\glyphbcg{\char43}}& Mong. Vowel Separator	& \verb|=|	\\
+  \bosoo{\glyphbcg{|}}	& Mongolian Nuruu	& \verb'|'	\\
+  \bosoo{\glyphbcg{.}}	& Period		& \verb|.|	\\
+  \bosoo{\glyphbcg{,}}	& Comma			& \verb|,|	\\
+  \bosoo{\glyphbcg{:}}	& Colon			& \verb|:|	\\
+  \bosoo{\glyphbcg{;}}	& D\"orw\"oljin		& \verb|;|	\\
+  \bosoo{\glyphbcg{..}}	& Ellipsis		& \verb|..|	\\
+  \bosoo{\glyphbcg{0}}	& Digit zero		& \verb|0|	\\
+  \bosoo{\glyphbcg{1}}	& Digit one		& \verb|1|	\\
+  \bosoo{\glyphbcg{2}}	& Digit two		& \verb|2|	\\
+  \bosoo{\glyphbcg{3}}	& Digit three		& \verb|3|	\\
+  \bosoo{\glyphbcg{4}}	& Digit four		& \verb|4|	\\
+  \bosoo{\glyphbcg{5}}	& Digit five		& \verb|5|	\\
+  \bosoo{\glyphbcg{6}}	& Digit six		& \verb|6|	\\
+  \bosoo{\glyphbcg{7}}	& Digit seven		& \verb|7|	\\
+  \bosoo{\glyphbcg{8}}	& Digit eight		& \verb|8|	\\
+  \bosoo{\glyphbcg{9}}	& Digit nine		& \verb|9|	\\
+% \hline
+\end{tabular}
+\end{center}
+\caption{Mongolian Script Special Symbols and Punctuation
+	Marks\label{table:SpecialMLSCharacters}}
+\end{table}
+
+\subsection{Manju Input}
+
+Manju documents can be compiled with the \refcmda{bithe} option
+to the \verb|\usepackage| command, which will create complete
+documents in Manju. Anywhere in the document, it is possible to
+switch to Manju input (transliteration mode)
+with
+\verb"\SetDocumentEncodingBithe"\label{cmd:SetDocumentEncodingBithe} which
+internally activates the \LMA\label{a:LMA} encoding.
+
+\textit{Caveat:} Since switching to Manju text
+requires a lot of settings to be effected at the same time, there
+are high-level commands available (see below) which do all the work, including
+the definition of the document encoding. Thus, while
+\verb|\SetDocumentEncodingBithe| is indeed classified as a
+user-level command, it is certainly not necessary for everyday work.
+
+
+\subsection{Basic Character Set and Romanization}
+
+Given by dictionary order, the system provides a basic
+character set as shown in table~\ref{table:ManjuBasicChars}.
+
+\newcommand{\MaEntry}[3]{\mabosoo{#1}& #2 & #3 }
+\begin{table}
+\begin{center}
+\begin{tabular}{ccc|ccc|ccc}
+Manju&Input&Latin&Manju&Input&Latin&Manju&Input&Latin\\
+\hline
+\MaEntry{a}{a}{a}	& \MaEntry{h}{h}{h}	& \MaEntry{c}{c}{c}	\\
+\MaEntry{e}{e}{e}	& \MaEntry{b}{b}{b}	& \MaEntry{j}{j}{j}	\\
+\MaEntry{i}{i}{i}	& \MaEntry{p}{p}{p}	& \MaEntry{y}{y}{y}	\\
+\MaEntry{o*}{o}{o}	& \MaEntry{s}{s}{s}	& \MaEntry{k'}{k'}{k'}	\\
+\MaEntry{u*}{u}{u}	& \MaEntry{s'}{s'}{\v s}	& \MaEntry{g'}{g'}{g'}	\\
+\MaEntry{v}{v}{\={u}}	& \MaEntry{t}{t}{t}	& \MaEntry{h'}{h'}{h'}	\\
+\MaEntry{n}{n}{n}	& \MaEntry{d}{d}{d}	& \MaEntry{r}{r}{r}	\\
+\MaEntry{k}{k}{k}	& \MaEntry{l}{l}{l}	& \MaEntry{f}{f}{f}	\\
+\MaEntry{g}{g}{g}	& \MaEntry{m}{m}{m}	& \MaEntry{w}{w}{w}	\\
+\end{tabular}
+\caption{Manju Basic Character Set\label{table:ManjuBasicChars}}
+\end{center}
+\end{table}
+
+While the input method for the majority of characters matches the
+transliteration conventions, some letters require a slightly
+different treatment:
+\begin{enumerate}
+	\item Although the diphtong \mabosoo{*aii*} is
+		usually rendered as \textit{ai}, it must be entered
+		as \texttt{aii} in order to produce the desired
+		effect.
+	\item The vowel which is conventionally rendered as \textit{\^u}
+		or \textit{\=u} \mabosoo{v} can be entered as \texttt{v}
+		or as \verb|\={u}| due to the fact that a character
+		\textit{\^u} is not readily available on most systems.
+	\item The consonant \textit{\v s} \mabosoo{s'} can be entered as
+		\texttt{s'} or as \verb|\v{s}|, but not as *\texttt{sh}
+		as to avoid undesired mergers of \textit{s} and \textit{h}
+		like in \textit{ishun} \mabosoo{ishun} which should not be
+		*\textit{i\v{s}un} \mabosoo{is'un}!
+\end{enumerate}
+
+
+\subsection{Small Portions of Mongolian and Manju in Running Text}
+
+For displaying short Mongolian snippets in running text
+use 
+\begin{itemize}
+	\item [MLS Romanization] \cmd{bcg}\verb|{...}|.
+	\item [Simplified Transliteration] \cmd{bicig}\verb|{...}|.
+\end{itemize}
+
+For displaying short Manju snippets in running text
+use \cmd{bithe}\verb|{...}|.
+
+\exa
+	This is \bicig{munggul bicik}. 
+
+	That is \bithe{manju bithe}.
+\exb
+	\begin{verbatim}
+	This is \bicig{munggul bicik}.
+	
+	That is \bithe{manju bithe}.
+	\end{verbatim}
+\exc
+
+\subsection{Horizontal Paragraphs of Mongolian or Manju Text}
+
+If one needs more than a few words of Mongolian or Manju but does
+not want to change the line orientation, then the environments
+\cmda{bicigtext} for Mongolian (which should be entered in
+Mongolian Simplified Transliteration) and \cmda{bithetext} for Manju are
+useful.
+
+\exa
+	\begin{bicigtext}
+	uindur gegen zanabazar.
+
+	17..18 d'ugar zagun-u munggul-un
+	neiigem, ulus tuiru, shasin-u uiiles-tu,
+	ilangguy=a uralig-un kuikzil-du uncukui
+	ekurge kuiicedgeksen uindur gegen
+	zanabazar, cingkis xagan-u aldan
+	urug-un izagur surbulzidan abadai
+	saiin nuyan xan-u kuiu tuisiyedu xan
+	gumbudurzi-yin ger-tu 1635 un-du
+	tuiruksen.%
+	\end{bicigtext}
+\exb
+	{\mdoublehyphenon
+	\begin{verbatim}
+	\begin{bicigtext}
+	uindur gegen zanabazar.
+
+	17..18 d'ugar zagun-u munggul-un
+	neiigem, ulus tuiru, shasin-u
+	uiiles-tu, ilangguy=a uralig-un
+	kuikzil-du uncukui ekurge
+	kuiicedgeksen uindur gegen
+	zanabazar, cingkis xagan-u
+	aldan urug-un izagur surbulzidan
+	abadai saiin nuyan xan-u kuiu
+	tuisiyedu xan gumbudurzi-yin
+	ger-tu 1635 un-du tuiruksen.
+	\end{bicigtext}
+	\end{verbatim}}
+\exc
+
+
+\exa
+	\begin{bithetext}
+	han-i araha sunja
+	hacin-i hergen kamciha
+	manju gisun-i buleku
+	bithe. abkai so\v{s}ohon.
+	emu hacin. nadan meyen.%
+	\end{bithetext}
+\exb
+	\begin{verbatim}
+	\begin{bithetext}
+	han-i araha sunja
+	hacin-i hergen kamciha
+	manju gisun-i buleku
+	bithe. abkai so\v{s}ohon.
+	emu hacin. nadan meyen.%
+	\end{bithetext}
+	\end{verbatim}
+\exc
+
+\subsection{Vertical Capsules}
+
+Individual Mongolian and Manju words can be placed vertically
+anywhere in otherwise horizontal text like in
+the keyword entry of dictionaries.\footnote{Famous dictionaries with
+	a mixture of vertical and horizontal printing are I.~J.~Schmidt's
+	Mongolian-Russian-German dictionary (1835) and F.~Lessing's
+	Mongolian-English dictionary (1960).}.\marginpar{%
+\mbosoo{mongGol}\mbosoo{bicig}
+
+		\vspace{2.54mm}
+
+		\raggedright\small
+		without PostScript support Mongolian text enclosed in
+		vertical capsules will be printed \emph{horizontally}!}
+The capsule containing the
+Mongolian or Manju word will automatically request sufficient space
+so that ugly overlaps with neighbouring lines will not happen.
+
+For presenting text given in broad (or MLS) transliteration, use the command
+\cmd{mbosoo}\verb|{...}|; when writing in Mongolian Simplified
+Transliteration, use \cmd{mobosoo}\verb|{...}|; likewise for Manju, use
+\cmd{mabosoo}\verb|{...}|. All these commands are derived from a
+command \cmd{bosoo}\verb|{...}| which places text in vertical
+capsules but leaves the contents untouched as far as the encoding is
+concerned.
+
+\exa
+	This is \bosoo{vertical}
+		\bosoo{text}. 
+	This is \mbosoo{mongGol}
+		\mbosoo{bicig}, 
+	this is \mobosoo{munggul}
+		\mobosoo{bicik}, 
+	that is \mabosoo{manju}
+		\mabosoo{bithe}.
+\exb
+	\begin{verbatim}
+	This is \bosoo{vertical}
+		\bosoo{text}. 
+	This is \mbosoo{mongGol}
+		\mbosoo{bicig}, 
+	this is \mobosoo{munggul}
+		\mobosoo{bicik}, 
+	that is \mabosoo{manju}
+		\mabosoo{bithe}.
+	\end{verbatim}
+\exc
+
+
+\subsection{Vertical Text Boxes}
+
+For presenting individual paragraphs of Mongolian or Manju text in
+vertical manner in an otherwise horizontal text, there are the box
+commands \cmd{mobox}\verb|{...}{...}| for Mongolian%
+\footnote{Mongolian input \emph{must} be coded in Mongolian Simplified
+	Transliteration; MLS input won't work.}
+and
+\cmd{mabox}\verb|{...}{...}|
+for Manju. These boxes take two arguments. The first argument
+indicates the \textit{vertical depth} of the box, or its line
+length. The second argument contains the desired text.
+
+\exa
+	\mobox{7.5cm}{%
+%	uindur gegen zanabazar.
+%
+	17..18 d'ugar zagun-u munggul-un
+	neiigem, ulus tuiru, shasin-u uiiles-tu,
+	ilangguy=a uralig-un kuikzil-du uncukui
+	ekurge kuiicedgeksen uindur gegen
+	zanabazar, cingkis xagan-u aldan
+	urug-un izagur surbulzidan abadai
+	saiin nuyan xan-u kuiu tuisiyedu xan
+	gumbudurzi-yin ger-tu 1635 un-du
+	tuiruksen.%
+	}
+\exb
+	%\vskip-9cm
+	{\mdoublehyphenon
+	\begin{verbatim}
+	\mobox{7.5cm}{%
+	uindur gegen zanabazar.
+
+	17..18 d'ugar zagun-u munggul-un
+	neiigem, ulus tuiru, shasin-u
+	uiiles-tu, ilangguy=a uralig-un
+	kuikzil-du uncukui ekurge
+	kuiicedgeksen uindur gegen
+	zanabazar, cingkis xagan-u
+	aldan urug-un izagur surbulzidan
+	abadai saiin nuyan xan-u kuiu
+	tuisiyedu xan gumbudurzi-yin
+	ger-tu 1635 un-du tuiruksen.%
+	}
+	\end{verbatim}}
+\exc
+
+
+\exa
+	\mabox{3.75cm}{%
+	\noindent\raggedleft han-i araha sunja
+	hacin-i hergen kamciha
+	manju gisun-i buleku
+	bithe. abkai so\v{s}ohon.
+	emu hacin. nadan meyen.%
+	}
+\exb
+	%\vskip-5.25cm
+	\begin{verbatim}
+	\mabox{3.75cm}{%
+	\raggedleft han-i araha sunja
+	hacin-i hergen kamciha
+	manju gisun-i buleku
+	bithe. abkai so\v{s}ohon.
+	emu hacin. nadan meyen.%
+	}
+	\end{verbatim}
+\exc
+
+\subsection{Full Vertical Text Pages\label{BicigandBithe}}
+
+If you need several pages of Mongolian output, enclose your text
+in an evironment \cmda{bicigpage}, and use \cmda{bithepage}
+likewise for Manju texts. Note that Mongolian must be entered in
+Simplified Transliteration.
+
+Finally, if you want the whole document and its basic language to be
+Classical, or Uighur Mongolian, say \verb|\usepackage[bicig,...]{mls}|.
+Likewise, complete Manju documents are produced with 
+\verb|\usepackage[bithe,...]{mls}|.
+
+If you start a document with a \verb|\usepackage[bicig]{mls}|
+declaration you can still switch back to Latin by issuing an
+\verb|\end{bicigpage}| command.
+
+Likewise, if you start a document with a \verb|\usepackage[bithe]{mls}|
+declaration you can still switch back to Latin by issuing an
+\verb|\end{bithepage}| command.
+
+The following snippet of Mongolian text is presented in full
+page mode on the next pages, first in Simplified Transliteration form, then
+in Uighur form; in order to achieve this result the text had to be
+included in the environment \texttt{bicigpage}.
+
+\noindent
+\begin{figure}
+\begin{verbatim}
+\begin{bicigpage}
+uindur gegen zanabazar.
+
+17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru, shasin-u
+uiiles-tu, ilangguy=a uralig-un kuikzil-du uncugui ekurge
+kuiicedgeksen uindur gegen zanabazar, cingkis xagan-u aldan
+urug-un izagur surbulzidan abadai saiin nuyan xan-u kuiu
+tuisiyedu xan gumbudurzi-yin ger-tu 1635 un-du tuiruksen.
+badu muingke dayan xagan-u 6-d'aki uiy=e-yin kuimun. gurban
+nasudai-d'agan num ungsizu enedkek gazar tuibed kele-yi xar=a
+ayandagan surcu, keuked axui cag-aca erdem num-un duiri-tei
+bulugsan zanabazar 15 nasu-tai-dagan baragun zuu (lhasa)
+uruzu tabudugar dalai lam=a-d'u shabilan saguzu, ulamar
+zebCundamba-yin xubilgan tudurazei. uran barimalci, zirugaci,
+kele sinzigeci, uran barilgaci, kuin uxagandan zanabazar ulan
+zagun zil-un daiin tululdugan-d'u nerbekden suliduzu, zugsunggi
+baiidal-d'u urugsan dumdadu zagun-u munggul-un suyul uralig-i
+serkun manduxu-d'u yeke xubi nemekuri urugulugsan yum. tekun-u
+abiyas bilig nuiri yeke kuidelmuri-ber munggul-un uralig nigen
+uiy=e tanigdasi uigei uindurlik-tu kuiruksen azei. xarin 1654
+un-d'u neiislel kuiriyen-u tulg=a-yin cilagu-yi tabilcagsan
+zanabazar-un uran barilg=a-yin buidugel-ece uinudur-i uizeksen
+zuiil barug uigei ni xaramsaldai. zanabazar uindesun-u bicig
+uisuk-i kuikzikulku-d'u beyecilen urulcazu, suyungbu uisuk-i
+zukiyazu ene uiy=e suyungbu ni man-u tusagar tugdanil-un belge
+temdek bulugsagar baiin=a.  tere-ber <<cag-i tukinagulugci>>
+gedek silukleksen zukiyal-d'agan arad tuimen-u-ben engke
+amugulang, saiin saiixan-i imagda kuisen muirugedezu yabudag
+sedkil-un-iien uige-i ilerkeiileksen baiidag. uindur gegen
+duirsuleku uralig-un xubi-d'u uirun=e-yin sunggudag-ud-tai
+eng zergeceku buidugel-tei kuimun abacu basa xari ulus-un
+buzar bacir arg=a-d'u abdagdan yabugsan nigen.
+...
+... more text ...
+              ...
+\end{bicigpage}
+\end{verbatim}
+\caption{Input Example of a Mongolian text}
+\end{figure}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{bicigpage}
+	uindur gegen zanabazar.
+
+	17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru,
+	shasin-u uiiles-tu, ilangguy=a uralig-un kuikzil-du
+	uncugui ekurge kuiicedgeksen uindur gegen zanabazar,
+	cingkis xagan-u aldan urug-un izagur surbulzidan abadai
+	saiin nuyan xan-u kuiu tuisiyedu xan gumbudurzi-yin
+	ger-tu 1635 un-du tuiruksen.  badu muingke dayan xagan-u
+	6-d'aki uiy=e-yin kuimun. gurban nasudai-d'agan num
+	ungsizu enedkek gazar tuibed kele-yi xar=a ayandagan
+	surcu, keuked axui cag-aca erdem num-un duiri-tei
+	bulugsan zanabazar 15 nasu-tai-dagan baragun zuu
+	(lhasa) uruzu tabudugar dalai lam=a-d'u shabilan
+	saguzu, ulamar zebCundamba-yin xubilgan tudurazei. uran
+	barimalci, zirugaci, kele sinzigeci, uran barilgaci,
+	kuin uxagandan zanabazar ulan zagun zil-un daiin
+	tululdugan-d'u nerbekden suliduzu, zugsunggi
+	baiidal-d'u urugsan dumdadu zagun-u munggul-un suyul
+	uralig-i serkun manduxu-d'u yeke xubi nemekuri
+	urugulugsan yum. tekun-u abiyas bilig nuiri yeke
+	kuidelmuri-ber munggul-un uralig nigen uiy=e tanigdasi
+	uigei uindurlik-tu kuiruksen azei. xarin 1654 un-d'u
+	neiislel kuiriyen-u tulg=a-yin cilagu-yi tabilcagsan
+	zanabazar-un uran barilg=a-yin buidugel-ece uinudur-i
+	uizeksen zuiil barug uigei ni xaramsaldai. zanabazar
+	uindesun-u bicig uisuk-i kuikzikulku-d'u beyecilen
+	urulcazu, suyungbu uisuk-i zukiyazu ene uiy=e suyungbu
+	ni man-u tusagar tugdanil-un belge temdek bulugsagar
+	baiin=a.  tere-ber <<cag-i tukinagulugci>> gedek
+	silukleksen zukiyal-d'agan arad tuimen-u-ben engke
+	amugulang, saiin saiixan-i imagda kuisen muirugedezu
+	yabudag sedkil-un-iien uige-i ilerkeiileksen
+	baiidag. uindur gegen duirsuleku uralig-un xubi-d'u
+	uirun=e-yin sunggudag-ud-tai eng zergeceku buidugel-tei
+	kuimun abacu basa xari ulus-un buzar bacir arg=a-d'u
+	abdagdan yabugsan nigen.
+
+	munggul-d'u urcigulxu uxagan yeke delgerezu baiigsan ni
+	man-u erden ba dumdadu uiy=e-yin suyul-un nigen uncalig
+	azei. erden-u enedkek-un kuin uxagan-u iragu naiirag,
+	kele bicik-un sudulul, anagaxu uxagan, uralaxu uxagan
+	zerge tabun uxagan-u zukiyal-i bagdagagsan buikude 334
+	budi <<ganzuur>>, <<danzuur>>-i num-un mergen bagsi
+	kuinggaudsar terikudei 64 erdemden lama urcigulun
+	neiideleksen baiin=a. 400 zil-un terdege urcigulg=a-yin
+	iimu eke kuiriyeleng munggul-d'u azillazu baiigsan-i
+	tuisugelen buduxu-d'u baxadai. munggulcud erden-ece
+	inagsi daguu xugur-tai buizik nagadum-tai xurdun
+	kuiluk murid-tai. er=e-yin gurban nagadum-i erkimelen
+	kuikzilduzu, ide xabu-ban bulgazu ireksen baiin=a.
+	munggul-un zirgalang ni buizik, xurim bile. xudala-i
+	xagan-d'u erkumzileged xurxunag-un sagalagar mudun-u
+	duur=a xabirg=a gazar-i xalcaradal=a, ebuduk gazar-i
+	uilduredel=e debkecen buiziklezu xurimlaba gesen uige
+	<<niguca tubciyan>>-d'u bui. munggul arad-un medelge
+	uxagan erde-ece inagsi mal azu axui, udun urun,
+	gazar zuii, anagaxu uxagan, baiigali, neiigem-un
+	ulan salburi-bar kuikzizu irebe.  <<aldan tubci>>,
+	<<erdeni-yin tubci>>, <<bulur tuli>>, <<subud erike>>
+	medu teuke-yin ulan arban zukiyal gargazei.
+
+	manzu nar <<munggul uyun>>-i muikugeku-yi kedui-ber
+	uruldubacu uyun bilikdu, cecen celmek, erdem uxagandan
+	tuduran garugsagar baiiba.  19-d'uger zagun bul
+	iragu naiiragci dangzirabzai. yeke zukiyalci inzinasi
+	dangzigvangzil nar-un amidurazu, buidugezu baiigsan
+	uiy=e bile.
+\end{bicigpage}
+
+\subsection{Pure Uighur Mongolian and Manju Documents}
+
+Writing a complete document in Mongolian or Manju is as simple and
+straightforward as writing a document in English or Xalx Mongolian.
+
+The example file, \texttt{zanabazr.tex}
+(shipped together with this documentation and located in the
+directory \texttt{../examples/}) demonstrates how a pure
+Mongolian Bicig document can be created.
+
+\begin{figure}[h]
+\begin{verbatim}
+\documentclass{article}
+\usepackage[bicig]{mls}
+\begin{document}
+uindur gegen zanabazar.
+
+17||18 d'ugar zagun-u munggul-un neiigem, ulus tuiru,
+shasin-u uiiles-tu, ilangguy=a uralig-un kuikzil-du
+...
+... more text ...
+              ...
+\end{document}
+\end{verbatim}
+\end{figure}
+
+The concept is the same for Manju documents: instead of \cmda{bicig}
+one would use the \verb|\usepackage[...]{mls}| option \cmda{bithe}
+and enter Manju text.
+
+\subsection{Font Selection Commands}
+
+There are two distinct styles of Mongolian script: one style
+is typically used for modern print, whereas the other style
+appears in old block prints and stone inscriptions.
+
+Since there is no proper equivalent between Latin and Mongolian
+typographical features, a somewhat arbitrary assignment was made
+to the effect that the block print style can be activated by
+setting the font family sans serif with \cmd{sffamily}. In 
+contrast, setting the roman default family with \cmd{rmfamily}
+switches back to the modern style.
+
+\exa
+	\mobox{2cm}{%
+	\parindent=0pt
+	\par
+	munggul\\
+	\sffamily munggul\\
+	\rmfamily munggul
+	}
+\exb
+	\begin{verbatim}
+	\mobox{2cm}{\noindent
+	munggul\\
+	\sffamily munggul\\
+	\rmfamily munggul}
+	\end{verbatim}
+\exc
+
+\end{document}