diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/de/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/de/Makefile.am | 8 | ||||
| -rw-r--r-- | doc/de/weechat_tester.de.adoc | 148 | ||||
| -rw-r--r-- | doc/en/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/en/Makefile.am | 6 | ||||
| -rw-r--r-- | doc/en/weechat_dev.en.adoc | 1 | ||||
| -rw-r--r-- | doc/en/weechat_tester.en.adoc | 131 | ||||
| -rw-r--r-- | doc/fr/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/fr/Makefile.am | 6 | ||||
| -rw-r--r-- | doc/fr/weechat_dev.fr.adoc | 1 | ||||
| -rw-r--r-- | doc/fr/weechat_tester.fr.adoc | 138 | ||||
| -rw-r--r-- | doc/it/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/it/Makefile.am | 8 | ||||
| -rw-r--r-- | doc/it/weechat_tester.it.adoc | 144 | ||||
| -rw-r--r-- | doc/ja/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/ja/Makefile.am | 6 | ||||
| -rw-r--r-- | doc/ja/weechat_dev.ja.adoc | 1 | ||||
| -rw-r--r-- | doc/ja/weechat_tester.ja.adoc | 135 | ||||
| -rw-r--r-- | doc/pl/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/pl/Makefile.am | 8 | ||||
| -rw-r--r-- | doc/pl/weechat_tester.pl.adoc | 139 | ||||
| -rw-r--r-- | doc/sr/CMakeLists.txt | 13 | ||||
| -rw-r--r-- | doc/sr/Makefile.am | 6 | ||||
| -rw-r--r-- | doc/sr/weechat_dev.sr.adoc | 1 | ||||
| -rw-r--r-- | doc/sr/weechat_tester.sr.adoc | 120 |
25 files changed, 3 insertions, 1095 deletions
diff --git a/doc/de/CMakeLists.txt b/doc/de/CMakeLists.txt index 7b3212df6..b736e0243 100644 --- a/doc/de/CMakeLists.txt +++ b/doc/de/CMakeLists.txt @@ -107,17 +107,4 @@ if(ENABLE_DOC) 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 ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.de.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.de.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.de.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - 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 ${DATAROOTDIR}/doc/${PROJECT_NAME}) - endif() diff --git a/doc/de/Makefile.am b/doc/de/Makefile.am index 9faf37b5a..4da7fb9fe 100644 --- a/doc/de/Makefile.am +++ b/doc/de/Makefile.am @@ -28,7 +28,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.de.adoc \ weechat_faq.de.adoc \ weechat_quickstart.de.adoc \ - weechat_tester.de.adoc \ includes/autogen_api_completions.de.adoc \ includes/autogen_api_hdata.de.adoc \ includes/autogen_api_infolists.de.adoc \ @@ -53,8 +52,7 @@ if DOC doc_targets = weechat_user.de.html \ weechat_scripting.de.html \ weechat_faq.de.html \ - weechat_quickstart.de.html \ - weechat_tester.de.html + weechat_quickstart.de.html doc_install = install-doc doc_uninstall = uninstall-doc endif @@ -82,10 +80,6 @@ weechat_faq.de.html: weechat_faq.de.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.de.html: weechat_quickstart.de.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.de.html $(abs_top_srcdir)/doc/de/weechat_quickstart.de.adoc -# tester's guide -weechat_tester.de.html: weechat_tester.de.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.de.html $(abs_top_srcdir)/doc/de/weechat_tester.de.adoc - # install man/docs install-data-hook: $(man_install) $(doc_install) diff --git a/doc/de/weechat_tester.de.adoc b/doc/de/weechat_tester.de.adoc deleted file mode 100644 index 3761523c6..000000000 --- a/doc/de/weechat_tester.de.adoc +++ /dev/null @@ -1,148 +0,0 @@ -= WeeChat Anleitung für Testpersonen -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: de -:toc: left -:toc-title: Inhaltsverzeichnis -:sectnums: -:docinfo1: - - -Übersetzer: - -* Juergen Descher <jhdl@gmx.net>, 2009 -* Nils Görs <weechatter@arcor.de>, 2009-2016 - - -[[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 Funktionen implementiert wurden dann -müssen diese getestet werden. Für manche Funktionen gibt es sehr viele -verschiedene Problemstellungen, oder diese sind äußerst Umfangreich. Dadurch -können die Entwickler nicht jede einzelne Variante ausprobieren. - -Ein Beispiel: Eine berüchtigte Zeichensatz-Erweiterung wurde in WeeChat 0.2.2 -eingeführt. Keiner von uns, Entwickler, Mithelfende und Tester, nutzten Channels -in denen länderspezifische Zeichen im eigenen Namen Verwendung fanden. Somit wurde -die Version 0.2.2 freigegeben und wir bekamen daraufhin eine Flut von Beschwerden -durch russischen User, bei denen der Fehler sichtbar war. Hätten wir mehr Tester, -dann sollte so etwas nicht mehr passieren. - -Eine stabile Version von WeeChat zu testen bringt uns leider nicht weiter da die -Entwickler in der Zwischenzeit neue Funktionen implementiert haben und vermutlich -alte Fehler schon behoben wurden. - - -[[prepare_system]] -== Bereite Dein System vor - -Es wäre uns schon sehr damit geholfen wenn Du Linux _core_ Dateien aktivieren würdest. -Falls WeeChat abstürzen sollte wird eine Datei Namens _core_ erzeugt. Diese Datei -beinhaltet viele nützliche Debug-Informationen um das genaue Problem in WeeChat -zu lokalisieren. - -Falls Du die _bash_ als shell benutzt, dann ergänze Deine _~/.bashrc_ durch folgende -Zeile: - ----- -ulimit -c unlimited ----- - - -[[download]] -== Besorge Dir die Entwickler-Version - -aktueller Programmcode (mit den aktuellen Fehlern und Funktionen) ist im GIT Repository -gespeichert. - -Du könntest Dich dazu entscheiden es manuell zu bauen (empfohlen): - -* die GIT Version kann parallel zur stabilen Version kompiliert 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 https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -Um auf den aktuellen Stand zu kommen verwendest Du z.B. `git pull` in -diesem Ordner. - -Ansonsten kannst Du das _Entwickler-Paket_ herunterladen und entpacken: - ----- -$ wget https://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 .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -Falls Du CMake nicht hast, ist es auch möglich die autotools zu nutzen: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Installieren des Programm-Paketes - -Abhängig Deiner Linux Distribution: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: PKGBUILD von https://aur.archlinux.org/ -* andere: Wissen wir nicht! Eheh. - - -[[run]] -== WeeChat starten - -Die Befehlszeile lautet: - ----- -$ ~/weechat-git/bin/weechat ----- - -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önnen diverse Probleme -oder Abstürze auftreten oder einfach Dein Bier überkochen) zögere nicht, komme -in den Channel _#weechat_ auf _irc.libera.chat_ (A.d.Ü.: englischsprachig) und -berichte uns darüber. - -Auch falls alles korrekt funktionieren sollte gib uns trotzdem Bescheid, wir -brauchen Deine Rückmeldung! diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt index 5300ffb2c..c227679eb 100644 --- a/doc/en/CMakeLists.txt +++ b/doc/en/CMakeLists.txt @@ -122,19 +122,6 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.en.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.en.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.en.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.en.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.en.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.en.html" - ) - add_custom_target(doc-tester-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.en.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.en.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # relay protocol add_custom_command( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.en.html diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am index f94616f45..3fe34c092 100644 --- a/doc/en/Makefile.am +++ b/doc/en/Makefile.am @@ -29,7 +29,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.en.adoc \ weechat_faq.en.adoc \ weechat_quickstart.en.adoc \ - weechat_tester.en.adoc \ weechat_relay_protocol.en.adoc \ weechat_dev.en.adoc \ includes/autogen_api_completions.en.adoc \ @@ -58,7 +57,6 @@ if DOC weechat_scripting.en.html \ weechat_faq.en.html \ weechat_quickstart.en.html \ - weechat_tester.en.html \ weechat_relay_protocol.en.html \ weechat_dev.en.html doc_install = install-doc @@ -92,10 +90,6 @@ weechat_faq.en.html: weechat_faq.en.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.en.html: weechat_quickstart.en.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.en.html $(abs_top_srcdir)/doc/en/weechat_quickstart.en.adoc -# tester's guide -weechat_tester.en.html: weechat_tester.en.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.en.html $(abs_top_srcdir)/doc/en/weechat_tester.en.adoc - # relay protocol weechat_relay_protocol.en.html: weechat_relay_protocol.en.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.en.html $(abs_top_srcdir)/doc/en/weechat_relay_protocol.en.adoc diff --git a/doc/en/weechat_dev.en.adoc b/doc/en/weechat_dev.en.adoc index 53617e6a7..5326a7d49 100644 --- a/doc/en/weechat_dev.en.adoc +++ b/doc/en/weechat_dev.en.adoc @@ -465,7 +465,6 @@ Documentation files: | weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide]. | weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol] (for remote interfaces). | weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide]. -| weechat_tester.XX.adoc | link:weechat_tester.en.html[Tester's guide]. | weechat_user.XX.adoc | link:weechat_user.en.html[User's guide]. | includes/ | Files included in documentation. | autogen_api_completions.XX.adoc | Auto-generated file for Plugin API reference: completions (do *NEVER* update manually!). diff --git a/doc/en/weechat_tester.en.adoc b/doc/en/weechat_tester.en.adoc deleted file mode 100644 index 18094ff2a..000000000 --- a/doc/en/weechat_tester.en.adoc +++ /dev/null @@ -1,131 +0,0 @@ -= WeeChat tester's guide -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: en -:toc: left -:sectnums: -:docinfo1: - - -[[purpose]] -== Purpose - -Many thankful users ask us how can they help developing WeeChat. The -easiest (and also most tricky) way to help developing WeeChat is testing! - -Testing is a very important part of software development and should not be -underestimated. When some features are implemented it should be tested, but for -some features there are too many use cases or these cases are tricky and -developers can't try out every case. - -For example: A notorious charset plugin was introduced in WeeChat 0.2.2: none -of us (developers, contributors and testers) used channels with national -characters in their names and when 0.2.2 was released we got flooded by Russian -users blaming us. If we have more testers it should not happen again in the -future. - -Testing the stable version of WeeChat is pointless because developers are busy -implementing new stuff (and fixing old bugs) all the time. - - -[[prepare_system]] -== Prepare your system - -It would help us a lot if you enable Linux _core_ files: if WeeChat crashes, -Linux will write a file called _core_. This file contains very useful debug -info, to know exactly where is problem in WeeChat. - -If you're using the _bash_ shell, add following line to your _~/.bashrc_: - ----- -ulimit -c unlimited ----- - - -[[download]] -== Download devel version - -Fresh code (with latest bugs and features) is stored in a GIT repository. - -You may decide to build it manually (recommended way): - -* The GIT version can be built and installed in parallel to the stable version. -* You don't need root access, and you don't need to sacrifice the stable - version of WeeChat. - -[[get_sources]] -=== Get and build sources - -First create a directory, for example _weechat-git_: - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -If you have git installed, you can just clone the git repository (recommended -way): - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -Later, you can run `git pull` in this directory, to get deltas with -the latest updates. - -Otherwise you can download and unpack _devel_ package: - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -To build sources, CMake is recommended: - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -If you don't have CMake, it's still possible to use autotools: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Install binary package - -According to your Linux distribution: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: PKGBUILD from https://aur.archlinux.org/ -* other: we don't know! Eheh. - - -[[run]] -== Run WeeChat - -Command is: - ----- -$ ~/weechat-git/bin/weechat ----- - -If you're still awake you should see the familiar interface and brag about -having the newest possible version of WeeChat. ;) - -Now if you experience strange behavior (it may have issues or crash or boil -your beer) don't hesitate to join _#weechat_ at _irc.libera.chat_ and tell us. - -If it doesn't crash - tell us too, we need your feedback! diff --git a/doc/fr/CMakeLists.txt b/doc/fr/CMakeLists.txt index 635376382..6a0ad26c8 100644 --- a/doc/fr/CMakeLists.txt +++ b/doc/fr/CMakeLists.txt @@ -122,19 +122,6 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.fr.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.fr.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.fr.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.fr.html" - ) - add_custom_target(doc-tester-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # relay protocol add_custom_command( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.fr.html diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am index 24b84a780..c0664e693 100644 --- a/doc/fr/Makefile.am +++ b/doc/fr/Makefile.am @@ -29,7 +29,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.fr.adoc \ weechat_faq.fr.adoc \ weechat_quickstart.fr.adoc \ - weechat_tester.fr.adoc \ weechat_relay_protocol.fr.adoc \ weechat_dev.fr.adoc \ includes/autogen_api_completions.fr.adoc \ @@ -58,7 +57,6 @@ if DOC weechat_scripting.fr.html \ weechat_faq.fr.html \ weechat_quickstart.fr.html \ - weechat_tester.fr.html \ weechat_relay_protocol.fr.html \ weechat_dev.fr.html doc_install = install-doc @@ -92,10 +90,6 @@ weechat_faq.fr.html: weechat_faq.fr.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.fr.html: weechat_quickstart.fr.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.fr.html $(abs_top_srcdir)/doc/fr/weechat_quickstart.fr.adoc -# tester's guide -weechat_tester.fr.html: weechat_tester.fr.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.fr.html $(abs_top_srcdir)/doc/fr/weechat_tester.fr.adoc - # relay protocol weechat_relay_protocol.fr.html: weechat_relay_protocol.fr.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.fr.html $(abs_top_srcdir)/doc/fr/weechat_relay_protocol.fr.adoc diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc index 1303af54c..472caa5d6 100644 --- a/doc/fr/weechat_dev.fr.adoc +++ b/doc/fr/weechat_dev.fr.adoc @@ -467,7 +467,6 @@ Fichiers de documentation : | weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage]. | weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay (pour les interfaces distantes)]. | weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts]. -| weechat_tester.XX.adoc | link:weechat_tester.fr.html[Guide du testeur]. | weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur]. | includes/ | Fichiers inclus dans la documentation. | autogen_api_completions.XX.adoc | Fichier auto-généré pour la Référence API extension : complétions (ne *JAMAIS* mettre à jour manuellement !). diff --git a/doc/fr/weechat_tester.fr.adoc b/doc/fr/weechat_tester.fr.adoc deleted file mode 100644 index 8aba356be..000000000 --- a/doc/fr/weechat_tester.fr.adoc +++ /dev/null @@ -1,138 +0,0 @@ -= Guide du testeur WeeChat -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: fr -:toc: left -:toc-title: Table des matières -:sectnums: -:docinfo1: - - -[[purpose]] -== Objet - -Beaucoup d'utilisateurs nous demandent comment aider WeeChat. La façon -la plus facile (et aussi la plus rusée) consiste à le tester ! - -Le test est une partie très importante du développement de logiciel et -ne devrait pas être sous-estimé. Lorsque de nouvelles fonctionnalités -sont implémentées, elles doivent être testées, mais pour certaines -fonctionnalités il y a trop de cas à tester et les développeurs ne -peuvent pas tout tester. - -Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun -de nous (développeurs, contributeurs et testeurs) n'utilisait de canaux avec -des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue -disponible, nous avons reçu de nombreuses remontées d'utilisateurs russes. -Si nous avons plus de testeurs, cela ne devrait pas arriver à nouveau dans le -futur. - -Tester les versions stables de WeeChat est inutile car les -développeurs sont constamment occupés à implémenter de nouvelles -fonctionnalités (et à corriger des anciens bugs). - - -[[prepare_system]] -== Préparez votre système - -Cela nous aiderait beaucoup si vous activiez les fichiers _core_ Linux : si -WeeChat se plante, Linux écrit un fichier _core_. Ce fichier contient des -informations importantes pour le debug, pour savoir exactement où le problème -se situe dans WeeChat). - -Si vous utilisez le shell _bash_, ajoutez cette ligne dans votre _~/.bashrc_ : - ----- -ulimit -c unlimited ----- - - -[[download]] -== Téléchargement de la version devel - -Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans -GIT. - -Vous pouvez décider de le construire manuellement (méthode recommandée) : - -* La version GIT peut être construite et installée en parallèle de la version - stable, -* Vous n'avez pas besoin d'accès root ni de sacrifier votre version stable de - WeeChat. - -[[get_sources]] -=== Obtenir et compiler les sources - -Créez tout d'abord un répertoire, par exemple _weechat-git_ : - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) : - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -Plus tard, vous pourrez utiliser la commande `git pull` dans ce répertoire -pour obtenir juste les deltas avec la version d'aujourd'hui. - -Sinon vous pouvez installer le paquet _devel_ : - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -Pour compiler les sources, CMake est recommandé : - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -Si vous n'avez pas CMake, il est toujours possible d'utiliser les autotools : - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Obtenir un paquet binaire - -Selon votre distribution Linux : - -* Debian : https://weechat.org/download/debian -* Gentoo : https://weechat.org/download -* ArchLinux : PKGBUILD depuis https://aur.archlinux.org/ -* autre : nous ne savons pas ! Eheh. - - -[[run]] -== Lancer WeeChat - -La commande est : - ----- -$ ~/weechat-git/bin/weechat ----- - -Si vous êtes encore éveillé, vous devriez voir une interface familière et -pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;) - -Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez -pas à nous en avertir sur _#weechat_, serveur _irc.libera.chat_. - -S'il n'y a pas de plantage, dites-le nous aussi, nous avons besoin de votre -retour et de vos impressions ! diff --git a/doc/it/CMakeLists.txt b/doc/it/CMakeLists.txt index 27ce9abbe..7368a3236 100644 --- a/doc/it/CMakeLists.txt +++ b/doc/it/CMakeLists.txt @@ -122,17 +122,4 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.it.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.it.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.it.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.it.html" - ) - add_custom_target(doc-tester-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.it.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - endif() diff --git a/doc/it/Makefile.am b/doc/it/Makefile.am index fe46d0566..84d82e423 100644 --- a/doc/it/Makefile.am +++ b/doc/it/Makefile.am @@ -28,7 +28,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.it.adoc \ weechat_faq.it.adoc \ weechat_quickstart.it.adoc \ - weechat_tester.it.adoc \ includes/autogen_api_completions.it.adoc \ includes/autogen_api_hdata.it.adoc \ includes/autogen_api_infolists.it.adoc \ @@ -54,8 +53,7 @@ if DOC weechat_plugin_api.it.html \ weechat_scripting.it.html \ weechat_faq.it.html \ - weechat_quickstart.it.html \ - weechat_tester.it.html + weechat_quickstart.it.html doc_install = install-doc doc_uninstall = uninstall-doc endif @@ -87,10 +85,6 @@ weechat_faq.it.html: weechat_faq.it.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.it.html: weechat_quickstart.it.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.it.html $(abs_top_srcdir)/doc/it/weechat_quickstart.it.adoc -# tester's guide -weechat_tester.it.html: weechat_tester.it.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.it.html $(abs_top_srcdir)/doc/it/weechat_tester.it.adoc - # install man/docs install-data-hook: $(man_install) $(doc_install) diff --git a/doc/it/weechat_tester.it.adoc b/doc/it/weechat_tester.it.adoc deleted file mode 100644 index efd8fab54..000000000 --- a/doc/it/weechat_tester.it.adoc +++ /dev/null @@ -1,144 +0,0 @@ -= Guida al Tester di WeeChat -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: it -:toc: left -:toc-title: Indice -:sectnums: -:docinfo1: - - -// TRANSLATION MISSING -Translators: - -* Marco Paolone <marcopaolone@gmail.com>, 2009-2012 - - -[[purpose]] -== Scopo - -Molti utenti riconoscenti chiedono come possono aiutare nello sviluppo -di WeeChat. Il modo più semplice (ed anche più delicato) per aiutare -lo sviluppo di WeeChat è il testing! - -Il testing è una parte davvero importante dello sviluppo software e non -può essere sottovalutato. Quando vengono implementate alcune -funzionalità dovrebbero essere testate, ma per alcune di esse esistono -troppi casi di utilizzo o questi casi sono delicati e gli sviluppatori non -possono verificarli uno ad uno. - -Per esempio: È stato introdotto un famigerato set di caratteri in WeeChat 0.2.2: -nessuno di noi (sviluppatori, contributori e tester) utilizzava canali con lettere -dell'alfabeto nazionale nei loro nomi e quando è stata rilasciata la 0.2.2 siamo -stati inondati dagli utenti russi. Se avessimo più tester non dovrebbe più -accadere in futuro. - -Testare la versione stabile di WeeChat è inutile poiché gli sviluppatori sono -occupati nell'implementazione di nuove funzionalità (e nella correzione di -vecchi bug). - - -[[prepare_system]] -== Preparazione del sistema - -Sarebbe molto di aiuto abilitare i file _core_ di Linux: se WeeChat -dovesse andare in crash, Linux scriverebbe un file chiamato _core_. -Questo file contiene informazioni di debug molto utili, per sapere -esattamente dove sia il problema in WeeChat. - -Se si utilizza la shell _bash_, aggiungere la seguente riga al file _~/.bashrc_: - ----- -ulimit -c unlimited ----- - - -[[download]] -== Download della versione di sviluppo - -Il codice più fresco (con gli ultimi bug e le funzionalità più recenti) è -conservato in un deposito GIT. - -È possibile compilarlo manualmente (raccomandato): - -* La versione GIT può essere compilata ed installata parallelamente alla -* versione stabile, non è necessario l'accesso da root né sacrificare la - versione stabile di WeeChat. - -[[get_sources]] -=== Ottenere e compilare i sorgenti - -Per prima cosa creare una directory, per esempio _weechat-git_: - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -Se si ha git installato, si può clonare il deposito git (raccomandato): - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -In seguito, si può eseguire `git pull` in questa directory per ricevere gli -ultimi aggiornamenti. - -Altrimenti si può scaricare ed estrarre il pacchetto _devel_: - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -Per compilare i sorgenti, si raccomanda CMake: - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -Se CMake non è installato, è ancora possibile usare gli autotools: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Installazione del pacchetto binario - -A seconda della distribuzione Linux: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: PKGBUILD da https://aur.archlinux.org/ -* altro: non lo sappiamo! Eheh. - - -[[run]] -== Eseguire WeeChat - -Il comando è: - ----- -$ ~/weechat-git/bin/weechat ----- - -Se siete ancora svegli dovreste vedere un'interfaccia familiare e vantarvi del -fatto di avere la versione più nuova possibile di WeeChat. ;) - -Se si dovessero verificare strani comportamenti (potrebbe andare in crash -o far bollire la vostra birra) non esitate ad entrare in _#weechat_ su -_irc.libera.chat_ e farcelo sapere. - -Se non dovesse andare in crash - ditelo comunque, abbiamo bisogno dei vostri -commenti! diff --git a/doc/ja/CMakeLists.txt b/doc/ja/CMakeLists.txt index c5700fcf5..b6ed0184b 100644 --- a/doc/ja/CMakeLists.txt +++ b/doc/ja/CMakeLists.txt @@ -122,19 +122,6 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.ja.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.ja.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.ja.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.ja.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.ja.html" - ) - add_custom_target(doc-tester-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.ja.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # relay protocol add_custom_command( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.ja.html diff --git a/doc/ja/Makefile.am b/doc/ja/Makefile.am index bbeb94029..1432506cb 100644 --- a/doc/ja/Makefile.am +++ b/doc/ja/Makefile.am @@ -28,7 +28,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.ja.adoc \ weechat_faq.ja.adoc \ weechat_quickstart.ja.adoc \ - weechat_tester.ja.adoc \ weechat_relay_protocol.ja.adoc \ weechat_dev.ja.adoc \ includes/autogen_api_completions.ja.adoc \ @@ -57,7 +56,6 @@ if DOC weechat_scripting.ja.html \ weechat_faq.ja.html \ weechat_quickstart.ja.html \ - weechat_tester.ja.html \ weechat_relay_protocol.ja.html \ weechat_dev.ja.html doc_install = install-doc @@ -91,10 +89,6 @@ weechat_faq.ja.html: weechat_faq.ja.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.ja.html: weechat_quickstart.ja.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.ja.html $(abs_top_srcdir)/doc/ja/weechat_quickstart.ja.adoc -# tester's guide -weechat_tester.ja.html: weechat_tester.ja.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.ja.html $(abs_top_srcdir)/doc/ja/weechat_tester.ja.adoc - # relay protocol weechat_relay_protocol.ja.html: weechat_relay_protocol.ja.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.ja.html $(abs_top_srcdir)/doc/ja/weechat_relay_protocol.ja.adoc diff --git a/doc/ja/weechat_dev.ja.adoc b/doc/ja/weechat_dev.ja.adoc index f9b8e4d39..81ef385db 100644 --- a/doc/ja/weechat_dev.ja.adoc +++ b/doc/ja/weechat_dev.ja.adoc @@ -509,7 +509,6 @@ WeeChat "core" は以下のディレクトリに配置されています: | weechat_quickstart.XX.adoc | link:weechat_quickstart.ja.html[クイックスタートガイド] | weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.ja.html[リレープロトコル] (リモートインターフェース用) | weechat_scripting.XX.adoc | link:weechat_scripting.ja.html[スクリプト作成ガイド] -| weechat_tester.XX.adoc | link:weechat_tester.ja.html[テスターガイド] | weechat_user.XX.adoc | link:weechat_user.ja.html[ユーザーズガイド] // TRANSLATION MISSING | includes/ | Files included in documentation. diff --git a/doc/ja/weechat_tester.ja.adoc b/doc/ja/weechat_tester.ja.adoc deleted file mode 100644 index e48137460..000000000 --- a/doc/ja/weechat_tester.ja.adoc +++ /dev/null @@ -1,135 +0,0 @@ -= WeeChat テスターガイド -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: ja-jp -:toc: left -:toc-title: 目次 -:sectnums: -:docinfo1: - - -翻訳者: - -* Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>, 2012-2019 - - -[[purpose]] -== 目的 - -WeeChat -開発への協力に興味を持っていただきありがとうございます。開発に協力する最も簡単 -(で最も大変) な方法はテストです! - -テストはソフトウェア開発においてとても重要で、疎かにできないものです。何か新しい機能が実装されたらその機能はテストされるべきです。しかし、機能によっては使用条件が広すぎるか使用条件が特殊過ぎるため、開発チームが全ての条件をテストできない場合があります。 - -例: WeeChat 0.2.2 で導入された charset プラグインは悪名高いものでした: -開発チームにはチャンネル名に各国語を使うユーザー -(開発者、貢献者、テスター) -がいなかったため、0.2.2 -がリリースされると、チームを非難するロシア人ユーザが殺到しました。より多くのテスターがいれば、今後そのようなことはおきないでしょう。 - -開発者は新機能の実装 (と古いバグの修正) に忙しいので、WeeChat -安定版をテストすることは意味がありません。 - - -[[prepare_system]] -== システムの準備 - -Linux の _core_ ファイルを有効にすることはとても役に立ちます: WeeChat -がクラッシュすると、Linux は _core_ と呼ばれるファイルを作ります。このファイルには、WeeChat -に問題の有る箇所を正確に示す、とても役立つデバッグ情報が含まれています。 - -_bash_ シェルを使っている場合、以下の行を _~/.bashrc_ に追記してください: - ----- -ulimit -c unlimited ----- - - -[[download]] -== 開発版のダウンロード - -最新のコード (最新のバグと最新の機能も含んでいますが) は GIT リポジトリにあります。 - -手作業で最新のコードをビルドすることができます (推奨): - -* GIT 版は安定版と共存してビルド、インストールできます。 -* root 権限は必要ありません、WeeChat - 安定版を捨てる必要もありません。 - -[[get_sources]] -=== ソースの取得とビルド - -最初にディレクトリを作ってください、ここでは _weechat-git_: - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -git がインストール済みの場合、git -リポジトリを clone してください (推奨): - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -clone の後、このディレクトリ内で `git pull` -を実行すれば、最新のアップデートとの差分が更新されます。 - -他の方法として _devel_ パッケージをダウンロードして展開する方法があります: - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -ソースをビルドするには CMake を使うことを推奨します: - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -CMake が無い場合は autotools を使うことも可能です: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== バイナリパッケージのインストール - -Linux ディストリビューション別に: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: https://aur.archlinux.org/ から PKGBUILD -* その他: 知らないよ! てへぺろ(・ω<) - - -[[run]] -== WeeChat の実行 - -コマンド: - ----- -$ ~/weechat-git/bin/weechat ----- - -より万全を期すなら、上の方法を使って WeeChat -の最新バージョンを使っていることを確認するべきです ;) - -おかしな (問題を引き起こしたり、クラッシュしたり、あなたを怒らせるような) 挙動を見つけたら -_irc.libera.chat_ の _#weechat_ に参加して、開発チームにこの挙動を教えてください。 - -クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています! diff --git a/doc/pl/CMakeLists.txt b/doc/pl/CMakeLists.txt index bcb548231..aab051457 100644 --- a/doc/pl/CMakeLists.txt +++ b/doc/pl/CMakeLists.txt @@ -107,17 +107,4 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.pl.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.pl.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.pl.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.pl.html" - ) - add_custom_target(doc-tester-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.pl.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - endif() diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am index 03543290b..a16afd98f 100644 --- a/doc/pl/Makefile.am +++ b/doc/pl/Makefile.am @@ -28,7 +28,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.pl.adoc \ weechat_faq.pl.adoc \ weechat_quickstart.pl.adoc \ - weechat_tester.pl.adoc \ includes/autogen_api_completions.pl.adoc \ includes/autogen_api_hdata.pl.adoc \ includes/autogen_api_infolists.pl.adoc \ @@ -53,8 +52,7 @@ if DOC doc_targets = weechat_user.pl.html \ weechat_scripting.pl.html \ weechat_faq.pl.html \ - weechat_quickstart.pl.html \ - weechat_tester.pl.html + weechat_quickstart.pl.html doc_install = install-doc doc_uninstall = uninstall-doc endif @@ -82,10 +80,6 @@ weechat_faq.pl.html: weechat_faq.pl.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.pl.html: weechat_quickstart.pl.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.pl.html $(abs_top_srcdir)/doc/pl/weechat_quickstart.pl.adoc -# tester's guide -weechat_tester.pl.html: weechat_tester.pl.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.pl.html $(abs_top_srcdir)/doc/pl/weechat_tester.pl.adoc - # install man/docs install-data-hook: $(man_install) $(doc_install) diff --git a/doc/pl/weechat_tester.pl.adoc b/doc/pl/weechat_tester.pl.adoc deleted file mode 100644 index 4ef9ca26d..000000000 --- a/doc/pl/weechat_tester.pl.adoc +++ /dev/null @@ -1,139 +0,0 @@ -= Poradnik testera WeeChat -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: pl -:toc: left -:toc-title: Spis treści -:sectnums: -:docinfo1: - - -Tłumaczenie: - -* Krzysztof Korościk <soltys1@gmail.com>, 2009-2016 - - -[[purpose]] -== Cel - -Wielu wdzięcznych użytkowników pyta nas jak mogą pomóc w rozwoju WeeChat. -Najłatwiejszym (a zarazem najtrudniejszym) sposobem jest testowanie! - -Testowanie jest bardzo ważną częścią rozwoju oprogramowania i nie powinno być -niedoceniane. Kiedy nowe funkcje są implementowane, powinny zostać przetestowane, -ale dla wielu z nich jest za dużo możliwości użycia lub nie są łatwe do -za symulowania dlatego programiści nie są wstanie sprawdzić ich wszystkich. - -Na przykład: Powszechnie znana wtyczka od kodowania została wprowadzona w -WeeChat 0.2.2: żaden z nas (programistów, współpracowników, testerów) nie -używał kanałów ze znakami narodowymi w nazwach, kiedy wersja 0.2.2 została -wypuszczona zostaliśmy zalani użytkownikami z Rosji obwiniającymi nas. -Gdy będziemy mieli więcej testerów taka sytuacja nie powinna się już zdarzyć -w przyszłości. - -Testowanie stabilnej wersji WeeChat jest bezcelowe, ponieważ programiści są -zajęci cały czas implementowaniem nowych rzeczy (oraz poprawianiem błędów). - - -[[prepare_system]] -== Przygotuj swój system - -Bardzo nam pomoże, jeśli włączysz linuksowe pliki _core_: jeśli WeeChat zawiesi -się Linux zapisze plik zwany _core_. Plik ten zawiera użyteczne informacje -pozwalające dokładnie zlokalizować błąd w WeeChat. - -Jeśli korzystasz z powłoki _bash_, dodaj następującą linijkę do _~/.bashrc_: - ----- -ulimit -c unlimited ----- - - -[[download]] -== Pobieranie wersji rozwojowej - -Świeży kod (z najnowszymi błędami i funkcjami) przechowywany jest w repozytorium GIT. - -Możesz się zdecydować na własnoręczne zbudowanie (zalecana metoda): - -* wersja z GIT może być zbudowana i zainstalowana równolegle z wersją stabilną, -* nie potrzebujesz uprawnień administratora, oraz nie musisz poświęcać stabilnej - wersji WeeChat. - -[[get_sources]] -=== Pobierz i zbuduj źródła - -Najpierw stwórz katalog, na przykład _weechat-git_: - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -Jeśli masz zainstalowanego gita, po prostu sklonuj repozytorium (zalecana -metoda): - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -Później możesz wykonać w tym katalogu `git pull`, aby pobrać najnowsze -poprawki. - -Oczywiście możesz pobrać paczkę oznaczoną jako _devel_: - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -Do zbudowania źródeł zaleca się CMake: - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -Jeśli nie posiadasz CMake, nadal jest możliwe użycie autotools: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Instalowanie pakietów binarnych - -W zależności od dystrybucji Linuksa: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: PKGBUILD z https://aur.archlinux.org/ -* inne: nie mamy pojęcia! Eheh. - - -[[run]] -== Uruchomienie WeeChat - -Komenda to: - ----- -$ ~/weechat-git/bin/weechat ----- - -Jeśli nadal nie śpisz powinieneś ujrzeć znajomy interfejs i chwalić się -z posiadania najnowszej możliwej wersji WeeChat. ;) - -Teraz jeśli zaobserwujesz dziwne zachowanie (może sprawiać problemy, ulec awarii -lub zagotować Twoje piwo) nie wahaj się wejść na kanał _#weechat_ na serwerze -_irc.libera.chat_ i nam o tym opowiedzieć. - -Jeśli wszystko będzie w porządku - też nam o tym powiedz, potrzebujemy Twojej opinii! diff --git a/doc/sr/CMakeLists.txt b/doc/sr/CMakeLists.txt index e13bbe3a4..4d039295b 100644 --- a/doc/sr/CMakeLists.txt +++ b/doc/sr/CMakeLists.txt @@ -122,19 +122,6 @@ if(ENABLE_DOC) add_custom_target(doc-quickstart-sr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.sr.html) install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.sr.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # tester's guide - add_custom_command( - OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.sr.html - COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -o weechat_tester.sr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.sr.adoc - DEPENDS - ${CMAKE_CURRENT_SOURCE_DIR}/../docinfo.html - ${CMAKE_CURRENT_SOURCE_DIR}/weechat_tester.sr.adoc - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} - COMMENT "Building weechat_tester.sr.html" - ) - add_custom_target(doc-tester-sr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.sr.html) - install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.sr.html DESTINATION ${DATAROOTDIR}/doc/${PROJECT_NAME}) - # relay protocol add_custom_command( OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.sr.html diff --git a/doc/sr/Makefile.am b/doc/sr/Makefile.am index 2c0e2ea56..2187eec6a 100644 --- a/doc/sr/Makefile.am +++ b/doc/sr/Makefile.am @@ -29,7 +29,6 @@ EXTRA_DIST = CMakeLists.txt \ weechat_scripting.sr.adoc \ weechat_faq.sr.adoc \ weechat_quickstart.sr.adoc \ - weechat_tester.sr.adoc \ weechat_relay_protocol.sr.adoc \ weechat_dev.sr.adoc \ includes/autogen_api_completions.sr.adoc \ @@ -58,7 +57,6 @@ if DOC weechat_scripting.sr.html \ weechat_faq.sr.html \ weechat_quickstart.sr.html \ - weechat_tester.sr.html \ weechat_relay_protocol.sr.html \ weechat_dev.sr.html doc_install = install-doc @@ -92,10 +90,6 @@ weechat_faq.sr.html: weechat_faq.sr.adoc $(abs_top_srcdir)/doc/docinfo.html weechat_quickstart.sr.html: weechat_quickstart.sr.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.sr.html $(abs_top_srcdir)/doc/sr/weechat_quickstart.sr.adoc -# tester's guide -weechat_tester.sr.html: weechat_tester.sr.adoc $(abs_top_srcdir)/doc/docinfo.html - $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_tester.sr.html $(abs_top_srcdir)/doc/sr/weechat_tester.sr.adoc - # relay protocol weechat_relay_protocol.sr.html: weechat_relay_protocol.sr.adoc $(abs_top_srcdir)/doc/docinfo.html $(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.sr.html $(abs_top_srcdir)/doc/sr/weechat_relay_protocol.sr.adoc diff --git a/doc/sr/weechat_dev.sr.adoc b/doc/sr/weechat_dev.sr.adoc index 979b9e10a..d77a0cee0 100644 --- a/doc/sr/weechat_dev.sr.adoc +++ b/doc/sr/weechat_dev.sr.adoc @@ -469,7 +469,6 @@ WeeChat „језгро” се налази у следећим директо | weechat_quickstart.XX.adoc | link:weechat_quickstart.sr.html[Водич за брзи почетак]. | weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.sr.html[Релеј протокол] (за удаљене интерфејсе). | weechat_scripting.XX.adoc | link:weechat_scripting.sr.html[Водич за скриптовање]. -| weechat_tester.XX.adoc | link:weechat_tester.sr.html[Водич за тестере]. | weechat_user.XX.adoc | link:weechat_user.sr.html[Корисничко упутство]. | includes/ | Фајлови укључени у документацију. | autogen_api_completions.XX.adoc | Ауто-генерисани фајл за Референцу API додатака: довршавања (*НИКАДА* не ажурирајте ручно!). diff --git a/doc/sr/weechat_tester.sr.adoc b/doc/sr/weechat_tester.sr.adoc deleted file mode 100644 index a838084ba..000000000 --- a/doc/sr/weechat_tester.sr.adoc +++ /dev/null @@ -1,120 +0,0 @@ -= Водич за тестирање програма WeeChat -:author: Sébastien Helleu -:email: flashcode@flashtux.org -:lang: sr -:toc: left -:toc-title: Садржај -:sectnums: -:docinfo1: - -Превод: - -* Иван Пешић (<ivan.pesic@gmail.com>), 2021. - - -[[purpose]] -== Намена - -Многи захвални корисници су нас питали како могу да помогну развој програма WeeChat. Најлакши (у исто време и најкомпликованији) начин помоћи у развоју програма WeeChat је тестирање! - -Тестирање је веома важан део развоја софтвера и не би требало да се занемари. Када се имплементирају неке могућности, требало би и да се тестирају, али за неке могућности постоји превише случајева коришћења или су ти случајеви компликовани, па програмери не могу да испробају баш сваки случај. - -На пример: озлоглашени charset додатак је уведен у WeeChat верзије 0.2.2: нико од нас (програмери, људи који су дали допринос програму, и тестери) није користио канале са националним карактерима у својим именима, па када је објављена верзија 0.2.2, руски коринисници су нас засули примедбама. Да имамо више тестера, овако нешто се не би опет поновило у будућности. - -Тестирање стабилне верзије програма WeeChat нема смисла јер су програмери стално заузети имплементирањем нових ствари (и исправљањем старих багова). - - -[[prepare_system]] -== Припремите свој систем - -Пуно би нам помогло ако укључите Линукс _core_ фајлове: ако се програм WeeChat сруши, Линукс ће креирати фајл под именом _core_. Овај фајл садржи врло корисне дибаг информације, тако да прецизно можемо знати где је у програму WeeChat настао проблем. - -Ако користите _bash_ командно окружење, додајте следећу линију у свој _~/.bashrc_: - ----- -ulimit -c unlimited ----- - - -[[download]] -== Преузмите развојну верзију - -Свеж кôд (са најновијим баговима и могућностима) је чува у GIT репозиторијуму. - -Можете одлучити да га сами изградите (препоручени начин): - -* GIT верзија може да се изгради и инсталира паралелно са стабилном верзијом. -* Није вам потребан root приступ, и не морате да жртвујете стабилну верзију програма WeeChat. - -[[get_sources]] -=== Набавите и изградите изворне фајлове - -Најпре креирајте директоријум, на пример _weechat-git_: - ----- -$ mkdir ~/weechat-git -$ cd ~/weechat-git ----- - -Ако имате инсталиран програм git, можете једноставно да клонирате git репозиторијум (препоручени начин): - ----- -$ git clone https://github.com/weechat/weechat.git -$ cd weechat ----- - -[NOTE] -Касније можете да извршите `git pull` у овом директоријуму, чиме преузимате делте са најновијим ажурирањима. - -У супротном можете да преузмете и распакујете _devel_ пакет: - ----- -$ wget https://weechat.org/files/src/weechat-devel.tar.bz2 -$ tar xvjf weechat-devel.tar.bz2 -$ cd weechat-devel ----- - -CMake се препоручује за изградњу изворних фајлова: - ----- -$ mkdir build -$ cd build -$ cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug -$ make -$ make install ----- - -Ако немате CMake, ипак је могуће да употребите autotools: - ----- -$ ./autogen.sh -$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev -$ make -$ make install ----- - -[[install_binary_package]] -=== Инсталација бинарног пакета - -У зависности од ваше Линукс дистрибуције: - -* Debian: https://weechat.org/download/debian -* Gentoo: https://weechat.org/download -* ArchLinux: PKGBUILD са https://aur.archlinux.org/ -* остале: не знамо! Хехе. - - -[[run]] -== Покретање програма WeeChat - -Команда је: - ----- -$ ~/weechat-git/bin/weechat ----- - -Ако сте још увек будни, требало би да угледате познати интерфејс и да се хвалите тиме што поседујете најновију могућу верзију програма WeeChat. ;) - -Ако сада искусите чудно понашање (можда постоје проблеми или крах или може да прокључа ваше пиво) не оклевајте да се придружите каналу _#weechat_ на _irc.libera.chat_ и да нам испричате о проблему. - -Ако се програм не руши - реците нам и то, потребно нам је ваше извештавање! |