README

   1 -*-text-*-
   2
   3 last update: 96/17/12, 0.0.17
   4
   5 LICENSE
   6
   7 See file COPYING
   8
   9 INTRODUCTION
  10
  11 This is a beta version of LilyPond (a music typesetter). Please send
  12 your helpful comments and patches to me,
  13
  14         hanwen@stack.nl
  15
  16 LilyPond is updated very frequently, the latest version is always available at:
  17
  18         ftp://pcnov095.win.tue.nl/pub/lilypond
  19
  20 PREREQUISITES
  21
  22 Compilation:
  23
  24         - Unix (any decent Linux distribution is fine)
  25         - GNU C++ v2.7  or better
  26         - GNU make.
  27         - flex (2.5.1 or better)
  28         - bison/yacc
  29         - The "flower" library, which should be available from the
  30         same source you got this from.
  31         - perl
  32
  33 Operation:
  34
  35         - TeX
  36         - the MusixTeX fonts
  37
  38 The Makefile uses  perl for trivial operations,  and you could  tinker
  39 with it to use sed or awk.
  40
  41 COMPILING
  42
  43 Do:
  44
  45         tar zxf flower-1.11.9.tar.gz
  46         mv flower-1.11.9 flower
  47         cd flower; make; cd ..
  48         tar zxf lilypond-1.2.13.tar.gz
  49         cd lilypond-1.2.13
  50         make
  51
  52 why G++ >= 2.7? LilyPond & flower lib uses:
  53
  54         builtin bool
  55         typeof
  56         operator <?, operator >?
  57         new for-scope
  58
  59 USING
  60
  61 At this time, LilyPond is only suited for Quick & Dirty jobs (the
  62 output quality still is too low). If you're not discouraged; this is
  63 what I type in my xterm:
  64
  65         lilypond someinput.ly
  66         tex test
  67         xdvi test&
  68
  69 This is what the output looks like over here:
  70
  71         hw:~/musix/spacer$ lilypond maartje.ly
  72         LilyPond 0.0.17/FlowerLib 1.0.14. Compile: Dec 17 1996, 11:33:54 (g++ 2.7.2)
  73         Parsing ... [symbol.ini][maartje.ly]
  74         Processing ... Calculating ... Postprocessing ...
  75         output to lelie.uit...
  76
  77         hw:~/musix/spacer$ tex test
  78         This is TeX, Version 3.14159 (C version 6.1)
  79         (test.tex
  80         Hyphenation patterns for english, dutch, loaded.
  81         (lilyponddefs.tex) (lelie.uit) [1] [2] )
  82         Output written on test.dvi (2 pages, 8072 bytes).
  83         Transcript written on test.log.
  84
  85         hw:~/musix/spacer$ xdvi test&
  86         [1] 1468
  87
  88 Check out kortjakje.ly, it has some comments
  89
  90
  91 PROBLEMS
  92
  93 If LilyPond bombs out, then please recompile using -g, and send a gdb
  94 stacktrace of the crash. It also helps if you can print the values of the objects. So if you trace is
  95
  96 (gdb) backtrace 12
  97 #0  Interval::operator+= (this=0x11fffec60, r=-1.7976931348623157e+308)
  98     at ../flower/interval.hh:50
  99 #1  0x12005195c in Item::width (this=0x14008a680) at src/item.cc:39
 100 #2  0x12008fdbc in itemlist_width (its=0x11fffed58) at src/simpleprint.cc:40
 101   :
 102   :
 103
 104 Than it would help if you send a dump of the Interval and the Item (use: 'print *this' or use LilyPond print() methods)
 105
 106 HOW DOES IT WORK
 107
 108 * Use The Source, Luke. If you don't know C++, you can try editing
 109 .dstreamrc for copious debugging output. (use -d)
 110
 111 * the subdir Documentation/ contains some more-in-depth matter on LilyPond
 112
 113 * The source is commented in the DOC++ style.
 114 Check out doc++ at
 115
 116         http://www.ZIB-Berlin.DE/VisPar/doc++/doc++.html