-*-text-*-

last update: 96/12/12, 0.0.16

INTRODUCTION

This is a beta version of LilyPond (a music typesetter). Please send
your helpful comments and patches to me,

	hanwen@stack.nl

LilyPond is updated very frequently, the latest version is always available at:

	ftp://pcnov095.win.tue.nl/pub/lilypond

PREREQUISITES

Compilation:

	- Unix (any decent Linux distribution is fine)
	- GNU C++ v2.7  or better
	- GNU make.
	- flex (2.5.1 or better)
	- bison/yacc
	- The "flower" library, which should be available from the
	same source you got this from.
	- perl

Operation:

	- TeX
	- the MusixTeX fonts

The Makefile uses  perl for trivial operations,  and you could  tinker
with it to use sed or awk.

COMPILING

Do:

	tar zxf flower-1.11.9.tar.gz
	mv flower-1.11.9 flower
	cd flower; make; cd ..
	tar zxf lilypond-1.2.13.tar.gz
	cd lilypond-1.2.13
	make

why G++ >= 2.7? LilyPond & flower lib uses:

	builtin bool
	typeof
	operator <?, operator >?

USING

At this time, LilyPond is only suited for Quick & Dirty jobs (the
output quality still is too low). If you're not discouraged; this is
what I type in my xterm:

	lilypond someinput.ly
	tex test
	xdvi test&

This is what the output looks like over here:

hw:~/musix/spacer$ lilypond maartje.ly
LilyPond version 0.0.16 compiled on Dec 11 1996 at 13:54:27
Parsing ... [symbol.ini][maartje.ly]
Processing ... Calculating ... Postprocessing ... 
output to lelie.uit...

hw:~/musix/spacer$ tex test
This is TeX, Version 3.14159 (C version 6.1)
(test.tex
Hyphenation patterns for english, dutch, loaded.
(lilyponddefs.tex) (lelie.uit) [1] [2] )
Output written on test.dvi (2 pages, 8072 bytes).
Transcript written on test.log.

hw:~/musix/spacer$ xdvi test&
[1] 1468

Check out kortjakje.ly, it has some comments

PROBLEMS

If LilyPond bombs out, then please recompile using -g, and send a gdb
stacktrace of the crash.


HOW DOES IT WORK

* Use The Source, Luke. If you don't know C++, you can try editing
.dstreamrc for copious debugging output. (use -d)

* the subdir Documentation/ contains some more-in-depth matter on LilyPond

* The source is commented in the DOC++ style.
Check out doc++ at

	http://www.ZIB-Berlin.DE/VisPar/doc++/doc++.html
