diff options
author | Karl Berry <karl@freefriends.org> | 2016-04-07 17:18:03 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-04-07 17:18:03 +0000 |
commit | c125719633d76d136a955ef3d0ef68249dfd9f25 (patch) | |
tree | 416fd89415d275004a8cf98869f181eccf9c08f5 /Master/texmf-dist/doc | |
parent | 4fc0fce826bc3e62885c787654e6a39740d0f31d (diff) |
musixtnt 2016-01-30 (31jan16)
git-svn-id: svn://tug.org/texlive/trunk@40307 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/README | 32 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 | 15 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf | bin | 6693 -> 6616 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf | bin | 8101 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz | bin | 107349 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/generic/musixtnt/musixtnt-2016-01-30.tar.gz | bin | 0 -> 96796 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/fixmsxpart.1 | 185 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/fixmsxpart.man1.pdf | bin | 8984 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/msxlint.man1.pdf | bin | 4197 -> 16579 bytes |
9 files changed, 20 insertions, 212 deletions
diff --git a/Master/texmf-dist/doc/generic/musixtnt/README b/Master/texmf-dist/doc/generic/musixtnt/README index feb85055448..78adcc1c8a4 100644 --- a/Master/texmf-dist/doc/generic/musixtnt/README +++ b/Master/texmf-dist/doc/generic/musixtnt/README @@ -1,7 +1,7 @@ -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. +This archive contains a MusiXTeX extension library +musixtnt.tex and C source code, binaries for Windows (32 +bit and 64 bit) and MacOSX, and documentation for a program +msxlint. musixtnt.tex provides a macro \TransformNotes that enables transformations of the effect of notes @@ -12,12 +12,8 @@ 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 +MusiXTeX source file. This should be used before using \TransformNotes. To install: @@ -35,19 +31,19 @@ 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 Windows, move the executable msxlint.exe +from either the 32bit or the 64bit folder to a folder on the +executable PATH. -If your platform is Mac OS-X, install the executables -in the macosx directory. +If your platform is Mac OS-X, install the executable from +the macosx directory. -musixtnt.tex, fixmsxpart.c, utils.c and msxlint.c are -licensed under the GPL version 2. +musixtnt.tex, utils.c and msxlint.c are licensed under the +GPL version 2 or (at your option) any later version. Please report bugs and experience (good or bad) using these programs to me. Bob Tennent -rdt@cs.queensu.ca -2015-02-18 +rdt(at)cs(dot)queensu(dot)ca +2016-01-30 diff --git a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 index 4db043a9818..752aa02985c 100644 --- a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 +++ b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.3 @@ -1,4 +1,4 @@ -.TH TransformNotes 3 2015-01-18 "" "" +.TH TransformNotes 3 2016-01-30 "" "" .SH NAME TransformNotes \- macro to transform notes command arguments in MusiXTeX @@ -15,7 +15,7 @@ TransformNotes \- macro to transform notes command arguments in MusiXTeX .SH USAGE musixtnt.tex is an extension library for MusiXTeX. It is available -at WIMA in the software archive. +at CTAN and 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} @@ -37,10 +37,7 @@ the score match the pattern of the first argument to \\TransformNotes exactly; t 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. +can be used to detect such inconsistencies. Notes commands are assumed to be terminated by \\en, not \\enotes. \\TransformNotes may be used anywhere between \\startpiece @@ -68,8 +65,8 @@ 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 +.BR autosp (1) +automates this process; it is available at WIMA in the software archive. The \\TransformNotes macro may be used for other purposes. Here are some examples: @@ -92,7 +89,7 @@ package for lyrics. .SH SEE ALSO .BR msxlint (1), -.BR fixmsxpart (1) +.BR autosp (1) .PP musixdoc.pdf diff --git a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf b/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf Binary files differindex 1e9374edd95..2cd529e0310 100644 --- a/Master/texmf-dist/doc/generic/musixtnt/TransformNotes.pdf +++ 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 differdeleted file mode 100644 index 833c48e57fd..00000000000 --- a/Master/texmf-dist/doc/generic/musixtnt/fixmsxpart.pdf +++ /dev/null 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 differdeleted file mode 100644 index 9bf6291cadf..00000000000 --- a/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2015-02-09.tar.gz +++ /dev/null diff --git a/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2016-01-30.tar.gz b/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2016-01-30.tar.gz Binary files differnew file mode 100644 index 00000000000..979058bdd65 --- /dev/null +++ b/Master/texmf-dist/doc/generic/musixtnt/musixtnt-2016-01-30.tar.gz diff --git a/Master/texmf-dist/doc/man/man1/fixmsxpart.1 b/Master/texmf-dist/doc/man/man1/fixmsxpart.1 deleted file mode 100644 index 2a546fcea3d..00000000000 --- a/Master/texmf-dist/doc/man/man1/fixmsxpart.1 +++ /dev/null @@ -1,185 +0,0 @@ -.\" This manpage is licensed under the GNU Public License -.TH FIXMSXPART 1 2015-02-05 "" "" - -.SH NAME -fixmsxpart \- corrects note spacing in a single-staff MusiXTeX part - -.SH SYNOPSIS -.B fixmsxpart -.RB [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ] - -.B fixmsxpart -.RB [ \-d\ | \ \-\-debug ] -.IR infile [ \fB.tex\fB ] -.RI [ outfile [ \fB.tex\fP ]] - - -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 -.IR outfile -is not specifed, standard output is used. - -.SH USAGE - -.SS Generating a Single-Instrument Part - -To generate a single-instrument part from (a copy of) the MusiXTeX source for -a multi-instrument score, add -.nf - - \\input musixtnt - -.fi -to the preamble, -set -.nf - - \\instrumentnumber1 - -.fi -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 -.IR four -instrument -score (arguments #2, #3, #4, and #5, separated by three &s), -and will result in a part for the -.IR second -of these (#3): - -.nf - \\TransformNotes{#2}{#3} -.fi - -Argument #1 is a scaling -parameter and should not be modified. -.B -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 -.BR 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: -.TP 3 -+ -adjustments of \\setname1, \\setclef1, \\setsign1 , \\setmeter1 and \\setstaffs1 commands, as necessary; -.TP 3 -+ -ensuring that tempo and roadmap markings -.RB ( D.C. , -.BR Fine , -etc.) are in the -appropriate instrument segment; -.PP -Finally, if the modified score is compiled and viewed, it may be seen that horizontal -spacing designed for -.I multiple -instruments often produces bad -spacing for a -.IR single -instrument. -This can be corrected manually (and very tediously) but it is -what -.B fixmsxpart -was designed to fix (much more conveniently). - -.SS Correcting Horizontal Spacing Using fixmsxpart -The -\\notes \\Notes \\NOtes \\NOTes... -commands in a -part derived from a multi-instrument score are unreliable, -and so -.B fixmsxpart -determines the spacing for ordinary notes by the note -commands themselves; for example, -.TP 3 -+ -\\qa, \\qu, \\ql, \\qp result in -\\NOtes; -.TP 3 -+ -\\ca, \\cu, \\cl, \\ds result in \\Notes; -.PP -and so on. -Spacing commands \\sk and \\hsk in the input are -discarded (but \\qsk, \\hqsk and explicit uses of \\off{...} are preserved). - -.B fixmsxpart -determines the spacing for -.IR 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 -.IR before -the \\tb... command. This is handled by setting a -variable -.IR new_beaming -when processing the \\tb... command -and only updating -.IR beaming -to -.IR 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. - -.IR Pointed -notes are -.IR 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 -.BR fixmsxpart -transformation: -.TP 3 -+ -Successive whole-bar rests are -accumulated into a multi-bar rest, with appropriate adjustment of the bar number. -.TP 3 -+ -\\alaligne -and \\alapage commands are replaced by \\bar. -.TP 3 -+ -\\mulooseness, \\eject, \\linegoal, \\song{top | bottom}, \\group{top | bottom} -and \\akkoladen -commands are commented out. -.TP 3 -+ -\\instrumentnumber... commands become -\\instrumentnumber1. -.TP 3 -+ -\\nostartrule is added to -the preamble. -.TP 3 -+ -Simple slurs or ties initiated by \\slur or \\tie are normalized by -setting the -.IR n -parameter to 1 on the -assumption that the new note spacing is correct. - -.SH LIMITATIONS -Only single-staff instrumental parts are supported. User-defined macros are not expanded. -A few esoteric MusiXTeX commands -and constructions are not supported. - -.SH SEE ALSO -.BR msxlint (1) -.PP -musixdoc.pdf - -.SH AUTHOR -This program and manual page were written by Bob Tennent <rdt@cs.queensu.ca>. diff --git a/Master/texmf-dist/doc/man/man1/fixmsxpart.man1.pdf b/Master/texmf-dist/doc/man/man1/fixmsxpart.man1.pdf Binary files differdeleted file mode 100644 index b259c22a813..00000000000 --- a/Master/texmf-dist/doc/man/man1/fixmsxpart.man1.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/man/man1/msxlint.man1.pdf b/Master/texmf-dist/doc/man/man1/msxlint.man1.pdf Binary files differindex 0707ad7f9e6..ff468a54488 100644 --- a/Master/texmf-dist/doc/man/man1/msxlint.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/msxlint.man1.pdf |