Difference between revisions of "De/Feedback"

From GnuCash
Jump to: navigation, search
(Aqbanking Protokolle: (neu))
({{*Url}} -> {{URL:*}}, …; minor cleanup)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Wie man einen Fehler meldet oder einen Verbesserungsvorschlag einreicht ...
+
[[Category:De|Feedback]]
 +
Wie man einen Fehler meldet oder einen Verbesserungsvorschlag einreicht
 
== Ein paar allgemeine Empfehlungen ==
 
== Ein paar allgemeine Empfehlungen ==
  
 
Da die Problematik der Fehlermeldung ja viele Projekte gleichermaßen betrifft, wird den Anwendern zunächst die Lektüre mindestens eines der beiden folgenden, teils recht unterhaltsamen Dokumente wärmstens empfohlen:
 
Da die Problematik der Fehlermeldung ja viele Projekte gleichermaßen betrifft, wird den Anwendern zunächst die Lektüre mindestens eines der beiden folgenden, teils recht unterhaltsamen Dokumente wärmstens empfohlen:
* [http://www.tty1.net/smart-questions_de.html Wie man Fragen richtig stellt]
+
* [https://www.tty1.net/smart-questions_de.html Wie man Fragen richtig stellt]
* [http://www.chiark.greenend.org.uk/~sgtatham/bugs-de.html Fehlerberichte - wie Sie Softwarefehler melden sollten]
+
* [https://www.chiark.greenend.org.uk/~sgtatham/bugs-de.html Fehlerberichte - wie Sie Softwarefehler melden sollten]
  
 
Obacht, jene Seiten bieten KEINEN SUPPORT für GnuCash, daher bitte weiterlesen.
 
Obacht, jene Seiten bieten KEINEN SUPPORT für GnuCash, daher bitte weiterlesen.
 +
 +
===Verwendetes Betriebssystem===
 +
 +
Da GnuCash unter verschiedenen Betriebssystemen läuft, ist es sehr wichtig das '''Betiebssystem''' und seine '''Version''' mitzuteilen.
 +
 +
===Verwendete Versionen===
 +
In den meisten Fällen ist es sinnvoll, die verwendeten Versionen von GnuCash und den benutzten Hilfsprogrammen zu notieren. Die meisten davon stehen im Dialog <tt>Hilfe->Info</tt>.
 +
Um auch die Version von <tt>Aqbanking</tt> und seiner Hilfsbibliothek Gwenhywfar anzuzeigen, nimmt man die Befehlszeile {{Shell Versions}} oder, bei einem [[De/Flatpak|Flatpak]]: {{Flatpak Versions}}
 +
In diesem Beispiel hat der Anwender ein neueres GnuCash selbst gebaut, während AqBanking im Flatpak neuer ist als in der Distribution.
  
 
== Die verschiedenen Meldungsebenen des Programms ==
 
== Die verschiedenen Meldungsebenen des Programms ==
Line 18: Line 28:
 
=== Die Ausgaben auf der Konsole ===
 
=== Die Ausgaben auf der Konsole ===
  
Wenn man das Programm nicht über das Start-Menü aufruft, sondern in einem Befehlsfenster, erscheinen dort zusätzliche Informationen. Meist sollte man zumindest diese Informationen bereithalten, wenn man einen Fehler melden möchte. In unserem Beispiel könnte hier etwa als Grund "Datei nicht gefunden", "Zugriff abgelehnt" oder ... stehen.
+
Wenn man das Programm nicht über das Start-Menü aufruft, sondern in einem Befehlsfenster, erscheinen dort zusätzliche Informationen. Meist sollte man zumindest diese Informationen bereithalten, wenn man einen Fehler melden möchte. In unserem Beispiel könnte hier etwa als Grund "Datei nicht gefunden", "Zugriff abgelehnt" oder stehen.
  
Wie öffnet man nun so ein Befehlsfenster?
+
Wie öffnet man nun so ein Befehlsfenster? Der Menüpunkt variiert je nach Betriebssystem, bzw. Desktop-Umgebung:
* ''Gnome'': '''Rechner->Anwendungen->Weitere Anwendungen->System->Terminal''',
+
:;Gnome: <tt>Rechner->Anwendungen->Weitere Anwendungen->System->Terminal</tt>,
* ''KDE'': '''K-Menü->System->Terminals->Konsole''',
+
:;KDE: <tt>K-Menü->System->Terminals->Konsole</tt>,
* ''MacOSX'': '''Finder->Programme->Dienstprogramme->Terminal''' und
+
:;{{mac}}: <tt>Finder->Programme->Dienstprogramme->Terminal</tt> und
* ''Windows'': '''Start->Alle Programme->Zubehör->Eingabeaufforderung'''.
+
:;Windows: <tt>Start->Alle Programme->Zubehör->Eingabeaufforderung</tt>.
  
Ein Aufruf darin von
+
Ein Aufruf darin von <syntaxhighlight lang="sh">
gnucash --help
+
gnucash --help
listet einem dann eine ganze Reihe möglicher Parameter auf. Für die Fehlersuche bedeutsam sind die im nächsten Beispiel augeführten. Weitere Möglichkeiten zum Feintuning der Ausgaben werden auf der englischsprachigen Seite [[Logging]] erläutert.
+
</syntaxhighlight> listet einem dann eine ganze Reihe möglicher Parameter auf. Für die Fehlersuche bedeutsam sind die im nächsten Beispiel aufgeführten. Weitere Möglichkeiten zum Feintuning der Ausgaben werden auf der englischsprachigen Seite [[Logging]] erläutert.
  
Falls man des Englischen einigermaßen mächtig ist, empfiehlt es sich insbesondere dann, wenn man vorhat, einen Bugzilla-Eintrag zu erstellen oder ergänzen, das Programm gleich auf Englisch mit
+
Falls man des Englischen einigermaßen mächtig ist, empfiehlt es sich insbesondere dann, wenn man vorhat, einen Bugzilla-Eintrag zu erstellen oder ergänzen, das Programm gleich auf Englisch mit <syntaxhighlight lang="sh">
 
+
LANG=C gnucash [--log [--logto [--debug|--extra]  
LANG=C gnucash [--log ...] [--logto ...] [--debug|--extra]  
+
</syntaxhighlight> zu starten, um Fehler bei der Rückübersetzung der Meldungen zu vermeiden.
 
 
zu starten, um Fehler bei der Rückübersetzung der Meldungen zu vermeiden.
 
  
 
:''"Der Wodka war gut, aber das Steak war gammlig."'' soll ja seinerzeit das Ergebnis der ersten maschinellen Rückübersetzung von
 
:''"Der Wodka war gut, aber das Steak war gammlig."'' soll ja seinerzeit das Ergebnis der ersten maschinellen Rückübersetzung von
Line 40: Line 48:
  
  
Manchmal reicht aber auch das nicht, dann geht's zum nächsten Punkt.
+
Manchmal reicht aber auch das nicht, dann geht es zum nächsten Punkt.
  
 
=== Die normale GnuCash Protokoll-Datei .trace ===
 
=== Die normale GnuCash Protokoll-Datei .trace ===
  
GnuCash schreibt während jedem Programmdurchlauf eine Protokolldatei "gnucash.trace", genannt "Trace-Datei". In vielen Fehlersituationen wird die ausführliche Information zu dem vorliegenden Fehler in diese Prokolldatei geschrieben. Deshalb brauchen die Entwickler in einem Fehlerbericht häufig als erstes den Inhalt dieser Protokolldatei. (Siehe auch die englische Seite "[[Tracefile]]".)
+
GnuCash schreibt während jedem Programmdurchlauf eine Protokolldatei "gnucash.trace", genannt "Trace-Datei". Bitte nicht mit dem ähnlich klingenden [[#Der_Stacktrace|Stacktrace]] verwechseln! In vielen Fehlersituationen wird die ausführliche Information zu dem vorliegenden Fehler in diese Prokolldatei geschrieben. Deshalb brauchen die Entwickler in einem Fehlerbericht häufig als erstes den Inhalt dieser Protokolldatei. (Siehe auch die englische Seite "[[Tracefile]]".)
  
 
Zum Auffinden der Protokolldatei: Sofern die Standardeinstellung nicht durch <code>--logto <PfadName></code> geändert wird, wird diese an folgendem Ort angelegt:
 
Zum Auffinden der Protokolldatei: Sofern die Standardeinstellung nicht durch <code>--logto <PfadName></code> geändert wird, wird diese an folgendem Ort angelegt:
* Linux/BSD/*nix: '''/tmp/gnucash.trace'''
+
;Linux/BSD/*nix: <tt>/tmp/gnucash.trace</tt>
* Windows
+
;Windows:
** bis XP: '''C:\Documente und Einstellungen\MeinName\Lokale Einstellungen\Temp\gnucash.trace.XXXXXX'''
+
:;seit Vista: <tt>C:\Users\myname\AppData\Local\Temp\gnucash.trace.XXXXXX</tt>
** ab Vista: '''C:\Users\myname\AppData\Local\Temp\gnucash.trace.XXXXXX'''
+
:;bis XP: <tt>C:\Documente und Einstellungen\MeinName\Lokale Einstellungen\Temp\gnucash.trace.XXXXXX</tt>
 
: Die Zeichenkette "XXXXXX" sind sechs zufällig wechselnde Buchstaben. Anhand des Änderungsdatum muss man jene Datei heraussuchen, die beim Auftreten des Fehlers erstellt wurde.
 
: Die Zeichenkette "XXXXXX" sind sechs zufällig wechselnde Buchstaben. Anhand des Änderungsdatum muss man jene Datei heraussuchen, die beim Auftreten des Fehlers erstellt wurde.
* MacOS: in einem temporären Ordner unter '''/var/folders''', welcher weder im Finder angezeigt wird, noch von Searchlight gefunden wird. :-(
+
;{{mac}}: in einem temporären Ordner unter <tt>/var/folders</tt>, welcher weder im Finder angezeigt wird, noch von Searchlight gefunden wird, also: <syntaxhighlight lang="sh">
find /var/folders -name gnucash.trace -exec less \{\} \;
+
find /var/folders -name gnucash.trace -exec less \{\} \;
: sollte das Anzeigen ermöglichen.
+
</syntaxhighlight>
 +
Falls mehrere Dateien vorhanden sind, sollte der ''Zeitstempel'' der letzten Modifikation mit dem ''Sitzungsende'' übereinstimmen.
  
 
Die Datei variiert stark in der Größe - wenige Zeilen oder viele Megabyte können beide vorkommen. Die Datei besteht aus einfachem Text und kann in jedem Texteditor betrachtet werden.
 
Die Datei variiert stark in der Größe - wenige Zeilen oder viele Megabyte können beide vorkommen. Die Datei besteht aus einfachem Text und kann in jedem Texteditor betrachtet werden.
  
Falls gewünscht, kann man die Auswahl der dort protokollierten Informationen genauer einstellen. Ein Beispiel und weitere Details wie Loglevel und Module finden sich auf der englischen Seite "[[Logging]]" oder auch in der [http://code.gnucash.org/docs/MAINT/group__Logging.html technische Dokumentation]. Falls man nun das Programm immer wieder mit denselben Einstellungen starten möchte, ohne sie jedesmal auf der Befehlzeile neu eingeben zu müssen, kann man die entsprechenden Optionen auch in einer Datei <code>~/.gnucash/log.conf</code> ablegen.
+
Falls gewünscht, kann man die Auswahl der von der Sitzung dort protokollierten Informationen genauer einstellen. Ein Beispiel und weitere Details wie Loglevel und Module finden sich auf der englischen Seite "[[Logging]]" oder auch in der [{{URL:docs:API}}group__Logging.html technische Dokumentation]. Falls man nun das Programm immer wieder mit denselben Einstellungen starten möchte, ohne sie jedes mal auf der Befehlzeile neu eingeben zu müssen, kann man die entsprechenden Optionen auch in einer Datei ablegen:
 +
:;seit GnuCash 3.0: <tt>[[Configuration Locations#GNC_CONFIG_HOME|GNC_CONFIG_HOME]]/log.conf</tt>
 +
:;bis GnuCash 2.6.x: <tt>[[Configuration Locations#DOT_GNUCASH_DIR|DOT_GNUCASH_DIR]]/log.conf</tt>
  
 
=== Aqbanking Protokolle ===
 
=== Aqbanking Protokolle ===
  
Sofern das Problem im Zusammenhang mit [[HBCI|Online-Banking]] auftritt, siehe auch [[HBCI#Fehlersuche]].
+
Sofern das Problem im Zusammenhang mit dem [[De/Online-Banking|Online-Banking]] auftritt, siehe die  dortige [[De/Online-Banking#Fehlersuche|Fehlersuche]].
 +
 
 +
Auf GnuCash-Seite läßt sich für die [[#Die_normale_GnuCash_Protokoll-Datei_.trace|Trace-Datei]] auf der Befehlszeile <syntaxhighlight lang="sh">
 +
gnucash --log gnc.import.aqbanking=debug
 +
</syntaxhighlight> oder dauerhafter in <tt>log.conf</tt> <syntaxhighlight lang="ini">
 +
[levels]
 +
gnc.import.aqbanking=debug
 +
</syntaxhighlight> setzen.
  
 
=== Die unkomprimierte Gnucash-Datei ===
 
=== Die unkomprimierte Gnucash-Datei ===
Line 70: Line 88:
 
Falls man vergessen hat, wo die Datei gespeichert wird, kann man das durch Öffnen des Dialogs "Datei->Speichern unter" in Erfahrung bringen.
 
Falls man vergessen hat, wo die Datei gespeichert wird, kann man das durch Öffnen des Dialogs "Datei->Speichern unter" in Erfahrung bringen.
  
In Fehlerberichten ist es zuweilen sinnvoll, eine ''möglichst kleine'' Beispieldatei anzuhängen, mit deren Hilfe das Problem nachvollzogen werden kann. In einigen ganz seltenen Fällen tritt aber das Problem auf, daß ein Fehler in der eigenen Datei vermutet wird, sich jedoch nicht ohne Weiteres reproduzieren läßt. Bevor man nun seine ganzen persönlichen Finanzdaten an eine relativ fremde Person weitergibt, sollte man die Daten verschleiern, ohne die Struktur der Datei zu verändern. Dazu gibt es auf der englischen Seite [[ObfuscateScript]] ein Perl-Skript, welches man ''auf die zu verschickende '''Kopie''' anwenden'' kann, um das zu bewerkstelligen. Da Perl bei Linux-Distributionen zum Lieferumfang gehört, wird für Windows-Benutzer auf die möglicherweise noch erforderliche [[De/Installation#Installation_des_optionalen_Zubeh.C3.B6rs | Installation]] verwiesen.
+
In Fehlerberichten ist es zuweilen sinnvoll, eine ''möglichst kleine'' Beispieldatei anzuhängen, mit deren Hilfe das Problem nachvollzogen werden kann. In einigen ganz seltenen Fällen tritt aber das Problem auf, dass ein Fehler in der eigenen Datei vermutet wird, sich jedoch nicht ohne Weiteres reproduzieren lässt. Bevor man nun seine ganzen persönlichen Finanzdaten an eine relativ fremde Person weitergibt, sollte man die Daten verschleiern, ohne die Struktur der Datei zu verändern. Dazu gibt es auf der englischen Seite [[ObfuscateScript]] ein Perl-Skript, welches man ''auf die zu verschickende '''Kopie''' anwenden'' kann, um das zu bewerkstelligen. Da Perl bei Linux-Distributionen zum Lieferumfang gehört, wird für Windows-Benutzer auf die möglicherweise noch erforderliche [[De/Installation#Installation_des_optionalen_Zubeh.C3.B6rs | Installation]] verwiesen.
  
 
=== Der Stacktrace ===
 
=== Der Stacktrace ===
  
Wenn es einen Programmabsturz gegeben hat, ist die wichtigste Information für die Entwickler ein ''Stacktrace'' (auch genannt ''Call Stack''), die Abfolge der Funktionsaufrufe im Programm. Wenn irgend möglich, sollte man bei einem Programmabsturz versuchen, diesen Stacktrace zu bekommen und mit einzuschicken. Dafür muss man GnuCash im Debugger ''gdb'' ausführen. Die Anleitung dazu steht auf der englischen Seite "[[Stack Trace]]".
+
Wenn es einen Programm'''absturz''' gegeben hat, ist die wichtigste Information für die Entwickler ein ''Stacktrace'' (auch genannt ''Call Stack''), die Abfolge der Funktionsaufrufe im Programm. Wenn irgend möglich, sollte man bei einem Programmabsturz versuchen, diesen Stacktrace zu bekommen und mit einzuschicken. Dafür muss man GnuCash im Debugger ''gdb'' ausführen. Die Anleitung dazu steht auf der englischen Seite "[[Stack Trace]]".
  
 
== Informationen des Betriebssystems ==
 
== Informationen des Betriebssystems ==
 
 
Es gibt ein paar Ursachen, die mit dem Zustand des Computers zusammenhängen und mit dessen Bordmitteln überprüft werden können:
 
Es gibt ein paar Ursachen, die mit dem Zustand des Computers zusammenhängen und mit dessen Bordmitteln überprüft werden können:
 
   
 
   
 
=== Schreib- und Leserechte ===
 
=== Schreib- und Leserechte ===
 
 
Hier sollte man mit dem Dateimanager seiner Wahl überprüfen, ob der Benutzer Schreib- und Leserechte für  
 
Hier sollte man mit dem Dateimanager seiner Wahl überprüfen, ob der Benutzer Schreib- und Leserechte für  
 
* die '''Datei''' und  
 
* die '''Datei''' und  
Line 91: Line 107:
  
 
=== Verfügbarer Speicherplatz ===
 
=== Verfügbarer Speicherplatz ===
 +
Bisweilen treten Fehler auch auf, weil auf dem Speichermedium - Festplatte, USB-Stick, Netzwerklaufwerk, … - schlichtweg kein Platz mehr ist. Auch dies kann man gewöhnlich im Dateimanager überprüfen.
  
Bisweilen treten Fehler auch auf, weil auf dem Speichermedium - Festplatte, USB-Stick, Netzwerklaufwerk, ... - schlichtweg kein Platz mehr ist. Auch dies kann man gewöhnlich im Dateimanager überprüfen.
+
=== Netzwerkverbindung ===
 +
Sofern man seine Datei nicht auf dem lokalen Rechner, sondern im Netz - LAN oder Internet - speichert, sollte man natürlich auch seine Netzwerk-Verbindung überprüfen.  
  
 
=== Sprach- und Regionaleinstellungen ===
 
=== Sprach- und Regionaleinstellungen ===
 +
Eine weitere Fehlerquelle sind unterschiedliche Einstellungen von Sprache, Zeichensatzcodierung oder Formaten.
 +
In der Regel verfügen Betriebssysteme, Distributionen oder Desktop-Umgebungen wie GNOME oder KDE über eine Komponente <tt>Systemeinstellungen</tt> und  darin ein Modul für Internationales, Sprach- und Regionaleinstellungen o.ä., um diese zu überprüfen oder zu ändern.
  
Eine weitere Fehlerquelle sind unterschiedliche Einstellungen von Sprache, Zeichensatzcodierung oder Formaten.
+
== Ist das Problem bereits gelöst? ==
In der Regel verfügen Betriebssyteme, Distributionen oder Desktop-Umgebungen wie GNOME oder KDE über eine Komponente <tt>Systemeinstellungen</tt> und  darin ein Modul für Internationales, Sprach- und Regionaleinstellungen o.ä., um diese zu überprüfen oder zu ändern.
+
;Anmerkung: Je nach Aufwand kann dieser Schritt auch später erfolgen.
 +
Falls die eigene Gnucash-Version schon älter ist - aktuell ist {{Version}} - sollte man zunächst sein System auf den neuesten Stand bringen.
 +
 
 +
Neben den [{{URL:www}}download.phtml offiziellen Veröffentlichungen] gibt es auch tägliche Testversionen für
 +
{| class="wikitable"
 +
|-
 +
! scope="col"|
 +
! scope="col"| nur aktuelle Bugfixes
 +
! scope="col"| neue Features, Bugfixes verzögert
 +
 
 +
|- style="vertical-align:top;"
 +
! scope="row"|[[De/Flatpak|Flatpak]] (Linux)
 +
| [{{URL:Build:FP}} flatpak/stable]
 +
| [{{URL:Build:FP|future}} flatpak/future]
 +
 
 +
|- style="vertical-align:top;"
 +
! scope="row"|Windows
 +
| [{{URL:Build:Win}} win32/stable]
 +
| [{{URL:Build:Win|future}} win32/future]
 +
|}
 +
sofern man es nicht [[Building|selber bauen (englisch)]] kann oder will.
 +
:;Anmerkung: Der <tt>future</tt>-Zweig wird erst mit der Implementierung des ersten Merkmals aus [[Release Schedule#Goals for 6.0]] erstellt.
  
 
== Die Recherche: Ist das Problem bereits bekannt? ==
 
== Die Recherche: Ist das Problem bereits bekannt? ==
Line 107: Line 148:
 
Falls man sein Problem knapp und fließend auf Englisch - manchmal sind auch Deutschsprachige anwesend, da muß man halt mal fragen - beschreiben kann, findet man im [irc://irc.gnome.org/#gnucash Chat] auch meistens jemanden, der einem helfen kann, zu entscheiden, ob es sich wirklich um einen Programmierfehler oder ein Verständnisproblem handelt.
 
Falls man sein Problem knapp und fließend auf Englisch - manchmal sind auch Deutschsprachige anwesend, da muß man halt mal fragen - beschreiben kann, findet man im [irc://irc.gnome.org/#gnucash Chat] auch meistens jemanden, der einem helfen kann, zu entscheiden, ob es sich wirklich um einen Programmierfehler oder ein Verständnisproblem handelt.
  
Wer nicht weiß, was [http://de.wikipedia.org/wiki/Internet_Relay_Chat Internet Relay Chat] ist und was man dafür braucht, sollte einen Blick auf die [[IRC|englische Seite]] werfen.
+
Wer nicht weiß, was [{{URL:wp|de}}Internet_Relay_Chat Internet Relay Chat] ist und was man dafür braucht, sollte einen Blick auf die [[IRC|englische Seite]] werfen.
  
Mittels ''Copy&Paste'' kann man sich ja ganz schnell auch größere Textbrocken zuwerfen. Im Chat ist das aber verpönt, da es einfach zu unübersichtlich ist. Falls man also aufgefordert wird die Konsolenausgabe oder eine Protokolldatei zu zeigen, sollte man einen Pastebin wie z.B. http://pastebin.ca oder http://pastebin.com verwenden. Text dort hineinkopieren, ''Submit'' anklicken und den zurückgegebenen Link in den Chat kopieren, damit die anderen darauf zugreifen können.
+
Mittels ''Copy&Paste'' kann man sich ja ganz schnell auch größere Textbrocken zuwerfen. Im Chat ist das aber verpönt, da es einfach zu unübersichtlich ist. Falls man also aufgefordert wird die Konsolenausgabe oder eine Protokolldatei zu zeigen, sollte man einen Pastebin wie z.B. https://pastebin.com verwenden. Text dort hineinkopieren, ''Submit'' anklicken und den zurückgegebenen Link in den Chat kopieren, damit die anderen darauf zugreifen können.
  
 
=== Suche in Mailinglisten ===
 
=== Suche in Mailinglisten ===
  
Auch die Suche in den [http://wiki.gnucash.org/wiki/Mailing_Lists GnuCash-Mailinglisten] mit [http://www.google.com Google] oder einer anderen Suchmaschine kann hilfreich sein - wahrscheinlich ist schon jemand anderes zuvor über das Problem gestolpert. Und in der Zeit, in der Entwickler Fragen beantworten, können sie nun mal nicht entwickeln.
+
Auch die Suche in den [[Mailing_Lists|GnuCash-Mailinglisten]] mit [https://www.google.com Google] oder einer anderen Suchmaschine kann hilfreich sein - wahrscheinlich ist schon jemand anderes zuvor über das Problem gestolpert. Und in der Zeit, in der Entwickler Fragen beantworten, können sie nun mal nicht entwickeln.
  
 
Da es zur Zeit - Herbst 2010 - Probleme mit dem Such-Index auf der GnuCash-Seite gibt, empfiehlt es sich die Google-Suche mit dem Parameter <code>site:lists.gnucash.org</code> oder in der erweiterten Google-Suche ''Domains Ausschließlich Antwortseiten von der Site oder Domain lists.gnucash.org'' zu verwenden.
 
Da es zur Zeit - Herbst 2010 - Probleme mit dem Such-Index auf der GnuCash-Seite gibt, empfiehlt es sich die Google-Suche mit dem Parameter <code>site:lists.gnucash.org</code> oder in der erweiterten Google-Suche ''Domains Ausschließlich Antwortseiten von der Site oder Domain lists.gnucash.org'' zu verwenden.
Line 120: Line 161:
  
 
Für eigenständige Projekte wie
 
Für eigenständige Projekte wie
* [https://github.com/codinguser/gnucash-android GnuCash für Android]: [https://github.com/codinguser/gnucash-android/issues?q=is%3Aopen GitHub Issues],
+
* [{{URL:GH}}codinguser/gnucash-android GnuCash für Android]: [https://github.com/codinguser/gnucash-android/issues?q=is%3Aopen GitHub Issues],
* die Online-Kursabfrage [http://sourceforge.net/projects/finance-quote Finance::Quote]: [https://rt.cpan.org/Public/Dist/Display.html?Name=Finance-Quote Request Tracker des Comprehensive Perl Archive Network] oder
+
* die Online-Kursabfrage [{{URL:GH}}finance-quote Finance::Quote] oder
* das Online-Banking [https://git.aquamaniac.de/trac/aqbanking/report AqBanking], sofern klar ist, daß es nicht an Gnucash liegt,  
+
*;Anmerkung: Die alten Seiten [{{URL:SF}}projects/finance-quote Finance::Quote@SF] und [https://rt.cpan.org/Public/Dist/Display.html?Name=Finance-Quote Request Tracker des Comprehensive Perl Archive Network] sind nicht mehr aktiv.
 
+
* das Online-Banking [https://git.aquamaniac.de/trac/aqbanking/report AqBanking], sofern klar ist, dass es nicht an Gnucash liegt,  
 
bitte deren jeweiliges System verwenden.
 
bitte deren jeweiliges System verwenden.
  
 
=== Suche im BugZilla ===
 
=== Suche im BugZilla ===
 +
Dass ist das Verzeichnis für Fehlermeldungen und Verbesserungsvorschläge von GnuCash, egal, ob es das Programm oder die Dokumentation betrifft.
 +
;Ausnahme: Missstände in diesem Wiki sollten hier direkt behoben werden. Rechts oben einloggen oder —sofern noch nicht geschehen: Konto beantragen, auf Bestätigung warten - und loslegen.
  
'''Bugzilla''' ist das Verzeichnis für Fehlermeldungen und Verbesserungsvorschläge.
+
{{De/2018-07-01 Bugzilla-Umzug}}
{{De/Ankündigung}}}
 
 
 
Seit dem 30.6.2018 betreibt das Gnucash-Team einen eigenen Server, zuvor wurde der des [http://www.gnome.org/ Gnome Projekts] benutzt. ''GnuCash'' wurde dort als eigenes Produkt geführt.
 
  
* [{{BugURL‏‎}}/query.cgi Allgemeine Suche (in allen Projekten)]
+
* [{{URL:Bugs‏‎}}query.cgi Allgemeine Suche (in allen Projekten)]
  
* [{{BugURL‏‎}}/buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&bug_status=VERIFIED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query&version=2.0.x&version=CVS&version=SVN&version=unspecified Suche nach offenen GnuCash Bugs und Verbesserungsvorschlägen, eingeschränkt auf unspezifizerte oder Versionen >=2.0]. Ältere Versionen werden nicht mehr gepflegt.  
+
* [{{URL:Bugs‏‎}}buglist.cgi?product=GnuCash&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&namedcmd=Gnucash+Bugs&newqueryname=Gnucash+Bugs&order=Bug+Number&form_name=query&version={{MainVersion}}.0&version=git-stable&version=git-future&version=unspecified Suche nach offenen GnuCash Bugs und Verbesserungsvorschlägen, eingeschränkt auf unspezifizerte oder Versionen >={{MainVersion}}.0]. Ältere Versionen werden nicht mehr gepflegt.  
  
 
Besonders, wenn man nicht die aktuellste Version verwendet, ist es sinnvoll, in einem 2. Durchgang die Einschränkungen des bug_status rauszunehmen, da der Fehler inzwischen behoben sein könnte.
 
Besonders, wenn man nicht die aktuellste Version verwendet, ist es sinnvoll, in einem 2. Durchgang die Einschränkungen des bug_status rauszunehmen, da der Fehler inzwischen behoben sein könnte.
Line 160: Line 200:
 
** ''-v'' als Abkürzung für
 
** ''-v'' als Abkürzung für
 
** ''--version''.
 
** ''--version''.
Falls man das Programm selbst gebaut hat, ist auch der '''Git-Hashwert''' oder zumindest der Zeitstempel der letzten Aktualisierung wichtig, da sich der Inhalt des [http://de.wikipedia.org/wiki/Git Git]-[https://github.com/Gnucash/gnucash Repositorium] ja sehr schnell ändern kann.
+
Falls man das Programm selbst gebaut hat, ist auch der '''Git-Hashwert''' oder zumindest der Zeitstempel der letzten Aktualisierung wichtig, da sich der Inhalt des [{{URL:wp|de}}Git Git]-[{{URL:git}}gnucash Repositorium] ja sehr schnell ändern kann.
  
 
Oft ist es auch hilfreich, das Programm statt über das Startmenü oder eine andere Verknüpfung, direkt in einem Terminalfenster zu starten und das, was es dorthin schreibt, zu analysieren oder als Anhang mitzusenden.
 
Oft ist es auch hilfreich, das Programm statt über das Startmenü oder eine andere Verknüpfung, direkt in einem Terminalfenster zu starten und das, was es dorthin schreibt, zu analysieren oder als Anhang mitzusenden.
Line 166: Line 206:
 
=== In BugZilla ===
 
=== In BugZilla ===
  
[{{BugURL‏‎}}/browse.cgi?product=GnuCash Bugzilla] dient der Verwaltung von '''Fehlern''' und '''Verbesserungsvorschlägen'''.
+
[{{URL:Bugs‏‎}} Bugzilla] dient der Verwaltung von '''Fehlern''' und '''Verbesserungsvorschlägen'''.
  
 
Zunächst sollte man die dortige Suche verwenden, um herauszufinden, ob der Fehler schon bekannt ist.
 
Zunächst sollte man die dortige Suche verwenden, um herauszufinden, ob der Fehler schon bekannt ist.
Line 174: Line 214:
 
Falls er noch nicht bekannt ist, meldet man ihn, am allerbesten auf Englisch, und zwar unter:  
 
Falls er noch nicht bekannt ist, meldet man ihn, am allerbesten auf Englisch, und zwar unter:  
  
* [{{BugURL‏‎}}/enter_bug.cgi?product=GnuCash Erstelle einen neuen GnuCash Fehlerbericht oder Verbesserungsvorschlag]; falls man einen Absturz berichtet, bitte [[Stack Trace|hier - leider noch auf english -]] nachsehen, wie man einen ''stack trace'' für den Bug Report erstellt und anfügt.
+
* [{{URL:Bugs‏‎}}enter_bug.cgi?product=GnuCash Erstelle einen neuen GnuCash Fehlerbericht oder Verbesserungsvorschlag]; falls man einen Absturz berichtet, bitte [[Stack Trace|hier - leider noch auf english -]] nachsehen, wie man einen ''stack trace'' für den Bug Report erstellt und anfügt.
  
 
* Falls für die Fehlersuche eine Gnucash-Datei eingeschickt werden soll, kann man den wirklichen Inhalt der Kopie einer unkomprimierten XML-Datei mit dem [[ObfuscateScript]] vernebeln.
 
* Falls für die Fehlersuche eine Gnucash-Datei eingeschickt werden soll, kann man den wirklichen Inhalt der Kopie einer unkomprimierten XML-Datei mit dem [[ObfuscateScript]] vernebeln.
Line 180: Line 220:
 
=== Auf UserVoice ===
 
=== Auf UserVoice ===
  
Seit Februar 2011 besteht auch die Möglichkeit, [http://gnucash.uservoice.com UserVoice] für die Verwaltung von '''Verbesserungsvorschlägen''' zu nutzen.
+
Seit Februar 2011 besteht auch die Möglichkeit, [{{URL:UV}} UserVoice] für die Verwaltung von '''Verbesserungsvorschlägen''' zu nutzen.
  
 
;Tip: Ganz unten auf der Seite kann man die Oberfläche auf ''Deutsch'' umstellen.
 
;Tip: Ganz unten auf der Seite kann man die Oberfläche auf ''Deutsch'' umstellen.
Line 187: Line 227:
  
 
Wer mit dem Englischen Probleme hat, kann auch auf der deutschen Mailing-Liste anfragen, ob jemand mit dem Übersetzen helfen kann.  
 
Wer mit dem Englischen Probleme hat, kann auch auf der deutschen Mailing-Liste anfragen, ob jemand mit dem Übersetzen helfen kann.  
Dafür ist wegen der Spammer allerdings eine [https://lists.gnucash.org/mailman/listinfo/gnucash-de Anmeldung ] sinnvoll. Andernfalls landet die Mail in einer Warteschlange und muß erst von einem Moderator freigegeben werden.
+
Dafür ist wegen der Spammer allerdings eine [{{URL:mail info|de}} Anmeldung ] sinnvoll. Andernfalls landet die Mail in einer Warteschlange und muss erst von einem Moderator freigegeben werden.
  
 
Hier sollten auch Verbesserungen an '''spezifisch deutschsprachigen Komponenten''' wie ''Kontenrahmen'' und ''Übersetzung'' von Programm-Meldungen oder Dokumentationen eingereicht und diskutiert werden.
 
Hier sollten auch Verbesserungen an '''spezifisch deutschsprachigen Komponenten''' wie ''Kontenrahmen'' und ''Übersetzung'' von Programm-Meldungen oder Dokumentationen eingereicht und diskutiert werden.
Line 195: Line 235:
 
'''Antworten''' sollte man immer auch an die Liste - jedes Mailprogramm hat auch irgendwo im Menü verborgen Befehle wie "Allen antworten" und "An die Liste antworten". Wirklich nur ganz persönliche Nachrichten wie ''Einladung zum Kaffeetrinken'' sollten nicht an die Liste geschickt werden. Der vorherige Autor könnte nämlich nach Diktat verreist sein - dann liegt die Antwort wochenlang in seinem Posteingang rum und kein Schwein kümmert sich drum - oder andere Leute könnten noch bessere Ideen zu dem Problem haben.
 
'''Antworten''' sollte man immer auch an die Liste - jedes Mailprogramm hat auch irgendwo im Menü verborgen Befehle wie "Allen antworten" und "An die Liste antworten". Wirklich nur ganz persönliche Nachrichten wie ''Einladung zum Kaffeetrinken'' sollten nicht an die Liste geschickt werden. Der vorherige Autor könnte nämlich nach Diktat verreist sein - dann liegt die Antwort wochenlang in seinem Posteingang rum und kein Schwein kümmert sich drum - oder andere Leute könnten noch bessere Ideen zu dem Problem haben.
  
Falls man sich die '''Gnucash-Mails täglich gebündelt''' zusenden läßt, ist es auch sinnvoll ''beim Antworten den Betreff'' auf die tatsächlich beantwortete Original-Mail ''anzupassen'', also statt "Re: [gnucash-de] gnucash-de Nachrichtensammlung, Band 94, Eintrag 6" aus der betreffenden Nachricht die Subject-Zeile
+
Falls man sich die '''Gnucash-Mails täglich gebündelt''' zusenden lässt, ist es auch sinnvoll ''beim Antworten den Betreff'' auf die tatsächlich beantwortete Original-Mail ''anzupassen'', also statt "Re: [gnucash-de] gnucash-de Nachrichtensammlung, Band 94, Eintrag 6" aus der betreffenden Nachricht die Subject-Zeile
 
"Re: [gnucash-de] DTAUS" übernehmen.
 
"Re: [gnucash-de] DTAUS" übernehmen.
  
Line 201: Line 241:
  
 
Falls es bereits gelungen ist, das eigene Sytem zu verbessern, sind die Entwickler natürlich an einem Patch interessiert. Für diese am einfachsten zu handhaben sind  
 
Falls es bereits gelungen ist, das eigene Sytem zu verbessern, sind die Entwickler natürlich an einem Patch interessiert. Für diese am einfachsten zu handhaben sind  
* '''Pull-Requests''' auf GitHub, siehe [[Git]].
+
* [[De/Pull Request|Pull-Requests]] auf GitHub, siehe [[Git]].
 
* Alternativ kann man den Patch auch an den entsprechenden '''[[#In Bugzilla|Bugzilla]]-Eintrag''' hängen.
 
* Alternativ kann man den Patch auch an den entsprechenden '''[[#In Bugzilla|Bugzilla]]-Eintrag''' hängen.
* Das Einsenden als Anhang via '''Mailingliste''' ist im Prinzip auch möglich, birgt aber die Gefahr, daß er übersehen oder vergessen wird.
+
* Das Einsenden als Anhang via '''Mailingliste''' ist im Prinzip auch möglich, birgt aber die Gefahr, dass er übersehen oder vergessen wird.
 
* Direkt an einen Entwickler sollte man ihn wirklich nur nach expliziter Aufforderung senden.
 
* Direkt an einen Entwickler sollte man ihn wirklich nur nach expliziter Aufforderung senden.
  
 
----
 
----
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[De/GnuCash | Zurück zur Hauptseite]]
 
[[Category:De|Feedback]]
 

Latest revision as of 20:20, 30 January 2024

Wie man einen Fehler meldet oder einen Verbesserungsvorschlag einreicht …

Ein paar allgemeine Empfehlungen

Da die Problematik der Fehlermeldung ja viele Projekte gleichermaßen betrifft, wird den Anwendern zunächst die Lektüre mindestens eines der beiden folgenden, teils recht unterhaltsamen Dokumente wärmstens empfohlen:

Obacht, jene Seiten bieten KEINEN SUPPORT für GnuCash, daher bitte weiterlesen.

Verwendetes Betriebssystem

Da GnuCash unter verschiedenen Betriebssystemen läuft, ist es sehr wichtig das Betiebssystem und seine Version mitzuteilen.

Verwendete Versionen

In den meisten Fällen ist es sinnvoll, die verwendeten Versionen von GnuCash und den benutzten Hilfsprogrammen zu notieren. Die meisten davon stehen im Dialog Hilfe->Info.

Um auch die Version von Aqbanking und seiner Hilfsbibliothek Gwenhywfar anzuzeigen, nimmt man die Befehlszeile
$ gnucash --version
GnuCash 3.8 development version
Build ID: git 3.8b-163-g0e6c9e219+(2020-02-19)
$ aqbanking-cli versions
Versions:
 AqBanking-CLI: 6.0.1
 Gwenhywfar   : 5.1.2.0
 AqBanking    : 6.0.1.0
oder, bei einem Flatpak:
$ flatpak run --command=sh org.gnucash.GnuCash
[📦 org.gnucash.GnuCash ~]$ gnucash --version
GnuCash 3.8 development version
Build ID: git e6b3c56+(2020-01-26)
[📦 org.gnucash.GnuCash ~]$ aqbanking-cli versions
Versions:
 AqBanking-CLI: 6.0.2
 Gwenhywfar   : 5.1.3.0
 AqBanking    : 6.0.2.0
[📦 org.gnucash.GnuCash ~]$ exit
exits

In diesem Beispiel hat der Anwender ein neueres GnuCash selbst gebaut, während AqBanking im Flatpak neuer ist als in der Distribution.

Die verschiedenen Meldungsebenen des Programms

GnuCash versucht auf verschiedenen Ebenen mit dem Benutzer zu kommunizieren. Während für das Tagesgeschäft die Ausgaben der Programmoberfläche reichen, sind bei Fehlermeldungen häufig die Ausgaben der Anderen erforderlich.

Die Programmoberfläche

Normalerweise kommuniziert GnuCash über seine Benutzeroberfläche mit dem Benutzer durch Hinweise in der Statuszeile, Dialog- oder Meldungsfenstern. Falls dort eine unbefriedigende Fehlermeldung erscheint wie "Beim Lesen der Datei »/Pfad/Name« ist ein Fehler aufgetreten.", sollte der nächste Punkt versucht werden.

Die Ausgaben auf der Konsole

Wenn man das Programm nicht über das Start-Menü aufruft, sondern in einem Befehlsfenster, erscheinen dort zusätzliche Informationen. Meist sollte man zumindest diese Informationen bereithalten, wenn man einen Fehler melden möchte. In unserem Beispiel könnte hier etwa als Grund "Datei nicht gefunden", "Zugriff abgelehnt" oder … stehen.

Wie öffnet man nun so ein Befehlsfenster? Der Menüpunkt variiert je nach Betriebssystem, bzw. Desktop-Umgebung:

Gnome
Rechner->Anwendungen->Weitere Anwendungen->System->Terminal,
KDE
K-Menü->System->Terminals->Konsole,
macOS
Finder->Programme->Dienstprogramme->Terminal und
Windows
Start->Alle Programme->Zubehör->Eingabeaufforderung.
Ein Aufruf darin von
gnucash --help
listet einem dann eine ganze Reihe möglicher Parameter auf. Für die Fehlersuche bedeutsam sind die im nächsten Beispiel aufgeführten. Weitere Möglichkeiten zum Feintuning der Ausgaben werden auf der englischsprachigen Seite Logging erläutert. Falls man des Englischen einigermaßen mächtig ist, empfiehlt es sich insbesondere dann, wenn man vorhat, einen Bugzilla-Eintrag zu erstellen oder ergänzen, das Programm gleich auf Englisch mit
LANG=C gnucash [--log … [--logto … [--debug|--extra]
zu starten, um Fehler bei der Rückübersetzung der Meldungen zu vermeiden.
"Der Wodka war gut, aber das Steak war gammlig." soll ja seinerzeit das Ergebnis der ersten maschinellen Rückübersetzung von
"Der Geist war willig, aber das Fleisch war schwach." gewesen sein.


Manchmal reicht aber auch das nicht, dann geht es zum nächsten Punkt.

Die normale GnuCash Protokoll-Datei .trace

GnuCash schreibt während jedem Programmdurchlauf eine Protokolldatei "gnucash.trace", genannt "Trace-Datei". Bitte nicht mit dem ähnlich klingenden Stacktrace verwechseln! In vielen Fehlersituationen wird die ausführliche Information zu dem vorliegenden Fehler in diese Prokolldatei geschrieben. Deshalb brauchen die Entwickler in einem Fehlerbericht häufig als erstes den Inhalt dieser Protokolldatei. (Siehe auch die englische Seite "Tracefile".)

Zum Auffinden der Protokolldatei: Sofern die Standardeinstellung nicht durch --logto <PfadName> geändert wird, wird diese an folgendem Ort angelegt:

Linux/BSD/*nix
/tmp/gnucash.trace
Windows
seit Vista
C:\Users\myname\AppData\Local\Temp\gnucash.trace.XXXXXX
bis XP
C:\Documente und Einstellungen\MeinName\Lokale Einstellungen\Temp\gnucash.trace.XXXXXX
Die Zeichenkette "XXXXXX" sind sechs zufällig wechselnde Buchstaben. Anhand des Änderungsdatum muss man jene Datei heraussuchen, die beim Auftreten des Fehlers erstellt wurde.
macOS
in einem temporären Ordner unter /var/folders, welcher weder im Finder angezeigt wird, noch von Searchlight gefunden wird, also:
find /var/folders -name gnucash.trace -exec less \{\} \;

Falls mehrere Dateien vorhanden sind, sollte der Zeitstempel der letzten Modifikation mit dem Sitzungsende übereinstimmen.

Die Datei variiert stark in der Größe - wenige Zeilen oder viele Megabyte können beide vorkommen. Die Datei besteht aus einfachem Text und kann in jedem Texteditor betrachtet werden.

Falls gewünscht, kann man die Auswahl der von der Sitzung dort protokollierten Informationen genauer einstellen. Ein Beispiel und weitere Details wie Loglevel und Module finden sich auf der englischen Seite "Logging" oder auch in der technische Dokumentation. Falls man nun das Programm immer wieder mit denselben Einstellungen starten möchte, ohne sie jedes mal auf der Befehlzeile neu eingeben zu müssen, kann man die entsprechenden Optionen auch in einer Datei ablegen:

seit GnuCash 3.0
GNC_CONFIG_HOME/log.conf
bis GnuCash 2.6.x
DOT_GNUCASH_DIR/log.conf

Aqbanking Protokolle

Sofern das Problem im Zusammenhang mit dem Online-Banking auftritt, siehe die dortige Fehlersuche.

Auf GnuCash-Seite läßt sich für die Trace-Datei auf der Befehlszeile
gnucash --log gnc.import.aqbanking=debug
oder dauerhafter in log.conf
[levels]
gnc.import.aqbanking=debug
setzen.

Die unkomprimierte Gnucash-Datei

Bisweilen kann es auch hilfreich sein, einen Blick in die unkomprimiert gespeicherte Gnucash-Datei zu werfen. Dafür ist vor dem Speichern unter Bearbeiten->Einstellungen->Allgemein das Häkchen bei "Datei komprimieren" zu entfernen.

Falls man vergessen hat, wo die Datei gespeichert wird, kann man das durch Öffnen des Dialogs "Datei->Speichern unter" in Erfahrung bringen.

In Fehlerberichten ist es zuweilen sinnvoll, eine möglichst kleine Beispieldatei anzuhängen, mit deren Hilfe das Problem nachvollzogen werden kann. In einigen ganz seltenen Fällen tritt aber das Problem auf, dass ein Fehler in der eigenen Datei vermutet wird, sich jedoch nicht ohne Weiteres reproduzieren lässt. Bevor man nun seine ganzen persönlichen Finanzdaten an eine relativ fremde Person weitergibt, sollte man die Daten verschleiern, ohne die Struktur der Datei zu verändern. Dazu gibt es auf der englischen Seite ObfuscateScript ein Perl-Skript, welches man auf die zu verschickende Kopie anwenden kann, um das zu bewerkstelligen. Da Perl bei Linux-Distributionen zum Lieferumfang gehört, wird für Windows-Benutzer auf die möglicherweise noch erforderliche Installation verwiesen.

Der Stacktrace

Wenn es einen Programmabsturz gegeben hat, ist die wichtigste Information für die Entwickler ein Stacktrace (auch genannt Call Stack), die Abfolge der Funktionsaufrufe im Programm. Wenn irgend möglich, sollte man bei einem Programmabsturz versuchen, diesen Stacktrace zu bekommen und mit einzuschicken. Dafür muss man GnuCash im Debugger gdb ausführen. Die Anleitung dazu steht auf der englischen Seite "Stack Trace".

Informationen des Betriebssystems

Es gibt ein paar Ursachen, die mit dem Zustand des Computers zusammenhängen und mit dessen Bordmitteln überprüft werden können:

Schreib- und Leserechte

Hier sollte man mit dem Dateimanager seiner Wahl überprüfen, ob der Benutzer Schreib- und Leserechte für

  • die Datei und
  • das Verzeichnis, in dem sie sich befindet, hat - zwecks Anlegen der Backup- und Protokolldateien.

An der Befehlszeile geht das auch mit

  • Linux: ls -al /pfad/zum/gnucash-verzeichnis
  • Windows: dir /pfad/zum/gnucash-verzeichnis

Verfügbarer Speicherplatz

Bisweilen treten Fehler auch auf, weil auf dem Speichermedium - Festplatte, USB-Stick, Netzwerklaufwerk, … - schlichtweg kein Platz mehr ist. Auch dies kann man gewöhnlich im Dateimanager überprüfen.

Netzwerkverbindung

Sofern man seine Datei nicht auf dem lokalen Rechner, sondern im Netz - LAN oder Internet - speichert, sollte man natürlich auch seine Netzwerk-Verbindung überprüfen.

Sprach- und Regionaleinstellungen

Eine weitere Fehlerquelle sind unterschiedliche Einstellungen von Sprache, Zeichensatzcodierung oder Formaten. In der Regel verfügen Betriebssysteme, Distributionen oder Desktop-Umgebungen wie GNOME oder KDE über eine Komponente Systemeinstellungen und darin ein Modul für Internationales, Sprach- und Regionaleinstellungen o.ä., um diese zu überprüfen oder zu ändern.

Ist das Problem bereits gelöst?

Anmerkung
Je nach Aufwand kann dieser Schritt auch später erfolgen.

Falls die eigene Gnucash-Version schon älter ist - aktuell ist 5.9 - sollte man zunächst sein System auf den neuesten Stand bringen.

Neben den offiziellen Veröffentlichungen gibt es auch tägliche Testversionen für

nur aktuelle Bugfixes neue Features, Bugfixes verzögert
Flatpak (Linux) flatpak/stable flatpak/future
Windows win32/stable win32/future

sofern man es nicht selber bauen (englisch) kann oder will.

Anmerkung
Der future-Zweig wird erst mit der Implementierung des ersten Merkmals aus Release Schedule#Goals for 6.0 erstellt.

Die Recherche: Ist das Problem bereits bekannt?

Da man ja nicht der einzige GnuCash-Benutzer ist, gibt es eine recht hohe Wahrscheinlichkeit, dass vor einem selbst schon jemand anderes auf das gleiche Problem gestoßen ist und unter Umständen ein – wie auch immer gearteter – Lösungsweg gefunden wurde.

Der schnelle Weg: Rückfrage im Chat

Falls man sein Problem knapp und fließend auf Englisch - manchmal sind auch Deutschsprachige anwesend, da muß man halt mal fragen - beschreiben kann, findet man im Chat auch meistens jemanden, der einem helfen kann, zu entscheiden, ob es sich wirklich um einen Programmierfehler oder ein Verständnisproblem handelt.

Wer nicht weiß, was Internet Relay Chat ist und was man dafür braucht, sollte einen Blick auf die englische Seite werfen.

Mittels Copy&Paste kann man sich ja ganz schnell auch größere Textbrocken zuwerfen. Im Chat ist das aber verpönt, da es einfach zu unübersichtlich ist. Falls man also aufgefordert wird die Konsolenausgabe oder eine Protokolldatei zu zeigen, sollte man einen Pastebin wie z.B. https://pastebin.com verwenden. Text dort hineinkopieren, Submit anklicken und den zurückgegebenen Link in den Chat kopieren, damit die anderen darauf zugreifen können.

Suche in Mailinglisten

Auch die Suche in den GnuCash-Mailinglisten mit Google oder einer anderen Suchmaschine kann hilfreich sein - wahrscheinlich ist schon jemand anderes zuvor über das Problem gestolpert. Und in der Zeit, in der Entwickler Fragen beantworten, können sie nun mal nicht entwickeln.

Da es zur Zeit - Herbst 2010 - Probleme mit dem Such-Index auf der GnuCash-Seite gibt, empfiehlt es sich die Google-Suche mit dem Parameter site:lists.gnucash.org oder in der erweiterten Google-Suche Domains Ausschließlich Antwortseiten von der Site oder Domain lists.gnucash.org zu verwenden.

Suche für Komponenten von Dritten

Für eigenständige Projekte wie

bitte deren jeweiliges System verwenden.

Suche im BugZilla

Dass ist das Verzeichnis für Fehlermeldungen und Verbesserungsvorschläge von GnuCash, egal, ob es das Programm oder die Dokumentation betrifft.

Ausnahme
Missstände in diesem Wiki sollten hier direkt behoben werden. Rechts oben einloggen oder —sofern noch nicht geschehen: Konto beantragen, auf Bestätigung warten - und loslegen.
Wichtiger Hinweis
Seit 1.7.2018 können keine neuen Fehlerberichte mehr in Gnomes Bugzilla erstellt werden. GnuCash hat seine Bugs daher in der Nacht von Freitag, dem 29. auf Samstag, den 30.06.2018 in eine selbst betriebene Instanz auf https://bugs.gnucash.org migriert.
  • Alle offenen GnuCash Bugs auf https://bugzilla.gnome.org wurden dann geschlossen als RESOLVED OBSOLETE und alle, offen oder geschlossen, erhielten einen Kommentar mit ihrer neuen URL.
  • Benutzerkonten einschließlich Email-Adressen wurden übertragen, aber keine Paßwörter oder Email-Beobachtungslisten. Benutzer, die sich bereits auf bugzilla.gnome.org registriert hatten, müssen daher einmalig ihr Paßwort über den Link Forgot Password rechts oben zurücksetzen. Beobachtungslisten, um dieselben Benachrichtigungen wie andere Benutzer - einschließlich der Pseudo-Benutzer aus Bugzilla#Configure Notifications - zu erhalten, müssen im Email Preferences-Reiter der persönlichen Einstellungen Preferences oben auf der Seite nach dem Einloggen neu erstellt werden.

Besonders, wenn man nicht die aktuellste Version verwendet, ist es sinnvoll, in einem 2. Durchgang die Einschränkungen des bug_status rauszunehmen, da der Fehler inzwischen behoben sein könnte.

Endlich: Fehler oder Verbesserungsvorschlag melden oder kommentieren

Häufig ist die Untersuchung von Fehlerberichten recht mühsam, weil der Berichterstatter für ihn selbstverständliche Informationen nicht mitliefert - Wieso, ich arbeite doch immer unter Betriebssystem XYZ, gibt's da etwa auch noch andere?. Trifft er damit auf einen gutgelaunten Freiwilligen, dann fragt der nach. Ist der selber gerade im Stress, wird die Meldung unter Umständen sogar ignoriert.

Ab Version 2.3 ist es auch hilfreich anzugeben, welches Backend verwendet wird - also was unter Datei speichern unter steht:

  • file: (XML-Datei, komprimiert oder nicht) oder
  • SQL: (MySQL/PGSQL/SQLite-Datenbank)

Daher sollte der Bericht möglichst alle der folgenden Angaben enthalten:

  • Ich benutze Gnucash Version <x.y.z> unter <Distribution> <a.b/Codename> <Betriebssystem> [<Version>] [mit Servicepack <j>] [mit den <relevante Zusatz>-Paketen aus dem Repositorium <wunderbar>] und speichere meine Daten in {[un]komprimierter XML-Datei|MySQL|PGSQL|SQLite}.
  • Wenn ich, nachdem ich <dies und das> gemacht habe, <Menü><Untermenü><Menüpunkt> öffne, <erscheinen kleine grüne Männchen>.
  • Ich hätte aber erwartet, dass <Engelchen Halleluja singen>.

Der Inhalt der <spitzen> Klammern ist dabei natürlich durch zutreffende Angaben zu ersetzen.

Zum Herausfinden der verwendeten Versionen gibt es, wie in den meisten modernen Programmen,

  • den Menüpunkt Hilfe->Über, sowie
  • die Befehlszeilenoptionen
    • -v als Abkürzung für
    • --version.

Falls man das Programm selbst gebaut hat, ist auch der Git-Hashwert oder zumindest der Zeitstempel der letzten Aktualisierung wichtig, da sich der Inhalt des Git-Repositorium ja sehr schnell ändern kann.

Oft ist es auch hilfreich, das Programm statt über das Startmenü oder eine andere Verknüpfung, direkt in einem Terminalfenster zu starten und das, was es dorthin schreibt, zu analysieren oder als Anhang mitzusenden.

In BugZilla

Bugzilla dient der Verwaltung von Fehlern und Verbesserungsvorschlägen.

Zunächst sollte man die dortige Suche verwenden, um herauszufinden, ob der Fehler schon bekannt ist.

Falls der Fehler schon bekannt ist, kann man durch weitere Kommentare die Informationen ergänzen, etwa "Der Fehler tritt nur bei abnehmendem Mond auf, nie bei zunehmendem". Damit hilft man den Entwicklern, den Fehler einzugrenzen. Am Besten ist es natürlich, gleich einen Patch einschicken. ;-)

Falls er noch nicht bekannt ist, meldet man ihn, am allerbesten auf Englisch, und zwar unter:

  • Falls für die Fehlersuche eine Gnucash-Datei eingeschickt werden soll, kann man den wirklichen Inhalt der Kopie einer unkomprimierten XML-Datei mit dem ObfuscateScript vernebeln.

Auf UserVoice

Seit Februar 2011 besteht auch die Möglichkeit, UserVoice für die Verwaltung von Verbesserungsvorschlägen zu nutzen.

Tip
Ganz unten auf der Seite kann man die Oberfläche auf Deutsch umstellen.

Auf der Mailingliste

Wer mit dem Englischen Probleme hat, kann auch auf der deutschen Mailing-Liste anfragen, ob jemand mit dem Übersetzen helfen kann. Dafür ist wegen der Spammer allerdings eine Anmeldung sinnvoll. Andernfalls landet die Mail in einer Warteschlange und muss erst von einem Moderator freigegeben werden.

Hier sollten auch Verbesserungen an spezifisch deutschsprachigen Komponenten wie Kontenrahmen und Übersetzung von Programm-Meldungen oder Dokumentationen eingereicht und diskutiert werden.

Im Betreff der Email sollte das Problem schon möglichst prägnant umrissen werden. Wer eine Email mit dem Betreff GnuCash oder Hilfe schickt, braucht sich nicht zu wundern, wenn er keine Antwort bekommt, da ein solcher Betreff niemanden vom Hocker reißt. Auch würde eine derartige Mail von Leidensgenossen desselben Problems bei der Mailinglistensuche nicht gefunden.

Antworten sollte man immer auch an die Liste - jedes Mailprogramm hat auch irgendwo im Menü verborgen Befehle wie "Allen antworten" und "An die Liste antworten". Wirklich nur ganz persönliche Nachrichten wie Einladung zum Kaffeetrinken sollten nicht an die Liste geschickt werden. Der vorherige Autor könnte nämlich nach Diktat verreist sein - dann liegt die Antwort wochenlang in seinem Posteingang rum und kein Schwein kümmert sich drum - oder andere Leute könnten noch bessere Ideen zu dem Problem haben.

Falls man sich die Gnucash-Mails täglich gebündelt zusenden lässt, ist es auch sinnvoll beim Antworten den Betreff auf die tatsächlich beantwortete Original-Mail anzupassen, also statt "Re: [gnucash-de] gnucash-de Nachrichtensammlung, Band 94, Eintrag 6" aus der betreffenden Nachricht die Subject-Zeile "Re: [gnucash-de] DTAUS" übernehmen.

Optional: Patch senden

Falls es bereits gelungen ist, das eigene Sytem zu verbessern, sind die Entwickler natürlich an einem Patch interessiert. Für diese am einfachsten zu handhaben sind

  • Pull-Requests auf GitHub, siehe Git.
  • Alternativ kann man den Patch auch an den entsprechenden Bugzilla-Eintrag hängen.
  • Das Einsenden als Anhang via Mailingliste ist im Prinzip auch möglich, birgt aber die Gefahr, dass er übersehen oder vergessen wird.
  • Direkt an einen Entwickler sollte man ihn wirklich nur nach expliziter Aufforderung senden.

Zurück zur Hauptseite