1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-29 22:36:38 +02:00

Compare commits

..

50 Commits

Author SHA1 Message Date
Sébastien Helleu dc692fd04a core, relay: fix include directory of libzstd 2024-05-26 23:54:34 +02:00
Sébastien Helleu 61e9fcb36b irc: fix crash in split of IRC message containing a newline if the server is not given 2024-05-25 19:54:53 +02:00
Sébastien Helleu 720a7e5a99 python: fix truncation of unsigned long long integer returned by function string_parse_size 2024-02-25 17:10:32 +01:00
Sébastien Helleu 33a6c852b7 tcl: fix truncation of long integer returned by function hdata_long 2024-02-25 16:16:02 +01:00
Sébastien Helleu 53fdd3458b core: add missing mouse events "alt-ctrl-button2" and "alt-ctrl-button3" 2024-02-25 13:46:24 +01:00
Sébastien Helleu 32c66a10a5 script: always display list of scripts when searching scripts with /script search (issue #2077) 2024-02-21 21:39:03 +01:00
Sébastien Helleu 134b639782 script: fix default mouse keys (issue #2076)
Some parameters of command `/script` were renamed in commit
85b5bacfe3 but the default mouse keys were not
changed and still using the old parameters names.
2024-02-21 21:16:25 +01:00
Sébastien Helleu 3ac74b94db trigger: fix memory leak when adding a new trigger with /trigger command 2024-02-10 17:58:24 +01:00
Faisal N Jawdat 769b64fb5b ruby: add detection of Ruby 3.3 2024-02-04 14:14:34 +01:00
Sébastien Helleu 870ae139a8 ci: remove tests on macOS 11 2024-02-04 14:07:08 +01:00
Sébastien Helleu 1eeb76a9ad Version 4.1.4-dev 2024-02-04 14:06:50 +01:00
Sébastien Helleu ad4529dc39 Version 4.1.3 2024-01-20 09:18:02 +01:00
Sébastien Helleu aff7a19339 core: add release notes for next version 2024-01-20 09:12:35 +01:00
Sébastien Helleu 1eed2d0e50 core: add version 4.0.8 in ChangeLog and release notes 2024-01-20 09:11:53 +01:00
Sébastien Helleu 5cb0f201f5 irc: check if arguments are not NULL in some infos
Affected infos:

- irc_server_isupport
- irc_server_isupport_value
- irc_server_cap
- irc_server_cap_value
2024-01-12 18:02:54 +01:00
Sébastien Helleu 4cd22e470c irc: fix info "irc_is_message_ignored" (issue #2059) 2024-01-12 18:02:31 +01:00
Sébastien Helleu 97b9d4b26e irc: fix display of self messages in case of message split failure
When the message sends inconsistent max lengths in message 005, the split of
self message fails and causes a display issue: the channel name is displayed
with the message:

  nick | #channel :this is a test

instead of:

  nick | this is a test
2024-01-05 21:35:29 +01:00
Sébastien Helleu f0394bf486 core: fix crash on plugin reload when using musl libc (issue #2052) 2023-12-15 23:02:27 +01:00
Sébastien Helleu 94616b4294 core: fix infinite loop in display when the chat area is too small (issue #2053) 2023-12-14 23:21:08 +01:00
Sébastien Helleu 1ade7c54a2 Version 4.1.3-dev 2023-12-14 23:20:28 +01:00
Sébastien Helleu 14b8518ae2 Version 4.1.2 2023-12-03 19:17:25 +01:00
Sébastien Helleu 4dbae51568 core: add version 4.0.7 in ChangeLog and release notes 2023-12-03 19:12:59 +01:00
Sébastien Helleu 19a1b4145b irc: remove trailing "\r\n" in signals "irc_out" and "irc_outtags" when messages are queued 2023-11-26 18:57:21 +01:00
Sébastien Helleu f6912518b3 tests: add tests on IRC message 337 2023-11-07 21:59:22 +01:00
Sébastien Helleu 5115bebb27 irc: fix target buffer of IRC message 337 (whois reply: "is hiding their idle time") 2023-11-07 21:50:55 +01:00
Sébastien Helleu ceaaab3866 core: fix value of buffer variable "num_history" when the value defined in option weechat.history.max_commands is reached 2023-11-04 17:02:08 +01:00
Sébastien Helleu 4865087019 relay: close properly connection with the IRC client in case of server disconnection (issue #2038) 2023-11-04 09:05:39 +01:00
Sébastien Helleu 532f2ce683 core: remove incorrect warning when binding keys F10 to F20 (issue #2039) 2023-11-04 08:37:36 +01:00
Sébastien Helleu 67bcbf5256 core, plugins: set error to NULL before calling strtol()
This is not strictly necessary, just in case the function strtol() doesn't
update the pointer.
2023-11-01 14:17:15 +01:00
Sébastien Helleu 08fbfcc203 core: fix memory leak when config version is invalid or not supported 2023-10-30 23:30:01 +01:00
Sébastien Helleu fad3f0c942 core: check that buffer is not NULL in function gui_chat_printf_date_tags_internal 2023-10-30 23:29:25 +01:00
Sébastien Helleu 8c55f87fb2 core: fix use NULL pointer when a config file has no options 2023-10-30 23:29:17 +01:00
Sébastien Helleu 8fae2fd927 logger: remove dead assignment 2023-10-30 23:29:13 +01:00
Sébastien Helleu 53f1eb9b28 xfer: fix use of uninitialized variable when adding a new xfer 2023-10-30 23:29:05 +01:00
Sébastien Helleu 3e78d55495 xfer: fix use of NULL pointer in strrchr() 2023-10-30 23:28:51 +01:00
Sébastien Helleu aa5c03334a core: fix crash when "config_version" is present in a configuration file without a value 2023-10-30 23:28:07 +01:00
Sébastien Helleu 8e6647c7c9 core: display an error on startup if environment variable "HOME" is not set 2023-10-30 23:27:20 +01:00
Sébastien Helleu e140f3cf8e tests: check that environment variable "HOME" is set before using it 2023-10-30 23:26:01 +01:00
Sébastien Helleu 60b2b03f9a ruby: fix use of NULL variable when displaying exception 2023-10-30 23:25:51 +01:00
Sébastien Helleu 1769ce1814 Version 4.1.2-dev 2023-10-30 23:24:34 +01:00
Sébastien Helleu fbd579eb61 ci: uninstall php8.1-imagick before build (issue #2009)
When php imagick is installed and when WeeChat is compiled with gcc, there's a
crash when the php plugin is loaded.  Newer versions of gcc should fix the
issue, but as in CI we can't easily use them, uninstalling imagick avoids the
crash.
2023-10-28 09:21:00 +02:00
Sébastien Helleu 0e97de4293 Version 4.1.1 2023-10-26 21:13:53 +02:00
Sébastien Helleu 097dc1f48f Version 4.1.1-dev 2023-10-26 21:12:39 +02:00
Sébastien Helleu c3dba4496b core: add version 4.0.6 in ChangeLog and release notes 2023-10-26 21:11:07 +02:00
Sébastien Helleu 7d854c84de core: fix crash when a custom bar item name is already used by a default bar item (issue #2034) 2023-10-23 13:11:02 +02:00
Sébastien Helleu a9c410ff23 core: fix random timeouts when a lot of concurrent processes are launched with hook_process (issue #2033) 2023-10-22 21:05:45 +02:00
Sébastien Helleu 8c4ff51beb core: update translations (issue #194, issue #2032) 2023-10-19 23:57:25 +02:00
Sébastien Helleu 6ca604938f irc: revert compute of nick colors to case sensitive way, deprecate again IRC nick color infos (issue #194, issue #2032) 2023-10-19 23:31:49 +02:00
Sébastien Helleu 252f787fcf core: make libintl.h required if CMake option ENABLE_NLS is enabled (issue #2031) 2023-10-15 14:58:26 +02:00
Sébastien Helleu 839148e9d4 core: update French translations 2023-10-15 15:47:04 +02:00
805 changed files with 88914 additions and 150901 deletions
+43
View File
@@ -0,0 +1,43 @@
---
name: Bug report
about: Create a bug report (please do not report security issues here)
labels: bug
---
<!-- Please do not report any security issue here, see file Contributing.adoc -->
## Bug summary
## Steps to reproduce
1. 
2. 
3. 
## Current behavior
## Expected behavior
## Suggested solutions
## Additional information
---
<!-- MANDATORY INFO: -->
- WeeChat version: 
- OS, distribution and version: 
- Terminal: 
- Terminal multiplexer (screen/tmux/…/none): 
-110
View File
@@ -1,110 +0,0 @@
name: Bug report
description: Create a bug report
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Before submitting a bug, please check that it has not already been reported by searching in [open and closed bugs](https://github.com/weechat/weechat/issues?q=is%3Aissue+label%3Abug).
If you don't use the latest version, please try if possible with the latest stable release to be sure the issue is still present and report the issue on this version.
**IMPORTANT**: please do not report any security issue here, see [CONTRIBUTING.md](https://github.com/weechat/weechat/blob/main/CONTRIBUTING.md#security-reports).
- type: textarea
id: bug-description
attributes:
label: Describe the bug
description: A clear and concise description of what the bug is.
validations:
required: true
- type: textarea
id: steps-to-reproduce
attributes:
label: Steps to reproduce
description: |
Steps to reproduce the issue.
If possible, please try to reproduce with a default configuration and no scripts loaded (`weechat -t`). If the issue is related to a script, please mention the list of all scripts loaded.
placeholder: |
1.
2.
3.
validations:
required: true
- type: textarea
id: current-behavior
attributes:
label: Current behavior
description: |
What currently happens.
validations:
required: true
- type: textarea
id: expected-behavior
attributes:
label: Expected behavior
description: What is actually supposed to happen.
validations:
required: true
- type: textarea
id: suggested-solutions
attributes:
label: Suggested solutions
description: How you think this issue can be resolved.
validations:
required: false
- type: textarea
id: additional-information
attributes:
label: Additional information
description: |
For a crash, please include a backtrace from gdb, see the [User's guide](https://weechat.org/doc/weechat/user/#report_crashes).
For a display issue, please add a screenshot if it makes sense.
Please mention if other versions are affected as well and if some versions are not affected (regression?).
And any additional information you deem relevant.
validations:
required: false
- type: input
id: weechat-version
attributes:
label: WeeChat version
description: |
For a stable release: output of `weechat --version`.
For the development version: output of command `/v` in WeeChat.
placeholder: "4.1.1"
validations:
required: true
- type: input
id: os-version
attributes:
label: What OS/distribution are you using?
description: Name of the operating system and its version.
placeholder: Debian 12, Ubuntu 24.04, MacOS 14, ...
validations:
required: true
- type: input
id: terminal
attributes:
label: On which terminal are you running WeeChat?
description: The name of terminal if you think it can be related to the issue (mainly for display issues).
placeholder: Terminator, Xterm, GNOME Terminal, Urxvt, ...
validations:
required: false
- type: input
id: terminal-multiplexer
attributes:
label: Which terminal multiplexer are you using?
description: The name of the terminal multiplexer if you think it can be related to the issue (mainly for display issues).
placeholder: none, tmux, screen, ...
validations:
required: false
@@ -0,0 +1,8 @@
---
name: Feature request
about: Request a new feature / enhancement
labels: feature
---
## Feature description
@@ -1,17 +0,0 @@
name: Feature request
description: Request a new feature / enhancement
labels: ["feature"]
body:
- type: markdown
attributes:
value: |
Before submitting a feature request, please check that it has not already been reported by searching in [open and closed feature requests](https://github.com/weechat/weechat/issues?q=is%3Aissue+label%3Afeature).
- type: textarea
id: feature
attributes:
label: Feature description
description: A description of the feature you would like.
validations:
required: true
+19
View File
@@ -0,0 +1,19 @@
---
name: Question
about: >
Ask a question (please read first FAQ and docs and ask on #weechat channel
before opening any question issue)
labels: question
---
<!-- Please read first FAQ/docs and ask on #weechat channel before opening any question issue -->
## Question
---
- WeeChat version: 
- OS, distribution and version: 
-19
View File
@@ -1,19 +0,0 @@
name: Question
description: Ask a question
labels: ["question"]
body:
- type: markdown
attributes:
value: |
Before opening an issue with a question:
- please read the [FAQ](https://weechat.org/doc/weechat/faq) and [documentation](https://weechat.org/doc/weechat/)
- please ask on #weechat channel (on server irc.libera.chat).
- type: textarea
id: question
attributes:
label: Question
description: Your question.
validations:
required: true
+8 -102
View File
@@ -1,47 +1,11 @@
name: CI name: CI
on: on:
push: - push
pull_request: - pull_request
schedule:
- cron: '22 9 * * 2'
env: env:
WEECHAT_DEPENDENCIES: >- WEECHAT_DEPENDENCIES: devscripts equivs python3-pip cmake ninja-build lcov pkg-config libncurses-dev gem2deb libperl-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-3.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev libzstd-dev zlib1g-dev curl libcpputest-dev php-dev libphp-embed libargon2-dev libsodium-dev flake8 pylint python3-bandit asciidoctor ruby-pygments.rb shellcheck
asciidoctor
cmake
curl
devscripts
equivs
flake8
gem2deb
guile-3.0-dev
lcov
libargon2-dev
libaspell-dev
libcjson-dev
libcpputest-dev
libcurl4-gnutls-dev
libgcrypt20-dev
libgnutls28-dev
liblua5.3-dev
libncurses-dev
libperl-dev
libphp-embed
libsodium-dev
libv8-dev
libzstd-dev
ninja-build
php-dev
pkgconf
pylint
python3-bandit
python3-dev
python3-pip
ruby-pygments.rb
shellcheck
tcl8.6-dev
zlib1g-dev
jobs: jobs:
@@ -56,7 +20,6 @@ jobs:
- { name: "gcc_ninja", cc: "gcc", cxx: "g++", buildargs: "-G Ninja" } - { name: "gcc_ninja", cc: "gcc", cxx: "g++", buildargs: "-G Ninja" }
- { name: "gcc_no_nls", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_NLS=OFF -DENABLE_DOC=OFF" } - { name: "gcc_no_nls", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_NLS=OFF -DENABLE_DOC=OFF" }
- { name: "gcc_no_zstd", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_ZSTD=OFF -DENABLE_DOC=OFF" } - { name: "gcc_no_zstd", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_ZSTD=OFF -DENABLE_DOC=OFF" }
- { name: "gcc_no_cjson", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CJSON=OFF -DENABLE_DOC=OFF" }
- { name: "gcc_coverage", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CODE_COVERAGE=ON" } - { name: "gcc_coverage", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CODE_COVERAGE=ON" }
- { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" } - { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" }
@@ -82,7 +45,7 @@ jobs:
run: ./tools/check_scripts.sh run: ./tools/check_scripts.sh
- name: Check Python stub file - name: Check Python stub file
run: ./tools/generate_python_stub.py | diff src/plugins/python/weechat.pyi - run: ./doc/python_stub.py | diff src/plugins/python/weechat.pyi -
- name: Check Curl symbols - name: Check Curl symbols
run: curl --silent --show-error --fail --retry 10 https://raw.githubusercontent.com/curl/curl/master/docs/libcurl/symbols-in-versions | ./tools/check_curl_symbols.py run: curl --silent --show-error --fail --retry 10 https://raw.githubusercontent.com/curl/curl/master/docs/libcurl/symbols-in-versions | ./tools/check_curl_symbols.py
@@ -100,28 +63,11 @@ jobs:
run: | run: |
weechat --help weechat --help
weechat-curses --help weechat-curses --help
weechat --version
weechat --build-info
weechat --colors weechat --colors
weechat --license weechat --license
weechat --version
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit" weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
- name: Test Relay OpenAPI
if: ${{ matrix.config.name == 'gcc' }}
env:
RELAY_PASSWORD: test
run: |
sudo -H pip3 install --ignore-installed schemathesis
weechat-headless \
--dir /tmp/weechat-test-api \
--run-command '/set relay.network.password "${{ env.RELAY_PASSWORD }}"' \
--run-command '/relay add api 9000' \
--daemon \
;
sleep 5
./tools/test_relay_api.sh http://localhost:9000
echo '*/quit' >/tmp/weechat-test-api/weechat_fifo_*
- name: Code coverage - name: Code coverage
if: ${{ matrix.config.name == 'gcc_coverage' }} if: ${{ matrix.config.name == 'gcc_coverage' }}
env: env:
@@ -138,7 +84,7 @@ jobs:
strategy: strategy:
matrix: matrix:
os: os:
- macos-14 - macos-12
config: config:
- { name: "gcc", cc: "gcc", cxx: "g++" } - { name: "gcc", cc: "gcc", cxx: "g++" }
- { name: "clang", cc: "clang", cxx: "clang++" } - { name: "clang", cc: "clang", cxx: "clang++" }
@@ -168,9 +114,7 @@ jobs:
/usr/local/bin/python3.11 \ /usr/local/bin/python3.11 \
/usr/local/bin/python3.11-config \ /usr/local/bin/python3.11-config \
; ;
# workaround for https://github.com/actions/runner-images/issues/10984 brew install asciidoctor guile lua pkg-config ruby
brew uninstall --ignore-dependencies --force pkg-config@0.29.2
brew install asciidoctor aspell cjson guile lua ruby
- uses: actions/checkout@v2 - uses: actions/checkout@v2
@@ -190,10 +134,9 @@ jobs:
run: | run: |
weechat --help weechat --help
weechat-curses --help weechat-curses --help
weechat --version
weechat --build-info
weechat --colors weechat --colors
weechat --license weechat --license
weechat --version
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit" weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
build_debian: build_debian:
@@ -231,41 +174,4 @@ jobs:
weechat --help weechat --help
weechat-curses --help weechat-curses --help
weechat --version weechat --version
weechat --build-info
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit" weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
codeql-analysis:
name: CodeQL
runs-on: ubuntu-latest
permissions:
actions: read
contents: read
security-events: write
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: Install dependencies
run: |
sudo apt-get update -qq
sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPENDENCIES }}
# uninstall php imagick as is causes a crash when loading php plugin (see #2009)
sudo apt-get --yes purge php8.1-imagick
sudo -H pip3 install --ignore-installed msgcheck
- name: Initialize CodeQL
uses: github/codeql-action/init@v3
with:
languages: cpp
- name: Autobuild
uses: github/codeql-action/autobuild@v3
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
with:
category: "/language:cpp"
+163
View File
@@ -0,0 +1,163 @@
= WeeChat Authors
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
== Developers
* General code
** Sébastien Helleu (FlashCode) <flashcode@flashtux.org>
* Scripts plugins, debian packager
** Emmanuel Bouthenot (kolter) <kolter@openics.org>
== Contributors
Alphabetically:
* Adam Saponara (adsr)
* Adrian Bjugård
* Ailin Nemui (Nei)
* Aleksey V Zapparov
* Alex Tarkovsky
* Anders Bergh
* Andrew Potter (talisein)
* Antoine Pietri (seirl)
* Arvydas Sidorenko
* Asakura
* Bazerka
* Benoit Papillault (benoit)
* Chris Hills
* Christian Duerr
* Christian Heinz
* Christopher O'Neill (deltafire)
* coypoop
* Danilo Spinella
* David Flatz
* Dmitry Kobylin
* Dominik Honnef
* Dominique Martinet
* dotflac
* Eduardo Elias
* Eli Schwartz
* Elizabeth Myers (Elizacat)
* Elián Hanisch (m4v)
* Emanuele Giaquinta
* Emir Sarı
* emk
* Érico Nogueira
* Esteban I. Ruiz Moreno (Exio)
* Evgeny Shmarnev
* Felix Eckhofer
* Frank Zacharias
* Fredrik Fornwall
* Grant Wu
* Gu1ll4um3r0m41n
* Guido Berhoerster
* Gwenn
* Hasan Kiran (turgay)
* Ivan Pešić
* Ivan Sichmann Freitas
* Jakub Jirutka
* Jan Palus
* Jason A. Donenfeld (zx2c4)
* JD Horelick (jdhore)
* jesopo
* Jim Ramsay (lack)
* Jiri Golembiovsky (GolemJ)
* Joey Pabalinas (alyptik)
* Johan Rylander
* Joram Schrijver
* Jos Ahrens
* Joseph Kichline
* Juan Francisco Cantero Hurtado
* Julien Louis (ptitlouis)
* Karthik K
* Koka El Kiwi (KiwiDash)
* Krzysztof Koroscik (soltys)
* Kyle Fuller (kylef)
* Kyle Sabo
* Latchezar Tzvetkoff
* Lázaro A.
* Leonid Evdokimov
* Linus Heckemann
* LuK1337
* Maarten de Vries
* Mantas Mikulėnas (grawity)
* Marco Paolone
* Marco Sirabella
* Mario Campos
* Mateusz Poszwa
* Matt Robinson
* Matthew Horan
* Matthew Martin
* Matti Virkkunen
* Max Anton Teufel
* Maxim Baz
* Michael Siegel
* Miroslav Koskar
* Murilo Opsfelder Araujo
* Neui
* Nick (SolitaryCipher)
* Nicolas Cavigneaux
* Nils Görs (nils_2)
* nyuszika7h
* Odin
* Ondřej Súkup
* Patrick Steinhardt
* Patrik Janoušek
* Paul Komkoff
* Pavel Shevchuk (Stalwart)
* Peter Boström (pbos)
* Phillip Sz
* Pierre Carru
* Piotr Szymaniak
* Pistos
* Quentin Glidic (SardemFF7)
* Quentin Pradet
* Quico Noizeux
* rafasc
* Raghavendra Prabhu
* raspbeguy
* Rettub
* Rob Campbell
* Romero B. de S. Malaquias
* Rudolf Polzer (divVerent)
* Ruslan Bekenev
* Ryan Farley
* Ryan Qian
* Ryuunosuke Ayanokouzi
* scumjr
* Sergio Durigan Junior
* Shane McCarron
* Shawn Smith
* Shun Sakai
* Simmo Saan (sim642)
* Simon Arlott
* Simon Kuhnle
* Simon Ser
* Stefano Pigozzi
* Stfn
* Sven Knurr (Cthulhux)
* Tim D. Smith
* Tim Harder
* Tobias Stoeckmann
* Tom Alsberg
* Tom Fitzhenry
* Tomoe Mami
* Tor Hveem (xt)
* Trevor Bergeron
* Valentin Lorentz (progval)
* Vasco Almeida
* Victorhck
* Voroskoi
* wfrsk
* Wojciech Kwolek
* W. Trevor King
* Yannick Palanque
* ZethJack
* Ørjan Malde
== Contact
See the https://weechat.org/about/support/[support page].
-161
View File
@@ -1,161 +0,0 @@
# WeeChat Authors
## Developers
- General code
- [Sébastien Helleu](https://github.com/flashcode) (FlashCode)
- Scripts plugins, debian packager
- [Emmanuel Bouthenot](https://github.com/k0lter) (kolter)
## Contributors
Alphabetically:
- Adam Saponara (adsr)
- Adrian Bjugård
- Ailin Nemui (Nei)
- Aleksey V Zapparov
- Alex Tarkovsky
- Anders Bergh
- Andrew Potter (talisein)
- Antoine Pietri (seirl)
- Arvydas Sidorenko
- Asakura
- Bazerka
- Benoit Papillault (benoit)
- Chris Hills
- Christian Duerr
- Christian Heinz
- Christopher O'Neill (deltafire)
- coypoop
- Danilo Spinella
- David Flatz
- Dmitry Kobylin
- Dominik Honnef
- Dominique Martinet
- dotflac
- Eduardo Elias
- Eli Schwartz
- Elizabeth Myers (Elizacat)
- Elián Hanisch (m4v)
- Emanuele Giaquinta
- Emir Sarı
- emk
- Érico Nogueira
- Esteban I. Ruiz Moreno (Exio)
- Evgeny Shmarnev
- Felix Eckhofer
- Frank Zacharias
- Fredrik Fornwall
- Grant Wu
- Gu1ll4um3r0m41n
- Guido Berhoerster
- Gwenn
- Hasan Kiran (turgay)
- Ivan Pešić
- Ivan Sichmann Freitas
- Jakub Jirutka
- Jan Palus
- Jason A. Donenfeld (zx2c4)
- JD Horelick (jdhore)
- jesopo
- Jim Ramsay (lack)
- Jiri Golembiovsky (GolemJ)
- Joey Pabalinas (alyptik)
- Johan Rylander
- Johannes Kuhn
- Joram Schrijver
- Jos Ahrens
- Joseph Kichline
- Juan Francisco Cantero Hurtado
- Julien Louis (ptitlouis)
- Karthik K
- Koka El Kiwi (KiwiDash)
- Krzysztof Koroscik (soltys)
- Kyle Fuller (kylef)
- Kyle Sabo
- Latchezar Tzvetkoff
- Lázaro A.
- Leonid Evdokimov
- Linus Heckemann
- LuK1337
- Maarten de Vries
- Mantas Mikulėnas (grawity)
- Marco Paolone
- Marco Sirabella
- Mario Campos
- Mateusz Poszwa
- Matt Robinson
- Matthew Horan
- Matthew Martin
- Matti Virkkunen
- Max Anton Teufel
- Maxim Baz
- Michael Siegel
- Miko
- Miroslav Koskar
- Murilo Opsfelder Araujo
- Neui
- Nick (SolitaryCipher)
- Nicolas Cavigneaux
- Nils Görs (nils_2)
- nyuszika7h
- Odin
- Ondřej Súkup
- Patrick Steinhardt
- Patrik Janoušek
- Paul Komkoff
- Pavel Shevchuk (Stalwart)
- Peter Boström (pbos)
- Phillip Sz
- Pierre Carru
- Piotr Szymaniak
- Pistos
- Quentin Glidic (SardemFF7)
- Quentin Pradet
- Quico Noizeux
- rafasc
- Raghavendra Prabhu
- raspbeguy
- Rettub
- Rob Campbell
- Romero B. de S. Malaquias
- Rudolf Polzer (divVerent)
- Ruslan Bekenev
- Ryan Farley
- Ryan Qian
- Ryuunosuke Ayanokouzi
- scumjr
- Sergio Durigan Junior
- Shane McCarron
- Shawn Smith
- Shun Sakai
- Simmo Saan (sim642)
- Simon Arlott
- Simon Kuhnle
- Simon Ser
- Stefano Pigozzi
- Stfn
- Sven Knurr (Cthulhux)
- Tim D. Smith
- Tim Harder
- Tobias Stoeckmann
- Tom Alsberg
- Tom Fitzhenry
- Tomoe Mami
- Tor Hveem (xt)
- Trevor Bergeron
- Valentin Lorentz (progval)
- Vasco Almeida
- Victorhck
- Voroskoi
- wfrsk
- Wojciech Kwolek
- W. Trevor King
- Yannick Palanque
- ZethJack
- Ørjan Malde
## Contact
See the [support page](https://weechat.org/about/support/).
-4277
View File
File diff suppressed because it is too large Load Diff
+10 -20
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net> # Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org> # Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
# #
@@ -19,7 +19,7 @@
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>. # along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
# #
cmake_minimum_required(VERSION 3.18) cmake_minimum_required(VERSION 3.5)
project(weechat C) project(weechat C)
@@ -100,7 +100,6 @@ option(ENABLE_HEADLESS "Compile the headless binary" ON)
option(ENABLE_NLS "Enable Native Language Support" ON) option(ENABLE_NLS "Enable Native Language Support" ON)
option(ENABLE_LARGEFILE "Enable Large File Support" ON) option(ENABLE_LARGEFILE "Enable Large File Support" ON)
option(ENABLE_ZSTD "Enable Zstandard compression" ON) option(ENABLE_ZSTD "Enable Zstandard compression" ON)
option(ENABLE_CJSON "Enable cJSON support" ON)
option(ENABLE_ALIAS "Enable Alias plugin" ON) option(ENABLE_ALIAS "Enable Alias plugin" ON)
option(ENABLE_BUFLIST "Enable Buflist plugin" ON) option(ENABLE_BUFLIST "Enable Buflist plugin" ON)
option(ENABLE_CHARSET "Enable Charset plugin" ON) option(ENABLE_CHARSET "Enable Charset plugin" ON)
@@ -192,9 +191,6 @@ include(CheckSymbolExists)
check_include_files("langinfo.h" HAVE_LANGINFO_CODESET) check_include_files("langinfo.h" HAVE_LANGINFO_CODESET)
check_include_files("sys/resource.h" HAVE_SYS_RESOURCE_H) check_include_files("sys/resource.h" HAVE_SYS_RESOURCE_H)
check_include_files("malloc.h" HAVE_MALLOC_H)
check_symbol_exists("malloc_trim" "malloc.h" HAVE_MALLOC_TRIM)
check_function_exists(mallinfo HAVE_MALLINFO) check_function_exists(mallinfo HAVE_MALLINFO)
check_function_exists(mallinfo2 HAVE_MALLINFO2) check_function_exists(mallinfo2 HAVE_MALLINFO2)
@@ -206,10 +202,9 @@ if(ENABLE_LARGEFILE)
endif() endif()
# Check for libgcrypt # Check for libgcrypt
pkg_check_modules(LIBGCRYPT REQUIRED libgcrypt) find_package(GCRYPT REQUIRED)
add_definitions(-DHAVE_GCRYPT) add_definitions(-DHAVE_GCRYPT)
include_directories(${LIBGCRYPT_INCLUDE_DIRS}) list(APPEND EXTRA_LIBS ${GCRYPT_LDFLAGS})
list(APPEND EXTRA_LIBS ${LIBGCRYPT_LDFLAGS})
# Check for GnuTLS # Check for GnuTLS
find_package(GnuTLS REQUIRED) find_package(GnuTLS REQUIRED)
@@ -227,12 +222,6 @@ if(ENABLE_ZSTD)
add_definitions(-DHAVE_ZSTD) add_definitions(-DHAVE_ZSTD)
endif() endif()
# Check for cJSON
if(ENABLE_CJSON)
pkg_check_modules(LIBCJSON REQUIRED libcjson)
add_definitions(-DHAVE_CJSON)
endif()
# Check for iconv # Check for iconv
find_package(Iconv) find_package(Iconv)
if(ICONV_FOUND) if(ICONV_FOUND)
@@ -260,6 +249,7 @@ add_subdirectory(icons)
if(ENABLE_NLS) if(ENABLE_NLS)
find_package(Gettext REQUIRED) find_package(Gettext REQUIRED)
add_definitions(-DENABLE_NLS)
find_package(Intl REQUIRED) find_package(Intl REQUIRED)
list(APPEND EXTRA_LIBS "${Intl_LIBRARIES}") list(APPEND EXTRA_LIBS "${Intl_LIBRARIES}")
add_subdirectory(po) add_subdirectory(po)
@@ -321,11 +311,11 @@ configure_file("${CMAKE_CURRENT_SOURCE_DIR}/weechat.cygport.in" "${CMAKE_CURRENT
# install some files (only on Cygwin) # install some files (only on Cygwin)
if(CYGWIN) if(CYGWIN)
install(FILES install(FILES
"${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.md" "${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md" "${CMAKE_CURRENT_SOURCE_DIR}/ChangeLog.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/CONTRIBUTING.md" "${CMAKE_CURRENT_SOURCE_DIR}/Contributing.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/README.md" "${CMAKE_CURRENT_SOURCE_DIR}/README.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/UPGRADING.md" "${CMAKE_CURRENT_SOURCE_DIR}/ReleaseNotes.adoc"
DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}"
) )
endif() endif()
-109
View File
@@ -1,109 +0,0 @@
# Contributing to WeeChat
## Reporting bugs
First, some basic things:
- Use only English to communicate with developers.
- Search in issues if the same problem or feature request has already been
reported (a duplicate is waste of time for you and the developers!).
- If you can, please check if the problem has been fixed in development version
(if you are using a stable release or old version).
- Report only one bug or feature request per issue.
### Security reports
Please **DO NOT** file a GitHub issue for security related problems, but send an
email to [security@weechat.org](mailto:security@weechat.org) instead.
### Required info
When reporting [issues](https://github.com/weechat/weechat/issues) on GitHub,
please include:
- Your **WeeChat version**: the output of `/v` in WeeChat, for example:
`WeeChat 1.7-dev (git: v1.6-6-g997f47f)`.\
If WeeChat does not start at all, please include the version displayed by
`weechat --help` (or the version installed with your package manager).
- Your **operating system**: its name and version (examples: Linux Debian Bookworm,
FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit…).
- The **steps to reproduce**: if possible, please include a reproducible example:
explain the steps which led you to the problem.\
It's even better if you can reproduce the problem with a new config (and no
scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
problem here.
- The **gdb's backtrace** (only for a crash): if you can reproduce the crash
(or if you have a core file), please include the backtrace from gdb (look at
[User's guide](https://weechat.org/doc/weechat/user/#report_crashes) for more info).
- The **actual result**.
- The **expected result**: the correct result you are expecting.
> [!IMPORTANT]
> Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_)
is **NOT USEFUL** to fix the bug, so please report this file **ONLY** if a developer
asked you to send it (and be extremely careful, this file can contain personal
data like passwords and contents of your chats).
### Scripts related issues
If you are using scripts, they can cause problems/crashes. To check if the
problem is related to one script, try to unload them one by one (using
command `/script unload <name>`).
Many issues reported are in fact related to bugs in scripts, so please first
check that before reporting any issue on WeeChat itself.
If you think the problem comes from a specific script, please report the issue
in the [scripts git repository](https://github.com/weechat/scripts/issues) instead.
## Translations
Pull requests on GitHub for fixes or new translations are welcome at any
time, for [WeeChat](https://github.com/weechat/weechat) and the website
[weechat.org](https://github.com/weechat/weechat.org).
To start a translation in a new language (not yet supported), please look at
[translations](https://weechat.org/doc/weechat/dev/#translations)
in Developer's guide.
## Feature requests
WeeChat is under active development, so your idea may already have been
implemented, or scheduled for a future version (you can check in
[roadmap](https://weechat.org/dev/) or
[milestones](https://github.com/weechat/weechat/milestones) on GitHub.
Pull requests on GitHub are welcome for minor new features.
For major new features, it's better to discuss about it in IRC
(server: `irc.libera.chat`, channel `#weechat`).
Before submitting any pull request, be sure you have read the
[coding rules](https://weechat.org/doc/weechat/dev/#coding_rules)
in Developer's guide, which contains info about styles used, naming convention
and other useful info.
## Semantic versioning
Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
It is based on [Semantic Versioning](https://semver.org/) but in a less strict way:
breaking changes in API with low user impact don't bump the major version.
The version number is on three digits `X.Y.Z`, where:
- `X` is the major version
- `Y` is the minor version
- `Z` is the patch version.
Rules to increment the version number:
- the **major version** number (`X`) is incremented only when intentional breaking changes
target feature areas that are actively consumed by users, scripts or C plugin API
- the **minor version** number (`Y`) is incremented for any new release of WeeChat
that includes new features and bug fixes, possibly breaking API with low impact on users
- the **patch version** number (`Z`) is reserved for releases that address severe bugs
or security issues found after the release.
For more information, see the
[specification](https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html).
+3925
View File
File diff suppressed because it is too large Load Diff
+109
View File
@@ -0,0 +1,109 @@
= Contributing to WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
== Reporting bugs
First, some basic things:
* Use only English to communicate with developers.
* Search in issues if the same problem or feature request has already been
reported (a duplicate is waste of time for you and the developers!).
* If you can, please check if the problem has been fixed in development version
(if you are using a stable release or old version).
* Report only one bug or feature request per issue.
=== Security reports
Please *DO NOT* file a GitHub issue for security related problems, but send an
email to <security@weechat.org> instead.
=== Required info
When reporting https://github.com/weechat/weechat/issues[issues] on GitHub,
please include:
* Your *WeeChat version*: the output of `/v` in WeeChat, for example:
_WeeChat 1.7-dev (git: v1.6-6-g997f47f)_. +
If WeeChat does not start at all, please include the version displayed by
`weechat --help` (or the version installed with your package manager).
* Your *operating system*: its name and version (examples: Linux Debian Bookworm,
FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...).
* The *steps to reproduce*: if possible, please include a reproducible example:
explain the steps which led you to the problem. +
It's even better if you can reproduce the problem with a new config (and no
scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
problem here.
* The *gdb's backtrace* (only for a crash): if you can reproduce the crash
(or if you have a core file), please include the backtrace from gdb (look at
https://weechat.org/doc/weechat/user/#report_crashes[User's guide] for more info).
* The *actual result*.
* The *expected result*: the correct result you are expecting.
[IMPORTANT]
Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_) is
*NOT USEFUL* to fix the bug, so please report this file *ONLY* if a developer
asked you to send it (and be extremely careful, this file can contain personal
data like passwords and contents of your chats).
=== Scripts related issues
If you are using scripts, they can cause problems/crashes. To check if the
problem is related to one script, try to unload them one by one (using
command `/script unload <name>`).
Many issues reported are in fact related to bugs in scripts, so please first
check that before reporting any issue on WeeChat itself.
If you think the problem comes from a specific script, please report the issue
in the https://github.com/weechat/scripts/issues[scripts git repository]
instead.
== Translations
Pull requests on GitHub for fixes or new translations are welcome at any
time, for https://github.com/weechat/weechat[WeeChat] and the website
https://github.com/weechat/weechat.org[weechat.org].
To start a translation in a new language (not yet supported), please look at
https://weechat.org/doc/weechat/dev/#translations[translations]
in Developer's guide.
== Feature requests
WeeChat is under active development, so your idea may already have been
implemented, or scheduled for a future version (you can check in
https://weechat.org/dev/[roadmap] or
https://github.com/weechat/weechat/milestones[milestones] on GitHub.
Pull requests on GitHub are welcome for minor new features.
For major new features, it's better to discuss about it in IRC
(server: _irc.libera.chat_, channel _#weechat_).
Before submitting any pull request, be sure you have read the
https://weechat.org/doc/weechat/dev/#coding_rules[coding rules]
in Developer's guide, which contains info about styles used, naming convention
and other useful info.
== Semantic versioning
Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
It is based on https://semver.org/[Semantic Versioning] but in a less strict way: breaking changes in API with low user impact don't bump the major version.
The version number is on three digits `X.Y.Z`, where:
* `X` is the major version
* `Y` is the minor version
* `Z` is the patch version.
Rules to increment the version number:
* the *major version* number (`X`) is incremented only when intentional breaking changes target feature areas that are actively consumed by users, scripts or C plugin API
* the *minor version* number (`Y`) is incremented for any new release of WeeChat that includes new features and bug fixes, possibly breaking API with low impact on users
* the *patch version* number (`Z`) is reserved for releases that address severe bugs or security issues found after the release.
For more information, see the https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html[specification].
+67
View File
@@ -0,0 +1,67 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
pass:[<p align="center">] image:https://weechat.org/media/images/weechat_logo_large.png[align="center"] pass:[</p>]
image:https://img.shields.io/badge/diaspora*-follow-blue.svg["Diaspora*", link="https://diasp.eu/u/weechat"]
image:https://img.shields.io/badge/mastodon-follow-blue.svg["Mastodon", link="https://hostux.social/@weechat"]
image:https://img.shields.io/badge/twitter-follow-blue.svg["Twitter", link="https://twitter.com/WeeChatClient"]
image:https://img.shields.io/badge/devel%20blog-follow-blue.svg["Devel blog", link="https://blog.weechat.org/"]
image:https://img.shields.io/badge/slant-recommend-28acad.svg["Slant", link="https://www.slant.co/topics/1323/~best-irc-clients-for-linux"]
image:https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg["Donate", link="https://weechat.org/donate/"]
image:https://github.com/weechat/weechat/workflows/CI/badge.svg["CI", link="https://github.com/weechat/weechat/actions"]
image:https://codecov.io/gh/weechat/weechat/branch/master/graph/badge.svg["Code coverage", link="https://codecov.io/gh/weechat/weechat"]
*WeeChat* (Wee Enhanced Environment for Chat) is a free chat client, fast and
light, designed for many operating systems.
It is highly customizable and extensible with scripts.
Homepage: https://weechat.org/
== Features
* *Modular chat client*: WeeChat has a lightweight core and optional https://weechat.org/doc/weechat/user/#plugins[plugins]. All plugins (including https://weechat.org/doc/weechat/user/#irc[IRC]) are independent and can be unloaded.
* *Multi-platform*: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
* *Multi-protocols*: WeeChat is designed to support multiple protocols by plugins, like IRC.
* *Standards-compliant*: the IRC plugin is compliant with RFCs https://datatracker.ietf.org/doc/html/rfc1459[1459], https://datatracker.ietf.org/doc/html/rfc2810[2810], https://datatracker.ietf.org/doc/html/rfc2811[2811], https://datatracker.ietf.org/doc/html/rfc2812[2812], https://datatracker.ietf.org/doc/html/rfc2813[2813] and https://datatracker.ietf.org/doc/html/rfc7194[7194].
* *Small, fast, and very light*: the core is and should stay as light and fast as possible.
* *Customizable and extensible*: there are a lot of options to customize WeeChat, and it is extensible with C plugins and https://weechat.org/scripts/[scripts] (https://weechat.org/scripts/language/perl/[Perl], https://weechat.org/scripts/language/python/[Python], https://weechat.org/scripts/language/ruby[Ruby], https://weechat.org/scripts/language/lua/[Lua], https://weechat.org/scripts/language/tcl/[Tcl], https://weechat.org/scripts/language/guile/[Scheme], https://weechat.org/scripts/language/javascript/[JavaScript] and https://weechat.org/scripts/language/php/[PHP]).
* *Fully documented*: there is comprehensive https://weechat.org/doc/weechat/[documentation], which is https://weechat.org/doc/weechat/dev/#translations[translated] into several languages.
* *Developed from scratch*: WeeChat was built from scratch and is not based on any other client.
* *Free software*: WeeChat is released under https://www.gnu.org/licenses/gpl-3.0.html[GPLv3].
pass:[<p align="center">] image:https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png[align="center"] pass:[</p>]
On WeeChat's website you can find https://weechat.org/about/screenshots/[more screenshots].
== Installation
WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.
For detailed instructions, please check the https://weechat.org/doc/weechat/user/#install[WeeChat user's guide].
== Semantic versioning
WeeChat is following a "practical" semantic versioning, see file link:Contributing.adoc#semantic-versioning[Contributing.adoc].
== Copyright
Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
This file is part of WeeChat, the extensible chat client.
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
WeeChat is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
-66
View File
@@ -1,66 +0,0 @@
# WeeChat
<p align="center">
<img src="https://weechat.org/media/images/weechat_logo_large.png" alt="WeeChat" />
</p>
[![Mastodon](https://img.shields.io/badge/mastodon-follow-blue.svg)](https://hostux.social/@weechat)
[![Diaspora*](https://img.shields.io/badge/diaspora*-follow-blue.svg)](https://diasp.eu/u/weechat)
[![X](https://img.shields.io/badge/x-follow-blue.svg)](https://x.com/WeeChatClient)
[![Devel blog](https://img.shields.io/badge/devel%20blog-follow-blue.svg)](https://blog.weechat.org/)
[![Slant](https://img.shields.io/badge/slant-recommend-28acad.svg)](https://www.slant.co/topics/1323/~best-irc-clients-for-linux)
[![Donate](https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg)](https://weechat.org/donate/)
[![CI](https://github.com/weechat/weechat/workflows/CI/badge.svg)](https://github.com/weechat/weechat/actions)
[![Code coverage](https://codecov.io/gh/weechat/weechat/branch/main/graph/badge.svg)](https://codecov.io/gh/weechat/weechat)
**WeeChat** (Wee Enhanced Environment for Chat) is a free chat client, fast and light, designed for many operating systems.\
It is highly customizable and extensible with scripts.
Homepage: [https://weechat.org/](https://weechat.org/)
## Features
- **Modular chat client**: WeeChat has a lightweight core and optional [plugins](https://weechat.org/doc/weechat/user/#plugins). All plugins (including [IRC](https://weechat.org/doc/weechat/user/#irc)) are independent and can be unloaded.
- **Multi-platform**: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
- **Multi-protocols**: WeeChat is designed to support multiple protocols by plugins, like IRC.
- **Standards-compliant**: the IRC plugin is compliant with RFCs [1459](https://datatracker.ietf.org/doc/html/rfc1459), [2810](https://datatracker.ietf.org/doc/html/rfc2810), [2811](https://datatracker.ietf.org/doc/html/rfc2811), [2812](https://datatracker.ietf.org/doc/html/rfc2812), [2813](https://datatracker.ietf.org/doc/html/rfc2813) and [7194](https://datatracker.ietf.org/doc/html/rfc7194).
- **Small, fast, and very light**: the core is and should stay as light and fast as possible.
- **Customizable and extensible**: there are a lot of options to customize WeeChat, and it is extensible with C plugins and [scripts](https://weechat.org/scripts/) ([Perl](https://weechat.org/scripts/language/perl/), [Python](https://weechat.org/scripts/language/python/), [Ruby](https://weechat.org/scripts/language/ruby), [Lua](https://weechat.org/scripts/language/lua/), [Tcl](https://weechat.org/scripts/language/tcl/), [Scheme](https://weechat.org/scripts/language/guile/), [JavaScript](https://weechat.org/scripts/language/javascript/) and [PHP](https://weechat.org/scripts/language/php/)).
- **Fully documented**: there is comprehensive [documentation](https://weechat.org/doc/weechat/), which is [translated](https://weechat.org/doc/weechat/dev/#translations) into several languages.
- **Developed from scratch**: WeeChat was built from scratch and is not based on any other client.
- **Free software**: WeeChat is released under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html).
<p align="center">
<img src="https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png" alt="WeeChat" />
</p>
On WeeChat's website you can find [more screenshots](https://weechat.org/about/screenshots/).
## Installation
WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.\
For detailed instructions, please check the [WeeChat user's guide](https://weechat.org/doc/weechat/user/#install).
## Semantic versioning
WeeChat is following a "practical" semantic versioning, see file [CONTRIBUTING.md](CONTRIBUTING.md#semantic-versioning).
## Copyright
Copyright © 2003-2024 [Sébastien Helleu](https://github.com/flashcode)
This file is part of WeeChat, the extensible chat client.
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
WeeChat is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2014-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2014-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+53
View File
@@ -0,0 +1,53 @@
#
# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
# WeeChat is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# WeeChat is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
#
# - Find Gcrypt
# This module finds if libgcrypt is installed and determines where
# the include files and libraries are.
#
# This code sets the following variables:
#
# GCRYPT_CFLAGS = cflags to use to compile
# GCRYPT_LDFLAGS = ldflags to use to compile
#
find_program(LIBGCRYPT_CONFIG_EXECUTABLE NAMES libgcrypt-config)
set(GCRYPT_LDFLAGS)
set(GCRYPT_CFLAGS)
if(LIBGCRYPT_CONFIG_EXECUTABLE)
execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --libs RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_LDFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --cflags RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_CFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
if(NOT DEFINED ${GCRYPT_CFLAGS})
set(GCRYPT_CFLAGS " ")
endif()
endif()
# handle the QUIETLY and REQUIRED arguments and set GCRYPT_FOUND to TRUE if
# all listed variables are TRUE
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(GCRYPT REQUIRED_VARS GCRYPT_LDFLAGS GCRYPT_CFLAGS)
if(GCRYPT_FOUND)
mark_as_advanced(GCRYPT_CFLAGS GCRYPT_LDFLAGS)
endif()
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net> # Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org> # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org> # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2011-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2011-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+2 -2
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
@@ -35,5 +35,5 @@ endif()
find_package(PkgConfig) find_package(PkgConfig)
if(PKG_CONFIG_FOUND) if(PKG_CONFIG_FOUND)
pkg_search_module(LUA lua lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50) pkg_search_module(LUA lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50 lua)
endif() endif()
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,6 +1,6 @@
# #
# Copyright (C) 2017 Adam Saponara <as@php.net> # Copyright (C) 2017 Adam Saponara <as@php.net>
# Copyright (C) 2017-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2017-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net> # Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
+45
View File
@@ -0,0 +1,45 @@
#
# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
# WeeChat is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# WeeChat is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
#
# - Find Ruby
# This module finds if Ruby is installed and determines where the include files
# and libraries are. It also determines what the name of the library is. This
# code sets the following variables:
#
# RUBY_INCLUDE_DIRS = C flags to compile with ruby
# RUBY_LIBRARY_DIRS = linker flags to compile with ruby (found with pkg-config)
# RUBY_LIB = ruby library (found without pkg-config)
if(RUBY_FOUND)
# Already in cache, be silent
set(RUBY_FIND_QUIETLY TRUE)
endif()
find_package(PkgConfig)
if(PKG_CONFIG_FOUND)
if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
# set specific search path for macOS
set(ENV{PKG_CONFIG_PATH} "$ENV{PKG_CONFIG_PATH}:/usr/local/opt/ruby/lib/pkgconfig")
endif()
pkg_search_module(RUBY ruby-3.3 ruby-3.2 ruby-3.1 ruby-3.0 ruby-2.7 ruby-2.6 ruby-2.5 ruby-2.4 ruby-2.3 ruby-2.2 ruby-2.1 ruby-2.0 ruby-1.9 ruby)
if(RUBY_FOUND AND ${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
# FIXME: weird hack: hardcoding the Ruby lib location on macOS
set(RUBY_LDFLAGS "${RUBY_LDFLAGS} -L/usr/local/opt/ruby/lib")
endif()
endif()
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2015-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2015-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
+1 -1
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
# #
-42
View File
@@ -1,39 +1,3 @@
#cmakedefine01 ENABLE_NCURSES
#cmakedefine01 ENABLE_HEADLESS
#cmakedefine01 ENABLE_NLS
#cmakedefine01 ENABLE_LARGEFILE
#cmakedefine01 ENABLE_ZSTD
#cmakedefine01 ENABLE_CJSON
#cmakedefine01 ENABLE_ALIAS
#cmakedefine01 ENABLE_BUFLIST
#cmakedefine01 ENABLE_CHARSET
#cmakedefine01 ENABLE_EXEC
#cmakedefine01 ENABLE_FIFO
#cmakedefine01 ENABLE_FSET
#cmakedefine01 ENABLE_IRC
#cmakedefine01 ENABLE_LOGGER
#cmakedefine01 ENABLE_RELAY
#cmakedefine01 ENABLE_SCRIPT
#cmakedefine01 ENABLE_SCRIPTS
#cmakedefine01 ENABLE_PERL
#cmakedefine01 ENABLE_PYTHON
#cmakedefine01 ENABLE_RUBY
#cmakedefine01 ENABLE_LUA
#cmakedefine01 ENABLE_TCL
#cmakedefine01 ENABLE_GUILE
#cmakedefine01 ENABLE_JAVASCRIPT
#cmakedefine01 ENABLE_PHP
#cmakedefine01 ENABLE_SPELL
#cmakedefine01 ENABLE_ENCHANT
#cmakedefine01 ENABLE_TRIGGER
#cmakedefine01 ENABLE_TYPING
#cmakedefine01 ENABLE_XFER
#cmakedefine01 ENABLE_MAN
#cmakedefine01 ENABLE_DOC
#cmakedefine01 ENABLE_DOC_INCOMPLETE
#cmakedefine01 ENABLE_TESTS
#cmakedefine01 ENABLE_CODE_COVERAGE
#cmakedefine HAVE_SYS_RESOURCE_H #cmakedefine HAVE_SYS_RESOURCE_H
#cmakedefine HAVE_FLOCK #cmakedefine HAVE_FLOCK
#cmakedefine HAVE_LANGINFO_CODESET #cmakedefine HAVE_LANGINFO_CODESET
@@ -41,16 +5,10 @@
#cmakedefine ICONV_2ARG_IS_CONST 1 #cmakedefine ICONV_2ARG_IS_CONST 1
#cmakedefine HAVE_MALLINFO #cmakedefine HAVE_MALLINFO
#cmakedefine HAVE_MALLINFO2 #cmakedefine HAVE_MALLINFO2
#cmakedefine HAVE_MALLOC_H
#cmakedefine HAVE_MALLOC_TRIM
#cmakedefine HAVE_EAT_NEWLINE_GLITCH #cmakedefine HAVE_EAT_NEWLINE_GLITCH
#cmakedefine HAVE_ASPELL_VERSION_STRING #cmakedefine HAVE_ASPELL_VERSION_STRING
#cmakedefine HAVE_ENCHANT_GET_VERSION #cmakedefine HAVE_ENCHANT_GET_VERSION
#cmakedefine HAVE_GUILE_GMP_MEMORY_FUNCTIONS #cmakedefine HAVE_GUILE_GMP_MEMORY_FUNCTIONS
#define CMAKE_BUILD_TYPE "@CMAKE_BUILD_TYPE@"
#define CMAKE_INSTALL_PREFIX "@CMAKE_INSTALL_PREFIX@"
#define PACKAGE_VERSION "@VERSION@" #define PACKAGE_VERSION "@VERSION@"
#define PACKAGE "@PROJECT_NAME@" #define PACKAGE "@PROJECT_NAME@"
#define PACKAGE_NAME "@PROJECT_NAME@" #define PACKAGE_NAME "@PROJECT_NAME@"
+3 -5
View File
@@ -6,8 +6,7 @@ Build-Depends:
asciidoctor (>= 1.5.4), asciidoctor (>= 1.5.4),
ruby-pygments.rb, ruby-pygments.rb,
debhelper (>= 12), debhelper (>= 12),
cmake, cmake, pkg-config,
pkgconf,
libncurses-dev, libncurses-dev,
gem2deb, gem2deb,
libperl-dev, libperl-dev,
@@ -22,9 +21,8 @@ Build-Depends:
libgcrypt20-dev, libgcrypt20-dev,
libgnutls28-dev, libgnutls28-dev,
libzstd-dev, libzstd-dev,
zlib1g-dev, zlib1g-dev
libcjson-dev Standards-Version: 4.6.2
Standards-Version: 4.7.0
Homepage: https://weechat.org/ Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat Vcs-Browser: https://salsa.debian.org/kolter/weechat
+3
View File
@@ -16,5 +16,8 @@ override_dh_auto_configure:
-DCMAKE_SKIP_RPATH:BOOL=ON \ -DCMAKE_SKIP_RPATH:BOOL=ON \
-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON -DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
override_dh_installchangelogs:
dh_installchangelogs ChangeLog.adoc
%: %:
dh $@ --builddirectory=$(BUILDDIR) dh $@ --builddirectory=$(BUILDDIR)
-3
View File
@@ -1,3 +0,0 @@
tar-ignore = ".git"
tar-ignore = "build"
tar-ignore = "release"
@@ -1,10 +0,0 @@
Document: weechat-dev-sr
Title: WeeChat developer's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html
@@ -1,10 +0,0 @@
Document: weechat-faq-sr
Title: WeeChat FAQ (Serbian)
Author: Sébastien Helleu
Abstract: This document answers frequently asked questions
about the WeeChat IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html
@@ -1,10 +0,0 @@
Document: weechat-plugin-sr
Title: WeeChat plugin API reference (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html
@@ -1,9 +0,0 @@
Document: weechat-quickstart-cs
Title: WeeChat quick start guide (Czech)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Czech version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html
@@ -1,9 +0,0 @@
Document: weechat-quickstart-sr
Title: WeeChat quick start guide (Serbian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-api-en
Title: WeeChat Relay "api" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-api-fr
Title: WeeChat Relay "api" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-en
Title: WeeChat Relay protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-fr
Title: WeeChat Relay protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-ja
Title: WeeChat Relay protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-en
Title: WeeChat Relay "weechat" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-fr
Title: WeeChat Relay "weechat" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-ja
Title: WeeChat Relay "weechat" protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-sr
Title: WeeChat Relay "weechat" protocol (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html
@@ -1,10 +0,0 @@
Document: weechat-scripting-sr
Title: WeeChat scripting guide (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html
@@ -1,10 +0,0 @@
Document: weechat-user-sr
Title: WeeChat user's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html
-34
View File
@@ -1,37 +1,3 @@
weechat (4.4.3-1) unstable; urgency=medium
* New upstream release
* Remove (fixed upstream) the fix for a possible privacy breach with html
documentation which includes stylesheets and fonts (font-awesome) hosted
on remote CDN (Cloudflare).
-- Emmanuel Bouthenot <kolter@debian.org> Wed, 06 Nov 2024 21:27:08 +0000
weechat (4.4.2-1) unstable; urgency=medium
* New upstream release
- fix crash where exiting (Closes: #1076532)
- fix a minor security issue (Closes: #1081942)
* Bump Standards-Version to 4.7.0
-- Emmanuel Bouthenot <kolter@debian.org> Sun, 22 Sep 2024 13:08:28 +0000
weechat (4.3.1-1) unstable; urgency=medium
* New upstream release (Closes: #1067608)
- fix FTBFS against libgcrypt 1.11 (Closes: #1071960)
* Add build dependency on libcjson-dev
* Replace pkg-config build dependency by pkgconf
* Minor updates in debian/copyright
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 01 Jun 2024 14:21:02 +0000
weechat (4.1.1-1) unstable; urgency=medium
* New upstream release (Closes: #1055278)
-- Emmanuel Bouthenot <kolter@debian.org> Fri, 03 Nov 2023 20:23:37 +0000
weechat (4.0.5-1) unstable; urgency=medium weechat (4.0.5-1) unstable; urgency=medium
* New upstream release * New upstream release
+3 -5
View File
@@ -6,8 +6,7 @@ Build-Depends:
asciidoctor (>= 1.5.4), asciidoctor (>= 1.5.4),
ruby-pygments.rb, ruby-pygments.rb,
debhelper (>= 12), debhelper (>= 12),
cmake, cmake, pkg-config,
pkgconf,
libncurses-dev, libncurses-dev,
gem2deb, gem2deb,
libperl-dev, libperl-dev,
@@ -22,9 +21,8 @@ Build-Depends:
libgcrypt20-dev, libgcrypt20-dev,
libgnutls28-dev, libgnutls28-dev,
libzstd-dev, libzstd-dev,
zlib1g-dev, zlib1g-dev
libcjson-dev Standards-Version: 4.6.2
Standards-Version: 4.7.0
Homepage: https://weechat.org/ Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat Vcs-Browser: https://salsa.debian.org/kolter/weechat
+13 -13
View File
@@ -4,26 +4,26 @@ Upstream-Contact: Sébastien Helleu <flashcode@flashtux.org>
Source: https://weechat.org/ Source: https://weechat.org/
Files: * Files: *
Copyright: 2003-2024, Sébastien Helleu <flashcode@flashtux.org> Copyright: 2003-2023, Sébastien Helleu <flashcode@flashtux.org>
License: GPL-3+ License: GPL-3+
Files: src/core/core-command.c Files: src/core/wee-command.c
src/core/core-command.h src/core/wee-command.h
Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org> Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
License: GPL-3+ License: GPL-3+
Files: src/core/core-config-file.c Files: src/core/wee-config-file.c
src/core/core-config-file.h src/core/wee-config-file.h
src/core/core-config.c src/core/wee-config.c
src/core/core-config.h src/core/wee-config.h
Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org> Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
License: GPL-3+ License: GPL-3+
Files: src/core/hook/hook-connect.c Files: src/core/hook/wee-hook-connect.c
Copyright: 2012, Simon Arlott Copyright: 2012, Simon Arlott
License: GPL-3+ License: GPL-3+
Files: src/core/hook/hook-connect.h Files: src/core/hook/wee-hook-connect.h
Copyright: 2012, Simon Arlott Copyright: 2012, Simon Arlott
License: GPL-3+ License: GPL-3+
@@ -31,9 +31,9 @@ Files: src/gui/gui-history.c
Copyright: 2005, Emmanuel Bouthenot <kolter@openics.org> Copyright: 2005, Emmanuel Bouthenot <kolter@openics.org>
License: GPL-3+ License: GPL-3+
Files: src/core/core-completion.c Files: src/core/wee-completion.c
src/core/core-log.c src/core/wee-log.c
src/core/core-utf8.c src/core/wee-utf8.c
src/core/weechat.h src/core/weechat.h
src/plugins/spell/spell-config.c src/plugins/spell/spell-config.c
src/plugins/spell/spell-config.h src/plugins/spell/spell-config.h
@@ -45,7 +45,7 @@ Files: src/core/core-completion.c
Copyright: 2006, Emmanuel Bouthenot <kolter@openics.org> Copyright: 2006, Emmanuel Bouthenot <kolter@openics.org>
License: GPL-3+ License: GPL-3+
Files: src/core/core-network.c Files: src/core/wee-network.c
Copyright: 2005-2010, Emmanuel Bouthenot <kolter@openics.org> Copyright: 2005-2010, Emmanuel Bouthenot <kolter@openics.org>
2010, Gu1ll4um3r0m41n <aeroxteam@gmail.com> 2010, Gu1ll4um3r0m41n <aeroxteam@gmail.com>
2012, Simon Arlott 2012, Simon Arlott
+3
View File
@@ -16,5 +16,8 @@ override_dh_auto_configure:
-DCMAKE_SKIP_RPATH:BOOL=ON \ -DCMAKE_SKIP_RPATH:BOOL=ON \
-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON -DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
override_dh_installchangelogs:
dh_installchangelogs ChangeLog.adoc
%: %:
dh $@ --builddirectory=$(BUILDDIR) dh $@ --builddirectory=$(BUILDDIR)
-3
View File
@@ -1,3 +0,0 @@
tar-ignore = ".git"
tar-ignore = "build"
tar-ignore = "release"
+4 -5
View File
@@ -1,5 +1,4 @@
AUTHORS.md AUTHORS.adoc
CHANGELOG.md Contributing.adoc
CONTRIBUTING.md README.adoc
README.md ReleaseNotes.adoc
UPGRADING.md
-1
View File
@@ -7,4 +7,3 @@ usr/share/man/it/man1/weechat.1.gz usr/share/man/it/man1/weechat-curses.1.gz
usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz
usr/share/man/pl/man1/weechat.1.gz usr/share/man/pl/man1/weechat-curses.1.gz usr/share/man/pl/man1/weechat.1.gz usr/share/man/pl/man1/weechat-curses.1.gz
usr/share/man/ru/man1/weechat.1.gz usr/share/man/ru/man1/weechat-curses.1.gz usr/share/man/ru/man1/weechat.1.gz usr/share/man/ru/man1/weechat-curses.1.gz
usr/share/man/sr/man1/weechat.1.gz usr/share/man/sr/man1/weechat-curses.1.gz
@@ -1,10 +0,0 @@
Document: weechat-relay-api-en
Title: WeeChat Relay "api" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-api-fr
Title: WeeChat Relay "api" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
-10
View File
@@ -1,10 +0,0 @@
Document: weechat-dev-sr
Title: WeeChat developer's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html
-10
View File
@@ -1,10 +0,0 @@
Document: weechat-faq-sr
Title: WeeChat FAQ (Serbian)
Author: Sébastien Helleu
Abstract: This document answers frequently asked questions
about the WeeChat IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html
@@ -1,10 +0,0 @@
Document: weechat-plugin-sr
Title: WeeChat plugin API reference (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html
@@ -1,9 +0,0 @@
Document: weechat-quickstart-cs
Title: WeeChat quick start guide (Czech)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Czech version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html
Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html
@@ -1,9 +0,0 @@
Document: weechat-quickstart-sr
Title: WeeChat quick start guide (Serbian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-en
Title: WeeChat Relay protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-fr
Title: WeeChat Relay protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-protocol-ja
Title: WeeChat Relay protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-en
Title: WeeChat Relay "weechat" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-fr
Title: WeeChat Relay "weechat" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-ja
Title: WeeChat Relay "weechat" protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html
@@ -1,10 +0,0 @@
Document: weechat-relay-weechat-sr
Title: WeeChat Relay "weechat" protocol (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html
@@ -1,10 +0,0 @@
Document: weechat-scripting-sr
Title: WeeChat scripting guide (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html
@@ -1,10 +0,0 @@
Document: weechat-user-sr
Title: WeeChat user's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_user.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_user.sr.html
+61 -52
View File
@@ -1,5 +1,5 @@
# #
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org> # Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org> # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
# #
# This file is part of WeeChat, the extensible chat client. # This file is part of WeeChat, the extensible chat client.
@@ -28,8 +28,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
set(SCRIPTING_LANG de en fr it ja pl sr) set(SCRIPTING_LANG de en fr it ja pl sr)
set(FAQ_LANG de en es fr it ja pl sr) set(FAQ_LANG de en es fr it ja pl sr)
set(QUICKSTART_LANG cs de en es fr it ja pl ru sr) set(QUICKSTART_LANG cs de en es fr it ja pl ru sr)
set(RELAY_API_LANG en fr) set(RELAY_LANG en fr ja sr)
set(RELAY_WEECHAT_LANG en fr ja sr)
set(DEV_LANG en fr ja sr) set(DEV_LANG en fr ja sr)
find_package(Asciidoctor) find_package(Asciidoctor)
@@ -40,6 +39,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a reproducible -a reproducible
-a "prewrap!" -a "prewrap!"
-a "webfonts!" -a "webfonts!"
-a icons=font
-a revnumber="${VERSION}" -a revnumber="${VERSION}"
-a sectanchors -a sectanchors
-a source-highlighter=pygments -a source-highlighter=pygments
@@ -93,17 +93,8 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a docinfo1 -a docinfo1
) )
# asciidoctor arguments for relay "api" # asciidoctor arguments for relay protocol
set(ASCIIDOCTOR_RELAY_API_ARGS set(ASCIIDOCTOR_RELAY_ARGS
-a toc=left
-a toclevels=3
-a sectnums
-a sectnumlevels=2
-a docinfo1
)
# asciidoctor arguments for relay "weechat"
set(ASCIIDOCTOR_RELAY_WEECHAT_ARGS
-a toc=left -a toc=left
-a toclevels=3 -a toclevels=3
-a sectnums -a sectnums
@@ -120,6 +111,54 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a docinfo1 -a docinfo1
) )
# sed arguments used to replace links in ChangeLog and release notes
set(SED_LINKS_ARGS
-e "'s/issue #\\([0-9][0-9]*\\)/https:\\/\\/github.com\\/weechat\\/weechat\\/issues\\/\\1[issue #\\1^]/g'"
-e "'s/bug #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/bugs\\/?\\1[bug #\\1^]/g'"
-e "'s/task #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/task\\/?\\1[task #\\1^]/g'"
-e "'s/patch #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/patch\\/?\\1[patch #\\1^]/g'"
-e "'s/debian #\\([0-9][0-9]*\\)/http:\\/\\/bugs.debian.org\\/cgi-bin\\/bugreport.cgi?bug=\\1[debian bug #\\1^]/g'"
-e "'s/\\(CVE-[0-9][0-9]*-[0-9][0-9]*\\)/https:\\/\\/cve.mitre.org\\/cgi-bin\\/cvename.cgi?name=\\1[\\1^]/g'"
)
# ChangeLog
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
)
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ChangeLog.html "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building ChangeLog.html"
)
add_custom_target(changelog DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html")
# Release notes
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
)
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ReleaseNotes.html "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building ReleaseNotes.html"
)
add_custom_target(rn DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html")
if(ENABLE_DOC) if(ENABLE_DOC)
set(AUTOGEN_FILES "") set(AUTOGEN_FILES "")
foreach(lang ${AUTOGEN_LANG}) foreach(lang ${AUTOGEN_LANG})
@@ -138,9 +177,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_default_aliases.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_default_aliases.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_irc_colors.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_irc_colors.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_options.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_options.${lang}.adoc"
# scripting duide
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_functions.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_constants.${lang}.adoc"
) )
endforeach() endforeach()
add_custom_target(doc-autogen ALL add_custom_target(doc-autogen ALL
@@ -204,7 +240,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_user.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_user.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/cmdline_options.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/cmdline_options.${lang}.adoc"
doc-autogen doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_commands.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_commands.${lang}.adoc"
@@ -225,7 +260,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_plugin_api.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_plugin_api.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
doc-autogen doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_completions.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_completions.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_config_priority.${lang}.adoc" "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_config_priority.${lang}.adoc"
@@ -249,10 +283,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_scripting.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_scripting.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_functions.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_constants.${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_scripting.${lang}.html" COMMENT "Building weechat_scripting.${lang}.html"
) )
@@ -267,7 +297,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_faq.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_faq.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_faq.${lang}.html" COMMENT "Building weechat_faq.${lang}.html"
) )
@@ -282,44 +311,25 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_quickstart.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_quickstart.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_quickstart.${lang}.html" COMMENT "Building weechat_quickstart.${lang}.html"
) )
add_custom_target(doc-quickstart-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html") add_custom_target(doc-quickstart-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}") install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach() endforeach()
# relay "api" # relay protocol
foreach(lang ${RELAY_API_LANG}) foreach(lang ${RELAY_LANG})
add_custom_command( add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html" OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_API_ARGS} -o "weechat_relay_api.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc" COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_ARGS} -o "weechat_relay_protocol.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_relay_api.${lang}.html" COMMENT "Building weechat_relay_protocol.${lang}.html"
) )
add_custom_target(doc-relay-api-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html") add_custom_target(doc-relay-protocol-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}") install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach()
# relay "weechat"
foreach(lang ${RELAY_WEECHAT_LANG})
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_WEECHAT_ARGS} -o "weechat_relay_weechat.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_relay_weechat.${lang}.html"
)
add_custom_target(doc-relay-weechat-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach() endforeach()
# developer's guide # developer's guide
foreach(lang ${DEV_LANG}) foreach(lang ${DEV_LANG})
@@ -329,7 +339,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html" "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_dev.${lang}.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_dev.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_dev.${lang}.html" COMMENT "Building weechat_dev.${lang}.html"
) )
-23
View File
@@ -1,23 +0,0 @@
// czech translation, for reference only; matches the built-in behavior of core
:appendix-caption: Příloha
:appendix-refsig: {appendix-caption}
:caution-caption: Upozornění
:chapter-signifier: Kapitola
:chapter-refsig: {chapter-signifier}
:example-caption: Příklad
:figure-caption: Obrázek
:important-caption: Důležité
:last-update-label: Změněno
ifdef::listing-caption[:listing-caption: Seznam]
ifdef::manname-title[:manname-title: Název]
:note-caption: Poznámka
:part-signifier: Část
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Úvod]
:section-refsig: Oddíl
:table-caption: Tabulka
:tip-caption: Tip
:toc-title: Obsah
:untitled-label: Nepojmenovaný
:version-label: Verze
:warning-caption: Varování
-4
View File
@@ -39,10 +39,6 @@
*-h*, *--help*:: *-h*, *--help*::
Zobrazí nápovědu. Zobrazí nápovědu.
// TRANSLATION MISSING
*-i*, *--build-info*::
Display build information and exit.
*-l*, *--license*:: *-l*, *--license*::
Zobrazí licenci WeeChatu. Zobrazí licenci WeeChatu.
+2 -2
View File
@@ -97,9 +97,9 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[] // tag::copyright[]
WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
souboru AUTHORS.md). souboru AUTHORS.adoc).
Copyright (C) 2003-2024 {author} Copyright (C) 2003-2023 {author}
WeeChat is free software; you can redistribute it and/or modify WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by
+1 -3
View File
@@ -2,7 +2,6 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: cs :lang: cs
include::includes/attributes-cs.adoc[]
[[start]] [[start]]
== Spuštění WeeChatu == Spuštění WeeChatu
@@ -13,9 +12,8 @@ klávesových zkratek.
Spustění z Vašeho shellu: Spustění z Vašeho shellu:
[source,shell]
---- ----
weechat $ weechat
---- ----
[[help]] [[help]]
-23
View File
@@ -1,23 +0,0 @@
// German translation, courtesy of Florian Wilhelm
:appendix-caption: Anhang
:appendix-refsig: {appendix-caption}
:caution-caption: Achtung
:chapter-signifier: Kapitel
:chapter-refsig: {chapter-signifier}
:example-caption: Beispiel
:figure-caption: Abbildung
:important-caption: Wichtig
:last-update-label: Zuletzt aktualisiert
ifdef::listing-caption[:listing-caption: Listing]
ifdef::manname-title[:manname-title: Bezeichnung]
:note-caption: Anmerkung
:part-signifier: Teil
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Vorwort]
:section-refsig: Abschnitt
:table-caption: Tabelle
:tip-caption: Hinweis
:toc-title: Inhaltsverzeichnis
:untitled-label: Ohne Titel
:version-label: Version
:warning-caption: Warnung
-3
View File
@@ -35,9 +35,6 @@
*-h*, *--help*:: *-h*, *--help*::
zeigt einen Hilfstext an. zeigt einen Hilfstext an.
*-i*, *--build-info*::
Build-Informationen anzeigen und beenden.
*-l*, *--license*:: *-l*, *--license*::
zeigt die Lizenz von WeeChat an. zeigt die Lizenz von WeeChat an.
+2 -2
View File
@@ -98,9 +98,9 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[] // tag::copyright[]
WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
findet man in der AUTHORS.md Datei). findet man in der AUTHORS.adoc Datei).
Copyright (C) 2003-2024 {author} Copyright (C) 2003-2023 {author}
WeeChat is free software; you can redistribute it and/or modify WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by
+7 -42
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: de :lang: de
include::includes/attributes-de.adoc[] :toc-title: Inhaltsverzeichnis
Übersetzer: Übersetzer:
@@ -54,14 +54,12 @@ Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.
Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird. Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird.
Hilfe erhält man mittels: Hilfe erhält man mittels:
[source,shell]
---- ----
brew info weechat brew info weechat
---- ----
WeeChat kann durch folgenden Befehl installiert werden: WeeChat kann durch folgenden Befehl installiert werden:
[source,shell]
---- ----
brew install weechat brew install weechat
---- ----
@@ -333,16 +331,11 @@ unterstützt (rxvt-unicode, konsole, gnome-terminal, ... um nur einige zu nennen
Im Normalfall erfolgt die Markierung des Textes mittels der Tasten kbd:[Ctrl+Alt] Im Normalfall erfolgt die Markierung des Textes mittels der Tasten kbd:[Ctrl+Alt]
in Verbindung mit der Auswahl durch die Maus. in Verbindung mit der Auswahl durch die Maus.
// TRANSLATION MISSING
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Eine weitere Möglichkeit besteht darin, Eine weitere Möglichkeit besteht darin,
die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positionieren: die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positionieren:
---- ----
/set weechat.bar.nicklist.position top /set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
---- ----
[[urls]] [[urls]]
@@ -352,14 +345,10 @@ Dazu kann man den vereinfachten Anzeigemodus nutzen (Standardtaste: kbd:[Alt+l]
Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werden: Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werden:
// TRANSLATION MISSING
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
* Die Benutzerliste am oberen Bildschirmbereich positionieren. * Die Benutzerliste am oberen Bildschirmbereich positionieren.
---- ----
/set weechat.bar.nicklist.position top /set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
---- ----
* Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren. * Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren.
@@ -410,7 +399,6 @@ Umgebungsvariable `TZ` muss auf einen entsprechenden Wert eingestellt werden.
Am Besten machen Sie dies in Ihrer Shell-Initialisierungsdatei oder in der Am Besten machen Sie dies in Ihrer Shell-Initialisierungsdatei oder in der
Befehlszeile, bevor Sie WeeChat starten: Befehlszeile, bevor Sie WeeChat starten:
[source,shell]
---- ----
export TZ=Europe/Berlin export TZ=Europe/Berlin
---- ----
@@ -633,22 +621,6 @@ die von einer Weechat Version ≥ 4.0.0 erstellt wurde, sind die Tastennamen ung
Um dies zu reparieren, muss WeeChat beendet und alle Einträge aus dem Abschnitt `[key*]` innerhalb der weechat.conf entfernt werden. Um dies zu reparieren, muss WeeChat beendet und alle Einträge aus dem Abschnitt `[key*]` innerhalb der weechat.conf entfernt werden.
Wenn WeeChat erneut gestartet wird, wird die Standardtastenbelegung neu erstellt. Wenn WeeChat erneut gestartet wird, wird die Standardtastenbelegung neu erstellt.
[[key_f11]]
=== Die Taste F11 maximiert das Terminalfenster. Wie kann ich aber in der Nicklist nach oben scrollen?
Die kbd:[F11] Taste wird häufig von Terminals verwendet, um das Fenster zu maximieren. Aber
kbd:[F11]/kbd:[F12] sind ebenso die Standardtasten, in WeeChat, um in der Nickliste zu scrollen.
Man kann andere Tasten nutzen, zum Beispiel kbd:[Shift+F11] und kbd:[Shift+F12],
mit WeeChat ≥ 4.0.0:
----
/key bind shift-f11 /bar scroll nicklist * -100%
/key bind shift-f12 /bar scroll nicklist * +100%
----
Eine andere Möglichkeit besteht darin, die Maus zu aktivieren (Taste: kbd:[Alt+m]) und mit dem Mausrad zu scrollen (siehe auch Fragen zu <<mouse,mouse>>).
[[customize_key_bindings]] [[customize_key_bindings]]
=== Wie kann ich die Tastaturbelegung anpassen? === Wie kann ich die Tastaturbelegung anpassen?
@@ -725,9 +697,8 @@ Entsprechend der ausgegebenen Information, wird ggf. eine Maus nicht unterstütz
Um zu testen ob eine Mausunterstützung vom Terminal bereitgestellt wird, sollte Um zu testen ob eine Mausunterstützung vom Terminal bereitgestellt wird, sollte
man folgende Zeile im Terminal eingeben: man folgende Zeile im Terminal eingeben:
[source,shell]
---- ----
printf '\033[?1002h' $ printf '\033[?1002h'
---- ----
Jetzt klickt man mit der Maus auf das erste Zeichen im Terminal (linke obere Jetzt klickt man mit der Maus auf das erste Zeichen im Terminal (linke obere
@@ -735,9 +706,8 @@ Ecke). Als Ergebnis sollte man folgende Zeichenkette erhalten: " !!#!!".
Um die Mausunterstützung im Terminal zu beenden: Um die Mausunterstützung im Terminal zu beenden:
[source,shell]
---- ----
printf '\033[?1002l' $ printf '\033[?1002l'
---- ----
[[mouse_coords]] [[mouse_coords]]
@@ -804,7 +774,7 @@ Man sollte versuchen, eine andere Priorität zu nutzen; Im folgenden Beispiel
muss "xxx" durch den betroffenen Servernamen ersetzt werden: muss "xxx" durch den betroffenen Servernamen ersetzt werden:
---- ----
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT" /set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
---- ----
[[irc_tls_libera]] [[irc_tls_libera]]
@@ -1081,9 +1051,8 @@ Als erstes sollte das Kapitel über TLS Verbindungen in dieser FAQ gelesen werde
Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
folgenden Befehl in der Shell ausführen: folgenden Befehl in der Shell ausführen:
[source,shell]
---- ----
rm ~/.cache/weechat/script/plugins.xml.gz $ rm ~/.cache/weechat/script/plugins.xml.gz
---- ----
[NOTE] [NOTE]
@@ -1107,17 +1076,15 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
* und in der Shell, mit installiertem curl: * und in der Shell, mit installiertem curl:
[source,shell]
---- ----
cd ~/.cache/weechat/script $ cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz $ curl -O https://weechat.org/files/plugins.xml.gz
---- ----
Wenn Sie macOS ausführen und die heruntergeladene Datei eine Größe von 0 Byte hat, Wenn Sie macOS ausführen und die heruntergeladene Datei eine Größe von 0 Byte hat,
versuchen Sie, diese Variable in Ihrer Shell-Initialisierungsdatei oder auf der versuchen Sie, diese Variable in Ihrer Shell-Initialisierungsdatei oder auf der
Befehlszeile zu setzen. Bevor Sie WeeChat starten: Befehlszeile zu setzen. Bevor Sie WeeChat starten:
[source,shell]
---- ----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
---- ----
@@ -1289,7 +1256,6 @@ siehe https://weechat.org/about/support/[this page ^↗^^].
Falls man WeeChat in gdb ausführt, kann folgende Fehlermeldung erscheinen: Falls man WeeChat in gdb ausführt, kann folgende Fehlermeldung erscheinen:
[source,shell]
---- ----
$ gdb /Pfad/zu/weechat $ gdb /Pfad/zu/weechat
(gdb) run (gdb) run
@@ -1300,7 +1266,6 @@ Cannot find new threads: generic error
Um diesen Fehler zu beheben, sollte man gdb wie folgt aufrufen (der Pfad zu Um diesen Fehler zu beheben, sollte man gdb wie folgt aufrufen (der Pfad zu
libpthread und WeeChat muss natürlich an das eigene System angepasst werden): libpthread und WeeChat muss natürlich an das eigene System angepasst werden):
[source,shell]
---- ----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
(gdb) run (gdb) run
+2 -3
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: de :lang: de
include::includes/attributes-de.adoc[] :toc-title: Inhaltsverzeichnis
Übersetzer: Übersetzer:
@@ -19,9 +19,8 @@ keine Probleme mit der Standard Tastaturbelegung.
Programmstart aus deiner Shell: Programmstart aus deiner Shell:
[source,shell]
---- ----
weechat $ weechat
---- ----
[[help]] [[help]]
+307 -7
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: de :lang: de
include::includes/attributes-de.adoc[] :toc-title: Inhaltsverzeichnis
Übersetzer: Übersetzer:
@@ -73,7 +73,7 @@ und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_
WeeChat definiert ein `weechat` Module welches mittels `import weechat` WeeChat definiert ein `weechat` Module welches mittels `import weechat`
importiert werden muss. + importiert werden muss. +
Ein Python-Stub für die WeeChat-API ist im Repository verfügbar: Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^]. https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]] [[python_functions]]
===== Funktionen ===== Funktionen
@@ -373,10 +373,9 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
Ein Beispiel für ein Python-Skript: Ein Beispiel für ein Python-Skript:
[source,shell]
---- ----
cd ~/.local/share/weechat/python/autoload $ cd ~/.local/share/weechat/python/autoload
ln -s ../script.py $ ln -s ../script.py
---- ----
[NOTE] [NOTE]
@@ -565,14 +564,315 @@ lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^
Liste der Skript API Funktionen: Liste der Skript API Funktionen:
include::{autogendir}/autogen_scripting_functions.de.adoc[tag=functions] [width="100%",cols="1,5",options="header"]
|===
| Kategorie | Funktionen
| Allgemein
| register
| Erweiterungen
| plugin_get_name
| Strings
| charset_set +
iconv_to_internal +
iconv_from_internal +
gettext +
ngettext +
strlen_screen +
string_match +
string_match_list +
string_has_highlight +
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_parse_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
string_eval_expression +
string_eval_path_home
| Verzeichnisse
| mkdir_home +
mkdir +
mkdir_parents
| sortierte Listen
| list_new +
list_add +
list_search +
list_search_pos +
list_casesearch +
list_casesearch_pos +
list_get +
list_set +
list_next +
list_prev +
list_string +
list_size +
list_remove +
list_remove_all +
list_free
| Konfigurationsdatei
| config_new +
config_new_section +
config_search_section +
config_new_option +
config_search_option +
config_string_to_boolean +
config_option_reset +
config_option_set +
config_option_set_null +
config_option_unset +
config_option_rename +
config_option_is_null +
config_option_default_is_null +
config_boolean +
config_boolean_default +
config_integer +
config_integer_default +
config_string +
config_string_default +
config_color +
config_color_default +
config_write_option +
config_write_line +
config_write +
config_read +
config_reload +
config_option_free +
config_section_free_options +
config_section_free +
config_free +
config_get +
config_get_plugin +
config_is_set_plugin +
config_set_plugin +
config_set_desc_plugin +
config_unset_plugin
| Tastenbelegung
| key_bind +
key_unbind
| Ausgabe
| prefix +
color +
print (für Python: prnt) +
print_date_tags (für Python: prnt_date_tags) +
print_y (für Python: prnt_y) +
print_y_date_tags (für Python: prnt_y_date_tags) +
log_print
| Hooks
| hook_command +
hook_command_run +
hook_timer +
hook_fd +
hook_process +
hook_process_hashtable +
hook_connect +
hook_line +
hook_print +
hook_signal +
hook_signal_send +
hook_hsignal +
hook_hsignal_send +
hook_config +
hook_completion +
hook_modifier +
hook_modifier_exec +
hook_info +
hook_info_hashtable +
hook_infolist +
hook_focus +
hook_set +
unhook +
unhook_all
| Buffer
| buffer_new +
buffer_new_props +
current_buffer +
buffer_search +
buffer_search_main +
buffer_clear +
buffer_close +
buffer_merge +
buffer_unmerge +
buffer_get_integer +
buffer_get_string +
buffer_get_pointer +
buffer_set +
buffer_string_replace_local_var +
buffer_match_list
| Fenster
| current_window +
window_search_with_buffer +
window_get_integer +
window_get_string +
window_get_pointer +
window_set_title
| Nickliste
| nicklist_add_group +
nicklist_search_group +
nicklist_add_nick +
nicklist_search_nick +
nicklist_remove_group +
nicklist_remove_nick +
nicklist_remove_all +
nicklist_group_get_integer +
nicklist_group_get_string +
nicklist_group_get_pointer +
nicklist_group_set +
nicklist_nick_get_integer +
nicklist_nick_get_string +
nicklist_nick_get_pointer +
nicklist_nick_set
| Bars
| bar_item_search +
bar_item_new +
bar_item_update +
bar_item_remove +
bar_search +
bar_new +
bar_set +
bar_update +
bar_remove
| Befehle
| command +
command_options
| Vervollständigung
| completion_new +
completion_search +
completion_get_string +
completion_list_add +
completion_free
| Informationen
| info_get +
info_get_hashtable
| Infolisten
| infolist_new +
infolist_new_item +
infolist_new_var_integer +
infolist_new_var_string +
infolist_new_var_pointer +
infolist_new_var_time +
infolist_get +
infolist_next +
infolist_prev +
infolist_reset_item_cursor +
infolist_search_var +
infolist_fields +
infolist_integer +
infolist_string +
infolist_pointer +
infolist_time +
infolist_free
| hdata
| hdata_get +
hdata_get_var_offset +
hdata_get_var_type_string +
hdata_get_var_array_size +
hdata_get_var_array_size_string +
hdata_get_var_hdata +
hdata_get_list +
hdata_check_pointer +
hdata_move +
hdata_search +
hdata_char +
hdata_integer +
hdata_long +
hdata_string +
hdata_pointer +
hdata_time +
hdata_hashtable +
hdata_compare +
hdata_update +
hdata_get_string
| Upgrade
| upgrade_new +
upgrade_write_object +
upgrade_read +
upgrade_close
|===
[[script_api_constants]] [[script_api_constants]]
=== Konstanten === Konstanten
Liste der Konstanten in Skript API: Liste der Konstanten in Skript API:
include::{autogendir}/autogen_scripting_constants.de.adoc[tag=constants] [width="100%",cols="1,5",options="header"]
|===
| Kategorie | Konstanten
| return codes
| `WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| Konfigurationsdatei
| `WEECHAT_CONFIG_READ_OK` (integer) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_WRITE_OK` (integer) +
`WEECHAT_CONFIG_WRITE_ERROR` (integer) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
| sortierte Listen
| `WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| Hotlist
| `WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook Prozesse
| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook Connect
| `WEECHAT_HOOK_CONNECT_OK` (integer) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
| hook Signal
| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]] [[common_tasks]]
== Gemeinschaftsaufgabe == Gemeinschaftsaufgabe
+100 -245
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: de :lang: de
include::includes/attributes-de.adoc[] :toc-title: Inhaltsverzeichnis
Übersetzer: Übersetzer:
@@ -35,7 +35,7 @@ wesentliche Merkmale:
https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^], https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] und https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] und
https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^] https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
* IRC proxy und relay für WeeChat und Remote-Schnittstellen * IRC proxy und relay für remote Schnittstellen
* Betriebssystemunabhängig (GNU/Linux, *BSD, macOS, Windows und weitere) * Betriebssystemunabhängig (GNU/Linux, *BSD, macOS, Windows und weitere)
* 100% GPL, freie Software * 100% GPL, freie Software
@@ -115,7 +115,7 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
| cmake | ≥ 3.0 | cmake | ≥ 3.0
| bauen. | bauen.
| pkgconf / pkg-config | | pkg-config |
| entdeckt installierte Bibliotheken. | entdeckt installierte Bibliotheken.
| libncurses-dev | | libncurses-dev |
@@ -133,8 +133,7 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
| zlib1g-dev | | zlib1g-dev |
| Logger-Erweitertung: Kompression von rotierenden Protokolldateien (gzip). + | Logger-Erweitertung: Kompression von rotierenden Protokolldateien (gzip). +
Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
(api und weechat Protokollen). +
Script-Erweiterung: Lesen der Repository-Indexdatei (gzip). Script-Erweiterung: Lesen der Repository-Indexdatei (gzip).
|=== |===
@@ -160,14 +159,9 @@ WeeChat optional sind:
| ca-certificates | | ca-certificates |
| Zertifikate für TLS Verbindungen. | Zertifikate für TLS Verbindungen.
| libcjson-dev |
| Relay-Erweiterung: Protokoll "api" (HTTP REST API).
| libzstd-dev | ≥ 0.8.1 | libzstd-dev | ≥ 0.8.1
// TRANLSATION MISSING
| Logger-Erweiterung: Kompression von rotierenden Protokolldateien (zstandard). + | Logger-Erweiterung: Kompression von rotierenden Protokolldateien (zstandard). +
Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
(api and weechat protocols).
| libaspell-dev / libenchant-dev | | libaspell-dev / libenchant-dev |
| Spell Erweiterung. | Spell Erweiterung.
@@ -227,9 +221,8 @@ Falls eine Debian/Ubuntu basierte Distribution genutzt wird und man einen
es mit folgendem Befehl möglich alle notwendigen Abhängigkeiten zu es mit folgendem Befehl möglich alle notwendigen Abhängigkeiten zu
installieren: installieren:
[source,shell]
---- ----
sudo apt-get build-dep weechat # apt-get build-dep weechat
---- ----
[[build]] [[build]]
@@ -237,24 +230,22 @@ sudo apt-get build-dep weechat
* Installation in das Systemverzeichnis (benötigt _root_ Privilegien): * Installation in das Systemverzeichnis (benötigt _root_ Privilegien):
[source,shell]
---- ----
mkdir build $ mkdir build
cd build $ cd build
cmake .. $ cmake ..
make $ make
sudo make install $ sudo make install
---- ----
* Installation in ein benutzerdefiniertes Verzeichnis (zum Beispiel ins Heimatverzeichnis): * Installation in ein benutzerdefiniertes Verzeichnis (zum Beispiel ins Heimatverzeichnis):
[source,shell]
---- ----
mkdir build $ mkdir build
cd build $ cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis $ cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
make $ make
make install $ make install
---- ----
Optionen für CMake können mit dem Format, `-DOPTION=VALUE`, genutzt werden. Optionen für CMake können mit dem Format, `-DOPTION=VALUE`, genutzt werden.
@@ -288,9 +279,6 @@ Liste der verfügbaren Optionen:
| ENABLE_CHARSET | `ON`, `OFF` | ON | ENABLE_CHARSET | `ON`, `OFF` | ON
| kompiliert <<charset,Charset Erweiterung>>. | kompiliert <<charset,Charset Erweiterung>>.
| ENABLE_CJSON | `ON`, `OFF` | ON
| Unterstützung von JSON mittels https://github.com/DaveGamble/cJSON[cJSON ^↗^^] Bibliothek.
| ENABLE_MAN | `ON`, `OFF` | OFF | ENABLE_MAN | `ON`, `OFF` | OFF
| erstellt die man page. | erstellt die man page.
@@ -390,16 +378,14 @@ Liste der verfügbaren Optionen:
Weitere Optionen können mit folgendem Befehl angezeigt werden: Weitere Optionen können mit folgendem Befehl angezeigt werden:
[source,shell]
---- ----
cmake -LA $ cmake -LA
---- ----
oder mittels der Curses-Oberfläche: oder mittels der Curses-Oberfläche:
[source,shell]
---- ----
ccmake .. $ ccmake ..
---- ----
[[tests]] [[tests]]
@@ -412,16 +398,14 @@ Folgende Pakete werden *benötigt* um Tests zu kompilieren:
Tests muss aktiviert werden wenn WeeChat kompiliert wird: Tests muss aktiviert werden wenn WeeChat kompiliert wird:
[source,shell]
---- ----
cmake .. -DENABLE_TESTS=ON $ cmake .. -DENABLE_TESTS=ON
---- ----
Nach der Kompilierung wird die Testumgebung im build-Verzeichnis ausgeführt: Nach der Kompilierung wird die Testumgebung im build-Verzeichnis ausgeführt:
[source,shell]
---- ----
ctest -V $ ctest -V
---- ----
[[git_sources]] [[git_sources]]
@@ -432,9 +416,8 @@ sich die Quellen nicht kompilieren oder der Code ist nicht stabil. Sie sind hier
Um die Git Quellen zu beziehen nutzen Sie folgende Befehle: Um die Git Quellen zu beziehen nutzen Sie folgende Befehle:
[source,shell]
---- ----
git clone https://github.com/weechat/weechat.git $ git clone https://github.com/weechat/weechat.git
---- ----
Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_package,Quellpakete>>). Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_package,Quellpakete>>).
@@ -455,9 +438,8 @@ Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:
Bei der Kompilierung mit CMake muss folgende Option gesetzt werden: Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:
[source,shell]
---- ----
cmake .. -DCMAKE_BUILD_TYPE=Debug $ cmake .. -DCMAKE_BUILD_TYPE=Debug
---- ----
[[address_sanitizer]] [[address_sanitizer]]
@@ -466,9 +448,8 @@ cmake .. -DCMAKE_BUILD_TYPE=Debug
Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort
zum Absturz von WeeChat führt: zum Absturz von WeeChat führt:
[source,shell]
---- ----
cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address $ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
---- ----
[WARNING] [WARNING]
@@ -477,9 +458,8 @@ Absturz zu provozieren. Diese Funktion wird im produktiven Einsatz nicht empfohl
Nach dem Kompilieren und Installieren müssen Sie WeeChat folgendermaßen ausführen: Nach dem Kompilieren und Installieren müssen Sie WeeChat folgendermaßen ausführen:
[source,shell]
---- ----
ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat $ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
---- ----
Im Falle eines Absturzes befinden sich zusätzliche Informationen in der Datei, `asan.log`. Im Falle eines Absturzes befinden sich zusätzliche Informationen in der Datei, `asan.log`.
@@ -500,14 +480,12 @@ aktivieren, bevor WeeChat gestaret wird, wird der Befehl `ulimit` benötigt.
Zum Beispiel muss unter Linux in einer _bash_ Shell folgender Befehl in die `~/.bashrc` Zum Beispiel muss unter Linux in einer _bash_ Shell folgender Befehl in die `~/.bashrc`
Datei eingetragen werden: Datei eingetragen werden:
[source,shell]
---- ----
ulimit -c unlimited ulimit -c unlimited
---- ----
optional kann noch die maximale Dateigröße bestimmt werden: optional kann noch die maximale Dateigröße bestimmt werden:
[source,shell]
---- ----
ulimit -c 200000 ulimit -c 200000
---- ----
@@ -531,7 +509,6 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich
in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen: in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen:
[source,shell]
---- ----
gdb /usr/bin/weechat /home/user/core gdb /usr/bin/weechat /home/user/core
---- ----
@@ -550,11 +527,11 @@ Copying output to /tmp/crash.txt.
at /some_path/src/core/weechat.c:351 at /some_path/src/core/weechat.c:351
#3 <signal handler called> #3 <signal handler called>
#4 0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90, #4 0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364 remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
hook_process = 0x254eb90 hook_process = 0x254eb90
status = <value optimized out> status = <value optimized out>
#5 0x000000000044cc7d in hook_timer_exec () #5 0x000000000044cc7d in hook_timer_exec ()
at /some_path/src/core/core-hook.c:1025 at /some_path/src/core/wee-hook.c:1025
tv_time = {tv_sec = 1272693881, tv_usec = 212665} tv_time = {tv_sec = 1272693881, tv_usec = 212665}
ptr_hook = 0x2811f40 ptr_hook = 0x2811f40
next_hook = 0x0 next_hook = 0x0
@@ -579,7 +556,6 @@ Um eine laufende Sitzung von WeeChat zu debuggen (zum Beispiel wenn WeeChat nich
mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten (_12345_ muss durch mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten (_12345_ muss durch
die PID des laufenden weechat Prozesses ersetzt werden): die PID des laufenden weechat Prozesses ersetzt werden):
[source,shell]
---- ----
gdb /usr/bin/weechat 12345 gdb /usr/bin/weechat 12345
---- ----
@@ -595,9 +571,8 @@ Sollte WeeChat abgestürzt sein, muss der Befehl `bt full` genutzt werden:
Um WeeChat zu starten muss folgender Befehl ausgeführt werden: Um WeeChat zu starten muss folgender Befehl ausgeführt werden:
[source,shell]
---- ----
weechat $ weechat
---- ----
Wird WeeChat das erste mal ausgeführt, wird die Standardkonfiguration und Wird WeeChat das erste mal ausgeführt, wird die Standardkonfiguration und
@@ -815,24 +790,25 @@ Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann ent
die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf
einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten: einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten:
[source,shell]
---- ----
weechat --upgrade $ weechat --upgrade
---- ----
[[restart_after_upgrade]] [[restart_after_upgrade]]
=== Neustart nach Upgrade === Neustart nach Upgrade
[[restart_upgrading_notes]] [[restart_release_notes]]
==== Hinweise zum Upgrade ==== Versionshinweise
Nach einem Upgrade, wird *dringend empfohlen* das Dokukment Nach einem Upgrade wird *dringend empfohlen* die,
https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^] https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^^]
zu lesen. Dieses Dokument enthält wichtige Informationen zu wichtigen Änderungen und zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob
einige manuelle Aktionen, die erforderlich sein könnten. eventuell ein manuelles Eingreifen erforderlich sein könnte.
Es sollten die Versionen zwischen der alten (abgelaufenen) und der neuen Version (eingeschlossen) gelesen werden. + Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen)
Wenn beispielsweise von Version 4.0.0 auf 4.3.0 gewechselt wurde, ist es ratsam die Versionen von 4.0.1 bis 4.3.0 zu lesen. und Ihrer neuen Version (enthalten) lesen. +
Wenn Sie beispielsweise von Version 3.0 auf 3.2 wechseln, müssen Sie die Versionshinweise
der Versionen 3.1 und 3.2 lesen.
[[restart_configuration_upgrade]] [[restart_configuration_upgrade]]
==== Konfigurations-Upgrade ==== Konfigurations-Upgrade
@@ -944,30 +920,11 @@ In der _input_ Bar lautet die Standardeinstellung:
| Item | Beispiel | Beschreibung | Item | Beispiel | Beschreibung
| input_prompt | `[@Flashy(i)]` | Input prompt, für irc: Nick und Modi (Modus "+i" bedeutet auf libera, unsichtbar). | input_prompt | `[@Flashy(i)]` | Input prompt, für irc: Nick und Modi (Modus "+i" bedeutet auf libera, unsichtbar).
| away | `(away)` | Abwesenheitsanzeige. | away | `(away)` | Abwesenheitsanzeige.
| input_search | `[Search lines (~ str,msg)]` | Suchindikatoren ("`~`": Groß-und Kleinschreibung ignorieren, "`==`": Groß-und Kleinschreibung berücksichtigen, "`str`": einfache Textsuche, "`regex`": suche mit regulären Ausdrücken, "`msg`": Suche in Nachrichten, "`pre`": Suche in Präfix, "`pre\|msg`": Suche in Präfix und Nachrichten). | input_search | `[Search (~ str,msg)]` | Suchindikatoren ("`~`": Groß-und Kleinschreibung ignorieren, "`==`": Groß-und Kleinschreibung berücksichtigen, "`str`": einfache Textsuche, "`regex`": suche mit regulären Ausdrücken, "`msg`": Suche in Nachrichten, "`pre`": Suche in Präfix, "`pre\|msg`": Suche in Präfix und Nachrichten).
| input_paste | `[Paste 7 lines ? [ctrl-y] Ja [ctrl-n] Nein]` | Nachfrage, ob sieben Zeilen eingefügt werden sollen. | input_paste | `[Paste 7 lines ? [ctrl-y] Ja [ctrl-n] Nein]` | Nachfrage ob sieben Zeilen eingefügt werden sollen.
| input_text | `hi peter!` | Text der eingegeben wird. | input_text | `hi peter!` | Text der eingegeben wird.
|=== |===
Es existieren zwei Suchmodi:
* Suche in Zeilen, zum Beispiel `[Search lines (~ str,msg)]`, mit folgenden Infos:
** `~`: Groß-und Kleinschreibung ignorieren
** `==`: Groß-und Kleinschreibung berücksichtigen
** `str`: einfache Textsuche
** `regex`: suche mit regulären Ausdrücken
** `msg`: Suche in Nachrichten
** `pre`: Suche in Präfix
** `pre\|msg`: Suche in Präfix und Nachrichten
* Suche im Befehlsverlauf, zum Beispiel `[Search command (~ str,local)]`,
mit den folgenden Informationen:
** `~`: Groß-und Kleinschreibung ignorieren
** `==`: Groß-und Kleinschreibung berücksichtigen
** `str`: einfache Textsuche
** `regex`: suche mit regulären Ausdrücken
** `local`: suche im lokalen Bufferverlauf
** `global`: suche im globalen Verlauf
In der _nicklist_ Bar lautet die Standardeinstellung: In der _nicklist_ Bar lautet die Standardeinstellung:
[width="100%",cols="^3,^3,9",options="header"] [width="100%",cols="^3,^3,9",options="header"]
@@ -1059,11 +1016,6 @@ Zeichen, genutzt werden:
| kbd:[Ctrl+c], kbd:[c], | kbd:[Ctrl+c], kbd:[c],
kbd:[xx], kbd:[,], kbd:[xx], kbd:[,],
kbd:[yy] | Textfarbe `xx` und Hintergrundfarbe `yy` (siehe Farbtabelle). kbd:[yy] | Textfarbe `xx` und Hintergrundfarbe `yy` (siehe Farbtabelle).
| kbd:[Ctrl+c], kbd:[d],
kbd:[xxxxxx] | Textfarbe `xxxxxx` (RGB als hexadezimale Zahl, zum Beispiel `FF0000` für rot).
| kbd:[Ctrl+c], kbd:[d],
kbd:[xxxxxx], kbd:[,],
kbd:[yyyyyy] | Textfarbe `xxxxxx` und Hintergrundfarbe `yyyyyy` (RGB als hexadezimale Zahl).
| kbd:[Ctrl+c], kbd:[i] | Text wird kursiv dargestellt. | kbd:[Ctrl+c], kbd:[i] | Text wird kursiv dargestellt.
| kbd:[Ctrl+c], kbd:[o] | deaktiviert Farben und Attribute. | kbd:[Ctrl+c], kbd:[o] | deaktiviert Farben und Attribute.
| kbd:[Ctrl+c], kbd:[v] | Farben umkehren (kehrt Textfarbe und Hintergrundfarbe um). | kbd:[Ctrl+c], kbd:[v] | Farben umkehren (kehrt Textfarbe und Hintergrundfarbe um).
@@ -1071,8 +1023,8 @@ Zeichen, genutzt werden:
|=== |===
[NOTE] [NOTE]
Der selbe Code (ohne Nummer für kbd:[Ctrl+c], kbd:[c] und kbd:[Ctrl+c], kbd:[d]) Der selbe Befehl (ohne den Wert für kbd:[Ctrl+c], kbd:[c]) sollte genutzt werden
kann verwendet werden, um das Attribut zu stoppen. um die Farbkodierungen bzw. Attribute zu deaktivieren.
Farbtabelle für kbd:[Ctrl+c], kbd:[c]: Farbtabelle für kbd:[Ctrl+c], kbd:[c]:
@@ -1357,7 +1309,7 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
| no_filter | Zeile kann nicht gefiltert werden. | no_filter | Zeile kann nicht gefiltert werden.
| no_highlight | die Zeile kann nicht gehiglighted werden. | no_highlight | die Zeile kann nicht gehiglighted werden.
| no_log | Zeile wird nicht in die Log-Datei geschrieben. | no_log | Zeile wird nicht in die Log-Datei geschrieben.
| log0 … log9 | Grad der Protokollierung (siehe den Befehl <<command_logger_logger,/logger>>). | log0 … log9 | Grad der Protokollierung (siehe `/help logger`).
| notify_none | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^ | notify_none | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^
| notify_message | Diese Zeile ist eine User Nachricht. ^(1)^ | notify_message | Diese Zeile ist eine User Nachricht. ^(1)^
| notify_private | Diese Zeile ist eine private Nachricht. ^(1)^ | notify_private | Diese Zeile ist eine private Nachricht. ^(1)^
@@ -1635,7 +1587,6 @@ Sie können mit dem Befehl <<command_weechat_key,/key>> geändert und neue hinzu
| Taste | Beschreibung | Befehl | Taste | Beschreibung | Befehl
| kbd:[Ctrl+c], kbd:[b] | fügt Steuerzeichen für fett geschrieben Text ein. | `+/input insert \x02+` | kbd:[Ctrl+c], kbd:[b] | fügt Steuerzeichen für fett geschrieben Text ein. | `+/input insert \x02+`
| kbd:[Ctrl+c], kbd:[c] | fügt Steuerzeichen für Textfarbe ein. | `+/input insert \x03+` | kbd:[Ctrl+c], kbd:[c] | fügt Steuerzeichen für Textfarbe ein. | `+/input insert \x03+`
| kbd:[Ctrl+c], kbd:[d] | fügt Steuerzeichen für Textfarbe ein (RGB Farbe, als hexadezimale Zahl). | `+/input insert \x04+`
| kbd:[Ctrl+c], kbd:[i] | fügt Steuerzeichen für kursiven Text ein. | `+/input insert \x1D+` | kbd:[Ctrl+c], kbd:[i] | fügt Steuerzeichen für kursiven Text ein. | `+/input insert \x1D+`
| kbd:[Ctrl+c], kbd:[o] | fügt Steuerzeichen für Standardfarbe ein. | `+/input insert \x0F+` | kbd:[Ctrl+c], kbd:[o] | fügt Steuerzeichen für Standardfarbe ein. | `+/input insert \x0F+`
| kbd:[Ctrl+c], kbd:[v] | fügt Steuerzeichen für Hintergrundfarbe ein. | `+/input insert \x16+` | kbd:[Ctrl+c], kbd:[v] | fügt Steuerzeichen für Hintergrundfarbe ein. | `+/input insert \x16+`
@@ -1669,8 +1620,8 @@ Sie können mit dem Befehl <<command_weechat_key,/key>> geändert und neue hinzu
[width="100%",cols="^.^3,.^8,.^5",options="header"] [width="100%",cols="^.^3,.^8,.^5",options="header"]
|=== |===
| Taste | Beschreibung | Befehl | Taste | Beschreibung | Befehl
| kbd:[Ctrl+r] | sucht nach Text im Befehlsverlauf (siehe <<key_bindings_histsearch_context,keys for context "histsearch">>). | `+/input search_history+` | kbd:[Ctrl+r] | Textsuche im Verlaufsspeicher des Buffers (siehe <<key_bindings_search_context,Tasten für Such-Kontext>>). | `+/input search_text_here+`
| kbd:[Ctrl+s] | sucht nach Text in Bufferzeilen (siehe <<key_bindings_search_context,keys for context "search">>). | `+/input search_text_here+` | kbd:[Ctrl+s], kbd:[Ctrl+u] | setzt für alle Buffer die Markierung für ungelesene Nachrichten. | `+/allbuf /buffer set unread+`
| kbd:[Ctrl+x] | Wechseln Sie den aktuellen Buffer, wenn diese zusammengefügt worden sind, z.B. zwischen IRC-Serverbuffer wechseln. | `+/buffer switch+` | kbd:[Ctrl+x] | Wechseln Sie den aktuellen Buffer, wenn diese zusammengefügt worden sind, z.B. zwischen IRC-Serverbuffer wechseln. | `+/buffer switch+`
| kbd:[Alt+x] | Zoom eines zusammengefügten Buffers (kbd:[Alt+x] ein zweites mal: alle zusammengefügten Buffer werden angezeigt). | `+/buffer zoom+` | kbd:[Alt+x] | Zoom eines zusammengefügten Buffers (kbd:[Alt+x] ein zweites mal: alle zusammengefügten Buffer werden angezeigt). | `+/buffer zoom+`
| kbd:[PgUp] | eine Seite im Verlaufsspeicher des Buffers nach oben blättern. | `+/window page_up+` | kbd:[PgUp] | eine Seite im Verlaufsspeicher des Buffers nach oben blättern. | `+/window page_up+`
@@ -1696,7 +1647,6 @@ Sie können mit dem Befehl <<command_weechat_key,/key>> geändert und neue hinzu
| kbd:[Alt+n] | springt zur nächsten Highlight Nachricht. | `+/window scroll_next_highlight+` | kbd:[Alt+n] | springt zur nächsten Highlight Nachricht. | `+/window scroll_next_highlight+`
| kbd:[Alt+p] | springt zur vorherigen Highlight Nachricht. | `+/window scroll_previous_highlight+` | kbd:[Alt+p] | springt zur vorherigen Highlight Nachricht. | `+/window scroll_previous_highlight+`
| kbd:[Alt+u] | springt zur ersten ungelesenen Zeile im Buffer. | `+/window scroll_unread+` | kbd:[Alt+u] | springt zur ersten ungelesenen Zeile im Buffer. | `+/window scroll_unread+`
| kbd:[Alt+Shift+U] | setzt für alle Buffer die Markierung für ungelesene Nachrichten. | `+/allbuf /buffer set unread+`
| kbd:[Alt+<] | springt zum letzten besuchten Buffer. | `+/buffer jump prev_visited+` | kbd:[Alt+<] | springt zum letzten besuchten Buffer. | `+/buffer jump prev_visited+`
| kbd:[Alt+>] | springt zum nächsten besuchten Buffer. | `+/buffer jump next_visited+` | kbd:[Alt+>] | springt zum nächsten besuchten Buffer. | `+/buffer jump next_visited+`
| kbd:[Alt+/] | wechselt zum jeweils zuletzt angezeigten Buffern. | `+/buffer jump last_displayed+` | kbd:[Alt+/] | wechselt zum jeweils zuletzt angezeigten Buffern. | `+/buffer jump last_displayed+`
@@ -1773,48 +1723,23 @@ Sie können mit dem Befehl <<command_weechat_key,/key>> geändert und neue hinzu
[[key_bindings_search_context]] [[key_bindings_search_context]]
=== Suchkontext === Suchkontext
Diese Tasten werden im Kontext "search" verwendet (wenn kbd:[Ctrl+s] gedrückt wird, um Text Diese Tasten werden im Kontext "search" verwendet (wenn kbd:[Ctrl+r] genutzt wird um
in Bufferzeilen zu suchen). in einem Buffer nach einem Text zu suchen).
[width="100%",cols="^.^3,.^8,.^5",options="header"] [width="100%",cols="^.^3,.^8,.^5",options="header"]
|=== |===
| Taste | Beschreibung | Befehl | Taste | Beschreibung | Befehl
| kbd:[Ctrl+x] | Wechsel des Suchmodus: einfache Textsuche (Standard), reguläre Ausdrücke. | `+/input search_switch_regex+` | kbd:[Ctrl+r] | Wechsel des Suchmodus: einfache Textsuche (Standard), reguläre Ausdrücke. | `+/input search_switch_regex+`
| kbd:[Alt+c] | auf Groß-/Kleinschreibung umschalten. | `+/input search_switch_case+` | kbd:[Alt+c] | auf Groß-/Kleinschreibung umschalten. | `+/input search_switch_case+`
| kbd:[Tab] | wechselt Suche in: Nachricht (Standard), im Präfix, Präfix + Nachricht. | `+/input search_switch_where+` | kbd:[Tab] | wechselt Suche in: Nachricht (Standard), im Präfix, Präfix + Nachricht. | `+/input search_switch_where+`
| kbd:[Ctrl+r] + | kbd:[↑] | sucht vorheriger Zeile. | `+/input search_previous+`
kbd:[] | sucht vorheriger Zeile. | `+/input search_previous+` | kbd:[] | sucht nächste Zeile . | `+/input search_next+`
| kbd:[Ctrl+s] +
kbd:[↓] | sucht nächste Zeile . | `+/input search_next+`
| kbd:[Enter] + | kbd:[Enter] +
kbd:[Ctrl+j] + kbd:[Ctrl+j] +
kbd:[Ctrl+m] | beendet Suche ab aktueller Position. | `+/input search_stop_here+` kbd:[Ctrl+m] | beendet Suche ab aktueller Position. | `+/input search_stop_here+`
| kbd:[Ctrl+q] | Suche wird abgebrochen und der Bildlauf wird auf die Vortextsuche zurückgesetzt. | `+/input search_stop+` | kbd:[Ctrl+q] | Suche wird abgebrochen und der Bildlauf wird auf die Vortextsuche zurückgesetzt. | `+/input search_stop+`
|=== |===
[[key_bindings_histsearch_context]]
=== Kontext der Verlaufssuche
Diese Tasten werden im Kontext "histsearch" verwendet (wenn kbd:[Ctrl+r] gedrückt wird, um Text
im Befehlsverlauf zu suchen).
[width="100%",cols="^.^3,.^8,.^5",options="header"]
|===
| Taste | Beschreibung | Befehl
| kbd:[Ctrl+x] | Wechsel des Suchmodus: einfache Textsuche (Standard), reguläre Ausdrücke. | `+/input search_switch_regex+`
| kbd:[Alt+c] | auf Groß-/Kleinschreibung umschalten. | `+/input search_switch_case+`
| kbd:[Tab] | umschalten der Suche für: lokaler Bufferverlauf (Standard), globaler Verlauf. | `+/input search_switch_where+`
| kbd:[Ctrl+r] +
kbd:[↑] | Suche in vorherigen (älteren) Verlaufseinträgen. | `+/input search_previous+`
| kbd:[Ctrl+s] +
kbd:[↓] | Suche in nachfolgenden (neueren) Verlaufseinträgen. | `+/input search_next+`
| kbd:[Enter] +
kbd:[Ctrl+j] +
kbd:[Ctrl+m] | Suche stoppen und übereinstimmende Eingaben verwenden. | `+/input search_stop_here+`
| kbd:[Ctrl+o] | führt den im Verlauf gefundenen Befehl aus und fügt den nächsten in die Befehlszeile ein. | `+/input history_use_get_next+`
| kbd:[Ctrl+q] | stoppt die Suche und stellt die Eingabe auf ihren ursprünglichen Wert zurück. | `+/input search_stop+`
|===
[[key_bindings_cursor_context]] [[key_bindings_cursor_context]]
=== Cursor-Kontext === Cursor-Kontext
@@ -2736,37 +2661,27 @@ und löschen (für die Syntax, siehe Befehl <<command_weechat_key,/key>>).
Der Name eines Ereignisses besteht aus einem Modifier (optional), einer Maustaste/Mausrad Der Name eines Ereignisses besteht aus einem Modifier (optional), einer Maustaste/Mausrad
und der Mausgeste (optional). Die unterschiedlichen Elemente werden durch ein `+-+` getrennt. und der Mausgeste (optional). Die unterschiedlichen Elemente werden durch ein `+-+` getrennt.
Liste der Modifikatoren (in der Reihenfolge des Ereignisnamens): Liste der Modifiers:
[width="100%",cols="1m,4",options="header"] [width="100%",cols="1m,4",options="header"]
|=== |===
| Modifier | Beschreibung | Modifier | Beschreibung
| alt | Taste kbd:[Alt]
| ctrl | Taste kbd:[Ctrl] | ctrl | Taste kbd:[Ctrl]
| shift | Taste kbd:[Shift] ^(1)^ | alt | Taste kbd:[Alt]
| ctrl-alt | Taste kbd:[Ctrl] + kbd:[Alt]
|=== |===
[NOTE]
^(1)^ Der `shift` Modifikator sollte in WeeChat selten verwendet werden, da es viele Terminals gibt
die diesen Modifikator nutzen, um Mausereignisse direkt abzufangen.
Verschiedene Modifikatoren können kombiniert werden, zum Beispiel:
* `alt-ctrl`
* `ctrl-shift`
* `alt-ctrl-shift`
Liste der Maustasten/Mausrad: Liste der Maustasten/Mausrad:
[width="100%",cols="1m,4",options="header"] [width="100%",cols="1m,4",options="header"]
|=== |===
| Maustaste/-rad | Beschreibung | Maustaste/-rad | Beschreibung
| button1 | Linker Mausknopf wird gedrückt | button1 | Linker Mausknopf wird gedrückt
| button2 | Rechter Mausknopf wird gedrückt | button2 | Rechter Mausknopf wird gedrückt
| button3 | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad) | button3 | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad)
| button4 ... button11 | Ein zusätzlicher Mausknopf wird gedrückt | button4 ... button9 | Ein zusätzlicher Mausknopf wird gedrückt
| wheelup | Mausrad wird nach oben gescrollt | wheelup | Mausrad wird nach oben gescrollt
| wheeldown | Mausrad wird nach unten gescrollt | wheeldown | Mausrad wird nach unten gescrollt
|=== |===
Liste der Mausgesten (nur für Maustasten, nicht für das Mausrad, anwendbar): Liste der Mausgesten (nur für Maustasten, nicht für das Mausrad, anwendbar):
@@ -2802,7 +2717,7 @@ Bespiele von Ereignissen:
* `button1-event-drag` * `button1-event-drag`
* `alt-button2-gesture-down-long` * `alt-button2-gesture-down-long`
* `wheelup` * `wheelup`
* `alt-ctrl-wheeldown` * `ctrl-alt-wheeldown`
[TIP] [TIP]
Wird eine Funktion im "mouse"-Kontext hinzufügt ist es möglich, mehrere Wird eine Funktion im "mouse"-Kontext hinzufügt ist es möglich, mehrere
@@ -2864,9 +2779,8 @@ Option in die Sektion "option" der Aspell-Konfiguration hinzufügt.
Den Name der Option findet man in der ASpell-Konfigurationsdatei. Eine Auflistung aller Den Name der Option findet man in der ASpell-Konfigurationsdatei. Eine Auflistung aller
möglichen Optionen erhält man durch: möglichen Optionen erhält man durch:
[source,shell]
---- ----
aspell config $ aspell config
---- ----
Um zum Beispiel die Option "ignore-case" einzuschalten: Um zum Beispiel die Option "ignore-case" einzuschalten:
@@ -3318,7 +3232,7 @@ Passwörter beinhalten. Dies dient dazu Passwörter nicht im Klartext als
Wert einer Option zu sichern. Dazu wird folgendes Format, anstelle des Wert einer Option zu sichern. Dazu wird folgendes Format, anstelle des
Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man
dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). + dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). +
Für eine vollständige Liste der unterstützen Optionen, siehe den Befehl <<command_weechat_secure,/secure>>. Für eine vollständige Liste aller unterstützten Optionen, siehe `/help secure`.
Um z.B. das oben eingestellte _libera_ Passwort für eine Um z.B. das oben eingestellte _libera_ Passwort für eine
<<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen: <<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen:
@@ -3441,9 +3355,8 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten
der Kanäle _#weechat_ und _#weechat-fr_ (Standardport (6667) wird genutzt): der Kanäle _#weechat_ und _#weechat-fr_ (Standardport (6667) wird genutzt):
[source,shell]
---- ----
weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
---- ----
[[irc_servers]] [[irc_servers]]
@@ -3601,10 +3514,9 @@ die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat.
* Importieren Sie die Zertifikate in einer Shell: * Importieren Sie die Zertifikate in einer Shell:
[source,shell]
---- ----
mkdir -p ~/.config/weechat/tls $ mkdir -p ~/.config/weechat/tls
wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt $ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
---- ----
[NOTE] [NOTE]
@@ -3625,11 +3537,10 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden.
* Erstellen Sie ein Zertifikat in der Shell: * Erstellen Sie ein Zertifikat in der Shell:
[source,shell]
---- ----
mkdir -p ~/.config/weechat/tls $ mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls $ cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
---- ----
[NOTE] [NOTE]
@@ -3678,9 +3589,8 @@ dadurch kein Passwort während des Verbindungsaufbaus benötigt).
Ein Schlüssel kann mit folgendem Befehl erzeugt werden: Ein Schlüssel kann mit folgendem Befehl erzeugt werden:
[source,shell]
---- ----
openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem $ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
---- ----
[NOTE] [NOTE]
@@ -3690,9 +3600,8 @@ das auch beispielsweise `~/.weechat` sein kann.
Um den öffentlichen Schlüssel zu erhalten (base64 enkodiert) muss Um den öffentlichen Schlüssel zu erhalten (base64 enkodiert) muss
folgender Befehl ausgeführt werden: folgender Befehl ausgeführt werden:
[source,shell]
---- ----
openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64 $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
---- ----
Nun Verbindung zum Server herstellen, identifizieren (z.B. mittels "nickserv identify") Nun Verbindung zum Server herstellen, identifizieren (z.B. mittels "nickserv identify")
@@ -3762,9 +3671,8 @@ Privatsphäre und Sicherheit im Internet verbessern können.
Im ersten Schritt muss Tor installiert werden. Für Debian (und Derivate): Im ersten Schritt muss Tor installiert werden. Für Debian (und Derivate):
[source,shell]
---- ----
sudo apt-get install tor $ sudo apt-get install tor
---- ----
In WeeChat muss nun ein socks5-Proxy für den Tor Service erstellt werden (Hostname/IP In WeeChat muss nun ein socks5-Proxy für den Tor Service erstellt werden (Hostname/IP
@@ -4188,7 +4096,7 @@ Schlüssel erfordert, aber nicht `#channel2`:
/set irc.server.libera.autojoin "#channel1,#channel2 key1" /set irc.server.libera.autojoin "#channel1,#channel2 key1"
---- ----
Hilfe zum Format findet man unter Option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>. Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`.
[[irc_private_messages]] [[irc_private_messages]]
=== private Nachrichten === private Nachrichten
@@ -4237,7 +4145,7 @@ damit die Zeilen im Buffer unterdrückt werden. Zum Beispiel:
---- ----
Dabei ist es möglich, einen Filter für nur einen Kanal oder für mehrere Kanäle zu erstellen, die mit Dabei ist es möglich, einen Filter für nur einen Kanal oder für mehrere Kanäle zu erstellen, die mit
dem selben Namen beginnen (siehe den Befehl <<command_weechat_filter,/filter>>): dem selben Namen beginnen (siehe `/help filter`):
---- ----
/filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter * /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4631,13 +4539,8 @@ Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokoll
* _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu * _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
IRC Servern zu unterhalten. IRC Servern zu unterhalten.
* _api_: HTTP REST API, wird von WeeChat und Remote-Schnittstellen zur Anzeige und * _weechat_: Protokoll, das von Remote-Schnittstellen zur Anzeige und Interaktion verwendet wird
Interaktion mit WeeChat verwendet WeeChat, siehe https://weechat.org/about/interfaces/[this page ^↗^^].
* _weechat_: von Remote-Schnittstellen verwendetes Protokoll zur Anzeige und Interaktion mit
WeeChat.
Für die _api_ und _weechat_ Protokolle findet man eine Liste der Remote-Schnittstellen auf
https://weechat.org/about/interfaces/[this page ^↗^^].
[[relay_password]] [[relay_password]]
=== Passwort === Passwort
@@ -4649,13 +4552,14 @@ Es wird dringend empfohlen, mit diesen Befehlen ein Passwort für das Relay fest
/set relay.network.password "${sec.data.relay}" /set relay.network.password "${sec.data.relay}"
---- ----
Dieses Passwort wird bei allen Protokollen verwendet. Dieses Passwort wird sowohl für das _irc_ als auch für das _weechat_ Protokoll
verwendet.
[[relay_totp]] [[relay_totp]]
=== TOTP === TOTP
TOTP (Time-based One-Time Password) kann als sekundärer Authentifizierungsfaktor TOTP (Time-based One-Time Passwort) ist eine Zwei-Faktor-Authentifizierung
für die Protokolle _api_ und _weechat_ zusätzlich zum Passwort verwendet werden. für das _weechat_ Protokoll, als Ergänzung zum eigentlichen Passwort.
Diese Funktion is optional und erhöht den Sicherheitsgrad. Diese Funktion is optional und erhöht den Sicherheitsgrad.
@@ -4693,11 +4597,10 @@ Der Standardpfad zum Zertifikat/Schlüssel wird durch die Option definiert
Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen
erstellen: erstellen:
[source,shell]
---- ----
mkdir -p ~/.config/weechat/tls $ mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls $ cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem $ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
---- ----
[NOTE] [NOTE]
@@ -4753,38 +4656,6 @@ folgenden Befehlen einrichten:
/set irc.server.relay.password "${sec.data.relay_libera}" /set irc.server.relay.password "${sec.data.relay_libera}"
---- ----
[[relay_api_protocol]]
=== API protocol
Die Relay-Erweiterung kann Daten über ein HTTP REST API-Protokoll an einen Remote-WeeChat oder eine Remote-Schnittstelle senden.
Die API kann online durchstöbert und getestet werden:
https://weechat.org/api/[WeeChat Relay API ^↗^^].
Sie können sich mit WeeChat oder einer Remote-Schnittstelle verbinden, siehe
https://weechat.org/about/interfaces/[this page ^↗^^].
Zum Beispiel:
----
/relay add api 9000
----
Jetzt kann man sich über Port 9000 mit einem WeeChat oder einer Remote-Schnittstelle
verbinden, indem das Passwort „mypassword“ verwendet wird.
So stellt man mit WeeChat eine Verbindung zu einem _api_ Relay her:
----
/remote add weechat http://localhost:9000 -password=mypassword
/remote connect weechat
----
[NOTE]
Der Remote-WeeChat muss dieselbe API-Version wie der lokale WeeChat nutzen.
Daher wird dringend empfohlen, auf dem Remote- und dem lokalen Client genau
dieselbe WeeChat-Version zu verwenden.
[[relay_weechat_protocol]] [[relay_weechat_protocol]]
=== WeeChat Protokoll === WeeChat Protokoll
@@ -4801,10 +4672,10 @@ dieses Protokoll verbinden.
Zum Beispiel: Zum Beispiel:
---- ----
/relay add weechat 9500 /relay add weechat 9000
---- ----
Nun kann man über den Port 9500 mittels einer Oberfläche und dem Passwort Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort
"meinPasswort" eine Verbindung zu WeeChat herstellen. "meinPasswort" eine Verbindung zu WeeChat herstellen.
[[relay_websocket]] [[relay_websocket]]
@@ -4821,13 +4692,11 @@ Ein WebSocket kann in HTML5, mit einer JavaScript Zeile, geöffnet werden:
[source,javascript] [source,javascript]
---- ----
websocket = new WebSocket("ws://server.com:9500/weechat"); websocket = new WebSocket("ws://server.com:9000/weechat");
---- ----
Der Port (im Beispiel: 9500) ist der Port der in der Relay Erweiterung angegeben wurde. Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben wurde.
Die URI muss immer auf "/weechat" enden (_irc_ und _weechat_ Protokoll).
Die URI muss mit „/weechat“ für die Protokolle _irc_ und _weechat_ und mit „/api“
für das Protokoll _api_ enden.
[[relay_unix_socket]] [[relay_unix_socket]]
=== UNIX Domain Sockets === UNIX Domain Sockets
@@ -4847,9 +4716,8 @@ andere Ports nicht geöffnet werden können.
OpenSSH nutzen: OpenSSH nutzen:
[source,shell]
---- ----
ssh -L 9000:.weechat/relay_socket user@hostname $ ssh -L 9000:.weechat/relay_socket user@hostname
---- ----
Dies leitet lokale relay Client Verbindungen von Port 9000 um, zu Dies leitet lokale relay Client Verbindungen von Port 9000 um, zu
@@ -4873,7 +4741,7 @@ Sektionen in Datei _relay.conf_:
| network | /set relay.network.* | Netzwerkoptionen. | network | /set relay.network.* | Netzwerkoptionen.
| irc | /set relay.irc.* | für das IRC Protokoll spezifische Optionen (IRC Proxy). | irc | /set relay.irc.* | für das IRC Protokoll spezifische Optionen (IRC Proxy).
| port | <<command_relay_relay,/relay add>> + | port | <<command_relay_relay,/relay add>> +
/set relay.port.* | Ports zur Nutzung der Relay-Erweiterung (Optionen können in Sektion hinzugefügt/entfernt werden). /set relay.port.* | Ports zur Nutzung der Relay-Erweiterung (IRC und weechat Protokolle) (Optionen können in Sektion hinzugefügt/entfernt werden).
|=== |===
Optionen: Optionen:
@@ -4937,39 +4805,34 @@ einige Beispiele:
* Ändert den eigenen Nick auf dem IRC Server libera in "newnick": * Ändert den eigenen Nick auf dem IRC Server libera in "newnick":
[source,shell]
---- ----
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345 $ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
---- ----
* Schickt eine Nachrich in den IRC #weechat Channel: * Schickt eine Nachrich in den IRC #weechat Channel:
[source,shell]
---- ----
echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345 $ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
---- ----
* Sendet eine mehrzeilige Nachricht in den IRC Kanal #test, wenn die Fähigkeit "draft/multiline" * Sendet eine mehrzeilige Nachricht in den IRC Kanal #test, wenn die Fähigkeit "draft/multiline"
auf dem Ergo Server aktiviert ist: auf dem Ergo Server aktiviert ist:
[source,shell]
---- ----
echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345 $ echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
---- ----
* Schickt eine Nachricht in den aktuellen Buffer: * Schickt eine Nachricht in den aktuellen Buffer:
[source,shell]
---- ----
echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345 $ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
---- ----
* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen * Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen
mit "\n" getrennt werden): mit "\n" getrennt werden):
[source,shell]
---- ----
printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345 $ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
---- ----
[[fifo_commands]] [[fifo_commands]]
@@ -5303,9 +5166,7 @@ Zutreffende Gruppen können in _replace_ verwendet werden:
* `+${re:0}+` nach `+${re:99}+`: `+${re:0}+` ist die ganze Trefferanzahl, `+${re:1}+` nach * `+${re:0}+` nach `+${re:99}+`: `+${re:0}+` ist die ganze Trefferanzahl, `+${re:1}+` nach
`+${re:99}+` sind als Gruppen erfasst. `+${re:99}+` sind als Gruppen erfasst.
* `pass:[${re:+}]`: das letzte Treffer (mit der höchsten Zahl) * `+${re:+}+`: das letzte Treffer (mit der höchsten Zahl)
* `+${re:#}+`: index of last group captured
* `+${re:repl_index}+`: index of replacement being done (starts to 1)
* `+${hide:c,${re:N}}+`: Treffer "N" mit allen Zeichen die durch "c" ersetzt wurden * `+${hide:c,${re:N}}+`: Treffer "N" mit allen Zeichen die durch "c" ersetzt wurden
(Beispiele: `+${hide:*,${re:2}}+` ist die Gruppe #2, mit allen Zeichen die durch (Beispiele: `+${hide:*,${re:2}}+` ist die Gruppe #2, mit allen Zeichen die durch
`+*+` ersetzt wurden). `+*+` ersetzt wurden).
@@ -5372,7 +5233,7 @@ Wenn _var_ nicht angegeben ist, wird die Standardvariable verwendet, sie hängt
| signal | tg_signal_data | | signal | tg_signal_data |
| hsignal | | | hsignal | |
| modifier | tg_string | tg_string | modifier | tg_string | tg_string
| line | message | buffer, buffer_name, y, date, date_usec, date_printed, date_usec_printed, str_time, tags, notify_level, highlight, prefix, message | line | message | buffer, buffer_name, y, date, date_printed, str_time, tags, notify_level, highlight, prefix, message
| print | tg_message | | print | tg_message |
| command | tg_argv_eol1 | | command | tg_argv_eol1 |
| command_run | tg_command | | command_run | tg_command |
@@ -5457,7 +5318,7 @@ und die Daten in einer Hashtable gesichert:
| server | string | Name des Server (Beispiel: "libera"). | server | string | Name des Server (Beispiel: "libera").
| tags | string | Tags in Nachricht (findet selten Verwendung). | tags | string | Tags in Nachricht (findet selten Verwendung).
| message_without_tags | string | Nachricht ohne Tags. | message_without_tags | string | Nachricht ohne Tags.
| nick | string | Nick. ^(1)^ | nick | string | Nick.
| host | string | Hostname. | host | string | Hostname.
| command | string | IRC Befehl (Beispiel: "PRIVMSG", "NOTICE", ...). | command | string | IRC Befehl (Beispiel: "PRIVMSG", "NOTICE", ...).
| channel | string | IRC Channel. | channel | string | IRC Channel.
@@ -5469,10 +5330,6 @@ und die Daten in einer Hashtable gesichert:
| pos_text | string | Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird). | pos_text | string | Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird).
|=== |===
[NOTE]
^(1)^ Der Nick, ist der Absender der Nachricht. +
Der eigene Nick für den Server ist `${irc_server.nick}`.
Sofern es sich bei den Daten um einen Pointer handelt, kann die Variable `+tg_signal_data+` Sofern es sich bei den Daten um einen Pointer handelt, kann die Variable `+tg_signal_data+`
wie im folgenden Beispiel genutzt werden um den Inhalt von hdata zu lesen (im Beispiel wie im folgenden Beispiel genutzt werden um den Inhalt von hdata zu lesen (im Beispiel
wird der Pointer eines Buffer verwendet): wird der Pointer eines Buffer verwendet):
@@ -5539,9 +5396,7 @@ Der Callback von "line" legt folgende Variablen in der Hashtable an:
| buffer_type | string | Buffertyp ("formatted" oder "free"). | buffer_type | string | Buffertyp ("formatted" oder "free").
| y | string | Zeilennummer bei einem Buffer mit freier Einteilung (≥ 0), -1 für einen Buffer mit formatiertem Inhalt. | y | string | Zeilennummer bei einem Buffer mit freier Einteilung (≥ 0), -1 für einen Buffer mit formatiertem Inhalt.
| date | string | Datum der Zeile (Zeitstempel). | date | string | Datum der Zeile (Zeitstempel).
| date_usec | string | Mikrosekunden des Zeilendatums.
| date_printed | string | Datum wann die Zeile dargestellt wurde (Zeitstempel). | date_printed | string | Datum wann die Zeile dargestellt wurde (Zeitstempel).
| date_usec_printed | string | Mikrosekunden des Datums, an dem die Zeile angezeigt wurde.
| str_time | string | Datum für Darstellung. Kann Farbkodierungen erhalten. | str_time | string | Datum für Darstellung. Kann Farbkodierungen erhalten.
| tags | string | Tags einer Nachricht (Komma wird automatisch zu Beginn und Ende den Tags hinzugefügt). | tags | string | Tags einer Nachricht (Komma wird automatisch zu Beginn und Ende den Tags hinzugefügt).
| displayed | string | "1" wenn Zeile dargestellt wird, "0" wenn Zeile gefiltert wird. | displayed | string | "1" wenn Zeile dargestellt wird, "0" wenn Zeile gefiltert wird.
@@ -5580,7 +5435,7 @@ Der Callback von "print" legt folgende Variablen in der Hashtable an:
|=== |===
| Variable | Typ | Beschreibung | Variable | Typ | Beschreibung
| buffer | pointer | Buffer. | buffer | pointer | Buffer.
| tg_date | string | Datum/Uhrzeit der Nachricht (Format: `%FT%T.%f`, siehe link:weechat_plugin_api.en.html#_util_strftimeval[WeeChat plugin API reference / util_strftimeval ^↗^^]). | tg_date | string | Datum/Uhrzeit der Nachricht (Format: `YYYY-MM-DD hh:mm:ss`).
| tg_displayed | string | "1" wenn Nachricht dargestellt wird, "0" falls Nachricht gefiltert wird. | tg_displayed | string | "1" wenn Nachricht dargestellt wird, "0" falls Nachricht gefiltert wird.
| tg_highlight | string | "1" falls es sich um eine Highlight-Nachricht handelt, andernfalls "0". | tg_highlight | string | "1" falls es sich um eine Highlight-Nachricht handelt, andernfalls "0".
| tg_prefix | string | Präfix. | tg_prefix | string | Präfix.
@@ -5645,7 +5500,7 @@ Der Callback von "timer" legt folgende Variablen in der Hashtable an:
|=== |===
| Variable | Typ | Beschreibung | Variable | Typ | Beschreibung
| tg_remaining_calls | string | Anzahl der noch ausstehenden Aufrufe. | tg_remaining_calls | string | Anzahl der noch ausstehenden Aufrufe.
| tg_date | string | aktuelles Datum und Uhrzeit (Format: `%FT%T.%f`, siehe link:weechat_plugin_api.en.html#_util_strftimeval[WeeChat plugin API reference / util_strftimeval ^↗^^]). | tg_date | string | aktuelles Datum und Uhrzeit (Format: `YYYY-MM-DD hh:mm:ss`).
|=== |===
[[trigger_data_config]] [[trigger_data_config]]
+1 -5
View File
@@ -1,6 +1,6 @@
<!-- <!--
Custom styles for Asciidoctor Custom styles for Asciidoctor
Copyright (C) 2016-2024 Sébastien Helleu <flashcode@flashtux.org> Copyright (C) 2016-2023 Sébastien Helleu <flashcode@flashtux.org>
--> -->
<style> <style>
@@ -198,10 +198,6 @@ mark {
/* syntax highlighting tuning */ /* syntax highlighting tuning */
pre.pygments {
color: #ddd !important;
}
pre.pygments .tok-cp { pre.pygments .tok-cp {
color: #44cfaf; color: #44cfaf;
} }
-23
View File
@@ -1,23 +0,0 @@
// English translation, for reference only; matches the built-in behavior of core
:appendix-caption: Appendix
:appendix-refsig: {appendix-caption}
:caution-caption: Caution
:chapter-signifier: Chapter
:chapter-refsig: {chapter-signifier}
:example-caption: Example
:figure-caption: Figure
:important-caption: Important
:last-update-label: Last updated
ifdef::listing-caption[:listing-caption: Listing]
ifdef::manname-title[:manname-title: Name]
:note-caption: Note
:part-signifier: Part
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Preface]
:section-refsig: Section
:table-caption: Table
:tip-caption: Tip
:toc-title: Table of Contents
:untitled-label: Untitled
:version-label: Version
:warning-caption: Warning
-3
View File
@@ -35,9 +35,6 @@
*-h*, *--help*:: *-h*, *--help*::
Display help. Display help.
*-i*, *--build-info*::
Display build information and exit.
*-l*, *--license*:: *-l*, *--license*::
Display WeeChat license. Display WeeChat license.
+2 -2
View File
@@ -98,9 +98,9 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[] // tag::copyright[]
WeeChat is written by Sébastien Helleu and contributors (complete list is in WeeChat is written by Sébastien Helleu and contributors (complete list is in
the AUTHORS.md file). the AUTHORS.adoc file).
Copyright (C) 2003-2024 {author} Copyright (C) 2003-2023 {author}
WeeChat is free software; you can redistribute it and/or modify WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by
-18
View File
@@ -1,18 +0,0 @@
// tag::diagram[]
....
┌──────────┐ Workstation
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS, …)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Mobile device
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone, …)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Other devices
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
network servers ncurses interface relay remote interfaces
....
// end::diagram[]
+363 -413
View File
@@ -2,7 +2,6 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: en :lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat. This manual documents WeeChat chat client, it is part of WeeChat.
@@ -113,97 +112,97 @@ WeeChat "core" is located in following directories:
[width="100%",cols="2m,3",options="header"] [width="100%",cols="2m,3",options="header"]
|=== |===
| Path/file | Description | Path/file | Description
| core/ | Core functions: entry point, internal structures. | core/ | Core functions: entry point, internal structures.
|    core-arraylist.c | Array lists. |    wee-arraylist.c | Array lists.
|    core-backtrace.c | Display a backtrace after a crash. |    wee-backtrace.c | Display a backtrace after a crash.
|    core-calc.c | Calculate result of expressions. |    wee-calc.c | Calculate result of expressions.
|    core-command.c | WeeChat core commands. |    wee-command.c | WeeChat core commands.
|    core-completion.c | Default completions. |    wee-completion.c | Default completions.
|    core-config-file.c | Configuration file management. |    wee-config-file.c | Configuration file management.
|    core-config.c | Configuration options for WeeChat core (file weechat.conf). |    wee-config.c | Configuration options for WeeChat core (file weechat.conf).
|    core-crypto.c | Cryptographic functions. |    wee-crypto.c | Cryptographic functions.
|    core-debug.c | Some debug functions. |    wee-debug.c | Some debug functions.
|    core-doc.c | Build of files for documentation. |    wee-doc.c | Build of files for documentation.
|    core-dir.c | Directory/file functions. |    wee-dir.c | Directory/file functions.
|    core-eval.c | Evaluation of expressions with references to internal vars. |    wee-eval.c | Evaluation of expressions with references to internal vars.
|    core-hashtable.c | Hashtables. |    wee-hashtable.c | Hashtables.
|    core-hdata.c | Hdata (direct access to data using hashtables). |    wee-hdata.c | Hdata (direct access to data using hashtables).
|    core-hook.c | Hooks. |    wee-hook.c | Hooks.
|    core-infolist.c | Infolists (lists with objects data). |    wee-infolist.c | Infolists (lists with objects data).
|    core-input.c | Input of commands/text. |    wee-input.c | Input of commands/text.
|    core-list.c | Sorted lists. |    wee-list.c | Sorted lists.
|    core-log.c | Write to WeeChat log file (weechat.log). |    wee-log.c | Write to WeeChat log file (weechat.log).
|    core-network.c | Network functions (connection to servers/proxies). |    wee-network.c | Network functions (connection to servers/proxies).
|    core-proxy.c | Proxy management. |    wee-proxy.c | Proxy management.
|    core-secure.c | Secured data functions. |    wee-secure.c | Secured data functions.
|    core-secure-buffer.c | Secured data buffer. |    wee-secure-buffer.c | Secured data buffer.
|    core-secure-config.c | Secured data options (file sec.conf). |    wee-secure-config.c | Secured data options (file sec.conf).
|    core-signal.c | Signal functions. |    wee-signal.c | Signal functions.
|    core-string.c | Functions on strings. |    wee-string.c | Functions on strings.
|    core-sys.c | System functions. |    wee-sys.c | System functions.
|    core-upgrade-file.c | Internal upgrade system. |    wee-upgrade-file.c | Internal upgrade system.
|    core-upgrade.c | Upgrade for WeeChat core (buffers, lines, history, ...). |    wee-upgrade.c | Upgrade for WeeChat core (buffers, lines, history, ...).
|    core-url.c | URL transfer (using libcurl). |    wee-url.c | URL transfer (using libcurl).
|    core-utf8.c | UTF-8 functions. |    wee-utf8.c | UTF-8 functions.
|    core-util.c | Some other functions. |    wee-util.c | Some other functions.
|    core-version.c | Functions for WeeChat version. |    wee-version.c | Functions for WeeChat version.
|    weechat.c | Main functions: command line options, startup. |    weechat.c | Main functions: command line options, startup.
|    hook/ | Hook functions. |    hook/ | Hook functions.
|       hook-command-run.c | Hook "command_run". |       wee-hook-command-run.c | Hook "command_run".
|       hook-command.c | Hook "command". |       wee-hook-command.c | Hook "command".
|       hook-completion.c | Hook "completion". |       wee-hook-completion.c | Hook "completion".
|       hook-config.c | Hook "config". |       wee-hook-config.c | Hook "config".
|       hook-connect.c | Hook "connect". |       wee-hook-connect.c | Hook "connect".
|       hook-fd.c | Hook "fd". |       wee-hook-fd.c | Hook "fd".
|       hook-focus.c | Hook "focus". |       wee-hook-focus.c | Hook "focus".
|       hook-hdata.c | Hook "hdata". |       wee-hook-hdata.c | Hook "hdata".
|       hook-hsignal.c | Hook "hsignal". |       wee-hook-hsignal.c | Hook "hsignal".
|       hook-info-hashtable.c | Hook "info_hashtable". |       wee-hook-info-hashtable.c | Hook "info_hashtable".
|       hook-info.c | Hook "info". |       wee-hook-info.c | Hook "info".
|       hook-infolist.c | Hook "infolist". |       wee-hook-infolist.c | Hook "infolist".
|       hook-line.c | Hook "line". |       wee-hook-line.c | Hook "line".
|       hook-modifier.c | Hook "modifier". |       wee-hook-modifier.c | Hook "modifier".
|       hook-print.c | Hook "print". |       wee-hook-print.c | Hook "print".
|       hook-process.c | Hook "process". |       wee-hook-process.c | Hook "process".
|       hook-signal.c | Hook "signal". |       wee-hook-signal.c | Hook "signal".
|       hook-timer.c | Hook "timer". |       wee-hook-timer.c | Hook "timer".
|       hook-url.c | Hook "url". |       wee-hook-url.c | Hook "url".
| gui/ | Functions for buffers, windows, ... (used by all interfaces). | gui/ | Functions for buffers, windows, ... (used by all interfaces).
|    gui-bar-item.c | Bar items. |    gui-bar-item.c | Bar items.
|    gui-bar-window.c | Bar windows. |    gui-bar-window.c | Bar windows.
|    gui-bar.c | Bars. |    gui-bar.c | Bars.
|    gui-buffer.c | Buffers. |    gui-buffer.c | Buffers.
|    gui-chat.c | Chat functions (display message, ...). |    gui-chat.c | Chat functions (display message, ...).
|    gui-color.c | Color functions. |    gui-color.c | Color functions.
|    gui-completion.c | Completion on command line. |    gui-completion.c | Completion on command line.
|    gui-cursor.c | Cursor mode (free movement of cursor). |    gui-cursor.c | Cursor mode (free movement of cursor).
|    gui-filter.c | Filters. |    gui-filter.c | Filters.
|    gui-focus.c | Functions about focus (for cursor mode and mouse). |    gui-focus.c | Functions about focus (for cursor mode and mouse).
|    gui-history.c | Commands/text saved in buffers. |    gui-history.c | Commands/text saved in buffers.
|    gui-hotlist.c | Hotlist management (list of buffers with activity). |    gui-hotlist.c | Hotlist management (list of buffers with activity).
|    gui-input.c | Input functions (input bar). |    gui-input.c | Input functions (input bar).
|    gui-key.c | Keyboard functions. |    gui-key.c | Keyboard functions.
|    gui-layout.c | Layout. |    gui-layout.c | Layout.
|    gui-line.c | Lines in buffers. |    gui-line.c | Lines in buffers.
|    gui-mouse.c | Mouse. |    gui-mouse.c | Mouse.
|    gui-nick.c | Nick functions. |    gui-nick.c | Nick functions.
|    gui-nicklist.c | Nicklist in buffers. |    gui-nicklist.c | Nicklist in buffers.
|    gui-window.c | Windows. |    gui-window.c | Windows.
|    curses/ | Curses interface. |    curses/ | Curses interface.
|       gui-curses-bar-window.c | Display in bar windows. |       gui-curses-bar-window.c | Display in bar windows.
|       gui-curses-chat.c | Display in chat area (messages). |       gui-curses-chat.c | Display in chat area (messages).
|       gui-curses-color.c | Color functions. |       gui-curses-color.c | Color functions.
|       gui-curses-key.c | Keyboard functions (default keys, read of input). |       gui-curses-key.c | Keyboard functions (default keys, read of input).
|       gui-curses-main.c | WeeChat main loop (waiting for keyboard/network events). |       gui-curses-main.c | WeeChat main loop (waiting for keyboard/network events).
|       gui-curses-mouse.c | Mouse. |       gui-curses-mouse.c | Mouse.
|       gui-curses-term.c | Functions about terminal. |       gui-curses-term.c | Functions about terminal.
|       gui-curses-window.c | Windows. |       gui-curses-window.c | Windows.
|       headless/ | Headless mode (no interface). |       headless/ | Headless mode (no interface).
|          main.c | Entry point for headless mode. |          main.c | Entry point for headless mode.
|          ncurses-fake.c | Fake ncurses library. |          ncurses-fake.c | Fake ncurses library.
|       normal/ | Curses interface. |       normal/ | Curses interface.
|          main.c | Entry point for Curses interface. |          main.c | Entry point for Curses interface.
|=== |===
[[sources_plugins]] [[sources_plugins]]
@@ -211,189 +210,180 @@ WeeChat "core" is located in following directories:
[width="100%",cols="2m,3",options="header"] [width="100%",cols="2m,3",options="header"]
|=== |===
| Path/file | Description | Path/file | Description
| plugins/ | Root of plugins. | plugins/ | Root of plugins.
|    plugin.c | Plugins management (load/unload dynamic C libraries). |    plugin.c | Plugins management (load/unload dynamic C libraries).
|    plugin-api.c | Extra functions for plugin API (wrapper around WeeChat core functions). |    plugin-api.c | Extra functions for plugin API (wrapper around WeeChat core functions).
|    plugin-api-info.c | Extra info/infolist functions for plugin API. |    plugin-api-info.c | Extra info/infolist functions for plugin API.
|    plugin-config.c | Plugin configuration options (file plugins.conf). |    plugin-config.c | Plugin configuration options (file plugins.conf).
|    plugin-script.c | Common functions used by script plugins. |    plugin-script.c | Common functions used by script plugins.
|    plugin-script-api.c | Script API functions: wrappers around some plugin API functions. |    plugin-script-api.c | Script API functions: wrappers around some plugin API functions.
|    plugin-script-config.c | Script plugin configuration options (files python.conf, perl.conf, ...). |    plugin-script-config.c | Script plugin configuration options (files python.conf, perl.conf, ...).
|    weechat-plugin.h | Header designed to be distributed with WeeChat plugins, in order to compile them. |    weechat-plugin.h | Header designed to be distributed with WeeChat plugins, in order to compile them.
|    alias/ | Alias plugin. |    alias/ | Alias plugin.
|       alias.c | Main alias functions. |       alias.c | Main alias functions.
|       alias-command.c | Alias commands. |       alias-command.c | Alias commands.
|       alias-completion.c | Alias completions. |       alias-completion.c | Alias completions.
|       alias-config.c | Alias config options (file alias.conf). |       alias-config.c | Alias config options (file alias.conf).
|       alias-info.c | Alias info/infolists/hdata. |       alias-info.c | Alias info/infolists/hdata.
|    spell/ | Spell checker plugin. |    spell/ | Spell checker plugin.
|       spell.c | Main spell checker functions. |       spell.c | Main spell checker functions.
|       spell-bar-item.c | Spell checker bar items. |       spell-bar-item.c | Spell checker bar items.
|       spell-command.c | Spell checker commands. |       spell-command.c | Spell checker commands.
|       spell-completion.c | Spell checker completions. |       spell-completion.c | Spell checker completions.
|       spell-config.c | Spell checker config options (file spell.conf). |       spell-config.c | Spell checker config options (file spell.conf).
|       spell-info.c | Spell checker info/infolists/hdata. |       spell-info.c | Spell checker info/infolists/hdata.
|       spell-speller.c | Spellers management. |       spell-speller.c | Spellers management.
|    buflist/ | Buflist plugin. |    buflist/ | Buflist plugin.
|       buflist.c | Main buflist functions. |       buflist.c | Main buflist functions.
|       buflist-bar-item.c | Buflist bar items. |       buflist-bar-item.c | Buflist bar items.
|       buflist-command.c | Buflist commands. |       buflist-command.c | Buflist commands.
|       buflist-completion.c | Buflist completions. |       buflist-completion.c | Buflist completions.
|       buflist-config.c | Buflist config options (file buflist.conf). |       buflist-config.c | Buflist config options (file buflist.conf).
|       buflist-info.c | Buflist info/infolists/hdata. |       buflist-info.c | Buflist info/infolists/hdata.
|       buflist-mouse.c | Buflist mouse actions. |       buflist-mouse.c | Buflist mouse actions.
|    charset/ | Charset plugin. |    charset/ | Charset plugin.
|       charset.c | Charset functions. |       charset.c | Charset functions.
|    exec/ | Exec plugin. |    exec/ | Exec plugin.
|       exec.c | Main exec functions. |       exec.c | Main exec functions.
|       exec-buffer.c | Exec buffer. |       exec-buffer.c | Exec buffer.
|       exec-command.c | Exec commands. |       exec-command.c | Exec commands.
|       exec-completion.c | Exec completions. |       exec-completion.c | Exec completions.
|       exec-config.c | Exec config options (file exec.conf). |       exec-config.c | Exec config options (file exec.conf).
|    fifo/ | Fifo plugin. |    fifo/ | Fifo plugin.
|       fifo.c | Main fifo functions. |       fifo.c | Main fifo functions.
|       fifo-command.c | Fifo commands. |       fifo-command.c | Fifo commands.
|       fifo-config.c | Fifo config options (file fifo.conf). |       fifo-config.c | Fifo config options (file fifo.conf).
|       fifo-info.c | Fifo info/infolists/hdata. |       fifo-info.c | Fifo info/infolists/hdata.
|    fset/ | Fset plugin. |    fset/ | Fset plugin.
|       fset.c | Main fset functions. |       fset.c | Main fset functions.
|       fset-bar-item.c | Fset bar items. |       fset-bar-item.c | Fset bar items.
|       fset-buffer.c | Fset buffer. |       fset-buffer.c | Fset buffer.
|       fset-command.c | Fset commands. |       fset-command.c | Fset commands.
|       fset-completion.c | Fset completions. |       fset-completion.c | Fset completions.
|       fset-config.c | Fset config options (file fset.conf). |       fset-config.c | Fset config options (file fset.conf).
|       fset-info.c | Fset info/infolists/hdata. |       fset-info.c | Fset info/infolists/hdata.
|       fset-mouse.c | Fset mouse actions. |       fset-mouse.c | Fset mouse actions.
|       fset-option.c | Fset options management. |       fset-option.c | Fset options management.
|    guile/ | Guile (scheme) plugin. |    guile/ | Guile (scheme) plugin.
|       weechat-guile.c | Main guile functions (load/unload scripts, execute guile code). |       weechat-guile.c | Main guile functions (load/unload scripts, execute guile code).
|       weechat-guile-api.c | Guile scripting API functions. |       weechat-guile-api.c | Guile scripting API functions.
|    irc/ | IRC (Internet Relay Chat) plugin. |    irc/ | IRC (Internet Relay Chat) plugin.
|       irc.c | Main IRC functions. |       irc.c | Main IRC functions.
|       irc-bar-item.c | IRC bar items. |       irc-bar-item.c | IRC bar items.
|       irc-batch.c | IRC batched events. |       irc-batch.c | IRC batched events.
|       irc-buffer.c | IRC buffers. |       irc-buffer.c | IRC buffers.
|       irc-channel.c | IRC channels. |       irc-channel.c | IRC channels.
|       irc-color.c | IRC colors. |       irc-color.c | IRC colors.
|       irc-command.c | IRC commands. |       irc-command.c | IRC commands.
|       irc-completion.c | IRC completions. |       irc-completion.c | IRC completions.
|       irc-config.c | IRC config options (file irc.conf). |       irc-config.c | IRC config options (file irc.conf).
|       irc-ctcp.c | IRC CTCP. |       irc-ctcp.c | IRC CTCP.
|       irc-debug.c | IRC debug functions. |       irc-debug.c | IRC debug functions.
|       irc-ignore.c | IRC Ignore. |       irc-ignore.c | IRC Ignore.
|       irc-info.c | IRC info/infolists/hdata. |       irc-info.c | IRC info/infolists/hdata.
|       irc-input.c | Input of commands/text. |       irc-input.c | Input of commands/text.
|       irc-join.c | Functions for list of channels to join. |       irc-join.c | Functions for list of channels to join.
|       irc-list.c | Buffer for reply to /list command. |       irc-list.c | Buffer for reply to /list command.
|       irc-message.c | Functions to manipulate IRC messages. |       irc-message.c | Functions to manipulate IRC messages.
|       irc-mode.c | Functions about channel/nick modes. |       irc-mode.c | Functions about channel/nick modes.
|       irc-modelist.c | IRC channel mode lists (+b, +e, +I, ...). |       irc-modelist.c | IRC channel mode lists (+b, +e, +I, ...).
|       irc-msgbuffer.c | Target buffer for IRC messages. |       irc-msgbuffer.c | Target buffer for IRC messages.
|       irc-nick.c | IRC nicks. |       irc-nick.c | IRC nicks.
|       irc-notify.c | IRC notify lists. |       irc-notify.c | IRC notify lists.
|       irc-protocol.c | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194). |       irc-protocol.c | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194).
|       irc-raw.c | IRC raw buffer. |       irc-raw.c | IRC raw buffer.
|       irc-redirect.c | Redirection of IRC command output. |       irc-redirect.c | Redirection of IRC command output.
|       irc-sasl.c | SASL authentication with IRC server. |       irc-sasl.c | SASL authentication with IRC server.
|       irc-server.c | I/O communication with IRC server. |       irc-server.c | I/O communication with IRC server.
|       irc-tag.c | Functions to manipulate IRC message tags. |       irc-tag.c | Functions to manipulate IRC message tags.
|       irc-typing.c | Typing status. |       irc-typing.c | Typing status.
|       irc-upgrade.c | Save/restore of IRC data when upgrading WeeChat. |       irc-upgrade.c | Save/restore of IRC data when upgrading WeeChat.
|    javascript/ | JavaScript plugin. |    javascript/ | JavaScript plugin.
|       weechat-js.cpp | Main JavaScript functions (load/unload scripts, execute JavaScript code). |       weechat-js.cpp | Main JavaScript functions (load/unload scripts, execute JavaScript code).
|       weechat-js-api.cpp | JavaScript scripting API functions. |       weechat-js-api.cpp | JavaScript scripting API functions.
|       weechat-js-v8.cpp | JavaScript v8 functions. |       weechat-js-v8.cpp | JavaScript v8 functions.
|    logger/ | Logger plugin. |    logger/ | Logger plugin.
|       logger.c | Main logger functions. |       logger.c | Main logger functions.
|       logger-backlog.c | Logger backlog functions. |       logger-backlog.c | Logger backlog functions.
|       logger-buffer.c | Logger buffer list management. |       logger-buffer.c | Logger buffer list management.
|       logger-command.c | Logger commands. |       logger-command.c | Logger commands.
|       logger-config.c | Logger config options (file logger.conf). |       logger-config.c | Logger config options (file logger.conf).
|       logger-info.c | Logger info/infolists/hdata. |       logger-info.c | Logger info/infolists/hdata.
|       logger-tail.c | Functions to get last lines of a file. |       logger-tail.c | Functions to get last lines of a file.
|    lua/ | Lua plugin. |    lua/ | Lua plugin.
|       weechat-lua.c | Main lua functions (load/unload scripts, execute lua code). |       weechat-lua.c | Main lua functions (load/unload scripts, execute lua code).
|       weechat-lua-api.c | Lua scripting API functions. |       weechat-lua-api.c | Lua scripting API functions.
|    perl/ | Perl plugin. |    perl/ | Perl plugin.
|       weechat-perl.c | Main perl functions (load/unload scripts, execute perl code). |       weechat-perl.c | Main perl functions (load/unload scripts, execute perl code).
|       weechat-perl-api.c | Perl scripting API functions. |       weechat-perl-api.c | Perl scripting API functions.
|    php/ | PHP plugin. |    php/ | PHP plugin.
|       weechat-php.c | Main PHP functions (load/unload scripts, execute PHP code). |       weechat-php.c | Main PHP functions (load/unload scripts, execute PHP code).
|       weechat-php-api.c | PHP scripting API functions. |       weechat-php-api.c | PHP scripting API functions.
|    python/ | Python plugin. |    python/ | Python plugin.
|       weechat-python.c | Main python functions (load/unload scripts, execute python code). |       weechat-python.c | Main python functions (load/unload scripts, execute python code).
|       weechat-python-api.c | Python scripting API functions. |       weechat-python-api.c | Python scripting API functions.
|    relay/ | Relay plugin (IRC proxy and relay for remote interfaces). |    relay/ | Relay plugin (IRC proxy and relay for remote interfaces).
|       relay.c | Main relay functions. |       relay.c | Main relay functions.
|       relay-auth.c | Clients authentication. |       relay-auth.c | Clients authentication.
|       relay-buffer.c | Relay buffer. |       relay-buffer.c | Relay buffer.
|       relay-client.c | Clients of relay. |       relay-client.c | Clients of relay.
|       relay-command.c | Relay commands. |       relay-command.c | Relay commands.
|       relay-completion.c | Relay completions. |       relay-completion.c | Relay completions.
|       relay-config.c | Relay config options (file relay.conf). |       relay-config.c | Relay config options (file relay.conf).
|       relay-http.c | HTTP functions. |       relay-info.c | Relay info/infolists/hdata.
|       relay-info.c | Relay info/infolists/hdata. |       relay-network.c | Network functions for relay.
|       relay-network.c | Network functions for relay. |       relay-raw.c | Relay raw buffer.
|       relay-raw.c | Relay raw buffer. |       relay-server.c | Relay server.
|       relay-remote.c | Relay remote. |       relay-upgrade.c | Save/restore of relay data when upgrading WeeChat.
|       relay-server.c | Relay server. |       relay-websocket.c | WebSocket server functions (RFC 6455).
|       relay-upgrade.c | Save/restore of relay data when upgrading WeeChat. |       irc/ | IRC proxy.
|       relay-websocket.c | WebSocket server functions (RFC 6455). |          relay-irc.c | Main IRC proxy functions.
|       api/ | Relay for remote interfaces (using HTTP REST API). |       weechat/ | Relay for remote interfaces.
|          relay-api.c | Main API functions for HTTP REST API. |          relay-weechat.c | Relay for remote interfaces (main functions).
|          relay-api-msg.c | Send JSON messages to clients. |          relay-weechat-msg.c | Send binary messages to clients.
|          relay-api-protocol.c | HTTP REST API protocol. |          relay-weechat-nicklist.c | Nicklist functions.
|          remote/ | Relay remote functions, specific to API. |          relay-weechat-protocol.c | Read commands from clients.
|             relay-remote-event.c | Process events received from relay remote. |    ruby/ | Ruby plugin.
|             relay-remote-network.c | Network functions for relay remote. |       weechat-ruby.c | Main ruby functions (load/unload scripts, execute ruby code).
|       irc/ | IRC proxy. |       weechat-ruby-api.c | Ruby scripting API functions.
|          relay-irc.c | Main IRC proxy functions. |    script/ | Script manager.
|       weechat/ | Relay for remote interfaces (using "weechat" binary protocol). |       script.c | Main functions for script manager.
|          relay-weechat.c | Relay for remote interfaces (main functions). |       script-action.c | Actions on scripts (load/unload, install/remove, ...).
|          relay-weechat-msg.c | Send binary messages to clients. |       script-buffer.c | Buffer for script manager.
|          relay-weechat-nicklist.c | Nicklist functions. |       script-command.c | Commands for script manager.
|          relay-weechat-protocol.c | Read commands from clients. |       script-completion.c | Completions for script manager.
|    ruby/ | Ruby plugin. |       script-config.c | Config options for script manager (file script.conf).
|       weechat-ruby.c | Main ruby functions (load/unload scripts, execute ruby code). |       script-info.c | Script manager info/infolists/hdata.
|       weechat-ruby-api.c | Ruby scripting API functions. |       script-mouse.c | Script mouse actions.
|    script/ | Script manager. |       script-repo.c | Download and read repository file.
|       script.c | Main functions for script manager. |    tcl/ | Tcl plugin.
|       script-action.c | Actions on scripts (load/unload, install/remove, ...). |       weechat-tcl.c | Main tcl functions (load/unload scripts, execute tcl code).
|       script-buffer.c | Buffer for script manager. |       weechat-tcl-api.c | Tcl scripting API functions.
|       script-command.c | Commands for script manager. |    trigger/ | Trigger plugin.
|       script-completion.c | Completions for script manager. |       trigger.c | Main trigger functions.
|       script-config.c | Config options for script manager (file script.conf). |       trigger-buffer.c | Trigger buffer.
|       script-info.c | Script manager info/infolists/hdata. |       trigger-callback.c | Trigger callbacks.
|       script-mouse.c | Script mouse actions. |       trigger-command.c | Trigger commands.
|       script-repo.c | Download and read repository file. |       trigger-completion.c | Trigger completions.
|    tcl/ | Tcl plugin. |       trigger-config.c | Trigger config options (file trigger.conf).
|       weechat-tcl.c | Main tcl functions (load/unload scripts, execute tcl code). |    typing/ | Typing plugin.
|       weechat-tcl-api.c | Tcl scripting API functions. |       typing.c | Main typing functions.
|    trigger/ | Trigger plugin. |       typing-bar-item.c | Typing bar items.
|       trigger.c | Main trigger functions. |       typing-config.c | Typing config options (file typing.conf).
|       trigger-buffer.c | Trigger buffer. |       typing-status.c | Messages typing status on buffers.
|       trigger-callback.c | Trigger callbacks. |    xfer/ | Xfer plugin (IRC DCC file/chat).
|       trigger-command.c | Trigger commands. |       xfer.c | Main xfer functions.
|       trigger-completion.c | Trigger completions. |       xfer-buffer.c | Xfer buffer.
|       trigger-config.c | Trigger config options (file trigger.conf). |       xfer-chat.c | DCC chat.
|    typing/ | Typing plugin. |       xfer-command.c | Xfer commands.
|       typing.c | Main typing functions. |       xfer-completion.c | Xfer completions.
|       typing-bar-item.c | Typing bar items. |       xfer-config.c | Xfer config options (file xfer.conf).
|       typing-config.c | Typing config options (file typing.conf). |       xfer-dcc.c | DCC file transfer.
|       typing-status.c | Messages typing status on buffers. |       xfer-file.c | File functions for xfer.
|    xfer/ | Xfer plugin (IRC DCC file/chat). |       xfer-info.c | Xfer info/infolists/hdata.
|       xfer.c | Main xfer functions. |       xfer-network.c | Network functions for xfer.
|       xfer-buffer.c | Xfer buffer. |       xfer-upgrade.c | Save/restore of xfer data when upgrading WeeChat.
|       xfer-chat.c | DCC chat.
|       xfer-command.c | Xfer commands.
|       xfer-completion.c | Xfer completions.
|       xfer-config.c | Xfer config options (file xfer.conf).
|       xfer-dcc.c | DCC file transfer.
|       xfer-file.c | File functions for xfer.
|       xfer-info.c | Xfer info/infolists/hdata.
|       xfer-network.c | Network functions for xfer.
|       xfer-upgrade.c | Save/restore of xfer data when upgrading WeeChat.
|=== |===
[[sources_tests]] [[sources_tests]]
@@ -401,120 +391,84 @@ WeeChat "core" is located in following directories:
[width="100%",cols="2m,3",options="header"] [width="100%",cols="2m,3",options="header"]
|=== |===
| Path/file | Description | Path/file | Description
| tests/ | Root of tests. | tests/ | Root of tests.
|    tests.cpp | Program used to run all tests. |    tests.cpp | Program used to run all tests.
|    tests-record.cpp | Record and search in messages displayed. |    tests-record.cpp | Record and search in messages displayed.
|    scripts/ | Root of scripting API tests. |    scripts/ | Root of scripting API tests.
|       test-scripts.cpp | Program used to run the scripting API tests. |       test-scripts.cpp | Program used to run the scripting API tests.
|       python/ | Python scripts to generate and run the scripting API tests. |       python/ | Python scripts to generate and run the scripting API tests.
|          testapigen.py | Python script generating scripts in all languages to test the scripting API. |          testapigen.py | Python script generating scripts in all languages to test the scripting API.
|          testapi.py | Python script with scripting API tests, used by script testapigen.py. |          testapi.py | Python script with scripting API tests, used by script testapigen.py.
|          unparse.py | Convert Python code to other languages, used by script testapigen.py. |          unparse.py | Convert Python code to other languages, used by script testapigen.py.
|    unit/ | Root of unit tests. |    unit/ | Root of unit tests.
|       test-plugins.cpp | Tests: plugins. |       test-plugins.cpp | Tests: plugins.
|       test-plugin-api-info.cpp | Tests: plugin API info functions. |       core/ | Root of unit tests for core.
|       test-plugin-config.cpp | Tests: plugin config functions. |          test-core-arraylist.cpp | Tests: arraylists.
|       core/ | Root of unit tests for core. |          test-core-calc.cpp | Tests: calculation of expressions.
|          test-core-arraylist.cpp | Tests: arraylists. |          test-core-command.cpp | Tests: commands.
|          test-core-calc.cpp | Tests: calculation of expressions. |          test-core-config-file.cpp | Tests: configuration files.
|          test-core-command.cpp | Tests: commands. |          test-core-crypto.cpp | Tests: cryptographic functions.
|          test-core-config-file.cpp | Tests: configuration files. |          test-core-dir.cpp | Tests: directory/file functions.
|          test-core-crypto.cpp | Tests: cryptographic functions. |          test-core-eval.cpp | Tests: evaluation of expressions.
|          test-core-dir.cpp | Tests: directory/file functions. |          test-core-hashtble.cpp | Tests: hashtables.
|          test-core-eval.cpp | Tests: evaluation of expressions. |          test-core-hdata.cpp | Tests: hdata.
|          test-core-hashtble.cpp | Tests: hashtables. |          test-core-hook.cpp | Tests: hooks.
|          test-core-hdata.cpp | Tests: hdata. |          test-core-infolist.cpp | Tests: infolists.
|          test-core-hook.cpp | Tests: hooks. |          test-core-list.cpp | Tests: lists.
|          test-core-infolist.cpp | Tests: infolists. |          test-core-network.cpp | Tests: network functions.
|          test-core-list.cpp | Tests: lists. |          test-core-secure.cpp | Tests: secured data.
|          test-core-network.cpp | Tests: network functions. |          test-core-signal.cpp | Tests: signals.
|          test-core-secure.cpp | Tests: secured data. |          test-core-string.cpp | Tests: strings.
|          test-core-signal.cpp | Tests: signals. |          test-core-url.cpp | Tests: URLs.
|          test-core-string.cpp | Tests: strings. |          test-core-utf8.cpp | Tests: UTF-8.
|          test-core-url.cpp | Tests: URLs. |          test-core-util.cpp | Tests: utility functions.
|          test-core-utf8.cpp | Tests: UTF-8. |          test-core-sys.cpp | Tests: system functions.
|          test-core-util.cpp | Tests: utility functions. |       gui/ | Root of unit tests for interfaces.
|          test-core-sys.cpp | Tests: system functions. |          test-gui-bar-window.cpp | Tests: bar window functions.
|          hook/ | Root of unit tests for hooks. |          test-gui-buffer.cpp | Tests: buffer functions.
|             test-hook-command.cpp | Tests: hooks "command". |          test-gui-chat.cpp | Tests: chat functions.
|             test-hook-command-run.cpp | Tests: hooks "command_run". |          test-gui-color.cpp | Tests: colors.
|             test-hook-completion.cpp | Tests: hooks "completion". |          test-gui-filter.cpp | Tests: filters.
|             test-hook-config.cpp | Tests: hooks "config". |          test-gui-input.cpp | Tests: input functions.
|             test-hook-connect.cpp | Tests: hooks "connect". |          test-gui-key.cpp | Tests: keys.
|             test-hook-fd.cpp | Tests: hooks "fd". |          test-gui-line.cpp | Tests: lines.
|             test-hook-focus.cpp | Tests: hooks "focus". |          test-gui-nick.cpp | Tests: nicks.
|             test-hook-hdata.cpp | Tests: hooks "hdata". |       plugins/ | Root of unit tests for plugins.
|             test-hook-hsignal.cpp | Tests: hooks "hsignal". |          irc/ | Root of unit tests for IRC plugin.
|             test-hook-info-hashtable.cpp | Tests: hooks "info_hashtable". |             test-irc-batch.cpp | Tests: IRC batched events.
|             test-hook-info.cpp | Tests: hooks "info". |             test-irc-buffer.cpp | Tests: IRC buffers.
|             test-hook-infolist.cpp | Tests: hooks "infolist". |             test-irc-channel.cpp | Tests: IRC channels.
|             test-hook-line.cpp | Tests: hooks "line". |             test-irc-color.cpp | Tests: IRC colors.
|             test-hook-modifier.cpp | Tests: hooks "modifier". |             test-irc-config.cpp | Tests: IRC configuration.
|             test-hook-print.cpp | Tests: hooks "print". |             test-irc-ctcp.cpp | Tests: IRC CTCP.
|             test-hook-process.cpp | Tests: hooks "process". |             test-irc-ignore.cpp | Tests: IRC ignores.
|             test-hook-signal.cpp | Tests: hooks "signal". |             test-irc-join.cpp | Tests: IRC join functions.
|             test-hook-timer.cpp | Tests: hooks "timer". |             test-irc-list.cpp | Tests: IRC buffer for reply to /list command.
|             test-hook-url.cpp | Tests: hooks "url". |             test-irc-message.cpp | Tests: IRC messages.
|       gui/ | Root of unit tests for interfaces. |             test-irc-mode.cpp | Tests: IRC modes.
|          test-gui-bar-window.cpp | Tests: bar window functions. |             test-irc-nick.cpp | Tests: IRC nicks.
|          test-gui-buffer.cpp | Tests: buffer functions. |             test-irc-protocol.cpp | Tests: IRC protocol.
|          test-gui-chat.cpp | Tests: chat functions. |             test-irc-sasl.cpp | Tests: SASL authentication with IRC protocol.
|          test-gui-color.cpp | Tests: colors. |             test-irc-server.cpp | Tests: IRC server.
|          test-gui-filter.cpp | Tests: filters. |             test-irc-tag.cpp | Tests: IRC message tags.
|          test-gui-hotlist.cpp | Tests: hotlist functions. |          logger/ | Root of unit tests for logger plugin.
|          test-gui-input.cpp | Tests: input functions. |             test-logger.cpp | Tests: logger.
|          test-gui-key.cpp | Tests: keys. |             test-logger-backlog.cpp | Tests: logger backlog.
|          test-gui-line.cpp | Tests: lines. |             test-logger-tail.cpp | Tests: logger tail functions.
|          test-gui-nick.cpp | Tests: nicks. |          trigger/ | Root of unit tests for trigger plugin.
|          test-gui-nicklist.cpp | Tests: nicklist functions. |             test-trigger.cpp | Tests: triggers.
|          curses/ | Root of unit tests for Curses interface. |             test-trigger-config.cpp | Tests: trigger configuration.
|             test-gui-curses-mouse.cpp | Tests: mouse (Curses interface). |          typing/ | Root of unit tests for typing plugin.
|       plugins/ | Root of unit tests for plugins. |             test-typing.cpp | Tests: typing.
|          irc/ | Root of unit tests for IRC plugin. |             test-typing-status.cpp | Tests: typing status.
|             test-irc-batch.cpp | Tests: IRC batched events. |          relay/ | Root of unit tests for Relay plugin.
|             test-irc-buffer.cpp | Tests: IRC buffers. |             test-relay-auth.cpp | Tests: clients authentication.
|             test-irc-channel.cpp | Tests: IRC channels. |             irc/ | Root of unit tests for Relay "irc" protocol.
|             test-irc-color.cpp | Tests: IRC colors. |                test-relay-irc.cpp | Tests: Relay "irc" protocol.
|             test-irc-command.cpp | Tests: IRC commands. |          xfer/ | Root of unit tests for Xfer plugin.
|             test-irc-config.cpp | Tests: IRC configuration. |             test-xfer-file.cpp | Tests: file functions.
|             test-irc-ctcp.cpp | Tests: IRC CTCP. |             test-xfer-network.cpp | Tests: network functions.
|             test-irc-ignore.cpp | Tests: IRC ignores.
|             test-irc-info.cpp | Tests: IRC info.
|             test-irc-join.cpp | Tests: IRC join functions.
|             test-irc-list.cpp | Tests: IRC buffer for reply to /list command.
|             test-irc-message.cpp | Tests: IRC messages.
|             test-irc-mode.cpp | Tests: IRC modes.
|             test-irc-nick.cpp | Tests: IRC nicks.
|             test-irc-protocol.cpp | Tests: IRC protocol.
|             test-irc-sasl.cpp | Tests: SASL authentication with IRC protocol.
|             test-irc-server.cpp | Tests: IRC server.
|             test-irc-tag.cpp | Tests: IRC message tags.
|          logger/ | Root of unit tests for logger plugin.
|             test-logger.cpp | Tests: logger.
|             test-logger-backlog.cpp | Tests: logger backlog.
|             test-logger-tail.cpp | Tests: logger tail functions.
|          trigger/ | Root of unit tests for trigger plugin.
|             test-trigger.cpp | Tests: triggers.
|             test-trigger-config.cpp | Tests: trigger configuration.
|          typing/ | Root of unit tests for typing plugin.
|             test-typing.cpp | Tests: typing.
|             test-typing-status.cpp | Tests: typing status.
|          relay/ | Root of unit tests for Relay plugin.
|             test-relay-auth.cpp | Tests: clients authentication.
|             test-relay-http.cpp | Tests: HTTP functions for Relay plugin.
|             test-relay-raw.cpp | Tests: raw messages functions for Relay plugin.
|             test-relay-remote.cpp | Tests: remote functions for Relay plugin.
|             test-relay-websocket.cpp | Tests: websocket functions for Relay plugin.
|             api/ | Root of unit tests for Relay "api" protocol.
|                test-relay-api.cpp | Tests: Relay "api" protocol: general functions.
|                test-relay-api-msg.cpp | Tests: Relay "api" protocol: messages.
|                test-relay-api-protocol.cpp | Tests: Relay "api" protocol: protocol.
|             irc/ | Root of unit tests for Relay "irc" protocol.
|                test-relay-irc.cpp | Tests: Relay "irc" protocol.
|          xfer/ | Root of unit tests for Xfer plugin.
|             test-xfer-file.cpp | Tests: file functions.
|             test-xfer-network.cpp | Tests: network functions.
|=== |===
[[documentation_translations]] [[documentation_translations]]
@@ -533,8 +487,7 @@ Documentation files:
|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^^]. |       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^^].
|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^]. |       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^].
|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^^]. |       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
|       weechat_relay_api.XX.adoc | link:weechat_relay_api.en.html[Relay "api" protocol ^↗^^] (for remote interfaces). |       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces).
|       weechat_relay_weechat.XX.adoc | link:weechat_relay_weechat.en.html[Relay "weechat" protocol ^↗^^] (for remote interfaces).
|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^^]. |       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^^].
|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^^]. |       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^^].
|       includes/ | Files included in documentation. |       includes/ | Files included in documentation.
@@ -575,7 +528,7 @@ Example in C:
/* /*
* weechat.c - core functions for WeeChat * weechat.c - core functions for WeeChat
* *
* Copyright (C) 2024 Your Name <your@email.com> * Copyright (C) 2023 Your Name <your@email.com>
* *
* This file is part of WeeChat, the extensible chat client. * This file is part of WeeChat, the extensible chat client.
* *
@@ -599,8 +552,9 @@ Example in C:
Some basic rules you *must* follow when you write C code: Some basic rules you *must* follow when you write C code:
* Use 4 spaces for indentation (no tabs). * Use 4 spaces for indentation. Don't use tabs, they are evil.
* Try to not exceed 80 chars by line, except if this is needed to increase readability. * Try to not exceed 80 chars by line, except if this is needed to increase
readability.
* Use comments `+/* comment */+` (not C99-style comments like `+// comment+`). * Use comments `+/* comment */+` (not C99-style comments like `+// comment+`).
* Add a comment before any function, to explain what it does (always use a * Add a comment before any function, to explain what it does (always use a
multi-line comment, even if description is very short). multi-line comment, even if description is very short).
@@ -812,7 +766,7 @@ Examples:
[width="100%",cols="2m,3",options="header"] [width="100%",cols="2m,3",options="header"]
|=== |===
| Directory | Files | Directory | Files
| src/core/ | weechat.c, core-backtrace.c, core-command.c, ... | src/core/ | weechat.c, wee-backtrace.c, wee-command.c, ...
| src/gui/ | gui-bar.c, gui-bar-item.c, gui-bar-window.c, ... | src/gui/ | gui-bar.c, gui-bar-item.c, gui-bar-window.c, ...
| src/gui/curses/ | gui-curses-bar.c, gui-curses-bar-window.c, gui-curses-chat.c, ... | src/gui/curses/ | gui-curses-bar.c, gui-curses-bar-window.c, gui-curses-chat.c, ...
| src/plugins/ | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ... | src/plugins/ | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ...
@@ -820,8 +774,8 @@ Examples:
| src/plugins/python/ | weechat-python.c, weechat-python-api.c, ... | src/plugins/python/ | weechat-python.c, weechat-python-api.c, ...
|=== |===
The headers of C files have same name as file, for example _core-command.h_ for The headers of C files have same name as file, for example _wee-command.h_ for
file _core-command.c_. file _wee-command.c_.
[[naming_convention_structures]] [[naming_convention_structures]]
==== Structures ==== Structures
@@ -1173,7 +1127,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^]. Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].
Any patch for bug or new feature must be done on branch `main`, preferred way Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail is a GitHub pull request. A patch can also be sent by e-mail
(made with `git diff` or `git format-patch`). (made with `git diff` or `git format-patch`).
@@ -1190,15 +1144,15 @@ Where _component_ is one of following:
| Component | Files | Description | Component | Files | Description
| core | core
| AUTHORS.md + | AUTHORS.adoc +
CHANGELOG.md + ChangeLog.adoc +
CONTRIBUTING.md + Contributing.adoc +
.github/FUNDING.yml + .github/FUNDING.yml +
.github/ISSUE_TEMPLATE/* + .github/ISSUE_TEMPLATE/* +
icons/* + icons/* +
po/* + po/* +
README.md + README.adoc +
UPGRADING.md + ReleaseNotes.adoc +
src/core/* + src/core/* +
src/gui/* + src/gui/* +
version.sh + version.sh +
@@ -1255,9 +1209,8 @@ Where _component_ is one of following:
| Plugin API reference | Plugin API reference
| doc/relay | doc/relay
| doc/xx/weechat_relay_api.xx.adoc + | doc/xx/weechat_relay_protocol.xx.adoc
doc/xx/weechat_relay_weechat.xx.adoc | Relay protocol
| Relay protocols
| doc/dev | doc/dev
| doc/xx/weechat_dev.en.adoc | doc/xx/weechat_dev.en.adoc
@@ -1301,10 +1254,9 @@ Gettext files are in directory _po/_.
If you want to initialize a new language, use command `msginit`. For example to If you want to initialize a new language, use command `msginit`. For example to
create a file which is ready to translate to Dutch: create a file which is ready to translate to Dutch:
[source,shell]
---- ----
cd po $ cd po
msginit -i weechat.pot -l nl_NL -o nl.po $ msginit -i weechat.pot -l nl_NL -o nl.po
---- ----
Base language for WeeChat is English, so you must of course perfectly understand Base language for WeeChat is English, so you must of course perfectly understand
@@ -1313,9 +1265,8 @@ English in order to translate to your language.
After changes in sources, you can regenerate all translations files: run this After changes in sources, you can regenerate all translations files: run this
command in the CMake "build" directory: command in the CMake "build" directory:
[source,shell]
---- ----
make translations && make update-po $ make translations && make update-po
---- ----
Then you can edit .po files (if you can translate in a language). Then you can edit .po files (if you can translate in a language).
@@ -1323,9 +1274,8 @@ Then you can edit .po files (if you can translate in a language).
When done, you *have* to check your file with When done, you *have* to check your file with
https://github.com/flashcode/msgcheck[msgcheck ^↗^^]: https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
[source,shell]
---- ----
msgcheck.py xx.po $ msgcheck.py xx.po
---- ----
And then you can recompile WeeChat to use the new translations. And then you can recompile WeeChat to use the new translations.
+6 -41
View File
@@ -2,7 +2,6 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: en :lang: en
include::includes/attributes-en.adoc[]
[[general]] [[general]]
== General == General
@@ -49,14 +48,12 @@ If you still have issues, please report them to the developers.
It is recommended to use https://brew.sh/[Homebrew ^↗^^], It is recommended to use https://brew.sh/[Homebrew ^↗^^],
you can get help with: you can get help with:
[source,shell]
---- ----
brew info weechat brew info weechat
---- ----
You can install WeeChat with this command: You can install WeeChat with this command:
[source,shell]
---- ----
brew install weechat brew install weechat
---- ----
@@ -316,14 +313,10 @@ You can use a terminal with rectangular selection (like rxvt-unicode,
konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse
selection. selection.
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Another solution is to move nicklist to top or bottom, for example: Another solution is to move nicklist to top or bottom, for example:
---- ----
/set weechat.bar.nicklist.position top /set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
---- ----
[[urls]] [[urls]]
@@ -333,13 +326,10 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
To make opening URLs easier, you can: To make opening URLs easier, you can:
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
* move nicklist to top: * move nicklist to top:
---- ----
/set weechat.bar.nicklist.position top /set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
---- ----
* disable alignment for multiline words: * disable alignment for multiline words:
@@ -389,7 +379,6 @@ There is no option in WeeChat to change the timezone, the environment variable
In your shell initialization file or on command line, before starting WeeChat: In your shell initialization file or on command line, before starting WeeChat:
[source,shell]
---- ----
export TZ=America/New_York export TZ=America/New_York
---- ----
@@ -602,23 +591,6 @@ version ≥ 4.0.0, the keys names become invalid and many keys won't work at all
To repair them, exit WeeChat, remove all sections `[key*]` from weechat.conf To repair them, exit WeeChat, remove all sections `[key*]` from weechat.conf
and start WeeChat again: all default keys will be created. and start WeeChat again: all default keys will be created.
[[key_f11]]
=== Key F11 maximizes the terminal window, how can I scroll up the nicklist?
The key kbd:[F11] is commonly used by terminals to maximize the window, and
kbd:[F11]/kbd:[F12] are the default keys in WeeChat to scroll the nicklist.
You can bind other keys, for example kbd:[Shift+F11] and kbd:[Shift+F12],
with WeeChat ≥ 4.0.0:
----
/key bind shift-f11 /bar scroll nicklist * -100%
/key bind shift-f12 /bar scroll nicklist * +100%
----
Other solution is to enable mouse (key: kbd:[Alt+m]) and scroll with the mouse
wheel (see also questions about <<mouse,mouse>>).
[[customize_key_bindings]] [[customize_key_bindings]]
=== How can I customize key bindings? === How can I customize key bindings?
@@ -693,18 +665,16 @@ According to terminfo used, mouse may not be supported.
You can test mouse support in terminal: You can test mouse support in terminal:
[source,shell]
---- ----
printf '\033[?1002h' $ printf '\033[?1002h'
---- ----
And then click on first char of terminal (upper left). You should see " !!#!!". And then click on first char of terminal (upper left). You should see " !!#!!".
To disable mouse in terminal: To disable mouse in terminal:
[source,shell]
---- ----
printf '\033[?1002l' $ printf '\033[?1002l'
---- ----
[[mouse_coords]] [[mouse_coords]]
@@ -759,7 +729,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
You can try a different priority string, replace "xxx" by your server name: You can try a different priority string, replace "xxx" by your server name:
---- ----
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT" /set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
---- ----
[[irc_tls_libera]] [[irc_tls_libera]]
@@ -1012,9 +982,8 @@ First check questions about TLS connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell): If still not working, try to manually delete the scripts file (in your shell):
[source,shell]
---- ----
rm ~/.cache/weechat/script/plugins.xml.gz $ rm ~/.cache/weechat/script/plugins.xml.gz
---- ----
[NOTE] [NOTE]
@@ -1038,17 +1007,15 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed: * in your shell, with curl installed:
[source,shell]
---- ----
cd ~/.cache/weechat/script $ cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz $ curl -O https://weechat.org/files/plugins.xml.gz
---- ----
If you're running macOS and the downloaded file has a size of 0 bytes, If you're running macOS and the downloaded file has a size of 0 bytes,
try to set this variable in your shell initialization file or on command line, try to set this variable in your shell initialization file or on command line,
before starting WeeChat: before starting WeeChat:
[source,shell]
---- ----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
---- ----
@@ -1218,7 +1185,6 @@ See https://weechat.org/about/support/[this page ^↗^^].
When you run WeeChat under gdb, you may have this error: When you run WeeChat under gdb, you may have this error:
[source,shell]
---- ----
$ gdb /path/to/weechat $ gdb /path/to/weechat
(gdb) run (gdb) run
@@ -1229,7 +1195,6 @@ Cannot find new threads: generic error
To fix that, you can run gdb with this command (replace path to libpthread and To fix that, you can run gdb with this command (replace path to libpthread and
WeeChat with paths on your system): WeeChat with paths on your system):
[source,shell]
---- ----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run (gdb) run
File diff suppressed because it is too large Load Diff
+1 -3
View File
@@ -2,7 +2,6 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: en :lang: en
include::includes/attributes-en.adoc[]
[[start]] [[start]]
== Start WeeChat == Start WeeChat
@@ -12,9 +11,8 @@ It has good UTF-8 support and works well with WeeChat's default key bindings.
Run from your shell: Run from your shell:
[source,shell]
---- ----
weechat $ weechat
---- ----
[[help]] [[help]]
File diff suppressed because it is too large Load Diff
@@ -2,12 +2,11 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: en :lang: en
include::includes/attributes-en.adoc[]
[[introduction]] [[introduction]]
== Introduction == Introduction
This document is the specification of _weechat_ relay protocol: the protocol used This document is the specification of WeeChat Relay protocol: the protocol used
to relay WeeChat data to clients, which are mostly remote interfaces. to relay WeeChat data to clients, which are mostly remote interfaces.
[[terminology]] [[terminology]]
@@ -25,11 +24,28 @@ The following terms are used in this document:
The _clients_ are connected to _relay_ like shown in this diagram: The _clients_ are connected to _relay_ like shown in this diagram:
include::includes/relay.en.adoc[tag=diagram] ....
┌──────────┐ Workstation
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS ...)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Mobile device
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone ...)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Other devices
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
network servers ncurses interface relay remote interfaces
protocol
....
[NOTE] [NOTE]
All clients here are clients using _weechat_ protocol in _relay_ plugin. + All clients here are clients using _weechat_ protocol in _relay_ plugin. The
The _relay_ plugin also allows _api_ and _irc_ protocols (not described in this document). _relay_ plugin also allows IRC clients, then _relay_ plugin acts as an
_IRC proxy_ (not described in this document).
[[protocol_generalities]] [[protocol_generalities]]
== Protocol generalities == Protocol generalities
@@ -472,9 +488,7 @@ hda:
'buffer': 'ptr', 'buffer': 'ptr',
'y': 'int', 'y': 'int',
'date': 'tim', 'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim', 'date_printed': 'tim',
'date_usec_printed': 'int',
'str_time': 'str', 'str_time': 'str',
'tags_count': 'int', 'tags_count': 'int',
'tags_array': 'arr', 'tags_array': 'arr',
@@ -492,9 +506,7 @@ hda:
buffer: '0x558d61ea3e60' buffer: '0x558d61ea3e60'
y: -1 y: -1
date: 1588404926 date: 1588404926
date_usec: 118712
date_printed: 1588404926 date_printed: 1588404926
date_usec_printed: 118712
str_time: 'F@0025209F@0024535F@0024026' str_time: 'F@0025209F@0024535F@0024026'
tags_count: 0 tags_count: 0
tags_array: [] tags_array: []
@@ -510,9 +522,7 @@ hda:
buffer: '0x558d61ea3e60' buffer: '0x558d61ea3e60'
y: -1 y: -1
date: 1588404930 date: 1588404930
date_usec: 25
date_printed: 1588404930 date_printed: 1588404930
date_usec_printed: 25
str_time: 'F@0025209F@0024535F@0024030' str_time: 'F@0025209F@0024535F@0024030'
tags_count: 0 tags_count: 0
tags_array: [] tags_array: []
@@ -691,7 +701,6 @@ inl:
nicklist_visible_count: 0 nicklist_visible_count: 0
title: 'WeeChat 2.9-dev (C) 2003-2020 - https://weechat.org/' title: 'WeeChat 2.9-dev (C) 2003-2020 - https://weechat.org/'
input: 1 input: 1
input_get_any_user_data: 0
input_get_unknown_commands: 0 input_get_unknown_commands: 0
input_get_empty: 0 input_get_empty: 0
input_multiline: 0 input_multiline: 0
@@ -703,14 +712,11 @@ inl:
input_buffer_1st_display: 0 input_buffer_1st_display: 0
num_history: 0 num_history: 0
text_search: 0 text_search: 0
text_search_direction: 0
text_search_exact: 0 text_search_exact: 0
text_search_regex: 0 text_search_regex: 0
text_search_regex_compiled: '0x0' text_search_regex_compiled: '0x0'
text_search_where: 0 text_search_where: 0
text_search_history: 0
text_search_found: 0 text_search_found: 0
text_search_ptr_history: '0x0'
text_search_input: None text_search_input: None
highlight_words: None highlight_words: None
highlight_disable_regex: None highlight_disable_regex: None
@@ -1489,9 +1495,6 @@ WeeChat reserved identifiers:
| _buffer_line_added | buffer | hdata: line | _buffer_line_added | buffer | hdata: line
| Line added in buffer. | Display line in buffer. | Line added in buffer. | Display line in buffer.
| _buffer_line_data_changed | buffer | hdata: line
| Line changed in buffer. | Update line displayed in buffer.
| _nicklist | nicklist | hdata: nicklist_item | _nicklist | nicklist | hdata: nicklist_item
| Nicklist for a buffer. | Replace nicklist. | Nicklist for a buffer. | Replace nicklist.
@@ -2044,19 +2047,16 @@ Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"] [width="100%",cols="3m,2,10",options="header"]
|=== |===
| Name | Type | Description | Name | Type | Description
| buffer | pointer | Buffer pointer. | buffer | pointer | Buffer pointer.
| id | integer | Line identifier. | date | time | Date of message.
| date | time | Date of message. | date_printed | time | Date when WeeChat displayed message.
| date_usec | integer | Microseconds of date. | displayed | char | 1 if message is displayed, 0 if message is filtered (hidden).
| date_printed | time | Date when WeeChat displayed message. | notify_level | char | Notify level: -1 = notify disabled, 0 = low, 1 = message, 2 = private, 3 = highlight.
| date_usec_printed | integer | Microseconds of date when WeeChat displayed message. | highlight | char | 1 if line has a highlight, otherwise 0.
| displayed | char | 1 if message is displayed, 0 if message is filtered (hidden). | tags_array | array of strings | List of tags for line.
| notify_level | char | Notify level: -1 = notify disabled, 0 = low, 1 = message, 2 = private, 3 = highlight. | prefix | string | Prefix.
| highlight | char | 1 if line has a highlight, otherwise 0. | message | string | Message.
| tags_array | array of strings | List of tags for line.
| prefix | string | Prefix.
| message | string | Message.
|=== |===
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_: Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_:
@@ -2067,11 +2067,8 @@ id: '_buffer_line_added'
hda: hda:
keys: { keys: {
'buffer': 'ptr', 'buffer': 'ptr',
'id': 'int',
'date': 'tim', 'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim', 'date_printed': 'tim',
'date_usec_printed': 'int',
'displayed': 'chr', 'displayed': 'chr',
'notify_level': 'chr', 'notify_level': 'chr',
'highlight': 'chr', 'highlight': 'chr',
@@ -2083,62 +2080,8 @@ hda:
item 1: item 1:
__path: ['0x4a49600'] __path: ['0x4a49600']
buffer: '0x4a715d0' buffer: '0x4a715d0'
id: 12
date: 1362728993 date: 1362728993
date_usec: 902765
date_printed: 1362728993 date_printed: 1362728993
date_usec_printed: 902765
displayed: 1
notify_level: 1
highlight: 0
tags_array: [
'irc_privmsg',
'notify_message',
'prefix_nick_142',
'nick_FlashCode',
'log1',
]
prefix: 'F06@F@00142FlashCode'
message: 'hello!'
----
[[message_buffer_line_data_changed]]
==== _buffer_line_data_changed
This message is sent to the client when the signal "buffer_line_data_changed"
is sent by WeeChat.
Data sent as hdata: same data as <<message_buffer_line_added,_buffer_line_added>>.
Example: message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_ has been updated:
[source,python]
----
id: '_buffer_line_data_changed'
hda:
keys: {
'buffer': 'ptr',
'id': 'int',
'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim',
'date_usec_printed': 'int',
'displayed': 'chr',
'notify_level': 'chr',
'highlight': 'chr',
'tags_array': 'arr',
'prefix': 'str',
'message': 'str',
}
path: ['line_data']
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
id: 12
date: 1362728993
date_usec: 902765
date_printed: 1362728993
date_usec_printed: 902765
displayed: 1 displayed: 1
notify_level: 1 notify_level: 1
highlight: 0 highlight: 0
+306 -7
View File
@@ -2,7 +2,6 @@
:author: Sébastien Helleu :author: Sébastien Helleu
:email: flashcode@flashtux.org :email: flashcode@flashtux.org
:lang: en :lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat. This manual documents WeeChat chat client, it is part of WeeChat.
@@ -68,7 +67,7 @@ link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗
WeeChat defines a `weechat` module which must be imported with `import weechat`. + WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository: A Python stub for WeeChat API is available in the repository:
https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^]. https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]] [[python_functions]]
===== Functions ===== Functions
@@ -363,10 +362,9 @@ WeeChat is starting.
For example with Python: For example with Python:
[source,shell]
---- ----
cd ~/.local/share/weechat/python/autoload $ cd ~/.local/share/weechat/python/autoload
ln -s ../script.py $ ln -s ../script.py
---- ----
[NOTE] [NOTE]
@@ -551,14 +549,315 @@ link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
List of functions in script API: List of functions in script API:
include::{autogendir}/autogen_scripting_functions.en.adoc[tag=functions] [width="100%",cols="1,5",options="header"]
|===
| Category | Functions
| general
| register
| plugins
| plugin_get_name
| strings
| charset_set +
iconv_to_internal +
iconv_from_internal +
gettext +
ngettext +
strlen_screen +
string_match +
string_match_list +
string_has_highlight +
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_parse_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
string_eval_expression +
string_eval_path_home
| directories
| mkdir_home +
mkdir +
mkdir_parents
| sorted lists
| list_new +
list_add +
list_search +
list_search_pos +
list_casesearch +
list_casesearch_pos +
list_get +
list_set +
list_next +
list_prev +
list_string +
list_size +
list_remove +
list_remove_all +
list_free
| configuration files
| config_new +
config_new_section +
config_search_section +
config_new_option +
config_search_option +
config_string_to_boolean +
config_option_reset +
config_option_set +
config_option_set_null +
config_option_unset +
config_option_rename +
config_option_is_null +
config_option_default_is_null +
config_boolean +
config_boolean_default +
config_integer +
config_integer_default +
config_string +
config_string_default +
config_color +
config_color_default +
config_write_option +
config_write_line +
config_write +
config_read +
config_reload +
config_option_free +
config_section_free_options +
config_section_free +
config_free +
config_get +
config_get_plugin +
config_is_set_plugin +
config_set_plugin +
config_set_desc_plugin +
config_unset_plugin
| key bindings
| key_bind +
key_unbind
| display
| prefix +
color +
print (for python: prnt) +
print_date_tags (for python: prnt_date_tags) +
print_y (for python: prnt_y) +
print_y_date_tags (for python: prnt_y_date_tags) +
log_print
| hooks
| hook_command +
hook_command_run +
hook_timer +
hook_fd +
hook_process +
hook_process_hashtable +
hook_connect +
hook_line +
hook_print +
hook_signal +
hook_signal_send +
hook_hsignal +
hook_hsignal_send +
hook_config +
hook_completion +
hook_modifier +
hook_modifier_exec +
hook_info +
hook_info_hashtable +
hook_infolist +
hook_focus +
hook_set +
unhook +
unhook_all
| buffers
| buffer_new +
buffer_new_props +
current_buffer +
buffer_search +
buffer_search_main +
buffer_clear +
buffer_close +
buffer_merge +
buffer_unmerge +
buffer_get_integer +
buffer_get_string +
buffer_get_pointer +
buffer_set +
buffer_string_replace_local_var +
buffer_match_list
| windows
| current_window +
window_search_with_buffer +
window_get_integer +
window_get_string +
window_get_pointer +
window_set_title
| nicklist
| nicklist_add_group +
nicklist_search_group +
nicklist_add_nick +
nicklist_search_nick +
nicklist_remove_group +
nicklist_remove_nick +
nicklist_remove_all +
nicklist_group_get_integer +
nicklist_group_get_string +
nicklist_group_get_pointer +
nicklist_group_set +
nicklist_nick_get_integer +
nicklist_nick_get_string +
nicklist_nick_get_pointer +
nicklist_nick_set
| bars
| bar_item_search +
bar_item_new +
bar_item_update +
bar_item_remove +
bar_search +
bar_new +
bar_set +
bar_update +
bar_remove
| commands
| command +
command_options
| completion
| completion_new +
completion_search +
completion_get_string +
completion_list_add +
completion_free
| infos
| info_get +
info_get_hashtable
| infolists
| infolist_new +
infolist_new_item +
infolist_new_var_integer +
infolist_new_var_string +
infolist_new_var_pointer +
infolist_new_var_time +
infolist_get +
infolist_next +
infolist_prev +
infolist_reset_item_cursor +
infolist_search_var +
infolist_fields +
infolist_integer +
infolist_string +
infolist_pointer +
infolist_time +
infolist_free
| hdata
| hdata_get +
hdata_get_var_offset +
hdata_get_var_type_string +
hdata_get_var_array_size +
hdata_get_var_array_size_string +
hdata_get_var_hdata +
hdata_get_list +
hdata_check_pointer +
hdata_move +
hdata_search +
hdata_char +
hdata_integer +
hdata_long +
hdata_string +
hdata_pointer +
hdata_time +
hdata_hashtable +
hdata_compare +
hdata_update +
hdata_get_string
| upgrade
| upgrade_new +
upgrade_write_object +
upgrade_read +
upgrade_close
|===
[[script_api_constants]] [[script_api_constants]]
=== Constants === Constants
List of constants in script API: List of constants in script API:
include::{autogendir}/autogen_scripting_constants.en.adoc[tag=constants] [width="100%",cols="1,5",options="header"]
|===
| Category | Constants
| return codes
| `WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| configuration files
| `WEECHAT_CONFIG_READ_OK` (integer) +
`WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_WRITE_OK` (integer) +
`WEECHAT_CONFIG_WRITE_ERROR` (integer) +
`WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
`WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
`WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
`WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
| sorted lists
| `WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| hotlist
| `WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook process
| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook connect
| `WEECHAT_HOOK_CONNECT_OK` (integer) +
`WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
`WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
`WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
`WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
`WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
| hook signal
| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]] [[common_tasks]]
== Common tasks == Common tasks

Some files were not shown because too many files have changed in this diff Show More