README

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