@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@ignore
- Translation of GIT committish: ab9e3136d78bfaf15cc6d77ed1975d252c3fe506
+ Translation of GIT committish: ebe492ca408fb0d9abf80b94c56197eef8dc2f09
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.13.36"
+@c \version "2.16.0"
@c Translators: Reinhold Kainhofer, Till Paala
@c Translation checkers: Till Paala
@menu
* lilypond aufrufen::
-* Optionen von lilypond auf der Kommandozeile::
+* Optionen auf der Kommandozeile für lilypond::
* Umgebungsvariablen::
* LilyPond in chroot-Kerker::
@end menu
@node lilypond aufrufen
-@subsection @command{lilypond} aufrufen
+@unnumberedsubsec @command{lilypond} aufrufen
@translationof Invoking lilypond
@cindex @command{lilypond} aufrufen
haben.
-@node Optionen von lilypond auf der Kommandozeile
-@subsection Optionen auf der Kommandozeile für @command{lilypond}
+@node Optionen auf der Kommandozeile für lilypond
+@unnumberedsubsec Optionen auf der Kommandozeile für @command{lilypond}
@translationof Command line options for lilypond
Die folgenden Kommandozeilenoptionen werden von @command{lilypond} unterstützt:
@table @code
-@item -e,--evaluate=@var{expr}
-Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
-gelesen und interpretiert werden.
-Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
-werden nacheinander ausgewertet.
-
-Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
-Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
-Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
-
-@example
-lilypond -e '(define-public a 42)'
-@end example
-
-@noindent
-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:
-
-@example
-#(use-modules (guile-user))
-@end example
-
-
-@item -f,--format=@var{Format}
-Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
-@code{svg}, @code{ps}, @code{pdf} und @code{png}.
-
-Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
-
-
-
@item -d,--define-default=@var{Variable}=@var{Wert}
Damit wird die interne Programmoption @var{Variable} auf den Scheme-Wert
@var{Wert} gesetzt. Wird kein @var{Wert} angegeben, so wird @var{#t} benutzt.
@noindent
dasselbe wie
@example
--dpoint-and-click='#f'
+-dpoint-and-click=#f
@end example
-Hier sind ein paar interessante Optionen:
+Folgende Optionen werden unterstützt:
@cindex Hilfe, Kommandozeile
-@table @samp
+@table @code
+
@item help
-Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren @code{-d}
-Optionen.
+Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren
+@option{-d}-Optionen.
@cindex Papierformat, Kommandozeile
Vertraut der @file{.ly} Datei nicht.
Wenn LilyPond über einen Webserver verfügbar gemacht wird, @b{MUSS} unbedingt
-eine die Optionen @code{--safe} oder @code{--jail} angegeben werden.
-Die @code{--safe} Option verhindert, dass in der @file{.ly}-Datei angegebener
+eine die Optionen @option{--safe} oder @option{--jail} angegeben werden.
+Die @option{--safe} Option verhindert, dass in der @file{.ly}-Datei angegebener
Scheme-Code das System gefährden kann, wie etwa in folgendem Beispiel:
@quotation
@verbatim
#(system "rm -rf /")
{
- c4^#(ly:export (ly:gulp-file "/etc/passwd"))
+ c4^$(ly:gulp-file "/etc/passwd")
}
@end verbatim
@end quotation
-Mit der @code{-dsafe} Option werden alle Scheme-Ausdrücke einem speziellen
+Mit der @option{-dsafe} Option werden alle Scheme-Ausdrücke einem speziellen
sicheren Modus ausgewertet. Dieser Modus ist vom GUILE @file{safe-r5rs} Modul
abgeleitet und fügt noch zahlreiche weitere erlaubte Funktionen der
LilyPond Programm-Schnittstelle hinzu. Diese Funktionen sind in
Im sicheren Modus ist es nicht möglich, LilyPond-Variablen nach Scheme
zu exportieren.
-@code{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
+@option{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
Ressourcen. In diesem Modus ist es also trotzdem möglich, dass LilyPond in einer
Endlosschleife hängt, z.B. wenn zyklische Datenstrukturen an das Backend
übergeben werden. Wenn LilyPond also auf einem öffentlich zugänglichen
als auch in der Speichernutzung limitiert werden.
Der sichere Modus verhindert auch, dass zahlreiche nützliche
-Musikfragmente von LilyPond verarbeitet werden. Die @code{--jail} Option ist
+Musikfragmente von LilyPond verarbeitet werden. Die @option{--jail}-Option ist
eine sicherere Alternative, benötigt allerdings auch mehr Aufwand zur
Einrichtung.
Schoolbook-Schriftarten zu installieren, die auch in der LilyPond-Installation
enthalten sind, um optimales Rendern zu erhalten. Unter UNIX können
diese Schriftarten einfach aus dem LilyPond-Verzeichnis (normalerweise
-@file{/usr/share/lilypond/VERSION/fonts/otf/}) nach @file{~/.fonts}
+@file{/usr/share/lilypond/@/VERSION/fonts/otf/}) nach @file{~/.fonts}
kopiert werden. Die SVG-Ausgabe sollte mit allen SVG-Editoren oder
Betrachtungsprogrammen kompatibel sein.
@cindex Scheme-dump
@item scm
-gibt die rohen Scheme-basierenden Zeichenbefehle aus, wie sie intern von
-LilyPond benutzt werden.
-
-@cindex Scheme dump
+gibt die rohen Scheme-basierenden Zeichenbefehle aus (@qq{Scheme-dump}),
+wie sie intern von LilyPond benutzt werden.
@item null
-Keine Partitur wird ausgegeben, hat gleichen Effekt wie @code{-dno-print-pages}.
+Keine Partitur wird ausgegeben, hat gleichen Effekt wie @option{-dno-print-pages}.
@end table
@cindex Vorschau
@item preview
-Erzeugt eine Ausgabedatei, die nur die Titelzeilen und das erste System
+Unterstützt von allen Backendes: @code{pdf}, @code{png}, @code{ps},
+@code{eps} und @code{svg} aber nicht @code{scm} und erzeugt eine
+Ausgabedatei, die nur die Titelzeilen und das erste System
enthält. Wenn @code{\bookpart}-Umgebungen benutzt werden, erscheinen die
Titel und ersten Systeme jedes @code{\bookpart}-Abschnitts in der Datei.
-Die Backends @code{ps}, @code{eps} und @code{svg} unterstützen diese Option.
+
+Zusätzlich wird eine Datei in der Form @code{meineDatei.preview.Endung}
+erstellt, um das zu vermeiden, können die zusätzlichen Optionen
+@option{-dprint-pages} oder @option{-dno-print-pages} je nach gewünschtem
+Ergebnis gewählt werden.
+
+@item gui
+Stiller Durchlauf, alle Ausgabe wird in eine Log-Datei umgeleitet.
+
+Bemerkung für Windows-Benutzer: Standardmäßig schreibt @code{lilypond.exe}
+alle Fortschrittinformation in die Kommandozeile, während
+@code{lilypond-windows.exe} keine Fortschrittinformation angibt und
+sofort die Eingabeaufforderung anzeigt. Die Option @option{-dgui} kann
+in diesem Fall eingesetzt werden, um die Ausgabe in eine Log-Datei umzuleiten.
@item print-pages
-Erzeugt vollständige Seiten (Standardeinstellung). @code{-dno-print-pages}
-ist in Verbindung mit @code{-dpreview} nützlich.
+Erzeugt vollständige Seiten (Standardeinstellung). @option{-dno-print-pages}
+ist in Verbindung mit @option{-dpreview} nützlich.
@end table
+@cindex Scheme, Auswertung von Ausdrücken
+@cindex Auswertung von Ausdrücken, Scheme
+@item -e,--evaluate=@var{expr}
+Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
+gelesen und interpretiert werden.
+Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
+werden nacheinander ausgewertet.
+
+Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
+Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
+Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
+
+@example
+lilypond -e '(define-public a 42)'
+@end example
+
+@noindent
+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:
+
+@example
+#(use-modules (guile-user))
+@end example
+
+@warning{Windows-Benutzer müssen doppelte anstelle der einfachen
+Anführungsstriche einsetzen.}
+
+@cindex Ausgabeformat
+
+@item -f,--format=@var{Format}
+Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
+@code{svg}, @code{ps}, @code{pdf} und @code{png}.
+
+Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
@item -h,--help
Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
@file{Dateiname.@var{FELD}} aus.
-@item --include, -I=@var{Verzeichnis}
+@item -i,--init=@var{Initialisierungsdatei}
+Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
+Standardwert ist @file{init.ly}.
+
+@item -I, --include=@var{Verzeichnis}
Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
@cindex Dateisuche
ersten definierten Verzeichnis und setzt in den weiteren Verzeichnissen
fort, wenn die gesuchte Datei nicht in dem Verzeichnis gefunden wird.
-@item -i,--init=@var{Initialisierungsdatei}
-Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
-Standardwert ist @file{init.ly}.
-
-@cindex Verzeichnis, Ausgabe speichern in
-@cindex Ausgabedateiname
-
-@item -o,--output=@var{DATEI}
-Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
-@var{DATEI}. Wenn ein Verzeichnis mit dem Namen existiert, werden die Ausgabedateien
-in dieses Verzeichnis gespeichert, wobei der Dateiname der Eingabedatei
-benutzt wird. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
-@code{.pdf} für pdf).
-
-@cindex PostScript-Ausgabe
-
-@item --ps
-Erzeugt PostScript.
-
-@cindex PNG-Ausgabe
-@cindex Portable Network Graphics (PNG)
-
-@item --png
-Erzeugt eine Grafik-Datei im PNG-Format von jeder Seite. Diese Option
-impliziert auch @code{--ps}. Die Auflösung in DPI der Grafik kann festgelegt
-werden durch
-@example
--dresolution=110
-@end example
-
-@cindex PDF-Ausgabe
-@cindex Portable Document Format (PDF)
-
-@item --pdf
-Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
+@cindex Kerker, Programm ausführen
+@cindex Jail, Programm ausführen
@item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
Führt @command{lilypond} in einem chroot-Jail aus.
-Die @code{--jail} Option ist eine flexiblere Alternative zu @code{--safe}, wenn
+Die @option{--jail} Option ist eine flexiblere Alternative zu @option{--safe}, wenn
LilyPond über das Internet verfügbar gemacht wird oder LilyPond-Quelldateien
von Dritten automatisch verarbeitet werden.
werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
-möglich ist, aus dem Jail auszubrechen. Damit @code{--jail} funktioniert, muss
+möglich ist, aus dem Jail auszubrechen. Damit @option{--jail} funktioniert, muss
@command{lilypond} allerdings als root ausgeführt werden, was normalerweise
auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
Punkten:
@table @asis
+
@item Erstellung eines getrennten Dateisystems
Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher.
+
@end table
+@cindex Logstufe
+@cindex Ausgabe, Ausführlichkeit
+
+@item -l,--loglevel=@var{Logstufe}
+Passt die Ausführlichkeit der Ausgabe auf der Kommandozeile entsprechend
+@var{Logstufe} an. Mögliche Werte sind:
+
+@table @code
+
+@item NONE
+Keine Ausgabe, nicht einmal Fehlermeldungen.
+
+@item ERROR
+Nur Fehlermeldungen, keine Warnungen oder Fortschrittsmeldungen.
+
+@item WARN
+Warnungen und Fehlermeldungen, keine Fortschrittsmeldungen.
+
+@item BASIC_PROGRESS
+Grundlegende Fortschrittsmeldungen (Erfolg), Warnungen und Fehler.
+
+@item PROGRESS
+Alle Fortschrittsmeldungen, Warnungen und Fehler.
+
+@item INFO (Standard)
+Fortschrittmeldungen, Warnungen, Fehlermeldungen und weiter
+Information über die Ausführung.
+
+@item DEBUG
+Alle möglichen Meldungen, die auch mit der Fehlersuche (Debug) zu tun
+haben können.
+
+@end table
+
+@cindex Verzeichnis, Ausgabe speichern in
+@cindex Ausgabedateiname
+@cindex Dateiname der Ausgabe bestimmen
+
+@item -o,--output=@var{DATEI} oder @var{ORDNER}
+Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
+@var{DATEI}. Wenn ein Verzeichnis mit dem Namen existiert, werden die Ausgabedateien
+in dieses Verzeichnis gespeichert, wobei der Dateiname der Eingabedatei
+benutzt wird. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
+@code{.pdf} für pdf).
+
+@cindex PostScript-Ausgabe
+
+@item --ps
+Erzeugt PostScript.
+
+@cindex PNG-Ausgabe
+@cindex Portable Network Graphics (PNG)
+
+@item --png
+Erzeugt eine Grafik-Datei im PNG-Format von jeder Seite. Diese Option
+impliziert auch @code{--ps}. Die Auflösung in DPI der Grafik kann festgelegt
+werden durch
+@example
+-dresolution=110
+@end example
+
+@cindex PDF-Ausgabe
+@cindex Portable Document Format (PDF)
+
+@item --pdf
+Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
@item -v,--version
Gibt die Versionsnummer aus.
@item -w,--warranty
Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
@strong{KEINERLEI GARANTIE}!)
+
@end table
@node Umgebungsvariablen
-@subsection Umgebungsvariablen
+@unnumberedsubsec Umgebungsvariablen
@translationof Environment variables
@cindex LANG
+@cindex LILYPOND_LOGLEVEL
@cindex LILYPOND_DATADIR
@cindex Variablen, Umgebungs-
@cindex Umgebungsvariablen
@item LANG
Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
+@item LILYPOND_LOGLEVEL
+Die standardmäßige Logstufe. Wenn LilyPond ohne eine explizite
+Logstufe aufterufen wird (d. h. die Kommandozeilenoption @option{--loglevel}
+nicht eingesetzt wird), wird dieser Wert benutzt.
+
@item LILYPOND_GC_YIELD
-Mit dieser Variable (mit Werten zwischen 0 und 100) kann die Feinabstimmung
-zwischen dem Bedarf an Hauptspeicher und Rechenleistung bei der Ausführung
-von LilyPond durchgeführt werden. Bei höheren Werten benutzt LilyPond
-mehr Hauptspeicher, benötigt aber weniger Prozessor-Leistung. Bei
+Eine Variable (von 1 bis 100), die die Speicherverwaltung regelt. Bei
niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
benötigt. Voreinstellung ist ein Wert von @code{70}.
@cindex Scheme Fehler
Fehler, die während der Ausführung von Scheme-Code auftreten, werden
vom Scheme-Interpreter aufgefangen und an der Kommandozeile ausgegeben.
-Wenn Sie LilyPond mit der @code{--verbose} Option (auch @code{-V})
+Wenn Sie LilyPond mit der @option{--verbose} Option (auch @code{-V})
ausführen, wird der sogenannte @q{Call trace} ausgegeben, der die
aufgerufenen Funktionen zur Zeit des Fehlers angibt.
Dies bezeichnet einen ernsten Programmierfehler, der das Programm
zum Absturz gebracht hat. Solche Fehler werden als kritisch angesehen.
Falls daher einer auftritt, senden Sie bitte einen Bug-Report!
+
@end table
@cindex Fehlermeldung, Format
Klammer (@code{@}}). Ohne diese Trennung wird die Klammer als
Teil der Silbe gewertet. Es bietet sich immer an, Leerzeichen vor
und hinter @emph{jede} Klammer zu setzen. Wie wichtig das ist, wenn
-Gesangstext eingesetzt wird, siehe @ruser{Was ist Gesangtext}.
+Gesangstext eingesetzt wird, siehe @ruser{Eingabe von Text}.
Diese Fehlermeldung kann auch mit einem fehlenden schließenden Anführungszeichen
(@code{"}) auftreten. In diesem Fall sollte die begleitende Fehlermeldung
\override VerticalAxisGroup #'staff-affinity = ##f
@end example
-Zu Einzelheiten siehe @qq{Abstand von Nicht-Notensystem-Zeilen} in
-@ruser{Vertikale Abstände innerhalb eines Systems}.
+Zu Einzelheiten siehe @qq{Abstand von Nicht-Notensystemzeilen} in
+@ruser{Flexible vertikale Abstände in Systemgruppen}.