-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Attached is a patch for the AU, sections 1 and 3, where I
1) Fix the English AU Section 3.2.1, which still said that Lilypond
produces .tex files. I also changed the order of the sentences so it makes
more sense.
2) Translated AU 1. to German.
There is a comment in the english version that translators should not
translate anything about compiling from source. How shall this really be
handled? Shall the translated AUs simply miss section "1.2 Compiling from
source" altogether? Or shall those parts appear in English
(language-mixture!)? Or shall section "1.2 Compiling from source" simply
consist of a link to the English version?
3) Translated AU 3, except "3.2.2 Command line options" and "3.4 Updating with
convert-ly".
Okay to apply?
Cheers,
Reinhold
- --
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: [EMAIL PROTECTED], http://reinhold.kainhofer.com/
* Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at/
* K Desktop Environment, http://www.kde.org, KOrganizer maintainer
* Chorvereinigung "Jung-Wien", http://www.jung-wien.at/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
iD8DBQFIsbBGTqjEwhXvPN0RAhluAKCTeEiu7P1bsX42vRklC6gikQZB/wCfVf+E
egVwUmxuVpBAj5RM5RcxSM0=
=YSf8
-----END PGP SIGNATURE-----
From 4ac76531a06d6b6836b67d3650b57a2f58d1108f Mon Sep 17 00:00:00 2001
From: Reinhold Kainhofer <[EMAIL PROTECTED]>
Date: Sun, 24 Aug 2008 20:48:41 +0200
Subject: [PATCH 1/1] Docs: German Translation of some AU sections, adjust English AU
-) English AU: LilyPond does NOT create .tex files any more. Rather, it
produces .ps and .pdf files. Adjust the AU to reflect that change from
years ago!
-) Translated several sections of the AU to German.
---
Documentation/de/user/install.itely | 43 ++++++++-
Documentation/de/user/running.itely | 188 +++++++++++++++++++++++++++++++++--
Documentation/user/running.itely | 26 +++---
3 files changed, 233 insertions(+), 24 deletions(-)
diff --git a/Documentation/de/user/install.itely b/Documentation/de/user/install.itely
index c5f0fed..d42deb7 100644
--- a/Documentation/de/user/install.itely
+++ b/Documentation/de/user/install.itely
@@ -1,16 +1,26 @@
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+ Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
[EMAIL PROTECTED] INSTALL
@node Install
@chapter Install
[EMAIL PROTECTED] ifclear
+Es gibt von Lilypond zwei verschiedene Typen von Versionen: stabile
+Versionen und instabile Entwicklerversionen. Stabile Versionen haben
+eine gerade Unter-Versionsnummer (z.B. 2.8, 2.10, 2.12, etc.).
+Entwicklerversionen haben hingegen ungerade Unter-Versionsnummern (z.B.
+2.7, 2.9, 2.11, etc.).
+
+LilyPond selbst zu kompilieren ist ein relativ komplizierter Vorgang, daher
+empfehlen wir @strong{stark}, die vorkompilierten Binär-Pakete zu benutzen.
@untranslated
@@ -22,10 +32,37 @@
@node Precompiled binaries
@section Precompiled binaries
[EMAIL PROTECTED]
[EMAIL PROTECTED] Downloading
[EMAIL PROTECTED] Downloading
+Aktuelle Informationen zu vorkompilierten Binär-Paketen für Ihre Plattform
+finden Sie unter @uref{http://lilypond.org/web/install/}. Falls Ihr Betriebssystem
+auf dieser allgemeinen Seite nicht behandelt wird, sehen Sie bitte in
+der vollständigen Liste unter @uref{http://download.linuxaudio.org/lilypond/binaries/}
+nach.
+
+Momentan werden Binärpakete für folgende Plattformen erstellt:
+
[EMAIL PROTECTED]
+darwin-ppc - MacOS X powerpc
+darwin-x86 - MacOS X intel
+freebsd-64 - FreeBSD 6.x, x86_64
+freebsd-x86 - FreeBSD 4.x, x86
+linux-64 - Beliebige GNU/Linux Distribution, x86_64
+linux-arm - Beliebige GNU/Linux Distribution, arm
+linux-ppc - Beliebige GNU/Linux Distribution, powerpc
+linux-x86 - Beliebige GNU/Linux Distribution, x86
+mingw - Windows x86
[EMAIL PROTECTED] example
+
+
[EMAIL PROTECTED] TRANSLATORS:
[EMAIL PROTECTED] Please **do not** translate anything below this line. Users
[EMAIL PROTECTED] should not be compiling LilyPond themselves; if they really
[EMAIL PROTECTED] want to do so, they should be able to read the English docs,
[EMAIL PROTECTED] because they'll probably need to ask questions in English
[EMAIL PROTECTED] on the -devel list. -gp
+
@node Compiling from source
@section Compiling from source
diff --git a/Documentation/de/user/running.itely b/Documentation/de/user/running.itely
index b35fb13..5fbfef6 100644
--- a/Documentation/de/user/running.itely
+++ b/Documentation/de/user/running.itely
@@ -1,7 +1,7 @@
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+ Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@@ -11,7 +11,7 @@
@node Running LilyPond
@chapter Running LilyPond
[EMAIL PROTECTED]
+Dieses Kapitel behandelt die technischen Details, wie Lilypond ausgeführt werden kann.
@menu
@@ -25,13 +25,29 @@
@node Normal usage
@section Normal usage
[EMAIL PROTECTED]
+Die meisten Benutzer führen LilyPond von einer graphischen Benutzeroberfläche
+aus. Siehe @rlearning{First steps}, falls Sie dies nicht bereits getan haben.
@node Command-line usage
@section Command-line usage
[EMAIL PROTECTED]
+Dieser Abschnitt enthält zusätzliche Informationen, wie Sie LilyPond
+von der Kommandozeile ausführen können. Dies kann erforderlich sein,
+um etwa zusätzliche Optionen an das Programm zu übergeben. AuÃerdem
+sind einige Zusatzprogramme (wie etwa @code{midi2ly}) nur von der
+Kommandozeile verfügbar.
+
+Unter @q{Kommandozeile} verstehen wir die Kommandozeile des jeweiligen
+Betriebssystems. Windows Benutzern ist sie vielleicht eher unter den
+englischen Begriffen @q{DOS shell} oder @q{command shell} bekannt.
[EMAIL PROTECTED] Benutzer kennen sie eher unter @q{Terminal} oder @q{Konsole}.
+Sie sollten auch den Abschnitt @ref{MacOS X on the command-line} konsultieren.
+
+Wie die Kommandozeile im jeweiligen Betriebssystem benutzt werden kann,
+soll in diesem Handbuch nicht näher beschrieben werden. Sehen Sie bitte
+im Handbuch Ihres Betriebssystems nach oder informieren Sie sich im
+Internet, wenn Sie mit der Kommandozeile nicht vertraut sind.
@menu
@@ -43,7 +59,48 @@
@node Invoking lilypond
@subsection Invoking lilypond
[EMAIL PROTECTED]
[EMAIL PROTECTED] LilyPond aufrufen
[EMAIL PROTECTED] Kommandozeilen-Optionen
[EMAIL PROTECTED] Optionen an der Kommandozeile
+
+Das @command{lilypond} Programm kann folgendermaÃen von der Kommandozeile
+aufgerufen werden.
+
[EMAIL PROTECTED]
+lilypond [EMAIL PROTECTED]@dots{} @[EMAIL PROTECTED]
[EMAIL PROTECTED] example
+
+
+Wird ein @file{Dateiname} ohne Erweiterung angegeben, so wird @file{.ly} als
+Standarderweiterung für LilyPond-Dateien benutzt. Um Daten von
[EMAIL PROTECTED] einzulesen, benutzen Sie einfach einen Bindestrich (@code{-})
+als @var{Dateiname}.
+
+Wenn Lilypond die Datei @file{Dateiname.ly} verarbeitet, werden daraus
+die Dateien @file{Dateiname.ps} und @file{Dateiname.pdf} erzeugt.
+Es können an @code{lilypond} auch mehrere @file{.ly} Dateien übergeben
+werden, die dann einzeln und voneinander unabhängig abgearbeitet
[EMAIL PROTECTED] Zustand von GUILE wird allerdings nicht nach
+jeder Datei zurückgesetzt, sodass Achtung geboten ist, wenn in einer
+Datei globale Ãnderungen von Scheme aus durchgeführt werden.}
+
+Falls @file{Dateiname.ly} mehr als einen @code{\score}-Block enthält,
+werden die weiteren Stücke in durchnummerierte Dateien der Form
[EMAIL PROTECTED] ausgegeben. Zusätzlich wird der Wert der
+Variable @code{output-suffix} zwischen den ursprünglichen Dateienamen
+und der Zahl eingefügt. Eine Lilypond-Datei @var{Dateiname.ly} mit dem Inhalt
+
[EMAIL PROTECTED]
+#(define output-suffix "Geige")
+\book @{ @dots{} @}
+#(define output-suffix "Cello")
+\book @{ @dots{} @}
[EMAIL PROTECTED] example
+
[EMAIL PROTECTED]
+erzeigt daher die Dateien @[EMAIL PROTECTED] und
[EMAIL PROTECTED]@file{-Cello-1.pdf}.
+
@node Command line options
@@ -55,13 +112,109 @@
@node Environment variables
@subsection Environment variables
[EMAIL PROTECTED]
[EMAIL PROTECTED] LANG
[EMAIL PROTECTED] LILYPOND_DATADIR
+
[EMAIL PROTECTED] erkennt und benützt die folgenden Umgebungsvariablen:
[EMAIL PROTECTED] @code
[EMAIL PROTECTED] LILYPOND_DATADIR
+Diese Variable gibt das Verzeichnis an, wo Lilypond seine eigenen Dateien,
+Meldungen und Ãbersetzungen finden kann. Dieses Verzeichnis sollte
+Unterverzeichnisse @file{ly/}, @file{ps/}, @file{tex/}, etc. beinhalten.
+
[EMAIL PROTECTED] LANG
+Gibt die Sprache an, in der Warnungen und Fehlermeldungen ausgegeben werden.
+
[EMAIL PROTECTED] 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
+niedrigeren Werten wird mehr Prozessor-Zeit, dafür weniger Hauptspeicher
+benötigt. Voreinstellung ist ein Wert von @code{70}.
+
[EMAIL PROTECTED] table
@node Error messages
@section Error messages
[EMAIL PROTECTED]
[EMAIL PROTECTED] error messages
+Während der Verarbeitung einer Dateien können diverse Meldungen an der
+Kommandozeile auftreten:
+
[EMAIL PROTECTED] @emph
+
[EMAIL PROTECTED] Warnung
[EMAIL PROTECTED] Warnung
+Irgendetwas ist verdächtig. Wenn Sie etwas Ungewöhnliches in Ihrer
+Datei durchführen, dann werden Sie die Meldung verstehen und können
+sie gegebenenfalls ignorieren. Im Normalfall jedoch bedeutet eine
+Warnung, dass mit Ihrer Datei etwas nicht stimmt, LilyPond jedoch
+trotzdem versucht, die Datei soweit wie möglich korrekt zu übersetzen.
+
[EMAIL PROTECTED] Fehler
[EMAIL PROTECTED] Fehler
+Irgendetwas stimmt definitiv nicht. Der aktuelle Bearbeitungsschritt
+(Einlesen, Interpretieren oder Formatieren der Datei) wird noch fertig
+ausgeführt, danach bricht die Bearbeitung aber ab.
+
[EMAIL PROTECTED] Fataler Fehler
[EMAIL PROTECTED] Fataler Fehler
+Irgendetwas stimmt definitiv nicht und LilyPond kann nicht weiter
+ausgeführt werden. Dies ist nur sehr selten der Fall, meist sind
+die Schriftarten nicht korrekt installiert.
+
[EMAIL PROTECTED] Scheme Fehler
[EMAIL PROTECTED] Fehlerprotokoll, Scheme
[EMAIL PROTECTED] 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})
+ausführen, wird der sogennante @q{Call trace} ausgegeben, der die
+aufgerufenen Funktionen zur Zeit des Fehlers angibt.
+
[EMAIL PROTECTED] Programmierfehler
[EMAIL PROTECTED] Programmierfehler
+Eine interne Inkonsistenz ist aufgetreten. Diese Fehlermeldungen
+sind sollen den Programmierern die Fehlersuche erleichtern und
+können meistens einfach ignoriert werden. In manchen Fällen werden
+so viele Meldungen ausgegeben, dass die Lesbarkeit der restliche
+Ausgabe davon beeinträchtigt wird.
+
[EMAIL PROTECTED] Abgebrochen (core dumped)
+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!
[EMAIL PROTECTED] table
+
[EMAIL PROTECTED] Fehlermeldung, Format
[EMAIL PROTECTED] Form der Fehlermeldungen
+Wenn Warnungen oder Fehlermeldungen mit einer konkreten Stelle in der
+Eingabedatei verknüpft werden können, dann hat die Meldung die folgende
+Form:
+
[EMAIL PROTECTED]
[EMAIL PROTECTED]:@var{Zeile}:@var{Spalte}: @var{Meldung}
[EMAIL PROTECTED] Eingabezeile}
[EMAIL PROTECTED] example
+
+Ein Zeilenumbruch wird in der fehlerhaften Zeile an jener Stelle eingefügt,
+wo der Fehler aufgetreten ist. Zum Beispiel
+
[EMAIL PROTECTED]
+test.ly:2:19: Fehler: keine gültige Dauer: 5
+ @{ c'4 e'
+ 5 g' @}
[EMAIL PROTECTED] example
+
+Diese Stellen sind LilyPonds Vermutung, wo die Warnung oder der Fehler
+aufgetreten ist, allerdings treten Warnungen und Fehler ja gerade in
+unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
+Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
+sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
+der angegebenen Zeile keinen Fehler erkenn, sollten Sie auch die Zeilen
+oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
@node Updating files with convert-ly
@@ -84,7 +237,26 @@
@node Reporting bugs
@section Reporting bugs
[EMAIL PROTECTED]
+
[EMAIL PROTECTED] Fehler
[EMAIL PROTECTED] Fehler melden
+
+Wenn Sie eine Datei haben, die zu einem Absturz von LilyPond oder zu einer
+fehlerhaften Ausgabe führt, so ist dies ein @q{Bug}. Die List der aktuell
+bekannten derartigen Fehler findet sich in unserem @q{Google Bug Tracker}:
+
[EMAIL PROTECTED]://code.google.com/p/lilypond/issues/list}
+
+Wenn Sie einen Fehler gefunden haben, der noch nicht aufgelistet ist, melden
+Sie dies bitte anhand der Anweisungen auf der Seite
+
[EMAIL PROTECTED]://lilypond.org/web/devel/participating/bugs}
+
+Wenn Sie Beispieldateien für den Fehler erstellen, versuchen Sie bitte, die
+Datei möglichst minimal zu halten und nur jenen LilyPond Code aufzunehmen,
+der auch wirklich für den Fehler verantwortlich ist. Meldungen mit
+Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
+nicht effektiv bearbeiten.
diff --git a/Documentation/user/running.itely b/Documentation/user/running.itely
index 06c2186..d2f7c50 100644
--- a/Documentation/user/running.itely
+++ b/Documentation/user/running.itely
@@ -16,7 +16,7 @@
This chapter details the technicalities of running LilyPond.
@menu
-* Normal usage::
+* Normal usage::
* Command-line usage::
* Error messages::
* Updating files with convert-ly::
@@ -75,17 +75,17 @@ When invoked with a filename that has no extension, the @file{.ly}
extension is tried first. To read input from stdin, use a
dash (@code{-}) for @var{file}.
-When @file{filename.ly} is processed it will produce
[EMAIL PROTECTED] as output (or @file{filename.ps} for PostScript
-output). If @file{filename.ly} contains more than one @code{\score}
-block, then the rest of the scores will be output in numbered files,
-starting with @file{filename-1.tex}. Several files can be specified;
+When @file{filename.ly} is processed it will produce @file{filename.ps}
+and @file{filename.pdf} as output. Several files can be specified;
they will each be processed independently. @footnote{The status of
GUILE is not reset after processing a @code{.ly} file, so be careful
not to change any system defaults from within Scheme.}
-In addition, the value of @code{output-suffix} will be inserted between
-the basename and the number. An input file containing
+If @file{filename.ly} contains more than one @code{\score}
+block, then the rest of the scores will be output in numbered files,
+starting with @file{filename-1.pdf}. In addition, the value of
[EMAIL PROTECTED] will be inserted between the basename and the
+number. An input file containing
@example
#(define output-suffix "violin")
@@ -95,8 +95,8 @@ the basename and the number. An input file containing
@end example
@noindent
-will output @[EMAIL PROTECTED] and
[EMAIL PROTECTED]@file{-cello-1.ps}.
+will output @[EMAIL PROTECTED] and
[EMAIL PROTECTED]@file{-cello-1.pdf}.
@node Command line options
@@ -460,9 +460,9 @@ A line-break is inserted in the offending line to indicate the column
where the error was found. For example,
@example
-test.ly:2:19: error: not a duration: 5:
- @{ c'4 e'5
- g' @}
+test.ly:2:19: error: not a duration: 5
+ @{ c'4 e'
+ 5 g' @}
@end example
These locations are LilyPond's best guess about where the warning or
--
1.5.4.3
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-devel
