diff options
author | Karl Berry <karl@freefriends.org> | 2015-04-23 22:55:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-04-23 22:55:51 +0000 |
commit | a5edcfe433dd540818b1a0d4eafd6c4b63d24dcc (patch) | |
tree | 1681f893f4068d9a03a2ad339819961884e5052b /Master/texmf-dist/doc | |
parent | 087d2d121f4f1e7dc23d5175759f4be6fb44c0ef (diff) |
musixtnt, split from musixtex
git-svn-id: svn://tug.org/texlive/trunk@37024 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/README | 53 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 | 101 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf | bin | 0 -> 6693 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf | bin | 0 -> 8101 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/msxlint.pdf | bin | 0 -> 4148 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz | bin | 0 -> 107349 bytes |
6 files changed, 154 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/musixtnt/README b/Master/texmf-dist/doc/generic/musixtnt/README new file mode 100644 index 00000000000..feb85055448 --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/README @@ -0,0 +1,53 @@ +This archive contains a MusiXTeX extension library musixtnt +and C source code, binaries for Windows (32 bit and 64 bit) +and MacOSX, and documentation for two programs: fixmsxpart +and msxlint. + +musixtnt.tex provides a macro \TransformNotes that +enables transformations of the effect of notes +commands such as \notes. In general, the effect of +\TransformNotes{input}{output} is that notes commands in +the source will expect their arguments to match the input +pattern, but the notes will be typeset according to the +output pattern. An example is extracting single-instrument +parts from a multi-instrument score. + +fixmsxpart corrects note spacing in a single-part MusiXTeX +source (possibly derived from a multi-instrument score and +as a result having irregular note spacing). + +msxlint detects incorrectly formatted notes lines in a +MusiXTeX source file. This should be used before using +\TransformNotes. + +To install: + +Create texmf/tex/generic/musixtnt in a local or personal +texmf tree and move musixtnt.tex into it. + +Create texmf/doc/generic/musixtnt and move there the files +in the doc directory. + +Update the file-name database as required by your TeX +installation. + +If your platform is UNIX-like, process the +musixtnt-<version>.tar.gz file as usual (tar zxvf ..., +./configure, make, make install). + +If your platform is Windows, move the executables +msxlint.exe and fixmsxpart.exe in either the 32bit or the +64bit folders to a folder on the executable PATH. + +If your platform is Mac OS-X, install the executables +in the macosx directory. + +musixtnt.tex, fixmsxpart.c, utils.c and msxlint.c are +licensed under the GPL version 2. + +Please report bugs and experience (good or bad) using these +programs to me. + +Bob Tennent +rdt@cs.queensu.ca +2015-02-18 diff --git a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 new file mode 100644 index 00000000000..4db043a9818 --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 @@ -0,0 +1,101 @@ +.TH TransformNotes 3 2015-01-18 "" "" + +.SH NAME +TransformNotes \- macro to transform notes command arguments in MusiXTeX + +.SH SYNOPSIS +.nf + + \\input musixtnt + + \\TransformNotes{input}{output}% + +.fi + +.SH USAGE + +musixtnt.tex is an extension library for MusiXTeX. It is available +at WIMA in the software archive. + +\\TransformNotes makes possible transformations of the effect of notes commands such as +\\notes. In general, the effect of \\TransformNotes{input}{output} +is that notes commands in the source will expect their arguments to match the input pattern, +but the notes will be typeset according to the output pattern. + +For example, \\TransformNotes{#2}{#2}% +would be appropriate for a four-instrument score (arguments #2, #3, #4, and #5, separated by three +&s), but the notes for the usual third argument (#4) will be discarded in the typeset output. + +The instrument/staff numbers in the first argument must start at 2 and increase +consecutively, using & (or | for multi-staff instruments) as a separator. +The reason that the segment identifiers start at 2 is that argument #1 for the +basic \\vnotes macro +is a spacing parameter. +It is +essential that every \\znotes, \\notes, \\Notes, \\NOtes, etc. command in +the score match the pattern of the first argument to \\TransformNotes exactly; too few (or too many) +note segments will result in unintentionally discarded material and possibly compilation failure. +An auxiliary program +.BR msxlint (1) +can be used to detect such inconsistencies; +it is available at WIMA in the +software +archive. +Notes commands are assumed to be terminated by \\en, not \\enotes. + +\\TransformNotes may be used anywhere between \\startpiece +and the command that ends the piece. + +To extract +a single-instrument part from a (copy of a) multi-instrument musixtex score: +set \\nbinstrument to 1 (for example, with command \\instrumentnumber1), +and use \\TransformNotes to discard all but one of the note segments in notes +commands. +For example, the following line placed after +\\startpiece (but before any note commands) would be appropriate for a +four-instrument score and will result in a single-instrument part for the second of +these: \\TransformNotes{#2}{#3}% . + +Some additional revisions to the source for the part might be necessary: + + + adjusting \\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; + +When the extracted part score is compiled and viewed, it may be seen +that horizontal-spacing commands designed for multiple instruments can produce bad +spacing when used for a single instrument. Bad spacing can be corrected manually but +this is very tedious; an auxiliary program called +.BR fixmsxpart (1) +automates this process (for single-staff instruments only); it is available at WIMA +in the software archive. + +The \\TransformNotes macro may be used for other purposes. Here are some examples: + +\\TransformNotes{#2}{#2&\\transpose+7#3}% +will transpose just the second instrument (argument #3). + +\\TransformNotes{#2|#3}{#2|#3&\\tinynotesize#4}% +will begin typesetting the notes of the second instrument (#4) in tiny size. + +\\TransformNotes{#2}{#3}% +will switch the order of the two instruments. + +\\TransformNotes{#2}{#2}% +will restore normal two-instrument processing. + +.SH LIMITATIONS +The \\TransformNotes macro is currently incompatible with the musixlyr extension +package for lyrics. + +.SH SEE ALSO +.BR msxlint (1), +.BR fixmsxpart (1) +.PP +musixdoc.pdf + +.SH AUTHOR +This manual page was written by Bob Tennent <rdt@cs.queensu.ca>. + diff --git a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf Binary files differnew file mode 100644 index 00000000000..1e9374edd95 --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf diff --git a/Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf b/Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf Binary files differnew file mode 100644 index 00000000000..833c48e57fd --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf diff --git a/Master/texmf-dist/doc/generic/musixtnt/msxlint.pdf b/Master/texmf-dist/doc/generic/musixtnt/msxlint.pdf Binary files differnew file mode 100644 index 00000000000..a0a3ecd26ab --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/msxlint.pdf diff --git a/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz b/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz Binary files differnew file mode 100644 index 00000000000..9bf6291cadf --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz |