mirror of
https://github.com/weechat/weechat.git
synced 2026-06-12 14:14:48 +02:00
doc: remove tester's guide
This commit is contained in:
Sébastien Helleu
@@ -42,6 +42,7 @@ Bug fixes::
|
||||
|
||||
Documentation::
|
||||
|
||||
* doc: remove tester's guide
|
||||
* doc: add dark theme (automatic, following browser/desktop settings)
|
||||
* doc: make build reproducible
|
||||
* doc: disable web fonts
|
||||
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-de
|
||||
Title: WeeChat tester's guide (German)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (German version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.de.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.de.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-en
|
||||
Title: WeeChat tester's guide (English)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (English version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.en.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.en.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-fr
|
||||
Title: WeeChat tester's guide (French)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (French version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.fr.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.fr.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-it
|
||||
Title: WeeChat tester's guide (Italian)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Italian version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.it.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.it.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-ja
|
||||
Title: WeeChat tester's guide (Japanese)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Japanese version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.ja.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.ja.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-pl
|
||||
Title: WeeChat tester's guide (Polish)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Polish version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-devel-doc/html/weechat_tester.pl.html
|
||||
Files: /usr/share/doc/weechat-devel-doc/html/weechat_tester.pl.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-de
|
||||
Title: WeeChat tester's guide (German)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (German version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.de.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.de.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-en
|
||||
Title: WeeChat tester's guide (English)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (English version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.en.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.en.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-fr
|
||||
Title: WeeChat tester's guide (French)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (French version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.fr.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.fr.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-it
|
||||
Title: WeeChat tester's guide (Italian)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Italian version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.it.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.it.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-ja
|
||||
Title: WeeChat tester's guide (Japanese)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Japanese version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.ja.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.ja.html
|
||||
@@ -1,10 +0,0 @@
|
||||
Document: weechat-tester-pl
|
||||
Title: WeeChat tester's guide (Polish)
|
||||
Author: Sébastien Helleu
|
||||
Abstract: This document describes how to test and report
|
||||
bugs against the WeeChat IRC Client (Polish version).
|
||||
Section: Network/Communication
|
||||
|
||||
Format: HTML
|
||||
Index: /usr/share/doc/weechat-doc/html/weechat_tester.pl.html
|
||||
Files: /usr/share/doc/weechat-doc/html/weechat_tester.pl.html
|
||||
@@ -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()
|
||||
|
||||
+1
-7
@@ -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)
|
||||
|
||||
@@ -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!
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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!).
|
||||
|
||||
@@ -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!
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 !).
|
||||
|
||||
@@ -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 !
|
||||
@@ -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()
|
||||
|
||||
+1
-7
@@ -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)
|
||||
|
||||
@@ -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!
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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_ に参加して、開発チームにこの挙動を教えてください。
|
||||
|
||||
クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています!
|
||||
@@ -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()
|
||||
|
||||
+1
-7
@@ -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)
|
||||
|
||||
@@ -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!
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 додатака: довршавања (*НИКАДА* не ажурирајте ручно!).
|
||||
|
||||
@@ -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_ и да нам испричате о проблему.
|
||||
|
||||
Ако се програм не руши - реците нам и то, потребно нам је ваше извештавање!
|
||||
Reference in New Issue
Block a user