summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/musixtex/musixdoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/musixtex/musixdoc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/musixtex/musixdoc.tex638
1 files changed, 354 insertions, 284 deletions
diff --git a/Master/texmf-dist/doc/generic/musixtex/musixdoc.tex b/Master/texmf-dist/doc/generic/musixtex/musixdoc.tex
index 17cafecb4c9..988f87f7046 100644
--- a/Master/texmf-dist/doc/generic/musixtex/musixdoc.tex
+++ b/Master/texmf-dist/doc/generic/musixtex/musixdoc.tex
@@ -1,8 +1,4 @@
%
-% mxdoc111d.tex (formerly file 110d, internally called 109d1)
-% Different from version posted in that it has the extra paragraph
-% "You may wonder ..." in section 1.3
-%
% This file is part of MusiXTeX
%
% MusiXTeX is free software; you can redistribute it and/or modify
@@ -20,20 +16,17 @@
% the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
% Boston, MA 02111-1307, USA.
%
-% This version 109d1 postdates the one posted to the site.
%
-
-\ifx\documentclass\undefined
- \documentstyle[twoside,11pt,musixdoc,multicol,backgrnd]{report}
-\else
- \documentclass[twoside,11pt,a4paper]{report}
- \usepackage{multicol}
- \usepackage{musixdoc}
- \usepackage{etex}
- \usepackage[dvips,bookmarks=true,bookmarksnumbered=true,bookmarksopen=true,colorlinks=true,pdfborder={0 0 0}]{hyperref}
- \usepackage{url}
- \usepackage{indentfirst}
- \usepackage[ansinew]{inputenc}
+% musixdoc.tex : the document
+%
+\documentclass[twoside,11pt,a4paper]{report}
+\usepackage{multicol}
+\usepackage{musixdoc}
+\usepackage{etex}
+\usepackage[dvips,bookmarks=true,bookmarksnumbered=true,bookmarksopen=false,colorlinks=true,pdfborder={0 0 0},pdfstartview={FitH},pdfmenubar=false]{hyperref}
+\usepackage{url}
+\usepackage{indentfirst}
+\usepackage[ansinew]{inputenc}
\makeatletter
\def\notesintext#1{% no staff lines, no clefs
{\let\extractline\relax
@@ -57,7 +50,7 @@
\nobarnumbers
\staffbotmarg0pt \setclefsymbol1\empty
\startextract\addspace{-\afterruleskip}#1\endextract}}
-\fi
+
\def\musictex{Music\TeX{}}
\def\onen{{\tt\char123}$n${\tt\char125}}
\def\pitchp{{\tt\char123}$p${\tt\char125}}
@@ -74,25 +67,17 @@
%\changebarsep 10 pt
\title{\Huge\bf\musixtex\raise1.5ex\hbox{\large\copyright}\\[\bigskipamount]
\LARGE\bf Using \TeX{} to write polyphonic\\or
-instrumental music\\\Large\sl Version T.114~-- June, 2006}
+instrumental music\\\Large\sl Version 1.15~-- April, 2011}
\author{\Large\rm Daniel \sc Taupin\\\large\sl
Laboratoire de Physique des Solides\\\normalsize\sl
(associ\'e au CNRS)\\\normalsize\sl
-% b\^atiment 510, Centre Universitaire, F-91405 ORSAY Cedex\\ E-mail : {\tt
-%taupin@lps.u-psud.fr}\\\medskip
b\^atiment 510, Centre Universitaire, F-91405 ORSAY Cedex\\\medskip
\\\Large\rm Ross \sc Mitchell\\\large\sl
CSIRO Division of Atmospheric Research,\\\normalsize\sl
Private Bag No.1, Mordialloc, Victoria 3195,\\ Australia \\\medskip
-% \\\Large\rm Andreas \sc Egler\ddag\\\large\sl
\\\Large\rm Andreas \sc Egler\\\large\sl
(Ruhr--Uni--Bochum)\\ Ursulastr. 32\\ D-44793 Bochum}
\date{}
-%\let\endtitleORI\endtitlepage
-% \def\endtitlepage{\vfill\noindent $^\ddag$ {\it For personal reasons, Andreas
-%Egler decided to retire from authorship of this work. Nevertherless, he has
-%done an important work about that, and I decided to keep his name on this
-%first page. {\sc D. Taupin}}\endtitleORI}
\maketitle
\clearpage
%\check
@@ -105,12 +90,6 @@ instrumental music\\\Large\sl Version T.114~-- June, 2006}
\vfill
\begin{flushright}\it
-%.. All the possible is done,\\
-%the impossible is being done,\\
-%for miracles I ask for some delay.\\[\smallskipamount]
-%{\sc N.N.}\\[\bigskipamount]
-%...~time after time~...\\[\smallskipamount]
-%{\sc Cindy Lauper}\\[\bigskipamount]
If you are not familiar with \TeX{} at all\\
I would recommend to find another software\\
package to do musical typesetting.\\
@@ -181,8 +160,7 @@ the inclusion of lyrics.
\bigskip
\begin{flushright}
-In the name of the community, Olivier Vogel
-(\href{mailto:oliviervogel@freesurf.ch}{\url{oliviervogel@freesurf.ch}}),
+In the name of the community, Olivier Vogel,
July 30, 2005
\end{flushright}
@@ -225,6 +203,69 @@ Postscript slur facilities.
Don Simons, Andre van Ryckeghem, Cornelius Noack, August 30, 2005
\end{flushright}
+\chapter*{Preface to Version 1.15}
+
+From the time of \musixtex's predecessor \musictex\ until the
+previous version of \musixtex~(T.114),
+the maximum numbers of simultaneous appearances of certain basic musical
+elements were limited:
+12 instruments, 12 or 6 beams depending on the type,
+12 font-based slurs%
+\footnote{\texttt{musixps.tex} by Stanislav Kneifl provides different limits.}%
+, and 6 trills or octave lines,
+even with \texttt{musixmad.tex}.
+For some purposes these limits are too tight, and because of them,
+developers of open-source GUI music editors may deem \musixtex{}
+unworthy of support in their software. Without such support or enhanced capacity,
+\musixtex{} risks consignment to the junk heap of obsolete software.
+
+It has been the \musixtex{} community's long-cherished desire to have a
+new official version with greater capacity. However, for quite some time
+the limits were due not only to the design of
+\musixtex{} itself but also to limitations in older versions of \TeX\ on the maximum
+numbers of available registers---256 each
+for counts (\texttt{\string\count}), dimensions (\texttt{\string\dimen}),
+skips (\texttt{\string\skip}), and tokens (\texttt{\string\toks}).
+
+But now, an extended variation of
+\TeX{}---$\varepsilon$\hbox{-}\nobreak\TeX---is available.\footnote{
+$\varepsilon$\hbox{-}\nobreak\TeX{} (e-\TeX) is a trademark
+of the NTS group.}
+One of $\varepsilon$\hbox{-}\nobreak\TeX's features is that it can handle
+32768 registers. Furthermore,
+ \LaTeXe\ and other well-known extension packages require the
+$\varepsilon$\hbox{-}\nobreak\TeX{} engine,
+so it has spread widely among many \TeX\ users.
+In fact, the current executable file called \texttt{latex}
+relies on the $\varepsilon$\hbox{-}\nobreak\TeX{} engine.
+Many other advanced branches based on $\varepsilon$\hbox{-}\nobreak\TeX{}
+are also available.
+
+Here we provide the new \musixtex{} 1.15 as the solution for typesetting larger
+musical scores,
+taking advantage of $\varepsilon$\hbox{-}\nobreak\TeX's 32768-register capacity.
+We have made the new version 1.15 as compatible as possible with
+earlier versions of \musixtex, existing scores, extension packages,
+and Prof.~Knuth's original (non~$\varepsilon$\hbox{-}\nobreak) \TeX.
+With it, you can use many more instruments and other musical elements within the capacity of
+$\varepsilon$\hbox{-}\nobreak\TeX{} or even with original \TeX.
+Also, as of version 2.6, the preprocessor \textbf{PMX} has been enhanced to
+allow up to 24 lines of music, and requires both \musixtex{} 1.15 and
+$\varepsilon$\hbox{-}\nobreak\TeX.\footnote{This should pose no problems for
+users, owing
+to the free availability of all the software, and to capacities of all modern
+computer hardware.}
+Unfortunately, we have found a few rarely used old extensions
+not compatible with 1.15;
+we will provide information for adapting them to the new version.
+
+We hope the new version 1.15 will keep \musixtex{} relevant well into the twenty-first century.
+
+
+\begin{flushright}
+Hiroaki Morimoto, Andre van Ryckeghem, Don Simons, April 2011
+\end{flushright}
+
\clearpage
%\pagenumbering{roman}
@@ -249,8 +290,8 @@ Don Simons, Andre van Ryckeghem, Cornelius Noack, August 30, 2005
This chapter is not a tutorial on the use of \musixtex, but instead serves as
an overview of some of its capabilities, quirks, and history.
-\musixtex\ is a set of \TeX\ macros which enables the typesetting of music with
-systems of up to twelve staves. It requires as a prerequisite a working
+\musixtex\ is a set of macros and fonts which enables music typesetting
+within the \TeX\ system. It requires as a prerequisite a working
installation of \TeX\footnote{See section \ref{installation}~for guidance on
installing \TeX.}.
\musixtex\ might be regarded as the digital equivalent of a box of type. It
@@ -324,14 +365,15 @@ is of the form
\begin{center}
\verb|\notes ... & ... & ... \enotes|\footnote{The abbreviation
\keyindex{en} can be used in place of \keyindex{enotes}.}
-\end{center}\index{\&}
+\end{center}\index{"&@{\tt\char'046}}
\noindent where the character \verb|&| is used to separate the notes to be
typeset on respective staves of the various instruments, starting from the
bottom.
In the case of an instrument whose score has to be written with
several staves, they are separated by the
-character \|. \index{"|@{\tt\char'174}}
+character \|\index{\tt\char'174@{\tt\char'174}}.
+
Thus, a score written for a keyboard instrument and
a single-line instrument (e.g., piano and violin)
will be coded as follows:
@@ -467,7 +509,7 @@ hand, so that the second one is aligned with the third eighth in the left hand.
(\verb|j| at this pitch) with slope 15\%.
\end{itemize}
-\section{The three pass system}
+\section{The three pass system}\label{threepass}
\TeX's line-breaking procedure implicitly assumes
that a normal line of text will contain many words, so that inter-word
glue need not stretch or shrink too much to justify the line.
@@ -497,7 +539,12 @@ a line just fill up what's not occupied by hard space. Obviously
it may vary from line to line.
To this end a three pass system was developed. To start the
-first pass on the file \verb|jobname.tex|, you would enter \verb|tex jobname|.
+first pass on the file \verb|jobname.tex|, you would enter\footnote{
+In many cases it will suffice to run {\tt tex}, but with \musixtex~1.15,
+it is possible to create a file requiring the enhanced capacity of
+{\tt etex}. Since {\tt etex} can handle any file {\tt tex} can, it's best
+always to use {\tt etex}.}
+\verb|etex jobname|.
Information about each bar is written to
an external file named \verb|jobname.mx1|.
This file begins with a header containing parameters
@@ -517,7 +564,7 @@ output to \verb|jobname.mx2|. The latter file contains a single entry for
each line of music in the reformatted output. The key piece of information
is the revised value of \keyindex{elemskip} for each line.
-Next, the file is \TeX-ed again, by entering \verb|tex jobname|. On this third pass,
+Next, the file is \TeX-ed again, by entering \verb|etex jobname|. On this third pass,
the \verb|jobname.mx2| file is read in, and the information
is used to physically define the final score and embed the
page descriptions into a \verb|dvi|\ file.
@@ -860,13 +907,14 @@ or \verb|\afterruleskip|.
\section{Further highlights}
%\check
\subsection{Key signatures}
-A single key signature can be assigned to all \nolinebreak3
-instruments, for example by \keyindex{generalsignature}\verb|{-2}|
+\begin{sloppypar}
+A single key signature can be assigned~to~all~instruments,~for~example~by
+\keyindex{generalsignature}\verb|{-2}|
which sets two flats on each staff. \keyindex{generalsignature}
can be overridden for selected instruments, for example by
\keyindex{setsign}\verb|2{1}| which puts one sharp on each staff
of instrument number 2. Of course, the current signature as well
-as meters and clefs may change at any time.
+as meters and clefs may change at any time.\end{sloppypar}
\subsection{Transposition}
With some extra attention, a score can be input in such a way that it is
fairly easily transposed. There is an internal register
@@ -922,9 +970,10 @@ The answer is yes, but only with a great deal of special attention---so much,
in fact, that we shall strongly recommend that if you want
to do this, you should use \textbf{PMX}, which makes the process
very easy. If for some reason you choose to ignore this advice, you may
-refer to the details that were provided in the prior version of this manual,
-\href{http://icking-music-archive.org/software/musixtex/mxdoc112.pdf}
-{\underline{mxdoc112.pdf}}.
+refer to the details that were provided in Section 1.4.3 of
+an earlier version of this manual,
+\href{http://icking-music-archive.org/software/musixtex/musixdoc-T112.pdf}
+{\underline{musixdoc-T112.pdf}}.
%After assigning symbolic numbers to instruments,
%there are macros (see \ref{instrum-inhibit}) that permit
@@ -973,9 +1022,9 @@ section of the archive. Assuming you already have \TeX\ and only want to install
{\underline{\texttt{musixtex.zip}}} . Further details about
the installation process are given in section \ref{installation}.
-The Werner Icking Archive also hosts the
-\href{http://icking-music-archive.org/mailman/listinfo/tex-music}
-{\underline{\TeX-music mailing list}}, where you will always find
+There is a
+\href{http://tug.org/mailman/listinfo/tex-music}{\underline{mailing list}},
+hosted by TUG, the \TeX\ Users Group, where you will always find
someone willing to answer questions and help solve problems.
\section{A very brief history of \musixtex}
@@ -1006,8 +1055,9 @@ Significant enhancements to \musixtex, which have already been mentioned, have b
by Stanislav {\sc Kneifl} (Type K postscript slurs) and
Rainer {\sc Dunker} (Lyrics handling via \verb|musixlyr.tex|).
-Since Dr. Taupin passed away in 2003, the primary maintainer of \musixtex\ has been
-Olivier {\sc Vogel}, with substantial assistance from Andre {\sc Van Ryckeghem},
+Since Dr. Taupin passed away in 2003, \musixtex\ has been maintained by a
+varying cast including Olivier {\sc Vogel}, Hiroaki {\sc Morimoto},
+Bob {\sc Tennent}, Andre {\sc Van Ryckeghem},
Cornelius {\sc Noack}, and Don {\sc Simons}.
No discussion of the history of \musixtex\ would be complete without mentioning
@@ -1030,8 +1080,18 @@ special is that it must contain the command
\verb|\input musixtex|
before any reference to \musixtex\ macros. After that might follow
\verb|\input musixadd| or \verb|\input musixmad| if you want to have
-respectively more than six or nine instruments or simultaneous beams,
+respectively up to nine or twelve instruments or simultaneous beams,
ties, or slurs.\ixtt{musixtex.tex}\ixtt{musixadd.tex}\ixtt{musixmad.tex}
+If you want to have greater numbers of these elements, you can assign them
+directly by including one or more of these commands:
+\verb|\setmaxinstruments|,
+\verb|\setmaxcxxviiibeams|,
+\verb|\setmaxcclvibeams|,
+\verb|\setmaxgroups|,
+\verb|\setmaxslurs|,
+\verb|\setmaxtrills|,
+\verb|\setmaxoctlines|.
+
Since it is still a \TeX\ file, after that, if you wished to,
you could write a whole non-musical book
using normal \TeX\ commands provided that you did not
@@ -1144,6 +1204,9 @@ So for example the clefs for a standard piano score
could be specified by
\keyindex{setclef}\verb|1{\bass}|.
+Treble and bass clefs with the digit 8 above or below are also possible; see
+section~\ref{treblelowoct}.
+
To set a common key signature for all instruments, use
\keyindex{generalsignature}\verb|{|$s$\verb|}|,
where $s>0$ is the number of \itxem{sharps} in the
@@ -1245,7 +1308,12 @@ groups, numbered from 1 to 3. The command \verb|\songtop| is equivalent
to \verb|\grouptop 1|; \verb|\songbottom| is equivalent to
\verb|\groupbottom 1|.
-With \ttxem{musixadd.tex}, the allowable number of groups is increased to four.
+With \ttxem{musixadd.tex} or \ttxem{musixmad.tex}, the allowable number of
+groups is increased to four.
+Alternatively, you can specify the allowable number of groups to $m$ by
+\keyindex{setmaxgroups}\verb|{|$m$\verb|}|%
+\footnote{Using $m>4$ may require e-\TeX.}.
+\label{musixmad_setmaxgroups}
If any of the instruments grouped this way has more than one staff, the
heavy curly brace will be shifted to the left of the square brace.
@@ -1579,7 +1647,7 @@ When entering notes inside \verb|\notes ... \enotes|, the usual way to suspend
input for one instrument and start the next (higher) is with the character
``\verb|&|''\index{"&@{\tt\char'046}}. If the instrument has more than one
staff, to switch to the next (higher) one you can use the character
-``\verb+|+''\index{"|@{\tt\char'174}}.
+``\verb+|+''\index{\tt\char'174@{\tt\char'174}}.
There are some alternate navigation commands that may be useful in
special situations. Due to ``catcode
@@ -1670,9 +1738,12 @@ within this macro name stands for the equivalent British term ``crotchet''} with
\item[\keyindex{cccu}{\tt\char123}$p${\tt\char125} :]32nd note with stem up.
\item[\keyindex{cccl}{\tt\char123}$p${\tt\char125} :]32nd note with stem down.
\item[\keyindex{ccca}{\tt\char123}$p${\tt\char125} :]32nd note with automatic stem direction.
- \item[\keyindex{ccccu}{\tt\char123}$p${\tt\char125} :]64nd note with stem up.
- \item[\keyindex{ccccl}{\tt\char123}$p${\tt\char125} :]64nd note with stem down.
- \item[\keyindex{ccccl}{\tt\char123}$p${\tt\char125} :]64nd note with automatic stem direction.
+ \item[\keyindex{ccccu}{\tt\char123}$p${\tt\char125} :]64th note with stem up.
+ \item[\keyindex{ccccl}{\tt\char123}$p${\tt\char125} :]64th note with stem down.
+ \item[\keyindex{cccca}{\tt\char123}$p${\tt\char125} :]64th note with automatic stem direction.
+ \item[\keyindex{cccccu}{\tt\char123}$p${\tt\char125} :]128nd note with stem up.
+ \item[\keyindex{cccccl}{\tt\char123}$p${\tt\char125} :]128nd note with stem down.
+ \item[\keyindex{ccccca}{\tt\char123}$p${\tt\char125} :]128nd note with automatic stem direction.
\end{description}\end{quote}
As an example, the sequence
@@ -1682,7 +1753,8 @@ within this macro name stands for the equivalent British term ``crotchet''} with
\Notes\cu c\cl j\enotes\bar
\Notes\ccu c\ccl j\enotes\bar
\Notes\cccu c\cccl j\enotes\bar
-\Notes\ccccu c\ccccl j\enotes
+\Notes\ccccu c\ccccl j\enotes\bar
+\Notes\cccccu c\cccccl j\enotes
\zendextract
\end{music}
\noindent was coded as
@@ -1690,7 +1762,8 @@ within this macro name stands for the equivalent British term ``crotchet''} with
\Notes\cu c\cl j\enotes\bar
\Notes\ccu c\ccl j\enotes\bar
\Notes\cccu c\cccl j\enotes\bar
-\Notes\ccccu c\ccccl j\enotes
+\Notes\ccccu c\ccccl j\enotes\bar
+\Notes\cccccu c\cccccl j\enotes
\end{verbatim}\end{quote}
\subsection{Non-spacing note heads}
@@ -1739,10 +1812,12 @@ preceding non-spacing note heads.
\verb|\qu| for chord building.
\item[\keyindex{zql}\pitchp~:]quarter note with stem down but no spacing. It acts
like \verb|\ql| for chord building.
- \item[\keyindex{zcu}\pitchp, \keyindex{zccu}, \keyindex{zcccu}, \keyindex{zccccu}
+ \item[\keyindex{zcu}\pitchp, \keyindex{zccu}, \keyindex{zcccu},
+ \keyindex{zccccu}, \keyindex{zcccccu}
:]eighth, ..., note with stem up but no spacing. They act like
\verb|\cu| for chord building.
- \item[\keyindex{zcl}\pitchp, \keyindex{zccl}, \keyindex{zcccl}, \keyindex{zccccl}
+ \item[\keyindex{zcl}\pitchp, \keyindex{zccl}, \keyindex{zcccl},
+ \keyindex{zccccl}, \keyindex{zcccccl}
:]eighth, ..., note with stem down but no spacing. They act
like \verb|\cl| for chord building.
\item[\keyindex{zqb}\pitchp~:]note belonging to a beam but no spacing. (DAS: put this later!)
@@ -1884,12 +1959,30 @@ cases.
The basic form of the macros for starting fixed-slope beams is exemplified
by the one for a single upper beam, \keyindex{ibu}\nps. Here
$n$ is the reference number of the beam, $p$ the starting ``pitch'', and
-$s$ the slope. The reference number is assigned by the user. By default it must be
-in the range [0-5], but the maximum can be increased to 8 or 11 respectively
-if \verb|musixadd| or \verb|musixmad| has been \verb|\input|. The beam number is
-needed because more than one beam may be open at a time, and it
-tells \musixtex\ to which beam subsequent beamed notes and other beam specification
-commands are assigned. The ``pitch'' parameter is a pitch that is three
+$s$ the slope.
+
+The reference number is assigned by the user.
+It is needed because more than one beam may be open at
+a time, and it tells \musixtex\ to which beam subsequent beamed notes and
+other beam specification commands are assigned.
+By default, the reference number must be in the range [0-5],
+but the range for 8th to 128th beams will be expanded to [0-8] or [0-11]
+if \verb|musixadd| or \verb|musixmad| respectively has been \verb|\input|.
+
+Alternatively, you can specify the number of 8th to 64th beams
+directly\footnote{8th to 64th beams are so basic that the maximum
+number of these beams are related with the maximum number of instruments
+by this command.
+Using $m>12$ may require e-\TeX.}
+with \keyindex{setmaxinstruments}\verb|{|$m$\verb|}|
+within the range $7<m\leq 100$; the corresponding reference number may then be
+in the range from 0 to $(m-1)$.
+\label{musixmad_setmaxinstruments_ccxviiibeams}
+For 128th beams, use \keyindex{setmaxcxxviiibeams}\verb|{|$m$\verb|}|.
+
+For 256th notes, which can only appear in beams, see section \ref{musixbbm}.
+
+The ``pitch'' parameter $p$ is a pitch that is three
staff spaces \ital{below} the bottom of the heavy connecting bar (\ital{above}
the bar for a lower beam); in many (but not all)
cases it should be input as the actual pitch of the first note. The slope $s$
@@ -2874,8 +2967,16 @@ Both restrictions are removed with the use of the alternate macros \keyindex{Ioc
\keyindex{Ioctfindown} and
\keyindex{Toctfin}.
-{\Bslash Ioctfinup}~$np$ indicate an upward octave transposition line with reference number
-$n$ ($0\le n<6$) and with dashed line at pitch $p$. Usually $p$ will be numeric and $>9$,
+{\Bslash Ioctfinup}~$np$ indicates an upward octave transposition line with reference number
+$n$ and with dashed line at pitch $p$.
+By default $n$ must be in the range [0-5], but
+you can specify a larger maximum number
+directly with \keyindex{setmaxoctlines}\verb|{|$m$\verb|}|
+where $7<m\leq 100$\footnote{This may require e-\TeX.}; the
+reference number will be in the range between 0 and $(m-1)$.
+\label{musixmad_setmaxoctlines}
+
+Usually $p$ will be numeric and $>9$,
but it can also be a letter.
{\Bslash Ioctfindown}~$np$ starts a lower octave transposition line at pitch $p$
(usually $p<-1$). Both extend until terminated with {\Bslash Toctfin}. The
@@ -2978,19 +3079,29 @@ similar to beams.
\subsubsection{Font-based slur initiation}
A slur must be initiated \ital{before}
the spacing note on which the slur begins, and terminated \ital{before} the
-note on which it ends. The basic slur initiation macro is
+note on which it ends.
+
+The basic slur initiation macro is
\keyindex{isluru}\enpee, which initiates an upper slur, with reference
number $n$, beginning on a note at pitch $p$. The starting point of the slur is
centered above a virtual quarter note head at pitch
$p$\footnote{The slur will start in the same place regardless of whether there is
{\it actually} a note at pitch $p$.}.
-As with beams, the reference number $n$ can take values from 0 to 5, or
-up to 8 or 11 respectively if \ttxem{musixadd.tex} or \ttxem{musixmad.tex} is included.
Similarly, \keyindex{islurd}\enpee\ initiates a lower slur.
These slurs are terminated by coding
\keyindex{tslur}\enpee\ where $n$ is the reference number and $p$ is the
-termination pitch. To illustrate with an elementary example, the following
-passage
+termination pitch.
+
+As with beams, the reference number $n$ by default can take values from 0 to 5, or
+up to 8 or 11 respectively if \ttxem{musixadd.tex} or \ttxem{musixmad.tex} is included.
+You can also specify the maximum number
+directly with \keyindex{setmaxslurs}\verb|{|$m$\verb|}| where
+$7<m\leq 100$%
+\footnote{This may require e-\TeX.};
+the reference number $n$ will be in the range between 0 and $(m-1)$.
+\label{musixmad_setmaxslurs}
+
+To illustrate with an elementary example, the following passage
\begin{music}\nostartrule
\startextract
@@ -3452,7 +3563,7 @@ invoked by including the command \verb|\input musixps|
near the beginning of your source file.
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},
-\textbf{Adobe Acrobat} (see chapter \ref{installation} for more information on this).
+or \textbf{Adobe Acrobat} (see chapter \ref{installation} for more information on this).
Two minor inconveniences with Type K postscript slurs are that (1) they won't appear
in any standard dvi previewer, and (2) they won't appear in PDF files generated with
@@ -3643,10 +3754,13 @@ slur rather than the middle.}.
%original ones.
\subsubsection{Type K postscript ties}
-All of the foregoing Type K slur commands have counterparts for ties. Simply
+All of the foregoing Type K slur commands
+except the shape-changing ones
+have counterparts for ties. Simply
replace ``\verb|slur|'' with ``\verb|tie|'', and for terminations omit
the pitch parameter. Type K ties not only are positioned differently by
-default, but they also have different shapes than slurs.
+default, but they also have different shapes than slurs. If you want to change
+the shape of a tie, redefine \verb|\pstiehgt| from its default of 0.7.
\subsubsection{Dotted type K slurs and ties.}%please check the capital D(otted)
A slur or tie can be made dotted simply by entering \keyindex{dotted} anywhere before
@@ -4585,6 +4699,12 @@ staff of instrument $n$ with blanks.
Normal symbols for those clefs that have been substituted can be restored by
\keyindex{resetclefsymbols}.
+Four other small clef symbols are available: \verb|\smalltrebleoct|,
+\verb|\smalltreblelowoct|, \verb|\smallbassoct|, and \verb|\smallbasslowoct|.
+They look just like the corresponding normal-sized symbols, and are useful by
+clef symbol substitution for clef changes after the beginning of a piece, as
+demonstrated in the following example.
+
The various clef symbol substitution commands can only be used to substitute for
\texttt{treble}, \texttt{alto}, or \texttt{bass} clefs.
@@ -4594,7 +4714,8 @@ back to treble and then the \verb|\treblelowoct| symbol is substituted by using
When changing the clef away from treble and then back as at (3), the substitution
symbol is still in force. At (4), \verb|\resetclefsymbols| cancels the symbol substitution.
If using \verb|\setclefsymbol| all available clefs are changed to the same symbol, as you can see
-in the two clefs after (5) in comparison with (2). Obviously the second clef after (5) is
+in the three clefs after (5) in comparison with (2). These also illustrate the use of the small
+octave clef symbol. Obviously the second clef after (5) is
nonsense; \verb|\resetclefsymbols| puts matters in order at (6) and (7).
\begin{music}
@@ -4610,10 +4731,10 @@ nonsense; \verb|\resetclefsymbols| puts matters in order at (6) and (7).
\notes\zchar{-5}{4}\qu J\en\resetclefsymbols\setclef1\treble\changeclefs
\notes\qu i\en\setclef1\bass\changeclefs\doublebar
\notes\zchar{-5}{5}\qu J\en
-\setclef1\treble\setclefsymbol1\treblelowoct\changeclefs
+\setclef1\treble\setclefsymbol1\smalltreblelowoct\changeclefs
\notes\qu i\en\setclef1\bass\changeclefs\bar
-\notes\zchar{-5}{6}\qu I\en\setclef1\treble\changeclefs
-\notes\qu i\en\resetclefsymbols\setclef1\bass\changeclefs\bar
+\notes\qu I\en\setclef1\treble\changeclefs
+\notes\zchar{-5}{6}\qu i\en\resetclefsymbols\setclef1\bass\changeclefs\bar
\notes\zchar{-5}{7}\qu J\en\setclef1\treble\changeclefs
\notes\qu i\en
\endpiece
@@ -4635,10 +4756,10 @@ nonsense; \verb|\resetclefsymbols| puts matters in order at (6) and (7).
\notes\zchar{-5}{4}\qu J\en\resetclefsymbols\setclef1\treble\changeclefs
\notes\qu i\en\setclef1\bass\changeclefs\doublebar
\notes\zchar{-5}{5}\qu J\en
-\setclef1\treble\setclefsymbol1\treblelowoct\changeclefs
+\setclef1\treble\setclefsymbol1\smalltreblelowoct\changeclefs
\notes\qu i\en\setclef1\bass\changeclefs\bar
-\notes\zchar{-5}{6}\qu I\en\setclef1\treble\changeclefs
-\notes\qu i\en\resetclefsymbols\setclef1\bass\changeclefs\bar
+\notes\qu I\en\setclef1\treble\changeclefs
+\notes\zchar{-5}{6}\qu i\en\resetclefsymbols\setclef1\bass\changeclefs\bar
\notes\zchar{-5}{7}\qu J\en\setclef1\treble\changeclefs
\notes\qu i\en
\endpiece
@@ -5118,6 +5239,12 @@ respectively coded as
\keyindex{metron}\verb|{\hup}{60}| and \keyindex{metronequiv}\verb|{\qup}{\qu}|,
which are normally emplaced using \keyindex{Uptext}.
+Also, you can set a smaller metronomic indication like~~~{\def\nbinstruments{0}
+\metron{\smallnotesize\lqu}{ca. 72}}~~~ or ~~~{\def\nbinstruments{0}
+\metron{\tinynotesize\lqu}{ca. 72}}~~~ by writing
+\verb|\metron{\smallnotesize\lqu}{ca. 72}| or \verb|\metron{\tinynotesize\lqu}{ca. 72}|.
+
+
\subsection{Accents}
You may use\footnote{Note from the editor: the reason the names of some of
@@ -5349,11 +5476,18 @@ current \verb|\noteskips|.
To let \musixtex\ compute the length of the trill, or if it extends across a
system break, you can use \keyindex{Itrille}$n$\pitchp\ to start a plain
-trill, where $n$ is a trill reference number between 0 and 6; then
+trill, where $n$ is a trill reference number between 0 and 5; then
\keyindex{Ttrille}$n$ to terminate it. To get the {\it tr} at the
beginning, use \keyindex{ITrille}$n$\pitchp\ to start the trill and
\verb|\Ttrille|$n$ to close it.
+As with other elements, you can specify the maximum number
+directly with \keyindex{setmaxtrills}\verb|{|$m$\verb|}| where $7<m\leq 100$%
+\footnote{This may require e-\TeX.};
+the reference number $n$ will be in the range between 0 and $(m-1)$.
+\label{musixmad_setmaxtrills}
+
+
For example:
\medskip
@@ -6215,12 +6349,12 @@ symbols to standard clef symbols.
\section{Lyrics}\index{lyrics}\label{lyrics}
\musixtex{} itself doesn't manage lyrics very well. You should use
-\verb+musixlyr+ instead, a MusiXTeX extension package for lyrics handling by Rainer Dunker.
+\verb+musixlyr+ instead, a \musixtex\ extension package for lyrics handling by Rainer Dunker.
The \TeX~source and
\href{http://icking-music-archive.org/software/musixtex/add-ons/mxlyrdoc.pdf}
{\underline{documentation}}~are included in the \musixtex~distribution.
-But first we recall briefly on the older methods, who are still usefull when
+But first we recall briefly the older methods, which may still be useful when
only a small number of words are involved.
\subsection{Native lyrics method: placing single words}
@@ -6343,18 +6477,18 @@ The package can be used by inserting a file in your source code:
...
\end{verbatim}\end{quote}
-The manual, the input file and a few examples can be downloaded as
-compact musixlyr packet
+The manual, the input file and a few examples are in \verb|musixtex.zip|, or they
+may be downloaded
\href{http://icking-music-archive.org/software/musixtex/add-ons/musixlyr21c.zip}
{\underline{for Windows}} or \href{http://icking-music-archive.org/software/musixtex/add-ons/musixlyr21c.tgz}
-{\underline{for \unix}}. Look at the manual for a detailed description. Here you can find an overview
-of the commands and an example of use.
+{\underline{for \unix}}. Look at the manual for a detailed description. Here is an overview
+of the commands and an example of use.\pagebreak
\def\keyexample#1{\keyindex{#1}}
\noindent\begin{tabbing}
\verb|\NOtes|\keyexample{assignlyricshere}\verb|{alto}\qa c\en|\quad\= assigning without staff number\kill
-Example\> Explanation
+Example\> Explanation
\end{tabbing}
\vspace{-1ex}
\hrule
@@ -6715,7 +6849,7 @@ end the extract with \keyindex{endextract} instead of \verb|\endpiece|
or \verb|\stoppiece|, followed by \keyindex{end\LBR music\RBR}.
To terminate an extract without any bar line, use \keyindex{zendextract}
-instead of \verb|\zendextract|.
+instead of \verb|\endextract|.
To create a left-justified excerpt, use the sequence
\keyindex{let\Bslash extractline\Bslash leftline}.
@@ -6822,7 +6956,7 @@ The symbols are given their special meanings by executing the macro
\keyindex{endcatcodesmusic}. When setting either a self-contained score or
a musical extract, you normally need not worry
about this at all, because \verb|\startpiece| or \verb|\startextract| executes
-\verb|\catcodesmusic| and \verb|\endpiece| or \verb|\zendextract| executes
+\verb|\catcodesmusic| and \verb|\endpiece| or \verb|\endextract| executes
\verb|\endcatcodesmusic|. But there are some special situations where you
might need to use these catcode-modifying macros explicitly. One is if you
were to define a personalized macro outside
@@ -6849,8 +6983,13 @@ brackets (see \ref{curlybrackets}).
\subsection{musixadd}\ixtt{musixadd.tex}
Increases the number of instruments, slurs and beams from six to nine.
+
\subsection{musixbm}
- Provides 128th notes, either with flags or with beams, via the commands
+This file does nothing; it is retained only for compatibility with
+\musixtex{} T.110 or earlier.
+Since version T.111, \verb|musixtex.tex| itself contains all the functions
+of the older \texttt{musixbm}, namely
+commands for 128th notes, either with flags or with beams:
\keyindex{ibbbbbu},
\keyindex{ibbbbbl},
\keyindex{nbbbbbu},
@@ -6860,13 +6999,14 @@ Increases the number of instruments, slurs and beams from six to nine.
\keyindex{Ibbbbbu},
\keyindex{Ibbbbbl},
\keyindex{cccccu},
+\keyindex{cccccl},
\keyindex{ccccca},
-\keyindex{zcccccu},
-\keyindex{cccccl} and
+\keyindex{zcccccu} and
\keyindex{zcccccl}.
- \subsection{musixbbm}
- Provides 256th notes, only with beams, via the commands
+
+ \subsection{musixbbm}\label{musixbbm}
+ Provides 256th notes, but only for use within beams, via the commands
\keyindex{ibbbbbbu},
\keyindex{ibbbbbbl},
\keyindex{nbbbbbbu},
@@ -6876,6 +7016,12 @@ Increases the number of instruments, slurs and beams from six to nine.
\keyindex{Ibbbbbbu} and
\keyindex{Ibbbbbbl}.
+By default \texttt{musixbbm} provides six 256th beams with
+reference number 0 to 5.
+You can specify a larger maximum number
+directly with \keyindex{setmaxcclvibeams}\verb|{|$m$\verb|}| within the
+range\footnote{This may require e-\TeX.} $7\leq m\leq 100$.
+
\subsection{musixcho}\label{song}
Enables certain macros intended for choral music\footnote{Remember
that we now recommend using \texttt{musixlyr} for any except the
@@ -8189,6 +8335,13 @@ staffs, rather that over them. This is an arbitrary question of taste...
instruments, slurs and beams up to twelve. When using this extension, it is
not necessary to explicitly input \verb|musixadd.tex|.
+If you need greater numbers of these elements, see sections
+\ref{musixmad_setmaxgroups},
+\ref{musixmad_setmaxinstruments_ccxviiibeams},
+\ref{musixmad_setmaxoctlines},
+\ref{musixmad_setmaxslurs}, and
+\ref{musixmad_setmaxtrills}.
+
\subsection{musixper}\label{perc}
@@ -8629,10 +8782,12 @@ If using MS Windows, you'll need to have manually installed some version of
\TeX. MiK\TeX\ is the most common variant by far and therefore will be assumed. If
you need to install MiK\TeX, you can get the software from
\href{http://www.miktex.org/}{\underline{\texttt{http://www.miktex.org}}}
-or from CTAN. The Werner Icking Archive contains excellent
-\href{http://icking-music-archive.org/software/musixtex/musixwinstall.pdf}%
-{\underline{instructions for installing MiK\TeX}}%
-\footnote{Thanks to Eva {\sc Jaksch}}.
+or from CTAN.
+% DAS Out of date!
+%The Werner Icking Archive contains excellent
+%\href{http://icking-music-archive.org/software/musixtex/musixwinstall.pdf}%
+%{\underline{instructions for installing MiK\TeX}}%
+%\footnote{Thanks to Eva {\sc Jaksch}}.
\section{Where to get \musixtex: the Werner Icking Archive}\label{getstuff}
@@ -8643,25 +8798,30 @@ The most up-to-date versions of \musixtex\ and friends are located in the
\href{http://icking-music-archive.org/software/indexmt6.html}{\underline{software}}
section of the archive. The stable distribution of \musixtex\ will be contained in
\href{http://icking-music-archive.org/software/musixtex/musixtex.zip}
-{\underline{\verb|musixtex.zip|}}, which is intended to serve all operating
-systems.
-The CTAN servers are official mirrors. The main CTAN server's
-web link is\\
-\href{http://www.ctan.org/tex-archive/macros/musixtex/taupin/}
-{\underline{http://www.ctan.org/tex-archive/macros/musixtex/taupin/}}
-and the FTP link is\\
-\href{http://ftp.ctan.org/tex-archive/macros/musixtex/taupin/}
-{\underline{http://ftp.ctan.org/tex-archive/macros/musixtex/taupin/}}.
-
-\subsection{End of line char in text files}
-The files in the Werner Icking Archive have been contributed by such a wide
+{\underline{\verb|musixtex.zip|}}. This will serve any operating system, but
+has detailed Windows-specific installation instructions and batch scripts that simplify
+installing and running the software.
+There is a somewhat differently organized distribution on the CTAN servers at\\
+\href{http://www.ctan.org/tex-archive/macros/musixtex/}
+{\underline{http://www.ctan.org/tex-archive/macros/musixtex/}}
+with FTP link\\
+\href{ftp://ftp.ctan.org/tex-archive/macros/musixtex/}
+{\underline{ftp://ftp.ctan.org/tex-archive/macros/musixtex/}}.
+This one is "TDS compliant," which means that it adheres to a recently announced
+standard directory structure for \TeX\ systems. It is accompanied by
+installation instructions for \unix\ and other OS's, but does not contain any
+installation scripts.
+
+\subsection{End of line characters in text files}
+The files in the Werner Icking Archive and in \verb|musixtex.zip|
+have been contributed by such a wide
range of authors that there is no common standard for the line endings in text files.
But the key text files serve as input to programs such as \TeX\ and \MF\
which are insensitive to this. If you use a PC and run into problems using any of
these text files, you might be able to solve them with the program
\verb|flip.exe| which comes with the \musixtex\ distribution. Run it from a
command window by typing \verb|flip -m| $<$filename$>$, and it will
-convert line endings from the \unix to MS-DOS convention.
+convert line endings from the \unix\ to MS-DOS convention.
\subsection{Pre-installed \musixtex}
Many versions of \TeX\ include \musixtex\ as a package. The included version is likely
@@ -8669,15 +8829,31 @@ to be out of date and probably should not be used. When an archived version is
downloaded and properly installed, it will supersede the pre-installed version.
\section{Installing \musixtex}
-The most useful \musixtex\ uses Postscript and produces PDF files.
-The installation is very system dependent and therefore beyond the scope of this manual.
-You may refer to the installation manual or to the HOWTO files in the archive for either
-\href{http://icking-music-archive/software/musixtex/musixwinstall.pdf}
-{\underline{Windows}}\ or
-\href{http://icking-music-archive/software/musixtex/musixtex-for-unix.html}
-{\underline{\unix}}.
-Whatever course you choose, there are really just a few
-fundamental tasks you must accomplish:
+Installation of the \TeX~ and
+\musixtex~ software is very system dependent and will not be detailed here. The
+distribution
+\href{http://icking-music-archive.org/software/musixtex/musixtex.zip}
+{\underline{\verb|musixtex.zip|}}
+is Windows-centric but does include all the \musixtex\ files
+needed for any OS. For Windows installation, the distribution includes very detailed
+instructions in
+\href{http://icking-music-archive.org/software/musixtex/musixtex.zip}
+{\underline{\verb|mxinsuse.pdf|}}
+and a batch file {\tt instmus.bat} which greatly
+simplifies the installation process.
+Users of other OS's may refer to
+\href{http://icking-music-archive.org/software/musixtex/mxinsuse.pdf}
+{\underline{\verb|mxinsuse.pdf|}}
+or to
+%DAS Out of date!
+%either
+%\href{http://icking-music-archive.org/software/musixtex/musixwinstall.pdf}
+%{\underline{Windows}}\ or
+\href{http://icking-music-archive.org/software/musixtex/musixtex-for-unix.html}
+{\underline{HOWTO file for \unix}} in the archive.
+
+Whatever your OS or installation method, there are really just a few
+fundamental tasks you must accomplish for a usable install:
\begin{itemize}\setlength{\itemsep}{0ex}
\item \musixtex\ comprises some \TeX\ source files (\verb|.tex|, \verb|.sty|),
font files, and the executable \verb|musixflx|. The \TeX\ sources and font
@@ -8687,114 +8863,32 @@ files must be placed in locations where \TeX\ can find them;
file somewhere in the \TeX\ file structure, and locate and modify a configuration
file such as \verb|config.ps| to record the addition of the map file.
\item \verb|musixflx| must be placed in a folder that is in your search path,
-so it can be executed from your working directory;
- \item As stated before, to compile a score, you must run in sequence \verb|tex|, \verb|musixflx|,
-and \verb|tex| again. This will produce a \verb|.dvi| file;
- \item To view the result, convert the file to
-postscript with \textbf{dvips} and then view it with a postscript viewer such
-as \textbf{GSview} and \textbf{ghostscript}, or convert the \verb|.dvi|
-directly to a PDF file with \textbf{pdftex} and then view it with any PDF viewer
-such as \textbf{Adobe Reader}. You also can use a DVI viewer, but if you are using type K postscript slurs, note that DVI viewers will not display the slurs.
+so it can be executed from your working directory.
\end{itemize}
-\section{Running Musix\TeX\ }
-
-In most systems the commands run in a shell. Unix people are familiar with it.
-Also in MS Windows systems, there are a large number of editor/shell programs. Although not recommended, you always can use the DOS
-\verb|cmd| shell (\verb|cmd.exe|).
-
-
-In the examples, a file \verb|mymp|
-(\textbf{my} \textbf{m}aster\textbf{p}iece) is used, for demonstrating
-the batch commands.
-
-
-
-\subsection{Batch commands for making DVI and postscript (MS Windows)}
+\section{Running \musixtex}
-This commands are available in the \musixtex\ distribution. They produce
-a DVI file that can be displayed by a viewer
-(normally a part of the \TeX\ installation), or/and a Postscript file (normally with GSview).
+As first stated in Section~\ref{threepass}, to compile a score, you must run
+in sequence \verb|etex|, \verb|musixflx|,
+and \verb|etex| again. This will produce a \verb|.dvi| file. From this point
+forward, this file can be processed like the device-independent output file
+for any \TeX\ document. The most common approach and the only one to
+be discussed here is to next generate a postscript file. This is accomplished
+by running \verb|dvips|, which is included in every \TeX\ system. To view the
+postscript, most users run {\tt GSview} or {\tt ghostscript}, which must
+be separately downloaded and installed. Finally, you may produce a PDF file
+also using GSview, and view that with Acrobat Reader or {\tt GSview}.
-After running \TeX\ on a music file, \verb|musixflx| must run. The program \verb|musixflx| calculates the number of bars on a system (music line), in order to have a nice layout. Then, \TeX\ must run again.
-
-When the paths to the binaries and the batch files are set properly, then the following commands can be used as is.
-
-\subsubsection{Using \TeX\ }
-The \ixem{musixtex.bat} command fulfills the sequence \texttt{\TeX\ $\Rightarrow$ musixflx $\Rightarrow$ \TeX}~.
-
-\begin{quote}\begin{verbatim}
-rem musixtex.bat
-if not exist %1.tex goto end
-if exist %1.mx1 del %1.mx1
-if exist %1.mx2 del %1.mx2
-tex %1
-if errorlevel 2 goto end
-musixflx %1
-if errorlevel 1 goto end
-tex %1
-:end
-\end{verbatim}\end{quote}
-The next command (\verb|mupsgs.bat|) processes \verb|mymp.tex| and makes a Postscript file and dispays the file.
-\begin{quote}\begin{verbatim}
-rem mupsgs.bat
-call musixtex.bat %1
-DVIPS.EXE -e0 -t a4 -P pdf -G0 %1.dvi
-gsview32.exe %1.ps
-\end{verbatim}\end{quote}
-The \verb|dvips| output looks a little bit nicer using the options
-\verb|-e0| (character drift value~=~0) and \verb|-G0| (shift low chars
-to higher position).
-\verb|-t a4| is for a4 paper (\verb|-t letter| for letter format).
-If the output is to be converted in Adobe Acrobat pdf format, the option \verb|-P pdf|
-(load \verb|config.pdf|) is needed.
-
-If you want to make a PDF output, you may add the line (after \verb+dvips+):
-
-\noindent{\small
-\verb+gswin32c -dBATCH -dNOPAUSE -sDEVICE=pdfwrite -r600 -sOutputFile=%1.pdf -c save pop -f %1.ps+
-}
-
-\subsubsection{Using La\TeX\ }
-Replace ``\verb+tex+'' by ``\verb+latex+'' in the file \verb+musixtex.bat+~.
-
-
-\subsection{Running \musixtex\ without a shell}
-You also may run the commands without a shell.
-To forward the argument in the batch file,
-use an other batch file which stays in the same directory as your
-masterpiece \verb|mymp.tex| and has the same name: \verb|mymp.bat|~.
-\verb|mymp.bat| consists of 1 line: \verb|musixtex.bat %~n0|~.
-
-\noindent Thus \verb|mymp.bat| passes his own name (\verb|mymp|) via \verb|%~n0|
-to the \verb|musixtex.bat| command.
-
-Here are four examples of batch files, dependent of the method you are using.
-\endcatcodesmusic
-%\begin{quote}\begin{verbatim}
-\begin{center}
-\begin{tabular}{|l|l|l|}
-\multicolumn{3}{c}{Choose only one batch file}\\[.4ex]\hline
-Batch file for&making DVI&making postscript\\\hline
-name &\verb+rem mymp.bat+&\verb+rem mymp.bat+\\
-contents&\verb+musixtex.bat %~n0+&\verb+mupsgs.bat %~n0+\\\hline
-\end{tabular}
-%\end{verbatim}\end{quote}
-\end{center}
-
-\subsection{Running \musixtex\ without giving a file name}
-If you want to process i.e.\ all \texttt{.tex} files in a directory, then you could make a batch file
-\texttt{texall.bat} with the following commands:
-
-\begin{quote}\begin{verbatim}
-rem texall
-for /F %%I in ('dir /B *.tex') do call mupsgs.bat %%~nI
-\end{verbatim}\end{quote}
-
-Of course, this command also works if there is only one file in a directory, which means you
-may use \texttt{texall.bat} for a single file, without giving an argument.
+You also can view the \verb|.dvi| file directly using a DVI viewer such as Yap,
+but if you are using type K postscript slurs, DVI viewers will not display them.
+Rather than executing all the foregoing programs separately, most users will
+find it more convenient to use either a batch file or a shell. The distribution
+\verb|musixtex.zip| includes various batch files for compiling and viewing
+\musixtex\ files in Windows. Their use is discussed in detail in
+\href{http://icking-music-archive.org/software/musixtex/mxinsuse.pdf}
+{\underline{\verb|mxinsuse.pdf|}}.
\chapter{\musixtex\ examples}
@@ -8804,7 +8898,7 @@ that produced them, while for a few only an image of the extract is included and
have to look in \verb|musixdoc.tex| to see the coding.
Other useful examples cannot be embedded in the source, either because they are
-meant to be in \TeX, not La\TeX, or because they are simply to large. For
+meant to be in \TeX, not \LaTeX, or because they are simply to large. For
these the source files also are provided separately.
When compiling or viewing any of the examples, you should keep in mind that
@@ -8829,7 +8923,10 @@ character set is used. See section \ref{8bit} on page \pageref{8bit} for other s
\end{itemize}
\section{Full examples}
-All of these examples and many others are available in
+The small examples above and the longer ones mentioned below are included in
+the folder
+\verb|MUSIXTEXdistribution\doc\musixtex\manualexa| of \verb|musixtex115.zip|.
+Many others are available in
\href{http://icking-music-archive.org/software/musixtex/musixexa.zip}
{\underline{\texttt{musixexa.zip}}} or
\href{http://icking-music-archive.org/software/musixtex/musixexa-T112.tar.gz}
@@ -8855,7 +8952,7 @@ commands (section \ref{glorias}). {\tt gloriab.tex} is the same piece, but with
\end{itemize}
-\subsection{Other examples, provided by the authors of MusiX\TeX }
+\subsection{Other examples, provided by the authors of \musixtex }
\begin{itemize}\setlength{\itemsep}{0ex}
@@ -8881,70 +8978,43 @@ to create staff-jumping doubly beamed notes.
\end{itemize}
\section{Compiling musixdoc.tex}
-\subsection{Command sequence}
-This is an example of a command sequence (in fact this is the normal procedure for La\TeX\ files). \verb|musixdoc.tex| is a large file, if you use an older version of La\TeX, use ``elatex'' in the command file.
+This manual is an excellent example of a primarily text document with embedded
+musical excerpts. For this reason it is a \LaTeX\ document and must be compiled
+with \verb|latex| rather than \verb|etex|. Those wishing to combine text and
+musical excerpts should carefully study how it is done here.
+
+Before compiling or recompiling \verb|musixdoc.tex|, you should remove all the auxilliary
+files {\tt musixdoc.[mx1\|\allowbreak mx2\|\allowbreak aux\|\allowbreak toc\|\allowbreak ind\|\allowbreak idx\|\allowbreak ilg\|\allowbreak out]}
+if they are present. Then the following command sequence will produce \verb|musixdoc.ps|:
\begin{quote}\begin{verbatim}
latex musixdoc
musixflx musixdoc
latex musixdoc
makeindex -l musixdoc
latex musixdoc
-(may require several more runs of elatex to get rid of
- "labels may have changed ..." warnings)
-dvips -ta4 musixdoc
+latex musixdoc
+dvips -e0 -t a4 -P pdf -G0 musixdoc
\end{verbatim}\end{quote}
+The initial three steps \verb|latex|\allowbreak$\to$\allowbreak\verb|musixflx|\allowbreak$\to$\allowbreak\verb|latex| build up the basic appearance of the document including many musical examples.
+\verb|makeindex| produces the database for the index.
+After that, \verb|latex| must be run at least twice to complete cross referencing.
+Finally, \verb|dvips| converts the \verb|.dvi| file into \verb|.ps| (making PostScript type K slurs
+visible).
To produce \verb|musixdoc.pdf|, open \verb|musixdoc.ps| in \texttt{GSview}. Go to
-\verb+File|Convert+, select \verb|pdfwrite| at 600 dpi resolution, click
+{\tt File\|Convert}, select \verb|pdfwrite| at 600 dpi resolution, and click
\verb|OK|.
-\subsection{Using batch files}
-There are
-many other files that are required to compile this document but all of them
-are included in \verb|musixtex.zip|, and will be placed in the proper locations
-if you have followed the installation instructions for \musixtex.
-
-The two following batch files reside in the same dir as \texttt{musixdoc.tex} (or \texttt{musixdoc114.tex}).
-
-This batch file makes a DVI, Postscript and PDF file, then displays the Postscript file.
-The full path names are shown as a comment.
-{\small
-\begin{quote}\begin{verbatim}
-rem filename: lapdfview
-LATEX.EXE %1 %2.tex
-if errorlevel 1 goto end
-makeindex -l %1
-rem C:\musixtex\system\musixflx\win32\musixflx %1
-musixflx %1
-LATEX.EXE %1 %2.tex
-if errorlevel 1 goto end
-rem C:\"Program Files\MiKTeX 2.7"\miktex\bin\DVIPS.EXE -e0 -t a4 -P pdf -G0 %1.dvi
-DVIPS.EXE -e0 -t a4 -P pdf -G0 %1.dvi
-rem C:\"program files"\gs\gs8.63\bin\gswin32c -dBATCH ^
-rem -dNOPAUSE -sDEVICE=pdfwrite -r600 \
-rem -sOutputFile=%1.pdf -c save pop -f %1.ps
-gswin32c -dBATCH -dNOPAUSE -sDEVICE=pdfwrite -r600 ^
--sOutputFile=%1.pdf -c save pop -f %1.ps
-pause
-rem C:\"program files"\Ghostgum\gsview\gsview32.exe %1.ps
-gsview32.exe %1.ps
-rem pause
-:end
-\end{verbatim}\end{quote}
-}
-
-This batch file searches the folder for tex files and calls \texttt{lapdfview.bat}
-{\small
-\begin{quote}\begin{verbatim}
-rem latexall.bat
-rem proces all files with extension tex in this directory
-for /F %%I in ('dir /B *.tex') do call lapdfview.bat %%~nI
-pause
-\end{verbatim}\end{quote}
-}
-
-Thus, to produce \texttt{musixdoc.pdf}, double click on \texttt{latexall.bat}.
+If you use an older version of \LaTeX\ which doesn't automatically
+invoke $\varepsilon$\hbox{-}\nobreak\TeX, you will encounter the
+error ``{\tt !~No room for new \string\count}''.
+This is because \verb|musixdoc.tex| invokes \verb|musixtex.tex|, which together with \LaTeX\
+requires more storage registers than available in \TeX.
+You may be able get around this by using the command
+\verb|elatex| instead of \verb|latex|;
+however, it is strongly recommended to upgrade your \TeX\ system to a more recent
+version in which \verb|latex| automatically invokes $\varepsilon$\hbox{-}\nobreak\TeX.
\clearpage
{\parindent0pt