Version 4.4.3

The `.git` directory can also be a regular file in a git worktree.

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -9,7 +9,7 @@ body:
         Before submitting a bug, please check that it has not already been reported by searching in [open and closed bugs](https://github.com/weechat/weechat/issues?q=is%3Aissue+label%3Abug).
         If you don't use the latest version, please try if possible with the latest stable release to be sure the issue is still present and report the issue on this version.
 
-        **IMPORTANT**: please do not report any security issue here, see [Contributing.adoc](https://github.com/weechat/weechat/blob/master/Contributing.adoc#security-reports).
+        **IMPORTANT**: please do not report any security issue here, see [CONTRIBUTING.md](https://github.com/weechat/weechat/blob/main/CONTRIBUTING.md#security-reports).
 
   - type: textarea
     id: bug-description
@@ -85,9 +85,9 @@ body:
   - type: input
     id: os-version
     attributes:
-      label: What OS are you using?
+      label: What OS/distribution are you using?
       description: Name of the operating system and its version.
-      placeholder: Debian 12, Ubuntu 23.10, MacOS 14, ...
+      placeholder: Debian 12, Ubuntu 24.04, MacOS 14, ...
     validations:
       required: true
 

.github/workflows/ci.yml

@@ -1,11 +1,47 @@
 name: CI
 
 on:
-  - push
+  push:
-  - pull_request
+  pull_request:
+  schedule:
+    - cron: '22 9 * * 2'
 
 env:
-  WEECHAT_DEPENDENCIES: devscripts equivs python3-pip cmake ninja-build lcov pkg-config libncurses-dev gem2deb libperl-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-3.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev libzstd-dev zlib1g-dev curl libcpputest-dev php-dev libphp-embed libargon2-dev libsodium-dev flake8 pylint python3-bandit asciidoctor ruby-pygments.rb shellcheck
+  WEECHAT_DEPENDENCIES: >-
+    asciidoctor
+    cmake
+    curl
+    devscripts
+    equivs
+    flake8
+    gem2deb
+    guile-3.0-dev
+    lcov
+    libargon2-dev
+    libaspell-dev
+    libcjson-dev
+    libcpputest-dev
+    libcurl4-gnutls-dev
+    libgcrypt20-dev
+    libgnutls28-dev
+    liblua5.3-dev
+    libncurses-dev
+    libperl-dev
+    libphp-embed
+    libsodium-dev
+    libv8-dev
+    libzstd-dev
+    ninja-build
+    php-dev
+    pkgconf
+    pylint
+    python3-bandit
+    python3-dev
+    python3-pip
+    ruby-pygments.rb
+    shellcheck
+    tcl8.6-dev
+    zlib1g-dev
 
 jobs:
 
@@ -20,6 +56,7 @@ jobs:
           - { name: "gcc_ninja", cc: "gcc", cxx: "g++", buildargs: "-G Ninja" }
           - { name: "gcc_no_nls", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_NLS=OFF -DENABLE_DOC=OFF" }
           - { name: "gcc_no_zstd", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_ZSTD=OFF -DENABLE_DOC=OFF" }
+          - { name: "gcc_no_cjson", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CJSON=OFF -DENABLE_DOC=OFF" }
           - { name: "gcc_coverage", cc: "gcc", cxx: "g++", buildargs: "-DENABLE_CODE_COVERAGE=ON" }
           - { name: "clang", cc: "clang", cxx: "clang++", buildargs: "" }
 
@@ -45,7 +82,7 @@ jobs:
       run: ./tools/check_scripts.sh
 
     - name: Check Python stub file
-      run: ./doc/python_stub.py | diff src/plugins/python/weechat.pyi -
+      run: ./tools/generate_python_stub.py | diff src/plugins/python/weechat.pyi -
 
     - name: Check Curl symbols
       run: curl --silent --show-error --fail --retry 10 https://raw.githubusercontent.com/curl/curl/master/docs/libcurl/symbols-in-versions | ./tools/check_curl_symbols.py
@@ -63,11 +100,28 @@ jobs:
       run: |
         weechat --help
         weechat-curses --help
+        weechat --version
+        weechat --build-info
         weechat --colors
         weechat --license
-        weechat --version
         weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
 
+    - name: Test Relay OpenAPI
+      if: ${{ matrix.config.name == 'gcc' }}
+      env:
+        RELAY_PASSWORD: test
+      run: |
+        sudo -H pip3 install --ignore-installed schemathesis
+        weechat-headless \
+          --dir /tmp/weechat-test-api \
+          --run-command '/set relay.network.password "${{ env.RELAY_PASSWORD }}"' \
+          --run-command '/relay add api 9000' \
+          --daemon \
+        ;
+        sleep 5
+        ./tools/test_relay_api.sh http://localhost:9000
+        echo '*/quit' >/tmp/weechat-test-api/weechat_fifo_*
+
     - name: Code coverage
       if: ${{ matrix.config.name == 'gcc_coverage' }}
       env:
@@ -85,7 +139,6 @@ jobs:
       matrix:
         os:
           - macos-12
-          - macos-11
         config:
           - { name: "gcc", cc: "gcc", cxx: "g++" }
           - { name: "clang", cc: "clang", cxx: "clang++" }
@@ -115,7 +168,7 @@ jobs:
           /usr/local/bin/python3.11 \
           /usr/local/bin/python3.11-config \
         ;
-        brew install asciidoctor guile lua pkg-config ruby
+        brew install asciidoctor cjson guile lua pkg-config ruby
 
     - uses: actions/checkout@v2
 
@@ -135,9 +188,10 @@ jobs:
       run: |
         weechat --help
         weechat-curses --help
+        weechat --version
+        weechat --build-info
         weechat --colors
         weechat --license
-        weechat --version
         weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
 
   build_debian:
@@ -175,4 +229,41 @@ jobs:
         weechat --help
         weechat-curses --help
         weechat --version
+        weechat --build-info
         weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
+
+  codeql-analysis:
+
+    name: CodeQL
+    runs-on: ubuntu-latest
+
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    - name: Install dependencies
+      run: |
+        sudo apt-get update -qq
+        sudo apt-get --yes --no-install-recommends install ${{ env.WEECHAT_DEPENDENCIES }}
+        # uninstall php imagick as is causes a crash when loading php plugin (see #2009)
+        sudo apt-get --yes purge php8.1-imagick
+        sudo -H pip3 install --ignore-installed msgcheck
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: cpp
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:cpp"

AUTHORS.adoc

@@ -1,163 +0,0 @@
-= WeeChat Authors
-:author: Sébastien Helleu
-:email: flashcode@flashtux.org
-:lang: en
-
-
-== Developers
-
-* General code
-** Sébastien Helleu (FlashCode) <flashcode@flashtux.org>
-* Scripts plugins, debian packager
-** Emmanuel Bouthenot (kolter) <kolter@openics.org>
-
-== Contributors
-
-Alphabetically:
-
-* Adam Saponara (adsr)
-* Adrian Bjugård
-* Ailin Nemui (Nei)
-* Aleksey V Zapparov
-* Alex Tarkovsky
-* Anders Bergh
-* Andrew Potter (talisein)
-* Antoine Pietri (seirl)
-* Arvydas Sidorenko
-* Asakura
-* Bazerka
-* Benoit Papillault (benoit)
-* Chris Hills
-* Christian Duerr
-* Christian Heinz
-* Christopher O'Neill (deltafire)
-* coypoop
-* Danilo Spinella
-* David Flatz
-* Dmitry Kobylin
-* Dominik Honnef
-* Dominique Martinet
-* dotflac
-* Eduardo Elias
-* Eli Schwartz
-* Elizabeth Myers (Elizacat)
-* Elián Hanisch (m4v)
-* Emanuele Giaquinta
-* Emir Sarı
-* emk
-* Érico Nogueira
-* Esteban I. Ruiz Moreno (Exio)
-* Evgeny Shmarnev
-* Felix Eckhofer
-* Frank Zacharias
-* Fredrik Fornwall
-* Grant Wu
-* Gu1ll4um3r0m41n
-* Guido Berhoerster
-* Gwenn
-* Hasan Kiran (turgay)
-* Ivan Pešić
-* Ivan Sichmann Freitas
-* Jakub Jirutka
-* Jan Palus
-* Jason A. Donenfeld (zx2c4)
-* JD Horelick (jdhore)
-* jesopo
-* Jim Ramsay (lack)
-* Jiri Golembiovsky (GolemJ)
-* Joey Pabalinas (alyptik)
-* Johan Rylander
-* Joram Schrijver
-* Jos Ahrens
-* Joseph Kichline
-* Juan Francisco Cantero Hurtado
-* Julien Louis (ptitlouis)
-* Karthik K
-* Koka El Kiwi (KiwiDash)
-* Krzysztof Koroscik (soltys)
-* Kyle Fuller (kylef)
-* Kyle Sabo
-* Latchezar Tzvetkoff
-* Lázaro A.
-* Leonid Evdokimov
-* Linus Heckemann
-* LuK1337
-* Maarten de Vries
-* Mantas Mikulėnas (grawity)
-* Marco Paolone
-* Marco Sirabella
-* Mario Campos
-* Mateusz Poszwa
-* Matt Robinson
-* Matthew Horan
-* Matthew Martin
-* Matti Virkkunen
-* Max Anton Teufel
-* Maxim Baz
-* Michael Siegel
-* Miroslav Koskar
-* Murilo Opsfelder Araujo
-* Neui
-* Nick (SolitaryCipher)
-* Nicolas Cavigneaux
-* Nils Görs (nils_2)
-* nyuszika7h
-* Odin
-* Ondřej Súkup
-* Patrick Steinhardt
-* Patrik Janoušek
-* Paul Komkoff
-* Pavel Shevchuk (Stalwart)
-* Peter Boström (pbos)
-* Phillip Sz
-* Pierre Carru
-* Piotr Szymaniak
-* Pistos
-* Quentin Glidic (SardemFF7)
-* Quentin Pradet
-* Quico Noizeux
-* rafasc
-* Raghavendra Prabhu
-* raspbeguy
-* Rettub
-* Rob Campbell
-* Romero B. de S. Malaquias
-* Rudolf Polzer (divVerent)
-* Ruslan Bekenev
-* Ryan Farley
-* Ryan Qian
-* Ryuunosuke Ayanokouzi
-* scumjr
-* Sergio Durigan Junior
-* Shane McCarron
-* Shawn Smith
-* Shun Sakai
-* Simmo Saan (sim642)
-* Simon Arlott
-* Simon Kuhnle
-* Simon Ser
-* Stefano Pigozzi
-* Stfn
-* Sven Knurr (Cthulhux)
-* Tim D. Smith
-* Tim Harder
-* Tobias Stoeckmann
-* Tom Alsberg
-* Tom Fitzhenry
-* Tomoe Mami
-* Tor Hveem (xt)
-* Trevor Bergeron
-* Valentin Lorentz (progval)
-* Vasco Almeida
-* Victorhck
-* Voroskoi
-* wfrsk
-* Wojciech Kwolek
-* W. Trevor King
-* Yannick Palanque
-* ZethJack
-* Ørjan Malde
-
-== Contact
-
-See the https://weechat.org/about/support/[support page].

AUTHORS.md

@@ -0,0 +1,161 @@
+# WeeChat Authors
+
+## Developers
+
+- General code
+  - [Sébastien Helleu](https://github.com/flashcode) (FlashCode)
+- Scripts plugins, debian packager
+  - [Emmanuel Bouthenot](https://github.com/k0lter) (kolter)
+
+## Contributors
+
+Alphabetically:
+
+- Adam Saponara (adsr)
+- Adrian Bjugård
+- Ailin Nemui (Nei)
+- Aleksey V Zapparov
+- Alex Tarkovsky
+- Anders Bergh
+- Andrew Potter (talisein)
+- Antoine Pietri (seirl)
+- Arvydas Sidorenko
+- Asakura
+- Bazerka
+- Benoit Papillault (benoit)
+- Chris Hills
+- Christian Duerr
+- Christian Heinz
+- Christopher O'Neill (deltafire)
+- coypoop
+- Danilo Spinella
+- David Flatz
+- Dmitry Kobylin
+- Dominik Honnef
+- Dominique Martinet
+- dotflac
+- Eduardo Elias
+- Eli Schwartz
+- Elizabeth Myers (Elizacat)
+- Elián Hanisch (m4v)
+- Emanuele Giaquinta
+- Emir Sarı
+- emk
+- Érico Nogueira
+- Esteban I. Ruiz Moreno (Exio)
+- Evgeny Shmarnev
+- Felix Eckhofer
+- Frank Zacharias
+- Fredrik Fornwall
+- Grant Wu
+- Gu1ll4um3r0m41n
+- Guido Berhoerster
+- Gwenn
+- Hasan Kiran (turgay)
+- Ivan Pešić
+- Ivan Sichmann Freitas
+- Jakub Jirutka
+- Jan Palus
+- Jason A. Donenfeld (zx2c4)
+- JD Horelick (jdhore)
+- jesopo
+- Jim Ramsay (lack)
+- Jiri Golembiovsky (GolemJ)
+- Joey Pabalinas (alyptik)
+- Johan Rylander
+- Johannes Kuhn
+- Joram Schrijver
+- Jos Ahrens
+- Joseph Kichline
+- Juan Francisco Cantero Hurtado
+- Julien Louis (ptitlouis)
+- Karthik K
+- Koka El Kiwi (KiwiDash)
+- Krzysztof Koroscik (soltys)
+- Kyle Fuller (kylef)
+- Kyle Sabo
+- Latchezar Tzvetkoff
+- Lázaro A.
+- Leonid Evdokimov
+- Linus Heckemann
+- LuK1337
+- Maarten de Vries
+- Mantas Mikulėnas (grawity)
+- Marco Paolone
+- Marco Sirabella
+- Mario Campos
+- Mateusz Poszwa
+- Matt Robinson
+- Matthew Horan
+- Matthew Martin
+- Matti Virkkunen
+- Max Anton Teufel
+- Maxim Baz
+- Michael Siegel
+- Miko
+- Miroslav Koskar
+- Murilo Opsfelder Araujo
+- Neui
+- Nick (SolitaryCipher)
+- Nicolas Cavigneaux
+- Nils Görs (nils_2)
+- nyuszika7h
+- Odin
+- Ondřej Súkup
+- Patrick Steinhardt
+- Patrik Janoušek
+- Paul Komkoff
+- Pavel Shevchuk (Stalwart)
+- Peter Boström (pbos)
+- Phillip Sz
+- Pierre Carru
+- Piotr Szymaniak
+- Pistos
+- Quentin Glidic (SardemFF7)
+- Quentin Pradet
+- Quico Noizeux
+- rafasc
+- Raghavendra Prabhu
+- raspbeguy
+- Rettub
+- Rob Campbell
+- Romero B. de S. Malaquias
+- Rudolf Polzer (divVerent)
+- Ruslan Bekenev
+- Ryan Farley
+- Ryan Qian
+- Ryuunosuke Ayanokouzi
+- scumjr
+- Sergio Durigan Junior
+- Shane McCarron
+- Shawn Smith
+- Shun Sakai
+- Simmo Saan (sim642)
+- Simon Arlott
+- Simon Kuhnle
+- Simon Ser
+- Stefano Pigozzi
+- Stfn
+- Sven Knurr (Cthulhux)
+- Tim D. Smith
+- Tim Harder
+- Tobias Stoeckmann
+- Tom Alsberg
+- Tom Fitzhenry
+- Tomoe Mami
+- Tor Hveem (xt)
+- Trevor Bergeron
+- Valentin Lorentz (progval)
+- Vasco Almeida
+- Victorhck
+- Voroskoi
+- wfrsk
+- Wojciech Kwolek
+- W. Trevor King
+- Yannick Palanque
+- ZethJack
+- Ørjan Malde
+
+## Contact
+
+See the [support page](https://weechat.org/about/support/).

CMakeLists.txt

@@ -100,6 +100,7 @@ option(ENABLE_HEADLESS       "Compile the headless binary"              ON)
 option(ENABLE_NLS            "Enable Native Language Support"           ON)
 option(ENABLE_LARGEFILE      "Enable Large File Support"                ON)
 option(ENABLE_ZSTD           "Enable Zstandard compression"             ON)
+option(ENABLE_CJSON          "Enable cJSON support"                     ON)
 option(ENABLE_ALIAS          "Enable Alias plugin"                      ON)
 option(ENABLE_BUFLIST        "Enable Buflist plugin"                    ON)
 option(ENABLE_CHARSET        "Enable Charset plugin"                    ON)
@@ -191,6 +192,9 @@ include(CheckSymbolExists)
 check_include_files("langinfo.h" HAVE_LANGINFO_CODESET)
 check_include_files("sys/resource.h" HAVE_SYS_RESOURCE_H)
 
+check_include_files("malloc.h" HAVE_MALLOC_H)
+check_symbol_exists("malloc_trim" "malloc.h" HAVE_MALLOC_TRIM)
+
 check_function_exists(mallinfo HAVE_MALLINFO)
 check_function_exists(mallinfo2 HAVE_MALLINFO2)
 
@@ -202,9 +206,10 @@ if(ENABLE_LARGEFILE)
 endif()
 
 # Check for libgcrypt
-find_package(GCRYPT REQUIRED)
+pkg_check_modules(LIBGCRYPT REQUIRED libgcrypt)
 add_definitions(-DHAVE_GCRYPT)
-list(APPEND EXTRA_LIBS ${GCRYPT_LDFLAGS})
+include_directories(${LIBGCRYPT_INCLUDE_DIRS})
+list(APPEND EXTRA_LIBS ${LIBGCRYPT_LDFLAGS})
 
 # Check for GnuTLS
 find_package(GnuTLS REQUIRED)
@@ -222,6 +227,12 @@ if(ENABLE_ZSTD)
   add_definitions(-DHAVE_ZSTD)
 endif()
 
+# Check for cJSON
+if(ENABLE_CJSON)
+  pkg_check_modules(LIBCJSON REQUIRED libcjson)
+  add_definitions(-DHAVE_CJSON)
+endif()
+
 # Check for iconv
 find_package(Iconv)
 if(ICONV_FOUND)
@@ -249,7 +260,6 @@ add_subdirectory(icons)
 
 if(ENABLE_NLS)
   find_package(Gettext REQUIRED)
-  add_definitions(-DENABLE_NLS)
   find_package(Intl REQUIRED)
   list(APPEND EXTRA_LIBS "${Intl_LIBRARIES}")
   add_subdirectory(po)
@@ -311,11 +321,11 @@ configure_file("${CMAKE_CURRENT_SOURCE_DIR}/weechat.cygport.in" "${CMAKE_CURRENT
 # install some files (only on Cygwin)
 if(CYGWIN)
   install(FILES
-    "${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.md"
-    "${CMAKE_CURRENT_SOURCE_DIR}/ChangeLog.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md"
-    "${CMAKE_CURRENT_SOURCE_DIR}/Contributing.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/CONTRIBUTING.md"
-    "${CMAKE_CURRENT_SOURCE_DIR}/README.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/README.md"
-    "${CMAKE_CURRENT_SOURCE_DIR}/ReleaseNotes.adoc"
+    "${CMAKE_CURRENT_SOURCE_DIR}/UPGRADING.md"
     DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}"
   )
 endif()

CONTRIBUTING.md

@@ -0,0 +1,109 @@
+# Contributing to WeeChat
+
+## Reporting bugs
+
+First, some basic things:
+
+- Use only English to communicate with developers.
+- Search in issues if the same problem or feature request has already been
+  reported (a duplicate is waste of time for you and the developers!).
+- If you can, please check if the problem has been fixed in development version
+  (if you are using a stable release or old version).
+- Report only one bug or feature request per issue.
+
+### Security reports
+
+Please **DO NOT** file a GitHub issue for security related problems, but send an
+email to [security@weechat.org](mailto:security@weechat.org) instead.
+
+### Required info
+
+When reporting [issues](https://github.com/weechat/weechat/issues) on GitHub,
+please include:
+
+- Your **WeeChat version**: the output of `/v` in WeeChat, for example:
+  `WeeChat 1.7-dev (git: v1.6-6-g997f47f)`.\
+  If WeeChat does not start at all, please include the version displayed by
+  `weechat --help` (or the version installed with your package manager).
+- Your **operating system**: its name and version (examples: Linux Debian Bookworm,
+  FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit…).
+- The **steps to reproduce**: if possible, please include a reproducible example:
+  explain the steps which led you to the problem.\
+  It's even better if you can reproduce the problem with a new config (and no
+  scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
+  problem here.
+- The **gdb's backtrace** (only for a crash): if you can reproduce the crash
+  (or if you have a core file), please include the backtrace from gdb (look at
+  [User's guide](https://weechat.org/doc/weechat/user/#report_crashes) for more info).
+- The **actual result**.
+- The **expected result**: the correct result you are expecting.
+
+> [!IMPORTANT]
+> Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_)
+is **NOT USEFUL** to fix the bug, so please report this file **ONLY** if a developer
+asked you to send it (and be extremely careful, this file can contain personal
+data like passwords and contents of your chats).
+
+### Scripts related issues
+
+If you are using scripts, they can cause problems/crashes. To check if the
+problem is related to one script, try to unload them one by one (using
+command `/script unload <name>`).
+
+Many issues reported are in fact related to bugs in scripts, so please first
+check that before reporting any issue on WeeChat itself.
+
+If you think the problem comes from a specific script, please report the issue
+in the [scripts git repository](https://github.com/weechat/scripts/issues) instead.
+
+## Translations
+
+Pull requests on GitHub for fixes or new translations are welcome at any
+time, for [WeeChat](https://github.com/weechat/weechat) and the website
+[weechat.org](https://github.com/weechat/weechat.org).
+
+To start a translation in a new language (not yet supported), please look at
+[translations](https://weechat.org/doc/weechat/dev/#translations)
+in Developer's guide.
+
+## Feature requests
+
+WeeChat is under active development, so your idea may already have been
+implemented, or scheduled for a future version (you can check in
+[roadmap](https://weechat.org/dev/) or
+[milestones](https://github.com/weechat/weechat/milestones) on GitHub.
+
+Pull requests on GitHub are welcome for minor new features.
+
+For major new features, it's better to discuss about it in IRC
+(server: `irc.libera.chat`, channel `#weechat`).
+
+Before submitting any pull request, be sure you have read the
+[coding rules](https://weechat.org/doc/weechat/dev/#coding_rules)
+in Developer's guide, which contains info about styles used, naming convention
+and other useful info.
+
+## Semantic versioning
+
+Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
+
+It is based on [Semantic Versioning](https://semver.org/) but in a less strict way:
+breaking changes in API with low user impact don't bump the major version.
+
+The version number is on three digits `X.Y.Z`, where:
+
+- `X` is the major version
+- `Y` is the minor version
+- `Z` is the patch version.
+
+Rules to increment the version number:
+
+- the **major version** number (`X`) is incremented only when intentional breaking changes
+  target feature areas that are actively consumed by users, scripts or C plugin API
+- the **minor version** number (`Y`) is incremented for any new release of WeeChat
+  that includes new features and bug fixes, possibly breaking API with low impact on users
+- the **patch version** number (`Z`) is reserved for releases that address severe bugs
+  or security issues found after the release.
+
+For more information, see the
+[specification](https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html).

Contributing.adoc

@@ -1,109 +0,0 @@
-= Contributing to WeeChat
-:author: Sébastien Helleu
-:email: flashcode@flashtux.org
-:lang: en
-
-
-== Reporting bugs
-
-First, some basic things:
-
-* Use only English to communicate with developers.
-* Search in issues if the same problem or feature request has already been
-  reported (a duplicate is waste of time for you and the developers!).
-* If you can, please check if the problem has been fixed in development version
-  (if you are using a stable release or old version).
-* Report only one bug or feature request per issue.
-
-=== Security reports
-
-Please *DO NOT* file a GitHub issue for security related problems, but send an
-email to <security@weechat.org> instead.
-
-=== Required info
-
-When reporting https://github.com/weechat/weechat/issues[issues] on GitHub,
-please include:
-
-* Your *WeeChat version*: the output of `/v` in WeeChat, for example:
-  _WeeChat 1.7-dev (git: v1.6-6-g997f47f)_. +
-  If WeeChat does not start at all, please include the version displayed by
-  `weechat --help` (or the version installed with your package manager).
-* Your *operating system*: its name and version (examples: Linux Debian Bookworm,
-  FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...).
-* The *steps to reproduce*: if possible, please include a reproducible example:
-  explain the steps which led you to the problem. +
-  It's even better if you can reproduce the problem with a new config (and no
-  scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
-  problem here.
-* The *gdb's backtrace* (only for a crash): if you can reproduce the crash
-  (or if you have a core file), please include the backtrace from gdb (look at
-  https://weechat.org/doc/weechat/user/#report_crashes[User's guide] for more info).
-* The *actual result*.
-* The *expected result*: the correct result you are expecting.
-
-[IMPORTANT]
-Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_) is
-*NOT USEFUL* to fix the bug, so please report this file *ONLY* if a developer
-asked you to send it (and be extremely careful, this file can contain personal
-data like passwords and contents of your chats).
-
-=== Scripts related issues
-
-If you are using scripts, they can cause problems/crashes. To check if the
-problem is related to one script, try to unload them one by one (using
-command `/script unload <name>`).
-
-Many issues reported are in fact related to bugs in scripts, so please first
-check that before reporting any issue on WeeChat itself.
-
-If you think the problem comes from a specific script, please report the issue
-in the https://github.com/weechat/scripts/issues[scripts git repository]
-instead.
-
-== Translations
-
-Pull requests on GitHub for fixes or new translations are welcome at any
-time, for https://github.com/weechat/weechat[WeeChat] and the website
-https://github.com/weechat/weechat.org[weechat.org].
-
-To start a translation in a new language (not yet supported), please look at
-https://weechat.org/doc/weechat/dev/#translations[translations]
-in Developer's guide.
-
-== Feature requests
-
-WeeChat is under active development, so your idea may already have been
-implemented, or scheduled for a future version (you can check in
-https://weechat.org/dev/[roadmap] or
-https://github.com/weechat/weechat/milestones[milestones] on GitHub.
-
-Pull requests on GitHub are welcome for minor new features.
-
-For major new features, it's better to discuss about it in IRC
-(server: _irc.libera.chat_, channel _#weechat_).
-
-Before submitting any pull request, be sure you have read the
-https://weechat.org/doc/weechat/dev/#coding_rules[coding rules]
-in Developer's guide, which contains info about styles used, naming convention
-and other useful info.
-
-== Semantic versioning
-
-Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
-
-It is based on https://semver.org/[Semantic Versioning] but in a less strict way: breaking changes in API with low user impact don't bump the major version.
-
-The version number is on three digits `X.Y.Z`, where:
-
-* `X` is the major version
-* `Y` is the minor version
-* `Z` is the patch version.
-
-Rules to increment the version number:
-
-* the *major version* number (`X`) is incremented only when intentional breaking changes target feature areas that are actively consumed by users, scripts or C plugin API
-* the *minor version* number (`Y`) is incremented for any new release of WeeChat that includes new features and bug fixes, possibly breaking API with low impact on users
-* the *patch version* number (`Z`) is reserved for releases that address severe bugs or security issues found after the release.
-
-For more information, see the https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html[specification].

README.adoc

@@ -1,67 +0,0 @@
-:author: Sébastien Helleu
-:email: flashcode@flashtux.org
-:lang: en
-
-
-pass:[<p align="center">] image:https://weechat.org/media/images/weechat_logo_large.png[align="center"] pass:[</p>]
-
-image:https://img.shields.io/badge/mastodon-follow-blue.svg["Mastodon", link="https://hostux.social/@weechat"]
-image:https://img.shields.io/badge/diaspora*-follow-blue.svg["Diaspora*", link="https://diasp.eu/u/weechat"]
-image:https://img.shields.io/badge/twitter-follow-blue.svg["Twitter", link="https://twitter.com/WeeChatClient"]
-image:https://img.shields.io/badge/devel%20blog-follow-blue.svg["Devel blog", link="https://blog.weechat.org/"]
-image:https://img.shields.io/badge/slant-recommend-28acad.svg["Slant", link="https://www.slant.co/topics/1323/~best-irc-clients-for-linux"]
-image:https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg["Donate", link="https://weechat.org/donate/"]
-
-image:https://github.com/weechat/weechat/workflows/CI/badge.svg["CI", link="https://github.com/weechat/weechat/actions"]
-image:https://codecov.io/gh/weechat/weechat/branch/master/graph/badge.svg["Code coverage", link="https://codecov.io/gh/weechat/weechat"]
-
-*WeeChat* (Wee Enhanced Environment for Chat) is a free chat client, fast and
-light, designed for many operating systems.
-It is highly customizable and extensible with scripts.
-
-Homepage: https://weechat.org/
-
-== Features
-
-* *Modular chat client*: WeeChat has a lightweight core and optional https://weechat.org/doc/weechat/user/#plugins[plugins]. All plugins (including https://weechat.org/doc/weechat/user/#irc[IRC]) are independent and can be unloaded.
-* *Multi-platform*: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
-* *Multi-protocols*: WeeChat is designed to support multiple protocols by plugins, like IRC.
-* *Standards-compliant*: the IRC plugin is compliant with RFCs https://datatracker.ietf.org/doc/html/rfc1459[1459], https://datatracker.ietf.org/doc/html/rfc2810[2810], https://datatracker.ietf.org/doc/html/rfc2811[2811], https://datatracker.ietf.org/doc/html/rfc2812[2812], https://datatracker.ietf.org/doc/html/rfc2813[2813] and https://datatracker.ietf.org/doc/html/rfc7194[7194].
-* *Small, fast, and very light*: the core is and should stay as light and fast as possible.
-* *Customizable and extensible*: there are a lot of options to customize WeeChat, and it is extensible with C plugins and https://weechat.org/scripts/[scripts] (https://weechat.org/scripts/language/perl/[Perl], https://weechat.org/scripts/language/python/[Python], https://weechat.org/scripts/language/ruby[Ruby], https://weechat.org/scripts/language/lua/[Lua], https://weechat.org/scripts/language/tcl/[Tcl], https://weechat.org/scripts/language/guile/[Scheme], https://weechat.org/scripts/language/javascript/[JavaScript] and https://weechat.org/scripts/language/php/[PHP]).
-* *Fully documented*: there is comprehensive https://weechat.org/doc/weechat/[documentation], which is https://weechat.org/doc/weechat/dev/#translations[translated] into several languages.
-* *Developed from scratch*: WeeChat was built from scratch and is not based on any other client.
-* *Free software*: WeeChat is released under https://www.gnu.org/licenses/gpl-3.0.html[GPLv3].
-
-pass:[<p align="center">] image:https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png[align="center"] pass:[</p>]
-
-On WeeChat's website you can find https://weechat.org/about/screenshots/[more screenshots].
-
-== Installation
-
-WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.
-
-For detailed instructions, please check the https://weechat.org/doc/weechat/user/#install[WeeChat user's guide].
-
-== Semantic versioning
-
-WeeChat is following a "practical" semantic versioning, see file link:Contributing.adoc#semantic-versioning[Contributing.adoc].
-
-== Copyright
-
-Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
-
-This file is part of WeeChat, the extensible chat client.
-
-WeeChat is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 3 of the License, or
-(at your option) any later version.
-
-WeeChat is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with WeeChat.  If not, see <https://www.gnu.org/licenses/>.

README.md

@@ -0,0 +1,66 @@
+# WeeChat
+
+<p align="center">
+  <img src="https://weechat.org/media/images/weechat_logo_large.png" alt="WeeChat" />
+</p>
+
+[![Mastodon](https://img.shields.io/badge/mastodon-follow-blue.svg)](https://hostux.social/@weechat)
+[![Diaspora*](https://img.shields.io/badge/diaspora*-follow-blue.svg)](https://diasp.eu/u/weechat)
+[![X](https://img.shields.io/badge/x-follow-blue.svg)](https://x.com/WeeChatClient)
+[![Devel blog](https://img.shields.io/badge/devel%20blog-follow-blue.svg)](https://blog.weechat.org/)
+[![Slant](https://img.shields.io/badge/slant-recommend-28acad.svg)](https://www.slant.co/topics/1323/~best-irc-clients-for-linux)
+[![Donate](https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg)](https://weechat.org/donate/)
+
+[![CI](https://github.com/weechat/weechat/workflows/CI/badge.svg)](https://github.com/weechat/weechat/actions)
+[![Code coverage](https://codecov.io/gh/weechat/weechat/branch/main/graph/badge.svg)](https://codecov.io/gh/weechat/weechat)
+
+**WeeChat** (Wee Enhanced Environment for Chat) is a free chat client, fast and light, designed for many operating systems.\
+It is highly customizable and extensible with scripts.
+
+Homepage: [https://weechat.org/](https://weechat.org/)
+
+## Features
+
+- **Modular chat client**: WeeChat has a lightweight core and optional [plugins](https://weechat.org/doc/weechat/user/#plugins). All plugins (including [IRC](https://weechat.org/doc/weechat/user/#irc)) are independent and can be unloaded.
+- **Multi-platform**: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
+- **Multi-protocols**: WeeChat is designed to support multiple protocols by plugins, like IRC.
+- **Standards-compliant**: the IRC plugin is compliant with RFCs [1459](https://datatracker.ietf.org/doc/html/rfc1459), [2810](https://datatracker.ietf.org/doc/html/rfc2810), [2811](https://datatracker.ietf.org/doc/html/rfc2811), [2812](https://datatracker.ietf.org/doc/html/rfc2812), [2813](https://datatracker.ietf.org/doc/html/rfc2813) and [7194](https://datatracker.ietf.org/doc/html/rfc7194).
+- **Small, fast, and very light**: the core is and should stay as light and fast as possible.
+- **Customizable and extensible**: there are a lot of options to customize WeeChat, and it is extensible with C plugins and [scripts](https://weechat.org/scripts/) ([Perl](https://weechat.org/scripts/language/perl/), [Python](https://weechat.org/scripts/language/python/), [Ruby](https://weechat.org/scripts/language/ruby), [Lua](https://weechat.org/scripts/language/lua/), [Tcl](https://weechat.org/scripts/language/tcl/), [Scheme](https://weechat.org/scripts/language/guile/), [JavaScript](https://weechat.org/scripts/language/javascript/) and [PHP](https://weechat.org/scripts/language/php/)).
+- **Fully documented**: there is comprehensive [documentation](https://weechat.org/doc/weechat/), which is [translated](https://weechat.org/doc/weechat/dev/#translations) into several languages.
+- **Developed from scratch**: WeeChat was built from scratch and is not based on any other client.
+- **Free software**: WeeChat is released under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html).
+
+<p align="center">
+  <img src="https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png" alt="WeeChat" />
+</p>
+
+On WeeChat's website you can find [more screenshots](https://weechat.org/about/screenshots/).
+
+## Installation
+
+WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.\
+For detailed instructions, please check the [WeeChat user's guide](https://weechat.org/doc/weechat/user/#install).
+
+## Semantic versioning
+
+WeeChat is following a "practical" semantic versioning, see file [CONTRIBUTING.md](CONTRIBUTING.md#semantic-versioning).
+
+## Copyright
+
+Copyright © 2003-2024 [Sébastien Helleu](https://github.com/flashcode)
+
+This file is part of WeeChat, the extensible chat client.
+
+WeeChat is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 3 of the License, or
+(at your option) any later version.
+
+WeeChat is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with WeeChat.  If not, see <https://www.gnu.org/licenses/>.

cmake/FindGCRYPT.cmake

@@ -1,53 +0,0 @@
-#
-# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
-#
-# This file is part of WeeChat, the extensible chat client.
-#
-# WeeChat is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 3 of the License, or
-# (at your option) any later version.
-#
-# WeeChat is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with WeeChat.  If not, see <https://www.gnu.org/licenses/>.
-#
-
-# - Find Gcrypt
-# This module finds if libgcrypt is installed and determines where
-# the include files and libraries are.
-#
-# This code sets the following variables:
-#
-#  GCRYPT_CFLAGS = cflags to use to compile
-#  GCRYPT_LDFLAGS = ldflags to use to compile
-#
-
-find_program(LIBGCRYPT_CONFIG_EXECUTABLE NAMES libgcrypt-config)
-
-set(GCRYPT_LDFLAGS)
-set(GCRYPT_CFLAGS)
-
-if(LIBGCRYPT_CONFIG_EXECUTABLE)
-
-  execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --libs RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_LDFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
-  execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --cflags RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_CFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
-
-  if(NOT DEFINED ${GCRYPT_CFLAGS})
-    set(GCRYPT_CFLAGS " ")
-  endif()
-
-endif()
-
-# handle the QUIETLY and REQUIRED arguments and set GCRYPT_FOUND to TRUE if
-# all listed variables are TRUE
-include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(GCRYPT REQUIRED_VARS GCRYPT_LDFLAGS GCRYPT_CFLAGS)
-
-if(GCRYPT_FOUND)
-  mark_as_advanced(GCRYPT_CFLAGS GCRYPT_LDFLAGS)
-endif()

cmake/FindLua.cmake

@@ -35,5 +35,5 @@ endif()
 
 find_package(PkgConfig)
 if(PKG_CONFIG_FOUND)
-  pkg_search_module(LUA lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50 lua)
+  pkg_search_module(LUA lua lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50)
 endif()

config.h.cmake

@@ -1,3 +1,39 @@
+#cmakedefine01 ENABLE_NCURSES
+#cmakedefine01 ENABLE_HEADLESS
+#cmakedefine01 ENABLE_NLS
+#cmakedefine01 ENABLE_LARGEFILE
+#cmakedefine01 ENABLE_ZSTD
+#cmakedefine01 ENABLE_CJSON
+#cmakedefine01 ENABLE_ALIAS
+#cmakedefine01 ENABLE_BUFLIST
+#cmakedefine01 ENABLE_CHARSET
+#cmakedefine01 ENABLE_EXEC
+#cmakedefine01 ENABLE_FIFO
+#cmakedefine01 ENABLE_FSET
+#cmakedefine01 ENABLE_IRC
+#cmakedefine01 ENABLE_LOGGER
+#cmakedefine01 ENABLE_RELAY
+#cmakedefine01 ENABLE_SCRIPT
+#cmakedefine01 ENABLE_SCRIPTS
+#cmakedefine01 ENABLE_PERL
+#cmakedefine01 ENABLE_PYTHON
+#cmakedefine01 ENABLE_RUBY
+#cmakedefine01 ENABLE_LUA
+#cmakedefine01 ENABLE_TCL
+#cmakedefine01 ENABLE_GUILE
+#cmakedefine01 ENABLE_JAVASCRIPT
+#cmakedefine01 ENABLE_PHP
+#cmakedefine01 ENABLE_SPELL
+#cmakedefine01 ENABLE_ENCHANT
+#cmakedefine01 ENABLE_TRIGGER
+#cmakedefine01 ENABLE_TYPING
+#cmakedefine01 ENABLE_XFER
+#cmakedefine01 ENABLE_MAN
+#cmakedefine01 ENABLE_DOC
+#cmakedefine01 ENABLE_DOC_INCOMPLETE
+#cmakedefine01 ENABLE_TESTS
+#cmakedefine01 ENABLE_CODE_COVERAGE
+
 #cmakedefine HAVE_SYS_RESOURCE_H
 #cmakedefine HAVE_FLOCK
 #cmakedefine HAVE_LANGINFO_CODESET
@@ -5,10 +41,16 @@
 #cmakedefine ICONV_2ARG_IS_CONST 1
 #cmakedefine HAVE_MALLINFO
 #cmakedefine HAVE_MALLINFO2
+#cmakedefine HAVE_MALLOC_H
+#cmakedefine HAVE_MALLOC_TRIM
 #cmakedefine HAVE_EAT_NEWLINE_GLITCH
 #cmakedefine HAVE_ASPELL_VERSION_STRING
 #cmakedefine HAVE_ENCHANT_GET_VERSION
 #cmakedefine HAVE_GUILE_GMP_MEMORY_FUNCTIONS
+
+#define CMAKE_BUILD_TYPE "@CMAKE_BUILD_TYPE@"
+#define CMAKE_INSTALL_PREFIX "@CMAKE_INSTALL_PREFIX@"
+
 #define PACKAGE_VERSION "@VERSION@"
 #define PACKAGE "@PROJECT_NAME@"
 #define PACKAGE_NAME "@PROJECT_NAME@"

debian-devel/control

@@ -6,7 +6,8 @@ Build-Depends:
     asciidoctor (>= 1.5.4),
     ruby-pygments.rb,
     debhelper (>= 12),
-    cmake, pkg-config,
+    cmake,
+    pkgconf,
     libncurses-dev,
     gem2deb,
     libperl-dev,
@@ -21,8 +22,9 @@ Build-Depends:
     libgcrypt20-dev,
     libgnutls28-dev,
     libzstd-dev,
-    zlib1g-dev
+    zlib1g-dev,
-Standards-Version: 4.6.2
+    libcjson-dev
+Standards-Version: 4.7.0
 Homepage: https://weechat.org/
 Vcs-Git: https://salsa.debian.org/kolter/weechat.git
 Vcs-Browser: https://salsa.debian.org/kolter/weechat

debian-devel/rules

@@ -16,8 +16,5 @@ override_dh_auto_configure:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
 
-override_dh_installchangelogs:
-	dh_installchangelogs ChangeLog.adoc
-
 %:
 	dh $@ --builddirectory=$(BUILDDIR)

debian-devel/weechat-devel-doc.doc-base.dev-sr

@@ -0,0 +1,10 @@
+Document: weechat-dev-sr
+Title: WeeChat developer's guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat internals and
+ how to contribute to WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html

debian-devel/weechat-devel-doc.doc-base.faq-sr

@@ -0,0 +1,10 @@
+Document: weechat-faq-sr
+Title: WeeChat FAQ (Serbian)
+Author: Sébastien Helleu
+Abstract: This document answers frequently asked questions
+ about the WeeChat IRC client (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html

debian-devel/weechat-devel-doc.doc-base.plugin-sr

@@ -0,0 +1,10 @@
+Document: weechat-plugin-sr
+Title: WeeChat plugin API reference (Serbian)
+Author: Sébastien Helleu
+Abstract: This document describes the API to create plugins
+ for WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html

debian-devel/weechat-devel-doc.doc-base.quickstart-cs

@@ -0,0 +1,9 @@
+Document: weechat-quickstart-cs
+Title: WeeChat quick start guide (Czech)
+Author: Sébastien Helleu
+Abstract: A short HowTo for new WeeChat users (Czech version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html

debian-devel/weechat-devel-doc.doc-base.quickstart-sr

@@ -0,0 +1,9 @@
+Document: weechat-quickstart-sr
+Title: WeeChat quick start guide (Serbian)
+Author: Sébastien Helleu
+Abstract: A short HowTo for new WeeChat users (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html

debian-devel/weechat-devel-doc.doc-base.relay-api-en

@@ -0,0 +1,10 @@
+Document: weechat-relay-api-en
+Title: WeeChat Relay "api" protocol (English)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "api" protocol, used by
+ remote GUI or WeeChat to communicate with Relay plugin (English version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html

debian-devel/weechat-devel-doc.doc-base.relay-api-fr

@@ -0,0 +1,10 @@
+Document: weechat-relay-api-fr
+Title: WeeChat Relay "api" protocol (French)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "api" protocol, used by
+ remote GUI or WeeChat to communicate with Relay plugin (French version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html

debian-devel/weechat-devel-doc.doc-base.relay-protocol-en

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-en
-Title: WeeChat Relay protocol (English)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (English version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html
-Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html

debian-devel/weechat-devel-doc.doc-base.relay-protocol-fr

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-fr
-Title: WeeChat Relay protocol (French)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (French version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html
-Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html

debian-devel/weechat-devel-doc.doc-base.relay-protocol-ja

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-ja
-Title: WeeChat Relay protocol (Japanese)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (Japanese version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html
-Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html

debian-devel/weechat-devel-doc.doc-base.relay-weechat-en

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-en
+Title: WeeChat Relay "weechat" protocol (English)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (English version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html

debian-devel/weechat-devel-doc.doc-base.relay-weechat-fr

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-fr
+Title: WeeChat Relay "weechat" protocol (French)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (French version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html

debian-devel/weechat-devel-doc.doc-base.relay-weechat-ja

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-ja
+Title: WeeChat Relay "weechat" protocol (Japanese)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (Japanese version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html

debian-devel/weechat-devel-doc.doc-base.relay-weechat-sr

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-sr
+Title: WeeChat Relay "weechat" protocol (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html

debian-devel/weechat-devel-doc.doc-base.scripting-sr

@@ -0,0 +1,10 @@
+Document: weechat-scripting-sr
+Title: WeeChat scripting guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This document describes the API to create scripts
+ for WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html

debian-devel/weechat-devel-doc.doc-base.user-sr

@@ -0,0 +1,10 @@
+Document: weechat-user-sr
+Title: WeeChat user's guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes how to use the WeeChat
+ IRC client (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html

debian-stable/changelog

@@ -1,3 +1,28 @@
+weechat (4.4.2-1) unstable; urgency=medium
+
+  * New upstream release
+    - fix crash where exiting (Closes: #1076532)
+    - fix a minor security issue (Closes: #1081942)
+  * Bump Standards-Version to 4.7.0
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Sun, 22 Sep 2024 13:08:28 +0000
+
+weechat (4.3.1-1) unstable; urgency=medium
+
+  * New upstream release (Closes: #1067608)
+    - fix FTBFS against libgcrypt 1.11 (Closes: #1071960)
+  * Add build dependency on libcjson-dev
+  * Replace pkg-config build dependency by pkgconf
+  * Minor updates in debian/copyright
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Sat, 01 Jun 2024 14:21:02 +0000
+
+weechat (4.1.1-1) unstable; urgency=medium
+
+  * New upstream release (Closes: #1055278)
+
+ -- Emmanuel Bouthenot <kolter@debian.org>  Fri, 03 Nov 2023 20:23:37 +0000
+
 weechat (4.0.5-1) unstable; urgency=medium
 
   * New upstream release

debian-stable/control

@@ -6,7 +6,8 @@ Build-Depends:
     asciidoctor (>= 1.5.4),
     ruby-pygments.rb,
     debhelper (>= 12),
-    cmake, pkg-config,
+    cmake,
+    pkgconf,
     libncurses-dev,
     gem2deb,
     libperl-dev,
@@ -21,8 +22,9 @@ Build-Depends:
     libgcrypt20-dev,
     libgnutls28-dev,
     libzstd-dev,
-    zlib1g-dev
+    zlib1g-dev,
-Standards-Version: 4.6.2
+    libcjson-dev
+Standards-Version: 4.7.0
 Homepage: https://weechat.org/
 Vcs-Git: https://salsa.debian.org/kolter/weechat.git
 Vcs-Browser: https://salsa.debian.org/kolter/weechat

debian-stable/copyright

@@ -7,23 +7,23 @@ Files: *
 Copyright: 2003-2024, Sébastien Helleu <flashcode@flashtux.org>
 License: GPL-3+
 
-Files: src/core/wee-command.c
+Files: src/core/core-command.c
-       src/core/wee-command.h
+       src/core/core-command.h
 Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+
 
-Files: src/core/wee-config-file.c
+Files: src/core/core-config-file.c
-       src/core/wee-config-file.h
+       src/core/core-config-file.h
-       src/core/wee-config.c
+       src/core/core-config.c
-       src/core/wee-config.h
+       src/core/core-config.h
 Copyright: 2005-2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+
 
-Files: src/core/hook/wee-hook-connect.c
+Files: src/core/hook/hook-connect.c
 Copyright: 2012, Simon Arlott
 License: GPL-3+
 
-Files: src/core/hook/wee-hook-connect.h
+Files: src/core/hook/hook-connect.h
 Copyright: 2012, Simon Arlott
 License: GPL-3+
 
@@ -31,9 +31,9 @@ Files: src/gui/gui-history.c
 Copyright: 2005, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+
 
-Files: src/core/wee-completion.c
+Files: src/core/core-completion.c
-       src/core/wee-log.c
+       src/core/core-log.c
-       src/core/wee-utf8.c
+       src/core/core-utf8.c
        src/core/weechat.h
        src/plugins/spell/spell-config.c
        src/plugins/spell/spell-config.h
@@ -45,7 +45,7 @@ Files: src/core/wee-completion.c
 Copyright: 2006, Emmanuel Bouthenot <kolter@openics.org>
 License: GPL-3+
 
-Files: src/core/wee-network.c
+Files: src/core/core-network.c
 Copyright: 2005-2010, Emmanuel Bouthenot <kolter@openics.org>
            2010, Gu1ll4um3r0m41n <aeroxteam@gmail.com>
            2012, Simon Arlott

debian-stable/rules

@@ -16,8 +16,5 @@ override_dh_auto_configure:
 		-DCMAKE_SKIP_RPATH:BOOL=ON \
 		-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
 
-override_dh_installchangelogs:
-	dh_installchangelogs ChangeLog.adoc
-
 %:
 	dh $@ --builddirectory=$(BUILDDIR)

debian-stable/weechat-core.docs

@@ -1,4 +1,5 @@
-AUTHORS.adoc
+AUTHORS.md
-Contributing.adoc
+CHANGELOG.md
-README.adoc
+CONTRIBUTING.md
-ReleaseNotes.adoc
+README.md
+UPGRADING.md

debian-stable/weechat-curses.links

@@ -7,3 +7,4 @@ usr/share/man/it/man1/weechat.1.gz usr/share/man/it/man1/weechat-curses.1.gz
 usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz
 usr/share/man/pl/man1/weechat.1.gz usr/share/man/pl/man1/weechat-curses.1.gz
 usr/share/man/ru/man1/weechat.1.gz usr/share/man/ru/man1/weechat-curses.1.gz
+usr/share/man/sr/man1/weechat.1.gz usr/share/man/sr/man1/weechat-curses.1.gz

debian-stable/weechat-devel-doc.doc-base.relay-api-en

@@ -0,0 +1,10 @@
+Document: weechat-relay-api-en
+Title: WeeChat Relay "api" protocol (English)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "api" protocol, used by
+ remote GUI or WeeChat to communicate with Relay plugin (English version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html

debian-stable/weechat-devel-doc.doc-base.relay-api-fr

@@ -0,0 +1,10 @@
+Document: weechat-relay-api-fr
+Title: WeeChat Relay "api" protocol (French)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "api" protocol, used by
+ remote GUI or WeeChat to communicate with Relay plugin (French version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
+Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html

debian-stable/weechat-doc.doc-base.dev-sr

@@ -0,0 +1,10 @@
+Document: weechat-dev-sr
+Title: WeeChat developer's guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat internals and
+ how to contribute to WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html

debian-stable/weechat-doc.doc-base.faq-sr

@@ -0,0 +1,10 @@
+Document: weechat-faq-sr
+Title: WeeChat FAQ (Serbian)
+Author: Sébastien Helleu
+Abstract: This document answers frequently asked questions
+ about the WeeChat IRC client (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html

debian-stable/weechat-doc.doc-base.plugin-sr

@@ -0,0 +1,10 @@
+Document: weechat-plugin-sr
+Title: WeeChat plugin API reference (Serbian)
+Author: Sébastien Helleu
+Abstract: This document describes the API to create plugins
+ for WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html

debian-stable/weechat-doc.doc-base.quickstart-cs

@@ -0,0 +1,9 @@
+Document: weechat-quickstart-cs
+Title: WeeChat quick start guide (Czech)
+Author: Sébastien Helleu
+Abstract: A short HowTo for new WeeChat users (Czech version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html
+Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html

debian-stable/weechat-doc.doc-base.quickstart-sr

@@ -0,0 +1,9 @@
+Document: weechat-quickstart-sr
+Title: WeeChat quick start guide (Serbian)
+Author: Sébastien Helleu
+Abstract: A short HowTo for new WeeChat users (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html

debian-stable/weechat-doc.doc-base.relay-protocol-en

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-en
-Title: WeeChat Relay protocol (English)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (English version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html
-Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html

debian-stable/weechat-doc.doc-base.relay-protocol-fr

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-fr
-Title: WeeChat Relay protocol (French)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (French version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html
-Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html

debian-stable/weechat-doc.doc-base.relay-protocol-ja

@@ -1,10 +0,0 @@
-Document: weechat-relay-protocol-ja
-Title: WeeChat Relay protocol (Japanese)
-Author: Sébastien Helleu
-Abstract: This manual describes WeeChat Relay Protocol, used by
- remote GUI to communicate with Relay plugin (Japanese version).
-Section: Network/Communication
-
-Format: HTML
-Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html
-Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html

debian-stable/weechat-doc.doc-base.relay-weechat-en

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-en
+Title: WeeChat Relay "weechat" protocol (English)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (English version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html
+Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html

debian-stable/weechat-doc.doc-base.relay-weechat-fr

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-fr
+Title: WeeChat Relay "weechat" protocol (French)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (French version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html

debian-stable/weechat-doc.doc-base.relay-weechat-ja

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-ja
+Title: WeeChat Relay "weechat" protocol (Japanese)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (Japanese version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html
+Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html

debian-stable/weechat-doc.doc-base.relay-weechat-sr

@@ -0,0 +1,10 @@
+Document: weechat-relay-weechat-sr
+Title: WeeChat Relay "weechat" protocol (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
+ remote GUI to communicate with Relay plugin (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html

debian-stable/weechat-doc.doc-base.scripting-sr

@@ -0,0 +1,10 @@
+Document: weechat-scripting-sr
+Title: WeeChat scripting guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This document describes the API to create scripts
+ for WeeChat (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html

debian-stable/weechat-doc.doc-base.user-sr

@@ -0,0 +1,10 @@
+Document: weechat-user-sr
+Title: WeeChat user's guide (Serbian)
+Author: Sébastien Helleu
+Abstract: This manual describes how to use the WeeChat
+ IRC client (Serbian version).
+Section: Network/Communication
+
+Format: HTML
+Index: /usr/share/doc/weechat-doc/html/weechat_user.sr.html
+Files: /usr/share/doc/weechat-doc/html/weechat_user.sr.html

doc/CMakeLists.txt

@@ -28,7 +28,8 @@ if(ENABLE_MAN OR ENABLE_DOC)
   set(SCRIPTING_LANG de en fr it ja pl sr)
   set(FAQ_LANG de en es fr it ja pl sr)
   set(QUICKSTART_LANG cs de en es fr it ja pl ru sr)
-  set(RELAY_LANG en fr ja sr)
+  set(RELAY_API_LANG en fr)
+  set(RELAY_WEECHAT_LANG en fr ja sr)
   set(DEV_LANG en fr ja sr)
 
   find_package(Asciidoctor)
@@ -39,7 +40,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
       -a reproducible
       -a "prewrap!"
       -a "webfonts!"
-      -a icons=font
       -a revnumber="${VERSION}"
       -a sectanchors
       -a source-highlighter=pygments
@@ -93,8 +93,17 @@ if(ENABLE_MAN OR ENABLE_DOC)
       -a docinfo1
     )
 
-    # asciidoctor arguments for relay protocol
+    # asciidoctor arguments for relay "api"
-    set(ASCIIDOCTOR_RELAY_ARGS
+    set(ASCIIDOCTOR_RELAY_API_ARGS
+      -a toc=left
+      -a toclevels=3
+      -a sectnums
+      -a sectnumlevels=2
+      -a docinfo1
+    )
+
+    # asciidoctor arguments for relay "weechat"
+    set(ASCIIDOCTOR_RELAY_WEECHAT_ARGS
       -a toc=left
       -a toclevels=3
       -a sectnums
@@ -111,54 +120,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
       -a docinfo1
     )
 
-    # sed arguments used to replace links in ChangeLog and release notes
-    set(SED_LINKS_ARGS
-      -e "'s/issue #\\([0-9][0-9]*\\)/https:\\/\\/github.com\\/weechat\\/weechat\\/issues\\/\\1[issue #\\1^]/g'"
-      -e "'s/bug #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/bugs\\/?\\1[bug #\\1^]/g'"
-      -e "'s/task #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/task\\/?\\1[task #\\1^]/g'"
-      -e "'s/patch #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/patch\\/?\\1[patch #\\1^]/g'"
-      -e "'s/debian #\\([0-9][0-9]*\\)/http:\\/\\/bugs.debian.org\\/cgi-bin\\/bugreport.cgi?bug=\\1[debian bug #\\1^]/g'"
-      -e "'s/\\(CVE-[0-9][0-9]*-[0-9][0-9]*\\)/https:\\/\\/cve.mitre.org\\/cgi-bin\\/cvename.cgi?name=\\1[\\1^]/g'"
-    )
-
-    # ChangeLog
-    add_custom_command(
-      OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
-      COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
-      DEPENDS
-      "${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc"
-      WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
-    )
-    add_custom_command(
-      OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html"
-      COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ChangeLog.html "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
-      DEPENDS
-      "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
-      "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
-      WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
-      COMMENT "Building ChangeLog.html"
-    )
-    add_custom_target(changelog DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html")
-
-    # Release notes
-    add_custom_command(
-      OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
-      COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
-      DEPENDS
-      "${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc"
-      WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
-    )
-    add_custom_command(
-      OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html"
-      COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ReleaseNotes.html "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
-      DEPENDS
-      "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
-      "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
-      WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
-      COMMENT "Building ReleaseNotes.html"
-    )
-    add_custom_target(rn DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html")
-
     if(ENABLE_DOC)
       set(AUTOGEN_FILES "")
       foreach(lang ${AUTOGEN_LANG})
@@ -177,6 +138,9 @@ if(ENABLE_MAN OR ENABLE_DOC)
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_default_aliases.${lang}.adoc"
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_irc_colors.${lang}.adoc"
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_options.${lang}.adoc"
+          # scripting duide
+          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_functions.${lang}.adoc"
+          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_constants.${lang}.adoc"
         )
       endforeach()
       add_custom_target(doc-autogen ALL
@@ -240,6 +204,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_user.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/cmdline_options.${lang}.adoc"
           doc-autogen
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_commands.${lang}.adoc"
@@ -260,6 +225,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_plugin_api.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
           doc-autogen
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_completions.${lang}.adoc"
           "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_config_priority.${lang}.adoc"
@@ -283,6 +249,10 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_scripting.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
+          doc-autogen
+          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_functions.${lang}.adoc"
+          "${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_constants.${lang}.adoc"
           WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
           COMMENT "Building weechat_scripting.${lang}.html"
         )
@@ -297,6 +267,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_faq.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
           WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
           COMMENT "Building weechat_faq.${lang}.html"
         )
@@ -311,25 +282,44 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_quickstart.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
           WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
           COMMENT "Building weechat_quickstart.${lang}.html"
         )
         add_custom_target(doc-quickstart-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html")
         install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
       endforeach()
-      # relay protocol
+      # relay "api"
-      foreach(lang ${RELAY_LANG})
+      foreach(lang ${RELAY_API_LANG})
         add_custom_command(
-          OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html"
+          OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html"
-          COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_ARGS} -o "weechat_relay_protocol.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
+          COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_API_ARGS} -o "weechat_relay_api.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc"
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
-          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
           WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
-          COMMENT "Building weechat_relay_protocol.${lang}.html"
+          COMMENT "Building weechat_relay_api.${lang}.html"
         )
-        add_custom_target(doc-relay-protocol-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html")
+        add_custom_target(doc-relay-api-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html")
-        install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
+        install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
+      endforeach()
+      # relay "weechat"
+      foreach(lang ${RELAY_WEECHAT_LANG})
+        add_custom_command(
+          OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html"
+          COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_WEECHAT_ARGS} -o "weechat_relay_weechat.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
+          DEPENDS
+          "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
+          WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
+          COMMENT "Building weechat_relay_weechat.${lang}.html"
+        )
+        add_custom_target(doc-relay-weechat-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html")
+        install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
       endforeach()
       # developer's guide
       foreach(lang ${DEV_LANG})
@@ -339,6 +329,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
           DEPENDS
           "${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
           "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_dev.${lang}.adoc"
+          "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
           WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
           COMMENT "Building weechat_dev.${lang}.html"
         )

doc/cs/includes/attributes-cs.adoc

@@ -0,0 +1,23 @@
+// czech translation, for reference only; matches the built-in behavior of core
+:appendix-caption: Příloha
+:appendix-refsig: {appendix-caption}
+:caution-caption: Upozornění
+:chapter-signifier: Kapitola
+:chapter-refsig: {chapter-signifier}
+:example-caption: Příklad
+:figure-caption: Obrázek
+:important-caption: Důležité
+:last-update-label: Změněno
+ifdef::listing-caption[:listing-caption: Seznam]
+ifdef::manname-title[:manname-title: Název]
+:note-caption: Poznámka
+:part-signifier: Část
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Úvod]
+:section-refsig: Oddíl
+:table-caption: Tabulka
+:tip-caption: Tip
+:toc-title: Obsah
+:untitled-label: Nepojmenovaný
+:version-label: Verze
+:warning-caption: Varování

doc/cs/includes/cmdline_options.cs.adoc

@@ -39,6 +39,10 @@
 *-h*, *--help*::
     Zobrazí nápovědu.
 
+// TRANSLATION MISSING
+*-i*, *--build-info*::
+    Display build information and exit.
+
 *-l*, *--license*::
     Zobrazí licenci WeeChatu.
 

doc/cs/includes/man.cs.adoc

@@ -97,7 +97,7 @@ $HOME/.local/share/weechat/weechat.log::
 
 // tag::copyright[]
 WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
-souboru AUTHORS.adoc).
+souboru AUTHORS.md).
 
 Copyright (C) 2003-2024 {author}
 

doc/cs/weechat_quickstart.cs.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: cs
+include::includes/attributes-cs.adoc[]
 
 [[start]]
 == Spuštění WeeChatu
@@ -12,8 +13,9 @@ klávesových zkratek.
 
 Spustění z Vašeho shellu:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 [[help]]

doc/de/includes/attributes-de.adoc

@@ -0,0 +1,23 @@
+// German translation, courtesy of Florian Wilhelm
+:appendix-caption: Anhang
+:appendix-refsig: {appendix-caption}
+:caution-caption: Achtung
+:chapter-signifier: Kapitel
+:chapter-refsig: {chapter-signifier}
+:example-caption: Beispiel
+:figure-caption: Abbildung
+:important-caption: Wichtig
+:last-update-label: Zuletzt aktualisiert
+ifdef::listing-caption[:listing-caption: Listing]
+ifdef::manname-title[:manname-title: Bezeichnung]
+:note-caption: Anmerkung
+:part-signifier: Teil
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Vorwort]
+:section-refsig: Abschnitt
+:table-caption: Tabelle
+:tip-caption: Hinweis
+:toc-title: Inhaltsverzeichnis
+:untitled-label: Ohne Titel
+:version-label: Version
+:warning-caption: Warnung

doc/de/includes/cmdline_options.de.adoc

@@ -35,6 +35,9 @@
 *-h*, *--help*::
     zeigt einen Hilfstext an.
 
+*-i*, *--build-info*::
+    Build-Informationen anzeigen und beenden.
+
 *-l*, *--license*::
     zeigt die Lizenz von WeeChat an.
 

doc/de/includes/man.de.adoc

@@ -98,7 +98,7 @@ $HOME/.local/share/weechat/weechat.log::
 
 // tag::copyright[]
 WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
-findet man in der AUTHORS.adoc Datei).
+findet man in der AUTHORS.md Datei).
 
 Copyright (C) 2003-2024 {author}
 

doc/de/weechat_faq.de.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]
 
 Übersetzer:
 
@@ -54,12 +54,14 @@ Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.
 Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird.
 Hilfe erhält man mittels:
 
+[source,shell]
 ----
 brew info weechat
 ----
 
 WeeChat kann durch folgenden Befehl installiert werden:
 
+[source,shell]
 ----
 brew install weechat
 ----
@@ -331,11 +333,16 @@ unterstützt (rxvt-unicode, konsole, gnome-terminal, ... um nur einige zu nennen
 Im Normalfall erfolgt die Markierung des Textes mittels der Tasten kbd:[Ctrl+Alt]
 in Verbindung mit der Auswahl durch die Maus.
 
+// TRANSLATION MISSING
+You can toggle nicklist and make it visible only when needed, with key
+kbd:[Alt+Shift+N].
+
 Eine weitere Möglichkeit besteht darin,
 die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positionieren:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 [[urls]]
@@ -345,10 +352,14 @@ Dazu kann man den vereinfachten Anzeigemodus nutzen (Standardtaste: kbd:[Alt+l]
 
 Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werden:
 
+// TRANSLATION MISSING
+* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
+
 * Die Benutzerliste am oberen Bildschirmbereich positionieren.
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 * Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren.
@@ -399,6 +410,7 @@ Umgebungsvariable `TZ` muss auf einen entsprechenden Wert eingestellt werden.
 Am Besten machen Sie dies in Ihrer Shell-Initialisierungsdatei oder in der
 Befehlszeile, bevor Sie WeeChat starten:
 
+[source,shell]
 ----
 export TZ=Europe/Berlin
 ----
@@ -713,8 +725,9 @@ Entsprechend der ausgegebenen Information, wird ggf. eine Maus nicht unterstütz
 Um zu testen ob eine Mausunterstützung vom Terminal bereitgestellt wird, sollte
 man folgende Zeile im Terminal eingeben:
 
+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----
 
 Jetzt klickt man mit der Maus auf das erste Zeichen im Terminal (linke obere
@@ -722,8 +735,9 @@ Ecke). Als Ergebnis sollte man folgende Zeichenkette erhalten: " !!#!!".
 
 Um die Mausunterstützung im Terminal zu beenden:
 
+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----
 
 [[mouse_coords]]
@@ -790,7 +804,7 @@ Man sollte versuchen, eine andere Priorität zu nutzen; Im folgenden Beispiel
 muss "xxx" durch den betroffenen Servernamen ersetzt werden:
 
 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----
 
 [[irc_tls_libera]]
@@ -1067,8 +1081,9 @@ Als erstes sollte das Kapitel über TLS Verbindungen in dieser FAQ gelesen werde
 Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
 folgenden Befehl in der Shell ausführen:
 
+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
 [NOTE]
@@ -1092,15 +1107,17 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
 
 * und in der Shell, mit installiertem curl:
 
+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
+cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
 Wenn Sie macOS ausführen und die heruntergeladene Datei eine Größe von 0 Byte hat,
 versuchen Sie, diese Variable in Ihrer Shell-Initialisierungsdatei oder auf der
 Befehlszeile zu setzen. Bevor Sie WeeChat starten:
 
+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1272,6 +1289,7 @@ siehe https://weechat.org/about/support/[this page ^↗^^].
 
 Falls man WeeChat in gdb ausführt, kann folgende Fehlermeldung erscheinen:
 
+[source,shell]
 ----
 $ gdb /Pfad/zu/weechat
 (gdb) run
@@ -1282,6 +1300,7 @@ Cannot find new threads: generic error
 Um diesen Fehler zu beheben, sollte man gdb wie folgt aufrufen (der Pfad zu
 libpthread und WeeChat muss natürlich an das eigene System angepasst werden):
 
+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
 (gdb) run

doc/de/weechat_quickstart.de.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]
 
 Übersetzer:
 
@@ -19,8 +19,9 @@ keine Probleme mit der Standard Tastaturbelegung.
 
 Programmstart aus deiner Shell:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 [[help]]

doc/de/weechat_scripting.de.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]
 
 Übersetzer:
 
@@ -73,7 +73,7 @@ und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_
 WeeChat definiert ein `weechat` Module welches mittels `import weechat`
 importiert werden muss. +
 Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
+https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
 
 [[python_functions]]
 ===== Funktionen
@@ -373,9 +373,10 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
 
 Ein Beispiel für ein Python-Skript:
 
+[source,shell]
 ----
-$ cd ~/.local/share/weechat/python/autoload
+cd ~/.local/share/weechat/python/autoload
-$ ln -s ../script.py
+ln -s ../script.py
 ----
 
 [NOTE]
@@ -564,317 +565,14 @@ lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^
 
 Liste der Skript API Funktionen:
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_functions.de.adoc[tag=functions]
-|===
-| Kategorie | Funktionen
-
-| Allgemein
-| register
-
-| Erweiterungen
-| plugin_get_name
-
-| Strings
-| charset_set +
-  iconv_to_internal +
-  iconv_from_internal +
-  gettext +
-  ngettext +
-  strlen_screen +
-  string_match +
-  string_match_list +
-  string_has_highlight +
-  string_has_highlight_regex +
-  string_mask_to_regex +
-  string_format_size +
-  string_parse_size +
-  string_color_code_size +
-  string_remove_color +
-  string_is_command_char +
-  string_input_for_buffer +
-  string_eval_expression +
-  string_eval_path_home
-
-| Verzeichnisse
-| mkdir_home +
-  mkdir +
-  mkdir_parents
-
-| sortierte Listen
-| list_new +
-  list_add +
-  list_search +
-  list_search_pos +
-  list_casesearch +
-  list_casesearch_pos +
-  list_get +
-  list_set +
-  list_next +
-  list_prev +
-  list_string +
-  list_size +
-  list_remove +
-  list_remove_all +
-  list_free
-
-| Konfigurationsdatei
-| config_new +
-  config_new_section +
-  config_search_section +
-  config_new_option +
-  config_search_option +
-  config_string_to_boolean +
-  config_option_reset +
-  config_option_set +
-  config_option_set_null +
-  config_option_unset +
-  config_option_rename +
-  config_option_is_null +
-  config_option_default_is_null +
-  config_boolean +
-  config_boolean_default +
-  config_integer +
-  config_integer_default +
-  config_string +
-  config_string_default +
-  config_color +
-  config_color_default +
-  config_write_option +
-  config_write_line +
-  config_write +
-  config_read +
-  config_reload +
-  config_option_free +
-  config_section_free_options +
-  config_section_free +
-  config_free +
-  config_get +
-  config_get_plugin +
-  config_is_set_plugin +
-  config_set_plugin +
-  config_set_desc_plugin +
-  config_unset_plugin
-
-| Tastenbelegung
-| key_bind +
-  key_unbind
-
-| Ausgabe
-| prefix +
-  color +
-  print (für Python: prnt) +
-  print_date_tags (für Python: prnt_date_tags) +
-  print_datetime_tags (für Python: prnt_datetime_tags) +
-  print_y (für Python: prnt_y) +
-  print_y_date_tags (für Python: prnt_y_date_tags) +
-  print_y_datetime_tags (für Python: prnt_y_datetime_tags) +
-  log_print
-
-| Hooks
-| hook_command +
-  hook_command_run +
-  hook_timer +
-  hook_fd +
-  hook_process +
-  hook_process_hashtable +
-  hook_connect +
-  hook_line +
-  hook_print +
-  hook_signal +
-  hook_signal_send +
-  hook_hsignal +
-  hook_hsignal_send +
-  hook_config +
-  hook_completion +
-  hook_modifier +
-  hook_modifier_exec +
-  hook_info +
-  hook_info_hashtable +
-  hook_infolist +
-  hook_focus +
-  hook_set +
-  unhook +
-  unhook_all
-
-| Buffer
-| buffer_new +
-  buffer_new_props +
-  current_buffer +
-  buffer_search +
-  buffer_search_main +
-  buffer_clear +
-  buffer_close +
-  buffer_merge +
-  buffer_unmerge +
-  buffer_get_integer +
-  buffer_get_string +
-  buffer_get_pointer +
-  buffer_set +
-  buffer_string_replace_local_var +
-  buffer_match_list
-
-| Fenster
-| current_window +
-  window_search_with_buffer +
-  window_get_integer +
-  window_get_string +
-  window_get_pointer +
-  window_set_title
-
-| Nickliste
-| nicklist_add_group +
-  nicklist_search_group +
-  nicklist_add_nick +
-  nicklist_search_nick +
-  nicklist_remove_group +
-  nicklist_remove_nick +
-  nicklist_remove_all +
-  nicklist_group_get_integer +
-  nicklist_group_get_string +
-  nicklist_group_get_pointer +
-  nicklist_group_set +
-  nicklist_nick_get_integer +
-  nicklist_nick_get_string +
-  nicklist_nick_get_pointer +
-  nicklist_nick_set
-
-| Bars
-| bar_item_search +
-  bar_item_new +
-  bar_item_update +
-  bar_item_remove +
-  bar_search +
-  bar_new +
-  bar_set +
-  bar_update +
-  bar_remove
-
-| Befehle
-| command +
-  command_options
-
-| Vervollständigung
-| completion_new +
-  completion_search +
-  completion_get_string +
-  completion_list_add +
-  completion_free
-
-| Informationen
-| info_get +
-  info_get_hashtable
-
-| Infolisten
-| infolist_new +
-  infolist_new_item +
-  infolist_new_var_integer +
-  infolist_new_var_string +
-  infolist_new_var_pointer +
-  infolist_new_var_time +
-  infolist_get +
-  infolist_next +
-  infolist_prev +
-  infolist_reset_item_cursor +
-  infolist_search_var +
-  infolist_fields +
-  infolist_integer +
-  infolist_string +
-  infolist_pointer +
-  infolist_time +
-  infolist_free
-
-| hdata
-| hdata_get +
-  hdata_get_var_offset +
-  hdata_get_var_type_string +
-  hdata_get_var_array_size +
-  hdata_get_var_array_size_string +
-  hdata_get_var_hdata +
-  hdata_get_list +
-  hdata_check_pointer +
-  hdata_move +
-  hdata_search +
-  hdata_char +
-  hdata_integer +
-  hdata_long +
-  hdata_string +
-  hdata_pointer +
-  hdata_time +
-  hdata_hashtable +
-  hdata_compare +
-  hdata_update +
-  hdata_get_string
-
-| Upgrade
-| upgrade_new +
-  upgrade_write_object +
-  upgrade_read +
-  upgrade_close
-|===
 
 [[script_api_constants]]
 === Konstanten
 
 Liste der Konstanten in Skript API:
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_constants.de.adoc[tag=constants]
-|===
-| Kategorie | Konstanten
-
-| return codes
-| `WEECHAT_RC_OK` (integer) +
-  `WEECHAT_RC_OK_EAT` (integer) +
-  `WEECHAT_RC_ERROR` (integer)
-
-| Konfigurationsdatei
-| `WEECHAT_CONFIG_READ_OK` (integer) +
-  `WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
-  `WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
-  `WEECHAT_CONFIG_WRITE_OK` (integer) +
-  `WEECHAT_CONFIG_WRITE_ERROR` (integer) +
-  `WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
-
-| sortierte Listen
-| `WEECHAT_LIST_POS_SORT` (string) +
-  `WEECHAT_LIST_POS_BEGINNING` (string) +
-  `WEECHAT_LIST_POS_END` (string)
-
-| Hotlist
-| `WEECHAT_HOTLIST_LOW` (string) +
-  `WEECHAT_HOTLIST_MESSAGE` (string) +
-  `WEECHAT_HOTLIST_PRIVATE` (string) +
-  `WEECHAT_HOTLIST_HIGHLIGHT` (string)
-
-| hook Prozesse
-| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
-  `WEECHAT_HOOK_PROCESS_ERROR` (integer)
-
-| hook Connect
-| `WEECHAT_HOOK_CONNECT_OK` (integer) +
-  `WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
-  `WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
-  `WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
-  `WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
-  `WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
-
-| hook Signal
-| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
-  `WEECHAT_HOOK_SIGNAL_INT` (string) +
-  `WEECHAT_HOOK_SIGNAL_POINTER` (string)
-|===
 
 [[common_tasks]]
 == Gemeinschaftsaufgabe

doc/de/weechat_user.de.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: de
-:toc-title: Inhaltsverzeichnis
+include::includes/attributes-de.adoc[]
 
 Übersetzer:
 
@@ -35,7 +35,7 @@ wesentliche Merkmale:
   https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
   https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] und
   https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
-* IRC proxy und relay für remote Schnittstellen
+* IRC proxy und relay für WeeChat und Remote-Schnittstellen
 * Betriebssystemunabhängig (GNU/Linux, *BSD, macOS, Windows und weitere)
 * 100% GPL, freie Software
 
@@ -115,7 +115,7 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
 | cmake | ≥ 3.0
 | bauen.
 
-| pkg-config |
+| pkgconf / pkg-config |
 | entdeckt installierte Bibliotheken.
 
 | libncurses-dev |
@@ -133,7 +133,8 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
 
 | zlib1g-dev |
 | Logger-Erweitertung: Kompression von rotierenden Protokolldateien (gzip). +
-  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
+  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^]
+  (api und weechat Protokollen). +
   Script-Erweiterung: Lesen der Repository-Indexdatei (gzip).
 |===
 
@@ -159,9 +160,14 @@ WeeChat optional sind:
 | ca-certificates |
 | Zertifikate für TLS Verbindungen.
 
+| libcjson-dev |
+| Relay-Erweiterung: Protokoll "api" (HTTP REST API).
+
 | libzstd-dev | ≥ 0.8.1
+// TRANLSATION MISSING
 | Logger-Erweiterung: Kompression von rotierenden Protokolldateien (zstandard). +
-  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
+  Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^]
+  (api and weechat protocols).
 
 | libaspell-dev / libenchant-dev |
 | Spell Erweiterung.
@@ -221,8 +227,9 @@ Falls eine Debian/Ubuntu basierte Distribution genutzt wird und man einen
 es mit folgendem Befehl möglich alle notwendigen Abhängigkeiten zu
 installieren:
 
+[source,shell]
 ----
-# apt-get build-dep weechat
+sudo apt-get build-dep weechat
 ----
 
 [[build]]
@@ -230,22 +237,24 @@ installieren:
 
 * Installation in das Systemverzeichnis (benötigt _root_ Privilegien):
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake ..
+cmake ..
-$ make
+make
-$ sudo make install
+sudo make install
 ----
 
 * Installation in ein benutzerdefiniertes Verzeichnis (zum Beispiel ins Heimatverzeichnis):
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
+cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
-$ make
+make
-$ make install
+make install
 ----
 
 Optionen für CMake können mit dem Format, `-DOPTION=VALUE`, genutzt werden.
@@ -279,6 +288,9 @@ Liste der verfügbaren Optionen:
 | ENABLE_CHARSET | `ON`, `OFF` | ON
 | kompiliert <<charset,Charset Erweiterung>>.
 
+| ENABLE_CJSON | `ON`, `OFF` | ON
+| Unterstützung von JSON mittels https://github.com/DaveGamble/cJSON[cJSON ^↗^^] Bibliothek.
+
 | ENABLE_MAN | `ON`, `OFF` | OFF
 | erstellt die man page.
 
@@ -378,14 +390,16 @@ Liste der verfügbaren Optionen:
 
 Weitere Optionen können mit folgendem Befehl angezeigt werden:
 
+[source,shell]
 ----
-$ cmake -LA
+cmake -LA
 ----
 
 oder mittels der Curses-Oberfläche:
 
+[source,shell]
 ----
-$ ccmake ..
+ccmake ..
 ----
 
 [[tests]]
@@ -398,14 +412,16 @@ Folgende Pakete werden *benötigt* um Tests zu kompilieren:
 
 Tests muss aktiviert werden wenn WeeChat kompiliert wird:
 
+[source,shell]
 ----
-$ cmake .. -DENABLE_TESTS=ON
+cmake .. -DENABLE_TESTS=ON
 ----
 
 Nach der Kompilierung wird die Testumgebung im build-Verzeichnis ausgeführt:
 
+[source,shell]
 ----
-$ ctest -V
+ctest -V
 ----
 
 [[git_sources]]
@@ -416,8 +432,9 @@ sich die Quellen nicht kompilieren oder der Code ist nicht stabil. Sie sind hier
 
 Um die Git Quellen zu beziehen nutzen Sie folgende Befehle:
 
+[source,shell]
 ----
-$ git clone https://github.com/weechat/weechat.git
+git clone https://github.com/weechat/weechat.git
 ----
 
 Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_package,Quellpakete>>).
@@ -438,8 +455,9 @@ Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:
 
 Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug
+cmake .. -DCMAKE_BUILD_TYPE=Debug
 ----
 
 [[address_sanitizer]]
@@ -448,8 +466,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
 Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort
 zum Absturz von WeeChat führt:
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
+cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
 ----
 
 [WARNING]
@@ -458,8 +477,9 @@ Absturz zu provozieren. Diese Funktion wird im produktiven Einsatz nicht empfohl
 
 Nach dem Kompilieren und Installieren müssen Sie WeeChat folgendermaßen ausführen:
 
+[source,shell]
 ----
-$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
+ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
 ----
 
 Im Falle eines Absturzes befinden sich zusätzliche Informationen in der Datei, `asan.log`.
@@ -480,12 +500,14 @@ aktivieren, bevor WeeChat gestaret wird, wird der Befehl `ulimit` benötigt.
 Zum Beispiel muss unter Linux in einer _bash_ Shell folgender Befehl in die `~/.bashrc`
 Datei eingetragen werden:
 
+[source,shell]
 ----
 ulimit -c unlimited
 ----
 
 optional kann noch die maximale Dateigröße bestimmt werden:
 
+[source,shell]
 ----
 ulimit -c 200000
 ----
@@ -509,6 +531,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
 Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich
 in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen:
 
+[source,shell]
 ----
 gdb /usr/bin/weechat /home/user/core
 ----
@@ -527,11 +550,11 @@ Copying output to /tmp/crash.txt.
     at /some_path/src/core/weechat.c:351
 #3  <signal handler called>
 #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
-    remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
+    remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
         hook_process = 0x254eb90
         status = <value optimized out>
 #5  0x000000000044cc7d in hook_timer_exec ()
-    at /some_path/src/core/wee-hook.c:1025
+    at /some_path/src/core/core-hook.c:1025
         tv_time = {tv_sec = 1272693881, tv_usec = 212665}
         ptr_hook = 0x2811f40
         next_hook = 0x0
@@ -556,6 +579,7 @@ Um eine laufende Sitzung von WeeChat zu debuggen (zum Beispiel wenn WeeChat nich
 mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten (_12345_ muss durch
 die PID des laufenden weechat Prozesses ersetzt werden):
 
+[source,shell]
 ----
 gdb /usr/bin/weechat 12345
 ----
@@ -571,8 +595,9 @@ Sollte WeeChat abgestürzt sein, muss der Befehl `bt full` genutzt werden:
 
 Um WeeChat zu starten muss folgender Befehl ausgeführt werden:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 Wird WeeChat das erste mal ausgeführt, wird die Standardkonfiguration und
@@ -790,25 +815,24 @@ Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann ent
 die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf
 einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten:
 
+[source,shell]
 ----
-$ weechat --upgrade
+weechat --upgrade
 ----
 
 [[restart_after_upgrade]]
 === Neustart nach Upgrade
 
-[[restart_release_notes]]
+[[restart_upgrading_notes]]
-==== Versionshinweise
+==== Hinweise zum Upgrade
 
-Nach einem Upgrade wird *dringend empfohlen* die,
+Nach einem Upgrade, wird *dringend empfohlen* das Dokukment
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^^]
+https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
-zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob
+zu lesen. Dieses Dokument enthält wichtige Informationen zu wichtigen Änderungen und
-eventuell ein manuelles Eingreifen erforderlich sein könnte.
+einige manuelle Aktionen, die erforderlich sein könnten.
 
-Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen)
+Es sollten die Versionen zwischen der alten (abgelaufenen) und der neuen Version (eingeschlossen) gelesen werden. +
-und Ihrer neuen Version (enthalten) lesen. +
+Wenn beispielsweise von Version 4.0.0 auf 4.3.0 gewechselt wurde, ist es ratsam die Versionen von 4.0.1 bis 4.3.0 zu lesen.
-Wenn Sie beispielsweise von Version 3.0 auf 3.2 wechseln, müssen Sie die Versionshinweise
-der Versionen 3.1 und 3.2 lesen.
 
 [[restart_configuration_upgrade]]
 ==== Konfigurations-Upgrade
@@ -1333,7 +1357,7 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
 | no_filter        | Zeile kann nicht gefiltert werden.
 | no_highlight     | die Zeile kann nicht gehiglighted werden.
 | no_log           | Zeile wird nicht in die Log-Datei geschrieben.
-| log0 … log9      | Grad der Protokollierung (siehe `/help logger`).
+| log0 … log9      | Grad der Protokollierung (siehe den Befehl <<command_logger_logger,/logger>>).
 | notify_none      | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^
 | notify_message   | Diese Zeile ist eine User Nachricht. ^(1)^
 | notify_private   | Diese Zeile ist eine private Nachricht. ^(1)^
@@ -1857,10 +1881,10 @@ wurde (Befehl: `+/mouse toggle+`).
 | kbd:[▼]                 | -            | chat: /list buffer  | gehe fünf Zeilen im /list-Buffer nach unten. | `+/list -down 5+`
 | kbd:[■ □ □]             | -            | chat: /list buffer  | Zeile im /list-Buffer auswählen. | `+/window ${_window_number};/list -go ${_chat_line_y}+`
 | kbd:[□ □ ■]             | -            | chat: /list buffer  | tritt dem IRC-Kanal, in der ausgewählten Zeile, bei. | `+hsignal:irc_list_mouse+`
-| kbd:[▲]                 | -            | chat: script buffer | fünf Zeilen nach oben blättern, im Script-Buffer. | `+/script up 5+`
+| kbd:[▲]                 | -            | chat: script buffer | fünf Zeilen nach oben blättern, im Script-Buffer. | `+/script -up 5+`
-| kbd:[▼]                 | -            | chat: script buffer | fünf Zeilen nach unten blättern, im Script-Buffer. | `+/script down 5+`
+| kbd:[▼]                 | -            | chat: script buffer | fünf Zeilen nach unten blättern, im Script-Buffer. | `+/script -down 5+`
-| kbd:[■ □ □]             | -            | chat: script buffer | wählt einen Eintrag im Script-Buffer aus. | `+/script go ${_chat_line_y}+`
+| kbd:[■ □ □]             | -            | chat: script buffer | wählt einen Eintrag im Script-Buffer aus. | `+/script -go ${_chat_line_y}+`
-| kbd:[□ □ ■]             | -            | chat: script buffer | installiert/entfernt ein Skript. | `+/script go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
+| kbd:[□ □ ■]             | -            | chat: script buffer | installiert/entfernt ein Skript. | `+/script -go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
 | kbd:[■ □ □]             | up / left    | buflist             | verschiebt Buffer in der Reihenfolge nach unten. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]             | down / right | buflist             | verschiebt Buffer in der Reihenfolge nach oben. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]             | -            | buflist             | wechselt zum Buffer (oder zum vorherigen Buffer, falls der aktuell genutzte Buffer angewählt wurde). | Signal `+buflist_mouse+`.
@@ -1978,8 +2002,8 @@ Diese Tasten und Aktionen werden im fset-Buffer verwendet (siehe <<script_manage
 [width="100%",cols="^.^3,^.^2,.^8,.^5",options="header"]
 |===
 | Taste             | Action ^(1)^ | Beschreibung | Befehl
-| kbd:[↑]           |              | eine Zeile nach oben. | `+/script up+`
+| kbd:[↑]           |              | eine Zeile nach oben. | `+/script -up+`
-| kbd:[↓]           |              | eine Zeile nach unten. | `+/script down+`
+| kbd:[↓]           |              | eine Zeile nach unten. | `+/script -down+`
 | kbd:[PgUp]        |              | eine Seite hoch blättern. | `+/window page_up+`
 | kbd:[PgDn]        |              | eine Seite nach unten blättern. | `+/window page_down+`
 | kbd:[Alt+i]       | `i`          | Skript installieren. | `+/script install+`
@@ -2712,27 +2736,37 @@ und löschen (für die Syntax, siehe Befehl <<command_weechat_key,/key>>).
 Der Name eines Ereignisses besteht aus einem Modifier (optional), einer Maustaste/Mausrad
 und der Mausgeste (optional). Die unterschiedlichen Elemente werden durch ein `+-+` getrennt.
 
-Liste der Modifiers:
+Liste der Modifikatoren (in der Reihenfolge des Ereignisnamens):
 
 [width="100%",cols="1m,4",options="header"]
 |===
 | Modifier | Beschreibung
-| ctrl     | Taste kbd:[Ctrl]
 | alt      | Taste kbd:[Alt]
-| ctrl-alt | Taste kbd:[Ctrl] + kbd:[Alt]
+| ctrl     | Taste kbd:[Ctrl]
+| shift    | Taste kbd:[Shift] ^(1)^
 |===
 
+[NOTE]
+^(1)^ Der `shift` Modifikator sollte in WeeChat selten verwendet werden, da es viele Terminals gibt
+die diesen Modifikator nutzen, um Mausereignisse direkt abzufangen.
+
+Verschiedene Modifikatoren können kombiniert werden, zum Beispiel:
+
+* `alt-ctrl`
+* `ctrl-shift`
+* `alt-ctrl-shift`
+
 Liste der Maustasten/Mausrad:
 
 [width="100%",cols="1m,4",options="header"]
 |===
-| Maustaste/-rad      | Beschreibung
+| Maustaste/-rad       | Beschreibung
-| button1             | Linker Mausknopf wird gedrückt
+| button1              | Linker Mausknopf wird gedrückt
-| button2             | Rechter Mausknopf wird gedrückt
+| button2              | Rechter Mausknopf wird gedrückt
-| button3             | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad)
+| button3              | Mittlerer Mausknopf wird gedrückt (häufig der Druck auf das Mausrad)
-| button4 ... button9 | Ein zusätzlicher Mausknopf wird gedrückt
+| button4 ... button11 | Ein zusätzlicher Mausknopf wird gedrückt
-| wheelup             | Mausrad wird nach oben gescrollt
+| wheelup              | Mausrad wird nach oben gescrollt
-| wheeldown           | Mausrad wird nach unten gescrollt
+| wheeldown            | Mausrad wird nach unten gescrollt
 |===
 
 Liste der Mausgesten (nur für Maustasten, nicht für das Mausrad, anwendbar):
@@ -2768,7 +2802,7 @@ Bespiele von Ereignissen:
 * `button1-event-drag`
 * `alt-button2-gesture-down-long`
 * `wheelup`
-* `ctrl-alt-wheeldown`
+* `alt-ctrl-wheeldown`
 
 [TIP]
 Wird eine Funktion im "mouse"-Kontext hinzufügt ist es möglich, mehrere
@@ -2830,8 +2864,9 @@ Option in die Sektion "option" der Aspell-Konfiguration hinzufügt.
 Den Name der Option findet man in der ASpell-Konfigurationsdatei. Eine Auflistung aller
 möglichen Optionen erhält man durch:
 
+[source,shell]
 ----
-$ aspell config
+aspell config
 ----
 
 Um zum Beispiel die Option "ignore-case" einzuschalten:
@@ -3283,7 +3318,7 @@ Passwörter beinhalten. Dies dient dazu Passwörter nicht im Klartext als
 Wert einer Option zu sichern. Dazu wird folgendes Format, anstelle des
 Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man
 dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). +
-Für eine vollständige Liste aller unterstützten Optionen, siehe  `/help secure`.
+Für eine vollständige Liste der unterstützen Optionen, siehe den Befehl <<command_weechat_secure,/secure>>.
 
 Um z.B. das oben eingestellte _libera_ Passwort für eine
 <<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen:
@@ -3406,8 +3441,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
 Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten
 der Kanäle _#weechat_ und _#weechat-fr_ (Standardport (6667) wird genutzt):
 
+[source,shell]
 ----
-$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
+weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 ----
 
 [[irc_servers]]
@@ -3565,9 +3601,10 @@ die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat.
 
 * Importieren Sie die Zertifikate in einer Shell:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
+wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
 ----
 
 [NOTE]
@@ -3588,10 +3625,11 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden.
 
 * Erstellen Sie ein Zertifikat in der Shell:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
+openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----
 
 [NOTE]
@@ -3640,8 +3678,9 @@ dadurch kein Passwort während des Verbindungsaufbaus benötigt).
 
 Ein Schlüssel kann mit folgendem Befehl erzeugt werden:
 
+[source,shell]
 ----
-$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
+openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
 ----
 
 [NOTE]
@@ -3651,8 +3690,9 @@ das auch beispielsweise `~/.weechat` sein kann.
 Um den öffentlichen Schlüssel zu erhalten (base64 enkodiert) muss
 folgender Befehl ausgeführt werden:
 
+[source,shell]
 ----
-$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
+openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
 ----
 
 Nun Verbindung zum Server herstellen, identifizieren (z.B. mittels "nickserv identify")
@@ -3722,8 +3762,9 @@ Privatsphäre und Sicherheit im Internet verbessern können.
 
 Im ersten Schritt muss Tor installiert werden. Für Debian (und Derivate):
 
+[source,shell]
 ----
-$ sudo apt-get install tor
+sudo apt-get install tor
 ----
 
 In WeeChat muss nun ein socks5-Proxy für den Tor Service erstellt werden (Hostname/IP
@@ -4147,7 +4188,7 @@ Schlüssel erfordert, aber nicht `#channel2`:
 /set irc.server.libera.autojoin "#channel1,#channel2 key1"
 ----
 
-Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`.
+Hilfe zum Format findet man unter Option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
 
 [[irc_private_messages]]
 === private Nachrichten
@@ -4196,7 +4237,7 @@ damit die Zeilen im Buffer unterdrückt werden. Zum Beispiel:
 ----
 
 Dabei ist es möglich, einen Filter für nur einen Kanal oder für mehrere Kanäle zu erstellen, die mit
-dem selben Namen beginnen (siehe `/help filter`):
+dem selben Namen beginnen (siehe den Befehl <<command_weechat_filter,/filter>>):
 
 ----
 /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4590,8 +4631,13 @@ Die Relay-Erweiterung wird genutzt um Daten, mittels unterschiedlicher Protokoll
 
 * _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
   IRC Servern zu unterhalten.
-* _weechat_: Protokoll, das von Remote-Schnittstellen zur Anzeige und Interaktion verwendet wird
+* _api_: HTTP REST API, wird von WeeChat und Remote-Schnittstellen zur Anzeige und
-  WeeChat, siehe https://weechat.org/about/interfaces/[this page ^↗^^].
+   Interaktion mit WeeChat verwendet
+* _weechat_: von Remote-Schnittstellen verwendetes Protokoll zur Anzeige und Interaktion mit
+  WeeChat.
+
+Für die _api_ und _weechat_ Protokolle findet man eine Liste der Remote-Schnittstellen auf
+https://weechat.org/about/interfaces/[this page ^↗^^].
 
 [[relay_password]]
 === Passwort
@@ -4603,14 +4649,13 @@ Es wird dringend empfohlen, mit diesen Befehlen ein Passwort für das Relay fest
 /set relay.network.password "${sec.data.relay}"
 ----
 
-Dieses Passwort wird sowohl für das _irc_ als auch für das _weechat_ Protokoll
+Dieses Passwort wird bei allen Protokollen verwendet.
-verwendet.
 
 [[relay_totp]]
 === TOTP
 
-TOTP (Time-based One-Time Passwort) ist eine Zwei-Faktor-Authentifizierung
+TOTP (Time-based One-Time Password) kann als sekundärer Authentifizierungsfaktor
-für das _weechat_ Protokoll, als Ergänzung zum eigentlichen Passwort.
+für die Protokolle _api_ und _weechat_ zusätzlich zum Passwort verwendet werden.
 
 Diese Funktion is optional und erhöht den Sicherheitsgrad.
 
@@ -4648,10 +4693,11 @@ Der Standardpfad zum Zertifikat/Schlüssel wird durch die Option definiert
 Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen
 erstellen:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
 ----
 
 [NOTE]
@@ -4707,6 +4753,38 @@ folgenden Befehlen einrichten:
 /set irc.server.relay.password "${sec.data.relay_libera}"
 ----
 
+[[relay_api_protocol]]
+=== API protocol
+
+Die Relay-Erweiterung kann Daten über ein HTTP REST API-Protokoll an einen Remote-WeeChat oder eine Remote-Schnittstelle senden.
+
+Die API kann online durchstöbert und getestet werden:
+https://weechat.org/api/[WeeChat Relay API ^↗^^].
+
+Sie können sich mit WeeChat oder einer Remote-Schnittstelle verbinden, siehe
+https://weechat.org/about/interfaces/[this page ^↗^^].
+
+Zum Beispiel:
+
+----
+/relay add api 9000
+----
+
+Jetzt kann man sich über Port 9000 mit einem WeeChat oder einer Remote-Schnittstelle
+verbinden, indem das Passwort „mypassword“ verwendet wird.
+
+So stellt man mit WeeChat eine Verbindung zu einem _api_ Relay her:
+
+----
+/remote add weechat http://localhost:9000 -password=mypassword
+/remote connect weechat
+----
+
+[NOTE]
+Der Remote-WeeChat muss dieselbe API-Version wie der lokale WeeChat nutzen.
+Daher wird dringend empfohlen, auf dem Remote- und dem lokalen Client genau
+dieselbe WeeChat-Version zu verwenden.
+
 [[relay_weechat_protocol]]
 === WeeChat Protokoll
 
@@ -4723,10 +4801,10 @@ dieses Protokoll verbinden.
 Zum Beispiel:
 
 ----
-/relay add weechat 9000
+/relay add weechat 9500
 ----
 
-Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort
+Nun kann man über den Port 9500 mittels einer Oberfläche und dem Passwort
 "meinPasswort" eine Verbindung zu WeeChat herstellen.
 
 [[relay_websocket]]
@@ -4743,11 +4821,13 @@ Ein WebSocket kann in HTML5, mit einer JavaScript Zeile, geöffnet werden:
 
 [source,javascript]
 ----
-websocket = new WebSocket("ws://server.com:9000/weechat");
+websocket = new WebSocket("ws://server.com:9500/weechat");
 ----
 
-Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben wurde.
+Der Port (im Beispiel: 9500) ist der Port der in der Relay Erweiterung angegeben wurde.
-Die URI muss immer auf "/weechat" enden (_irc_ und _weechat_ Protokoll).
+
+Die URI muss mit „/weechat“ für die Protokolle _irc_ und _weechat_ und mit „/api“
+für das Protokoll _api_ enden.
 
 [[relay_unix_socket]]
 === UNIX Domain Sockets
@@ -4767,8 +4847,9 @@ andere Ports nicht geöffnet werden können.
 
 OpenSSH nutzen:
 
+[source,shell]
 ----
-$ ssh -L 9000:.weechat/relay_socket user@hostname
+ssh -L 9000:.weechat/relay_socket user@hostname
 ----
 
 Dies leitet lokale relay Client Verbindungen von Port 9000 um, zu
@@ -4792,7 +4873,7 @@ Sektionen in Datei _relay.conf_:
 | network | /set relay.network.*               | Netzwerkoptionen.
 | irc     | /set relay.irc.*                   | für das IRC Protokoll spezifische Optionen (IRC Proxy).
 | port    | <<command_relay_relay,/relay add>> +
-            /set relay.port.*                  | Ports zur Nutzung der Relay-Erweiterung (IRC und weechat Protokolle) (Optionen können in Sektion hinzugefügt/entfernt werden).
+            /set relay.port.*                  | Ports zur Nutzung der Relay-Erweiterung (Optionen können in Sektion hinzugefügt/entfernt werden).
 |===
 
 Optionen:
@@ -4856,34 +4937,39 @@ einige Beispiele:
 
 * Ändert den eigenen Nick auf dem IRC Server libera in "newnick":
 
+[source,shell]
 ----
-$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Schickt eine Nachrich in den IRC #weechat Channel:
 
+[source,shell]
 ----
-$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Sendet eine mehrzeilige Nachricht in den IRC Kanal #test, wenn die Fähigkeit "draft/multiline"
   auf dem Ergo Server aktiviert ist:
 
+[source,shell]
 ----
-$ echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Schickt eine Nachricht in den aktuellen Buffer:
 
+[source,shell]
 ----
-$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
+echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen
   mit "\n" getrennt werden):
 
+[source,shell]
 ----
-$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
+printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 [[fifo_commands]]
@@ -5217,7 +5303,9 @@ Zutreffende Gruppen können in _replace_ verwendet werden:
 
 * `+${re:0}+` nach `+${re:99}+`: `+${re:0}+` ist die ganze Trefferanzahl, `+${re:1}+` nach
   `+${re:99}+` sind als Gruppen erfasst.
-* `+${re:+}+`: das letzte Treffer (mit der höchsten Zahl)
+* `pass:[${re:+}]`: das letzte Treffer (mit der höchsten Zahl)
+* `+${re:#}+`: index of last group captured
+* `+${re:repl_index}+`: index of replacement being done (starts to 1)
 * `+${hide:c,${re:N}}+`: Treffer "N" mit allen Zeichen die durch "c" ersetzt wurden
   (Beispiele: `+${hide:*,${re:2}}+` ist die Gruppe #2, mit allen Zeichen die durch
   `+*+` ersetzt wurden).
@@ -5369,7 +5457,7 @@ und die Daten in einer Hashtable gesichert:
 | server               | string  | Name des Server (Beispiel: "libera").
 | tags                 | string  | Tags in Nachricht (findet selten Verwendung).
 | message_without_tags | string  | Nachricht ohne Tags.
-| nick                 | string  | Nick.
+| nick                 | string  | Nick. ^(1)^
 | host                 | string  | Hostname.
 | command              | string  | IRC Befehl (Beispiel: "PRIVMSG", "NOTICE", ...).
 | channel              | string  | IRC Channel.
@@ -5381,6 +5469,10 @@ und die Daten in einer Hashtable gesichert:
 | pos_text             | string  | Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird).
 |===
 
+[NOTE]
+^(1)^ Der Nick, ist der Absender der Nachricht. +
+Der eigene Nick für den Server ist `${irc_server.nick}`.
+
 Sofern es sich bei den Daten um einen Pointer handelt, kann die Variable `+tg_signal_data+`
 wie im folgenden Beispiel genutzt werden um den Inhalt von hdata zu lesen (im Beispiel
 wird der Pointer eines Buffer verwendet):

doc/docinfo.html

@@ -198,6 +198,10 @@ mark {
 
 /* syntax highlighting tuning */
 
+pre.pygments {
+  color: #ddd !important;
+}
+
 pre.pygments .tok-cp {
   color: #44cfaf;
 }

doc/en/includes/attributes-en.adoc

@@ -0,0 +1,23 @@
+// English translation, for reference only; matches the built-in behavior of core
+:appendix-caption: Appendix
+:appendix-refsig: {appendix-caption}
+:caution-caption: Caution
+:chapter-signifier: Chapter
+:chapter-refsig: {chapter-signifier}
+:example-caption: Example
+:figure-caption: Figure
+:important-caption: Important
+:last-update-label: Last updated
+ifdef::listing-caption[:listing-caption: Listing]
+ifdef::manname-title[:manname-title: Name]
+:note-caption: Note
+:part-signifier: Part
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Preface]
+:section-refsig: Section
+:table-caption: Table
+:tip-caption: Tip
+:toc-title: Table of Contents
+:untitled-label: Untitled
+:version-label: Version
+:warning-caption: Warning

doc/en/includes/cmdline_options.en.adoc

@@ -35,6 +35,9 @@
 *-h*, *--help*::
     Display help.
 
+*-i*, *--build-info*::
+    Display build information and exit.
+
 *-l*, *--license*::
     Display WeeChat license.
 

doc/en/includes/man.en.adoc

@@ -98,7 +98,7 @@ $HOME/.local/share/weechat/weechat.log::
 
 // tag::copyright[]
 WeeChat is written by Sébastien Helleu and contributors (complete list is in
-the AUTHORS.adoc file).
+the AUTHORS.md file).
 
 Copyright (C) 2003-2024 {author}
 

doc/en/includes/relay.en.adoc

@@ -0,0 +1,18 @@
+// tag::diagram[]
+....
+                                              ┌──────────┐ Workstation
+ ┌────────┐                               ┌───┤ client 1 │ (Linux, Windows,
+ │  irc   │◄──┐  ╔═══════════╤═══════╗    │   └──────────┘ BSD, macOS, …)
+ └────────┘   └──╢           │       ║◄───┘   ┌──────────┐
+   ......        ║  WeeChat  │ Relay ║◄───────┤ client 2 │ Mobile device
+ ┌────────┐   ┌──╢           │       ║◄───┐   └──────────┘ (Android, iPhone, …)
+ │ jabber │◄──┘  ╚═══════════╧═══════╝    │      ......
+ └────────┘                               │   ┌──────────┐
+   ......                                 └───┤ client N │ Other devices
+                                              └──────────┘
+
+
+└────────────┘   └───────────────────┘╘══════╛└────────────────────────────────┘
+network servers    ncurses interface    relay         remote interfaces
+....
+// end::diagram[]

doc/en/weechat_dev.en.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 This manual documents WeeChat chat client, it is part of WeeChat.
 
@@ -112,97 +113,97 @@ WeeChat "core" is located in following directories:
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                       | Description
+| Path/file                     | Description
-| core/                           | Core functions: entry point, internal structures.
+| core/                         | Core functions: entry point, internal structures.
-|    wee-arraylist.c              | Array lists.
+|    core-arraylist.c           | Array lists.
-|    wee-backtrace.c              | Display a backtrace after a crash.
+|    core-backtrace.c           | Display a backtrace after a crash.
-|    wee-calc.c                   | Calculate result of expressions.
+|    core-calc.c                | Calculate result of expressions.
-|    wee-command.c                | WeeChat core commands.
+|    core-command.c             | WeeChat core commands.
-|    wee-completion.c             | Default completions.
+|    core-completion.c          | Default completions.
-|    wee-config-file.c            | Configuration file management.
+|    core-config-file.c         | Configuration file management.
-|    wee-config.c                 | Configuration options for WeeChat core (file weechat.conf).
+|    core-config.c              | Configuration options for WeeChat core (file weechat.conf).
-|    wee-crypto.c                 | Cryptographic functions.
+|    core-crypto.c              | Cryptographic functions.
-|    wee-debug.c                  | Some debug functions.
+|    core-debug.c               | Some debug functions.
-|    wee-doc.c                    | Build of files for documentation.
+|    core-doc.c                 | Build of files for documentation.
-|    wee-dir.c                    | Directory/file functions.
+|    core-dir.c                 | Directory/file functions.
-|    wee-eval.c                   | Evaluation of expressions with references to internal vars.
+|    core-eval.c                | Evaluation of expressions with references to internal vars.
-|    wee-hashtable.c              | Hashtables.
+|    core-hashtable.c           | Hashtables.
-|    wee-hdata.c                  | Hdata (direct access to data using hashtables).
+|    core-hdata.c               | Hdata (direct access to data using hashtables).
-|    wee-hook.c                   | Hooks.
+|    core-hook.c                | Hooks.
-|    wee-infolist.c               | Infolists (lists with objects data).
+|    core-infolist.c            | Infolists (lists with objects data).
-|    wee-input.c                  | Input of commands/text.
+|    core-input.c               | Input of commands/text.
-|    wee-list.c                   | Sorted lists.
+|    core-list.c                | Sorted lists.
-|    wee-log.c                    | Write to WeeChat log file (weechat.log).
+|    core-log.c                 | Write to WeeChat log file (weechat.log).
-|    wee-network.c                | Network functions (connection to servers/proxies).
+|    core-network.c             | Network functions (connection to servers/proxies).
-|    wee-proxy.c                  | Proxy management.
+|    core-proxy.c               | Proxy management.
-|    wee-secure.c                 | Secured data functions.
+|    core-secure.c              | Secured data functions.
-|    wee-secure-buffer.c          | Secured data buffer.
+|    core-secure-buffer.c       | Secured data buffer.
-|    wee-secure-config.c          | Secured data options (file sec.conf).
+|    core-secure-config.c       | Secured data options (file sec.conf).
-|    wee-signal.c                 | Signal functions.
+|    core-signal.c              | Signal functions.
-|    wee-string.c                 | Functions on strings.
+|    core-string.c              | Functions on strings.
-|    wee-sys.c                    | System functions.
+|    core-sys.c                 | System functions.
-|    wee-upgrade-file.c           | Internal upgrade system.
+|    core-upgrade-file.c        | Internal upgrade system.
-|    wee-upgrade.c                | Upgrade for WeeChat core (buffers, lines, history, ...).
+|    core-upgrade.c             | Upgrade for WeeChat core (buffers, lines, history, ...).
-|    wee-url.c                    | URL transfer (using libcurl).
+|    core-url.c                 | URL transfer (using libcurl).
-|    wee-utf8.c                   | UTF-8 functions.
+|    core-utf8.c                | UTF-8 functions.
-|    wee-util.c                   | Some other functions.
+|    core-util.c                | Some other functions.
-|    wee-version.c                | Functions for WeeChat version.
+|    core-version.c             | Functions for WeeChat version.
-|    weechat.c                    | Main functions: command line options, startup.
+|    weechat.c                  | Main functions: command line options, startup.
-|    hook/                        | Hook functions.
+|    hook/                      | Hook functions.
-|       wee-hook-command-run.c    | Hook "command_run".
+|       hook-command-run.c      | Hook "command_run".
-|       wee-hook-command.c        | Hook "command".
+|       hook-command.c          | Hook "command".
-|       wee-hook-completion.c     | Hook "completion".
+|       hook-completion.c       | Hook "completion".
-|       wee-hook-config.c         | Hook "config".
+|       hook-config.c           | Hook "config".
-|       wee-hook-connect.c        | Hook "connect".
+|       hook-connect.c          | Hook "connect".
-|       wee-hook-fd.c             | Hook "fd".
+|       hook-fd.c               | Hook "fd".
-|       wee-hook-focus.c          | Hook "focus".
+|       hook-focus.c            | Hook "focus".
-|       wee-hook-hdata.c          | Hook "hdata".
+|       hook-hdata.c            | Hook "hdata".
-|       wee-hook-hsignal.c        | Hook "hsignal".
+|       hook-hsignal.c          | Hook "hsignal".
-|       wee-hook-info-hashtable.c | Hook "info_hashtable".
+|       hook-info-hashtable.c   | Hook "info_hashtable".
-|       wee-hook-info.c           | Hook "info".
+|       hook-info.c             | Hook "info".
-|       wee-hook-infolist.c       | Hook "infolist".
+|       hook-infolist.c         | Hook "infolist".
-|       wee-hook-line.c           | Hook "line".
+|       hook-line.c             | Hook "line".
-|       wee-hook-modifier.c       | Hook "modifier".
+|       hook-modifier.c         | Hook "modifier".
-|       wee-hook-print.c          | Hook "print".
+|       hook-print.c            | Hook "print".
-|       wee-hook-process.c        | Hook "process".
+|       hook-process.c          | Hook "process".
-|       wee-hook-signal.c         | Hook "signal".
+|       hook-signal.c           | Hook "signal".
-|       wee-hook-timer.c          | Hook "timer".
+|       hook-timer.c            | Hook "timer".
-|       wee-hook-url.c            | Hook "url".
+|       hook-url.c              | Hook "url".
-| gui/                            | Functions for buffers, windows, ... (used by all interfaces).
+| gui/                          | Functions for buffers, windows, ... (used by all interfaces).
-|    gui-bar-item.c               | Bar items.
+|    gui-bar-item.c             | Bar items.
-|    gui-bar-window.c             | Bar windows.
+|    gui-bar-window.c           | Bar windows.
-|    gui-bar.c                    | Bars.
+|    gui-bar.c                  | Bars.
-|    gui-buffer.c                 | Buffers.
+|    gui-buffer.c               | Buffers.
-|    gui-chat.c                   | Chat functions (display message, ...).
+|    gui-chat.c                 | Chat functions (display message, ...).
-|    gui-color.c                  | Color functions.
+|    gui-color.c                | Color functions.
-|    gui-completion.c             | Completion on command line.
+|    gui-completion.c           | Completion on command line.
-|    gui-cursor.c                 | Cursor mode (free movement of cursor).
+|    gui-cursor.c               | Cursor mode (free movement of cursor).
-|    gui-filter.c                 | Filters.
+|    gui-filter.c               | Filters.
-|    gui-focus.c                  | Functions about focus (for cursor mode and mouse).
+|    gui-focus.c                | Functions about focus (for cursor mode and mouse).
-|    gui-history.c                | Commands/text saved in buffers.
+|    gui-history.c              | Commands/text saved in buffers.
-|    gui-hotlist.c                | Hotlist management (list of buffers with activity).
+|    gui-hotlist.c              | Hotlist management (list of buffers with activity).
-|    gui-input.c                  | Input functions (input bar).
+|    gui-input.c                | Input functions (input bar).
-|    gui-key.c                    | Keyboard functions.
+|    gui-key.c                  | Keyboard functions.
-|    gui-layout.c                 | Layout.
+|    gui-layout.c               | Layout.
-|    gui-line.c                   | Lines in buffers.
+|    gui-line.c                 | Lines in buffers.
-|    gui-mouse.c                  | Mouse.
+|    gui-mouse.c                | Mouse.
-|    gui-nick.c                   | Nick functions.
+|    gui-nick.c                 | Nick functions.
-|    gui-nicklist.c               | Nicklist in buffers.
+|    gui-nicklist.c             | Nicklist in buffers.
-|    gui-window.c                 | Windows.
+|    gui-window.c               | Windows.
-|    curses/                      | Curses interface.
+|    curses/                    | Curses interface.
-|       gui-curses-bar-window.c   | Display in bar windows.
+|       gui-curses-bar-window.c | Display in bar windows.
-|       gui-curses-chat.c         | Display in chat area (messages).
+|       gui-curses-chat.c       | Display in chat area (messages).
-|       gui-curses-color.c        | Color functions.
+|       gui-curses-color.c      | Color functions.
-|       gui-curses-key.c          | Keyboard functions (default keys, read of input).
+|       gui-curses-key.c        | Keyboard functions (default keys, read of input).
-|       gui-curses-main.c         | WeeChat main loop (waiting for keyboard/network events).
+|       gui-curses-main.c       | WeeChat main loop (waiting for keyboard/network events).
-|       gui-curses-mouse.c        | Mouse.
+|       gui-curses-mouse.c      | Mouse.
-|       gui-curses-term.c         | Functions about terminal.
+|       gui-curses-term.c       | Functions about terminal.
-|       gui-curses-window.c       | Windows.
+|       gui-curses-window.c     | Windows.
-|       headless/                 | Headless mode (no interface).
+|       headless/               | Headless mode (no interface).
-|          main.c                 | Entry point for headless mode.
+|          main.c               | Entry point for headless mode.
-|          ncurses-fake.c         | Fake ncurses library.
+|          ncurses-fake.c       | Fake ncurses library.
-|       normal/                   | Curses interface.
+|       normal/                 | Curses interface.
-|          main.c                 | Entry point for Curses interface.
+|          main.c               | Entry point for Curses interface.
 |===
 
 [[sources_plugins]]
@@ -210,180 +211,189 @@ WeeChat "core" is located in following directories:
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                         | Description
+| Path/file                          | Description
-| plugins/                          | Root of plugins.
+| plugins/                           | Root of plugins.
-|    plugin.c                       | Plugins management (load/unload dynamic C libraries).
+|    plugin.c                        | Plugins management (load/unload dynamic C libraries).
-|    plugin-api.c                   | Extra functions for plugin API (wrapper around WeeChat core functions).
+|    plugin-api.c                    | Extra functions for plugin API (wrapper around WeeChat core functions).
-|    plugin-api-info.c              | Extra info/infolist functions for plugin API.
+|    plugin-api-info.c               | Extra info/infolist functions for plugin API.
-|    plugin-config.c                | Plugin configuration options (file plugins.conf).
+|    plugin-config.c                 | Plugin configuration options (file plugins.conf).
-|    plugin-script.c                | Common functions used by script plugins.
+|    plugin-script.c                 | Common functions used by script plugins.
-|    plugin-script-api.c            | Script API functions: wrappers around some plugin API functions.
+|    plugin-script-api.c             | Script API functions: wrappers around some plugin API functions.
-|    plugin-script-config.c         | Script plugin configuration options (files python.conf, perl.conf, ...).
+|    plugin-script-config.c          | Script plugin configuration options (files python.conf, perl.conf, ...).
-|    weechat-plugin.h               | Header designed to be distributed with WeeChat plugins, in order to compile them.
+|    weechat-plugin.h                | Header designed to be distributed with WeeChat plugins, in order to compile them.
-|    alias/                         | Alias plugin.
+|    alias/                          | Alias plugin.
-|       alias.c                     | Main alias functions.
+|       alias.c                      | Main alias functions.
-|       alias-command.c             | Alias commands.
+|       alias-command.c              | Alias commands.
-|       alias-completion.c          | Alias completions.
+|       alias-completion.c           | Alias completions.
-|       alias-config.c              | Alias config options (file alias.conf).
+|       alias-config.c               | Alias config options (file alias.conf).
-|       alias-info.c                | Alias info/infolists/hdata.
+|       alias-info.c                 | Alias info/infolists/hdata.
-|    spell/                         | Spell checker plugin.
+|    spell/                          | Spell checker plugin.
-|       spell.c                     | Main spell checker functions.
+|       spell.c                      | Main spell checker functions.
-|       spell-bar-item.c            | Spell checker bar items.
+|       spell-bar-item.c             | Spell checker bar items.
-|       spell-command.c             | Spell checker commands.
+|       spell-command.c              | Spell checker commands.
-|       spell-completion.c          | Spell checker completions.
+|       spell-completion.c           | Spell checker completions.
-|       spell-config.c              | Spell checker config options (file spell.conf).
+|       spell-config.c               | Spell checker config options (file spell.conf).
-|       spell-info.c                | Spell checker info/infolists/hdata.
+|       spell-info.c                 | Spell checker info/infolists/hdata.
-|       spell-speller.c             | Spellers management.
+|       spell-speller.c              | Spellers management.
-|    buflist/                       | Buflist plugin.
+|    buflist/                        | Buflist plugin.
-|       buflist.c                   | Main buflist functions.
+|       buflist.c                    | Main buflist functions.
-|       buflist-bar-item.c          | Buflist bar items.
+|       buflist-bar-item.c           | Buflist bar items.
-|       buflist-command.c           | Buflist commands.
+|       buflist-command.c            | Buflist commands.
-|       buflist-completion.c        | Buflist completions.
+|       buflist-completion.c         | Buflist completions.
-|       buflist-config.c            | Buflist config options (file buflist.conf).
+|       buflist-config.c             | Buflist config options (file buflist.conf).
-|       buflist-info.c              | Buflist info/infolists/hdata.
+|       buflist-info.c               | Buflist info/infolists/hdata.
-|       buflist-mouse.c             | Buflist mouse actions.
+|       buflist-mouse.c              | Buflist mouse actions.
-|    charset/                       | Charset plugin.
+|    charset/                        | Charset plugin.
-|       charset.c                   | Charset functions.
+|       charset.c                    | Charset functions.
-|    exec/                          | Exec plugin.
+|    exec/                           | Exec plugin.
-|       exec.c                      | Main exec functions.
+|       exec.c                       | Main exec functions.
-|       exec-buffer.c               | Exec buffer.
+|       exec-buffer.c                | Exec buffer.
-|       exec-command.c              | Exec commands.
+|       exec-command.c               | Exec commands.
-|       exec-completion.c           | Exec completions.
+|       exec-completion.c            | Exec completions.
-|       exec-config.c               | Exec config options (file exec.conf).
+|       exec-config.c                | Exec config options (file exec.conf).
-|    fifo/                          | Fifo plugin.
+|    fifo/                           | Fifo plugin.
-|       fifo.c                      | Main fifo functions.
+|       fifo.c                       | Main fifo functions.
-|       fifo-command.c              | Fifo commands.
+|       fifo-command.c               | Fifo commands.
-|       fifo-config.c               | Fifo config options (file fifo.conf).
+|       fifo-config.c                | Fifo config options (file fifo.conf).
-|       fifo-info.c                 | Fifo info/infolists/hdata.
+|       fifo-info.c                  | Fifo info/infolists/hdata.
-|    fset/                          | Fset plugin.
+|    fset/                           | Fset plugin.
-|       fset.c                      | Main fset functions.
+|       fset.c                       | Main fset functions.
-|       fset-bar-item.c             | Fset bar items.
+|       fset-bar-item.c              | Fset bar items.
-|       fset-buffer.c               | Fset buffer.
+|       fset-buffer.c                | Fset buffer.
-|       fset-command.c              | Fset commands.
+|       fset-command.c               | Fset commands.
-|       fset-completion.c           | Fset completions.
+|       fset-completion.c            | Fset completions.
-|       fset-config.c               | Fset config options (file fset.conf).
+|       fset-config.c                | Fset config options (file fset.conf).
-|       fset-info.c                 | Fset info/infolists/hdata.
+|       fset-info.c                  | Fset info/infolists/hdata.
-|       fset-mouse.c                | Fset mouse actions.
+|       fset-mouse.c                 | Fset mouse actions.
-|       fset-option.c               | Fset options management.
+|       fset-option.c                | Fset options management.
-|    guile/                         | Guile (scheme) plugin.
+|    guile/                          | Guile (scheme) plugin.
-|       weechat-guile.c             | Main guile functions (load/unload scripts, execute guile code).
+|       weechat-guile.c              | Main guile functions (load/unload scripts, execute guile code).
-|       weechat-guile-api.c         | Guile scripting API functions.
+|       weechat-guile-api.c          | Guile scripting API functions.
-|    irc/                           | IRC (Internet Relay Chat) plugin.
+|    irc/                            | IRC (Internet Relay Chat) plugin.
-|       irc.c                       | Main IRC functions.
+|       irc.c                        | Main IRC functions.
-|       irc-bar-item.c              | IRC bar items.
+|       irc-bar-item.c               | IRC bar items.
-|       irc-batch.c                 | IRC batched events.
+|       irc-batch.c                  | IRC batched events.
-|       irc-buffer.c                | IRC buffers.
+|       irc-buffer.c                 | IRC buffers.
-|       irc-channel.c               | IRC channels.
+|       irc-channel.c                | IRC channels.
-|       irc-color.c                 | IRC colors.
+|       irc-color.c                  | IRC colors.
-|       irc-command.c               | IRC commands.
+|       irc-command.c                | IRC commands.
-|       irc-completion.c            | IRC completions.
+|       irc-completion.c             | IRC completions.
-|       irc-config.c                | IRC config options (file irc.conf).
+|       irc-config.c                 | IRC config options (file irc.conf).
-|       irc-ctcp.c                  | IRC CTCP.
+|       irc-ctcp.c                   | IRC CTCP.
-|       irc-debug.c                 | IRC debug functions.
+|       irc-debug.c                  | IRC debug functions.
-|       irc-ignore.c                | IRC Ignore.
+|       irc-ignore.c                 | IRC Ignore.
-|       irc-info.c                  | IRC info/infolists/hdata.
+|       irc-info.c                   | IRC info/infolists/hdata.
-|       irc-input.c                 | Input of commands/text.
+|       irc-input.c                  | Input of commands/text.
-|       irc-join.c                  | Functions for list of channels to join.
+|       irc-join.c                   | Functions for list of channels to join.
-|       irc-list.c                  | Buffer for reply to /list command.
+|       irc-list.c                   | Buffer for reply to /list command.
-|       irc-message.c               | Functions to manipulate IRC messages.
+|       irc-message.c                | Functions to manipulate IRC messages.
-|       irc-mode.c                  | Functions about channel/nick modes.
+|       irc-mode.c                   | Functions about channel/nick modes.
-|       irc-modelist.c              | IRC channel mode lists (+b, +e, +I, ...).
+|       irc-modelist.c               | IRC channel mode lists (+b, +e, +I, ...).
-|       irc-msgbuffer.c             | Target buffer for IRC messages.
+|       irc-msgbuffer.c              | Target buffer for IRC messages.
-|       irc-nick.c                  | IRC nicks.
+|       irc-nick.c                   | IRC nicks.
-|       irc-notify.c                | IRC notify lists.
+|       irc-notify.c                 | IRC notify lists.
-|       irc-protocol.c              | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194).
+|       irc-protocol.c               | IRC protocol (RFCs 1459/2810/2811/2812/2813/7194).
-|       irc-raw.c                   | IRC raw buffer.
+|       irc-raw.c                    | IRC raw buffer.
-|       irc-redirect.c              | Redirection of IRC command output.
+|       irc-redirect.c               | Redirection of IRC command output.
-|       irc-sasl.c                  | SASL authentication with IRC server.
+|       irc-sasl.c                   | SASL authentication with IRC server.
-|       irc-server.c                | I/O communication with IRC server.
+|       irc-server.c                 | I/O communication with IRC server.
-|       irc-tag.c                   | Functions to manipulate IRC message tags.
+|       irc-tag.c                    | Functions to manipulate IRC message tags.
-|       irc-typing.c                | Typing status.
+|       irc-typing.c                 | Typing status.
-|       irc-upgrade.c               | Save/restore of IRC data when upgrading WeeChat.
+|       irc-upgrade.c                | Save/restore of IRC data when upgrading WeeChat.
-|    javascript/                    | JavaScript plugin.
+|    javascript/                     | JavaScript plugin.
-|       weechat-js.cpp              | Main JavaScript functions (load/unload scripts, execute JavaScript code).
+|       weechat-js.cpp               | Main JavaScript functions (load/unload scripts, execute JavaScript code).
-|       weechat-js-api.cpp          | JavaScript scripting API functions.
+|       weechat-js-api.cpp           | JavaScript scripting API functions.
-|       weechat-js-v8.cpp           | JavaScript v8 functions.
+|       weechat-js-v8.cpp            | JavaScript v8 functions.
-|    logger/                        | Logger plugin.
+|    logger/                         | Logger plugin.
-|       logger.c                    | Main logger functions.
+|       logger.c                     | Main logger functions.
-|       logger-backlog.c            | Logger backlog functions.
+|       logger-backlog.c             | Logger backlog functions.
-|       logger-buffer.c             | Logger buffer list management.
+|       logger-buffer.c              | Logger buffer list management.
-|       logger-command.c            | Logger commands.
+|       logger-command.c             | Logger commands.
-|       logger-config.c             | Logger config options (file logger.conf).
+|       logger-config.c              | Logger config options (file logger.conf).
-|       logger-info.c               | Logger info/infolists/hdata.
+|       logger-info.c                | Logger info/infolists/hdata.
-|       logger-tail.c               | Functions to get last lines of a file.
+|       logger-tail.c                | Functions to get last lines of a file.
-|    lua/                           | Lua plugin.
+|    lua/                            | Lua plugin.
-|       weechat-lua.c               | Main lua functions (load/unload scripts, execute lua code).
+|       weechat-lua.c                | Main lua functions (load/unload scripts, execute lua code).
-|       weechat-lua-api.c           | Lua scripting API functions.
+|       weechat-lua-api.c            | Lua scripting API functions.
-|    perl/                          | Perl plugin.
+|    perl/                           | Perl plugin.
-|       weechat-perl.c              | Main perl functions (load/unload scripts, execute perl code).
+|       weechat-perl.c               | Main perl functions (load/unload scripts, execute perl code).
-|       weechat-perl-api.c          | Perl scripting API functions.
+|       weechat-perl-api.c           | Perl scripting API functions.
-|    php/                           | PHP plugin.
+|    php/                            | PHP plugin.
-|       weechat-php.c               | Main PHP functions (load/unload scripts, execute PHP code).
+|       weechat-php.c                | Main PHP functions (load/unload scripts, execute PHP code).
-|       weechat-php-api.c           | PHP scripting API functions.
+|       weechat-php-api.c            | PHP scripting API functions.
-|    python/                        | Python plugin.
+|    python/                         | Python plugin.
-|       weechat-python.c            | Main python functions (load/unload scripts, execute python code).
+|       weechat-python.c             | Main python functions (load/unload scripts, execute python code).
-|       weechat-python-api.c        | Python scripting API functions.
+|       weechat-python-api.c         | Python scripting API functions.
-|    relay/                         | Relay plugin (IRC proxy and relay for remote interfaces).
+|    relay/                          | Relay plugin (IRC proxy and relay for remote interfaces).
-|       relay.c                     | Main relay functions.
+|       relay.c                      | Main relay functions.
-|       relay-auth.c                | Clients authentication.
+|       relay-auth.c                 | Clients authentication.
-|       relay-buffer.c              | Relay buffer.
+|       relay-buffer.c               | Relay buffer.
-|       relay-client.c              | Clients of relay.
+|       relay-client.c               | Clients of relay.
-|       relay-command.c             | Relay commands.
+|       relay-command.c              | Relay commands.
-|       relay-completion.c          | Relay completions.
+|       relay-completion.c           | Relay completions.
-|       relay-config.c              | Relay config options (file relay.conf).
+|       relay-config.c               | Relay config options (file relay.conf).
-|       relay-info.c                | Relay info/infolists/hdata.
+|       relay-http.c                 | HTTP functions.
-|       relay-network.c             | Network functions for relay.
+|       relay-info.c                 | Relay info/infolists/hdata.
-|       relay-raw.c                 | Relay raw buffer.
+|       relay-network.c              | Network functions for relay.
-|       relay-server.c              | Relay server.
+|       relay-raw.c                  | Relay raw buffer.
-|       relay-upgrade.c             | Save/restore of relay data when upgrading WeeChat.
+|       relay-remote.c               | Relay remote.
-|       relay-websocket.c           | WebSocket server functions (RFC 6455).
+|       relay-server.c               | Relay server.
-|       irc/                        | IRC proxy.
+|       relay-upgrade.c              | Save/restore of relay data when upgrading WeeChat.
-|          relay-irc.c              | Main IRC proxy functions.
+|       relay-websocket.c            | WebSocket server functions (RFC 6455).
-|       weechat/                    | Relay for remote interfaces.
+|       api/                         | Relay for remote interfaces (using HTTP REST API).
-|          relay-weechat.c          | Relay for remote interfaces (main functions).
+|          relay-api.c               | Main API functions for HTTP REST API.
-|          relay-weechat-msg.c      | Send binary messages to clients.
+|          relay-api-msg.c           | Send JSON messages to clients.
-|          relay-weechat-nicklist.c | Nicklist functions.
+|          relay-api-protocol.c      | HTTP REST API protocol.
-|          relay-weechat-protocol.c | Read commands from clients.
+|          remote/                   | Relay remote functions, specific to API.
-|    ruby/                          | Ruby plugin.
+|             relay-remote-event.c   | Process events received from relay remote.
-|       weechat-ruby.c              | Main ruby functions (load/unload scripts, execute ruby code).
+|             relay-remote-network.c | Network functions for relay remote.
-|       weechat-ruby-api.c          | Ruby scripting API functions.
+|       irc/                         | IRC proxy.
-|    script/                        | Script manager.
+|          relay-irc.c               | Main IRC proxy functions.
-|       script.c                    | Main functions for script manager.
+|       weechat/                     | Relay for remote interfaces (using "weechat" binary protocol).
-|       script-action.c             | Actions on scripts (load/unload, install/remove, ...).
+|          relay-weechat.c           | Relay for remote interfaces (main functions).
-|       script-buffer.c             | Buffer for script manager.
+|          relay-weechat-msg.c       | Send binary messages to clients.
-|       script-command.c            | Commands for script manager.
+|          relay-weechat-nicklist.c  | Nicklist functions.
-|       script-completion.c         | Completions for script manager.
+|          relay-weechat-protocol.c  | Read commands from clients.
-|       script-config.c             | Config options for script manager (file script.conf).
+|    ruby/                           | Ruby plugin.
-|       script-info.c               | Script manager info/infolists/hdata.
+|       weechat-ruby.c               | Main ruby functions (load/unload scripts, execute ruby code).
-|       script-mouse.c              | Script mouse actions.
+|       weechat-ruby-api.c           | Ruby scripting API functions.
-|       script-repo.c               | Download and read repository file.
+|    script/                         | Script manager.
-|    tcl/                           | Tcl plugin.
+|       script.c                     | Main functions for script manager.
-|       weechat-tcl.c               | Main tcl functions (load/unload scripts, execute tcl code).
+|       script-action.c              | Actions on scripts (load/unload, install/remove, ...).
-|       weechat-tcl-api.c           | Tcl scripting API functions.
+|       script-buffer.c              | Buffer for script manager.
-|    trigger/                       | Trigger plugin.
+|       script-command.c             | Commands for script manager.
-|       trigger.c                   | Main trigger functions.
+|       script-completion.c          | Completions for script manager.
-|       trigger-buffer.c            | Trigger buffer.
+|       script-config.c              | Config options for script manager (file script.conf).
-|       trigger-callback.c          | Trigger callbacks.
+|       script-info.c                | Script manager info/infolists/hdata.
-|       trigger-command.c           | Trigger commands.
+|       script-mouse.c               | Script mouse actions.
-|       trigger-completion.c        | Trigger completions.
+|       script-repo.c                | Download and read repository file.
-|       trigger-config.c            | Trigger config options (file trigger.conf).
+|    tcl/                            | Tcl plugin.
-|    typing/                        | Typing plugin.
+|       weechat-tcl.c                | Main tcl functions (load/unload scripts, execute tcl code).
-|       typing.c                    | Main typing functions.
+|       weechat-tcl-api.c            | Tcl scripting API functions.
-|       typing-bar-item.c           | Typing bar items.
+|    trigger/                        | Trigger plugin.
-|       typing-config.c             | Typing config options (file typing.conf).
+|       trigger.c                    | Main trigger functions.
-|       typing-status.c             | Messages typing status on buffers.
+|       trigger-buffer.c             | Trigger buffer.
-|    xfer/                          | Xfer plugin (IRC DCC file/chat).
+|       trigger-callback.c           | Trigger callbacks.
-|       xfer.c                      | Main xfer functions.
+|       trigger-command.c            | Trigger commands.
-|       xfer-buffer.c               | Xfer buffer.
+|       trigger-completion.c         | Trigger completions.
-|       xfer-chat.c                 | DCC chat.
+|       trigger-config.c             | Trigger config options (file trigger.conf).
-|       xfer-command.c              | Xfer commands.
+|    typing/                         | Typing plugin.
-|       xfer-completion.c           | Xfer completions.
+|       typing.c                     | Main typing functions.
-|       xfer-config.c               | Xfer config options (file xfer.conf).
+|       typing-bar-item.c            | Typing bar items.
-|       xfer-dcc.c                  | DCC file transfer.
+|       typing-config.c              | Typing config options (file typing.conf).
-|       xfer-file.c                 | File functions for xfer.
+|       typing-status.c              | Messages typing status on buffers.
-|       xfer-info.c                 | Xfer info/infolists/hdata.
+|    xfer/                           | Xfer plugin (IRC DCC file/chat).
-|       xfer-network.c              | Network functions for xfer.
+|       xfer.c                       | Main xfer functions.
-|       xfer-upgrade.c              | Save/restore of xfer data when upgrading WeeChat.
+|       xfer-buffer.c                | Xfer buffer.
+|       xfer-chat.c                  | DCC chat.
+|       xfer-command.c               | Xfer commands.
+|       xfer-completion.c            | Xfer completions.
+|       xfer-config.c                | Xfer config options (file xfer.conf).
+|       xfer-dcc.c                   | DCC file transfer.
+|       xfer-file.c                  | File functions for xfer.
+|       xfer-info.c                  | Xfer info/infolists/hdata.
+|       xfer-network.c               | Network functions for xfer.
+|       xfer-upgrade.c               | Save/restore of xfer data when upgrading WeeChat.
 |===
 
 [[sources_tests]]
@@ -391,89 +401,120 @@ WeeChat "core" is located in following directories:
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Path/file                           | Description
+| Path/file                                  | Description
-| tests/                              | Root of tests.
+| tests/                                     | Root of tests.
-|    tests.cpp                        | Program used to run all tests.
+|    tests.cpp                               | Program used to run all tests.
-|    tests-record.cpp                 | Record and search in messages displayed.
+|    tests-record.cpp                        | Record and search in messages displayed.
-|    scripts/                         | Root of scripting API tests.
+|    scripts/                                | Root of scripting API tests.
-|       test-scripts.cpp              | Program used to run the scripting API tests.
+|       test-scripts.cpp                     | Program used to run the scripting API tests.
-|       python/                       | Python scripts to generate and run the scripting API tests.
+|       python/                              | Python scripts to generate and run the scripting API tests.
-|          testapigen.py              | Python script generating scripts in all languages to test the scripting API.
+|          testapigen.py                     | Python script generating scripts in all languages to test the scripting API.
-|          testapi.py                 | Python script with scripting API tests, used by script testapigen.py.
+|          testapi.py                        | Python script with scripting API tests, used by script testapigen.py.
-|          unparse.py                 | Convert Python code to other languages, used by script testapigen.py.
+|          unparse.py                        | Convert Python code to other languages, used by script testapigen.py.
-|    unit/                            | Root of unit tests.
+|    unit/                                   | Root of unit tests.
-|       test-plugins.cpp              | Tests: plugins.
+|       test-plugins.cpp                     | Tests: plugins.
-|       test-plugin-api-info.cpp      | Tests: plugin API info functions.
+|       test-plugin-api-info.cpp             | Tests: plugin API info functions.
-|       test-plugin-config.cpp        | Tests: plugin config functions.
+|       test-plugin-config.cpp               | Tests: plugin config functions.
-|       core/                         | Root of unit tests for core.
+|       core/                                | Root of unit tests for core.
-|          test-core-arraylist.cpp    | Tests: arraylists.
+|          test-core-arraylist.cpp           | Tests: arraylists.
-|          test-core-calc.cpp         | Tests: calculation of expressions.
+|          test-core-calc.cpp                | Tests: calculation of expressions.
-|          test-core-command.cpp      | Tests: commands.
+|          test-core-command.cpp             | Tests: commands.
-|          test-core-config-file.cpp  | Tests: configuration files.
+|          test-core-config-file.cpp         | Tests: configuration files.
-|          test-core-crypto.cpp       | Tests: cryptographic functions.
+|          test-core-crypto.cpp              | Tests: cryptographic functions.
-|          test-core-dir.cpp          | Tests: directory/file functions.
+|          test-core-dir.cpp                 | Tests: directory/file functions.
-|          test-core-eval.cpp         | Tests: evaluation of expressions.
+|          test-core-eval.cpp                | Tests: evaluation of expressions.
-|          test-core-hashtble.cpp     | Tests: hashtables.
+|          test-core-hashtble.cpp            | Tests: hashtables.
-|          test-core-hdata.cpp        | Tests: hdata.
+|          test-core-hdata.cpp               | Tests: hdata.
-|          test-core-hook.cpp         | Tests: hooks.
+|          test-core-hook.cpp                | Tests: hooks.
-|          test-core-infolist.cpp     | Tests: infolists.
+|          test-core-infolist.cpp            | Tests: infolists.
-|          test-core-list.cpp         | Tests: lists.
+|          test-core-list.cpp                | Tests: lists.
-|          test-core-network.cpp      | Tests: network functions.
+|          test-core-network.cpp             | Tests: network functions.
-|          test-core-secure.cpp       | Tests: secured data.
+|          test-core-secure.cpp              | Tests: secured data.
-|          test-core-signal.cpp       | Tests: signals.
+|          test-core-signal.cpp              | Tests: signals.
-|          test-core-string.cpp       | Tests: strings.
+|          test-core-string.cpp              | Tests: strings.
-|          test-core-url.cpp          | Tests: URLs.
+|          test-core-url.cpp                 | Tests: URLs.
-|          test-core-utf8.cpp         | Tests: UTF-8.
+|          test-core-utf8.cpp                | Tests: UTF-8.
-|          test-core-util.cpp         | Tests: utility functions.
+|          test-core-util.cpp                | Tests: utility functions.
-|          test-core-sys.cpp          | Tests: system functions.
+|          test-core-sys.cpp                 | Tests: system functions.
-|          hook/                      | Root of unit tests for hooks.
+|          hook/                             | Root of unit tests for hooks.
-|             test-hook-command.cpp   | Tests: hooks "command".
+|             test-hook-command.cpp          | Tests: hooks "command".
-|       gui/                          | Root of unit tests for interfaces.
+|             test-hook-command-run.cpp      | Tests: hooks "command_run".
-|          test-gui-bar-window.cpp    | Tests: bar window functions.
+|             test-hook-completion.cpp       | Tests: hooks "completion".
-|          test-gui-buffer.cpp        | Tests: buffer functions.
+|             test-hook-config.cpp           | Tests: hooks "config".
-|          test-gui-chat.cpp          | Tests: chat functions.
+|             test-hook-connect.cpp          | Tests: hooks "connect".
-|          test-gui-color.cpp         | Tests: colors.
+|             test-hook-fd.cpp               | Tests: hooks "fd".
-|          test-gui-filter.cpp        | Tests: filters.
+|             test-hook-focus.cpp            | Tests: hooks "focus".
-|          test-gui-input.cpp         | Tests: input functions.
+|             test-hook-hdata.cpp            | Tests: hooks "hdata".
-|          test-gui-key.cpp           | Tests: keys.
+|             test-hook-hsignal.cpp          | Tests: hooks "hsignal".
-|          test-gui-line.cpp          | Tests: lines.
+|             test-hook-info-hashtable.cpp   | Tests: hooks "info_hashtable".
-|          test-gui-nick.cpp          | Tests: nicks.
+|             test-hook-info.cpp             | Tests: hooks "info".
-|       plugins/                      | Root of unit tests for plugins.
+|             test-hook-infolist.cpp         | Tests: hooks "infolist".
-|          irc/                       | Root of unit tests for IRC plugin.
+|             test-hook-line.cpp             | Tests: hooks "line".
-|             test-irc-batch.cpp      | Tests: IRC batched events.
+|             test-hook-modifier.cpp         | Tests: hooks "modifier".
-|             test-irc-buffer.cpp     | Tests: IRC buffers.
+|             test-hook-print.cpp            | Tests: hooks "print".
-|             test-irc-channel.cpp    | Tests: IRC channels.
+|             test-hook-process.cpp          | Tests: hooks "process".
-|             test-irc-color.cpp      | Tests: IRC colors.
+|             test-hook-signal.cpp           | Tests: hooks "signal".
-|             test-irc-config.cpp     | Tests: IRC configuration.
+|             test-hook-timer.cpp            | Tests: hooks "timer".
-|             test-irc-ctcp.cpp       | Tests: IRC CTCP.
+|             test-hook-url.cpp              | Tests: hooks "url".
-|             test-irc-ignore.cpp     | Tests: IRC ignores.
+|       gui/                                 | Root of unit tests for interfaces.
-|             test-irc-info.cpp       | Tests: IRC info.
+|          test-gui-bar-window.cpp           | Tests: bar window functions.
-|             test-irc-join.cpp       | Tests: IRC join functions.
+|          test-gui-buffer.cpp               | Tests: buffer functions.
-|             test-irc-list.cpp       | Tests: IRC buffer for reply to /list command.
+|          test-gui-chat.cpp                 | Tests: chat functions.
-|             test-irc-message.cpp    | Tests: IRC messages.
+|          test-gui-color.cpp                | Tests: colors.
-|             test-irc-mode.cpp       | Tests: IRC modes.
+|          test-gui-filter.cpp               | Tests: filters.
-|             test-irc-nick.cpp       | Tests: IRC nicks.
+|          test-gui-hotlist.cpp              | Tests: hotlist functions.
-|             test-irc-protocol.cpp   | Tests: IRC protocol.
+|          test-gui-input.cpp                | Tests: input functions.
-|             test-irc-sasl.cpp       | Tests: SASL authentication with IRC protocol.
+|          test-gui-key.cpp                  | Tests: keys.
-|             test-irc-server.cpp     | Tests: IRC server.
+|          test-gui-line.cpp                 | Tests: lines.
-|             test-irc-tag.cpp        | Tests: IRC message tags.
+|          test-gui-nick.cpp                 | Tests: nicks.
-|          logger/                    | Root of unit tests for logger plugin.
+|          test-gui-nicklist.cpp             | Tests: nicklist functions.
-|             test-logger.cpp         | Tests: logger.
+|          curses/                           | Root of unit tests for Curses interface.
-|             test-logger-backlog.cpp | Tests: logger backlog.
+|             test-gui-curses-mouse.cpp      | Tests: mouse (Curses interface).
-|             test-logger-tail.cpp    | Tests: logger tail functions.
+|       plugins/                             | Root of unit tests for plugins.
-|          trigger/                   | Root of unit tests for trigger plugin.
+|          irc/                              | Root of unit tests for IRC plugin.
-|             test-trigger.cpp        | Tests: triggers.
+|             test-irc-batch.cpp             | Tests: IRC batched events.
-|             test-trigger-config.cpp | Tests: trigger configuration.
+|             test-irc-buffer.cpp            | Tests: IRC buffers.
-|          typing/                    | Root of unit tests for typing plugin.
+|             test-irc-channel.cpp           | Tests: IRC channels.
-|             test-typing.cpp         | Tests: typing.
+|             test-irc-color.cpp             | Tests: IRC colors.
-|             test-typing-status.cpp  | Tests: typing status.
+|             test-irc-command.cpp           | Tests: IRC commands.
-|          relay/                     | Root of unit tests for Relay plugin.
+|             test-irc-config.cpp            | Tests: IRC configuration.
-|             test-relay-auth.cpp     | Tests: clients authentication.
+|             test-irc-ctcp.cpp              | Tests: IRC CTCP.
-|             irc/                    | Root of unit tests for Relay "irc" protocol.
+|             test-irc-ignore.cpp            | Tests: IRC ignores.
-|                test-relay-irc.cpp   | Tests: Relay "irc" protocol.
+|             test-irc-info.cpp              | Tests: IRC info.
-|          xfer/                      | Root of unit tests for Xfer plugin.
+|             test-irc-join.cpp              | Tests: IRC join functions.
-|             test-xfer-file.cpp      | Tests: file functions.
+|             test-irc-list.cpp              | Tests: IRC buffer for reply to /list command.
-|             test-xfer-network.cpp   | Tests: network 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.cpp                | Tests: logger.
+|             test-logger-backlog.cpp        | Tests: logger backlog.
+|             test-logger-tail.cpp           | Tests: logger tail functions.
+|          trigger/                          | Root of unit tests for trigger plugin.
+|             test-trigger.cpp               | Tests: triggers.
+|             test-trigger-config.cpp        | Tests: trigger configuration.
+|          typing/                           | Root of unit tests for typing plugin.
+|             test-typing.cpp                | Tests: typing.
+|             test-typing-status.cpp         | Tests: typing status.
+|          relay/                            | Root of unit tests for Relay plugin.
+|             test-relay-auth.cpp            | Tests: clients authentication.
+|             test-relay-http.cpp            | Tests: HTTP functions for Relay plugin.
+|             test-relay-raw.cpp             | Tests: raw messages functions for Relay plugin.
+|             test-relay-remote.cpp          | Tests: remote functions for Relay plugin.
+|             test-relay-websocket.cpp       | Tests: websocket functions for Relay plugin.
+|             api/                           | Root of unit tests for Relay "api" protocol.
+|                test-relay-api.cpp          | Tests: Relay "api" protocol: general functions.
+|                test-relay-api-msg.cpp      | Tests: Relay "api" protocol: messages.
+|                test-relay-api-protocol.cpp | Tests: Relay "api" protocol: protocol.
+|             irc/                           | Root of unit tests for Relay "irc" protocol.
+|                test-relay-irc.cpp          | Tests: Relay "irc" protocol.
+|          xfer/                             | Root of unit tests for Xfer plugin.
+|             test-xfer-file.cpp             | Tests: file functions.
+|             test-xfer-network.cpp          | Tests: network functions.
 |===
 
 [[documentation_translations]]
@@ -492,7 +533,8 @@ Documentation files:
 |       weechat_faq.XX.adoc                     | link:weechat_faq.en.html[FAQ ^↗^^].
 |       weechat_plugin_api.XX.adoc              | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^].
 |       weechat_quickstart.XX.adoc              | link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
-|       weechat_relay_protocol.XX.adoc          | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces).
+|       weechat_relay_api.XX.adoc               | link:weechat_relay_api.en.html[Relay "api" protocol ^↗^^] (for remote interfaces).
+|       weechat_relay_weechat.XX.adoc           | link:weechat_relay_weechat.en.html[Relay "weechat" protocol ^↗^^] (for remote interfaces).
 |       weechat_scripting.XX.adoc               | link:weechat_scripting.en.html[Scripting guide ^↗^^].
 |       weechat_user.XX.adoc                    | link:weechat_user.en.html[User's guide ^↗^^].
 |       includes/                               | Files included in documentation.
@@ -557,9 +599,8 @@ Example in C:
 
 Some basic rules you *must* follow when you write C code:
 
-* Use 4 spaces for indentation. Don't use tabs, they are evil.
+* Use 4 spaces for indentation (no tabs).
-* Try to not exceed 80 chars by line, except if this is needed to increase
+* Try to not exceed 80 chars by line, except if this is needed to increase readability.
-  readability.
 * Use comments `+/* comment */+` (not C99-style comments like `+// comment+`).
 * Add a comment before any function, to explain what it does (always use a
   multi-line comment, even if description is very short).
@@ -771,7 +812,7 @@ Examples:
 [width="100%",cols="2m,3",options="header"]
 |===
 | Directory           | Files
-| src/core/           | weechat.c, wee-backtrace.c, wee-command.c, ...
+| src/core/           | weechat.c, core-backtrace.c, core-command.c, ...
 | src/gui/            | gui-bar.c, gui-bar-item.c, gui-bar-window.c, ...
 | src/gui/curses/     | gui-curses-bar.c, gui-curses-bar-window.c, gui-curses-chat.c, ...
 | src/plugins/        | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ...
@@ -779,8 +820,8 @@ Examples:
 | src/plugins/python/ | weechat-python.c, weechat-python-api.c, ...
 |===
 
-The headers of C files have same name as file, for example _wee-command.h_ for
+The headers of C files have same name as file, for example _core-command.h_ for
-file _wee-command.c_.
+file _core-command.c_.
 
 [[naming_convention_structures]]
 ==== Structures
@@ -1132,7 +1173,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
 
 Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].
 
-Any patch for bug or new feature must be done on master branch, preferred way
+Any patch for bug or new feature must be done on branch `main`, preferred way
 is a GitHub pull request. A patch can also be sent by e-mail
 (made with `git diff` or `git format-patch`).
 
@@ -1149,15 +1190,15 @@ Where _component_ is one of following:
 | Component | Files | Description
 
 | core
-| AUTHORS.adoc +
+| AUTHORS.md +
-  ChangeLog.adoc +
+  CHANGELOG.md +
-  Contributing.adoc +
+  CONTRIBUTING.md +
   .github/FUNDING.yml +
   .github/ISSUE_TEMPLATE/* +
   icons/* +
   po/* +
-  README.adoc +
+  README.md +
-  ReleaseNotes.adoc +
+  UPGRADING.md +
   src/core/* +
   src/gui/* +
   version.sh +
@@ -1214,8 +1255,9 @@ Where _component_ is one of following:
 | Plugin API reference
 
 | doc/relay
-| doc/xx/weechat_relay_protocol.xx.adoc
+| doc/xx/weechat_relay_api.xx.adoc +
-| Relay protocol
+  doc/xx/weechat_relay_weechat.xx.adoc
+| Relay protocols
 
 | doc/dev
 | doc/xx/weechat_dev.en.adoc
@@ -1259,9 +1301,10 @@ Gettext files are in directory _po/_.
 If you want to initialize a new language, use command `msginit`. For example to
 create a file which is ready to translate to Dutch:
 
+[source,shell]
 ----
-$ cd po
+cd po
-$ msginit -i weechat.pot -l nl_NL -o nl.po
+msginit -i weechat.pot -l nl_NL -o nl.po
 ----
 
 Base language for WeeChat is English, so you must of course perfectly understand
@@ -1270,8 +1313,9 @@ English in order to translate to your language.
 After changes in sources, you can regenerate all translations files: run this
 command in the CMake "build" directory:
 
+[source,shell]
 ----
-$ make translations && make update-po
+make translations && make update-po
 ----
 
 Then you can edit .po files (if you can translate in a language).
@@ -1279,8 +1323,9 @@ Then you can edit .po files (if you can translate in a language).
 When done, you *have* to check your file with
 https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
 
+[source,shell]
 ----
-$ msgcheck.py xx.po
+msgcheck.py xx.po
 ----
 
 And then you can recompile WeeChat to use the new translations.

doc/en/weechat_faq.en.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 [[general]]
 == General
@@ -48,12 +49,14 @@ If you still have issues, please report them to the developers.
 It is recommended to use https://brew.sh/[Homebrew ^↗^^],
 you can get help with:
 
+[source,shell]
 ----
 brew info weechat
 ----
 
 You can install WeeChat with this command:
 
+[source,shell]
 ----
 brew install weechat
 ----
@@ -313,10 +316,14 @@ You can use a terminal with rectangular selection (like rxvt-unicode,
 konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse
 selection.
 
+You can toggle nicklist and make it visible only when needed, with key
+kbd:[Alt+Shift+N].
+
 Another solution is to move nicklist to top or bottom, for example:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 [[urls]]
@@ -326,10 +333,13 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
 
 To make opening URLs easier, you can:
 
+* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
+
 * move nicklist to top:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 * disable alignment for multiline words:
@@ -379,6 +389,7 @@ There is no option in WeeChat to change the timezone, the environment variable
 
 In your shell initialization file or on command line, before starting WeeChat:
 
+[source,shell]
 ----
 export TZ=America/New_York
 ----
@@ -682,16 +693,18 @@ According to terminfo used, mouse may not be supported.
 
 You can test mouse support in terminal:
 
+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----
 
 And then click on first char of terminal (upper left). You should see " !!#!!".
 
 To disable mouse in terminal:
 
+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----
 
 [[mouse_coords]]
@@ -746,7 +759,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
 You can try a different priority string, replace "xxx" by your server name:
 
 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----
 
 [[irc_tls_libera]]
@@ -999,8 +1012,9 @@ First check questions about TLS connection in this FAQ.
 
 If still not working, try to manually delete the scripts file (in your shell):
 
+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
 [NOTE]
@@ -1024,15 +1038,17 @@ have to update manually the file yourself to get updates):
 
 * in your shell, with curl installed:
 
+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
+cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
 If you're running macOS and the downloaded file has a size of 0 bytes,
 try to set this variable in your shell initialization file or on command line,
 before starting WeeChat:
 
+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1202,6 +1218,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
 
 When you run WeeChat under gdb, you may have this error:
 
+[source,shell]
 ----
 $ gdb /path/to/weechat
 (gdb) run
@@ -1212,6 +1229,7 @@ Cannot find new threads: generic error
 To fix that, you can run gdb with this command (replace path to libpthread and
 WeeChat with paths on your system):
 
+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
 (gdb) run

doc/en/weechat_quickstart.en.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 [[start]]
 == Start WeeChat
@@ -11,8 +12,9 @@ It has good UTF-8 support and works well with WeeChat's default key bindings.
 
 Run from your shell:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 [[help]]

doc/en/weechat_relay_weechat.en.adoc

@@ -2,11 +2,12 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 [[introduction]]
 == Introduction
 
-This document is the specification of WeeChat Relay protocol: the protocol used
+This document is the specification of _weechat_ relay protocol: the protocol used
 to relay WeeChat data to clients, which are mostly remote interfaces.
 
 [[terminology]]
@@ -24,28 +25,11 @@ The following terms are used in this document:
 
 The _clients_ are connected to _relay_ like shown in this diagram:
 
-....
+include::includes/relay.en.adoc[tag=diagram]
-                                              ┌──────────┐ Workstation
- ┌────────┐                               ┌───┤ client 1 │ (Linux, Windows,
- │  irc   │◄──┐  ╔═══════════╤═══════╗    │   └──────────┘ BSD, macOS ...)
- └────────┘   └──╢           │       ║◄───┘   ┌──────────┐
-   ......        ║  WeeChat  │ Relay ║◄───────┤ client 2 │ Mobile device
- ┌────────┐   ┌──╢           │       ║◄───┐   └──────────┘ (Android, iPhone ...)
- │ jabber │◄──┘  ╚═══════════╧═══════╝    │      ......
- └────────┘                               │   ┌──────────┐
-   ......                                 └───┤ client N │ Other devices
-                                              └──────────┘
-
-
-└────────────┘   └───────────────────┘╘══════╛└────────────────────────────────┘
-network servers    ncurses interface    relay         remote interfaces
-                                      protocol
-....
 
 [NOTE]
-All clients here are clients using _weechat_ protocol in _relay_ plugin. The
+All clients here are clients using _weechat_ protocol in _relay_ plugin. +
-_relay_ plugin also allows IRC clients, then _relay_ plugin acts as an
+The _relay_ plugin also allows _api_ and _irc_ protocols (not described in this document).
-_IRC proxy_ (not described in this document).
 
 [[protocol_generalities]]
 == Protocol generalities
@@ -707,6 +691,7 @@ inl:
         nicklist_visible_count: 0
         title: 'WeeChat 2.9-dev (C) 2003-2020 - https://weechat.org/'
         input: 1
+        input_get_any_user_data: 0
         input_get_unknown_commands: 0
         input_get_empty: 0
         input_multiline: 0
@@ -1504,6 +1489,9 @@ WeeChat reserved identifiers:
 | _buffer_line_added | buffer | hdata: line
 | Line added in buffer. | Display line in buffer.
 
+| _buffer_line_data_changed | buffer | hdata: line
+| Line changed in buffer. | Update line displayed in buffer.
+
 | _nicklist | nicklist | hdata: nicklist_item
 | Nicklist for a buffer. | Replace nicklist.
 
@@ -2058,6 +2046,7 @@ Data sent as hdata:
 |===
 | Name              | Type             | Description
 | buffer            | pointer          | Buffer pointer.
+| id                | integer          | Line identifier.
 | date              | time             | Date of message.
 | date_usec         | integer          | Microseconds of date.
 | date_printed      | time             | Date when WeeChat displayed message.
@@ -2078,6 +2067,7 @@ id: '_buffer_line_added'
 hda:
     keys: {
         'buffer': 'ptr',
+        'id': 'int',
         'date': 'tim',
         'date_usec': 'int',
         'date_printed': 'tim',
@@ -2093,6 +2083,58 @@ hda:
     item 1:
         __path: ['0x4a49600']
         buffer: '0x4a715d0'
+        id: 12
+        date: 1362728993
+        date_usec: 902765
+        date_printed: 1362728993
+        date_usec_printed: 902765
+        displayed: 1
+        notify_level: 1
+        highlight: 0
+        tags_array: [
+            'irc_privmsg',
+            'notify_message',
+            'prefix_nick_142',
+            'nick_FlashCode',
+            'log1',
+        ]
+        prefix: 'F06@F@00142FlashCode'
+        message: 'hello!'
+----
+
+[[message_buffer_line_data_changed]]
+==== _buffer_line_data_changed
+
+This message is sent to the client when the signal "buffer_line_data_changed"
+is sent by WeeChat.
+
+Data sent as hdata: same data as <<message_buffer_line_added,_buffer_line_added>>.
+
+Example: message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_ has been updated:
+
+[source,python]
+----
+id: '_buffer_line_data_changed'
+hda:
+    keys: {
+        'buffer': 'ptr',
+        'id': 'int',
+        'date': 'tim',
+        'date_usec': 'int',
+        'date_printed': 'tim',
+        'date_usec_printed': 'int',
+        'displayed': 'chr',
+        'notify_level': 'chr',
+        'highlight': 'chr',
+        'tags_array': 'arr',
+        'prefix': 'str',
+        'message': 'str',
+    }
+    path: ['line_data']
+    item 1:
+        __path: ['0x4a49600']
+        buffer: '0x4a715d0'
+        id: 12
         date: 1362728993
         date_usec: 902765
         date_printed: 1362728993

doc/en/weechat_scripting.en.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 This manual documents WeeChat chat client, it is part of WeeChat.
 
@@ -67,7 +68,7 @@ link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗
 
 WeeChat defines a `weechat` module which must be imported with `import weechat`. +
 A Python stub for WeeChat API is available in the repository:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
+https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
 
 [[python_functions]]
 ===== Functions
@@ -362,9 +363,10 @@ WeeChat is starting.
 
 For example with Python:
 
+[source,shell]
 ----
-$ cd ~/.local/share/weechat/python/autoload
+cd ~/.local/share/weechat/python/autoload
-$ ln -s ../script.py
+ln -s ../script.py
 ----
 
 [NOTE]
@@ -549,317 +551,14 @@ link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
 
 List of functions in script API:
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_functions.en.adoc[tag=functions]
-|===
-| Category | Functions
-
-| general
-| register
-
-| plugins
-| plugin_get_name
-
-| strings
-| charset_set +
-  iconv_to_internal +
-  iconv_from_internal +
-  gettext +
-  ngettext +
-  strlen_screen +
-  string_match +
-  string_match_list +
-  string_has_highlight +
-  string_has_highlight_regex +
-  string_mask_to_regex +
-  string_format_size +
-  string_parse_size +
-  string_color_code_size +
-  string_remove_color +
-  string_is_command_char +
-  string_input_for_buffer +
-  string_eval_expression +
-  string_eval_path_home
-
-| directories
-| mkdir_home +
-  mkdir +
-  mkdir_parents
-
-| sorted lists
-| list_new +
-  list_add +
-  list_search +
-  list_search_pos +
-  list_casesearch +
-  list_casesearch_pos +
-  list_get +
-  list_set +
-  list_next +
-  list_prev +
-  list_string +
-  list_size +
-  list_remove +
-  list_remove_all +
-  list_free
-
-| configuration files
-| config_new +
-  config_new_section +
-  config_search_section +
-  config_new_option +
-  config_search_option +
-  config_string_to_boolean +
-  config_option_reset +
-  config_option_set +
-  config_option_set_null +
-  config_option_unset +
-  config_option_rename +
-  config_option_is_null +
-  config_option_default_is_null +
-  config_boolean +
-  config_boolean_default +
-  config_integer +
-  config_integer_default +
-  config_string +
-  config_string_default +
-  config_color +
-  config_color_default +
-  config_write_option +
-  config_write_line +
-  config_write +
-  config_read +
-  config_reload +
-  config_option_free +
-  config_section_free_options +
-  config_section_free +
-  config_free +
-  config_get +
-  config_get_plugin +
-  config_is_set_plugin +
-  config_set_plugin +
-  config_set_desc_plugin +
-  config_unset_plugin
-
-| key bindings
-| key_bind +
-  key_unbind
-
-| display
-| prefix +
-  color +
-  print (for python: prnt) +
-  print_date_tags (for python: prnt_date_tags) +
-  print_datetime_tags (for python: prnt_datetime_tags) +
-  print_y (for python: prnt_y) +
-  print_y_date_tags (for python: prnt_y_date_tags) +
-  print_y_datetime_tags (for python: prnt_y_datetime_tags) +
-  log_print
-
-| hooks
-| hook_command +
-  hook_command_run +
-  hook_timer +
-  hook_fd +
-  hook_process +
-  hook_process_hashtable +
-  hook_connect +
-  hook_line +
-  hook_print +
-  hook_signal +
-  hook_signal_send +
-  hook_hsignal +
-  hook_hsignal_send +
-  hook_config +
-  hook_completion +
-  hook_modifier +
-  hook_modifier_exec +
-  hook_info +
-  hook_info_hashtable +
-  hook_infolist +
-  hook_focus +
-  hook_set +
-  unhook +
-  unhook_all
-
-| buffers
-| buffer_new +
-  buffer_new_props +
-  current_buffer +
-  buffer_search +
-  buffer_search_main +
-  buffer_clear +
-  buffer_close +
-  buffer_merge +
-  buffer_unmerge +
-  buffer_get_integer +
-  buffer_get_string +
-  buffer_get_pointer +
-  buffer_set +
-  buffer_string_replace_local_var +
-  buffer_match_list
-
-| windows
-| current_window +
-  window_search_with_buffer +
-  window_get_integer +
-  window_get_string +
-  window_get_pointer +
-  window_set_title
-
-| nicklist
-| nicklist_add_group +
-  nicklist_search_group +
-  nicklist_add_nick +
-  nicklist_search_nick +
-  nicklist_remove_group +
-  nicklist_remove_nick +
-  nicklist_remove_all +
-  nicklist_group_get_integer +
-  nicklist_group_get_string +
-  nicklist_group_get_pointer +
-  nicklist_group_set +
-  nicklist_nick_get_integer +
-  nicklist_nick_get_string +
-  nicklist_nick_get_pointer +
-  nicklist_nick_set
-
-| bars
-| bar_item_search +
-  bar_item_new +
-  bar_item_update +
-  bar_item_remove +
-  bar_search +
-  bar_new +
-  bar_set +
-  bar_update +
-  bar_remove
-
-| commands
-| command +
-  command_options
-
-| completion
-| completion_new +
-  completion_search +
-  completion_get_string +
-  completion_list_add +
-  completion_free
-
-| infos
-| info_get +
-  info_get_hashtable
-
-| infolists
-| infolist_new +
-  infolist_new_item +
-  infolist_new_var_integer +
-  infolist_new_var_string +
-  infolist_new_var_pointer +
-  infolist_new_var_time +
-  infolist_get +
-  infolist_next +
-  infolist_prev +
-  infolist_reset_item_cursor +
-  infolist_search_var +
-  infolist_fields +
-  infolist_integer +
-  infolist_string +
-  infolist_pointer +
-  infolist_time +
-  infolist_free
-
-| hdata
-| hdata_get +
-  hdata_get_var_offset +
-  hdata_get_var_type_string +
-  hdata_get_var_array_size +
-  hdata_get_var_array_size_string +
-  hdata_get_var_hdata +
-  hdata_get_list +
-  hdata_check_pointer +
-  hdata_move +
-  hdata_search +
-  hdata_char +
-  hdata_integer +
-  hdata_long +
-  hdata_string +
-  hdata_pointer +
-  hdata_time +
-  hdata_hashtable +
-  hdata_compare +
-  hdata_update +
-  hdata_get_string
-
-| upgrade
-| upgrade_new +
-  upgrade_write_object +
-  upgrade_read +
-  upgrade_close
-|===
 
 [[script_api_constants]]
 === Constants
 
 List of constants in script API:
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_constants.en.adoc[tag=constants]
-|===
-| Category | Constants
-
-| return codes
-| `WEECHAT_RC_OK` (integer) +
-  `WEECHAT_RC_OK_EAT` (integer) +
-  `WEECHAT_RC_ERROR` (integer)
-
-| configuration files
-| `WEECHAT_CONFIG_READ_OK` (integer) +
-  `WEECHAT_CONFIG_READ_MEMORY_ERROR` (integer) +
-  `WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (integer) +
-  `WEECHAT_CONFIG_WRITE_OK` (integer) +
-  `WEECHAT_CONFIG_WRITE_ERROR` (integer) +
-  `WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_ERROR` (integer) +
-  `WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (integer) +
-  `WEECHAT_CONFIG_OPTION_UNSET_ERROR` (integer)
-
-| sorted lists
-| `WEECHAT_LIST_POS_SORT` (string) +
-  `WEECHAT_LIST_POS_BEGINNING` (string) +
-  `WEECHAT_LIST_POS_END` (string)
-
-| hotlist
-| `WEECHAT_HOTLIST_LOW` (string) +
-  `WEECHAT_HOTLIST_MESSAGE` (string) +
-  `WEECHAT_HOTLIST_PRIVATE` (string) +
-  `WEECHAT_HOTLIST_HIGHLIGHT` (string)
-
-| hook process
-| `WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
-  `WEECHAT_HOOK_PROCESS_ERROR` (integer)
-
-| hook connect
-| `WEECHAT_HOOK_CONNECT_OK` (integer) +
-  `WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (integer) +
-  `WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (integer) +
-  `WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (integer) +
-  `WEECHAT_HOOK_CONNECT_PROXY_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (integer) +
-  `WEECHAT_HOOK_CONNECT_TIMEOUT` (integer) +
-  `WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (integer)
-
-| hook signal
-| `WEECHAT_HOOK_SIGNAL_STRING` (string) +
-  `WEECHAT_HOOK_SIGNAL_INT` (string) +
-  `WEECHAT_HOOK_SIGNAL_POINTER` (string)
-|===
 
 [[common_tasks]]
 == Common tasks

doc/en/weechat_user.en.adoc

@@ -2,6 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: en
+include::includes/attributes-en.adoc[]
 
 This manual documents WeeChat chat client, it is part of WeeChat.
 
@@ -30,7 +31,7 @@ Main features are:
   https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
   https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] and
   https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
-* IRC proxy and relay for remote interfaces
+* IRC proxy and relay for WeeChat and remote interfaces
 * multi-platform (GNU/Linux, *BSD, macOS, Windows and other)
 * 100% GPL, free software
 
@@ -110,7 +111,7 @@ WeeChat:
 | cmake | ≥ 3.0
 | Build.
 
-| pkg-config |
+| pkgconf / pkg-config |
 | Detect installed libraries.
 
 | libncurses-dev |
@@ -128,7 +129,8 @@ WeeChat:
 
 | zlib1g-dev |
 | Logger plugin: compression of rotated log files (gzip). +
-  Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
+  Relay plugin: compression of messages with https://zlib.net/[zlib ^↗^^]
+  (api and weechat protocols). +
   Script plugin: read of repository index file (gzip).
 |===
 
@@ -154,9 +156,13 @@ WeeChat:
 | ca-certificates |
 | Certificates for TLS connections.
 
+| libcjson-dev |
+| Relay plugin: protocol "api" (HTTP REST API).
+
 | libzstd-dev | ≥ 0.8.1
 | Logger plugin: compression of rotated log files (zstandard). +
-  Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
+  Relay plugin: compression of messages with https://facebook.github.io/zstd/[Zstandard ^↗^^]
+  (api and weechat protocols).
 
 | libaspell-dev / libenchant-dev |
 | Spell plugin.
@@ -215,8 +221,9 @@ If you are using a Debian/Ubuntu based distribution, and if you have some
 "deb-src" source entries in your file _/etc/apt/sources.list_, you can install
 all dependencies with the command:
 
+[source,shell]
 ----
-# apt-get build-dep weechat
+sudo apt-get build-dep weechat
 ----
 
 [[build]]
@@ -224,22 +231,24 @@ all dependencies with the command:
 
 * Installation in system directories (requires _root_ privileges):
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake ..
+cmake ..
-$ make
+make
-$ sudo make install
+sudo make install
 ----
 
 * Installation in custom directory (for example your home):
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
+cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
-$ make
+make
-$ make install
+make install
 ----
 
 Options can be used for CMake, with format: `-DOPTION=VALUE`.
@@ -273,6 +282,9 @@ List of available options:
 | ENABLE_CHARSET | `ON`, `OFF` | ON
 | Compile <<charset,Charset plugin>>.
 
+| ENABLE_CJSON | `ON`, `OFF` | ON
+| Support of JSON with https://github.com/DaveGamble/cJSON[cJSON ^↗^^] library.
+
 | ENABLE_MAN | `ON`, `OFF` | OFF
 | Build man page.
 
@@ -372,14 +384,16 @@ List of available options:
 
 The other options can be displayed with this command:
 
+[source,shell]
 ----
-$ cmake -LA
+cmake -LA
 ----
 
 Or with Curses interface:
 
+[source,shell]
 ----
-$ ccmake ..
+ccmake ..
 ----
 
 [[tests]]
@@ -392,14 +406,16 @@ Following packages are *required* to compile tests:
 
 Tests must be enabled when compiling WeeChat:
 
+[source,shell]
 ----
-$ cmake .. -DENABLE_TESTS=ON
+cmake .. -DENABLE_TESTS=ON
 ----
 
 They can be launched after compilation from the build directory:
 
+[source,shell]
 ----
-$ ctest -V
+ctest -V
 ----
 
 [[git_sources]]
@@ -410,8 +426,9 @@ stable. You're warned!
 
 To get Git sources, issue this command:
 
+[source,shell]
 ----
-$ git clone https://github.com/weechat/weechat.git
+git clone https://github.com/weechat/weechat.git
 ----
 
 Then follow instructions for source package (see
@@ -434,8 +451,9 @@ you have to:
 
 If you're compiling with CMake:
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug
+cmake .. -DCMAKE_BUILD_TYPE=Debug
 ----
 
 [[address_sanitizer]]
@@ -444,8 +462,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
 You can additionally enable the address sanitizer, which causes WeeChat to
 crash immediately in case of problem:
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
+cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
 ----
 
 [WARNING]
@@ -454,8 +473,9 @@ this is not recommended in production.
 
 Then once compiled and installed, you must run WeeChat like this:
 
+[source,shell]
 ----
-$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
+ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
 ----
 
 In case of crash, the backtrace is in file `asan.log`.
@@ -475,12 +495,14 @@ starts, you can use `ulimit` command.
 
 For example under Linux with _bash_ shell, add this line to your `~/.bashrc`:
 
+[source,shell]
 ----
 ulimit -c unlimited
 ----
 
 Or max size:
 
+[source,shell]
 ----
 ulimit -c 200000
 ----
@@ -502,6 +524,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
 For example if _weechat_ is installed in _/usr/bin/_ and _core_ file is
 in _/home/user/_, then run gdb with this command:
 
+[source,shell]
 ----
 gdb /usr/bin/weechat /home/user/core
 ----
@@ -520,11 +543,11 @@ Copying output to /tmp/crash.txt.
     at /some_path/src/core/weechat.c:351
 #3  <signal handler called>
 #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
-    remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
+    remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
         hook_process = 0x254eb90
         status = <value optimized out>
 #5  0x000000000044cc7d in hook_timer_exec ()
-    at /some_path/src/core/wee-hook.c:1025
+    at /some_path/src/core/core-hook.c:1025
         tv_time = {tv_sec = 1272693881, tv_usec = 212665}
         ptr_hook = 0x2811f40
         next_hook = 0x0
@@ -549,6 +572,7 @@ Thank you for your help!
 To debug a running WeeChat (for example if WeeChat seems blocked), you can use
 gdb with process id (replace _12345_ with PID of weechat process):
 
+[source,shell]
 ----
 gdb /usr/bin/weechat 12345
 ----
@@ -564,8 +588,9 @@ Then like for a crash, use command `bt full`:
 
 To start WeeChat, issue this command:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 When you run WeeChat for the first time, the default configuration files are
@@ -781,25 +806,25 @@ This saves the current state in `*.upgrade` files. You can then either reboot
 or move the whole WeeChat directories (config, data, cache) to another machine,
 and restart WeeChat later with this command:
 
+[source,shell]
 ----
-$ weechat --upgrade
+weechat --upgrade
 ----
 
 [[restart_after_upgrade]]
 === Restart after upgrade
 
-[[restart_release_notes]]
+[[restart_upgrading_notes]]
-==== Release notes
+==== Upgrading notes
 
-After an upgrade, it is *strongly recommended* to read the
+After an upgrade, it is *strongly recommended* to read the file
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
+https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
-which contain important information about breaking changes and some
+which contains important information about breaking changes and some
 manual actions that could be required.
 
-You must read the release notes of all versions between your old (excluded) and
+You must read the versions between your old (excluded) and your new version (included). +
-your new version (included). +
+For example if you switch from version 4.0.0 to 4.3.0, you must read versions
-For example if you switch from version 3.0 to 3.2, you must read release notes
+4.0.1 to 4.3.0.
-of versions 3.1 and 3.2.
 
 [[restart_configuration_upgrade]]
 ==== Configuration upgrade
@@ -1318,7 +1343,7 @@ Tags commonly used (non-exhaustive list):
 | no_filter        | Line can not be filtered.
 | no_highlight     | No highlight is possible on line.
 | no_log           | Line is not written in log file.
-| log0 … log9      | Level of log for line (see `/help logger`).
+| log0 … log9      | Level of log for line (see the <<command_logger_logger,/logger>> command).
 | notify_none      | The line must not be added to hotlist. ^(1)^
 | notify_message   | The line is a user message. ^(1)^
 | notify_private   | The line is a private message. ^(1)^
@@ -1845,10 +1870,10 @@ These mouse actions are possible only if mouse is enabled with key kbd:[Alt+m]
 | kbd:[▼]            | -            | chat: /list buffer  | Move five lines down in /list buffer. | `+/list -down 5+`
 | kbd:[■ □ □]        | -            | chat: /list buffer  | Select line in /list buffer. | `+/window ${_window_number};/list -go ${_chat_line_y}+`
 | kbd:[□ □ ■]        | -            | chat: /list buffer  | Join IRC channel on selected line. | `+hsignal:irc_list_mouse+`
-| kbd:[▲]            | -            | chat: script buffer | Move five lines up in script buffer. | `+/script up 5+`
+| kbd:[▲]            | -            | chat: script buffer | Move five lines up in script buffer. | `+/script -up 5+`
-| kbd:[▼]            | -            | chat: script buffer | Move five lines down in script buffer. | `+/script down 5+`
+| kbd:[▼]            | -            | chat: script buffer | Move five lines down in script buffer. | `+/script -down 5+`
-| kbd:[■ □ □]        | -            | chat: script buffer | Select line in script buffer. | `+/script go ${_chat_line_y}+`
+| kbd:[■ □ □]        | -            | chat: script buffer | Select line in script buffer. | `+/script -go ${_chat_line_y}+`
-| kbd:[□ □ ■]        | -            | chat: script buffer | Install/remove script. | `+/script go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
+| kbd:[□ □ ■]        | -            | chat: script buffer | Install/remove script. | `+/script -go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
 | kbd:[■ □ □]        | up / left    | buflist             | Move buffer to a lower number. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]        | down / right | buflist             | Move buffer to a higher number. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]        | -            | buflist             | Switch to buffer (previously visited buffer if the buffer is the current one). | Signal `+buflist_mouse+`.
@@ -1966,8 +1991,8 @@ These keys and actions are used on the script buffer (see <<script_manager,scrip
 [width="100%",cols="^.^3,^.^2,.^8,.^5",options="header"]
 |===
 | Key               | Action ^(1)^ | Description | Command
-| kbd:[↑]           |              | Move one line up. | `+/script up+`
+| kbd:[↑]           |              | Move one line up. | `+/script -up+`
-| kbd:[↓]           |              | Move one line down. | `+/script down+`
+| kbd:[↓]           |              | Move one line down. | `+/script -down+`
 | kbd:[PgUp]        |              | Move one page up. | `+/window page_up+`
 | kbd:[PgDn]        |              | Move one page down. | `+/window page_down+`
 | kbd:[Alt+i]       | `i`          | Install script. | `+/script install+`
@@ -2673,27 +2698,37 @@ You can change or add bindings with the command `/key` using context "mouse"
 Event name consists of a modifier (optional), a button/wheel name and a gesture
 (optional). Different elements are separated by `+-+`.
 
-List of modifiers:
+List of modifiers (by order in the event name):
 
 [width="100%",cols="1m,4",options="header"]
 |===
 | Modifier | Description
-| ctrl     | Key kbd:[Ctrl]
 | alt      | Key kbd:[Alt]
-| ctrl-alt | Keys kbd:[Ctrl] + kbd:[Alt]
+| ctrl     | Key kbd:[Ctrl]
+| shift    | Key kbd:[Shift] ^(1)^
 |===
 
+[NOTE]
+^(1)^ The `shift` modifier can rarely be used in WeeChat because many terminals
+use this modifier to catch directly mouse events.
+
+Several modifiers can be combined, for example:
+
+* `alt-ctrl`
+* `ctrl-shift`
+* `alt-ctrl-shift`
+
 List of buttons/wheel:
 
 [width="100%",cols="1m,4",options="header"]
 |===
-| Button/wheel        | Description
+| Button/wheel         | Description
-| button1             | Click on left button
+| button1              | Click on left button
-| button2             | Click on right button
+| button2              | Click on right button
-| button3             | Click on middle button (often click on wheel)
+| button3              | Click on middle button (often click on wheel)
-| button4 ... button9 | Click on extra buttons
+| button4 ... button11 | Click on extra buttons
-| wheelup             | Wheel (up)
+| wheelup              | Wheel (up)
-| wheeldown           | Wheel (down)
+| wheeldown            | Wheel (down)
 |===
 
 List of gestures (only for buttons, not wheel):
@@ -2729,7 +2764,7 @@ Example of events:
 * `button1-event-drag`
 * `alt-button2-gesture-down-long`
 * `wheelup`
-* `ctrl-alt-wheeldown`
+* `alt-ctrl-wheeldown`
 * ...
 
 [TIP]
@@ -2789,8 +2824,9 @@ configuration.
 The option name is an aspell configuration option. List of options can be found
 in a shell with following command:
 
+[source,shell]
 ----
-$ aspell config
+aspell config
 ----
 
 For example, to enable option "ignore-case":
@@ -3226,7 +3262,7 @@ buffer to see values), just do:
 Secured data can be used in some options that can contain private data like
 password, using this format: "${sec.data.xxx}" where "xxx" is the name of
 secured data (used with `/secure set xxx ...`). +
-For a complete list of supported options, see `/help secure`.
+For a complete list of supported options, see the <<command_weechat_secure,/secure>> command.
 
 To use the _libera_ password, for example with
 <<irc_sasl_authentication,SASL authentication>>:
@@ -3350,8 +3386,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
 Example to join _#weechat_ and _#weechat-fr_ on server _irc.libera.chat_ server,
 default port (6667), with nick _alice_:
 
+[source,shell]
 ----
-$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
+weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 ----
 
 [[irc_servers]]
@@ -3505,9 +3542,10 @@ even if it was OK with versions prior to 0.3.1.
 
 * Import certificate in shell:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
+wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
 ----
 
 [NOTE]
@@ -3528,10 +3566,11 @@ It is possible to concatenate many certificates in file CAs.pem.
 
 * Create certificate in shell:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
+openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----
 
 [NOTE]
@@ -3579,8 +3618,9 @@ ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection).
 
 You can generate the key with this command:
 
+[source,shell]
 ----
-$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
+openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
 ----
 
 [NOTE]
@@ -3589,8 +3629,9 @@ which can also be for example `~/.weechat`.
 
 Get the public key (encoded as base64) with this command:
 
+[source,shell]
 ----
-$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
+openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
 ----
 
 Connect to the server, identify (for example with "nickserv identify") and set
@@ -3657,8 +3698,9 @@ privacy and security on the Internet.
 
 In first place, install Tor. For Debian (and derived):
 
+[source,shell]
 ----
-$ sudo apt-get install tor
+sudo apt-get install tor
 ----
 
 In WeeChat you need to add a socks5 proxy for Tor service (hostname/IP and
@@ -4079,7 +4121,7 @@ for example if `#channel1` requires a key but not `#channel2`:
 /set irc.server.libera.autojoin "#channel1,#channel2 key1"
 ----
 
-For help on the format, see `/help irc.server.libera.autojoin`.
+For help on the format, see option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
 
 [[irc_private_messages]]
 === Private messages
@@ -4126,7 +4168,7 @@ buffers, for example:
 ----
 
 It is possible to create filter for one channel only or channels beginning with
-same name (see `/help filter`):
+same name (see the <<command_weechat_filter,/filter>> command):
 
 ----
 /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4511,8 +4553,13 @@ The Relay plugin is used to relay data via network, using different protocols:
 
 * _irc_: IRC proxy: used to share connections to IRC servers with one or many
   other IRC clients
+* _api_: HTTP REST API, used by WeeChat and remote interfaces to display and
+  interact with WeeChat
 * _weechat_: protocol used by remote interfaces to display and interact with
-  WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^].
+  WeeChat.
+
+For _api_ and _weechat_ protocols, see the list of remote interfaces on
+https://weechat.org/about/interfaces/[this page ^↗^^].
 
 [[relay_password]]
 === Password
@@ -4524,13 +4571,13 @@ It is highly recommended to set a password for relay, with these commands:
 /set relay.network.password "${sec.data.relay}"
 ----
 
-This password is used for _irc_ and _weechat_ protocols.
+This password is used with all protocols.
 
 [[relay_totp]]
 === TOTP
 
 TOTP (Time-based One-Time Password) can be used as secondary authentication
-factor for _weechat_ protocol, in addition to the password.
+factor for _api_ and _weechat_ protocols, in addition to the password.
 
 This is optional and increases the security level.
 
@@ -4566,10 +4613,11 @@ The default path to certificate/key is defined by option
 
 You can create a certificate and private key with following commands:
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
 ----
 
 [NOTE]
@@ -4622,6 +4670,39 @@ commands:
 /set irc.server.relay.password "${sec.data.relay_libera}"
 ----
 
+[[relay_api_protocol]]
+=== API protocol
+
+The Relay plugin can send data to a remote WeeChat or interface using an
+HTTP REST API protocol.
+
+You can browse and test the API online:
+https://weechat.org/api/[WeeChat Relay API ^↗^^].
+
+You can connect with WeeChat or a remote interface, see
+https://weechat.org/about/interfaces/[this page ^↗^^].
+
+For example:
+
+----
+/relay add api 9000
+----
+
+Now you can connect on port 9000 with a WeeChat or a remote interface using
+password "mypassword".
+
+To connect to an _api_ relay with WeeChat:
+
+----
+/remote add weechat http://localhost:9000 -password=mypassword
+/remote connect weechat
+----
+
+[NOTE]
+The remote WeeChat must expose the same API version as the local WeeChat, so
+it's highly recommended to use exactly the same WeeChat version on remote
+and local client.
+
 [[relay_weechat_protocol]]
 === WeeChat protocol
 
@@ -4636,10 +4717,10 @@ WeeChat itself can NOT connect to another WeeChat with this protocol.
 For example:
 
 ----
-/relay add weechat 9000
+/relay add weechat 9500
 ----
 
-Now you can connect on port 9000 with a remote interface using password
+Now you can connect on port 9500 with a remote interface using password
 "mypassword".
 
 [[relay_websocket]]
@@ -4657,11 +4738,13 @@ A WebSocket can be opened in a HTML5 with a single line of JavaScript:
 
 [source,javascript]
 ----
-websocket = new WebSocket("ws://server.com:9000/weechat");
+websocket = new WebSocket("ws://server.com:9500/weechat");
 ----
 
-The port (9000 in example) is the port defined in Relay plugin.
+The port (9500 in example) is the port defined in Relay plugin.
-The URI must always end with "/weechat" (for _irc_ and _weechat_ protocols).
+
+The URI must end with "/weechat" for _irc_ and _weechat_ protocols and "/api"
+for _api_ protocol.
 
 [[relay_unix_socket]]
 === UNIX domain sockets
@@ -4679,8 +4762,9 @@ SSH forwarding for relay clients, when other ports cannot be opened.
 
 Using OpenSSH:
 
+[source,shell]
 ----
-$ ssh -L 9000:.weechat/relay_socket user@hostname
+ssh -L 9000:.weechat/relay_socket user@hostname
 ----
 
 This redirects local relay clients connecting on port 9000 to the WeeChat
@@ -4704,7 +4788,7 @@ Sections in file _relay.conf_:
 | network | /set relay.network.*               | Network options.
 | irc     | /set relay.irc.*                   | Options specific to irc protocol (irc proxy).
 | port    | <<command_relay_relay,/relay add>> +
-            /set relay.port.*                  | Ports used for relay (irc and weechat protocols) (options can be added/removed in section).
+            /set relay.port.*                  | Ports used for relay (options can be added/removed in section).
 |===
 
 Options:
@@ -4766,34 +4850,39 @@ Some examples:
 
 * Change nick on IRC server libera to "newnick":
 
+[source,shell]
 ----
-$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Send a message on IRC #weechat channel:
 
+[source,shell]
 ----
-$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Send a multiline message on IRC #test channel, if capability "draft/multiline"
   is enabled on the ergo server:
 
+[source,shell]
 ----
-$ echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Send a message on current buffer:
 
+[source,shell]
 ----
-$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
+echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Send two commands to unload/reload Python scripts (you have to separate them
   with "\n"):
 
+[source,shell]
 ----
-$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
+printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 [[fifo_commands]]
@@ -5110,7 +5199,9 @@ Matching groups can be used in _replace_:
 
 * `+${re:0}+` to `+${re:99}+`: `+${re:0}+` is the whole match, `+${re:1}+` to
   `+${re:99}+` are groups captured
-* `+${re:+}+`: the last match (with highest number)
+* `pass:[${re:+}]`: the last match (with highest number)
+* `+${re:#}+`: index of last group captured
+* `+${re:repl_index}+`: index of replacement being done (starts to 1)
 * `+${hide:c,${re:N}}+`: match "N" with all chars replaced by "c"
   (example: `+${hide:*,${re:2}}+` is the group #2 with all chars replaced by
   `+*+`).
@@ -5259,7 +5350,7 @@ is added in hashtable:
 | server               | string  | Name of server (example: "libera").
 | tags                 | string  | Tags in message (rarely used).
 | message_without_tags | string  | Message without tags.
-| nick                 | string  | Nick.
+| nick                 | string  | Nick. ^(1)^
 | host                 | string  | Hostname.
 | command              | string  | IRC command (example: "PRIVMSG", "NOTICE", ...).
 | channel              | string  | IRC channel.
@@ -5271,6 +5362,10 @@ is added in hashtable:
 | pos_text             | string  | The index of _text_ in message ("-1" if _text_ was not found).
 |===
 
+[NOTE]
+^(1)^ The nick is the sender of the message. +
+Your own nick on the server is `${irc_server.nick}`.
+
 When the data is a pointer, the variable `+tg_signal_data+` can be used like this
 to read a hdata property (in this example this is a pointer on a buffer):
 

doc/es/includes/attributes-es.adoc

@@ -0,0 +1,23 @@
+// Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com> with updates from Fede Mendez <federicomh@gmail.com>
+:appendix-caption: Apéndice
+:appendix-refsig: {appendix-caption}
+:caution-caption: Precaución
+:chapter-signifier: Capítulo
+:chapter-refsig: {chapter-signifier}
+:example-caption: Ejemplo
+:figure-caption: Figura
+:important-caption: Importante
+:last-update-label: Ultima actualización
+ifdef::listing-caption[:listing-caption: Lista]
+ifdef::manname-title[:manname-title: Nombre]
+:note-caption: Nota
+:part-signifier: Parte
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Prefacio]
+:section-refsig: Sección
+:table-caption: Tabla
+:tip-caption: Sugerencia
+:toc-title: Tabla de Contenido
+:untitled-label: Sin título
+:version-label: Versión
+:warning-caption: Aviso

doc/es/weechat_faq.es.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: es
-:toc-title: Índice
+include::includes/attributes-es.adoc[]
 
 Traductores
 
@@ -58,12 +58,14 @@ If you still have issues, please report them to the developers.
 Se recomienda utilizar https://brew.sh/[Homebrew ^↗^^],
 puede obtener ayuda con el comando:
 
+[source,shell]
 ----
 brew info weechat
 ----
 
 Puede instalar WeeChat con este comando:
 
+[source,shell]
 ----
 brew install weechat
 ----
@@ -326,10 +328,15 @@ Puede utilizar una terminal con selección rectangualr (como rxvt-unicode,
 konsole, gnome-terminal, etc.). La tecla normalmente es kbd:[Ctrl] + kbd:[Alt] + la selección
 con el ratón.
 
+// TRANSLATION MISSING
+You can toggle nicklist and make it visible only when needed, with key
+kbd:[Alt+Shift+N].
+
 Otra solución es mover la lista de apodos a la parte superior o inferior, por ejemplo:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 [[urls]]
@@ -340,10 +347,14 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
 
 Para abrir direcciones URL más fácilmente, puede:
 
+// TRANSLATION MISSING
+* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
+
 * mover la lista de apodos a la parte superior con este comando:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 * inhabilitar la alineación de palabras multilínea:
@@ -394,6 +405,7 @@ No hay razón en WeeChat para cambiar la zona horaria, la variable de entorno
 
 En el archivo de inicialización de su shell o en la línea de comando, antes de ejecutar WeeChat:
 
+[source,shell]
 ----
 export TZ=America/New_York
 ----
@@ -701,16 +713,18 @@ De acuerdo a la información usada, el ratón podrá o no estar soportado.
 
 Puede comprobar el soporte del ratón en la terminal:
 
+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----
 
 Y después haga clic en el primer caracter de la terminal (superior izquierdo). Debería ver " !!#!!".
 
 Para inhabilitar el ratón en la terminal:
 
+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----
 
 [[mouse_coords]]
@@ -766,7 +780,7 @@ Puede intentar una cadena de prioridad diferente, reemplace "xxx" por el nombre
 de su servidor:
 
 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----
 
 [[irc_tls_libera]]
@@ -1033,8 +1047,9 @@ Primero compruebe las preguntas sobre la conexión TLS en este documento.
 
 Si todavía no funciona, trate de manera manual eliminar los archivos de scripts (escriba en su terminal):
 
+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
 // TRANSLATION MISSING
@@ -1059,9 +1074,10 @@ que actualizar manualmente el archivo usted mismo para obtener las actualizacion
 
 * en su terminal, con el software curl instalado:
 
+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
+cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
 // TRANSLATION MISSING
@@ -1069,6 +1085,7 @@ If you're running macOS and the downloaded file has a size of 0 bytes,
 try to set this variable in your shell initialization file or on command line,
 before starting WeeChat:
 
+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1243,6 +1260,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
 
 Cuando ejecuta WeeChat bajo gdb, puede tener este error:
 
+[source,shell]
 ----
 $ gdb /ruta/a/weechat
 (gdb) run
@@ -1253,6 +1271,7 @@ Cannot find new threads: generic error
 Para solucionar esto, puede ejecutar gdb con este comando (reemplace la ruta a libpthread y
 WeeChat con las rutas de su sistema):
 
+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /ruta/a/weechat
 (gdb) run

doc/es/weechat_quickstart.es.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: es
-:toc-title: Índice
+include::includes/attributes-es.adoc[]
 
 Traductores:
 
@@ -18,8 +18,9 @@ los atajos de teclado predeterminados.
 
 Ejecuta desde una consola:
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 [[help]]

doc/fr/includes/attributes-fr.adoc

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

doc/fr/includes/cmdline_options.fr.adoc

@@ -36,6 +36,9 @@
 *-h*, *--help*::
     Afficher l'aide.
 
+*-i*, *--build-info*::
+    Afficher les informations de construction et quitter.
+
 *-l*, *--license*::
     Afficher la licence de WeeChat.
 

doc/fr/includes/man.fr.adoc

@@ -100,7 +100,7 @@ $HOME/.local/share/weechat/weechat.log::
 
 // tag::copyright[]
 WeeChat est écrit par Sébastien Helleu et des contributeurs (la liste complète
-est dans le fichier AUTHORS.adoc).
+est dans le fichier AUTHORS.md).
 
 Copyright (C) 2003-2024 {author}
 

doc/fr/includes/relay.fr.adoc

@@ -0,0 +1,18 @@
+// tag::diagram[]
+....
+                                              ┌──────────┐ Station de travail
+ ┌────────┐                               ┌───┤ client 1 │ (Linux, Windows,
+ │  irc   │◄──┐  ╔═══════════╤═══════╗    │   └──────────┘ BSD, macOS, …)
+ └────────┘   └──╢           │       ║◄───┘   ┌──────────┐
+   ......        ║  WeeChat  │ Relay ║◄───────┤ client 2 │ Appareil mobile
+ ┌────────┐   ┌──╢           │       ║◄───┐   └──────────┘ (Android, iPhone, …)
+ │ jabber │◄──┘  ╚═══════════╧═══════╝    │      ......
+ └────────┘                               │   ┌──────────┐
+   ......                                 └───┤ client N │ Autres appareils
+                                              └──────────┘
+
+
+└────────────┘   └───────────────────┘╘══════╛└────────────────────────────────┘
+   serveurs        interface ncurses    relay        interfaces distantes
+....
+// end::diagram[]

doc/fr/weechat_dev.fr.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 Ce manuel documente le client de messagerie instantanée WeeChat, il fait
 partie de WeeChat.
@@ -114,97 +114,97 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Chemin/fichier                  | Description
+| Chemin/fichier                | Description
-| core/                           | Fonctions du cœur : point d'entrée, structures internes.
+| core/                         | Fonctions du cœur : point d'entrée, structures internes.
-|    wee-arraylist.c              | Listes avec tableau (« arraylists »).
+|    core-arraylist.c           | Listes avec tableau (« arraylists »).
-|    wee-backtrace.c              | Afficher une trace après un plantage.
+|    core-backtrace.c           | Afficher une trace après un plantage.
-|    wee-calc.c                   | Calcul du résultat d'expressions.
+|    core-calc.c                | Calcul du résultat d'expressions.
-|    wee-command.c                | Commandes du cœur de WeeChat.
+|    core-command.c             | Commandes du cœur de WeeChat.
-|    wee-completion.c             | Complétions par défaut.
+|    core-completion.c          | Complétions par défaut.
-|    wee-config-file.c            | Gestion des fichiers de configuration.
+|    core-config-file.c         | Gestion des fichiers de configuration.
-|    wee-config.c                 | Options de configuration du cœur de WeeChat (fichier weechat.conf).
+|    core-config.c              | Options de configuration du cœur de WeeChat (fichier weechat.conf).
-|    wee-crypto.c                 | Fonctions de cryptographie.
+|    core-crypto.c              | Fonctions de cryptographie.
-|    wee-debug.c                  | Quelques fonctions de debug.
+|    core-debug.c               | Quelques fonctions de debug.
-|    wee-dir.c                    | Fonctions sur les répertoires/fichiers.
+|    core-dir.c                 | Fonctions sur les répertoires/fichiers.
-|    wee-doc.c                    | Génération de fichiers pour la documentation.
+|    core-doc.c                 | Génération de fichiers pour la documentation.
-|    wee-eval.c                   | Évaluation d'expressions avec des références à des variables internes.
+|    core-eval.c                | Évaluation d'expressions avec des références à des variables internes.
-|    wee-hashtable.c              | Tables de hachage.
+|    core-hashtable.c           | Tables de hachage.
-|    wee-hdata.c                  | Hdata (accès direct aux données en utilisant des tables de hachage).
+|    core-hdata.c               | Hdata (accès direct aux données en utilisant des tables de hachage).
-|    wee-hook.c                   | Crochets ("hooks").
+|    core-hook.c                | Crochets ("hooks").
-|    wee-infolist.c               | Infolists (listes avec les données des objets).
+|    core-infolist.c            | Infolists (listes avec les données des objets).
-|    wee-input.c                  | Entrée de commandes/texte.
+|    core-input.c               | Entrée de commandes/texte.
-|    wee-list.c                   | Listes triées.
+|    core-list.c                | Listes triées.
-|    wee-log.c                    | Écriture dans le fichier de log WeeChat (weechat.log).
+|    core-log.c                 | Écriture dans le fichier de log WeeChat (weechat.log).
-|    wee-network.c                | Fonctions réseau (connexion aux serveurs/proxies).
+|    core-network.c             | Fonctions réseau (connexion aux serveurs/proxies).
-|    wee-proxy.c                  | Gestion des proxies.
+|    core-proxy.c               | Gestion des proxies.
-|    wee-secure.c                 | Fonctions pour les données sécurisées.
+|    core-secure.c              | Fonctions pour les données sécurisées.
-|    wee-secure-buffer.c          | Tampon pour les données sécurisées.
+|    core-secure-buffer.c       | Tampon pour les données sécurisées.
-|    wee-secure-config.c          | Options des données sécurisées (fichier sec.conf).
+|    core-secure-config.c       | Options des données sécurisées (fichier sec.conf).
-|    wee-signal.c                 | Fonctions sur les signaux.
+|    core-signal.c              | Fonctions sur les signaux.
-|    wee-string.c                 | Fonctions sur les chaînes de caractères.
+|    core-string.c              | Fonctions sur les chaînes de caractères.
-|    wee-sys.c                    | Fonctions système.
+|    core-sys.c                 | Fonctions système.
-|    wee-upgrade-file.c           | Système de mise à jour interne.
+|    core-upgrade-file.c        | Système de mise à jour interne.
-|    wee-upgrade.c                | Mise à jour du cœur de WeeChat (tampons, lignes, historique, ...).
+|    core-upgrade.c             | Mise à jour du cœur de WeeChat (tampons, lignes, historique, ...).
-|    wee-url.c                    | Transfert d'URL (en utilisant libcurl).
+|    core-url.c                 | Transfert d'URL (en utilisant libcurl).
-|    wee-utf8.c                   | Fonctions UTF-8.
+|    core-utf8.c                | Fonctions UTF-8.
-|    wee-util.c                   | Quelques autres fonctions utilitaires.
+|    core-util.c                | Quelques autres fonctions utilitaires.
-|    wee-version.c                | Fonctions pour la version de WeeChat.
+|    core-version.c             | Fonctions pour la version de WeeChat.
-|    weechat.c                    | Fonctions principales : options de ligne de commande, démarrage.
+|    weechat.c                  | Fonctions principales : options de ligne de commande, démarrage.
-|    hook/                        | Fonctions "hook".
+|    hook/                      | Fonctions "hook".
-|       wee-hook-command-run.c    | Hook "command_run".
+|       hook-command-run.c      | Hook "command_run".
-|       wee-hook-command.c        | Hook "command".
+|       hook-command.c          | Hook "command".
-|       wee-hook-completion.c     | Hook "completion".
+|       hook-completion.c       | Hook "completion".
-|       wee-hook-config.c         | Hook "config".
+|       hook-config.c           | Hook "config".
-|       wee-hook-connect.c        | Hook "connect".
+|       hook-connect.c          | Hook "connect".
-|       wee-hook-fd.c             | Hook "fd".
+|       hook-fd.c               | Hook "fd".
-|       wee-hook-focus.c          | Hook "focus".
+|       hook-focus.c            | Hook "focus".
-|       wee-hook-hdata.c          | Hook "hdata".
+|       hook-hdata.c            | Hook "hdata".
-|       wee-hook-hsignal.c        | Hook "hsignal".
+|       hook-hsignal.c          | Hook "hsignal".
-|       wee-hook-info-hashtable.c | Hook "info".
+|       hook-info-hashtable.c   | Hook "info".
-|       wee-hook-info.c           | Hook "info".
+|       hook-info.c             | Hook "info".
-|       wee-hook-infolist.c       | Hook "infolist".
+|       hook-infolist.c         | Hook "infolist".
-|       wee-hook-line.c           | Hook "line".
+|       hook-line.c             | Hook "line".
-|       wee-hook-modifier.c       | Hook "modifier".
+|       hook-modifier.c         | Hook "modifier".
-|       wee-hook-print.c          | Hook "print".
+|       hook-print.c            | Hook "print".
-|       wee-hook-process.c        | Hook "process".
+|       hook-process.c          | Hook "process".
-|       wee-hook-signal.c         | Hook "signal".
+|       hook-signal.c           | Hook "signal".
-|       wee-hook-timer.c          | Hook "timer".
+|       hook-timer.c            | Hook "timer".
-|       wee-hook-url.c            | Hook "url".
+|       hook-url.c              | Hook "url".
-| gui/                            | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces).
+| gui/                          | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces).
-|    gui-bar-item.c               | Objets de barre.
+|    gui-bar-item.c             | Objets de barre.
-|    gui-bar-window.c             | Fenêtres de barre.
+|    gui-bar-window.c           | Fenêtres de barre.
-|    gui-bar.c                    | Barres.
+|    gui-bar.c                  | Barres.
-|    gui-buffer.c                 | Tampons.
+|    gui-buffer.c               | Tampons.
-|    gui-chat.c                   | Fonctions pour la discussion (afficher un message, ...).
+|    gui-chat.c                 | Fonctions pour la discussion (afficher un message, ...).
-|    gui-color.c                  | Fonctions de couleur.
+|    gui-color.c                | Fonctions de couleur.
-|    gui-completion.c             | Complétion sur la ligne de commande.
+|    gui-completion.c           | Complétion sur la ligne de commande.
-|    gui-cursor.c                 | Mode curseur (mouvement libre du curseur).
+|    gui-cursor.c               | Mode curseur (mouvement libre du curseur).
-|    gui-filter.c                 | Filtres.
+|    gui-filter.c               | Filtres.
-|    gui-focus.c                  | Fonctions concernant le focus (pour les modes curseur et souris).
+|    gui-focus.c                | Fonctions concernant le focus (pour les modes curseur et souris).
-|    gui-history.c                | Commandes/texte sauvés dans les tampons.
+|    gui-history.c              | Commandes/texte sauvés dans les tampons.
-|    gui-hotlist.c                | Gestion de la "hotlist" (liste des tampons avec activité).
+|    gui-hotlist.c              | Gestion de la "hotlist" (liste des tampons avec activité).
-|    gui-input.c                  | Fonctions d'entrée (barre "input").
+|    gui-input.c                | Fonctions d'entrée (barre "input").
-|    gui-key.c                    | Fonctions pour le clavier.
+|    gui-key.c                  | Fonctions pour le clavier.
-|    gui-layout.c                 | Dispositions ("layouts").
+|    gui-layout.c               | Dispositions ("layouts").
-|    gui-line.c                   | Lignes dans les tampons.
+|    gui-line.c                 | Lignes dans les tampons.
-|    gui-mouse.c                  | Souris.
+|    gui-mouse.c                | Souris.
-|    gui-nick.c                   | Fonctions pour les pseudos.
+|    gui-nick.c                 | Fonctions pour les pseudos.
-|    gui-nicklist.c               | Liste de pseudos dans les tampons.
+|    gui-nicklist.c             | Liste de pseudos dans les tampons.
-|    gui-window.c                 | Fenêtres.
+|    gui-window.c               | Fenêtres.
-|    curses/                      | Interface Curses.
+|    curses/                    | Interface Curses.
-|       gui-curses-bar-window.c   | Affichage dans les fenêtres de barre.
+|       gui-curses-bar-window.c | Affichage dans les fenêtres de barre.
-|       gui-curses-chat.c         | Affichage dans la zone de discussion (messages).
+|       gui-curses-chat.c       | Affichage dans la zone de discussion (messages).
-|       gui-curses-color.c        | Fonctions pour les couleurs.
+|       gui-curses-color.c      | Fonctions pour les couleurs.
-|       gui-curses-key.c          | Fonctions pour le clavier (touches par défaut, lecture du clavier).
+|       gui-curses-key.c        | Fonctions pour le clavier (touches par défaut, lecture du clavier).
-|       gui-curses-main.c         | Boucle principale de WeeChat (attente des évènements clavier/réseau).
+|       gui-curses-main.c       | Boucle principale de WeeChat (attente des évènements clavier/réseau).
-|       gui-curses-mouse.c        | Souris.
+|       gui-curses-mouse.c      | Souris.
-|       gui-curses-term.c         | Fonctions pour le terminal.
+|       gui-curses-term.c       | Fonctions pour le terminal.
-|       gui-curses-window.c       | Fenêtres.
+|       gui-curses-window.c     | Fenêtres.
-|       headless/                 | Mode sans interface (« headless »).
+|       headless/               | Mode sans interface (« headless »).
-|          main.c                 | Point d'entrée pour le mode sans interface.
+|          main.c               | Point d'entrée pour le mode sans interface.
-|          ncurses-fake.c         | Fausse bibliothèque ncurses.
+|          ncurses-fake.c       | Fausse bibliothèque ncurses.
-|       normal/                   | Interface Curses.
+|       normal/                 | Interface Curses.
-|          main.c                 | Point d'entrée pour l'interface Curses.
+|          main.c               | Point d'entrée pour l'interface Curses.
 |===
 
 [[sources_plugins]]
@@ -212,180 +212,189 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Chemin/fichier                    | Description
+| Chemin/fichier                     | Description
-| plugins/                          | Racine des extensions.
+| plugins/                           | Racine des extensions.
-|    plugin.c                       | Gestion des extensions (chargement/déchargement des bibliothèques C dynamiques).
+|    plugin.c                        | Gestion des extensions (chargement/déchargement des bibliothèques C dynamiques).
-|    plugin-api.c                   | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat).
+|    plugin-api.c                    | Fonctions supplémentaires pour l'API extension (enveloppes autour des fonctions du cœur de WeeChat).
-|    plugin-api-info.c              | Fonctions supplémentaires info/infolist pour l'API extension.
+|    plugin-api-info.c               | Fonctions supplémentaires info/infolist pour l'API extension.
-|    plugin-config.c                | Options de configuration des extensions (fichier plugins.conf).
+|    plugin-config.c                 | Options de configuration des extensions (fichier plugins.conf).
-|    plugin-script.c                | Fonctions communes utilisés par les extensions pour les scripts.
+|    plugin-script.c                 | Fonctions communes utilisés par les extensions pour les scripts.
-|    plugin-script-api.c            | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension.
+|    plugin-script-api.c             | Fonctions pour l'API script : enveloppes autour de quelques fonctions de l'API extension.
-|    plugin-script-config.c         | Options de configuration des extensions pour les scripts (fichiers python.conf, perl.conf, ...).
+|    plugin-script-config.c          | Options de configuration des extensions pour les scripts (fichiers python.conf, perl.conf, ...).
-|    weechat-plugin.h               | En-tête destiné à être distribué avec les extensions WeeChat, pour les compiler.
+|    weechat-plugin.h                | En-tête destiné à être distribué avec les extensions WeeChat, pour les compiler.
-|    alias/                         | Extension Alias.
+|    alias/                          | Extension Alias.
-|       alias.c                     | Fonctions principales pour les alias.
+|       alias.c                      | Fonctions principales pour les alias.
-|       alias-command.c             | Commandes Alias.
+|       alias-command.c              | Commandes Alias.
-|       alias-completion.c          | Complétions pour Alias.
+|       alias-completion.c           | Complétions pour Alias.
-|       alias-config.c              | Options de configuration des alias (fichier alias.conf).
+|       alias-config.c               | Options de configuration des alias (fichier alias.conf).
-|       alias-info.c                | Info/infolists/hdata pour les alias.
+|       alias-info.c                 | Info/infolists/hdata pour les alias.
-|    spell/                         | Extension Spell.
+|    spell/                          | Extension Spell.
-|       spell.c                     | Fonctions principales pour Spell.
+|       spell.c                      | Fonctions principales pour Spell.
-|       spell-bar-item.c            | Objets de barre Spell.
+|       spell-bar-item.c             | Objets de barre Spell.
-|       spell-command.c             | Commandes Spell.
+|       spell-command.c              | Commandes Spell.
-|       spell-completion.c          | Complétions pour Spell.
+|       spell-completion.c           | Complétions pour Spell.
-|       spell-config.c              | Options de configuration pour Spell (fichier spell.conf).
+|       spell-config.c               | Options de configuration pour Spell (fichier spell.conf).
-|       spell-info.c                | Info/infolists/hdata pour Spell.
+|       spell-info.c                 | Info/infolists/hdata pour Spell.
-|       spell-speller.c             | Gestion des correcteurs orthographiques.
+|       spell-speller.c              | Gestion des correcteurs orthographiques.
-|    buflist/                       | Extension Buflist.
+|    buflist/                        | Extension Buflist.
-|       buflist.c                   | Fonctions principales de Buflist.
+|       buflist.c                    | Fonctions principales de Buflist.
-|       buflist-bar-item.c          | Objets de barre Buflist.
+|       buflist-bar-item.c           | Objets de barre Buflist.
-|       buflist-command.c           | Commandes pour Buflist.
+|       buflist-command.c            | Commandes pour Buflist.
-|       buflist-completion.c        | Complétions pour Buflist.
+|       buflist-completion.c         | Complétions pour Buflist.
-|       buflist-config.c            | Options de configuration pour Buflist (fichier buflist.conf).
+|       buflist-config.c             | Options de configuration pour Buflist (fichier buflist.conf).
-|       buflist-info.c              | Info/infolists/hdata pour Buflist.
+|       buflist-info.c               | Info/infolists/hdata pour Buflist.
-|       buflist-mouse.c             | Actions souris pour Buflist.
+|       buflist-mouse.c              | Actions souris pour Buflist.
-|    charset/                       | Extension Charset.
+|    charset/                        | Extension Charset.
-|       charset.c                   | Fonctions pour Charset.
+|       charset.c                    | Fonctions pour Charset.
-|    exec/                          | Extension Exec.
+|    exec/                           | Extension Exec.
-|       exec.c                      | Fonctions principales de Exec.
+|       exec.c                       | Fonctions principales de Exec.
-|       exec-buffer.c               | Tampon Exec.
+|       exec-buffer.c                | Tampon Exec.
-|       exec-command.c              | Commandes pour Exec.
+|       exec-command.c               | Commandes pour Exec.
-|       exec-completion.c           | Complétions pour Exec.
+|       exec-completion.c            | Complétions pour Exec.
-|       exec-config.c               | Options de configuration pour Exec (fichier exec.conf).
+|       exec-config.c                | Options de configuration pour Exec (fichier exec.conf).
-|    fifo/                          | Extension Fifo.
+|    fifo/                           | Extension Fifo.
-|       fifo.c                      | Fonctions principales de Fifo.
+|       fifo.c                       | Fonctions principales de Fifo.
-|       fifo-command.c              | Commandes pour Fifo.
+|       fifo-command.c               | Commandes pour Fifo.
-|       fifo-config.c               | Options de configuration pour Fifo (fichier fifo.conf).
+|       fifo-config.c                | Options de configuration pour Fifo (fichier fifo.conf).
-|       fifo-info.c                 | Info/infolists/hdata pour Fifo.
+|       fifo-info.c                  | Info/infolists/hdata pour Fifo.
-|    fset/                          | Extension Fset.
+|    fset/                           | Extension Fset.
-|       fset.c                      | Fonctions principales de Fset.
+|       fset.c                       | Fonctions principales de Fset.
-|       fset-bar-item.c             | Objets de barre Fset.
+|       fset-bar-item.c              | Objets de barre Fset.
-|       fset-buffer.c               | Tampon Fset.
+|       fset-buffer.c                | Tampon Fset.
-|       fset-command.c              | Commandes pour Fset.
+|       fset-command.c               | Commandes pour Fset.
-|       fset-completion.c           | Complétions pour Fset.
+|       fset-completion.c            | Complétions pour Fset.
-|       fset-config.c               | Options de configuration pour Fset (fichier fset.conf).
+|       fset-config.c                | Options de configuration pour Fset (fichier fset.conf).
-|       fset-info.c                 | Info/infolists/hdata pour Fset.
+|       fset-info.c                  | Info/infolists/hdata pour Fset.
-|       fset-mouse.c                | Actions souris pour Fset.
+|       fset-mouse.c                 | Actions souris pour Fset.
-|       fset-option.c               | Gestion des options Fset.
+|       fset-option.c                | Gestion des options Fset.
-|    guile/                         | Extension Guile (scheme).
+|    guile/                          | Extension Guile (scheme).
-|       weechat-guile.c             | Fonctions principales pour Guile (chargement/déchargement des scripts, exécution de code Guile).
+|       weechat-guile.c              | Fonctions principales pour Guile (chargement/déchargement des scripts, exécution de code Guile).
-|       weechat-guile-api.c         | Fonctions de l'API script Guile.
+|       weechat-guile-api.c          | Fonctions de l'API script Guile.
-|    irc/                           | Extension IRC (Internet Relay Chat).
+|    irc/                            | Extension IRC (Internet Relay Chat).
-|       irc.c                       | Fonctions principales IRC.
+|       irc.c                        | Fonctions principales IRC.
-|       irc-bar-item.c              | Objets de barre IRC.
+|       irc-bar-item.c               | Objets de barre IRC.
-|       irc-batch.c                 | Évènements batch IRC.
+|       irc-batch.c                  | Évènements batch IRC.
-|       irc-buffer.c                | Tampons IRC.
+|       irc-buffer.c                 | Tampons IRC.
-|       irc-channel.c               | Canaux IRC.
+|       irc-channel.c                | Canaux IRC.
-|       irc-color.c                 | Couleurs IRC.
+|       irc-color.c                  | Couleurs IRC.
-|       irc-command.c               | Commandes IRC.
+|       irc-command.c                | Commandes IRC.
-|       irc-completion.c            | Complétions IRC.
+|       irc-completion.c             | Complétions IRC.
-|       irc-config.c                | Options de configuration IRC (fichier irc.conf).
+|       irc-config.c                 | Options de configuration IRC (fichier irc.conf).
-|       irc-ctcp.c                  | CTCP IRC.
+|       irc-ctcp.c                   | CTCP IRC.
-|       irc-debug.c                 | Fonctions de debug IRC.
+|       irc-debug.c                  | Fonctions de debug IRC.
-|       irc-ignore.c                | Ignore IRC.
+|       irc-ignore.c                 | Ignore IRC.
-|       irc-info.c                  | Info/infolists/hdata pour IRC.
+|       irc-info.c                   | Info/infolists/hdata pour IRC.
-|       irc-input.c                 | Entrée de commandes/texte.
+|       irc-input.c                  | Entrée de commandes/texte.
-|       irc-join.c                  | Fonctions pour les listes de canaux à rejoindre.
+|       irc-join.c                   | Fonctions pour les listes de canaux à rejoindre.
-|       irc-list.c                  | Tampon pour la réponse à la commande /list.
+|       irc-list.c                   | Tampon pour la réponse à la commande /list.
-|       irc-message.c               | Fonctions pour manipuler les messages IRC.
+|       irc-message.c                | Fonctions pour manipuler les messages IRC.
-|       irc-mode.c                  | Fonctions pour les modes de canal/pseudo.
+|       irc-mode.c                   | Fonctions pour les modes de canal/pseudo.
-|       irc-modelist.c              | Listes de modes de canaux IRC (+b, +e, +I, ...).
+|       irc-modelist.c               | Listes de modes de canaux IRC (+b, +e, +I, ...).
-|       irc-msgbuffer.c             | Tampon cible pour les messages IRC.
+|       irc-msgbuffer.c              | Tampon cible pour les messages IRC.
-|       irc-nick.c                  | Pseudos IRC.
+|       irc-nick.c                   | Pseudos IRC.
-|       irc-notify.c                | Listes de notification IRC.
+|       irc-notify.c                 | Listes de notification IRC.
-|       irc-protocol.c              | Protocole IRC (RFCs 1459/2810/2811/2812/2813/7194).
+|       irc-protocol.c               | Protocole IRC (RFCs 1459/2810/2811/2812/2813/7194).
-|       irc-raw.c                   | Tampon des données brutes IRC.
+|       irc-raw.c                    | Tampon des données brutes IRC.
-|       irc-redirect.c              | Redirection de la sortie des commandes IRC.
+|       irc-redirect.c               | Redirection de la sortie des commandes IRC.
-|       irc-sasl.c                  | Authentification SASL avec le serveur IRC.
+|       irc-sasl.c                   | Authentification SASL avec le serveur IRC.
-|       irc-server.c                | Communication avec le serveur IRC.
+|       irc-server.c                 | Communication avec le serveur IRC.
-|       irc-tag.c                   | Fonctions pour manipuler les étiquettes de message IRC.
+|       irc-tag.c                    | Fonctions pour manipuler les étiquettes de message IRC.
-|       irc-typing.c                | Statut d'écriture.
+|       irc-typing.c                 | Statut d'écriture.
-|       irc-upgrade.c               | Sauvegarde/restauration des données IRC lors de la mise à jour de WeeChat.
+|       irc-upgrade.c                | Sauvegarde/restauration des données IRC lors de la mise à jour de WeeChat.
-|    javascript/                    | Extension JavaScript.
+|    javascript/                     | Extension JavaScript.
-|       weechat-js.cpp              | Fonctions principales pour JavaScript (chargement/déchargement des scripts, exécution de code JavaScript).
+|       weechat-js.cpp               | Fonctions principales pour JavaScript (chargement/déchargement des scripts, exécution de code JavaScript).
-|       weechat-js-api.cpp          | Fonctions de l'API script JavaScript.
+|       weechat-js-api.cpp           | Fonctions de l'API script JavaScript.
-|       weechat-js-v8.cpp           | Fonctions JavaScript v8.
+|       weechat-js-v8.cpp            | Fonctions JavaScript v8.
-|    logger/                        | Extension Logger.
+|    logger/                         | Extension Logger.
-|       logger.c                    | Fonctions principales pour Logger.
+|       logger.c                     | Fonctions principales pour Logger.
-|       logger-backlog.c            | Fonctions de backlog pour Logger.
+|       logger-backlog.c             | Fonctions de backlog pour Logger.
-|       logger-buffer.c             | Gestion des listes de tampons pour Logger.
+|       logger-buffer.c              | Gestion des listes de tampons pour Logger.
-|       logger-command.c            | Commandes de Logger.
+|       logger-command.c             | Commandes de Logger.
-|       logger-config.c             | Options de configuration pour Logger (fichier logger.conf).
+|       logger-config.c              | Options de configuration pour Logger (fichier logger.conf).
-|       logger-info.c               | Info/infolists/hdata pour Logger.
+|       logger-info.c                | Info/infolists/hdata pour Logger.
-|       logger-tail.c               | Fonctions pour obtenir les dernières lignes d'un fichier.
+|       logger-tail.c                | Fonctions pour obtenir les dernières lignes d'un fichier.
-|    lua/                           | Extension Lua.
+|    lua/                            | Extension Lua.
-|       weechat-lua.c               | Fonctions principales pour Lua (chargement/déchargement des scripts, exécution de code Lua).
+|       weechat-lua.c                | Fonctions principales pour Lua (chargement/déchargement des scripts, exécution de code Lua).
-|       weechat-lua-api.c           | Fonctions de l'API script Lua.
+|       weechat-lua-api.c            | Fonctions de l'API script Lua.
-|    perl/                          | Extension Perl.
+|    perl/                           | Extension Perl.
-|       weechat-perl.c              | Fonctions principales pour Perl (chargement/déchargement des scripts, exécution de code Perl).
+|       weechat-perl.c               | Fonctions principales pour Perl (chargement/déchargement des scripts, exécution de code Perl).
-|       weechat-perl-api.c          | Fonctions de l'API script Perl.
+|       weechat-perl-api.c           | Fonctions de l'API script Perl.
-|    php/                           | Extension PHP.
+|    php/                            | Extension PHP.
-|       weechat-php.c               | Fonctions principales pour PHP (chargement/déchargement des scripts, exécution de code PHP).
+|       weechat-php.c                | Fonctions principales pour PHP (chargement/déchargement des scripts, exécution de code PHP).
-|       weechat-php-api.c           | Fonctions de l'API script PHP.
+|       weechat-php-api.c            | Fonctions de l'API script PHP.
-|    python/                        | Extension Python.
+|    python/                         | Extension Python.
-|       weechat-python.c            | Fonctions principales pour Python (chargement/déchargement des scripts, exécution de code Python).
+|       weechat-python.c             | Fonctions principales pour Python (chargement/déchargement des scripts, exécution de code Python).
-|       weechat-python-api.c        | Fonctions de l'API script Python.
+|       weechat-python-api.c         | Fonctions de l'API script Python.
-|    relay/                         | Extension Relay (proxy IRC et relai pour des interfaces distantes).
+|    relay/                          | Extension Relay (proxy IRC et relai pour des interfaces distantes).
-|       relay.c                     | Fonctions principales de Relay.
+|       relay.c                      | Fonctions principales de Relay.
-|       relay-auth.c                | Authentification des clients.
+|       relay-auth.c                 | Authentification des clients.
-|       relay-buffer.c              | Tampon Relay.
+|       relay-buffer.c               | Tampon Relay.
-|       relay-client.c              | Clients du relai.
+|       relay-client.c               | Clients du relai.
-|       relay-command.c             | Commandes de Relay.
+|       relay-command.c              | Commandes de Relay.
-|       relay-completion.c          | Complétions de Relay.
+|       relay-completion.c           | Complétions de Relay.
-|       relay-config.c              | Options de configuration pour Relay (fichier relay.conf).
+|       relay-config.c               | Options de configuration pour Relay (fichier relay.conf).
-|       relay-info.c                | Info/infolists/hdata pour Relay.
+|       relay-http.c                 | Fonctions HTTP.
-|       relay-network.c             | Fonctions de réseau pour Relay.
+|       relay-info.c                 | Info/infolists/hdata pour Relay.
-|       relay-raw.c                 | Tampon des données brutes de Relay.
+|       relay-network.c              | Fonctions de réseau pour Relay.
-|       relay-server.c              | Serveur Relay.
+|       relay-raw.c                  | Tampon des données brutes de Relay.
-|       relay-upgrade.c             | Sauvegarde/restauration des données Relay lors de la mise à jour de WeeChat.
+|       relay-remote.c               | Relai distant.
-|       relay-websocket.c           | Fonctions pour le serveur WebSocket (RFC 6455).
+|       relay-server.c               | Serveur Relay.
-|       irc/                        | Proxy IRC.
+|       relay-upgrade.c              | Sauvegarde/restauration des données Relay lors de la mise à jour de WeeChat.
-|          relay-irc.c              | Fonctions principales pour le proxy IRC.
+|       relay-websocket.c            | Fonctions pour le serveur WebSocket (RFC 6455).
-|       weechat/                    | Relai pour les interfaces distantes.
+|       api/                         | Relai pour les interfaces distantes (en utilisant une API REST HTTP).
-|          relay-weechat.c          | Relai pour les interfaces distantes (fonctions principales).
+|          relay-api.c               | Fonctions principales pour l'API REST HTTP.
-|          relay-weechat-msg.c      | Envoi de messages binaires aux clients.
+|          relay-api-msg.c           | Envoi de messages JSON aux clients.
-|          relay-weechat-nicklist.c | Fonctions pour la liste de pseudos.
+|          relay-api-protocol.c      | Protocole HTTP REST API.
-|          relay-weechat-protocol.c | Lecture des commandes des clients.
+|          remote/                   | Relai distant.
-|    ruby/                          | Extension Ruby.
+|             relay-remote-event.c   | Traitement des évènements reçus du relai distant.
-|       weechat-ruby.c              | Fonctions principales pour Ruby (chargement/déchargement des scripts, exécution de code Ruby).
+|             relay-remote-network.c | Fonctions réseau pour le relai distant.
-|       weechat-ruby-api.c          | Fonctions de l'API script Ruby.
+|       irc/                         | Proxy IRC.
-|    script/                        | Gestionnaire de scripts.
+|          relay-irc.c               | Fonctions principales pour le proxy IRC.
-|       script.c                    | Fonctions principales du gestionnaire de scripts.
+|       weechat/                     | Relai pour les interfaces distantes (en utilisant le protocole binaire "weechat").
-|       script-action.c             | Actions sur les scripts (chargement/déchargement, installation/suppression, ...).
+|          relay-weechat.c           | Relai pour les interfaces distantes (fonctions principales).
-|       script-buffer.c             | Tampon pour le gestionnaire de scripts.
+|          relay-weechat-msg.c       | Envoi de messages binaires aux clients.
-|       script-command.c            | Commandes pour le gestionnaire de scripts.
+|          relay-weechat-nicklist.c  | Fonctions pour la liste de pseudos.
-|       script-completion.c         | Complétions pour le gestionnaire de scripts.
+|          relay-weechat-protocol.c  | Lecture des commandes des clients.
-|       script-config.c             | Options de configuration pour le gestionnaire de scripts (fichier script.conf).
+|    ruby/                           | Extension Ruby.
-|       script-info.c               | Info/infolists/hdata pour le gestionnaire de scripts.
+|       weechat-ruby.c               | Fonctions principales pour Ruby (chargement/déchargement des scripts, exécution de code Ruby).
-|       script-mouse.c              | Actions souris pour le gestionnaire de scripts.
+|       weechat-ruby-api.c           | Fonctions de l'API script Ruby.
-|       script-repo.c               | Téléchargement et lecture du dépôt de scripts.
+|    script/                         | Gestionnaire de scripts.
-|    tcl/                           | Extension Tcl.
+|       script.c                     | Fonctions principales du gestionnaire de scripts.
-|       weechat-tcl.c               | Fonctions principales pour Tcl (chargement/déchargement des scripts, exécution de code Tcl).
+|       script-action.c              | Actions sur les scripts (chargement/déchargement, installation/suppression, ...).
-|       weechat-tcl-api.c           | Fonctions de l'API script Tcl.
+|       script-buffer.c              | Tampon pour le gestionnaire de scripts.
-|    trigger/                       | Extension Trigger.
+|       script-command.c             | Commandes pour le gestionnaire de scripts.
-|       trigger.c                   | Fonctions principales de Trigger.
+|       script-completion.c          | Complétions pour le gestionnaire de scripts.
-|       trigger-buffer.c            | Tampon Trigger.
+|       script-config.c              | Options de configuration pour le gestionnaire de scripts (fichier script.conf).
-|       trigger-callback.c          | Fonctions de rappel de Trigger.
+|       script-info.c                | Info/infolists/hdata pour le gestionnaire de scripts.
-|       trigger-command.c           | Commandes pour Trigger.
+|       script-mouse.c               | Actions souris pour le gestionnaire de scripts.
-|       trigger-completion.c        | Complétions pour Trigger.
+|       script-repo.c                | Téléchargement et lecture du dépôt de scripts.
-|       trigger-config.c            | Options de configuration pour Trigger (fichier trigger.conf).
+|    tcl/                            | Extension Tcl.
-|    typing/                        | Extension Typing.
+|       weechat-tcl.c                | Fonctions principales pour Tcl (chargement/déchargement des scripts, exécution de code Tcl).
-|       typing.c                    | Fonctions principales de Typing.
+|       weechat-tcl-api.c            | Fonctions de l'API script Tcl.
-|       typing-bar-item.c           | Objets de barre Typing.
+|    trigger/                        | Extension Trigger.
-|       typing-config.c             | Options de configuration pour Typing (fichier typing.conf).
+|       trigger.c                    | Fonctions principales de Trigger.
-|       typing-status.c             | Statut d'écriture de messages sur les tampons.
+|       trigger-buffer.c             | Tampon Trigger.
-|    xfer/                          | Extension Xfer (IRC DCC fichier/discussion).
+|       trigger-callback.c           | Fonctions de rappel de Trigger.
-|       xfer.c                      | Fonctions principales de Xfer.
+|       trigger-command.c            | Commandes pour Trigger.
-|       xfer-buffer.c               | Tampon Xfer.
+|       trigger-completion.c         | Complétions pour Trigger.
-|       xfer-chat.c                 | Discussion DCC.
+|       trigger-config.c             | Options de configuration pour Trigger (fichier trigger.conf).
-|       xfer-command.c              | Commandes pour Xfer.
+|    typing/                         | Extension Typing.
-|       xfer-completion.c           | Complétions pour Xfer.
+|       typing.c                     | Fonctions principales de Typing.
-|       xfer-config.c               | Options de configuration pour Xfer (fichier xfer.conf).
+|       typing-bar-item.c            | Objets de barre Typing.
-|       xfer-dcc.c                  | Transfert de fichier par DCC.
+|       typing-config.c              | Options de configuration pour Typing (fichier typing.conf).
-|       xfer-file.c                 | Fonctions pour les fichiers dans Xfer.
+|       typing-status.c              | Statut d'écriture de messages sur les tampons.
-|       xfer-info.c                 | Info/infolists/hdata pour Xfer.
+|    xfer/                           | Extension Xfer (IRC DCC fichier/discussion).
-|       xfer-network.c              | Fonctions réseau pour Xfer.
+|       xfer.c                       | Fonctions principales de Xfer.
-|       xfer-upgrade.c              | Sauvegarde/restauration des données Xfer lors de la mise à jour de WeeChat.
+|       xfer-buffer.c                | Tampon Xfer.
+|       xfer-chat.c                  | Discussion DCC.
+|       xfer-command.c               | Commandes pour Xfer.
+|       xfer-completion.c            | Complétions pour Xfer.
+|       xfer-config.c                | Options de configuration pour Xfer (fichier xfer.conf).
+|       xfer-dcc.c                   | Transfert de fichier par DCC.
+|       xfer-file.c                  | Fonctions pour les fichiers dans Xfer.
+|       xfer-info.c                  | Info/infolists/hdata pour Xfer.
+|       xfer-network.c               | Fonctions réseau pour Xfer.
+|       xfer-upgrade.c               | Sauvegarde/restauration des données Xfer lors de la mise à jour de WeeChat.
 |===
 
 [[sources_tests]]
@@ -393,89 +402,120 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
 
 [width="100%",cols="2m,3",options="header"]
 |===
-| Chemin/fichier                      | Description
+| Chemin/fichier                             | Description
-| tests/                              | Racine des tests.
+| tests/                                     | Racine des tests.
-|    tests.cpp                        | Programme utilisé pour lancer tous les tests.
+|    tests.cpp                               | Programme utilisé pour lancer tous les tests.
-|    tests-record.cpp                 | Enregistrement et recherche dans les messages affichés.
+|    tests-record.cpp                        | Enregistrement et recherche dans les messages affichés.
-|    scripts/                         | Racine des tests de l'API script.
+|    scripts/                                | Racine des tests de l'API script.
-|       test-scripts.cpp              | Programme utilisé pour lancer les tests de l'API script.
+|       test-scripts.cpp                     | Programme utilisé pour lancer les tests de l'API script.
-|       python/                       | Scripts Python pour générer et lancer les tests de l'API script.
+|       python/                              | Scripts Python pour générer et lancer les tests de l'API script.
-|          testapigen.py              | Script Python générant des scripts dans tous les languages pour tester l'API script.
+|          testapigen.py                     | Script Python générant des scripts dans tous les languages pour tester l'API script.
-|          testapi.py                 | Script Python avec les tests API, utilisé par le script testapigen.py.
+|          testapi.py                        | Script Python avec les tests API, utilisé par le script testapigen.py.
-|          unparse.py                 | Conversion de code Python vers d'autres langages, utilisé par le script testapigen.py.
+|          unparse.py                        | Conversion de code Python vers d'autres langages, utilisé par le script testapigen.py.
-|    unit/                            | Racine des tests unitaires.
+|    unit/                                   | Racine des tests unitaires.
-|       test-plugins.cpp              | Tests : extensions.
+|       test-plugins.cpp                     | Tests : extensions.
-|       test-plugin-api-info.cpp      | Tests : fonctions info de l'API extension.
+|       test-plugin-api-info.cpp             | Tests : fonctions info de l'API extension.
-|       test-plugin-config.cpp        | Tests : fonctions config de l'extension.
+|       test-plugin-config.cpp               | Tests : fonctions config de l'extension.
-|       core/                         | Racine des tests unitaires pour le cœur.
+|       core/                                | Racine des tests unitaires pour le cœur.
-|          test-core-arraylist.cpp    | Tests : listes avec tableau (« arraylists »).
+|          test-core-arraylist.cpp           | Tests : listes avec tableau (« arraylists »).
-|          test-core-calc.cpp         | Tests : calcul d'expressions.
+|          test-core-calc.cpp                | Tests : calcul d'expressions.
-|          test-core-command.cpp      | Tests : commandes.
+|          test-core-command.cpp             | Tests : commandes.
-|          test-core-config-file.cpp  | Tests : fichiers de configuration.
+|          test-core-config-file.cpp         | Tests : fichiers de configuration.
-|          test-core-crypto.cpp       | Tests : fonctions cryptographiques.
+|          test-core-crypto.cpp              | Tests : fonctions cryptographiques.
-|          test-core-dir.cpp          | Tests : répertoires/fichiers.
+|          test-core-dir.cpp                 | Tests : répertoires/fichiers.
-|          test-core-eval.cpp         | Tests : évaluation d'expressions.
+|          test-core-eval.cpp                | Tests : évaluation d'expressions.
-|          test-core-hashtble.cpp     | Tests : tables de hachage.
+|          test-core-hashtble.cpp            | Tests : tables de hachage.
-|          test-core-hdata.cpp        | Tests : hdata.
+|          test-core-hdata.cpp               | Tests : hdata.
-|          test-core-hook.cpp         | Tests : hooks.
+|          test-core-hook.cpp                | Tests : hooks.
-|          test-core-infolist.cpp     | Tests : infolists.
+|          test-core-infolist.cpp            | Tests : infolists.
-|          test-core-list.cpp         | Tests : listes.
+|          test-core-list.cpp                | Tests : listes.
-|          test-core-network.cpp      | Tests : fonctions réseau.
+|          test-core-network.cpp             | Tests : fonctions réseau.
-|          test-core-secure.cpp       | Tests : données sécurisées.
+|          test-core-secure.cpp              | Tests : données sécurisées.
-|          test-core-signal.cpp       | Tests : signaux.
+|          test-core-signal.cpp              | Tests : signaux.
-|          test-core-string.cpp       | Tests : chaînes.
+|          test-core-string.cpp              | Tests : chaînes.
-|          test-core-url.cpp          | Tests : URLs.
+|          test-core-url.cpp                 | Tests : URLs.
-|          test-core-utf8.cpp         | Tests : UTF-8.
+|          test-core-utf8.cpp                | Tests : UTF-8.
-|          test-core-util.cpp         | Tests : fonctions utiles.
+|          test-core-util.cpp                | Tests : fonctions utiles.
-|          test-core-sys.cpp          | Tests : fonctions système.
+|          test-core-sys.cpp                 | Tests : fonctions système.
-|          hook/                      | Racine des tests pour les hooks.
+|          hook/                             | Racine des tests pour les hooks.
-|             test-hook-command.cpp   | Tests : hooks "command".
+|             test-hook-command.cpp          | Tests : hooks "command".
-|       gui/                          | Racine des tests unitaires pour les interfaces.
+|             test-hook-command-run.cpp      | Tests: hooks "command_run".
-|          test-gui-bar-window.cpp    | Tests : fonctions de fenêtres de barre.
+|             test-hook-completion.cpp       | Tests: hooks "completion".
-|          test-gui-buffer.cpp        | Tests : fonctions de tampons.
+|             test-hook-config.cpp           | Tests: hooks "config".
-|          test-gui-chat.cpp          | Tests : fonctions de discussion.
+|             test-hook-connect.cpp          | Tests: hooks "connect".
-|          test-gui-color.cpp         | Tests : couleurs.
+|             test-hook-fd.cpp               | Tests: hooks "fd".
-|          test-gui-filter.cpp        | Tests : filtres.
+|             test-hook-focus.cpp            | Tests: hooks "focus".
-|          test-gui-input.cpp         | Tests : fonctions d'entrée.
+|             test-hook-hdata.cpp            | Tests: hooks "hdata".
-|          test-gui-key.cpp           | Tests : touches.
+|             test-hook-hsignal.cpp          | Tests: hooks "hsignal".
-|          test-gui-line.cpp          | Tests : lignes.
+|             test-hook-info-hashtable.cpp   | Tests: hooks "info_hashtable".
-|          test-gui-nick.cpp          | Tests : pseudos.
+|             test-hook-info.cpp             | Tests: hooks "info".
-|       plugins/                      | Racine des tests unitaires pour les extensions.
+|             test-hook-infolist.cpp         | Tests: hooks "infolist".
-|          irc/                       | Racine des tests unitaires pour l'extension IRC.
+|             test-hook-line.cpp             | Tests: hooks "line".
-|             test-irc-batch.cpp      | Tests : évènements batch IRC.
+|             test-hook-modifier.cpp         | Tests : hooks "modifier".
-|             test-irc-buffer.cpp     | Tests : tampons IRC.
+|             test-hook-print.cpp            | Tests: hooks "print".
-|             test-irc-channel.cpp    | Tests : canaux IRC.
+|             test-hook-process.cpp          | Tests: hooks "process".
-|             test-irc-color.cpp      | Tests : couleurs IRC.
+|             test-hook-signal.cpp           | Tests: hooks "signal".
-|             test-irc-config.cpp     | Tests : configuration IRC.
+|             test-hook-timer.cpp            | Tests: hooks "timer".
-|             test-irc-ctcp.cpp       | Tests : CTCP IRC.
+|             test-hook-url.cpp              | Tests: hooks "url".
-|             test-irc-ignore.cpp     | Tests : ignores IRC.
+|       gui/                                 | Racine des tests unitaires pour les interfaces.
-|             test-irc-info.cpp       | Tests : infos IRC.
+|          test-gui-bar-window.cpp           | Tests : fonctions de fenêtres de barre.
-|             test-irc-join.cpp       | Tests : fonctions de join IRC.
+|          test-gui-buffer.cpp               | Tests : fonctions de tampons.
-|             test-irc-list.cpp       | Tests : tampon IRC pour la réponse à la commande /list.
+|          test-gui-chat.cpp                 | Tests : fonctions de discussion.
-|             test-irc-message.cpp    | Tests : messages IRC.
+|          test-gui-color.cpp                | Tests : couleurs.
-|             test-irc-mode.cpp       | Tests : modes IRC.
+|          test-gui-filter.cpp               | Tests : filtres.
-|             test-irc-nick.cpp       | Tests : pseudos IRC.
+|          test-gui-hotlist.cpp              | Tests : fonctions hotlist.
-|             test-irc-protocol.cpp   | Tests : protocole IRC.
+|          test-gui-input.cpp                | Tests : fonctions d'entrée.
-|             test-irc-sasl.cpp       | Tests : authentification SASL avec le protocole IRC.
+|          test-gui-key.cpp                  | Tests : touches.
-|             test-irc-server.cpp     | Tests : serveur IRC.
+|          test-gui-line.cpp                 | Tests : lignes.
-|             test-irc-tag.cpp        | Tests : étiquettes des messages IRC.
+|          test-gui-nick.cpp                 | Tests : pseudos.
-|          logger/                    | Racine des tests unitaires pour l'extension logger.
+|          test-gui-nicklist.cpp             | Tests : fonctions de liste de pseudos.
-|             test-logger.cpp         | Tests : logger.
+|          curses/                           | Racine des tests unitaires pour l'interface Curses.
-|             test-logger-backlog.cpp | Tests : backlog logger.
+|             test-gui-curses-mouse.cpp      | Tests : souris (interface Curses).
-|             test-logger-tail.cpp    | Tests : fonctions "tail".
+|       plugins/                             | Racine des tests unitaires pour les extensions.
-|          trigger/                   | Racine des tests unitaires pour l'extension trigger.
+|          irc/                              | Racine des tests unitaires pour l'extension IRC.
-|             test-trigger.cpp        | Tests : triggers.
+|             test-irc-batch.cpp             | Tests : évènements batch IRC.
-|             test-trigger-config.cpp | Tests : configuration trigger.
+|             test-irc-buffer.cpp            | Tests : tampons IRC.
-|          typing/                    | Racine des tests unitaires pour l'extension typing.
+|             test-irc-channel.cpp           | Tests : canaux IRC.
-|             test-typing.cpp         | Tests : typing.
+|             test-irc-color.cpp             | Tests : couleurs IRC.
-|             test-typing-status.cpp  | Tests : statut d'écriture.
+|             test-irc-command.cpp           | Tests : commandes IRC.
-|          relay/                     | Racine des tests unitaires pour l'extension Relay.
+|             test-irc-config.cpp            | Tests : configuration IRC.
-|             test-relay-auth.cpp     | Tests : authentification des clients.
+|             test-irc-ctcp.cpp              | Tests : CTCP IRC.
-|             irc/                    | Racine des tests unitaires pour le protocole relay "irc".
+|             test-irc-ignore.cpp            | Tests : ignores IRC.
-|                test-relay-irc.cpp   | Tests : Protocole relay "irc".
+|             test-irc-info.cpp              | Tests : infos IRC.
-|          xfer/                      | Racine des tests unitaires pour l'extension Xfer.
+|             test-irc-join.cpp              | Tests : fonctions de join IRC.
-|             test-xfer-file.cpp      | Tests : fonctions sur les fichiers.
+|             test-irc-list.cpp              | Tests : tampon IRC pour la réponse à la commande /list.
-|             test-xfer-network.cpp   | Tests : fonctions réseau.
+|             test-irc-message.cpp           | Tests : messages IRC.
+|             test-irc-mode.cpp              | Tests : modes IRC.
+|             test-irc-nick.cpp              | Tests : pseudos IRC.
+|             test-irc-protocol.cpp          | Tests : protocole IRC.
+|             test-irc-sasl.cpp              | Tests : authentification SASL avec le protocole IRC.
+|             test-irc-server.cpp            | Tests : serveur IRC.
+|             test-irc-tag.cpp               | Tests : étiquettes des messages IRC.
+|          logger/                           | Racine des tests unitaires pour l'extension logger.
+|             test-logger.cpp                | Tests : logger.
+|             test-logger-backlog.cpp        | Tests : backlog logger.
+|             test-logger-tail.cpp           | Tests : fonctions "tail".
+|          trigger/                          | Racine des tests unitaires pour l'extension trigger.
+|             test-trigger.cpp               | Tests : triggers.
+|             test-trigger-config.cpp        | Tests : configuration trigger.
+|          typing/                           | Racine des tests unitaires pour l'extension typing.
+|             test-typing.cpp                | Tests : typing.
+|             test-typing-status.cpp         | Tests : statut d'écriture.
+|          relay/                            | Racine des tests unitaires pour l'extension Relay.
+|             test-relay-auth.cpp            | Tests : authentification des clients.
+|             test-relay-http.cpp            | Tests : fonctions HTTP pour l'extension Relay.
+|             test-relay-raw.cpp             | Tests : fonctions sur les messages bruts pour l'extension Relay.
+|             test-relay-remote.cpp          | Tests : fonctions remote pour l'extension Relay.
+|             test-relay-websocket.cpp       | Tests : fonctions websocket pour l'extension Relay.
+|             api/                           | Racine des tests unitaires pour le protocole relay "api".
+|                test-relay-api.cpp          | Tests : protocole relay "api" : fonctions générales.
+|                test-relay-api-msg.cpp      | Tests : protocole relay "api" : messages.
+|                test-relay-api-protocol.cpp | Tests : protocole relay "api" : protocole.
+|             irc/                           | Racine des tests unitaires pour le protocole relay "irc".
+|                test-relay-irc.cpp          | Tests : protocole relay "irc".
+|          xfer/                             | Racine des tests unitaires pour l'extension Xfer.
+|             test-xfer-file.cpp             | Tests : fonctions sur les fichiers.
+|             test-xfer-network.cpp          | Tests : fonctions réseau.
 |===
 
 [[documentation_translations]]
@@ -494,7 +534,8 @@ Fichiers de documentation :
 |       weechat_faq.XX.adoc                     | link:weechat_faq.fr.html[FAQ ^↗^^] (questions fréquemment posées).
 |       weechat_plugin_api.XX.adoc              | link:weechat_plugin_api.fr.html[Référence API extension ^↗^^].
 |       weechat_quickstart.XX.adoc              | link:weechat_quickstart.fr.html[Guide de démarrage ^↗^^].
-|       weechat_relay_protocol.XX.adoc          | link:weechat_relay_protocol.fr.html[Protocole Relay ^↗^^] (pour les interfaces distantes).
+|       weechat_relay_api.XX.adoc               | link:weechat_relay_api.fr.html[Protocole relay "api" ^↗^^] (pour les interfaces distantes).
+|       weechat_relay_weechat.XX.adoc           | link:weechat_relay_weechat.fr.html[Protocole relay "weechat" ^↗^^] (pour les interfaces distantes).
 |       weechat_scripting.XX.adoc               | link:weechat_scripting.fr.html[Guide pour scripts ^↗^^].
 |       weechat_user.XX.adoc                    | link:weechat_user.fr.html[Guide utilisateur ^↗^^].
 |       includes/                               | Fichiers inclus dans la documentation.
@@ -559,8 +600,7 @@ Exemple en C :
 
 Quelques règles basiques que vous *devez* suivre quand vous écrivez du code C :
 
-* Utilisez 4 espaces pour l'indentation. N'utilisez pas de tabulations, c'est le
+* Utilisez 4 espaces pour l'indentation (pas de tabulations).
-  mal.
 * Essayez de ne pas dépasser 80 caractères par ligne, sauf si cela est
   nécessaire pour améliorer la lisibilité.
 * Utilisez les commentaires `+/* comment */+` (pas de style C99 comme
@@ -782,7 +822,7 @@ Exemples :
 [width="100%",cols="2m,3",options="header"]
 |===
 | Répertoire          | Fichiers
-| src/core/           | weechat.c, wee-backtrace.c, wee-command.c, ...
+| src/core/           | weechat.c, core-backtrace.c, core-command.c, ...
 | src/gui/            | gui-bar.c, gui-bar-item.c, gui-bar-window.c, ...
 | src/gui/curses/     | gui-curses-bar.c, gui-curses-bar-window.c, gui-curses-chat.c, ...
 | src/plugins/        | plugin.c, plugin-api.c, plugin-api-info.c, plugin-config.c, plugin-script.c, ...
@@ -791,7 +831,7 @@ Exemples :
 |===
 
 Les en-têtes des fichiers C doivent avoir le même nom que le fichier, par
-exemple _wee-command.h_ pour le fichier _wee-command.c_.
+exemple _core-command.h_ pour le fichier _core-command.c_.
 
 [[naming_convention_structures]]
 ==== Structures
@@ -1152,7 +1192,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
 Le dépôt Git est sur https://github.com/weechat/weechat[GitHub ^↗^^].
 
 Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la
-branche master, le format préféré étant une "pull request" sur GitHub. Un patch
+branche `main`, le format préféré étant une "pull request" sur GitHub. Un patch
 peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`).
 
 Le format du message de commit est le suivant (avec fermeture automatique
@@ -1169,15 +1209,15 @@ Où _composant_ est :
 | Composant | Fichiers | Description
 
 | core
-| AUTHORS.adoc +
+| AUTHORS.md +
-  ChangeLog.adoc +
+  CHANGELOG.md +
-  Contributing.adoc +
+  CONTRIBUTING.md +
   .github/FUNDING.yml +
   .github/ISSUE_TEMPLATE/* +
   icons/* +
   po/* +
-  README.adoc +
+  README.md +
-  ReleaseNotes.adoc +
+  UPGRADING.md +
   src/core/* +
   src/gui/* +
   version.sh +
@@ -1234,8 +1274,9 @@ Où _composant_ est :
 | Référence extension API
 
 | doc/relay
-| doc/xx/weechat_relay_protocol.xx.adoc
+| doc/xx/weechat_relay_api.xx.adoc +
-| Protocole relay
+  doc/xx/weechat_relay_weechat.xx.adoc
+| Protocoles relay
 
 | doc/dev
 | doc/xx/weechat_dev.en.adoc
@@ -1279,9 +1320,10 @@ Si vous souhaitez initialiser une nouvelle langue, utilisez la commande
 `msginit`. Par exemple pour créer un fichier qui est prêt à traduire en
 néerlandais :
 
+[source,shell]
 ----
-$ cd po
+cd po
-$ msginit -i weechat.pot -l nl_NL -o nl.po
+msginit -i weechat.pot -l nl_NL -o nl.po
 ----
 
 La langue de base pour WeeChat est l'anglais, donc vous devez évidemment
@@ -1290,8 +1332,9 @@ comprendre parfaitement l'anglais pour traduire vers votre langue.
 Après des changements dans les sources, vous pouvez regénérer toutes les
 traductions : lancez cette commande dans le répertoire "build" de CMake :
 
+[source,shell]
 ----
-$ make translations && make update-po
+make translations && make update-po
 ----
 
 Vous pouvez alors éditer les fichiers .po (si vous pouvez traduire dans une
@@ -1300,8 +1343,9 @@ langue).
 Une fois terminé, vous *devez* vérifier votre fichier avec
 https://github.com/flashcode/msgcheck[msgcheck ^↗^^] :
 
+[source,shell]
 ----
-$ msgcheck.py xx.po
+msgcheck.py xx.po
 ----
 
 Et vous pouvez alors recompiler WeeChat pour utiliser les nouvelles traductions.

doc/fr/weechat_faq.fr.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 == Général
 
@@ -50,12 +50,14 @@ Si vous avez toujours des problèmes, merci de les remonter aux développeurs.
 Il est recommandé d'utiliser https://brew.sh/[Homebrew ^↗^^],
 vous pouvez avoir de l'aide avec :
 
+[source,shell]
 ----
 brew info weechat
 ----
 
 Vous pouvez installer WeeChat avec cette commande :
 
+[source,shell]
 ----
 brew install weechat
 ----
@@ -324,11 +326,15 @@ Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
 rxvt-unicode, konsole, gnome-terminal, etc.). La touche est habituellement
 kbd:[Ctrl] + kbd:[Alt] + sélection à la souris.
 
+Vous pouvez afficher/cacher la liste des pesudos et la rendre visible seulement
+lorsque c'est nécessaire, avec la touche kbd:[Alt+Shift+N].
+
 Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par
 exemple :
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 [[urls]]
@@ -338,10 +344,14 @@ Vous pouvez utiliser l'affichage dépouillé (touche par défaut : kbd:[Alt+l]
 
 Pour rendre le clic d'URL plus facile, vous pouvez :
 
+* afficher/cacher la liste des pseudos et la rendre visible seulement lorsque
+  c'est nécessaire, avec la touche kbd:[Alt+Shift+N]
+
 * déplacer la liste des pseudos en haut :
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 * désactiver l'alignement pour les mots sur plusieurs lignes :
@@ -393,6 +403,7 @@ d'environnement `TZ` doit être positionnée à la valeur appropriée.
 Dans votre fichier d'initialisation du shell ou sur la ligne de commande, avant
 de démarrer WeeChat :
 
+[source,shell]
 ----
 export TZ=Europe/Paris
 ----
@@ -704,8 +715,9 @@ Selon le terminfo utilisé, la souris peut ne pas être supportée.
 
 Vous pouvez tester le support de la souris dans le terminal :
 
+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----
 
 Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez
@@ -713,8 +725,9 @@ voir " !!#!!".
 
 Pour désactiver la souris dans le terminal :
 
+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----
 
 [[mouse_coords]]
@@ -772,7 +785,7 @@ Vous pouvez essayer une chaîne de priorité différente, remplacez "xxx" par
 le nom de votre serveur :
 
 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----
 
 [[irc_tls_libera]]
@@ -1035,8 +1048,9 @@ Consultez d'abord les questions à propos des connexions TLS dans cette FAQ.
 Si cela ne fonctionne toujours pas, essayez de supprimer manuellement le fichier
 avec les scripts (dans votre shell) :
 
+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
 [NOTE]
@@ -1062,15 +1076,17 @@ vous-même pour obtenir les mises à jour) :
 
 * dans votre shell, avec curl installé :
 
+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
+cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
 Si vous êtes sous macOS et que le fichier téléchargé a une taille de 0 octet,
 essayez de définir cette variable dans votre fichier d'initialisation du shell
 ou sur la ligne de commande, avant de démarrer WeeChat :
 
+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1252,6 +1268,7 @@ Voir https://weechat.org/about/support/[cette page ^↗^^].
 
 Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur :
 
+[source,shell]
 ----
 $ gdb /path/to/weechat
 (gdb) run
@@ -1262,6 +1279,7 @@ Cannot find new threads: generic error
 Pour corriger ça, vous pouvez lancer gdb avec cette commande (remplacez le
 chemin vers libpthread et WeeChat avec les chemins sur votre système) :
 
+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
 (gdb) run

doc/fr/weechat_quickstart.fr.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 [[start]]
 == Démarrer WeeChat
@@ -13,8 +13,9 @@ touches par défaut.
 
 Lancer depuis votre shell :
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 [[help]]

doc/fr/weechat_relay_weechat.fr.adoc

@@ -2,12 +2,12 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 [[introduction]]
 == Introduction
 
-Ce document est une spécification du protocole Relay de WeeChat : le protocole
+Ce document est une spécification du protocole relay _weechat_ : le protocole
 utilisé pour relayer les données de WeeChat aux clients, qui sont surtout des
 interfaces distantes.
 
@@ -27,28 +27,11 @@ Les termes suivants sont utilisés dans ce document :
 
 Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous :
 
-....
+include::includes/relay.fr.adoc[tag=diagram]
-                                              ┌──────────┐ Station de travail
- ┌────────┐                               ┌───┤ client 1 │ (Linux, Windows,
- │  irc   │◄──┐  ╔═══════════╤═══════╗    │   └──────────┘ BSD, macOS ...)
- └────────┘   └──╢           │       ║◄───┘   ┌──────────┐
-   ......        ║  WeeChat  │ Relay ║◄───────┤ client 2 │ Appareil mobile
- ┌────────┐   ┌──╢           │       ║◄───┐   └──────────┘ (Android, iPhone ...)
- │ jabber │◄──┘  ╚═══════════╧═══════╝    │      ......
- └────────┘                               │   ┌──────────┐
-   ......                                 └───┤ client N │ Autres appareils
-                                              └──────────┘
-
-
-└────────────┘   └───────────────────┘╘══════╛└────────────────────────────────┘
-   serveurs        interface ncurses  protocole      interfaces distantes
-                                        relay
-....
 
 [NOTE]
 Tous les clients ici utilisent le protocole _weechat_ dans l'extension _relay_.
-L'extension _relay_ autorise aussi des clients IRC, et _relay_ agit alors comme
+L'extension _relay_ autorise aussi les protocoles _api_ et _irc_ (non décrits dans ce document).
-un _proxy IRC_ (non décrit dans ce document).
 
 [[protocol_generalities]]
 == Généralités sur le protocole
@@ -723,6 +706,7 @@ inl:
         nicklist_visible_count: 0
         title: 'WeeChat 2.9-dev (C) 2003-2020 - https://weechat.org/'
         input: 1
+        input_get_any_user_data: 0
         input_get_unknown_commands: 0
         input_get_empty: 0
         input_multiline: 0
@@ -1530,6 +1514,9 @@ Les identifiants réservés par WeeChat :
 | _buffer_line_added | buffer | hdata : line
 | Ligne ajoutée dans le tampon. | Afficher la ligne dans le tampon.
 
+| _buffer_line_data_changed | buffer | hdata : line
+| Ligne changée dans le tampon. | Modifier la ligne affichée dans le tampon.
+
 | _nicklist | nicklist | hdata : nicklist_item
 | Liste de pseudos pour un tampon. | Remplacer la liste de pseudos.
 
@@ -2086,6 +2073,7 @@ Données envoyées dans le hdata :
 |===
 | Nom               | Type               | Description
 | buffer            | pointeur           | Pointeur vers le tampon.
+| id                | entier             | Identifiant de ligne.
 | date              | date/heure         | Date du message.
 | date_usec         | entier             | Microsecondes de la date.
 | date_printed      | date/heure         | Date d'affichage du message.
@@ -2107,6 +2095,7 @@ id: '_buffer_line_added'
 hda:
     keys: {
         'buffer': 'ptr',
+        'id': 'int',
         'date': 'tim',
         'date_usec': 'int',
         'date_printed': 'tim',
@@ -2122,6 +2111,59 @@ hda:
     item 1:
         __path: ['0x4a49600']
         buffer: '0x4a715d0'
+        id: 12
+        date: 1362728993
+        date_usec: 902765
+        date_printed: 1362728993
+        date_usec_printed: 902765
+        displayed: 1
+        notify_level: 1
+        highlight: 0
+        tags_array: [
+            'irc_privmsg',
+            'notify_message',
+            'prefix_nick_142',
+            'nick_FlashCode',
+            'log1',
+        ]
+        prefix: 'F06@F@00142FlashCode'
+        message: 'hello!'
+----
+
+[[message_buffer_line_data_changed]]
+==== _buffer_line_data_changed
+
+Ce message est envoyé au client lorsque le signal "buffer_line_data_changed"
+est envoyé par WeeChat.
+
+Données envoyées dans le hdata : mêmes données que pour
+<<message_buffer_line_added,_buffer_line_added>>.
+
+Exemple : le message _hello!_ du pseudo _FlashCode_ sur le tampon _irc.libera.#weechat_ a été mis à jour :
+
+[source,python]
+----
+id: '_buffer_line_data_changed'
+hda:
+    keys: {
+        'buffer': 'ptr',
+        'id': 'int',
+        'date': 'tim',
+        'date_usec': 'int',
+        'date_printed': 'tim',
+        'date_usec_printed': 'int',
+        'displayed': 'chr',
+        'notify_level': 'chr',
+        'highlight': 'chr',
+        'tags_array': 'arr',
+        'prefix': 'str',
+        'message': 'str',
+    }
+    path: ['line_data']
+    item 1:
+        __path: ['0x4a49600']
+        buffer: '0x4a715d0'
+        id: 12
         date: 1362728993
         date_usec: 902765
         date_printed: 1362728993

doc/fr/weechat_scripting.fr.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 Ce manuel documente le client de messagerie instantanée WeeChat, il fait
 partie de WeeChat.
@@ -73,7 +73,7 @@ link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat
 
 WeeChat définit un module `weechat` qui doit être importé avec `import weechat`. +
 Un "stub" Python pour l'API WeeChat est disponible dans le dépôt :
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
+https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
 
 [[python_functions]]
 ===== Fonctions
@@ -376,9 +376,10 @@ automatiquement le script quand WeeChat démarre.
 
 Par exemple en Python :
 
+[source,shell]
 ----
-$ cd ~/.local/share/weechat/python/autoload
+cd ~/.local/share/weechat/python/autoload
-$ ln -s ../script.py
+ln -s ../script.py
 ----
 
 [NOTE]
@@ -570,318 +571,14 @@ link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^].
 
 Liste des fonctions de l'API script :
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_functions.fr.adoc[tag=functions]
-|===
-| Catégorie | Fonctions
-
-| général
-| register
-
-| extensions
-| plugin_get_name
-
-| chaînes
-| charset_set +
-  iconv_to_internal +
-  iconv_from_internal +
-  gettext +
-  ngettext +
-  strlen_screen +
-  string_match +
-  string_match_list +
-  string_has_highlight +
-  string_has_highlight_regex +
-  string_mask_to_regex +
-  string_format_size +
-  string_parse_size +
-  string_color_code_size +
-  string_remove_color +
-  string_is_command_char +
-  string_input_for_buffer +
-  string_eval_expression +
-  string_eval_path_home
-
-| répertoires
-| mkdir_home +
-  mkdir +
-  mkdir_parents
-
-| listes triées
-| list_new +
-  list_add +
-  list_search +
-  list_search_pos +
-  list_casesearch +
-  list_casesearch_pos +
-  list_get +
-  list_set +
-  list_next +
-  list_prev +
-  list_string +
-  list_size +
-  list_remove +
-  list_remove_all +
-  list_free
-
-| fichiers de configuration
-| config_new +
-  config_new_section +
-  config_search_section +
-  config_new_option +
-  config_search_option +
-  config_string_to_boolean +
-  config_option_reset +
-  config_option_set +
-  config_option_set_null +
-  config_option_unset +
-  config_option_rename +
-  config_option_is_null +
-  config_option_default_is_null +
-  config_boolean +
-  config_boolean_default +
-  config_integer +
-  config_integer_default +
-  config_string +
-  config_string_default +
-  config_color +
-  config_color_default +
-  config_write_option +
-  config_write_line +
-  config_write +
-  config_read +
-  config_reload +
-  config_option_free +
-  config_section_free_options +
-  config_section_free +
-  config_free +
-  config_get +
-  config_get_plugin +
-  config_is_set_plugin +
-  config_set_plugin +
-  config_set_desc_plugin +
-  config_unset_plugin
-
-| associations de touches
-| key_bind +
-  key_unbind
-
-| affichage
-| prefix +
-  color +
-  print (pour python : prnt) +
-  print_date_tags (pour python : prnt_date_tags) +
-  print_datetime_tags (pour python : prnt_datetime_tags) +
-  print_y (pour python : prnt_y) +
-  print_y_date_tags (pour python : prnt_y_date_tags) +
-  print_y_datetime_tags (pour python : prnt_y_datetime_tags) +
-  log_print
-
-| hooks
-| hook_command +
-  hook_command_run +
-  hook_timer +
-  hook_fd +
-  hook_process +
-  hook_process_hashtable +
-  hook_connect +
-  hook_line +
-  hook_print +
-  hook_signal +
-  hook_signal_send +
-  hook_hsignal +
-  hook_hsignal_send +
-  hook_config +
-  hook_completion +
-  hook_modifier +
-  hook_modifier_exec +
-  hook_info +
-  hook_info_hashtable +
-  hook_infolist +
-  hook_focus +
-  hook_set +
-  unhook +
-  unhook_all
-
-| tampons
-| buffer_new +
-  buffer_new_props +
-  current_buffer +
-  buffer_search +
-  buffer_search_main +
-  buffer_clear +
-  buffer_close +
-  buffer_merge +
-  buffer_unmerge +
-  buffer_get_integer +
-  buffer_get_string +
-  buffer_get_pointer +
-  buffer_set +
-  buffer_string_replace_local_var +
-  buffer_match_list
-
-| fenêtres
-| current_window +
-  window_search_with_buffer +
-  window_get_integer +
-  window_get_string +
-  window_get_pointer +
-  window_set_title
-
-| liste des pseudos
-| nicklist_add_group +
-  nicklist_search_group +
-  nicklist_add_nick +
-  nicklist_search_nick +
-  nicklist_remove_group +
-  nicklist_remove_nick +
-  nicklist_remove_all +
-  nicklist_group_get_integer +
-  nicklist_group_get_string +
-  nicklist_group_get_pointer +
-  nicklist_group_set +
-  nicklist_nick_get_integer +
-  nicklist_nick_get_string +
-  nicklist_nick_get_pointer +
-  nicklist_nick_set
-
-| barres
-| bar_item_search +
-  bar_item_new +
-  bar_item_update +
-  bar_item_remove +
-  bar_search +
-  bar_new +
-  bar_set +
-  bar_update +
-  bar_remove
-
-| commandes
-| command +
-  command_options
-
-| complétion
-| completion_new +
-  completion_search +
-  completion_get_string +
-  completion_list_add +
-  completion_free
-
-| infos
-| info_get +
-  info_get_hashtable
-
-| infolists
-| infolist_new +
-  infolist_new_item +
-  infolist_new_var_integer +
-  infolist_new_var_string +
-  infolist_new_var_pointer +
-  infolist_new_var_time +
-  infolist_get +
-  infolist_next +
-  infolist_prev +
-  infolist_reset_item_cursor +
-  infolist_search_var +
-  infolist_fields +
-  infolist_integer +
-  infolist_string +
-  infolist_pointer +
-  infolist_time +
-  infolist_free
-
-| hdata
-| hdata_get +
-  hdata_get_var_offset +
-  hdata_get_var_type_string +
-  hdata_get_var_array_size +
-  hdata_get_var_array_size_string +
-  hdata_get_var_hdata +
-  hdata_get_list +
-  hdata_check_pointer +
-  hdata_move +
-  hdata_search +
-  hdata_char +
-  hdata_integer +
-  hdata_long +
-  hdata_string +
-  hdata_pointer +
-  hdata_time +
-  hdata_hashtable +
-  hdata_compare +
-  hdata_update +
-  hdata_get_string
-
-| mise à jour
-| upgrade_new +
-  upgrade_write_object +
-  upgrade_read +
-  upgrade_close
-|===
 
 [[script_api_constants]]
 === Constantes
 
 Liste des constantes de l'API script :
 
-[width="100%",cols="1,5",options="header"]
+include::{autogendir}/autogen_scripting_constants.fr.adoc[tag=constants]
-|===
-
-| Catégorie | Constantes
-
-| codes retour
-| `WEECHAT_RC_OK` (entier) +
-  `WEECHAT_RC_OK_EAT` (entier) +
-  `WEECHAT_RC_ERROR` (entier)
-
-| fichiers de configuration
-| `WEECHAT_CONFIG_READ_OK` (entier) +
-  `WEECHAT_CONFIG_READ_MEMORY_ERROR` (entier) +
-  `WEECHAT_CONFIG_READ_FILE_NOT_FOUND` (entier) +
-  `WEECHAT_CONFIG_WRITE_OK` (entier) +
-  `WEECHAT_CONFIG_WRITE_ERROR` (entier) +
-  `WEECHAT_CONFIG_WRITE_MEMORY_ERROR` (entier) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_CHANGED` (entier) +
-  `WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE` (entier) +
-  `WEECHAT_CONFIG_OPTION_SET_ERROR` (entier) +
-  `WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND` (entier) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET` (entier) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_RESET` (entier) +
-  `WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED` (entier) +
-  `WEECHAT_CONFIG_OPTION_UNSET_ERROR` (entier)
-
-| listes triées
-| `WEECHAT_LIST_POS_SORT` (chaîne) +
-  `WEECHAT_LIST_POS_BEGINNING` (chaîne) +
-  `WEECHAT_LIST_POS_END` (chaîne)
-
-| hotlist
-| `WEECHAT_HOTLIST_LOW` (chaîne) +
-  `WEECHAT_HOTLIST_MESSAGE` (chaîne) +
-  `WEECHAT_HOTLIST_PRIVATE` (chaîne) +
-  `WEECHAT_HOTLIST_HIGHLIGHT` (chaîne)
-
-| hook process
-| `WEECHAT_HOOK_PROCESS_RUNNING` (entier) +
-  `WEECHAT_HOOK_PROCESS_ERROR` (entier)
-
-| hook connect
-| `WEECHAT_HOOK_CONNECT_OK` (entier) +
-  `WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND` (entier) +
-  `WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND` (entier) +
-  `WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED` (entier) +
-  `WEECHAT_HOOK_CONNECT_PROXY_ERROR` (entier) +
-  `WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR` (entier) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR` (entier) +
-  `WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR` (entier) +
-  `WEECHAT_HOOK_CONNECT_MEMORY_ERROR` (entier) +
-  `WEECHAT_HOOK_CONNECT_TIMEOUT` (entier) +
-  `WEECHAT_HOOK_CONNECT_SOCKET_ERROR` (entier)
-
-| hook signal
-| `WEECHAT_HOOK_SIGNAL_STRING` (chaîne) +
-  `WEECHAT_HOOK_SIGNAL_INT` (chaîne) +
-  `WEECHAT_HOOK_SIGNAL_POINTER` (chaîne)
-|===
 
 [[common_tasks]]
 == Tâches courantes

doc/fr/weechat_user.fr.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: fr
-:toc-title: Table des matières
+include::includes/attributes-fr.adoc[]
 
 Ce manuel documente le client de messagerie instantanée WeeChat, il fait
 partie de WeeChat.
@@ -32,7 +32,7 @@ Ses principales fonctionnalités sont les suivantes :
   https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
   https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] et
   https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
-* proxy IRC et relai pour interfaces distantes
+* proxy IRC et relai pour WeeChat et interfaces distantes
 * multi plates-formes (GNU/Linux, *BSD, macOS, Windows et d'autres systèmes)
 * 100% GPL, logiciel libre
 
@@ -110,7 +110,7 @@ Le tableau suivant liste les paquets *requis* pour construire WeeChat :
 | cmake | ≥ 3.0
 | Construction.
 
-| pkg-config |
+| pkgconf / pkg-config |
 | Détection des bibliothèques installées.
 
 | libncurses-dev |
@@ -128,7 +128,8 @@ Le tableau suivant liste les paquets *requis* pour construire WeeChat :
 
 | zlib1g-dev |
 | Extension Logger : compression des fichiers de log qui tournent (gzip). +
-  Extention Relay : compression des messages (WeeChat -> client) avec https://zlib.net/[zlib ^↗^^] (protocole weechat). +
+  Extention Relay : compression des messages (WeeChat -> client) avec https://zlib.net/[zlib ^↗^^]
+  (protocoles api et weechat). +
   Extension Script : lecture du fichier d'index du dépôt (gzip).
 |===
 
@@ -153,9 +154,13 @@ Le tableau suivant liste les paquets optionnels pour compiler WeeChat :
 | ca-certificates |
 | Certificats pour les connexions TLS.
 
+| libcjson-dev |
+| Extension Relay : protocole "api" (API REST HTTP).
+
 | libzstd-dev | ≥ 0.8.1
 | Extension Logger : compression des fichiers de log qui tournent (zstandard). +
-  Extension Relay : compression des messages (WeeChat -> client) avec https://facebook.github.io/zstd/[Zstandard ^↗^^] (protocole weechat).
+  Extension Relay : compression des messages (WeeChat -> client) avec https://facebook.github.io/zstd/[Zstandard ^↗^^]
+  (protocoles api et weechat).
 
 | libaspell-dev / libenchant-dev |
 | Extension spell.
@@ -214,8 +219,9 @@ Si vous utilisez une distribution basée sur Debian ou Ubuntu, et si vous avez
 des entrées source "deb-src" dans votre fichier _/etc/apt/sources.list_, vous
 pouvez installer toutes les dépendances avec la commande :
 
+[source,shell]
 ----
-# apt-get build-dep weechat
+sudo apt-get build-dep weechat
 ----
 
 [[build]]
@@ -223,22 +229,24 @@ pouvez installer toutes les dépendances avec la commande :
 
 * Installation dans les répertoires systèmes (nécessite les droits _root_) :
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake ..
+cmake ..
-$ make
+make
-$ sudo make install
+sudo make install
 ----
 
 * Installation dans un répertoire spécifique (par exemple dans votre "home") :
 
+[source,shell]
 ----
-$ mkdir build
+mkdir build
-$ cd build
+cd build
-$ cmake .. -DCMAKE_INSTALL_PREFIX=/chemin/vers/répertoire
+cmake .. -DCMAKE_INSTALL_PREFIX=/chemin/vers/répertoire
-$ make
+make
-$ make install
+make install
 ----
 
 Des options peuvent être utilisées pour CMake, avec le format : `-DOPTION=VALUE`.
@@ -272,6 +280,9 @@ Liste des options disponibles :
 | ENABLE_CHARSET | `ON`, `OFF` | ON
 | Compiler <<charset,l'extension Charset>>.
 
+| ENABLE_CJSON | `ON`, `OFF` | ON
+| Support du JSON avec la bibliothèque https://github.com/DaveGamble/cJSON[cJSON ^↗^^].
+
 | ENABLE_MAN | `ON`, `OFF` | OFF
 | Construire la page man.
 
@@ -372,14 +383,16 @@ Liste des options disponibles :
 
 Les autres options peuvent être affichées avec cette commande :
 
+[source,shell]
 ----
-$ cmake -LA
+cmake -LA
 ----
 
 Ou avec l'interface Curses :
 
+[source,shell]
 ----
-$ ccmake ..
+ccmake ..
 ----
 
 [[tests]]
@@ -392,14 +405,16 @@ Les paquets suivants sont nécessaires pour compiler les tests :
 
 Les tests doivent être activés pour compiler WeeChat :
 
+[source,shell]
 ----
-$ cmake .. -DENABLE_TESTS=ON
+cmake .. -DENABLE_TESTS=ON
 ----
 
 Ils peuvent être lancés après compilation depuis le répertoire de construction :
 
+[source,shell]
 ----
-$ ctest -V
+ctest -V
 ----
 
 [[git_sources]]
@@ -410,8 +425,9 @@ que WeeChat ne compile pas et qu'il soit très instable. Vous êtes prévenus !
 
 Pour récupérer les sources Git, tapez cette commande :
 
+[source,shell]
 ----
-$ git clone https://github.com/weechat/weechat.git
+git clone https://github.com/weechat/weechat.git
 ----
 
 Suivez alors les instructions du paquet source (voir
@@ -434,8 +450,9 @@ futur de WeeChat, vous devez :
 
 Si vous compilez avec CMake :
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug
+cmake .. -DCMAKE_BUILD_TYPE=Debug
 ----
 
 [[address_sanitizer]]
@@ -444,8 +461,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
 Vous pouvez aussi activer la vérification des adresses (« address sanitizer »),
 ce qui provoquera immédiatement un plantage de WeeChat en cas de problème :
 
+[source,shell]
 ----
-$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
+cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
 ----
 
 [WARNING]
@@ -454,8 +472,9 @@ provoquer un plantage, ce qui n'est pas recommandé en production.
 
 Une fois compilé et installé, vous devez lancer WeeChat comme ceci :
 
+[source,shell]
 ----
-$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
+ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
 ----
 
 En cas de plantage, la trace se trouve dans le fichier `asan.log`.
@@ -476,12 +495,14 @@ WeeChat ne démarre, vous pouvez utiliser la commande `ulimit`.
 Par exemple sous Linux avec le shell _bash_, ajoutez cette ligne dans votre
 `~/.bashrc` :
 
+[source,shell]
 ----
 ulimit -c unlimited
 ----
 
 Ou une taille maximum :
 
+[source,shell]
 ----
 ulimit -c 200000
 ----
@@ -505,6 +526,7 @@ https://wiki.archlinux.org/title/Core_dump[page wiki ^↗^^].
 Par exemple si _weechat_ est installé dans _/usr/bin/_ et que le fichier
 _core_ se trouve dans _/home/user/_, alors il faut lancer gdb avec cette commande :
 
+[source,shell]
 ----
 gdb /usr/bin/weechat /home/user/core
 ----
@@ -523,11 +545,11 @@ Copying output to /tmp/crash.txt.
     at /some_path/src/core/weechat.c:351
 #3  <signal handler called>
 #4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90,
-    remaining_calls=<value optimized out>) at /some_path/src/core/wee-hook.c:1364
+    remaining_calls=<value optimized out>) at /some_path/src/core/core-hook.c:1364
         hook_process = 0x254eb90
         status = <value optimized out>
 #5  0x000000000044cc7d in hook_timer_exec ()
-    at /some_path/src/core/wee-hook.c:1025
+    at /some_path/src/core/core-hook.c:1025
         tv_time = {tv_sec = 1272693881, tv_usec = 212665}
         ptr_hook = 0x2811f40
         next_hook = 0x0
@@ -553,6 +575,7 @@ Pour déboguer WeeChat qui tourne (par exemple si WeeChat semble bloqué), vous
 pouvez utiliser gdb avec l'identifiant du processus (remplacez _12345_ par le
 PID du processus weechat) :
 
+[source,shell]
 ----
 gdb /usr/bin/weechat 12345
 ----
@@ -568,8 +591,9 @@ Ensuite comme pour un crash, utilisez la commande `bt full` :
 
 Pour lancer WeeChat, tapez cette commande :
 
+[source,shell]
 ----
-$ weechat
+weechat
 ----
 
 Lorsque vous lancez WeeChat pour la première fois, les fichiers de configuration
@@ -793,25 +817,26 @@ Cela sauvegarde l'état actuel dans des fichiers `*.upgrade`. Vous pouvez soit
 rebooter ou déplacer les répertoires WeeChat (config, data, cache) vers une
 autre machine, et redémarrer WeeChat plus tard avec cette commande :
 
+[source,shell]
 ----
-$ weechat --upgrade
+weechat --upgrade
 ----
 
 [[restart_after_upgrade]]
 === Redémarrage après mise à jour
 
-[[restart_release_notes]]
+[[restart_upgrading_notes]]
-==== Notes de version
+==== Notes de mise à jour
 
-Après une mise à jour, il est *fortement recommandé* de lire les
+Après une mise à jour, il est *fortement recommandé* de lire le fichier
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[notes de version ^↗^^]
+https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
-qui contiennent des informations importantes sur les changements majeurs et
+qui contient des informations importantes sur les changements majeurs et
 quelques actions manuelles qui pourraient être nécessaires.
 
-Vous devez lire les notes des versions entre votre version ancienne (exclue)
+Vous devez lire les versions entre votre version ancienne (exclue)
 et votre nouvelle version (incluse). +
-Par exemple si vous passez de la version 3.0 à 3.2, vous devez lire les notes
+Par exemple si vous passez de la version 4.0.0 à 4.3.0, vous devez lire les
-des versions 3.1 et 3.2.
+versions 4.0.1 à 4.3.0.
 
 [[restart_configuration_upgrade]]
 ==== Mise à jour de la configuration
@@ -1342,7 +1367,7 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
 | no_filter        | La ligne ne peut pas être filtrée.
 | no_highlight     | Aucun highlight n'est possible sur cette ligne.
 | no_log           | La ligne n'est pas écrite dans le fichier de log.
-| log0 … log9      | Niveau de log pour la ligne (voir `/help logger`).
+| log0 … log9      | Niveau de log pour la ligne (voir la commande <<command_logger_logger,/logger>>).
 | notify_none      | La ligne ne doit pas être ajoutée à la "hotlist". ^(1)^
 | notify_message   | La ligne est un message utilisateur. ^(1)^
 | notify_private   | La ligne est un message privé. ^(1)^
@@ -1880,10 +1905,10 @@ avec la touche kbd:[Alt+m] (commande : `+/mouse toggle+`).
 | kbd:[▼]               | -             | chat : tampon /list  | Descendre de cinq lignes dans le tampon /list. | `+/list -down 5+`
 | kbd:[■ □ □]           | -             | chat : tampon /list  | Sélectionner la ligne dans le tampon /list. | `+/window ${_window_number};/list -go ${_chat_line_y}+`
 | kbd:[□ □ ■]           | -             | chat : tampon /list  | Rejoindre le canal IRC sur la ligne sélectionnée. | `+hsignal:irc_list_mouse+`
-| kbd:[▲]               | -             | chat : tampon script | Monter de 5 lignes dans le tampon script. | `+/script up 5+`
+| kbd:[▲]               | -             | chat : tampon script | Monter de 5 lignes dans le tampon script. | `+/script -up 5+`
-| kbd:[▼]               | -             | chat : tampon script | Descendre de 5 lignes dans le tampon script. | `+/script down 5+`
+| kbd:[▼]               | -             | chat : tampon script | Descendre de 5 lignes dans le tampon script. | `+/script -down 5+`
-| kbd:[■ □ □]           | -             | chat : tampon script | Sélectionner la ligne dans le tampon script. | `+/script go ${_chat_line_y}+`
+| kbd:[■ □ □]           | -             | chat : tampon script | Sélectionner la ligne dans le tampon script. | `+/script -go ${_chat_line_y}+`
-| kbd:[□ □ ■]           | -             | chat : tampon script | Installer/supprimer un script. | `+/script go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
+| kbd:[□ □ ■]           | -             | chat : tampon script | Installer/supprimer un script. | `+/script -go ${_chat_line_y};/script installremove -q ${script_name_with_extension}+`
 | kbd:[■ □ □]           | haut / gauche | buflist              | Déplacer le tampon vers un numéro inférieur. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]           | bas / droit   | buflist              | Déplacer le tampon vers un numéro supérieur. | Signal `+buflist_mouse+`.
 | kbd:[■ □ □]           | -             | buflist              | Aller au tampon (tampon précédent dans la liste des tampons visités si le tampon est le courant). | Signal `+buflist_mouse+`.
@@ -2004,8 +2029,8 @@ Ces touches et actions sont utilisées sur le tampon script
 [width="100%",cols="^.^3,^.^2,.^8,.^5",options="header"]
 |===
 | Touche            | Action ^(1)^ | Description | Commande
-| kbd:[↑]           |              | Monter d'une ligne. | `+/script up+`
+| kbd:[↑]           |              | Monter d'une ligne. | `+/script -up+`
-| kbd:[↓]           |              | Descendre d'une ligne. | `+/script down+`
+| kbd:[↓]           |              | Descendre d'une ligne. | `+/script -down+`
 | kbd:[PgUp]        |              | Monter d'une page. | `+/window page_up+`
 | kbd:[PgDn]        |              | Descendre d'une page. | `+/window page_down+`
 | kbd:[Alt+i]       | `i`          | Installer le script. | `+/script install+`
@@ -2737,27 +2762,38 @@ utilisant le contexte "mouse" (pour la syntaxe voir la commande
 Un nom d'évènement consiste en un modificateur (facultatif), un bouton/roulette
 et un geste (facultatif). Les différents éléments sont séparés par `+-+`.
 
-Liste des modificateurs :
+Liste des modificateurs (par ordre dans le nom de l'évènement) :
 
 [width="100%",cols="1m,4",options="header"]
 |===
 | Modificateur | Description
-| ctrl         | Touche kbd:[Ctrl]
 | alt          | Touche kbd:[Alt]
-| ctrl-alt     | Touches kbd:[Ctrl] + kbd:[Alt]
+| ctrl         | Touche kbd:[Ctrl]
+| shift        | Touche kbd:[Shift] ^(1)^
 |===
 
+[NOTE]
+^(1)^ Le modificateur `shift` peut rarement être utilisé dans WeeChat car
+beaucoup de terminaux utilisent ce modificateur pour attraper directement les
+évènements souris.
+
+Plusieurs modificateurs peuvent être combinés, par exemple :
+
+* `alt-ctrl`
+* `ctrl-shift`
+* `alt-ctrl-shift`
+
 Liste des boutons/roulette :
 
 [width="100%",cols="1m,4",options="header"]
 |===
-| Bouton/roulette     | Description
+| Bouton/roulette      | Description
-| button1             | Clic sur le bouton gauche
+| button1              | Clic sur le bouton gauche
-| button2             | Clic sur le bouton droit
+| button2              | Clic sur le bouton droit
-| button3             | Clic sur le bouton du milieu (souvent clic sur la roulette)
+| button3              | Clic sur le bouton du milieu (souvent clic sur la roulette)
-| button4 ... button9 | Clic sur un bouton additionnel
+| button4 ... button11 | Clic sur un bouton additionnel
-| wheelup             | Roulette (haut)
+| wheelup              | Roulette (haut)
-| wheeldown           | Roulette (bas)
+| wheeldown            | Roulette (bas)
 |===
 
 Liste des gestes (seulement pour les boutons, pas la roulette) :
@@ -2794,7 +2830,7 @@ Exemples d'évènements :
 * `button1-event-drag`
 * `alt-button2-gesture-down-long`
 * `wheelup`
-* `ctrl-alt-wheeldown`
+* `alt-ctrl-wheeldown`
 * ...
 
 [TIP]
@@ -2857,8 +2893,9 @@ options dans la section "option" de la configuration aspell.
 Le nom de l'option est une option de configuration aspell. La liste des options
 peut être trouvée par la commande suivante sous le shell :
 
+[source,shell]
 ----
-$ aspell config
+aspell config
 ----
 
 Par exemple, pour activer l'option "ignore-case" :
@@ -3320,7 +3357,7 @@ Les données sécurisées peuvent être utilisées dans quelques options qui peu
 contenir des données sensibles comme un mot de passe, en utilisant ce format :
 "${sec.data.xxx}" où "xxx" est le nom de la donnée sécurisée (utilisé dans la
 commande `/secure set xxx ...`). +
-Pour une liste complète des options supportées, voir `/help secure`.
+Pour une liste complète des options supportées, voir la commande <<command_weechat_secure,/secure>>.
 
 Pour utiliser le mot de passe _libera_, par exemple avec
 <<irc_sasl_authentication,l'authentification SASL>> :
@@ -3446,8 +3483,9 @@ irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/canal][,canal[...]]
 Exemple pour rejoindre _#weechat_ et _#weechat-fr_ sur le serveur
 _irc.libera.chat_, port par défaut (6667), avec le pseudo _alice_ :
 
+[source,shell]
 ----
-$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
+weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
 ----
 
 [[irc_servers]]
@@ -3605,9 +3643,10 @@ et peut échouer, même si cela pouvait être OK dans les versions inférieures
 
 * Importer le certificat sous le shell :
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
+wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
 ----
 
 [NOTE]
@@ -3628,10 +3667,11 @@ Il est possible de concaténer plusieurs certificats dans le fichier CAs.pem.
 
 * Créer le certificat sous le shell :
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
+openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----
 
 [NOTE]
@@ -3681,8 +3721,9 @@ connexion).
 
 Vous pouvez générer la clé avec cette commande :
 
+[source,shell]
 ----
-$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
+openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
 ----
 
 [NOTE]
@@ -3691,8 +3732,9 @@ config WeeChat qui peut aussi être par exemple `~/.weechat`.
 
 Récupérez la clé publique (encodée en base64) avec cette commande :
 
+[source,shell]
 ----
-$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
+openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
 ----
 
 Connectez-vous au serveur, identifiez vous (par exemple avec
@@ -3762,8 +3804,9 @@ sur Internet.
 
 En premier lieu, installez Tor. Pour Debian (et dérivés) :
 
+[source,shell]
 ----
-$ sudo apt-get install tor
+sudo apt-get install tor
 ----
 
 Sous WeeChat vous devez ajouter un proxy socks5 pour le service Tor (le nom/IP
@@ -4196,7 +4239,7 @@ des clés, par exemple si `#canal1` requiert une clé mais pas `#canal2`:
 /set irc.server.libera.autojoin "#canal1,#canal2 cle1"
 ----
 
-Pour de l'aide sur le format, voir `/help irc.server.libera.autojoin`.
+Pour de l'aide sur le format, voir l'option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
 
 [[irc_private_messages]]
 === Messages privés
@@ -4245,7 +4288,7 @@ pour cacher les lignes sur les tampons, par exemple :
 ----
 
 Il est possible de créer un filtre pour un canal seulement ou plusieurs canaux
-commençant par le même nom (voir `/help filter`) :
+commençant par le même nom (voir la commande <<command_weechat_filter,/filter>>) :
 
 ----
 /filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4641,8 +4684,13 @@ utilisant divers protocoles :
 
 * _irc_ : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec
   un ou plusieurs autres clients IRC
+* _api_ : API REST HTTP, utilisée par WeeChat et les interfaces distantes pour
+  afficher et interagir avec WeeChat
 * _weechat_ : protocole utilisé par les interfaces distantes pour afficher et
-  interagir avec WeeChat, voir https://weechat.org/about/interfaces/[cette page ^↗^^].
+  interagir avec WeeChat.
+
+Pour les protocoles _api_ et _weechat_, voir la liste des interfaces distantes
+sur https://weechat.org/about/interfaces/[cette page ^↗^^].
 
 [[relay_password]]
 === Mot de passe
@@ -4655,14 +4703,14 @@ commandes :
 /set relay.network.password "${sec.data.relay}"
 ----
 
-Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_.
+Ce mot de passe est utilisé avec tous les protocoles.
 
 [[relay_totp]]
 === TOTP
 
 TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le
-temps) peut être utilisé comme second facteur d'authentification pour le protocole
+temps) peut être utilisé comme second facteur d'authentification pour les
-_weechat_, en plus du mot de passe.
+protocoles _api_ et _weechat_, en plus du mot de passe.
 
 Il est optionnel et augmente le niveau de sécurité.
 
@@ -4699,10 +4747,11 @@ Le chemin par défaut vers le certificat/clé est défini par l'option
 
 Vous pouvez créer le certificat et la clé privée avec les commandes suivantes :
 
+[source,shell]
 ----
-$ mkdir -p ~/.config/weechat/tls
+mkdir -p ~/.config/weechat/tls
-$ cd ~/.config/weechat/tls
+cd ~/.config/weechat/tls
-$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
 ----
 
 [NOTE]
@@ -4759,6 +4808,39 @@ avec ces commandes :
 /set irc.server.relay.password "${sec.data.relay_libera}"
 ----
 
+[[relay_api_protocol]]
+=== API protocol
+
+L'extension Relay peut envoyer les données à un autre WeeChat ou une interface
+distante avec un protocol HTTP de type API REST.
+
+Vous pouvez parcourir et tester l'API en ligne :
+https://weechat.org/api/[API Relay WeeChat ^↗^^].
+
+Vous pouvez vous connecter avec WeeChat ou une interface distante, voir
+https://weechat.org/about/interfaces/[cette page ^↗^^].
+
+Par exemple :
+
+----
+/relay add api 9000
+----
+
+Maintenant vous pouvez vous connecter sur le port 9000 avec une interface
+distante en utilisant le mot de passe "motdepasse".
+
+Pour vous connecter à un relai _api_ avec WeeChat :
+
+----
+/remote add weechat http://localhost:9000 -password=motdepasse
+/remote connect weechat
+----
+
+[NOTE]
+Le WeeChat distant doit exposer exactement la même version d'API que le WeeChat
+local, il est donc fortement recommandé d'utiliser exactement la même version
+de WeeChat de chaque côté.
+
 [[relay_weechat_protocol]]
 === Protocole WeeChat
 
@@ -4775,10 +4857,10 @@ protocole.
 Par exemple :
 
 ----
-/relay add weechat 9000
+/relay add weechat 9500
 ----
 
-Maintenant vous pouvez vous connecter sur le port 9000 avec une interface
+Maintenant vous pouvez vous connecter sur le port 9500 avec une interface
 distante en utilisant le mot de passe "motdepasse".
 
 [[relay_websocket]]
@@ -4798,12 +4880,13 @@ JavaScript :
 
 [source,javascript]
 ----
-websocket = new WebSocket("ws://server.com:9000/weechat");
+websocket = new WebSocket("ws://server.com:9500/weechat");
 ----
 
-Le port (9000 dans l'exemple) est le port défini dans l'extension Relay.
+Le port (9500 dans l'exemple) est le port défini dans l'extension Relay.
-L'URI doit toujours se terminer par "/weechat" (pour les protocoles _irc_ et
+
-_weechat_).
+L'URI doit se terminer par "/weechat" pour les protocoles _irc_ et _weechat_ et
+"/api" pour le protocole _api_.
 
 [[relay_unix_socket]]
 === UNIX domain sockets
@@ -4823,8 +4906,9 @@ _/run/user/1000/weechat/relay_socket_. Cela est utile pour autoriser le
 
 Avec OpenSSH :
 
+[source,shell]
 ----
-$ ssh -L 9000:.weechat/relay_socket user@hostname
+ssh -L 9000:.weechat/relay_socket user@hostname
 ----
 
 Cela redirige les clients relay locaux qui se connectent au port 9000 vers
@@ -4848,7 +4932,7 @@ Sections dans le fichier _relay.conf_ :
 | network | /set relay.network.*               | Options réseau.
 | irc     | /set relay.irc.*                   | Options spécifiques au protocole irc (proxy irc).
 | port    | <<command_relay_relay,/relay add>> +
-            /set relay.port.*                  | Ports utilisés pour le relai (protocoles irc et weechat) (les options peuvent être ajoutées/supprimées dans la section).
+            /set relay.port.*                  | Ports utilisés pour le relai (les options peuvent être ajoutées/supprimées dans la section).
 |===
 
 Options :
@@ -4912,34 +4996,39 @@ Quelques exemples :
 
 * Changer le pseudo sur libera en "autrepseudo" :
 
+[source,shell]
 ----
-$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Envoyer un message sur le canal IRC #weechat :
 
+[source,shell]
 ----
-$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Envoyer un message multi-lignes sur le canal IRC #test, si la capacité
   "draft/multiline" est activée sur le serveur ergo :
 
+[source,shell]
 ----
-$ echo 'irc.ergo.#test \bonjour\n...sur deux lignes !' >/run/user/1000/weechat/weechat_fifo_12345
+echo 'irc.ergo.#test \bonjour\n...sur deux lignes !' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Envoyer un message sur le tampon courant :
 
+[source,shell]
 ----
-$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
+echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 * Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez
   les séparer par "\n") :
 
+[source,shell]
 ----
-$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
+printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
 ----
 
 [[fifo_commands]]
@@ -5265,7 +5354,9 @@ Les groupes de correspondance peuvent être utilisés dans le _remplacement_ :
 
 * `+${re:0}+` à `+${re:99}+` : `+${re:0}+` est la correspondance complète, `+${re:1}+`
   à `+${re:99}+` sont les groupes capturés
-* `+${re:+}+` : la dernière correspondance (avec le numéro le plus élevé)
+* `pass:[${re:+}]` : la dernière correspondance (avec le numéro le plus élevé)
+* `+${re:#}+` : index du dernier groupe capturé
+* `+${re:repl_index}+` : index du remplacement en cours (démarre à 1)
 * `+${hide:c,${re:N}}+` : la correspondance "N" avec tous les caractères
   remplacés par "c" (exemple : `+${hide:*,${re:2}}+` est le groupe n°2 avec tous
   les caractères remplacés par `+*+`).
@@ -5421,7 +5512,7 @@ suivantes sont ajoutées dans la table de hachage :
 | server               | chaîne   | Nom du serveur (exemple : "libera").
 | tags                 | chaîne   | Étiquettes dans le message (rarement utilisées).
 | message_without_tags | chaîne   | Message sans les étiquettes.
-| nick                 | chaîne   | Pseudo.
+| nick                 | chaîne   | Pseudo. ^(1)^
 | host                 | chaîne   | Nom d'hôte.
 | command              | chaîne   | Commande IRC (exemple : "PRIVMSG", "NOTICE", ...).
 | channel              | chaîne   | Canal IRC.
@@ -5433,6 +5524,10 @@ suivantes sont ajoutées dans la table de hachage :
 | pos_text             | chaîne   | L'index de _text_ dans le message ("-1" si _text_ n'a pas été trouvé).
 |===
 
+[NOTE]
+^(1)^ Le pseudo est l'expéditeur du message. +
+Votre propre pseudo sur le serveur est `${irc_server.nick}`.
+
 Lorsque la donnée est un pointeur, la variable `+tg_signal_data+` peut être
 utilisée comme ceci pour lire une propriété hdata (dans cet exemple il s'agit
 d'un pointeur sur un tampon) :

doc/it/includes/attributes-it.adoc

@@ -0,0 +1,23 @@
+// Italian translation, courtesy of Marco Ciampa <ciampix@posteo.net>
+:appendix-caption: Appendice
+:appendix-refsig: {appendix-caption}
+:caution-caption: Attenzione
+:chapter-signifier: Capitolo
+:chapter-refsig: {chapter-signifier}
+:example-caption: Esempio
+:figure-caption: Figura
+:important-caption: Importante
+:last-update-label: Ultimo aggiornamento
+ifdef::listing-caption[:listing-caption: Elenco]
+ifdef::manname-title[:manname-title: Nome]
+:note-caption: Nota
+:part-signifier: Parte
+:part-refsig: {part-signifier}
+ifdef::preface-title[:preface-title: Prefazione]
+:section-refsig: Sezione
+:table-caption: Tabella
+:tip-caption: Suggerimento
+:toc-title: Indice
+:untitled-label: Senza titolo
+:version-label: Versione
+:warning-caption: Attenzione

doc/it/includes/cmdline_options.it.adoc

@@ -39,6 +39,10 @@
 *-h*, *--help*::
     Mostra l'aiuto.
 
+// TRANSLATION MISSING
+*-i*, *--build-info*::
+    Display build information and exit.
+
 *-l*, *--license*::
     Mostra la licenza di WeeChat.
 

doc/it/includes/man.it.adoc

@@ -101,7 +101,7 @@ $HOME/.local/share/weechat/weechat.log::
 // tag::copyright[]
 // TRANSLATION MISSING
 WeeChat is written by Sébastien Helleu and contributors (complete list is in
-the AUTHORS.adoc file).
+the AUTHORS.md file).
 
 Copyright (C) 2003-2024 {author}
 

doc/it/weechat_faq.it.adoc

@@ -2,7 +2,7 @@
 :author: Sébastien Helleu
 :email: flashcode@flashtux.org
 :lang: it
-:toc-title: Indice
+include::includes/attributes-it.adoc[]
 
 // TRANSLATION MISSING
 Translators:
@@ -62,6 +62,7 @@ If you still have issues, please report them to the developers.
 It is recommended to use https://brew.sh/[Homebrew ^↗^^],
 you can get help with:
 
+[source,shell]
 ----
 brew info weechat
 ----
@@ -69,6 +70,7 @@ brew info weechat
 // TRANSLATION MISSING
 You can install WeeChat with this command:
 
+[source,shell]
 ----
 brew install weechat
 ----
@@ -348,10 +350,15 @@ just the contents of the currently selected window, without any formatting.
 rxvt-unicode, konsole, gnome-terminal, ...). La combinazione tasti in
 generale è kbd:[Ctrl] + kbd:[Alt] + selezione mouse.
 
+// TRANSLATION MISSING
+You can toggle nicklist and make it visible only when needed, with key
+kbd:[Alt+Shift+N].
+
 Un'altra soluzione è spostare la lista nick in alto o in basso, per esempio:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 [[urls]]
@@ -363,11 +370,15 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
 // TRANSLATION MISSING
 To make opening URLs easier, you can:
 
+// TRANSLATION MISSING
+* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
+
 // TRANSLATION MISSING
 * move nicklist to top:
 
 ----
 /set weechat.bar.nicklist.position top
+/set weechat.bar.nicklist.size_max 8
 ----
 
 // TRANSLATION MISSING
@@ -424,6 +435,7 @@ There is no option in WeeChat to change the timezone, the environment variable
 // TRANSLATION MISSING
 In your shell initialization file or on command line, before starting WeeChat:
 
+[source,shell]
 ----
 export TZ=Europe/Rome
 ----
@@ -750,8 +762,9 @@ In base al terminale usato, il mouse potrebbe non essere supportato.
 
 È possibile testare il supporto al mouse nel terminale:
 
+[source,shell]
 ----
-$ printf '\033[?1002h'
+printf '\033[?1002h'
 ----
 
 E poi cliccare sul primo carattere del terminale (in alto a sinistra. Dovrebbe
@@ -759,8 +772,9 @@ essere possibile vedere  !!#!!".
 
 Per disabilitare il mouse nel terminale:
 
+[source,shell]
 ----
-$ printf '\033[?1002l'
+printf '\033[?1002l'
 ----
 
 [[mouse_coords]]
@@ -818,7 +832,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
 Provare una stringa di priorità diversa, sostituendo "xxx" con il nome del server:
 
 ----
-/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
+/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
 ----
 
 [[irc_tls_libera]]
@@ -1096,8 +1110,9 @@ First check questions about TLS connection in this FAQ.
 
 If still not working, try to manually delete the scripts file (in your shell):
 
+[source,shell]
 ----
-$ rm ~/.cache/weechat/script/plugins.xml.gz
+rm ~/.cache/weechat/script/plugins.xml.gz
 ----
 
 // TRANSLATION MISSING
@@ -1122,9 +1137,10 @@ have to update manually the file yourself to get updates):
 
 * in your shell, with curl installed:
 
+[source,shell]
 ----
-$ cd ~/.cache/weechat/script
+cd ~/.cache/weechat/script
-$ curl -O https://weechat.org/files/plugins.xml.gz
+curl -O https://weechat.org/files/plugins.xml.gz
 ----
 
 // TRANSLATION MISSING
@@ -1132,6 +1148,7 @@ If you're running macOS and the downloaded file has a size of 0 bytes,
 try to set this variable in your shell initialization file or on command line,
 before starting WeeChat:
 
+[source,shell]
 ----
 export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
 ----
@@ -1322,6 +1339,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
 Quando viene eseguito WeeChat all'interno di gdb, potrebbe verificarsi
 questo errore:
 
+[source,shell]
 ----
 $ gdb /path/to/weechat
 (gdb) run
@@ -1332,6 +1350,7 @@ Cannot find new threads: generic error
 Per correggerlo, è possibile eseguire gdb con questo comando (sostituire il
 path di libpthread e WeeChat con i path del proprio sistema):
 
+[source,shell]
 ----
 $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
 (gdb) run