core: set terminal title using curses emulation of termcap (WIP)

This is work in progress and it does not even compile because of the include of term.h.
ci: fix macOS CI
2026-06-12 14:14:48 +02:00 · 2023-03-03 07:53:07 +01:00 · 2023-02-22 21:53:25 +01:00 · 2023-02-22 20:38:56 +01:00 · 2023-02-21 12:25:23 +01:00 · 2023-02-16 21:39:02 +01:00
802 changed files with 94069 additions and 57319 deletions
@@ -5,4 +5,4 @@ debian-devel           export-ignore
 debian-stable          export-ignore
 weechat.spec           export-ignore
 .mailmap               export-ignore
-tools/build-debian.sh  export-ignore
+tools/build_debian.sh  export-ignore
@@ -4,26 +4,25 @@ on:
  - push
  - pull_request

+env:
+  WEECHAT_DEPENDENCIES: devscripts equivs python3-pip cmake ninja-build lcov pkg-config libncursesw5-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
+
 jobs:

-  build_linux:
+  tests_linux:

    strategy:
-      fail-fast: false
      matrix:
        os:
-          - ubuntu-20.04
+          - ubuntu-22.04
        config:
-          - { name: "cmake_gcc", cc: "gcc", cxx: "g++", tool: "cmake", args: "" }
-          - { name: "cmake_gcc_ninja", cc: "gcc", cxx: "g++", tool: "cmake", args: "-G Ninja" }
-          - { name: "cmake_gcc_no_nls", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_NLS=OFF" }
-          - { name: "cmake_gcc_py2", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_PYTHON2=ON" }
-          - { name: "cmake_gcc_coverage", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_CODE_COVERAGE=ON" }
-          - { name: "cmake_clang", cc: "clang", cxx: "clang++", tool: "cmake", args: "" }
-          - { name: "autotools_gcc", cc: "gcc", cxx: "g++", tool: "autotools", args: "" }
-          - { name: "autotools_clang", cc: "clang", cxx: "clang++", tool: "autotools", args: "" }
+          - { 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" }
+          - { name: "gcc_coverage", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CODE_COVERAGE=ON" }
+          - { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" }

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

    steps:
@@ -32,36 +31,28 @@ jobs:

    - name: Install dependencies
      run: |
-        sudo apt-add-repository --yes ppa:ondrej/php
        sudo apt-get update -qq
-        sudo apt-get --yes purge php8.1-dev
-        sudo apt-get --yes --no-install-recommends install devscripts equivs python3-pip libenchant-dev autopoint cmake ninja-build lcov pkg-config libncursesw5-dev gem2deb libperl-dev python2-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php8.0-dev libphp8.0-embed libargon2-0-dev libsodium-dev pylint python3-bandit asciidoctor
+        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPENDENCIES }}
        sudo -H pip3 install --ignore-installed msgcheck

-    - name: Test patches
-      run: ./tools/build-debian.sh test-patches
-
    - name: Check gettext files
      run: msgcheck po/*.po

-    - name: Check Python scripts
-      run: |
-        pylint --additional-builtins=_ doc/docgen.py
-        pylint doc/python_stub.py
-        pylint tests/scripts/python/testapigen.py tests/scripts/python/testapi.py tests/scripts/python/unparse.py
-        bandit doc/docgen.py doc/python_stub.py
-        bandit tests/scripts/python/testapigen.py tests/scripts/python/testapi.py tests/scripts/python/unparse.py
+    - name: Check shell and Python scripts
+      run: ./tools/check_scripts.sh

    - name: Check Python stub file
      run: ./doc/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
+
    - name: Build and run tests
      env:
        CC: ${{ matrix.config.cc }}
        CXX: ${{ matrix.config.cxx }}
-        BUILDTOOL: ${{ matrix.config.tool }}
-        BUILDARGS: ${{ matrix.config.args }}
-      run: ./tools/build-test.sh
+        BUILDARGS: ${{ matrix.config.buildargs }}
+      run: ./tools/build_test.sh

    - name: Run WeeChat
      env:
@@ -72,10 +63,10 @@ jobs:
        weechat --colors
        weechat --license
        weechat --version
-        weechat --temp-dir --run-command "/debug dirs;/debug libs" --run-command "/quit"
+        weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"

    - name: Code coverage
-      if: ${{ matrix.config.name == 'cmake_gcc_coverage' }}
+      if: ${{ matrix.config.name == 'gcc_coverage' }}
      env:
        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
      run: |
@@ -85,19 +76,18 @@ jobs:
        lcov --list coverage.info
        bash <(curl -s https://codecov.io/bash) -f coverage.info || echo 'Codecov error'

-  build_macos:
+  tests_macos:

    strategy:
-      fail-fast: false
      matrix:
        os:
+          - macos-12
          - macos-11
-          - macos-10.15
        config:
-          - { name: "cmake_gcc", cc: "gcc", cxx: "g++" }
-          - { name: "cmake_clang", cc: "clang", cxx: "clang++" }
+          - { name: "gcc", cc: "gcc", cxx: "g++" }
+          - { name: "clang", cc: "clang", cxx: "clang++" }

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

    steps:
@@ -107,7 +97,20 @@ jobs:
    - name: Install dependencies
      run: |
        brew update
-        brew install asciidoctor lua ruby
+        # temporary fix, see: https://github.com/actions/setup-python/issues/577
+        rm -f \
+          /usr/local/bin/2to3 \
+          /usr/local/bin/idle3 \
+          /usr/local/bin/pydoc3 \
+          /usr/local/bin/python3 \
+          /usr/local/bin/python3-config \
+          /usr/local/bin/2to3-3.11 \
+          /usr/local/bin/idle3.11 \
+          /usr/local/bin/pydoc3.11 \
+          /usr/local/bin/python3.11 \
+          /usr/local/bin/python3.11-config \
+        ;
+        brew install asciidoctor guile lua pkg-config ruby

    - name: Build
      env:
@@ -128,4 +131,41 @@ jobs:
        weechat --colors
        weechat --license
        weechat --version
-        weechat --temp-dir --run-command "/debug dirs;/debug libs" --run-command "/quit"
+        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"
@@ -11,7 +11,9 @@ Sébastien Helleu <flashcode@flashtux.org> <flashcode>
 Sébastien Helleu <flashcode@flashtux.org> <uid67137>
 Nils Görs <weechatter@arcor.de>
 Ryuunosuke Ayanokouzi <i38w7i3@yahoo.co.jp>
-Krzysztof Korościk <soltys1@gmail.com> <soltys@szluug.org> <soltys@soltys.info>
+Krzysztof Korościk <soltys@soltys.info>
+Krzysztof Korościk <soltys@soltys.info> <soltys1@gmail.com>
+Krzysztof Korościk <soltys@soltys.info> <soltys@szluug.org>
 Marco Paolone <marcopaolone@gmail.com>
 <marcopaolone@gmail.com> <marco@DrB4tch.sitecomwl601>
 <mikaela.suomalainen@outlook.com> <mkaysi@outlook.com>
@@ -1,46 +0,0 @@
-dist: bionic
-sudo: required
-language: c
-
-env:
-    - CC="gcc" CXX="g++" BUILDTOOL="cmake" BUILDARGS=""
-    - CC="gcc" CXX="g++" BUILDTOOL="cmake" BUILDARGS="-DENABLE_PYTHON2=ON"
-    # - CC="gcc" CXX="g++" BUILDTOOL="cmake" BUILDARGS="-DENABLE_CODE_COVERAGE=ON" CODECOVERAGE="1"
-    - CC="gcc" CXX="g++" BUILDTOOL="autotools" BUILDARGS=""
-    - CC="gcc" CXX="g++" BUILDTOOL="autotools" BUILDARGS="--enable-python2"
-    - CC="clang" CXX="clang++" BUILDTOOL="cmake" BUILDARGS=""
-    - CC="clang" CXX="clang++" BUILDTOOL="cmake" BUILDARGS="-DENABLE_PYTHON2=ON"
-    - CC="clang" CXX="clang++" BUILDTOOL="autotools" BUILDARGS=""
-    - CC="clang" CXX="clang++" BUILDTOOL="autotools" BUILDARGS="--enable-python2"
-
-matrix:
-    fast_finish: true
-
-before_script:
-    - echo 'APT::Install-Recommends "false";' | sudo tee -a /etc/apt/apt.conf
-    - travis_retry sudo apt-get update -qq
-    - travis_retry sudo apt-get -y install devscripts equivs python-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.2-dev libphp7.2-embed libargon2-0-dev libsodium-dev pylint3
-    - travis_retry sudo gem install asciidoctor
-    - travis_retry sudo -H pip install --ignore-installed msgcheck
-    - phpenv local system
-      # work around broken travis environment variables, see https://github.com/travis-ci/travis-ci/issues/5301
-    - unset PYTHON_CFLAGS
-
-script:
-    - ./tools/build-test.sh
-    - msgcheck po/*.po
-    - pylint3 --version
-    - pylint3 --additional-builtins=_ doc/docgen.py
-    - pylint3 tests/scripts/python/testapigen.py
-    - pylint3 tests/scripts/python/testapi.py
-    - pylint3 tests/scripts/python/unparse.py
-    - ./tools/build-debian.sh test-patches
-
-after_success:
-    - weechat --help
-    - weechat-curses --help
-    - weechat --colors
-    - weechat --license
-    - weechat --version
-    - weechat --temp-dir --run-command "/debug dirs;/debug libs" --run-command "/quit"
-    # - if [ "$CODECOVERAGE" = "1" ]; then bash <(curl -s https://codecov.io/bash) -f coverage.info || echo "Codecov error"; fi
@@ -77,8 +77,9 @@ Alphabetically:
 * Krzysztof Koroscik (soltys)
 * Kyle Fuller (kylef)
 * Kyle Sabo
-* Leonid Evdokimov
+* Latchezar Tzvetkoff
 * Lázaro A.
+* Leonid Evdokimov
 * Linus Heckemann
 * Maarten de Vries
 * Mantas Mikulėnas (grawity)
@@ -122,6 +123,7 @@ Alphabetically:
 * Rudolf Polzer (divVerent)
 * Ruslan Bekenev
 * Ryan Farley
+* Ryan Qian
 * Ryuunosuke Ayanokouzi
 * scumjr
 * Sergio Durigan Junior
@@ -155,5 +157,4 @@ Alphabetically:

 == Contact

-See https://weechat.org/files/doc/devel/weechat_user.en.html#support[user's guide]
-or https://weechat.org/about/support
+See the https://weechat.org/about/support/[support page].
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net>
 # Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
 #
@@ -105,7 +105,6 @@ option(ENABLE_SCRIPT        "Enable Script plugin (script manager)"       ON)
 option(ENABLE_SCRIPTS       "Enable script plugins (perl, python, ...)"   ON)
 option(ENABLE_PERL          "Enable Perl scripting language"              ON)
 option(ENABLE_PYTHON        "Enable Python scripting language"            ON)
-option(ENABLE_PYTHON2       "Use Python 2 instead of Python 3"            OFF)
 option(ENABLE_RUBY          "Enable Ruby scripting language"              ON)
 option(ENABLE_LUA           "Enable Lua scripting language"               ON)
 option(ENABLE_TCL           "Enable Tcl scripting language"               ON)
@@ -151,6 +150,8 @@ endif()

 add_definitions(-DHAVE_CONFIG_H)

+include(FindPkgConfig)
+
 include(CheckIncludeFiles)
 include(CheckFunctionExists)
 include(CheckSymbolExists)
@@ -196,7 +197,9 @@ list(APPEND EXTRA_LIBS gnutls)

 # Check for zlib
 find_package(ZLIB REQUIRED)
-add_definitions(-DHAVE_ZLIB)
+
+# Check for zstd
+pkg_check_modules(LIBZSTD REQUIRED libzstd)

 # Check for iconv
 find_package(Iconv)
@@ -238,13 +241,16 @@ if(ENABLE_TESTS)
  else()
    message(SEND_ERROR "CppUTest not found")
  endif()
+else()
+  enable_testing()
+  add_test(NAME notests COMMAND true)
 endif()

 configure_file(config.h.cmake config.h @ONLY)

 # set the git version in "config-git.h"
 add_custom_target(version_git ALL
-  COMMAND "${CMAKE_CURRENT_SOURCE_DIR}/tools/git-version.sh" "${CMAKE_CURRENT_SOURCE_DIR}" "${VERSION}" "config-git.h"
+  COMMAND "${CMAKE_CURRENT_SOURCE_DIR}/tools/set_git_version.sh" "${CMAKE_CURRENT_SOURCE_DIR}" "${VERSION}" "config-git.h"
  WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
 )

@@ -29,8 +29,8 @@ please include:
  _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 Wheezy,
-  FreeBSD 10.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...).
+* Your *operating system*: its name and version (examples: Linux Debian Bullseye,
+  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
@@ -38,8 +38,7 @@ please include:
  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/files/doc/devel/weechat_user.en.html#report_crashes[User's guide]
-  for more info).
+  https://weechat.org/doc/user/#report_crashes[User's guide] for more info).
 * The *actual result*.
 * The *expected result*: the correct result you are expecting.

@@ -69,14 +68,14 @@ 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/files/doc/devel/weechat_dev.en.html#translations[translations]
+https://weechat.org/doc/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://weechat.org/dev/[roadmap] or
 https://github.com/weechat/weechat/milestones[milestones] on GitHub.

 Pull requests on GitHub are welcome for minor new features.
@@ -85,6 +84,6 @@ 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/files/doc/devel/weechat_dev.en.html#coding_rules[coding rules]
+https://weechat.org/doc/dev/#coding_rules[coding rules]
 in Developer's guide, which contains info about styles used, naming convention
 and other useful info.
@@ -1,80 +0,0 @@
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
-# Copyright (C) 2006-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/>.
-#
-
-# This target will update file config-git.h with output of command "git describe"
-# (if needed, and only for a devel/rc version).
-BUILT_SOURCES = build-config-git.h
-build-config-git.h:
-	-$(abs_top_srcdir)/tools/git-version.sh "$(abs_top_srcdir)" "$(VERSION)" config-git.h
-
-if TESTS
-tests_dir = tests
-endif
-
-SUBDIRS = icons po doc intl src $(tests_dir)
-
-EXTRA_DIST = AUTHORS.adoc \
-             ChangeLog.adoc \
-             Contributing.adoc \
-             README.adoc \
-             ReleaseNotes.adoc \
-             CMakeLists.txt \
-             config.rpath \
-             config.h.cmake \
-             cmake/CMakeParseArguments.cmake \
-             cmake/FindAsciidoctor.cmake \
-             cmake/FindAspell.cmake \
-             cmake/FindCppUTest.cmake \
-             cmake/FindENCHANT.cmake \
-             cmake/FindGCRYPT.cmake \
-             cmake/FindGettext.cmake \
-             cmake/FindGnuTLS.cmake \
-             cmake/FindGuile.cmake \
-             cmake/FindIconv.cmake \
-             cmake/FindLua.cmake \
-             cmake/FindNcurses.cmake \
-             cmake/FindPerl.cmake \
-             cmake/FindPkgConfig.cmake \
-             cmake/FindPython.cmake \
-             cmake/FindRuby.cmake \
-             cmake/FindV8.cmake \
-             cmake/FindZLIB.cmake \
-             cmake/cmake_uninstall.cmake.in \
-             po/CMakeLists.txt \
-             po/srcfiles.cmake \
-             tools/build-test.sh \
-             tools/git-version.sh \
-             tools/makedist.sh \
-             version.sh \
-             weechat.desktop \
-             weechat.pc.in \
-             weechat.cygport.in
-
-ACLOCAL_AMFLAGS = -I m4
-
-pkgconfigdir = $(libdir)/pkgconfig
-pkgconfig_DATA = weechat.pc
-
-desktopdir = $(datadir)/applications
-desktop_DATA = weechat.desktop
-
-clean-local:
-	$(RM) config-git.h
@@ -23,13 +23,13 @@ Homepage: https://weechat.org/

 == Features

-* *Modular chat client*: WeeChat has a lightweight core and optional https://weechat.org/files/doc/stable/weechat_user.en.html#plugins[plugins]. All plugins (including https://weechat.org/files/doc/stable/weechat_user.en.html#irc_plugin[IRC]) are independent and can be unloaded.
+* *Modular chat client*: WeeChat has a lightweight core and optional https://weechat.org/doc/user/#plugins[plugins]. All plugins (including https://weechat.org/doc/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://tools.ietf.org/html/rfc1459[1459], https://tools.ietf.org/html/rfc2810[2810], https://tools.ietf.org/html/rfc2811[2811], https://tools.ietf.org/html/rfc2812[2812], and https://tools.ietf.org/html/rfc2813[2813].
 * *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/[documentation], which is https://weechat.org/files/doc/stable/weechat_dev.en.html#translations[translated] into several languages.
+* *Fully documented*: there is comprehensive https://weechat.org/doc/[documentation], which is https://weechat.org/doc/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].

@@ -39,15 +39,13 @@ On WeeChat's website you can find https://weechat.org/about/screenshots/[more sc

 == Installation

-WeeChat can be installed using your favorite package manager (recommended)
-or by compiling it yourself.
+WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.

-For detailed instructions, please check the
-https://weechat.org/files/doc/stable/weechat_user.en.html#install[WeeChat user's guide].
+For detailed instructions, please check the https://weechat.org/doc/user/#install[WeeChat user's guide].

 == Copyright

-Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>

 This file is part of WeeChat, the extensible chat client.

@@ -1,69 +0,0 @@
-#!/bin/sh
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
-# Copyright (C) 2005-2006 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/>.
-#
-
-###
-### common stuff
-###
-
-DIR=$(cd "$(dirname "$0")" || exit 1; pwd)
-cd "$DIR" || exit 1
-
-AUTOGEN_LOG=autogen.log
-
-err ()
-{
-    echo "-------"
-    echo "Error :"
-    echo "---8<-----------------------------------"
-    cat "$AUTOGEN_LOG"
-    echo "----------------------------------->8---"
-    exit 1
-}
-
-run ()
-{
-    printf "Running \"%s\"..." "$@"
-    if eval "$@" >"$AUTOGEN_LOG" 2>&1 ; then
-        echo " OK"
-    else
-        echo " FAILED"
-        err
-    fi
-}
-
-# remove autotools stuff
-run "rm -f config.h.in"
-run "rm -f aclocal.m4 configure config.log config.status"
-run "rm -rf autom4te*.cache"
-
-# remove libtool stuff
-run "rm -f libtool"
-
-# remove gettext stuff
-run "rm -f ABOUT-NLS"
-run "rm -rf intl"
-
-# execute autoreconf cmds
-run "autoreconf -vi"
-
-# ending
-rm -f "$AUTOGEN_LOG"
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2014-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2014-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -27,11 +27,11 @@ else()
  find_path(ENCHANT_INCLUDE_DIR
    NAMES enchant++.h
    HINTS ${PC_ENCHANT_INCLUDEDIR} ${PC_ENCHANT_INCLUDE_DIRS}
-    PATH_SUFFIXES enchant
+    PATH_SUFFIXES enchant-2 enchant
  )

  find_library(ENCHANT_LIBRARIES
-    NAMES enchant
+    NAMES enchant-2 enchant
    HINTS ${PC_ENCHANT_LIBDIR}
    ${PC_ENCHANT_LIBRARY_DIRS}
  )
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net>
 # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
 #
 # This file is part of WeeChat, the extensible chat client.
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2011-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2011-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,6 +1,6 @@
 #
 # Copyright (C) 2017 Adam Saponara <as@php.net>
-# Copyright (C) 2017-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2017-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -29,6 +29,7 @@ endif()

 if(NOT PHP_FOUND)
  find_program(PHP_CONFIG_EXECUTABLE NAMES
+    php-config8.2 php-config82
    php-config8.1 php-config81
    php-config8.0 php-config80
    php-config8
@@ -47,7 +48,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.1 php8.0 php8 php7.4 php7.3 php7.2 php7.1 php7.0 php7 php
+        NAMES php8.2 php8.1 php8.0 php8 php7.4 php7.3 php7.2 php7.1 php7.0 php7 php
        HINTS ${PHP_LIB_PREFIX} ${PHP_LIB_PREFIX}/lib ${PHP_LIB_PREFIX}/lib64
      )
      if(PHP_LIB)
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net>
 #
 # This file is part of WeeChat, the extensible chat client.
@@ -28,13 +28,7 @@
 #  PYTHON_LIBRARIES = path to where libpython.so* can be found
 #  PYTHON_LDFLAGS = python compiler options for linking

-include(FindPkgConfig)
-
-if(ENABLE_PYTHON2)
-  pkg_check_modules(PYTHON python2 IMPORTED_TARGET GLOBAL)
-else()
-  pkg_check_modules(PYTHON python3-embed IMPORTED_TARGET GLOBAL)
-  if(NOT PYTHON_FOUND)
-    pkg_check_modules(PYTHON python3 IMPORTED_TARGET GLOBAL)
-  endif()
+pkg_check_modules(PYTHON python3-embed IMPORTED_TARGET GLOBAL)
+if(NOT PYTHON_FOUND)
+  pkg_check_modules(PYTHON python3 IMPORTED_TARGET GLOBAL)
 endif()
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -37,7 +37,7 @@ if(PKG_CONFIG_FOUND)
    # 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.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)
+  pkg_search_module(RUBY 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")
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2015-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2015-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -4,6 +4,7 @@ Priority: optional
 Maintainer: Sébastien Helleu <flashcode@flashtux.org>
 Build-Depends:
    asciidoctor (>= 1.5.4),
+    ruby-pygments.rb,
    debhelper (>= 12),
    cmake, pkg-config,
    libncursesw5-dev,
@@ -13,12 +14,13 @@ Build-Depends:
    libaspell-dev,
    liblua5.3-dev,
    tcl8.6-dev,
-    guile-2.2-dev,
-    php-dev, libphp-embed, libargon2-0-dev, libsodium-dev,
+    guile-3.0-dev,
+    php-dev, libphp-embed, libargon2-dev, libsodium-dev,
    libxml2-dev,
    libcurl4-gnutls-dev,
    libgcrypt20-dev,
    libgnutls28-dev,
+    libzstd-dev,
    zlib1g-dev
 Standards-Version: 4.6.0.1
 Homepage: https://weechat.org/
@@ -4,10 +4,8 @@ export DEB_BUILD_MAINT_OPTIONS=hardening=+all

 BUILDDIR = builddir

-$(BUILDDIR)/Makefile:
-	mkdir -p $(BUILDDIR)
-	cd $(BUILDDIR) && \
-	cmake .. \
+override_dh_auto_configure:
+	dh_auto_configure --buildsystem=cmake -- \
 		-DCMAKE_INSTALL_PREFIX:FILEPATH=/usr \
 		-DLIBDIR=/usr/lib/${DEB_HOST_MULTIARCH} \
 		-DENABLE_DOC:BOOL=ON \
@@ -18,16 +16,8 @@ $(BUILDDIR)/Makefile:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON

-override_dh_auto_configure:
-	# the package also has autotools buildsys and
-	# debhelper try to use it but that's not needed
-	echo
-
-override_dh_auto_build: $(BUILDDIR)/Makefile
-	dh_auto_build
-
 override_dh_installchangelogs:
 	dh_installchangelogs ChangeLog.adoc

 %:
-	dh $@ --builddirectory=$(BUILDDIR) --without autoreconf
+	dh $@ --builddirectory=$(BUILDDIR)
@@ -1,3 +1,54 @@
+weechat (3.7.1-1) unstable; urgency=medium
+
+  * New upstream release
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Sat, 22 Oct 2022 12:55:10 +0000
+
+weechat (3.7-1) unstable; urgency=medium
+
+  * New upstream release
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Tue, 18 Oct 2022 12:44:29 +0000
+
+weechat (3.6-1) unstable; urgency=medium
+
+  * New upstream release
+  * Bump Standards-Version to 4.6.1.0
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Sat, 23 Jul 2022 09:56:24 +0000
+
+weechat (3.5-1) unstable; urgency=medium
+
+  * New upstream release
+  * Add build dependency on libzstd-dev
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Thu, 31 Mar 2022 11:36:01 +0000
+
+weechat (3.4.1-1) unstable; urgency=medium
+
+  * New upstream release
+    - Fix a possible man-in-the-middle attack in TLS connection to servers
+  * Update build dependency from libargon2-0-dev to libargon2-dev
+    (libargon2-0-dev is now virtual package) (Closes: #1005703)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Tue, 22 Mar 2022 05:55:14 +0000
+
+weechat (3.4-2) unstable; urgency=medium
+
+  * Remove build dependency on ruby-pygments.rb (no longer required)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Sat, 08 Jan 2022 06:00:17 +0000
+
+weechat (3.4-1) unstable; urgency=medium
+
+  * New upstream release (Closes: #1001654, #1001245)
+  * Remove tester's guide from weechat-doc (according to upstream changes)
+  * Refresh ASCII Doctor options patch
+  * Update lintian override on weechat-plugins
+  * Update copyright (new year)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Fri, 07 Jan 2022 23:03:49 +0000
+
 weechat (3.3-1) unstable; urgency=medium

  * New upstream release
@@ -4,6 +4,7 @@ Priority: optional
 Maintainer: Emmanuel Bouthenot <kolter@debian.org>
 Build-Depends:
    asciidoctor (>= 1.5.4),
+    ruby-pygments.rb,
    debhelper (>= 12),
    cmake, pkg-config,
    libncursesw5-dev,
@@ -13,14 +14,15 @@ Build-Depends:
    libaspell-dev,
    liblua5.3-dev,
    tcl8.6-dev,
-    guile-2.2-dev,
-    php-dev, libphp-embed, libargon2-0-dev, libsodium-dev,
+    guile-3.0-dev,
+    php-dev, libphp-embed, libargon2-dev, libsodium-dev,
    libxml2-dev,
    libcurl4-gnutls-dev,
    libgcrypt20-dev,
    libgnutls28-dev,
+    libzstd-dev,
    zlib1g-dev
-Standards-Version: 4.6.0.1
+Standards-Version: 4.6.1.0
 Homepage: https://weechat.org/
 Vcs-Git: https://salsa.debian.org/kolter/weechat.git
 Vcs-Browser: https://salsa.debian.org/kolter/weechat
@@ -4,7 +4,7 @@ Upstream-Contact: Sébastien Helleu <flashcode@flashtux.org>
 Source: https://weechat.org/

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

 Files: src/core/wee-command.c
@@ -4,10 +4,8 @@ export DEB_BUILD_MAINT_OPTIONS=hardening=+all

 BUILDDIR = builddir

-$(BUILDDIR)/Makefile:
-	mkdir -p $(BUILDDIR)
-	cd $(BUILDDIR) && \
-	cmake .. \
+override_dh_auto_configure:
+	dh_auto_configure --buildsystem=cmake -- \
 		-DCMAKE_INSTALL_PREFIX:FILEPATH=/usr \
 		-DLIBDIR=/usr/lib/${DEB_HOST_MULTIARCH} \
 		-DENABLE_DOC:BOOL=ON \
@@ -18,16 +16,8 @@ $(BUILDDIR)/Makefile:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON

-override_dh_auto_configure:
-	# the package also has autotools buildsys and
-	# debhelper try to use it but that's not needed
-	echo
-
-override_dh_auto_build: $(BUILDDIR)/Makefile
-	dh_auto_build
-
 override_dh_installchangelogs:
 	dh_installchangelogs ChangeLog.adoc

 %:
-	dh $@ --builddirectory=$(BUILDDIR) --without autoreconf
+	dh $@ --builddirectory=$(BUILDDIR)
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 # Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
 #
 # This file is part of WeeChat, the extensible chat client.
@@ -1,28 +0,0 @@
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2006 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/>.
-#
-
-SUBDIRS = . cs de en es fr it ja pl ru sr
-
-EXTRA_DIST = docgen.py \
-             docinfo.html \
-             CMakeLists.txt
-
-uninstall-hook:
-	-rmdir $(DESTDIR)$(datadir)/doc/$(PACKAGE)
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,81 +0,0 @@
-#
-# Copyright (C) 2003-2021 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/>.
-#
-
-docdir = $(datadir)/doc/$(PACKAGE)
-
-EXTRA_DIST = CMakeLists.txt \
-             docinfo.html \
-             weechat.1.cs.adoc \
-             weechat-headless.1.cs.adoc \
-             weechat_quickstart.cs.adoc \
-             includes/cmdline_options.cs.adoc \
-             includes/man.cs.adoc
-
-if MAN
-  man_targets = weechat.1 \
-                weechat-headless.1
-  man_install = install-man
-  man_uninstall = uninstall-man
-endif
-if DOC
-  doc_targets = weechat_quickstart.cs.html
-  doc_install = install-doc
-  doc_uninstall = uninstall-doc
-endif
-all-local: $(man_targets) $(doc_targets)
-
-# man pages
-weechat.1: weechat.1.cs.adoc includes/cmdline_options.cs.adoc includes/man.cs.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat.1 $(abs_top_srcdir)/doc/cs/weechat.1.cs.adoc
-weechat-headless.1: weechat-headless.1.cs.adoc includes/cmdline_options.cs.adoc includes/man.cs.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat-headless.1 $(abs_top_srcdir)/doc/cs/weechat-headless.1.cs.adoc
-
-# quickstart
-weechat_quickstart.cs.html: weechat_quickstart.cs.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.cs.html $(abs_top_srcdir)/doc/cs/weechat_quickstart.cs.adoc
-
-# install man/docs
-
-install-data-hook: $(man_install) $(doc_install)
-
-install-man:
-	$(mkinstalldirs) $(DESTDIR)$(mandir)/cs/man1/
-	$(INSTALL_DATA) *.1 $(DESTDIR)$(mandir)/cs/man1/
-
-install-doc:
-	$(mkinstalldirs) $(DESTDIR)$(docdir)/
-	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
-
-# uninstall man/docs
-
-uninstall-hook: $(man_uninstall) $(doc_uninstall)
-
-uninstall-man:
-	$(RM) $(DESTDIR)$(mandir)/cs/man1/weechat.1
-	$(RM) $(DESTDIR)$(mandir)/cs/man1/weechat-headless.1
-	-rmdir $(DESTDIR)$(mandir)/cs/man1
-
-uninstall-doc:
-	$(RM) $(DESTDIR)$(docdir)/*.cs.html
-	-rmdir $(DESTDIR)$(docdir)
-
-# clean
-
-clean-local:
-	-$(RM) weechat.1 weechat-headless.1 weechat_*.html
@@ -1,6 +1,6 @@
 // tag::plugin_options[]
 Pro kompletní dokumentaci nastavení pluginů a jejich volby podívejte se na
-https://weechat.org/doc[WeeChat user's guide].
+https://weechat.org/doc/[WeeChat user's guide].

 S irc pluginem se můžete doččasně připojit na server s URL jako:

@@ -99,7 +99,7 @@ $HOME/.local/share/weechat/weechat.log::
 WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
 souboru AUTHORS.adoc).

-Copyright (C) 2003-2021 {author}
+Copyright (C) 2003-2023 {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
@@ -67,4 +67,4 @@ include::includes/man.cs.adoc[tag=copyright]

 == PODPORA / HLÁŠENÍ CHYB

-Pro pomoc nebo hlášení chyb https://weechat.org/about/support
+Pro pomoc nebo hlášení chyb https://weechat.org/about/support/
@@ -62,4 +62,4 @@ include::includes/man.cs.adoc[tag=copyright]

 == PODPORA / HLÁŠENÍ CHYB

-Pro pomoc nebo hlášení chyb https://weechat.org/about/support
+Pro pomoc nebo hlášení chyb https://weechat.org/about/support/
@@ -208,10 +208,16 @@ K automatickému připojení některých kanálů při připojování k serveru:
 ----

 // TRANSLATION MISSING
-[TIP]
-You can complete name and value of options with the kbd:[Tab] key
-and kbd:[Shift+Tab] for a partial completion (useful for long words like
-the name of option).
+The `/autojoin` command lets you configure the _autojoin_ option easily
+(see `/help autojoin`).
+
+// TRANSLATION MISSING
+You can also configure WeeChat to automatically update the _autojoin_ option
+when you join or leave channels:
+
+----
+/set irc.server_default.autojoin_dynamic on
+----

 K smazání hodnoty serverové volby a k použití výchozí hodnoty místo ní,
 například k požití výchozích přezdívek (irc.server_default.nicks):
@@ -227,6 +233,12 @@ název volby):
 /set irc.server.libera.xxx value
 ----

+// TRANSLATION MISSING
+[TIP]
+You can complete name and value of options with the kbd:[Tab] key
+and kbd:[Shift+Tab] for a partial completion (useful for long words like
+the name of option).
+
 [[connect_to_irc_server]]
 == Připojení k IRC serveru

@@ -389,14 +401,16 @@ například:

 Zkuste `/help script` pro více informací.

-
-A seznam skriptů je dostupný v WeeChatu s příkazem `/script` nebo na této
-adrese https://weechat.org/scripts
+// TRANSLATION MISSING
+A list of scripts is available in WeeChat with `/script` or on
+https://weechat.org/scripts/[this page ^↗^,window=_blank].

 [[more_doc]]
 == Další dokumentace

-Nyní jste schopni používat WeeChat a můžete si přečíst FAQ/dokumentaci pro
-jakékoliv další otázky: https://weechat.org/doc
+// TRANSLATION MISSING
+You can now use WeeChat and read
+https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+for any other questions.

 Ať máte radost z použití WeeChatu!
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,111 +0,0 @@
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2006 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/>.
-#
-
-docdir = $(datadir)/doc/$(PACKAGE)
-
-EXTRA_DIST = CMakeLists.txt \
-             docinfo.html \
-             weechat.1.de.adoc \
-             weechat-headless.1.de.adoc \
-             weechat_user.de.adoc \
-             weechat_scripting.de.adoc \
-             weechat_faq.de.adoc \
-             weechat_quickstart.de.adoc \
-             includes/autogen_api_completions.de.adoc \
-             includes/autogen_api_hdata.de.adoc \
-             includes/autogen_api_infolists.de.adoc \
-             includes/autogen_api_infos.de.adoc \
-             includes/autogen_api_infos_hashtable.de.adoc \
-             includes/autogen_api_plugins_priority.de.adoc \
-             includes/autogen_api_url_options.de.adoc \
-             includes/autogen_user_commands.de.adoc \
-             includes/autogen_user_default_aliases.de.adoc \
-             includes/autogen_user_irc_colors.de.adoc \
-             includes/autogen_user_options.de.adoc \
-             includes/cmdline_options.de.adoc \
-             includes/man.de.adoc
-
-if MAN
-  man_targets = weechat.1 \
-                weechat-headless.1
-  man_install = install-man
-  man_uninstall = uninstall-man
-endif
-if DOC
-  doc_targets = weechat_user.de.html \
-		weechat_scripting.de.html \
-		weechat_faq.de.html \
-		weechat_quickstart.de.html
-  doc_install = install-doc
-  doc_uninstall = uninstall-doc
-endif
-all-local: $(man_targets) $(doc_targets)
-
-# man pages
-weechat.1: weechat.1.de.adoc includes/cmdline_options.de.adoc includes/man.de.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat.1 $(abs_top_srcdir)/doc/de/weechat.1.de.adoc
-weechat-headless.1: weechat-headless.1.de.adoc includes/cmdline_options.de.adoc includes/man.de.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat-headless.1 $(abs_top_srcdir)/doc/de/weechat-headless.1.de.adoc
-
-# user's guide
-weechat_user.de.html: weechat_user.de.adoc includes/cmdline_options.de.adoc $(wildcard includes/autogen_user_*.adoc) $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_user.de.html $(abs_top_srcdir)/doc/de/weechat_user.de.adoc
-
-# scripting guide
-weechat_scripting.de.html: weechat_scripting.de.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_scripting.de.html $(abs_top_srcdir)/doc/de/weechat_scripting.de.adoc
-
-# FAQ
-weechat_faq.de.html: weechat_faq.de.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_faq.de.html $(abs_top_srcdir)/doc/de/weechat_faq.de.adoc
-
-# quickstart
-weechat_quickstart.de.html: weechat_quickstart.de.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.de.html $(abs_top_srcdir)/doc/de/weechat_quickstart.de.adoc
-
-# install man/docs
-
-install-data-hook: $(man_install) $(doc_install)
-
-install-man:
-	$(mkinstalldirs) $(DESTDIR)$(mandir)/de/man1/
-	$(INSTALL_DATA) *.1 $(DESTDIR)$(mandir)/de/man1/
-
-install-doc:
-	$(mkinstalldirs) $(DESTDIR)$(docdir)/
-	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
-
-# uninstall man/docs
-
-uninstall-hook: $(man_uninstall) $(doc_uninstall)
-
-uninstall-man:
-	$(RM) $(DESTDIR)$(mandir)/de/man1/weechat.1
-	$(RM) $(DESTDIR)$(mandir)/de/man1/weechat-headless.1
-	-rmdir $(DESTDIR)$(mandir)/de/man1
-
-uninstall-doc:
-	$(RM) $(DESTDIR)$(docdir)/*.de.html
-	-rmdir $(DESTDIR)$(docdir)
-
-# clean
-
-clean-local:
-	-$(RM) weechat.1 weechat-headless.1 weechat_*.html
@@ -26,6 +26,8 @@

 | irc | irc_channels | Kanäle auf allen IRC Servern

+| irc | irc_channels_autojoin | Kanäle, die automatisch auf dem aktuellen Server betreten werden (Option "autojoin")
+
 | irc | irc_ignores_numbers | Anzahl für festgelegte Ignorierungen

 | irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Kanal; benötigtes Argument: modelist mode
@@ -92,6 +94,8 @@

 | tcl | tcl_script | Liste der Skripten

+| trigger | trigger_add_arguments | Argumente für den Befehl, der einen Trigger hinzufügt: Name des Triggers, Hooks, Hook-Argumente, Hook-Bedingungen, Hook-Regex, Hook-Befehl, Hook-Rückgabecode, nachfolgende Aktionen
+
 | trigger | trigger_hook_arguments | Standardargumente für einen Hook

 | trigger | trigger_hook_command | Standardbefehl für einen Hook
@@ -146,6 +150,14 @@

 | weechat | cursor_areas | Bereiche in denen der Cursor frei bewegt werden kann ("chat" oder Name einer Bar)

+| weechat | custom_bar_item_add_arguments | Argumente für den Befehl, der ein benutzerdefiniertes Bar-Item hinzufügt: Elementname, Bedingungen,Inhalt
+
+| weechat | custom_bar_item_conditions | Bedingungen für benutzerdefinierte Bar-Items
+
+| weechat | custom_bar_item_contents | Inhalte für benutzerdefinierte Bar-Items
+
+| weechat | custom_bar_items_names | Namen der benutzerdefinierten Bar-Items
+
 | weechat | env_value | Wert einer Umgebungsvariable

 | weechat | env_vars | Umgebungsvariablen
@@ -0,0 +1,36 @@
+//
+// This file is auto-generated by script docgen.py.
+// DO NOT EDIT BY HAND!
+//
+
+// tag::config_priority[]
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rang | Datei | Priorität
+| 1 | sec.conf | 120000
+| 2 | weechat.conf | 110000
+| 3 | plugins.conf | 100000
+| 4 | charset.conf | 16000
+| 5 | logger.conf | 15000
+| 6 | exec.conf | 14000
+| 7 | trigger.conf | 13000
+| 8 | spell.conf | 12000
+| 9 | alias.conf | 11000
+| 10 | buflist.conf | 10000
+| 11 | fifo.conf | 9000
+| 12 | typing.conf | 8000
+| 13 | xfer.conf | 7000
+| 14 | irc.conf | 6000
+| 15 | relay.conf | 5000
+| 16 | guile.conf | 4070
+| 17 | javascript.conf | 4060
+| 18 | lua.conf | 4050
+| 19 | perl.conf | 4040
+| 20 | php.conf | 4030
+| 21 | python.conf | 4020
+| 22 | ruby.conf | 4010
+| 23 | tcl.conf | 4000
+| 24 | script.conf | 3000
+| 25 | fset.conf | 2000
+|===
+// end::config_priority[]
@@ -241,6 +241,8 @@ _sasl_scram_salted_pwd_size_   (integer) +
 _sasl_scram_auth_message_   (string) +
 _sasl_temp_username_   (string) +
 _sasl_temp_password_   (string) +
+_authentication_method_   (integer) +
+_sasl_mechanism_used_   (integer) +
 _is_connected_   (integer) +
 _ssl_connected_   (integer) +
 _disconnected_   (integer) +
@@ -278,7 +280,7 @@ _typing_allowed_   (integer) +
 _reconnect_delay_   (integer) +
 _reconnect_start_   (time) +
 _command_time_   (time) +
-_reconnect_join_   (integer) +
+_autojoin_done_   (integer) +
 _disable_autojoin_   (integer) +
 _is_away_   (integer) +
 _away_message_   (string) +
@@ -582,6 +584,7 @@ _title_   (string) +
 _own_lines_   (pointer, hdata: "lines") +
 _mixed_lines_   (pointer, hdata: "lines") +
 _lines_   (pointer, hdata: "lines") +
+_next_line_id_   (integer) +
 _time_for_each_line_   (integer) +
 _chat_refresh_needed_   (integer) +
 _nicklist_   (integer) +
@@ -631,6 +634,8 @@ _text_search_input_   (string) +
 _highlight_words_   (string) +
 _highlight_regex_   (string) +
 _highlight_regex_compiled_   (pointer) +
+_highlight_disable_regex_   (string) +
+_highlight_disable_regex_compiled_   (pointer) +
 _highlight_tags_restrict_   (string) +
 _highlight_tags_restrict_count_   (integer) +
 _highlight_tags_restrict_array_   (pointer, array_size: "highlight_tags_restrict_count") +
@@ -704,6 +709,7 @@ _count_   (integer) +
 _last_config_file_ +

 | _plugin_   (pointer, hdata: "plugin") +
+_priority_   (integer) +
 _name_   (string) +
 _filename_   (string) +
 _file_   (pointer) +
@@ -921,6 +927,7 @@ _next_line_   (pointer, hdata: "line") +
 | Struktur mit einzeiligen Daten
 | -
 | _buffer_   (pointer, hdata: "buffer") +
+_id_   (integer) +
 _y_   (integer) +
 _date_   (time) +
 _date_printed_   (time) +
@@ -60,8 +60,6 @@

 | php | php_version | Version des verwendeten Interpreters | -

-| python | python2_bin | Pfad zum Python 2.x Interpreter (*veraltet*, seit WeeChat Version 2.6 müssen Skripten Python3 verwenden) | -
-
 | python | python_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll

 | python | python_interpreter | Name des verwendeten Interpreters | -
@@ -128,6 +126,8 @@

 | weechat | uptime | Laufzeit von WeeChat (Format: "days:hh:mm:ss") | "days" (Anzahl der Tage) oder "seconds" (Anzahl der Sekunden) (optional)

+| weechat | uptime_current | WeeChat-Betriebszeit für den aktuellen Prozess (Upgrades mit /upgrade Befehlwerden ignoriert) (Format: "Tage:hh:mm:ss") | "days" (Anzahl der Tage) oder "seconds" (Anzahl der Sekunden) (optional)
+
 | weechat | version | WeeChat-Version | -

 | weechat | version_git | WeeChat Git Version (Ausgabe des Befehls "git describe", ausschließlich für eine Entwicklerversion. Eine stabile Version gibt keine Information zurück) | -
@@ -4,26 +4,30 @@
 //

 // tag::plugins_priority[]
-. charset (16000)
-. logger (15000)
-. exec (14000)
-. trigger (13000)
-. spell (12000)
-. alias (11000)
-. buflist (10000)
-. fifo (9000)
-. typing (8000)
-. xfer (7000)
-. irc (6000)
-. relay (5000)
-. guile (4007)
-. javascript (4006)
-. lua (4005)
-. perl (4004)
-. php (4003)
-. python (4002)
-. ruby (4001)
-. tcl (4000)
-. script (3000)
-. fset (2000)
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rang | Erweiterung | Priorität
+| 1 | charset | 16000
+| 2 | logger | 15000
+| 3 | exec | 14000
+| 4 | trigger | 13000
+| 5 | spell | 12000
+| 6 | alias | 11000
+| 7 | buflist | 10000
+| 8 | fifo | 9000
+| 9 | typing | 8000
+| 10 | xfer | 7000
+| 11 | irc | 6000
+| 12 | relay | 5000
+| 13 | guile | 4070
+| 14 | javascript | 4060
+| 15 | lua | 4050
+| 16 | perl | 4040
+| 17 | php | 4030
+| 18 | python | 4020
+| 19 | ruby | 4010
+| 20 | tcl | 4000
+| 21 | script | 3000
+| 22 | fset | 2000
+|===
 // end::plugins_priority[]
@@ -6,7 +6,7 @@
 // tag::url_options[]
 [width="100%",cols="2,^1,7",options="header"]
 |===
-| Einstellung | Type ^(1)^ | Konstanten ^(2)^
+| Einstellung | Type ^(1)^ | Konstanten ^(2)^

 | verbose | long |

@@ -48,10 +48,6 @@

 | address_scope | long |

-| protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
-| redir_protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
 | noproxy | string |

 | socks5_gssapi_nec | long |
@@ -82,15 +78,19 @@

 | doh_url | string |

+| protocols_str | string |
+
+| redir_protocols_str | string |
+
 | netrc | long | ignored, optional, required

 | userpwd | string |

 | proxyuserpwd | string |

-| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

-| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

 | netrc_file | string |

@@ -108,6 +108,8 @@

 | tlsauth_password | string |

+| sasl_authzid | string |
+
 | sasl_ir | long |

 | xoauth2_bearer | string |
@@ -120,8 +122,6 @@

 | followlocation | long |

-| put | long |
-
 | post | long |

 | postfields | string |
@@ -144,7 +144,7 @@

 | cookiejar | string |

-| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge
+| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge, 3

 | cookiesession | long |

@@ -182,12 +182,20 @@

 | request_target | string |

+| http09_allowed | long |
+
+| hsts | string |
+
+| hsts_ctrl | mask | enable, readonlyfile
+
 | mail_from | string |

 | mail_rcpt | list |

 | mail_auth | string |

+| mail_rcpt_alllowfails | long |
+
 | tftp_blksize | long |

 | tftp_no_options | long |
@@ -206,8 +214,6 @@

 | ftp_create_missing_dirs | long |

-| ftp_response_timeout | long |
-
 | ftpsslauth | long | default, ssl, tls

 | ftp_account | string |
@@ -238,6 +244,8 @@

 | rtsp_server_cseq | long |

+| aws_sigv4 | string |
+
 | crlf | long |

 | range | string |
@@ -274,6 +282,8 @@

 | upload_buffersize | long |

+| mime_options | mask | formescape
+
 | timeout | long |

 | low_speed_limit | long |
@@ -298,6 +308,8 @@

 | connecttimeout_ms | long |

+| maxage_conn | long |
+
 | maxconnects | long |

 | use_ssl | long | none, try, control, all
@@ -322,6 +334,8 @@

 | upkeep_interval_ms | long |

+| maxlifetime_conn | long |
+
 | sslcert | string |

 | sslversion | long | default, tlsv1, sslv2, sslv3, tlsv1_0, tlsv1_1, tlsv1_2, tlsv1_3, max_default, max_none, max_tlsv1_0, max_tlsv1_1, max_tlsv1_2, max_tlsv1_3
@@ -330,10 +344,6 @@

 | cainfo | string |

-| random_file | string |
-
-| egdsocket | string |
-
 | ssl_verifyhost | long |

 | ssl_cipher_list | string |
@@ -364,12 +374,10 @@

 | gssapi_delegation | long | none, policy_flag, flag

-| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | ssl_enable_alpn | long |

-| ssl_enable_npn | long |
-
 | pinnedpublickey | string |

 | ssl_verifystatus | long |
@@ -398,7 +406,7 @@

 | proxy_ssl_cipher_list | list |

-| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | proxy_ssl_verifyhost | long |

@@ -414,6 +422,18 @@

 | proxy_tls13_ciphers | list |

+| proxy_issuercert | string |
+
+| ssl_ec_curves | string |
+
+| doh_ssl_verifyhost | long |
+
+| doh_ssl_verifypeer | long |
+
+| doh_ssl_verifystatus | long |
+
+| ca_cache_timeout | long |
+
 | ssh_auth_types | mask | none, policy_flag, flag

 | ssh_public_keyfile | string |
@@ -426,11 +446,17 @@

 | ssh_compression | long |

+| ssh_host_public_key_sha256 | string |
+
+| telnetoptions | list |
+
+| ws_options | mask | binary, close, cont, offset, ping, pong, raw_mode, text
+
 | new_file_perms | long |

 | new_directory_perms | long |

-| telnetoptions | list |
+| quick_exit | long |

 |===
 // end::url_options[]
@@ -123,6 +123,39 @@ Beispiele:
    /auth user2 ${weechat_config_dir}/ecdsa2.pem
 ----

+[[command_irc_autojoin]]
+* `+autojoin+`: Konfigurieren der Serveroption "autojoin"
+
+----
+/autojoin  add [<channel1> [<channel2>...]]
+           addraw <channel1>[,<channel2>...] [<key1>[,<key2>...]]
+           del [<channel1> [<channel2>...]]
+           apply
+           join
+           sort
+
+    add: Hinzufügen des aktuellen Kanals oder einer Liste von Kanälen (mit optionalen Schlüsseln) zur autojoin-Option; Wenn Sie sich in dem Kanal befinden und der Schlüssel nicht übergeben wird, wird der Schlüssel im Kanal gelesen
+ addraw: das IRC Roh-Format wird genutzt (wie beim /join Befehl): alle Kanäle werden durch Kommata voneinander getrennt und optional werden die Schlüssel durch Kommata separiert
+    del: Löschen des aktuellen Kanals oder eine Liste von Kanälen aus der autoJoin-Option
+channel: Kanalname
+    key: Schlüssel für den Kanal
+  apply: fügt die aktuell besuchten Kanäle in der autojoin-Option hinzu
+   join: betrete die Kanäle, die in der autojoin-Option eingetragen sind
+   sort: sortiert die Kanäle alphabetisch in der autojoin Option
+
+Beispiele:
+  /autojoin add
+  /autojoin add #test
+  /autojoin add #chan1 #chan2
+  /allchan /autojoin add
+  /autojoin addraw #chan1,#chan2,#chan3 key1,key2
+  /autojoin del
+  /autojoin del #chan1
+  /autojoin apply
+  /autojoin join
+  /autojoin sort
+----
+
 [[command_irc_ban]]
 * `+ban+`: Nicknamen oder Hosts sperren/verbannen

@@ -157,8 +190,14 @@ Fähigkeiten die von WeeChat unterstützt werden: account-notify, away-notify, c
 Fähigkeiten die standardmäßig genutzt werden sollen, können mit der Option irc.server_default.capabilities gesetzt werden (oder individuell für jeden Server mit der Option irc.server.xxx.capabilities).

 Beispiele:
-   /cap
-   /cap req multi-prefix away-notify
+  zeigt unterstützte und aktivierte Funktionen an:
+    /cap
+  Fähigkeiten multi-prefix und away-notify anfordern:
+    /cap req multi-prefix away-notify
+  Fähigkeit extended-join anfordern, Fähigkeit multi-prefix entfernen:
+    /cap req extended-join -multi-prefix
+  Fähigkeit away-notify entfernen
+    /cap req -away-notify
 ----

 [[command_irc_connect]]
@@ -267,7 +306,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
          * -yes

 nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
-   *: entzieht allen Nicks im Kanal den voice-Status
+   *: entzieht allen Nicks im Kanal die Stimme
 ----

 [[command_irc_die]]
@@ -414,6 +453,16 @@ Beispiel:
 reason: Grund der Abmeldung
 ----

+[[command_irc_knock]]
+* `+knock+`: sendet eine Benachrichtigung an einen Kanal, der nur mit Einladung betreten werden kann, um eine Einladung anzufragen
+
+----
+/knock  <channel> [<message>]
+
+channel: Name des Kanals
+message: Text, welcher versendet werden soll
+----
+
 [[command_irc_links]]
 * `+links+`: alle Servernamen auflisten, die dem antwortenden Server bekannt sind

@@ -484,7 +533,7 @@ Kanal-Eigenschaften:
  i: geschlossener Kanal (Zutritt nur mit Einladung)
  t: nur Operatoren dürfen das Thema setzen
  n: keine Nachrichten von außerhalb des Kanals zulassen
-  m: moderierter Kanal (schreiben nur mit Voice)
+  m: moderierter Kanal (schreiben nur mit Stimme)
  l: maximale Anzahl an Usern im Kanal festlegen
  b: Bannmaske für zu sperrende User (in nick!ident@host-Form)
  e: legt Ausnahmemaske fest
@@ -708,6 +757,12 @@ channel: Kanalname
 target: Servername
 ----

+[[command_irc_rules]]
+* `+rules+`: Fordert die Serverregeln an
+
+----
+----
+
 [[command_irc_sajoin]]
 * `+sajoin+`: fordert einen User auf einen oder mehrere Kanäle zu betreten

@@ -961,14 +1016,14 @@ target: Servername
 ----

 [[command_irc_voice]]
-* `+voice+`: Voice an Nick(s) vergeben
+* `+voice+`: Stimme an Nick(s) vergeben

 ----
 /voice  <nick> [<nick>...]
        * -yes

 nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
-   *: vergibt an alle Nicks im Kanal den voice-Status
+   *: vergibt an alle Nicks im Kanal eine Stimme
 ----

 [[command_irc_wallchops]]
@@ -1037,11 +1092,13 @@ target: Antwort soll auf diese Suchmaske zutreffen
        add <alias> [<command>[;<command>...]]
        addcompletion <completion> <alias> [<command>[;<command>...]]
        del <alias> [<alias>...]
+        rename <alias> <new_alias>

         list: listet Alternativbefehle auf (ohne Angabe von Argumenten wird diese Liste dargestellt)
          add: fügt einen Alternativbefehl hinzu
 addcompletion: fügt einen Alternativbefehl, mit einer benutzerdefinierten Vervollständigung, hinzu
          del: entfernt einen Alternativbefehl
+       rename: ein Alias umbenennen
   completion: Vervollständigung für Alternativbefehl: standardmäßig wird die Vervollständigung auf den Zielbefehl angewendet
               Hinweis: Mit der Variablen "%%command" kann eine Vervollständigung eines vorhandenen Befehls durchgeführt werden
        alias: Name des Alternativbefehls
@@ -1062,12 +1119,27 @@ Beispiele:
    /alias add split /window splith
  Alternativbefehl "/hallo" wird angelegt um in allen Channels, außer im #weechat Channel, den Text "Hallo" auszugeben:
    /alias add hallo /allchan -exclude=#weechat hallo
+  alias "hallo" nach "Hallo" umbenennen:
+    /alias rename hello Hello
  Alternativbefehl "/forcejoin" wird angelegt um den IRC Befehl "forcejoin" mit einer Vervollständigung von /sajoin auszuführen:
    /alias addcompletion %%sajoin forcejoin /quote forcejoin
 ----
 // end::alias_commands[]

 // tag::weechat_commands[]
+[[command_weechat_allbuf]]
+* `+allbuf+`: führt einen Befehl in allen Buffern aus
+
+----
+/allbuf  <Befehl>
+
+command: Befehl der ausgeführt werden soll (oderText welcher in den Buffer gesendet werden soll, sofern dem Befehl kein '/' vorangestellt ist)
+
+Beispiele:
+  setze den ungelesen Marker für alle Buffer:
+    /allbuf /buffer set unread
+----
+
 [[command_weechat_away]]
 * `+away+`: Abwesenheitsstatus setzen oder entfernen

@@ -1144,6 +1216,8 @@ Beispiele:
         unmerge [<number>|-all]
         hide [<number>|<name>|-all [<number>|<name>...]]
         unhide [<number>|<name>|-all [<number>|<name>...]]
+         switch [-previous]
+         zoom
         renumber [<number1> [<number2> [<start>]]]
         close [<n1>[-<n2>]|<name>...]
         notify [<level>]
@@ -1152,6 +1226,7 @@ Beispiele:
         delvar <name>
         set <property> [<value>]
         get <property>
+         jump smart|last_displayed|prev_visited|next_visited
         <number>|-|+|<name>

    list: alle geöffneten Buffer werden aufgelistet (ohne Angabe von Argumente wird diese Liste standardmäßig ausgegeben)
@@ -1165,6 +1240,8 @@ Beispiele:
 unmerge: trennt Buffer wieder voneinander, falls zwei Buffer die selbe Nummer teilen
    hide: versteckt einen Buffer
  unhide: macht Buffer wieder sichtbar
+  switch: wechselt zum nächsten zusammengeführten Buffer (oder zum vorherigen Buffer mit "-previous")
+    zoom: zoomen eines zusammengeführten Buffers
 renumber: Buffer werden umnummeriert (Einstellung weechat.look.buffer_auto_renumber muss deaktiviert sein)
   close: Buffer schließen (Nummer oder Bereich ist optional)
  notify: Benachrichtigungsstufe für den aktuellen Buffer anzeigen oder einstellen. Folgende Möglichkeiten bestimmen den Grad der Benachrichtigung und ob der Buffer in der Hotlist angezeigt wird:
@@ -1178,6 +1255,11 @@ renumber: Buffer werden umnummeriert (Einstellung weechat.look.buffer_auto_renum
  delvar: löscht eine lokale Variable des aktuellen Buffers
     set: setzt eine Eigenschaft für den aktuellen Buffer
     get: zeigt eine Eigenschaft für den aktuellen Buffer an
+    jump: springt zu einem anderen Buffer:
+          smart: nächster Buffer mit Aktivität
+          last_displayed: letzter angezeigter Buffer (vor dem letzten Sprung zu einem Buffer)
+          prev_visited: zuvor besuchter Buffer
+          next_visited: zum nächsten besuchten Buffer springen
  number: wechselt von einem Buffer zu einem anderen, mögliche Optionen:
          '+': relativer Sprung um 'n'-Buffer
          '-': relativer Sprung, um 'n'-Buffer
@@ -1302,32 +1384,40 @@ Beispiele:
 ----
 /debug  list
        set <plugin> <level>
-        dump [<plugin>]
-        buffer|color|infolists|libs|certs|memory|tags|term|windows
+        dump|hooks [<plugin>]
+        buffer|certs|color|dirs|infolists|libs|memory|tags|term|windows
        mouse|cursor [verbose]
        hdata [free]
        time <command>
+        unicode <string>

     list: zeigt alle Erweiterungen mit Debuglevel an
      set: setzt den Level der Protokollierung für eine Erweiterung
   plugin: Name der Erweiterung ("core" für den WeeChat Kern)
    level: Debuglevel der Erweiterung (0 = deaktiviert Debug)
     dump: Speicherabbild in die WeeChat Protokolldatei schreiben (wie bei einem Programmabsturz)
+    hooks: zeigt die aktiven Hooks an (bei einer Erweiterung: detaillierte Informationen über Hooks werden angezeigt, die von der Erweiterung erstellt wurden)
   buffer: speichert den Bufferinhalt als hexadezimale Ausgabe in die Protokolldatei
+    certs: gibt die Anzahl geladener vertrauenswürdiger Zertifizierungsstellen aus
    color: zeigt Informationen über die aktuellen Farbpaarungen an
   cursor: schaltet den debug-Modus für den Cursor-Modus ein/aus
     dirs: Verzeichnisse werden angezeigt
    hdata: zeigt Informationen zu hdata an (mittels free werden alle hdata Informationen aus dem Speicher entfernt)
-    hooks: zeigt die aktiven Hooks an
 infolists: zeigt Information über die Infolists an
     libs: zeigt an welche externen Bibliotheken verwendet werden
-    certs: gibt die Anzahl geladener vertrauenswürdiger Zertifizierungsstellen aus
   memory: gibt Informationen über den genutzten Speicher aus
    mouse: schaltet den debug-Modus für den Maus-Modus ein/aus
     tags: zeigt für jede einzelne Zeile die dazugehörigen Schlagwörter an
     term: zeigt Informationen über das Terminal an
  windows: zeigt die Fensterstruktur an
     time: misst die Zeit um einen Befehl auszuführen oder um einen Text in den aktuellen Buffer zu senden
+  unicode: Zeigt Informationen über Unicode-Zeichen in Zeichenkette an (evaluiert, siehe /help eval)
+
+Beispiele:
+  /debug set irc 1
+  /debug mouse verbose
+  /debug time /filter toggle
+  /debug unicode ${chars:${\u26C0}-${\u26CF}}
 ----

 [[command_weechat_eval]]
@@ -1374,33 +1464,36 @@ Um einen Vergleich zwischen zwei Zeichenketten zu erzwingen, müssen die Ausdrü
  "50" > "100"  ==> 1

 Einige Variablen werden im Ausdruck mittels der Formatierung ${variable} ersetzt. Mögliche Variablen sind, nach Reihenfolge ihrer Priorität:
-  1. die Zeichenfolge selbst ohne Auswertung (Format: "raw:xxx")
-  2. eine benutzerdefinierte Variable (Format: "name")
-  3. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
-  4. eine evaluierte Bedingung (Format: "eval_cond:xxx")
-  5. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
-  6. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
-  7. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:max,suffix,string" oder "cut:+max,suffix,string")
+  - die Zeichenfolge selbst ohne Auswertung (Format: "raw:xxx")
+  - eine benutzerdefinierte Variable (Format: "name")
+  - eine evaluierte Teilzeichenkette (Format: "eval:xxx")
+  - eine evaluierte Bedingung (Format: "eval_cond:xxx")
+  - eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
+  - eine Zeichenfolge mit einer Reihe von Zeichen (Format: "chars:xxx" oder "chars:c1-c2" wobei "xxx" von folgenden Typ sein muss: "digit", "xdigit", "lower", "upper", "alpha", "alnum")
+  - eine Zeichenfolge, die in Kleinbuchstaben umgewandelt wird (Format: "lower:xxx")
+  - eine Zeichenfolge, die in Großbuchstaben umgewandelt wird (Format: "upper:xxx")
+  - Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
+  - eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:max,suffix,string" oder "cut:+max,suffix,string")
     oder maximale Anzahl an Zeichen die auf dem Bildschirm angezeigt werden sollen (Format: "cutscr:Max,Suffix,Zeichenkette oder "cutscr:+Max,Suffix,Zeichenkette")
-  8. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
-  9. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
-  10. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
-  11. Aufteilen einer Zeichenkette (Format: "split:Anzahl,Trennzeichen,Flags,xxx")
-  12. Aufteilen von Shell-Argumenten (Format: "split_shell:Anzahl,xxx")
-  13. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
-  14. zum modifizieren (Format: "modifier:name,data,string")
-  15. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
-  16. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
-  17. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
-  18. eine Umgebungsvariable (Format: "env:XXX")
-  19. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
-  20. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
-  21. eine zufällige ganze Zahl (Format: "random:min,max")
-  22. eine übersetzte Zeichenkette (Format: "translate:xxx")
-  23. eine Benutzervariable definieren (Format: "define:Name,Wert")
-  24. eine Option (Format: "file.section.option")
-  25. eine lokale Variable eines Buffers
-  26. ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
+  - eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
+  - eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
+  - Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
+  - Aufteilen einer Zeichenkette (Format: "split:Anzahl,Trennzeichen,Flags,xxx")
+  - Aufteilen von Shell-Argumenten (Format: "split_shell:Anzahl,xxx")
+  - eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
+  - zum modifizieren (Format: "modifier:name,data,string")
+  - eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
+  - eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
+  - aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
+  - eine Umgebungsvariable (Format: "env:XXX")
+  - ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
+  - Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
+  - eine zufällige ganze Zahl (Format: "random:min,max")
+  - eine übersetzte Zeichenkette (Format: "translate:xxx")
+  - eine Benutzervariable definieren (Format: "define:Name,Wert")
+  - eine Option (Format: "file.section.option")
+  - eine lokale Variable eines Buffers
+  - ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
 Das Format für hdata kann wie folgt aufgebaut sein:
  hdata.var1.var2...: startet mit hdata (der Pointer muss bekannt sein) und fragt eine Variable nach der anderen ab (weitere hdata können folgen)
  hdata[list].var1.var2...: startet hdata mittels einer Liste, zum Beispiel:
@@ -1423,6 +1516,10 @@ Beispiele (einfache Zeichenketten):
  /eval -n ${window.buffer.full_name}            ==> core.weechat
  /eval -n ${window.buffer.number}               ==> 1
  /eval -n ${\t}                                 ==> <tab>
+  /eval -n ${chars:digit}                         ==> 0123456789
+  /eval -n ${chars:J-T}                           ==> JKLMNOPQRST
+  /eval -n ${lower:TEST}                          ==> test
+  /eval -n ${upper:test}                          ==> TEST
  /eval -n ${hide:-,${relay.network.password}}   ==> --------
  /eval -n ${cut:3,+,test}                       ==> tes+
  /eval -n ${cut:+3,+,test}                      ==> te+
@@ -1468,7 +1565,7 @@ Beispiele (Bedingungen):
         add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
         rename <name> <new_name>
         recreate <name>
-         del <name>|-all
+         del <name>|-all [<name>...]

      list: alle Filter auflisten
    enable: Filter wird aktiviert (Filter werden standardmäßig aktiviert)
@@ -1552,6 +1649,22 @@ clear: löscht den Befehlsverlauf
 value: Anzahl der gewünschten Einträgen im Befehlsverlauf anzeigen
 ----

+[[command_weechat_hotlist]]
+* `+hotlist+`: Hotlist verwalten
+
+----
+/hotlist  add [low|message|private|highlight]
+          clear [<level>]
+          remove
+          restore [-all]
+
+    add: füge den aktuellen Buffer zur Hotlist (Standardlevel: "low", Bedingungen die in Option weechat.look.hotlist_add_conditions definiert sind, werden NICHT überprüft)
+  clear: lösche Hotlist
+  level: "lowest" um die niedrigste Benachrichtigungsstufe in der Hotlist zu löschen, "highest" um die höchste Benachrichtigungsstufe in der Hotlist zu löschen, oder mit einer Levelmaske: Integer aus einer Kombination von 1=join/part, 2=message, 4=private, 8=highlight)
+ remove: entferne aktuellen Buffer von Hotlist
+restore: stellt die letzte Hotlist wieder her, die im aktuellen Buffer entfernt wurde (oder alle Buffer mit -all)
+----
+
 [[command_weechat_input]]
 * `+input+`: Funktionen für die Befehlszeile

@@ -1574,6 +1687,7 @@ Auflistung der möglichen Aktionen:
  delete_previous_char: entfernt vorheriges Zeichen
  delete_next_char: entfernt nächstes Zeichen
  delete_previous_word: entfernt vorheriges Wort
+  delete_previous_word_whitespace: vorheriges Wort löschen (bis zum Leerzeichen)
  delete_next_word: entfernt nächstes Wort
  delete_beginning_of_line: entfernt alle Zeichen ab Zeilenanfang bis zum Cursor
  delete_end_of_line: entfernt alle Zeichen ab Cursor bis zum Ende der Zeile
@@ -1592,23 +1706,10 @@ Auflistung der möglichen Aktionen:
  history_next: ruft nächsten Befehl oder Nachricht aus dem Befehlsspeicher auf (im Such-Modus: vorwärts suchen)
  history_global_previous: ruft vorherigen Befehl/Nachricht aus dem globalen Befehlsspeicher auf (für alle Buffer)
  history_global_next: ruft nächsten Befehl/Nachricht aus dem globalen Befehlsspeicher auf (für alle Buffer)
-  jump_smart: wechselt zum nächsten Buffer mit Aktivität (nach Priorität: highlight, Nachricht, …)
-  jump_last_buffer_displayed: wechselt zum jeweils zuletzt angezeigten Buffer
-  jump_previously_visited_buffer: springt zum letzten besuchten Buffer
-  jump_next_visited_buffer: springt zum nächsten besuchten Buffer
-  hotlist_clear: löscht Hotlist (Aktivitätsanzeige für die Buffer), (optionales Argument: "lowest" löscht den niedrigsten Eintrag der Hotlist, "highest" löscht den höchsten Eintrag der Hotlist, oder eine integer Maske: eine Kombination aus 1=join/part, 2=Nachricht,4=privat,8=highlight)
-  hotlist_remove_buffer: entferne aktuellen Buffer von der Hotlist
-  hotlist_restore_buffer: Wiederherstellen der neuesten Hotlist, die im aktuellen Buffer entfernt wurde
-  hotlist_restore_all: Wiederherstellen der neuesten Hotlist, die in allen Buffern entfernt wurde
  grab_key: fängt eine Taste (optionales Argument: Verzögerung um eine Taste einzufangen. Standard sind 500 Millisekunden)
  grab_key_command: zeigt den Tastencode (inklusive des eingebundenen Befehls) einer Tastenkombination an und fügt ihn in die Befehlszeile ein (optionales Argument: Verzögerung um eine Taste einzufangen. Standard sind 500 Millisekunden)
  grab_mouse: fängt den Code einer Maus Aktivität
  grab_mouse_area: fängt den Code einer Maus Aktivität mit entsprechendem Bereich
-  set_unread: setzt für alle Buffer die Markierung der ungelesen Nachrichten
-  set_unread_current_buffer: setzt nur für den aktuellen Buffer eine Markierung der ungelesen Nachrichten
-  switch_active_buffer: springt zum nächsten zusammengefügten Buffer
-  switch_active_buffer_previous: springt zum vorherigen zusammengefügten Buffer
-  zoom_merged_buffer: zoomt in zusammengefügte Buffer
  insert: fügt einen Text in die Eingabezeile ein (Escapesequenzen sind möglich, siehe /help print)
  send: schickt Text an einen Buffer
  paste_start: Einfügen wird gestartet (bracketed paste mode)
@@ -1617,6 +1718,49 @@ Auflistung der möglichen Aktionen:
 Dieser Befehl wird sinnvollerweise mittels Tastenbelegungen oder Erweiterungen genutzt.
 ----

+[[command_weechat_item]]
+* `+item+`: Verwalten von benutzerdefinierten Bar-Items
+
+----
+/item  list
+       add|addreplace <name> "<conditions>" "<content>"
+       rename <name> <new_name>
+       refresh <name> [<name>...]
+       recreate <name>
+       del <name>|-all
+
+      list: zeigt eine Liste aller benutzerdefinierten Bar-Items
+       add: fügt ein benutzerdefiniertes Bar-Item hinzu
+addreplace: erzeugt neues Bar-Item oder ersetzt ein schon existierendes Bar-Item
+      name: benutzerdefinierter Name des Bar-Items
+conditions: evaluierte Bedingungen um ein Bar-Item anzuzeigen (zum Beispiel um ein Bar-Item nur in einem bestimmten Buffer anzuzeigen)
+   content: Inhalt (evaluiert, siehe /help eval)
+    rename: Umbenennen eines benutzerdefinierten Bar-Items
+   refresh: aktualisiert den Inhalt des Items in allen Bars, in denen das Item angezeigt wird; jedes Item kann aktualisiert werden: standard/Erweiterung/benutzerdefiniertes Bar-Item
+  recreate: kopiert den Befehl in die Eingabezeile um das benutzerdefinierte Bar-Item zu editieren
+       del: entfernt ein benutzerdefiniertes Bar-Item
+      -all: entfernt alle benutzerdefinierten Bar-Items
+
+Beispiele:
+  Item welches die Terminalgröße anzeigt wird hinzugefügt, aber nur in Buffern mit Nummer angezeigt = 1:
+    /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}"
+  fügt ein Item hinzu, welches Informationen über den Buffer anzeigt:
+    /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}"
+  fügt ein Item mit Datum/Uhrzeit hinzu, dabei wird das Format "Dec 25, 12:34 +0100" verwendet, aktualisiert, jede Minute:
+    /item add datetime "" "${date:%b %d, %H:%M %z}"
+    /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime"
+  fügt ein Item mit der Anzahl der Zeilen in dem Buffer hinzu (sichtbar/total), jeweils aktualisiertwenn eine neue Zeile dargestellt wird oder wenn sich der Status der gefilterten Zeilen geändert hat:
+    /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines"
+    /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count"
+    /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count"
+  erzwingt die Aktualisierung des Items "lines_count":
+    /item refresh lines_count
+  erstellt das Item "lines_count", mit anderen Bedingungen oder Inhalten, neu:
+    /item recreate lines_count
+  entfernt das Item "lines_count":
+    /item del lines_count
+----
+
 [[command_weechat_key]]
 * `+key+`: Einer Taste einen Befehl zuordnen oder entfernen

@@ -1667,7 +1811,7 @@ Beispiele:
  Die Tastenkombination "alt-r" wird auf die Standardfunktion zurückgesetzt:
    /key reset meta-r
  "Tab"-Taste nutzen um im Kontext "search" die Suche innerhalb eines Buffers zu beenden:
-    /key bindctxt search ctrl-I /input search_stop
+    /key bindctxt search ctrl-i /input search_stop
  Auswahl eines Nicknamens mittels mittlerer Maustaste zeigt zusätzliche Informationen zu dem Nick an:
    /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
 ----
@@ -2039,20 +2183,23 @@ Beispiele:
 ----

 [[command_weechat_upgrade]]
-* `+upgrade+`: WeeChat Binärdatei neu laden, ohne die Verbindung zum Server zu trennen
+* `+upgrade+`: Speichern der WeeChat-Sitzung und laden der WeeChat-Binärdatei, ohne die Verbindung zu Servern zu trennen

 ----
-/upgrade  [-yes] [<path_to_binary>|-quit]
+/upgrade  [-yes] [<path_to_binary>|-save|-quit]

          -yes: wird benötigt, sobald Option "weechat.look.confirm_upgrade" aktiviert ist
 path_to_binary: Pfad zu einer ausführbaren WeeChat Binärdatei (Standardeinstellung ist die aktuell ausführbare Datei)
        -dummy: ohne Funktion (dient lediglich dazu, um nicht versehentlich die "-quit" Funktion auszuführen)
+         -save: speichert nur die aktuelle Sitzung, WeeChat wird nicht beendet oder neu gestartet. DieKonfigurationsdateien werden hierbei nicht gespeichert (falls dies gewünscht wird, nutze vorher /save)
         -quit: trennt *ALLE* Verbindungen, speichert die aktuelle Sitzung und beendet WeeChat, um den aktuellen Zustand später wiederherstellen (siehe unten)

 Dieser Befehl führt ein Upgrade von WeeChat durch und startet die laufende Sitzung neu. Bevor dieser Befehl ausgeführt wird, sollte eine neue Version von WeeChat entweder vorab kompiliert, oder mit einem Paketmanager installiert worden sein.

 Hinweis: SSL Verbindungen werden während eines Upgrades unterbrochen, da diese Verbindungen zur Zeit nicht mit GnuTLS gehalten werden können. Nach einem erfolgten Upgrade findet eine automatische Verbindung zu diesen Servern statt.

+Wichtig: Die Verwendung der Option -save kann gefährlich sein. Für ein Standard-Upgrade oder einen Neustart wird empfohlen, nur den /upgrade (oder mit -quit) Befehl zu nutzen.Mit der Option -save kann eine Sitzung regelmäßig gespeichert und dann wiederhergestellt werden,falls Weechat abnormal beendet wird (Stromausfall, Absturz etc.)
+
 Der Upgrade Vorgang besteht aus vier Schritten:
  1. Sicherung der Sitzung, in Dateien für Core und Erweiterungen (buffers, history, ..)
  2. alle Erweiterungen werden ausgeschaltet (Konfigurationen *.conf werden gesichert)
@@ -2065,9 +2212,13 @@ Nutzt man die "-quit" Funktion ist die Abfolge geringfügig anders:
  3. alle Erweiterungen werden ausgeschaltet
  4. die WeeChat Konfiguration wird gesichert
  5. WeeChat wird beendet
-Die Sitzung kann zu einem späteren Zeitpunkt wiederhergestellt werden: weechat --upgrade
-WICHTIG: Die Sitzung muss mit exakt den selben Konfigurationsdateien wiederhergestellt werden (*.conf)
-Es ist möglich, die WeeChat-Sitzung auf einem anderen Computer wiederherzustellen, wenn Sie den Inhalt der WeeChat Verzeichnisse kopieren (siehe / debug dirs).
+
+Mit der Option "-save" ist der Ablauf:
+  1. Die Sitzung wird in Dateien (*.upgrade) gesichert, allerdings mit dem Status das IRC und Client Verbindungen unterbrochen sind (es findet aber keine Trennung der Verbindung statt!)
+
+Durch nutzen von -quit oder -save kann eine Sitzung zu einem späteren Zeitpunkt wiederhergestellt werden:weechat --upgrade
+WICHTIG: Die Sitzung muss mit exakt den selben Konfigurationsdateien wiederhergestellt werden (*.conf) und wenn möglich mit der selben Version von WeeChat (oder einer neueren Version).
+Es ist möglich, die WeeChat-Sitzung auf einem anderen Computer wiederherzustellen, wenn Sie den Inhalt der WeeChat Verzeichnisse kopieren (siehe /debug dirs).
 ----

 [[command_weechat_uptime]]
@@ -2251,6 +2402,7 @@ Die folgenden Variablen können in den obigen Optionen genutzt werden:
    - ${format_hotlist}: die formatierte Hotlist (evaluiert aus Option buflist.format.hotlist)
    - ${hotlist}: die Hotlist in der Rohform
    - ${hotlist_priority}: "none", "low", "message", "private" oder "highlight"
+    - ${hotlist_priority_number}: -1 = keine, 0 = niedrig, 1 = Nachricht, 2 = private, 3 = Hervorhebungen
    - ${format_lag}: die Verzögerung für einen IRC Server-Buffer, ist leer falls es keine Verzögerung gibt (evaluiert aus Option buflist.format.lag)
    - ${format_tls_version}: Indikator der TLS Version für den Serverbuffer, Channels bleiben unberührt (evaluiert aus Option buflist.format.tls_version)
 ----
@@ -2498,7 +2650,7 @@ Tasten und Eingaben um Optionen im fset Buffer zu editieren:
                    u:xxx   demarkiert Optionen welche angezeigt werden und auf die der Filter "xxx" zutrifft (jeder Filter für Option oder Wert ist erlaubt, siehe Filterung weiter oben)

 weitere Tasten und Eingaben im fset Buffer:
-  ctrl+L                    der Bildschirm wird neu gezeichnet (Befehl: /fset -refresh)
+  ctrl+l                    der Bildschirm wird neu gezeichnet (Befehl: /fset -refresh)
                    $       Optionen neu einlesen (markierte Optionen werden beibehalten)
                    $$      Optionen neu einlesen (Markierungen von Optionen werden dabei gelöscht)
  alt+p             p       Umschalten der Beschreibung von Erweiterungen (plugins.desc.*)
@@ -2508,7 +2660,7 @@ weitere Tasten und Eingaben im fset Buffer:
                    w:xxx   exportiert Optionen in Datei "xxx"
                    w-:xxx  exportiert Optionen in Datei "xxx", ohne Hilfstext
                    w+:xxx  exportiert Optionen in Datei "xxx", mit Hilfstext
-  ctrl+X            x       umschalten zwischen der Darstellung von Optionen
+  ctrl+x            x       umschalten zwischen der Darstellung von Optionen
                    q       schließt fset Buffer

 Mausaktionen im fset Buffer:
@@ -2817,7 +2969,7 @@ protocol.name: Protokoll und Name des Relay:
                 - Protokoll "weechat" (es wird kein Name verwendet)

 Das "irc" Protokoll dient dazu eine Verbindung zu einem anderen IRC Client (oder zu einem zweiten WeeChat) herzustellen.
-Das "weechat" Protokoll wird von einem Remote-Interface genutzt um eine Verbindung auf dem Port herzustellen. Siehe https://weechat.org/about/interfaces
+Das "weechat" Protokoll wird von einem Remote-Interface genutzt um eine Verbindung auf dem Port herzustellen. Siehe https://weechat.org/about/interfaces/

 Ohne Angabe von Argumenten werden alle Relay-Clients in einem neuen Buffer dargestellt.

@@ -2972,7 +3124,7 @@ Beispiele:
 ----
 /spell  enable|disable|toggle
        listdict
-        setdict <dict>[,<dict>...]
+        setdict -|<dict>[,<dict>...]
        deldict
        addword [<dict>] <word>

@@ -2980,7 +3132,7 @@ Beispiele:
 disable: Rechtschreibprüfung wird deaktiviert
  toggle: Funktionalität der Rechtschreibprüfung umschalten
 listdict: die, auf dem System, installierten Wörterbücher werden aufgelistet
- setdict: Wörterbuch für den aktuellen Buffer einstellen (mehrere Wörterbücher müssen durch Kommata getrennt werden)
+ setdict: Wörterbuch für den aktuellen Buffer einstellen (mehrere Wörterbücher müssen durch Kommata getrennt werden (spezieller Wert "-" deaktiviert die Rechtschreibprüfung für den aktuellen Buffer))
 deldict: Wörterbuch für den aktuellen Buffer entfernen
 addword: fügt ein Wort in das persönliche Wörterbuch hinzu

@@ -3088,7 +3240,7 @@ post_action: Aktion welche nach der Abarbeitung des Triggers ausgeführt werden
    restart: startet Trigger neu (Hook(s) werden neu erstellt)
       show: zeigt detaillierte Informationen zu einem Trigger (inklusive einer kleinen Statistik)
        del: entfernt einen Trigger
-       -all: führt eine Aktion aus, die alle Trigger beinhaltet
+       -all: führt eine Aktion aus, die alle Trigger betrifft
    restore: stellt Trigger mit Standardwerten wieder her (funktioniert nur bei vorgegebenen Triggern)
    default: stellt die standardmäßigen Trigger wieder her
    monitor: öffnet den Trigger Monitor-Buffer, mit optionaler Filterfunktion:
@@ -3102,13 +3254,15 @@ Wenn ein Trigger-Callback aufgerufen wird, dann wird folgende Befehlskette ausge
  5. Aktion welche nach der Abarbeitung des Triggers ausgeführt werden soll

 Beispiele (die standardmäßig verfügbaren Trigger kann man sich mit "/trigger listdefault" anzeigen lassen):
-  fügt einer Nachricht die Textattribute *fett*, _unterstrichen_ und /kursiv/ hinzu:
+  fügt einer Nachricht die Textattribute *fett*, _unterstrichen_ und /kursiv/ hinzu (nur in User-Nachrichten):
    /trigger add effects modifier weechat_print "${tg_tag_nick}" "==\*([^ ]+)\*==*${color:bold}${re:1}${color:-bold}*== ==_([^ ]+)_==_${color:underline}${re:1}${color:-underline}_== ==/([^ ]+)/==/${color:italic}${re:1}${color:-italic}/"
  verbirgt die Nicklist auf kleineren Terminals:
    /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
    /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
  speichert die Konfiguration jede Stunde ab:
    /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
+  speichert, ohne Ausgabe von Text, eine Weechat-Sitzung um Mitternach (siehe /help upgrade):
+    /trigger add session_save signal day_changed "" "" "/mute /upgrade -save"
  öffnet den Trigger Monitor und zeigt ausschließlich modifier und Trigger an, die mit "resize" im Namen beginnen:
    /trigger monitor @modifier,resize*
 ----
@@ -8,37 +8,37 @@
 |===
 | Alias | Befehl | Vervollständigung

-| /AAWAY | /allserv /away | -
-| /ANICK | /allserv /nick | -
-| /BEEP | /print -beep | -
-| /BYE | /quit | -
-| /C | /buffer clear | -
-| /CL | /buffer clear | -
-| /CLOSE | /buffer close | -
-| /CHAT | /dcc chat | -
-| /EXIT | /quit | -
-| /IG | /ignore | -
-| /J | /join | -
-| /K | /kick | -
-| /KB | /kickban | -
-| /LEAVE | /part | -
-| /M | /msg | -
-| /MUB | /unban * | -
-| /MSGBUF | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
-| /N | /names | -
-| /Q | /query | -
-| /REDRAW | /window refresh | -
-| /SAY | /msg * | -
-| /SIGNOFF | /quit | -
-| /T | /topic | -
-| /UB | /unban | -
-| /UMODE | /mode $nick | -
-| /V | /command core version | -
-| /W | /who | -
-| /WC | /window close | -
-| /WI | /whois | -
-| /WII | /whois $1 $1 | -
-| /WM | /window merge | -
-| /WW | /whowas | -
+| /aaway | /allserv /away | -
+| /anick | /allserv /nick | -
+| /beep | /print -beep | -
+| /bye | /quit | -
+| /c | /buffer clear | -
+| /cl | /buffer clear | -
+| /close | /buffer close | -
+| /chat | /dcc chat | -
+| /exit | /quit | -
+| /ig | /ignore | -
+| /j | /join | -
+| /k | /kick | -
+| /kb | /kickban | -
+| /leave | /part | -
+| /m | /msg | -
+| /mub | /unban * | -
+| /msgbuf | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
+| /n | /names | -
+| /q | /query | -
+| /redraw | /window refresh | -
+| /say | /msg * | -
+| /signoff | /quit | -
+| /t | /topic | -
+| /ub | /unban | -
+| /umode | /mode $nick | -
+| /v | /command core version | -
+| /w | /who | -
+| /wc | /window close | -
+| /wi | /whois | -
+| /wii | /whois $1 $1 | -
+| /wm | /window merge | -
+| /ww | /whowas | -
 |===
 // end::default_aliases[]
@@ -1,6 +1,6 @@
 // tag::plugin_options[]
 Um eine vollständige Dokumentation der Optionen zu erhalten, siehe
-https://weechat.org/doc[WeeChat user's guide].
+https://weechat.org/doc/[WeeChat user's guide].

 Mittels der IRC Erweiterung kann man sich zu einen temporären Server verbinden lassen,
 indem man eine URL verwendet:
@@ -100,7 +100,7 @@ $HOME/.local/share/weechat/weechat.log::
 WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
 findet man in der AUTHORS.adoc Datei).

-Copyright (C) 2003-2021 {author}
+Copyright (C) 2003-2023 {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
@@ -63,4 +63,4 @@ include::includes/man.de.adoc[tag=copyright]

 == SUPPORT / FEHLER MELDEN

-für Hilfe oder um einen Fehler zu melden: https://weechat.org/about/support
+für Hilfe oder um einen Fehler zu melden: https://weechat.org/about/support/
@@ -59,4 +59,4 @@ include::includes/man.de.adoc[tag=copyright]

 == SUPPORT / FEHLER MELDEN

-für Hilfe oder um einen Fehler zu melden: https://weechat.org/about/support
+für Hilfe oder um einen Fehler zu melden: https://weechat.org/about/support/
@@ -10,13 +10,10 @@
 :docinfo1:


-Diese Dokumentation bezieht sich auf die WeeChat Version ≥ 0.3.0. Es sollte aber
-vorzugsweise immer die aktuell veröffentlichte Version von WeeChat genutzt werden.
-
 Übersetzer:

 * Juergen Descher <jhdl@gmx.net>, 2009
-* Nils Görs <weechatter@arcor.de>, 2009-2018
+* Nils Görs <weechatter@arcor.de>, 2009-2022

 toc::[]

@@ -38,7 +35,8 @@ Aber diese Bedeutung trifft nicht auf WeeChat zu!)

 WeeChat ist sehr speicherschonend und besticht durch innovative Funktionen.

-Weitere Informationen findet man auf der WeeChat Seite: https://weechat.org/about/features
+Weitere Infomationen über Weechat
+https://weechat.org/about/features/[features page ^↗^,window=_blank].

 [[compilation_install]]
 == Kompilierung / Installation
@@ -46,30 +44,23 @@ Weitere Informationen findet man auf der WeeChat Seite: https://weechat.org/abou
 [[gui]]
 === Ich habe gehört es gibt verschiedene GUIs für WeeChat. Wie kann ich diese kompilieren bzw. nutzen?

-Es sind einige Remote-Oberflächen verfügbar. Diese findet man auf der Homepage:
-https://weechat.org/about/interfaces
+Einige Remote-GUIs sind verfügbar, siehe
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].

 [[compile_git]]
 === Ich kann WeeChat nach Cloning des git Repository nicht kompilieren - weshalb?

-Es wird empfohlen link:weechat_user.de.html#compile_with_cmake[CMake] zum
-kompilieren von WeeChat zu nutzen.
+WeeChat muss mit CMake kompiliert werden.

-Falls Du WeeChat mit Hilfe der
-link:weechat_user.de.html#compile_with_autotools[autotools] kompilieren solltest
-(dich also nicht für CMake entscheidest), stelle sicher, dass Du die neueste
-Version von autoconf und automake besitzt.
+Bitte folgen Sie link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+und stellen Sie sicher, dass alle erforderlichen Abhängigkeiten installiert sind.

-Die zweite Möglichkeit besteht darin, das "Entwickler-Paket" zu installieren, denn dies
-besitzt weniger Abhängigkeiten. Das Paket wird quasi täglich aus dem git Repository erstellt.
-Beachte, dass dieses Paket nicht immer exakt mit dem git Repository übereinstimmen muss
-und daher auch weniger brauchbar sein kann. Im Gegensatz zu der Möglichkeit, dass man selbst
-das Repository klont und daraus Updates installiert.
+Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.

 [[compile_macos]]
 === Wie installiere ich WeeChat auf macOS?

-Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew] genutzt wird.
+Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^,window=_blank] genutzt wird.
 Hilfe erhält man mittels:

 ----
@@ -87,12 +78,12 @@ brew install weechat

 Um Hilfe zu erhalten, nutze den `/help` Befehl.
 Jeder Befehl besitzt einen Hilfstext, den man sich durch `/help Befehlsname` anzeigen lassen kann.
-Die link:weechat_user.de.html#key_bindings[Standard Tastenbelegung] sowie
-link:weechat_user.de.html#commands_and_options[Befehle und Optionen] sind im
-link:weechat_user.de.html[Benutzerhandbuch] aufgeführt.
+Die link:weechat_user.de.html#key_bindings[Standard Tastenbelegung ^↗^,window=_blank] sowie
+link:weechat_user.de.html#commands_and_options[Befehle und Optionen ^↗^,window=_blank] sind im
+link:weechat_user.de.html[Benutzerhandbuch ^↗^,window=_blank] aufgeführt.

 Neuen Anwendern wird empfohlen,
-die link:weechat_quickstart.de.html[Quickstart Anleitung] zu lesen.
+die link:weechat_quickstart.de.html[Quickstart Anleitung ^↗^,window=_blank] zu lesen.

 [[display]]
 == Anzeige
@@ -125,7 +116,7 @@ Es ist deshalb wichtig, *ALLE* der folgenden Lösungsmöglichkeiten zu prüfen:
   ("`defutf8 on`" in der Datei ~/.screenrc oder `screen -U` beim Starten von
   screen).
 * Überprüfe die Option
-  link:weechat_user.de.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_]
+  link:weechat_user.de.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
  (diese Option kann schwerwiegenden Darstellungsfehler verursachen, wenn man die Option aktiviert hat).

 [NOTE]
@@ -141,10 +132,10 @@ Dieser Fehler sollte durch glibc 2.22 behoben sein (vielleicht ist diese Version
 verwendeten Distributionen noch nicht verfügbar).

 Es gibt folgende Übergangslösung, um das Problem mit der _wcwidth_ zu umgehen:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].

-Siehe auch diese Fehlermeldung für weitere Informationen:
-https://github.com/weechat/weechat/issues/79
+Siehe https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+für weitere Informationen.

 [[bars_background]]
 === Weshalb haben Bars, z.B. Titel und Status, keine Hintergrundfarbe bzw. diese endet direkt nach dem Text?
@@ -199,17 +190,10 @@ von einem oder mehreren Fenstern gleichzeitig angezeigt werden.
 [[buffers_list]]
 === Wie kann ich eine Liste mit den Buffern z.B. auf der linken Seite anzeigen lassen?

-Ab WeeChat ≥ 1.8 wird standardmäßig die link:weechat_user.de.html#buflist_plugin["buflist"-Erweiterung]
-automatisch geladen und verwendet.
+Diese Erweiterung, link:weechat_user.de.html#buflist[buflist ^↗^,window=_blank],
+wird standardmäßig geladen und aktiviert.

-Bei älteren Versionen kann stattdessen das Skript _buffers.pl_ installiert werden:
-
----
-/script install buffers.pl
----
-
-Um die maximale Breite der buflist-Spalte zu reduzieren (ersetze "buflist" durch "buffers", wenn das
-Skript _buffers.pl_ genutzt wird), nutze folgende Option:
+Um die maximale Breite der buflist-Spalte zu reduzieren, nutze folgende Option:

 ----
 /set weechat.bar.buflist.size_max 15
@@ -229,26 +213,6 @@ kbd:[F1] oder kbd:[Ctrl+F1]) zum Hoch-Scrollen,
 kbd:[F2] oder kbd:[Ctrl+F2] zum Runter-Scrollen,
 kbd:[Alt+F1] und kbd:[Alt+F2] um an den Anfang bzw. an das Ende der Liste zu springen.

-Wird das Skript _buffers.pl_ verwendet,
-müssen die entsprechenden Tasten selbst definiert werden.
-Sie sind dann vergleichbar mit den vorhanden Tasten für die Nicklist. +
-Um zum Beispiel folgende Tasten nutzen zu können:
-kbd:[F1], kbd:[F2] um zu scrollen,
-oder kbd:[Alt+F1] und kbd:[Alt+F2] um an den Anfang bzw. das Ende zu springen,
-finden folgende WeeChat-Befehle Anwendung:
-
----
-/key bind meta-OP /bar scroll buffers * -100%
-/key bind meta-OQ /bar scroll buffers * +100%
-/key bind meta-meta-OP /bar scroll buffers * b
-/key bind meta-meta-OQ /bar scroll buffers * e
----
-
-[NOTE]
-Die Tasten "meta-OP" und "meta-OQ" können im Hinblick auf das jeweils genutzte Terminal variieren.
-Um die korrekten Tasten zu finden, sollte man mit kbd:[Alt+k] die gewünschte Tastenkombination einfangen.
-Siehe auch: link:weechat_user.de.html#key_bindings_command_line[Benutzerhandbuch / Tastenbelegung].
-
 [[customize_buflist]]
 === Wie kann ich die Darstellung der Bufferliste anpassen, z.B. die Farbe des aktiven Buffers?

@@ -271,8 +235,8 @@ Es kann auch eine beliebige numerische Farbe anstelle von "Rot" verwendet werden

 Die Buflist-Erweiterung bietet viele Optionen, zum individualisieren. Bitte lesen Sie dazu die Hilfe von jeder Option.

-Es gibt auch eine Wiki-Seite mit Beispielen, wie eine erweiterte Konfiguration aussehen kann:
-https://github.com/weechat/weechat/wiki/buflist
+Es gibt zusätzlich die https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+mit Beispielen für die erweiterte buflist Konfiguration.

 [[customize_prefix]]
 === Wie kann ich die Länge eines Nicknamens begrenzen oder die Ausrichtung des Nicks im Chatbereich entfernen?
@@ -318,8 +282,8 @@ Diese Farben können mit den Optionen __weechat.color.status_data_*__
 Weitere hotlist Eigenschaften können mit Hilfe der Optionen  __weechat.look.hotlist_*__
 verändert werden.

-Siehe link:weechat_user.de.html#screen_layout[Benutzerhandbuch / Screen layout] für
-weitere Informationen zur Hotlist.
+Siehe link:weechat_user.de.html#screen_layout[Benutzerhandbuch / Screen layout ^↗^,window=_blank]
+für weitere Informationen zur Hotlist.

 [[input_bar_size]]
 === Wie kann man eine mehrzeilige Eingabezeile einstellen?
@@ -368,9 +332,8 @@ sobald das Item "input_text" in keiner anderen Bar genutzt wird:
 [[terminal_copy_paste]]
 === Wie kann ich einen Text kopieren und einfügen, ohne dass die Nickliste (Benutzerliste) mit kopiert wird?

-Seit WeeChat ≥ 1.0 gibt es den "einfachen Anzeigemodus".
-Dieser kann mit der Tastenkombination kbd:[Alt+l] (<l> wie in Lima) aktiviert werden.
-Der Inhalt des aktuellen Fensters wird nach der Aktivierung ohne Formatierung angezeigt.
+Sie können den vereinfachten Anzeigemodus verwenden (Standardtaste: kbd:[Alt+l] (`L`)), dieser
+zeigt nur den Inhalt des aktuell ausgewählten Fensters an, ohne jegliche Formatierung.

 Jetzt kannst Du die Block-Auswahl nutzen, insofern dein Terminal diesen Modus
 unterstützt (rxvt-unicode, konsole, gnome-terminal, ... um nur einige zu nennen ).
@@ -387,8 +350,7 @@ die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positi
 [[urls]]
 === Wie kann ich eine URL aufrufen, die einen Zeilenumbruch besitzt?

-Seit WeeChat ≥ 1.0 gibt es den "einfachen Anzeigemodus".
-Dieser kann mit der Tastenkombination kbd:[Alt+l] (<l> wie in Lima) aktiviert werden.
+Dazu kann man den vereinfachten Anzeigemodus nutzen (Standardtaste: kbd:[Alt+l] (`L`)).

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

@@ -398,7 +360,7 @@ Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werde
 /set weechat.bar.nicklist.position top
 ----

-* Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren (WeeChat ≥ 1.7).
+* Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren.

 ----
 /set weechat.look.align_multiline_words off
@@ -410,9 +372,9 @@ Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werde
 /set weechat.look.align_end_of_lines time
 ----

-Ab der WeeChat Version ≥ 0.3.6, kann die Option "eat_newline_glitch" aktiviert werden.
-Damit wird das Zeichen für einen Zeilenumbruch nicht an die dargestellten Zeilen angefügt
-(dies führt dazu, dass URLs beim Markieren korrekt erkannt werden):
+Es kann auch die "eat_newline_glitch" Option aktiviert werden,
+sodass kein neuer Zeilenumbruch hinzugefügt wird,
+am Ende jeder angezeigten Zeile (es wird die URL-Auswahl nicht unterbrechen):

 ----
 /set weechat.look.eat_newline_glitch on
@@ -459,8 +421,6 @@ In WeeChat wird der neue Wert umgehend genutzt:
 [[use_256_colors]]
 === Wie kann ich 256 Farben in WeeChat nutzen?

-256 Farben werden ab der WeeChat Version ≥ 0.3.4 unterstützt.
-
 Zuerst sollte überprüft werden, ob die _TERM_-Umgebungsvariable korrekt hinterlegt ist.
 Folgende Werte sind zu empfehlen:

@@ -481,21 +441,18 @@ term screen-256color

 Falls die Umgebungsvariable _TERM_ einen falschen Wert haben sollte und WeeChat
 schon gestartet wurde, kann man die Umgebungsvariable mit folgenden WeeChat Befehlen
-anpassen (WeeChat ≥ 1.0):
+anpassen:

 ----
 /set env TERM screen-256color
 /upgrade
 ----

-Mit der WeeChat Version 0.3.4 muss der Befehl `/color` genutzt werden, um neue Farben zu erstellen.
+Sie können eine beliebige Farbnummer in den Optionen verwenden (optional: Sie können Farbaliase,
+mit dem Befehl `/color`, erstellen.

-Ab Version ≥ 0.3.5 kann in den Optionen für eine zu nutzende Farbe die entsprechende
-Zahl der Farbe eingetragen werden (optional: mit dem Befehl `/color` kann man einen Alias für
-eine Farbe definieren).
-
-Bitte lese link:weechat_user.de.html#colors[Benutzerhandbuch / Farben] für weitere
-Informationen die das Farbmanagement betreffen.
+Bitte lese link:weechat_user.de.html#colors[Benutzerhandbuch / Farben ^↗^,window=_blank]
+für weitere Informationen die das Farbmanagement betreffen.

 [[search_text]]
 === Wie kann ich in einem Buffer nach einem Text suchen (vergleichbar /lastlog in irssi)?
@@ -505,8 +462,8 @@ Die Standardtastenbelegung lautet kbd:[Ctrl+r]
 Um zu Highlight-Nachrichten zu springen:
 kbd:[Alt+p] für vorherige, kbd:[Alt+n] für die nächste Nachricht.

-siehe link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung] für weitere
-Informationen zu dieser Funktion.
+siehe link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^,window=_blank]
+für weitere Informationen zu dieser Funktion.

 [[terminal_focus]]
 === Wie kann ich Befehle ausführen, wenn der Terminal (keinen) Fokus hat?
@@ -541,7 +498,7 @@ Um zum Beispiel Buffer als gelesen zu markieren,
 wenn das Terminal den Fokus verlieren sollte:

 ----
-/key bind meta2-O /input set_unread
+/key bind meta2-O /allbuf /buffer set unread
 ----

 [[screen_paste]]
@@ -686,7 +643,7 @@ Es kann auch eine neue Taste eingebunden werden um zu einem Buffer zu wechseln:
 ----

 Eine Auflistung der Standardtastenbelegung findet man in
-link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung].
+link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^,window=_blank].

 Um zu Buffern zu wechseln die an Position ≥ 100 sind kann ein Trigger definiert
 werden um dann z.B. mit einem Kurzbefehl `/123` zum Buffer #123 zu springen:
@@ -718,8 +675,6 @@ Um die korrekten Tasten zu finden, sollte man mit kbd:[Alt+k] die gewünschte Ta
 [[mouse_not_working]]
 === Die Mausunterstützung funktioniert nicht, was kann ich tun?

-Eine Unterstützung von Mausfunktionen ist seit WeeChat ≥ 0.3.6 verfügbar.
-
 Als erstes sollte man die Mausunterstützung einschalten:

 ----
@@ -777,12 +732,6 @@ Falls macOS genutzt wird,
 muss mittels Homebrew `openssl` installiert werden.
 Eine CA-Datei wird mittels Zertifikaten vom Systemschlüssel geladen.

-Ab WeeChat ≤ 3.1 können Sie den Pfad zu Systemzertifikaten festlegen:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
 Falls Fehlermeldungen auftreten, die besagen,
 dass der gnutls Handshake fehlgeschlagen ist,
 sollte ein kleinerer Diffie-Hellman-Schlüssel verwendet werden (Standardgröße: 2048):
@@ -812,8 +761,8 @@ des Zertifikats von Hand eingetragen werden:
 [[irc_ssl_handshake_error]]
 === Bei einem Verbindungsaufbau zum Server via SSL erhalte ich "TLS Handshake fehlgeschlagen". Wie kann ich das beheben?

-Man sollte versuchen, eine andere Priorität zu nutzen (nur WeeChat ≥ 0.3.5);
-Im folgenden Beispiel muss "xxx" durch den betroffenen Servernamen ersetzt werden:
+Man sollte versuchen, eine andere Priorität zu nutzen; Im folgenden Beispiel
+muss "xxx" durch den betroffenen Servernamen ersetzt werden:

 ----
 /set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
@@ -822,23 +771,8 @@ Im folgenden Beispiel muss "xxx" durch den betroffenen Servernamen ersetzt werde
 [[irc_ssl_libera]]
 === Wie kann ich eine SSL gesicherte Verbindung zum libera Server herstellen?

-Ab WeeChat ≤ 3.1 kann mit der Option _weechat.network.gnutls_ca_file_ eine Datei mit
-Zertifikaten ausgewählt werden:
-
----
-/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
----
-
-Wenn openssl mit homebrew unter macOS installiert wurde, könnte es sein,
-dass die Zertifikate in einer anderen Datei bereitgestellt werden:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
-[NOTE]
-Überprüfe, ob die Zertifikationsdatei auf deinem System installiert wurde.
-Üblicherweise wird diese Datei durch das Paket "ca-certificates" bereitgestellt.
+Überprüfen Sie, ob auf Ihrem System Zertifikate installiert sind. Dies wird häufig
+durch das Paket "ca-certificates" bereitgestellt.

 Konfiguration des Servers, Port angeben, SSL aktivieren und Verbindung herstellen:

@@ -865,7 +799,7 @@ ersetzt werden:
 ----

 [[irc_sasl]]
-=== Wie kann ich mich vor dem Betreten von Channels identifizieren?
+=== Wie kann ich mich vor dem Betreten von Kanälen identifizieren?

 Sollte der Server SASL unterstützen,
 ist es ratsam auf diese Funktion zurückzugreifen
@@ -878,37 +812,44 @@ und sich nicht mittels "nickserv" zu authentifizieren:

 Unterstützt der Server keine SASL Authentifizierung,
 kann eine Verzögerung aktiviert werden,
-um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
+um sich vor dem Betreten von Kanälen bei "nickserv" zu identifizieren:

 ----
 /set irc.server.libera.command_delay 5
 ----

 [[edit_autojoin]]
-=== Wie kann ich Channels zur autojoin Option entfernen/hinzufügen?
+=== Wie kann ich Kanäle zur autojoin Option hinzufügen oder entfernen?

-Um die Liste der autojoin Channels zu editieren,
-kann der Befehl `/set` genutzt werden.
-In folgendem Beispiel wird der "libera"-Server angepasst:
+Ab WeeChat ≥ 3.5 können Sie die Kanäle, denen Sie manuell betreten und verlassen,
+automatisch aufzeichnen und die Serveroption „autojoin“ entsprechend anpassen.
+
+Für alle Server:

 ----
-/set irc.server.libera.autojoin [TAB]
+/set irc.server_default.autojoin_dynamic on
 ----

-[NOTE]
-Man kann den Namen oder den Wert einer Option mit kbd:[Tab] vervollständigen
-oder mittels kbd:[Shift+Tab] eine teilweise Vervollständigung durchführen,
-was bei Namen sinnvoll ist, denn so braucht nicht die komplette Liste
-der Channels neu geschrieben werden.
-
-Es kann auch der `/fset` Befehl verwendet werden, um die Liste der Channels
-zu editieren:
+Für einen einzelnen Server:

 ----
-/fset autojoin
+/set irc.server.libera.autojoin_dynamic on
 ----

-oder man nutzt ein Skript:
+Sie können den aktuellen Kanal auch in der Serveroption "autojoin" hinzufügen, indem
+Sie den `/autojoin`-Befehl nutzen:
+
+----
+/autojoin add
+----
+
+oder einen beliebigen Kanal:
+
+----
+/autojoin add #test
+----
+
+Es existieren aber auch Skripten:

 ----
 /script search autojoin
@@ -918,9 +859,9 @@ oder man nutzt ein Skript:
 === Was ist der Unterschied zwischen dem Befehl /ignore und /filter?

 Der Befehl `/ignore` ist ein (clientseitiger) IRC-Befehl und beeinflusst direkt,
-welche vom Server empfangenen Nachrichten im IRC-Buffer (Server und Channel) landen.
+welche vom Server empfangenen Nachrichten im IRC-Buffer (Server und Kanäle) landen.
 Durch diesen Befehl können bestimmte Nicks oder Hostnamen von bestimmten Servern
-oder Channels ignoriert werden.
+oder Kanäle ignoriert werden.
 Der Befehl wird nicht auf den Inhalt eines IRC-Buffers angewandt.
 Zutreffende Meldungen werden, bevor sie dem Buffer zugeführt werden,
 von der "irc"-Erweiterung gelöscht. Es gibt somit keine Möglichkeit,
@@ -941,7 +882,7 @@ Die voreingestellte Tastenkombination zum Aktivieren bzw. Deaktivieren
 aller Filter ist kbd:[Alt+-].

 [[filter_irc_join_part_quit]]
-=== Wie kann ich join/part/quit Meldungen in den IRC Channels filtern/unterdrücken?
+=== Wie kann ich join/part/quit Meldungen in den IRC Kanälen filtern/unterdrücken?

 Zum einen mit dem Smart-Filter.
 Bei dessen Anwendung werden join/part/quit-Meldungen von Usern angezeigt,
@@ -961,19 +902,18 @@ Dabei werden *alle* join/part/quit Nachrichten unterdrückt:

 [NOTE]
 Für weitere Hilfe: `/help filter`, `+/help irc.look.smart_filter+` und
-link:weechat_user.de.html#irc_smart_filter_join_part_quit[Benutzerhandbuch / einfacher Filter für join/part/quit Nachrichten].
+link:weechat_user.de.html#irc_smart_filter_join_part_quit[Benutzerhandbuch / einfacher Filter für join/part/quit Nachrichten ^↗^,window=_blank].

 [[filter_irc_join_channel_messages]]
-=== Wie kann ich Server-Nachrichten filtern, wenn ich einen IRC Channel betrete?
+=== Wie kann ich die Server-Nachrichten filtern, wenn ich einen IRC Kanal betrete?

-Ab WeeChat ≥ 0.4.1 kann man auswählen, welche Server-Nachrichten beim Betreten
-eines Channels angezeigt und welche verborgen werden sollen. Dazu nutzt man
-die Option _irc.look.display_join_message_ (für weitere Informationen, siehe
-`+/help irc.look.display_join_message+`).
+Sie können auswählen, welche Nachrichten angezeigt werden, wenn Sie einem Kanal beitreten
+Option _irc.look.display_join_message_ (siehe `+/help irc.look.display_join_message+`
+Für mehr Information).

 Um Nachrichten visuell zu verbergen, können diese gefiltert werden.
 Dazu wird der Befehl `/filter` auf bestimmte Nachrichten-Tags angewandt.
-Das Tag _irc_329_ kennzeichnet beispielsweise das Erstellungsdatum des Channels.
+Das Tag _irc_329_ kennzeichnet beispielsweise das Erstellungsdatum des Kanals.
 Siehe `/help filter`, um weitere Informationen über die Filterfunktion zu
 erhalten.

@@ -988,13 +928,13 @@ da diese dazu genutzt werden um den Abwesenheitsstatus anderer User anzuzeigen
 und man nicht von diesen Mitteilungen überflutet werden möchte,
 kann man WeeChat anweisen, abwesende Nicks in einer anderen Farbe darzustellen.

-Nutzt man Bitlbee ≥ 3, sollte man im _&bitlbee_ Channel folgendes eingeben:
+Nutzt man Bitlbee ≥ 3, sollte man im _&bitlbee_ Kanal folgendes eingeben:

 ----
 channel set show_users online,away
 ----

-für ältere Versionen von Bitlbee gibt man im _&bitlbee_ Channel ein:
+für ältere Versionen von Bitlbee gibt man im _&bitlbee_ Kanal ein:

 ----
 set away_devoice false
@@ -1020,12 +960,12 @@ in welchem Zeitintervall die Überprüfungen auf Abwesenheit stattfinden sollen.
 Die Angabe des Wertes erfolgt in Minuten.

 Mit der Option _irc.server_default.away_check_max_nicks_ kann festgelegt werden,
-in welchen Channels eine Überprüfung stattfinden soll.
-Hierbei stellt der angegebene Wert die maximale Anzahl an Nicks in einem Channel dar,
-die den Channel gleichzeitig besuchen dürfen.
+in welchen Kanälen eine Überprüfung stattfinden soll.
+Hierbei stellt der angegebene Wert die maximale Anzahl an Nicks in einem Kanal dar,
+die den Kanal gleichzeitig besuchen dürfen.

 Im folgenden Beispiel wird der Abwesenheitsstatus alle fünf Minuten überprüft.
-Dabei werden aber nur solche Channels berücksichtigt, die nicht mehr als 25
+Dabei werden aber nur solche Kanäle berücksichtigt, die nicht mehr als 25
 Teilnehmer haben:

 ----
@@ -1033,18 +973,13 @@ Teilnehmer haben:
 /set irc.server_default.away_check_max_nicks 25
 ----

-[NOTE]
-Für WeeChat ≤ 0.3.3, lauten die Optionen _irc.network.away_check_ und
-_irc.network.away_check_max_nicks_.
-
 [[highlight_notification]]
-=== Wie kann ich mich benachrichtigen lassen, falls mich jemand in einem Channel direkt anspricht (highlight)?
+=== Wie kann ich mich benachrichtigen lassen, falls mich jemand in einem Kanal direkt anspricht (highlight)?

-Seit WeeChat ≥ 1.0 gibt es standardmäßig den Trigger "beep",
-der an das Terminal ein _BEL_ Signal schickt,
-sobald man eine highlight (hervorgehobene) oder private Nachricht erhält.
-Nun muss man lediglich im Terminalprogramm oder dem Multiplexer (screen/tmux) einstellen,
-welcher Befehl ausgeführt werden soll, sobald das Terminal das _BEL_ Signal erhält.
+Es gibt einen voreingestellten Trigger mit Namen „beep“, der ein _BEL_ an das Terminal sendet,
+bei einem Highlight oder einer private Nachricht. Damit können Sie Ihr Terminal konfigurieren
+(oder einen Multiplexer wie screen/tmux), um einen Befehl auszuführen oder einen Ton abzuspielen, wenn
+ein _BEL_ tritt auf.

 Der Trigger "beep" kann auch direkt an einen externen Befehl gekoppelt werden:

@@ -1070,11 +1005,9 @@ Es gibt weitere Skripten, die auch zu diesem Thema passen:
 [[disable_highlights_for_specific_nicks]]
 === Wie kann ich Highlights (Hervorhebungen) von bestimmten Nicks deaktivieren?

-Ab WeeChat ≥ 0.3.4 kann die Eigenschaft
-link:weechat_user.de.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add]
-für den entsprechenden Buffer gesetzt werden.
-Dies kann für einzelne Nicks,
-einen Buffer oder eine Gruppe von Buffern (z.B. IRC Server) gelten.
+Dafür sollte link:weechat_user.de.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+die Buffer-Eigenschaft genutzt werden, um das maximale Hotlist-Level für einige Nicks pro Puffer festzulegen,
+oder pro Gruppe von Buffern (wie IRC-Server).

 Um nun Highlights (Hervorhebungen) für bestimmte Nicks zu deaktivieren, muss
 man die entsprechende Eigenschaft auf 2 setzen:
@@ -1091,7 +1024,7 @@ das Skript _buffer_autoset.py_ nutzen:
 /script install buffer_autoset.py
 ----

-Um zum Beispiel Highlights (Hervorhebungen) von Nick "mike" im Channel
+Um zum Beispiel Highlights (Hervorhebungen) von Nick "mike" im Kanal
 #weechat auf dem IRC Server libera zu deaktivieren:

 ----
@@ -1110,7 +1043,7 @@ Für weitere Beispiele, siehe `+/help buffer_autoset+`.
 === Wie kann ich bei zusammengefügten Buffern den Zielbuffer ändern (z.B. bei einem Server-Buffer)?

 Die Standardtastenkombination ist kbd:[Ctrl+x]. Der entsprechende Befehl lautet:
-`+/input switch_active_buffer+`.
+`+/buffer switch+`.

 [[plugins_scripts]]
 == Erweiterungen / Skripten
@@ -1130,9 +1063,8 @@ Um dies zu beheben, muss folgendes konfiguriert werden:
 [[install_scripts]]
 === Wie kann ich Skripten installieren? Sind Skripten kompatibel mit anderen IRC Clients?

-Seit WeeChat ≥ 0.3.9 gibt es den Befehl `/script` um Skripten zu installieren und zu verwalten
-(siehe `/help script` um eine Hilfe zu erhalten). Nutzt man eine ältere Version von WeeChat
-kann man die Skripten weeget.py und script.pl nutzen.
+Mit dem Befehl `/script` können Sie Skripte installieren und verwalten (siehe `/help script`
+für Hilfe).

 Die Skripten für WeeChat sind mit anderen IRC-Clients nicht kompatibel und vice versa.

@@ -1149,7 +1081,7 @@ $ rm ~/.cache/weechat/script/plugins.xml.gz
 ----

 [NOTE]
-Ab WeeChat ≤ 3.1, sollte der Pfad: _~/.weechat/script/plugins.xml.gz_ lauten.
+Wenn Sie die XDG-Verzeichnisse nicht verwenden, könnte der Pfad lauten: _~/.weechat/script/plugins.xml.gz_.

 Danach sollte man noch einmal versuchen die Datei herunter zu laden:

@@ -1191,10 +1123,6 @@ Du brauchst lediglich die "spell"-Erweiterung neu zu laden:
 /plugin reload spell
 ----

-[NOTE]
-Bis WeeChat ≤ 2.4, hieß die "spell"-Erweiterung, "aspell". Somit lautet der Befehl:
-`/plugin reload aspell`.
-
 [[settings]]
 == Einstellungen

@@ -1284,7 +1212,7 @@ Definiere eine Passphrase und nutze ausschließlich geschützte Daten wann immer
 es möglich ist, wie z.B. bei Passwörtern: siehe `/help secure` und nutze `/help`
 bei der entsprechenden Option (falls man geschützte Daten nutzen kann, wird es
 im Hilfstext erwähnt).
-Siehe auch link:weechat_user.de.html#secured_data[Benutzerhandbuch / sensible Daten].
+Siehe auch link:weechat_user.de.html#secured_data[Benutzerhandbuch / sensible Daten ^↗^,window=_blank].

 Beispiel:

@@ -1305,7 +1233,7 @@ Ihrer Passphrase verschlüsselten Kennwörter enthält.
 Einige andere Dateien enthalten möglicherweise vertrauliche Informationen wie
 Kennwörter (sofern sie nicht mit dem Befehl `/secure` in _sec.conf_ gesichert werden).

-Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse]
+Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse ^↗^,window=_blank]
 für weitere Informationen über Konfigurationsdateien.

 [[development]]
@@ -1314,7 +1242,7 @@ für weitere Informationen über Konfigurationsdateien.
 [[bug_task_patch]]
 === Was kann ich machen, falls ich einen Fehler gefunden habe, mich nach neuen Funktionen erkundigen oder Patches einsenden möchte?

-siehe: https://weechat.org/about/support
+siehe https://weechat.org/about/support/[this page ^↗^,window=_blank].

 [[gdb_error_threads]]
 === Wenn man WeeChat in gdb startet, kann ein Thread-Fehler auftreten. Was beudeutet das?
@@ -1352,11 +1280,11 @@ Das Gleiche gilt für Systeme, zu denen wir keinen Zugang haben.

 Es gibt einiges zu tun - z.B. testen, programmieren, dokumentieren, ...

-Bitte kontaktiere uns via IRC oder E-Mail, wirf einen Blick auf die Support-Seite:
-https://weechat.org/about/support
+Bitte kontaktieren Sie uns per IRC oder Mail, siehe
+https://weechat.org/about/support/[support page ^↗^,window=_blank].

 [[donate]]
 === Kann ich Geld oder anderes an die WeeChat Entwickler spenden?

-Du kannst uns Geld zur Unterstützung der weiteren Entwicklung spenden.
-Details hierzu gibt es auf: https://weechat.org/donate
+Sie können uns Geld spenden, um die Entwicklung zu unterstützen.
+Details dazu, unter https://weechat.org/donate/[donation page ^↗^,window=_blank].
@@ -223,11 +223,15 @@ in folgender Option erreicht werden:
 /set irc.server.libera.autojoin "#channel1,#channel2"
 ----

-[TIP]
-Mittels der kbd:[Tab] Taste kann man sehr einfach Namen und Werte von Optionen
-vervollständigen und mittels kbd:[Shift+Tab] kann eine teilweise Vervollständigung
-durchgeführt werden (was bei langen Wörtern, wie z.B. dem Namen einer Option, nützlich
-sein kann).
+Mit dem `/autojoin` Befehl können die _autojoin_ Optionen einfach konfiguriert werden.
+(siehe `/help autojoin`).
+
+WeeChat kann auch konfigurieren werden, dass die _autojoin_ Optionen automatisch aktualisiert werden
+sobald man Kanäle betritt oder verlässt:
+
+----
+/set irc.server_default.autojoin_dynamic on
+----

 Mit dem Befehl `/unset` können Server-Optionen zurückgesetzt werden.
 Ist eine Server-Option zurückgesetzt, _wirkt_ der entsprechende Vorgabewert
@@ -246,6 +250,12 @@ Werte anderer Server-Optionen (`xxx`) können festgelegt werden mit:
 /set irc.server.libera.xxx Wert
 ----

+[TIP]
+Mittels der kbd:[Tab] Taste kann man sehr einfach Namen und Werte von Optionen
+vervollständigen und mittels kbd:[Shift+Tab] kann eine teilweise Vervollständigung
+durchgeführt werden (was bei langen Wörtern, wie z.B. dem Namen einer Option, nützlich
+sein kann).
+
 [[connect_to_irc_server]]
 == Verbinden mit dem IRC-Server

@@ -431,14 +441,14 @@ Zeige eine liste aller verfügbaren Skripten:
 /script
 ----

-Auf *weechat.org* von Drittanbietern bereitgestellte Scripten: https://weechat.org/scripts
+Eine Liste von Skripten ist in WeeChat mittels `/script` oder auf
+https://weechat.org/scripts/[this page ^↗^,window=_blank] verfügbar.

 [[more_doc]]
 == Weitere Dokumentation

-Mit dieser Quickstart-Anleitung wurden dir die wesentlichen
-Bedienungswerkzeuge von WeeChat nähergebracht.
-Für das eingehende Studium aller verfügbaren Funktionalitäten
-sei dir unsere ausführliche FAQ/Dokumentation ans Herz gelegt: https://weechat.org/doc
+WeeChat kann nun verwendet werden und lesen Sie
+https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+falls Sie weitere Fragen haben.

 Viel Spass mit WeeChat!
@@ -17,8 +17,8 @@

 Diese Anleitung beschreibt den WeeChat Chat Client und ist Teil von WeeChat.

-Die aktuelle Version dieser Anleitung finden Sie auf:
-https://weechat.org/doc
+Die neueste Version dieses Dokuments finden Sie unter
+https://weechat.org/doc/[this page ^↗^,window=_blank].


 [[introduction]]
@@ -67,7 +67,7 @@ Ein Skript darf *NIEMALS* einen fork nutzen oder einen eigenen Thread erstellen,
 dafür gibt es explizit eine API Funktion, andernfalls kann WeeChat abstürzen. +
 Wenn etwas in einem Hintergrundprozess ausgeführt werden soll, kann die Funktion
 `+hook_process+` genutzt werden. Siehe Beispiele im Kapitel <<hook_process,Hintergrundprozesse>>
-und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference] (Englisch).
+und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank] (Englisch).

 [[languages_specificities]]
 === Besonderheiten der einzelnen Skriptsprachen
@@ -81,7 +81,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/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].

 [[python_functions]]
 ===== Funktionen
@@ -109,45 +109,41 @@ Liste ist nicht vollständig):
 |===
 | API Funktion | Argumente | Beispiele| Beschreibung

-| hook_modifier |
-  irc_in_yyy |
-  pass:[irc_in_privmsg] +
-  pass:[irc_in_notice] |
-  Eine Nachricht die von der IRC Erweiterung empfangen wurde und bevor sie nach UTF-8 dekodiert wurde (intern
+| hook_modifier
+| irc_in_yyy
+| pass:[irc_in_privmsg] +
+  pass:[irc_in_notice]
+| Eine Nachricht die von der IRC Erweiterung empfangen wurde und bevor sie nach UTF-8 dekodiert wurde (intern
  verwendet). +
  +
  Es wird empfohlen den Modifier `+irc_in2_yyy+` zu nutzen, da die empfangene Zeichenkette
  immer UTF-8 gültig ist. +
  siehe Funktion `+hook_modifier+` in der
-  link:weechat_plugin_api.en.html#_hook_modifier[WeeChat Anleitung für API Erweiterung].
+  link:weechat_plugin_api.en.html#_hook_modifier[WeeChat Anleitung für API Erweiterung ^↗^,window=_blank].

-| hook_signal |
-  xxx,irc_out_yyy +
-  xxx,irc_outtags_yyy |
-  pass:[*,irc_out_privmsg] +
+| hook_signal
+| xxx,irc_out_yyy +
+  xxx,irc_outtags_yyy
+| pass:[*,irc_out_privmsg] +
  pass:[*,irc_out_notice] +
  pass:[*,irc_outtags_privmsg] +
-  pass:[*,irc_outtags_notice] |
-  Eine Nachricht welche von der IRC Erweiterung versendet wurde, nachdem diese entsprechend
+  pass:[*,irc_outtags_notice]
+| Eine Nachricht welche von der IRC Erweiterung versendet wurde, nachdem diese entsprechend
  der Benutzereinstellung  `encode` Charset kodiert (falls abweichend von der `UTF-8` Standardeinstellung). +
  +
  Es wird empfohlen das Signal `+xxx,irc_out1_yyy+` zu nutzen, da die empfangene Zeichenkette
  immer UTF-8 gültig ist. +
  siehe Funktion `+hook_signal+` in der
-  link:weechat_plugin_api.en.html#_hook_signal[WeeChat Anleitung für API Erweiterung].
+  link:weechat_plugin_api.en.html#_hook_signal[WeeChat Anleitung für API Erweiterung ^↗^,window=_blank].

 | hook_process +
-  hook_process_hashtable |
-  - |
-  - |
-  Ausgabe des Befehls, dass an den Callback gesendet wurde, kann ungültige UTF-8 Daten enthalten.
+  hook_process_hashtable
+| -
+| -
+| Ausgabe des Befehls, dass an den Callback gesendet wurde, kann ungültige UTF-8 Daten enthalten.

 |===

-Mit Python 2, das mittlerweile veraltet ist und nicht mehr verwendet werden sollte, ist die
-Zeichenkette die an die Callbacks gesendet wird immer vom Typ `str` und kann deshalb bei den
-oben genannten Fällen, ungültige UTF-8 Daten enthalten.
-
 [[language_perl]]
 ==== Perl

@@ -205,6 +201,22 @@ Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.

 Funktionen werden aufgerufen mittels `+weechat::xxx arg1 arg2 ...+`.

+[[tcl_null]]
+===== Nullwerte
+
+Da Tcl nur String-Typen nutzt, gibt es keinen Null-Typ, der als Argument übergeben
+werden kann wenn eine Funktion Nullwerte akzeptiert, oder als Argument in einem
+Callback zu erhalten Funktion. Um dies zu umgehen, definiert die WeeChat-API die
+Konstante `$::weechat::WEECHAT_NULL`, welches als Nullwert fungiert. Diese Konstante
+ist festgelegt und lautet `\uFFFF\uFFFF\uFFFFWEECHAT_NULL\uFFFF\uFFFF\uFFFF`,
+es ist also sehr unwahrscheinlich das dies ungewollt genutzt wird.
+
+Sie können diese Konstante übergeben, wenn eine Funktion NULL als Argument akzeptiert
+und Sie erhält es als Wert eines Arguments in einer Callback-Funktion zurück, wenn
+der Wert des Arguments NULL ist. Um zu sehen, welche Funktionen Nullwerte akzeptieren
+und Nullwerte in Rückrufen übergeben, schauen Sie sich die Python-Prototypen an
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+
 [[language_guile]]
 ==== Guile (Scheme)

@@ -384,7 +396,7 @@ ein Link in das entsprechende _autoload_ Verzeichnis erzeugt.
 Die Skripten API ist nahezu identisch mit der API der C Erweiterung.
 Um einen Überblick über alle API Funktionen (Prototyp, Argumente,
 Rückgabe werte, Beispiele) zu erhalten werfen Sie einen Blick in
-die link:weechat_plugin_api.en.html[WeeChat Plugin API Reference] (Englisch).
+die link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).
 Es ist wichtig das man zwischen einer _Erweiterung_ und einem _Skript_
 unterscheidet: Eine _Erweiterung_ ist eine Binärdatei die kompiliert wurde
 und mittels `/plugin` geladen wird. Ein _Skript_ ist eine Textdatei welche
@@ -553,25 +565,25 @@ weechat_hook_timer(1000, 0, 1, $timer_cb, 'test');
 == Skript API

 Um weiterführende Informationen zu den API Funktionen zu erhalten
-lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference] (Englisch).
+lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).

 [[script_api_functions]]
 === Funktionen

 Liste der Skript API Funktionen:

-[width="100%",cols="1,3",options="header"]
+[width="100%",cols="1,5",options="header"]
 |===
 | Kategorie | Funktionen

-| Allgemein |
-  register
+| Allgemein
+| register

-| Erweiterungen |
-  plugin_get_name
+| Erweiterungen
+| plugin_get_name

-| Strings |
-  charset_set +
+| Strings
+| charset_set +
  iconv_to_internal +
  iconv_from_internal +
  gettext +
@@ -583,6 +595,7 @@ Liste der Skript API Funktionen:
  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 +
@@ -590,13 +603,13 @@ Liste der Skript API Funktionen:
  string_eval_expression +
  string_eval_path_home

-| Verzeichnisse |
-  mkdir_home +
+| Verzeichnisse
+| mkdir_home +
  mkdir +
  mkdir_parents

-| sortierte Listen |
-  list_new +
+| sortierte Listen
+| list_new +
  list_add +
  list_search +
  list_search_pos +
@@ -612,8 +625,8 @@ Liste der Skript API Funktionen:
  list_remove_all +
  list_free

-| Konfigurationsdatei |
-  config_new +
+| Konfigurationsdatei
+| config_new +
  config_new_section +
  config_search_section +
  config_new_option +
@@ -650,20 +663,21 @@ Liste der Skript API Funktionen:
  config_set_desc_plugin +
  config_unset_plugin

-| Tastenbelegung |
-  key_bind +
+| Tastenbelegung
+| key_bind +
  key_unbind

-| Ausgabe |
-  prefix +
+| Ausgabe
+| prefix +
  color +
  print (für Python: prnt) +
  print_date_tags (für Python: prnt_date_tags) +
  print_y (für Python: prnt_y) +
+  print_y_date_tags (für Python: prnt_y_date_tags) +
  log_print

-| Hooks |
-  hook_command +
+| Hooks
+| hook_command +
  hook_command_run +
  hook_timer +
  hook_fd +
@@ -688,8 +702,9 @@ Liste der Skript API Funktionen:
  unhook +
  unhook_all

-| Buffer |
-  buffer_new +
+| Buffer
+| buffer_new +
+  buffer_new_props +
  current_buffer +
  buffer_search +
  buffer_search_main +
@@ -704,16 +719,16 @@ Liste der Skript API Funktionen:
  buffer_string_replace_local_var +
  buffer_match_list

-| Fenster |
-  current_window +
+| Fenster
+| current_window +
  window_search_with_buffer +
  window_get_integer +
  window_get_string +
  window_get_pointer +
  window_set_title

-| Nickliste |
-  nicklist_add_group +
+| Nickliste
+| nicklist_add_group +
  nicklist_search_group +
  nicklist_add_nick +
  nicklist_search_nick +
@@ -729,8 +744,8 @@ Liste der Skript API Funktionen:
  nicklist_nick_get_pointer +
  nicklist_nick_set

-| Bars |
-  bar_item_search +
+| Bars
+| bar_item_search +
  bar_item_new +
  bar_item_update +
  bar_item_remove +
@@ -740,23 +755,23 @@ Liste der Skript API Funktionen:
  bar_update +
  bar_remove

-| Befehle |
-  command +
+| Befehle
+| command +
  command_options

-| Vervollständigung |
-  completion_new +
+| Vervollständigung
+| completion_new +
  completion_search +
  completion_get_string +
  completion_list_add +
  completion_free

-| Informationen |
-  info_get +
+| Informationen
+| info_get +
  info_get_hashtable

-| Infolisten |
-  infolist_new +
+| Infolisten
+| infolist_new +
  infolist_new_item +
  infolist_new_var_integer +
  infolist_new_var_string +
@@ -774,8 +789,8 @@ Liste der Skript API Funktionen:
  infolist_time +
  infolist_free

-| hdata |
-  hdata_get +
+| hdata
+| hdata_get +
  hdata_get_var_offset +
  hdata_get_var_type_string +
  hdata_get_var_array_size +
@@ -796,8 +811,8 @@ Liste der Skript API Funktionen:
  hdata_update +
  hdata_get_string

-| Upgrade |
-  upgrade_new +
+| Upgrade
+| upgrade_new +
  upgrade_write_object +
  upgrade_read +
  upgrade_close
@@ -808,17 +823,17 @@ Liste der Skript API Funktionen:

 Liste der Konstanten in Skript API:

-[width="100%",cols="1,3",options="header"]
+[width="100%",cols="1,5",options="header"]
 |===
 | Kategorie | Konstanten

-| return codes |
-  `WEECHAT_RC_OK` (integer) +
+| return codes
+| `WEECHAT_RC_OK` (integer) +
  `WEECHAT_RC_OK_EAT` (integer) +
  `WEECHAT_RC_ERROR` (integer)

-| Konfigurationsdatei |
-  `WEECHAT_CONFIG_READ_OK` (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) +
@@ -833,23 +848,23 @@ Liste der Konstanten in Skript API:
  `WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
  `WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)

-| sortierte Listen |
-  `WEECHAT_LIST_POS_SORT` (string) +
+| sortierte Listen
+| `WEECHAT_LIST_POS_SORT` (string) +
  `WEECHAT_LIST_POS_BEGINNING` (string) +
  `WEECHAT_LIST_POS_END` (string)

-| Hotlist |
-  `WEECHAT_HOTLIST_LOW` (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) +
+| hook Prozesse
+| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
  `WEECHAT_HOOK_PROCESS_ERROR` (integer)

-| hook Connect |
-  `WEECHAT_HOOK_CONNECT_OK` (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) +
@@ -861,8 +876,8 @@ Liste der Konstanten in Skript API:
  `WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
  `WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)

-| hook Signal |
-  `WEECHAT_HOOK_SIGNAL_STRING` (string) +
+| hook Signal
+| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
  `WEECHAT_HOOK_SIGNAL_INT` (string) +
  `WEECHAT_HOOK_SIGNAL_POINTER` (string)
 |===
@@ -873,7 +888,7 @@ Liste der Konstanten in Skript API:
 Dieses Kapitel beinhaltet einige Aufgaben mit Lösungsbeispielen.
 Die Skript API wird dabei nur sehr oberflächlich besprochen.Um eine vollständige
 Übersicht aller Befehle zu erhalten nutzen Sie bitte die
-link:weechat_plugin_api.en.html[WeeChat Plugin API Reference] (Englisch).
+link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).

 [[buffers]]
 === Buffer
@@ -893,7 +908,7 @@ Beispiele:
 weechat.prnt("", "Hallo")

 # Gibt den Text "Hallo" im Core Buffer aus, schreibt diesen aber nicht in die Protokolldatei
-# (nur Version >= 0.3.3)
+# (nur Version ≥ 0.3.3)
 weechat.prnt_date_tags("", 0, "no_log", "hello")

 # Gibt den Präfix "==>" gefolgt von dem Text "Hallo" im aktuellen Buffer aus
@@ -1073,26 +1088,53 @@ Mit der Funktion `+hook_process+` kann ein Hintergrundprozess gestartet werden.
 Der Callback wird aufgerufen sobald der Hintergrundprozess abgearbeitet wurde.
 Dies kann auch mehrfach der Fall sein.

-Für den letzten Aufruf des Callback wird _rc_ auf 0 oder einen positiven Wert
-gesetzt. Dies ist der Return Code des Befehls.
+Für den letzten Aufruf des Callback wird _return_code_ auf 0 oder einen positiven
+Wert gesetzt. Dies ist der Return Code des Befehls.

 Beispiele:

 [source,python]
 ----
-process_output = ""
-
-def my_process_cb(data, command, rc, out, err):
-    global process_output
-    if out != "":
-        process_output += out
-    if int(rc) >= 0:
-        weechat.prnt("", process_output)
+def my_process_cb(data, command, return_code, out, err):
+    if return_code == weechat.WEECHAT_HOOK_PROCESS_ERROR:
+        weechat.prnt("", "Error with command '%s'" % command)
+        return weechat.WEECHAT_RC_OK
+    if return_code >= 0:
+        weechat.prnt("", "return_code = %d" % return_code)
+    if out:
+        weechat.prnt("", "stdout: %s" % out)
+    if err:
+        weechat.prnt("", "stderr: %s" % err)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process("/bin/ls -l /etc", 10 * 1000, "my_process_cb", "")
 ----

+Sie können statt eines externen Befehls auch direkt eine
+Skriptfunktion aufrufen, die Weechat blockieren würde:
+
+[source,python]
+----
+def get_status(data):
+    # do something blocking...
+    # ...
+    return "this is the result"
+
+def my_process_cb(data, command, return_code, out, err):
+    if return_code == weechat.WEECHAT_HOOK_PROCESS_ERROR:
+        weechat.prnt("", "Error with command '%s'" % command)
+        return weechat.WEECHAT_RC_OK
+    if return_code >= 0:
+        weechat.prnt("", "return_code = %d" % return_code)
+    if out:
+        weechat.prnt("", "stdout: %s" % out)
+    if err:
+        weechat.prnt("", "stderr: %s" % err)
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_process("func:get_status", 5000, "my_process_cb", "")
+----
+
 [[url_transfer]]
 ==== URL Übertragung

@@ -1107,15 +1149,15 @@ dabei in der Callback-Variable "out" gesichert (Standardausgabe des Prozesses):

 [source,python]
 ----
-# Zeigt die aktuelle stabile Version von WeeChat an.
-weechat_version = ""
+# Display latest stable version of WeeChat.
+weechat_latest_version = ""

-def weechat_process_cb(data, command, rc, out, err):
-    global weechat_version
-    if out != "":
-        weechat_version += out
-    if int(rc) >= 0:
-        weechat.prnt("", "aktuelle stabile WeeChat-Version: %s" % weechat_version)
+def weechat_process_cb(data, command, return_code, out, err):
+    global weechat_latest_version
+    if out:
+        weechat_latest_version += out
+    if return_code >= 0:
+        weechat.prnt("", "Latest WeeChat version: %s" % weechat_latest_version)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process("url:https://weechat.org/dev/info/stable/",
@@ -1123,16 +1165,17 @@ weechat.hook_process("url:https://weechat.org/dev/info/stable/",
 ----

 [TIP]
-Alle Informationen die WeeChat betreffen findet man auf: https://weechat.org/dev/info
+Alle verfügbaren Informationen über WeeChat findet man unter
+https://weechat.org/dev/info/[this page ^↗^,window=_blank].

 Beispiel eines URL Transfers, mit zusätzliche Optionen: Es wird das neuste
 WeeChat Entwicklerpaket in die Datei _/tmp/weechat-devel.tar.gz_ gesichert:

 [source,python]
 ----
-def my_process_cb(data, command, rc, out, err):
-    if int(rc) >= 0:
-        weechat.prnt("", "End of transfer (rc=%s)" % rc)
+def my_process_cb(data, command, return_code, out, err):
+    if return_code >= 0:
+        weechat.prnt("", "End of transfer (return code = %d)" % return_code)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel.tar.gz",
@@ -1142,7 +1185,7 @@ weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel.

 Für weitere Informationen zum URL Transfer und verfügbare Optionen, siehe Funktionen
 `+hook_process+` und `+hook_process_hashtable+` in
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference] (Englisch).
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank] (Englisch).

 [[config_options]]
 === Konfiguration / Optionen
@@ -1298,63 +1341,71 @@ Das Ergebnis ist eine Hashtabelle mit folgenden Schlüsseln

 [width="100%",cols="3,^2,10,7",options="header"]
 |===
-| Schlüssel | Seit WeeChat ^(1)^ | Beschreibung | Beispiel
+| Schlüssel | Seit WeeChat ^(1)^ | Beschreibung | Beispiel

-| Tags | 0.4.0 |
-  Tags in der Nachricht (kann leer sein). |
-  `+time=2015-06-27T16:40:35.000Z+`
+| Tags | 0.4.0
+| Tags in der Nachricht (kann leer sein).
+| `+time=2015-06-27T16:40:35.000Z+`

-| tag_xxx | 3.3 |
-  Wert des Tags "xxx" ohne Escapezeichen (ein Schlüssel pro Tag). |
-  `+2015-06-27T16:40:35.000Z+`
+| tag_xxx | 3.3
+| Wert des Tags "xxx" ohne Escapezeichen (ein Schlüssel pro Tag).
+| `+2015-06-27T16:40:35.000Z+`

-| message_without_tags | 0.4.0 |
-  Die IRC Nachricht ohne Tags (wie eine Nachricht ohne Tags). |
-  `+:nick!user@host PRIVMSG #weechat :hello!+`
+| message_without_tags | 0.4.0
+| Die IRC Nachricht ohne Tags (wie eine Nachricht ohne Tags).
+| `+:nick!user@host PRIVMSG #weechat :hello!+`

-| nick | 0.3.4 |
-  der ursprüngliche Nick. |
-  `+nick+`
+| nick | 0.3.4
+| der ursprüngliche Nick.
+| `+nick+`

-| user | 2.7 |
-  der ursprüngliche Benutzer. |
-  `+user+`
+| user | 2.7
+| der ursprüngliche Benutzer.
+| `+user+`

-| host | 0.3.4 |
-  der ursprüngliche Host (beinhaltet den Nick). |
-  `+nick!user@host+`
+| host | 0.3.4
+| der ursprüngliche Host (beinhaltet den Nick).
+| `+nick!user@host+`

-| command | 0.3.4 |
-  der Befehl (_PRIVMSG_, _NOTICE_, ...). |
-  `+PRIVMSG+`
+| command | 0.3.4
+| der Befehl (_PRIVMSG_, _NOTICE_, ...).
+| `+PRIVMSG+`

-| channel | 0.3.4 |
-  der Zielchanne.l|
+| channel | 0.3.4
+| der Zielchanne.l|
  `+#weechat+`

-| arguments | 0.3.4 |
-  das Argument des Befehls (beinhaltet den Channel). |
-  `+#weechat :hello!+`
+| arguments | 0.3.4
+| das Argument des Befehls (beinhaltet den Channel).
+| `+#weechat :hello!+`

-| text | 1.3 |
-  der Text (zum Beispiel eine Nachricht eines Users). |
-  `+hello!+`
+| text | 1.3
+| der Text (zum Beispiel eine Nachricht eines Users).
+| `+hello!+`

-| pos_command | 1.3 |
-  Index von _command_ innerhalb einer Nachricht ("-1" falls _command_ nicht gefunden wird). |
-  `+47+`
+| paramN | 3.4
+| Befehlsparameter (von 1 bis N).
+| `+#weechat+`

-| pos_arguments | 1.3 |
-  Index von_arguments_ innerhalb einer Nachricht ("-1" falls _arguments_ nicht gefunden wird). |
-  `+55+`
+| num_params | 3.4
+| Anzahl der Befehlsparameter.
+| `+2+`

-| pos_channel | 1.3 |
-  Index von _channel_ innerhalb einer Nachricht ("-1" falls _channel_ nicht gefunden wird). |
-  `+55+`
+| pos_command | 1.3
+| Index von _command_ innerhalb einer Nachricht ("-1" falls _command_ nicht gefunden wird).
+| `+47+`

-| pos_text | 1.3 |
-  Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird). |
-  `+65+`
+| pos_arguments | 1.3
+| Index von_arguments_ innerhalb einer Nachricht ("-1" falls _arguments_ nicht gefunden wird).
+| `+55+`
+
+| pos_channel | 1.3
+| Index von _channel_ innerhalb einer Nachricht ("-1" falls _channel_ nicht gefunden wird).
+| `+55+`
+
+| pos_text | 1.3
+| Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird).
+| `+65+`
 |===

 [NOTE]
@@ -1378,6 +1429,9 @@ dict = weechat.info_get_hashtable(
 #     "channel": "#weechat",
 #     "arguments": "#weechat :hello!",
 #     "text": "hello!",
+#     "param1": "#weechat",
+#     "param2": "hello!",
+#     "num_params": "2",
 #     "pos_command": "65",
 #     "pos_arguments": "73",
 #     "pos_channel": "73",
@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 #
-# Copyright (C) 2008-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2008-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -29,7 +29,8 @@ Documentation generator for WeeChat: build include files with:
 - hdata
 - completions
 - URL options
- plugins priority.
+- plugins priority
+- config files priority.

 Instructions to build config files yourself in WeeChat directories
 (replace "path" with the path to the docgen.py script in WeeChat repository):
@@ -452,6 +453,25 @@ class WeechatDoc():  # pylint: disable=too-few-public-methods
        weechat.infolist_free(infolist)
        return plugins_priority

+    @staticmethod
+    def _read_api_config_priority():
+        """
+        Get priority of default configuration files as a dictionary.
+        """
+        config_priority = {}
+        ptr_hdata = weechat.hdata_get('config_file')
+        ptr_config = weechat.hdata_get_list(ptr_hdata, 'config_files')
+        while ptr_config:
+            name = weechat.hdata_string(ptr_hdata, ptr_config, 'name')
+            config_name = f'{name}.conf'
+            priority = weechat.hdata_integer(ptr_hdata, ptr_config, 'priority')
+            if priority in config_priority:
+                config_priority[priority].append(config_name)
+            else:
+                config_priority[priority] = [config_name]
+            ptr_config = weechat.hdata_move(ptr_hdata, ptr_config, 1)
+        return config_priority
+

 class AutogenDoc():
    """A class to write auto-generated doc files."""
@@ -487,7 +507,8 @@ class AutogenDoc():
            f'autogen_{name}.{self.locale[:2]}.adoc',
        )
        self.filename_tmp = f'{self.filename}.tmp'
-        self._file = open(self.filename_tmp, 'w')
+        # pylint: disable=consider-using-with
+        self._file = open(self.filename_tmp, 'w', encoding='utf-8')

    def write_autogen_files(self, weechat_doc):
        """Write auto-generated files."""
@@ -612,15 +633,21 @@ class AutogenDoc():
                        default_value = ('"%s"' %
                                         default_value.replace('"', '\\"'))
                    elif opt_type == 'color':
-                        values = _('a WeeChat color name (default, black, '
-                                   '(dark)gray, white, (light)red, '
-                                   '(light)green, brown, yellow, (light)blue, '
-                                   '(light)magenta, (light)cyan), a terminal '
-                                   'color number or an alias; attributes are '
-                                   'allowed before color (for text color '
-                                   'only, not background): \"*\" for bold, '
-                                   '\"!\" for reverse, \"/\" for italic, '
-                                   '\"_\" for underline')
+                        values = _(
+                            'a WeeChat color name (default, black, '
+                            '(dark)gray, white, (light)red, '
+                            '(light)green, brown, yellow, (light)blue, '
+                            '(light)magenta, (light)cyan), a terminal '
+                            'color number or an alias; attributes are '
+                            'allowed before color (for text color '
+                            'only, not background): '
+                            '\"%\" for blink, '
+                            '\".\" for \"dim\" (half bright), '
+                            '\"*\" for bold, '
+                            '\"!\" for reverse, '
+                            '\"/\" for italic, '
+                            '\"_\" for underline'
+                        )
                    self.write(f'* [[option_{config}.{section}.{option}]] '
                               f'*{config}.{section}.{option}*')
                    self.write('** %s: pass:none[%s]',
@@ -782,7 +809,7 @@ class AutogenDoc():
        self.write('// tag::url_options[]')
        self.write('[width="100%",cols="2,^1,7",options="header"]')
        self.write('|===')
-        self.write('| %s | %s ^(1)^ | %s ^(2)^\n',
+        self.write('| %s | %s ^(1)^ | %s ^(2)^\n',
                   _('Option'), _('Type'), _('Constants'))
        for option in url_options:
            constants = option['constants']
@@ -798,11 +825,30 @@ class AutogenDoc():
        """Write plugins priority."""
        self.write()
        self.write('// tag::plugins_priority[]')
-        for priority in sorted(plugins_priority, reverse=True):
+        self.write('[width="30%",cols="1,3,2",options="header"]')
+        self.write('|===')
+        self.write('| %s | %s | %s',
+                   _('Rank'), _('Plugin'), _('Priority'))
+        for i, priority in enumerate(sorted(plugins_priority, reverse=True)):
            plugins = ', '.join(sorted(plugins_priority[priority]))
-            self.write('. %s (%s)', escape(plugins), priority)
+            self.write('| %d | %s | %d', i + 1, escape(plugins), priority)
+        self.write('|===')
        self.write('// end::plugins_priority[]')

+    def _write_api_config_priority(self, config_priority):
+        """Write configuration files priority."""
+        self.write()
+        self.write('// tag::config_priority[]')
+        self.write('[width="30%",cols="1,3,2",options="header"]')
+        self.write('|===')
+        self.write('| %s | %s | %s',
+                   _('Rank'), _('File'), _('Priority'))
+        for i, priority in enumerate(sorted(config_priority, reverse=True)):
+            configs = ', '.join(sorted(config_priority[priority]))
+            self.write('| %d | %s | %d', i + 1, escape(configs), priority)
+        self.write('|===')
+        self.write('// end::config_priority[]')
+

 def docgen_cmd_cb(data, buf, args):
    """Callback for /docgen command."""
@@ -1,6 +1,6 @@
 <!--
  Custom styles for Asciidoctor
-  Copyright (C) 2016-2021 Sébastien Helleu <flashcode@flashtux.org>
+  Copyright (C) 2016-2023 Sébastien Helleu <flashcode@flashtux.org>
 -->
 <style>

@@ -9,10 +9,11 @@
@media (prefers-color-scheme: dark) {
  /* dark theme */
  :root {
+    color-scheme: dark;
    --body-bg-color: #1a1a1a;
    --body-color: #ddd;
-    --body-font: system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";
-    --link-color: #8aceff;
+    --body-font: system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";
+    --link-color: #7abeef;
    --table-thead-tfoot: #252525;
    --th-color: #fff;
    --toc-bg-color: #252525;
@@ -21,6 +22,7 @@
    --header-details-color: #aaa;
    --border: 1px solid #444;
    --code-bg-color: #252525;
+    --pre-color: #ddd;
    --pre-bg-color: #202020;
    --pre-code-bg-color: #202020;
    --keyseq-color: #777;
@@ -39,10 +41,11 @@
@media (not (prefers-color-scheme: dark)), (prefers-color-scheme: light)  {
  /* light theme */
  :root {
-    --body-bg-color: ##fff;
+    color-scheme: light;
+    --body-bg-color: #fff;
    --body-color: #353535;
-    --body-font: system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";
-    --link-color: #1d4b8f;
+    --body-font: system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans","Liberation Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";
+    --link-color: #3d6baf;
    --table-thead-tfoot: #f7f8f7;
    --th-color: #000;
    --toc-bg-color: #f8f8f7;
@@ -52,6 +55,7 @@
    --border: 1px solid #dddddf;
    --code-bg-color: #f7f7f8;
    --keyseq-color: #333c;
+    --pre-color: #353535;
    --pre-bg-color: #f7f7f8;
    --pre-code-bg-color: #202020;
    --kbd-bg-color: #f7f7f7;
@@ -86,6 +90,7 @@ h1, h2, h3, #toctitle, .sidebarblock > .content > .title, h4, h5, h6 {

 a:link, a:visited, #header .details span.email a {
  color: var(--link-color);
+  text-decoration: none;
 }

 table thead, table tfoot {
@@ -134,6 +139,10 @@ code, .prettyprint {
  color: var(--body-color);
 }

+pre {
+  color: var(--pre-color) !important;
+}
+
 pre > code {
  background-color: var(--pre-code-bg-color) !important;
 }
@@ -190,7 +199,7 @@ mark {
 /* syntax highlighting tuning */

 pre.pygments .tok-cp {
-  color: #ed4848;
+  color: #44cfaf;
 }

 pre.pygments .tok-nc, pre.pygments .tok-nf {
@@ -218,8 +227,8 @@ h1, h2, h3, h4, h5 {
 }

 .literalblock pre {
-  font-family: monospace, 'Courier New', Courier;
-  line-height: normal;
+  font-family: "DejaVu Sans Mono", "Liberation Mono", "Lucida Console", monospace, 'Courier New', Courier;
+  line-height: inherit;
 }

 kbd {
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,129 +0,0 @@
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2006 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/>.
-#
-
-docdir = $(datadir)/doc/$(PACKAGE)
-
-EXTRA_DIST = CMakeLists.txt \
-             docinfo.html \
-             weechat.1.en.adoc \
-             weechat-headless.1.en.adoc \
-             weechat_user.en.adoc \
-             weechat_plugin_api.en.adoc \
-             weechat_scripting.en.adoc \
-             weechat_faq.en.adoc \
-             weechat_quickstart.en.adoc \
-             weechat_relay_protocol.en.adoc \
-             weechat_dev.en.adoc \
-             includes/autogen_api_completions.en.adoc \
-             includes/autogen_api_hdata.en.adoc \
-             includes/autogen_api_infolists.en.adoc \
-             includes/autogen_api_infos.en.adoc \
-             includes/autogen_api_infos_hashtable.en.adoc \
-             includes/autogen_api_plugins_priority.en.adoc \
-             includes/autogen_api_url_options.en.adoc \
-             includes/autogen_user_commands.en.adoc \
-             includes/autogen_user_default_aliases.en.adoc \
-             includes/autogen_user_irc_colors.en.adoc \
-             includes/autogen_user_options.en.adoc \
-             includes/cmdline_options.en.adoc \
-             includes/man.en.adoc
-
-if MAN
-  man_targets = weechat.1 \
-                weechat-headless.1
-  man_install = install-man
-  man_uninstall = uninstall-man
-endif
-if DOC
-  doc_targets = weechat_user.en.html \
-		weechat_plugin_api.en.html \
-		weechat_scripting.en.html \
-		weechat_faq.en.html \
-		weechat_quickstart.en.html \
-		weechat_relay_protocol.en.html \
-		weechat_dev.en.html
-  doc_install = install-doc
-  doc_uninstall = uninstall-doc
-endif
-all-local: $(man_targets) $(doc_targets)
-
-# man pages
-weechat.1: weechat.1.en.adoc includes/cmdline_options.en.adoc includes/man.en.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat.1 $(abs_top_srcdir)/doc/en/weechat.1.en.adoc
-weechat-headless.1: weechat-headless.1.en.adoc includes/cmdline_options.en.adoc includes/man.en.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat-headless.1 $(abs_top_srcdir)/doc/en/weechat-headless.1.en.adoc
-
-# user's guide
-weechat_user.en.html: weechat_user.en.adoc includes/cmdline_options.en.adoc $(wildcard includes/autogen_user_*.adoc) $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_user.en.html $(abs_top_srcdir)/doc/en/weechat_user.en.adoc
-
-# plugin API reference
-weechat_plugin_api.en.html: weechat_plugin_api.en.adoc $(wildcard includes/autogen_api_*.adoc) $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_plugin_api.en.html $(abs_top_srcdir)/doc/en/weechat_plugin_api.en.adoc
-
-# scripting guide
-weechat_scripting.en.html: weechat_scripting.en.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_scripting.en.html $(abs_top_srcdir)/doc/en/weechat_scripting.en.adoc
-
-# FAQ
-weechat_faq.en.html: weechat_faq.en.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_faq.en.html $(abs_top_srcdir)/doc/en/weechat_faq.en.adoc
-
-# quickstart
-weechat_quickstart.en.html: weechat_quickstart.en.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.en.html $(abs_top_srcdir)/doc/en/weechat_quickstart.en.adoc
-
-# relay protocol
-weechat_relay_protocol.en.html: weechat_relay_protocol.en.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.en.html $(abs_top_srcdir)/doc/en/weechat_relay_protocol.en.adoc
-
-# developer's guide
-weechat_dev.en.html: weechat_dev.en.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_dev.en.html $(abs_top_srcdir)/doc/en/weechat_dev.en.adoc
-
-# install man/docs
-
-install-data-hook: $(man_install) $(doc_install)
-
-install-man:
-	$(mkinstalldirs) $(DESTDIR)$(mandir)/man1/
-	$(INSTALL_DATA) *.1 $(DESTDIR)$(mandir)/man1/
-
-install-doc:
-	$(mkinstalldirs) $(DESTDIR)$(docdir)/
-	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
-
-# uninstall man/docs
-
-uninstall-hook: $(man_uninstall) $(doc_uninstall)
-
-uninstall-man:
-	$(RM) $(DESTDIR)$(mandir)/man1/weechat.1
-	$(RM) $(DESTDIR)$(mandir)/man1/weechat-headless.1
-	-rmdir $(DESTDIR)$(mandir)/man1
-
-uninstall-doc:
-	$(RM) $(DESTDIR)$(docdir)/*.en.html
-	-rmdir $(DESTDIR)$(docdir)
-
-# clean
-
-clean-local:
-	-$(RM) weechat.1 weechat-headless.1 weechat_*.html
@@ -26,6 +26,8 @@

 | irc | irc_channels | channels on all IRC servers

+| irc | irc_channels_autojoin | channels automatically joined on the current server (option "autojoin")
+
 | irc | irc_ignores_numbers | numbers for defined ignores

 | irc | irc_modelist_masks | modelist masks of current IRC channel; required argument: modelist mode
@@ -92,6 +94,8 @@

 | tcl | tcl_script | list of scripts

+| trigger | trigger_add_arguments | arguments for command that adds a trigger: trigger name, hooks, hook arguments, hook conditions, hook regex, hook command, hook return code, post actions
+
 | trigger | trigger_hook_arguments | default arguments for a hook

 | trigger | trigger_hook_command | default command for a hook
@@ -146,6 +150,14 @@

 | weechat | cursor_areas | areas ("chat" or bar name) for free cursor movement

+| weechat | custom_bar_item_add_arguments | arguments for command that adds a custom bar item: item name, conditions, content
+
+| weechat | custom_bar_item_conditions | conditions for custom bar item
+
+| weechat | custom_bar_item_contents | contents for custom bar item
+
+| weechat | custom_bar_items_names | names of custom bar items
+
 | weechat | env_value | value of an environment variable

 | weechat | env_vars | environment variables
@@ -0,0 +1,36 @@
+//
+// This file is auto-generated by script docgen.py.
+// DO NOT EDIT BY HAND!
+//
+
+// tag::config_priority[]
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rank | File | Priority
+| 1 | sec.conf | 120000
+| 2 | weechat.conf | 110000
+| 3 | plugins.conf | 100000
+| 4 | charset.conf | 16000
+| 5 | logger.conf | 15000
+| 6 | exec.conf | 14000
+| 7 | trigger.conf | 13000
+| 8 | spell.conf | 12000
+| 9 | alias.conf | 11000
+| 10 | buflist.conf | 10000
+| 11 | fifo.conf | 9000
+| 12 | typing.conf | 8000
+| 13 | xfer.conf | 7000
+| 14 | irc.conf | 6000
+| 15 | relay.conf | 5000
+| 16 | guile.conf | 4070
+| 17 | javascript.conf | 4060
+| 18 | lua.conf | 4050
+| 19 | perl.conf | 4040
+| 20 | php.conf | 4030
+| 21 | python.conf | 4020
+| 22 | ruby.conf | 4010
+| 23 | tcl.conf | 4000
+| 24 | script.conf | 3000
+| 25 | fset.conf | 2000
+|===
+// end::config_priority[]
@@ -241,6 +241,8 @@ _sasl_scram_salted_pwd_size_   (integer) +
 _sasl_scram_auth_message_   (string) +
 _sasl_temp_username_   (string) +
 _sasl_temp_password_   (string) +
+_authentication_method_   (integer) +
+_sasl_mechanism_used_   (integer) +
 _is_connected_   (integer) +
 _ssl_connected_   (integer) +
 _disconnected_   (integer) +
@@ -278,7 +280,7 @@ _typing_allowed_   (integer) +
 _reconnect_delay_   (integer) +
 _reconnect_start_   (time) +
 _command_time_   (time) +
-_reconnect_join_   (integer) +
+_autojoin_done_   (integer) +
 _disable_autojoin_   (integer) +
 _is_away_   (integer) +
 _away_message_   (string) +
@@ -582,6 +584,7 @@ _title_   (string) +
 _own_lines_   (pointer, hdata: "lines") +
 _mixed_lines_   (pointer, hdata: "lines") +
 _lines_   (pointer, hdata: "lines") +
+_next_line_id_   (integer) +
 _time_for_each_line_   (integer) +
 _chat_refresh_needed_   (integer) +
 _nicklist_   (integer) +
@@ -631,6 +634,8 @@ _text_search_input_   (string) +
 _highlight_words_   (string) +
 _highlight_regex_   (string) +
 _highlight_regex_compiled_   (pointer) +
+_highlight_disable_regex_   (string) +
+_highlight_disable_regex_compiled_   (pointer) +
 _highlight_tags_restrict_   (string) +
 _highlight_tags_restrict_count_   (integer) +
 _highlight_tags_restrict_array_   (pointer, array_size: "highlight_tags_restrict_count") +
@@ -704,6 +709,7 @@ _count_   (integer) +
 _last_config_file_ +

 | _plugin_   (pointer, hdata: "plugin") +
+_priority_   (integer) +
 _name_   (string) +
 _filename_   (string) +
 _file_   (pointer) +
@@ -921,6 +927,7 @@ _next_line_   (pointer, hdata: "line") +
 | structure with one line data
 | -
 | _buffer_   (pointer, hdata: "buffer") +
+_id_   (integer) +
 _y_   (integer) +
 _date_   (time) +
 _date_printed_   (time) +
@@ -60,8 +60,6 @@

 | php | php_version | version of the interpreter used | -

-| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
-
 | python | python_eval | evaluation of source code | source code to execute

 | python | python_interpreter | name of the interpreter used | -
@@ -128,6 +126,8 @@

 | weechat | uptime | WeeChat uptime (format: "days:hh:mm:ss") | "days" (number of days) or "seconds" (number of seconds) (optional)

+| weechat | uptime_current | WeeChat uptime for the current process only (upgrades with /upgrade command are ignored) (format: "days:hh:mm:ss") | "days" (number of days) or "seconds" (number of seconds) (optional)
+
 | weechat | version | WeeChat version | -

 | weechat | version_git | WeeChat git version (output of command "git describe" for a development version only, empty for a stable release) | -
@@ -4,26 +4,30 @@
 //

 // tag::plugins_priority[]
-. charset (16000)
-. logger (15000)
-. exec (14000)
-. trigger (13000)
-. spell (12000)
-. alias (11000)
-. buflist (10000)
-. fifo (9000)
-. typing (8000)
-. xfer (7000)
-. irc (6000)
-. relay (5000)
-. guile (4007)
-. javascript (4006)
-. lua (4005)
-. perl (4004)
-. php (4003)
-. python (4002)
-. ruby (4001)
-. tcl (4000)
-. script (3000)
-. fset (2000)
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rank | Plugin | Priority
+| 1 | charset | 16000
+| 2 | logger | 15000
+| 3 | exec | 14000
+| 4 | trigger | 13000
+| 5 | spell | 12000
+| 6 | alias | 11000
+| 7 | buflist | 10000
+| 8 | fifo | 9000
+| 9 | typing | 8000
+| 10 | xfer | 7000
+| 11 | irc | 6000
+| 12 | relay | 5000
+| 13 | guile | 4070
+| 14 | javascript | 4060
+| 15 | lua | 4050
+| 16 | perl | 4040
+| 17 | php | 4030
+| 18 | python | 4020
+| 19 | ruby | 4010
+| 20 | tcl | 4000
+| 21 | script | 3000
+| 22 | fset | 2000
+|===
 // end::plugins_priority[]
@@ -6,7 +6,7 @@
 // tag::url_options[]
 [width="100%",cols="2,^1,7",options="header"]
 |===
-| Option | Type ^(1)^ | Constants ^(2)^
+| Option | Type ^(1)^ | Constants ^(2)^

 | verbose | long |

@@ -48,10 +48,6 @@

 | address_scope | long |

-| protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
-| redir_protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
 | noproxy | string |

 | socks5_gssapi_nec | long |
@@ -82,15 +78,19 @@

 | doh_url | string |

+| protocols_str | string |
+
+| redir_protocols_str | string |
+
 | netrc | long | ignored, optional, required

 | userpwd | string |

 | proxyuserpwd | string |

-| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

-| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

 | netrc_file | string |

@@ -108,6 +108,8 @@

 | tlsauth_password | string |

+| sasl_authzid | string |
+
 | sasl_ir | long |

 | xoauth2_bearer | string |
@@ -120,8 +122,6 @@

 | followlocation | long |

-| put | long |
-
 | post | long |

 | postfields | string |
@@ -144,7 +144,7 @@

 | cookiejar | string |

-| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge
+| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge, 3

 | cookiesession | long |

@@ -182,12 +182,20 @@

 | request_target | string |

+| http09_allowed | long |
+
+| hsts | string |
+
+| hsts_ctrl | mask | enable, readonlyfile
+
 | mail_from | string |

 | mail_rcpt | list |

 | mail_auth | string |

+| mail_rcpt_alllowfails | long |
+
 | tftp_blksize | long |

 | tftp_no_options | long |
@@ -206,8 +214,6 @@

 | ftp_create_missing_dirs | long |

-| ftp_response_timeout | long |
-
 | ftpsslauth | long | default, ssl, tls

 | ftp_account | string |
@@ -238,6 +244,8 @@

 | rtsp_server_cseq | long |

+| aws_sigv4 | string |
+
 | crlf | long |

 | range | string |
@@ -274,6 +282,8 @@

 | upload_buffersize | long |

+| mime_options | mask | formescape
+
 | timeout | long |

 | low_speed_limit | long |
@@ -298,6 +308,8 @@

 | connecttimeout_ms | long |

+| maxage_conn | long |
+
 | maxconnects | long |

 | use_ssl | long | none, try, control, all
@@ -322,6 +334,8 @@

 | upkeep_interval_ms | long |

+| maxlifetime_conn | long |
+
 | sslcert | string |

 | sslversion | long | default, tlsv1, sslv2, sslv3, tlsv1_0, tlsv1_1, tlsv1_2, tlsv1_3, max_default, max_none, max_tlsv1_0, max_tlsv1_1, max_tlsv1_2, max_tlsv1_3
@@ -330,10 +344,6 @@

 | cainfo | string |

-| random_file | string |
-
-| egdsocket | string |
-
 | ssl_verifyhost | long |

 | ssl_cipher_list | string |
@@ -364,12 +374,10 @@

 | gssapi_delegation | long | none, policy_flag, flag

-| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | ssl_enable_alpn | long |

-| ssl_enable_npn | long |
-
 | pinnedpublickey | string |

 | ssl_verifystatus | long |
@@ -398,7 +406,7 @@

 | proxy_ssl_cipher_list | list |

-| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | proxy_ssl_verifyhost | long |

@@ -414,6 +422,18 @@

 | proxy_tls13_ciphers | list |

+| proxy_issuercert | string |
+
+| ssl_ec_curves | string |
+
+| doh_ssl_verifyhost | long |
+
+| doh_ssl_verifypeer | long |
+
+| doh_ssl_verifystatus | long |
+
+| ca_cache_timeout | long |
+
 | ssh_auth_types | mask | none, policy_flag, flag

 | ssh_public_keyfile | string |
@@ -426,11 +446,17 @@

 | ssh_compression | long |

+| ssh_host_public_key_sha256 | string |
+
+| telnetoptions | list |
+
+| ws_options | mask | binary, close, cont, offset, ping, pong, raw_mode, text
+
 | new_file_perms | long |

 | new_directory_perms | long |

-| telnetoptions | list |
+| quick_exit | long |

 |===
 // end::url_options[]
@@ -123,6 +123,39 @@ Examples:
    /auth user2 ${weechat_config_dir}/ecdsa2.pem
 ----

+[[command_irc_autojoin]]
+* `+autojoin+`: configure the "autojoin" server option
+
+----
+/autojoin  add [<channel1> [<channel2>...]]
+           addraw <channel1>[,<channel2>...] [<key1>[,<key2>...]]
+           del [<channel1> [<channel2>...]]
+           apply
+           join
+           sort
+
+    add: add current channel or a list of channels (with optional keys) to the autojoin option; if you are on the channel and the key is not provided, the key is read in the channel
+ addraw: use the IRC raw format (same as /join command): all channels separated by commas, optional keys separated by commas
+    del: delete current channel or a list of channels from the autojoin option
+channel: channel name
+    key: key for the channel
+  apply: set currently joined channels in the autojoin option
+   join: join the channels in the autojoin option
+   sort: sort alphabetically channels in the autojoin option
+
+Examples:
+  /autojoin add
+  /autojoin add #test
+  /autojoin add #chan1 #chan2
+  /allchan /autojoin add
+  /autojoin addraw #chan1,#chan2,#chan3 key1,key2
+  /autojoin del
+  /autojoin del #chan1
+  /autojoin apply
+  /autojoin join
+  /autojoin sort
+----
+
 [[command_irc_ban]]
 * `+ban+`: ban nicks or hosts

@@ -146,7 +179,7 @@ Without argument, this command displays the ban list for current channel.

   ls: list the capabilities supported by the server
 list: list the capabilities currently enabled
-  req: request a capability
+  req: request a new capability or remove a capability (if starting with "-", for example: "-multi-prefix")
  ack: acknowledge capabilities which require client-side acknowledgement
  end: end the capability negotiation

@@ -157,8 +190,14 @@ Capabilities supported by WeeChat are: account-notify, away-notify, cap-notify,
 The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).

 Examples:
-   /cap
-   /cap req multi-prefix away-notify
+  display supported and enabled capabilities:
+    /cap
+  request capabilities multi-prefix and away-notify:
+    /cap req multi-prefix away-notify
+  request capability extended-join, remove capability multi-prefix:
+    /cap req extended-join -multi-prefix
+  remove capability away-notify:
+    /cap req -away-notify
 ----

 [[command_irc_connect]]
@@ -414,6 +453,16 @@ Example:
 reason: reason
 ----

+[[command_irc_knock]]
+* `+knock+`: send a notice to an invitation-only channel, requesting an invite
+
+----
+/knock  <channel> [<message>]
+
+channel: channel name
+message: message to send
+----
+
 [[command_irc_links]]
 * `+links+`: list all server names which are known by the server answering the query

@@ -708,6 +757,12 @@ channel: channel name
 target: server name
 ----

+[[command_irc_rules]]
+* `+rules+`: request the server rules
+
+----
+----
+
 [[command_irc_sajoin]]
 * `+sajoin+`: force a user to join channel(s)

@@ -1037,11 +1092,13 @@ target: reply should match this mask
        add <alias> [<command>[;<command>...]]
        addcompletion <completion> <alias> [<command>[;<command>...]]
        del <alias> [<alias>...]
+        rename <alias> <new_alias>

         list: list aliases (without argument, this list is displayed)
          add: add an alias
 addcompletion: add an alias with a custom completion
          del: delete an alias
+       rename: rename an alias
   completion: completion for alias: by default completion is done with target command
               note: you can use %%command to use completion of an existing command
        alias: name of alias
@@ -1062,12 +1119,27 @@ Examples:
    /alias add split /window splith
  alias /hello to say "hello" on all channels but not on #weechat:
    /alias add hello /allchan -exclude=#weechat hello
+  rename alias "hello" to "Hello":
+    /alias rename hello Hello
  alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
    /alias addcompletion %%sajoin forcejoin /quote forcejoin
 ----
 // end::alias_commands[]

 // tag::weechat_commands[]
+[[command_weechat_allbuf]]
+* `+allbuf+`: execute a command on all buffers
+
+----
+/allbuf  <command>
+
+command: command to execute (or text to send to buffer if command does not start with '/')
+
+Examples:
+  set unread marker on all buffers:
+    /allbuf /buffer set unread
+----
+
 [[command_weechat_away]]
 * `+away+`: set or remove away status

@@ -1144,6 +1216,8 @@ Examples:
         unmerge [<number>|-all]
         hide [<number>|<name>|-all [<number>|<name>...]]
         unhide [<number>|<name>|-all [<number>|<name>...]]
+         switch [-previous]
+         zoom
         renumber [<number1> [<number2> [<start>]]]
         close [<n1>[-<n2>]|<name>...]
         notify [<level>]
@@ -1152,6 +1226,7 @@ Examples:
         delvar <name>
         set <property> [<value>]
         get <property>
+         jump smart|last_displayed|prev_visited|next_visited
         <number>|-|+|<name>

    list: list buffers (without argument, this list is displayed)
@@ -1165,6 +1240,8 @@ Examples:
 unmerge: unmerge buffer from other buffers which have same number
    hide: hide the buffer
  unhide: unhide the buffer
+  switch: switch to next merged buffer (or to previous buffer with "-previous")
+    zoom: zoom on merged buffer
 renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumber is off)
   close: close buffer (number/range or name is optional)
  notify: display or set notify level for current buffer: this level determines whether buffer will be added to hotlist or not:
@@ -1178,6 +1255,11 @@ renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumb
  delvar: delete a local variable from the current buffer
     set: set a property in the current buffer
     get: display a property of current buffer
+    jump: jump to another buffer:
+          smart: next buffer with activity
+          last_displayed: last buffer displayed (before last jump to a buffer)
+          prev_visited: previously visited buffer
+          next_visited: jump to next visited buffer
  number: jump to buffer by number, possible prefix:
          '+': relative jump, add number to current
          '-': relative jump, sub number to current
@@ -1302,32 +1384,40 @@ Examples:
 ----
 /debug  list
        set <plugin> <level>
-        dump [<plugin>]
-        buffer|color|infolists|libs|certs|memory|tags|term|windows
+        dump|hooks [<plugin>]
+        buffer|certs|color|dirs|infolists|libs|memory|tags|term|windows
        mouse|cursor [verbose]
        hdata [free]
        time <command>
+        unicode <string>

     list: list plugins with debug levels
      set: set debug level for plugin
   plugin: name of plugin ("core" for WeeChat core)
    level: debug level for plugin (0 = disable debug)
     dump: save memory dump in WeeChat log file (same dump is written when WeeChat crashes)
+    hooks: display infos about hooks (with a plugin: display detailed info about hooks created by the plugin)
   buffer: dump buffer content with hexadecimal values in log file
+    certs: display number of loaded trusted certificate authorities
    color: display infos about current color pairs
   cursor: toggle debug for cursor mode
     dirs: display directories
    hdata: display infos about hdata (with free: remove all hdata in memory)
-    hooks: display infos about hooks
 infolists: display infos about infolists
     libs: display infos about external libraries used
-    certs: display number of loaded trusted certificate authorities
   memory: display infos about memory usage
    mouse: toggle debug for mouse
     tags: display tags for lines
     term: display infos about terminal
  windows: display windows tree
     time: measure time to execute a command or to send text to the current buffer
+  unicode: display information about string and unicode chars (evaluated, see /help eval)
+
+Examples:
+  /debug set irc 1
+  /debug mouse verbose
+  /debug time /filter toggle
+  /debug unicode ${chars:${\u26C0}-${\u26CF}}
 ----

 [[command_weechat_eval]]
@@ -1374,33 +1464,36 @@ To force a string comparison, you can add double quotes around each expression,
  "50" > "100"  ==> 1

 Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
-  1. the string itself without evaluation (format: "raw:xxx")
-  2. a user-defined variable (format: "name")
-  3. an evaluated sub-string (format: "eval:xxx")
-  4. an evaluated condition (format: "eval_cond:xxx")
-  5. a string with escaped chars (format: "esc:xxx" or "\xxx")
-  6. a string with chars to hide (format: "hide:char,string")
-  7. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
+  - the string itself without evaluation (format: "raw:xxx")
+  - a user-defined variable (format: "name")
+  - an evaluated sub-string (format: "eval:xxx")
+  - an evaluated condition (format: "eval_cond:xxx")
+  - a string with escaped chars (format: "esc:xxx" or "\xxx")
+  - a string with a range of chars (format: "chars:xxx" or "chars:c1-c2" where "xxx" is one of: "digit", "xdigit", "lower", "upper", "alpha", "alnum")
+  - a string converted to lower case (format: "lower:xxx")
+  - a string converted to upper case (format: "upper:xxx")
+  - a string with chars to hide (format: "hide:char,string")
+  - a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
     or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
-  8. a reversed string (format: "rev:xxx" or "revscr:xxx")
-  9. a repeated string (format: "repeat:count,string")
-  10. length of a string (format: "length:xxx" or "lengthscr:xxx")
-  11. split of a string (format: "split:number,separators,flags,xxx")
-  12. split of shell argmuents (format: "split_shell:number,xxx")
-  13. a color (format: "color:xxx", see "Plugin API reference", function "color")
-  14. a modifier (format: "modifier:name,data,string")
-  15. an info (format: "info:name,arguments", arguments are optional)
-  16. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
-  17. current date/time (format: "date" or "date:format")
-  18. an environment variable (format: "env:XXX")
-  19. a ternary operator (format: "if:condition?value_if_true:value_if_false")
-  20. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
-  21. a random integer number (format: "random:min,max")
-  22. a translated string (format: "translate:xxx")
-  23. define a user variable (format: "define:name,value")
-  24. an option (format: "file.section.option")
-  25. a local variable in buffer
-  26. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
+  - a reversed string (format: "rev:xxx" or "revscr:xxx")
+  - a repeated string (format: "repeat:count,string")
+  - length of a string (format: "length:xxx" or "lengthscr:xxx")
+  - split of a string (format: "split:number,separators,flags,xxx")
+  - split of shell argmuents (format: "split_shell:number,xxx")
+  - a color (format: "color:xxx", see "Plugin API reference", function "color")
+  - a modifier (format: "modifier:name,data,string")
+  - an info (format: "info:name,arguments", arguments are optional)
+  - a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
+  - current date/time (format: "date" or "date:format")
+  - an environment variable (format: "env:XXX")
+  - a ternary operator (format: "if:condition?value_if_true:value_if_false")
+  - result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
+  - a random integer number (format: "random:min,max")
+  - a translated string (format: "translate:xxx")
+  - define a user variable (format: "define:name,value")
+  - an option (format: "file.section.option")
+  - a local variable in buffer
+  - a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
 Format for hdata can be one of following:
  hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
  hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, for example:
@@ -1423,6 +1516,10 @@ Examples (simple strings):
  /eval -n ${window.buffer.full_name}             ==> core.weechat
  /eval -n ${window.buffer.number}                ==> 1
  /eval -n ${\t}                                  ==> <tab>
+  /eval -n ${chars:digit}                         ==> 0123456789
+  /eval -n ${chars:J-T}                           ==> JKLMNOPQRST
+  /eval -n ${lower:TEST}                          ==> test
+  /eval -n ${upper:test}                          ==> TEST
  /eval -n ${hide:-,${relay.network.password}}    ==> --------
  /eval -n ${cut:3,+,test}                        ==> tes+
  /eval -n ${cut:+3,+,test}                       ==> te+
@@ -1468,7 +1565,7 @@ Examples (conditions):
         add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
         rename <name> <new_name>
         recreate <name>
-         del <name>|-all
+         del <name>|-all [<name>...]

      list: list all filters
    enable: enable filters (filters are enabled by default)
@@ -1552,6 +1649,22 @@ clear: clear history
 value: number of history entries to show
 ----

+[[command_weechat_hotlist]]
+* `+hotlist+`: manage hotlist
+
+----
+/hotlist  add [low|message|private|highlight]
+          clear [<level>]
+          remove
+          restore [-all]
+
+    add: add current buffer in hotlist (default level: "low", conditions defined in option weechat.look.hotlist_add_conditions are NOT checked)
+  clear: clear hotlist
+  level: "lowest" to clear only lowest level in hotlist, highest" to clear only highest level in hotlist, or level mask: integer which is a combination of 1=join/part, 2=message, 4=private, 8=highlight)
+ remove: remove current buffer from hotlist
+restore: restore latest hotlist removed in the current buffer (or all buffers with -all)
+----
+
 [[command_weechat_input]]
 * `+input+`: functions for command line

@@ -1574,6 +1687,7 @@ list of actions:
  delete_previous_char: delete previous char
  delete_next_char: delete next char
  delete_previous_word: delete previous word
+  delete_previous_word_whitespace: delete previous word (until whitespace)
  delete_next_word: delete next word
  delete_beginning_of_line: delete from beginning of line until cursor
  delete_end_of_line: delete from cursor until end of line
@@ -1592,23 +1706,10 @@ list of actions:
  history_next: recall next command in current buffer history
  history_global_previous: recall previous command in global history
  history_global_next: recall next command in global history
-  jump_smart: jump to next buffer with activity
-  jump_last_buffer_displayed: jump to last buffer displayed (before last jump to a buffer)
-  jump_previously_visited_buffer: jump to previously visited buffer
-  jump_next_visited_buffer: jump to next visited buffer
-  hotlist_clear: clear hotlist (optional argument: "lowest" to clear only lowest level in hotlist, "highest" to clear only highest level in hotlist, or level mask: integer which is a combination of 1=join/part, 2=message, 4=private, 8=highlight)
-  hotlist_remove_buffer: remove current buffer from hotlist
-  hotlist_restore_buffer: restore latest hotlist removed in the current buffer
-  hotlist_restore_all: restore latest hotlist removed in all buffers
  grab_key: grab a key (optional argument: delay for end of grab, default is 500 milliseconds)
  grab_key_command: grab a key with its associated command (optional argument: delay for end of grab, default is 500 milliseconds)
  grab_mouse: grab mouse event code
  grab_mouse_area: grab mouse event code with area
-  set_unread: set unread marker for all buffers
-  set_unread_current_buffer: set unread marker for current buffer
-  switch_active_buffer: switch to next merged buffer
-  switch_active_buffer_previous: switch to previous merged buffer
-  zoom_merged_buffer: zoom on merged buffer
  insert: insert text in command line (escaped chars are allowed, see /help print)
  send: send text to the buffer
  paste_start: start paste (bracketed paste mode)
@@ -1617,6 +1718,49 @@ list of actions:
 This command is used by key bindings or plugins.
 ----

+[[command_weechat_item]]
+* `+item+`: manage custom bar items
+
+----
+/item  list
+       add|addreplace <name> "<conditions>" "<content>"
+       rename <name> <new_name>
+       refresh <name> [<name>...]
+       recreate <name>
+       del <name>|-all
+
+      list: list all custom bar items
+       add: add a custom bar item
+addreplace: add or replace an existing custom bar item
+      name: custom bar item name
+conditions: evaluated conditions to display the bar item (for example to display the bar item only in specific buffers)
+   content: content (evaluated, see /help eval)
+    rename: rename a custom bar item
+   refresh: update content of item in all bars where the item is displayed; any item can be refreshed: default/plugin/custom bar items
+  recreate: set input with the command used to edit the custom bar item
+       del: delete a custom bar item
+      -all: delete all custom bar items
+
+Examples:
+  add item with terminal size, displayed only in buffers with number = 1:
+    /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}"
+  add item with buffer info:
+    /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}"
+  add item with date/time using format "Dec 25, 12:34 +0100", refreshed every minute:
+    /item add datetime "" "${date:%b %d, %H:%M %z}"
+    /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime"
+  add item with number of lines in buffer (displayed/total), refreshed each time a new line is displayed or if filtered lines have changed:
+    /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines"
+    /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count"
+    /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count"
+  force refresh of item "lines_count":
+    /item refresh lines_count
+  recreate item "lines_count" with different conditions or content:
+    /item recreate lines_count
+  delete item "lines_count":
+    /item del lines_count
+----
+
 [[command_weechat_key]]
 * `+key+`: bind/unbind keys

@@ -1667,7 +1811,7 @@ Examples:
  restore default binding for key alt-r:
    /key reset meta-r
  key "tab" to stop search in buffer:
-    /key bindctxt search ctrl-I /input search_stop
+    /key bindctxt search ctrl-i /input search_stop
  middle button of mouse on a nick to retrieve info on nick:
    /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
 ----
@@ -2039,19 +2183,22 @@ Examples:
 ----

 [[command_weechat_upgrade]]
-* `+upgrade+`: reload the WeeChat binary without disconnecting from servers
+* `+upgrade+`: save WeeChat session and reload the WeeChat binary without disconnecting from servers

 ----
-/upgrade  [-yes] [<path_to_binary>|-quit]
+/upgrade  [-yes] [<path_to_binary>|-save|-quit]

          -yes: required if option "weechat.look.confirm_upgrade" is enabled
 path_to_binary: path to WeeChat binary (default is current binary)
        -dummy: do nothing (option used to prevent accidental completion with "-quit")
+         -save: only save the session, do not quit nor reload WeeChat; the configuration files are not saved (if needed you can use /save before this command)
         -quit: close *ALL* connections, save session and quit WeeChat, which makes possible a delayed restoration (see below)

 This command upgrades and reloads a running WeeChat session. The new WeeChat binary must have been compiled or installed with a package manager before running this command.

-Note: SSL connections are lost during upgrade, because reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
+Note: SSL connections are lost during upgrade (except with -save), because the reload of SSL sessions is currently not possible with GnuTLS. There is automatic reconnection after upgrade.
+
+Important: use of option -save can be dangerous, it is recommended to use only /upgrade (or with -quit) for a standard upgrade and a restart; the option -save can be used to save the session regularly and restore it in case of after abnormal exit (power outage, crash, etc.)

 Upgrade process has 4 steps:
  1. save session into files for core and plugins (buffers, history, ..)
@@ -2059,14 +2206,18 @@ Upgrade process has 4 steps:
  3. save WeeChat configuration (weechat.conf)
  4. execute new WeeChat binary and reload session.

-With option "-quit", the process is slightly different:
+With option "-quit", the process is:
  1. close *ALL* connections (irc, xfer, relay, ...)
  2. save session into files (*.upgrade)
  3. unload all plugins
  4. save WeeChat configuration
  5. quit WeeChat
-Then later you can restore session with command: weechat --upgrade
-IMPORTANT: you must restore the session with exactly same configuration (files *.conf).
+
+With option "-save", the process is:
+  1. save session into files (*.upgrade) with a disconnected state for IRC servers and Relay clients (but no disconnection is made)
+
+With -quit or -save, you can restore the session later with this command: weechat --upgrade
+IMPORTANT: you must restore the session with exactly same configuration (files *.conf) and if possible the same WeeChat version (or a more recent one).
 It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
 ----

@@ -2251,6 +2402,7 @@ The following variables can be used in these options:
    - ${format_hotlist}: the formatted hotlist (evaluation of option buflist.format.hotlist)
    - ${hotlist}: the raw hotlist
    - ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
+    - ${hotlist_priority_number}: -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight
    - ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
    - ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
 ----
@@ -2498,7 +2650,7 @@ Keys and input to set options on fset buffer:
                    u:xxx   unmark options displayed that are matching filter "xxx" (any filter on option or value is allowed, see filters above)

 Other keys and input on fset buffer:
-  ctrl+L                    refresh options and whole screen (command: /fset -refresh)
+  ctrl+l                    refresh options and whole screen (command: /fset -refresh)
                    $       refresh options (keep marked options)
                    $$      refresh options (unmark all options)
  alt+p             p       toggle plugin description options (plugins.desc.*)
@@ -2508,7 +2660,7 @@ Other keys and input on fset buffer:
                    w:xxx   export options in file "xxx"
                    w-:xxx  export options in file "xxx" without help
                    w+:xxx  export options in file "xxx" with help
-  ctrl+X            x       switch the format used to display options
+  ctrl+x            x       switch the format used to display options
                    q       close fset buffer

 Mouse actions on fset buffer:
@@ -2817,7 +2969,7 @@ protocol.name: protocol and name to relay:
                 - protocol "weechat" (name is not used)

 The "irc" protocol allows any IRC client (including WeeChat itself) to connect on the port.
-The "weechat" protocol allows a remote interface to connect on the port, see the list here: https://weechat.org/about/interfaces
+The "weechat" protocol allows a remote interface to connect on the port, see the list here: https://weechat.org/about/interfaces/

 Without argument, this command opens buffer with list of relay clients.

@@ -2972,7 +3124,7 @@ Examples:
 ----
 /spell  enable|disable|toggle
        listdict
-        setdict <dict>[,<dict>...]
+        setdict -|<dict>[,<dict>...]
        deldict
        addword [<dict>] <word>

@@ -2980,7 +3132,7 @@ Examples:
 disable: disable spell checker
  toggle: toggle spell checker
 listdict: show installed dictionaries
- setdict: set dictionary for current buffer (multiple dictionaries can be separated by a comma)
+ setdict: set dictionary for current buffer (multiple dictionaries can be separated by a comma, the special value "-" disables spell checking on current buffer)
 deldict: delete dictionary used on current buffer
 addword: add a word in personal dictionary

@@ -3109,6 +3261,8 @@ Examples (you can also look at default triggers with /trigger listdefault):
    /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
  silently save config each hour:
    /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
+  silently save WeeChat session at midnight (see /help upgrade):
+    /trigger add session_save signal day_changed "" "" "/mute /upgrade -save"
  open trigger monitor and show only modifiers and triggers whose name starts with "resize":
    /trigger monitor @modifier,resize*
 ----
@@ -8,37 +8,37 @@
 |===
 | Alias | Command | Completion

-| /AAWAY | /allserv /away | -
-| /ANICK | /allserv /nick | -
-| /BEEP | /print -beep | -
-| /BYE | /quit | -
-| /C | /buffer clear | -
-| /CL | /buffer clear | -
-| /CLOSE | /buffer close | -
-| /CHAT | /dcc chat | -
-| /EXIT | /quit | -
-| /IG | /ignore | -
-| /J | /join | -
-| /K | /kick | -
-| /KB | /kickban | -
-| /LEAVE | /part | -
-| /M | /msg | -
-| /MUB | /unban * | -
-| /MSGBUF | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
-| /N | /names | -
-| /Q | /query | -
-| /REDRAW | /window refresh | -
-| /SAY | /msg * | -
-| /SIGNOFF | /quit | -
-| /T | /topic | -
-| /UB | /unban | -
-| /UMODE | /mode $nick | -
-| /V | /command core version | -
-| /W | /who | -
-| /WC | /window close | -
-| /WI | /whois | -
-| /WII | /whois $1 $1 | -
-| /WM | /window merge | -
-| /WW | /whowas | -
+| /aaway | /allserv /away | -
+| /anick | /allserv /nick | -
+| /beep | /print -beep | -
+| /bye | /quit | -
+| /c | /buffer clear | -
+| /cl | /buffer clear | -
+| /close | /buffer close | -
+| /chat | /dcc chat | -
+| /exit | /quit | -
+| /ig | /ignore | -
+| /j | /join | -
+| /k | /kick | -
+| /kb | /kickban | -
+| /leave | /part | -
+| /m | /msg | -
+| /mub | /unban * | -
+| /msgbuf | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
+| /n | /names | -
+| /q | /query | -
+| /redraw | /window refresh | -
+| /say | /msg * | -
+| /signoff | /quit | -
+| /t | /topic | -
+| /ub | /unban | -
+| /umode | /mode $nick | -
+| /v | /command core version | -
+| /w | /who | -
+| /wc | /window close | -
+| /wi | /whois | -
+| /wii | /whois $1 $1 | -
+| /wm | /window merge | -
+| /ww | /whowas | -
 |===
 // end::default_aliases[]
@@ -1,6 +1,6 @@
 // tag::plugin_options[]
 For complete doc on plugin options, please look at plugins documentation in
-https://weechat.org/doc[WeeChat user's guide].
+https://weechat.org/doc/[WeeChat user's guide].

 With irc plugin, you can connect to temporary server with an URL like:

@@ -100,7 +100,7 @@ $HOME/.local/share/weechat/weechat.log::
 WeeChat is written by Sébastien Helleu and contributors (complete list is in
 the AUTHORS.adoc file).

-Copyright (C) 2003-2021 {author}
+Copyright (C) 2003-2023 {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
@@ -60,4 +60,4 @@ include::includes/man.en.adoc[tag=copyright]

 == SUPPORT / REPORTING BUGS

-For help or a bug report: https://weechat.org/about/support
+For help or a bug report: https://weechat.org/about/support/
@@ -57,4 +57,4 @@ include::includes/man.en.adoc[tag=copyright]

 == SUPPORT / REPORTING BUGS

-For help or a bug report: https://weechat.org/about/support
+For help or a bug report: https://weechat.org/about/support/
@@ -10,8 +10,8 @@

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

-Latest version of this document can be found on this page:
-https://weechat.org/doc
+Latest version of this document can be found on
+https://weechat.org/doc/[this page ^↗^,window=_blank].


 [[introduction]]
@@ -31,8 +31,8 @@ This manual documents WeeChat internals:
 [[repositories]]
 == Repositories

-WeeChat repositories are on GitHub organization "weechat":
-https://github.com/weechat
+WeeChat repositories are on GitHub organization
+https://github.com/weechat[weechat ^↗^,window=_blank].

 List of repositories:

@@ -43,7 +43,7 @@ scripts::
    the _official_ scripts submitted on weechat.org

 weechat.org::
-    source of WeeChat website: https://weechat.org/
+    source of https://weechat.org/[WeeChat website ^↗^,window=_blank]

 weercd::
    IRC testing server
@@ -284,6 +284,7 @@ WeeChat "core" is located in following directories:
 |       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-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, ...).
@@ -296,6 +297,7 @@ WeeChat "core" is located in following directories:
 |       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).
@@ -403,6 +405,7 @@ WeeChat "core" is located in following directories:
 |       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.
@@ -420,7 +423,13 @@ WeeChat "core" is located in following directories:
 |          test-core-utf8.cpp         | Tests: UTF-8.
 |          test-core-util.cpp         | Tests: utility functions.
 |       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.
@@ -430,12 +439,16 @@ WeeChat "core" is located in following directories:
 |             test-irc-color.cpp      | Tests: IRC colors.
 |             test-irc-config.cpp     | Tests: IRC configuration.
 |             test-irc-ignore.cpp     | Tests: IRC ignores.
+|             test-irc-join.cpp       | Tests: IRC join functions.
 |             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-backlog.cpp | Tests: logger backlog.
 |          trigger/                   | Root of unit tests for trigger plugin.
 |             test-trigger.cpp        | Tests: triggers.
 |             test-trigger-config.cpp | Tests: trigger configuration.
@@ -444,6 +457,9 @@ WeeChat "core" is located in following directories:
 |             test-typing-status.cpp  | Tests: typing status.
 |          relay/                     | Root of unit tests for Relay plugin.
 |             test-relay-auth.cpp     | Tests: clients authentication.
+|          xfer/                      | Root of unit tests for Xfer plugin.
+|             test-xfer-file.cpp      | Tests: file functions.
+|             test-xfer-network.cpp   | Tests: network functions.
 |===

 [[documentation_translations]]
@@ -459,13 +475,13 @@ Documentation files:
 |    docgen.py                                  | Python script to build auto-generated files in _includes/_ directory (see below).
 |    XX/                                        | Documentation for language XX (languages: en, fr, de, it, ...).
 |       weechat.1.XX.adoc                       | Man page (`man weechat`).
-|       weechat_dev.XX.adoc                     | link:weechat_dev.en.html[Developer's guide] (this document).
-|       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_scripting.XX.adoc               | link:weechat_scripting.en.html[Scripting guide].
-|       weechat_user.XX.adoc                    | link:weechat_user.en.html[User's guide].
+|       weechat_dev.XX.adoc                     | link:weechat_dev.en.html[Developer's guide ^↗^,window=_blank] (this document).
+|       weechat_faq.XX.adoc                     | link:weechat_faq.en.html[FAQ ^↗^,window=_blank].
+|       weechat_plugin_api.XX.adoc              | link:weechat_plugin_api.en.html[Plugin API reference ^↗^,window=_blank].
+|       weechat_quickstart.XX.adoc              | link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank].
+|       weechat_relay_protocol.XX.adoc          | link:weechat_relay_protocol.en.html[Relay protocol ^↗^,window=_blank] (for remote interfaces).
+|       weechat_scripting.XX.adoc               | link:weechat_scripting.en.html[Scripting guide ^↗^,window=_blank].
+|       weechat_user.XX.adoc                    | link:weechat_user.en.html[User's guide ^↗^,window=_blank].
 |       includes/                               | Files included in documentation.
 |          autogen_api_completions.XX.adoc      | Auto-generated file for Plugin API reference: completions (do *NEVER* update manually!).
 |          autogen_api_hdata.XX.adoc            | Auto-generated file for Plugin API reference: hdata (do *NEVER* update manually!).
@@ -515,7 +531,7 @@ Example in C:
 /*
 * weechat.c - core functions for WeeChat
 *
- * Copyright (C) 2021 Your Name <your@email.com>
+ * Copyright (C) 2023 Your Name <your@email.com>
 *
 * This file is part of WeeChat, the extensible chat client.
 *
@@ -730,7 +746,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd));
 [[coding_python_style]]
 === Python style

-See https://www.python.org/dev/peps/pep-0008/
+See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].

 [[core_internals]]
 == Core internals
@@ -907,6 +923,8 @@ In following table, these conventions are used:
 * `EXT`: extended color (`+@+` + 5 digits)
 * `(ATTR)EXT`: extended color with optional attributes (`+@+` + attributes + 5 digits)
 * `(ATTR)`: one or more attribute chars:
+** `+%+`: blink
+** `+.+`: "dim" (half bright)
 ** `+*+`: bold
 ** `+!+`: reverse
 ** `+/+`: italic
@@ -917,6 +935,8 @@ In following table, these conventions are used:
 ** _0x02_: reverse
 ** _0x03_: italic
 ** _0x04_: underline
+** _0x05_: blink
+** _0x06_: "dim" (half bright)

 All combinations are summarized in this table:

@@ -931,10 +951,10 @@ All combinations are summarized in this table:
 | [hex]#19# + `B` + `EXT`                           | [hex]#19# `+B@00124+`        | chat + bars | Set background (extended color).
 | [hex]#19# + `*` + `(ATTR)STD`                     | [hex]#19# `+*05+`            | chat + bars | Set foreground (WeeChat color).
 | [hex]#19# + `*` + `(ATTR)EXT`                     | [hex]#19# `+*@00214+`        | chat + bars | Set foreground (extended color).
-| [hex]#19# + `*` + `(ATTR)STD` + `,` + `STD` ^(1)^ | [hex]#19# `+*08,05+`         | chat + bars | Set foreground/background (WeeChat colors).
-| [hex]#19# + `*` + `(ATTR)STD` + `,` + `EXT` ^(1)^ | [hex]#19# `+*01,@00214+`     | chat + bars | Set foreground (WeeChat color) and background (extended color).
-| [hex]#19# + `*` + `(ATTR)EXT` + `,` + `STD` ^(1)^ | [hex]#19# `+*@00214,05+`     | chat + bars | Set foreground (extended color) and background (WeeChat color).
-| [hex]#19# + `*` + `(ATTR)EXT` + `,` + `EXT` ^(1)^ | [hex]#19# `+*@00214,@00017+` | chat + bars | Set foreground/background (extended colors).
+| [hex]#19# + `*` + `(ATTR)STD` + `,` + `STD` ^(1)^ | [hex]#19# `+*08,05+`         | chat + bars | Set foreground/background (WeeChat colors).
+| [hex]#19# + `*` + `(ATTR)STD` + `,` + `EXT` ^(1)^ | [hex]#19# `+*01,@00214+`     | chat + bars | Set foreground (WeeChat color) and background (extended color).
+| [hex]#19# + `*` + `(ATTR)EXT` + `,` + `STD` ^(1)^ | [hex]#19# `+*@00214,05+`     | chat + bars | Set foreground (extended color) and background (WeeChat color).
+| [hex]#19# + `*` + `(ATTR)EXT` + `,` + `EXT` ^(1)^ | [hex]#19# `+*@00214,@00017+` | chat + bars | Set foreground/background (extended colors).
 | [hex]#19# + `*` + `(ATTR)STD` + `~` + `STD`       | [hex]#19# `+*08~05+`         | chat + bars | Set foreground/background (WeeChat colors).
 | [hex]#19# + `*` + `(ATTR)STD` + `~` + `EXT`       | [hex]#19# `+*01~@00214+`     | chat + bars | Set foreground (WeeChat color) and background (extended color).
 | [hex]#19# + `*` + `(ATTR)EXT` + `~` + `STD`       | [hex]#19# `+*@00214~05+`     | chat + bars | Set foreground (extended color) and background (WeeChat color).
@@ -1106,7 +1126,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
 [[git_repository]]
 === Git repository

-Git repository is at this URL: https://github.com/weechat/weechat
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].

 Any patch for bug or new feature must be done on master branch, preferred way
 is a GitHub pull request. A patch can also be sent by e-mail
@@ -1120,11 +1140,92 @@ component: fix a problem (closes #123)

 Where _component_ is one of following:

-* WeeChat core: _core_ (files in root directory, _po/_ and _src/_,
-  except _src/plugins/_)
-* documentation files: _doc_ (files in directory _doc/_)
-* name of a plugin: _irc_, _python_, _relay_, ... (files in directory
-  _src/plugins/_)
+[width="100%",cols="1m,4m,5",options="header"]
+|===
+| Component | Files | Description
+
+| core
+| AUTHORS.adoc +
+  ChangeLog.adoc +
+  Contributing.adoc +
+  .github/FUNDING.yml +
+  .github/ISSUE_TEMPLATE/* +
+  icons/* +
+  po/* +
+  README.adoc +
+  ReleaseNotes.adoc +
+  src/core/* +
+  src/gui/* +
+  version.sh +
+  weechat.desktop
+| WeeChat core
+
+| build
+| CMakeLists.txt +
+  cmake/* +
+  tools/* +
+  weechat.cygport.in +
+  weechat.spec
+| Build
+
+| ci
+| .github/workflows/*
+| Continuous integration
+
+| debian
+| debian-devel/* +
+  debian-stable/*
+| Debian packaging
+
+| tests
+| tests/*
+| Tests
+
+| doc
+| doc/*
+| General doc updates, for example build
+
+| doc/man
+| doc/xx/weechat.1.xx.adoc +
+  doc/xx/weechat-headless.1.xx.adoc
+| Man pages
+
+| doc/faq
+| doc/xx/weechat_faq.xx.adoc
+| Frequently asked questions (FAQ)
+
+| doc/quickstart
+| doc/xx/weechat_quickstart.xx.adoc
+| Quickstart guide
+
+| doc/user
+| doc/xx/weechat_user.xx.adoc
+| User's guide
+
+| doc/scripting
+| doc/xx/weechat_scripting.xx.adoc
+| Scripting guide
+
+| doc/api
+| doc/xx/weechat_plugin_api.xx.adoc
+| Plugin API reference
+
+| doc/relay
+| doc/xx/weechat_relay_protocol.xx.adoc
+| Relay protocol
+
+| doc/dev
+| doc/xx/weechat_dev.en.adoc
+| Developer's guide
+
+| irc +
+  python +
+  relay +
+  …
+| src/plugins/<name>/*
+| Plugin
+
+|===

 Some rules to follow:

@@ -1138,6 +1239,7 @@ Examples of commit messages:
 ----
 core: add callback "nickcmp" for nick comparison in buffers
 core: update Japanese translations
+doc/user: add chapter on typing extension
 irc: add command /unquiet (closes #36)
 python: fix crash when unloading a script without pointer to interpreter
 ruby: add detection of ruby version 1.9.3 in CMake
@@ -1171,8 +1273,8 @@ $ make translations && make update-po

 Then you can edit .po files (if you can translate in a language).

-When done, you *have* to check your file with script _msgcheck.py_
-(https://github.com/flashcode/msgcheck):
+When done, you *have* to check your file with
+https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:

 ----
 $ msgcheck.py xx.po
@@ -9,9 +9,6 @@
 :docinfo1:


-This document is written for WeeChat versions ≥ 0.3.0 but should preferably be
-used with latest stable version of WeeChat.
-
 toc::[]


@@ -32,7 +29,8 @@ apply to WeeChat!).

 Because WeeChat is very light and brings innovating features.

-More info on the WeeChat features page: https://weechat.org/about/features
+More info on the WeeChat
+https://weechat.org/about/features/[features page ^↗^,window=_blank].

 [[compilation_install]]
 == Compilation / install
@@ -40,27 +38,24 @@ More info on the WeeChat features page: https://weechat.org/about/features
 [[gui]]
 === I've heard about many GUIs for WeeChat. How can I compile/use them?

-Some remote GUIs are available, see the remote interfaces page:
-https://weechat.org/about/interfaces
+Some remote GUIs are available, see the
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].

 [[compile_git]]
 === I can't compile WeeChat after cloning git repository, why?

-The recommended way to compile WeeChat is with
-link:weechat_user.en.html#compile_with_cmake[CMake].
+WeeChat must be compiled with CMake.

-If you're compiling with link:weechat_user.en.html#compile_with_autotools[autotools]
-(and not CMake), check that you have latest version of autoconf and automake.
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+and ensure all required dependencies are installed.

-The other way is to install the "devel package", which needs less dependencies.
-This package is built almost every day using git repository. Note that this
-package may not correspond exactly to git base and that it's less convenient
-than git cloning for installing updates.
+If you still have issues, please report them to the developers.

 [[compile_macos]]
 === How can I install WeeChat on macOS?

-It is recommended to use https://brew.sh/[Homebrew], you can get help with:
+It is recommended to use https://brew.sh/[Homebrew ^↗^,window=_blank],
+you can get help with:

 ----
 brew info weechat
@@ -76,12 +71,12 @@ brew install weechat
 === I've launched WeeChat, but I'm lost, what can I do?

 For help you can type `/help`. For help about a command, type `/help command`.
-link:weechat_user.en.html#key_bindings[Keys] and
-link:weechat_user.en.html#commands_and_options[commands] are listed
-in documentation.
+link:weechat_user.en.html#key_bindings[Keys ^↗^,window=_blank] and
+link:weechat_user.en.html#commands_and_options[commands ^↗^,window=_blank]
+are listed in documentation.

 It's recommended for new users to read the
-link:weechat_quickstart.en.html[Quickstart guide].
+link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank].

 [[display]]
 == Display
@@ -109,7 +104,7 @@ It's a common issue with a variety of causes, please read carefully and check
 ** If you are using screen, check that it is run with UTF-8 mode
   ("`defutf8 on`" in ~/.screenrc or `screen -U` to run screen).
 * Check that option
-  link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_]
+  link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
  is off (this option may cause display bugs).

 [NOTE]
@@ -124,10 +119,10 @@ This may be caused by a libc bug in function _wcwidth_, which should be fixed
 in glibc 2.22 (maybe not yet available in your distribution).

 There is a workaround to use the fixed _wcwidth_ function:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank]

-See this bug report for more information:
-https://github.com/weechat/weechat/issues/79
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+for more information.

 [[bars_background]]
 === Bars like title and status are not filled, background color stops after text, why?
@@ -184,17 +179,10 @@ windows.
 [[buffers_list]]
 === How to display the buffers list on the left side?

-With WeeChat ≥ 1.8, the plugin link:weechat_user.en.html#buflist_plugin[buflist]
+The plugin link:weechat_user.en.html#buflist[buflist ^↗^,window=_blank]
 is loaded and enabled by default.

-With an older version, you can install script _buffers.pl_:
-
----
-/script install buffers.pl
----
-
-To limit size of bar (replace "buflist" by "buffers" if you're using the script
-_buffers.pl_):
+To limit size of bar:

 ----
 /set weechat.bar.buflist.size_max 15
@@ -212,21 +200,6 @@ bar with your mouse wheel.
 Default keys to scroll _buflist_ bar are kbd:[F1] (or kbd:[Ctrl+F1]), kbd:[F2]
 (or kbd:[Ctrl+F2]), kbd:[Alt+F1] and kbd:[Alt+F2].

-For script _buffers.pl_, you can define keys, similar to the existing keys to
-scroll nicklist. +
-For example to use kbd:[F1], kbd:[F2], kbd:[Alt+F1] and kbd:[Alt+F2]:
-
----
-/key bind meta-OP /bar scroll buffers * -100%
-/key bind meta-OQ /bar scroll buffers * +100%
-/key bind meta-meta-OP /bar scroll buffers * b
-/key bind meta-meta-OQ /bar scroll buffers * e
----
-
-[NOTE]
-Keys "meta-OP" and "meta-OQ" may be different in your terminal. To find key
-code press kbd:[Alt+k] then key.
-
 [[customize_buflist]]
 === How can I customize the list of buffers list, like the color of the active buffer?

@@ -252,8 +225,8 @@ like `237` for dark gray.
 The buflist plugin provides lot of options that you can customize, please read
 the help on each option.

-There's also a wiki page with examples of advanced buflist configuration:
-https://github.com/weechat/weechat/wiki/buflist
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+with examples of advanced buflist configuration.

 [[customize_prefix]]
 === How can I reduce length of nicks or remove nick alignment in chat area?
@@ -296,8 +269,8 @@ These colors can be changed with the options __weechat.color.status_data_*__
 (buffers) and __weechat.color.status_count_*__ (counters). +
 Other hotlist options can be changed with the options __weechat.look.hotlist_*__.

-See link:weechat_user.en.html#screen_layout[User's guide / Screen layout] for
-more info about the hotlist.
+See link:weechat_user.en.html#screen_layout[User's guide / Screen layout ^↗^,window=_blank]
+for more info about the hotlist.

 [[input_bar_size]]
 === How to use command line with more than one line?
@@ -342,9 +315,8 @@ any bar:
 [[terminal_copy_paste]]
 === How can I copy/paste text without pasting nicklist?

-With WeeChat ≥ 1.0, you can use the bare display (default key: kbd:[Alt+l] (`L`)),
-which will show just the contents of the currently selected window,
-without any formatting.
+You can use the bare display (default key: kbd:[Alt+l] (`L`)), which shows
+just the contents of the currently selected window, without any formatting.

 You can use a terminal with rectangular selection (like rxvt-unicode,
 konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse
@@ -359,7 +331,7 @@ Another solution is to move nicklist to top or bottom, for example:
 [[urls]]
 === How can I click on long URLs (more than one line)?

-With WeeChat ≥ 1.0, you can use the bare display (default key: kbd:[Alt+l] (`L`)).
+You can use the bare display (default key: kbd:[Alt+l] (`L`)).

 To make opening URLs easier, you can:

@@ -369,7 +341,7 @@ To make opening URLs easier, you can:
 /set weechat.bar.nicklist.position top
 ----

-* disable alignment for multiline words (WeeChat ≥ 1.7):
+* disable alignment for multiline words:

 ----
 /set weechat.look.align_multiline_words off
@@ -381,9 +353,8 @@ To make opening URLs easier, you can:
 /set weechat.look.align_end_of_lines time
 ----

-With WeeChat ≥ 0.3.6, you can enable option "eat_newline_glitch", so that
-new line char is not added at the end of each line displayed (it will not break
-URL selection):
+You can enable option "eat_newline_glitch", so that new line char is not added
+at the end of each line displayed (it will not break URL selection):

 ----
 /set weechat.look.eat_newline_glitch on
@@ -430,8 +401,6 @@ In WeeChat, the new value is immediately used:
 [[use_256_colors]]
 === How can I use 256 colors in WeeChat?

-256 colors are supported with WeeChat ≥ 0.3.4.
-
 First check that your _TERM_ environment variable is correct, recommended values
 are:

@@ -450,20 +419,18 @@ term screen-256color
 ----

 If your _TERM_ variable has a wrong value and that WeeChat is already running,
-you can change it with these two commands (with WeeChat ≥ 1.0):
+you can change it with these two commands:

 ----
 /set env TERM screen-256color
 /upgrade
 ----

-For version 0.3.4, you must use command `/color` to add new colors.
+You can use any color number in options (optional: you can add color aliases
+with command `/color`).

-For versions ≥ 0.3.5, you can use any color number in options (optional: you
-can add color aliases with command `/color`).
-
-Please read the link:weechat_user.en.html#colors[User's guide / Colors] for more
-information about colors management.
+Please read the link:weechat_user.en.html#colors[User's guide / Colors ^↗^,window=_blank]
+for more information about colors management.

 [[search_text]]
 === How can I search text in buffer (like /lastlog in irssi)?
@@ -471,8 +438,8 @@ information about colors management.
 The default key is kbd:[Ctrl+r] (command is: `+/input search_text_here+`).
 And jump to highlights: kbd:[Alt+p] / kbd:[Alt+n].

-See link:weechat_user.en.html#key_bindings[User's guide / Key bindings] for more
-info about this feature.
+See link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank]
+for more info about this feature.

 [[terminal_focus]]
 === How can I execute commands when terminal gets/loses focus?
@@ -505,7 +472,7 @@ commands of your choice):
 For example to mark buffers as read when the terminal loses the focus:

 ----
-/key bind meta2-O /input set_unread
+/key bind meta2-O /allbuf /buffer set unread
 ----

 [[screen_paste]]
@@ -645,7 +612,7 @@ You can bind a key, for example:
 ----

 List of default keys is in
-link:weechat_user.en.html#key_bindings[User's guide / Key bindings].
+link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank].

 To jump to buffers with number ≥ 100, you could define a trigger and then use
 commands like `/123` to jump to buffer #123:
@@ -677,8 +644,6 @@ code press kbd:[Alt+k] then key.
 [[mouse_not_working]]
 === Mouse is not working at all, what can I do?

-Mouse is supported with WeeChat ≥ 0.3.6.
-
 First try to enable mouse:

 ----
@@ -728,12 +693,6 @@ you have to use kbd:[Alt] instead of kbd:[Shift]).
 If you are using macOS, you must install `openssl` from Homebrew.
 A CA file will be bootstrapped using certificates from the system keychain.

-With WeeChat ≤ 3.1, you can then set the path to system certificates:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
 If you see errors about gnutls handshake, you can try to use a smaller
 Diffie-Hellman key (default is 2048):

@@ -758,8 +717,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
 [[irc_ssl_handshake_error]]
 === When connecting to server with SSL, I only see the error "TLS handshake failed", what can I do?

-You can try a different priority string (WeeChat ≥ 0.3.5 only), replace "xxx"
-by your server name:
+You can try a different priority string, replace "xxx" by your server name:

 ----
 /set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
@@ -768,22 +726,8 @@ by your server name:
 [[irc_ssl_libera]]
 === How can I connect to libera server using SSL?

-With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
-certificates:
-
----
-/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
----
-
-Note: if you are running macOS with homebrew openssl installed, you can do:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
-[NOTE]
-Check that you have this file on your system (commonly brought by package
-"ca-certificates").
+Check that you have certificates installed on your system, this is commonly
+provided by the package "ca-certificates".

 Setup server port, SSL, then connect:

@@ -829,25 +773,35 @@ join of channels):
 [[edit_autojoin]]
 === How can I add/remove channels from autojoin option?

-You can use the `/set` command to edit the list of autojoin channels,
-for example for the "libera" server:
+With WeeChat ≥ 3.5, you can automatically record the channels you manually
+join and part in the "autojoin" server option.
+
+For all servers:

 ----
-/set irc.server.libera.autojoin [TAB]
+/set irc.server_default.autojoin_dynamic on
 ----

-[NOTE]
-You can complete the name and value of option with the kbd:[Tab] key
-(or kbd:[Shift+Tab] for partial completion, useful for the name). +
-This way you don't have to type the whole list of channels.
-
-You can also use the `/fset` command to edit the list of channels:
+For a single server:

 ----
-/fset autojoin
+/set irc.server.libera.autojoin_dynamic on
 ----

-Another solution is to use a script:
+You can also add the current channel in the "autojoin" server option using the
+`/autojoin` command:
+
+----
+/autojoin add
+----
+
+Or another channel:
+
+----
+/autojoin add #test
+----
+
+There are also scripts:

 ----
 /script search autojoin
@@ -887,14 +841,14 @@ With a global filter (hide *all* join/part/quit):

 [NOTE]
 For help: `/help filter`, `+/help irc.look.smart_filter+` and see
-link:weechat_user.en.html#irc_smart_filter_join_part_quit[User's guide / Smart filter for join/part/quit messages].
+link:weechat_user.en.html#irc_smart_filter_join_part_quit[User's guide / Smart filter for join/part/quit messages ^↗^,window=_blank].

 [[filter_irc_join_channel_messages]]
 === How can I filter some messages displayed when I join an IRC channel?

-With WeeChat ≥ 0.4.1, you can choose which messages are displayed when
-joining a channel with the option _irc.look.display_join_message_ (see
-`+/help irc.look.display_join_message+` for more info).
+You can choose which messages are displayed when joining a channel with the
+option _irc.look.display_join_message_ (see `+/help irc.look.display_join_message+`
+for more info).

 To hide messages (but keep them in buffer), you can filter them using the tag
 (for example _irc_329_ for channel creation date). See `/help filter` for help
@@ -949,17 +903,13 @@ nicks:
 /set irc.server_default.away_check_max_nicks 25
 ----

-[NOTE]
-For WeeChat ≤ 0.3.3, options are _irc.network.away_check_ and
-_irc.network.away_check_max_nicks_.
-
 [[highlight_notification]]
 === How can I be warned when someone highlights me on a channel?

-With WeeChat ≥ 1.0, there is a default trigger "beep" which sends a _BEL_ to
-the terminal on a highlight or private message. Thus you can configure your
-terminal (or multiplexer like screen/tmux) to run a command or play a sound
-when a _BEL_ occurs.
+There is a default trigger "beep" which sends a _BEL_ to the terminal on
+a highlight or private message. Thus you can configure your terminal
+(or multiplexer like screen/tmux) to run a command or play a sound when
+a _BEL_ occurs.

 Or you can add a command in "beep" trigger:

@@ -984,8 +934,8 @@ Other scripts on this subject:
 [[disable_highlights_for_specific_nicks]]
 === How can I disable highlights for specific nicks?

-With WeeChat ≥ 0.3.4 you can use the
-link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add]
+You can use the
+link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
 buffer property to set the max hotlist level for some nicks, per buffer,
 or per group of buffers (like IRC servers).

@@ -1021,7 +971,7 @@ For more examples, see `+/help buffer_autoset+`.
 [[irc_target_buffer]]
 === How can I change target buffer for commands on merged buffers (like buffer with servers)?

-The default key is kbd:[Ctrl+x] (command is: `+/input switch_active_buffer+`).
+The default key is kbd:[Ctrl+x] (command is: `+/buffer switch+`).

 [[plugins_scripts]]
 == Plugins / scripts
@@ -1041,8 +991,8 @@ You must set that up:
 [[install_scripts]]
 === How can I install scripts? Are scripts compatible with other IRC clients?

-With WeeChat ≥ 0.3.9 you can use the command `/script` to install and manage scripts
-(see `/help script` for help). For older versions there is weeget.py and script.pl.
+You can use the command `/script` to install and manage scripts (see `/help script`
+for help).

 Scripts are not compatible with other IRC clients.

@@ -1058,7 +1008,7 @@ $ rm ~/.cache/weechat/script/plugins.xml.gz
 ----

 [NOTE]
-With WeeChat ≤ 3.1, the path should be: _~/.weechat/script/plugins.xml.gz_.
+If you are not using the XDG directories, the path could be: _~/.weechat/script/plugins.xml.gz_.

 And update scripts again in WeeChat:

@@ -1100,10 +1050,6 @@ You have to reload the spell plugin:
 /plugin reload spell
 ----

-[NOTE]
-With WeeChat ≤ 2.4, the "spell" plugin was named "aspell", so the command is:
-`/plugin reload aspell`.
-
 [[settings]]
 == Settings

@@ -1188,7 +1134,7 @@ Unload and disable auto-loading of "xfer" plugin (used for IRC DCC):
 Define a passphrase and use secured data wherever you can for sensitive data
 like passwords: see `/help secure` and `/help` on options
 (if you can use secured data, it is written in the help).
-See also link:weechat_user.en.html#secured_data[User's guide / Secured data].
+See also link:weechat_user.en.html#secured_data[User's guide / Secured data ^↗^,window=_blank].

 For example:

@@ -1209,7 +1155,7 @@ contains your passwords ciphered with your passphrase.
 Some other files may contain sensitive info like passwords (if they are not
 stored in _sec.conf_ with the `/secure` command).

-See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories]
+See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories ^↗^,window=_blank]
 for more information about configuration files.

 [[development]]
@@ -1218,7 +1164,7 @@ for more information about configuration files.
 [[bug_task_patch]]
 === How should I report bugs, ask for new features or send patches?

-See: https://weechat.org/about/support
+See https://weechat.org/about/support/[this page ^↗^,window=_blank].

 [[gdb_error_threads]]
 === When I run WeeChat under gdb, there is an error about threads, what can I do?
@@ -1254,11 +1200,11 @@ some OS' we don't have, to test WeeChat.

 There are many tasks to do (testing, code, documentation, etc.)

-Please contact us via IRC or mail, look at support page:
-https://weechat.org/about/support
+Please contact us via IRC or mail, look at
+https://weechat.org/about/support/[support page ^↗^,window=_blank].

 [[donate]]
 === Can I give money or other things to WeeChat developers?

 You can give us money to help development.
-Details on https://weechat.org/donate
+Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
@@ -194,10 +194,15 @@ To auto-join some channels when connecting to server:
 /set irc.server.libera.autojoin "#channel1,#channel2"
 ----

-[TIP]
-You can complete name and value of options with the kbd:[Tab] key
-and kbd:[Shift+Tab] for a partial completion (useful for long words like
-the name of option).
+The `/autojoin` command lets you configure the _autojoin_ option easily
+(see `/help autojoin`).
+
+You can also configure WeeChat to automatically update the _autojoin_ option
+when you join or leave channels:
+
+----
+/set irc.server_default.autojoin_dynamic on
+----

 To remove a value of a server option, and use the default value instead,
 for example to use default nicks (irc.server_default.nicks):
@@ -213,6 +218,11 @@ option name):
 /set irc.server.libera.xxx value
 ----

+[TIP]
+You can complete name and value of options with the kbd:[Tab] key
+and kbd:[Shift+Tab] for a partial completion (useful for long words like
+the name of option).
+
 [[connect_to_irc_server]]
 == Connect to IRC server

@@ -370,13 +380,14 @@ for example:

 See `/help script` for more info.

-A list of scripts is available in WeeChat with `/script` or at this URL:
-https://weechat.org/scripts
+A list of scripts is available in WeeChat with `/script` or on
+https://weechat.org/scripts/[this page ^↗^,window=_blank].

 [[more_doc]]
 == More documentation

-You can now use WeeChat and read FAQ/documentation for any other questions:
-https://weechat.org/doc
+You can now use WeeChat and read
+https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+for any other questions.

 Enjoy using WeeChat!
@@ -84,7 +84,7 @@ Fields are:

 List of available commands (detail in next chapters):

-[width="100%",cols="^3m,14",options="header"]
+[width="100%",cols="1m,8",options="header"]
 |===
 | Command    | Description
 | handshake  | Handshake: prepare client authentication and set options, before _init_ command.
@@ -103,7 +103,7 @@ List of available commands (detail in next chapters):
 [[command_handshake]]
 === handshake

-_WeeChat ≥ 2.9._
+_WeeChat ≥ 2.9, updated in version 3.5._

 Perform an handshake between the client and WeeChat: this is required in most
 cases to know the session settings and prepare the authentication with the
@@ -127,10 +127,15 @@ Arguments:
 *** _sha512_: password salted and hashed with SHA512 algorithm
 *** _pbkdf2+sha256_: password salted and hashed with PBKDF2 algorithm (using SHA256 hash)
 *** _pbkdf2+sha512_: password salted and hashed with PBKDF2 algorithm (using SHA512 hash)
-** _compression_: compression type:
-*** _zlib_: enable _zlib_ compression for messages sent by _relay_
-    (enabled by default if _relay_ supports _zlib_ compression)
-*** _off_: disable compression
+** _compression_: list of supported compression types supported by the client
+   (separated by colons and sorted from most important to the fallback value);
+   if compression is enabled, messages from _relay_ to client are compressed
+   to save bandwidth; allowed values are:
+*** _off_: no compression (default if option is not given)
+*** _zlib_: compress with https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_
+*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]:
+    better compression and much faster than _zlib_ for both compression and decompression
+    _(WeeChat ≥ 3.5)_

 Notes about option _password_hash_algo_:

@@ -169,8 +174,9 @@ WeeChat replies with a hashtable containing the following keys and values:
  and the user password (the _relay_ nonce + the client nonce is the salt used
  in the password hash algorithm)
 * _compression_: compression type:
-** _zlib_: messages are compressed with _zlib_
 ** _off_: messages are not compressed
+** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^,window=_blank]
+** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]

 [TIP]
 With WeeChat ≤ 2.8, the command _handshake_ is not implemented, WeeChat silently
@@ -196,7 +202,7 @@ htb: {
    'password_hash_iterations': '100000',
    'totp': 'on',
    'nonce': '85B1EE00695A5B254E14F4885538DF0D',
-    'compression': 'zlib',
+    'compression': 'off',
 }
 ----

@@ -216,7 +222,7 @@ htb: {
    'password_hash_iterations': '100000',
    'totp': 'on',
    'nonce': '85B1EE00695A5B254E14F4885538DF0D',
-    'compression': 'zlib',
+    'compression': 'off',
 }
 ----

@@ -236,7 +242,7 @@ htb: {
    'password_hash_iterations': '100000',
    'totp': 'on',
    'nonce': '85B1EE00695A5B254E14F4885538DF0D',
-    'compression': 'zlib',
+    'compression': 'off',
 }
 ----

@@ -248,10 +254,11 @@ the password is "test" in this example:
 init password_hash=pbkdf2+sha256:85b1ee00695a5b254e14f4885538df0da4b73207f5aae4:100000:ba7facc3edb89cd06ae810e29ced85980ff36de2bb596fcf513aaab626876440
 ----

-* Only "sha256" and "sha512" are supported by the client, disable compression:
+* Only "sha256" and "sha512" are supported by the client, enable zstd (preferred)
+or zlib compression:

 ----
-(handshake) handshake password_hash_algo=sha256:sha512,compression=off
+(handshake) handshake password_hash_algo=sha256:sha512,compression=zstd:zlib
 ----

 Response:
@@ -264,14 +271,14 @@ htb: {
    'password_hash_iterations': '100000',
    'totp': 'on',
    'nonce': '85B1EE00695A5B254E14F4885538DF0D',
-    'compression': 'off',
+    'compression': 'zstd',
 }
 ----

 [[command_init]]
 === init

-_Updated in versions 2.4, 2.8, 2.9._
+_Updated in versions 2.4, 2.8, 2.9, 3.5._

 Authenticate with _relay_.

@@ -298,12 +305,6 @@ Arguments:
   factor, in addition to the password
   (option _relay.network.totp_secret_ in WeeChat)
   _(WeeChat ≥ 2.4)_
-** _compression_: compression type (*deprecated* since version 2.9, it is kept
-   for compatibility reasons but should be sent in the
-   <<command_handshake,handshake command>>):
-*** _zlib_: enable _zlib_ compression for messages sent by _relay_
-    (enabled by default if _relay_ supports _zlib_ compression)
-*** _off_: disable compression

 [NOTE]
 With WeeChat ≥ 1.6, commas can be escaped in the value, for example
@@ -690,6 +691,8 @@ inl:
        text_search_found: 0
        text_search_input: None
        highlight_words: None
+        highlight_disable_regex: None
+        highlight_disable_regex_compiled: '0x0'
        highlight_regex: None
        highlight_regex_compiled: '0x0'
        highlight_tags_restrict: None
@@ -992,7 +995,7 @@ Arguments:

 WeeChat replies with a hdata:

-[width="100%",cols="3m,2,10",options="header"]
+[width="100%",cols="2m,3,14",options="header"]
 |===
 | Name      | Type             | Description
 | context   | string           | Completion context: "null" (no completion), "command", "command_arg", "auto".
@@ -1260,24 +1263,24 @@ Syntax:

 Returned objects (in this order):

-[width="100%",cols="^3,3m,5m",options="header"]
+[width="80%",cols="1m,2,6m",options="header"]
 |===
-| Type              | Type (in message) | Value
-| char              | chr               | 65 ("A")
-| integer           | int               | 123456
-| integer           | int               | -123456
-| long              | lon               | 1234567890
-| long              | lon               | -1234567890
-| string            | str               | "a string"
-| string            | str               | ""
-| string            | str               | NULL
-| buffer            | buf               | "buffer"
-| buffer            | buf               | NULL
-| pointer           | ptr               | 0x1234abcd
-| pointer           | ptr               | NULL
-| time              | tim               | 1321993456
-| array of strings  | arr str           | [ "abc", "de" ]
-| array of integers | arr int           | [ 123, 456, 789 ]
+| Type    | Description       | Value
+| chr     | char              | 65 ("A")
+| int     | integer           | 123456
+| int     | integer           | -123456
+| lon     | long              | 1234567890
+| lon     | long              | -1234567890
+| str     | string            | "a string"
+| str     | string            | ""
+| str     | string            | NULL
+| buf     | buffer            | "buffer"
+| buf     | buffer            | NULL
+| ptr     | pointer           | 0x1234abcd
+| ptr     | pointer           | NULL
+| tim     | time              | 1321993456
+| arr str | array of strings  | [ "abc", "de" ]
+| arr int | array of integers | [ 123, 456, 789 ]
 |===

 [IMPORTANT]
@@ -1379,7 +1382,8 @@ Messages are sent as binary data, using following format (with size in bytes):
  (including this field)
 * _compression_ (byte): flag:
 ** _0x00_: following data is not compressed
-** _0x01_: following data is compressed with _zlib_
+** _0x01_: following data is compressed with https://zlib.net/[zlib ^↗^,window=_blank]
+** _0x02_: following data is compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
 * _id_ (string, 4 bytes + content): identifier sent by client (before command name); it can be
  empty (string with zero length and no content) if no identifier was given in
  command
@@ -1389,8 +1393,10 @@ Messages are sent as binary data, using following format (with size in bytes):
 [[message_compression]]
 === Compression

-If flag _compression_ is equal to 0x01, then *all* data after is compressed
-with _zlib_, and therefore must be uncompressed before being processed.
+If flag _compression_ is equal to 0x01 or 0x02, then *all* data after is compressed
+with https://zlib.net/[zlib ^↗^,window=_blank] or
+https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank],
+and therefore must be uncompressed before being processed.

 [[message_identifier]]
 === Identifier
@@ -1405,68 +1411,68 @@ WeeChat reserved identifiers:

 [width="100%",cols="5m,5,3,4,7",options="header"]
 |===
-| Identifier | Received with _sync_ | Data sent |
-  Description | Recommended action in client
+| Identifier | Received with _sync_ | Data sent
+| Description | Recommended action in client

-| _buffer_opened | buffers / buffer | hdata: buffer |
-  Buffer opened. | Open buffer.
+| _buffer_opened | buffers / buffer | hdata: buffer
+| Buffer opened. | Open buffer.

-| _buffer_type_changed | buffers / buffer | hdata: buffer |
-  Type of buffer changed. | Change type of buffer.
+| _buffer_type_changed | buffers / buffer | hdata: buffer
+| Type of buffer changed. | Change type of buffer.

-| _buffer_moved | buffers / buffer | hdata: buffer |
-  Buffer moved. | Move buffer.
+| _buffer_moved | buffers / buffer | hdata: buffer
+| Buffer moved. | Move buffer.

-| _buffer_merged | buffers / buffer | hdata: buffer |
-  Buffer merged. | Merge buffer.
+| _buffer_merged | buffers / buffer | hdata: buffer
+| Buffer merged. | Merge buffer.

-| _buffer_unmerged | buffers / buffer | hdata: buffer |
-  Buffer unmerged. | Unmerge buffer.
+| _buffer_unmerged | buffers / buffer | hdata: buffer
+| Buffer unmerged. | Unmerge buffer.

-| _buffer_hidden | buffers / buffer | hdata: buffer |
-  Buffer hidden. | Hide buffer.
+| _buffer_hidden | buffers / buffer | hdata: buffer
+| Buffer hidden. | Hide buffer.

-| _buffer_unhidden | buffers / buffer | hdata: buffer |
-  Buffer unhidden. | Unhide buffer.
+| _buffer_unhidden | buffers / buffer | hdata: buffer
+| Buffer unhidden. | Unhide buffer.

-| _buffer_renamed | buffers / buffer | hdata: buffer |
-  Buffer renamed. | Rename buffer.
+| _buffer_renamed | buffers / buffer | hdata: buffer
+| Buffer renamed. | Rename buffer.

-| _buffer_title_changed | buffers / buffer | hdata: buffer |
-  Title of buffer changed. | Change title of buffer.
+| _buffer_title_changed | buffers / buffer | hdata: buffer
+| Title of buffer changed. | Change title of buffer.

-| _buffer_localvar_added | buffers / buffer | hdata: buffer |
-  Local variable added. | Add local variable in buffer.
+| _buffer_localvar_added | buffers / buffer | hdata: buffer
+| Local variable added. | Add local variable in buffer.

-| _buffer_localvar_changed | buffers / buffer | hdata: buffer |
-  Local variable changed. | Change local variable in buffer.
+| _buffer_localvar_changed | buffers / buffer | hdata: buffer
+| Local variable changed. | Change local variable in buffer.

-| _buffer_localvar_removed | buffers / buffer | hdata: buffer |
-  Local variable removed. | Remove local variable from buffer.
+| _buffer_localvar_removed | buffers / buffer | hdata: buffer
+| Local variable removed. | Remove local variable from buffer.

-| _buffer_closing | buffers / buffer | hdata: buffer |
-  Buffer closing. | Close buffer.
+| _buffer_closing | buffers / buffer | hdata: buffer
+| Buffer closing. | Close buffer.

-| _buffer_cleared | buffer | hdata: buffer |
-  Buffer cleared. | Clear buffer.
+| _buffer_cleared | buffer | hdata: buffer
+| Buffer cleared. | Clear buffer.

-| _buffer_line_added | buffer | hdata: line |
-  Line added in buffer. | Display line in buffer.
+| _buffer_line_added | buffer | hdata: line
+| Line added in buffer. | Display line in buffer.

-| _nicklist | nicklist | hdata: nicklist_item |
-  Nicklist for a buffer. | Replace nicklist.
+| _nicklist | nicklist | hdata: nicklist_item
+| Nicklist for a buffer. | Replace nicklist.

-| _nicklist_diff | nicklist | hdata: nicklist_item |
-  Nicklist diffs for a buffer . | Update nicklist.
+| _nicklist_diff | nicklist | hdata: nicklist_item
+| Nicklist diffs for a buffer . | Update nicklist.

-| _pong | (always) | string: ping arguments |
-  Answer to a "ping". | Measure response time.
+| _pong | (always) | string: ping arguments
+| Answer to a "ping". | Measure response time.

-| _upgrade | upgrade | (empty) |
-  WeeChat is upgrading. | Desync from WeeChat (or disconnect).
+| _upgrade | upgrade | (empty)
+| WeeChat is upgrading. | Desync from WeeChat (or disconnect).

-| _upgrade_ended | upgrade | (empty) |
-  Upgrade of WeeChat done. | Sync/resync with WeeChat.
+| _upgrade_ended | upgrade | (empty)
+| Upgrade of WeeChat done. | Sync/resync with WeeChat.
 |===

 [[message_buffer_opened]]
@@ -2331,7 +2337,7 @@ commands sent on startup after the _init_.

 Objects are identified by 3 letters, called _type_. Following types are used:

-[width="100%",cols="^2m,5,10",options="header"]
+[width="100%",cols="1m,2,8",options="header"]
 |===
 | Type | Value                | Length
 | chr  | Signed char          | 1 byte
@@ -11,8 +11,8 @@

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

-Latest version of this document can be found on this page:
-https://weechat.org/doc
+Latest version of this document can be found on
+https://weechat.org/doc/[this page ^↗^,window=_blank].


 [[introduction]]
@@ -61,7 +61,7 @@ function, this can crash WeeChat. +
 If something must be run in background, the function `+hook_process+` can be used.
 See example in the chapter <<hook_process,Run a background process>>
 and the documentation on the function `+hook_process+` in the
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference].
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].

 [[languages_specificities]]
 === Languages specificities
@@ -74,7 +74,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/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].

 [[python_functions]]
 ===== Functions
@@ -99,45 +99,41 @@ receive a string of type `str` or `bytes` (this list is not exhaustive):
 |===
 | API function | Arguments | Examples | Description

-| hook_modifier |
-  irc_in_yyy |
-  pass:[irc_in_privmsg] +
-  pass:[irc_in_notice] |
-  A message received in IRC plugin, before it is decoded to UTF-8 (used
+| hook_modifier
+| irc_in_yyy
+| pass:[irc_in_privmsg] +
+  pass:[irc_in_notice]
+| A message received in IRC plugin, before it is decoded to UTF-8 (used
  internally). +
  +
  It is recommended to use modifier `+irc_in2_yyy+` instead, the string received
  is always UTF-8 valid. +
  See function `+hook_modifier+` in the
-  link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference].
+  link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference ^↗^,window=_blank].

-| hook_signal |
-  xxx,irc_out_yyy +
-  xxx,irc_outtags_yyy |
-  pass:[*,irc_out_privmsg] +
+| hook_signal
+| xxx,irc_out_yyy +
+  xxx,irc_outtags_yyy
+| pass:[*,irc_out_privmsg] +
  pass:[*,irc_out_notice] +
  pass:[*,irc_outtags_privmsg] +
-  pass:[*,irc_outtags_notice] |
-  A message sent by IRC plugin, after it is encoded to the `encode` charset
+  pass:[*,irc_outtags_notice]
+| A message sent by IRC plugin, after it is encoded to the `encode` charset
  defined by the user (if different from the default `UTF-8`). +
  +
  It is recommended to use signal `+xxx,irc_out1_yyy+` instead, the string received
  is always UTF-8 valid. +
  See function `+hook_signal+` in the
-  link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference].
+  link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference ^↗^,window=_blank].

 | hook_process +
-  hook_process_hashtable |
-  - |
-  - |
-  Output of the command, sent to the callback, can contain invalid UTF-8 data.
+  hook_process_hashtable
+| -
+| -
+| Output of the command, sent to the callback, can contain invalid UTF-8 data.

 |===

-In Python 2, which is now deprecated and should not be used any more, the
-strings sent to callbacks are always of type `str`, and may contain invalid
-UTF-8 data, in the cases mentioned above.
-
 [[language_perl]]
 ==== Perl

@@ -195,6 +191,22 @@ Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.

 Functions are called with `+weechat::xxx arg1 arg2 ...+`.

+[[tcl_null]]
+===== Null values
+
+Since Tcl only has string types, there's no null type to pass as an argument
+when a function accepts null values or to get as an argument in a callback
+function. To overcome this the WeeChat API defines the constant
+`$::weechat::WEECHAT_NULL` which acts as a null value. This constant is defined
+as `\uFFFF\uFFFF\uFFFFWEECHAT_NULL\uFFFF\uFFFF\uFFFF`, so it's very unlikely to
+appear unintentionally.
+
+You can pass this constant when a function accepts null as an argument and you
+will get it as the value of an argument in a callback function if the argument
+value is null. To see which functions accept null values and passes null values
+to callbacks, look at the Python prototypes in the
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+
 [[language_guile]]
 ==== Guile (Scheme)

@@ -370,7 +382,7 @@ directory is automatically created.
 == Differences with C API

 Script API is almost the same as C plugin API.
-You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference]
+You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank]
 for detail about each function in API: prototype, arguments, return values, examples.

 It's important to make difference between a _plugin_ and a _script_: a
@@ -537,25 +549,25 @@ weechat_hook_timer(1000, 0, 1, $timer_cb, 'test');
 == Script API

 For more information about functions in API, please read the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].

 [[script_api_functions]]
 === Functions

 List of functions in script API:

-[width="100%",cols="1,3",options="header"]
+[width="100%",cols="1,5",options="header"]
 |===
 | Category | Functions

-| general |
-  register
+| general
+| register

-| plugins |
-  plugin_get_name
+| plugins
+| plugin_get_name

-| strings |
-  charset_set +
+| strings
+| charset_set +
  iconv_to_internal +
  iconv_from_internal +
  gettext +
@@ -567,6 +579,7 @@ List of functions in script API:
  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 +
@@ -574,13 +587,13 @@ List of functions in script API:
  string_eval_expression +
  string_eval_path_home

-| directories |
-  mkdir_home +
+| directories
+| mkdir_home +
  mkdir +
  mkdir_parents

-| sorted lists |
-  list_new +
+| sorted lists
+| list_new +
  list_add +
  list_search +
  list_search_pos +
@@ -596,8 +609,8 @@ List of functions in script API:
  list_remove_all +
  list_free

-| configuration files |
-  config_new +
+| configuration files
+| config_new +
  config_new_section +
  config_search_section +
  config_new_option +
@@ -634,20 +647,21 @@ List of functions in script API:
  config_set_desc_plugin +
  config_unset_plugin

-| key bindings |
-  key_bind +
+| key bindings
+| key_bind +
  key_unbind

-| display |
-  prefix +
+| display
+| prefix +
  color +
  print (for python: prnt) +
  print_date_tags (for python: prnt_date_tags) +
  print_y (for python: prnt_y) +
+  print_y_date_tags (for python: prnt_y_date_tags) +
  log_print

-| hooks |
-  hook_command +
+| hooks
+| hook_command +
  hook_command_run +
  hook_timer +
  hook_fd +
@@ -672,8 +686,9 @@ List of functions in script API:
  unhook +
  unhook_all

-| buffers |
-  buffer_new +
+| buffers
+| buffer_new +
+  buffer_new_props +
  current_buffer +
  buffer_search +
  buffer_search_main +
@@ -688,16 +703,16 @@ List of functions in script API:
  buffer_string_replace_local_var +
  buffer_match_list

-| windows |
-  current_window +
+| windows
+| current_window +
  window_search_with_buffer +
  window_get_integer +
  window_get_string +
  window_get_pointer +
  window_set_title

-| nicklist |
-  nicklist_add_group +
+| nicklist
+| nicklist_add_group +
  nicklist_search_group +
  nicklist_add_nick +
  nicklist_search_nick +
@@ -713,8 +728,8 @@ List of functions in script API:
  nicklist_nick_get_pointer +
  nicklist_nick_set

-| bars |
-  bar_item_search +
+| bars
+| bar_item_search +
  bar_item_new +
  bar_item_update +
  bar_item_remove +
@@ -724,23 +739,23 @@ List of functions in script API:
  bar_update +
  bar_remove

-| commands |
-  command +
+| commands
+| command +
  command_options

-| completion |
-  completion_new +
+| completion
+| completion_new +
  completion_search +
  completion_get_string +
  completion_list_add +
  completion_free

-| infos |
-  info_get +
+| infos
+| info_get +
  info_get_hashtable

-| infolists |
-  infolist_new +
+| infolists
+| infolist_new +
  infolist_new_item +
  infolist_new_var_integer +
  infolist_new_var_string +
@@ -758,8 +773,8 @@ List of functions in script API:
  infolist_time +
  infolist_free

-| hdata |
-  hdata_get +
+| hdata
+| hdata_get +
  hdata_get_var_offset +
  hdata_get_var_type_string +
  hdata_get_var_array_size +
@@ -780,8 +795,8 @@ List of functions in script API:
  hdata_update +
  hdata_get_string

-| upgrade |
-  upgrade_new +
+| upgrade
+| upgrade_new +
  upgrade_write_object +
  upgrade_read +
  upgrade_close
@@ -792,17 +807,17 @@ List of functions in script API:

 List of constants in script API:

-[width="100%",cols="1,3",options="header"]
+[width="100%",cols="1,5",options="header"]
 |===
 | Category | Constants

-| return codes |
-  `WEECHAT_RC_OK` (integer) +
+| return codes
+| `WEECHAT_RC_OK` (integer) +
  `WEECHAT_RC_OK_EAT` (integer) +
  `WEECHAT_RC_ERROR` (integer)

-| configuration files |
-  `WEECHAT_CONFIG_READ_OK` (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) +
@@ -817,23 +832,23 @@ List of constants in script API:
  `WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
  `WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)

-| sorted lists |
-  `WEECHAT_LIST_POS_SORT` (string) +
+| sorted lists
+| `WEECHAT_LIST_POS_SORT` (string) +
  `WEECHAT_LIST_POS_BEGINNING` (string) +
  `WEECHAT_LIST_POS_END` (string)

-| hotlist |
-  `WEECHAT_HOTLIST_LOW` (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) +
+| hook process
+| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
  `WEECHAT_HOOK_PROCESS_ERROR` (integer)

-| hook connect |
-  `WEECHAT_HOOK_CONNECT_OK` (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) +
@@ -845,8 +860,8 @@ List of constants in script API:
  `WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
  `WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)

-| hook signal |
-  `WEECHAT_HOOK_SIGNAL_STRING` (string) +
+| hook signal
+| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
  `WEECHAT_HOOK_SIGNAL_INT` (string) +
  `WEECHAT_HOOK_SIGNAL_POINTER` (string)
 |===
@@ -856,7 +871,7 @@ List of constants in script API:

 This chapter shows some common tasks, with examples.
 Only partial things in API are used here, for full reference, see the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].

 [[buffers]]
 === Buffers
@@ -875,7 +890,7 @@ Examples:
 weechat.prnt("", "hello")

 # display "hello" on core buffer, but do not write it to log file
-# (version >= 0.3.3 only)
+# (version ≥ 0.3.3 only)
 weechat.prnt_date_tags("", 0, "no_log", "hello")

 # display prefix "==>" and message "hello" on current buffer
@@ -1049,26 +1064,53 @@ weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "")
 You can run a background process with `+hook_process+`. Your callback will be
 called when data is ready. It may be called many times.

-For the last call to your callback, _rc_ is set to 0 or positive value, it's
-return code of command.
+For the last call to your callback, _return_code_ is set to 0 or positive value,
+it is the return code of command.

 Example:

 [source,python]
 ----
-process_output = ""
-
-def my_process_cb(data, command, rc, out, err):
-    global process_output
-    if out != "":
-        process_output += out
-    if int(rc) >= 0:
-        weechat.prnt("", process_output)
+def my_process_cb(data, command, return_code, out, err):
+    if return_code == weechat.WEECHAT_HOOK_PROCESS_ERROR:
+        weechat.prnt("", "Error with command '%s'" % command)
+        return weechat.WEECHAT_RC_OK
+    if return_code >= 0:
+        weechat.prnt("", "return_code = %d" % return_code)
+    if out:
+        weechat.prnt("", "stdout: %s" % out)
+    if err:
+        weechat.prnt("", "stderr: %s" % err)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process("/bin/ls -l /etc", 10 * 1000, "my_process_cb", "")
 ----

+You can also call directly a script function that does something blocking,
+instead of an external command:
+
+[source,python]
+----
+def get_status(data):
+    # do something blocking...
+    # ...
+    return "this is the result"
+
+def my_process_cb(data, command, return_code, out, err):
+    if return_code == weechat.WEECHAT_HOOK_PROCESS_ERROR:
+        weechat.prnt("", "Error with command '%s'" % command)
+        return weechat.WEECHAT_RC_OK
+    if return_code >= 0:
+        weechat.prnt("", "return_code = %d" % return_code)
+    if out:
+        weechat.prnt("", "stdout: %s" % out)
+    if err:
+        weechat.prnt("", "stderr: %s" % err)
+    return weechat.WEECHAT_RC_OK
+
+hook = weechat.hook_process("func:get_status", 5000, "my_process_cb", "")
+----
+
 [[url_transfer]]
 ==== URL transfer

@@ -1082,15 +1124,15 @@ in callback (standard output of process):

 [source,python]
 ----
-# Display current stable version of WeeChat.
-weechat_version = ""
+# Display latest stable version of WeeChat.
+weechat_latest_version = ""

-def weechat_process_cb(data, command, rc, out, err):
-    global weechat_version
-    if out != "":
-        weechat_version += out
-    if int(rc) >= 0:
-        weechat.prnt("", "Current WeeChat stable is: %s" % weechat_version)
+def weechat_process_cb(data, command, return_code, out, err):
+    global weechat_latest_version
+    if out:
+        weechat_latest_version += out
+    if return_code >= 0:
+        weechat.prnt("", "Latest WeeChat version: %s" % weechat_latest_version)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process("url:https://weechat.org/dev/info/stable/",
@@ -1098,16 +1140,17 @@ weechat.hook_process("url:https://weechat.org/dev/info/stable/",
 ----

 [TIP]
-All infos available about WeeChat are on page https://weechat.org/dev/info
+All infos available about WeeChat are on
+https://weechat.org/dev/info/[this page ^↗^,window=_blank].

 Example of URL transfer with an option: download latest WeeChat development
 package in file _/tmp/weechat-devel.tar.gz_:

 [source,python]
 ----
-def my_process_cb(data, command, rc, out, err):
-    if int(rc) >= 0:
-        weechat.prnt("", "End of transfer (rc=%s)" % rc)
+def my_process_cb(data, command, return_code, out, err):
+    if return_code >= 0:
+        weechat.prnt("", "End of transfer (return code = %d)" % return_code)
    return weechat.WEECHAT_RC_OK

 weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel.tar.gz",
@@ -1117,7 +1160,7 @@ weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel.

 For more information about URL transfer and available options, see functions
 `+hook_process+` and `+hook_process_hashtable+` in
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference].
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].

 [[config_options]]
 === Config / options
@@ -1271,63 +1314,71 @@ The result is a hashtable with following keys

 [width="100%",cols="3,^2,10,7",options="header"]
 |===
-| Key | Since WeeChat ^(1)^ | Description | Example
+| Key | Since WeeChat ^(1)^ | Description | Example

-| tags | 0.4.0 |
-  The tags in message (can be empty). |
-  `+time=2015-06-27T16:40:35.000Z+`
+| tags | 0.4.0
+| The tags in message (can be empty).
+| `+time=2015-06-27T16:40:35.000Z+`

-| tag_xxx | 3.3 |
-  Unescaped value of tag "xxx" (one key per tag). |
-  `+2015-06-27T16:40:35.000Z+`
+| tag_xxx | 3.3
+| Unescaped value of tag "xxx" (one key per tag).
+| `+2015-06-27T16:40:35.000Z+`

-| message_without_tags | 0.4.0 |
-  The message without the tags (the same as message if there are no tags). |
-  `+:nick!user@host PRIVMSG #weechat :hello!+`
+| message_without_tags | 0.4.0
+| The message without the tags (the same as message if there are no tags).
+| `+:nick!user@host PRIVMSG #weechat :hello!+`

-| nick | 0.3.4 |
-  The origin nick. |
-  `+nick+`
+| nick | 0.3.4
+| The origin nick.
+| `+nick+`

-| user | 2.7 |
-  The origin user. |
-  `+user+`
+| user | 2.7
+| The origin user.
+| `+user+`

-| host | 0.3.4 |
-  The origin host (includes the nick). |
-  `+nick!user@host+`
+| host | 0.3.4
+| The origin host (includes the nick).
+| `+nick!user@host+`

-| command | 0.3.4 |
-  The command (_PRIVMSG_, _NOTICE_, ...). |
-  `+PRIVMSG+`
+| command | 0.3.4
+| The command (_PRIVMSG_, _NOTICE_, ...).
+| `+PRIVMSG+`

-| channel | 0.3.4 |
-  The target channel. |
-  `+#weechat+`
+| channel | 0.3.4
+| The target channel.
+| `+#weechat+`

-| arguments | 0.3.4 |
-  The command arguments (includes the channel). |
-  `+#weechat :hello!+`
+| arguments | 0.3.4
+| The command arguments (includes the channel).
+| `+#weechat :hello!+`

-| text | 1.3 |
-  The text (for example user message). |
-  `+hello!+`
+| text | 1.3
+| The text (for example user message).
+| `+hello!+`

-| pos_command | 1.3 |
-  The index of _command_ in message ("-1" if _command_ was not found). |
-  `+47+`
+| paramN | 3.4
+| Command parameter (from 1 to N).
+| `+#weechat+`

-| pos_arguments | 1.3 |
-  The index of _arguments_ in message ("-1" if _arguments_ was not found). |
-  `+55+`
+| num_params | 3.4
+| Number of command parameters.
+| `+2+`

-| pos_channel | 1.3 |
-  The index of _channel_ in message ("-1" if _channel_ was not found). |
-  `+55+`
+| pos_command | 1.3
+| The index of _command_ in message ("-1" if _command_ was not found).
+| `+47+`

-| pos_text | 1.3 |
-  The index of _text_ in message ("-1" if _text_ was not found). |
-  `+65+`
+| pos_arguments | 1.3
+| The index of _arguments_ in message ("-1" if _arguments_ was not found).
+| `+55+`
+
+| pos_channel | 1.3
+| The index of _channel_ in message ("-1" if _channel_ was not found).
+| `+55+`
+
+| pos_text | 1.3
+| The index of _text_ in message ("-1" if _text_ was not found).
+| `+65+`
 |===

 [NOTE]
@@ -1351,6 +1402,9 @@ dict = weechat.info_get_hashtable(
 #     "channel": "#weechat",
 #     "arguments": "#weechat :hello!",
 #     "text": "hello!",
+#     "param1": "#weechat",
+#     "param2": "hello!",
+#     "num_params": "2",
 #     "pos_command": "65",
 #     "pos_arguments": "73",
 #     "pos_channel": "73",
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2012-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2012-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,77 +0,0 @@
-#
-# Copyright (C) 2012-2021 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/>.
-#
-
-docdir = $(datadir)/doc/$(PACKAGE)
-
-EXTRA_DIST = CMakeLists.txt \
-             docinfo.html \
-             weechat_faq.es.adoc \
-             weechat_quickstart.es.adoc
-
-if MAN
-  man_targets =
-  man_install =
-  man_uninstall =
-endif
-if DOC
-  doc_targets = weechat_faq.es.html \
-		weechat_quickstart.es.html
-  doc_install = install-doc
-  doc_uninstall = uninstall-doc
-endif
-all-local: $(man_targets) $(doc_targets)
-
-# FAQ
-weechat_faq.es.html: weechat_faq.es.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_faq.es.html $(abs_top_srcdir)/doc/es/weechat_faq.es.adoc
-
-# quickstart
-weechat_quickstart.es.html: weechat_quickstart.es.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.es.html $(abs_top_srcdir)/doc/es/weechat_quickstart.es.adoc
-
-# install man/docs
-
-install-data-hook: $(man_install) $(doc_install)
-
-install-man:
-	$(mkinstalldirs) $(DESTDIR)$(mandir)/es/man1/
-	$(INSTALL_DATA) *.1 $(DESTDIR)$(mandir)/es/man1/
-	(cd '$(DESTDIR)$(mandir)/es/man1/' && $(RM) weechat-headless.1 && $(LN_S) weechat.1 weechat-headless.1)
-
-install-doc:
-	$(mkinstalldirs) $(DESTDIR)$(docdir)/
-	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
-
-# uninstall man/docs
-
-uninstall-hook: $(man_uninstall) $(doc_uninstall)
-
-uninstall-man:
-	$(RM) $(DESTDIR)$(mandir)/es/man1/weechat.1
-	$(RM) $(DESTDIR)$(mandir)/es/man1/weechat-headless.1
-	-rmdir $(DESTDIR)$(mandir)/es/man1
-
-uninstall-doc:
-	$(RM) $(DESTDIR)$(docdir)/*.es.html
-	-rmdir $(DESTDIR)$(docdir)
-
-# clean
-
-clean-local:
-	-$(RM) weechat_*.html
@@ -13,9 +13,6 @@ Traductores
 * Victorhck <victorhck.mailbox.org>, 2021


-Este documento está escrito para versiones de WeeChat ≥ 0.3.0 pero siempre es preferible
-usar la última versión estable de WeeChat.
-
 toc::[]


@@ -36,7 +33,9 @@ no se aplican a WeeChat!).

 Porque WeeChat es muy ligero y ofrece funcionalidades innovadoras.

-Más información de las funcionalidades de WeeChat en la página: https://weechat.org/about/features
+// TRANSLATION MISSING
+More info on the WeeChat
+https://weechat.org/about/features/[features page ^↗^,window=_blank].

 [[compilation_install]]
 == Compilación / instalación
@@ -44,27 +43,28 @@ Más información de las funcionalidades de WeeChat en la página: https://weech
 [[gui]]
 === ¿He oido que hay muchas interfaces gráficas de susuario (GUI) para WeeChat. ¿Cómo puedo compilarlas o usarlas?

-Hay disponibles algunas GUIs, eche un vistazo a la página de interfaces remotas:
-https://weechat.org/about/interfaces
+// TRANSLATION MISSING
+Some remote GUIs are available, see the
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].

 [[compile_git]]
 === No puedo compilar WeeChat después de haber clonado el repositorio git, ¿por qué?

-La manera recomendada para compilar WeeChat es con
-link:weechat_user.en.html#compile_with_cmake[CMake].
+// TRANSLATION MISSING
+WeeChat must be compiled with CMake.

-Si lo está compilando con link:weechat_user.en.html#compile_with_autotools[autotools]
-(y no con CMake), compruebe que tiene la versión más reciente de autoconf y automake.
+// TRANSLATION MISSING
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+and ensure all required dependencies are installed.

-Otra forma es instalar "devel package", que necesita menos dependencias.
-Este paquete está compilado casi cada día utilizando el repositorio git. Tenga en cuenta que este
-paquete puede no corresponder exactamente con la base de git y es menos conveniente
-que la opción de clonar el repositorio de git a la hora de instalar actualizaciones.
+// TRANSLATION MISSING
+If you still have issues, please report them to the developers.

 [[compile_macos]]
 === ¿Cómo puedo instalar WeeChat en macOS?

-Se recomienda utilizar https://brew.sh/[Homebrew], puede obtener ayuda con el comando:
+Se recomienda utilizar https://brew.sh/[Homebrew ^↗^,window=_blank],
+puede obtener ayuda con el comando:

 ----
 brew info weechat
@@ -80,12 +80,12 @@ brew install weechat
 === He lanzado WeeChat, pero estoy perdido, ¿qué puedo hacer?

 Para consultar la ayuda, escriba `/help`. Para buscar ayuda con un comando, escriba `/help comando`.
-link:weechat_user.en.html#key_bindings[Las teclas] y
-link:weechat_user.en.html#commands_and_options[comandos] aparecen listados
+link:weechat_user.en.html#key_bindings[Las teclas ^↗^,window=_blank] y
+link:weechat_user.en.html#commands_and_options[comandos ^↗^,window=_blank] aparecen listados
 en la documentación.

 Se recomienda a las personas recién llegadas leer la
-link:weechat_quickstart.es.html[guía rápida].
+link:weechat_quickstart.es.html[guía rápida ^↗^,window=_blank].

 [[display]]
 == Visualización
@@ -113,7 +113,7 @@ Es un problema común con una variedad de causas, por favor lea detenidamente y
 ** Si está utilizando el multiplexador screen, compruebe que lo está ejecuando con el modo UTF-8
   ("`defutf8 on`" en ~/.screenrc o `screen -U` al ejecutar screen).
 * Compruebe si la opción
-  link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_]
+  link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
  está en off (esta opción puede causar errores a la hora de mostrar el texto).

 [NOTE]
@@ -128,10 +128,11 @@ Esto puede estar causado por un error en libc en la función _wcwidth_, que debe
 en glibc 2.22 (quizás todavía no está disponible en su distribución).

 Hay una solución temporal que es utilizar una función de _wcwidth_ sin ese error:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].

-Vea este reporte de error para más información:
-https://github.com/weechat/weechat/issues/79
+// TRANSLATION MISSING
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+for more information.

 [[bars_background]]
 === Las barras del título y de estado no aparecen rellenadas, el color de fondo desaparece después del texto, ¿por qué?
@@ -188,17 +189,10 @@ ventanas.
 [[buffers_list]]
 === ¿Cómo mostrar un listado de los buffers en la parte izquierda?

-Con WeeChat ≥ 1.8, el complemento link:weechat_user.en.html#buflist_plugin[buflist]
+El complemento link:weechat_user.en.html#buflist[buflist ^↗^,window=_blank]
 está cargado y habilitado de manera predeterminada.

-Con versiones anteriores, puede instalar el script _buffers.pl_:
-
----
-/script install buffers.pl
----
-
-Para limitar el tamaño de la barra (reemplace "buflist" por "buffers" si está utilizando el script
-_buffers.pl_):
+Para limitar el tamaño de la barra:

 ----
 /set weechat.bar.buflist.size_max 15
@@ -216,21 +210,6 @@ con la rueda del ratón.
 Las teclas predeterminadas para _hacer scroll_ en la barra son kbd:[F1] (o kbd:[Ctrl+F1]), kbd:[F2]
 (o kbd:[Ctrl+F2]), kbd:[Alt+F1] y kbd:[Alt+F2].

-Para el script _buffers.pl_, puede definir las teclas, similares a las teclas existentes para
-hacer _scroll_ en la lista de apodos. +
-Por ejemplo para utilizar kbd:[F1], kbd:[F2], kbd:[Alt+F1] y kbd:[Alt+F2]:
-
----
-/key bind meta-OP /bar scroll buffers * -100%
-/key bind meta-OQ /bar scroll buffers * +100%
-/key bind meta-meta-OP /bar scroll buffers * b
-/key bind meta-meta-OQ /bar scroll buffers * e
----
-
-[NOTE]
-Las teclas "meta-OP" y "meta-OQ" pueden ser diferentes en su terminal. Para encontrar el código
-de la tecla, pulse kbd:[Alt+k] y después la tecla.
-
 [[customize_buflist]]
 === ¿Cómo puedo personalizar la lista de lista de buffers, como el color del buffer activo?

@@ -256,8 +235,9 @@ como `237` para gris oscuro.
 El complemento del listado de buffers _buflist_ ofrece múltiples opciones que puede configurar, por favor lea
 la ayuda de cada opción.

-También hay una página wiki con ejemplos de configuraciones más completas:
-https://github.com/weechat/weechat/wiki/buflist
+// TRANSLATION MISSING
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+with examples of advanced buflist configuration.

 [[customize_prefix]]
 === ¿Cómo puedo reducir la longitud de los apodos o eliminar la alineación de los apodos en el área del chat?
@@ -300,7 +280,7 @@ Estos colores pueden ser cambiados con las opciones __weechat.color.status_data_
 (buffers) y __weechat.color.status_count_*__ (contadores). +
 Otras opciones de la lista rápida o _hotlist_ pueden ser cambiadas con las opciones __weechat.look.hotlist_*__.

-Vea la link:weechat_user.en.html#screen_layout[Guía de usuario / diseño de la pantalla] para
+Vea la link:weechat_user.en.html#screen_layout[Guía de usuario / diseño de la pantalla ^↗^,window=_blank] para
 más información sobre este tema.

 [[input_bar_size]]
@@ -346,9 +326,9 @@ en ninguna barra:
 [[terminal_copy_paste]]
 === ¿Cómo puedo copiar/pegar texto sin pegar la lista de apodos?

-Con WeeChat ≥ 1.0, puedes utilizar una visualización simple (la tecla predeterminada: kbd:[Alt+l] (`L`)),
-que mostrará solo el contenido de la ventana actual seleccionada,
-sin ningún tipo de formato de texto.
+// TRANSLATION MISSING
+You can use the bare display (default key: kbd:[Alt+l] (`L`)), which shows
+just the contents of the currently selected window, without any formatting.

 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
@@ -363,7 +343,8 @@ Otra solución es mover la lista de apodos a la parte superior o inferior, por e
 [[urls]]
 === ¿Cómo puedo hacer clic sobre direcciones URL largas (de más de una línea)?

-Con WeeChat ≥ 1.0, puede utilizar la visualización simple (la tecla predeterminada: kbd:[Alt+l] (`L`)).
+// TRANSLATION MISSING
+You can use the bare display (default key: kbd:[Alt+l] (`L`)).

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

@@ -373,7 +354,7 @@ Para abrir direcciones URL más fácilmente, puede:
 /set weechat.bar.nicklist.position top
 ----

-* inhabilitar la alineación de palabras multilínea (WeeChat ≥ 1.7):
+* inhabilitar la alineación de palabras multilínea:

 ----
 /set weechat.look.align_multiline_words off
@@ -385,9 +366,9 @@ Para abrir direcciones URL más fácilmente, puede:
 /set weechat.look.align_end_of_lines time
 ----

-Con WeeChat ≥ 0.3.6, puede habilitar la opción "eat_newline_glitch", así
-el caracter de la nueva línea no es añadido al final de cada línea mostrada (esto no romperá
-la selección de la dirección URL):
+// TRANSLATION MISSING
+You can enable option "eat_newline_glitch", so that new line char is not added
+at the end of each line displayed (it will not break URL selection):

 ----
 /set weechat.look.eat_newline_glitch on
@@ -434,8 +415,6 @@ En WeeChat, el nuevo valor es inmediatamente utilizado:
 [[use_256_colors]]
 === ¿Cómo puedo utilizar 256 colors en WeeChat?

-256 colors están admitidos con WeeChat ≥ 0.3.4.
-
 Primero compruebe que su variable de entorno _TERM_ es correcta, los valores recomendados
 son:

@@ -453,19 +432,18 @@ term screen-256color
 ----

 Si su variable _TERM_ tiene un valor erróneo y ya WeeChat está ejecutándose,
-puede cambiarlo con estos dos comandos (en WeeChat ≥ 1.0):
+puede cambiarlo con estos dos comandos:

 ----
 /set env TERM screen-256color
 /upgrade
 ----

-Para la versión 0.3.4, deberá utilizar el comando `/color` para añadir nuevos colores.
+// TRANSLATION MISSING
+You can use any color number in options (optional: you can add color aliases
+with command `/color`).

-Para versiones ≥ 0.3.5, puede utilizar cualquier número de color en las opciones (opcional: puede
-añadir alias al color con el comando `/color`).
-
-Por favor lea la link:weechat_user.en.html#colors[Guía del usuario / Colores] para más
+Por favor lea la link:weechat_user.en.html#colors[Guía del usuario / Colores ^↗^,window=_blank] para más
 información sobre la gestión de los colores.

 [[search_text]]
@@ -474,8 +452,8 @@ información sobre la gestión de los colores.
 La tecla predeterminada es kbd:[Ctrl+r] (el comando es: `+/input texto_a_buscar_aquí+`).
 Y para saltar a los textos resaltados: kbd:[Alt+p] / kbd:[Alt+n].

-Vea la link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado] para más
-información sobre esta funcionalidad.
+Vea la link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^,window=_blank]
+para más información sobre esta funcionalidad.

 [[terminal_focus]]
 === ¿Cómo puedo ejecutar comandos cuando la terminal tiene o pierde el foco?
@@ -508,7 +486,7 @@ comandos que prefiera):
 Por ejemplo, para marcar buffers como leidos cuando una terminal pierde el foco:

 ----
-/key bind meta2-O /input set_unread
+/key bind meta2-O /allbuf /buffer set unread
 ----

 [[screen_paste]]
@@ -648,7 +626,7 @@ Puede crear un atajo de teclado, por ejemplo:
 ----

 Tiene una lista de las teclas predeterminadas en la
-link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado].
+link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^,window=_blank].

 Para saltar a un buffer mayor de 100, podría definir un disparador y después utilizar
 comandos como `/123` para saltar al buffer #123:
@@ -680,8 +658,6 @@ de la tecla pulse kbd:[Alt+k] y después la tecla.
 [[mouse_not_working]]
 === El ratón no funciona en absoluto, ¿qué puedo hacer?

-El ratón tiene soporte desde WeeChat ≥ 0.3.6.
-
 Primero trate de habilitar el ratón:

 ----
@@ -731,12 +707,6 @@ tiene que utilizar kbd:[Alt] en vez de kbd:[Shift]).
 Si está utilizando macOS, deberá instalar `openssl` desde Homebrew.
 Se añadirá un archivo CA que utiliza los certificados del sistema.

-Con WeeChat ≤ 3.1, puede establecer la ruta de los certificados del sistema:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
 Si ve errores en gnutls handshake, puede intentar utilizar una clave de cifrado menor
 Diffie-Hellman (la predeterminada es 2048):

@@ -761,8 +731,8 @@ debería ser, puede especificar la huella (fingerprint) (SHA-512, SHA-256 or SHA
 [[irc_ssl_handshake_error]]
 === Al conectar a un servidor con SSL, solo veo el error "TLS handshake failed", ¿qué puedo hacer?

-Puede intentar una cadena de prioridad diferente (WeeChat ≥ 0.3.5 únicamente), reemplace "xxx"
-por el nombre de su servidor:
+Puede intentar una cadena de prioridad diferente, reemplace "xxx" por el nombre
+de su servidor:

 ----
 /set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
@@ -771,22 +741,9 @@ por el nombre de su servidor:
 [[irc_ssl_libera]]
 === ¿Cómo puedo conectarme al servidor libera utilizando SSL?

-Con WeeChat ≤ 3.1, establezca la opción _weechat.network.gnutls_ca_file_ en el archivo con
-los certificados:
-
----
-/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
----
-
-Nota: Si está ejecutando macOS con Homebrew openssl instalado, puede ejecutar:
-
----
-/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
----
-
-[NOTE]
-Compruebe que tiene este archivo en su sistema (normalmente viene ofrecido por el paquete
-"ca-certificates").
+// TRANSLATION MISSING
+Check that you have certificates installed on your system, this is commonly
+provided by the package "ca-certificates".

 Establezca el puerto del servidor, SSL, después conecte:

@@ -832,25 +789,41 @@ unirse a los canales):
 [[edit_autojoin]]
 === ¿Cómo puedo añadir/eliminar canales de la opción autojoin?

-Puede utilizar el comando `/set` para editar la lista de canales con autojoin,
-por ejemplo, para el servidor "libera":
+// TRANSLATION MISSING
+With WeeChat ≥ 3.5, you can automatically record the channels you manually
+join and part in the "autojoin" server option.
+
+// TRANSLATION MISSING
+For all servers:

 ----
-/set irc.server.libera.autojoin [TAB]
+/set irc.server_default.autojoin_dynamic on
 ----

-[NOTE]
-Puede completar el nombre y el valor de la opción con la tecla kbd:[Tab]
-(o kbd:[Shift+Tab] para completar el comando de manera parcial, útil para el nombre). +
-De esta manera no tendrá que escribir la lista completa de canales.
-
-También puede utilizar el comando `/fset` para editar la lista de canales:
+// TRANSLATION MISSING
+For a single server:

 ----
-/fset autojoin
+/set irc.server.libera.autojoin_dynamic on
 ----

-Otra solución es utilizar un script:
+// TRANSLATION MISSING
+You can also add the current channel in the "autojoin" server option using the
+`/autojoin` command:
+
+----
+/autojoin add
+----
+
+// TRANSLATION MISSING
+Or another channel:
+
+----
+/autojoin add #test
+----
+
+// TRANSLATION MISSING
+There are also scripts:

 ----
 /script search autojoin
@@ -890,14 +863,15 @@ Con un filtro global (oculta *todos* los mensajes join/part/quit):

 [NOTE]
 Para más ayuda: `/help filter`, `+/help irc.look.smart_filter+` y vea la
-link:weechat_user.en.html#irc_smart_filter_join_part_quit[Guía del usuario / Filtros inteligente para mensajes join/part/quit].
+link:weechat_user.en.html#irc_smart_filter_join_part_quit[Guía del usuario / Filtros inteligente para mensajes join/part/quit ^↗^,window=_blank].

 [[filter_irc_join_channel_messages]]
 === ¿Cómo puedo filtrar algunos mensajes mostrados cuando me uno a un canal IRC?

-Con WeeChat ≥ 0.4.1, puede escoger qué mensajes son mostrados cuando
-se une a un canal mediante la opción _irc.look.display_join_message_ (vea
-`+/help irc.look.display_join_message+` para más información).
+// TRANSLATION MISSING
+You can choose which messages are displayed when joining a channel with the
+option _irc.look.display_join_message_ (see `+/help irc.look.display_join_message+`
+for more info).

 Para ocultar mensajes (pero mantenerlos en el buffer), puede filtrarlos utilizando la etiqueta propia del mensaje
 (por ejemplo _irc_329_ para la fecha de creación del canal). Vea `/help filter` para más información
@@ -952,17 +926,14 @@ apodos:
 /set irc.server_default.away_check_max_nicks 25
 ----

-[NOTE]
-Para WeeChat ≤ 0.3.3, las opciones son _irc.network.away_check_ y
-_irc.network.away_check_max_nicks_.
-
 [[highlight_notification]]
 === ¿Cómo puedo ser advertido cuando alguien me menciona en un canal?

-Con WeeChat ≥ 1.0, hay un disparador "beep" que envía un _BEL_ a
-a la terminal cuando alguien le menciona o le manda un privado. Además puede configurar su
-terminal (o multiplexador como screen/tmux) para ejecutar un comando o reproducir un sonido
-cuando suceda un evento _BEL_.
+// TRANSLATION MISSING
+There is a default trigger "beep" which sends a _BEL_ to the terminal on
+a highlight or private message. Thus you can configure your terminal
+(or multiplexer like screen/tmux) to run a command or play a sound when
+a _BEL_ occurs.

 O puede añadir un comando al disparador "beep":

@@ -987,10 +958,11 @@ Otros scripts para este tema:
 [[disable_highlights_for_specific_nicks]]
 === ¿Cómo puedo inhabilitar las menciones de unos apodos específicos?

-Con WeeChat ≥ 0.3.4 puede utilizar
-link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add]
-esta propiedad del buffer para configurar el nivel máximo de la hotlist para algunos apodos, por buffer,
-o por grupo de buffers (como servidores IRC).
+// TRANSLATION MISSING
+You can use the
+link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+buffer property to set the max hotlist level for some nicks, per buffer,
+or per group of buffers (like IRC servers).

 Para únicamente inhabilitar las notificaciones, debería establecerlo a 2:

@@ -1024,7 +996,7 @@ Para más ejemplos, vea `+/help buffer_autoset+`.
 [[irc_target_buffer]]
 === ¿Cómo puedo cambiar el objetivo del buffer para comandos en buffers unidos (como en un buffer con servidores)?

-La tecla predeterminada es kbd:[Ctrl+x] (el comando es: `+/input switch_active_buffer+`).
+La tecla predeterminada es kbd:[Ctrl+x] (el comando es: `+/buffer switch+`).

 [[plugins_scripts]]
 == Complementos / scripts
@@ -1044,8 +1016,9 @@ Deberá configurar lo siguiente:
 [[install_scripts]]
 === ¿Cómo puedo instalar scripts? ¿Son los scripts compatibles con otros clientes IRC?

-Con WeeChat ≥ 0.3.9 puede utilizar el comando `/script` para instalar y gestionar los scripts
-(vea `/help script` para obtener más ayuda). Para versiones anteriores existe weeget.py y script.pl.
+// TRANSLATION MISSING
+You can use the command `/script` to install and manage scripts (see `/help script`
+for help).

 Los scripts no son compatibles con otros clientes IRC.

@@ -1060,8 +1033,9 @@ Si todavía no funciona, trate de manera manual eliminar los archivos de scripts
 $ rm ~/.cache/weechat/script/plugins.xml.gz
 ----

+// TRANSLATION MISSING
 [NOTE]
-Con WeeChat ≤ 3.1, la ruta debería ser: _~/.weechat/script/plugins.xml.gz_.
+If you are not using the XDG directories, the path could be: _~/.weechat/script/plugins.xml.gz_.

 Y vuelva a actualitar los scripts de nuevo en WeeChat:

@@ -1104,10 +1078,6 @@ Deberá recargar el complemento spell:
 /plugin reload spell
 ----

-[NOTE]
-Con WeeChat ≤ 2.4, el complemento "spell" fue renombrado a "aspell", así que el comando sería:
-`/plugin reload aspell`.
-
 [[settings]]
 == Ajustes

@@ -1192,7 +1162,7 @@ Elimine de la memoria e inhabilite la carga automática del complemento "xfer" (
 Defina una frase de paso y utilice datos seguros cada vez que pueda para datos sensibles
 como contraseñas: vea `/help secure` y `/help` en las opciones
 (si puede utilice datos seguros, está escrito en la ayuda).
-Ver también link:weechat_user.en.html#secured_data[Guía del usuario / Datos seguros].
+Ver también link:weechat_user.en.html#secured_data[Guía del usuario / Datos seguros ^↗^,window=_blank].

 Por ejemplo:

@@ -1213,7 +1183,7 @@ contiene sus contraseñas cifradas con su frase de paso.
 Algunos otros archivos pueden contener información sensible como contraseñas (si no están
 almacenadas en _sec.conf_ con el comando `/secure`).

-Vea la link:weechat_user.en.html#files_and_directories[Guía del usuario / Archivos y directorios]
+Vea la link:weechat_user.en.html#files_and_directories[Guía del usuario / Archivos y directorios ^↗^,window=_blank]
 para más información relacionada con los archivos de configuración.

 [[development]]
@@ -1222,7 +1192,8 @@ para más información relacionada con los archivos de configuración.
 [[bug_task_patch]]
 === ¿Cómo podría informar de errores, pedir nuevas funcionalidades o enviar parches?

-Vea: https://weechat.org/about/support
+// TRANSLATION MISSING
+See https://weechat.org/about/support/[this page ^↗^,window=_blank].

 [[gdb_error_threads]]
 === Cuando ejecuto WeeChat bajo gdb, hay un error con la muestra de las conversaciones, ¿qué puedo hacer?
@@ -1258,11 +1229,13 @@ algunos sistemas operativos en los que no podemos probar WeeChat.

 Hay muchas tareas que hacer (probar, escribir código, documentación, etc.)

-Por favor, contacte con nosotros mediante IRC o correo electrónico, eche un vistazo a la página de soporte:
-https://weechat.org/about/support
+// TRANSLATION MISSING
+Please contact us via IRC or mail, look at
+https://weechat.org/about/support/[support page ^↗^,window=_blank].

 [[donate]]
 === ¿Puedo donar dinero u otras cosas a las personas que desarrollan WeeChat?

-Puede donar dinero para ayudar en el desarrollo.
-Más detalles en https://weechat.org/donate
+// TRANSLATION MISSING
+You can give us money to help development.
+Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
@@ -207,10 +207,17 @@ Para unirse automáticamente a canales cuando el servidor se conecte:
 /set irc.server.libera.autojoin "#uncanal,#otrocanal"
 ----

-[TIP]
-Puede completar el nombre y el valor de las opciones con la tecla kbd:[Tab]
-y kbd:[Shift+Tab] para un autocompletado parcial (útil para palabras largas como
-el nombre de la opción).
+// TRANSLATION MISSING
+The `/autojoin` command lets you configure the _autojoin_ option easily
+(see `/help autojoin`).
+
+// TRANSLATION MISSING
+You can also configure WeeChat to automatically update the _autojoin_ option
+when you join or leave channels:
+
+----
+/set irc.server_default.autojoin_dynamic on
+----

 Para eliminar un valor asignado a una opción de servidor y usar los
 valores predeterminados en su lugar, por ejemplo, usar el nick predeterminado
@@ -227,6 +234,11 @@ donde "xxx" es el nombre de la opción.
 /set irc.server.libera.xxx valor
 ----

+[TIP]
+Puede completar el nombre y el valor de las opciones con la tecla kbd:[Tab]
+y kbd:[Shift+Tab] para un autocompletado parcial (útil para palabras largas como
+el nombre de la opción).
+
 [[connect_to_irc_server]]
 == Conectarse a un servidor IRC

@@ -390,13 +402,16 @@ por ejemplo:

 Vea `/help script` para obtener más información.

-Hay una lista de scripts disponibles en WeeChat mediante el comando `/script` o en este enlace:
-https://weechat.org/scripts
+// TRANSLATION MISSING
+A list of scripts is available in WeeChat with `/script` or on
+https://weechat.org/scripts/[this page ^↗^,window=_blank].

 [[more_doc]]
 == Más documentación

-Ahora puede usar WeeChat y leer las FAQ/documentación para cada pregunta
-en: https://weechat.org/doc
+// TRANSLATION MISSING
+You can now use WeeChat and read
+https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+for any other questions.

 ¡Disfrute de WeeChat!
@@ -1,5 +1,5 @@
 #
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
+# Copyright (C) 2003-2023 Sébastien Helleu <flashcode@flashtux.org>
 #
 # This file is part of WeeChat, the extensible chat client.
 #
@@ -1,129 +0,0 @@
-#
-# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
-# Copyright (C) 2006 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/>.
-#
-
-docdir = $(datadir)/doc/$(PACKAGE)
-
-EXTRA_DIST = CMakeLists.txt \
-             docinfo.html \
-             weechat.1.fr.adoc \
-             weechat-headless.1.fr.adoc \
-             weechat_user.fr.adoc \
-             weechat_plugin_api.fr.adoc \
-             weechat_scripting.fr.adoc \
-             weechat_faq.fr.adoc \
-             weechat_quickstart.fr.adoc \
-             weechat_relay_protocol.fr.adoc \
-             weechat_dev.fr.adoc \
-             includes/autogen_api_completions.fr.adoc \
-             includes/autogen_api_hdata.fr.adoc \
-             includes/autogen_api_infolists.fr.adoc \
-             includes/autogen_api_infos.fr.adoc \
-             includes/autogen_api_infos_hashtable.fr.adoc \
-             includes/autogen_api_plugins_priority.fr.adoc \
-             includes/autogen_api_url_options.fr.adoc \
-             includes/autogen_user_commands.fr.adoc \
-             includes/autogen_user_default_aliases.fr.adoc \
-             includes/autogen_user_irc_colors.fr.adoc \
-             includes/autogen_user_options.fr.adoc \
-             includes/cmdline_options.fr.adoc \
-             includes/man.fr.adoc
-
-if MAN
-  man_targets = weechat.1 \
-                weechat-headless.1
-  man_install = install-man
-  man_uninstall = uninstall-man
-endif
-if DOC
-  doc_targets = weechat_user.fr.html \
-		weechat_plugin_api.fr.html \
-		weechat_scripting.fr.html \
-		weechat_faq.fr.html \
-		weechat_quickstart.fr.html \
-		weechat_relay_protocol.fr.html \
-		weechat_dev.fr.html
-  doc_install = install-doc
-  doc_uninstall = uninstall-doc
-endif
-all-local: $(man_targets) $(doc_targets)
-
-# man pages
-weechat.1: weechat.1.fr.adoc includes/cmdline_options.fr.adoc includes/man.fr.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat.1 $(abs_top_srcdir)/doc/fr/weechat.1.fr.adoc
-weechat-headless.1: weechat-headless.1.fr.adoc includes/cmdline_options.fr.adoc includes/man.fr.adoc
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -b manpage -o weechat-headless.1 $(abs_top_srcdir)/doc/fr/weechat-headless.1.fr.adoc
-
-# user's guide
-weechat_user.fr.html: weechat_user.fr.adoc includes/cmdline_options.fr.adoc $(wildcard includes/autogen_user_*.adoc) $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_user.fr.html $(abs_top_srcdir)/doc/fr/weechat_user.fr.adoc
-
-# plugin API reference
-weechat_plugin_api.fr.html: weechat_plugin_api.fr.adoc $(wildcard includes/autogen_api_*.adoc) $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_plugin_api.fr.html $(abs_top_srcdir)/doc/fr/weechat_plugin_api.fr.adoc
-
-# scripting guide
-weechat_scripting.fr.html: weechat_scripting.fr.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_scripting.fr.html $(abs_top_srcdir)/doc/fr/weechat_scripting.fr.adoc
-
-# FAQ
-weechat_faq.fr.html: weechat_faq.fr.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_faq.fr.html $(abs_top_srcdir)/doc/fr/weechat_faq.fr.adoc
-
-# quickstart
-weechat_quickstart.fr.html: weechat_quickstart.fr.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_quickstart.fr.html $(abs_top_srcdir)/doc/fr/weechat_quickstart.fr.adoc
-
-# relay protocol
-weechat_relay_protocol.fr.html: weechat_relay_protocol.fr.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_relay_protocol.fr.html $(abs_top_srcdir)/doc/fr/weechat_relay_protocol.fr.adoc
-
-# developer's guide
-weechat_dev.fr.html: weechat_dev.fr.adoc $(abs_top_srcdir)/doc/docinfo.html
-	$(ASCIIDOCTOR) $(ASCIIDOCTOR_ARGS) -a revnumber="$(VERSION)" -o weechat_dev.fr.html $(abs_top_srcdir)/doc/fr/weechat_dev.fr.adoc
-
-# install man/docs
-
-install-data-hook: $(man_install) $(doc_install)
-
-install-man:
-	$(mkinstalldirs) $(DESTDIR)$(mandir)/fr/man1/
-	$(INSTALL_DATA) *.1 $(DESTDIR)$(mandir)/fr/man1/
-
-install-doc:
-	$(mkinstalldirs) $(DESTDIR)$(docdir)/
-	$(INSTALL_DATA) *.html $(DESTDIR)$(docdir)/
-
-# uninstall man/docs
-
-uninstall-hook: $(man_uninstall) $(doc_uninstall)
-
-uninstall-man:
-	$(RM) $(DESTDIR)$(mandir)/fr/man1/weechat.1
-	$(RM) $(DESTDIR)$(mandir)/fr/man1/weechat-headless.1
-	-rmdir $(DESTDIR)$(mandir)/fr/man1
-
-uninstall-doc:
-	$(RM) $(DESTDIR)$(docdir)/*.fr.html
-	-rmdir $(DESTDIR)$(docdir)
-
-# clean
-
-clean-local:
-	-$(RM) weechat.1 weechat-headless.1 weechat_*.html
@@ -26,6 +26,8 @@

 | irc | irc_channels | canaux sur tous les serveurs IRC

+| irc | irc_channels_autojoin | canaux automatiquement rejoints sur le serveur courant (option "autojoin")
+
 | irc | irc_ignores_numbers | numéros pour les ignores définis

 | irc | irc_modelist_masks | masques de la liste de modes du canal IRC courant ; argument obligatoire : mode de la liste de modes
@@ -92,6 +94,8 @@

 | tcl | tcl_script | liste des scripts

+| trigger | trigger_add_arguments | paramètres pour la commande qui ajoute un trigger : nom du trigger, hooks, paramètres du hook, conditions du hook, regex du hook, commande du hook, code retour du hook, actions "post"
+
 | trigger | trigger_hook_arguments | paramètres par défaut pour un hook

 | trigger | trigger_hook_command | commande par défaut pour un hook
@@ -146,6 +150,14 @@

 | weechat | cursor_areas | zones ("chat" ou un nom de barre) pour le mouvement libre du curseur

+| weechat | custom_bar_item_add_arguments | paramètres pour la commande qui ajoute un objet de barre personnalisé : nom de l'objet, conditions, contenu
+
+| weechat | custom_bar_item_conditions | conditions pour l'objet de barre personnalisé
+
+| weechat | custom_bar_item_contents | contenus pour l'objet de barre personnalisé
+
+| weechat | custom_bar_items_names | noms des objets de barre personnalisés
+
 | weechat | env_value | valeur d'une variable d'environnement

 | weechat | env_vars | variables d'environnement
@@ -0,0 +1,36 @@
+//
+// This file is auto-generated by script docgen.py.
+// DO NOT EDIT BY HAND!
+//
+
+// tag::config_priority[]
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rang | Fichier | Priorité
+| 1 | sec.conf | 120000
+| 2 | weechat.conf | 110000
+| 3 | plugins.conf | 100000
+| 4 | charset.conf | 16000
+| 5 | logger.conf | 15000
+| 6 | exec.conf | 14000
+| 7 | trigger.conf | 13000
+| 8 | spell.conf | 12000
+| 9 | alias.conf | 11000
+| 10 | buflist.conf | 10000
+| 11 | fifo.conf | 9000
+| 12 | typing.conf | 8000
+| 13 | xfer.conf | 7000
+| 14 | irc.conf | 6000
+| 15 | relay.conf | 5000
+| 16 | guile.conf | 4070
+| 17 | javascript.conf | 4060
+| 18 | lua.conf | 4050
+| 19 | perl.conf | 4040
+| 20 | php.conf | 4030
+| 21 | python.conf | 4020
+| 22 | ruby.conf | 4010
+| 23 | tcl.conf | 4000
+| 24 | script.conf | 3000
+| 25 | fset.conf | 2000
+|===
+// end::config_priority[]
@@ -241,6 +241,8 @@ _sasl_scram_salted_pwd_size_   (integer) +
 _sasl_scram_auth_message_   (string) +
 _sasl_temp_username_   (string) +
 _sasl_temp_password_   (string) +
+_authentication_method_   (integer) +
+_sasl_mechanism_used_   (integer) +
 _is_connected_   (integer) +
 _ssl_connected_   (integer) +
 _disconnected_   (integer) +
@@ -278,7 +280,7 @@ _typing_allowed_   (integer) +
 _reconnect_delay_   (integer) +
 _reconnect_start_   (time) +
 _command_time_   (time) +
-_reconnect_join_   (integer) +
+_autojoin_done_   (integer) +
 _disable_autojoin_   (integer) +
 _is_away_   (integer) +
 _away_message_   (string) +
@@ -582,6 +584,7 @@ _title_   (string) +
 _own_lines_   (pointer, hdata: "lines") +
 _mixed_lines_   (pointer, hdata: "lines") +
 _lines_   (pointer, hdata: "lines") +
+_next_line_id_   (integer) +
 _time_for_each_line_   (integer) +
 _chat_refresh_needed_   (integer) +
 _nicklist_   (integer) +
@@ -631,6 +634,8 @@ _text_search_input_   (string) +
 _highlight_words_   (string) +
 _highlight_regex_   (string) +
 _highlight_regex_compiled_   (pointer) +
+_highlight_disable_regex_   (string) +
+_highlight_disable_regex_compiled_   (pointer) +
 _highlight_tags_restrict_   (string) +
 _highlight_tags_restrict_count_   (integer) +
 _highlight_tags_restrict_array_   (pointer, array_size: "highlight_tags_restrict_count") +
@@ -704,6 +709,7 @@ _count_   (integer) +
 _last_config_file_ +

 | _plugin_   (pointer, hdata: "plugin") +
+_priority_   (integer) +
 _name_   (string) +
 _filename_   (string) +
 _file_   (pointer) +
@@ -921,6 +927,7 @@ _next_line_   (pointer, hdata: "line") +
 | structure avec les données d'une ligne
 | -
 | _buffer_   (pointer, hdata: "buffer") +
+_id_   (integer) +
 _y_   (integer) +
 _date_   (time) +
 _date_printed_   (time) +
@@ -60,8 +60,6 @@

 | php | php_version | version de l'interpréteur utilisé | -

-| python | python2_bin | chemin vers l'interpréteur Python 2.x (*obsolète* depuis la version 2.6, les scripts doivent utiliser seulement Python 3) | -
-
 | python | python_eval | évaluation de code source | code source à exécuter

 | python | python_interpreter | nom de l'interpréteur utilisé | -
@@ -128,6 +126,8 @@

 | weechat | uptime | Durée de fonctionnement de WeeChat (format : "jours:hh:mm:ss") | "days" (nombre de jours) ou "seconds" (nombre de secondes) (optionnel)

+| weechat | uptime_current | Durée de fonctionnement de WeeChat pour le processus actuel seulement (les mises à jour par la commande /upgrade sont ignorées) (format : "jours:hh:mm:ss") | "days" (nombre de jours) ou "seconds" (nombre de secondes) (optionnel)
+
 | weechat | version | version de WeeChat | -

 | weechat | version_git | version git de WeeChat (sortie de la commande "git describe" pour une version de développement seulement, vide pour une version stable) | -
@@ -4,26 +4,30 @@
 //

 // tag::plugins_priority[]
-. charset (16000)
-. logger (15000)
-. exec (14000)
-. trigger (13000)
-. spell (12000)
-. alias (11000)
-. buflist (10000)
-. fifo (9000)
-. typing (8000)
-. xfer (7000)
-. irc (6000)
-. relay (5000)
-. guile (4007)
-. javascript (4006)
-. lua (4005)
-. perl (4004)
-. php (4003)
-. python (4002)
-. ruby (4001)
-. tcl (4000)
-. script (3000)
-. fset (2000)
+[width="30%",cols="1,3,2",options="header"]
+|===
+| Rang | Extension | Priorité
+| 1 | charset | 16000
+| 2 | logger | 15000
+| 3 | exec | 14000
+| 4 | trigger | 13000
+| 5 | spell | 12000
+| 6 | alias | 11000
+| 7 | buflist | 10000
+| 8 | fifo | 9000
+| 9 | typing | 8000
+| 10 | xfer | 7000
+| 11 | irc | 6000
+| 12 | relay | 5000
+| 13 | guile | 4070
+| 14 | javascript | 4060
+| 15 | lua | 4050
+| 16 | perl | 4040
+| 17 | php | 4030
+| 18 | python | 4020
+| 19 | ruby | 4010
+| 20 | tcl | 4000
+| 21 | script | 3000
+| 22 | fset | 2000
+|===
 // end::plugins_priority[]
@@ -6,7 +6,7 @@
 // tag::url_options[]
 [width="100%",cols="2,^1,7",options="header"]
 |===
-| Option | Type ^(1)^ | Constantes ^(2)^
+| Option | Type ^(1)^ | Constantes ^(2)^

 | verbose | long |

@@ -48,10 +48,6 @@

 | address_scope | long |

-| protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
-| redir_protocols | mask | http, https, ftp, ftps, scp, sftp, telnet, ldap, ldaps, dict, file, tftp, all, imap, imaps, pop3, pop3s, smtp, smtps, rtsp, rtmp, rtmpt, rtmpe, rtmpte, rtmps, rtmpts, gopher, smb, smbs
-
 | noproxy | string |

 | socks5_gssapi_nec | long |
@@ -82,15 +78,19 @@

 | doh_url | string |

+| protocols_str | string |
+
+| redir_protocols_str | string |
+
 | netrc | long | ignored, optional, required

 | userpwd | string |

 | proxyuserpwd | string |

-| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| httpauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

-| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer
+| proxyauth | mask | none, basic, digest, ntlm, any, anysafe, digest_ie, only, ntlm_wb, negotiate, gssapi, bearer, aws_sigv4

 | netrc_file | string |

@@ -108,6 +108,8 @@

 | tlsauth_password | string |

+| sasl_authzid | string |
+
 | sasl_ir | long |

 | xoauth2_bearer | string |
@@ -120,8 +122,6 @@

 | followlocation | long |

-| put | long |
-
 | post | long |

 | postfields | string |
@@ -144,7 +144,7 @@

 | cookiejar | string |

-| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge
+| http_version | long | none, 1_0, 1_1, 2_0, 2, 2tls, 2_prior_knowledge, 3

 | cookiesession | long |

@@ -182,12 +182,20 @@

 | request_target | string |

+| http09_allowed | long |
+
+| hsts | string |
+
+| hsts_ctrl | mask | enable, readonlyfile
+
 | mail_from | string |

 | mail_rcpt | list |

 | mail_auth | string |

+| mail_rcpt_alllowfails | long |
+
 | tftp_blksize | long |

 | tftp_no_options | long |
@@ -206,8 +214,6 @@

 | ftp_create_missing_dirs | long |

-| ftp_response_timeout | long |
-
 | ftpsslauth | long | default, ssl, tls

 | ftp_account | string |
@@ -238,6 +244,8 @@

 | rtsp_server_cseq | long |

+| aws_sigv4 | string |
+
 | crlf | long |

 | range | string |
@@ -274,6 +282,8 @@

 | upload_buffersize | long |

+| mime_options | mask | formescape
+
 | timeout | long |

 | low_speed_limit | long |
@@ -298,6 +308,8 @@

 | connecttimeout_ms | long |

+| maxage_conn | long |
+
 | maxconnects | long |

 | use_ssl | long | none, try, control, all
@@ -322,6 +334,8 @@

 | upkeep_interval_ms | long |

+| maxlifetime_conn | long |
+
 | sslcert | string |

 | sslversion | long | default, tlsv1, sslv2, sslv3, tlsv1_0, tlsv1_1, tlsv1_2, tlsv1_3, max_default, max_none, max_tlsv1_0, max_tlsv1_1, max_tlsv1_2, max_tlsv1_3
@@ -330,10 +344,6 @@

 | cainfo | string |

-| random_file | string |
-
-| egdsocket | string |
-
 | ssl_verifyhost | long |

 | ssl_cipher_list | string |
@@ -364,12 +374,10 @@

 | gssapi_delegation | long | none, policy_flag, flag

-| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | ssl_enable_alpn | long |

-| ssl_enable_npn | long |
-
 | pinnedpublickey | string |

 | ssl_verifystatus | long |
@@ -398,7 +406,7 @@

 | proxy_ssl_cipher_list | list |

-| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend
+| proxy_ssl_options | long | allow_beast, no_revoke, no_backends, ok, too_late, unknown_backend, no_partialchain, revoke_best_effort, native_ca, auto_client_cert

 | proxy_ssl_verifyhost | long |

@@ -414,6 +422,18 @@

 | proxy_tls13_ciphers | list |

+| proxy_issuercert | string |
+
+| ssl_ec_curves | string |
+
+| doh_ssl_verifyhost | long |
+
+| doh_ssl_verifypeer | long |
+
+| doh_ssl_verifystatus | long |
+
+| ca_cache_timeout | long |
+
 | ssh_auth_types | mask | none, policy_flag, flag

 | ssh_public_keyfile | string |
@@ -426,11 +446,17 @@

 | ssh_compression | long |

+| ssh_host_public_key_sha256 | string |
+
+| telnetoptions | list |
+
+| ws_options | mask | binary, close, cont, offset, ping, pong, raw_mode, text
+
 | new_file_perms | long |

 | new_directory_perms | long |

-| telnetoptions | list |
+| quick_exit | long |

 |===
 // end::url_options[]
@@ -123,6 +123,39 @@ Exemples :
    /auth utilisateur2 ${weechat_config_dir}/ecdsa2.pem
 ----

+[[command_irc_autojoin]]
+* `+autojoin+`: configurer l'option serveur "autojoin"
+
+----
+/autojoin  add [<canal1> [<canal2>...]]
+           addraw <canal1>[,<canal2>...] [<clé1>[,<clé2>...]]
+           del [<canal1> [<canal2>...]]
+           apply
+           join
+           sort
+
+    add : ajouter le canal courant ou une liste de canaux (avec clés facultatives) dans l'option autojoin ; si vous êtes sur le canal et que la clé n'est pas fournie, la clé est lue sur ce canal
+ addraw : utiliser le format brut IRC (identique à la commande /join) : tous les canaux séparés par des virgules, clés facultatives séparées par des virgules
+    del : supprimer le canal courant ou une liste de canaux de l'option autojoin
+channel : nom du canal
+    key : clé pour le canal
+  apply : définir les canaux actuellement joints dans l'option autojoin
+   join : joindre les canaux de l'option autojoin
+   sort : trier les canaux de l'option autojoin par ordre alphabétique
+
+Exemples :
+  /autojoin add
+  /autojoin add #test
+  /autojoin add #chan1 #chan2
+  /allchan /autojoin add
+  /autojoin addraw #chan1,#chan2,#chan3 key1,key2
+  /autojoin del
+  /autojoin del #chan1
+  /autojoin apply
+  /autojoin join
+  /autojoin sort
+----
+
 [[command_irc_ban]]
 * `+ban+`: bannir des pseudos ou hôtes

@@ -146,7 +179,7 @@ Sans paramètre, cette commande affiche la liste des bannissements pour le canal

   ls : lister les capacités supportées par le serveur
 list : lister les capacités actuellement activées
-  req : demander une capacité
+  req : demander une nouvelle capacité ou supprimer une capacité (si elle commence par "-", par exemple : "-multi-prefix")
  ack : accuser réception de capacités qui nécessitent un accusé de réception du client
  end : terminer la négociation de capacité

@@ -157,8 +190,14 @@ Les capacités supportées par WeeChat sont : account-notify, away-notify, cap-
 Les capacités à activer automatiquement sur les serveurs peuvent être définies dans l'option irc.server_default.capabilities (ou par serveur dans l'option irc.server.xxx.capabilities).

 Exemples :
-   /cap
-   /cap req multi-prefix away-notify
+  afficher les capacités supportées et activées :
+    /cap
+  demander les capacités multi-prefix et away-notify :
+    /cap req multi-prefix away-notify
+  demander la capacité extended-join, supprimer la capacité multi-prefix :
+    /cap req extended-join -multi-prefix
+  supprimer la capacité away-notify :
+    /cap req -away-notify
 ----

 [[command_irc_connect]]
@@ -414,6 +453,16 @@ pseudo : pseudo
 raison : raison
 ----

+[[command_irc_knock]]
+* `+knock+`: envoyer une notice à un canal en invitation seulement, en demandant une invitation
+
+----
+/knock  <canal> [<message>]
+
+  canal : nom du canal
+message : message à envoyer
+----
+
 [[command_irc_links]]
 * `+links+`: lister tous les noms de serveurs connus du serveur qui répondent à la requête

@@ -708,6 +757,12 @@ raison : raison (les variables spéciales $nick, $channel et $server sont rempl
 cible : nom du serveur
 ----

+[[command_irc_rules]]
+* `+rules+`: demander les règles du serveur
+
+----
+----
+
 [[command_irc_sajoin]]
 * `+sajoin+`: forcer un utilisateur à rejoindre un ou plusieurs canaux

@@ -1037,11 +1092,13 @@ nombre : nombre de réponses à retourner (recherche complète si nombre négat
        add <alias> [<commande>[;<commande>...]]
        addcompletion <complétion> <alias> [<commande>[;<commande>...]]
        del <alias> [<alias>...]
+        rename <alias> <nouvel_alias>

         list : afficher les alias (sans paramètre, cette liste est affichée)
          add : ajouter un alias
 addcompletion : ajouter un alias avec une complétion personnalisée
          del : supprimer un alias
+       rename : renommer un alias
   complétion : complétion pour l'alias : par défaut la complétion se fait avec la commande cible
                note : vous pouvez utiliser %%commande pour utiliser la complétion d'une commande existante
        alias : nom de l'alias
@@ -1062,12 +1119,27 @@ Exemples :
    /alias add split /window splith
  alias /hello pour dire "hello" sur tous les canaux mais pas sur #weechat :
    /alias add hello /allchan -exclude=#weechat hello
+  renommer l'alias "hello" en "Hello" :
+    /alias rename hello Hello
  alias /forcejoin pour envoyer la commande IRC "forcejoin" avec la complétion de /sajoin :
    /alias addcompletion %%sajoin forcejoin /quote forcejoin
 ----
 // end::alias_commands[]

 // tag::weechat_commands[]
+[[command_weechat_allbuf]]
+* `+allbuf+`: exécuter une commande sur tous les tampons
+
+----
+/allbuf  <commande>
+
+commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
+
+Exemples :
+  définir le marqueur de lecture sur tous les tampons :
+    /allbuf /buffer set unread
+----
+
 [[command_weechat_away]]
 * `+away+`: définir ou supprimer le statut d'absence

@@ -1144,6 +1216,8 @@ Exemples :
         unmerge [<nombre>|-all]
         hide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
         unhide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
+         switch [-previous]
+         zoom
         renumber <nombre1> [<nombre2> [<départ>]]
         close [<n1>[-<n2>]|<nom>...]
         notify [<niveau>]
@@ -1152,7 +1226,8 @@ Exemples :
         delvar <nom>
         set <propriété> [<valeur>]
         get <propriété>
-         <nombre>|<nom>
+         jump smart|last_displayed|prev_visited|next_visited
+         <nombre>|-|+|<nom>

    list : lister les tampons ouverts (sans paramètre, cette liste est affichée)
     add : ajouter un nouveau tampon (il peut être fermé avec "/buffer close" ou l'entrée "q")
@@ -1165,6 +1240,8 @@ Exemples :
 unmerge : détacher le tampon courant des autres tampons portant le même numéro
    hide : masquer le tampon
  unhide : démasquer le tampon
+  switch : basculer vers le tampon mélangé suivant (ou vers le tampon précédent avec -previous)
+    zoom : zoom sur le tampon mélangé
 renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.look.buffer_auto_renumber est désactivée)
   close : fermer le tampon (nombre/intervalle ou nom optionnel)
  notify : afficher ou définir le niveau de notification pour le tampon courant : ce niveau détermine si le tampon doit être ajouté à la hotlist ou pas :
@@ -1178,9 +1255,14 @@ renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.l
  delvar : supprimer une variable locale du tampon courant
     set : modifier une propriété du tampon courant
     get : afficher une propriété du tampon courant
+    jump : sauter vers un autre tampon :
+           smart : prochain tampon avec de l'activité
+           last_displayed : dernier tampon affiché (avant le dernier saut vers un tampon)
+           prev_visited : tampon visité précédemment
+           next_visited : tampon visité après
  nombre : sauter au tampon qui a ce numéro, préfixe possible :
-           '+' : saut relatif, ajoute le numéro au courant,
-           '-' : saut relatif, soustrait le numéro au courant,
+           '+' : saut relatif, ajoute le numéro au courant
+           '-' : saut relatif, soustrait le numéro au courant
           '*' : saut au numéro en utilisant l'option "jump_current_to_previous_buffer"
       - : sauter au premier numéro de tampon
       + : sauter au dernier numéro de tampon
@@ -1302,32 +1384,40 @@ Exemples :
 ----
 /debug  list
        set <extension> <niveau>
-        dump [<extension>]
-        buffer|color|infolists|libs|certs|memory|tags|term|windows
+        dump|hooks [<extension>]
+        buffer|certs|color|dirs|infolists|libs|memory|tags|term|windows
        cursor|mouse [verbose]
        hdata [free]
        time <commande>
+        unicode <chaîne>

     list : lister les extensions avec leur niveau de debug
      set : définir le niveau de debug pour l'extension
 extension : nom de l'extension ("core" pour le cœur de WeeChat)
   niveau : niveau de debug pour l'extension
     dump : afficher les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante)
+    hooks : afficher des infos sur les hooks (avec une extension : afficher les infos détaillées sur les hooks créés par l'extension)
   buffer : afficher le contenu du tampon en valeurs hexadécimales dans le fichier log
+    certs : afficher le nombre de certificats des autorités de certification chargés
    color : afficher des infos sur les paires de couleur courantes
   cursor : activer/désactiver le debug pour le mode curseur
     dirs : afficher les répertoires
    hdata : afficher des infos sur les hdata (avec free : supprimer tous les hdata en mémoire)
-    hooks : afficher des infos sur les hooks
 infolists : afficher des infos sur les infolists
     libs : afficher des infos sur les bibliothèques externes utilisées
-    certs : afficher le nombre de certificats des autorités de certification chargés
   memory : afficher des infos sur l'utilisation de la mémoire
    mouse : activer/désactiver le debug pour la souris
     tags : afficher les étiquettes pour les lignes
     term : afficher des infos sur le terminal
  windows : afficher l'arbre des fenêtres
     time : mesurer le temps pour exécuter une commande ou pour envoyer du texte au tampon courant
+  unicode : afficher des informations sur la chaîne et les caractères unicode (évaluée, voir /help eval)
+
+Exemples :
+  /debug set irc 1
+  /debug mouse verbose
+  /debug time /filter toggle
+  /debug unicode ${chars:${\u26C0}-${\u26CF}}
 ----

 [[command_weechat_eval]]
@@ -1374,33 +1464,36 @@ Pour forcer une comparaison de chaînes, vous pouvez ajouter des guillemets auto
  "50" > "100"  ==> 1

 Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
-  1. la chaîne elle-même sans évaluation (format : "raw:xxx")
-  2. une variable définie par l'utilisateur (format : "nom")
-  3. une sous-chaîne évaluée (format : "eval:xxx")
-  4. une condition évaluée (format : "eval_cond:xxx")
-  5. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
-  6. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
-  7. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
-     ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
-  8. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
-  9. une chaîne répétée (format : "repeat:nombre,chaîne")
-  10. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
-  11. découpage d'une chaîne (format : "split:nombre,séparateurs,flags,xxx")
-  12. découpage de paramètres shell (format : "split_shell:nombre,xxx")
-  13. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
-  14. un modificateur (format : "modifier:nom,données,chaîne")
-  15. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
-  16. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
-  17. la date/heure courante (format : "date" ou "date:format")
-  18. une variable d'environnement (format : "env:XXX")
-  19. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
-  20. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format : "calc:xxx")
-  21. un nombre entier aléatoire (format : "random:min,max")
-  22. une chaîne traduite (format : "translate:xxx")
-  23. déclaration d'une variable utilisateur (format : "define:nom,valeur")
-  24. une option (format : "fichier.section.option")
-  25. une variable locale du tampon
-  26. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
+  - la chaîne elle-même sans évaluation (format : "raw:xxx")
+  - une variable définie par l'utilisateur (format : "nom")
+  - une sous-chaîne évaluée (format : "eval:xxx")
+  - une condition évaluée (format : "eval_cond:xxx")
+  - une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
+  - une chaîne avec un intervalle de caractères (format : "chars:xxx" ou "chars:c1-c2")
+  - une chaîne convertie en minuscules (format : "lower:xxx")
+  - une chaîne convertie en majuscules (format : "upper:xxx")
+  - une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
+  - une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
+    ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
+  - une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
+  - une chaîne répétée (format : "repeat:nombre,chaîne")
+  - longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
+  - découpage d'une chaîne (format : "split:nombre,séparateurs,flags,xxx")
+  - découpage de paramètres shell (format : "split_shell:nombre,xxx")
+  - une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
+  - un modificateur (format : "modifier:nom,données,chaîne")
+  - une info (format : "info:nom,paramètres", les paramètres sont optionnels)
+  - une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
+  - la date/heure courante (format : "date" ou "date:format")
+  - une variable d'environnement (format : "env:XXX")
+  - un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
+  - le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format : "calc:xxx")
+  - un nombre entier aléatoire (format : "random:min,max")
+  - une chaîne traduite (format : "translate:xxx")
+  - déclaration d'une variable utilisateur (format : "define:nom,valeur")
+  - une option (format : "fichier.section.option")
+  - une variable locale du tampon
+  - un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
 Le format du hdata peut être le suivant :
  hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
  hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, par exemple :
@@ -1423,6 +1516,10 @@ Exemples (chaînes simples) :
  /eval -n ${window.buffer.full_name}             ==> core.weechat
  /eval -n ${window.buffer.number}                ==> 1
  /eval -n ${\t}                                  ==> <tab>
+  /eval -n ${chars:digit}                         ==> 0123456789
+  /eval -n ${chars:J-T}                           ==> JKLMNOPQRST
+  /eval -n ${lower:TEST}                          ==> test
+  /eval -n ${upper:test}                          ==> TEST
  /eval -n ${hide:-,${relay.network.password}}    ==> --------
  /eval -n ${cut:3,+,test}                        ==> tes+
  /eval -n ${cut:+3,+,test}                       ==> te+
@@ -1468,7 +1565,7 @@ Exemples (conditions) :
         add|addreplace <nom> <tampon>[,<tampon>...] <étiquettes> <regex>
         rename <nom> <nouveau_nom>
         recreate <nom>
-         del <nom>|-all
+         del <nom>|-all [<nom>...]

      list : lister tous les filtres
    enable : activer les filtres (par défaut les filtres sont activés)
@@ -1552,6 +1649,22 @@ extension : lister les commandes de cette extension
 valeur : nombre d'entrées dans l'historique à afficher
 ----

+[[command_weechat_hotlist]]
+* `+hotlist+`: gestion de la hotlist
+
+----
+/hotlist  add [low|message|private|highlight]
+          clear [<niveau>]
+          remove
+          restore [-all]
+
+   add : ajouter le tampon courant dans la hotlist (niveau par défaut : "low", les conditions définies dans l'option weechat.look.hotlist_add_conditions ne sont PAS vérifiées)
+ clear : effacer la hotlist
+ niveau : "lowest" pour effacer seulement le plus petit niveau dans la hotlist, "highest" pour effacer seulement le niveau le plus haut dans la hotlist, ou un masque de niveaux : entier qui est une combinaison de 1=join/part, 2=message, 4=privé, 8=highlight
+ remove : supprimer le tampon courant de la hotlist
+restore : restaurer la dernière hotlist supprimée dans le tampon courant (ou tous les tampons avec -all)
+----
+
 [[command_weechat_input]]
 * `+input+`: fonctions pour la ligne de commande

@@ -1574,6 +1687,7 @@ liste des actions :
  delete_previous_char : effacer le caractère précédent
  delete_next_char : effacer le caractère suivant
  delete_previous_word : effacer le mot précédent
+  delete_previous_word_whitespace : effacer le mot précédent (jusqu'à un espace)
  delete_next_word : effacer le mot suivant
  delete_beginning_of_line : effacer du début de la ligne jusqu'au curseur
  delete_end_of_line : effacer du curseur jusqu'à la fin de la ligne
@@ -1592,29 +1706,59 @@ liste des actions :
  history_next : rappeler la commande suivante dans l'historique du tampon courant
  history_global_previous : rappeler la commande précédente dans l'historique global
  history_global_next : rappeler la commande suivante dans l'historique global
-  jump_smart : sauter au prochain tampon avec de l'activité
-  jump_last_buffer_displayed : sauter au dernier tampon affiché (avant le dernier saut vers un tampon)
-  jump_previously_visited_buffer : sauter au tampon visité précédemment
-  jump_next_visited_buffer : sauter au tampon visité après
-  hotlist_clear : effacer la hotlist (paramètre facultatif : "lowest" pour effacer seulement le plus petit niveau dans la hotlist, "highest" pour effacer seulement le niveau le plus haut dans la hotlist, ou un masque de niveaux : entier qui est une combinaison de 1=join/part, 2=message, 4=privé, 8=highlight)
-  hotlist_remove_buffer : supprimer le tampon courant de la hotlist
-  hotlist_restore_buffer : restaurer la dernière hotlist supprimée dans le tampon courant
-  hotlist_restore_all : restaurer la dernière hotlist supprimée dans tous les tampons
  grab_key : capturer une touche (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
  grab_key_command : capturer une touche avec sa commande associée (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
  grab_mouse : capturer un évènement de la souris
  grab_mouse_area : capturer un évènement de la souris avec la zone
-  set_unread : définir le marqueur de données non lues pour tous les tampons
-  set_unread_current_buffer : définir le marqueur de données non lues pour le tampon courant
-  switch_active_buffer : basculer vers le tampon mélangé suivant
-  switch_active_buffer_previous : basculer vers le tampon mélangé précédent
-  zoom_merged_buffer : zoom sur le tampon mélangé
  insert : insérer du texte dans la ligne de commande (les caractères échappés sont autorisés, voir /help print)
  send : envoyer du texte au tampon
  paste_start : début de collage (mode "bracketed paste")
  paste_stop : fin de collage (mode "bracketed paste")

-Cette commande est utilisé par les associations de touches ou les extensions.
+Cette commande est utilisée par les associations de touches ou les extensions.
+----
+
+[[command_weechat_item]]
+* `+item+`: gestion des objets de barre personnalisés
+
+----
+/item  list
+       add|addreplace <nom> "<conditions>" "<contenu>"
+       rename <nom> <nouveau_nom>
+       refresh <nom> [<nom>...]
+       recreate <nom>
+       del <nom>|-all
+
+      list : lister tous les objets de barre personnalisés
+       add : ajouter un objet de barre personnalisé
+addreplace : ajouter ou remplacer un objet de barre personnalisé existant
+       nom : nom de l'objet de barre personnalisé
+conditions : conditions évaluées pour afficher l'objet de barre (par exemple pour afficher l'objet de barre seulement sur certains tampons)
+   contenu : contenu (évalué, voir /help eval)
+    rename : renommer un objet de barre personnalisé
+   refresh : mettre à jour le contenu d'un objet de barre personnalisé dans toutes les barres où l'objet est affiché ; tout objet peut être rafraîchi : défaut/extension/objets de barre personnalisés
+  recreate : définir la ligne de commande utilisée pour éditer l'objet de barre personnalisé
+       del : supprimer un objet de barre personnalisé
+      -all : supprimer tous les objets de barre personnalisés
+
+Exemples :
+  ajouter un objet avec la taille du terminal, affiché seulement sur les tampons avec numéro = 1 :
+    /item add terminfo "${buffer.number} == 1" "term:${info:term_width}x${info:term_height}"
+  ajouter un objet avec des informations sur le tampon :
+    /item add bufinfo "" "${buffer.number}:${buffer.name}${if:${buffer.zoomed}?(Z)}"
+  ajouter un objet avec la date/heure en utilisant le format "Dec 25, 12:34 +0100", rafraîchi chaque minute :
+    /item add datetime "" "${date:%b %d, %H:%M %z}"
+    /trigger add datetime_refresh timer "60000;60" "" "" "/item refresh datetime"
+  ajouter un objet avec le nombre de lignes dans le tampon (affichées/total), rafraîchi à chaque nouvelle ligne affichée ou si les lignes filtrées ont changé :
+    /item add lines_count "" "${calc:${buffer.lines.lines_count}-${buffer.lines.lines_hidden}}/${buffer.lines.lines_count} lines"
+    /trigger add lines_count_refresh_print print "" "" "" "/item refresh lines_count"
+    /trigger add lines_count_refresh_signal signal "window_switch;buffer_switch;buffer_lines_hidden;filters_*" "" "" "/item refresh lines_count"
+  forcer le rafraîchissement de l'objet "lines_count" :
+    /item refresh lines_count
+  recréer l'objet "lines_count" avec différentes conditions ou contenu :
+    /item recreate lines_count
+  supprimer l'objet "lines_count" :
+    /item del lines_count
 ----

 [[command_weechat_key]]
@@ -1667,7 +1811,7 @@ Exemples :
  restaure l'association par défaut pour la touche alt-r :
    /key reset meta-r
  touche "tab" pour arrêter la recherche dans le tampon :
-    /key bindctxt search ctrl-I /input search_stop
+    /key bindctxt search ctrl-i /input search_stop
  bouton du milieu de la souris sur un pseudo pour récupérer les infos sur le pseudo :
    /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
 ----
@@ -2039,34 +2183,41 @@ Exemples :
 ----

 [[command_weechat_upgrade]]
-* `+upgrade+`: relancer le binaire WeeChat sans se déconnecter des serveurs
+* `+upgrade+`: sauvegarder la session WeeChat et relancer le binaire WeeChat sans se déconnecter des serveurs

 ----
-/upgrade  [-yes] [<chemin_vers_binaire>|-quit]
+/upgrade  [-yes] [<chemin_vers_binaire>|-save|-quit]

               -yes : requis si l'option "weechat.look.confirm_upgrade" est activée
 chemin_vers_binaire : chemin vers le binaire WeeChat (par défaut le binaire courant)
             -dummy : ne rien faire (option utilisée pour éviter une complétion accidentelle avec "-quit")
-              -quit : fermer *TOUTES* les connexions, sauver la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous)
+              -save : sauvegarder seulement la session, ne pas quitter ni relancer WeeChat ; les fichiers de configuration ne sont pas sauvegardés (si besoin vous pouvez utiliser /save avant cette commande)
+              -quit : fermer *TOUTES* les connexions, sauvegarder la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous)

 Cette commande met à jour et recharge une session de WeeChat qui tourne. Le nouveau binaire WeeChat doit avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande.

 Note : les connexions SSL sont perdues durant la mise à jour, car le rechargement de session SSL n'est pas possible actuellement avec GnuTLS. Il y a une reconnexion automatique après la mise à jour.

+Important : l'utilisation de l'option -save peut être dangereuse, il est recommandé d'utiliser seulement /upgrade (ou avec -quit) pour une mise à jour standard et un redémarrage ; l'option -save peut être utilisée pour sauvegarder régulièrement la session et la restaurer en cas de sortie anormale (panne de courant, crash, etc.).
+
 Le processus de mise à jour comporte 4 étapes :
  1. sauvegarder la session pour le cœur et les extensions (tampons, historique, ...)
  2. décharger toutes les extensions (les fichiers de configuration (*.conf) sont écrits sur disque)
  3. sauvegarder la configuration WeeChat (weechat.conf)
  4. exécuter le nouveau binaire WeeChat et recharger la session.

-Avec l'option "-quit", le processus est légèrement différent :
+Avec l'option "-quit", le processus est le suivant :
  1. fermer *TOUTES* les connexions
  2. sauvegarder la session (fichiers *.upgrade)
  3. décharger les extensions
  4. sauvegarder la configuration WeeChat
  5. quitter WeeChat
-Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade
-IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf).
+
+Avec l'option "-save", le processus est le suivant :
+  1. sauvegarder la session (fichiers *.upgrade) avec un état déconnecté pour les serveurs IRC et les clients Relay (mais aucune déconnexion n'est faite)
+
+Avec "-quit" ou "-save", vous pouvez restaurer la session plus tard avec cette commande : weechat --upgrade
+IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf) et si possible la même version de WeeChat (ou une plus récente).
 Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu des répertoires personnels de WeeChat (voir /debug dirs).
 ----

@@ -2166,7 +2317,7 @@ scroll_bottom : faire défiler jusqu'en bas du tampon
 scroll_beyond_end : faire défiler au-delà de la fin du tampon
 scroll_previous_highlight : faire défiler jusqu'au highlight précédent
 scroll_next_highlight : faire défiler jusqu'au highlight suivant
-scroll_unread : faire défiler jusqu'au marqueur de données non lues
+scroll_unread : faire défiler jusqu'au marqueur de lecture
         swap : échanger les tampons de deux fenêtres (avec une direction facultative pour la fenêtre cible)
         zoom : zoomer sur la fenêtre
         bare : activer/désactiver le mode d'affichage dépouillé (avec un délai facultatif en secondes pour un retour automatique au mode d'affichage standard)
@@ -2251,6 +2402,7 @@ Les variables suivantes peuvent être utilisées dans ces options :
    - ${format_hotlist} : la hotlist formatée (évaluation de l'option buflist.format.hotlist)
    - ${hotlist} : la hotlist brute
    - ${hotlist_priority} : "none", "low", "message", "private" ou "highlight"
+    - ${hotlist_priority_number} : -1 = none, 0 = low, 1 = message, 2 = private, 3 = highlight
    - ${format_lag} : le lag pour un tampon de serveur IRC, vide s'il n'y a pas de lag (évaluation de l'option buflist.format.lag)
    - ${format_tls_version}: indicateur de la version de TLS pour le serveur courant, vide pour les canaux (évaluation de l'option buflist.format.tls_version)
 ----
@@ -2498,7 +2650,7 @@ Touches et entrées pour définir les options sur le tampon fset :
                    u:xxx   démarquer les options affichées qui correspondent au filtre "xxx" (tout filtre sur une option ou valeur est autorisé, voir les filtres ci-dessus)

 Autres touches et entrées sur le tampon fset :
-  ctrl+L                    rafraîchir les options et l'écran entier (commande : /fset -refresh)
+  ctrl+l                    rafraîchir les options et l'écran entier (commande : /fset -refresh)
                    $       rafraîchir les options (garder les options marquées)
                    $$      rafraîchir les options (démarquer toutes les options)
  alt+p             p       activer/désactiver la description des options d'extensions (plugins.desc.*)
@@ -2508,7 +2660,7 @@ Autres touches et entrées sur le tampon fset :
                    w:xxx   exporter les options dans le fichier "xxx"
                    w-:xxx  exporter les options dans le fichier "xxx" sans aide
                    w+:xxx  exporter les options dans le fichier "xxx" avec aide
-  ctrl+X            x       basculer le format utilisé pour afficher les options
+  ctrl+x            x       basculer le format utilisé pour afficher les options
                    q       fermer le tampon fset

 Actions de la souris sur le tampon fset :
@@ -2817,7 +2969,7 @@ protocole.nom : protocole et nom à relayer :
                  - protocole "weechat" (le nom n'est pas utilisé)

 Le protocole "irc" permet à n'importe quel client IRC (incluant WeeChat lui-même) de se connecter sur le port.
-Le protocole "weechat" permet à une interface distante de se connecter sur le port, voir la liste ici : https://weechat.org/about/interfaces
+Le protocole "weechat" permet à une interface distante de se connecter sur le port, voir la liste ici : https://weechat.org/about/interfaces/

 Sans paramètre, cette commande ouvre le tampon avec la liste des clients pour le relai.

@@ -2972,7 +3124,7 @@ Exemples :
 ----
 /spell  enable|disable|toggle
        listdict
-        setdict <dict>[,<dict>...]
+        setdict -|<dict>[,<dict>...]
        deldict
        addword [<dict>] <mot>

@@ -2980,7 +3132,7 @@ Exemples :
 disable : désactiver le vérificateur d'orthographe
  toggle : activer/désactiver le vérificateur d'orthographe
 listdict : afficher les dictionnaires installés
- setdict : définir le dictionnaire pour le tampon courant (plusieurs dictionnaires peuvent être séparés par une virgule)
+ setdict : définir le dictionnaire pour le tampon courant (plusieurs dictionnaires peuvent être séparés par une virgule, la valeur spéciale "-" désactive la vérification orthographique sur le tampon courant)
 deldict : supprimer le dictionnaire utilisé sur le tampon courant
 addword : ajouter un mot dans le dictionnaire personnel

@@ -3107,8 +3259,10 @@ Exemples (vous pouvez aussi regarder les triggers par défaut avec /trigger list
  cacher la barre de pseudos sur les petits terminaux :
    /trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
    /trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
-  sauver la configuration chaque heure (de manière silencieuse) :
+  sauver silencieusement la configuration chaque heure :
    /trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
+  sauver silencieusement la session WeeChat à minuit (voir /help upgrade) :
+    /trigger add session_save signal day_changed "" "" "/mute /upgrade -save"
  ouvrir le tampon moniteur des triggers et afficher seulement les modificateurs et les triggers dont le nom commence par "resize" :
    /trigger monitor @modifier,resize*
 ----
@@ -8,37 +8,37 @@
 |===
 | Alias | Commande | Complétion

-| /AAWAY | /allserv /away | -
-| /ANICK | /allserv /nick | -
-| /BEEP | /print -beep | -
-| /BYE | /quit | -
-| /C | /buffer clear | -
-| /CL | /buffer clear | -
-| /CLOSE | /buffer close | -
-| /CHAT | /dcc chat | -
-| /EXIT | /quit | -
-| /IG | /ignore | -
-| /J | /join | -
-| /K | /kick | -
-| /KB | /kickban | -
-| /LEAVE | /part | -
-| /M | /msg | -
-| /MUB | /unban * | -
-| /MSGBUF | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
-| /N | /names | -
-| /Q | /query | -
-| /REDRAW | /window refresh | -
-| /SAY | /msg * | -
-| /SIGNOFF | /quit | -
-| /T | /topic | -
-| /UB | /unban | -
-| /UMODE | /mode $nick | -
-| /V | /command core version | -
-| /W | /who | -
-| /WC | /window close | -
-| /WI | /whois | -
-| /WII | /whois $1 $1 | -
-| /WM | /window merge | -
-| /WW | /whowas | -
+| /aaway | /allserv /away | -
+| /anick | /allserv /nick | -
+| /beep | /print -beep | -
+| /bye | /quit | -
+| /c | /buffer clear | -
+| /cl | /buffer clear | -
+| /close | /buffer close | -
+| /chat | /dcc chat | -
+| /exit | /quit | -
+| /ig | /ignore | -
+| /j | /join | -
+| /k | /kick | -
+| /kb | /kickban | -
+| /leave | /part | -
+| /m | /msg | -
+| /mub | /unban * | -
+| /msgbuf | /command -buffer $1 * /input send $2- | %(buffers_plugins_names)
+| /n | /names | -
+| /q | /query | -
+| /redraw | /window refresh | -
+| /say | /msg * | -
+| /signoff | /quit | -
+| /t | /topic | -
+| /ub | /unban | -
+| /umode | /mode $nick | -
+| /v | /command core version | -
+| /w | /who | -
+| /wc | /window close | -
+| /wi | /whois | -
+| /wii | /whois $1 $1 | -
+| /wm | /window merge | -
+| /ww | /whowas | -
 |===
 // end::default_aliases[]
--- a/Show More
+++ b/Show More