scm/lily.scm

   1 ;;;; This file is part of LilyPond, the GNU music typesetter.
   2 ;;;;
   3 ;;;; Copyright (C) 1998--2012 Jan Nieuwenhuizen <janneke@gnu.org>
   4 ;;;; Han-Wen Nienhuys <hanwen@xs4all.nl>
   5 ;;;;
   6 ;;;; LilyPond is free software: you can redistribute it and/or modify
   7 ;;;; it under the terms of the GNU General Public License as published by
   8 ;;;; the Free Software Foundation, either version 3 of the License, or
   9 ;;;; (at your option) any later version.
  10 ;;;;
  11 ;;;; LilyPond is distributed in the hope that it will be useful,
  12 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 ;;;; GNU General Public License for more details.
  15 ;;;;
  16 ;;;; You should have received a copy of the GNU General Public License
  17 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 ;; Internationalisation: (_i "to be translated") gets an entry in the
  20 ;; POT file; (gettext ...) must be invoked explicitly to do the actual
  21 ;; "translation".
  22 ;;
  23 ;; (define-macro (_i x) x)
  24 ;; (define-macro-public _i (x) x)
  25 ;; (define-public-macro _i (x) x)
  26 ;; Abbrv-PWR!
  27
  28 (defmacro-public _i (x) x)
  29
  30 ;;; Boolean thunk - are we integrating Guile V2.0 or higher with LilyPond?
  31 (define-public (guile-v2)
  32   (string>? (version) "1.9.10"))
  33
  34 (read-enable 'positions)
  35 (if (not (guile-v2))
  36     (debug-enable 'debug)
  37     (begin
  38       (debug-enable 'backtrace)
  39       (debug-set! show-file-name #t)))
  40
  41 (define-public PLATFORM
  42   (string->symbol
  43    (string-downcase
  44     (car (string-tokenize (utsname:sysname (uname)))))))
  45
  46 (define scheme-options-definitions
  47   `(
  48     ;; NAMING: either
  49
  50     ;; - [subject-]object-object-verb +"ing"
  51     ;; - [subject-]-verb-object-object
  52
  53     ;; Avoid overlong lines in `lilypond -dhelp'!  Strings should not
  54     ;; be longer than 48 characters per line.
  55
  56     (anti-alias-factor 1
  57 "Render at higher resolution (using given factor)
  58 and scale down result to prevent jaggies in
  59 PNG images.")
  60     (aux-files #t
  61 "Create .tex, .texi, .count files in the
  62 EPS backend.")
  63     (backend ps
  64 "Select backend.  Possible values: 'eps, 'null,
  65 'ps, 'scm, 'socket, 'svg.")
  66     (check-internal-types #f
  67 "Check every property assignment for types.")
  68     (clip-systems #f
  69 "Generate cut-out snippets of a score.")
  70     (datadir #f
  71 "LilyPond prefix for data files (read-only).")
  72     (debug-gc #f
  73 "Dump memory debugging statistics.")
  74     (debug-gc-assert-parsed-dead #f
  75 "For memory debugging: Ensure that all
  76 references to parsed objects are dead.  This is
  77 an internal option, and is switched on
  78 automatically for `-ddebug-gc'.")
  79     (debug-lexer #f
  80 "Debug the flex lexer.")
  81     (debug-page-breaking-scoring #f
  82 "Dump scores for many different page breaking
  83 configurations.")
  84     (debug-parser #f
  85 "Debug the bison parser.")
  86     (debug-property-callbacks #f
  87 "Debug cyclic callback chains.")
  88     (debug-skylines #f
  89 "Debug skylines.")
  90     (delete-intermediate-files #t
  91 "Delete unusable, intermediate PostScript files.")
  92     (dump-profile #f
  93 "Dump memory and time information for each file.")
  94     (dump-cpu-profile #f
  95 "Dump timing information (system-dependent).")
  96     (dump-signatures #f
  97 "Dump output signatures of each system.  Used for
  98 regression testing.")
  99     (eps-box-padding #f
 100 "Pad left edge of the output EPS bounding box by
 101 given amount (in mm).")
 102     (gs-load-fonts #f
 103 "Load fonts via Ghostscript.")
 104     (gs-load-lily-fonts #f
 105 "Load only LilyPond fonts via Ghostscript.")
 106     (gui #f
 107 "Run LilyPond from a GUI and redirect stderr to
 108 a log file.")
 109     (help #f
 110 "Show this help.")
 111     (include-book-title-preview #t
 112 "Include book titles in preview images.")
 113     (include-eps-fonts #t
 114 "Include fonts in separate-system EPS files.")
 115     (include-settings #f
 116 "Include file for global settings, included before the score is processed.")
 117     (job-count #f
 118 "Process in parallel, using the given number of
 119 jobs.")
 120     (log-file #f
 121 "If string FOO is given as argument, redirect
 122 output to log file `FOO.log'.")
 123     (max-markup-depth 1024
 124 "Maximum depth for the markup tree. If a markup has more levels,
 125 assume it will not terminate on its own, print a warning and return a
 126 null markup instead.")
 127     (midi-extension ,(if (eq? PLATFORM 'windows)
 128                          "mid"
 129                          "midi")
 130 "Set the default file extension for MIDI output
 131 file to given string.")
 132     (music-strings-to-paths #f
 133 "Convert text strings to paths when glyphs belong
 134 to a music font.")
 135     (old-relative #f
 136 "Make \\relative mode for simultaneous music work
 137 similar to chord syntax.")
 138     (point-and-click #t
 139 "Add point & click links to PDF output.")
 140     (paper-size "a4"
 141 "Set default paper size.")
 142     (pixmap-format "png16m"
 143 "Set GhostScript's output format for pixel images.")
 144     (preview #f
 145 "Create preview images also.")
 146     (print-pages #t
 147 "Print pages in the normal way.")
 148     (protected-scheme-parsing #t
 149 "Continue when errors in inline scheme are caught
 150 in the parser.  If #f, halt on errors and print
 151 a stack trace.")
 152     (profile-property-accesses #f
 153 "Keep statistics of get_property() calls.")
 154     (resolution 101
 155 "Set resolution for generating PNG pixmaps to
 156 given value (in dpi).")
 157     (read-file-list #f
 158 "Specify name of a file which contains a list of
 159 input files to be processed.")
 160     (relative-includes #f
 161 "When processing an \\include command, look for
 162 the included file relative to the current file
 163 (instead of the root file)")
 164     (safe #f
 165 "Run in safer mode.")
 166     (separate-log-files #f
 167 "For input files `FILE1.ly', `FILE2.ly', ...
 168 output log data to files `FILE1.log',
 169 `FILE2.log', ...")
 170     (show-available-fonts #f
 171 "List available font names.")
 172     (strict-infinity-checking #f
 173 "Force a crash on encountering Inf and NaN
 174 floating point exceptions.")
 175     (strip-output-dir #t
 176 "Don't use directories from input files while
 177 constructing output file names.")
 178     (svg-woff #f
 179 "Use woff font files in SVG backend.")
 180     (trace-memory-frequency #f
 181 "Record Scheme cell usage this many times per
 182 second.  Dump results to `FILE.stacks' and
 183 `FILE.graph'.")
 184     (trace-scheme-coverage #f
 185 "Record coverage of Scheme files in `FILE.cov'.")
 186     (verbose ,(ly:verbose-output?)
 187 "Verbose output, i.e. loglevel at least DEBUG (read-only).")
 188     (warning-as-error #f
 189 "Change all warning and programming_error
 190 messages into errors.")
 191     ))
 192
 193 ;; Need to do this in the beginning.  Other parts of the Scheme
 194 ;; initialization depend on these options.
 195
 196 (for-each (lambda (x)
 197             (ly:add-option (car x) (cadr x) (caddr x)))
 198           scheme-options-definitions)
 199
 200 (for-each (lambda (x)
 201             (ly:set-option (car x) (cdr x)))
 202           (eval-string (ly:command-line-options)))
 203
 204 (debug-set! stack 0)
 205
 206 (if (defined? 'set-debug-cell-accesses!)
 207     (set-debug-cell-accesses! #f))
 208
 209 ;;(set-debug-cell-accesses! 1000)
 210
 211 (use-modules (ice-9 regex)
 212              (ice-9 safe)
 213              (ice-9 format)
 214              (ice-9 rdelim)
 215              (ice-9 optargs)
 216              (oop goops)
 217              (srfi srfi-1)
 218              (srfi srfi-13)
 219              (srfi srfi-14)
 220              (scm clip-region)
 221              (scm memory-trace)
 222              (scm coverage)
 223              (scm safe-utility-defs))
 224
 225 (define-public _ gettext)
 226 ;;; There are new modules defined in Guile V2.0 which we need to use.
 227 ;;
 228 ;;  Modules and scheme files loaded by lily.scm use currying
 229 ;;  in Guile V2 this needs a module which is not present in Guile V1.8
 230 ;;
 231
 232 (cond
 233   ((guile-v2)
 234    (ly:debug (_ "Using (ice-9 curried-definitions) module\n"))
 235    (use-modules (ice-9 curried-definitions)))
 236   (else
 237     (ly:debug (_ "Guile 1.8\n"))))
 238
 239 ;; TODO add in modules for V1.8.7 deprecated in V2.0 and integrated
 240 ;; into Guile base code, like (ice-9 syncase).
 241 ;;
 242
 243 (define-public fancy-format
 244   format)
 245
 246 (define-public (ergonomic-simple-format dest . rest)
 247   "Like ice-9's @code{format}, but without the memory consumption."
 248   (if (string? dest)
 249       (apply simple-format (cons #f (cons dest rest)))
 250       (apply simple-format (cons dest rest))))
 251
 252 (define format
 253   ergonomic-simple-format)
 254
 255 ;; my display
 256 (define-public (myd k v)
 257   (display k)
 258   (display ": ")
 259   (display v)
 260   (display ", ")
 261   v)
 262
 263 (define-public (print . args)
 264   (apply format (cons (current-output-port) args)))
 265
 266
 267 ;;; General settings.
 268 ;;;
 269 ;;; Debugging evaluator is slower.  This should have a more sensible
 270 ;;; default.
 271
 272
 273 (if (or (ly:get-option 'verbose)
 274         (ly:get-option 'trace-memory-frequency)
 275         (ly:get-option 'trace-scheme-coverage))
 276     (begin
 277       (ly:set-option 'protected-scheme-parsing #f)
 278       (debug-enable 'backtrace)
 279       (read-enable 'positions)))
 280
 281 (if (ly:get-option 'trace-scheme-coverage)
 282     (coverage:enable))
 283
 284 (define-public parser #f)
 285
 286 (define music-string-to-path-backends
 287   '(svg))
 288
 289 (if (memq (ly:get-option 'backend) music-string-to-path-backends)
 290     (ly:set-option 'music-strings-to-paths #t))
 291
 292 (define-public (ly:load x)
 293   (let* ((file-name (%search-load-path x)))
 294     (ly:debug "[~A" file-name)
 295     (if (not file-name)
 296         (ly:error (_ "cannot find: ~A") x))
 297     (primitive-load-path file-name)  ;; to support Guile V2 autocompile
 298     ;; TODO: Any chance to use ly:debug here? Need to extend it to prevent
 299     ;;       a newline in this case
 300     (if (ly:get-option 'verbose)
 301         (ly:progress "]\n"))))
 302
 303 (define-public DOS
 304   (let ((platform (string-tokenize
 305                    (vector-ref (uname) 0) char-set:letter+digit)))
 306     (if (null? (cdr platform)) #f
 307         (member (string-downcase (cadr platform)) '("95" "98" "me")))))
 308
 309 (define (slashify x)
 310   (if (string-index x #\\)
 311       x
 312       (string-regexp-substitute
 313         "//*" "/"
 314         (string-regexp-substitute "\\\\" "/" x))))
 315
 316 (define-public (ly-getcwd)
 317   (if (eq? PLATFORM 'windows)
 318       (slashify (getcwd))
 319       (getcwd)))
 320
 321 (define-public (is-absolute? file-name)
 322   (let ((file-name-length (string-length file-name)))
 323     (if (= file-name-length 0)
 324         #f
 325         (or (eq? (string-ref file-name 0) #\/)
 326             (and (eq? PLATFORM 'windows)
 327                  (> file-name-length 2)
 328                  (eq? (string-ref file-name 1) #\:)
 329                  (eq? (string-ref file-name 2) #\/))))))
 330
 331 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 332 ;;; If necessary, emulate Guile V2 module_export_all! for Guile V1.8.n
 333 (cond-expand
 334  ((not guile-v2)
 335   (define (module-export-all! mod)
 336     (define (fresh-interface!)
 337       (let ((iface (make-module)))
 338         (set-module-name! iface (module-name mod))
 339         ;; for guile 2: (set-module-version! iface (module-version mod))
 340         (set-module-kind! iface 'interface)
 341         (set-module-public-interface! mod iface)
 342         iface))
 343     (let ((iface (or (module-public-interface mod)
 344                      (fresh-interface!))))
 345       (set-module-obarray! iface (module-obarray mod))))))
 346
 347
 348 (define-safe-public (lilypond-version)
 349   (string-join
 350    (map (lambda (x) (if (symbol? x)
 351                         (symbol->string x)
 352                         (number->string x)))
 353         (ly:version))
 354    "."))
 355
 356 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 357 ;; init pitch system
 358
 359 (ly:set-default-scale (ly:make-scale #(0 1 2 5/2 7/2 9/2 11/2)))
 360
 361 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 362 ;; other files.
 363
 364 ;;
 365 ;;  List of Scheme files to be loaded into the (lily) module.
 366 ;;
 367 ;;  - Library definitions, need to be at the head of the list
 368 (define init-scheme-files-lib
 369   '("lily-library.scm"
 370     "output-lib.scm"))
 371 ;;  - Files containing definitions used later by other files later in load
 372 (define init-scheme-files-used
 373   '("markup-macros.scm"
 374     "parser-ly-from-scheme.scm"))
 375 ;;  - Main body of files to be loaded
 376 (define init-scheme-files-body
 377   '("file-cache.scm"
 378     "define-event-classes.scm"
 379     "define-music-callbacks.scm"
 380     "define-music-types.scm"
 381     "define-note-names.scm"
 382     "c++.scm"
 383     "chord-entry.scm"
 384     "stencil.scm"
 385     "define-markup-commands.scm"
 386     "markup.scm"
 387     "modal-transforms.scm"
 388     "chord-generic-names.scm"
 389     "chord-ignatzek-names.scm"
 390     "music-functions.scm"
 391     "part-combiner.scm"
 392     "autochange.scm"
 393     "define-music-properties.scm"
 394     "time-signature-settings.scm"
 395     "auto-beam.scm"
 396     "chord-name.scm"
 397     "bezier-tools.scm"
 398     "ly-syntax-constructors.scm"
 399
 400     "define-context-properties.scm"
 401     "translation-functions.scm"
 402     "script.scm"
 403     "midi.scm"
 404     "layout-beam.scm"
 405     "parser-clef.scm"
 406     "layout-slur.scm"
 407     "font.scm"
 408     "encoding.scm"
 409
 410     "bar-line.scm"
 411     "flag-styles.scm"
 412     "fret-diagrams.scm"
 413     "tablature.scm"
 414     "harp-pedals.scm"
 415     "define-woodwind-diagrams.scm"
 416     "display-woodwind-diagrams.scm"
 417     "predefined-fretboards.scm"
 418     "define-grob-properties.scm"
 419     "define-grobs.scm"
 420     "define-grob-interfaces.scm"
 421     "define-stencil-commands.scm"
 422     "titling.scm"
 423     "text.scm"
 424
 425     "paper.scm"
 426     "backend-library.scm"
 427     "x11-color.scm"))
 428 ;;  - Files to be loaded last
 429 (define init-scheme-files-tail
 430 ;;  - must be after everything has been defined
 431   '("safe-lily.scm"))
 432 ;;
 433 ;; Now construct the load list
 434 ;;
 435 (define init-scheme-files
 436   (append init-scheme-files-lib
 437           init-scheme-files-used
 438           init-scheme-files-body
 439           init-scheme-files-tail))
 440
 441 (for-each ly:load init-scheme-files)
 442
 443 (define-public r5rs-primary-predicates
 444   `((,boolean? . "boolean")
 445     (,char? . "character")
 446     (,number? . "number")
 447     (,pair? . "pair")
 448     (,port? . "port")
 449     (,procedure? . "procedure")
 450     (,string? . "string")
 451     (,symbol? . "symbol")
 452     (,vector? . "vector")))
 453
 454 (define-public r5rs-secondary-predicates
 455   `((,char-alphabetic? . "alphabetic character")
 456     (,char-lower-case? . "lower-case character")
 457     (,char-numeric? . "numeric character")
 458     (,char-upper-case? . "upper-case character")
 459     (,char-whitespace? . "whitespace character")
 460
 461     (,complex? . "complex number")
 462     (,even? . "even number")
 463     (,exact? . "exact number")
 464     (,inexact? . "inexact number")
 465     (,integer? . "integer")
 466     (,negative? . "negative number")
 467     (,odd? . "odd number")
 468     (,positive? . "positive number")
 469     (,rational? . "rational number")
 470     (,real? . "real number")
 471     (,zero? . "zero")
 472
 473     (,list? . "list")
 474     (,null? . "null")
 475
 476     (,input-port? . "input port")
 477     (,output-port? . "output port")
 478
 479     ;; would this ever be used?
 480     (,eof-object? . "end-of-file object")
 481     ))
 482
 483 (define-public guile-predicates
 484   `((,hash-table? . "hash table")
 485   ))
 486
 487 (define-public lilypond-scheme-predicates
 488   `((,boolean-or-symbol? . "boolean or symbol")
 489     (,color? . "color")
 490     (,cheap-list? . "list")
 491     (,fraction? . "fraction, as pair")
 492     (,grob-list? . "list of grobs")
 493     (,index? . "non-negative integer")
 494     ;; this is built on cheap-list
 495     (,list-or-symbol? . "list or symbol")
 496     (,markup? . "markup")
 497     (,markup-command-list? . "markup command list")
 498     (,markup-list? . "markup list")
 499     (,moment-pair? . "pair of moment objects")
 500     (,number-list? . "number list")
 501     (,number-or-grob? . "number or grob")
 502     (,number-or-pair? . "number or pair")
 503     (,number-or-string? . "number or string")
 504     (,number-pair? . "pair of numbers")
 505     (,rhythmic-location? . "rhythmic location")
 506     (,scheme? . "any type")
 507     (,string-or-pair? . "string or pair")
 508     (,string-or-symbol? . "string or symbol")
 509     (,void? . "void")
 510     ))
 511
 512 (define-public lilypond-exported-predicates
 513   `((,ly:book? . "book")
 514     (,ly:box? . "box")
 515     (,ly:context? . "context")
 516     (,ly:context-def? . "context definition")
 517     (,ly:context-mod? . "context modification")
 518     (,ly:dimension? . "dimension, in staff space")
 519     (,ly:dir? . "direction")
 520     (,ly:dispatcher? . "dispatcher")
 521     (,ly:duration? . "duration")
 522     (,ly:event? . "post event")
 523     (,ly:font-metric? . "font metric")
 524     (,ly:grob? . "graphical (layout) object")
 525     (,ly:grob-array? . "array of grobs")
 526     (,ly:input-location? . "input location")
 527     (,ly:item? . "item")
 528     (,ly:iterator? . "iterator")
 529     (,ly:lily-lexer? . "lily-lexer")
 530     (,ly:lily-parser? . "lily-parser")
 531     (,ly:listener? . "listener")
 532     (,ly:moment? . "moment")
 533     (,ly:music? . "music")
 534     (,ly:music-function? . "music function")
 535     (,ly:music-list? . "list of music objects")
 536     (,ly:music-output? . "music output")
 537     (,ly:otf-font? . "OpenType font")
 538     (,ly:output-def? . "output definition")
 539     (,ly:page-marker? . "page marker")
 540     (,ly:pango-font? . "pango font")
 541     (,ly:paper-book? . "paper book")
 542     (,ly:paper-system? . "paper-system Prob")
 543     (,ly:pitch? . "pitch")
 544     (,ly:prob? . "property object")
 545     (,ly:score? . "score")
 546     (,ly:simple-closure? . "simple closure")
 547     (,ly:skyline? . "skyline")
 548     (,ly:skyline-pair? . "pair of skylines")
 549     (,ly:source-file? . "source file")
 550     (,ly:spanner? . "spanner")
 551     (,ly:spring? . "spring")
 552     (,ly:stencil? . "stencil")
 553     (,ly:stream-event? . "stream event")
 554     (,ly:translator? . "translator")
 555     (,ly:translator-group? . "translator group")
 556     (,ly:unpure-pure-container? . "unpure/pure container")
 557     ))
 558
 559
 560 (set! type-p-name-alist
 561       (append r5rs-primary-predicates
 562               r5rs-secondary-predicates
 563               guile-predicates
 564               lilypond-scheme-predicates
 565               lilypond-exported-predicates))
 566
 567
 568 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 569 ;; timing
 570
 571 (define (profile-measurements)
 572   (let* ((t (times))
 573          (stats (gc-stats)))
 574     (list (- (+ (tms:cutime t)
 575                 (tms:utime t))
 576              (assoc-get 'gc-time-taken stats))
 577           (assoc-get 'total-cells-allocated  stats 0))))
 578
 579 (define (dump-profile base last this)
 580   (let* ((outname (format #f "~a.profile" (dir-basename base ".ly")))
 581          (diff (map (lambda (y) (apply - y)) (zip this last))))
 582     (ly:progress "\nWriting timing to ~a..." outname)
 583     (format (open-file outname "w")
 584             "time: ~a\ncells: ~a\n"
 585             (if (ly:get-option 'dump-cpu-profile)
 586                 (car diff)
 587                 0)
 588             (cadr diff))))
 589
 590 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 591 ;; debug memory leaks
 592
 593 (define gc-dumping
 594   #f)
 595
 596 (define gc-protect-stat-count
 597   0)
 598
 599 ;; Undead objects that should be ignored after the first time round
 600 (define gc-zombies
 601   (make-weak-key-hash-table 0))
 602
 603 (define-public (dump-live-object-stats outfile)
 604   (for-each (lambda (x)
 605               (format outfile "~a: ~a\n" (car x) (cdr x)))
 606             (sort (gc-live-object-stats)
 607                   (lambda (x y)
 608                     (string<? (car x) (car y))))))
 609
 610 (define-public (dump-gc-protects)
 611   (set! gc-protect-stat-count (1+ gc-protect-stat-count))
 612   (let* ((protects (sort (hash-table->alist (ly:protects))
 613                          (lambda (a b)
 614                            (< (object-address (car a))
 615                               (object-address (car b))))))
 616         (out-file-name (string-append
 617                        "gcstat-" (number->string gc-protect-stat-count)
 618                        ".scm"))
 619         (outfile (open-file out-file-name "w")))
 620     (set! gc-dumping #t)
 621     (ly:progress "Dumping GC statistics ~a...\n" out-file-name)
 622     (for-each (lambda (y)
 623                 (let ((x (car y))
 624                       (c (cdr y)))
 625                   (format outfile "~a (~a) = ~a\n" (object-address x) c x)))
 626               (filter
 627                (lambda (x)
 628                  (not (symbol? (car x))))
 629                protects))
 630     (format outfile "\nprotected symbols: ~a\n"
 631             (apply + (map (lambda (obj-count)
 632                             (if (symbol? (car obj-count))
 633                                 (cdr obj-count)
 634                                 0))
 635                           protects)))
 636
 637     ;; (display (ly:smob-protects))
 638     (newline outfile)
 639     (if (defined? 'gc-live-object-stats)
 640         (let* ((stats #f))
 641           (ly:progress "Live object statistics: GC'ing\n")
 642           (ly:reset-all-fonts)
 643           (gc)
 644           (gc)
 645           (ly:progress "Asserting dead objects\n")
 646           (ly:set-option 'debug-gc-assert-parsed-dead #t)
 647           (gc)
 648           (ly:set-option 'debug-gc-assert-parsed-dead #f)
 649           (for-each
 650            (lambda (x)
 651              (if (not (hashq-ref gc-zombies x))
 652                  (begin
 653                    (ly:programming-error "Parsed object should be dead: ~a" x)
 654                    (hashq-set! gc-zombies x #t))))
 655            (ly:parsed-undead-list!))
 656           (set! stats (gc-live-object-stats))
 657           (ly:progress "Dumping live object statistics.\n")
 658           (dump-live-object-stats outfile)))
 659     (newline outfile)
 660     (let* ((stats (gc-stats)))
 661       (for-each (lambda (sym)
 662                   (format outfile "~a ~a ~a\n"
 663                           gc-protect-stat-count
 664                           sym
 665                           (assoc-get sym stats "?")))
 666                 '(protected-objects bytes-malloced cell-heap-size)))
 667     (set! gc-dumping #f)
 668     (close-port outfile)))
 669
 670 (define (check-memory)
 671   "Read `/proc/self' to check up on memory use."
 672   (define (gulp-file name)
 673     (let* ((file (open-input-file name))
 674            (text (read-delimited "" file)))
 675       (close file)
 676       text))
 677
 678   (let* ((stat (gulp-file "/proc/self/status"))
 679          (lines (string-split stat #\newline))
 680          (interesting (filter identity
 681                               (map
 682                                (lambda (l)
 683                                  (string-match "^VmData:[ \t]*([0-9]*) kB" l))
 684                                lines)))
 685          (mem (string->number (match:substring (car interesting) 1))))
 686     (format #t "VMDATA: ~a\n" mem)
 687     (display (gc-stats))
 688     (newline)
 689     (if (> mem 500000)
 690         (begin (dump-gc-protects)
 691                (raise 1)))))
 692
 693 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 694
 695 (define (multi-fork count)
 696   "Split this process into COUNT helpers.  Returns either a list of
 697 PIDs or the number of the process."
 698   (define (helper count acc)
 699     (if (> count 0)
 700         (let* ((pid (primitive-fork)))
 701               (if (= pid 0)
 702                   (1- count)
 703                   (helper (1- count) (cons pid acc))))
 704         acc))
 705
 706   (helper count '()))
 707
 708 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 709
 710 (define* (ly:exit status #:optional (silently #f))
 711   "Exit function for lilypond"
 712   (if (not silently)
 713       (case status
 714         ((0) (ly:basic-progress (_ "Success: compilation successfully completed")))
 715         ((1) (ly:warning (_ "Compilation completed with warnings or errors")))
 716         (else (ly:message ""))))
 717   (exit status))
 718
 719 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 720
 721 (define-public (lilypond-main files)
 722   "Entry point for LilyPond."
 723   (eval-string (ly:command-line-code))
 724   (if (ly:get-option 'help)
 725       (begin (ly:option-usage)
 726              (ly:exit 0 #t)))
 727   (if (ly:get-option 'show-available-fonts)
 728       (begin (ly:font-config-display-fonts)
 729              (ly:exit 0 #t)))
 730   (if (ly:get-option 'gui)
 731       (gui-main files))
 732   (if (null? files)
 733       (begin (ly:usage)
 734              (ly:exit 2 #t)))
 735   (if (ly:get-option 'read-file-list)
 736       (set! files
 737             (filter (lambda (s)
 738                       (> (string-length s) 0))
 739                     (apply append
 740                            (map (lambda (f)
 741                                   (string-split (ly:gulp-file f) #\nl))
 742                                 files)))))
 743   (if (and (number? (ly:get-option 'job-count))
 744            (>= (length files) (ly:get-option 'job-count)))
 745       (let* ((count (ly:get-option 'job-count))
 746              (split-todo (split-list files count))
 747              (joblist (multi-fork count))
 748              (errors '()))
 749         (if (not (string-or-symbol? (ly:get-option 'log-file)))
 750             (ly:set-option 'log-file "lilypond-multi-run"))
 751         (if (number? joblist)
 752             (begin (ly:set-option
 753                     'log-file (format #f "~a-~a"
 754                                       (ly:get-option 'log-file) joblist))
 755                     (set! files (vector-ref split-todo joblist)))
 756             (begin (ly:progress "\nForking into jobs:  ~a\n" joblist)
 757                    (for-each
 758                     (lambda (pid)
 759                       (let* ((stat (cdr (waitpid pid))))
 760                         (if (not (= stat 0))
 761                             (set! errors
 762                                   (acons (list-element-index joblist pid)
 763                                  stat errors)))))
 764                     joblist)
 765                    (for-each
 766                     (lambda (x)
 767                       (let* ((job (car x))
 768                              (state (cdr x))
 769                              (logfile (format #f "~a-~a.log"
 770                                               (ly:get-option 'log-file) job))
 771                              (log (ly:gulp-file logfile))
 772                              (len (string-length log))
 773                              (tail (substring  log (max 0 (- len 1024)))))
 774                         (if (status:term-sig state)
 775                             (ly:message
 776                              "\n\n~a\n"
 777                              (format #f (_ "job ~a terminated with signal: ~a")
 778                                      job (status:term-sig state)))
 779                             (ly:message
 780                              (_ "logfile ~a (exit ~a):\n~a")
 781                              logfile (status:exit-val state) tail))))
 782                       errors)
 783                      (if (pair? errors)
 784                          (ly:error "Children ~a exited with errors."
 785                                    (map car errors)))
 786                      ;; must overwrite individual entries
 787                      (if (ly:get-option 'dump-profile)
 788                          (dump-profile "lily-run-total"
 789                                        '(0 0) (profile-measurements)))
 790                      (if (null? errors)
 791                          (ly:exit 0 #f)
 792                          (ly:exit 1 #f))))))
 793
 794   (if (string-or-symbol? (ly:get-option 'log-file))
 795       (ly:stderr-redirect (format #f "~a.log" (ly:get-option 'log-file)) "w"))
 796   (let ((failed (lilypond-all files)))
 797     (if (ly:get-option 'trace-scheme-coverage)
 798         (begin
 799           (coverage:show-all (lambda (f)
 800                                (string-contains f "lilypond")))))
 801     (if (pair? failed)
 802         (begin (ly:error (_ "failed files: ~S") (string-join failed))
 803                (ly:exit 1 #f))
 804         (begin
 805           (ly:exit 0 #f)))))
 806
 807
 808 (define-public (lilypond-all files)
 809   (let* ((failed '())
 810          (separate-logs (ly:get-option 'separate-log-files))
 811          (ping-log
 812           (if separate-logs
 813               (open-file (if (string-or-symbol? (ly:get-option 'log-file))
 814                              (format #f "~a.log" (ly:get-option 'log-file))
 815                      "/dev/stderr") "a") #f))
 816          (do-measurements (ly:get-option 'dump-profile))
 817          (handler (lambda (key failed-file)
 818                     (set! failed (append (list failed-file) failed)))))
 819     (gc)
 820     (for-each
 821      (lambda (x)
 822        (let* ((start-measurements (if do-measurements
 823                                       (profile-measurements)
 824                                       #f))
 825               (base (dir-basename x ".ly"))
 826               (all-settings (ly:all-options)))
 827          (if separate-logs
 828              (ly:stderr-redirect (format #f "~a.log" base) "w"))
 829          (if ping-log
 830              (format ping-log "Processing ~a\n" base))
 831          (if (ly:get-option 'trace-memory-frequency)
 832              (mtrace:start-trace  (ly:get-option 'trace-memory-frequency)))
 833          (lilypond-file handler x)
 834          (ly:check-expected-warnings)
 835          (if start-measurements
 836              (dump-profile x start-measurements (profile-measurements)))
 837          (if (ly:get-option 'trace-memory-frequency)
 838              (begin (mtrace:stop-trace)
 839                     (mtrace:dump-results base)))
 840          (for-each (lambda (s)
 841                      (ly:set-option (car s) (cdr s)))
 842                    all-settings)
 843          (ly:set-option 'debug-gc-assert-parsed-dead #t)
 844          (gc)
 845          (ly:set-option 'debug-gc-assert-parsed-dead #f)
 846          (for-each
 847           (lambda (x)
 848             (ly:programming-error "Parsed object should be dead: ~a" x))
 849           (ly:parsed-undead-list!))
 850          (if (ly:get-option 'debug-gc)
 851              (dump-gc-protects)
 852              (ly:reset-all-fonts))
 853          (flush-all-ports)))
 854      files)
 855
 856     ;; Ensure a notice re failed files is written to aggregate logfile.
 857     (if ping-log
 858         (format ping-log "Failed files: ~a\n" failed))
 859     (if (ly:get-option 'dump-profile)
 860         (dump-profile "lily-run-total" '(0 0) (profile-measurements)))
 861     failed))
 862
 863 (define-public lilypond-declarations '())
 864
 865 (define (lilypond-file handler file-name)
 866   (catch 'ly-file-failed
 867          (lambda () (ly:parse-file file-name))
 868          (lambda (x . args) (handler x file-name))))
 869
 870 (use-modules (scm editor))
 871
 872 (define-public (gui-main files)
 873   (if (null? files)
 874       (gui-no-files-handler))
 875   (if (not (string? (ly:get-option 'log-file)))
 876       (let* ((base (dir-basename (car files) ".ly"))
 877              (log-name (string-append base ".log")))
 878         (if (not (ly:get-option 'gui))
 879             (ly:message (_ "Redirecting output to ~a...") log-name))
 880         (ly:stderr-redirect log-name "w")
 881         (ly:message "# -*-compilation-*-"))
 882       (let ((failed (lilypond-all files)))
 883         (if (pair? failed)
 884             (begin
 885               ;; ugh
 886               (ly:stderr-redirect "foo" "r")
 887               (system (get-editor-command log-name 0 0 0))
 888               (ly:error (_ "failed files: ~S") (string-join failed))
 889               ;; not reached?
 890               (exit 1))
 891             (ly:exit 0 #f)))))
 892
 893 (define (gui-no-files-handler)
 894   (let* ((ly (string-append (ly:effective-prefix) "/ly/"))
 895          ;; FIXME: soft-code, localize
 896          (welcome-ly (string-append ly "Welcome_to_LilyPond.ly"))
 897          (cmd (get-editor-command welcome-ly 0 0 0)))
 898     (ly:message (_ "Invoking `~a'...\n") cmd)
 899     (system cmd)
 900     (ly:exit 1 #f)))