summaryrefslogtreecommitdiff
path: root/macros/musixtex/doc/musixdoc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-10-09 03:05:28 +0000
committerNorbert Preining <norbert@preining.info>2023-10-09 03:05:28 +0000
commit55c62aa6d5cc8ce94c28ac255b66a13ccd2375b2 (patch)
tree1b5eb4f2e66d4ee007cac50ea4d0f34c11cda50f /macros/musixtex/doc/musixdoc
parent9f6bac4b7884af8d5a457275e30fc5e253ff9de8 (diff)
CTAN sync 202310090305
Diffstat (limited to 'macros/musixtex/doc/musixdoc')
-rw-r--r--macros/musixtex/doc/musixdoc/extensions.tex85
-rw-r--r--macros/musixtex/doc/musixdoc/frontmatter.tex2
-rw-r--r--macros/musixtex/doc/musixdoc/miscellaneous.tex2
-rw-r--r--macros/musixtex/doc/musixdoc/smaller.tex2
4 files changed, 89 insertions, 2 deletions
diff --git a/macros/musixtex/doc/musixdoc/extensions.tex b/macros/musixtex/doc/musixdoc/extensions.tex
index d2bdd3d75a..c11c389efa 100644
--- a/macros/musixtex/doc/musixdoc/extensions.tex
+++ b/macros/musixtex/doc/musixdoc/extensions.tex
@@ -1689,6 +1689,91 @@ These are generated by, respectively,
\end{tabular}
\end{list}
+ \section{musixmtab}\index{tablature}\index{musixmtab@{\tt musixmtab.tex}}\label{mtab}
+
+Modern instrumentalists of string instruments (guitar, banjo, mandolin, etc.)
+use a hybrid form of tablature in which notes have (downward) stems and beams attached.%
+\footnote{It seems this ``modern'' form of tablature was introduced by Pete Seeger in his 5-string banjo
+instruction book, first published in 1948.}
+The \verb\musixmtab\\index{musixmtab} package combines traditional Gelten-style tablature notation
+already in \musixtex\ with the stems and beams of standard music notation.
+It is assumed that there is at most one beam (beam number $0$) and that all stems are downward.
+
+In the following commands,
+\{$s$\} is a string number (counting from the top) and \{$n$\} is a numerical note (i.e., fret number).
+
+\begin{center}
+\begin{tabular}{ll}
+\keyindex{uh}\{$s$\}\{$n$\} & a half note (boxed, to differentiate from a quarter note)\\
+\keyindex{zuh}\{$s$\}\{$n$\} & a non-spacing stemless half note\\
+\keyindex{uq}\{$s$\}\{$n$\} & a quarter note (with a centered stem)\\
+\keyindex{uc}\{$s$\}\{$n$\} & an eighth note (with a flag)\\
+\keyindex{ucc}\{$s$\}\{$n$\} & a sixteenth note (with a double flag)\\
+\keyindex{zu}\{$s$\}\{$n$\} & a non-spacing stemless quarter, eighth or sixteenth note\\
+\keyindex{uib}\{$s$\}\{$l$\} & initiate a single beam; $s$ is the starting string and $l$ is the slope\\
+\keyindex{uibb}\{$s$\}\{$l$\} & initiate a double beam; $s$ is the starting string and $l$ is the slope\\
+\keyindex{ub}\{$s$\}\{$n$\} & a beamed note\\
+\keyindex{unbb} & increase the beam multiplicity to 2\\
+\keyindex{utbb} & decrease the beam mutiplicity to 1 after the following note\\
+\keyindex{utb} & terminate the beam after the following note\\
+\keyindex{utq}\{$s$\}\{$n$\} & terminate the beam after this note\\
+
+\end{tabular}
+\end{center}
+Conventional \musixtex\ commands such as \verb|pt| and \verb|arpeggio| may be used but arguments must reference \musixtex\ note
+designations rather than string numbers.
+
+Here is an example, {\it Cripple Creek}, for 5-string banjo in standard G tuning, clawhammer style:
+
+\begin{music}
+\parindent=2ex
+\input musixmtab
+\setclefsymbol1\tabclef\setsize1{\largevalue}\setsign10
+\setname1{\tabstringfnt\baselineskip=1.2\internote%
+\vbox{\hbox{D}\hbox{B}\hbox{G}\hbox{D}\hbox{\ g}}}
+\generalmeter{\meterfrac24}
+\startbarno1
+\nobarnumbers
+\nostartrule
+\startpiece\addspace\afterruleskip
+\notes\uibb40\ub12\lcn{10}{\it SL}\ub15\zu15\zu20\ub30\utq50\en
+\notes\uibb40\ub10\ccn{10}{\it T}\ub20\ub10\utq50\en
+\bar%2
+\Notes\uib24\ub21\utq12\en
+\Notes\uib40\ub10\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\bar%3
+\notes\uibb40\ub12\lcn{10}{\it SL}\ub15\zu15\zu20\ub30\utq50\en
+\notes\uibb40\ub10\ccn{10}{\it T}\ub20\ub10\utq50\en
+\bar%4
+\notes\uibb2{-2}\ub21\utbb\ccn9{\it P}\ub20\en
+\Notes\utq32\en
+\Notes\uib40\ub30\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\setrightrepeat
+\alaligne
+\zleftrepeat
+\notes\uibb40\ub32\lcn{9}{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\notes\uibb3{-1}\ub32\utbb\ccn9{\it P}\ub30\utq42\en
+\bar
+\notes\uibb40\ub32\lcn9{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\Notes\uib40\ub40\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\bar
+\notes\uibb40\ub32\lcn9{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\notes\uibb4{-1}\ub32\ccn9{\it P}\ub30\ub42\ccn9{\it P}\utq40\en
+\bar
+\notes\uibb40\ub40\ccn9{\it H}\ub42\zu10\zu20\ub30\utq50\en
+\Notes\uib40\ub30\en
+\Notes\unbb\zu10\zu20\ub30\utq50\en
+\zrightrepeat
+\qspace
+\NOtes\arpeggio05\zuh10\zuh20\zuh30\zuh40\uh50\en
+\Endpiece
+
+\end{music}
+
+
\section{musixper}\label{perc}
Provides special symbols intended for percussion parts. Included are a
diff --git a/macros/musixtex/doc/musixdoc/frontmatter.tex b/macros/musixtex/doc/musixdoc/frontmatter.tex
index 6079e9b04d..e62408b2ac 100644
--- a/macros/musixtex/doc/musixdoc/frontmatter.tex
+++ b/macros/musixtex/doc/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.36}
+instrumental music\\\Large\itshape Version 1.37}
\author{}
diff --git a/macros/musixtex/doc/musixdoc/miscellaneous.tex b/macros/musixtex/doc/musixdoc/miscellaneous.tex
index 7b568bda91..6b1cbf4fe5 100644
--- a/macros/musixtex/doc/musixdoc/miscellaneous.tex
+++ b/macros/musixtex/doc/musixdoc/miscellaneous.tex
@@ -1093,3 +1093,5 @@ 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}.
+See extension libraries in Section~\ref{frenchtab} and \ref{mtab} for ``french'' and ``modern''
+variants, respectively.
diff --git a/macros/musixtex/doc/musixdoc/smaller.tex b/macros/musixtex/doc/musixdoc/smaller.tex
index 987b6f6422..8a50b8e596 100644
--- a/macros/musixtex/doc/musixdoc/smaller.tex
+++ b/macros/musixtex/doc/musixdoc/smaller.tex
@@ -105,7 +105,7 @@ example:
\end{verbatim}\end{quote}
\section[Ossia]{Ossia\texorpdfstring{\protect\footnote{Italian \textit{o sia} (or else)}}{}}
-This clever example had been provided by Olivier Vogel:\label{ossia}
+This clever example had been provided by Olivier Vogel:\label{ossia}\index{ossia}
%\begin{center}
%\includegraphics[scale=1]{./mxdexamples/ossiavogel.eps}