summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-01-25 22:35:15 +0000
committerKarl Berry <karl@freefriends.org>2019-01-25 22:35:15 +0000
commit0c9aa4f80b0f44658e8ba13f2261a2386e99c774 (patch)
treeb06ea5ce07c014d072fe77e90fd37a0d8573a11b /Master/texmf-dist/doc/generic
parent2b252198a05d7b5f671f4a377c9de54441dc1db4 (diff)
m-tx (24jan19)
git-svn-id: svn://tug.org/texlive/trunk@49818 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/Makefile2
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/README2
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/borup.pdfbin0 -> 24188 bytes
-rwxr-xr-xMaster/texmf-dist/doc/generic/m-tx/buildmtxdoc.lua2
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/halleluja.pdfbin0 -> 137069 bytes
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/kanons.pdfbin0 -> 49409 bytes
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx100
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/mtxdoc.pdfbin345556 -> 378927 bytes
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/mtxlatex.sty94
9 files changed, 64 insertions, 136 deletions
diff --git a/Master/texmf-dist/doc/generic/m-tx/Makefile b/Master/texmf-dist/doc/generic/m-tx/Makefile
index 90b2080f029..8eaf4d74f73 100644
--- a/Master/texmf-dist/doc/generic/m-tx/Makefile
+++ b/Master/texmf-dist/doc/generic/m-tx/Makefile
@@ -6,7 +6,7 @@ halleluja:
texlua buildmtxdoc.lua halleluja
kanons:
texlua buildmtxdoc.lua kanons
-PHONY: default hallelua kanons
+PHONY: default halleluja kanons
support = Makefile make-dvi make-pdf make-target pdfcat \
buildmtxdoc.lua buildzip.lua
diff --git a/Master/texmf-dist/doc/generic/m-tx/README b/Master/texmf-dist/doc/generic/m-tx/README
index dc26070d44a..c537b9eed94 100644
--- a/Master/texmf-dist/doc/generic/m-tx/README
+++ b/Master/texmf-dist/doc/generic/m-tx/README
@@ -1,4 +1,4 @@
-This is M-Tx (Music-from-TeXt), version 0.63a (2018-04-14).
+This is M-Tx (Music-from-TeXt), version 0.63c (2019-01-15).
M-Tx is a preprocessor for PMX that facilitates inputting
lyrics. It builds the PMX input file based on a language
diff --git a/Master/texmf-dist/doc/generic/m-tx/borup.pdf b/Master/texmf-dist/doc/generic/m-tx/borup.pdf
new file mode 100644
index 00000000000..521b6b06dc9
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/m-tx/borup.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/m-tx/buildmtxdoc.lua b/Master/texmf-dist/doc/generic/m-tx/buildmtxdoc.lua
index 6d4cb2b6e35..c69dad23f91 100755
--- a/Master/texmf-dist/doc/generic/m-tx/buildmtxdoc.lua
+++ b/Master/texmf-dist/doc/generic/m-tx/buildmtxdoc.lua
@@ -40,7 +40,7 @@ local build_project = function(target)
if target == "mtxdoc" then
make_examples()
end
- sys("musixtex -q "..project[target])
+ sys("musixtex -q "..project[target])
end
-- Main program
diff --git a/Master/texmf-dist/doc/generic/m-tx/halleluja.pdf b/Master/texmf-dist/doc/generic/m-tx/halleluja.pdf
new file mode 100644
index 00000000000..c67ef907bbf
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/m-tx/halleluja.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/m-tx/kanons.pdf b/Master/texmf-dist/doc/generic/m-tx/kanons.pdf
new file mode 100644
index 00000000000..9b0a4da0f39
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/m-tx/kanons.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx b/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx
index cbf7f82927f..c2082c1f6ad 100644
--- a/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx
+++ b/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx
@@ -22,10 +22,10 @@
\texttt{https://github.com/dlaurie/M-Tx}
}
-\def\versionname{0.62}
-\def\version{0.62}
+\def\versionname{0.63c}
+\def\version{0.63c}
\def\newfrom{0.61}
-\date{20 October 2016}
+\date{15 January 2019}
\title{\Huge \textbf{\MTx: Music from Text \\ \LARGE Version\current} \\
User's Guide \vfill}
\author{\LARGE Dirk Laurie\\ \texttt{dirk.laurie@gmail.com} }
@@ -1943,15 +1943,16 @@ Some points to note:
\item The file \texttt{mtxlatex.sty} is supplied with the \MTx\
documentation source. You may need to copy it to some other place
for \TeX\ to find it.
- \item The package \texttt{times} comes with standard distributions.
-You could use any \LaTeXe\ font package here. The \texttt{times}
+ \item The package \texttt{mathptmx} comes with standard distributions
+and loads \texttt{Times} fonts, including fonts for mathematics.
+You could use any suitable \LaTeXe\ font package here. The \texttt{Times}
font is quite narrow and therefore useful when the lyrics are crowded.
If you do use a font package, load it \emph{after} \texttt{mtxlatex}.
\item \verb"\pagestyle{headings}" puts page
numbers and running headings at the top of the page.
- \item To change fonts, use pure \LaTeXe\
-\ixem{font change} commands, as above. Don't try to use \verb"\it", \verb"\bf"
-etc. Briefly, subject to what fonts you have installed,
+ \item To change fonts, you can use pure \LaTeXe\
+\ixem{font change} commands, as above.
+Briefly, subject to what fonts you have installed,
you can independently change:
\begin{description}
\item[size] \verb"\tiny",
@@ -1961,9 +1962,31 @@ you can independently change:
\item[shape] \verb"\upshape", \verb"\itshape", \verb"\slshape",
\verb"\scshape";
\item[family] \verb"\rmfamily", \verb"\sffamily", \verb"\ttfamily";
- \item[series] \verb"\mdseries", \verb"\bfseries".
+ \item[series] \verb"\mdseries", \verb"\bfseries",
\end{description}
+or corresponding \verb|\text..{...}| macros.
For a full description, see any good \LaTeXe\ manual.
+
+Header
+font commands (see Section~\ref{ChangingFonts}) are redefined in \verb|mtxlatex.sty| as follows:
+\begin{verbatim}
+ \renewcommand{\BIGtype}{\Huge\bfseries}
+ \renewcommand{\BIgtype}{\huge\bfseries}
+ \renewcommand{\Bigtype}{\LARGE\bfseries}
+ \renewcommand{\bigtype}{\Large\bfseries}
+\end{verbatim}
+If \TeX-like commands such as \verb"\it", \verb"\bf"
+etc.\ are used in a particular score, they can be redefined to work as in MusiX\TeX\ in
+that environment as follows:
+\begin{verbatim}
+ \renewcommand{\rm}{\upshape\mdseries}
+ \renewcommand{\it}{\itshape\mdseries}
+ \renewcommand{\bf}{\upshape\bfseries}
+ \renewcommand{\bi}{\itshape\bfseries}
+ \renewcommand{\sc}{\scshape\mdseries}
+\end{verbatim}
+
+
\item The blank line after \verb"\pagebreak" is essential.
\item The environment \ttxem{Score} is used to include each piece.
It takes two arguments: the first will appear in the list of
@@ -2074,39 +2097,38 @@ for so doing is that the user can modify their effect by redefining
them in the source file. These macros, together with a few others
that make life easier, are collected in the file \ttxem{mtx.tex}.
-Documentation of these commands can be found at the end of the file
-\texttt{mtx.tex}.
-
\subsection{Changing fonts}
-
-The font used for lyrics is the default text font of the moment,
-which usually is eleven-point roman.
-It can be changed globally, e.g.
-\verb"TeX: \twelverm" in the preamble will change the font to
-twelve-point. When using \LaTeX, you can use font-changing commands
-inside the environment to change the lyrics font only for that
-particular piece.
-
-The fonts used for titles and other items in headers are respectively
-called \keyindex{BIGfont} and \keyindex{Bigfont}. In \verb"mtxlatex.sty"
-they are redefined as follows:
+\label{ChangingFonts}
+
+The font used for lyrics is
+by default eleven-point roman.
+It can be changed globally; for example, \verb"TeX: \twelverm" in the preamble will change the font to
+twelve-point.
+The font families used by default for titles and other items in headers are respectively
+called \keyindex{BIgtype} and \keyindex{bigtype}.
+If you want larger or smaller fonts, you may use \verb|\BIGtype| or \verb|\Bigtype|
+to prefix
+the header text,
+as in
\begin{verbatim}
-\renewcommand{\BIGfont}{\Huge\bfseries}
-\renewcommand{\Bigfont}{\Large}
+ Title: \Bigtype Sanctus
\end{verbatim}
-If you are not using \LaTeX, they can be redefined in two ways:
-\begin{itemize}
- \item You can simply assign an existing font, e.g.\ to get
- somewhat smaller fonts,\\
-\verb" \let\Bigfont\bigfont\let\BIGfont\BIgfont"
- \item You can define the font explicitly, e.g.\ \\
-\verb" \font\BIGfont=cmss9 scaled \magstep4"
-\end{itemize}
-
-The macros \keyindex{mtxPalatino} and \keyindex{mtxHelvetica} defined in
-\texttt{mtx.tex}, based on work by Andr\'e van Ryckeghem, replace
-Computer Modern in all the font definitions by Palatino and Helvetica
-respectively.
+You may also use commands \verb|\rm|, \verb|\it|,
+\verb|\bi|, and \verb|\sc| to get Roman, italic, bold-italic, or small-capital text
+in header strings.
+The macros \keyindex{mtxPalatino} and \keyindex{mtxTimes}, defined in
+\texttt{mtx.tex}, replace
+Computer Modern in all the font definitions by Palatino or Times, respectively.
+
+A command like \verb|\mtxelevensf| may be used in
+a \verb|TeX:| header to get sans-serif lyrics.
+The macro \keyindex{mtxAllsf} sets \verb|\mtxelevensf| as the default
+for lyrics and also redefines the \verb|\bigtype|,
+\verb|\Bigtype|, \verb|\BIgtype| and \verb|\BIGtype| families
+to use sans-serif fonts.
+Only \verb|\rm| and \verb|\it| styles are available in sans-serif header strings.
+The macro \keyindex{mtxHelvetica} replaces the
+Computer Modern Sans font definitions by Helvetica.
\pagebreak
diff --git a/Master/texmf-dist/doc/generic/m-tx/mtxdoc.pdf b/Master/texmf-dist/doc/generic/m-tx/mtxdoc.pdf
index 7fc7c3f9434..1971b5a0cfb 100644
--- a/Master/texmf-dist/doc/generic/m-tx/mtxdoc.pdf
+++ b/Master/texmf-dist/doc/generic/m-tx/mtxdoc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/m-tx/mtxlatex.sty b/Master/texmf-dist/doc/generic/m-tx/mtxlatex.sty
deleted file mode 100644
index 33898e0ac79..00000000000
--- a/Master/texmf-dist/doc/generic/m-tx/mtxlatex.sty
+++ /dev/null
@@ -1,94 +0,0 @@
-% mtxlatex.sty: Macro package to make music scores using Latex
-% or produce LaTeX documents containing music examples
-% Dirk Laurie dlaurie@na-net.ornl.gov 2001-12-27
-% Update: see \mtxdate below
-% Some comments on usage appear at the bottom
-\ifx\mtxlatex\undefined\else\endinput\fi
-\def\mtxlatexdate{20 October 2016}
-\immediate\write10{%
-mtxLaTeX\space<\mtxlatexdate>}
-
-\usepackage{etex}
-
-\def\MTx{\mbox{\textbf{\textsl{M-Tx}}}}
-\def\PMX{\textbf{PMX}}
-\def\musixlyr{\texttt{\textbf{musixlyr}}}
-
-\input musixtex
-\input musixltx
-
-% Preamble TeX commands for documents that contain .ex files
-% generated by M-Tx/PMX
-
-\def\mtxlatex{
-\input mtx
-\renewcommand{\BIGfont}{\Huge\bfseries}
-\renewcommand{\Bigfont}{\Large\bfseries}
-% Kill the PMX definition of \parskip.
-\parskip=0pt plus 1pt
-}
-% Extra vertical space evenly spread between systems
-\renewcommand\alaligne{\stoppiece\vfill\contpiece}
-\def\scoreheight{\textheight 270mm}
-\def\scorewidth{\textwidth 193mm}
-
-\newcommand{\startscore}{\let\SmuF\startmuflex\let\EmuF\endmuflex
-\scorewidth\scoreheight
-\oddsidemargin -15mm\evensidemargin -15mm\topmargin -20mm
-\ifx\mysizes\undefined\else\mysizes\fi
-\let\startmuflex\relax\let\endmuflex\relax\let\bye\relax%
-\let\nopagenumbers\relax\musicparskip}
-\newcommand\headingandcontents[1]{\markboth{#1}{#1}\addcontentsline{toc}
- {section}{\protect\numberline{}{#1}}}
-
-% The environment 'Score' is suitable for scores submitted to the
-% Werner Icking music archive
-\newenvironment{Score}[2]{\headingandcontents{#1}
-\startscore\input #2
-}{\markboth{}{}}
-
-% The environment 'score' requires you to do your own input
-\newenvironment{score}{\startscore}{}
-
-\newenvironment{excerpts}{
-\newlength\keepOSM\setlength\keepOSM\oddsidemargin
-\newlength\keepTM\setlength\keepTM\topmargin
-\global\setlength\oddsidemargin{-13mm} \global\setlength\topmargin{-20mm}
-\let\startmuflex\relax\let\endmuflex\relax
-\let\nopagenumbers\relax \let\bye\relax \let\vfill\relax \let\eject\relax
-\musicparskip
-\renewcommand{\BIGfont}{\Large\bfseries}
-\renewcommand{\Bigfont}{\large\bfseries}
-}{\global\setlength\oddsidemargin\keepOSM\global\setlength\topmargin\keepTM}
-
-\newenvironment{mus}%
-{\begin{minipage}{260mm}\startscore\musicparskip}%
-{\assignlyrics1{}\assignlyrics2{}%
-\gdef\mtxTitle{}\end{minipage}}
-
-\def\example#1#2#3#4#5#6#7#8{
-\noindent\begin{minipage}[t]{#3}
-\begin{mus} \vskip #6
-\input{#1.tex}
-\end{mus}
-\end{minipage}\hskip #4
-\begin{minipage}[#7]{#5} \vskip #8
-\verbatiminput{#1.#2}
-\end{minipage}}
-
-\mtxlatex
-
-\endinput
-
-============================================================================
-
-\example{basename}{ext}
- {musicwidth}{separation}{codewidth}
- {musicvskip}{alignment}{codevskip}
-
-Set music example together with M-Tx (or other) code.
-
-basename - musicfile is basename.tex
-ext - codefile is basename.ext
-separation - distance between music and code minipages
-alignment - c, t or b (for code minipage)