ABC Viewer
==========

ABC Viewer is a program to display abc format music files on the Palm
Pilot. It is still very much "alpha" software; please feel free to
report bugs.

Licensing
---------
ABC Viewer is distributed under the terms of the GNU General Public
Licence. This means (basically) that there is NO WARRANTY on the
software, and that you may distribute and modify the software subject to
certain conditions. See the GNU GPL at http://www.gnu.org/ for complete
information. The software is copyright (C) 1998,1999 Dave Holland.

Getting Started
---------------
ABC Viewer expects to find a MemoPad category called "ABC". If it can't,
it will complain and exit. Create that category and HotSync in a couple
of tunes before trying to use ABC Viewer.

Index View
----------
The first screen is the index of tunes. The titles are taken from the
MemoPad entries, with the "T:" magically removed. If an "X:" line is present
before the title (which is quite likely, if you've just hot-synced the tune
in) then it is skipped when looking for the title.

The tunes appear in the same order as they do in MemoPad, which means
that all tunes with initial "X:" lines appear after the others. This can
make the sort order seem rather strange.

Tap on a tune to display it. Use the scrollbar or up/down buttons to scroll.

Music Display
-------------
Tap Menu/Close to return to the index view, or Menu/Edit ABC to drop
into the MemoPad with the tune loaded for editing.

Author
------
Dave Holland <dave@zenda.demon.co.uk>

To Do (also, "grep TODO *.c")
-----
key signatures
clefs
slurs
beams
scrolling in music view
keeping place in index view between invocations
bug with drawing off bottom of screen?
guitar chords

Probably never likely to happen
-------------------------------
multi-voice tunes (either as chords or as separate staves)
lyrics

Version History
---------------
0.2 fixed bugs in drawing of |: and ledger lines
    fixed bug in parsing non-standard note lengths
    ignore "\" and "*" (used by abc2mtex for line breaking/justification)
    fixed off-by-one error in guitar chord parsing
    displays whole notes (semibreves) properly
    1st/2nd time endings (ish)
    ignore "X:" when looking for title to display in index
    ">" and "<" work now

0.3 accidentals show up now