summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx')
-rw-r--r--Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx36
1 files changed, 23 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx b/Master/texmf-dist/doc/generic/m-tx/mtxdoc.ltx
index 176d34d5b9d..cbf7f82927f 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.61}
-\def\version{0.61}
+\def\versionname{0.62}
+\def\version{0.62}
\def\newfrom{0.61}
-\date{11 December 2015}
+\date{20 October 2016}
\title{\Huge \textbf{\MTx: Music from Text \\ \LARGE Version\current} \\
User's Guide \vfill}
\author{\LARGE Dirk Laurie\\ \texttt{dirk.laurie@gmail.com} }
@@ -427,7 +427,7 @@ style names are translated to uppercase internally.
\verb"Meter: C/" & \textit{Alla breve} meter: another notation for \verb"2/2". \\
\verb"Flats: 3" & Key signature has three flats. \\
\verb"Sharps: 2" & Key signature has two sharps. \\
-\verb"Space: 6 0 3" & Extra interlines of space below staves. \\
+\verb"Space: 10; 6 0 3" & Extra interlines of space after title block (optional) and below staves. \\
\verb"PMX: Ar" & \PMX\ command in preamble.\\
\verb"Options: x" & Forces the \texttt x option to be in effect, despite the command line. \\
\verb"Enable: pedanticWarnings" & Enables the \texttt{pedanticWarnings} feature. \\
@@ -615,7 +615,10 @@ staves. There may be a number for every stave: the last number is
interpreted as extra space below the bottom stave. You will probably
need to specify it if you have lyrics or very low notes down there.
This command can be issued in any music paragraph, not only in
-the preamble. It will take effect at the start of the next system.
+the preamble. It will take effect at the start of the next system.
+If issued in the preamble, however, you may optionally also give extra
+space to be inserted below the title block, separated from the other
+numbers by a semicolon. \NEW{0.63}
See Appendix \ref{voltas} for an example of how this command interacts
with lyrics adjustments.
@@ -993,8 +996,9 @@ of empty bars may be difficult to count, and the conventional notation
is to put all the rests in a single bar, with the total number of
bars printed above them. The word for a \mark multi-bar rest is e.g.\
\texttt{rm8} for a rest of eight bars. You code this for one voice only,
-and there may be no other notes or rests on that line. The same rest
-will be printed on all staves.
+and there may be no other notes or rests on that line, with one
+exception:\NEW{0.63} at the start of the piece, there may be a pickup
+consisting of rests. The same rest will be printed on all staves.
Thanks to recent improvements to MusiXTeX and PMX \NEW{0.62} it is no
longer necessary to tune the appearance of the rest e.g.\ \texttt{rm19+18}.
@@ -1216,9 +1220,7 @@ preprocessor to Music\TeX\ (Daniel's first package). My lack of
expertise caused that project to die. The appearance in January 1997 of
\PMX\ 1.1 inspired me to resurrect the idea --- thanks to Don Simons.
Don has also made some comments which helped me to improve the \MTx\
-input language. Some \MTx\ features that are implemented by using \TeX\ directly,
-such as multi-bar rests in scores with more than one stave, make use of
-MusiXTeX code written by Don.
+input language. Some \MTx\ features that are implemented by using \TeX\ directly, make use of MusiXTeX code written by Don.
Since version 0.21, \MTx\ uses Rainer Dunker's \ttxem{musixlyr} package.
This gives much neater horizontal spacing of lyrics than the manual system
@@ -1384,6 +1386,14 @@ E.g.~\verb"g4x3 a b" defines a \ixem{triplet} of total duration a quarter-note
looking like three eighth-notes. The \ttxem{n} means that the number
\verb"#" is not to be printed.
+The other \verb"#"$-1$ notes in the multiplet are excluded from the count.
+They need not all be of the same length: double-length notes are allowed.
+You can double the length using either \verb"D" or \verb"F". Either of
+these in a multiplet note makes that note count as two notes and
+changes the way it is printed. Consult the PMX documentation for
+the difference between \verb"D" and \verb"F" (or experiment and see
+for yourself).
+
\paragraph*{Grace notes:} A normal note may have a prefix group starting
with \verb"G#" or \ttxem{G}. This indicates that the note is the first
of a grace note \index{note!grace}
@@ -1449,7 +1459,7 @@ consult the MusiX\TeX\ manual for other interesting commands.
\verb"%%" lines in the preamble are treated a little differently -- see
Appendix \ref{expert}.
\begin{description}
- \item{Line, page and movement breaks:}
+ \item{Line, page and movement breaks:}
Put \ttxem{\%\%L}\texttt{6} above a paragraph
to make the 6th system start there, and \verb'%%L6P2' to put that
paragraph at the top of page 2. You can't ask for a \ixem{page break}
@@ -1491,8 +1501,8 @@ is 64) and MIDI velocities of 127 and 100 respectively. More details
appear in the \PMX\ manual.
\end{description}
-One thing that you must only pass to PMX by the third method — embedded
-in a music line — is a meter change, otherwise \MTx\ does not know about
+One thing that you must only pass to PMX by the third method --- embedded
+in a music line --- is a meter change, otherwise \MTx\ does not know about
it and will continue to count bars by the old meter.
\section{How to get and use \MTx}