README file for the OS/2 distribution of Mup.

Hello all,

This is an OS/2 - eCS *unofficial* port of the latest (at 11/13/2008) version
of mup - music publishing program from Arkkra Enterprises (www.arkkra.com). I
ported the source code of mup to  OS/2 - eCS  by using the  Build Environment 
from Paul Smedley (www.smedley.info), using GCC 3.3.5 - this will be the last
time  I port mup using gcc 3.3.5, by the way:  I'm going to use gcc 4.3.2 and 
3.4.6 all the time for my next works.

Please note this is an unofficial port, which means that neither I, nor Paul,
nor Arkkra Enterprises will be liable  for any damage might occur from proper
or improper use  of the included software.  All I can say is that I read some
of the source code,  and saw it clean and damage-free,  but I can't guarantee
it will work as expected (on my PC it works fine).

As for all the software ported with GCC 3.3.5 and later,  to run Mup you will 
need the libc063.dll,  available at ftp.netlabs.org:  the  FTP URL  for it is
ftp://ftp.netlabs.org/pub/gcc/libc-0.6.3-csd3.zip.  Using other software from
Paul, or eComStation, it's really likely you already have it.

Please note that Mup is *shareware*:  for this particular product, this means
that,  if you don't register it,  any score  printed with mup  will contain a 
statement saying you're using an unregistered copy. In my humble opinion, you
must be really a "big loser" if you don't want to pay US$29 to buy it.  Also,
I strongly advise you to donate  some money  to Paul,  who's been  so kind to 
make his build environment available and constantly updates it.

The OS/2 mup distribution lacks of  mupprnt and mupdisp, two DOS utilities to
display on screen and print on paper scores in mup format: in our beloved OS,
these two utilities are fairly useless,  known that we have got  many ways to
display/print/convert the postscript output coming from mup.

I have included in this distribution  also  some third-party software, linked
by the www.arkkra.com website: this software can help much in writing complex
scores. The contributions are listed below:

grids		- mup macro file to display chord grids.  Info on how  to use
		  it are included in the first lines of the file.

guitar		- mup macro file to print  guitar chords.  Again, info on how
		  to use it are included in the first lines of the file.

splitvoices	- maybe a  shell script  (bash?)  to split  a  mup file  into
		  multiple files, one for any voice of the score.

midi2mup.pl	- Perl script to convert a MIDI file in mup format.

mtm.exe		- C program to convert a  MIDI  file in mup format, ported by
		  me: simply feed it with the right file names.

pssubset.exe	- Prints a subsets of pages from a PostScript file. Reads from
                  stdin and writes to stdout.

mkmupfnt.exe	- Generates a fontfile for Mup to use, to override a Mup font.



All the exes have been ported by me, Mentore Siesto.

The "mups" subdirectory contains a couple of sample files (one of them, alas,
is  fairly  incomplete:  I'm trying  to  find some time to  typeset my  Choir 
teacher's scores...)

Note that  there exists somewhere a  "mupmate"  perl application,  which is a
complete IDE for mup: it's useful, but needs Perl/Tk, which is a kind of Perl
extension we seem not to have  (ISTR that Ilya did something in the past).  I
will try and look for it,  and maybe I will eventually port it on OS/2 - eCS.
In the meantime,  I plan to build some  kind of editor  with DrDialog  or EPM 
macro file using samples I found on hobbes. Simply don't hold your breath :-)

