NAME

       fixmsxpart - corrects note spacing in a single-staff MusiXTeX part

SYNOPSIS

       fixmsxpart [-v | --version | -h | --help]

       fixmsxpart [-d | --debug] infile[.tex] [outfile[.tex]]

       Converts  a  single-staff  MusiXTeX  part (possibly derived from a multi-instrument score and as a result
       having irregular note spacing) to a single-staff  part  with  proper  spacing  determined  by  the  notes
       themselves.

       If outfile is not specifed, standard output is used.

USAGE

   Generating a Single-Instrument Part
       To  generate a single-instrument part from (a copy of) the MusiXTeX source for a  multi-instrument score,
       add

           \input musixtnt

       to the preamble, set

           \instrumentnumber1

       and use the \TransformNotes macro defined in musixtnt.tex to discard all but one part.  For example,  the
       following  line  placed after \startpiece (but before any note commands) would be appropriate for a four-
       instrument score (arguments #2, #3, #4, and #5, separated by three &s), and will result in a part for the
       second of these (#3):

           \TransformNotes{#2&#3&#4&#5}{#3}

       Argument #1 is a scaling parameter and should not be modified.   It  is  essential  that  every  \znotes,
       \notes,  \Notes, \NOtes, etc. command in the score match the macro  pattern exactly; insufficient (or too
       many) note segments will result in lost text and possibly compilation failure;  see  msxlint(1).   It  is
       assumed by \TransformNotes that notes commands are terminated by \en (rather than \enotes).

       Some additional manual changes to the source will be necessary:

       +  adjustments of \setname1, \setclef1, \setsign1 , \setmeter1 and \setstaffs1 commands, as necessary;

       +  ensuring that tempo and roadmap markings (D.C., Fine, etc.) are in the appropriate instrument segment;

       Finally,  if  the  modified score is compiled and viewed, it may be seen that horizontal spacing designed
       for multiple instruments often produces bad spacing for a  single  instrument.   This  can  be  corrected
       manually (and very tediously) but it is what fixmsxpart was designed to fix (much more conveniently).

   Correcting Horizontal Spacing Using fixmsxpart
       The  \notes  \Notes  \NOtes  \NOTes...   commands  in  a  part  derived from a multi-instrument score are
       unreliable, and so fixmsxpart determines the spacing for ordinary notes by the note commands  themselves;
       for example,

       +  \qa, \qu, \ql, \qp result in \NOtes;

       +  \ca, \cu, \cl, \ds result in \Notes;

       and  so  on.  Spacing commands \sk and \hsk in the input are discarded (but \qsk, \hqsk and explicit uses
       of \off{...} are preserved).

       fixmsxpart determines the spacing for beamed notes by the beam multiplicity: \ib...  results  in  \Notes,
       \ibb...  results  in  \notes,  etc.  Some  beam-termination commands (\tb...) are problematic because the
       immediately-following beam note \qb... must be spaced according to the spacing before the \tb... command.
       This is handled by setting a variable new_beaming when processing the \tb... command  and  only  updating
       beaming to new_beaming when processing the subsequent beam note.  This isn't needed for the abbreviations
       \tqb, \tqh, \ztqb and \ztqh which combine beam-termination and specification of the final beam note.

       Pointed  notes  are not given extra space automatically. They should be given extra space manually in the
       score by using either a \roff-like command on the subsequent note or the \qsk or \hqsk spacing commands.

       Additional features of fixmsxpart transformation:

       +  Successive whole-bar rests are accumulated into a multi-bar rest, with appropriate adjustment  of  the
          bar number.

       +  \alaligne and \alapage commands are replaced by \bar.

       +  \mulooseness, \eject, \linegoal, \song{top | bottom}, \group{top | bottom} and \akkoladen commands are
          commented out.

       +  \instrumentnumber...  commands become \instrumentnumber1.

       +  \nostartrule is added to the preamble.

       +  Simple  slurs or ties initiated by \slur or \tie are normalized by setting the n parameter to 1 on the
          assumption that the new note spacing is correct.

LIMITATIONS

       Only single-staff instrumental parts are supported. User-defined macros are not expanded.  A few esoteric
       MusiXTeX commands and constructions are not supported.

SEE ALSO

       msxlint(1)

       musixdoc.pdf

AUTHOR

       This program and manual page were written by Bob Tennent <rdt@cs.queensu.ca>.

                                                   2015-02-05                                      FIXMSXPART(1)