summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/autosp.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-05-03 17:35:31 +0000
committerKarl Berry <karl@freefriends.org>2017-05-03 17:35:31 +0000
commitb44542791aed9e9287e23c5e749881555b42ccee (patch)
treeaaff7dfe66103be4cf92069de54f1b8daf1ca5a3 /Master/texmf-dist/doc/man/man1/autosp.1
parent7481a4854eaf5e6e010a838d0851bb9a5c9e3e7f (diff)
TL2017 man page update
git-svn-id: svn://tug.org/texlive/trunk@44166 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/autosp.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/autosp.126
1 files changed, 18 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/man/man1/autosp.1 b/Master/texmf-dist/doc/man/man1/autosp.1
index 6affb4d93fe..dd66df84458 100644
--- a/Master/texmf-dist/doc/man/man1/autosp.1
+++ b/Master/texmf-dist/doc/man/man1/autosp.1
@@ -1,5 +1,5 @@
.\" This manpage is licensed under the GNU Public License
-.TH AUTOSP 1 2016-01-30 "" ""
+.TH AUTOSP 1 2017-04-06 "" ""
.SH NAME
autosp \- preprocessor to generate note-spacing commands for MusiXTeX scores
@@ -126,9 +126,14 @@ coded using the standard \\def\\atnextbar notation but also
the non-standard command \\Cpause in a note segment generates a
bar-centered rest.
-Spacing commands \\sk and \\hsk
-(but not \\qsk, \\hqsk or \\qqsk)
-in the source are discarded.
+Spacing commands \\sk and \\hsk in the source are discarded,
+but not \\qsk, \\hqsk or \\qqsk;
+moreover
+non-standard commands
+\\Qsk, \\HQsk and \\QQsk generate "global" skips; i.e., the effect of \\qsk, \\hqsk or \\qqsk in
+.I every
+staff.
+
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
@@ -199,7 +204,7 @@ 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 these assumptions
+If this assumption
isn't valid, the x-tuplet must
be coded explicitly using a \\vnotes command; see the first
measure of barsant2.aspc for an example of a non-standard x-tuplet: a 5-tuple
@@ -207,7 +212,11 @@ of 64th notes with an intended duration
of
.I six
64ths.
-
+.B autosp
+cannot deal with simultaneous x-tuplets in multiple staffs unless the x values and
+note durations are identical. Global skips (\\QQsk, \\HQsk and \\Qsk) are
+ineffective if a staff has an x-tuplet; however, "local" skips (\\qqsk, \\hqsk, \\qsk)
+are effective.
User-defined macros are not processed or expanded.
@@ -215,8 +224,9 @@ All staffs are assumed to have the same meter; see kinder2.aspc for
an example of how to work around this.
.B autosp
-will 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, or to omit certain voices
+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