diff options
author | Norbert Preining <norbert@preining.info> | 2024-01-30 03:00:44 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2024-01-30 03:00:44 +0000 |
commit | 084f5d8435744b7ea7ef487ec111a7bfd100ed62 (patch) | |
tree | d4e91f6ef6d075509a2b33942f57337725089951 /macros/musixtnt/doc | |
parent | 6c43653052d016d5913aabb728c484f0e62b4754 (diff) |
CTAN sync 202401300300
Diffstat (limited to 'macros/musixtnt/doc')
-rw-r--r-- | macros/musixtnt/doc/TransformNotes.3 | 98 | ||||
-rw-r--r-- | macros/musixtnt/doc/TransformNotes.pdf | bin | 6616 -> 0 bytes | |||
-rw-r--r-- | macros/musixtnt/doc/msxlint.1 | 36 | ||||
-rw-r--r-- | macros/musixtnt/doc/msxlint.pdf | bin | 4148 -> 0 bytes |
4 files changed, 0 insertions, 134 deletions
diff --git a/macros/musixtnt/doc/TransformNotes.3 b/macros/musixtnt/doc/TransformNotes.3 deleted file mode 100644 index 752aa02985..0000000000 --- a/macros/musixtnt/doc/TransformNotes.3 +++ /dev/null @@ -1,98 +0,0 @@ -.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 <rdt@cs.queensu.ca>. - diff --git a/macros/musixtnt/doc/TransformNotes.pdf b/macros/musixtnt/doc/TransformNotes.pdf Binary files differdeleted file mode 100644 index 2cd529e031..0000000000 --- a/macros/musixtnt/doc/TransformNotes.pdf +++ /dev/null diff --git a/macros/musixtnt/doc/msxlint.1 b/macros/musixtnt/doc/msxlint.1 deleted file mode 100644 index d0a3f695ae..0000000000 --- a/macros/musixtnt/doc/msxlint.1 +++ /dev/null @@ -1,36 +0,0 @@ -.\" 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 <rdt@cs.queensu.ca>. diff --git a/macros/musixtnt/doc/msxlint.pdf b/macros/musixtnt/doc/msxlint.pdf Binary files differdeleted file mode 100644 index a0a3ecd26a..0000000000 --- a/macros/musixtnt/doc/msxlint.pdf +++ /dev/null |