summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/montex/mlsquick.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/montex/mlsquick.tex
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/montex/mlsquick.tex')
-rw-r--r--Master/texmf-dist/doc/latex/montex/mlsquick.tex1038
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}