Documentation/de/user/running.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: 2c00bdbfaf62dd90863331c4713e6b29e32c9322
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.11.61"
  11
  12 @c Translators: Reinhold Kainhofer, Till Rettig
  13
  14 @node Running LilyPond
  15 @chapter Running LilyPond
  16
  17 Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
  18
  19
  20 @menu
  21 * Normal usage::
  22 * Command-line usage::
  23 * Error messages::
  24 * Updating files with convert-ly::
  25 * Reporting bugs::
  26 @end menu
  27
  28 @node Normal usage
  29 @section Normal usage
  30
  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.
  33
  34
  35 @node Command-line usage
  36 @section Command-line usage
  37
  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.
  43
  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.
  49
  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.
  54
  55
  56 @menu
  57 * Invoking lilypond::
  58 * Command line options for lilypond::
  59 * Environment variables::
  60 @end menu
  61
  62 @node Invoking lilypond
  63 @subsection Invoking @command{lilypond}
  64
  65 @cindex @command{lilypond} aufrufen
  66 @cindex Kommandozeilen-Optionen für @command{lilypond}
  67 @cindex Optionen an der Kommandozeile
  68
  69 Das @command{lilypond} Programm kann folgendermaßen von der Kommandozeile
  70 aufgerufen werden.
  71
  72 @example
  73 lilypond [@var{Option}]@dots{} @var{Dateiname}@dots{}
  74 @end example
  75
  76
  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{-})
  80 als @var{Dateiname}.
  81
  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.}
  89
  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
  95
  96 @example
  97 #(define output-suffix "Geige")
  98 \book @{ @dots{} @}
  99 #(define output-suffix "Cello")
 100 \book @{ @dots{} @}
 101 @end example
 102
 103 @noindent
 104 erzeugt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
 105 @var{Dateiname}@file{-Cello-1.pdf}.
 106
 107
 108
 109 @node Command line options for lilypond
 110 @subsection Command line options for @command{lilypond}
 111
 112 Die folgenden Kommandozeilenoptionen werden von @command{lilypond} unterstützt:
 113
 114 @table @code
 115
 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.
 121
 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:
 125
 126 @example
 127 lilypond -e '(define-public a 42)'
 128 @end example
 129
 130 @noindent
 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:
 132
 133 @example
 134 #(use-modules (guile-user))
 135 @end example
 136
 137
 138 @item -f,--format=@var{Format}
 139 Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
 140 @code{svg}, @code{ps}, @code{pdf}, @code{png}, @code{tex} und @code{dvi}.
 141
 142 Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
 143
 144
 145
 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
 151
 152 @cindex Point and Click, Kommandozeile
 153
 154 @example
 155 -dno-point-and-click
 156 @end example
 157
 158 @noindent
 159 dasselbe wie
 160 @example
 161 -dpoint-and-click='#f'
 162 @end example
 163
 164 Hier sind ein paar interessante Optionen:
 165
 166 @table @samp
 167 @item help
 168 Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren @code{-d}
 169 Optionen.
 170
 171 @item paper-size
 172 Setzt das Standard-Papierformat,
 173 @example
 174 -dpaper-size=\"letter\"
 175 @end example
 176
 177 @noindent
 178 Die Zeichenkette, die das Format angibt, muss in Anführungszeichen mit Backslash
 179 ( @code{\"} ) stehen.
 180
 181
 182 @item safe
 183 Vertraut der @code{.ly} Datei nicht.
 184
 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:
 189
 190 @quotation
 191 @verbatim
 192 #(system "rm -rf /")
 193 {
 194   c4^#(ly:export (ly:gulp-file "/etc/passwd"))
 195 }
 196 @end verbatim
 197 @end quotation
 198
 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.
 204
 205 Zusätzliche verbietet der sichere Modus auch @code{\include} Befehle sowie
 206 die Benutzung eines Backslashs in @TeX{} Zeichenketten.
 207
 208 Im sicheren Modus ist es nicht möglich, LilyPond-Variablen nach Scheme
 209 zu exportieren.
 210
 211 @code{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
 212 Ressourcen. In diesem Modus ist es also trotzdem möglich, dass LilyPond in einer
 213 Endlosschleife hängt, z.B. wenn zyklische Datenstrukturen an das Backend
 214 übergeben werden. Wenn LilyPond also auf einem öffentlich zugänglichen
 215 Webserver verfügbar gemacht wird, sollte der Prozess sowohl in der CPU-
 216 als auch in der Speichernutzung limitiert werden.
 217
 218 Der sichere Modus verhindert auch, dass zahlreiche nützliche
 219 Musikfragmente von LilyPond verarbeitet werden. Die @code{--jail} Option ist
 220 eine sicherere Alternative, benötigt allerdings auch mehr Aufwand zur
 221 Einrichtung.
 222
 223 @item backend
 224 Gibt an, welches Ausgabeformat das LilyPond Backend benutzt. Mögliche Werte
 225 für diese Option sind:
 226 @table @code
 227 @item tex
 228 @TeX{}-Ausgabeformat, das mit La@TeX{} weiterverarbeitet werden kann. Falls sie
 229 existiert, wird die Datei @file{file.textmetrics} gelesen, um die Textweiten
 230 zu bestimmen.
 231 @item texstr
 232 Schreibt alle Zeichenketten in eine @file{.texstr}-Datei, die mit (La)@TeX{}
 233 verarbeitet werden kann, um eine @code{.textmetrics}-Datei mit den Textweiten
 234 zu erstellen. @strong{Achtung:} Diese Funktionalität ist momentan nicht
 235 verfügbar, da der Quellcode stark umstrukturiert wurde.
 236 @item ps
 237 PostScript-Ausgabeformat.
 238
 239 @cindex PostScript Ausgabeformat
 240
 241 Postscript-Dateien enthalten auch TTF-, Type1- und OTF-Schriften. Allerdings
 242 wird die gesamte Schriftart eingefügt und nicht nur die benötigten Zeichen.
 243 Vor allem wenn nicht-westliche Zeichensätze benutzt werden, kann dies zu sehr
 244 großen Dateien führen.
 245
 246 @item eps
 247 Erzeugt @q{encapsulated PostScript} (EPS). Jede Seite (oder jedes System) wird
 248 als eigene @file{EPS}-Datei ausgegeben, inklusive Schriftarten. Außerdem wird
 249 eine Datei mit allen Seiten (bzw. Systemen) und Schriftarten erzeugt.
 250
 251 Dies ist die Standardeinstellung von @command{lilypond-book}.
 252
 253 @item svg
 254 SVG-Ausgabe (Scalable Vector Graphics). Jede Seite wird als eigene
 255 @file{SVG}-Datei ausgegeben, inklusive eingebetteten Schriftarten.
 256 @cindex SVG (Scalable Vector Graphics)
 257 Sie benötigen einen SVG-Betrachter, der eingebettete Schriftarten unterstützt,
 258 oder einen SVG-Betrachter, der eingebettete Schriftarten durch OTF-Schriften
 259 ersetzen kann. In UNIX und Linux kann z.B. @uref{http://www.inkscape.org,Inkscape}
 260 (ab Version 0.42) benutzt werden, nachdem die OTF-Schriften aus dem
 261 LilyPond-Verzeichnis (typischerweise @file{/usr/share/lilypond/VERSION/fonts/otf/})
 262 in das Verzeichnis @file{~/.fonts/} kopiert wurden.
 263
 264 @item scm
 265 gibt die rohen Scheme-basierenden Zeichenbefehle aus, wie sie intern von
 266 LilyPond benutzt werden.
 267
 268 @cindex Scheme dump
 269 @end table
 270
 271 Beispiel: @code{lilypond -dbackend=svg @var{Dateiname}.ly}
 272
 273 @cindex Ausgabeformat
 274
 275 @item preview
 276 Erzeugt eine Ausgabedatei, die nur die Titelzeilen und das erste System
 277 enthält.
 278
 279 @item print-pages
 280 Erzeugt vollständige Seiten (Standardeinstellung).  @code{-dno-print-pages}
 281 ist in Verbindung mit @code{-dpreview} nützlich.
 282
 283 @end table
 284
 285
 286
 287 @item -h,--help
 288 Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
 289
 290 @item -H,--header=@var{FELD}
 291 Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
 292 @file{Dateiname.@var{FELD}} aus.
 293
 294 @item --include, -I=@var{Verzeichnis}
 295 Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
 296 @cindex Dateisuche
 297 @cindex Suchpfad
 298
 299 @item -i,--init=@var{Initialisierungsdatei}
 300 Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
 301 Standardwert ist @file{init.ly}.
 302
 303 @item -o,--output=@var{DATEI}
 304 Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
 305 @var{DATEI}. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
 306 @code{.pdf} für pdf, @code{.tex} für tex, etc.).
 307
 308 @item --ps
 309 Erzeugt PostScript.
 310
 311 @item --dvi
 312 Erzeugt DVI-Dateien. In diesem Fall sollte das @TeX{}-Backend angegeben werden,
 313 d.h. auch @code{-dbackend=tex}.
 314
 315 @item --png
 316 Erzeugt eine Grafik-Datei im PNG-Format von jeder Seite. Diese Option
 317 impliziert auch @code{--ps}. Die Auflösung in DPI der Grafik kann festgelegt
 318 werden durch
 319 @example
 320 -dresolution=110
 321 @end example
 322
 323 @item --pdf
 324 Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
 325
 326
 327
 328 @item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
 329 Führt @command{lilypond} in einem chroot-Jail aus.
 330
 331 Die @code{--jail} Option ist eine flexiblere Alternative zu @code{--safe}, wenn
 332 LilyPond über das Internet verfügbar gemacht wird oder LilyPond-Quelldateien
 333 von Dritten automatisch vararbeitet werden.
 334
 335 Sie funktioniert dergestalt, dass das Wurzelverzeichnis von
 336 @command{lilypond} auf @var{Jail-Verzeichnis} gesetzt wird, bevor die
 337 tatsächliche Kompilierung der .ly-Datei beginnt. Der Benutzer und die Gruppe
 338 werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
 339 wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
 340 Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
 341 möglich ist, aus dem Jail auszubrechen. Damit @code{--jail} funktioniert, muss
 342 @command{lilypond} allerdings als root ausgeführt werden, was normalerweise
 343 auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
 344
 345 Das Jail-Verzeichnis zu erstellen ist etwas heikel, da LilyPond alle zur
 346 Ausführung nötigen Bibliotheken und Dateien @emph{innerhalb des
 347 Jail-Verzeichnisses} finden muss. Ein typisches Setup besteht aus folgenden
 348 Punkten:
 349
 350 @table @asis
 351 @item Erstellung eines getrennten Dateisystems
 352 Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
 353 sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
 354 eingebunden werden kann. Damit ist es unmöglich, Programme von diesem
 355 Dateisystem auszuführen oder direkt auf eine Hardware-Schnittstelle
 356 zuzugreifen. Wenn Sie keine eigene Partition erstellen möchten, können Sie
 357 auch eine Datei der entsprechenden Größe erstellen und sie als @q{loop}-Gerät
 358 einbinden. Ein getrenntes Dateisystem garantiert auch, dass LilyPond nicht
 359 mehr Festplattenspeicher benutzt als erlaubt.
 360
 361 @item Erstellung eines eigenen Benutzerkontos
 362 Es sollte ein eigener Benutzer und eine eigene Gruppe (z. B.
 363 @code{lily}/@code{lily}) mit geringen Rechten für die Ausführung von LilyPond
 364 innerhalb des Jails benutzt werden. Nur ein einziges Verzeichnis des Jails sollte
 365 für den Benutzer schreibbar sein und als @var{Arbeitsverzeichnis} an
 366 @code{lilypond} übergeben werden.
 367
 368 @item Einrichtung des Jails
 369 LilyPond muss zahlreiche Dateien für die Ausführung einlesen. All diese
 370 Dateien müssen in das Jail-Verzeichnis kopiert werden (mit denselben Pfaden
 371 wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
 372 (typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
 373
 374 Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
 375 @command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
 376 welche Dateien im Jail noch fehlen.
 377
 378 @item Ausführung von LilyPond
 379 In einem mit @code{noexec} eingebundenen Jail ist es nicht möglich, externe
 380 Programme auszuführen. Daher muss LilyPond auf eine Art gestartet werden,
 381 die keine weitere Ausführung von Programmen benötigt. Wie bereits erwähnt
 382 muss LilyPond mit Administrator-Rechten gestartet werden (die es allerdings
 383 sofort wieder abgibt), beispielsweise mittels @command{sudo}. Außerdem
 384 ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
 385 limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
 386 dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher.
 387 @end table
 388
 389
 390 @item -v,--version
 391 Gibt die Versionsnummer aus.
 392
 393 @item -V,--verbose
 394 Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
 395 aller gelesenen Dateien sowie Informationen über die Laufzeit.
 396
 397 @item -w,--warranty
 398 Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
 399 @strong{KEINERLEI GARANTIE}!)
 400 @end table
 401
 402
 403 @node Environment variables
 404 @subsection Environment variables
 405
 406 @cindex LANG
 407 @cindex LILYPOND_DATADIR
 408
 409 @command{lilypond} erkennt und benützt die folgenden Umgebungsvariablen:
 410 @table @code
 411 @item LILYPOND_DATADIR
 412 Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
 413 Meldungen und Übersetzungen finden kann.  Dieses Verzeichnis sollte
 414 Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
 415
 416 @item LANG
 417 Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
 418
 419 @item LILYPOND_GC_YIELD
 420 Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
 421 zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
 422 von LilyPond durchgeführt werden.  Bei höheren Werten benutzt LilyPond
 423 mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung.  Bei
 424 niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
 425 benötigt.  Voreinstellung ist ein Wert von @code{70}.
 426
 427 @end table
 428
 429
 430 @node Error messages
 431 @section Error messages
 432
 433 @cindex error messages
 434 Während der Verarbeitung einer Dateien können diverse Meldungen an der
 435 Kommandozeile auftreten:
 436
 437 @table @emph
 438
 439 @item Warnung
 440 @cindex Warnung
 441 Irgendetwas ist verdächtig.  Wenn Sie etwas Ungewöhnliches in Ihrer
 442 Datei durchführen, dann werden Sie die Meldung verstehen und können
 443 sie gegebenenfalls ignorieren.  Im Normalfall jedoch bedeutet eine
 444 Warnung, dass mit Ihrer Datei etwas nicht stimmt, LilyPond jedoch
 445 trotzdem versucht, die Datei soweit wie möglich korrekt zu übersetzen.
 446
 447 @item Fehler
 448 @cindex Fehler
 449 Irgendetwas stimmt definitiv nicht.  Der aktuelle Bearbeitungsschritt
 450 (Einlesen, Interpretieren oder Formatieren der Datei) wird noch fertig
 451 ausgeführt, danach bricht die Bearbeitung aber ab.
 452
 453 @item Fataler Fehler
 454 @cindex Fataler Fehler
 455 Irgendetwas stimmt definitiv nicht und LilyPond kann nicht weiter
 456 ausgeführt werden.  Dies ist nur sehr selten der Fall, meist sind
 457 die Schriftarten nicht korrekt installiert.
 458
 459 @item Scheme Fehler
 460 @cindex Fehlerprotokoll, Scheme
 461 @cindex Scheme Fehler
 462 Fehler, die während der Ausführung von Scheme-Code auftreten, werden
 463 vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
 464 Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
 465 ausführen, wird der sogennante @q{Call trace} ausgegeben, der die
 466 aufgerufenen Funktionen zur Zeit des Fehlers angibt.
 467
 468 @item Programmierfehler
 469 @cindex Programmierfehler
 470 Eine interne Inkonsistenz ist aufgetreten.  Diese Fehlermeldungen
 471 sollen den Programmierern die Fehlersuche erleichtern und
 472 können meistens einfach ignoriert werden.  In manchen Fällen werden
 473 so viele Meldungen ausgegeben, dass die Lesbarkeit der restliche
 474 Ausgabe davon beeinträchtigt wird.
 475
 476 @item Abgebrochen (core dumped)
 477 Dies bezeichnet einen ernsten Programmierfehler, der das Programm
 478 zum Absturz gebracht hat.  Solche Fehler werden als kritisch angesehen.
 479 Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
 480 @end table
 481
 482 @cindex Fehlermeldung, Format
 483 @cindex Form der Fehlermeldungen
 484 Wenn Warnungen oder Fehlermeldungen mit einer konkreten Stelle in der
 485 Eingabedatei verknüpft werden können, dann hat die Meldung die folgende
 486 Form:
 487
 488 @example
 489 @var{Dateiname}:@var{Zeile}:@var{Spalte}: @var{Meldung}
 490 @var{Fehlerhafte Eingabezeile}
 491 @end example
 492
 493 Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
 494 wo der Fehler aufgetreten ist.  Zum Beispiel
 495
 496 @example
 497 test.ly:2:19: Fehler: keine gültige Dauer: 5
 498   @{ c'4 e'
 499              5 g' @}
 500 @end example
 501
 502 Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
 503 aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
 504 unerwarteten Fällen auf.  Manchmal kann Lilypond auch eine fehlerhafte
 505 Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
 506 sich der Fehler aber dann doch noch aus.  In solchen Fällen, wo Sie in
 507 der angegebenen Zeile keinen Fehler erkennen, sollten Sie auch die Zeilen
 508 oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
 509
 510
 511 @node Updating files with convert-ly
 512 @section Updating files with @command{convert-ly}
 513
 514 @cindex Aktualisierung von LilyPond-Dateien
 515 @cindex Aktualisierung mit convert-ly
 516 @cindex convert-ly: Aktualisierung
 517
 518 Die Eingabesyntax von LilyPond ändert sich graduell um etwa die
 519 Eingabe zu erleichtern oder neue Funktionen zu ermöglichen.  Ein
 520 Nebeneffekt hiervon ist, dass das LilyPond-Übersetzerprogramm nicht
 521 mehr mit älteren Eingabedateien kompatibel sein kann.  Um dies
 522 zu umgehen, kann @command{convert-ly} benutzt werden, welches die
 523 meisten der Syntaxänderungen korrigieren kann.
 524
 525 Das Programm benötigt eine @code{\version}-Information in der
 526 Eingabedatei, um zu wissen, von welcher Version konvertiert werden
 527 soll.  In den meisten Fällen genügt es, den Befehl
 528
 529 @example
 530 convert-ly -e meineDatei.ly
 531 @end example
 532
 533 @noindent
 534 auszuführen.
 535 @c MacOS@tie{}X-Benutzer können diesen Befehl im Menu unter
 536 @c @code{Compile > Update syntax} finden.
 537 @c Does it work? TR
 538
 539 Wenn keine Veränderungen in @code{meineDatei.ly} vorgenommen wurden
 540 und eine Datei @code{meineDatei.ly.NEW} erstellt wird, it
 541 @code{meineDatei.ly} schon aktuell.
 542
 543
 544 @menu
 545 * Command line options for convert-ly::
 546 * Problems with convert-ly::
 547 @end menu
 548
 549 @node Command line options for convert-ly
 550 @subsection Command line options for @command{convert-ly}
 551
 552 @command{convert-ly} konvertiert immer bis zur letzten Syntaxänderung,
 553 die es beherrscht.  Das heißt, dass die neue @code{version}-Nummer
 554 in der Datei überlicherweise etwas niedriger ist als die
 555 Version von @command{convert-ly}.
 556
 557 Um LilyPond-Fragmente in texinfo-Dateien zu aktualisieren, gilt
 558 der Befehl:
 559
 560 @example
 561 convert-ly --from=... --to=... --no-version *.itely
 562 @end example
 563
 564 Um die Änderungen der LilyPond-Syntax zwischen bestimmten Versionen
 565 zu sehen, kann der Befehl
 566
 567 @example
 568 convert-ly --from=... --to=... -s
 569 @end example
 570
 571 @noindent
 572 benutzt werden.
 573
 574 Viele Dateien können auf einmal aktualisiert werden, indem
 575 @code{convert-ly} mit den üblichen UNIX-Befehlen kombiniert
 576 wird.  Das folgende Beispiel aktualisiert alle @code{.ly}-Dateien
 577 im aktuellen Verzeichnis:
 578
 579 @example
 580 for f in *.ly; do convert-ly -e $f; done;
 581 @end example
 582
 583 Die allgemeine Syntax des Programms lautet:
 584
 585 @example
 586 convert-ly [@var{option}]@dots{} @var{file}@dots{}
 587 @end example
 588
 589 Folgende Optionen sind möglich:
 590
 591 @table @code
 592 @item -e,--edit
 593 Verändere die entsprechende Zeile der Eingabedatei. Überschreibt
 594 @code{--output}.
 595
 596 @item -f,--from=@var{von-Versionsnummer}
 597 Setze die Version, ab welcher konvertiert werden soll.  Wenn diese
 598 Option nicht gesetzt ist, versucht @command{convert-ly}, die
 599 Version auf Grundlage von @code{\version} zu raten.
 600
 601 @item -n,--no-version
 602 Normalerweise fügt @command{convert-ly} eine @code{\version}-Zeile
 603 zur Ausgabe hinzu.  Mit dieser Option kann das unterdrückt werden.
 604
 605 @item -s, --show-rules
 606 Zeige alle bekannten Konversionsregeln und beende.
 607
 608 @item --to=@var{bis-Versionsnummer}
 609 Hiermit kann das Ziel der Konversion gesetzt werden.  Standard ist
 610 die neueste mögliche Version.
 611
 612 @item -h, --help
 613 Benutzerhilfe ausgeben.
 614 @end table
 615
 616
 617 @node Problems with convert-ly
 618 @subsection Problems with @code{convert-ly}
 619
 620 Nicht alle Änderungen der Syntax können konvertiert werden.  Nur
 621 eine Ausgabeoption kann angegeben werden.  Scheme- und
 622 LilyPond-Scheme-Code wird sehr unwahrscheinlich korrekt aktualisiert,
 623 hier ist meistens Nacharbeit erforderlich.
 624
 625 @verbatim
 626 Hier eine Liste einiger Befehle, die convert-ly nicht konvertieren kann.
 627
 628 Diese Liste ist in Form von Fehlermeldungen, denn convert-ly
 629 ist so strukturiert, dass nicht alle benötigten Änderungen
 630 implementiert werden können.  Es handelt sich also eher um eine
 631 Wunschliste zur Referenz.
 632
 633 1.6->2.0:
 634  Bezifferter Bass wird nicht immer korrekt konvertiert, besonders
 635  Befehle wie {< >}.  Mats Kommentar hierzu:
 636     Um convert-ly korrekt ausführen zu können, müssen alle Vorkommen
 637     von '{<' in etwas beliebiges wie '{#' und genauso '>}' in '&}'
 638     geändert werden.  Nach der Konversion können sie dann zurück
 639     in '{ <' und '> }' verwandelt werden
 640  Nicht alle Textbeschriftungen werden richtig konvertiert.  In der
 641  alten Syntax  konnten Beschriftungsbefehle mit Klammern gruppiert
 642  werden, etwa
 643    -#'((bold italic) "string")
 644    This will incorrectly be converted into
 645    -\markup{{\bold italic} "string"}
 646    instead of the correct
 647    -\markup{\bold \italic "string"}
 648 2.0->2.2:
 649  \partcombine wird nicht konvertiert
 650  \addlyrics => \lyricsto wird nicht konvertiert, dadurch kompilieren
 651  manche Dateien mit mehreren Strophen nicht.
 652 2.0->2.4:
 653  \magnify wird nicht nach \fontsize konvertiert.
 654     - \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
 655  remove-tag wird nicht verändert.
 656     - \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
 657  first-page-number wird nicht geändert.
 658     - first-page-number no => print-first-page-number = ##f
 659  Zeilenumbrüche im \header-Feld werde nicht konvertiert.
 660     - \\\\  als Zeilenumbruch in \header{...} => \markup \center-align <
 661       "First Line" "Second Line" >
 662  Crescendo- und Decrescendo-Enden werden nicht konvertiert.
 663     - \rced => \!
 664     - \rc => \!
 665 2.2->2.4:
 666  \turnOff (in \set Staff.VoltaBracket = \turnOff eingesetzt) wird nicht korrekt behandelt.
 667 2.4.2->2.5.9
 668  \markup{ \center-align <{ ... }> } sollte umgewandelt werden in:
 669  \markup{ \center-align {\line { ... }} }
 670  aber im Moment fehlt \line.
 671 2.4->2.6
 672  Besondere LaTeX-Zeichen wie $~$ im Text werden nicht nach UTF(
 673  konvertiert.
 674 2.8
 675  \score{} muss jetzt mit einem musikalischen Ausdruck beginnen.
 676  Alles andere (insbesondere \header{}) darf erst nach den Noten
 677  kommen.
 678 @end verbatim
 679
 680
 681
 682 @node Reporting bugs
 683 @section Reporting bugs
 684
 685
 686 @cindex Fehler
 687 @cindex Fehler melden
 688
 689 Wenn Sie eine Datei haben, die zu einem Absturz von LilyPond oder zu einer
 690 fehlerhaften Ausgabe führt, so ist dies ein @q{Bug}.  Die List der aktuell
 691 bekannten derartigen Fehler findet sich in unserem @q{Google Bug Tracker}:
 692
 693 @uref{http://code.google.com/p/lilypond/issues/list}
 694
 695 Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
 696 Sie dies bitte anhand der Anweisungen auf der Seite
 697
 698 @uref{http://lilypond.org/web/devel/participating/bugs}
 699
 700 Wenn Sie Beispieldateien für den Fehler erstellen, versuchen Sie bitte, die
 701 Datei möglichst minimal zu halten und nur jenen LilyPond Code aufzunehmen,
 702 der auch wirklich für den Fehler verantwortlich ist.  Meldungen mit
 703 Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
 704 nicht effektiv bearbeiten.
 705