core: fix buffer overflow in function network_pass_socks5proxy (#2325 )

bound the configured proxy username and password before they are copied into the fixed stack buffer in network_pass_socks5proxy, otherwise a login longer than the buffer (a long password or token) overruns it while building the SOCKS5 auth request.
core: add CVE IDs in ChangeLog
2026-06-12 22:24:47 +02:00 · 2026-06-12 17:26:48 +02:00 · 2026-06-09 22:13:57 +02:00 · 2026-06-07 08:51:20 +02:00 · 2026-06-06 14:37:21 +02:00 · 2026-06-06 14:37:21 +02:00
805 changed files with 110066 additions and 52804 deletions
@@ -0,0 +1,25 @@
+# To use this config on you editor, follow the instructions at:
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+insert_final_newline = true
+indent_size = 4
+indent_style = space
+tab_width = 8
+trim_trailing_whitespace = true
+
+[{*.{c,cpp,h}}]
+max_line_length = 80
+
+[{CMakeLists.txt,*.cmake}]
+max_line_length = 80
+indent_size = 2
+
+[*.html]
+indent_size = 2
+
+[*.yml]
+indent_size = 2
@@ -9,7 +9,7 @@ body:
        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.adoc](https://github.com/weechat/weechat/blob/master/Contributing.adoc#security-reports).
+        **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
@@ -85,9 +85,9 @@ body:
  - type: input
    id: os-version
    attributes:
-      label: What OS are you using?
+      label: What OS/distribution are you using?
      description: Name of the operating system and its version.
-      placeholder: Debian 12, Ubuntu 23.10, MacOS 14, ...
+      placeholder: Debian 12, Ubuntu 24.04, macOS 14, ...
    validations:
      required: true

@@ -10,6 +10,8 @@ body:
        - 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).

+        **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: question
    attributes:
@@ -1,42 +1,131 @@
 name: CI

 on:
-  - push
-  - pull_request
+  push:
+  pull_request:
+  schedule:
+    - cron: '22 9 * * 2'

 env:
-  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
+  WEECHAT_DEPS_UBUNTU: >-
+    asciidoctor
+    build-essential
+    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
+    pipx
+    pkgconf
+    pylint
+    python3-bandit
+    python3-dev
+    ruby-pygments.rb
+    shellcheck
+    tcl8.6-dev
+    zlib1g-dev
+  WEECHAT_DEPS_ROCKYLINUX: >-
+    asciidoctor
+    aspell-devel
+    cjson-devel
+    clang
+    cmake
+    cpputest-devel
+    gcc
+    gettext
+    glibc-langpack-en
+    gnutls-devel
+    guile30-devel
+    libcurl-devel
+    libgcrypt-devel
+    libzstd-devel
+    lua-devel
+    ncurses-devel
+    perl-devel
+    php-devel
+    php-embedded
+    python-devel
+    ruby-devel
+    sudo
+    tcl-devel
+    zlib-devel
+  WEECHAT_DEPS_FREEBSD: >-
+    aspell
+    cmake
+    cpputest
+    curl
+    gcc
+    gettext
+    git
+    gnutls
+    guile3
+    libargon2
+    libcjson
+    libgcrypt
+    libiconv
+    llvm
+    lua54
+    ncurses
+    perl5
+    php83
+    pkgconf
+    python3
+    ruby
+    rubygem-asciidoctor
+    sudo
+    tcl86
+    zstd

 jobs:

-  tests_linux:
+  tests_ubuntu:

    strategy:
      matrix:
        os:
-          - ubuntu-22.04
+          - ubuntu-24.04
        config:
          - { name: "gcc", cc: "gcc", cxx: "g++", buildargs: "" }
          - { 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_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: "clang", cc: "clang", cxx: "clang++", buildargs: "" }

-    name: "Tests: ${{ matrix.config.name }} on ${{ matrix.os }}"
+    name: "${{ matrix.os }} (${{ matrix.config.name }})"
    runs-on: ${{ matrix.os }}

    steps:

-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4

    - name: Install dependencies
      run: |
        sudo apt-get update -qq
-        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPENDENCIES }}
+        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPS_UBUNTU }}
        # 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
+        sudo apt-get --yes purge php8.3-imagick
+        pipx install msgcheck

    - name: Check gettext files
      run: msgcheck po/*.po
@@ -45,7 +134,7 @@ jobs:
      run: ./tools/check_scripts.sh

    - name: Check Python stub file
-      run: ./doc/python_stub.py | diff src/plugins/python/weechat.pyi -
+      run: ./tools/generate_python_stub.py | diff src/plugins/python/weechat.pyi -

    - 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
@@ -63,11 +152,28 @@ jobs:
      run: |
        weechat --help
        weechat-curses --help
+        weechat --version
+        weechat --build-info
        weechat --colors
        weechat --license
-        weechat --version
        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"

+    - name: Test Relay OpenAPI
+      if: ${{ matrix.config.name == 'gcc' }}
+      env:
+        RELAY_PASSWORD: test
+      run: |
+        pipx install schemathesis==3.39.16
+        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
      if: ${{ matrix.config.name == 'gcc_coverage' }}
      env:
@@ -79,17 +185,178 @@ jobs:
        lcov --list coverage.info
        bash <(curl -s https://codecov.io/bash) -f coverage.info || echo 'Codecov error'

+  build_debian:
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-24.04
+
+    name: "${{ matrix.os }} (build Debian)"
+    runs-on: ${{ matrix.os }}
+
+    steps:
+
+    - uses: actions/checkout@v4
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get update -qq
+        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPS_UBUNTU }}
+
+    - name: Test Debian patches
+      run: ./tools/build_debian.sh test-patches
+
+    - name: Build Debian packages
+      run: ./tools/build_debian.sh devel ubuntu/noble
+
+    - name: Install Debian packages
+      run: sudo dpkg -i ../weechat-devel*.deb
+
+    - name: Run WeeChat
+      env:
+        TERM: xterm-256color
+      run: |
+        weechat --help
+        weechat-curses --help
+        weechat --version
+        weechat --build-info
+        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
+
+  codeql-analysis:
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-24.04
+
+    name: "${{ matrix.os }} (CodeQL)"
+    runs-on: ${{ matrix.os }}
+
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get update -qq
+        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPS_UBUNTU }}
+        # uninstall php imagick as is causes a crash when loading php plugin (see #2009)
+        sudo apt-get --yes purge php8.3-imagick
+        pipx install 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"
+
+  tests_rockylinux:
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-24.04
+        config:
+          - { name: "gcc", cc: "gcc", cxx: "g++", buildargs: "" }
+          - { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" }
+
+    name: "rockylinux-9 (${{ matrix.config.name }})"
+    runs-on: ${{ matrix.os }}
+    container:
+      image: rockylinux:9
+
+    steps:
+
+    - uses: actions/checkout@v4
+
+    - name: Install dependencies
+      run: |
+        dnf install -y epel-release
+        dnf config-manager --set-enabled crb
+        dnf install -y ${{ env.WEECHAT_DEPS_ROCKYLINUX }}
+
+    - name: Build and run tests
+      env:
+        CC: ${{ matrix.config.cc }}
+        CXX: ${{ matrix.config.cxx }}
+        BUILDARGS: ${{ matrix.config.buildargs }}
+      run: ./tools/build_test.sh
+
+    - name: Run WeeChat
+      env:
+        TERM: xterm-256color
+      run: |
+        weechat --help
+        weechat-curses --help
+        weechat --version
+        weechat --build-info
+        weechat --colors
+        weechat --license
+        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
+
+  tests_freebsd:
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu-24.04
+        config:
+          # - { name: "gcc", cc: "gcc", cxx: "g++", buildargs: "" }
+          - { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" }
+
+    name: "freebsd-14 (${{ matrix.config.name }})"
+    runs-on: ${{ matrix.os }}
+
+    steps:
+
+    - uses: actions/checkout@v4
+
+    - name: Install dependencies, build and run tests, run WeeChat
+      uses: vmactions/freebsd-vm@v1
+      env:
+        CC: ${{ matrix.config.cc }}
+        CXX: ${{ matrix.config.cxx }}
+        BUILDARGS: ${{ matrix.config.buildargs }}
+        TERM: xterm-256color
+      with:
+        envs: "CC CXX BUILDARGS TERM"
+        usesh: true
+        prepare: pkg install -y ${{ env.WEECHAT_DEPS_FREEBSD }}
+        run: |
+          ./tools/build_test.sh
+          weechat --help
+          weechat-curses --help
+          weechat --version
+          weechat --build-info
+          weechat --colors
+          weechat --license
+          weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
+
  tests_macos:

    strategy:
      matrix:
        os:
-          - macos-12
+          - macos-14
        config:
          - { name: "gcc", cc: "gcc", cxx: "g++" }
          - { name: "clang", cc: "clang", cxx: "clang++" }

-    name: "Tests: ${{ matrix.config.name }} on ${{ matrix.os }}"
+    name: "${{ matrix.os }} (${{ matrix.config.name }})"
    runs-on: ${{ matrix.os }}

    steps:
@@ -114,9 +381,9 @@ jobs:
          /usr/local/bin/python3.11 \
          /usr/local/bin/python3.11-config \
        ;
-        brew install asciidoctor guile lua pkg-config ruby
+        brew install asciidoctor aspell cjson guile lua pkg-config ruby

-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4

    - name: Build
      env:
@@ -134,44 +401,8 @@ jobs:
      run: |
        weechat --help
        weechat-curses --help
+        weechat --version
+        weechat --build-info
        weechat --colors
        weechat --license
-        weechat --version
-        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
-
-  build_debian:
-
-    strategy:
-      matrix:
-        os:
-          - ubuntu-22.04
-
-    name: "Build Debian on ${{ matrix.os }}"
-    runs-on: ${{ matrix.os }}
-
-    steps:
-
-    - uses: actions/checkout@v2
-
-    - name: Install dependencies
-      run: |
-        sudo apt-get update -qq
-        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPENDENCIES }}
-
-    - name: Test Debian patches
-      run: ./tools/build_debian.sh test-patches
-
-    - name: Build Debian packages
-      run: ./tools/build_debian.sh devel ubuntu/jammy
-
-    - name: Install Debian packages
-      run: sudo dpkg -i ../weechat-devel*.deb
-
-    - name: Run WeeChat
-      env:
-        TERM: xterm-256color
-      run: |
-        weechat --help
-        weechat-curses --help
-        weechat --version
        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
@@ -1,163 +0,0 @@
-= 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].
@@ -0,0 +1,167 @@
+# 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
+- Daniel Lublin
+- Danilo Spinella
+- David Flatz
+- Dmitry Kobylin
+- Dominik Honnef
+- Dominique Martinet
+- dotflac
+- Eduardo Elias
+- Eli Schwartz
+- Elizabeth Myers (Elizacat)
+- Elián Hanisch (m4v)
+- Emanuele Giaquinta
+- Emil Velikov
+- 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
+- James C. Morey
+- Jan Palus
+- Jason A. Donenfeld (zx2c4)
+- JD Horelick (jdhore)
+- jesopo
+- Jim Ramsay (lack)
+- Jiri Golembiovsky (GolemJ)
+- Joe Hermaszewski
+- Joey Pabalinas (alyptik)
+- Johan Rylander
+- Johannes Kuhn
+- Joram Schrijver
+- Jos Ahrens
+- Joseph Kichline
+- Josh Soref
+- 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
+- Yiheng Cao
+- ZethJack
+- Ørjan Malde
+
+## Contact
+
+See the [support page](https://weechat.org/about/support/).
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net>
 # Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
 #
@@ -19,7 +19,7 @@
 # along with WeeChat.  If not, see <https://www.gnu.org/licenses/>.
 #

-cmake_minimum_required(VERSION 3.5)
+cmake_minimum_required(VERSION 3.18)

 project(weechat C)

@@ -100,6 +100,7 @@ option(ENABLE_HEADLESS       "Compile the headless binary"              ON)
 option(ENABLE_NLS            "Enable Native Language Support"           ON)
 option(ENABLE_LARGEFILE      "Enable Large File Support"                ON)
 option(ENABLE_ZSTD           "Enable Zstandard compression"             ON)
+option(ENABLE_CJSON          "Enable cJSON support"                     ON)
 option(ENABLE_ALIAS          "Enable Alias plugin"                      ON)
 option(ENABLE_BUFLIST        "Enable Buflist plugin"                    ON)
 option(ENABLE_CHARSET        "Enable Charset plugin"                    ON)
@@ -165,6 +166,16 @@ if(ENABLE_TESTS AND NOT ENABLE_HEADLESS)
  message(FATAL_ERROR "Headless mode is required for tests.")
 endif()

+# Set this to override aspell's dictionaries directory
+if(ASPELL_DICT_DIR)
+  add_definitions(-DASPELL_DICT_DIR="${ASPELL_DICT_DIR}")
+endif()
+
+# Set this to override the myspell dictionaries directory when using enchant
+if(ENCHANT_MYSPELL_DICT_DIR)
+  add_definitions(-DENCHANT_MYSPELL_DICT_DIR="${ENCHANT_MYSPELL_DICT_DIR}")
+endif()
+
 # option WEECHAT_HOME
 set(WEECHAT_HOME "${WEECHAT_HOME}" CACHE
  STRING "Force a single WeeChat home directory for config, logs, scripts, etc."
@@ -187,31 +198,53 @@ include(FindPkgConfig)
 include(CheckIncludeFiles)
 include(CheckFunctionExists)
 include(CheckSymbolExists)
+include(CheckLibraryExists)

 check_include_files("langinfo.h" HAVE_LANGINFO_CODESET)
 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(mallinfo2 HAVE_MALLINFO2)

+check_symbol_exists("htonll" "sys/types.h;netinet/in.h;inttypes.h" HAVE_HTONLL)
+
 check_symbol_exists("eat_newline_glitch" "term.h" HAVE_EAT_NEWLINE_GLITCH)

+# Check if res_init requires libresolv
+check_function_exists(res_init, LIBC_HAS_RES_INIT)
+if(NOT LIBC_HAS_RES_INIT)
+  find_library(RESOLV_LIBRARY resolv)
+  if(RESOLV_LIBRARY)
+    check_library_exists("${RESOLV_LIBRARY}" res_init "" LIBRESOLV_HAS_RES_INIT)
+    if(LIBRESOLV_HAS_RES_INIT)
+      list(APPEND EXTRA_LIBS ${RESOLV_LIBRARY})
+    endif()
+  endif()
+endif()
+
 # Check for Large File Support
 if(ENABLE_LARGEFILE)
  add_definitions(-D_FILE_OFFSET_BITS=64 -D_LARGEFILE64_SOURCE -D_LARGEFILE_SOURCE -D_LARGE_FILES)
 endif()

+# _XPG4_2 is needed for macros like CMSG_SPACE
+# __EXTENSIONS__ is needed for constants like NI_MAXHOST and for struct timeval
+if(CMAKE_HOST_SOLARIS)
+  add_definitions(-D_XPG4_2 -D__EXTENSIONS__)
+endif()
+
 # Check for libgcrypt
-find_package(GCRYPT REQUIRED)
-add_definitions(-DHAVE_GCRYPT)
-list(APPEND EXTRA_LIBS ${GCRYPT_LDFLAGS})
+pkg_check_modules(LIBGCRYPT REQUIRED libgcrypt)
+include_directories(${LIBGCRYPT_INCLUDE_DIRS})
+list(APPEND EXTRA_LIBS ${LIBGCRYPT_LDFLAGS})

 # Check for GnuTLS
-find_package(GnuTLS REQUIRED)
-string(REGEX REPLACE "/[^/]*$" "" GNUTLS_LIBRARY_PATH "${GNUTLS_LIBRARY}")
-include_directories(${GNUTLS_INCLUDE_PATH})
-set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -L${GNUTLS_LIBRARY_PATH}")
-list(APPEND EXTRA_LIBS gnutls)
+pkg_check_modules(GNUTLS REQUIRED gnutls>=3.3.0)
+include_directories(${GNUTLS_INCLUDE_DIRS})
+list(APPEND EXTRA_LIBS ${GNUTLS_LDFLAGS})

 # Check for zlib
 find_package(ZLIB REQUIRED)
@@ -222,6 +255,12 @@ if(ENABLE_ZSTD)
  add_definitions(-DHAVE_ZSTD)
 endif()

+# Check for cJSON
+if(ENABLE_CJSON)
+  pkg_check_modules(LIBCJSON REQUIRED libcjson)
+  add_definitions(-DHAVE_CJSON)
+endif()
+
 # Check for iconv
 find_package(Iconv)
 if(ICONV_FOUND)
@@ -229,28 +268,25 @@ if(ICONV_FOUND)
 endif()

 # Check for CURL
-find_package(CURL REQUIRED)
-
-# weechat_gui_common MUST be the first lib in the list
-set(STATIC_LIBS weechat_gui_common)
+# NOTE: keep version in sync with tools/check_curl_symbols.py
+pkg_check_modules(LIBCURL REQUIRED libcurl>=7.47.0)
+include_directories(${LIBCURL_INCLUDE_DIRS})
+list(APPEND EXTRA_LIBS ${LIBCURL_LDFLAGS})

 find_library(DL_LIBRARY
  NAMES dl
  PATHS /lib /usr/lib /usr/libexec /usr/local/lib /usr/local/libexec
 )
-list(APPEND STATIC_LIBS weechat_plugins)
 if(DL_LIBRARY)
-  string(REGEX REPLACE "/[^/]*$" "" DL_LIBRARY_PATH "${DL_LIBRARY}")
-  set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -L${DL_LIBRARY_PATH}")
-  list(APPEND EXTRA_LIBS dl)
+  list(APPEND EXTRA_LIBS ${DL_LIBRARY})
 endif()

 add_subdirectory(icons)

 if(ENABLE_NLS)
  find_package(Gettext REQUIRED)
-  add_definitions(-DENABLE_NLS)
  find_package(Intl REQUIRED)
+  include_directories(${Intl_INCLUDE_DIRS})
  list(APPEND EXTRA_LIBS "${Intl_LIBRARIES}")
  add_subdirectory(po)
 else()
@@ -311,11 +347,11 @@ configure_file("${CMAKE_CURRENT_SOURCE_DIR}/weechat.cygport.in" "${CMAKE_CURRENT
 # install some files (only on Cygwin)
 if(CYGWIN)
  install(FILES
-    "${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.adoc"
-    "${CMAKE_CURRENT_SOURCE_DIR}/ChangeLog.adoc"
-    "${CMAKE_CURRENT_SOURCE_DIR}/Contributing.adoc"
-    "${CMAKE_CURRENT_SOURCE_DIR}/README.adoc"
-    "${CMAKE_CURRENT_SOURCE_DIR}/ReleaseNotes.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.md"
+    "${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md"
+    "${CMAKE_CURRENT_SOURCE_DIR}/CONTRIBUTING.md"
+    "${CMAKE_CURRENT_SOURCE_DIR}/README.md"
+    "${CMAKE_CURRENT_SOURCE_DIR}/UPGRADING.md"
    DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}"
  )
 endif()
@@ -0,0 +1,109 @@
+# 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).
@@ -1,109 +0,0 @@
-= 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].
@@ -1,67 +0,0 @@
-: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/mastodon-follow-blue.svg["Mastodon", link="https://hostux.social/@weechat"]
-image:https://img.shields.io/badge/diaspora*-follow-blue.svg["Diaspora*", link="https://diasp.eu/u/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-2024 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/>.
@@ -0,0 +1,66 @@
+# 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-2025 [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/>.
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2014-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2014-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,53 +0,0 @@
-#
-# Copyright (C) 2003-2024 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,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net>
 # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
 #
@@ -1,75 +0,0 @@
-#
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.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 GnuTLS
-# This module finds if libgnutls is installed and determines where
-# the include files and libraries are.
-#
-# This code sets the following variables:
-#
-#  GNUTLS_INCLUDE_PATH = path to where <gnutls/gnutls.h> can be found
-#  GNUTLS_LIBRARY = path to where libgnutls.so* can be found
-#  GNUTLS_CFLAGS = cflags to use to compile
-#  GNUTLS_LDFLAGS = ldflags to use to compile
-
-if(GNUTLS_INCLUDE_PATH AND GNUTLS_LIBRARY)
-  # Already in cache, be silent
-  set(GNUTLS_FIND_QUIETLY TRUE)
-endif()
-
-find_program(PKG_CONFIG_EXECUTABLE NAMES pkg-config)
-
-execute_process(COMMAND ${PKG_CONFIG_EXECUTABLE} --variable=prefix gnutls
-  OUTPUT_VARIABLE GNUTLS_PREFIX
-)
-
-execute_process(COMMAND ${PKG_CONFIG_EXECUTABLE} --cflags gnutls
-  OUTPUT_VARIABLE GNUTLS_CFLAGS
-)
-string(REGEX REPLACE "[\r\n]" "" GNUTLS_CFLAGS "${GNUTLS_CFLAGS}")
-
-execute_process(COMMAND ${PKG_CONFIG_EXECUTABLE} --libs gnutls
-  OUTPUT_VARIABLE GNUTLS_LDFLAGS
-)
-string(REGEX REPLACE "[\r\n]" "" GNUTLS_LDFLAGS "${GNUTLS_LDFLAGS}")
-
-set(GNUTLS_POSSIBLE_INCLUDE_PATH "${GNUTLS_PREFIX}/include")
-set(GNUTLS_POSSIBLE_LIB_DIR "${GNUTLS_PREFIX}/lib")
-
-find_path(GNUTLS_INCLUDE_PATH
-  NAMES gnutls/gnutls.h
-  PATHS GNUTLS_POSSIBLE_INCLUDE_PATH
-)
-
-find_library(GNUTLS_LIBRARY
-  NAMES gnutls
-  PATHS GNUTLS_POSSIBLE_LIB_DIR
-)
-
-if(NOT GNUTLS_INCLUDE_PATH OR NOT GNUTLS_LIBRARY)
-  message(FATAL_ERROR "GnuTLS was not found")
-endif()
-
-mark_as_advanced(
-  GNUTLS_INCLUDE_PATH
-  GNUTLS_LIBRARY
-  GNUTLS_CFLAGS
-  GNUTLS_LDFLAGS
-)
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2011-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2011-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -35,5 +35,5 @@ endif()

 find_package(PkgConfig)
 if(PKG_CONFIG_FOUND)
-  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)
+  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)
 endif()
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,6 +1,6 @@
 #
 # Copyright (C) 2017 Adam Saponara <as@php.net>
-# Copyright (C) 2017-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2017-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -29,6 +29,8 @@ endif()

 if(NOT PHP_FOUND)
  find_program(PHP_CONFIG_EXECUTABLE NAMES
+    php-config8.4 php-config84
+    php-config8.3 php-config83
    php-config8.2 php-config82
    php-config8.1 php-config81
    php-config8.0 php-config80
@@ -48,7 +50,7 @@ if(NOT PHP_FOUND)
    execute_process(COMMAND ${PHP_CONFIG_EXECUTABLE} --version OUTPUT_VARIABLE PHP_VERSION OUTPUT_STRIP_TRAILING_WHITESPACE)
    if(${PHP_VERSION} MATCHES "^[78]")
      find_library(PHP_LIB
-        NAMES php8.2 php82 php8.1 php81 php8.0 php80 php8 php7.4 php74 php7.3 php73 php7.2 php72 php7.1 php71 php7.0 php70 php7 php
+        NAMES php8.4 php84 php8.3 php83 php8.2 php82 php8.1 php81 php8.0 php80 php8 php7.4 php74 php7.3 php73 php7.2 php72 php7.1 php71 php7.0 php70 php7 php
        HINTS ${PHP_LIB_PREFIX} ${PHP_LIB_PREFIX}/lib ${PHP_LIB_PREFIX}/lib64
      )
      if(PHP_LIB)
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,34 +0,0 @@
-#
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net>
-#
-# 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 Python
-# This module finds if Python 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:
-#
-#  PYTHON_EXECUTABLE   = full path to the python binary
-#  PYTHON_INCLUDE_DIRS = path to where python.h can be found
-#  PYTHON_LIBRARIES = path to where libpython.so* can be found
-#  PYTHON_LDFLAGS = python compiler options for linking
-
-pkg_check_modules(PYTHON python3-embed IMPORTED_TARGET GLOBAL)
-if(NOT PYTHON_FOUND)
-  pkg_check_modules(PYTHON python3 IMPORTED_TARGET GLOBAL)
-endif()
@@ -1,45 +0,0 @@
-#
-# Copyright (C) 2003-2024 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,5 +1,5 @@
 #
-# Copyright (C) 2015-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2015-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,3 +1,39 @@
+#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_FLOCK
 #cmakedefine HAVE_LANGINFO_CODESET
@@ -5,10 +41,17 @@
 #cmakedefine ICONV_2ARG_IS_CONST 1
 #cmakedefine HAVE_MALLINFO
 #cmakedefine HAVE_MALLINFO2
+#cmakedefine HAVE_MALLOC_H
+#cmakedefine HAVE_MALLOC_TRIM
+#cmakedefine HAVE_HTONLL
 #cmakedefine HAVE_EAT_NEWLINE_GLITCH
 #cmakedefine HAVE_ASPELL_VERSION_STRING
 #cmakedefine HAVE_ENCHANT_GET_VERSION
 #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 "@PROJECT_NAME@"
 #define PACKAGE_NAME "@PROJECT_NAME@"
@@ -6,7 +6,8 @@ Build-Depends:
    asciidoctor (>= 1.5.4),
    ruby-pygments.rb,
    debhelper (>= 12),
-    cmake, pkg-config,
+    cmake,
+    pkgconf,
    libncurses-dev,
    gem2deb,
    libperl-dev,
@@ -21,8 +22,9 @@ Build-Depends:
    libgcrypt20-dev,
    libgnutls28-dev,
    libzstd-dev,
-    zlib1g-dev
-Standards-Version: 4.6.2
+    zlib1g-dev,
+    libcjson-dev
+Standards-Version: 4.7.2
 Homepage: https://weechat.org/
 Vcs-Git: https://salsa.debian.org/kolter/weechat.git
 Vcs-Browser: https://salsa.debian.org/kolter/weechat
@@ -16,8 +16,5 @@ override_dh_auto_configure:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON

-override_dh_installchangelogs:
-	dh_installchangelogs ChangeLog.adoc
-
 %:
 	dh $@ --builddirectory=$(BUILDDIR)
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,9 @@
+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
@@ -0,0 +1,9 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -1,10 +0,0 @@
-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
@@ -1,10 +0,0 @@
-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
@@ -1,10 +0,0 @@
-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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -1,3 +1,50 @@
+weechat (4.6.1-1) unstable; urgency=medium
+
+  * New upstream release (Closes: #1102450, #1098090)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Wed, 16 Apr 2025 20:31:07 +0000
+
+weechat (4.5.1-1) unstable; urgency=medium
+
+  * New upstream release
+  * Update copyright file (new year)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Mon, 20 Jan 2025 14:39:42 +0000
+
+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

  * New upstream release
@@ -512,7 +559,7 @@ weechat (0.3.6-1) unstable; urgency=low
  documentation when weechat-doc is installed (Closes: #632621)
  * Add a Suggest on weechat-doc for weechat and weechat-curses. Thanks to
  Jonathan Nieder for the proposal.
-  * Fix the cmake invokation from debian/rules (cflags and ldflags)
+  * Fix the cmake invocation from debian/rules (cflags and ldflags)

 -- Emmanuel Bouthenot <kolter@debian.org>  Wed, 26 Oct 2011 20:10:09 +0000

@@ -734,7 +781,7 @@ weechat (0.2.3-1) unstable; urgency=low
  * New upstream release
  * Bump lua build-dependency to liblua5.1-0-dev
  * Add pkg-config to Build-Depends
-  * Remove some duplited changelog entries.
+  * Remove some duplicated changelog entries.
  * Improve weechat-plugins description

 -- Julien Louis <ptitlouis@sysif.net>  Fri, 12 Jan 2007 09:01:46 +0100
@@ -742,7 +789,7 @@ weechat (0.2.3-1) unstable; urgency=low
 weechat (0.2.1-1) unstable; urgency=low

  * New upstream release
-  * Overrive lintian menu-icon-missing warning
+  * Override lintian menu-icon-missing warning
    since the icon is in the weechat-common package.

 -- Julien Louis <ptitlouis@sysif.net>  Mon,  2 Oct 2006 15:30:06 +0200
@@ -887,7 +934,7 @@ weechat (0.1.1-2) unstable; urgency=low

  * debian/control:
    - Add myself to uploaders.
-    - Remove unecessary dependency on weechat-gtk (Closes: #308287).
+    - Remove unnecessary dependency on weechat-gtk (Closes: #308287).

 -- Julien Louis <ptitlouis@sysif.net>  Tue, 10 May 2005 22:38:52 +0200

@@ -6,7 +6,8 @@ Build-Depends:
    asciidoctor (>= 1.5.4),
    ruby-pygments.rb,
    debhelper (>= 12),
-    cmake, pkg-config,
+    cmake,
+    pkgconf,
    libncurses-dev,
    gem2deb,
    libperl-dev,
@@ -21,8 +22,9 @@ Build-Depends:
    libgcrypt20-dev,
    libgnutls28-dev,
    libzstd-dev,
-    zlib1g-dev
-Standards-Version: 4.6.2
+    zlib1g-dev,
+    libcjson-dev
+Standards-Version: 4.7.2
 Homepage: https://weechat.org/
 Vcs-Git: https://salsa.debian.org/kolter/weechat.git
 Vcs-Browser: https://salsa.debian.org/kolter/weechat
@@ -4,26 +4,26 @@ Upstream-Contact: Sébastien Helleu <flashcode@flashtux.org>
 Source: https://weechat.org/

 Files: *
-Copyright: 2003-2024, Sébastien Helleu <flashcode@flashtux.org>
+Copyright: 2003-2025, Sébastien Helleu <flashcode@flashtux.org>
 License: GPL-3+

-Files: src/core/wee-command.c
-       src/core/wee-command.h
+Files: src/core/core-command.c
+       src/core/core-command.h
 Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+

-Files: src/core/wee-config-file.c
-       src/core/wee-config-file.h
-       src/core/wee-config.c
-       src/core/wee-config.h
+Files: src/core/core-config-file.c
+       src/core/core-config-file.h
+       src/core/core-config.c
+       src/core/core-config.h
 Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+

-Files: src/core/hook/wee-hook-connect.c
+Files: src/core/hook/hook-connect.c
 Copyright: 2012, Simon Arlott
 License: GPL-3+

-Files: src/core/hook/wee-hook-connect.h
+Files: src/core/hook/hook-connect.h
 Copyright: 2012, Simon Arlott
 License: GPL-3+

@@ -31,9 +31,9 @@ Files: src/gui/gui-history.c
 Copyright: 2005, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+

-Files: src/core/wee-completion.c
-       src/core/wee-log.c
-       src/core/wee-utf8.c
+Files: src/core/core-completion.c
+       src/core/core-log.c
+       src/core/core-utf8.c
       src/core/weechat.h
       src/plugins/spell/spell-config.c
       src/plugins/spell/spell-config.h
@@ -45,7 +45,7 @@ Files: src/core/wee-completion.c
 Copyright: 2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+

-Files: src/core/wee-network.c
+Files: src/core/core-network.c
 Copyright: 2005-2010, Emmanuel Bouthenot <kolter@openics.org>
           2010, Gu1ll4um3r0m41n <aeroxteam@gmail.com>
           2012, Simon Arlott
@@ -16,8 +16,5 @@ override_dh_auto_configure:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON

-override_dh_installchangelogs:
-	dh_installchangelogs ChangeLog.adoc
-
 %:
 	dh $@ --builddirectory=$(BUILDDIR)
@@ -1,4 +1,5 @@
-AUTHORS.adoc
-Contributing.adoc
-README.adoc
-ReleaseNotes.adoc
+AUTHORS.md
+CHANGELOG.md
+CONTRIBUTING.md
+README.md
+UPGRADING.md
@@ -7,3 +7,4 @@ 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/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/sr/man1/weechat.1.gz usr/share/man/sr/man1/weechat-curses.1.gz
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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-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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,9 @@
+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
@@ -0,0 +1,9 @@
+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
@@ -1,10 +0,0 @@
-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
@@ -1,10 +0,0 @@
-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
@@ -1,10 +0,0 @@
-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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -0,0 +1,10 @@
+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
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2025 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
 #
 # This file is part of WeeChat, the extensible chat client.
@@ -28,7 +28,8 @@ if(ENABLE_MAN OR ENABLE_DOC)
  set(SCRIPTING_LANG de en 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(RELAY_LANG en fr ja sr)
+  set(RELAY_API_LANG en fr)
+  set(RELAY_WEECHAT_LANG en fr ja sr)
  set(DEV_LANG en fr ja sr)

  find_package(Asciidoctor)
@@ -39,7 +40,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
      -a reproducible
      -a "prewrap!"
      -a "webfonts!"
-      -a icons=font
      -a revnumber="${VERSION}"
      -a sectanchors
      -a source-highlighter=pygments
@@ -93,8 +93,17 @@ if(ENABLE_MAN OR ENABLE_DOC)
      -a docinfo1
    )

-    # asciidoctor arguments for relay protocol
-    set(ASCIIDOCTOR_RELAY_ARGS
+    # asciidoctor arguments for relay "api"
+    set(ASCIIDOCTOR_RELAY_API_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 toclevels=3
      -a sectnums
@@ -111,54 +120,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
      -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)
      set(AUTOGEN_FILES "")
      foreach(lang ${AUTOGEN_LANG})
@@ -177,6 +138,9 @@ if(ENABLE_MAN OR ENABLE_DOC)
          "${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_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()
      add_custom_target(doc-autogen ALL
@@ -240,6 +204,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${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"
          doc-autogen
          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_commands.${lang}.adoc"
@@ -260,6 +225,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_plugin_api.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
          doc-autogen
          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_completions.${lang}.adoc"
          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_config_priority.${lang}.adoc"
@@ -283,6 +249,10 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${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}"
          COMMENT "Building weechat_scripting.${lang}.html"
        )
@@ -297,6 +267,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_faq.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
          WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
          COMMENT "Building weechat_faq.${lang}.html"
        )
@@ -311,25 +282,44 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_quickstart.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
          WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
          COMMENT "Building 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}")
      endforeach()
-      # relay protocol
-      foreach(lang ${RELAY_LANG})
+      # relay "api"
+      foreach(lang ${RELAY_API_LANG})
        add_custom_command(
-          OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html"
-          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"
+          OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${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"
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
-          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${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_protocol.${lang}.html"
+          COMMENT "Building 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_protocol.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
+        add_custom_target(doc-relay-api-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html")
+        install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${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()
      # developer's guide
      foreach(lang ${DEV_LANG})
@@ -339,6 +329,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
          DEPENDS
          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_dev.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
          WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
          COMMENT "Building weechat_dev.${lang}.html"
        )
@@ -0,0 +1,23 @@
+// 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í
@@ -39,6 +39,10 @@
 *-h*, *--help*::
    Zobrazí nápovědu.

+// TRANSLATION MISSING
+*-i*, *--build-info*::
+    Display build information and exit.
+
 *-l*, *--license*::
    Zobrazí licenci WeeChatu.

@@ -97,9 +97,9 @@ $HOME/.local/share/weechat/weechat.log::

 // tag::copyright[]
 WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
-souboru AUTHORS.adoc).
+souboru AUTHORS.md).

-Copyright (C) 2003-2024 {author}
+Copyright (C) 2003-2025 {author}

 WeeChat is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: cs
+include::includes/attributes-cs.adoc[]

 [[start]]
 == Spuštění WeeChatu
@@ -12,8 +13,9 @@ klávesových zkratek.

 Spustění z Vašeho shellu:

+[source,shell]
 ----
-$ weechat
+weechat
 ----

 [[help]]
@@ -285,7 +287,7 @@ Close a server, channel or private buffer (`/close` is an alias for
 ----

 // TRANSLATION MISSING
-[WARNING]
+[CAUTION]
 Closing the server buffer will close all channel/private buffers.

 // TRANSLATION MISSING
@@ -0,0 +1,23 @@
+// 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
@@ -35,6 +35,9 @@
 *-h*, *--help*::
    zeigt einen Hilfstext an.

+*-i*, *--build-info*::
+    Build-Informationen anzeigen und beenden.
+
 *-l*, *--license*::
    zeigt die Lizenz von WeeChat an.

@@ -98,9 +98,9 @@ $HOME/.local/share/weechat/weechat.log::

 // tag::copyright[]
 WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
-findet man in der AUTHORS.adoc Datei).
+findet man in der AUTHORS.md Datei).

-Copyright (C) 2003-2024 {author}
+Copyright (C) 2003-2025 {author}

 WeeChat is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]

 Übersetzer:

@@ -54,12 +54,14 @@ Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.
 Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird.
 Hilfe erhält man mittels:

+[source,shell]
 ----
 brew info weechat
 ----

 WeeChat kann durch folgenden Befehl installiert werden:

+[source,shell]
 ----
 brew install weechat
 ----
@@ -331,11 +333,14 @@ 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]
 in Verbindung mit der Auswahl durch die Maus.

+Die Nickliste kann umgeschaltet und nur bei Bedarf sichtbar gemacht werden, mit der Taste kbd:[Alt+Shift+N].
+
 Eine weitere Möglichkeit besteht darin,
 die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positionieren:

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 [[urls]]
@@ -345,10 +350,13 @@ Dazu kann man den vereinfachten Anzeigemodus nutzen (Standardtaste: kbd:[Alt+l]

 Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werden:

+* Nickliste umschalten und nur bei Bedarf darstellen, mit dem Tastenkurzbefehl kbd:[Alt+Shift+N]
+
 * Die Benutzerliste am oberen Bildschirmbereich positionieren.

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 * Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren.
@@ -399,6 +407,7 @@ Umgebungsvariable `TZ` muss auf einen entsprechenden Wert eingestellt werden.
 Am Besten machen Sie dies in Ihrer Shell-Initialisierungsdatei oder in der
 Befehlszeile, bevor Sie WeeChat starten:

+[source,shell]
 ----
 export TZ=Europe/Berlin
 ----
@@ -713,8 +722,9 @@ Entsprechend der ausgegebenen Information, wird ggf. eine Maus nicht unterstütz
 Um zu testen ob eine Mausunterstützung vom Terminal bereitgestellt wird, sollte
 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
@@ -722,8 +732,9 @@ Ecke). Als Ergebnis sollte man folgende Zeichenkette erhalten: " !!#!!".

 Um die Mausunterstützung im Terminal zu beenden:

+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----

 [[mouse_coords]]
@@ -790,7 +801,7 @@ Man sollte versuchen, eine andere Priorität zu nutzen; Im folgenden Beispiel
 muss "xxx" durch den betroffenen Servernamen ersetzt werden:

 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----

 [[irc_tls_libera]]
@@ -1067,8 +1078,9 @@ 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
 folgenden Befehl in der Shell ausführen:

+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----

 [NOTE]
@@ -1092,15 +1104,17 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss

 * und in der Shell, mit installiertem curl:

+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+cd ~/.cache/weechat/script
+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,
 versuchen Sie, diese Variable in Ihrer Shell-Initialisierungsdatei oder auf der
 Befehlszeile zu setzen. Bevor Sie WeeChat starten:

+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1272,6 +1286,7 @@ siehe https://weechat.org/about/support/[this page ^↗^^].

 Falls man WeeChat in gdb ausführt, kann folgende Fehlermeldung erscheinen:

+[source,shell]
 ----
 $ gdb /Pfad/zu/weechat
 (gdb) run
@@ -1282,6 +1297,7 @@ Cannot find new threads: generic error
 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):

+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
 (gdb) run
@@ -1290,7 +1306,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
 [[supported_os]]
 === Auf welchen Plattformen läuft WeeChat und wird es noch auf andere Betriebssysteme portiert?

-WeeChat läuft auf den meisten Linux/BSD-Distributionen, GNU/Hurd, Mac OS und
+WeeChat läuft auf den meisten Linux/BSD-Distributionen, GNU/Hurd, macOS und
 Windows (Cygwin und Windows Subsystem für Linux) einwandfrei.

 Wir geben unser Bestes, WeeChat auf möglichst viele Plattformen zu portieren.
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]

 Übersetzer:

@@ -19,8 +19,9 @@ keine Probleme mit der Standard Tastaturbelegung.

 Programmstart aus deiner Shell:

+[source,shell]
 ----
-$ weechat
+weechat
 ----

 [[help]]
@@ -300,7 +301,7 @@ Einen Buffer schließen (Server, Channel, privater Buffer);
 /close
 ----

-[WARNING]
+[CAUTION]
 Wird ein Server-Buffer geschlossen,
 schließt WeeChat ebenfalls alle zum Server
 gehörenden Channels und privaten Buffer.
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]

 Ü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`
 importiert werden muss. +
 Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
+https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].

 [[python_functions]]
 ===== Funktionen
@@ -373,9 +373,10 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.

 Ein Beispiel für ein Python-Skript:

+[source,shell]
 ----
-$ cd ~/.local/share/weechat/python/autoload
-$ ln -s ../script.py
+cd ~/.local/share/weechat/python/autoload
+ln -s ../script.py
 ----

 [NOTE]
@@ -564,317 +565,14 @@ lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^

 Liste der Skript API Funktionen:

-[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_datetime_tags (für Python: prnt_datetime_tags) +
-  print_y (für Python: prnt_y) +
-  print_y_date_tags (für Python: prnt_y_date_tags) +
-  print_y_datetime_tags (für Python: prnt_y_datetime_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
-|===
+include::{autogendir}/autogen_scripting_functions.de.adoc[tag=functions]

 [[script_api_constants]]
 === Konstanten

 Liste der Konstanten in Skript API:

-[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)
-|===
+include::{autogendir}/autogen_scripting_constants.de.adoc[tag=constants]

 [[common_tasks]]
 == Gemeinschaftsaufgabe
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]

 Übersetzer:

@@ -35,7 +35,7 @@ wesentliche Merkmale:
  https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
  https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] und
  https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
-* IRC proxy und relay für remote Schnittstellen
+* IRC proxy und relay für WeeChat und Remote-Schnittstellen
 * Betriebssystemunabhängig (GNU/Linux, *BSD, macOS, Windows und weitere)
 * 100% GPL, freie Software

@@ -115,7 +115,7 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
 | cmake | ≥ 3.0
 | bauen.

-| pkg-config |
+| pkgconf / pkg-config |
 | entdeckt installierte Bibliotheken.

 | libncurses-dev |
@@ -133,7 +133,8 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee

 | zlib1g-dev |
 | Logger-Erweitertung: Kompression von rotierenden Protokolldateien (gzip). +
-  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
+  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^]
+  (api und weechat Protokollen). +
  Script-Erweiterung: Lesen der Repository-Indexdatei (gzip).
 |===

@@ -159,9 +160,14 @@ WeeChat optional sind:
 | ca-certificates |
 | Zertifikate für TLS Verbindungen.

+| libcjson-dev |
+| Relay-Erweiterung: Protokoll "api" (HTTP REST API).
+
 | libzstd-dev | ≥ 0.8.1
+// TRANLSATION MISSING
 | Logger-Erweiterung: Kompression von rotierenden Protokolldateien (zstandard). +
-  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
+  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^]
+  (api and weechat protocols).

 | libaspell-dev / libenchant-dev |
 | Spell Erweiterung.
@@ -221,8 +227,9 @@ Falls eine Debian/Ubuntu basierte Distribution genutzt wird und man einen
 es mit folgendem Befehl möglich alle notwendigen Abhängigkeiten zu
 installieren:

+[source,shell]
 ----
-# apt-get build-dep weechat
+sudo apt-get build-dep weechat
 ----

 [[build]]
@@ -230,22 +237,24 @@ installieren:

 * Installation in das Systemverzeichnis (benötigt _root_ Privilegien):

+[source,shell]
 ----
-$ mkdir build
-$ cd build
-$ cmake ..
-$ make
-$ sudo make install
+mkdir build
+cd build
+cmake ..
+make
+sudo make install
 ----

 * Installation in ein benutzerdefiniertes Verzeichnis (zum Beispiel ins Heimatverzeichnis):

+[source,shell]
 ----
-$ mkdir build
-$ cd build
-$ cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
-$ make
-$ make install
+mkdir build
+cd build
+cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
+make
+make install
 ----

 Optionen für CMake können mit dem Format, `-DOPTION=VALUE`, genutzt werden.
@@ -279,6 +288,9 @@ Liste der verfügbaren Optionen:
 | ENABLE_CHARSET | `ON`, `OFF` | ON
 | 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
 | erstellt die man page.

@@ -378,14 +390,16 @@ Liste der verfügbaren Optionen:

 Weitere Optionen können mit folgendem Befehl angezeigt werden:

+[source,shell]
 ----
-$ cmake -LA
+cmake -LA
 ----

 oder mittels der Curses-Oberfläche:

+[source,shell]
 ----
-$ ccmake ..
+ccmake ..
 ----

 [[tests]]
@@ -398,14 +412,16 @@ Folgende Pakete werden *benötigt* um Tests zu kompilieren:

 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:

+[source,shell]
 ----
-$ ctest -V
+ctest -V
 ----

 [[git_sources]]
@@ -416,8 +432,9 @@ sich die Quellen nicht kompilieren oder der Code ist nicht stabil. Sie sind hier

 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>>).
@@ -438,8 +455,9 @@ Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:

 Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:

+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug
+cmake .. -DCMAKE_BUILD_TYPE=Debug
 ----

 [[address_sanitizer]]
@@ -448,18 +466,20 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
 Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort
 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]
+[CAUTION]
 Sie sollten die Adressbereinigung nur aktivieren, wenn Sie versuchen, einen
 Absturz zu provozieren. Diese Funktion wird im produktiven Einsatz nicht empfohlen.

 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`.
@@ -480,12 +500,14 @@ 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`
 Datei eingetragen werden:

+[source,shell]
 ----
 ulimit -c unlimited
 ----

 optional kann noch die maximale Dateigröße bestimmt werden:

+[source,shell]
 ----
 ulimit -c 200000
 ----
@@ -509,6 +531,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
 Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich
 in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen:

+[source,shell]
 ----
 gdb /usr/bin/weechat /home/user/core
 ----
@@ -527,11 +550,11 @@ Copying output to /tmp/crash.txt.
    at /some_path/src/core/weechat.c:351
 #3  <signal handler called>
 #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
-    remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
+    remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
        hook_process = 0x254eb90
        status = <value optimized out>
 #5  0x000000000044cc7d in hook_timer_exec ()
-    at /some_path/src/core/wee-hook.c:1025
+    at /some_path/src/core/core-hook.c:1025
        tv_time = {tv_sec = 1272693881, tv_usec = 212665}
        ptr_hook = 0x2811f40
        next_hook = 0x0
@@ -556,6 +579,7 @@ 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
 die PID des laufenden weechat Prozesses ersetzt werden):

+[source,shell]
 ----
 gdb /usr/bin/weechat 12345
 ----
@@ -571,8 +595,9 @@ Sollte WeeChat abgestürzt sein, muss der Befehl `bt full` genutzt 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
@@ -586,7 +611,7 @@ include::includes/cmdline_options.de.adoc[tag=standard]

 Einige zusätzliche Optionen sollten nur für Debug-Zwecke genutzt werden:

-[WARNING]
+[CAUTION]
 *KEINE* dieser Optionen sollte für ein Produktivsystem genutzt werden!

 include::includes/cmdline_options.de.adoc[tag=debug]
@@ -790,25 +815,24 @@ Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann ent
 die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf
 einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten:

+[source,shell]
 ----
-$ weechat --upgrade
+weechat --upgrade
 ----

 [[restart_after_upgrade]]
 === Neustart nach Upgrade

-[[restart_release_notes]]
-==== Versionshinweise
+[[restart_upgrading_notes]]
+==== Hinweise zum Upgrade

-Nach einem Upgrade wird *dringend empfohlen* die,
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^^]
-zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob
-eventuell ein manuelles Eingreifen erforderlich sein könnte.
+Nach einem Upgrade, wird *dringend empfohlen* das Dokukment
+https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
+zu lesen. Dieses Dokument enthält wichtige Informationen zu wichtigen Änderungen und
+einige manuelle Aktionen, die erforderlich sein könnten.

-Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen)
-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.
+Es sollten die Versionen zwischen der alten (abgelaufenen) und der neuen Version (eingeschlossen) gelesen werden. +
+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.

 [[restart_configuration_upgrade]]
 ==== Konfigurations-Upgrade
@@ -858,7 +882,7 @@ Beispiel des WeeChat-Terminals:
 │         │                                                                    │       │
 │         │                                                                    │       │
 │         │                                                                    │       │
-│         │[12:55] [5] [irc/libera] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]                │
+│         │[12:55] [5] [irc/libera] 2:#test(+n){4}* M [H: 3:#abc(2,5), 5]              │
 │         │[@Flashy(i)] hi peter!█                                                     │
 └──────────────────────────────────────────────────────────────────────────────────────┘
            ▲ Bars "status" und "input"                               Bar "nicklist" ▲
@@ -897,32 +921,34 @@ Die _status_-Bar besitzt als Standardeinträge:

 [width="100%",cols="^3,^3,9",options="header"]
 |===
-| Item                  | Beispiel              | Beschreibung
-| time                  | `[12:55]`             | Uhrzeit.
-| buffer_last_number    | `[5]`                 | Nummer des letzten Buffers.
-| buffer_plugin         | `[irc/libera]`        | Erweiterung des aktuellen Buffers (IRC Erweiterung setzt den IRC Servername für den Buffer).
-| buffer_number         | `2`                   | Aktuelle Nummer des Buffers.
-| buffer_name           | `#test`               | Name des aktuellen Buffers.
-| buffer_modes          | `+n`                  | IRC Kanal-Modi.
-| buffer_nicklist_count | `{4}`                 | Anzahl der Nicks die in der Nickliste angezeigt werden.
-| buffer_zoom           | !                     | `!` bedeutet, dass ein zusammengefügter Buffer gezoomed (nur dieser Buffer wird angezeigt) wird.
-| buffer_filter         | `+*+`                 | Filteranzeige: `+*+` bedeutet das Zeilen gefiltert (unterdrückt) werden. Ein leerer Eintrag zeigt an, dass alle Zeilen dargestellt werden.
-| scroll                | `-MORE(50)-`          | Scroll Indikator, zeigt an wie viele Zeilen unterhalb der zur Zeit dargestellten Zeile vorhanden sind.
-| lag                   | `[Lag: 2.5]`          | Verzögerungsanzeige, in Sekunden (keine Anzeige falls Verzögerung gering).
-| hotlist               | `[H: 3:#abc(2,5), 5]` | Liste der Buffer mit Aktivität (ungelesene Nachrichten) (für das Beispiel: 2 Highlights und 5 ungelesene Nachrichten im Kanal _#abc_, eine ungelesene Nachricht in Buffer #5).
-| completion            | `abc(2) def(5)`       | Liste von Wörtern für Vervollständigung, die Zahl zeigt an wie viele Varianten möglich sind.
+| Item                  | Beispiel               | Beschreibung
+| time                  | `12:55`                | Uhrzeit.
+| buffer_last_number    | `5`                    | Nummer des letzten Buffers (kann sich unterscheiden von `buffer_count` wenn Option <<option_weechat.look.buffer_auto_renumber,weechat.look.buffer_auto_renumber>> deaktiviert (`off`) ist).
+| buffer_plugin         | `irc/libera`           | Erweiterung des aktuellen Buffers (IRC Erweiterung setzt den IRC Servername für den Buffer).
+| buffer_number         | `2`                    | Aktuelle Nummer des Buffers.
+| buffer_name           | `#test`                | Name des aktuellen Buffers.
+| buffer_modes          | `+n`                   | IRC Kanal-Modi.
+| buffer_nicklist_count | `4`                    | Anzahl der Nicks die in der Nickliste angezeigt werden.
+| buffer_zoom           | !                      | `!` bedeutet, dass ein zusammengefügter Buffer gezoomed (nur dieser Buffer wird angezeigt) wird.
+| buffer_filter         | `+*+`                  | Filteranzeige: `+*+` bedeutet das Zeilen gefiltert (unterdrückt) werden. Ein leerer Eintrag zeigt an, dass alle Zeilen dargestellt werden.
+| mouse_status          | `M`                    | Mouse status (empty if mouse is disabled), see command <<command_weechat_mouse,/mouse>> and <<key_bindings_toggle_keys,Tasten zum Umschalten von Funktionen>>.
+| scroll                | `-MORE(50)-`           | Scroll Indikator, zeigt an wie viele Zeilen unterhalb der zur Zeit dargestellten Zeile vorhanden sind.
+| lag                   | `Lag: 2.5`             | Verzögerungsanzeige, in Sekunden (keine Anzeige falls Verzögerung gering).
+| hotlist               | `H: 3:#abc(2,5), 5`    | Liste der Buffer mit Aktivität (ungelesene Nachrichten) (für das Beispiel: 2 Highlights und 5 ungelesene Nachrichten im Kanal _#abc_, eine ungelesene Nachricht in Buffer #5).
+| typing                | `Typing: bob, (alice)` | Schreibbenachrichtigung, siehe <<typing_notifications,Schreibbenachrichtigung>>.
+| completion            | `abc(2) def(5)`        | Liste von Wörtern für Vervollständigung, die Zahl zeigt an wie viele Varianten möglich sind.
 |===

 In der _input_ Bar lautet die Standardeinstellung:

 [width="100%",cols="^3,^3,9",options="header"]
 |===
-| Item         | Beispiel                                      | Beschreibung
-| input_prompt | `[@Flashy(i)]`                                | Input prompt, für irc: Nick und Modi (Modus "+i" bedeutet auf libera, unsichtbar).
-| 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_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.
+| Item         | Beispiel                                    | Beschreibung
+| input_prompt | `@Flashy(i)`                                | Input prompt, für irc: Nick und Modi (Modus "+i" bedeutet auf libera, unsichtbar).
+| 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_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.
 |===

 Es existieren zwei Suchmodi:
@@ -957,8 +983,7 @@ andere Items die zur Verfügung stehen (die aber nicht standardmäßig in einer
 [width="100%",cols="^3,^3,9",options="header"]
 |===
 | Item                         | Beispiel                 | Beschreibung
-| buffer_count                 | `10`                     | absolute Anzahl an geöffneten Buffern.
-| buffer_last_number           | `10`                     | Nummer des letzten Buffers (kann sich unterscheiden von `buffer_count` wenn Option <<option_weechat.look.buffer_auto_renumber,weechat.look.buffer_auto_renumber>> deaktiviert (`off`) ist).
+| buffer_count                 | `5`                      | absolute Anzahl an geöffneten Buffern.
 | buffer_nicklist_count_all    | `4`                      | Anzahl der sichtbaren Gruppen und Nicks in der Nickliste.
 | buffer_nicklist_count_groups | `0`                      | Anzahl der sichtbaren Gruppen in der Nickliste.
 | buffer_short_name            | `#test`                  | Kurzname des aktuellen Buffers.
@@ -973,7 +998,7 @@ andere Items die zur Verfügung stehen (die aber nicht standardmäßig in einer
 | irc_nick_host                | `+Flashy!user@host.com+` | aktueller IRC Nick und Host.
 | irc_nick_modes               | `i`                      | IRC Modi für den eigenen Nick.
 | irc_nick_prefix              | `@`                      | IRC Nick-Präfix für den Kanal.
-| mouse_status                 | `M`                      | Status der Maus (keine Anzeige, falls Maus deaktiviert).
+| spacer                       |                          | spezielles Item um Text in einer Bar auszurichten, siehe <<item_spacer,Spacer item>>.
 | spell_dict                   | `de,en`                  | zeigt an welche Wörterbücher für die Rechtschreibung im aktuellen Buffer genutzt werden.
 | spell_suggest                | `Glück,Glocke,Block`     | Vorschläge für ein falsch geschriebenes Wort.
 | tls_version                  | `TLS1.3`                 | TLS Version die für den IRC Server genutzt wird.
@@ -1333,7 +1358,7 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
 | no_filter        | Zeile kann nicht gefiltert werden.
 | no_highlight     | die Zeile kann nicht gehiglighted werden.
 | no_log           | Zeile wird nicht in die Log-Datei geschrieben.
-| log0 … log9      | Grad der Protokollierung (siehe `/help logger`).
+| log0 … log9      | Grad der Protokollierung (siehe den Befehl <<command_logger_logger,/logger>>).
 | notify_none      | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^
 | notify_message   | Diese Zeile ist eine User Nachricht. ^(1)^
 | notify_private   | Diese Zeile ist eine private Nachricht. ^(1)^
@@ -1739,11 +1764,12 @@ Sie können mit dem Befehl <<command_weechat_key,/key>> geändert und neue hinzu

 [width="100%",cols="^.^3,.^8,.^5",options="header"]
 |===
-| Taste       | Beschreibung | Befehl
-| kbd:[Alt+m] | schaltet Mausfunktion ein/aus. | `+/mouse toggle+`
-| kbd:[Alt+s] | Umschalten der Rechtschreibprüfung. | `+/mute spell toggle+`
-| kbd:[Alt+=] | schaltet Filterfunktion an/aus. | `+/filter toggle+`
-| kbd:[Alt+-] | schaltet, für den aktuellen Buffer, Filterfunktion an/aus. | `+/filter toggle @+`
+| Taste                  | Beschreibung | Befehl
+| kbd:[Alt+m]            | schaltet Mausfunktion ein/aus. | `+/mouse toggle+`
+| kbd:[Alt+s]            | Umschalten der Rechtschreibprüfung. | `+/mute spell toggle+`
+| kbd:[Alt+=]            | schaltet Filterfunktion an/aus. | `+/filter toggle+`
+| kbd:[Alt+-]            | schaltet, für den aktuellen Buffer, Filterfunktion an/aus. | `+/filter toggle @+`
+| kbd:[Alt+Ctrl+l] (`L`) | Umschalten zwischen Remote- und lokalen Befehlen in einem Remote-Buffer (relay "api"). | `+/remote togglecmd+`
 |===

 [[key_bindings_search_context]]
@@ -2013,27 +2039,27 @@ Beispiel des fset-Buffer, der Optionen anzeigt, die mit `weechat.look` beginnen
 [subs="quotes"]
 ....
 ┌──────────────────────────────────────────────────────────────────────────────────────┐
-│1.weechat│1/121 | Filter: weechat.look.* | Sort: ~name | Key(input): alt+space=toggle │
-│2.fset   │weechat.look.bare_display_exit_on_input: exit the bare display mode on any c│
-│         │hanges in input [default: on]                                               │
+│1.weechat│7/125 | Filter: weechat.look.* | Sortierung: ~name | Taste(input): alt+Lee>>│
+│2.fset   │weechat.look.bare_display_exit_on_input: beendet den einfachen Anzeigemodus │
+│         │durch Tastendruck [Standardwert: on]                                        │
 │         │----------------------------------------------------------------------------│
-│         │  weechat.look.align_end_of_lines                   enum     message        │
-│         │  weechat.look.align_multiline_words                boolean  on             │
-│         │  weechat.look.bar_more_down                        string   "++"           │
-│         │  weechat.look.bar_more_left                        string   "<<"           │
-│         │  weechat.look.bar_more_right                       string   ">>"           │
-│         │  weechat.look.bar_more_up                          string   "--"           │
-│         │##  weechat.look.bare_display_exit_on_input           boolean  on             ##│
-│         │  weechat.look.bare_display_time_format             string   "%H:%M"        │
-│         │  weechat.look.buffer_auto_renumber                 boolean  on             │
-│         │  weechat.look.buffer_notify_default                enum     all            │
-│         │  weechat.look.buffer_position                      enum     end            │
-│         │  weechat.look.buffer_search_case_sensitive         boolean  off            │
-│         │  weechat.look.buffer_search_force_default          boolean  off            │
-│         │  weechat.look.buffer_search_regex                  boolean  off            │
-│         │  weechat.look.buffer_search_where                  enum     prefix_message │
-│         │  weechat.look.buffer_time_format                   string   "%H:%M:%S"     │
-│         │  weechat.look.buffer_time_same                     string   ""             │
+│         │  weechat.look.align_end_of_lines              Aufzählung    message        │
+│         │  weechat.look.align_multiline_words           boolesch      on             │
+│         │  weechat.look.bar_more_down                   Zeichenkette  "++"           │
+│         │  weechat.look.bar_more_left                   Zeichenkette  "<<"           │
+│         │  weechat.look.bar_more_right                  Zeichenkette  ">>"           │
+│         │  weechat.look.bar_more_up                     Zeichenkette  "--"           │
+│         │##  weechat.look.bare_display_exit_on_input      boolesch      on             ##│
+│         │  weechat.look.bare_display_time_format        Zeichenkette  "%H:%M"        │
+│         │  weechat.look.buffer_auto_renumber            boolesch      on             │
+│         │  weechat.look.buffer_notify_default           Aufzählung    all            │
+│         │  weechat.look.buffer_position                 Aufzählung    end            │
+│         │  weechat.look.buffer_search_case_sensitive    boolesch      off            │
+│         │  weechat.look.buffer_search_force_default     boolesch      off            │
+│         │  weechat.look.buffer_search_history           Aufzählung    local          │
+│         │  weechat.look.buffer_search_regex             boolesch      off            │
+│         │  weechat.look.buffer_search_where             Aufzählung    prefix_message │
+│         │  weechat.look.buffer_time_format              Zeichenkette  "%H:%M:%S"     │
 │         │[12:55] [2] [fset] 2:fset                                                   │
 │         │█                                                                           │
 └──────────────────────────────────────────────────────────────────────────────────────┘
@@ -2712,27 +2738,37 @@ 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
 und der Mausgeste (optional). Die unterschiedlichen Elemente werden durch ein `+-+` getrennt.

-Liste der Modifiers:
+Liste der Modifikatoren (in der Reihenfolge des Ereignisnamens):

 [width="100%",cols="1m,4",options="header"]
 |===
 | Modifier | Beschreibung
-| ctrl     | Taste kbd:[Ctrl]
 | alt      | Taste kbd:[Alt]
-| ctrl-alt | Taste kbd:[Ctrl] + kbd:[Alt]
+| ctrl     | Taste kbd:[Ctrl]
+| shift    | Taste kbd:[Shift] ^(1)^
 |===

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

 [width="100%",cols="1m,4",options="header"]
 |===
-| Maustaste/-rad      | Beschreibung
-| button1             | Linker Mausknopf wird gedrückt
-| button2             | Rechter Mausknopf wird gedrückt
-| button3             | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad)
-| button4 ... button9 | Ein zusätzlicher Mausknopf wird gedrückt
-| wheelup             | Mausrad wird nach oben gescrollt
-| wheeldown           | Mausrad wird nach unten gescrollt
+| Maustaste/-rad       | Beschreibung
+| button1              | Linker Mausknopf wird gedrückt
+| button2              | Rechter Mausknopf wird gedrückt
+| button3              | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad)
+| button4 ... button11 | Ein zusätzlicher Mausknopf wird gedrückt
+| wheelup              | Mausrad wird nach oben gescrollt
+| wheeldown            | Mausrad wird nach unten gescrollt
 |===

 Liste der Mausgesten (nur für Maustasten, nicht für das Mausrad, anwendbar):
@@ -2768,7 +2804,7 @@ Bespiele von Ereignissen:
 * `button1-event-drag`
 * `alt-button2-gesture-down-long`
 * `wheelup`
-* `ctrl-alt-wheeldown`
+* `alt-ctrl-wheeldown`

 [TIP]
 Wird eine Funktion im "mouse"-Kontext hinzufügt ist es möglich, mehrere
@@ -2830,8 +2866,9 @@ Option in die Sektion "option" der Aspell-Konfiguration hinzufügt.
 Den Name der Option findet man in der ASpell-Konfigurationsdatei. Eine Auflistung aller
 möglichen Optionen erhält man durch:

+[source,shell]
 ----
-$ aspell config
+aspell config
 ----

 Um zum Beispiel die Option "ignore-case" einzuschalten:
@@ -3283,7 +3320,7 @@ Passwörter beinhalten. Dies dient dazu Passwörter nicht im Klartext als
 Wert einer Option zu sichern. Dazu wird folgendes Format, anstelle des
 Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man
 dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). +
-Für eine vollständige Liste aller unterstützten Optionen, siehe  `/help secure`.
+Für eine vollständige Liste der unterstützen Optionen, siehe den Befehl <<command_weechat_secure,/secure>>.

 Um z.B. das oben eingestellte _libera_ Passwort für eine
 <<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen:
@@ -3406,8 +3443,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
 Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten
 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]]
@@ -3420,14 +3458,16 @@ Standardmäßig sind keine Server angelegt. Es gibt keine Begrenzung für die
 Anzahl von Servern. Server können mit dem Befehl <<command_irc_server,/server>>
 angelegt werden.

-Um zum Beispiel eine TLS verschlüsselte Verbindung zu
-https://libera.chat/[libera.chat ^↗^^] herzustellen:
+Zum Beispiel für eine Verbindung zu https://libera.chat/[libera.chat ^↗^^]:

 ----
-/server add libera irc.libera.chat/6697 -tls
+/server add libera irc.libera.chat
 ----

-Um WeeChat beim Start direkt mit dem Server zu verbinden:
+[NOTE]
+Der Standardport ist 6697 und TLS (verschlüsselter Datenverkehr) ist aktiviert.
+
+Um WeeChat, beim Programmstart, direkt mit einem Server zu verbinden:

 ----
 /set irc.server.libera.autoconnect on
@@ -3444,7 +3484,7 @@ Kapitel über <<irc_sasl_authentication,SASL authentication>>):
 ----

 Wenn SASL nicht unterstützt wird, können Sie einen Befehl verwenden, um eine
-Nachricht an nickserv zu senden, um sich zu Authentifizieren:
+Nachricht an nickserv zu senden, um sich zu authentifizieren:

 ----
 /set irc.server.libera.command "/msg nickserv identify ${sec.data.libera}"
@@ -3468,51 +3508,52 @@ Wenn Sie beispielsweise den _libera_-Server mit den obigen Befehlen erstellt hab
 sehen Sie dies mit dem Befehl `/fset libera`:

 ....
-irc.server.libera.addresses             string   "irc.libera.chat/6697"
-irc.server.libera.anti_flood_prio_high  integer  null -> 2
-irc.server.libera.anti_flood_prio_low   integer  null -> 2
-irc.server.libera.autoconnect           boolean  on
-irc.server.libera.autojoin              string   null -> ""
-irc.server.libera.autojoin_dynamic      boolean  null -> off
-irc.server.libera.autoreconnect         boolean  null -> on
-irc.server.libera.autoreconnect_delay   integer  null -> 10
-irc.server.libera.autorejoin            boolean  null -> off
-irc.server.libera.autorejoin_delay      integer  null -> 30
-irc.server.libera.away_check            integer  null -> 0
-irc.server.libera.away_check_max_nicks  integer  null -> 25
-irc.server.libera.capabilities          string   null -> "*"
-irc.server.libera.charset_message       enum     null -> message
-irc.server.libera.command               string   null -> ""
-irc.server.libera.command_delay         integer  null -> 0
-irc.server.libera.connection_timeout    integer  null -> 60
-irc.server.libera.default_chantypes     string   null -> "#&"
-irc.server.libera.ipv6                  boolean  null -> on
-irc.server.libera.local_hostname        string   null -> ""
-irc.server.libera.msg_kick              string   null -> ""
-irc.server.libera.msg_part              string   null -> "WeeChat ${info:version}"
-irc.server.libera.msg_quit              string   null -> "WeeChat ${info:version}"
-irc.server.libera.nicks                 string   null -> "alice,alice1,alice2,alice3,alice4"
-irc.server.libera.nicks_alternate       boolean  null -> on
-irc.server.libera.notify                string   null -> ""
-irc.server.libera.password              string   null -> ""
-irc.server.libera.proxy                 string   null -> ""
-irc.server.libera.realname              string   null -> ""
-irc.server.libera.sasl_fail             enum     null -> reconnect
-irc.server.libera.sasl_key              string   null -> ""
-irc.server.libera.sasl_mechanism        enum     null -> plain
-irc.server.libera.sasl_password         string   "${sec.data.libera}"
-irc.server.libera.sasl_timeout          integer  null -> 15
-irc.server.libera.sasl_username         string   "alice"
-irc.server.libera.split_msg_max_length  integer  null -> 512
-irc.server.libera.tls                   boolean  on
-irc.server.libera.tls_cert              string   null -> ""
-irc.server.libera.tls_dhkey_size        integer  null -> 2048
-irc.server.libera.tls_fingerprint       string   null -> ""
-irc.server.libera.tls_password          string   null -> ""
-irc.server.libera.tls_priorities        string   null -> "NORMAL:-VERS-SSL3.0"
-irc.server.libera.tls_verify            boolean  null -> on
-irc.server.libera.usermode              string   null -> ""
-irc.server.libera.username              string   null -> "alice"
+irc.server.libera.addresses             Zeichenkette  "irc.libera.chat"
+irc.server.libera.anti_flood            integer       null -> 2000
+irc.server.libera.autoconnect           boolesch      on
+irc.server.libera.autojoin              Zeichenkette  null -> ""
+irc.server.libera.autojoin_delay        integer       null -> 0
+irc.server.libera.autojoin_dynamic      boolesch      null -> off
+irc.server.libera.autoreconnect         boolesch      null -> on
+irc.server.libera.autoreconnect_delay   integer       null -> 10
+irc.server.libera.autorejoin            boolesch      null -> off
+irc.server.libera.autorejoin_delay      integer       null -> 30
+irc.server.libera.away_check            integer       null -> 0
+irc.server.libera.away_check_max_nicks  integer       null -> 25
+irc.server.libera.capabilities          Zeichenkette  null -> "*"
+irc.server.libera.charset_message       Aufzählung    null -> message
+irc.server.libera.command               Zeichenkette  null -> ""
+irc.server.libera.command_delay         integer       null -> 0
+irc.server.libera.connection_timeout    integer       null -> 60
+irc.server.libera.default_chantypes     Zeichenkette  null -> "#&"
+irc.server.libera.ipv6                  Aufzählung    null -> auto
+irc.server.libera.local_hostname        Zeichenkette  null -> ""
+irc.server.libera.msg_kick              Zeichenkette  null -> ""
+irc.server.libera.msg_part              Zeichenkette  null -> "WeeChat ${info:version}"
+irc.server.libera.msg_quit              Zeichenkette  null -> "WeeChat ${info:version}"
+irc.server.libera.nicks                 Zeichenkette  null -> "${username},${username}2,${username}3,${username}4,${username}5"
+irc.server.libera.nicks_alternate       boolesch      null -> on
+irc.server.libera.notify                Zeichenkette  null -> ""
+irc.server.libera.password              Zeichenkette  null -> ""
+irc.server.libera.proxy                 Zeichenkette  null -> ""
+irc.server.libera.realname              Zeichenkette  null -> ""
+irc.server.libera.registered_mode       Zeichenkette  null -> "r"
+irc.server.libera.sasl_fail             Aufzählung    null -> reconnect
+irc.server.libera.sasl_key              Zeichenkette  null -> ""
+irc.server.libera.sasl_mechanism        Aufzählung    null -> plain
+irc.server.libera.sasl_password         Zeichenkette  "${sec.data.libera}"
+irc.server.libera.sasl_timeout          integer       null -> 15
+irc.server.libera.sasl_username         Zeichenkette  "alice"
+irc.server.libera.split_msg_max_length  integer       null -> 512
+irc.server.libera.tls                   boolesch      null -> on
+irc.server.libera.tls_cert              Zeichenkette  null -> ""
+irc.server.libera.tls_dhkey_size        integer       null -> 2048
+irc.server.libera.tls_fingerprint       Zeichenkette  null -> ""
+irc.server.libera.tls_password          Zeichenkette  null -> ""
+irc.server.libera.tls_priorities        Zeichenkette  null -> "NORMAL"
+irc.server.libera.tls_verify            boolesch      null -> on
+irc.server.libera.usermode              Zeichenkette  null -> ""
+irc.server.libera.username              Zeichenkette  null -> "${username}"
 ....

 Wenn Sie beispielsweise automatisch eine Verbindung zu allen von Ihnen
@@ -3565,9 +3606,10 @@ die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat.

 * Importieren Sie die Zertifikate in einer Shell:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
+mkdir -p ~/.config/weechat/tls
+wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
 ----

 [NOTE]
@@ -3588,10 +3630,11 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden.

 * Erstellen Sie ein Zertifikat in der Shell:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
+mkdir -p ~/.config/weechat/tls
+cd ~/.config/weechat/tls
+openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----

 [NOTE]
@@ -3640,8 +3683,9 @@ dadurch kein Passwort während des Verbindungsaufbaus benötigt).

 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]
@@ -3651,8 +3695,9 @@ das auch beispielsweise `~/.weechat` sein kann.
 Um den öffentlichen Schlüssel zu erhalten (base64 enkodiert) muss
 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")
@@ -3722,8 +3767,9 @@ Privatsphäre und Sicherheit im Internet verbessern können.

 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
@@ -4007,7 +4053,7 @@ Spezifikation: https://ircv3.net/specs/extensions/message-tags[message-tags ^
 Diese Funktion ermöglicht das Hinzufügen von Metadaten zu Nachrichten. +
 Diese Tags können mit dem Befehl `/debug tags` angezeigt werden.

-Um diese Funktion zu verwenden, muss sie aktiviert werden: <<typing_notifications,typing notifications>>.
+Um diese Funktion zu verwenden, muss sie aktiviert werden: <<typing_notifications,Schreibbenachrichtigung>>.

 [[irc_ircv3_monitor]]
 ==== monitor
@@ -4078,7 +4124,7 @@ Mit dieser Funktion können Sie Ihren richtigen Namen ändern, indem Sie den

 Spezifikation: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]

-Siehe das entsprechende Kapitel <<typing_notifications,Typing notifications>>.
+Siehe das entsprechende Kapitel <<typing_notifications,Schreibbenachrichtigung>>.

 [[irc_ircv3_userhost_in_names]]
 ==== userhost-in-names
@@ -4147,7 +4193,7 @@ Schlüssel erfordert, aber nicht `#channel2`:
 /set irc.server.libera.autojoin "#channel1,#channel2 key1"
 ----

-Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`.
+Hilfe zum Format findet man unter Option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.

 [[irc_private_messages]]
 === private Nachrichten
@@ -4196,7 +4242,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
-dem selben Namen beginnen (siehe `/help filter`):
+dem selben Namen beginnen (siehe den Befehl <<command_weechat_filter,/filter>>):

 ----
 /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4590,8 +4636,13 @@ Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokoll

 * _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
  IRC Servern zu unterhalten.
-* _weechat_: Protokoll, das von Remote-Schnittstellen zur Anzeige und Interaktion verwendet wird
-  WeeChat, siehe https://weechat.org/about/interfaces/[this page ^↗^^].
+* _api_: HTTP REST API, wird von WeeChat und Remote-Schnittstellen zur Anzeige und
+   Interaktion mit WeeChat verwendet
+* _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]]
 === Passwort
@@ -4603,14 +4654,13 @@ Es wird dringend empfohlen, mit diesen Befehlen ein Passwort für das Relay fest
 /set relay.network.password "${sec.data.relay}"
 ----

-Dieses Passwort wird sowohl für das _irc_ als auch für das _weechat_ Protokoll
-verwendet.
+Dieses Passwort wird bei allen Protokollen verwendet.

 [[relay_totp]]
 === TOTP

-TOTP (Time-based One-Time Passwort) ist eine Zwei-Faktor-Authentifizierung
-für das _weechat_ Protokoll, als Ergänzung zum eigentlichen Passwort.
+TOTP (Time-based One-Time Password) kann als sekundärer Authentifizierungsfaktor
+für die Protokolle _api_ und _weechat_ zusätzlich zum Passwort verwendet werden.

 Diese Funktion is optional und erhöht den Sicherheitsgrad.

@@ -4648,10 +4698,11 @@ Der Standardpfad zum Zertifikat/Schlüssel wird durch die Option definiert
 Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen
 erstellen:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+mkdir -p ~/.config/weechat/tls
+cd ~/.config/weechat/tls
+openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
 ----

 [NOTE]
@@ -4707,6 +4758,46 @@ folgenden Befehlen einrichten:
 /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.
+
+Um eine lokale Verbindung via _api_ Relay mittels WeeChat herzustelen:
+
+----
+/remote add weechat http://localhost:9000 -password=mypassword
+/remote connect weechat
+----
+
+Um eine entfernte Verbindung via _api_Relay mittels WeeChat herzustelen
+(TLS wird dringend empfohlen):
+
+----
+/remote add weechat https://example.com: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]]
 === WeeChat Protokoll

@@ -4723,10 +4814,10 @@ dieses Protokoll verbinden.
 Zum Beispiel:

 ----
-/relay add weechat 9000
+/relay add weechat 9500
 ----

-Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort
+Nun kann man über den Port 9500 mittels einer Oberfläche und dem Passwort
 "meinPasswort" eine Verbindung zu WeeChat herstellen.

 [[relay_websocket]]
@@ -4743,11 +4834,13 @@ Ein WebSocket kann in HTML5, mit einer JavaScript Zeile, geöffnet werden:

 [source,javascript]
 ----
-websocket = new WebSocket("ws://server.com:9000/weechat");
+websocket = new WebSocket("ws://example.com:9500/weechat");
 ----

-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).
+Der Port (im Beispiel: 9500) ist der Port der in der Relay Erweiterung angegeben wurde.
+
+Die URI muss mit „/weechat“ für die Protokolle _irc_ und _weechat_ und mit „/api“
+für das Protokoll _api_ enden.

 [[relay_unix_socket]]
 === UNIX Domain Sockets
@@ -4767,8 +4860,9 @@ andere Ports nicht geöffnet werden können.

 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
@@ -4792,7 +4886,7 @@ Sektionen in Datei _relay.conf_:
 | network | /set relay.network.*               | Netzwerkoptionen.
 | irc     | /set relay.irc.*                   | für das IRC Protokoll spezifische Optionen (IRC Proxy).
 | port    | <<command_relay_relay,/relay add>> +
-            /set relay.port.*                  | Ports zur Nutzung der Relay-Erweiterung (IRC und weechat Protokolle) (Optionen können in Sektion hinzugefügt/entfernt werden).
+            /set relay.port.*                  | Ports zur Nutzung der Relay-Erweiterung (Optionen können in Sektion hinzugefügt/entfernt werden).
 |===

 Optionen:
@@ -4856,34 +4950,39 @@ einige Beispiele:

 * Ä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:

+[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"
  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:

+[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
  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]]
@@ -5217,7 +5316,9 @@ Zutreffende Gruppen können in _replace_ verwendet werden:

 * `+${re:0}+` nach `+${re:99}+`: `+${re:0}+` ist die ganze Trefferanzahl, `+${re:1}+` nach
  `+${re:99}+` sind als Gruppen erfasst.
-* `+${re:+}+`: das letzte Treffer (mit der höchsten Zahl)
+* `pass:[${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
  (Beispiele: `+${hide:*,${re:2}}+` ist die Gruppe #2, mit allen Zeichen die durch
  `+*+` ersetzt wurden).
@@ -5369,7 +5470,7 @@ und die Daten in einer Hashtable gesichert:
 | server               | string  | Name des Server (Beispiel: "libera").
 | tags                 | string  | Tags in Nachricht (findet selten Verwendung).
 | message_without_tags | string  | Nachricht ohne Tags.
-| nick                 | string  | Nick.
+| nick                 | string  | Nick. ^(1)^
 | host                 | string  | Hostname.
 | command              | string  | IRC Befehl (Beispiel: "PRIVMSG", "NOTICE", ...).
 | channel              | string  | IRC Channel.
@@ -5381,6 +5482,10 @@ und die Daten in einer Hashtable gesichert:
 | 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+`
 wie im folgenden Beispiel genutzt werden um den Inhalt von hdata zu lesen (im Beispiel
 wird der Pointer eines Buffer verwendet):
@@ -5795,7 +5900,7 @@ Aus Datenschutzgründen ist das Herunterladen von Skripten standardmäßig deakt
 Um es zu aktivieren, geben Sie diesen Befehl ein:

 ----
-/set script.scripts.download_enabled on
+/script enable
 ----

 Dann können Sie die Liste der Skripte herunterladen und in einem separaten Buffer,
@@ -5805,33 +5910,33 @@ mit dem Befehl <<command_script_script,/script>>, anzeigen lassen:
 :x: *
 ....
 ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│1.weechat│368/368 scripts (filter: {x}) | Sort: i,p,n | Alt+key/input: i=install, r=remove, l=load, L=reload, u=│
-│2.scripts│{x}      autosort.py                 3.9     2020-10-11 | Automatically keep buffers grouped by server│
-│         │{x}      multiline.pl                0.6.3   2016-01-02 | Multi-line edit box, also supports editing o│
-│         │{x}      highmon.pl                  2.7     2020-06-21 | Adds a highlight monitor buffer.            │
-│         │##{x}ia r  grep.py               0.8.5 0.8.5   2021-05-11 | Search regular expression in buffers or log ##│
-│         │{x}      autojoin.py                 0.3.1   2019-10-06 | Configure autojoin for all servers according│
-│         │{x}      colorize_nicks.py           28      2021-03-06 | Use the weechat nick colors in the chat area│
-│         │{x}ia r  go.py                 2.7   2.7     2021-05-26 | Quick jump to buffers.                      │
-│         │{x}      text_item.py                0.9     2019-05-25 | Add bar items with plain text.              │
-│         │       aesthetic.py                1.0.6   2020-10-25 | Make messages more A E S T H E T I C A L L Y│
-│         │       aformat.py                  0.2     2018-06-21 | Alternate text formatting, useful for relays│
-│         │       alternatetz.py              0.3     2018-11-11 | Add an alternate timezone item.             │
-│         │       amarok2.pl                  0.7     2012-05-08 | Amarok 2 control and now playing script.    │
-│         │       amqp_notify.rb              0.1     2011-01-12 | Send private messages and highlights to an A│
-│         │       announce_url_title.py       19      2021-06-05 | Announce URL title to user or to channel.   │
-│         │       anotify.py                  1.0.2   2020-05-16 | Notifications of private messages, highlight│
-│         │       anti_password.py            1.2.1   2021-03-13 | Prevent a password from being accidentally s│
-│         │       apply_corrections.py        1.3     2018-06-21 | Display corrected text when user sends s/typ│
-│         │       arespond.py                 0.1.1   2020-10-11 | Simple autoresponder.                       │
-│         │       atcomplete.pl               0.001   2016-10-29 | Tab complete nicks when prefixed with "@".  │
-│         │       audacious.pl                0.3     2009-05-03 | Display which song Audacious is currently pl│
-│         │       auth.rb                     0.3     2014-05-30 | Automatically authenticate with NickServ usi│
-│         │       auto_away.py                0.4     2018-11-11 | A simple auto-away script.                  │
-│         │       autoauth.py                 1.3     2021-11-07 | Permits to auto-authenticate when changing n│
-│         │       autobump.py                 0.1.0   2019-06-14 | Bump buffers upon activity.                 │
-│         │       autoconf.py                 0.4     2021-05-11 | Auto save/load changed options in a .weerc f│
-│         │       autoconnect.py              0.3.3   2019-10-06 | Reopen servers and channels opened last time│
+│1.weechat│322/322 Skripten (Filter: {x}) | Sortierung: i,p,n | Alt+Taste/Eingabe: i=installieren, r=entfernen,>>│
+│2.scripts│{x}      autosort.py                     3.10    2023-12-31 | Behält die Gruppierung der Buffer nach S│
+│         │{x}      highmon.pl                      2.7     2020-06-21 | Startet einen Highlight Monitor Buffer. │
+│         │{x}ia r  grep.py                   0.8.6 0.8.6   2022-11-11 | Sucht nach regulären Ausdrücken in Buffe│
+│         │{x}      colorize_nicks.py               32      2023-10-30 | Im Textbereich oder der Eingabezeile wir│
+│         │##{x}ia r  go.py                     3.0.1 3.0.1   2024-05-30 | Schneller Wechsel zu Buffern.           ##│
+│         │       aesthetic.py                    1.0.6   2020-10-25 | Macht Nachrichten Ä S T H E T I S C H an│
+│         │       aformat.py                      0.2     2018-06-21 | Alternative Textformatierung, nützlich f│
+│         │       alternatetz.py                  0.4     2022-01-25 | Fügt der Bar-Item eine zusätzliche Zeitz│
+│         │       amarok2.pl                      0.7     2012-05-08 | Fernbedienung für Amarok2 und zum anzeig│
+│         │       amqp_notify.rb                  0.1     2011-01-12 | Schickt private Nachrichten und Highligh│
+│         │       announce_url_title.py           19      2021-06-05 | Schickt einen URL Titel an einen User od│
+│         │       anotify.py                      1.0.2   2020-05-16 | Benachrichtigung von privaten Nachrichte│
+│         │       anti_password.py                1.2.1   2021-03-13 | Verhindert, dass ein Kennwort versehentl│
+│         │       apply_corrections.py            1.3     2018-06-21 | Zeigt den korrigierten Text an wenn der │
+│         │       arespond.py                     0.1.2   2022-01-25 | Anfragen werden automatisch beantwortet.│
+│         │       atcomplete.pl                   0.001   2016-10-29 | Fügt "@" Präfix bei der Nick Tab-Vervoll│
+│         │       audacious.pl                    0.3     2009-05-03 | Zeigt an welche Musik gerade von Audacio│
+│         │       auth.rb                         0.3     2014-05-30 | Automatische Authentifizierung mittels S│
+│         │       auto_away.py                    0.4     2018-11-11 | Ein einfaches Abwesenheit-Skript.       │
+│         │       autoauth.py                     1.3     2021-11-07 | Erlaubt automatische Authentisierung, we│
+│         │       autobump.py                     0.1.0   2019-06-14 | Springt zu Buffern nach deren Aktivität.│
+│         │       autoconf.py                     0.4     2021-05-11 | Automatisches speichern/laden von Option│
+│         │       autoconnect.py                  0.3.3   2019-10-06 | Öffnet erneut die Server und Channel die│
+│         │       autojoin_on_invite.py           0.9     2022-10-25 | Betritt automatisch einen Kanal wenn man│
+│         │       automarkbuffer.py               1.0     2015-03-31 | Buffer werden als gelesen markiert falls│
+│         │       automerge.py                    0.2     2018-03-03 | Automatische Zusammenführung neuer Buffe│
 │         │[12:55] [2] [script] 2:scripts                                                                      │
 │         │█                                                                                                   │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
@@ -1,6 +1,6 @@
 <!--
  Custom styles for Asciidoctor
-  Copyright (C) 2016-2024 Sébastien Helleu <flashcode@flashtux.org>
+  Copyright (C) 2016-2025 Sébastien Helleu <flashcode@flashtux.org>
 -->
 <style>

@@ -198,6 +198,10 @@ mark {

 /* syntax highlighting tuning */

+pre.pygments {
+  color: #ddd !important;
+}
+
 pre.pygments .tok-cp {
  color: #44cfaf;
 }
@@ -0,0 +1,23 @@
+// 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
@@ -35,6 +35,9 @@
 *-h*, *--help*::
    Display help.

+*-i*, *--build-info*::
+    Display build information and exit.
+
 *-l*, *--license*::
    Display WeeChat license.

@@ -98,9 +98,9 @@ $HOME/.local/share/weechat/weechat.log::

 // tag::copyright[]
 WeeChat is written by Sébastien Helleu and contributors (complete list is in
-the AUTHORS.adoc file).
+the AUTHORS.md file).

-Copyright (C) 2003-2024 {author}
+Copyright (C) 2003-2025 {author}

 WeeChat is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -0,0 +1,18 @@
+// 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[]
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

 This manual documents WeeChat chat client, it is part of WeeChat.

@@ -112,97 +113,97 @@ WeeChat "core" is located in following directories:

 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                       | Description
-| core/                           | Core functions: entry point, internal structures.
-|    wee-arraylist.c              | Array lists.
-|    wee-backtrace.c              | Display a backtrace after a crash.
-|    wee-calc.c                   | Calculate result of expressions.
-|    wee-command.c                | WeeChat core commands.
-|    wee-completion.c             | Default completions.
-|    wee-config-file.c            | Configuration file management.
-|    wee-config.c                 | Configuration options for WeeChat core (file weechat.conf).
-|    wee-crypto.c                 | Cryptographic functions.
-|    wee-debug.c                  | Some debug functions.
-|    wee-doc.c                    | Build of files for documentation.
-|    wee-dir.c                    | Directory/file functions.
-|    wee-eval.c                   | Evaluation of expressions with references to internal vars.
-|    wee-hashtable.c              | Hashtables.
-|    wee-hdata.c                  | Hdata (direct access to data using hashtables).
-|    wee-hook.c                   | Hooks.
-|    wee-infolist.c               | Infolists (lists with objects data).
-|    wee-input.c                  | Input of commands/text.
-|    wee-list.c                   | Sorted lists.
-|    wee-log.c                    | Write to WeeChat log file (weechat.log).
-|    wee-network.c                | Network functions (connection to servers/proxies).
-|    wee-proxy.c                  | Proxy management.
-|    wee-secure.c                 | Secured data functions.
-|    wee-secure-buffer.c          | Secured data buffer.
-|    wee-secure-config.c          | Secured data options (file sec.conf).
-|    wee-signal.c                 | Signal functions.
-|    wee-string.c                 | Functions on strings.
-|    wee-sys.c                    | System functions.
-|    wee-upgrade-file.c           | Internal upgrade system.
-|    wee-upgrade.c                | Upgrade for WeeChat core (buffers, lines, history, ...).
-|    wee-url.c                    | URL transfer (using libcurl).
-|    wee-utf8.c                   | UTF-8 functions.
-|    wee-util.c                   | Some other functions.
-|    wee-version.c                | Functions for WeeChat version.
-|    weechat.c                    | Main functions: command line options, startup.
-|    hook/                        | Hook functions.
-|       wee-hook-command-run.c    | Hook "command_run".
-|       wee-hook-command.c        | Hook "command".
-|       wee-hook-completion.c     | Hook "completion".
-|       wee-hook-config.c         | Hook "config".
-|       wee-hook-connect.c        | Hook "connect".
-|       wee-hook-fd.c             | Hook "fd".
-|       wee-hook-focus.c          | Hook "focus".
-|       wee-hook-hdata.c          | Hook "hdata".
-|       wee-hook-hsignal.c        | Hook "hsignal".
-|       wee-hook-info-hashtable.c | Hook "info_hashtable".
-|       wee-hook-info.c           | Hook "info".
-|       wee-hook-infolist.c       | Hook "infolist".
-|       wee-hook-line.c           | Hook "line".
-|       wee-hook-modifier.c       | Hook "modifier".
-|       wee-hook-print.c          | Hook "print".
-|       wee-hook-process.c        | Hook "process".
-|       wee-hook-signal.c         | Hook "signal".
-|       wee-hook-timer.c          | Hook "timer".
-|       wee-hook-url.c            | Hook "url".
-| gui/                            | Functions for buffers, windows, ... (used by all interfaces).
-|    gui-bar-item.c               | Bar items.
-|    gui-bar-window.c             | Bar windows.
-|    gui-bar.c                    | Bars.
-|    gui-buffer.c                 | Buffers.
-|    gui-chat.c                   | Chat functions (display message, ...).
-|    gui-color.c                  | Color functions.
-|    gui-completion.c             | Completion on command line.
-|    gui-cursor.c                 | Cursor mode (free movement of cursor).
-|    gui-filter.c                 | Filters.
-|    gui-focus.c                  | Functions about focus (for cursor mode and mouse).
-|    gui-history.c                | Commands/text saved in buffers.
-|    gui-hotlist.c                | Hotlist management (list of buffers with activity).
-|    gui-input.c                  | Input functions (input bar).
-|    gui-key.c                    | Keyboard functions.
-|    gui-layout.c                 | Layout.
-|    gui-line.c                   | Lines in buffers.
-|    gui-mouse.c                  | Mouse.
-|    gui-nick.c                   | Nick functions.
-|    gui-nicklist.c               | Nicklist in buffers.
-|    gui-window.c                 | Windows.
-|    curses/                      | Curses interface.
-|       gui-curses-bar-window.c   | Display in bar windows.
-|       gui-curses-chat.c         | Display in chat area (messages).
-|       gui-curses-color.c        | Color functions.
-|       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-mouse.c        | Mouse.
-|       gui-curses-term.c         | Functions about terminal.
-|       gui-curses-window.c       | Windows.
-|       headless/                 | Headless mode (no interface).
-|          main.c                 | Entry point for headless mode.
-|          ncurses-fake.c         | Fake ncurses library.
-|       normal/                   | Curses interface.
-|          main.c                 | Entry point for Curses interface.
+| Path/file                     | Description
+| core/                         | Core functions: entry point, internal structures.
+|    core-arraylist.c           | Array lists.
+|    core-backtrace.c           | Display a backtrace after a crash.
+|    core-calc.c                | Calculate result of expressions.
+|    core-command.c             | WeeChat core commands.
+|    core-completion.c          | Default completions.
+|    core-config-file.c         | Configuration file management.
+|    core-config.c              | Configuration options for WeeChat core (file weechat.conf).
+|    core-crypto.c              | Cryptographic functions.
+|    core-debug.c               | Some debug functions.
+|    core-doc.c                 | Build of files for documentation.
+|    core-dir.c                 | Directory/file functions.
+|    core-eval.c                | Evaluation of expressions with references to internal vars.
+|    core-hashtable.c           | Hashtables.
+|    core-hdata.c               | Hdata (direct access to data using hashtables).
+|    core-hook.c                | Hooks.
+|    core-infolist.c            | Infolists (lists with objects data).
+|    core-input.c               | Input of commands/text.
+|    core-list.c                | Sorted lists.
+|    core-log.c                 | Write to WeeChat log file (weechat.log).
+|    core-network.c             | Network functions (connection to servers/proxies).
+|    core-proxy.c               | Proxy management.
+|    core-secure.c              | Secured data functions.
+|    core-secure-buffer.c       | Secured data buffer.
+|    core-secure-config.c       | Secured data options (file sec.conf).
+|    core-signal.c              | Signal functions.
+|    core-string.c              | Functions on strings.
+|    core-sys.c                 | System functions.
+|    core-upgrade-file.c        | Internal upgrade system.
+|    core-upgrade.c             | Upgrade for WeeChat core (buffers, lines, history, ...).
+|    core-url.c                 | URL transfer (using libcurl).
+|    core-utf8.c                | UTF-8 functions.
+|    core-util.c                | Some other functions.
+|    core-version.c             | Functions for WeeChat version.
+|    weechat.c                  | Main functions: command line options, startup.
+|    hook/                      | Hook functions.
+|       hook-command-run.c      | Hook "command_run".
+|       hook-command.c          | Hook "command".
+|       hook-completion.c       | Hook "completion".
+|       hook-config.c           | Hook "config".
+|       hook-connect.c          | Hook "connect".
+|       hook-fd.c               | Hook "fd".
+|       hook-focus.c            | Hook "focus".
+|       hook-hdata.c            | Hook "hdata".
+|       hook-hsignal.c          | Hook "hsignal".
+|       hook-info-hashtable.c   | Hook "info_hashtable".
+|       hook-info.c             | Hook "info".
+|       hook-infolist.c         | Hook "infolist".
+|       hook-line.c             | Hook "line".
+|       hook-modifier.c         | Hook "modifier".
+|       hook-print.c            | Hook "print".
+|       hook-process.c          | Hook "process".
+|       hook-signal.c           | Hook "signal".
+|       hook-timer.c            | Hook "timer".
+|       hook-url.c              | Hook "url".
+| gui/                          | Functions for buffers, windows, ... (used by all interfaces).
+|    gui-bar-item.c             | Bar items.
+|    gui-bar-window.c           | Bar windows.
+|    gui-bar.c                  | Bars.
+|    gui-buffer.c               | Buffers.
+|    gui-chat.c                 | Chat functions (display message, ...).
+|    gui-color.c                | Color functions.
+|    gui-completion.c           | Completion on command line.
+|    gui-cursor.c               | Cursor mode (free movement of cursor).
+|    gui-filter.c               | Filters.
+|    gui-focus.c                | Functions about focus (for cursor mode and mouse).
+|    gui-history.c              | Commands/text saved in buffers.
+|    gui-hotlist.c              | Hotlist management (list of buffers with activity).
+|    gui-input.c                | Input functions (input bar).
+|    gui-key.c                  | Keyboard functions.
+|    gui-layout.c               | Layout.
+|    gui-line.c                 | Lines in buffers.
+|    gui-mouse.c                | Mouse.
+|    gui-nick.c                 | Nick functions.
+|    gui-nicklist.c             | Nicklist in buffers.
+|    gui-window.c               | Windows.
+|    curses/                    | Curses interface.
+|       gui-curses-bar-window.c | Display in bar windows.
+|       gui-curses-chat.c       | Display in chat area (messages).
+|       gui-curses-color.c      | Color functions.
+|       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-mouse.c      | Mouse.
+|       gui-curses-term.c       | Functions about terminal.
+|       gui-curses-window.c     | Windows.
+|       headless/               | Headless mode (no interface).
+|          main.c               | Entry point for headless mode.
+|          ncurses-fake.c       | Fake ncurses library.
+|       normal/                 | Curses interface.
+|          main.c               | Entry point for Curses interface.
 |===

 [[sources_plugins]]
@@ -210,180 +211,190 @@ WeeChat "core" is located in following directories:

 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                         | Description
-| plugins/                          | Root of plugins.
-|    plugin.c                       | Plugins management (load/unload dynamic C libraries).
-|    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-config.c                | Plugin configuration options (file plugins.conf).
-|    plugin-script.c                | Common functions used by script plugins.
-|    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, ...).
-|    weechat-plugin.h               | Header designed to be distributed with WeeChat plugins, in order to compile them.
-|    alias/                         | Alias plugin.
-|       alias.c                     | Main alias functions.
-|       alias-command.c             | Alias commands.
-|       alias-completion.c          | Alias completions.
-|       alias-config.c              | Alias config options (file alias.conf).
-|       alias-info.c                | Alias info/infolists/hdata.
-|    spell/                         | Spell checker plugin.
-|       spell.c                     | Main spell checker functions.
-|       spell-bar-item.c            | Spell checker bar items.
-|       spell-command.c             | Spell checker commands.
-|       spell-completion.c          | Spell checker completions.
-|       spell-config.c              | Spell checker config options (file spell.conf).
-|       spell-info.c                | Spell checker info/infolists/hdata.
-|       spell-speller.c             | Spellers management.
-|    buflist/                       | Buflist plugin.
-|       buflist.c                   | Main buflist functions.
-|       buflist-bar-item.c          | Buflist bar items.
-|       buflist-command.c           | Buflist commands.
-|       buflist-completion.c        | Buflist completions.
-|       buflist-config.c            | Buflist config options (file buflist.conf).
-|       buflist-info.c              | Buflist info/infolists/hdata.
-|       buflist-mouse.c             | Buflist mouse actions.
-|    charset/                       | Charset plugin.
-|       charset.c                   | Charset functions.
-|    exec/                          | Exec plugin.
-|       exec.c                      | Main exec functions.
-|       exec-buffer.c               | Exec buffer.
-|       exec-command.c              | Exec commands.
-|       exec-completion.c           | Exec completions.
-|       exec-config.c               | Exec config options (file exec.conf).
-|    fifo/                          | Fifo plugin.
-|       fifo.c                      | Main fifo functions.
-|       fifo-command.c              | Fifo commands.
-|       fifo-config.c               | Fifo config options (file fifo.conf).
-|       fifo-info.c                 | Fifo info/infolists/hdata.
-|    fset/                          | Fset plugin.
-|       fset.c                      | Main fset functions.
-|       fset-bar-item.c             | Fset bar items.
-|       fset-buffer.c               | Fset buffer.
-|       fset-command.c              | Fset commands.
-|       fset-completion.c           | Fset completions.
-|       fset-config.c               | Fset config options (file fset.conf).
-|       fset-info.c                 | Fset info/infolists/hdata.
-|       fset-mouse.c                | Fset mouse actions.
-|       fset-option.c               | Fset options management.
-|    guile/                         | Guile (scheme) plugin.
-|       weechat-guile.c             | Main guile functions (load/unload scripts, execute guile code).
-|       weechat-guile-api.c         | Guile scripting API functions.
-|    irc/                           | IRC (Internet Relay Chat) plugin.
-|       irc.c                       | Main IRC functions.
-|       irc-bar-item.c              | IRC bar items.
-|       irc-batch.c                 | IRC batched events.
-|       irc-buffer.c                | IRC buffers.
-|       irc-channel.c               | IRC channels.
-|       irc-color.c                 | IRC colors.
-|       irc-command.c               | IRC commands.
-|       irc-completion.c            | IRC completions.
-|       irc-config.c                | IRC config options (file irc.conf).
-|       irc-ctcp.c                  | IRC CTCP.
-|       irc-debug.c                 | IRC debug functions.
-|       irc-ignore.c                | IRC Ignore.
-|       irc-info.c                  | IRC info/infolists/hdata.
-|       irc-input.c                 | Input of commands/text.
-|       irc-join.c                  | Functions for list of channels to join.
-|       irc-list.c                  | Buffer for reply to /list command.
-|       irc-message.c               | Functions to manipulate IRC messages.
-|       irc-mode.c                  | Functions about channel/nick modes.
-|       irc-modelist.c              | IRC channel mode lists (+b, +e, +I, ...).
-|       irc-msgbuffer.c             | Target buffer for IRC messages.
-|       irc-nick.c                  | IRC nicks.
-|       irc-notify.c                | IRC notify lists.
-|       irc-protocol.c              | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194).
-|       irc-raw.c                   | IRC raw buffer.
-|       irc-redirect.c              | Redirection of IRC command output.
-|       irc-sasl.c                  | SASL authentication with IRC server.
-|       irc-server.c                | I/O communication with IRC server.
-|       irc-tag.c                   | Functions to manipulate IRC message tags.
-|       irc-typing.c                | Typing status.
-|       irc-upgrade.c               | Save/restore of IRC data when upgrading WeeChat.
-|    javascript/                    | JavaScript plugin.
-|       weechat-js.cpp              | Main JavaScript functions (load/unload scripts, execute JavaScript code).
-|       weechat-js-api.cpp          | JavaScript scripting API functions.
-|       weechat-js-v8.cpp           | JavaScript v8 functions.
-|    logger/                        | Logger plugin.
-|       logger.c                    | Main logger functions.
-|       logger-backlog.c            | Logger backlog functions.
-|       logger-buffer.c             | Logger buffer list management.
-|       logger-command.c            | Logger commands.
-|       logger-config.c             | Logger config options (file logger.conf).
-|       logger-info.c               | Logger info/infolists/hdata.
-|       logger-tail.c               | Functions to get last lines of a file.
-|    lua/                           | Lua plugin.
-|       weechat-lua.c               | Main lua functions (load/unload scripts, execute lua code).
-|       weechat-lua-api.c           | Lua scripting API functions.
-|    perl/                          | Perl plugin.
-|       weechat-perl.c              | Main perl functions (load/unload scripts, execute perl code).
-|       weechat-perl-api.c          | Perl scripting API functions.
-|    php/                           | PHP plugin.
-|       weechat-php.c               | Main PHP functions (load/unload scripts, execute PHP code).
-|       weechat-php-api.c           | PHP scripting API functions.
-|    python/                        | Python plugin.
-|       weechat-python.c            | Main python functions (load/unload scripts, execute python code).
-|       weechat-python-api.c        | Python scripting API functions.
-|    relay/                         | Relay plugin (IRC proxy and relay for remote interfaces).
-|       relay.c                     | Main relay functions.
-|       relay-auth.c                | Clients authentication.
-|       relay-buffer.c              | Relay buffer.
-|       relay-client.c              | Clients of relay.
-|       relay-command.c             | Relay commands.
-|       relay-completion.c          | Relay completions.
-|       relay-config.c              | Relay config options (file relay.conf).
-|       relay-info.c                | Relay info/infolists/hdata.
-|       relay-network.c             | Network functions for relay.
-|       relay-raw.c                 | Relay raw buffer.
-|       relay-server.c              | Relay server.
-|       relay-upgrade.c             | Save/restore of relay data when upgrading WeeChat.
-|       relay-websocket.c           | WebSocket server functions (RFC 6455).
-|       irc/                        | IRC proxy.
-|          relay-irc.c              | Main IRC proxy functions.
-|       weechat/                    | Relay for remote interfaces.
-|          relay-weechat.c          | Relay for remote interfaces (main functions).
-|          relay-weechat-msg.c      | Send binary messages to clients.
-|          relay-weechat-nicklist.c | Nicklist functions.
-|          relay-weechat-protocol.c | Read commands from clients.
-|    ruby/                          | Ruby plugin.
-|       weechat-ruby.c              | Main ruby functions (load/unload scripts, execute ruby code).
-|       weechat-ruby-api.c          | Ruby scripting API functions.
-|    script/                        | Script manager.
-|       script.c                    | Main functions for script manager.
-|       script-action.c             | Actions on scripts (load/unload, install/remove, ...).
-|       script-buffer.c             | Buffer for script manager.
-|       script-command.c            | Commands for script manager.
-|       script-completion.c         | Completions for script manager.
-|       script-config.c             | Config options for script manager (file script.conf).
-|       script-info.c               | Script manager info/infolists/hdata.
-|       script-mouse.c              | Script mouse actions.
-|       script-repo.c               | Download and read repository file.
-|    tcl/                           | Tcl plugin.
-|       weechat-tcl.c               | Main tcl functions (load/unload scripts, execute tcl code).
-|       weechat-tcl-api.c           | Tcl scripting API functions.
-|    trigger/                       | Trigger plugin.
-|       trigger.c                   | Main trigger functions.
-|       trigger-buffer.c            | Trigger buffer.
-|       trigger-callback.c          | Trigger callbacks.
-|       trigger-command.c           | Trigger commands.
-|       trigger-completion.c        | Trigger completions.
-|       trigger-config.c            | Trigger config options (file trigger.conf).
-|    typing/                        | Typing plugin.
-|       typing.c                    | Main typing functions.
-|       typing-bar-item.c           | Typing bar items.
-|       typing-config.c             | Typing config options (file typing.conf).
-|       typing-status.c             | Messages typing status on buffers.
-|    xfer/                          | Xfer plugin (IRC DCC file/chat).
-|       xfer.c                      | Main xfer functions.
-|       xfer-buffer.c               | Xfer buffer.
-|       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.
+| Path/file                          | Description
+| plugins/                           | Root of plugins.
+|    plugin.c                        | Plugins management (load/unload dynamic C libraries).
+|    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-config.c                 | Plugin configuration options (file plugins.conf).
+|    plugin-script.c                 | Common functions used by script plugins.
+|    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, ...).
+|    weechat-plugin.h                | Header designed to be distributed with WeeChat plugins, in order to compile them.
+|    alias/                          | Alias plugin.
+|       alias.c                      | Main alias functions.
+|       alias-command.c              | Alias commands.
+|       alias-completion.c           | Alias completions.
+|       alias-config.c               | Alias config options (file alias.conf).
+|       alias-info.c                 | Alias info/infolists/hdata.
+|    spell/                          | Spell checker plugin.
+|       spell.c                      | Main spell checker functions.
+|       spell-bar-item.c             | Spell checker bar items.
+|       spell-command.c              | Spell checker commands.
+|       spell-completion.c           | Spell checker completions.
+|       spell-config.c               | Spell checker config options (file spell.conf).
+|       spell-info.c                 | Spell checker info/infolists/hdata.
+|       spell-speller.c              | Spellers management.
+|    buflist/                        | Buflist plugin.
+|       buflist.c                    | Main buflist functions.
+|       buflist-bar-item.c           | Buflist bar items.
+|       buflist-command.c            | Buflist commands.
+|       buflist-completion.c         | Buflist completions.
+|       buflist-config.c             | Buflist config options (file buflist.conf).
+|       buflist-info.c               | Buflist info/infolists/hdata.
+|       buflist-mouse.c              | Buflist mouse actions.
+|    charset/                        | Charset plugin.
+|       charset.c                    | Charset functions.
+|    exec/                           | Exec plugin.
+|       exec.c                       | Main exec functions.
+|       exec-buffer.c                | Exec buffer.
+|       exec-command.c               | Exec commands.
+|       exec-completion.c            | Exec completions.
+|       exec-config.c                | Exec config options (file exec.conf).
+|    fifo/                           | Fifo plugin.
+|       fifo.c                       | Main fifo functions.
+|       fifo-command.c               | Fifo commands.
+|       fifo-config.c                | Fifo config options (file fifo.conf).
+|       fifo-info.c                  | Fifo info/infolists/hdata.
+|    fset/                           | Fset plugin.
+|       fset.c                       | Main fset functions.
+|       fset-bar-item.c              | Fset bar items.
+|       fset-buffer.c                | Fset buffer.
+|       fset-command.c               | Fset commands.
+|       fset-completion.c            | Fset completions.
+|       fset-config.c                | Fset config options (file fset.conf).
+|       fset-info.c                  | Fset info/infolists/hdata.
+|       fset-mouse.c                 | Fset mouse actions.
+|       fset-option.c                | Fset options management.
+|    guile/                          | Guile (scheme) plugin.
+|       weechat-guile.c              | Main guile functions (load/unload scripts, execute guile code).
+|       weechat-guile-api.c          | Guile scripting API functions.
+|    irc/                            | IRC (Internet Relay Chat) plugin.
+|       irc.c                        | Main IRC functions.
+|       irc-bar-item.c               | IRC bar items.
+|       irc-batch.c                  | IRC batched events.
+|       irc-buffer.c                 | IRC buffers.
+|       irc-channel.c                | IRC channels.
+|       irc-color.c                  | IRC colors.
+|       irc-command.c                | IRC commands.
+|       irc-completion.c             | IRC completions.
+|       irc-config.c                 | IRC config options (file irc.conf).
+|       irc-ctcp.c                   | IRC CTCP.
+|       irc-debug.c                  | IRC debug functions.
+|       irc-ignore.c                 | IRC Ignore.
+|       irc-info.c                   | IRC info/infolists/hdata.
+|       irc-input.c                  | Input of commands/text.
+|       irc-join.c                   | Functions for list of channels to join.
+|       irc-list.c                   | Buffer for reply to /list command.
+|       irc-message.c                | Functions to manipulate IRC messages.
+|       irc-mode.c                   | Functions about channel/nick modes.
+|       irc-modelist.c               | IRC channel mode lists (+b, +e, +I, ...).
+|       irc-msgbuffer.c              | Target buffer for IRC messages.
+|       irc-nick.c                   | IRC nicks.
+|       irc-notify.c                 | IRC notify lists.
+|       irc-protocol.c               | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194).
+|       irc-raw.c                    | IRC raw buffer.
+|       irc-redirect.c               | Redirection of IRC command output.
+|       irc-sasl.c                   | SASL authentication with IRC server.
+|       irc-server.c                 | I/O communication with IRC server.
+|       irc-tag.c                    | Functions to manipulate IRC message tags.
+|       irc-typing.c                 | Typing status.
+|       irc-upgrade.c                | Save/restore of IRC data when upgrading WeeChat.
+|    javascript/                     | JavaScript plugin.
+|       weechat-js.cpp               | Main JavaScript functions (load/unload scripts, execute JavaScript code).
+|       weechat-js-api.cpp           | JavaScript scripting API functions.
+|       weechat-js-v8.cpp            | JavaScript v8 functions.
+|    logger/                         | Logger plugin.
+|       logger.c                     | Main logger functions.
+|       logger-backlog.c             | Logger backlog functions.
+|       logger-buffer.c              | Logger buffer list management.
+|       logger-command.c             | Logger commands.
+|       logger-config.c              | Logger config options (file logger.conf).
+|       logger-info.c                | Logger info/infolists/hdata.
+|       logger-tail.c                | Functions to get last lines of a file.
+|    lua/                            | Lua plugin.
+|       weechat-lua.c                | Main lua functions (load/unload scripts, execute lua code).
+|       weechat-lua-api.c            | Lua scripting API functions.
+|    perl/                           | Perl plugin.
+|       weechat-perl.c               | Main perl functions (load/unload scripts, execute perl code).
+|       weechat-perl-api.c           | Perl scripting API functions.
+|    php/                            | PHP plugin.
+|       weechat-php.c                | Main PHP functions (load/unload scripts, execute PHP code).
+|       weechat-php-api.c            | PHP scripting API functions.
+|    python/                         | Python plugin.
+|       weechat-python.c             | Main python functions (load/unload scripts, execute python code).
+|       weechat-python-api.c         | Python scripting API functions.
+|    relay/                          | Relay plugin (IRC proxy and relay for remote interfaces).
+|       relay.c                      | Main relay functions.
+|       relay-auth.c                 | Clients authentication.
+|       relay-bar-item.c             | Relay bar items.
+|       relay-buffer.c               | Relay buffer.
+|       relay-client.c               | Clients of relay.
+|       relay-command.c              | Relay commands.
+|       relay-completion.c           | Relay completions.
+|       relay-config.c               | Relay config options (file relay.conf).
+|       relay-http.c                 | HTTP functions.
+|       relay-info.c                 | Relay info/infolists/hdata.
+|       relay-network.c              | Network functions for relay.
+|       relay-raw.c                  | Relay raw buffer.
+|       relay-remote.c               | Relay remote.
+|       relay-server.c               | Relay server.
+|       relay-upgrade.c              | Save/restore of relay data when upgrading WeeChat.
+|       relay-websocket.c            | WebSocket server functions (RFC 6455).
+|       api/                         | Relay for remote interfaces (using HTTP REST API).
+|          relay-api.c               | Main API functions for HTTP REST API.
+|          relay-api-msg.c           | Send JSON messages to clients.
+|          relay-api-protocol.c      | HTTP REST API protocol.
+|          remote/                   | Relay remote functions, specific to API.
+|             relay-remote-event.c   | Process events received from relay remote.
+|             relay-remote-network.c | Network functions for relay remote.
+|       irc/                         | IRC proxy.
+|          relay-irc.c               | Main IRC proxy functions.
+|       weechat/                     | Relay for remote interfaces (using "weechat" binary protocol).
+|          relay-weechat.c           | Relay for remote interfaces (main functions).
+|          relay-weechat-msg.c       | Send binary messages to clients.
+|          relay-weechat-nicklist.c  | Nicklist functions.
+|          relay-weechat-protocol.c  | Read commands from clients.
+|    ruby/                           | Ruby plugin.
+|       weechat-ruby.c               | Main ruby functions (load/unload scripts, execute ruby code).
+|       weechat-ruby-api.c           | Ruby scripting API functions.
+|    script/                         | Script manager.
+|       script.c                     | Main functions for script manager.
+|       script-action.c              | Actions on scripts (load/unload, install/remove, ...).
+|       script-buffer.c              | Buffer for script manager.
+|       script-command.c             | Commands for script manager.
+|       script-completion.c          | Completions for script manager.
+|       script-config.c              | Config options for script manager (file script.conf).
+|       script-info.c                | Script manager info/infolists/hdata.
+|       script-mouse.c               | Script mouse actions.
+|       script-repo.c                | Download and read repository file.
+|    tcl/                            | Tcl plugin.
+|       weechat-tcl.c                | Main tcl functions (load/unload scripts, execute tcl code).
+|       weechat-tcl-api.c            | Tcl scripting API functions.
+|    trigger/                        | Trigger plugin.
+|       trigger.c                    | Main trigger functions.
+|       trigger-buffer.c             | Trigger buffer.
+|       trigger-callback.c           | Trigger callbacks.
+|       trigger-command.c            | Trigger commands.
+|       trigger-completion.c         | Trigger completions.
+|       trigger-config.c             | Trigger config options (file trigger.conf).
+|    typing/                         | Typing plugin.
+|       typing.c                     | Main typing functions.
+|       typing-bar-item.c            | Typing bar items.
+|       typing-config.c              | Typing config options (file typing.conf).
+|       typing-status.c              | Messages typing status on buffers.
+|    xfer/                           | Xfer plugin (IRC DCC file/chat).
+|       xfer.c                       | Main xfer functions.
+|       xfer-buffer.c                | Xfer buffer.
+|       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]]
@@ -391,89 +402,121 @@ WeeChat "core" is located in following directories:

 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                           | Description
-| tests/                              | Root of tests.
-|    tests.cpp                        | Program used to run all tests.
-|    tests-record.cpp                 | Record and search in messages displayed.
-|    scripts/                         | Root of 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.
-|          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.
-|          unparse.py                 | Convert Python code to other languages, used by script testapigen.py.
-|    unit/                            | Root of unit tests.
-|       test-plugins.cpp              | Tests: plugins.
-|       test-plugin-api-info.cpp      | Tests: plugin API info functions.
-|       test-plugin-config.cpp        | Tests: plugin config functions.
-|       core/                         | Root of unit tests for core.
-|          test-core-arraylist.cpp    | Tests: arraylists.
-|          test-core-calc.cpp         | Tests: calculation of expressions.
-|          test-core-command.cpp      | Tests: commands.
-|          test-core-config-file.cpp  | Tests: configuration files.
-|          test-core-crypto.cpp       | Tests: cryptographic functions.
-|          test-core-dir.cpp          | Tests: directory/file functions.
-|          test-core-eval.cpp         | Tests: evaluation of expressions.
-|          test-core-hashtble.cpp     | Tests: hashtables.
-|          test-core-hdata.cpp        | Tests: hdata.
-|          test-core-hook.cpp         | Tests: hooks.
-|          test-core-infolist.cpp     | Tests: infolists.
-|          test-core-list.cpp         | Tests: lists.
-|          test-core-network.cpp      | Tests: network functions.
-|          test-core-secure.cpp       | Tests: secured data.
-|          test-core-signal.cpp       | Tests: signals.
-|          test-core-string.cpp       | Tests: strings.
-|          test-core-url.cpp          | Tests: URLs.
-|          test-core-utf8.cpp         | Tests: UTF-8.
-|          test-core-util.cpp         | Tests: utility functions.
-|          test-core-sys.cpp          | Tests: system functions.
-|          hook/                      | Root of unit tests for hooks.
-|             test-hook-command.cpp   | Tests: hooks "command".
-|       gui/                          | Root of unit tests for interfaces.
-|          test-gui-bar-window.cpp    | Tests: bar window functions.
-|          test-gui-buffer.cpp        | Tests: buffer functions.
-|          test-gui-chat.cpp          | Tests: chat functions.
-|          test-gui-color.cpp         | Tests: colors.
-|          test-gui-filter.cpp        | Tests: filters.
-|          test-gui-input.cpp         | Tests: input functions.
-|          test-gui-key.cpp           | Tests: keys.
-|          test-gui-line.cpp          | Tests: lines.
-|          test-gui-nick.cpp          | Tests: nicks.
-|       plugins/                      | Root of unit tests for plugins.
-|          irc/                       | Root of unit tests for IRC plugin.
-|             test-irc-batch.cpp      | Tests: IRC batched events.
-|             test-irc-buffer.cpp     | Tests: IRC buffers.
-|             test-irc-channel.cpp    | Tests: IRC channels.
-|             test-irc-color.cpp      | Tests: IRC colors.
-|             test-irc-config.cpp     | Tests: IRC configuration.
-|             test-irc-ctcp.cpp       | Tests: IRC CTCP.
-|             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.
-|             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.
+| Path/file                                  | Description
+| tests/                                     | Root of tests.
+|    tests.cpp                               | Program used to run all tests.
+|    tests-record.cpp                        | Record and search in messages displayed.
+|    scripts/                                | Root of 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.
+|          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.
+|          unparse.py                        | Convert Python code to other languages, used by script testapigen.py.
+|    unit/                                   | Root of unit tests.
+|       test-plugins.cpp                     | Tests: plugins.
+|       test-plugin-api-info.cpp             | Tests: plugin API info functions.
+|       test-plugin-config.cpp               | Tests: plugin config functions.
+|       core/                                | Root of unit tests for core.
+|          test-core-arraylist.cpp           | Tests: arraylists.
+|          test-core-calc.cpp                | Tests: calculation of expressions.
+|          test-core-command.cpp             | Tests: commands.
+|          test-core-config-file.cpp         | Tests: configuration files.
+|          test-core-crypto.cpp              | Tests: cryptographic functions.
+|          test-core-dir.cpp                 | Tests: directory/file functions.
+|          test-core-eval.cpp                | Tests: evaluation of expressions.
+|          test-core-hashtable.cpp           | Tests: hashtables.
+|          test-core-hdata.cpp               | Tests: hdata.
+|          test-core-hook.cpp                | Tests: hooks.
+|          test-core-infolist.cpp            | Tests: infolists.
+|          test-core-input.cpp               | Tests: input functions.
+|          test-core-list.cpp                | Tests: lists.
+|          test-core-network.cpp             | Tests: network functions.
+|          test-core-secure.cpp              | Tests: secured data.
+|          test-core-signal.cpp              | Tests: signals.
+|          test-core-string.cpp              | Tests: strings.
+|          test-core-url.cpp                 | Tests: URLs.
+|          test-core-utf8.cpp                | Tests: UTF-8.
+|          test-core-util.cpp                | Tests: utility functions.
+|          test-core-sys.cpp                 | Tests: system functions.
+|          hook/                             | Root of unit tests for hooks.
+|             test-hook-command.cpp          | Tests: hooks "command".
+|             test-hook-command-run.cpp      | Tests: hooks "command_run".
+|             test-hook-completion.cpp       | Tests: hooks "completion".
+|             test-hook-config.cpp           | Tests: hooks "config".
+|             test-hook-connect.cpp          | Tests: hooks "connect".
+|             test-hook-fd.cpp               | Tests: hooks "fd".
+|             test-hook-focus.cpp            | Tests: hooks "focus".
+|             test-hook-hdata.cpp            | Tests: hooks "hdata".
+|             test-hook-hsignal.cpp          | Tests: hooks "hsignal".
+|             test-hook-info-hashtable.cpp   | Tests: hooks "info_hashtable".
+|             test-hook-info.cpp             | Tests: hooks "info".
+|             test-hook-infolist.cpp         | Tests: hooks "infolist".
+|             test-hook-line.cpp             | Tests: hooks "line".
+|             test-hook-modifier.cpp         | Tests: hooks "modifier".
+|             test-hook-print.cpp            | Tests: hooks "print".
+|             test-hook-process.cpp          | Tests: hooks "process".
+|             test-hook-signal.cpp           | Tests: hooks "signal".
+|             test-hook-timer.cpp            | Tests: hooks "timer".
+|             test-hook-url.cpp              | Tests: hooks "url".
+|       gui/                                 | Root of unit tests for interfaces.
+|          test-gui-bar-window.cpp           | Tests: bar window functions.
+|          test-gui-buffer.cpp               | Tests: buffer functions.
+|          test-gui-chat.cpp                 | Tests: chat functions.
+|          test-gui-color.cpp                | Tests: colors.
+|          test-gui-filter.cpp               | Tests: filters.
+|          test-gui-hotlist.cpp              | Tests: hotlist functions.
+|          test-gui-input.cpp                | Tests: input functions.
+|          test-gui-key.cpp                  | Tests: keys.
+|          test-gui-line.cpp                 | Tests: lines.
+|          test-gui-nick.cpp                 | Tests: nicks.
+|          test-gui-nicklist.cpp             | Tests: nicklist functions.
+|          curses/                           | Root of unit tests for Curses interface.
+|             test-gui-curses-mouse.cpp      | Tests: mouse (Curses interface).
+|       plugins/                             | Root of unit tests for plugins.
+|          irc/                              | Root of unit tests for IRC plugin.
+|             test-irc-batch.cpp             | Tests: IRC batched events.
+|             test-irc-buffer.cpp            | Tests: IRC buffers.
+|             test-irc-channel.cpp           | Tests: IRC channels.
+|             test-irc-color.cpp             | Tests: IRC colors.
+|             test-irc-command.cpp           | Tests: IRC commands.
+|             test-irc-config.cpp            | Tests: IRC configuration.
+|             test-irc-ctcp.cpp              | Tests: IRC CTCP.
+|             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]]
@@ -492,7 +535,8 @@ Documentation files:
 |       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_quickstart.XX.adoc              | link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
-|       weechat_relay_protocol.XX.adoc          | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces).
+|       weechat_relay_api.XX.adoc               | link:weechat_relay_api.en.html[Relay "api" 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_user.XX.adoc                    | link:weechat_user.en.html[User's guide ^↗^^].
 |       includes/                               | Files included in documentation.
@@ -533,7 +577,7 @@ Example in C:
 /*
 * weechat.c - core functions for WeeChat
 *
- * Copyright (C) 2024 Your Name <your@email.com>
+ * Copyright (C) 2025 Your Name <your@email.com>
 *
 * This file is part of WeeChat, the extensible chat client.
 *
@@ -557,9 +601,8 @@ Example in C:

 Some basic rules you *must* follow when you write C code:

-* 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.
+* Use 4 spaces for indentation (no tabs).
+* 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+`).
 * Add a comment before any function, to explain what it does (always use a
  multi-line comment, even if description is very short).
@@ -771,7 +814,7 @@ Examples:
 [width="100%",cols="2m,3",options="header"]
 |===
 | Directory           | Files
-| src/core/           | weechat.c, wee-backtrace.c, wee-command.c, ...
+| src/core/           | weechat.c, core-backtrace.c, core-command.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/plugins/        | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ...
@@ -779,8 +822,8 @@ Examples:
 | src/plugins/python/ | weechat-python.c, weechat-python-api.c, ...
 |===

-The headers of C files have same name as file, for example _wee-command.h_ for
-file _wee-command.c_.
+The headers of C files have same name as file, for example _core-command.h_ for
+file _core-command.c_.

 [[naming_convention_structures]]
 ==== Structures
@@ -1007,16 +1050,16 @@ _src/gui/gui-color.h_):
 | 14   | weechat.color.chat_nick
 | 15   | weechat.color.chat_nick_self
 | 16   | weechat.color.chat_nick_other
-| 17   | _(not used any more since WeeChat 0.3.4)_
-| 18   | _(not used any more since WeeChat 0.3.4)_
-| 19   | _(not used any more since WeeChat 0.3.4)_
-| 20   | _(not used any more since WeeChat 0.3.4)_
-| 21   | _(not used any more since WeeChat 0.3.4)_
-| 22   | _(not used any more since WeeChat 0.3.4)_
-| 23   | _(not used any more since WeeChat 0.3.4)_
-| 24   | _(not used any more since WeeChat 0.3.4)_
-| 25   | _(not used any more since WeeChat 0.3.4)_
-| 26   | _(not used any more since WeeChat 0.3.4)_
+| 17   | _(not used anymore since WeeChat 0.3.4)_
+| 18   | _(not used anymore since WeeChat 0.3.4)_
+| 19   | _(not used anymore since WeeChat 0.3.4)_
+| 20   | _(not used anymore since WeeChat 0.3.4)_
+| 21   | _(not used anymore since WeeChat 0.3.4)_
+| 22   | _(not used anymore since WeeChat 0.3.4)_
+| 23   | _(not used anymore since WeeChat 0.3.4)_
+| 24   | _(not used anymore since WeeChat 0.3.4)_
+| 25   | _(not used anymore since WeeChat 0.3.4)_
+| 26   | _(not used anymore since WeeChat 0.3.4)_
 | 27   | weechat.color.chat_host
 | 28   | weechat.color.chat_delimiters
 | 29   | weechat.color.chat_highlight
@@ -1132,7 +1175,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,

 Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].

-Any patch for bug or new feature must be done on master branch, preferred way
+Any patch for bug or new feature must be done on branch `main`, preferred way
 is a GitHub pull request. A patch can also be sent by e-mail
 (made with `git diff` or `git format-patch`).

@@ -1149,15 +1192,15 @@ Where _component_ is one of following:
 | Component | Files | Description

 | core
-| AUTHORS.adoc +
-  ChangeLog.adoc +
-  Contributing.adoc +
+| AUTHORS.md +
+  CHANGELOG.md +
+  CONTRIBUTING.md +
  .github/FUNDING.yml +
  .github/ISSUE_TEMPLATE/* +
  icons/* +
  po/* +
-  README.adoc +
-  ReleaseNotes.adoc +
+  README.md +
+  UPGRADING.md +
  src/core/* +
  src/gui/* +
  version.sh +
@@ -1214,8 +1257,9 @@ Where _component_ is one of following:
 | Plugin API reference

 | doc/relay
-| doc/xx/weechat_relay_protocol.xx.adoc
-| Relay protocol
+| doc/xx/weechat_relay_api.xx.adoc +
+  doc/xx/weechat_relay_weechat.xx.adoc
+| Relay protocols

 | doc/dev
 | doc/xx/weechat_dev.en.adoc
@@ -1259,9 +1303,10 @@ Gettext files are in directory _po/_.
 If you want to initialize a new language, use command `msginit`. For example to
 create a file which is ready to translate to Dutch:

+[source,shell]
 ----
-$ cd po
-$ msginit -i weechat.pot -l nl_NL -o nl.po
+cd po
+msginit -i weechat.pot -l nl_NL -o nl.po
 ----

 Base language for WeeChat is English, so you must of course perfectly understand
@@ -1270,8 +1315,9 @@ English in order to translate to your language.
 After changes in sources, you can regenerate all translations files: run this
 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).
@@ -1279,8 +1325,9 @@ Then you can edit .po files (if you can translate in a language).
 When done, you *have* to check your file with
 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.
@@ -1317,5 +1364,5 @@ warnings, ... These words must be kept unchanged:
 When there is a name after `+<<link_name>>+`, then you must translate it:

 ----
-<<link_name,this text must be translated>>
+<<link_name,this text should be translated>>
 ----
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

 [[general]]
 == General
@@ -48,12 +49,14 @@ If you still have issues, please report them to the developers.
 It is recommended to use https://brew.sh/[Homebrew ^↗^^],
 you can get help with:

+[source,shell]
 ----
 brew info weechat
 ----

 You can install WeeChat with this command:

+[source,shell]
 ----
 brew install weechat
 ----
@@ -266,7 +269,7 @@ for more info about the hotlist.
 [[input_bar_size]]
 === How to use command line with more than one line?

-The option _size_ in input bar can be set to a value higher than 1 (for fixed
+The option _size_ in input bar can be set to a value greater than 1 (for fixed
 size, default size is 1) or 0 for dynamic size, and then option _size_max_ will
 set the max size (0 = no limit).

@@ -313,10 +316,14 @@ You can use a terminal with rectangular selection (like rxvt-unicode,
 konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse
 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:

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 [[urls]]
@@ -326,10 +333,13 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).

 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:

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 * disable alignment for multiline words:
@@ -379,6 +389,7 @@ 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:

+[source,shell]
 ----
 export TZ=America/New_York
 ----
@@ -682,16 +693,18 @@ According to terminfo used, mouse may not be supported.

 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 " !!#!!".

 To disable mouse in terminal:

+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----

 [[mouse_coords]]
@@ -746,7 +759,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:

 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----

 [[irc_tls_libera]]
@@ -993,14 +1006,15 @@ for help).
 Scripts are not compatible with other IRC clients.

 [[scripts_update]]
-=== The command "/script update" can not read scripts, how to fix that?
+=== The command "/script update" cannot read scripts, how to fix that?

 First check questions about TLS connection in this FAQ.

 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]
@@ -1024,15 +1038,17 @@ have to update manually the file yourself to get updates):

 * in your shell, with curl installed:

+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+cd ~/.cache/weechat/script
+curl -O https://weechat.org/files/plugins.xml.gz
 ----

 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,
 before starting WeeChat:

+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1202,6 +1218,7 @@ See https://weechat.org/about/support/[this page ^↗^^].

 When you run WeeChat under gdb, you may have this error:

+[source,shell]
 ----
 $ gdb /path/to/weechat
 (gdb) run
@@ -1212,6 +1229,7 @@ Cannot find new threads: generic error
 To fix that, you can run gdb with this command (replace path to libpthread and
 WeeChat with paths on your system):

+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
 (gdb) run
@@ -1220,7 +1238,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
 [[supported_os]]
 === What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?

-WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
+WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, macOS and Windows
 (Cygwin and Windows Subsystem for Linux).

 We do our best to run on as many platforms as possible. Help is welcome for
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

 [[start]]
 == Start WeeChat
@@ -11,8 +12,9 @@ It has good UTF-8 support and works well with WeeChat's default key bindings.

 Run from your shell:

+[source,shell]
 ----
-$ weechat
+weechat
 ----

 [[help]]
@@ -265,7 +267,7 @@ Close a server, channel or private buffer (`/close` is an alias for
 /close
 ----

-[WARNING]
+[CAUTION]
 Closing the server buffer will close all channel/private buffers.

 Disconnect from server, on the server buffer:
@@ -2,11 +2,12 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

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

 [[terminology]]
@@ -24,28 +25,11 @@ The following terms are used in this document:

 The _clients_ are connected to _relay_ like shown in this 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
-....
+include::includes/relay.en.adoc[tag=diagram]

 [NOTE]
-All clients here are clients using _weechat_ protocol in _relay_ plugin. The
-_relay_ plugin also allows IRC clients, then _relay_ plugin acts as an
-_IRC proxy_ (not described in this document).
+All clients here are clients using _weechat_ protocol in _relay_ plugin. +
+The _relay_ plugin also allows _api_ and _irc_ protocols (not described in this document).

 [[protocol_generalities]]
 == Protocol generalities
@@ -707,6 +691,7 @@ inl:
        nicklist_visible_count: 0
        title: 'WeeChat 2.9-dev (C) 2003-2020 - https://weechat.org/'
        input: 1
+        input_get_any_user_data: 0
        input_get_unknown_commands: 0
        input_get_empty: 0
        input_multiline: 0
@@ -994,7 +979,7 @@ Arguments:

 Examples:

-* Send command "/help filter" on WeeChat core bufer:
+* Send command "/help filter" on WeeChat core buffer:

 ----
 input core.weechat /help filter
@@ -1504,6 +1489,9 @@ WeeChat reserved identifiers:
 | _buffer_line_added | buffer | hdata: line
 | 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 for a buffer. | Replace nicklist.

@@ -2058,6 +2046,7 @@ Data sent as hdata:
 |===
 | Name              | Type             | Description
 | buffer            | pointer          | Buffer pointer.
+| id                | integer          | Line identifier.
 | date              | time             | Date of message.
 | date_usec         | integer          | Microseconds of date.
 | date_printed      | time             | Date when WeeChat displayed message.
@@ -2078,6 +2067,7 @@ id: '_buffer_line_added'
 hda:
    keys: {
        'buffer': 'ptr',
+        'id': 'int',
        'date': 'tim',
        'date_usec': 'int',
        'date_printed': 'tim',
@@ -2093,6 +2083,58 @@ hda:
    item 1:
        __path: ['0x4a49600']
        buffer: '0x4a715d0'
+        id: 12
+        date: 1362728993
+        date_usec: 902765
+        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
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

 This manual documents WeeChat chat client, it is part of WeeChat.

@@ -67,7 +68,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`. +
 A Python stub for WeeChat API is available in the repository:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
+https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].

 [[python_functions]]
 ===== Functions
@@ -362,9 +363,10 @@ WeeChat is starting.

 For example with Python:

+[source,shell]
 ----
-$ cd ~/.local/share/weechat/python/autoload
-$ ln -s ../script.py
+cd ~/.local/share/weechat/python/autoload
+ln -s ../script.py
 ----

 [NOTE]
@@ -549,317 +551,14 @@ link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].

 List of functions in script API:

-[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_datetime_tags (for python: prnt_datetime_tags) +
-  print_y (for python: prnt_y) +
-  print_y_date_tags (for python: prnt_y_date_tags) +
-  print_y_datetime_tags (for python: prnt_y_datetime_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
-|===
+include::{autogendir}/autogen_scripting_functions.en.adoc[tag=functions]

 [[script_api_constants]]
 === Constants

 List of constants in script API:

-[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)
-|===
+include::{autogendir}/autogen_scripting_constants.en.adoc[tag=constants]

 [[common_tasks]]
 == Common tasks
@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]

 This manual documents WeeChat chat client, it is part of WeeChat.

@@ -30,7 +31,7 @@ Main features are:
  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 ^↗^^]
-* IRC proxy and relay for remote interfaces
+* IRC proxy and relay for WeeChat and remote interfaces
 * multi-platform (GNU/Linux, *BSD, macOS, Windows and other)
 * 100% GPL, free software

@@ -110,7 +111,7 @@ WeeChat:
 | cmake | ≥ 3.0
 | Build.

-| pkg-config |
+| pkgconf / pkg-config |
 | Detect installed libraries.

 | libncurses-dev |
@@ -128,7 +129,8 @@ WeeChat:

 | zlib1g-dev |
 | Logger plugin: compression of rotated log files (gzip). +
-  Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
+  Relay plugin: compression of messages with https://zlib.net/[zlib ^↗^^]
+  (api and weechat protocols). +
  Script plugin: read of repository index file (gzip).
 |===

@@ -154,9 +156,13 @@ WeeChat:
 | ca-certificates |
 | Certificates for TLS connections.

+| libcjson-dev |
+| Relay plugin: protocol "api" (HTTP REST API).
+
 | libzstd-dev | ≥ 0.8.1
 | Logger plugin: compression of rotated log files (zstandard). +
-  Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
+  Relay plugin: compression of messages with https://facebook.github.io/zstd/[Zstandard ^↗^^]
+  (api and weechat protocols).

 | libaspell-dev / libenchant-dev |
 | Spell plugin.
@@ -215,8 +221,9 @@ If you are using a Debian/Ubuntu based distribution, and if you have some
 "deb-src" source entries in your file _/etc/apt/sources.list_, you can install
 all dependencies with the command:

+[source,shell]
 ----
-# apt-get build-dep weechat
+sudo apt-get build-dep weechat
 ----

 [[build]]
@@ -224,22 +231,24 @@ all dependencies with the command:

 * Installation in system directories (requires _root_ privileges):

+[source,shell]
 ----
-$ mkdir build
-$ cd build
-$ cmake ..
-$ make
-$ sudo make install
+mkdir build
+cd build
+cmake ..
+make
+sudo make install
 ----

 * Installation in custom directory (for example your home):

+[source,shell]
 ----
-$ mkdir build
-$ cd build
-$ cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
-$ make
-$ make install
+mkdir build
+cd build
+cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
+make
+make install
 ----

 Options can be used for CMake, with format: `-DOPTION=VALUE`.
@@ -273,6 +282,9 @@ List of available options:
 | ENABLE_CHARSET | `ON`, `OFF` | ON
 | Compile <<charset,Charset plugin>>.

+| ENABLE_CJSON | `ON`, `OFF` | ON
+| Support of JSON with https://github.com/DaveGamble/cJSON[cJSON ^↗^^] library.
+
 | ENABLE_MAN | `ON`, `OFF` | OFF
 | Build man page.

@@ -372,14 +384,16 @@ List of available options:

 The other options can be displayed with this command:

+[source,shell]
 ----
-$ cmake -LA
+cmake -LA
 ----

 Or with Curses interface:

+[source,shell]
 ----
-$ ccmake ..
+ccmake ..
 ----

 [[tests]]
@@ -392,14 +406,16 @@ Following packages are *required* to compile tests:

 Tests must be enabled when compiling WeeChat:

+[source,shell]
 ----
-$ cmake .. -DENABLE_TESTS=ON
+cmake .. -DENABLE_TESTS=ON
 ----

 They can be launched after compilation from the build directory:

+[source,shell]
 ----
-$ ctest -V
+ctest -V
 ----

 [[git_sources]]
@@ -410,8 +426,9 @@ stable. You're warned!

 To get Git sources, issue this command:

+[source,shell]
 ----
-$ git clone https://github.com/weechat/weechat.git
+git clone https://github.com/weechat/weechat.git
 ----

 Then follow instructions for source package (see
@@ -434,8 +451,9 @@ you have to:

 If you're compiling with CMake:

+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug
+cmake .. -DCMAKE_BUILD_TYPE=Debug
 ----

 [[address_sanitizer]]
@@ -444,18 +462,20 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
 You can additionally enable the address sanitizer, which causes WeeChat to
 crash immediately in case of problem:

+[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]
+[CAUTION]
 You should enable address sanitizer only if you're trying to cause a crash,
 this is not recommended in production.

 Then once compiled and installed, you must run WeeChat like this:

+[source,shell]
 ----
-$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
+ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
 ----

 In case of crash, the backtrace is in file `asan.log`.
@@ -475,12 +495,14 @@ starts, you can use `ulimit` command.

 For example under Linux with _bash_ shell, add this line to your `~/.bashrc`:

+[source,shell]
 ----
 ulimit -c unlimited
 ----

 Or max size:

+[source,shell]
 ----
 ulimit -c 200000
 ----
@@ -502,6 +524,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
 For example if _weechat_ is installed in _/usr/bin/_ and _core_ file is
 in _/home/user/_, then run gdb with this command:

+[source,shell]
 ----
 gdb /usr/bin/weechat /home/user/core
 ----
@@ -520,11 +543,11 @@ Copying output to /tmp/crash.txt.
    at /some_path/src/core/weechat.c:351
 #3  <signal handler called>
 #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
-    remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
+    remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
        hook_process = 0x254eb90
        status = <value optimized out>
 #5  0x000000000044cc7d in hook_timer_exec ()
-    at /some_path/src/core/wee-hook.c:1025
+    at /some_path/src/core/core-hook.c:1025
        tv_time = {tv_sec = 1272693881, tv_usec = 212665}
        ptr_hook = 0x2811f40
        next_hook = 0x0
@@ -549,6 +572,7 @@ Thank you for your help!
 To debug a running WeeChat (for example if WeeChat seems blocked), you can use
 gdb with process id (replace _12345_ with PID of weechat process):

+[source,shell]
 ----
 gdb /usr/bin/weechat 12345
 ----
@@ -564,8 +588,9 @@ Then like for a crash, use command `bt full`:

 To start WeeChat, issue this command:

+[source,shell]
 ----
-$ weechat
+weechat
 ----

 When you run WeeChat for the first time, the default configuration files are
@@ -579,7 +604,7 @@ include::includes/cmdline_options.en.adoc[tag=standard]

 Some extra options are available for debug purposes only:

-[WARNING]
+[CAUTION]
 Do *NOT* use any of these options in production!

 include::includes/cmdline_options.en.adoc[tag=debug]
@@ -781,25 +806,25 @@ This saves the current state in `*.upgrade` files. You can then either reboot
 or move the whole WeeChat directories (config, data, cache) to another machine,
 and restart WeeChat later with this command:

+[source,shell]
 ----
-$ weechat --upgrade
+weechat --upgrade
 ----

 [[restart_after_upgrade]]
 === Restart after upgrade

-[[restart_release_notes]]
-==== Release notes
+[[restart_upgrading_notes]]
+==== Upgrading notes

-After an upgrade, it is *strongly recommended* to read the
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
-which contain important information about breaking changes and some
+After an upgrade, it is *strongly recommended* to read the file
+https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
+which contains important information about breaking changes and some
 manual actions that could be required.

-You must read the release notes of all versions between your old (excluded) and
-your new version (included). +
-For example if you switch from version 3.0 to 3.2, you must read release notes
-of versions 3.1 and 3.2.
+You must read the versions between your old (excluded) and your new version (included). +
+For example if you switch from version 4.0.0 to 4.3.0, you must read versions
+4.0.1 to 4.3.0.

 [[restart_configuration_upgrade]]
 ==== Configuration upgrade
@@ -852,7 +877,7 @@ Example of terminal with WeeChat:
 │         │                                                                    │       │
 │         │                                                                    │       │
 │         │                                                                    │       │
-│         │[12:55] [5] [irc/libera] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]                │
+│         │[12:55] [5] [irc/libera] 2:#test(+n){4}* M [H: 3:#abc(2,5), 5]              │
 │         │[@Flashy(i)] hi peter!█                                                     │
 └──────────────────────────────────────────────────────────────────────────────────────┘
            ▲ bars "status" and "input"                               bar "nicklist" ▲
@@ -891,39 +916,41 @@ Bar _status_ has following default items:

 [width="100%",cols="^3,^3,9",options="header"]
 |===
-| Item                  | Example               | Description
-| time                  | `[12:55]`             | Time.
-| buffer_last_number    | `[5]`                 | Number of last buffer in list.
-| buffer_plugin         | `[irc/libera]`        | Plugin of current buffer (irc plugin can add IRC server name used by buffer).
-| buffer_number         | `2`                   | Current buffer number.
-| buffer_name           | `#test`               | Current buffer name.
-| buffer_modes          | `+n`                  | IRC channel modes.
-| buffer_nicklist_count | `{4}`                 | Number of nicks displayed in nicklist.
-| buffer_zoom           | !                     | `!` means the merged buffer is zoomed (only this one is displayed), empty value means all merged buffers are displayed.
-| buffer_filter         | `+*+`                 | Filtering indicator: `+*+` means some lines are filtered (hidden), empty value means all lines are displayed.
-| scroll                | `-MORE(50)-`          | Scroll indicator, with number of lines below last line displayed.
-| lag                   | `[Lag: 2.5]`          | Lag indicator, in seconds (hidden if lag is low).
-| hotlist               | `[H: 3:#abc(2,5), 5]` | List of buffers with activity (unread messages) (in example, 2 highlights and 5 unread messages on _#abc_, one unread message on buffer #5).
-| completion            | `abc(2) def(5)`       | List of words for completion, with number of possible completions for each word.
+| Item                  | Example                | Description
+| time                  | `12:55`                | Time.
+| buffer_last_number    | `5`                    | Number of the latest buffer (can be different from `buffer_count` if option <<option_weechat.look.buffer_auto_renumber,weechat.look.buffer_auto_renumber>> is `off`).
+| buffer_plugin         | `irc/libera`           | Plugin of current buffer (irc plugin can add IRC server name used by buffer).
+| buffer_number         | `2`                    | Current buffer number.
+| buffer_name           | `#test`                | Current buffer name.
+| buffer_modes          | `+n`                   | IRC channel modes.
+| buffer_nicklist_count | `4`                    | Number of nicks displayed in nicklist.
+| buffer_zoom           | !                      | `!` means the merged buffer is zoomed (only this one is displayed), empty value means all merged buffers are displayed.
+| buffer_filter         | `+*+`                  | Filtering indicator: `+*+` means some lines are filtered (hidden), empty value means all lines are displayed.
+| mouse_status          | `M`                    | Mouse status (empty if mouse is disabled), see command <<command_weechat_mouse,/mouse>> and <<key_bindings_toggle_keys,toggle keys>>.
+| scroll                | `-MORE(50)-`           | Scroll indicator, with number of lines below last line displayed.
+| lag                   | `Lag: 2.5`             | Lag indicator, in seconds (hidden if lag is low).
+| hotlist               | `H: 3:#abc(2,5), 5`    | List of buffers with activity (unread messages) (in example, 2 highlights and 5 unread messages on _#abc_, one unread message on buffer #5).
+| typing                | `Typing: bob, (alice)` | Typing notification, see <<typing_notifications,typing notifications>>.
+| completion            | `abc(2) def(5)`        | List of words for completion, with number of possible completions for each word.
 |===

 Bar _input_ has following default items:

 [width="100%",cols="^3,^3,9",options="header"]
 |===
-| Item         | Example                                      | Description
-| input_prompt | `[@Flashy(i)]`                               | Input prompt, for irc: nick and modes (mode "+i" means invisible on libera).
-| away         | `(away)`                                     | Away indicator.
-| input_search | `[Search lines (~ str,msg)]`                 | Search indicator (see below)
-| input_paste  | `[Paste 7 lines ? [ctrl-y] Yes [ctrl-n] No]` | Question to user for pasting lines.
-| input_text   | `hi peter!`                                  | Input text.
+| Item         | Example                                    | Description
+| input_prompt | `@Flashy(i)`                               | Input prompt, for irc: nick and modes (mode "+i" means invisible on libera).
+| away         | `away`                                     | Away indicator.
+| input_search | `Search lines (~ str,msg)`                 | Search indicator (see below)
+| input_paste  | `Paste 7 lines ? [ctrl-y] Yes [ctrl-n] No` | Question to user for pasting lines.
+| input_text   | `hi peter!`                                | Input text.
 |===

 There are two search modes:

 * search in lines, for example `[Search lines (~ str,msg)]`, with the following info:
-** `~`: case insensitive
-** `==`: case sensitive
+** `~`: case-insensitive
+** `==`: case-sensitive
 ** `str`: search string
 ** `regex`: search regular expression
 ** `msg`: search in messages
@@ -931,8 +958,8 @@ There are two search modes:
 ** `pre\|msg`: search in prefixes and messages.
 * search in commands history, for example `[Search command (~ str,local)]`,
  with the following info:
-** `~`: case insensitive
-** `==`: case sensitive
+** `~`: case-insensitive
+** `==`: case-sensitive
 ** `str`: search string
 ** `regex`: search regular expression
 ** `local`: search in buffer local history
@@ -951,8 +978,7 @@ Other items available (not used in bars by default):
 [width="100%",cols="^3,^3,9",options="header"]
 |===
 | Item                         | Example                  | Description
-| buffer_count                 | `10`                     | Total number of buffers opened.
-| buffer_last_number           | `10`                     | Number of the latest buffer (can be different from `buffer_count` if option <<option_weechat.look.buffer_auto_renumber,weechat.look.buffer_auto_renumber>> is `off`).
+| buffer_count                 | `5`                      | Total number of buffers opened.
 | buffer_nicklist_count_all    | `4`                      | Number of visible groups and nicks in nicklist.
 | buffer_nicklist_count_groups | `0`                      | Number of visible groups in nicklist.
 | buffer_short_name            | `#test`                  | Current buffer short name.
@@ -967,7 +993,7 @@ Other items available (not used in bars by default):
 | irc_nick_host                | `+Flashy!user@host.com+` | Current IRC nick and host.
 | irc_nick_modes               | `i`                      | IRC modes for self nick.
 | irc_nick_prefix              | `@`                      | IRC nick prefix on channel.
-| mouse_status                 | `M`                      | Mouse status (empty if mouse is disabled).
+| spacer                       |                          | Special item used to align text in bars, see <<item_spacer,Spacer item>>.
 | spell_dict                   | `fr,en`                  | Spelling dictionaries used on current buffer.
 | spell_suggest                | `print,prone,prune`      | Spelling suggestions for word under cursor (if misspelled).
 | tls_version                  | `TLS1.3`                 | TLS version in use for current IRC server.
@@ -1077,7 +1103,7 @@ data).

 Examples of buffers:

-* core buffer (created by WeeChat on startup, can not be closed)
+* core buffer (created by WeeChat on startup, cannot be closed)
 * irc server (displays messages from server)
 * irc channel
 * irc private messages
@@ -1315,10 +1341,10 @@ Tags commonly used (non-exhaustive list):
 [width="100%",cols="1m,4",options="header"]
 |===
 | Tag              | Description
-| no_filter        | Line can not be filtered.
+| no_filter        | Line cannot be filtered.
 | no_highlight     | No highlight is possible on line.
 | no_log           | Line is not written in log file.
-| log0 … log9      | Level of log for line (see `/help logger`).
+| log0 … log9      | Level of log for line (see the <<command_logger_logger,/logger>> command).
 | notify_none      | The line must not be added to hotlist. ^(1)^
 | notify_message   | The line is a user message. ^(1)^
 | notify_private   | The line is a private message. ^(1)^
@@ -1727,11 +1753,12 @@ They can be changed and new ones can be added with the <<command_weechat_key,/ke

 [width="100%",cols="^.^3,.^8,.^5",options="header"]
 |===
-| Key         | Description | Command
-| kbd:[Alt+m] | Toggle mouse. | `+/mouse toggle+`
-| kbd:[Alt+s] | Toggle spell checker. | `+/mute spell toggle+`
-| kbd:[Alt+=] | Toggle filters. | `+/filter toggle+`
-| kbd:[Alt+-] | Toggle filters in current buffer. | `+/filter toggle @+`
+| Key                    | Description | Command
+| kbd:[Alt+m]            | Toggle mouse. | `+/mouse toggle+`
+| kbd:[Alt+s]            | Toggle spell checker. | `+/mute spell toggle+`
+| kbd:[Alt+=]            | Toggle filters. | `+/filter toggle+`
+| kbd:[Alt+-]            | Toggle filters in current buffer. | `+/filter toggle @+`
+| kbd:[Alt+Ctrl+l] (`L`) | Toggle between remote and local commands on a remote buffer (relay "api"). | `+/remote togglecmd+`
 |===

 [[key_bindings_search_context]]
@@ -1942,9 +1969,9 @@ These keys and actions are used on the IRC /list buffer (see command <<command_i
 | kbd:[F11]      | `pass:[<]`   | Scroll horizontally on the left. | `+/list -left+`
 | kbd:[F12]      | `pass:[>]`   | Scroll horizontally on the right. | `+/list -right+`
 | kbd:[Ctrl+j]   | `j`          | Join IRC channel on selected line. | `+/list -join+`
-|                | `xxx`        | Show only channels with "xxx" in name or topic (case insensitive). |
-|                | `n:xxx`      | Show only channels with "xxx" in name (case insensitive). |
-|                | `t:xxx`      | Show only channels with "xxx" in topic (case insensitive). |
+|                | `xxx`        | Show only channels with "xxx" in name or topic (case-insensitive). |
+|                | `n:xxx`      | Show only channels with "xxx" in name (case-insensitive). |
+|                | `t:xxx`      | Show only channels with "xxx" in topic (case-insensitive). |
 |                | `u:n`        | Show only channels with at least "n" users. |
 |                | `u:>n`       | Show only channels with more than "n" users. |
 |                | `u:<n`       | Show only channels with less than "n" users. |
@@ -2001,27 +2028,27 @@ Example of fset buffer displaying options starting with `weechat.look` :
 [subs="quotes"]
 ....
 ┌──────────────────────────────────────────────────────────────────────────────────────┐
-│1.weechat│1/121 | Filter: weechat.look.* | Sort: ~name | Key(input): alt+space=toggle │
+│1.weechat│7/125 | Filter: weechat.look.* | Sort: ~name | Key(input): alt+space=toggl>>│
 │2.fset   │weechat.look.bare_display_exit_on_input: exit the bare display mode on any c│
 │         │hanges in input [default: on]                                               │
 │         │----------------------------------------------------------------------------│
-│         │  weechat.look.align_end_of_lines                   enum     message        │
-│         │  weechat.look.align_multiline_words                boolean  on             │
-│         │  weechat.look.bar_more_down                        string   "++"           │
-│         │  weechat.look.bar_more_left                        string   "<<"           │
-│         │  weechat.look.bar_more_right                       string   ">>"           │
-│         │  weechat.look.bar_more_up                          string   "--"           │
-│         │##  weechat.look.bare_display_exit_on_input           boolean  on             ##│
-│         │  weechat.look.bare_display_time_format             string   "%H:%M"        │
-│         │  weechat.look.buffer_auto_renumber                 boolean  on             │
-│         │  weechat.look.buffer_notify_default                enum     all            │
-│         │  weechat.look.buffer_position                      enum     end            │
-│         │  weechat.look.buffer_search_case_sensitive         boolean  off            │
-│         │  weechat.look.buffer_search_force_default          boolean  off            │
-│         │  weechat.look.buffer_search_regex                  boolean  off            │
-│         │  weechat.look.buffer_search_where                  enum     prefix_message │
-│         │  weechat.look.buffer_time_format                   string   "%H:%M:%S"     │
-│         │  weechat.look.buffer_time_same                     string   ""             │
+│         │  weechat.look.align_end_of_lines              enum     message             │
+│         │  weechat.look.align_multiline_words           boolean  on                  │
+│         │  weechat.look.bar_more_down                   string   "++"                │
+│         │  weechat.look.bar_more_left                   string   "<<"                │
+│         │  weechat.look.bar_more_right                  string   ">>"                │
+│         │  weechat.look.bar_more_up                     string   "--"                │
+│         │##  weechat.look.bare_display_exit_on_input      boolean  on                  ##│
+│         │  weechat.look.bare_display_time_format        string   "%H:%M"             │
+│         │  weechat.look.buffer_auto_renumber            boolean  on                  │
+│         │  weechat.look.buffer_notify_default           enum     all                 │
+│         │  weechat.look.buffer_position                 enum     end                 │
+│         │  weechat.look.buffer_search_case_sensitive    boolean  off                 │
+│         │  weechat.look.buffer_search_force_default     boolean  off                 │
+│         │  weechat.look.buffer_search_history           enum     local               │
+│         │  weechat.look.buffer_search_regex             boolean  off                 │
+│         │  weechat.look.buffer_search_where             enum     prefix_message      │
+│         │  weechat.look.buffer_time_format              string   "%H:%M:%S"          │
 │         │[12:55] [2] [fset] 2:fset                                                   │
 │         │█                                                                           │
 └──────────────────────────────────────────────────────────────────────────────────────┘
@@ -2673,27 +2700,37 @@ You can change or add bindings with the command `/key` using context "mouse"
 Event name consists of a modifier (optional), a button/wheel name and a gesture
 (optional). Different elements are separated by `+-+`.

-List of modifiers:
+List of modifiers (by order in the event name):

 [width="100%",cols="1m,4",options="header"]
 |===
 | Modifier | Description
-| ctrl     | Key kbd:[Ctrl]
 | alt      | Key kbd:[Alt]
-| ctrl-alt | Keys kbd:[Ctrl] + kbd:[Alt]
+| ctrl     | Key kbd:[Ctrl]
+| shift    | Key kbd:[Shift] ^(1)^
 |===

+[NOTE]
+^(1)^ The `shift` modifier can rarely be used in WeeChat because many terminals
+use this modifier to catch directly mouse events.
+
+Several modifiers can be combined, for example:
+
+* `alt-ctrl`
+* `ctrl-shift`
+* `alt-ctrl-shift`
+
 List of buttons/wheel:

 [width="100%",cols="1m,4",options="header"]
 |===
-| Button/wheel        | Description
-| button1             | Click on left button
-| button2             | Click on right button
-| button3             | Click on middle button (often click on wheel)
-| button4 ... button9 | Click on extra buttons
-| wheelup             | Wheel (up)
-| wheeldown           | Wheel (down)
+| Button/wheel         | Description
+| button1              | Click on left button
+| button2              | Click on right button
+| button3              | Click on middle button (often click on wheel)
+| button4 ... button11 | Click on extra buttons
+| wheelup              | Wheel (up)
+| wheeldown            | Wheel (down)
 |===

 List of gestures (only for buttons, not wheel):
@@ -2729,7 +2766,7 @@ Example of events:
 * `button1-event-drag`
 * `alt-button2-gesture-down-long`
 * `wheelup`
-* `ctrl-alt-wheeldown`
+* `alt-ctrl-wheeldown`
 * ...

 [TIP]
@@ -2789,8 +2826,9 @@ configuration.
 The option name is an aspell configuration option. List of options can be found
 in a shell with following command:

+[source,shell]
 ----
-$ aspell config
+aspell config
 ----

 For example, to enable option "ignore-case":
@@ -3226,7 +3264,7 @@ buffer to see values), just do:
 Secured data can be used in some options that can contain private data like
 password, using this format: "${sec.data.xxx}" where "xxx" is the name of
 secured data (used with `/secure set xxx ...`). +
-For a complete list of supported options, see `/help secure`.
+For a complete list of supported options, see the <<command_weechat_secure,/secure>> command.

 To use the _libera_ password, for example with
 <<irc_sasl_authentication,SASL authentication>>:
@@ -3242,7 +3280,7 @@ Alias plugin lets you create alias for commands (from WeeChat or other
 plugins).

 Some aliases are created by default, with name in upper case (to make them
-different from standard commands); commands are not case sensitive in WeeChat,
+different from standard commands); commands are not case-sensitive in WeeChat,
 so for example `/close` runs the alias `/CLOSE`.

 List of default aliases:
@@ -3350,8 +3388,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
 Example to join _#weechat_ and _#weechat-fr_ on server _irc.libera.chat_ server,
 default port (6667), with nick _alice_:

+[source,shell]
 ----
-$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
+weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 ----

 [[irc_servers]]
@@ -3363,13 +3402,15 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 By default no servers are defined. You can add as many servers as you want with
 the <<command_irc_server,/server>> command.

-For example to connect to https://libera.chat/[libera.chat ^↗^^]
-with TLS (encrypted trafic):
+For example to connect to https://libera.chat/[libera.chat ^↗^^]:

 ----
-/server add libera irc.libera.chat/6697 -tls
+/server add libera irc.libera.chat
 ----

+[NOTE]
+Default port is 6697 and TLS (encrypted traffic) is enabled.
+
 You can tell WeeChat to auto-connect to this server on startup:

 ----
@@ -3410,11 +3451,11 @@ For example if you created the _libera_ server with the commands above, you'll
 see this with the command `/fset libera`:

 ....
-irc.server.libera.addresses             string   "irc.libera.chat/6697"
-irc.server.libera.anti_flood_prio_high  integer  null -> 2
-irc.server.libera.anti_flood_prio_low   integer  null -> 2
+irc.server.libera.addresses             string   "irc.libera.chat"
+irc.server.libera.anti_flood            integer  null -> 2000
 irc.server.libera.autoconnect           boolean  on
 irc.server.libera.autojoin              string   null -> ""
+irc.server.libera.autojoin_delay        integer  null -> 0
 irc.server.libera.autojoin_dynamic      boolean  null -> off
 irc.server.libera.autoreconnect         boolean  null -> on
 irc.server.libera.autoreconnect_delay   integer  null -> 10
@@ -3428,17 +3469,18 @@ irc.server.libera.command               string   null -> ""
 irc.server.libera.command_delay         integer  null -> 0
 irc.server.libera.connection_timeout    integer  null -> 60
 irc.server.libera.default_chantypes     string   null -> "#&"
-irc.server.libera.ipv6                  boolean  null -> on
+irc.server.libera.ipv6                  enum     null -> auto
 irc.server.libera.local_hostname        string   null -> ""
 irc.server.libera.msg_kick              string   null -> ""
 irc.server.libera.msg_part              string   null -> "WeeChat ${info:version}"
 irc.server.libera.msg_quit              string   null -> "WeeChat ${info:version}"
-irc.server.libera.nicks                 string   null -> "alice,alice1,alice2,alice3,alice4"
+irc.server.libera.nicks                 string   null -> "${username},${username}2,${username}3,${username}4,${username}5"
 irc.server.libera.nicks_alternate       boolean  null -> on
 irc.server.libera.notify                string   null -> ""
 irc.server.libera.password              string   null -> ""
 irc.server.libera.proxy                 string   null -> ""
 irc.server.libera.realname              string   null -> ""
+irc.server.libera.registered_mode       string   null -> "r"
 irc.server.libera.sasl_fail             enum     null -> reconnect
 irc.server.libera.sasl_key              string   null -> ""
 irc.server.libera.sasl_mechanism        enum     null -> plain
@@ -3446,15 +3488,15 @@ irc.server.libera.sasl_password         string   "${sec.data.libera}"
 irc.server.libera.sasl_timeout          integer  null -> 15
 irc.server.libera.sasl_username         string   "alice"
 irc.server.libera.split_msg_max_length  integer  null -> 512
-irc.server.libera.tls                   boolean  on
+irc.server.libera.tls                   boolean  null -> on
 irc.server.libera.tls_cert              string   null -> ""
 irc.server.libera.tls_dhkey_size        integer  null -> 2048
 irc.server.libera.tls_fingerprint       string   null -> ""
 irc.server.libera.tls_password          string   null -> ""
-irc.server.libera.tls_priorities        string   null -> "NORMAL:-VERS-SSL3.0"
+irc.server.libera.tls_priorities        string   null -> "NORMAL"
 irc.server.libera.tls_verify            boolean  null -> on
 irc.server.libera.usermode              string   null -> ""
-irc.server.libera.username              string   null -> "alice"
+irc.server.libera.username              string   null -> "${username}"
 ....

 For example if you want to automatically connect to all servers you define
@@ -3505,9 +3547,10 @@ even if it was OK with versions prior to 0.3.1.

 * Import certificate in shell:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
+mkdir -p ~/.config/weechat/tls
+wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
 ----

 [NOTE]
@@ -3528,10 +3571,11 @@ It is possible to concatenate many certificates in file CAs.pem.

 * Create certificate in shell:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
+mkdir -p ~/.config/weechat/tls
+cd ~/.config/weechat/tls
+openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----

 [NOTE]
@@ -3574,13 +3618,14 @@ Options in servers are:
 [[irc_sasl_ecdsa_nist256p_challenge]]
 ===== SASL ECDSA-NIST256P-CHALLENGE

-You must generate a private key in order to authentify with the
+You must generate a private key in order to authenticate with the
 ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection).

 You can generate the key with this command:

+[source,shell]
 ----
-$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
+openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
 ----

 [NOTE]
@@ -3589,8 +3634,9 @@ which can also be for example `~/.weechat`.

 Get the public key (encoded as base64) with this command:

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

 Connect to the server, identify (for example with "nickserv identify") and set
@@ -3657,8 +3703,9 @@ privacy and security on the Internet.

 In first place, install Tor. For Debian (and derived):

+[source,shell]
 ----
-$ sudo apt-get install tor
+sudo apt-get install tor
 ----

 In WeeChat you need to add a socks5 proxy for Tor service (hostname/IP and
@@ -4079,7 +4126,7 @@ for example if `#channel1` requires a key but not `#channel2`:
 /set irc.server.libera.autojoin "#channel1,#channel2 key1"
 ----

-For help on the format, see `/help irc.server.libera.autojoin`.
+For help on the format, see option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.

 [[irc_private_messages]]
 === Private messages
@@ -4126,7 +4173,7 @@ buffers, for example:
 ----

 It is possible to create filter for one channel only or channels beginning with
-same name (see `/help filter`):
+same name (see the <<command_weechat_filter,/filter>> command):

 ----
 /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4511,8 +4558,13 @@ The Relay plugin is used to relay data via network, using different protocols:

 * _irc_: IRC proxy: used to share connections to IRC servers with one or many
  other IRC clients
+* _api_: HTTP REST API, used by WeeChat and remote interfaces to display and
+  interact with WeeChat
 * _weechat_: protocol used by remote interfaces to display and interact with
-  WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^].
+  WeeChat.
+
+For _api_ and _weechat_ protocols, see the list of remote interfaces on
+https://weechat.org/about/interfaces/[this page ^↗^^].

 [[relay_password]]
 === Password
@@ -4524,13 +4576,13 @@ It is highly recommended to set a password for relay, with these commands:
 /set relay.network.password "${sec.data.relay}"
 ----

-This password is used for _irc_ and _weechat_ protocols.
+This password is used with all protocols.

 [[relay_totp]]
 === TOTP

 TOTP (Time-based One-Time Password) can be used as secondary authentication
-factor for _weechat_ protocol, in addition to the password.
+factor for _api_ and _weechat_ protocols, in addition to the password.

 This is optional and increases the security level.

@@ -4566,10 +4618,11 @@ The default path to certificate/key is defined by option

 You can create a certificate and private key with following commands:

+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+mkdir -p ~/.config/weechat/tls
+cd ~/.config/weechat/tls
+openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
 ----

 [NOTE]
@@ -4622,6 +4675,47 @@ commands:
 /set irc.server.relay.password "${sec.data.relay_libera}"
 ----

+[[relay_api_protocol]]
+=== API protocol
+
+The Relay plugin can send data to a remote WeeChat or interface using an
+HTTP REST API protocol.
+
+You can browse and test the API online:
+https://weechat.org/api/[WeeChat Relay API ^↗^^].
+
+You can connect with WeeChat or a remote interface, see
+https://weechat.org/about/interfaces/[this page ^↗^^].
+
+For example:
+
+----
+/relay add api 9000
+----
+
+Now you can connect on port 9000 with a WeeChat or a remote interface using
+password "mypassword".
+
+To connect to an _api_ relay running locally with WeeChat:
+
+----
+/remote add weechat http://localhost:9000 -password=mypassword
+/remote connect weechat
+----
+
+To connect to an _api_ relay running elsewhere with WeeChat
+(TLS is highly recommended):
+
+----
+/remote add weechat https://example.com:9000 -password=mypassword
+/remote connect weechat
+----
+
+[NOTE]
+The remote WeeChat must expose the same API version as the local WeeChat, so
+it's highly recommended to use exactly the same WeeChat version on remote
+and local client.
+
 [[relay_weechat_protocol]]
 === WeeChat protocol

@@ -4631,15 +4725,15 @@ You can connect with a remote interface, see
 https://weechat.org/about/interfaces/[this page ^↗^^].

 [IMPORTANT]
-WeeChat itself can NOT connect to another WeeChat with this protocol.
+WeeChat itself cannot connect to another WeeChat with this protocol.

 For example:

 ----
-/relay add weechat 9000
+/relay add weechat 9500
 ----

-Now you can connect on port 9000 with a remote interface using password
+Now you can connect on port 9500 with a remote interface using password
 "mypassword".

 [[relay_websocket]]
@@ -4657,11 +4751,13 @@ A WebSocket can be opened in a HTML5 with a single line of JavaScript:

 [source,javascript]
 ----
-websocket = new WebSocket("ws://server.com:9000/weechat");
+websocket = new WebSocket("ws://example.com:9500/weechat");
 ----

-The port (9000 in example) is the port defined in Relay plugin.
-The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
+The port (9500 in example) is the port defined in Relay plugin.
+
+The URI must end with "/weechat" for _irc_ and _weechat_ protocols and "/api"
+for _api_ protocol.

 [[relay_unix_socket]]
 === UNIX domain sockets
@@ -4679,8 +4775,9 @@ SSH forwarding for relay clients, when other ports cannot be opened.

 Using OpenSSH:

+[source,shell]
 ----
-$ ssh -L 9000:.weechat/relay_socket user@hostname
+ssh -L 9000:.weechat/relay_socket user@hostname
 ----

 This redirects local relay clients connecting on port 9000 to the WeeChat
@@ -4704,7 +4801,7 @@ Sections in file _relay.conf_:
 | network | /set relay.network.*               | Network options.
 | irc     | /set relay.irc.*                   | Options specific to irc protocol (irc proxy).
 | port    | <<command_relay_relay,/relay add>> +
-            /set relay.port.*                  | Ports used for relay (irc and weechat protocols) (options can be added/removed in section).
+            /set relay.port.*                  | Ports used for relay (options can be added/removed in section).
 |===

 Options:
@@ -4766,34 +4863,39 @@ Some examples:

 * Change nick on IRC server libera to "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
 ----

 * Send a message on 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
 ----

 * Send a multiline message on IRC #test channel, if capability "draft/multiline"
  is enabled on the ergo server:

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

 * Send a message on current buffer:

+[source,shell]
 ----
-$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
+echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
 ----

 * Send two commands to unload/reload Python scripts (you have to separate them
  with "\n"):

+[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]]
@@ -4876,7 +4978,7 @@ A trigger has the following options (names are

 | enabled | `on`, `off`
 | When option is `off`, the trigger is disabled and actions are not executed
-  any more.
+  anymore.

 | hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
  `+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
@@ -5110,7 +5212,9 @@ Matching groups can be used in _replace_:

 * `+${re:0}+` to `+${re:99}+`: `+${re:0}+` is the whole match, `+${re:1}+` to
  `+${re:99}+` are groups captured
-* `+${re:+}+`: the last match (with highest number)
+* `pass:[${re:+}]`: the last match (with highest number)
+* `+${re:#}+`: index of last group captured
+* `+${re:repl_index}+`: index of replacement being done (starts to 1)
 * `+${hide:c,${re:N}}+`: match "N" with all chars replaced by "c"
  (example: `+${hide:*,${re:2}}+` is the group #2 with all chars replaced by
  `+*+`).
@@ -5259,7 +5363,7 @@ is added in hashtable:
 | server               | string  | Name of server (example: "libera").
 | tags                 | string  | Tags in message (rarely used).
 | message_without_tags | string  | Message without tags.
-| nick                 | string  | Nick.
+| nick                 | string  | Nick. ^(1)^
 | host                 | string  | Hostname.
 | command              | string  | IRC command (example: "PRIVMSG", "NOTICE", ...).
 | channel              | string  | IRC channel.
@@ -5271,6 +5375,10 @@ is added in hashtable:
 | pos_text             | string  | The index of _text_ in message ("-1" if _text_ was not found).
 |===

+[NOTE]
+^(1)^ The nick is the sender of the message. +
+Your own nick on the server is `${irc_server.nick}`.
+
 When the data is a pointer, the variable `+tg_signal_data+` can be used like this
 to read a hdata property (in this example this is a pointer on a buffer):

@@ -5684,7 +5792,7 @@ For privacy considerations, the download of scripts is disabled by default. +
 To enable it, type this command:

 ----
-/set script.scripts.download_enabled on
+/script enable
 ----

 Then you can download the list of scripts and display them in a new buffer
@@ -5694,33 +5802,33 @@ with the <<command_script_script,/script>> command:
 :x: *
 ....
 ┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│1.weechat│368/368 scripts (filter: {x}) | Sort: i,p,n | Alt+key/input: i=install, r=remove, l=load, L=reload, u=│
-│2.scripts│{x}      autosort.py                 3.9     2020-10-11 | Automatically keep buffers grouped by server│
-│         │{x}      multiline.pl                0.6.3   2016-01-02 | Multi-line edit box, also supports editing o│
-│         │{x}      highmon.pl                  2.7     2020-06-21 | Adds a highlight monitor buffer.            │
-│         │##{x}ia r  grep.py               0.8.5 0.8.5   2021-05-11 | Search regular expression in buffers or log ##│
-│         │{x}      autojoin.py                 0.3.1   2019-10-06 | Configure autojoin for all servers according│
-│         │{x}      colorize_nicks.py           28      2021-03-06 | Use the weechat nick colors in the chat area│
-│         │{x}ia r  go.py                 2.7   2.7     2021-05-26 | Quick jump to buffers.                      │
-│         │{x}      text_item.py                0.9     2019-05-25 | Add bar items with plain text.              │
-│         │       aesthetic.py                1.0.6   2020-10-25 | Make messages more A E S T H E T I C A L L Y│
-│         │       aformat.py                  0.2     2018-06-21 | Alternate text formatting, useful for relays│
-│         │       alternatetz.py              0.3     2018-11-11 | Add an alternate timezone item.             │
-│         │       amarok2.pl                  0.7     2012-05-08 | Amarok 2 control and now playing script.    │
-│         │       amqp_notify.rb              0.1     2011-01-12 | Send private messages and highlights to an A│
-│         │       announce_url_title.py       19      2021-06-05 | Announce URL title to user or to channel.   │
-│         │       anotify.py                  1.0.2   2020-05-16 | Notifications of private messages, highlight│
-│         │       anti_password.py            1.2.1   2021-03-13 | Prevent a password from being accidentally s│
-│         │       apply_corrections.py        1.3     2018-06-21 | Display corrected text when user sends s/typ│
-│         │       arespond.py                 0.1.1   2020-10-11 | Simple autoresponder.                       │
-│         │       atcomplete.pl               0.001   2016-10-29 | Tab complete nicks when prefixed with "@".  │
-│         │       audacious.pl                0.3     2009-05-03 | Display which song Audacious is currently pl│
-│         │       auth.rb                     0.3     2014-05-30 | Automatically authenticate with NickServ usi│
-│         │       auto_away.py                0.4     2018-11-11 | A simple auto-away script.                  │
-│         │       autoauth.py                 1.3     2021-11-07 | Permits to auto-authenticate when changing n│
-│         │       autobump.py                 0.1.0   2019-06-14 | Bump buffers upon activity.                 │
-│         │       autoconf.py                 0.4     2021-05-11 | Auto save/load changed options in a .weerc f│
-│         │       autoconnect.py              0.3.3   2019-10-06 | Reopen servers and channels opened last time│
+│1.weechat│322/322 scripts (filter: {x}) | Sort: i,p,n | Alt+key/input: i=install, r=remove, l=load, L=reload, >>│
+│2.scripts│{x}      autosort.py                     3.10    2023-12-31 | Automatically keep buffers grouped by se│
+│         │{x}      highmon.pl                      2.7     2020-06-21 | Adds a highlight monitor buffer.        │
+│         │{x}ia r  grep.py                   0.8.6 0.8.6   2022-11-11 | Search regular expression in buffers or │
+│         │{x}      colorize_nicks.py               32      2023-10-30 | Use the weechat nick colors in the chat │
+│         │##{x}ia r  go.py                     3.0.1 3.0.1   2024-05-30 | Quick jump to buffers.                  ##│
+│         │       aesthetic.py                    1.0.6   2020-10-25 | Make messages more A E S T H E T I C A L│
+│         │       aformat.py                      0.2     2018-06-21 | Alternate text formatting, useful for re│
+│         │       alternatetz.py                  0.4     2022-01-25 | Add an alternate timezone item.         │
+│         │       amarok2.pl                      0.7     2012-05-08 | Amarok 2 control and now playing script.│
+│         │       amqp_notify.rb                  0.1     2011-01-12 | Send private messages and highlights to │
+│         │       announce_url_title.py           19      2021-06-05 | Announce URL title to user or to channel│
+│         │       anotify.py                      1.0.2   2020-05-16 | Notifications of private messages, highl│
+│         │       anti_password.py                1.2.1   2021-03-13 | Prevent a password from being accidental│
+│         │       apply_corrections.py            1.3     2018-06-21 | Display corrected text when user sends s│
+│         │       arespond.py                     0.1.2   2022-01-25 | Simple autoresponder.                   │
+│         │       atcomplete.pl                   0.001   2016-10-29 | Tab complete nicks when prefixed with "@│
+│         │       audacious.pl                    0.3     2009-05-03 | Display which song Audacious is currentl│
+│         │       auth.rb                         0.3     2014-05-30 | Automatically authenticate with NickServ│
+│         │       auto_away.py                    0.4     2018-11-11 | A simple auto-away script.              │
+│         │       autoauth.py                     1.3     2021-11-07 | Permits to auto-authenticate when changi│
+│         │       autobump.py                     0.1.0   2019-06-14 | Bump buffers upon activity.             │
+│         │       autoconf.py                     0.4     2021-05-11 | Auto save/load changed options in a .wee│
+│         │       autoconnect.py                  0.3.3   2019-10-06 | Reopen servers and channels opened last │
+│         │       autojoin_on_invite.py           0.9     2022-10-25 | Auto joins channels when invited.       │
+│         │       automarkbuffer.py               1.0     2015-03-31 | Mark buffers as read if there is no new │
+│         │       automerge.py                    0.2     2018-03-03 | Automatically merge new buffers accordin│
 │         │[12:55] [2] [script] 2:scripts                                                                      │
 │         │█                                                                                                   │
 └──────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
@@ -0,0 +1,23 @@
+// Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com> with updates from Fede Mendez <federicomh@gmail.com>
+:appendix-caption: Apéndice
+:appendix-refsig: {appendix-caption}
+:caution-caption: Precaución
+:chapter-signifier: Capítulo
+:chapter-refsig: {chapter-signifier}
+:example-caption: Ejemplo
+:figure-caption: Figura
+:important-caption: Importante
+:last-update-label: Ultima actualización
+ifdef::listing-caption[:listing-caption: Lista]
+ifdef::manname-title[:manname-title: Nombre]
+:note-caption: Nota
+:part-signifier: Parte
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Prefacio]
+:section-refsig: Sección
+:table-caption: Tabla
+:tip-caption: Sugerencia
+:toc-title: Tabla de Contenido
+:untitled-label: Sin título
+:version-label: Versión
+:warning-caption: Aviso
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: es
-:toc-title: Índice
+include::includes/attributes-es.adoc[]

 Traductores

@@ -58,12 +58,14 @@ If you still have issues, please report them to the developers.
 Se recomienda utilizar https://brew.sh/[Homebrew ^↗^^],
 puede obtener ayuda con el comando:

+[source,shell]
 ----
 brew info weechat
 ----

 Puede instalar WeeChat con este comando:

+[source,shell]
 ----
 brew install weechat
 ----
@@ -326,10 +328,15 @@ Puede utilizar una terminal con selección rectangualr (como rxvt-unicode,
 konsole, gnome-terminal, etc.). La tecla normalmente es kbd:[Ctrl] + kbd:[Alt] + la selección
 con el ratón.

+// TRANSLATION MISSING
+You can toggle nicklist and make it visible only when needed, with key
+kbd:[Alt+Shift+N].
+
 Otra solución es mover la lista de apodos a la parte superior o inferior, por ejemplo:

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 [[urls]]
@@ -340,10 +347,14 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).

 Para abrir direcciones URL más fácilmente, puede:

+// TRANSLATION MISSING
+* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
+
 * mover la lista de apodos a la parte superior con este comando:

 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----

 * inhabilitar la alineación de palabras multilínea:
@@ -394,6 +405,7 @@ No hay razón en WeeChat para cambiar la zona horaria, la variable de entorno

 En el archivo de inicialización de su shell o en la línea de comando, antes de ejecutar WeeChat:

+[source,shell]
 ----
 export TZ=America/New_York
 ----
@@ -701,16 +713,18 @@ De acuerdo a la información usada, el ratón podrá o no estar soportado.

 Puede comprobar el soporte del ratón en la terminal:

+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----

 Y después haga clic en el primer caracter de la terminal (superior izquierdo). Debería ver " !!#!!".

 Para inhabilitar el ratón en la terminal:

+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----

 [[mouse_coords]]
@@ -766,7 +780,7 @@ Puede intentar una cadena de prioridad diferente, reemplace "xxx" por el nombre
 de su servidor:

 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----

 [[irc_tls_libera]]
@@ -1033,8 +1047,9 @@ Primero compruebe las preguntas sobre la conexión TLS en este documento.

 Si todavía no funciona, trate de manera manual eliminar los archivos de scripts (escriba en su terminal):

+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----

 // TRANSLATION MISSING
@@ -1059,9 +1074,10 @@ que actualizar manualmente el archivo usted mismo para obtener las actualizacion

 * en su terminal, con el software curl instalado:

+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+cd ~/.cache/weechat/script
+curl -O https://weechat.org/files/plugins.xml.gz
 ----

 // TRANSLATION MISSING
@@ -1069,6 +1085,7 @@ 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,
 before starting WeeChat:

+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1243,6 +1260,7 @@ See https://weechat.org/about/support/[this page ^↗^^].

 Cuando ejecuta WeeChat bajo gdb, puede tener este error:

+[source,shell]
 ----
 $ gdb /ruta/a/weechat
 (gdb) run
@@ -1253,6 +1271,7 @@ Cannot find new threads: generic error
 Para solucionar esto, puede ejecutar gdb con este comando (reemplace la ruta a libpthread y
 WeeChat con las rutas de su sistema):

+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /ruta/a/weechat
 (gdb) run
@@ -1261,7 +1280,7 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /ruta/a/weechat
 [[supported_os]]
 === ¿Cual es la lista de plataformas para las que está disponible WeeChat? ¿Será portado a otros sistemas operativos?

-WeeChat se ejecuta sin problemas en la mayoría de distribuciones Linux/BSD, GNU/Hurd, Mac OS y Windows
+WeeChat se ejecuta sin problemas en la mayoría de distribuciones Linux/BSD, GNU/Hurd, macOS y Windows
 (Cygwin y Windows Subsystem para Linux).

 Hacemos todo lo posible para que pueda ser ejecutado en cuantas plataformas sea posible. La ayuda es bienvenida para
@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: es
-:toc-title: Índice
+include::includes/attributes-es.adoc[]

 Traductores:

@@ -18,8 +18,9 @@ los atajos de teclado predeterminados.

 Ejecuta desde una consola:

+[source,shell]
 ----
-$ weechat
+weechat
 ----

 [[help]]
@@ -282,7 +283,7 @@ Cierra un servidor, canal o buffer privado (`/close` es un alias para
 /close
 ----

-[WARNING]
+[CAUTION]
 Al cerrar el buffer del servidor cerrará todos los buffer de canales/privados

 Para desconectar del servidor, en el buffer del servidor ejecute:
@@ -0,0 +1,23 @@
+// French translation, courtesy of Nicolas Comet <nicolas.comet@gmail.com> with updates from Maheva Bagard Laursen <mblaursen@gbif.org>
+:appendix-caption: Annexe
+:appendix-refsig: {appendix-caption}
+:caution-caption: Attention
+:chapter-signifier: Chapitre
+:chapter-refsig: {chapter-signifier}
+:example-caption: Exemple
+:figure-caption: Figure
+:important-caption: Important
+:last-update-label: Dernière mise à jour
+ifdef::listing-caption[:listing-caption: Liste]
+ifdef::manname-title[:manname-title: Nom]
+:note-caption: Note
+:part-signifier: Partie
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Préface]
+:section-refsig: Section
+:table-caption: Tableau
+:tip-caption: Astuce
+:toc-title: Table des matières
+:untitled-label: Sans titre
+:version-label: Version
+:warning-caption: Avertissement
--- a/Show More
+++ b/Show More