diff options
author | Karl Berry <karl@freefriends.org> | 2017-03-01 22:32:52 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-03-01 22:32:52 +0000 |
commit | e4bbbf71a1a7ed2bd323e6c971bb8ff99f777f3c (patch) | |
tree | 09656daac0936d4d30292a3c6b634ed97b3c48cc /Master/texmf-dist/doc/generic/musixtex | |
parent | 1927ebbe0621fbca8bf2c12796dc99cfeafdeb25 (diff) |
musixtex (1mar17)
git-svn-id: svn://tug.org/texlive/trunk@43375 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/musixtex')
16 files changed, 130 insertions, 76 deletions
diff --git a/Master/texmf-dist/doc/generic/musixtex/ChangeLog-124.txt b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-124.txt new file mode 100644 index 00000000000..0a2beb1b4e8 --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-124.txt @@ -0,0 +1,10 @@ + +Changes from MusiXTeX 123 to 124: + + + preserve changes to \transpose in an hboxed tremolo command + + test that musixtex.tex has already been loaded in some extensions: + + musixps, musixec, musixhv, musixplt, musixtmr, musixppff + + changed from \it to \ppff in several places + + support new command \setinterstaff{n}{m} + + define \largenotesize, \Largenotesize + + corrected typos \twtybf[g] \svtbf[g] diff --git a/Master/texmf-dist/doc/generic/musixtex/ChangeLog-musixdoc.txt b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-musixdoc.txt index 2efd2aa484b..aea36ae40ce 100644 --- a/Master/texmf-dist/doc/generic/musixtex/ChangeLog-musixdoc.txt +++ b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-musixdoc.txt @@ -1,3 +1,7 @@ +2016-11-12 RDT + + Expanded treatment of big cautionary accidentals + 2016-06-06 RDT Revised the material on page layout. diff --git a/Master/texmf-dist/doc/generic/musixtex/README b/Master/texmf-dist/doc/generic/musixtex/README index 8f5f78f6d66..5c5d258f56a 100644 --- a/Master/texmf-dist/doc/generic/musixtex/README +++ b/Master/texmf-dist/doc/generic/musixtex/README @@ -1,4 +1,4 @@ -This is MusiXTeX, version 1.23 (2016-06-06). +This is MusiXTeX, version 1.24 (2017-02-28). MusiXTeX is a TeX-based system for typesetting music. The main author was Daniel Taupin, who died in a climbing diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc.pdf b/Master/texmf-dist/doc/generic/musixtex/musixdoc.pdf Binary files differindex 2f891a391a3..0270e521fe0 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc.pdf +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc.pdf diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/accidentals.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/accidentals.tex index 4d9e575b7d6..a504837530b 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/accidentals.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/accidentals.tex @@ -49,10 +49,9 @@ heads. This is done using \keyindex{uppersh}\pitchp, \keyindex{upperna}\pitchp, \vspace*{-2ex} It also possible to introduce \ital{\ixem{cautionary accidental}s}, -i.e.,~small accidentals enclosed in parentheses. This done by preceding -the name of the accidental keyword with ``\verb|c|'',\label{cautionary} -e.g.,~\keyindex{cfl}\pitchp~for a cautionary flat. - Available cautionary accidentals are \keyindex{csh}, \keyindex{cfl}, +i.e.,~small accidentals enclosed in parentheses. This is done by preceding +the name of the accidental keyword with ``\verb|c|''\label{cautionary}. +Available cautionary accidentals are \keyindex{csh}, \keyindex{cfl}, \keyindex{cna}, \keyindex{cdfl} and \keyindex{cdsh}, which give @@ -71,3 +70,5 @@ e.g.,~\keyindex{cfl}\pitchp~for a cautionary flat. \keyindex{accshift}\verb|=|\ital{any \TeX\ dimension}, where positive values shift to the left and negative to right, with a default of~\verb|0pt|. +For ``big'' cautionary accidentals, use, for example, +\verb|{|\keyindex{largenotesize}\verb|\csh|\pitchp\verb|}| or see Section~\ref{brapar}. diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex index a4b3c4b2755..2bcc1179a7b 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/extensions.tex @@ -1,7 +1,10 @@ \chapter{Extension Library} -All of the following files are invoked by saying \keyindex{input} \ital{filename}\ . -Most of them are fully compatible with \musixtex\ in that they do not redefine -any existing macros but rather provide additional functionality. In future +All of the following files are invoked by saying \keyindex{input} \ital{filename}. +In some cases, +\verb\musixtex\ must be input \emph{before} the extension, +but most of them are fully compatible with \verb\musixtex.tex\ in that they do not redefine +any existing macros and just provide additional functionality. +In future versions of \musixtex\ we may very well incorporate many of them directly into \verb|musixtex.tex|, but for now we leave them separate. @@ -1466,18 +1469,22 @@ example using (for instrument 2 as an example): \verb|\settrebleclefsymbol2\oldGclef| - \item\keyindex{cqu} $p$ provides a square headed quarter note with stem up at + \item\keyindex{cqu} $p$ provides a square-headed quarter note with stem up at pitch $p$. - \item\keyindex{cql} $p$ provides a square headed quarter note with stem down at + \item\keyindex{cql} $p$ provides a square-headed quarter note with stem down at pitch $p$. - \item\keyindex{chu} $p$ provides a square headed half note with stem up at + \item\keyindex{chu} $p$ provides a square-headed half note with stem up at pitch $p$. - \item\keyindex{chl} $p$ provides a square headed half note with stem down at + \item\keyindex{chl} $p$ provides a square-headed half note with stem down at pitch $p$. + \item\keyindex{cqb} $n$ $p$ provides a square-headed beam note for beam $n$ at pitch $p$. + + \item\keyindex{zcqb} $n$ $p$ provides a non-spacing square-headed beam note for beam $n$ at pitch $p$. + \item\keyindex{cnqu} $p$ and \keyindex{cnql} $p$ provide a stemless square headed quarter note at pitch $p$. @@ -1873,6 +1880,12 @@ for other bold-italic text in music. \section{musixps}\label{musixps}\index{musixps@{\tt musixps.tex}} Activates type K Postscript slurs, ties, and hairpins; see Chapter~\ref{PostscriptSlurs}. +Use as follows: +\begin{quote}\begin{verbatim} +\input musixtex +\input musixps +... +\end{verbatim}\end{quote} \section{musixstr}\label{musixstr}\index{musixstr@{\tt musixstr.tex}} Provides bowing and other symbols for \itxem{string instruments}\footnote{provided diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex index 3dbc437bec3..1728eb49ef8 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex @@ -1,6 +1,6 @@ \title{\Huge\bfseries\musixtex\\[\bigskipamount] \LARGE\bfseries Using \TeX{} to write polyphonic\\or -instrumental music\\\Large\itshape Version 1.23} +instrumental music\\\Large\itshape Version 1.24} %\author{\Large\rm Daniel \sc Taupin\\\large\sl @@ -67,7 +67,7 @@ Since then, the only significant update to \musixtex\ has been in version 1.15 ( takes advantage of the greater capacity of the e\TeX\ version of \TeX. This manual is the definitive reference to all features of -\musixtex\ version~1.23. +\musixtex\ version~1.24. Novice users need not start here. Most diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/layout.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/layout.tex index afc8bbe9fc2..10d8bbc3cfa 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/layout.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/layout.tex @@ -53,7 +53,7 @@ systems to increase by up to \verb|5\Interligne|. The following values of page-layout parameters will allow as much material as possible -on a page, provided the printer supports these dimensions, which +on a page, provided the printer supports these dimensions which imply approximately half-inch margins: \begin{center} @@ -74,30 +74,26 @@ If a score is going to be ``published'' at a public repository (such as A$4$ \emph{or} letter paper, for example by setting the \verb|\hsize| to~190~mm and the \verb|\vsize| to~10~in. -To determine the maximal dimensions that \emph{your} printer is capable of, -process the standard file \verb|testpage.tex| with \LaTeX\ and -print the result. The ``rulers'' on four sides will indicate -how much of the one-inch ``margin'' material outside the frame can actually be printed. -Your \verb|\hsize| and \verb|\vsize| parameters can be increased, or, if necessary, decreased -accordingly. If your score is going to be printed by a publisher or a colleague, you can send -\verb|testpage.pdf| to them to determine what margins are necessary for their -printer. +To generate a score in ``landscape''\index{landscape mode} mode, adjust the +text-size parameters above accordingly (e.g., \verb+\hsize=10in+ and \verb+\vsize=7.5in+) +and add a suitable \verb\papersize\ ``special'' to the \TeX\ output, as in +\verb+\special{papersize=11in,8.5in}+. For \emph{any} values of \verb|\hsize| and \verb|\vsize|, -material will normally be centered on the page by using one of the following -command sequences, which simply split the difference between the page size and the text size, +material will normally be centered on the page by using +command sequences such as the following, which simply split the difference between the page size and the text size, and then subtract one inch because of \TeX\ conventions: \begin{enumerate} -\item[For A$4$ paper (210~mm $\times$ 297~mm):]\quad\\[-2ex] +\item[For A$4$ paper, portrait mode (210~mm $\times$ 297~mm):]\quad\\[-2ex] \begin{verbatim} \hoffset=210mm\advance\hoffset-\hsize\divide\hoffset2 \advance\hoffset-1.0in \voffset=297mm\advance\voffset-\vsize\divide\voffset2 \advance\voffset-1.0in \end{verbatim} -\item[For letter-size paper (8.5~in $\times$ 11~in):] \quad\\[-2ex] +\item[For letter-size paper, portrait mode (8.5~in $\times$ 11~in):] \quad\\[-2ex] \begin{verbatim} \hoffset=8.5in\advance\hoffset-\hsize\divide\hoffset2 \advance\hoffset-1.0in @@ -105,6 +101,16 @@ and then subtract one inch because of \TeX\ conventions: \advance\voffset-1.0in \end{verbatim} \end{enumerate} + +To determine the maximal dimensions that \emph{your} printer is capable of, +process the standard file \verb|testpage.tex| with \LaTeX\ and +print the result. The ``rulers'' on four sides will indicate +how much of the one-inch ``margin'' material outside the frame can actually be printed. +Your \verb|\hsize| and \verb|\vsize| parameters can be increased, or, if necessary, decreased +accordingly. If your score is going to be printed by a publisher or a colleague, you can send +\verb|testpage.pdf| to them to determine what margins are necessary for their +printer. + However, if the margins on the \verb|testpage| output are \emph{not} symmetric, the printer is mis-aligned. @@ -116,7 +122,8 @@ for just \verb|musixtex| output using \verb|\advance\voffset ...| after the ``normal'' settings given above. -\pagebreak + + \section{Page numbering, headers and footers}\index{page number}\index{footnote} diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex index 7179d9b29ae..a6506ef27b4 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex @@ -681,24 +681,26 @@ use within a score. \begin{itemize}\setlength{\itemsep}{0ex} \item \keyindex{lpar}\verb|{|$p$\verb|}| and \keyindex{rpar}\verb|{|$p$\verb|}| yield left and right -parentheses at pitch $p$. They could be used to enclose notes or to build -\ital{cautionary} accidentals, although the latter are more easily -obtained with predefined macros (see Chapter~\ref{cautionary}). - -%avrb -For example, - +parentheses at pitch $p$. They can be used to enclose notes or to build +``big'' cautionary\index{cautionary accidental} accidentals. For example, +\\ +\begin{center} \begin{tabular}{ll} -\raisebox{-1.5ex}[0ex][0ex]{\musicintextnoclefn{\notes\bsk\lpar{g}\rpar{g}\hu{g}\sk% -\loffset{1.5}{\lpar{g}}\loffset{1.5}{\rpar{g}}\loffset{.4}{\sh g}\hu{g}\en}} -&\begin{tabular}{ll} -&\verb+\notes\lpar{g}\rpar{g}\hu{g}\sk%+\\ -is coded as&\verb+\loffset{1.5}{\lpar{g}}\loffset{1.5}{\rpar{g}}%+\\ -&\verb+\loffset{.4}{\sh g}\hu{g}\en}+ +\raisebox{-1.5ex}[0ex][0ex]{\musicintextnoclefn{\NOtes\qsk\lpar g\rpar g\hu g\sk% +\loffset{1.5}{\lpar g\rpar g}\loffset{.4}{\sh g}\hu g\sk% +\loffset{2.1}{\lpar g}\loffset{1.5}{\rpar g}\loffset{.4}{\dfl g}\hu g\en}} \end{tabular} +\end{center} +is coded as +\end{itemize} +\begin{center}\small +\begin{tabular}{l} +\verb+\NOtes\lpar g\rpar g\hu g\sk%+\\ +\verb+\loffset{1.5}{\lpar g\rpar g}\loffset{.4}{\sh g}\hu g\sk%+\\ +\verb+\loffset{2.1}{\lpar g}\loffset{1.5}{\rpar g}\loffset{.4}{\dfl g}\hu g\en+ \end{tabular} -%avre - +\end{center} +\begin{itemize} \item \keyindex{bracket}\verb|{|$p$\verb|}{|$n$\verb|}| posts a square bracket to the left of a chord, vertically spanning $n$ \verb|internote|s. @@ -742,7 +744,7 @@ For example, \endextract \end{music} \noindent is coded as -\begin{quote}\begin{verbatim} +\begin{quote}\small\begin{verbatim} \begin{music} \setstaffs1{2} \setclef1{\bass} diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/parameters.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/parameters.tex index 0acb3b56aa9..6cdd48b62f9 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/parameters.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/parameters.tex @@ -19,6 +19,8 @@ possible alteration by \keyindex{setsize}; \nochange. \item[\keyindex{internote} :]vertical spacing between notes one scale step apart in the current instrument, taking account of a possible alteration by \keyindex{setsize}; \nochange. +Note that each distinct instrument may have a different +\verb|\internote| (see Chapter~\ref{staffspacing}). \item[\keyindex{Internote} :]vertical spacing between notes one scale step apart in any instrument whose \keyindex{setsize} has the default value \keyindex{normalvalue} ($1.0$), equal to \verb|0.5\Interligne|; \nochange. @@ -32,15 +34,22 @@ Default is \verb|3\Interligne|. \item[\keyindex{interstaff} :]a very important macro with a single numerical argument representing the factor that multiplies \verb|2\internote| to give the distance between the bottom of one staff and the bottom of the next one. In -fact the macro redefines the parameter \verb|\interfacteur|. +fact the macro redefines the parameter \verb|\interfacteur|. Default is 9. +\verb|\interstaff| applies to all the +instruments; to set the inter-staff spacing for a single instrument, +use \keyindex{setinterstaff}\itbrace{n}\itbrace{m}, +$n$ is the instrument and $m$ is the replacement factor for that instrument. +Note that +after you have used \keyindex{setinterstaff}, +you cannot reset the distances for that instrument with +\keyindex{interstaff}; you must subsequently use +\keyindex{setinterstaff} for that purpose. \item[\keyindex{interportee} :]distance between the bottom of one staff and the bottom of the next one. It is always reset to -\verb|2|\keyindex{interfacteur}\verb|\internote| at the next system. +2 times \keyindex{internote} times the \keyindex{interfacteur} for the current +instrument at the next system. Therefore, trying to change \verb|\interportee| will have no effect. Change -\verb|\interstaff| instead. Further, note that \verb|\interstaff| applies to all the -instruments, but each distinct instrument may have a different -\verb|\internote| (see Chapter~\ref{staffspacing}). - +\verb|\interstaff| or use \keyindex{setinterstaff} instead. \item[\keyindex{interinstrument} :]additional vertical distance between two consecutive instruments. This means that the distance between the lowest line of the previous instrument and the lowest line of the top staff of the current @@ -53,7 +62,8 @@ value can be overridden for the space above any particular instrument with the macro \keyindex{setinterinstrument}\itbrace{n}\itbrace{s}, where $n$ is the instrument and $s$ is the replacement value of the space to be added. The \verb|\setinterinstrument| macro may be useful in some vocal -scores to provide vertical space for lyrics. Note that +scores to provide vertical space for lyrics. +Note that after you have used \keyindex{setinterinstrument}, you cannot reset the distances for that instrument with \keyindex{interinstrument}; you must subsequently use diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex index 3693223ac4c..606fc2df119 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/preparing.tex @@ -269,7 +269,9 @@ and \verb|\vnotes|) will be processed similarly; this is useful for correcting the spacing in single-instrument parts extracted from a multi-instrument score; see Section~\ref{musixtnt}. -The \texttt{autosp} package can be found at +The \texttt{autosp} package is available in +\href{https://www.tug.org/texlive/}{\underline{TeXLive}} (from 2016) and +can also be found at the \href{http://icking-music-archive.org/software/autosp/autosp.zip} {\underline{Werner Icking Music Archive}} or at diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex index 3f5b1943df5..cfac63093f0 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex @@ -219,6 +219,13 @@ To set an \itxem{instrument name}, use This will place the name in the space to the left of the first staff or group of staves for instrument $n$. To specify the amount of space available, use \verb|\parindent|$d$ where $d$ is any hard \TeX\ dimension. +For multi-line instrument names, use \TeX\ commands as in the following: +\begin{verbatim} + \setname1{\vbox{% + \hbox to\parindent{\hss Bass\hss}% + \hbox to\parindent{\hss Recorder\hss}}} +\end{verbatim} + \section{Groupings of instruments}\label{curlybrackets} By default, all staves in a system will be joined at the left by a thin, vertical rule. In addition, if an instrument has more than diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex index fa1300c5ffe..736b7b522b7 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex @@ -24,7 +24,7 @@ and then you will not have to install this font. Once the software mentioned in the prior two paragraphs is installed and the \TeX\ filename database is refreshed, the type~K package can be invoked by including the command \verb|\input musixps| -near the beginning of your source file. +near the beginning of your source file (but after loading \verb\musixtex.tex\). The resulting dvi file should then be converted into Postscript using \textbf{dvips}. If desired, a PDF file can then be generated with \textbf{ps2pdf}, \textbf{ghostscript}, or \textbf{Adobe Acrobat} (see Section~\ref{using} for more information on this). diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/smaller.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/smaller.tex index b90bcbc741f..987b6f6422e 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/smaller.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/smaller.tex @@ -1,5 +1,5 @@ -\chapter{Smaller Notes in Normal-Sized Staves} -Here we describe how to reduce the size of note symbols without changing the +\chapter{Smaller (or Larger) Notes in Normal-Sized Staves} +Here we describe how to change the size of note symbols without changing the size of the staff itself. Changing overall staff size will be treated in Chapter~\ref{staffspacing}. @@ -69,6 +69,8 @@ Haydn, J.}}, \notes&\sk\tbbl0\tbl0\qb0J|\tbl1\zq c\qb1e\en \endextract \end{verbatim}\end{quote} +Similarly, you may use +\keyindex{largenotesize} or \keyindex{Largenotesize} to get \emph{larger} notes. \section{Grace notes} Grace notes are a special case of small and tiny notes, namely single-stemmed diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/transposition.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/transposition.tex index 0303abac690..4fc9e9d6096 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/transposition.tex +++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/transposition.tex @@ -9,43 +9,39 @@ not otherwise alter the appearance of the score, which we'll call \section{Logical transposition and octaviation} Logical transposition is controlled by an integer-valued \TeX\ register -\keyindex{transpose}. Its default value is 0. If you enter -\verb|\transpose=|$n$, then all subsequent pitches specified by +\keyindex{transpose}. Its default value is $0$. If you enter +\verb|\transpose=|$n$ outside of notes commands, then all subsequent pitches specified by letters will be transposed by $n$ positions. Normally this method would be used to transpose an entire piece. Pitches specified with numbers will not be affected, so if you think you will ever want to transpose a piece, you should enter all note pitches with letters. -One way to transpose up or down by one octave would be to set -\keyindex{transpose} to $7$ or $-7$. For example, to make a quarter note -octave as a chord, you could define a macro as -\verb|\def\soqu#1{\zq{#1}{\transpose=7 \qu{#1}}}|. -Note that because \verb|\transpose| is altered inside a pair of braces, the -effect of the alteration is only local and does not reach outside the braces. - - Another more convenient way to transpose locally up or down by one octave +One way to transpose up or down by one octave would be to increase or decrease +\keyindex{transpose} by $7$. +A more convenient way to transpose locally up or down by one octave makes use respectively of the characters \verb|'| (close-quote, interpreted as an \itxem{acute accent}) and \verb|`| (open-quote, interpreted as a \itxem{grave accent}), placed immediately before the letter specifying the pitch. So for example \verb|\qu{'ab}| is equivalent to \verb|\qu{hi}| and \verb|\qu{`kl}| is equivalent to \verb|\qu{de}|. These characters have -cumulative effects but in a somewhat restricted sense. They will alter the value of -\verb|\transpose|, but only until changing to a different staff or -instrument or encountering \verb|\en|, at which time it will be reset to the +cumulative effects; thus, +for example, \verb|\qu{''A'A}| and \verb|\qu{''A}\qu{'A}| are both equivalent to \verb|\qu{ah}|. +Alterations to the value of +\verb|\transpose| in notes commands are \emph{local}: when changing to a different staff or +instrument or encountering \verb|\en|, \verb|\transpose| will be reset to the value it had before the accents were used. (That value is stored in -another register called \keyindex{normaltranspose}). Thus for example -\verb|\qu{''A'A}| and \verb|\qu{''A}\qu{'A}| -are both equivalent to \verb|\qu{ah}|. +another register called \keyindex{normaltranspose}). Another way to localize +changes to \verb|\transpose| is to create an explicit \TeX\ ''group'' by enclosing commands in \verb|{...}| braces. At any point it is possible to reset the \verb|\transpose| register -explicitly to the value it had -when entering \verb|\notes|, by prefacing a pitch indication with +explicitly to the \verb|\normaltranspose| value +by prefacing a pitch indication with ``\verb|!|''. Thus \verb|\qu{!a'a}| always gives the note \verb|a| and its upper octave \verb|h|, shifted by the -value of {\Bslash transpose} at the beginning of the current -\verb|\notes...\en| group, regardless of the number of grave and -acute accents occurring previously within that group. +value of {\Bslash normaltranspose}, +regardless of the number of grave and +acute accents earlier in that group. \section{Behavior of accidentals under logical transposition}\label{transposeaccids} The above processes indeed change the vertical position of the note heads diff --git a/Master/texmf-dist/doc/generic/musixtex/musixtex-install.pdf b/Master/texmf-dist/doc/generic/musixtex/musixtex-install.pdf Binary files differindex 6c3622be664..c29c72bb3b5 100644 --- a/Master/texmf-dist/doc/generic/musixtex/musixtex-install.pdf +++ b/Master/texmf-dist/doc/generic/musixtex/musixtex-install.pdf |