diff options
author | Karl Berry <karl@freefriends.org> | 2015-04-23 22:56:57 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-04-23 22:56:57 +0000 |
commit | ec4fffd1f3b4bf24a5892e6cd2c06da1b562bab4 (patch) | |
tree | e9a0e166feddda069f12c3379e08251eaf78b06d /Master/texmf-dist/doc/generic/musixtex/musixdoc | |
parent | a5edcfe433dd540818b1a0d4eafd6c4b63d24dcc (diff) |
musixtex (22apr15), with musixtnt binaries (fixmsxpart,msxlint) now their own package
git-svn-id: svn://tug.org/texlive/trunk@37025 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/musixtex/musixdoc')
6 files changed, 113 insertions, 130 deletions
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex index 9c64ef2c4c2..4447f44617a 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex @@ -1499,101 +1499,6 @@ If you need greater numbers of these elements, see Sections~\ref{musixmad_setmax \ref{musixmad_setmaxslurs} and \ref{musixmad_setmaxtrills}. -\section{musixtnt}\label{musixtnt} -This package (tnt = Transform Notes) provides a macro \keyindex{TransformNotes} which makes -possible several ``transformations'' of the effect of notes commands such as \keyindex{notes}. -The \verb\musixtnt\ package is distributed separately from \verb\musixtex\. - -In general the effect of \verb|\TransformNotes(|\textit{input}\verb|}{|\textit{output}\verb|}| -is that subsequent notes commands in the source will expect their arguments -to match the \textit{input} pattern but -the notes will be typeset according to the \textit{output} pattern. - -For example, -\begin{verbatim} - \TransformNotes{#2}{#2} -\end{verbatim} -would be appropriate for a four-instrument score (arguments \verb|#2|, \verb|#3|, \verb|#4|, and \verb|#5|, separated by three -\verb\&\s, but the third instrument (\verb|#4|) will be discarded. - -The instrument/staff numbers in the first argument must start at $2$ and increase -consecutively, using \verb|&| (or \| for multi-staff instruments) as a separator. -The reason that the segment identifiers start at $2$ is that the first argument for \keyindex{vnotes} -is a spacing parameter. - -It is -essential that every \verb|\znotes|, \verb|\notes|, \verb|\Notes|, \verb|\NOtes|, etc.\@ command in -the score match the pattern of the first argument to \keyindex{TransformNotes} exactly; for example, -too few (or too many) -note segments will result in unintentionally discarded material and possibly compilation failure. -Similarly, it is not possible to use \keyindex{nextinstrument}, \keyindex{nextstaff}, \keyindex{selectinstrument} or \keyindex{selectstaff}, or to hide the \verb|&| (or \|) tokens inside -a user-defined macro. -An auxiliary program \verb|msxlint| distributed in the \verb\musixtnt\ package can be used to detect such incompatibilities. - -\keyindex{TransformNotes} may be used anywhere between \keyindex{startpiece} -and the command that ends the piece. - -\subsection{Extracting single-instrument parts from multi-instrument scores} - -To extract -a single-instrument part from a (copy of a) multi-instrument \musixtex\ score: -\begin{itemize} -\item Set \verb|\nbinstrument| to 1; for example, with command \verb|\instrumentnumber1|. -\item Use \keyindex{TransformNotes} to discard all but one of the note segments in notes -commands. -For example, the following line placed after -\verb|\startpiece| (but before any note commands) would be appropriate for a -four-instrument score and will result in a single-instrument part for the second of -these: -\begin{verbatim} - \TransformNotes{#2}{#3} -\end{verbatim} -\end{itemize} -Caveats: -\begin{itemize} -\item -Some additional revisions to the source for the part might be necessary: -\begin{itemize} -\item adjusting \verb|\setname1|, \verb|\setclef1|, \verb|\setsign1|, -\verb|\setmeter1| and \verb|\setstaffs1| commands, as necessary; - -\item ensuring that tempo and roadmap markings (\textbf{D.C.}, \textbf{Fine}, etc.) are in - the appropriate instrument segment; -\end{itemize} -\item -When the extracted part score is compiled and viewed, it may be seen -that horizontal-spacing commands designed for \emph{multiple} instruments can produce bad -spacing when used for a \emph{single} instrument. Bad spacing can be corrected manually but -this is very tedious; an auxiliary program called \verb\fixprt\ -automates this process (for single-staff instruments only). -\end{itemize} - -\subsection{Other applications} - -The \keyindex{TransformNotes} macro may be used for other purposes. Here are some examples: -\begin{list}{}{}\item - \verb|\TransformNotes{#2}{#2&\transpose+7#3}| -\end{list} -will begin transposing\index{transpose@{\Bslash transpose}} just the second instrument (argument \verb|#3|). -\begin{list}{}{}\item - \verb|\TransformNotes{#2|\|\verb|#3}{#2|\|\verb|#3&\tinynotesize#4}| -\end{list} -will begin typesetting the notes of the second instrument (\verb|#4|) in tiny size. -\begin{list}{}{}\item - \verb|\TransformNotes{#2}{#3}| -\end{list} -will switch the order of the two instruments. -\begin{list}{}{}\item - \verb|\TransformNotes{#2}{#2}| -\end{list} -will restore normal two-instrument processing. - - -The \keyindex{TransformNotes} macro is currently not compatible with the -\texttt{musixlyr} extension -package for lyrics described in Section~\ref{musixlyr}. For extracting or omitting parts -in scores with lyrics, use the techniques described in Chapter~\ref{parts}. - \section{musixper}\label{perc} @@ -1991,6 +1896,7 @@ their meanings are as follows: \end{description}\end{quote} } + %\check \section{musixsty}\index{musixsty@{\tt musixsty.tex}} @@ -2125,6 +2031,101 @@ The default font for typesetting \keyindex{txt} and \keyindex{tuplettxt} arguments is \keyindex{eightit} (\verb|8pt| italic). +\section{musixtnt}\label{musixtnt} +This package (tnt = Transform Notes) provides a macro \keyindex{TransformNotes} which makes +possible several ``transformations'' of the effect of notes commands such as \keyindex{notes}. +The \verb\musixtnt\ package is distributed separately from \verb\musixtex\. + +In general the effect of \verb|\TransformNotes(|\textit{input}\verb|}{|\textit{output}\verb|}| +is that subsequent notes commands in the source will expect their arguments +to match the \textit{input} pattern but +the notes will be typeset according to the \textit{output} pattern. + +For example, +\begin{verbatim} + \TransformNotes{#2}{#2} +\end{verbatim} +would be appropriate for a four-instrument score (arguments \verb|#2|, \verb|#3|, \verb|#4|, and \verb|#5|, separated by three +\verb\&\s, but the third instrument (\verb|#4|) will be discarded. + +The instrument/staff numbers in the first argument must start at $2$ and increase +consecutively, using \verb|&| (or \| for multi-staff instruments) as a separator. +The reason that the segment identifiers start at $2$ is that the first argument for \keyindex{vnotes} +is a spacing parameter. + +It is +essential that every \verb|\znotes|, \verb|\notes|, \verb|\Notes|, \verb|\NOtes|, etc.\@ command in +the score match the pattern of the first argument to \keyindex{TransformNotes} exactly; for example, +too few (or too many) +note segments will result in unintentionally discarded material and possibly compilation failure. +Similarly, it is not possible to use \keyindex{nextinstrument}, \keyindex{nextstaff}, \keyindex{selectinstrument} or \keyindex{selectstaff}, or to hide the \verb|&| (or \|) tokens inside +a user-defined macro. +An auxiliary program \verb|msxlint| distributed in the \verb\musixtnt\ package can be used to detect such incompatibilities. + +\keyindex{TransformNotes} may be used anywhere between \keyindex{startpiece} +and the command that ends the piece. + +\subsection{Extracting single-instrument parts from multi-instrument scores} + +To extract +a single-instrument part from a (copy of a) multi-instrument \musixtex\ score: +\begin{itemize} +\item Set \verb|\nbinstrument| to 1; for example, with command \verb|\instrumentnumber1|. +\item Use \keyindex{TransformNotes} to discard all but one of the note segments in notes +commands. +For example, the following line placed after +\verb|\startpiece| (but before any note commands) would be appropriate for a +four-instrument score and will result in a single-instrument part for the second of +these: +\begin{verbatim} + \TransformNotes{#2}{#3} +\end{verbatim} +\end{itemize} +Caveats: +\begin{itemize} +\item +Some additional revisions to the source for the part might be necessary: +\begin{itemize} +\item adjusting \verb|\setname1|, \verb|\setclef1|, \verb|\setsign1|, +\verb|\setmeter1| and \verb|\setstaffs1| commands, as necessary; + +\item ensuring that tempo and roadmap markings (\textbf{D.C.}, \textbf{Fine}, etc.) are in + the appropriate instrument segment; +\end{itemize} +\item +When the extracted part score is compiled and viewed, it may be seen +that horizontal-spacing commands designed for \emph{multiple} instruments can produce bad +spacing when used for a \emph{single} instrument. Bad spacing can be corrected manually but +this is very tedious; an auxiliary program called \verb\fixmsxpart\ +automates this process (for single-staff instruments only). +\end{itemize} + +\subsection{Other applications} + +The \keyindex{TransformNotes} macro may be used for other purposes. Here are some examples: +\begin{list}{}{}\item + \verb|\TransformNotes{#2}{#2&\transpose+7#3}| +\end{list} +will begin transposing\index{transpose@{\Bslash transpose}} just the second instrument (argument \verb|#3|). +\begin{list}{}{}\item + \verb|\TransformNotes{#2|\|\verb|#3}{#2|\|\verb|#3&\tinynotesize#4}| +\end{list} +will begin typesetting the notes of the second instrument (\verb|#4|) in tiny size. +\begin{list}{}{}\item + \verb|\TransformNotes{#2}{#3}| +\end{list} +will switch the order of the two instruments. +\begin{list}{}{}\item + \verb|\TransformNotes{#2}{#2}| +\end{list} +will restore normal two-instrument processing. + + +The \keyindex{TransformNotes} macro is currently not compatible with the +\texttt{musixlyr} extension +package for lyrics described in Section~\ref{musixlyr}. For extracting or omitting parts +in scores with lyrics, use the techniques described in Chapter~\ref{parts}. + \section{musixtri}\index{musixtri@{\tt musixtri.tex}} Provides triply dotted note symbols. Available are: diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/fonts.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/fonts.tex index 2a3a0037cd5..e0c547834b2 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/fonts.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/fonts.tex @@ -103,9 +103,9 @@ in any \TeX\ document, e.g., by coding \verb|\font blafont=bla10| and then You might also wish to replace once and for all the typefaces invoked by the commands described in the previous section. Again, before doing this, you must -follow steps (a-c) of the previous paragraph for all fonts in questions. +follow steps (a-c) of the previous paragraph for all fonts in question. \label{UserFonts} -You can use the standard bitmapped fonts which are converted to +You can use bitmapped fonts, which are converted to Postscript by e.g.,~\verb|dvips|, but you also may replace them by native Postscript fonts. diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex index c0f52919c24..76439f0ed9a 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex @@ -12,7 +12,7 @@ instrumental music\\\Large\itshape Version 1.16} % Private Bag No.1, Mordialloc, Victoria 3195,\\ Australia \\\medskip % \\\Large\rm Andreas \sc Egler\\\large\sl % (Ruhr--Uni--Bochum)\\ Ursulastr. 32\\ D-44793 Bochum} -\date{\today} +\date{Revised \today} \maketitle \vfill \thispagestyle{empty} @@ -66,9 +66,10 @@ event. You may read tributes to Daniel Taupin that are archived at the Since then, the only significant update to \musixtex\ has been in version 1.15 (April 2011) which takes advantage of the greater capacity of the e\TeX\ version of \TeX. The current version~1.16 (February~2015) incorporates some minor -corrections in cautionary accidentals and ``hiding'' staffs. The package +corrections in cautionary accidentals and ``hiding'' staffs, and a major correction +to a deep bug in the package for Postscript fonts. The \musixtex\ package includes -new extension libraries for use of Palatino text fonts, the EC variants +new extension libraries for use of Palatino and Helvetica text fonts, the EC variants of Computer Modern fonts, additional accents and improved dynamic marks. This manual is the definitive reference to all features of \musixtex\ version~1.16. diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex index aed7e821fcc..f139c96c56c 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex @@ -108,8 +108,8 @@ have the expected effect until the notes group is terminated or \verb|\noteskip| is further redefined. The following abbreviations may be useful: \begin{quote} - \keyindex{nnotes} for \verb|\notes\multnoteskip\smallvalue|\quad (i.e.,~\verb|1.6\elemskip|)\\ - \keyindex{nnnotes} for \verb|\notes\multnoteskip\tinyvalue|\quad (i.e.,~\verb|1.28\elemskip|) + \keyindex{nnotes} for \verb|\vnotes1.6\elemskip|\\ + \keyindex{nnnotes} for \verb|\vnotes1.28\elemskip| \end{quote} Finally, by issuing a command like \keyindex{scale}\verb|{2.4}| outside any notes group, you can scale all subsequent diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/summary.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/summary.tex index 72f754f0e86..0b5675f9ffe 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/summary.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/summary.tex @@ -1,10 +1,16 @@ \newgeometry{margin=0.5in} \makeatletter -\let\chapterheadorig\@makeschapterhead -\def\@makeschapterhead#1{} +\def\@makeschapterhead#1{} % omit chapter head to save space \chapter*{} \addcontentsline{toc}{chapter}{Summary of Denotations} -\def\@makeschapterhead#1{\chapterheadorig} +\def\@makeschapterhead#1{% restore usual definition + \vspace*{50\p@}% + {\parindent \z@ \raggedright + \normalfont + \interlinepenalty\@M + \Huge \bfseries #1\par\nobreak + \vskip 40\p@ + }} \makeatother \parskip0pt plus 2pt \parindent0pt diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/texput.log b/Master/texmf-dist/doc/generic/musixtex/musixdoc/texput.log deleted file mode 100644 index e219b01db63..00000000000 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/texput.log +++ /dev/null @@ -1,25 +0,0 @@ -This is XeTeX, Version 3.14159265-2.6-0.99991 (TeX Live 2014) (preloaded format=xelatex 2014.10.14) 25 FEB 2015 09:14 -entering extended mode - restricted \write18 enabled. - %&-line parsing enabled. -**\end - -*\end -! TeX capacity exceeded, sorry [input stack size=5000]. -\end #1->\csname end#1 - \endcsname \@checkend {#1}\expandafter \endgroup \if@e... -<*> \end - -If you really absolutely need more capacity, -you can ask a wizard to enlarge me. - - -Here is how much of TeX's memory you used: - 1 string out of 493724 - 10 string characters out of 6145898 - 54450 words of memory out of 5000000 - 3432 multiletter control sequences out of 15000+600000 - 3640 words of font info for 14 fonts, out of 8000000 for 9000 - 1328 hyphenation exceptions out of 8191 - 5000i,0n,5000p,10b,8s stack positions out of 5000i,500n,10000p,200000b,80000s -No pages of output. |