################################################################
#  ABCMR    0.0.6 ------- Jan. 31, 2002 Luis Pablo Gasparotto  #
################################################################

Thank you for use this program.

I ask you to have patience because this is my first program using PERL.
As you will see I'm not a PERL MASTER.

abcmr.tcl is a script designed to convert a sequence of whole rest into 
one multimeasure rest (Zn or "n"zn'). 

I've created this program because I was needing to make individual parts 
from a general score with rest compressing. 

Thanks to Christoph Dalitz (creator of acbtab2ps) for suggesting this 
project. 

I shall appreciate all comments and bug reports. 

REQUIREMENTS: 
-------------
You will need:
    - Tcl (I'm using v8.3.2 and I've not tested with other versions)
    - abcm2ps, abctab2ps, abc2ps or yaps (if you want to display and print your music)
    - abc2abc (if you want to use indpart script, I've modified the sources 
		in order to can deal with "Z".)
		
FEATURES:
---------
abcmr.tcl:
    - Condense a sequence of whole rests into ONE multimeasure rest (Zn or "n"zn).
    - Stop condensing when ||, :| , |: or |] is detected.
    - Send a text file to the standard out. It can be redirected to a file using ">".
indpart:
    - Extract individual parts from a score. Extracting (abcxv), transposing 
	(abc2abc) and compresing rests (abcmr).
Zn2nz.pl:
    - Replace abcm2ps multimeasure rests for abctab2ps and abc2ps multimeasure 
	rests. This is Zn for "n"zn'. (from this version it was included on abcmr)

nz2Zn.pl:
    - Replace abctab2ps and abc2ps multimeasure rests for abcm2ps multimeasure
	rests. This is "n"zn' for Zn. (from this version it was included on abcmr) 
    
LIMITS:
-------
This program:
    - Can't deal with more than one voice. So you will need to run abcselect first.
    - Can't condense rests diferents of a whole rest. It will work with "| z8 | z8 |" 
	and will not work with "| z4 z4 | z4 z4 |"
    - Can't condense multiple multimeasure rests (i.e. Z8 | Z4 don't become Z12)

CHANGES:
--------
    0.0.1-0.0.2		- Several bugs were fixed
			- Now the whole rest ($whole_rest) can be 3 digits
			- Added two abc sample files. One for abcmr (rc-sanple-file.abc)
			    and the other for indpart (ip-sample-file.abc) 
			- Changes in the code in order to make the program run faster 
			    (There's a lot to do in this area)

    0.0.2-0.0.3		- Added -Z or -z flag to select kind of multimeasure rest.
			    -Z will generate Zn (abcm2ps/abctab2ps) and -z will generate 
			    "n"zn' (jaabc2ps, abc2ps, yaps). Default is -Z.
			- Added two PERL scripts for converting Zn to "n"zn' (Zn2nz.pl)	
			    and "n"zn' to Zn (nz2Zn.pl)
			- Added install script.
    0.0.3-0.0.4		- The script was ported entirely to Tcl. I plan to keep supporting 
			    and upgrading the Perl version.
			- The code was optimized. Unnecessary variables and steps were
			    removed.
			- Minor bugs were fixed.
			- The -n flag was added to avoid removing \ at the end of the 
			    lines
			- Zn2nz and nz2Zn were included in abcmr.tcl. Now abcmr checks if
			    there previous multimeasures rest and changes these to the 
			    right format.
			- An tune and voice extraction utility called abcxv.tcl was 
			    included.
    0.0.4-0.0.5		- The code was reorganized (Thanks to Seymour Shlien). It's 
			    more readable 
			- The internal documentation was improved (Thanks to Seymour Shlien)

    0.0.5-0.0.6		- Left space eliminated
    
    
################################################################
# ABCPE    0.0.2 -------  June 7, 2002   Luis Pablo Gasparotto #
################################################################

ABCPE is a Tcl script that manage abcxv, abcmr, abc2abc and abcra. 
You will need abcmr.tcl, abxv.tcl, abc2abc and abcra in a path 
directory in order to use ABCEP.

Usage: 
abcep.tcl input.abc [Flags] -o output.abc
Flags could be:
 -x	: for selecting tune number (Default:1)  
 -v	: for selecting voice number (Default:1)
 -p	: for keeping pseudocomments for all voices (Default:no)
 -m	: for compressing whole rests into a multimeasure rest (Default:no)
 -Z	: for compressing rests to Zn
 -z	: for compressing rests to "n"zn'
 -n 	: for not removing \ character

Changes:
  
    0.0.1-0.0.2		- Bug when doing abcmr.tcl because compressrests was always 0
			- Rest compress is optional you will need to add -z or -Z
			    to make it works
    0.0.2-0.0.3		- "-m" flag no longer used

################################################################
# ABCXV    0.0.3 -------  June 21, 2002  Luis Pablo Gasparotto #
################################################################

ABCXV is a Tcl script for tune and voice extracting.

Usage:
abcxv.tcl [Flags] input.abc > output.abc

Flags could be:

-x  : for selecting tune number (Default=1)  
-v  : for selecting voice number (Default=1)
-p for keeping pseudocomments for all voices (Default=No)

The output will be directed to the std output if no output file is defined

Changes:
    
    0.0.1-0.0.2		- Can keep pseudocomments for all voices or not
    0.0.2-0.0.3		- Keep pseudocomments placed at the begining of the file 


################################################################
# ABCRA   0.0.2 ------- June 24, 2002   Luis Pablo Gasparotto  #
################################################################

ABCRA is a Tcl script for converting double sharps and double 
flats into single sharps, single flats or naturals.

Usage:
abcra.tcl input.abc > output.abc

The output will be directed to the std output if no output file is defined

Changes:
    
    0.0.1-0.0.2		- Bug when eliminating unnecessary accidentals solved. 
			    $bar_content was changed by $bar_content2

Luis Pablo Gasparotto
luispagasparotto@yahoo.com