Print

Print


*****************************************************************
********** Announcing    version   1.1   of   abc2mtex **********
*****************************************************************
 
This is a package designed to notate tunes  stored  in  an  ascii
format  (henceforth  abc notation). It was designed primarily for
folk and traditional tunes of Western European  origin  (such  as
Irish, English and Scottish) which can be written on one stave in
standard classical notation. However, it should be extendible  to
many other types of music.
 
As an example the tune Paddy O'Rafferty would be written out as
 
T:Paddy O'Rafferty
C:Trad.
M:6/8
K:D
dff cee|def gfe|dff cee|dfe dBA|dff cee|def gfe|faf gfe|[1 dfe dBA:|[2 dfe dcB||
~A3 B3|gfe fdB|AFA B2c|dfe dcB|~A3 ~B3|efe efg|faf gfe|[1 dfe dcB:|[2 dfe dBA||
fAA eAA|def gfe|fAA eAA|dfe dBA|fAA eAA|def gfe|faf gfe|dfe dBA:|
 
The tune is then read in by the program and MusicTeX output  gen-
erated (in a matter of seconds). TeX can then be run on this out-
put to "typeset beautiful music".
 
The package is small (about 70 KByte), easy to use and  features,
amongst   other  things,  the ability to transpose both music and
abc notation. It will also create an index of all the  tunes  you
have transcribed.
 
The ability to write tunes in abc notation means that they can be
easily  and  portably  stored or transported electronically. This
package allows you to typeset them easily too.
 
The package has been written on top of MusicTeX , Daniel Taupin's
music   typesetting package, itself written on top of TeX, Donald
Knuth's typesetting package. To  run  it  you  will   need    TeX
(widely  available  on Unix machines and also available for PCs),
MusicTeX  (available   by  ftp  from a number of sources such  as
ftp.wustl.edu in /packages/TeX/macros/musictex) and a C compiler.
 
You can get a copy  of   the   package   by  anonymous  ftp  from
ftp.maths.tcd.ie in /pub/TeX/abc2mtex or  celtic.stanford.edu  in
/pub/tunes/abc2mtex   or    by    sending   an   email    request
to  me ([log in to unmask]).
 
        Chris Walshaw
 
 
CHANGES BETWEEN V1.1 & V1.0
^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
The name of the executable has now been changed  from  format  to
abc2mtex and the name of the code changed to abc2mtex.c.
 
        NEW FEATURES (see userguide for full details)
        ^^^^^^^^^^^^
 
The K: field now accepts mixolydian & dorian modes (e.g.  K:AMix,
K:EDor), together with K:HP & K:Hp for highland pipes.
 
The new P: field can be used to mark parts inside  the  tune  and
the order of playing them in the header.
 
If the M: field is used to change meter and the change is just to
adjust the default note length (e.g. 4/4 -> 4/4l) then the change
doesn't show up in the printed music.
 
        BUG FIXES
        ^^^^^^^^^
 
,G corrected to G, etc. in transpose lists in abc2mtex.c.
 
        OTHER CHANGES
        ^^^^^^^^^^^^^
 
The MusicTeX macro * is now used to generate extra space in front
of accidentals and all macros containing O have been taken out of
zmacros.tex. This has halved the size of zmacros.tex  and  allows
the  code  to  cope  with  any  arrangement of accidentals within
beams.
 
The z marks which generate rests can be `dotted', i.e. z3,  z6  &
z12, to generate two rests, one half the length of the other.
 
The z's are also recognised by the code to  terminate  beams  (so
that coding such as g3zgz will be treated properly).
 
There are new macros (from John Walsh) in zmacros.tex for 7  &  8
gracenotes & for acb patterns.
 
Notes lengths of 1 and of more than one digit (e.g. 12 or 16) are
now possible.