Add german tester's guide

3 files changed, 165 insertions, 2 deletions

diff --git a/doc/de/CMakeLists.txt b/doc/de/CMakeLists.txt
index 1a64f6742..38ba5c632 100644
--- a/doc/de/CMakeLists.txt
+++ b/doc/de/CMakeLists.txt
@@ -24,3 +24,14 @@ ADD_CUSTOM_COMMAND(
 )
 ADD_CUSTOM_TARGET(doc-quickstart-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html)
 INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.de.html DESTINATION share/doc/${PROJECT_NAME})
+
+# tester's guide
+ADD_CUSTOM_COMMAND(
+  OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="${VERSION}" -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.txt
+  DEPENDS
+  ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.txt
+  COMMENT "Building weechat_tester.de.html"
+)
+ADD_CUSTOM_TARGET(doc-tester-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html)
+INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html DESTINATION share/doc/${PROJECT_NAME})
diff --git a/doc/de/Makefile.am b/doc/de/Makefile.am
index 42e53bdab..50371edbc 100644
--- a/doc/de/Makefile.am
+++ b/doc/de/Makefile.am
@@ -17,14 +17,20 @@
 docdir = $(datadir)/doc/$(PACKAGE)
 
 EXTRA_DIST = CMakeLists.txt \
-		weechat_quickstart.de.txt
+		weechat_quickstart.de.txt \
+		weechat_tester.de.txt
 
-all-local: weechat_quickstart.de.html
+all-local: weechat_quickstart.de.html \
+		weechat_tester.de.html
 
 # quickstart
 weechat_quickstart.de.html: weechat_quickstart.de.txt
 	$(ASCIIDOC) -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_quickstart.de.html weechat_quickstart.de.txt
 
+# tester's guide
+weechat_tester.de.html: weechat_tester.de.txt
+	$(ASCIIDOC) -a toc -a toc_title='Inhaltsverzeichnis' -a date=`date "+%F"` -a revision="$(VERSION)" -n -o weechat_tester.de.html weechat_tester.de.txt
+
 # install docs
 
 install-data-hook:
diff --git a/doc/de/weechat_tester.de.txt b/doc/de/weechat_tester.de.txt
new file mode 100644
index 000000000..5d517a76c
--- /dev/null
+++ b/doc/de/weechat_tester.de.txt
@@ -0,0 +1,146 @@
+WeeChat Tester's Guide
+======================
+FlashCode <flashcode@flashtux.org>
+
+
+[[purpose]]
+Intention
+---------
+
+Viele dankbare Anwender fragen uns wie sie bei der Entwicklung von WeeChat
+helfen können. Der einfachste (aber auch der kniffligste) Weg uns zu helfen ist:
+Testen!
+
+Testen ist ein sehr wichtiger Teil der Programmentwicklung und sollte daher
+nicht unterbewertet werden. Wenn neue Features implementiert wurden, sollten sie
+getestet werden. Für einige Features gibt es aber zu viele Möglichkeiten - oder
+diese Möglichkeiten sind komplex und die Entwickler können nicht jede Variante
+ausprobieren.
+
+Ein Beispiel: Ein berüchtigtes Zeichensatz-Plugin wurde in WeeChat 0.2.2
+eingeführt: Keiner von uns (Entwickler, Mithelfende und Tester) nutzen Channels
+in den länderspezifische Zeichen in den Namen vorkamen, und als 0.2.2
+freigegeben wurde, wurden wir überschwemmt von russischen Usern, die uns dies
+vorwarfen. Hätten wir mehr Tester, dann  sollte so etwas nicht mehr passieren.
+
+Eine stabile Version von WeeChat zu testen ist nutzlos, da die Entwickler
+die ganze Zeit fleißig neues Zeug implementieren (und alte Bugs fixen).
+
+
+[[prepare_system]]
+Bereite Dein System vor
+-----------------------
+
+Sehr helfen würde uns, wenn Du Linuxs 'core' Dateien aktivieren würdest: wenn
+WeeChat crasht wird Linux eine Datei Namens 'core' erzeugen. Diese Datei
+beinhaltet viele nützliche Debug-Informationen um das genaue Problem in WeeChat
+zu lokalisieren.
+
+Falls Du die 'bash' als shell benutzt, ergänze Deine `~/.bashrc` mit folgender
+Zeile:
+
+  ulimit -c unlimited
+
+
+[[download]]
+Besorge Dir die Entwickler-Version
+----------------------------------
+
+Frischer Code (mit den letzten Bugs und Features) ist im GIT Repository
+gespeichert.
+
+Du könntest Dich ja dazu entscheiden es manuell zu bauen (empfohlen):
+
+* die GIT Version kann parallel zur stabilen Version gebaut und installiert
+  werden.
+* Du benötigst keine Root-Rechte, und opfern brauchst Du Deine stabile Version
+  von WeeChat auch nicht. 
+
+[[get_sources]]
+Beschaffe und baue die Quellen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Erstelle zuerst einen neuen Ordner, z.B. 'weechat-git':
+
+---------------------
+$ mkdir ~/weechat-git
+$ cd ~/weechat-git
+---------------------
+
+Falls Du git installiert hast, clone das git Repository (empfohlen):
+
+--------------------------------------------
+$ git clone git://git.sv.gnu.org/weechat.git
+$ cd weechat
+--------------------------------------------
+
+NOTE: Um auf den neuesten Stand zukommen verwendest Du z.B. "`git pull`" in
+diesem Ordner.
+
+Ansonsten kannst Du das 'Entwickler-Paket' herunterladen und entpacken:
+
+-----------------------------------------------------------------
+$ wget http://www.weechat.org/files/src/weechat-devel.tar.bz2
+$ tar xvjf weechat-devel.tar.bz2
+$ cd weechat-devel
+-----------------------------------------------------------------
+
+Um die Quellen zu übersetzen, wird cmake empfohlen:
+
+--------------------------------------------------------------
+$ mkdir build
+$ cd build
+$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug
+$ make
+$ make install
+--------------------------------------------------------------
+
+Falls Du cmake nicht hast, ist es auch möglich die autotools zu nutzen:
+
+----------------------------------------------------------
+$ ./autogen.sh       # (nur bei geklontem git Repository)
+$ ./configure --prefix=$HOME/weechat-git
+$ make
+$ make install
+----------------------------------------------------------
+
+[[install_binary_package]]
+Installieren des Programm-Paketes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Abhängig Deiner Linux Distribution:
+
+* Debian: http://debian.flashtux.org/
+* Gentoo: http://www.weechat.org/download
+* ArchLinux: PKGBUILD von http://aur.archlinux.org/
+* andere: Wissen wir nicht! Eheh.
+
+
+[[run]]
+WeeChat starten
+---------------
+
+Es wird empfohlen WeeChat durch die Option `--dir` mit einem anderen Ordner zu
+starten (nicht mit dem der stabilen Version).
+
+Die Befehlszeile lautet:
+
+  ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev
+
+Immer noch munter? Dann solltest Du jetzt das bekannte Interface sehen, und nun
+prahle vor Anderen, dass Du die neueste WeeChat-Version verwendest :)
+
+Solltest Du nun ein merkwürdiges Verhalten bemerken (es könnte Probleme machen
+oder crashen oder Dein Bier kochen) zögere nicht, komme in den Channel
+`#weechat` auf `irc.freenode.net` (A.d.Ü.: englischsprachig) und berichte uns
+darüber.
+
+Auch wenn es nicht crasht - gib uns trotzdem Bescheid, wir brauchen Deine
+Rückmeldung!
+
+[[links]]
+Nützliche Links
+---------------
+
+* GIT repository: http://git.savannah.gnu.org/gitweb/?p=weechat.git
+* Bug tracker: https://savannah.nongnu.org/bugs/?group=weechat
+* WeeChat commits RSS feed: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss