weechat/doc/ja/weechat_tester.ja.asciidoc

= WeeChat テスターガイド
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:toc2:
:toc-title: 目次
:max-width: 100%


翻訳者:

* Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>, 2012-2014


[[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
----

注意: 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 .. -DPREFIX=$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: http://aur.archlinux.org/ から PKGBUILD
* その他: 知らないよ!


[[run]]
== WeeChat の実行

`--dir` オプションを使って WeeChat を専用の (安定版とは違う)
ディレクトリで実行することを推奨します。

コマンド:

----
$ ~/weechat-git/bin/weechat
----

より万全を期すなら、上の方法を使って WeeChat
の最新バージョンを使っていることを確認するべきです ;)

おかしな (問題を引き起こしたり、クラッシュしたり、あなたを怒らせるような) 挙動を見つけたら
`chat.freenode.net` の `#weechat` に参加して、開発チームにこの挙動を教えてください。

クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています!
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`= WeeChat テスターガイド`
doc: move asciidoc attributes from command line into files 2014-01-23 18:38:53 +01:00			`:author: Sébastien Helleu`
			`:email: flashcode@flashtux.org`
doc: add translators in docs, move table of contents on the left, build HTML5 2015-01-12 21:53:34 +01:00			`:toc2:`
doc: move asciidoc attributes from command line into files 2014-01-23 18:38:53 +01:00			`:toc-title: 目次`
doc: add translators in docs, move table of contents on the left, build HTML5 2015-01-12 21:53:34 +01:00			`:max-width: 100%`


core: update Japanese translations 2015-01-18 12:54:58 +09:00			`翻訳者:`
doc: add translators in docs, move table of contents on the left, build HTML5 2015-01-12 21:53:34 +01:00
			`* Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>, 2012-2014`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00

			`[[purpose]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`== 目的`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`WeeChat`
			`開発への協力に興味を持っていただきありがとうございます。開発に協力する最も簡単`
			`(で最も大変) な方法はテストです!`

			`テストはソフトウェア開発においてとても重要で、疎かにできないものです。`
			`何か新しい機能が実装されたらその機能はテストされるべきです。`
			`しかし、機能によっては使用条件が広すぎる条件が特殊ぎるため、`
			`開発チームが全ての条件をテストできない場合があります。`

			`例: WeeChat 0.2.2 で導入された charset プラグインは悪名高いものでした:`
			`チャンネル名に各国語を使うユーザー (開発者、貢献者、テスター)`
			`が開発チームにおらず、0.2.2`
			`がリリースされると、チームを非難するロシア人ユーザが殺到しました。`
			`より多くのテスターがいれば、今後そのようなことはおきないでしょう。`

			`開発者は新機能の実装 (と古いバグの修正) に忙しいので、WeeChat`
			`安定版をテストすることは意味がありません。`


			`[[prepare_system]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`== システムの準備`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`Linux の 'core' ファイルを有効にすることはとても役に立ちます: WeeChat`
			`がクラッシュすると、Linux は 'core' と呼ばれるファイルを作ります。このファイルには、WeeChat`
			`に問題の有る箇所を正確に示す、とても役立つデバッグ情報が含まれています。`

			'bash' シェルを使っている場合、以下の行を `~/.bashrc` に追記してください:

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
core: rename binary and man page from "weechat-curses" to "weechat" (task #11027) A symbolic link weechat-curses -> weechat is now created (by both cmake and configure), so that the /upgrade will work from an old version. However, if you upgrade from an old version, it is recommended to force the use of the new binary name with the command: `/upgrade /path/to/weechat` (replace the path accordingly). 2013-08-02 08:54:16 +02:00			`ulimit -c unlimited`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00

			`[[download]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`== 開発版のダウンロード`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`最新のコード (最新のバグと最新の機能も含んでいますが) は GIT リポジトリにあります。`

			`手作業で最新のコードをビルドすることができます (推奨):`

			`* GIT 版は安定版と共存してビルド、インストールできます。`
			`* root 権限は必要ありません、WeeChat`
			`安定版を捨てる必要もありません。`

			`[[get_sources]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`=== ソースの取得とビルド`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`最初にディレクトリを作ってください、ここでは 'weechat-git':`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ mkdir ~/weechat-git`
			`$ cd ~/weechat-git`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`git がインストール済みの場合、git`
			`リポジトリを clone してください (推奨):`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: update links to git repositories (savannah -> github) 2014-03-03 12:31:02 +01:00			`$ git clone https://github.com/weechat/weechat.git`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ cd weechat`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			注意: clone の後、このディレクトリ内で "`git pull`"
			`を実行すれば、最新のアップデートとの差分が更新されます。`

			`他の方法として 'devel' パッケージをダウンロードして展開する方法があります:`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
core: use https for WeeChat URLs 2014-12-13 09:16:09 +01:00			`$ wget https://weechat.org/files/src/weechat-devel.tar.bz2`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ tar xvjf weechat-devel.tar.bz2`
			`$ cd weechat-devel`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`ソースをビルドするには cmake を使うことを推奨します:`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ mkdir build`
			`$ cd build`
core: rename binary and man page from "weechat-curses" to "weechat" (task #11027) A symbolic link weechat-curses -> weechat is now created (by both cmake and configure), so that the /upgrade will work from an old version. However, if you upgrade from an old version, it is recommended to force the use of the new binary name with the command: `/upgrade /path/to/weechat` (replace the path accordingly). 2013-08-02 08:54:16 +02:00			`$ cmake .. -DPREFIX=$HOME/weechat-git -DWEECHAT_HOME=~/.weechat-dev -DCMAKE_BUILD_TYPE=Debug`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ make`
			`$ make install`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`cmake が無い場合は autotools を使うことも可能です:`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: remove comment for autogen.sh in tester's guide (command required even for tarball) 2013-01-07 09:50:29 +01:00			`$ ./autogen.sh`
core: rename binary and man page from "weechat-curses" to "weechat" (task #11027) A symbolic link weechat-curses -> weechat is now created (by both cmake and configure), so that the /upgrade will work from an old version. However, if you upgrade from an old version, it is recommended to force the use of the new binary name with the command: `/upgrade /path/to/weechat` (replace the path accordingly). 2013-08-02 08:54:16 +02:00			`$ ./configure --prefix=$HOME/weechat-git WEECHAT_HOME=~/.weechat-dev`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`$ make`
			`$ make install`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`[[install_binary_package]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`=== バイナリパッケージのインストール`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`Linux ディストリビューション別に:`

doc: update URL to WeeChat debian repositories (tester's guide) 2014-12-13 09:26:55 +01:00			`* Debian: https://weechat.org/download/debian`
core: use https for WeeChat URLs 2014-12-13 09:16:09 +01:00			`* Gentoo: https://weechat.org/download`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00			`* ArchLinux: http://aur.archlinux.org/ から PKGBUILD`
			`* その他: 知らないよ!`


			`[[run]]`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`== WeeChat の実行`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`--dir` オプションを使って WeeChat を専用の (安定版とは違う)
			`ディレクトリで実行することを推奨します。`

			`コマンド:`

doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
core: rename binary and man page from "weechat-curses" to "weechat" (task #11027) A symbolic link weechat-curses -> weechat is now created (by both cmake and configure), so that the /upgrade will work from an old version. However, if you upgrade from an old version, it is recommended to force the use of the new binary name with the command: `/upgrade /path/to/weechat` (replace the path accordingly). 2013-08-02 08:54:16 +02:00			`$ ~/weechat-git/bin/weechat`
doc: use one line titles and less chars for delimited blocks/tables in asciidoc files 2013-11-04 21:41:34 +01:00			`----`
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`より万全を期すなら、上の方法を使って WeeChat`
			`の最新バージョンを使っていることを確認するべきです ;)`

			`おかしな (問題を引き起こしたり、クラッシュしたり、あなたを怒らせるような) 挙動を見つけたら`
core: replace irc.freenode.net by chat.freenode.net Freenode wants people to use chat.freenode.net instead of irc.freenode.net which is alias to chat.freenode.net. 2014-12-20 10:48:05 +02:00			`chat.freenode.net` の `#weechat` に参加して、開発チームにこの挙動を教えてください。
doc: add japanese tester's guide, update japanese translations and docs 2012-09-21 11:56:33 +02:00
			`クラッシュしなかったとしても教えてください。開発チームはあなたからのフィードバックをお待ちしています!`