summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/autosp/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-03-04 23:59:46 +0000
committerKarl Berry <karl@freefriends.org>2018-03-04 23:59:46 +0000
commit3e0b4848b04542e4b5d3510fbdff3b826354714a (patch)
treeef3e847e3a0552970fbb9810661230dba435467e /Master/texmf-dist/doc/generic/autosp/README
parent351aef16f282a75c4e791fad94103a93bc3fea7a (diff)
autosp for tl18
git-svn-id: svn://tug.org/texlive/trunk@46820 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/autosp/README')
-rw-r--r--Master/texmf-dist/doc/generic/autosp/README27
1 files changed, 15 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/generic/autosp/README b/Master/texmf-dist/doc/generic/autosp/README
index e8b174dc3b7..ea1b5218811 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 2017-04-06.
+version 2018-02-23.
autosp is a preprocessor that generates note-spacing
commands for MusiXTeX scores. It simplifies the creation
@@ -25,13 +25,6 @@ precede note segments, allowing more flexible source
formatting; the line breaks and spaces will be elided from
the output.
-If applied to a file with .tex extension, autosp will
-process conventional note-spacing commands (but not \vnotes
-or \znotes) similarly. This is intended to correct spacing
-in an extracted single-instrument part, but may not
-produce satisfactory output when applied to a conventional
-multi-instrument MusiXTeX score.
-
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 also
@@ -39,14 +32,19 @@ by using the non-standard command \Cpause in a note segment.
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 *every* staff.
+\Qsk, \TQsk, \HQsk and \QQsk generate "global" skips; i.e., the
+effect of \qsk, \tqsk, \hqsk or \qqsk in *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 form \ha{*}, \qa{.*}, \qa{*}, \ca{*}, etc.
+From version 2017-06-14, the effects of \TransformNotes calls are
+implemented by the pre-processor. This enables use of autosp with
+musixlyr.tex, which is incompatible with the musixtnt.tex implementation
+of \TransformNotes.
+
All other conventional MusiXTeX commands are output exactly
as given in the input.
@@ -114,13 +112,18 @@ comments of the form %barno appended to commands such as
\bar, \alaligne, etc. replacing any existing comments.
Bar-numbering in the MusiXTeX output is not affected
+Also included is the program tex2aspc which re-factors
+conventional MusiXTeX scores to aspc format suitable for
+autosp pre-processing by merging every conventional notes
+commands in a measure into a single \anotes command.
+
To install the autosp package, unzip autosp.tds.zip
at the root of a local or personal texmf tree and
update the file-name database. This will install
documentation and examples.
-On Windows or MacOSX, install the relevant binaries on the
-PATH of executables. On Unix-like systems, unpack the
+On Windows or MacOSX, install the relevant binaries on
+the PATH of executables. On Unix-like systems, unpack the
.tar.gz archive, and compile and install using the sequence
./configure && make && sudo make install