diff options
author | Karl Berry <karl@freefriends.org> | 2019-01-09 22:56:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-01-09 22:56:43 +0000 |
commit | 9823a3300cfc8502e141583168741e3d8f757537 (patch) | |
tree | cc3de33d4b38f88fe4abd134f4896e8a53bd7abd /Master/texmf-dist | |
parent | 72dc156cb5ac86df57a1d2d49c1446744be53395 (diff) |
autosp (9jan19)
git-svn-id: svn://tug.org/texlive/trunk@49652 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
15 files changed, 4 insertions, 349 deletions
diff --git a/Master/texmf-dist/doc/generic/autosp/README b/Master/texmf-dist/doc/generic/autosp/README index ea1b5218811..e9abdc25d56 100644 --- a/Master/texmf-dist/doc/generic/autosp/README +++ b/Master/texmf-dist/doc/generic/autosp/README @@ -1,5 +1,5 @@ This is the README for the autosp package, -version 2018-02-23. +version 2019-01-08. autosp is a preprocessor that generates note-spacing commands for MusiXTeX scores. It simplifies the creation diff --git a/Master/texmf-dist/doc/generic/autosp/autosp.1 b/Master/texmf-dist/doc/generic/autosp/autosp.1 deleted file mode 100644 index 3d51ccd5947..00000000000 --- a/Master/texmf-dist/doc/generic/autosp/autosp.1 +++ /dev/null @@ -1,300 +0,0 @@ -.\" This manpage is licensed under the GNU Public License -.TH AUTOSP 1 2018-02-14 "" "" - -.SH NAME -autosp \- preprocessor to generate note-spacing commands for MusiXTeX scores - -.SH SYNOPSIS -.B autosp -.RB [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ] - -.B autosp -.RB [ \-d\ |\ \-\-dotted ] -.RB [ \-l\ |\ \-\-log ] -.IR infile [\fR.aspc\fP] -.RI [ outfile [ \fR.tex\fP ]] - - -This program makes it easier to create MusiXTeX scores by converting (non-standard) commands of the -form \\anotes ... \\en into one or more conventional -note-spacing commands (\\notes \\Notes \\NOtes ...), -determined by the actual note values, with \\sk spacing commands inserted as necessary. -The coding -for an entire measure can be entered one part at a time, -without -concern for note-spacing changes within the part or spacing requirements of other parts. - -For example, if applied to -.nf - - \\anotes\\qa J\\qa K&\\ca l\\qa m\\ca n\\en - -.fi -.B autosp -generates -.nf - - \\Notes\\qa J\\sk\\qa K\\sk&\\ca l\\qa m\\sk\\ca n\\en - -.fi -Typically, -an -\\anotes command generates several conventional -note-spacing commands. - -If the -.I infile -argument -does not have an .aspc extension, input is taken from -.IR infile .aspc -if that file exists. - -If the -.I outfile -argument does not have a .tex extension, output is sent to -.IR outfile .tex. -If no -.I outfile -argument is provided, output will go to -.IR infile .tex -(or to -.IR infile .ltx -if a \\documentclass declaration is encountered). - -For -\\anotes commands, -line breaks and spaces may precede note segments, allowing more flexible source formatting; -the line breaks and spaces will be elided from the output. - -For example, -.nf - - \\anotes - \\ibl0K0\\qb0K\\nbbl0\\qb0{.K}\\tbbbl0\\tbbl0\\tql0L& - \\ibbl1m{-2}\\qb1{.m}\\tbbbl1\\tbbl1\\qb1l\\tql1k\\en - -.fi -is acceptable and generates -.nf - - \\notesp\\ibl0K0\\qb0K&\\ibbl1m{-2}\\qb1{.m}\\en - \\nnotes\\sk&\\tbbbl1\\tbbl1\\qb1l\\en - \\notesp\\nbbl0\\qb0{.K}&\\tql1k\\en - \\nnotes\\tbbbl0\\tbbl0\\tql0L&\\sk\\en - -.fi - - -If the -.B \-l -( \fB\-\-log\fP ) option is used, a very detailed log -.IR infile .alog -is generated. - -If the -.B \-d -( \fB--dotted\fP ) -option is used, -.I dotted -beam notes of the form \\qb{\fIn\fP}{\fB.\fP\fIp\fP} are -.I not -given extra space; -it is assumed that the subsequent note will be shifted -by -a \\roff-like command -or a spacing command such as \\qsk or \\hqsk. -Commands of the form \\qlp{\fIp\fP}, \\qlpp{\fIp\fP}, ..., \\qpb{\fIn\fP}{\fIp\fP} and -\\qppb{\fIn\fP}{\fIp\fP} are always spaced -as indicated. - -If there is a single staff, consecutive whole-bar rest bars -are merged into a multi-bar rest. Bar-centered rests can be -coded using the standard \\def\\atnextbar notation but -the non-standard command \\Cpause in a note segment also generates a -bar-centered rest. - -Spacing commands \\sk and \\bsk in the source are discarded, -but not "small" skips \\hsk, \\qsk, \\tqsk, \\hqsk or \\qqsk, -or the small "backward" skips \\hbsk, \\bqsk, \\btsk, or \\bhsk. -Moreover, -non-standard commands -\\QQsk, \\HQsk \\TQsk and \\Qsk in the source generate "global" skips; i.e., the effect of \\qqsk, \\hqsk, \\tqsk or \\qsk, respectively, in -.I every -staff. These ensure that staffs remain synchronized if additional spacing is needed in any staff(s). - -Global skips may also be obtained within collective-coding sequences by using -up to four successive commas -to get the effects of \\QQsk, \\HQsk, \\TQsk or \\Qsk, respectively. -Global skips \\tqsk (or, for double-flats, \\qsk) are -automatically inserted before accidentals ('^', '_', '=', '<', '>') on collective-coding notes -(except when the preceding note is "virtual"; i.e., a skip). -If this automatic additional spacing is -.I not -wanted in some context, it may be avoided by -replacing -the accidental in the collective-coding sequence -by -any of the -.I explicit -accidental commands: \\sh, \\fl, \\na, \\smallsh, \\bigsh, etc. -If the automatic spacing is insufficient, the spacing may be increased by adding sufficient commas or -using a conventional notes command instead of \\anotes. - - -A note segment can be completely empty, but if a note segment should start -with or contain a "space," the note-value -of that space must be made explicit with a command of the -form \\ha{*}, \\qa{.*}, \\qa{*}, \\ca{*}, etc. - -From version 2017-06-14, the effects of \\TransformNotes calls are implemented by the -.B autosp -pre-processor. This -enables use of -musixlyr in -.B autosp -scores; musixlyr.tex -is incompatible with the -musixtnt.tex -implementation of \\TransformNotes. - -All other conventional MusiXTeX commands are output exactly as given in the input. - - -.SH OPERATION - -.B autosp -determines the spacing for ordinary notes from 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. - -The spacing for -.IR beamed -notes is determined by the beam -multiplicity, so that \\ib... results in \\Notes, \\ibb... results in -\\notes, etc. - -Collective coding of note sequences (including accidentals and dots) is handled -by expanding the sequence -into a sequence of individual note commands. - - -.SH LIMITATIONS - -.B autosp -assumes that & and | (rather than \\nextinstrument and \\nextstaff) are used to separate instruments and staffs. - - -Appoggiaturas and grace notes are recognized by the use of \\tinynotesize; note-spacing -of 1.45\\elemskip is used. If this isn't suitable and can't be corrected with a small skip, a -\\vnotes command with any desired spacing can be used. - -.B autosp -supports -.I x-tuplets -introduced using \\xtuplet{\fIx\fP} -or \\xxtuplet{\fIx:y\fP} -and -.I triplets -introduced -using any of the following commands (regardless of any re-definition of \\txt or \\tuplettxt): -.nf - - \\triolet - \\uptrio - \\downtrio - \\uptuplet - \\downtuplet - -.fi -.B autosp -assumes that an x-tuplet is to be played in -(\fIx\fP\-1)/\fIx\fP -of the apparent x-tuplet duration. -So, for example, a triplet in eighths is assumed to be played in the time of one quarter note. -If this assumption -isn't valid, the x-tuplet must -be coded explicitly using a suitable \\vnotes command; see the first -measure of barsant2.aspc for an example of a non-standard x-tuplet: a 5-tuple -of 64th notes with an intended duration -of -.I six -64ths. - -In some polyrhythmic scores, the \\txt numeral may be displaced, even if the notes -themselves are correctly spaced. In these cases, it is possible to suppress -the normal output of \\txt by using the non-standard commands \\Triolet (no arguments) -or \\Xtuplet{k}\\ -and placing a numeral at the correct location using \\zcn (i.e., \\zcharnote). - -.B autosp -can deal with simultaneous x-tuplets in multiple staffs provided the x values and -total note durations are identical. - -In some baroque scores, particularly by J.S. Bach, a beamed sixteenth note is vertically aligned -with -the third note of a triplet of eighth notes in another staff (implying that they should -be sounded simultaneously); e.g., -.nf - - \\ibl0L0\\qb0{.L}\\tqql0L - -.fi -would be played as if notated -.nf - - \\uptrio{b}10\\ql L\\hroff{\\cl L} - -.fi -The following coding will align the beamed sixteenth note -with the third note of a triplet in another staff: -.nf - - \\ibl0L0\\qb0{.L}\\hbsk\\tqql0L - -.fi -and, similarly, for triplets of sixteenth notes: -.nf - - \\ibbu0J0\\qb0{.J}\\hbsk\\nqqqu0J\\qb0{.J}\\hbsk\\tqqqu0J - -.fi -Generally, user-defined macros are not processed or expanded; however, definitions of the form -.nf - - \\def\\atnextbar{\\znotes ... \\en} - -.fi -generate definitions that do take account of \\TransformNotes. - -All staffs are assumed to have the same meter; see kinder2.aspc for -an example of how to work around this. - -.B autosp -may not be effective for music with more than one voice in a single staff. It might be -advisable to use a separate staff for each voice, to avoid \\anotes when necessary, -or to omit certain voices -initially and add them into the resulting TeX file. - -.SH EXAMPLES -See files quod2.aspc, kinder2.aspc, geminiani.aspc and barsant2.aspc for scores suitable for input to -.BR autosp . -The program -.B tex2aspc -can be used to convert "legacy" MusiXTeX scores to .aspc format. - -.SH SEE ALSO -.BR msxlint (1) -.BR tex2aspc (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/generic/autosp/autosp.pdf b/Master/texmf-dist/doc/generic/autosp/autosp.pdf Binary files differdeleted file mode 100644 index f4c1e0e38d8..00000000000 --- a/Master/texmf-dist/doc/generic/autosp/autosp.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/generic/autosp/barsant2.pdf b/Master/texmf-dist/doc/generic/autosp/barsant2.pdf Binary files differindex 275d1c8965d..78b4f76bafe 100644 --- a/Master/texmf-dist/doc/generic/autosp/barsant2.pdf +++ b/Master/texmf-dist/doc/generic/autosp/barsant2.pdf diff --git a/Master/texmf-dist/doc/generic/autosp/geminiani.pdf b/Master/texmf-dist/doc/generic/autosp/geminiani.pdf Binary files differindex f357a66d152..f84f30df39a 100644 --- a/Master/texmf-dist/doc/generic/autosp/geminiani.pdf +++ b/Master/texmf-dist/doc/generic/autosp/geminiani.pdf diff --git a/Master/texmf-dist/doc/generic/autosp/kinder2.pdf b/Master/texmf-dist/doc/generic/autosp/kinder2.pdf Binary files differindex 82029881bef..3bea428369d 100644 --- a/Master/texmf-dist/doc/generic/autosp/kinder2.pdf +++ b/Master/texmf-dist/doc/generic/autosp/kinder2.pdf diff --git a/Master/texmf-dist/doc/generic/autosp/quod2.aspc b/Master/texmf-dist/doc/generic/autosp/quod2.aspc index 052758c8cf3..31012e4b529 100644 --- a/Master/texmf-dist/doc/generic/autosp/quod2.aspc +++ b/Master/texmf-dist/doc/generic/autosp/quod2.aspc @@ -162,7 +162,6 @@ \ibbl2h1\qb2{hkj}\tqb2i\ibbl2j0\qb2j\tbbl2\qb2h\itieu2k\tqb2k& \ibu3f2\qb3f\tqh3g\ibu3h{-4}\qb3h\tqh3f\en \anotes\qa N\cu G&\ibu1i{-2}\qb1i\tqh1h\cu g&\ttie2\ibl2j0\qb2k\nbbl2\qb2j\tqb2k\cl i&\qa g\cu g\en -\mulooseness-1% \setrightrepeat \endpiece% \eject diff --git a/Master/texmf-dist/doc/generic/autosp/quod2.pdf b/Master/texmf-dist/doc/generic/autosp/quod2.pdf Binary files differindex 88881db6a9f..cd371ac188e 100644 --- a/Master/texmf-dist/doc/generic/autosp/quod2.pdf +++ b/Master/texmf-dist/doc/generic/autosp/quod2.pdf diff --git a/Master/texmf-dist/doc/generic/autosp/quod2A.pdf b/Master/texmf-dist/doc/generic/autosp/quod2A.pdf Binary files differindex 0291e120e79..96aa9875c84 100644 --- a/Master/texmf-dist/doc/generic/autosp/quod2A.pdf +++ b/Master/texmf-dist/doc/generic/autosp/quod2A.pdf diff --git a/Master/texmf-dist/doc/generic/autosp/tex2aspc.1 b/Master/texmf-dist/doc/generic/autosp/tex2aspc.1 deleted file mode 100644 index 5fa7e3c5b82..00000000000 --- a/Master/texmf-dist/doc/generic/autosp/tex2aspc.1 +++ /dev/null @@ -1,46 +0,0 @@ -.\" This manpage is licensed under the GNU Public License -.TH TEX2ASPC 1 2018-02-14 "" "" - -.SH NAME - -tex2aspc \- converts conventional MusiXTeX scores to .aspc format -for processing by -.BR autosp (1). - -.SH SYNOPSIS - -.B tex2aspc -.RB [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ] - -.B tex2aspc -.IR infile [\fR.tex\fP] -.RI [ outfile [ \fR.aspc\fP ]] - -This program re-factors (sequences of) conventional -note-spacing commands (\\notes \\Notes \\NOtes ...) -in a measure -into -a single \\anotes command. -This is intended for "legacy" scores in order to take advantage of -features -only provided by -.BR autosp (1), -such as "global" skips and processing of \TransformNotes commands. - -.SH LIMITATIONS - - -.B tex2aspc -assumes that & and | (rather than \\nextinstrument and \\nextstaff) are used to separate instruments and staffs. - -User-defined macros are not processed or expanded. - -.SH SEE ALSO -.BR autosp (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/generic/autosp/tex2aspc.pdf b/Master/texmf-dist/doc/generic/autosp/tex2aspc.pdf Binary files differdeleted file mode 100644 index dbef52ddf74..00000000000 --- a/Master/texmf-dist/doc/generic/autosp/tex2aspc.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/man/man1/autosp.1 b/Master/texmf-dist/doc/man/man1/autosp.1 index 3d51ccd5947..547933a96d6 100644 --- a/Master/texmf-dist/doc/man/man1/autosp.1 +++ b/Master/texmf-dist/doc/man/man1/autosp.1 @@ -14,7 +14,7 @@ autosp \- preprocessor to generate note-spacing commands for MusiXTeX scores .IR infile [\fR.aspc\fP] .RI [ outfile [ \fR.tex\fP ]] - +.SH DESCRIPTION This program makes it easier to create MusiXTeX scores by converting (non-standard) commands of the form \\anotes ... \\en into one or more conventional note-spacing commands (\\notes \\Notes \\NOtes ...), diff --git a/Master/texmf-dist/doc/man/man1/autosp.man1.pdf b/Master/texmf-dist/doc/man/man1/autosp.man1.pdf Binary files differindex c0904cc0581..f1d90c4a1fd 100644 --- a/Master/texmf-dist/doc/man/man1/autosp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/autosp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tex2aspc.1 b/Master/texmf-dist/doc/man/man1/tex2aspc.1 index 5fa7e3c5b82..7f860d491dc 100644 --- a/Master/texmf-dist/doc/man/man1/tex2aspc.1 +++ b/Master/texmf-dist/doc/man/man1/tex2aspc.1 @@ -16,6 +16,8 @@ for processing by .IR infile [\fR.tex\fP] .RI [ outfile [ \fR.aspc\fP ]] +.SH DESCRIPTION + This program re-factors (sequences of) conventional note-spacing commands (\\notes \\Notes \\NOtes ...) in a measure diff --git a/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf b/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf Binary files differindex d3fe0819bc7..573a558511c 100644 --- a/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf |