1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
4 Translation of GIT committish: d415427752fa5fd83b0da189d677481d1c7f3043
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @c Translators: Reinhold Kainhofer, Till Rettig
14 @node Running LilyPond
15 @chapter Running LilyPond
17 Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
22 * Command-line usage::
24 * Updating files with convert-ly::
31 Die meisten Benutzer führen LilyPond von einer graphischen Benutzeroberfläche
32 aus. Siehe @rlearning{First steps}, falls Sie dies nicht bereits getan haben.
35 @node Command-line usage
36 @section Command-line usage
38 Dieser Abschnitt enthält zusätzliche Informationen, wie Sie LilyPond
39 von der Kommandozeile ausführen können. Dies kann erforderlich sein,
40 um etwa zusätzliche Optionen an das Programm zu übergeben. Außerdem
41 sind einige Zusatzprogramme (wie etwa @code{midi2ly}) nur von der
42 Kommandozeile verfügbar.
44 Unter @q{Kommandozeile} verstehen wir die Kommandozeile des jeweiligen
45 Betriebssystems. Windows Benutzern ist sie vielleicht eher unter den
46 englischen Begriffen @q{DOS shell} oder @q{command shell} bekannt.
47 MacOS@tie{}X Benutzer kennen sie eher unter @q{Terminal} oder @q{Konsole}.
48 Sie sollten auch den Abschnitt @ref{Setup for MacOS X} konsultieren.
50 Wie die Kommandozeile im jeweiligen Betriebssystem benutzt werden kann,
51 soll in diesem Handbuch nicht näher beschrieben werden. Sehen Sie bitte
52 im Handbuch Ihres Betriebssystems nach oder informieren Sie sich im
53 Internet, wenn Sie mit der Kommandozeile nicht vertraut sind.
58 * Command line options for lilypond::
59 * Environment variables::
62 @node Invoking lilypond
63 @subsection Invoking @command{lilypond}
65 @cindex @command{lilypond} aufrufen
66 @cindex Kommandozeilen-Optionen für @command{lilypond}
67 @cindex Optionen an der Kommandozeile
69 Das @command{lilypond} Programm kann folgendermaßen von der Kommandozeile
73 lilypond [@var{Option}]@dots{} @var{Dateiname}@dots{}
77 Wird ein @file{Dateiname} ohne Erweiterung angegeben, so wird @file{.ly} als
78 Standarderweiterung für LilyPond-Dateien benutzt. Um Daten von
79 @code{stdin} einzulesen, benutzen Sie einfach einen Bindestrich (@code{-})
82 Wenn Lilypond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
83 die Dateien @file{Dateiname.ps} und @file{Dateiname.pdf} erzeugt.
84 Es können an @code{lilypond} auch mehrere @file{.ly} Dateien übergeben
85 werden, die dann einzeln und voneinander unabhängig abgearbeitet
86 werden.@footnote{Der Zustand von GUILE wird allerdings nicht nach
87 jeder Datei zurückgesetzt, sodass Achtung geboten ist, wenn in einer
88 Datei globale Änderungen von Scheme aus durchgeführt werden.}
90 Falls @file{Dateiname.ly} mehr als einen @code{\score}-Block enthält,
91 werden die weiteren Stücke in durchnummerierte Dateien der Form
92 @file{Dateiname-1.pdf} ausgegeben. Zusätzlich wird der Wert der
93 Variable @code{output-suffix} zwischen den ursprünglichen Dateienamen
94 und der Zahl eingefügt. Eine Lilypond-Datei @var{Dateiname.ly} mit dem Inhalt
97 #(define output-suffix "Geige")
99 #(define output-suffix "Cello")
104 erzeugt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
105 @var{Dateiname}@file{-Cello-1.pdf}.
109 @node Command line options for lilypond
110 @subsection Command line options for @command{lilypond}
112 Die folgenden Kommandozeilenoptionen werden von @command{lilypond} unterstützt:
116 @item -e,--evaluate=@var{expr}
117 Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
118 gelesen und interpretiert werden.
119 Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
120 werden nacheinander ausgewertet.
122 Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
123 Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
124 Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
127 lilypond -e '(define-public a 42)'
131 Am Beginn der @file{.ly}-Datei muss dann das @code{guile-user} Modul noch geladen werden, bevor die Definition von @var{a} verfügbar ist:
134 #(use-modules (guile-user))
138 @item -f,--format=@var{Format}
139 Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
140 @code{svg}, @code{ps}, @code{pdf} und @code{png}.
142 Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
146 @item -d,--define-default=@var{Variable}=@var{Wert}
147 Damit wird die interne Programmoption @var{Variable} auf den Scheme-Wert
148 @var{Wert} gesetzt. Wird kein @var{Wert} angegeben, so wird @var{#t} benutzt.
149 Um eine Option auszuschalten, kann der Präfix @code{no-} dem Namen
150 @var{Variable} der Variable vorangestellt werden. So ist etwa
152 @cindex Point and Click, Kommandozeile
161 -dpoint-and-click='#f'
164 Hier sind ein paar interessante Optionen:
168 Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren @code{-d}
172 Setzt das Standard-Papierformat,
174 -dpaper-size=\"letter\"
178 Die Zeichenkette, die das Format angibt, muss in Anführungszeichen mit Backslash
179 ( @code{\"} ) stehen.
183 Vertraut der @code{.ly} Datei nicht.
185 Wenn LilyPond über einen Webserver verfügbar gemacht wird, @b{MUSS} unbedingt
186 eine die Optionen @code{--safe} oder @code{--jail} angegeben werden.
187 Die @code{--safe} Option verhindert, dass in der .ly-Datei angegebener
188 Scheme-Code das System gefährden kann, wie etwa in folgendem Beispiel:
194 c4^#(ly:export (ly:gulp-file "/etc/passwd"))
199 Mit der @code{-dsafe} Option werden alle Scheme-Ausdrücke einem speziellen
200 sicheren Modus ausgewertet. Dieser Modus ist vom GUILE @file{safe-r5rs} Modul
201 abgeleitet und fügt noch zahlreiche weitere erlaubte Funktionen der
202 LilyPond Programm-Schnittstelle hinzu. Diese Funktionen sind in
203 @file{scm/@/safe@/-lily@/.scm} angegeben.
205 Zusätzliche verbietet der sichere Modus auch @code{\include} Befehle.
207 Im sicheren Modus ist es nicht möglich, LilyPond-Variablen nach Scheme
210 @code{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
211 Ressourcen. In diesem Modus ist es also trotzdem möglich, dass LilyPond in einer
212 Endlosschleife hängt, z.B. wenn zyklische Datenstrukturen an das Backend
213 übergeben werden. Wenn LilyPond also auf einem öffentlich zugänglichen
214 Webserver verfügbar gemacht wird, sollte der Prozess sowohl in der CPU-
215 als auch in der Speichernutzung limitiert werden.
217 Der sichere Modus verhindert auch, dass zahlreiche nützliche
218 Musikfragmente von LilyPond verarbeitet werden. Die @code{--jail} Option ist
219 eine sicherere Alternative, benötigt allerdings auch mehr Aufwand zur
223 Gibt an, welches Ausgabeformat das LilyPond Backend benutzt. Mögliche Werte
224 für diese Option sind:
228 PostScript-Ausgabeformat.
230 @cindex PostScript Ausgabeformat
232 Postscript-Dateien enthalten auch TTF-, Type1- und OTF-Schriften. Allerdings
233 wird die gesamte Schriftart eingefügt und nicht nur die benötigten Zeichen.
234 Vor allem wenn nicht-westliche Zeichensätze benutzt werden, kann dies zu sehr
235 großen Dateien führen.
238 Erzeugt @q{encapsulated PostScript} (EPS). Jede Seite (oder jedes System) wird
239 als eigene @file{EPS}-Datei ausgegeben, inklusive Schriftarten. Außerdem wird
240 eine Datei mit allen Seiten (bzw. Systemen) und Schriftarten erzeugt.
242 Dies ist die Standardeinstellung von @command{lilypond-book}.
245 SVG-Ausgabe (Scalable Vector Graphics). Jede Seite wird als eigene
246 @file{SVG}-Datei ausgegeben, inklusive eingebetteten Schriftarten.
247 @cindex SVG (Scalable Vector Graphics)
248 Sie benötigen einen SVG-Betrachter, der eingebettete Schriftarten unterstützt,
249 oder einen SVG-Betrachter, der eingebettete Schriftarten durch OTF-Schriften
250 ersetzen kann. In UNIX und Linux kann z.B. @uref{http://www.inkscape.org,Inkscape}
251 (ab Version 0.42) benutzt werden, nachdem die OTF-Schriften aus dem
252 LilyPond-Verzeichnis (typischerweise @file{/usr/share/lilypond/VERSION/fonts/otf/})
253 in das Verzeichnis @file{~/.fonts/} kopiert wurden.
256 gibt die rohen Scheme-basierenden Zeichenbefehle aus, wie sie intern von
257 LilyPond benutzt werden.
262 Keine Partitur wird ausgegeben, hat gleichen Effekt wie @code{-dno-print-pages}.
266 Beispiel: @code{lilypond -dbackend=svg @var{Dateiname}.ly}
268 @cindex Ausgabeformat
271 Erzeugt eine Ausgabedatei, die nur die Titelzeilen und das erste System
275 Erzeugt vollständige Seiten (Standardeinstellung). @code{-dno-print-pages}
276 ist in Verbindung mit @code{-dpreview} nützlich.
283 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
285 @item -H,--header=@var{FELD}
286 Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
287 @file{Dateiname.@var{FELD}} aus.
289 @item --include, -I=@var{Verzeichnis}
290 Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
294 @item -i,--init=@var{Initialisierungsdatei}
295 Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
296 Standardwert ist @file{init.ly}.
298 @item -o,--output=@var{DATEI}
299 Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
300 @var{DATEI}. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
301 @code{.pdf} für pdf).
307 Erzeugt eine Grafik-Datei im PNG-Format von jeder Seite. Diese Option
308 impliziert auch @code{--ps}. Die Auflösung in DPI der Grafik kann festgelegt
315 Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
317 @item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
318 Führt @command{lilypond} in einem chroot-Jail aus.
320 Die @code{--jail} Option ist eine flexiblere Alternative zu @code{--safe}, wenn
321 LilyPond über das Internet verfügbar gemacht wird oder LilyPond-Quelldateien
322 von Dritten automatisch vararbeitet werden.
324 Sie funktioniert dergestalt, dass das Wurzelverzeichnis von
325 @command{lilypond} auf @var{Jail-Verzeichnis} gesetzt wird, bevor die
326 tatsächliche Kompilierung der .ly-Datei beginnt. Der Benutzer und die Gruppe
327 werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
328 wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
329 Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
330 möglich ist, aus dem Jail auszubrechen. Damit @code{--jail} funktioniert, muss
331 @command{lilypond} allerdings als root ausgeführt werden, was normalerweise
332 auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
334 Das Jail-Verzeichnis zu erstellen ist etwas heikel, da LilyPond alle zur
335 Ausführung nötigen Bibliotheken und Dateien @emph{innerhalb des
336 Jail-Verzeichnisses} finden muss. Ein typisches Setup besteht aus folgenden
340 @item Erstellung eines getrennten Dateisystems
341 Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
342 sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
343 eingebunden werden kann. Damit ist es unmöglich, Programme von diesem
344 Dateisystem auszuführen oder direkt auf eine Hardware-Schnittstelle
345 zuzugreifen. Wenn Sie keine eigene Partition erstellen möchten, können Sie
346 auch eine Datei der entsprechenden Größe erstellen und sie als @q{loop}-Gerät
347 einbinden. Ein getrenntes Dateisystem garantiert auch, dass LilyPond nicht
348 mehr Festplattenspeicher benutzt als erlaubt.
350 @item Erstellung eines eigenen Benutzerkontos
351 Es sollte ein eigener Benutzer und eine eigene Gruppe (z. B.
352 @code{lily}/@code{lily}) mit geringen Rechten für die Ausführung von LilyPond
353 innerhalb des Jails benutzt werden. Nur ein einziges Verzeichnis des Jails sollte
354 für den Benutzer schreibbar sein und als @var{Arbeitsverzeichnis} an
355 @code{lilypond} übergeben werden.
357 @item Einrichtung des Jails
358 LilyPond muss zahlreiche Dateien für die Ausführung einlesen. All diese
359 Dateien müssen in das Jail-Verzeichnis kopiert werden (mit denselben Pfaden
360 wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
361 (typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
363 Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
364 @command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
365 welche Dateien im Jail noch fehlen.
367 @item Ausführung von LilyPond
368 In einem mit @code{noexec} eingebundenen Jail ist es nicht möglich, externe
369 Programme auszuführen. Daher muss LilyPond auf eine Art gestartet werden,
370 die keine weitere Ausführung von Programmen benötigt. Wie bereits erwähnt
371 muss LilyPond mit Administrator-Rechten gestartet werden (die es allerdings
372 sofort wieder abgibt), beispielsweise mittels @command{sudo}. Außerdem
373 ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
374 limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
375 dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher.
380 Gibt die Versionsnummer aus.
383 Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
384 aller gelesenen Dateien sowie Informationen über die Laufzeit.
387 Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
388 @strong{KEINERLEI GARANTIE}!)
392 @node Environment variables
393 @subsection Environment variables
396 @cindex LILYPOND_DATADIR
398 @command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
400 @item LILYPOND_DATADIR
401 Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
402 Meldungen und Übersetzungen finden kann. Dieses Verzeichnis sollte
403 Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
406 Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
408 @item LILYPOND_GC_YIELD
409 Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
410 zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
411 von LilyPond durchgeführt werden. Bei höheren Werten benutzt LilyPond
412 mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung. Bei
413 niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
414 benötigt. Voreinstellung ist ein Wert von @code{70}.
420 @section Error messages
422 @cindex error messages
423 Während der Verarbeitung einer Dateien können diverse Meldungen an der
424 Kommandozeile auftreten:
430 Irgendetwas ist verdächtig. Wenn Sie etwas Ungewöhnliches in Ihrer
431 Datei durchführen, dann werden Sie die Meldung verstehen und können
432 sie gegebenenfalls ignorieren. Im Normalfall jedoch bedeutet eine
433 Warnung, dass mit Ihrer Datei etwas nicht stimmt, LilyPond jedoch
434 trotzdem versucht, die Datei soweit wie möglich korrekt zu übersetzen.
438 Irgendetwas stimmt definitiv nicht. Der aktuelle Bearbeitungsschritt
439 (Einlesen, Interpretieren oder Formatieren der Datei) wird noch fertig
440 ausgeführt, danach bricht die Bearbeitung aber ab.
443 @cindex Fataler Fehler
444 Irgendetwas stimmt definitiv nicht und LilyPond kann nicht weiter
445 ausgeführt werden. Dies ist nur sehr selten der Fall, meist sind
446 die Schriftarten nicht korrekt installiert.
449 @cindex Fehlerprotokoll, Scheme
450 @cindex Scheme Fehler
451 Fehler, die während der Ausführung von Scheme-Code auftreten, werden
452 vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
453 Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
454 ausführen, wird der sogennante @q{Call trace} ausgegeben, der die
455 aufgerufenen Funktionen zur Zeit des Fehlers angibt.
457 @item Programmierfehler
458 @cindex Programmierfehler
459 Eine interne Inkonsistenz ist aufgetreten. Diese Fehlermeldungen
460 sollen den Programmierern die Fehlersuche erleichtern und
461 können meistens einfach ignoriert werden. In manchen Fällen werden
462 so viele Meldungen ausgegeben, dass die Lesbarkeit der restliche
463 Ausgabe davon beeinträchtigt wird.
465 @item Abgebrochen (core dumped)
466 Dies bezeichnet einen ernsten Programmierfehler, der das Programm
467 zum Absturz gebracht hat. Solche Fehler werden als kritisch angesehen.
468 Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
471 @cindex Fehlermeldung, Format
472 @cindex Form der Fehlermeldungen
473 Wenn Warnungen oder Fehlermeldungen mit einer konkreten Stelle in der
474 Eingabedatei verknüpft werden können, dann hat die Meldung die folgende
478 @var{Dateiname}:@var{Zeile}:@var{Spalte}: @var{Meldung}
479 @var{Fehlerhafte Eingabezeile}
482 Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
483 wo der Fehler aufgetreten ist. Zum Beispiel
486 test.ly:2:19: Fehler: keine gültige Dauer: 5
491 Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
492 aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
493 unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
494 Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
495 sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
496 der angegebenen Zeile keinen Fehler erkennen, sollten Sie auch die Zeilen
497 oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
500 @node Updating files with convert-ly
501 @section Updating files with @command{convert-ly}
503 @cindex Aktualisierung von LilyPond-Dateien
504 @cindex Aktualisierung mit convert-ly
505 @cindex convert-ly: Aktualisierung
507 Die Eingabesyntax von LilyPond ändert sich graduell um etwa die
508 Eingabe zu erleichtern oder neue Funktionen zu ermöglichen. Ein
509 Nebeneffekt hiervon ist, dass das LilyPond-Übersetzerprogramm nicht
510 mehr mit älteren Eingabedateien kompatibel sein kann. Um dies
511 zu umgehen, kann @command{convert-ly} benutzt werden, welches die
512 meisten der Syntaxänderungen korrigieren kann.
514 Das Programm benötigt eine @code{\version}-Information in der
515 Eingabedatei, um zu wissen, von welcher Version konvertiert werden
516 soll. In den meisten Fällen genügt es, den Befehl
519 convert-ly -e meineDatei.ly
524 @c MacOS@tie{}X-Benutzer können diesen Befehl im Menu unter
525 @c @code{Compile > Update syntax} finden.
528 Wenn keine Veränderungen in @code{meineDatei.ly} vorgenommen wurden
529 und eine Datei @code{meineDatei.ly.NEW} erstellt wird, it
530 @code{meineDatei.ly} schon aktuell.
534 * Command line options for convert-ly::
535 * Problems with convert-ly::
538 @node Command line options for convert-ly
539 @subsection Command line options for @command{convert-ly}
541 @command{convert-ly} konvertiert immer bis zur letzten Syntaxänderung,
542 die es beherrscht. Das heißt, dass die neue @code{version}-Nummer
543 in der Datei überlicherweise etwas niedriger ist als die
544 Version von @command{convert-ly}.
546 Um LilyPond-Fragmente in texinfo-Dateien zu aktualisieren, gilt
550 convert-ly --from=... --to=... --no-version *.itely
553 Um die Änderungen der LilyPond-Syntax zwischen bestimmten Versionen
554 zu sehen, kann der Befehl
557 convert-ly --from=... --to=... -s
563 Viele Dateien können auf einmal aktualisiert werden, indem
564 @code{convert-ly} mit den üblichen UNIX-Befehlen kombiniert
565 wird. Das folgende Beispiel aktualisiert alle @code{.ly}-Dateien
566 im aktuellen Verzeichnis:
569 for f in *.ly; do convert-ly -e $f; done;
572 Die allgemeine Syntax des Programms lautet:
575 convert-ly [@var{option}]@dots{} @var{file}@dots{}
578 Folgende Optionen sind möglich:
582 Verändere die entsprechende Zeile der Eingabedatei. Überschreibt
585 @item -f,--from=@var{von-Versionsnummer}
586 Setze die Version, ab welcher konvertiert werden soll. Wenn diese
587 Option nicht gesetzt ist, versucht @command{convert-ly}, die
588 Version auf Grundlage von @code{\version} zu raten.
590 @item -n,--no-version
591 Normalerweise fügt @command{convert-ly} eine @code{\version}-Zeile
592 zur Ausgabe hinzu. Mit dieser Option kann das unterdrückt werden.
594 @item -s, --show-rules
595 Zeige alle bekannten Konversionsregeln und beende.
597 @item --to=@var{bis-Versionsnummer}
598 Hiermit kann das Ziel der Konversion gesetzt werden. Standard ist
599 die neueste mögliche Version.
602 Benutzerhilfe ausgeben.
606 @node Problems with convert-ly
607 @subsection Problems with @code{convert-ly}
609 Nicht alle Änderungen der Syntax können konvertiert werden. Nur
610 eine Ausgabeoption kann angegeben werden. Scheme- und
611 LilyPond-Scheme-Code wird sehr unwahrscheinlich korrekt aktualisiert,
612 hier ist meistens Nacharbeit erforderlich.
615 Hier eine Liste einiger Befehle, die convert-ly nicht konvertieren kann.
617 Diese Liste ist in Form von Fehlermeldungen, denn convert-ly
618 ist so strukturiert, dass nicht alle benötigten Änderungen
619 implementiert werden können. Es handelt sich also eher um eine
620 Wunschliste zur Referenz.
623 Bezifferter Bass wird nicht immer korrekt konvertiert, besonders
624 Befehle wie {< >}. Mats Kommentar hierzu:
625 Um convert-ly korrekt ausführen zu können, müssen alle Vorkommen
626 von '{<' in etwas beliebiges wie '{#' und genauso '>}' in '&}'
627 geändert werden. Nach der Konversion können sie dann zurück
628 in '{ <' und '> }' verwandelt werden
629 Nicht alle Textbeschriftungen werden richtig konvertiert. In der
630 alten Syntax konnten Beschriftungsbefehle mit Klammern gruppiert
632 -#'((bold italic) "string")
633 This will incorrectly be converted into
634 -\markup{{\bold italic} "string"}
635 instead of the correct
636 -\markup{\bold \italic "string"}
638 \partcombine wird nicht konvertiert
639 \addlyrics => \lyricsto wird nicht konvertiert, dadurch kompilieren
640 manche Dateien mit mehreren Strophen nicht.
642 \magnify wird nicht nach \fontsize konvertiert.
643 - \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
644 remove-tag wird nicht verändert.
645 - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
646 first-page-number wird nicht geändert.
647 - first-page-number no => print-first-page-number = ##f
648 Zeilenumbrüche im \header-Feld werde nicht konvertiert.
649 - \\\\ als Zeilenumbruch in \header{...} => \markup \center-align <
650 "First Line" "Second Line" >
651 Crescendo- und Decrescendo-Enden werden nicht konvertiert.
655 \turnOff (in \set Staff.VoltaBracket = \turnOff eingesetzt) wird nicht korrekt behandelt.
657 \markup{ \center-align <{ ... }> } sollte umgewandelt werden in:
658 \markup{ \center-align {\line { ... }} }
659 aber im Moment fehlt \line.
661 Besondere LaTeX-Zeichen wie $~$ im Text werden nicht nach UTF(
664 \score{} muss jetzt mit einem musikalischen Ausdruck beginnen.
665 Alles andere (insbesondere \header{}) darf erst nach den Noten
672 @section Reporting bugs
676 @cindex Fehler melden
678 Wenn Sie eine Datei haben, die zu einem Absturz von LilyPond oder zu einer
679 fehlerhaften Ausgabe führt, so ist dies ein @q{Bug}. Die List der aktuell
680 bekannten derartigen Fehler findet sich in unserem @q{Google Bug Tracker}:
682 @uref{http://code.google.com/p/lilypond/issues/list}
684 Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
685 Sie dies bitte anhand der Anweisungen auf der Seite
687 @uref{http://lilypond.org/web/devel/participating/bugs}
689 Wenn Sie Beispieldateien für den Fehler erstellen, versuchen Sie bitte, die
690 Datei möglichst minimal zu halten und nur jenen LilyPond Code aufzunehmen,
691 der auch wirklich für den Fehler verantwortlich ist. Meldungen mit
692 Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
693 nicht effektiv bearbeiten.