From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/musixtnt/doc/TransformNotes.3 | 98 +++++++++++++++++++++++++++++++++ macros/musixtnt/doc/TransformNotes.pdf | Bin 0 -> 6616 bytes macros/musixtnt/doc/msxlint.1 | 36 ++++++++++++ macros/musixtnt/doc/msxlint.pdf | Bin 0 -> 4148 bytes 4 files changed, 134 insertions(+) create mode 100644 macros/musixtnt/doc/TransformNotes.3 create mode 100644 macros/musixtnt/doc/TransformNotes.pdf create mode 100644 macros/musixtnt/doc/msxlint.1 create mode 100644 macros/musixtnt/doc/msxlint.pdf (limited to 'macros/musixtnt/doc') diff --git a/macros/musixtnt/doc/TransformNotes.3 b/macros/musixtnt/doc/TransformNotes.3 new file mode 100644 index 0000000000..752aa02985 --- /dev/null +++ b/macros/musixtnt/doc/TransformNotes.3 @@ -0,0 +1,98 @@ +.TH TransformNotes 3 2016-01-30 "" "" + +.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 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} +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. +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 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: + +\\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 autosp (1) +.PP +musixdoc.pdf + +.SH AUTHOR +This manual page was written by Bob Tennent . + diff --git a/macros/musixtnt/doc/TransformNotes.pdf b/macros/musixtnt/doc/TransformNotes.pdf new file mode 100644 index 0000000000..2cd529e031 Binary files /dev/null and b/macros/musixtnt/doc/TransformNotes.pdf differ diff --git a/macros/musixtnt/doc/msxlint.1 b/macros/musixtnt/doc/msxlint.1 new file mode 100644 index 0000000000..d0a3f695ae --- /dev/null +++ b/macros/musixtnt/doc/msxlint.1 @@ -0,0 +1,36 @@ +.\" This manpage is licensed under the GNU Public License +.TH MSXLINT 1 2015-02-05 "" "" + +.SH NAME +msxlint \- detects incorrectly formatted notes lines in a MusiXTeX source file. + +.SH SYNOPSIS +.B msxlint +.RB [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ] + +.B msxlint +.RB [ \-d\ | \ \-\-debug ]... +.RI [ infile [ \fB.tex\fP ]...] + +If no +.IR infiles +are specifed, standard input is used. + +.SH USAGE + +The format that notes commands are expected to match is +determined by \\instrumentnumber and \\setstaffs commands, or +uses of the \\TransformNotes macro defined in musixtnt.tex (see musixdoc.pdf), or re-definitions of the \\vnotes macro. +Output consists of messages about format errors, +with listings of the ill-formatted lines. + +.SH LIMITATIONS +User-defined macros are not processed or expanded. Notes commands (\\notes, \\Notes, etc.) +can have line breaks, but other commands must fit on one line. +.SH SEE ALSO +.BR fixmsxpart (1) +.PP +musixdoc.pdf + +.SH AUTHOR +This program and manual page were written by Bob Tennent . diff --git a/macros/musixtnt/doc/msxlint.pdf b/macros/musixtnt/doc/msxlint.pdf new file mode 100644 index 0000000000..a0a3ecd26a Binary files /dev/null and b/macros/musixtnt/doc/msxlint.pdf differ -- cgit v1.2.3