diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/m-tx/mtx-install.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/m-tx/mtx-install.tex | 49 |
1 files changed, 36 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/generic/m-tx/mtx-install.tex b/Master/texmf-dist/doc/generic/m-tx/mtx-install.tex index 5e391dee3da..08649ab19b3 100644 --- a/Master/texmf-dist/doc/generic/m-tx/mtx-install.tex +++ b/Master/texmf-dist/doc/generic/m-tx/mtx-install.tex @@ -5,7 +5,7 @@ \RequirePackage{hyperref} \usepackage{xcolor} \newcommand{\myurl}[1]{\textcolor{blue}{\underline{\textcolor{black}{\url{#1}}}}} -\newcommand{\mtxVersion}{0.61} +\newcommand{\mtxVersion}{0.60d} \begin{document} \title{Installation of the CTAN M-Tx Distribution} \author{Bob Tennent\\ @@ -35,8 +35,8 @@ and installing files\footnote{% \section{Installing \texttt{m-tx.tds.zip}} In this distribution of M-Tx, many of the files to be installed -(including macros and documentation are in -\myurl{http://mirror.ctan.org/install/m-tx.tds.zip}. The file +(including macros, documentation, and a wrapper script \verb\m-tx.lua\) are in +\texttt{tex-archive/install/m-tx.tds.zip} at CTAN. The file \verb|mt-x.tds.zip| is a zipped TEXMF hierarchy; simply download it and unzip in the root folder/directory of whichever TEXMF tree you decide is most appropriate, likely a ``local'' or ``personal'' one. @@ -65,8 +65,8 @@ the one essential file that can't be installed in a TEXMF tree: the \texttt{prep On Windows systems, one can install \texttt{prepmx.exe} -in the \texttt{Windows/32bit} or \texttt{Windows/64bit} sub-directory; these are pre-compiled -executables and should be copied to any +in the \texttt{Windows} sub-directory; this is a pre-compiled +executable and should be copied to any folder on the PATH of executables. This might entail creating a suitable folder and adding that folder to the PATH as follows: @@ -126,16 +126,39 @@ This step should be executed as root if you need super-user privileges. You should now have an executable \verb\prepmx\ in your PATH. -\section{Usage} - -To process an M-Tx source file, use the \verb|musixtex| script -which is included in the \verb|musixtex| package. -If applied to a file with \verb|.mtx| extension, it will by default execute \verb|prepmx| followed by -\verb|pmxab|, followed -by \verb|etex|, \verb|musixflx|, and \verb|etex| again, followed by -conversion to PDF using \verb|dvips| and \verb|ps2pdf|. +\section{The Processing Script} + +The Lua script \verb\.../scripts/m-tx/m-tx.lua\ +is simply a convenient wrapper that +by default runs the following processes in order (and then deletes intermediate files): +\begin{itemize}\topsep=0pt\itemsep=0pt +\item \verb\prepmx\ (pre-pre-processing pass) +\item \verb\pmxab\ (pre-processing pass) +\item \verb\etex\ (1st pass) +\item \verb\musixflx\ (2nd pass) +\item \verb\etex\ (3rd pass) +\item \verb\dvips\ (to convert \verb\dvi\ output to Postscript) +\item \verb\ps2pdf\ (to convert \verb\ps\ output to Portable Document Format) +\end{itemize}% There are many options to vary the default behaviour. +On a Unix-like system (with \texttt{luatex} installed), you can put a +symbolic link to \texttt{m-tx.lua} in any directory on the executable PATH as follows: +\begin{list}{}{} +\item \verb\ln -s <path to m-tx.lua> m-tx\ +\end{list} +On Windows, install +the batch script +\begin{list}{}{} +\item \verb|Windows\m-tx.bat| +\end{list} +to a folder +on the executable PATH. + +Documentation for the \verb\m-tx\ script is in the +\verb\doc/generic/m-tx/scripts\ directory. + + \section{Discussion} Other pre-processor packages, additional documentation, additional |