musixtex (5aug18)

git-svn-id: svn://tug.org/texlive/trunk@48353 c570f23f-e606-0410-a88d-b1316a301751

10 files changed, 188 insertions, 25 deletions

diff --git a/Master/texmf-dist/doc/generic/musixtex/ChangeLog-129.txt b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-129.txt
new file mode 100644
index 00000000000..780d4cef33e
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/musixtex/ChangeLog-129.txt
@@ -0,0 +1,6 @@
+
+Changes from MusiXTeX 128 to 129:
+
+ * introduced support for tablature notation: \tabfnt,
+   \tabcleffnt, \tabstringfnt, \tabstylespace, \tab, \ztab,
+   etc.
diff --git a/Master/texmf-dist/doc/generic/musixtex/README b/Master/texmf-dist/doc/generic/musixtex/README
index 84374a87110..aebd633e312 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.28 (2018-05-07).
+This is MusiXTeX, version 1.29 (2018-08-04).
 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
index 0bbde1ea6c3..d2b3b793db2 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/frontmatter.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex
index 96e47348d88..42d4e645c0f 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/frontmatter.tex
@@ -1,6 +1,7 @@
 \title{\Huge\bfseries\musixtex\\[\bigskipamount]
 \LARGE\bfseries Using \TeX{} to write polyphonic\\or
-instrumental music\\\Large\itshape Version 1.28}
+instrumental music\\\Large\itshape Version 1.29}
+\author{}
 
 
 %\author{\Large\rm Daniel \sc Taupin\\\large\sl
@@ -61,13 +62,13 @@ on earlier work by Andrea Steinbach and Angelika Schofer.
 Unfortunately, Daniel Taupin, the main developer, died all too early in a 2003
 climbing accident. The \musixtex\ community was shocked by this tragic and unexpected
 event. You may read tributes to Daniel Taupin that are archived at the
-\href{http://icking-music-archive.org}{\underline{Werner Icking Music Archive}}.
+\href{http://icking-music-archive.org}{\underline{Werner Icking Music Archive}} (WIMA\index{WIMA}).
 
 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. 
 This manual
 is the definitive reference to all features of
-\musixtex\ version~1.27.
+\musixtex\ version~1.29.
 
 Novice users need not start here.
 Most 
@@ -91,7 +92,7 @@ generating input files, other than \TeX-oriented integrated
 graphical development environments such as \TeX Works.
 
 The \href{http://icking-music-archive.org/software/indexmt6.html}
-{\underline{Werner Icking Music Archive}}\ (WIMA) contains excellent and detailed
+{\underline{Werner Icking Music Archive}} contains excellent and detailed
 instructions for installing \TeX, \musixtex{} and the strongly recommended
 preprocessors \textbf{PMX}
 and \mbox{\textbf{M-Tx}} on
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex
index 6efd0ec7d27..50be2c03442 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/miscellaneous.tex
@@ -760,7 +760,7 @@ For example,
 \NOtes\lpar c\rpar c\qu c\en
 \NOtes\unbkt C15\qu {FH}|\ovbkt n14\ql{kl}\en
 \NOtes\downtrio C16\qu {FH}|\uptrio o14\ql{lm}\en
-\NOtesp\roffset{1.5}{\slide J33}\qa{JM}|\roffset{1.5}{\slide j33}\qa{jm}\en
+\NOtesp\roffset{1.5}{\slide J33}\ca{JM}|\roffset{1.5}{\slide j33}\ca{jm}\en
 \endextract
 \end{music}
 \noindent is coded as
@@ -774,7 +774,7 @@ For example,
 \NOtes\lpar c\rpar c\qu c\en
 \NOtes\unbkt C15\qu {FH}|\ovbkt n14\ql{kl}\en
 \NOtes\downtrio C16\qu {FH}|\uptrio o14\ql{lm}\en
-\NOtesp\roffset{1.5}{\slide J33}\qa{JM}|\roffset{1.5}{\slide j33}\qa{jm}\en
+\NOtesp\roffset{1.5}{\slide J33}\ca{JM}|\roffset{1.5}{\slide j33}\ca{jm}\en
 \zendextract
 \end{music}
 \end{verbatim}\end{quote}
@@ -821,3 +821,138 @@ The coding is
 \NOTes\ha{HIJK}&\ha{efgh}&\ha{hijk}&\ha{hmlk}\en
 \endextract
 \end{verbatim}\end{quote}
+
+
+\section{Tablature}
+Tablature is a notational system used for fretted stringed instruments such
+as lute, guitar, banjo, mandolin, and so on.  Staff lines represent strings
+and conventional note heads are replaced by numbers (or sometimes letters)
+indicating which fret is to be stopped, with $0$ representing an open string.
+
+A special clef symbol 
+\keyindex{tabclef} may be used with \verb|\setclefsymbol| for a tablature staff; commands \verb|\setlines|, \verb|\setsign|
+and \verb|\setsize| may be used as usual for a tablature staff.  The macros that put numbers (or letters) on staff lines
+are as follows:
+\begin{itemize}
+\item \keyindex{tab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+puts $p$ on string $n$
+(counting from top to bottom); $p$ is centered, using \verb|\ccharnote|.
+Ledger lines are added for $n$ less than $1$ or greater than the current number of staff lines.
+\item \keyindex{ltab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+uses \verb|\zcharnote| so $p$
+spills to the right and
+\keyindex{rtab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+uses \verb|\lcharnote| so $p$
+spills to the left.
+\item \keyindex{ztab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+is a non-spacing \verb|\tab|, and can be used for building chords. 
+\item \keyindex{zltab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+is a non-spacing \verb|\ltab| and
+\keyindex{zrtab}\verb|{|$n$\verb|}|\verb|{|$p$\verb|}| 
+is a non-spacing \verb|\rtab|.
+\end{itemize}
+A size-dependent font \keyindex{tabfnt} is used for tab characters; Helvetica is the default font family.
+
+The default tablature style is to place the fingering notations \emph{on} the staff line;
+Postscript specials are used to ``blank'' staff lines below
+the tab characters.  
+If it is desired to locate the fingering notations \emph{above} staff lines, use
+the command \keyindex{tabstylespacetrue}.
+A size-dependent font \keyindex{tabstringfnt} is defined to allow string names to be
+listed using \verb|\setname|.
+
+Here is an example of a guitar tablature (6th string lowered to D):
+
+\begin{music}
+\input musixps
+\def\psslurhgt{0.5}
+\instrumentnumber{2}
+\songbottom1\songtop2
+\generalmeter{\meterfrac34}
+\generalsignature{-1}
+\setlines16
+\setclefsymbol1\tabclef\setclefsymbol2\treblelowoct
+\setsize1\largevalue
+\setsign10
+\nobarnumbers
+\interinstrument=4\internote
+\parindent=2ex
+\setname1{\tabstringfnt\baselineskip=1.5\internote%
+          \vbox{\hbox to\parindent{\hss E \hss}%
+                \hbox to\parindent{\hss B \hss}%
+                \hbox to\parindent{\hss G \hss}%
+                \hbox to\parindent{\hss D \hss}%
+                \hbox to\parindent{\hss A \hss}%
+                \hbox to\parindent{\hss D \hss}%
+}}
+\startextract
+\NOtesp\zltab55\zltab43\ltab32&\zh{d}\zhl{f}\qu{.h}\en
+\Notes\ltab32&\cu{h}\en
+\bar%
+\NOtes\zltab55\zltab45\zltab33\ltab10&\zq d\zql g\zq i\qu l\en
+\NOtesp\zltab54\zltab45\zltab32\ltab10&\rhl{^c}\rhu{g}\zh{h}\qu{.l}\en
+\Notes\ltab10&\cu{l}\en
+\bar%
+\NOtes\zltab40\zltab32\zltab23\ltab11&\zq d\zq h\zq k\qu{m}\en
+\NOtes\zltab51\zltab43\zltab33\ltab23&\zhl b\zh f\zq{.i}\qu{.k}\en
+\Notes\ltab35&\cu j\en
+\bar%
+\NOtes\zltab65\zltab45\ltab33&\zql N\zq g\qu i\en
+\NOtes\zltab50\zltab43\ltab32&\zql a\zq f\qu h\en
+\notes\zltab54\ltab45\ilsluru04\ltab43\ltab42\tlslur04\ltab43%
+&\zql{^c}\ibbu0g{-1}\qb0{g}\slur eed2\qb0{fe}\tqu0f\en
+\bar%
+\notes\zltab60\zltab50\ltab45\ilsluru04\ltab42\ltab43\tlslur04\ltab40%
+&\zq K\zql a\ibbu0g{-1}\qb0g\slur edd2\qb0e\qb0f\tqu0d\en
+\znotes&\lcn{14}{J.S. Bach}\en
+\zendextract
+\end{music}
+
+\noindent
+The coding is
+\begin{footnotesize}
+\begin{quote}\begin{verbatim}
+\instrumentnumber{2}
+\songbottom1\songtop2
+\setclefsymbol2\treblelowoct
+\generalmeter{\meterfrac34}
+\generalsignature{-1}
+\setlines16\setclefsymbol1\tabclef\setsize1\largevalue\setsign10
+\nobarnumbers
+\interinstrument=4\internote
+\parindent=2ex
+\setname1{\tabstringfnt\baselineskip=1.5\internote%
+          \vbox{\hbox to\parindent{\hss E\hss}%
+                \hbox to\parindent{\hss B\hss}%
+                \hbox to\parindent{\hss G\hss}%
+                \hbox to\parindent{\hss D\hss}%
+                \hbox to\parindent{\hss A\hss}%
+                \hbox to\parindent{\hss D\hss}}}
+\startextract
+\NOtesp\zltab55\zltab43\ltab32&\zh{d}\zhl{f}\qu{.h}\en
+\Notes\ltab32&\cu{h}\en
+\bar%
+\NOtes\zltab55\zltab45\zltab33\ltab10&\zq d\zql g\zq i\qu l\en
+\NOtesp\zltab54\zltab45\zltab32\ltab10&\rhl{^c}\rhu{g}\zh{h}\qu{.l}\en
+\Notes\ltab10&\cu{l}\en
+\bar%
+\NOtes\zltab40\zltab32\zltab23\ltab11&\zq d\zq h\zq k\qu{m}\en
+\NOtes\zltab51\zltab43\zltab33\ltab23&\zhl b\zh f\zq{.i}\qu{.k}\en
+\Notes\ltab35&\cu j\en
+\bar%
+\NOtes\zltab65\zltab45\ltab33&\zql N\zq g\qu i\en
+\NOtes\zltab50\zltab43\ltab32&\zql a\zq f\qu h\en
+\notes\zltab54\ltab45\ilsluru04\ltab43\ltab42\tlslur04\ltab43%
+&\zql{^c}\ibbu0g{-1}\qb0{g}\slur eed2\qb0{fe}\tqu0f\en
+\bar%
+\notes\zltab60\zltab50\ltab45\ilsluru04\ltab42\ltab43\tlslur04\ltab40%
+&\zq K\zql a\ibbu0g{-1}\qb0g\slur edd2\qb0e\qb0f\tqu0d\en
+\znotes&\lcn{14}{J.S. Bach}\en
+\zendextract
+\end{verbatim}\end{quote}
+\end{footnotesize}
+Tablature support in \musixtex\ has been adapted
+from \verb|tabdefs.tex| by R.J.~Gelten, which is available 
+\href{http://icking-music-archive.org/software/musixtex/add-ons/tabdefs.tex}
+{\underline{here}}
+at WIMA\index{WIMA}.
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/musixdoc.pdf b/Master/texmf-dist/doc/generic/musixtex/musixdoc/musixdoc.pdf
index 0bbde1ea6c3..d2b3b793db2 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/musixdoc.pdf
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/musixdoc.pdf
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex
index da410cc92e5..5de88fc3e64 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/settingup.tex
@@ -85,7 +85,8 @@ stem lengths, etc.
 number of instruments to be $n$. If not entered, the default is $1$. This number is used in loops
 that build staves,
 set key signatures, set meters, etc., so if it differs from $1$ it must be explicitly
-defined before any further commands.
+defined before any further commands.  The default maximum number of instruments is $6$
+but this can be increased by using \keyindex{setmaxinstruments}\onen.
 
 \subsection{Number of staves per instrument}
 
@@ -128,7 +129,7 @@ $s=1$ to $4$ mean C-clef, respectively on the first (lowest) through fourth staf
 $1$ is also called \ital{soprano}, $3$ \ital{alto} and $4$ \ital{tenor}.
 $s=5$ to $s=7$ mean F-clef, respectively on the third through fifth staff line. $5$ is
 also called \ital{baritone} and $6$ is the normal \ital{bass}.
- $s=8$ is not used.
+ $s=8$ is used to specify an ``empty'' clef.
 $s=9$ represents a G clef on the first line, also called \ital{French violin} clef.
 
 The three tokens \verb|\treble|, \verb|\alto|, and \verb|\bass| can be used instead
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex
index 736b7b522b7..b7bfca7d649 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesTypeK.tex
@@ -58,6 +58,11 @@ You can shift the starting or ending point slightly to the left
 or right by substituting one of the commands \keyindex{ilsluru},
 \keyindex{ilslurd}, \keyindex{irsluru},
 \keyindex{irslurd}, \keyindex{trslur} or \keyindex{tlslur}.
+For shifts farther to the left, use
+\keyindex{iLsluru},
+\keyindex{iLslurd} 
+or \keyindex{tLslur}.
+
 
 You can control the shape of type~K slurs with variants of
 the termination command. To make the slur a bit flatter than default use
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesfont.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesfont.tex
index 1a671d44a2b..8674dc02e98 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesfont.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc/slurstiesfont.tex
@@ -236,26 +236,45 @@ For example,
 
 \begin{music}\nostartrule
 \startextract
-\NOtes\multnoteskip8\isluru0g\ql g\en
-\notes\tslur0g\ql g\en
+\NOtes\multnoteskip8\isluru0i\ql i\en
+\notes\tslur0i\ql i\en
 \zendextract
 \startextract
-\NOtes\multnoteskip8\isluru0g\ql g\en
-\notes\midslur7\tslur0g\ql g\en
+\NOtes\multnoteskip8\isluru0i\ql i\en
+\notes\midslur7\tslur0i\ql i\en
 \zendextract
 \startextract
-\NOtes\multnoteskip8\isluru2g\ql g\en
-\notes\midslur{11}\tslur2g\ql g\en
+\NOtes\multnoteskip8\isluru2i\ql i\en
+\notes\midslur{11}\tslur2i\ql i\en
 \zendextract
 \end{music}
 \noindent was coded as
 \begin{quote}\begin{verbatim}
-\NOtes\multnoteskip8\isluru0g\ql g\en
-\notes\tslur0g\ql g\en
-\NOtes\multnoteskip8\isluru0g\ql g\en
-\notes\midslur7\tslur0g\ql g\en
-\NOtes\multnoteskip8\isluru2g\ql g\en
-\notes\midslur{11}\tslur2g\ql g\en
+\NOtes\multnoteskip8\isluru0i\ql i\en
+\notes\tslur0i\ql i\en
+\NOtes\multnoteskip8\isluru0i\ql i\en
+\notes\midslur7\tslur0i\ql i\en
+\NOtes\multnoteskip8\isluru2i\ql i\en
+\notes\midslur{11}\tslur2i\ql i\en
+\end{verbatim}\end{quote}
+For downward slurs, use negative values; for example,
+
+\begin{music}\nostartrule
+\startextract
+\NOtes\multnoteskip8\islurd0i\qu i\en
+\notes\tslur0i\qu i\en
+\zendextract
+\startextract
+\NOtes\multnoteskip8\islurd0i\qu i\en
+\notes\midslur{-7}\tslur0i\qu i\en
+\zendextract
+\end{music}
+\noindent was coded as
+\begin{quote}\begin{verbatim}
+\NOtes\multnoteskip8\islurd0i\qu i\en
+\notes\tslur0i\qu i\en
+\NOtes\multnoteskip8\islurd0i\qu i\en
+\notes\midslur{-7}\tslur0i\qu i\en
 \end{verbatim}\end{quote}
 
 The macro \keyindex{curve}$hij$ allows more precise control over the shape
@@ -289,12 +308,8 @@ the slur termination. The example below illustrates the use of \verb|\curve|.
 \begin{quote}\begin{verbatim}
 \NOtes\multnoteskip8\itieu0g\ql g\en
 \notes\ttie0\ql g\en
-\zendextract
-\startextract
 \NOtes\multnoteskip8\itieu1g\ql g\en
 \notes\curve 322\ttie1\ql g\en
-\zendextract
-\startextract
 \NOtes\multnoteskip8\itieu2g\ql g\en
 \notes\curve 111\ttie2\ql g\en
 \end{verbatim}\end{quote}
diff --git a/Master/texmf-dist/doc/generic/musixtex/scripts/musixtex.pdf b/Master/texmf-dist/doc/generic/musixtex/scripts/musixtex.pdf
index 4b99770a501..e8caf62c92e 100644
--- a/Master/texmf-dist/doc/generic/musixtex/scripts/musixtex.pdf
+++ b/Master/texmf-dist/doc/generic/musixtex/scripts/musixtex.pdf