1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-12 22:24:47 +02:00

Compare commits

...

326 Commits

Author SHA1 Message Date
Sébastien Helleu 70c09f1f5a Version 3.2 2021-06-13 09:28:25 +02:00
Sébastien Helleu 1adf6927e5 irc: fix translation of SASL errors 2021-06-13 09:16:09 +02:00
Sébastien Helleu de6575dd32 doc: update Polish auto-generated files 2021-06-10 21:28:15 +02:00
Krzysztof Korościk 4b3785ad1e po: updated polish translation 2021-06-10 00:18:03 +02:00
Sébastien Helleu 2a71d79b37 doc: update German auto-generated file 2021-06-07 07:13:54 +02:00
Nils Görs 5775e9cd10 core: update German translations 2021-06-05 23:09:34 +02:00
Sébastien Helleu 7dd3b0016c Version 3.2-rc1 2021-06-04 21:30:54 +02:00
Sébastien Helleu f8872c415b doc: add IRC SASL SCRAM mechanisms in user's guide (issue #1628) 2021-06-01 21:29:55 +02:00
Sébastien Helleu 8c57e8abd3 irc: add comments about parameter sasl_error (issue #1628) 2021-06-01 21:17:13 +02:00
Sébastien Helleu e365e66eeb irc: add support of SASL mechanisms SCRAM-SHA-1, SCRAM-SHA-256 and SCRAM-SHA-512 (closes #1628) 2021-06-01 20:45:11 +02:00
Sébastien Helleu 5cffb7179f api: add function crypto_hmac (issue #1628) 2021-06-01 20:39:04 +02:00
Sébastien Helleu 6ac6cf7293 tests: add test of base64 encode/decode with NUL char in string 2021-06-01 20:39:04 +02:00
Sébastien Helleu 576406888c doc: update German auto-generated files 2021-06-01 20:39:04 +02:00
Nils Görs ae60c3ec66 core: update German translations 2021-05-30 19:06:05 +02:00
Sébastien Helleu 466fed4f5b irc: add ${target} in help of server msg_kick option 2021-05-30 15:22:30 +02:00
Sébastien Helleu b21589944e core, irc, script: fix typos 2021-05-29 14:33:13 +02:00
Sébastien Helleu 4a41625989 irc: add variable "${target}" (target nick) in commands /kick and /kickban 2021-05-29 14:26:30 +02:00
Nils Görs a9b976274e doc: update German documentation 2021-05-28 13:46:02 +02:00
Sébastien Helleu 1181ab454e doc: use secured data in relay examples (user's guide) 2021-05-28 13:37:31 +02:00
Nils Görs c676148a63 core: update German translations 2021-05-28 09:30:29 +02:00
Victorhck f3428d48f3 doc: update Spanish quickstart guide 2021-05-27 20:59:53 +02:00
Sébastien Helleu 557dd8f4a5 core: update translations (issue #1647) 2021-05-27 18:28:52 +02:00
Filip H.F. "FiXato" Slagter d4f3bc596d clarify (max) bar size to be in chars/lines
(max) bar size was described to be in chars, though this only applies to the left/right bars. This change clarifies that top/bottom bars would have their size defined in lines.
2021-05-27 18:14:18 +02:00
Filip H.F. "FiXato" Slagter ddc5d56a65 Typo fix
Zomming -> Zooming
2021-05-26 19:53:11 +02:00
Sébastien Helleu b94907c249 doc: replace freenode-tor by a generic TOR example in user's guide 2021-05-26 10:07:59 +02:00
Sébastien Helleu dfdd5b1c50 core: add signals "cursor_start" and "cursor_end" 2021-05-26 08:53:31 +02:00
Sébastien Helleu 7cc61cdbb3 core: replace freenode by libera in command examples 2021-05-25 18:44:10 +02:00
Sébastien Helleu e5f58b77c1 core, buflist, irc, relay: replace freenode by libera in comments 2021-05-25 13:39:55 +02:00
Sébastien Helleu 18c82fc5c7 tests: replace freenode by libera in tests 2021-05-25 13:38:12 +02:00
Sébastien Helleu f55dcde4ff doc: replace freenode by libera in release notes 2021-05-25 13:37:43 +02:00
Sébastien Helleu a25f0f1928 doc: replace freenode by libera in contributing guide 2021-05-25 13:37:24 +02:00
Sébastien Helleu c20d3778d6 doc: replace freenode by libera in man page 2021-05-25 07:59:21 +02:00
Sébastien Helleu 1a7e49ac3f doc: replace freenode by libera in user's guide 2021-05-25 07:56:07 +02:00
Sébastien Helleu 8bd0df9b70 doc: replace freenode by libera in tester's guide 2021-05-25 07:34:01 +02:00
Sébastien Helleu afaff533c8 doc: replace freenode by libera in scripting guide 2021-05-25 07:27:13 +02:00
Sébastien Helleu 08ab8bef83 doc: replace freenode by libera in replay protocol 2021-05-25 07:22:32 +02:00
Sébastien Helleu 14c5e656f2 doc: replace freenode by libera in plugin API reference 2021-05-25 07:13:44 +02:00
Sébastien Helleu dc46bbf63d doc: replace freenode by libera in FAQ 2021-05-25 07:07:12 +02:00
Sébastien Helleu 0577fd1c99 doc: replace freenode by libera in quickstart guide 2021-05-25 07:02:55 +02:00
Krzysztof Korościk 6915f4e4c0 doc: updated polish translation 2021-05-24 22:52:51 +02:00
Sébastien Helleu f7dd2dbd55 doc: update Polish auto-generated files 2021-05-24 13:00:09 +02:00
Krzysztof Korościk d436ab6b0d po: updated polish translation 2021-05-23 18:25:01 +02:00
Sébastien Helleu 0886b38725 doc: update German auto-generated file 2021-05-23 08:15:33 +02:00
Nils Görs e3f4c4811f core: update German translations 2021-05-22 23:42:16 +02:00
Sébastien Helleu 35b35f6923 core: fix typo 2021-05-22 09:47:30 +02:00
Sébastien Helleu f8419c6aa6 doc: update auto-generated files 2021-05-22 09:17:36 +02:00
Sébastien Helleu 9ac3f887a5 core: add split of commands before evaluation in release notes (issue #1643) 2021-05-22 09:16:32 +02:00
Sébastien Helleu 15b001b011 core: update translations (issue #1643) 2021-05-22 08:58:36 +02:00
Sébastien Helleu d949ebb088 core: split signal command before evaluating it (issue #1643) 2021-05-22 08:52:46 +02:00
Sébastien Helleu b74af1d2da core: split startup command before evaluating it (issue #1643) 2021-05-22 08:51:38 +02:00
Sébastien Helleu e350437c81 irc: split server command before evaluating it (issue #1643) 2021-05-22 08:48:24 +02:00
Sébastien Helleu 4065972000 core: fix tests when NLS is disabled 2021-05-21 13:51:47 +02:00
Giuseppe Bilotta 916f57f31d core: fix build error if ENABLE_NLS is OFF
wee-eval.c calls gettext directly, but gettext is not a function if
ENABLE_NLS is off. Fix by defining a gettext macro (that expands to its
first argument) if NLS support is disabled.
2021-05-21 13:22:05 +02:00
Sébastien Helleu badd231b82 core: add build without NLS in CI 2021-05-21 13:19:16 +02:00
Sébastien Helleu 2f2cf55f74 doc: format script with black 2021-05-20 20:07:36 +02:00
Nils Görs 5d4ee9e471 core: update German translations 2021-05-20 14:19:01 +02:00
Sébastien Helleu d09fe80fd1 core: merge two entries into one about GnuTLS options 2021-05-18 21:34:24 +02:00
Sébastien Helleu 447abad79e core: display old default values for options affected by XDG directories in release notes 2021-05-18 21:30:34 +02:00
Sébastien Helleu b43958ac92 irc: use constant GNUTLS_TLS1_3 only with GnuTLS >= 3.6.3
This constant was introduced in GnuTLS 3.6.3.

This fixes a build error on these old distributions:

- Debian Stretch
- Debian Jessie
- Ubuntu Bionic
- Ubuntu Xenial
2021-05-17 12:59:41 +02:00
Sébastien Helleu a071ee5012 tests: remove dependency on French locale in eval tests 2021-05-16 20:17:07 +02:00
Sébastien Helleu cf7ac76de9 tests: add missing include of locale.h in eval tests 2021-05-16 19:09:18 +02:00
Sébastien Helleu 215f12d859 tests: remove commented includes 2021-05-16 19:08:35 +02:00
Nils Görs 59d1811987 core: update German translations 2021-05-16 16:29:54 +02:00
Sébastien Helleu 89e43eaf40 core: set server name when connecting to server with TLS (SNI extension) only if it's not an IPV4/IPv6 (closes #1635) 2021-05-16 14:52:11 +02:00
Sébastien Helleu e03642e9df tests: add tests on translation in evaluated expressions 2021-05-16 14:09:07 +02:00
Sébastien Helleu 58c66474ce core: add contributor (issue #1609) 2021-05-16 13:50:19 +02:00
Emir Sarı 431b799b01 core: update Turkish translations (issue #1609) 2021-05-16 13:39:44 +02:00
Sébastien Helleu 4c25151f31 core: move build option CA_FILE in build section 2021-05-16 10:11:23 +02:00
Sébastien Helleu dd916d5e52 doc: update auto-generated files 2021-05-16 10:08:04 +02:00
Sébastien Helleu d18680e442 core: update ChangeLog (issue #1622) 2021-05-16 10:01:17 +02:00
Sébastien Helleu 92410e9949 irc: sort config options alphabetically (issue #1622) 2021-05-16 10:01:14 +02:00
Sébastien Helleu e6a3d08704 buflist, irc, xfer: do not translate "cleartext" in buffer local variable "tls_version" (issue #1622)
The text "cleartext" is translated for display only: directly with gettext in
IRC plugin and with "${translate:${tls_version}}" in the buflist evaluated
format.
2021-05-16 10:01:07 +02:00
Sébastien Helleu 5bce484c01 api: add translated string in evaluation of expressions with "translate:xxx" (issue #1622) 2021-05-16 10:01:03 +02:00
Sébastien Helleu 7e10038f4b core: update translations (issue #1622) 2021-05-16 10:00:57 +02:00
Andrew Potter 94c902adfc irc, buflist: add bar item "tls_version" with options for colors, add buflist format "${format_tls_version}" (issue #1622) 2021-05-16 10:00:30 +02:00
Nils Görs 670c5cd745 core: update German translations 2021-05-15 23:45:36 +02:00
Sébastien Helleu a7db77e253 core: remove obsolete translations 2021-05-15 16:53:14 +02:00
Sébastien Helleu 3102eccda2 core: fix French translation of /help fifo 2021-05-15 16:52:43 +02:00
Sébastien Helleu b714d3dc91 core: fix punctuation in German translation 2021-05-15 14:40:01 +02:00
Nils Görs 0d8aeee738 core: update German translations 2021-05-15 13:58:01 +02:00
Sébastien Helleu 9d96d5d450 doc: add missing names for anchors in scripting guide 2021-05-14 19:19:49 +02:00
Sébastien Helleu 168dbaf020 doc: add link to Python stub in scripting guide (issue #1377) 2021-05-14 19:19:45 +02:00
Sébastien Helleu 13cb870b9a core: add generator and Python stub file for WeeChat API (issue #1377) 2021-05-14 19:19:45 +02:00
Sébastien Helleu a5903e8020 doc: add type annotations in Python prototype (scripting guide) (issue #1377) 2021-05-13 20:24:59 +02:00
Sébastien Helleu fafe2c9d2e doc: add type annotations in Python prototypes (plugin API reference) (issue #1377) 2021-05-13 20:24:59 +02:00
Sébastien Helleu 3e122ed900 doc: add types of constants in scripting guide (issue #1377) 2021-05-13 15:47:21 +02:00
Sébastien Helleu 33767b22f3 doc: fix translations in Italian and Japanese plugin API reference 2021-05-13 09:57:50 +02:00
Sébastien Helleu 11b311ce2f core: add GnuTLS CA changes in release notes 2021-05-12 21:00:21 +02:00
Sébastien Helleu bbdeb51bc1 doc: add missing French translations in user's guide 2021-05-12 20:44:07 +02:00
Sébastien Helleu c588ee21bc core: improve options to load GnuTLS system/user CAs (closes #972)
Changes:

* new option: weechat.network.gnutls_ca_system
* option weechat.network.gnutls_ca_file renamed to
  weechat.network.gnutls_ca_user
* reload certificates when options are changed
* remove build option CA_FILE
2021-05-12 20:39:40 +02:00
Sébastien Helleu b7112e4090 core: add slack.py version in release notes 2021-05-11 22:41:13 +02:00
Sébastien Helleu be575e5400 core: update translations (issue #1285) 2021-05-11 21:39:46 +02:00
Sébastien Helleu 7f8f5f94e3 core: update ChangeLog (issue #1285) 2021-05-11 21:07:43 +02:00
Sébastien Helleu 6e528a1d62 core: add XDG directories in release notes (issue #1285) 2021-05-11 21:07:41 +02:00
Sébastien Helleu a9e210121b fifo: add PID in default FIFO pipe filename (issue #1285)
This is to prevent two WeeChat using the same runtime directory to use the same
FIFO pipe.
2021-05-11 21:07:39 +02:00
Sébastien Helleu 6925ea3ccb doc: add missing names for anchors in user's guide (issue #1285) 2021-05-11 21:07:36 +02:00
Sébastien Helleu 70cdf21681 doc: add XDG directories support in docs (issue #1285) 2021-05-11 21:07:30 +02:00
Sébastien Helleu 87d4ea9286 doc: remove tag "translation missing" in French user's guide (issue #1285) 2021-05-11 21:07:28 +02:00
Sébastien Helleu d9f5bce6ee doc: add file wee-dir.c in developer's guide (issue #1285) 2021-05-11 21:07:26 +02:00
Sébastien Helleu f71b4f78fd doc: add link to CMake option in environment variable WEECHAT_HOME (user's guide) (issue #1285) 2021-05-11 21:07:24 +02:00
Sébastien Helleu a3f8647a72 doc: change default value of WEECHAT_HOME CMake option to empty string (user's guide) (issue #1285) 2021-05-11 21:07:21 +02:00
Sébastien Helleu 664fb12db7 doc: remove wrong default value of option weechat.network.gnutls_ca_file (user's guide) (issue #1285) 2021-05-11 21:07:19 +02:00
Sébastien Helleu cb4c3b0226 doc: use XDG config directory in Relay SSL chapter (user's guide) (issue #1285) 2021-05-11 21:07:17 +02:00
Sébastien Helleu 7d75d82f6a doc: use XDG config directory in chapter on IRC server certificate (user's guide) (issue #1285) 2021-05-11 21:07:15 +02:00
Sébastien Helleu 49844a71f0 doc: use XDG config directory in SASL ECDSA-NIST256P-CHALLENGE chapter (user's guide) (issue #1285) 2021-05-11 21:07:11 +02:00
Sébastien Helleu 5210d501d4 doc: replace "%h" by "${weechat_config_dir}" in examples of values for IRC server option "ssl_cert" (user's guide) (issue #1285) 2021-05-11 21:07:09 +02:00
Sébastien Helleu 3833b965e4 doc: replace "%h" by "${weechat_config_dir}" in examples of values for IRC server option "sasl_key" (user's guide) (issue #1285) 2021-05-11 21:07:07 +02:00
Sébastien Helleu 703106a31f core: mention evaluation with string_eval_path_home for CMake/autotools option CA_FILE (issue #1285) 2021-05-11 21:07:04 +02:00
Sébastien Helleu 43ba8d3b73 xfer: remove "%h" from /help xfer.file.upload_path (issue #1285) 2021-05-11 21:07:02 +02:00
Sébastien Helleu 6170f97cd6 xfer: change default value of option xfer.file.download_path to "${weechat_data_dir}/xfer" (issue #1285) 2021-05-11 21:07:00 +02:00
Sébastien Helleu 19bf10647c script: change default value of option script.scripts.path to "${weechat_cache_dir}/script" (issue #1285) 2021-05-11 21:06:58 +02:00
Sébastien Helleu 4459119409 relay: change default value of option relay.network.ssl_cert_key to "${weechat_config_dir}/ssl/relay.pem" (issue #1285) 2021-05-11 21:06:56 +02:00
Sébastien Helleu 047a668275 relay: remove "%h" from help on UNIX socket path option (issue #1285) 2021-05-11 21:06:54 +02:00
Sébastien Helleu 36847bd305 relay: remove "%h" from /help relay (issue #1285) 2021-05-11 21:06:51 +02:00
Sébastien Helleu 005ef8a4a9 logger: change default value of option logger.file.path to "${weechat_data_dir}/logs" (issue #1285) 2021-05-11 21:06:49 +02:00
Sébastien Helleu 7e79145d46 fifo: change default value of option fifo.file.path to "${weechat_runtime_dir}/weechat_fifo" (issue #1285) 2021-05-11 21:06:46 +02:00
Sébastien Helleu d2c5bba356 core: change default value of option weechat.plugin.path to "${weechat_data_dir}/plugins" (issue #1285) 2021-05-11 21:06:42 +02:00
Sébastien Helleu 0f9640a5f3 core: split WeeChat home in 4 directories, use XDG directories by default (issue #1285)
The 4 directories (which can be the same):

- config: configuration files, certificates
- data: log/upgrade files, local plugins, scripts, xfer files
- cache: script repository, scripts downloaded (temporary location)
- runtime: FIFO pipe, relay UNIX sockets
2021-05-11 21:06:34 +02:00
Sébastien Helleu 4c5fcb743b core: move home directory functions from weechat.c to wee-dir.c (issue #1285) 2021-05-11 21:06:32 +02:00
Sébastien Helleu 269576eea2 core: move directory/file functions from wee-util.c to wee-dir.c (issue #1285) 2021-05-11 21:06:29 +02:00
Sébastien Helleu 9eecad496d logger: remove unused variable weechat_dir (issue #1285) 2021-05-11 21:06:27 +02:00
Sébastien Helleu 5361722699 core: set WeeChat home to empty string by default in CMake and autotools (issue #1285) 2021-05-11 21:06:24 +02:00
Sébastien Helleu e07221d7c5 relay: evaluate option relay.network.ssl_cert_key (issue #1285) 2021-05-11 21:06:22 +02:00
Sébastien Helleu 39b629550b irc: evaluate options irc.server_default.ssl_cert and irc.server.xxx.ssl_cert (issue #1285) 2021-05-11 21:06:19 +02:00
Sébastien Helleu d7d594873b irc: evaluate options irc.server_default.sasl_key and irc.server.xxx.sasl_key (issue #1285) 2021-05-11 21:06:17 +02:00
Sébastien Helleu f923524a21 core: evaluate option weechat.plugin.path (issue #1285) 2021-05-11 21:06:13 +02:00
Sébastien Helleu e5d18e1221 core: evaluate option weechat.network.gnutls_ca_file (issue #1285) 2021-05-11 21:05:42 +02:00
Sébastien Helleu 9e7d052517 core: update ChangeLog (issue #1636) 2021-05-08 07:33:17 +02:00
Sébastien Helleu f3f3c54372 core: add detection of function mallinfo2 in autotools (issue #1636) 2021-05-08 07:33:12 +02:00
Andrew Potter b222e75019 core: Use mallinfo2() when available
mallinfo() is deprecated in glibc 2.33
2021-05-08 07:25:44 +02:00
Sébastien Helleu aa7860c942 doc: update German auto-generated file 2021-05-05 13:59:04 +02:00
Sébastien Helleu ed560a785a doc: fix list of supported OS in FAQ 2021-05-05 13:57:11 +02:00
Sébastien Helleu e95fdc3a0a core: display a warning when the file with certificate authorities is not found (option weechat.network.gnutls_ca_file) 2021-05-04 20:37:15 +02:00
Sébastien Helleu 9f0e7fb47e xfer: make file transfer fail when option xfer.file.auto_rename is off and file already exists (closes #1633) 2021-04-26 20:51:17 +02:00
Nils Görs bcd889cf90 doc: update German documentation 2021-04-21 07:53:47 +02:00
Sébastien Helleu 65ea67204c doc: translate changes in chapter on bar conditions (user's guide) 2021-04-18 12:08:11 +02:00
Tobias Rehbein 2c674a54d4 doc: Update weechat.bar.*.condition to use info:term_width
In cf93e953b the `weechat.bar.*.condition` examples have been changed to use
`${info:term_width}` instead of `${window.win_width}`. The user guide still
shows the old example. This commit syncs the user guide with the on-line help.
2021-04-18 12:00:29 +02:00
Nils Görs 2fbedfec1a doc: update German documentation 2021-04-18 09:58:09 +02:00
Sébastien Helleu 1181ac069e doc: add link to Archlinux wiki page about core dump files (user's guide) 2021-04-17 14:21:50 +02:00
Nils Görs 950c2bb898 core: update German translations 2021-04-13 11:44:40 +02:00
Sébastien Helleu 6b62456119 Revert "core: add option "-save" in command /upgrade (closes #1630)"
This reverts commit 1df1903d23.

This is not so easy to implement: it requires saving state of plugins, and
plugins like irc can not save the connected state (except in a real upgrade
case where the sockets are still valid after exec of the new binary).
2021-04-13 00:11:11 +02:00
Sébastien Helleu 1df1903d23 core: add option "-save" in command /upgrade (closes #1630) 2021-04-12 20:48:32 +02:00
Sébastien Helleu ae39b7ce61 tests: fix if/else blocks in trigger tests 2021-04-11 10:42:24 +02:00
Sébastien Helleu 044bcd0751 doc: improve display of WeeChat version in info_hashtable "irc_message_parse" (scripting guide) 2021-04-11 09:47:13 +02:00
Sébastien Helleu 5d30e0faac doc: mark info "python2_bin" as deprecated since version 2.6 (plugin API reference) 2021-04-11 09:31:49 +02:00
Sébastien Helleu e58c827c91 trigger: add tests on main trigger functions 2021-04-11 09:20:49 +02:00
Sébastien Helleu 1f0636bab6 irc: remove unused variable ptr_address and dead code 2021-04-10 14:11:11 +02:00
Sébastien Helleu 7bd23700de irc: remove dead assignment on variable pos_message 2021-04-10 13:26:46 +02:00
Sébastien Helleu 937ecb62c4 trigger: remove useless test 2021-04-10 12:21:16 +02:00
Sébastien Helleu 2e67b13edd trigger: check that option is not NULL in function trigger_search_with_option 2021-04-09 21:36:12 +02:00
Sébastien Helleu 7c5cbefd51 trigger: fix description of function trigger_name_valid 2021-04-08 20:56:37 +02:00
Sébastien Helleu b6b78df3d2 trigger: check that trigger is not NULL in functions trigger_rename and trigger_copy 2021-04-08 20:55:37 +02:00
Nils Görs 4da5647e9f doc: update German documentation 2021-04-07 12:38:35 +02:00
Sébastien Helleu fae9bdf8f8 trigger: add variables "${tg_shell_argc}" and "${tg_shell_argvN}" in command trigger evaluated strings (closes #1624) 2021-04-06 18:37:22 +02:00
Sébastien Helleu 3bf585ba04 core: evaluate left/right part of comparison after split on the comparison operator in ${if:xxx} (closes #1627)
To force evaluation of the expression before doing the comparison (less safe),
the "${eval_cond:xxx}" can be used.

With the old behavior we had:

    >> ${if:a==b}
    == [0]
    >> ${if:${raw:a==b}}
    == [0]
    >> ${if:${eval_cond:${raw:a==b}}}
    == [0]

And with the new behavior, we have:

    >> ${if:a==b}
    == [0]
    >> ${if:${raw:a==b}}
    == [1]
    >> ${if:${eval_cond:${raw:a==b}}}
    == [0]
2021-04-04 14:44:18 +02:00
Sébastien Helleu 1aefb0a546 doc: update German auto-generated file 2021-03-29 22:32:56 +02:00
Nils Görs efd5a8bd14 core: update German translations 2021-03-29 09:22:07 +02:00
Sébastien Helleu 4f606ceb64 buflist: improve help on option buflist.look.sort 2021-03-21 09:34:40 +01:00
Sébastien Helleu 027966e5e9 core: update ChangeLog (issue #1621) 2021-03-21 09:01:08 +01:00
Trygve Aaberge 6b23d855d8 buflist: Fix wrong pointers being used in hdata_compare
This used pointer1 and pointer2 which are pointers to the buffers, but
it should use ptr_hotlist1 and ptr_hotlist1 which are pointers to the
hotlists it is trying to compare.
2021-03-21 08:59:37 +01:00
Sébastien Helleu e8a58a27cd core: update ChangeLog (issue #1591, issue #1592) 2021-03-20 13:08:35 +01:00
Trygve Aaberge 472eab38e5 core: Prevent switching to start of visited buffers when jumping to next
If you run /input jump_next_visited_buffer right after switching to a
buffer, weechat changes to the first buffer in the visited buffers list.
That is, it wraps around and goes to the buffer you visited the longest
ago. This patch fixes that.

The reason it happens is that when you switch to a buffer (normally,
i.e. in another way than using jump_previously_visited_buffer/
jump_next_visited_buffer) gui_buffers_visited_index is set to -1 (in
gui_buffer_visited_add). This makes gui_buffer_visited_get_index_next
return 0 because it returns gui_buffers_visited_index + 1, which makes
gui_input_jump_next_visited_buffer jump to the first buffer in the list
of visited buffers.

Fixes #1591
2021-03-20 13:07:20 +01:00
Sébastien Helleu aa4beb99e8 doc: update German auto-generated file 2021-03-20 09:20:51 +01:00
Nils Görs 741c1b4e87 doc: update German documentation 2021-03-20 07:52:35 +01:00
Nils Görs a715403d60 core: update German translations 2021-03-20 06:36:19 +01:00
Sébastien Helleu 40ab0bb11e core: update ChangeLog 2021-03-19 23:27:00 +01:00
Sébastien Helleu 3b76a8dd82 core: add repository ppa:ondrej/php in CI 2021-03-19 07:12:23 +01:00
Sébastien Helleu bcddb06094 core: do not force build of JavaScript plugin in CI 2021-03-19 09:14:59 +01:00
Sébastien Helleu 611ea27edc tests: disable pylint error useless-object-inheritance 2021-03-19 09:14:59 +01:00
Sébastien Helleu bacd50c7a7 core: replace pylint3 by pylint in CI on Ubuntu 20.04 2021-03-19 09:14:59 +01:00
Sébastien Helleu da91ddef98 core: first remove package php7.4-common in CI on Ubuntu 20.04
See: https://github.com/actions/virtual-environments/issues/2859
2021-03-19 09:14:59 +01:00
Sébastien Helleu 692d313fe3 core: switch from Ubuntu 18.04 to 20.04 in CI 2021-03-19 09:14:59 +01:00
Sébastien Helleu 4d96a3a84d core: add pointer name in description of function eval_replace_vars_cb 2021-03-18 07:35:12 +01:00
Sébastien Helleu 0d5b7ae9d0 doc: update German auto-generated files 2021-03-17 21:58:18 +01:00
Sébastien Helleu 8ee7d46605 api: add support of pointer names in function string_eval_expression (direct and in hdata)
These two formats are now supported, if "pointer_name" is present in the
"pointers" hashtable:

* "${pointer_name}": value of pointer (example: "0x1234abcd")
* ${buffer[pointer_name].full_name}: use of a pointer name instead of pointer
  value or list name
2021-03-17 21:57:16 +01:00
Sébastien Helleu c54cadace5 tests: use macros UINT32_C and UINT64_C for integer constants of type uint32_t and uint64_t
This fixes the following compiler warnings: "integer constant is so large that
it is unsigned".
2021-03-17 21:56:43 +01:00
Nils Görs 84d9de798a core: update German translations 2021-03-17 14:16:16 +01:00
Sébastien Helleu e4ff17e162 doc: add section "plugin" in weechat.conf (user's guide) 2021-03-16 19:03:45 +01:00
Sébastien Helleu 0dc7fbcb0c core: add options to customize commands on system signals, quit by default on SIGHUP when not running headless (closes #1595)
New options to customize behavior on signals received, with the default
behavior:

- weechat.signal.sighup: quit in normal mode, reload config in headless
- weechat.signal.sigquit: quit
- weechat.signal.sigterm: quit
- weechat.signal.sigusr1: no command executed by default
- weechat.signal.sigusr2: no command executed by default

The signals SIGUSR1 and SIGUSR2 are introduced by this commit, so it's now
possible to run commands when they are received.

The SIGHUP signal makes now WeeChat quit, it was the behavior before version
2.9 of WeeChat (see commit de1e61f7cd).
2021-03-16 18:47:31 +01:00
Sébastien Helleu bb41de8c02 api: add info "weechat_daemon" 2021-03-14 14:11:06 +01:00
Sébastien Helleu a02a2fbaae doc: use full path /usr/bin/pass in example for option sec.crypt.passphrase_command 2021-03-14 13:38:50 +01:00
Sébastien Helleu e37f2569f9 core: mention /fset command in header comment of configuration files 2021-03-14 11:36:07 +01:00
Sébastien Helleu ab282db3a6 core: update ChangeLog (closes #1618) 2021-03-14 10:56:51 +01:00
Sébastien Helleu 8c793fe7cc fset: add fset bar on configuration reload (issue #1618) 2021-03-14 10:56:24 +01:00
Sébastien Helleu 35b5adbc4c buflist: always add buflist bar when plugin is loaded, hide bar by default if buflist is disabled (issue #1618) 2021-03-14 10:55:48 +01:00
Sébastien Helleu a4440ba8e5 buflist: add buflist bar on configuration reload (issue #1618) 2021-03-14 10:55:24 +01:00
Nils Görs 3bdae5b464 doc: update German documentation 2021-03-13 23:56:16 +01:00
Sébastien Helleu d2c56084f8 doc: add upgrade chapter in user's guide 2021-03-13 15:17:01 +01:00
Sébastien Helleu 5311c103d5 debian: update debian/ubuntu patches with new Standards-Version 2021-03-08 20:48:06 +01:00
Sébastien Helleu 39bd4e2099 debian: fix watch according to download page changes 2021-03-08 20:38:25 +01:00
Sébastien Helleu 35ca5cde9c debian: bump Standards-Version to 4.5.1 2021-03-08 20:37:43 +01:00
Sébastien Helleu c49255a851 core: add missing include of sys/time.h in C headers 2021-03-07 13:21:24 +01:00
Sébastien Helleu 2b1c2d6d05 Version 3.2-dev 2021-03-07 12:11:55 +01:00
Sébastien Helleu ae2f25109c Version 3.1 2021-03-07 11:54:55 +01:00
Sébastien Helleu 7dd7da1d7b core: reorder release notes for version 3.1 2021-03-07 09:45:06 +01:00
Sébastien Helleu 3983e9fa1e core: fix compilation of tests on FreeBSD 2021-03-07 09:33:06 +01:00
Sébastien Helleu 4307733853 debian: update changelog 2021-03-07 08:57:53 +01:00
Sébastien Helleu 4014c1140a doc: update Polish auto-generated files 2021-03-06 19:02:53 +01:00
Krzysztof Korościk 65a732449e doc: updated polish user guide 2021-03-06 18:49:12 +01:00
Krzysztof Korościk 4fd3c5e1d6 po: updated polish translation 2021-03-06 18:10:42 +01:00
Sébastien Helleu e9c8b8bf0f core: add contributor in AUTHORS.adoc (issue #1615) 2021-03-05 21:00:17 +01:00
Sébastien Helleu ca4d7b37c6 core: fix pt_BR translations 2021-03-05 20:51:43 +01:00
Érico Rolim 23a3096e1d core: update pt_BR translations. 2021-03-05 20:50:50 +01:00
Sébastien Helleu c17aeeba29 core: force Ubuntu 18.04 for CI 2021-03-05 20:45:31 +01:00
Sébastien Helleu c3cc06ff27 core: fix quoted line in cursor mode (closes #1602)
Regression was introduced in version 2.7 by commit
93d2dbf3e1.
2021-02-28 17:13:52 +01:00
Sébastien Helleu 3ca58c2fd9 Version 3.1-rc1 2021-02-28 12:06:49 +01:00
Sébastien Helleu 1862f4b3d2 core: add missing "xxx" in format of evaluated expressions (ChangeLog) 2021-02-28 12:03:47 +01:00
Nils Görs f06d434a0c Merge branch 'master' of https://github.com/weechat/weechat 2021-02-27 13:58:11 +01:00
Nils Görs 00d6183cd8 doc: update German documentation 2021-02-27 13:57:49 +01:00
Sébastien Helleu ceaf480ba7 core: fix paragraph in release notes 2021-02-27 13:49:55 +01:00
Sébastien Helleu 0f71b4ccc8 irc: add bar item "irc_nick_prefix" 2021-02-27 13:44:24 +01:00
Sébastien Helleu a811da3a42 doc: add missing available bar items (user's guide) 2021-02-27 12:56:09 +01:00
Sébastien Helleu 83379469aa irc: fix separator between nick and host in bar item "irc_nick_host"
Use "!" instead of "@" to separate nick from host, like it is done in IRC
protocol.

The nick and host is now displayed as "nick!user@host" instead of
"nick@user@host".
2021-02-27 09:02:09 +01:00
Sébastien Helleu 6a7da6d473 fset: fix description of function fset_bar_item_fset_cb 2021-02-27 08:57:32 +01:00
Sébastien Helleu 7b15742a11 doc: fix example of value for bar item "irc_nick_modes" (user's guide) 2021-02-26 18:45:21 +01:00
Sébastien Helleu 5339e6aa17 doc: update German auto-generated file 2021-02-26 18:41:14 +01:00
Nils Görs 2a31544242 core: update German translations 2021-02-26 14:02:42 +01:00
Sébastien Helleu 3d587ad37d core: add info_hashtable "secured_data" 2021-02-25 19:06:47 +01:00
Sébastien Helleu 5725c8561c doc: remove references to Savannah in developer's guide 2021-02-20 11:12:14 +01:00
Sébastien Helleu 49ac7dd9f5 doc: split dependencies in two tables: required and optional (user's guide) 2021-02-19 20:12:18 +01:00
Sébastien Helleu d10e8342d3 core: convert "totp" to upper case in ChangeLog 2021-02-16 07:47:42 +01:00
Sébastien Helleu 1a86036edb doc: update German auto-generated file 2021-02-11 07:16:11 +01:00
Sébastien Helleu ab47c1abf7 core: move line from "New features" to "Bug fixes" (issue #1612) 2021-02-11 07:12:55 +01:00
Nils Görs 69af1ac0ae core: update German translations 2021-02-10 08:10:06 +01:00
Sébastien Helleu b6a935b1c3 core: move line to appropriate version in ChangeLog 2021-02-10 07:56:43 +01:00
Sébastien Helleu 45c372ebc8 core: move line from "New features" to "Bug fixes" (issue #1613) 2021-02-09 20:42:58 +01:00
Sébastien Helleu 840551dcfa doc: update German auto-generated files 2021-02-09 20:37:35 +01:00
Sébastien Helleu 630fe0581f buflist: add option buflist.look.use_items to speed up display of buflist (closes #1613) 2021-02-09 20:34:56 +01:00
Sébastien Helleu d74f2e3183 core: add fixed behavior of command /window splitv in release notes 2021-02-09 20:19:22 +01:00
Sébastien Helleu 00409cba6a core: fix wrong size of the new window after vertical split (closes #1612) 2021-02-08 18:47:44 +01:00
Nils Görs 8a6a135b45 core: update German translations 2021-02-08 13:41:59 +01:00
Sébastien Helleu 47112a113e core: update help on option sec.crypt.passphrase_command, update translations 2021-02-08 13:12:54 +01:00
Sébastien Helleu d08e9aed1c core: update translations 2021-02-07 11:00:12 +01:00
Sébastien Helleu 1c3c8c92c7 core: update ChangeLog (closes #992, closes #993) 2021-02-07 09:52:15 +01:00
Kevin Pulo df12f8de34 core: add options weechat.look.hotlist_update_on_buffer_switch and weechat.look.read_marker_update_on_buffer_switch
Both default to "on" (no change to previous behavior).

If hotlist_update_on_buffer_switch is "off", then when switching away from a
buffer, the hotlist is not cleared.

If read_marker_update_on_buffer_switch is "off", then when switching away from
a buffer, the read marker is not set to the end of the buffer.

This allows users to choose to have fully manual control over when hotlist
counts and buffer read markers are reset.

Fixes #992.
2021-02-07 09:48:19 +01:00
Sébastien Helleu 84d4be1bee core: update ChangeLog (remove option sec.crypt.passphrase_file) 2021-02-06 16:20:11 +01:00
Sébastien Helleu f1c681c832 core: replace option sec.crypt.passphrase_file by sec.crypt.passphrase_command (closes #141)
The command is used to read the passphrase on startup, for example using your
favorite password manager.

Note: only the passphrase is read from the program, the secured data is still
stored encrypted in sec.conf and handled by WeeChat itself.
2021-02-06 16:07:14 +01:00
Sébastien Helleu fe9ec8fbda doc: update German auto-generated files 2021-02-05 20:08:18 +01:00
Sébastien Helleu a93e598c35 core: add raw string in evaluation of expressions with "raw:xxx" (closes #1611) 2021-02-05 20:07:16 +01:00
Nils Görs 64fe602aae core: update German translations 2021-02-05 10:56:49 +01:00
Sébastien Helleu a34959a619 irc: add info "irc_is_message_ignored" 2021-02-03 18:30:32 +01:00
Sébastien Helleu 42a86f0a36 core: add version 3.0.1 in ChangeLog, release notes and weechat.spec 2021-01-31 10:38:57 +01:00
Nils Görs a250a50ca5 core: update German translations 2021-01-31 10:32:26 +01:00
Nils Görs 8bdc58f32d core: update German translations 2021-01-31 09:32:26 +01:00
Sébastien Helleu 691c9a0a0f irc: add function irc_server_get_chantypes 2021-01-30 10:34:23 +01:00
Sébastien Helleu 0c98b0cfa4 irc: use server option "default_chantypes" as fallback in function irc_nick_is_nick 2021-01-30 09:59:04 +01:00
Sébastien Helleu ba892ee5a0 core: update translations 2021-01-30 09:55:02 +01:00
Sébastien Helleu a11c90ab70 core: add contributor in AUTHORS.adoc (issue #1610) 2021-01-30 09:34:30 +01:00
Sébastien Helleu 201979fa8d doc: update auto-generated files with options 2021-01-30 09:32:59 +01:00
Sébastien Helleu dd589cd141 irc: use server option "default_chantypes" as fallback when automatically adding channel type on join 2021-01-30 09:31:31 +01:00
Sébastien Helleu e305b4e960 core: update ChangeLog 2021-01-30 09:25:55 +01:00
Sébastien Helleu ec2ffedab6 irc: improve help on server option "default_chantypes" 2021-01-30 09:25:06 +01:00
Sébastien Helleu 293402143b irc: fix name of option "default_chantypes" in list of server options 2021-01-30 09:24:34 +01:00
Sébastien Helleu e74dd22707 irc: simplify code in function irc_channel_is_channel 2021-01-30 09:05:49 +01:00
Matti Virkkunen bad6dc8a57 irc: make default chantypes configurable 2021-01-30 01:01:51 +02:00
Nils Görs dc8df133ea doc: update German documentation 2021-01-27 07:48:05 +01:00
Sébastien Helleu d465ec2a39 doc: update Polish auto-generated files 2021-01-27 00:06:34 +01:00
Sébastien Helleu fd672a0fa4 doc: add a second note on default configuration files in user's guide 2021-01-27 00:04:30 +01:00
Sébastien Helleu 7b1b482cc7 core: add command "/buffer listvar" in release notes 2021-01-26 23:39:49 +01:00
Sébastien Helleu 7255fac60b core: add contributor in AUTHORS.adoc (issue #1607) 2021-01-16 13:35:54 +01:00
Sébastien Helleu bb6152d8a3 core: update ChangeLog 2021-01-16 13:20:14 +01:00
Jan Palus b142617cca doc: don't build headless man page if headless is disabled 2021-01-16 13:15:45 +01:00
Krzysztof Korościk 1c3cb4364d po: updated polish translation 2021-01-15 21:35:27 +01:00
Krzysztof Korościk c81eac325d doc: updated polish translation 2021-01-15 21:17:37 +01:00
Sébastien Helleu 25ed384418 doc: add missing non-breaking spaces before punctuation in French docs 2021-01-09 20:22:22 +01:00
Nils Görs 84b02c1296 core: update German translations 2021-01-05 09:15:43 +01:00
Sébastien Helleu efc7a588d6 core: update copyright dates 2021-01-02 21:34:16 +01:00
Sébastien Helleu df4b9170f1 irc: remove obsolete comment on translation 2021-01-02 15:22:02 +01:00
Sébastien Helleu b8acaf8a14 irc: fix ambiguity on translation of word "server"
This fixes the following warning:

/usr/bin/xgettext: warning: msgid 'server' is used without plural and with plural.
                            ./src/plugins/irc/irc-bar-item.c:136: Here is the occurrence without plural.
                            ./src/plugins/irc/irc.c:154: Here is the occurrence with plural.
                            Workaround: If the msgid is a sentence, change the wording of the sentence; otherwise, use contexts for disambiguation.
2021-01-02 15:18:26 +01:00
Sébastien Helleu 470e3ef9cf core: move debug_id assignation in macro EVAL_DEBUG_MSG 2021-01-02 14:43:40 +01:00
Sébastien Helleu 943374f789 doc: add note about call to "regfree" after call to "string_regcomp" (plugin API reference) 2021-01-01 18:10:47 +01:00
Sébastien Helleu d413ccdf4f core: add indentation and colors in /eval debug output 2021-01-01 17:08:59 +01:00
Sébastien Helleu 63ead3da49 doc: update German auto-generated file 2021-01-01 15:47:35 +01:00
Nils Görs 565837f75a core: update German translations 2021-01-01 11:21:57 +01:00
Sébastien Helleu 2ad3da03a2 core: display more verbose debug with two "-d" in command /eval
Now a single -d in command /eval shows less debug messages than previous
versions.

To get the same debug messages than previous versions, two -d must be used.
2020-12-31 20:37:43 +01:00
Sébastien Helleu 33c7b96146 core: fix typo in comment 2020-12-30 23:02:37 +01:00
Nils Görs 7b13bb5cf9 doc: update German documentation 2020-12-28 10:14:42 +01:00
Sébastien Helleu 9bc194c898 doc: update question about config files sharing (FAQ) 2020-12-28 00:17:05 +01:00
Sébastien Helleu 0942b04c52 doc: add info about sensitive data in relay.conf (user's guide) 2020-12-28 00:08:45 +01:00
Sébastien Helleu 2e3cef4c41 doc: update Polish auto-generated files 2020-12-27 21:56:10 +01:00
Krzysztof Korościk 05a9a7904c po: updated polish translation 2020-12-27 19:05:51 +01:00
Sébastien Helleu ee9aa28a8c core: do not remove quotes in arguments of command /eval (closes #1601)
Now, /eval -n -c "a" == "a" returns True instead of False.

When quotes were removed, the condition evaluated was: a" == "a (which is
False).
2020-12-25 00:21:03 +01:00
Sébastien Helleu a8abfcd7b4 doc: update German auto-generated files 2020-12-21 18:33:48 +01:00
Sébastien Helleu cc5c34d4dc doc: add missing parenthesis in user's guide 2020-12-21 18:31:08 +01:00
Nils Görs f9b4f4e7e6 doc: update German documentation 2020-12-21 13:40:39 +01:00
Nils Görs 18f9ba3c0c core: update German translations 2020-12-21 13:07:23 +01:00
Sébastien Helleu 09f57476d2 doc: add a chapter on buffer local variables (user's guide) 2020-12-19 21:23:16 +01:00
Sébastien Helleu 7e2396ade8 core: add options "setvar" and "delvar" in command /buffer, rename option "localvar" to "listvar"
The option "localvar" (introduced long time ago, in WeeChat 0.3.0) is still
recognized by WeeChat, to stay compatible with any extension/script calling
it (or referencing it in the documentation).

It is deprecated and will be removed in a future release.
2020-12-19 20:59:38 +01:00
Sébastien Helleu 1526f58d7a doc: replace "core" by "weechat" in table with extra info for bar item "buffer_nicklist" (plugin API reference) 2020-12-19 15:00:02 +01:00
Sébastien Helleu 0294b246f6 core: add buffer local variable "completion_default_template" (evaluated) (closes #1600)
When this local variable is set, it overrides the value of option
"weechat.completion.default_template".

It is evaluated, that means the global default template can be used to append
some custom completion. For example:

  /buffer set localvar_set_completion_default_template ${weechat.completion.default_template}|%(my_completion)
2020-12-19 14:25:13 +01:00
Sébastien Helleu e4152c3535 core: remove unneeded return of WEECHAT_RC_OK in filter command 2020-12-18 20:28:41 +01:00
Sébastien Helleu dc5277fe89 core: add option "recreate" in command /filter 2020-12-18 20:28:16 +01:00
Sébastien Helleu 73eabdbe80 doc: update German auto-generated file 2020-12-18 19:55:44 +01:00
Nils Görs 5e17f0039b core: update German translations 2020-12-17 11:05:15 +01:00
Sébastien Helleu 13e4af7b46 script: add status of scripts in output of command /script list in /help script 2020-12-15 20:41:13 +01:00
Nils Görs 1efcaa9752 doc: update German documentation 2020-12-13 11:55:38 +01:00
Sébastien Helleu b95e91e1a2 doc: add command to run WeeChat with address sanitizer (user's guide) 2020-12-13 11:01:04 +01:00
Nils Görs 3dea65aa05 doc: update German documentation 2020-12-07 08:59:07 +01:00
Sébastien Helleu a69cfbdb19 core: add contributor in AUTHORS.adoc (issue #1597) 2020-12-06 15:54:44 +01:00
Sébastien Helleu d01a98950a doc: update auto-generated files with commands 2020-12-06 15:51:12 +01:00
Sébastien Helleu ee25c74903 irc: fix completion of commands /halfop and /dehalfop 2020-12-06 15:48:55 +01:00
Sébastien Helleu cd7947d8fc irc: add missing parameter "-yes" in /help dehalfop 2020-12-06 15:47:52 +01:00
dotflac 4974c2f0a2 add -yes to output of /help voice
currently /help voice does not tell you that you need -yes if you are using *. i have changed it to match /help op, /help deop and /help devoice
2020-12-06 15:43:36 +01:00
Sébastien Helleu 33cdf3eb90 doc: add question about buflist customization 2020-12-06 15:13:55 +01:00
Sébastien Helleu 58a94df61d core: update ChangeLog 2020-12-05 19:57:53 +01:00
Sébastien Helleu 08ebc99dea Revert "exec: return NULL immediately if the task id is invalid"
This reverts commit dff1bf6f0f.
2020-12-05 19:57:24 +01:00
Sébastien Helleu 03f4afe65e Revert "core: add extra compiler options to check overflow of destination buffer and output truncation"
This reverts commit 4ff4a64209.

These compiler flags are not supported on old compiler version, for example on
Debian Stretch/Jessie and Ubuntu Xenial (16.04).
2020-11-29 11:05:38 +01:00
Tim Gates 08db4407ed docs: fix simple typo, confiuration -> configuration
There is a small typo in src/core/weechat.c.

Should read `configuration` rather than `confiuration`.
2020-11-28 09:46:23 +01:00
Sébastien Helleu 4ff4a64209 core: add extra compiler options to check overflow of destination buffer and output truncation 2020-11-28 09:43:57 +01:00
Sébastien Helleu 21aef706cd core: allocate dynamic string size for colors 2020-11-23 21:25:41 +01:00
Sébastien Helleu 345bdddf62 script: increase buffer size in function script_buffer_detail_label
This fixes a compiler warning complaining about a too small buffer for
snprintf, even if this should never happen.
2020-11-22 15:00:19 +01:00
Sébastien Helleu d1cad18f01 core: increase buffer size in function plugin_api_info_uptime_cb
This fixes a compiler warning complaining about a too small buffer for
snprintf, even if this should never happen.
2020-11-22 14:59:06 +01:00
Sébastien Helleu a8dd0e1337 core: increase buffer size in function gui_bar_item_time_cb
This fixes a compiler warning complaining about a too small buffer for
snprintf, even if this should never happen.
2020-11-22 14:56:55 +01:00
Sébastien Helleu 070eb3f7b0 core: increase buffer size in HTTP proxy connection
In case of long address/username/password, the HTTP CONNECT message could be
truncated.
2020-11-21 21:13:13 +01:00
Sébastien Helleu 194f8b5b74 core: increase command buffer size in /color command
In case of long alias name, the command to set color alias could be truncated.
2020-11-21 21:13:05 +01:00
Sébastien Helleu ee24fac586 spell: fix crash with IRC color codes in command line (closes #1589) 2020-11-20 21:50:05 +01:00
Sébastien Helleu a2266e4e3f core: add missing cast to unsigned char on first argument to function isdigit 2020-11-19 22:20:48 +01:00
Sébastien Helleu 214f4f66d9 doc: update German auto-generated file 2020-11-18 22:58:32 +01:00
Nils Görs 14e66962c8 core: update German translations 2020-11-18 09:44:17 +01:00
Sébastien Helleu 5cbda03fca core: fix and normalize error messages 2020-11-17 21:54:24 +01:00
Sébastien Helleu 21eadc9488 core: display an error when the buffer is not found with command /command -buffer 2020-11-17 13:43:20 +01:00
Sébastien Helleu 6fda5a7e5f core: remove option to open a blank issue 2020-11-16 22:58:17 +01:00
Sébastien Helleu b9c8569422 trigger: add variable "${tg_trigger_name}" in command trigger evaluated strings (closes #1580)
${tg_trigger_name} is replaced by the trigger name in these command strings:

- description
- arguments
- description of arguments
- completion
2020-11-14 09:32:24 +01:00
Sébastien Helleu b626df72fb core: add evaluation of conditions in evaluation of expressions with "eval_cond:" (closes #1582) 2020-11-14 09:28:46 +01:00
Sébastien Helleu eb90a73fe8 spell: fix refresh of bar item "spell_suggest" when the input becomes empty (closes #1586)
When the input is empty, length of string is zero: when sending zero to
function weechat_string_dyn_alloc, the function returns NULL and therefore we
return immediately instead of handling the empty input, which is a valid value.

The regression was introduced by the use of dynamic strings, commit:
299f74bfef
2020-11-13 21:30:06 +01:00
Sébastien Helleu 4065d32e68 Version 3.1-dev 2020-11-11 09:30:24 +01:00
701 changed files with 28619 additions and 16745 deletions
+1
View File
@@ -0,0 +1 @@
blank_issues_enabled: false
+13 -8
View File
@@ -1,18 +1,21 @@
name: CI
on: [push, pull_request]
on:
- push
- pull_request
jobs:
build:
name: ${{ matrix.config.name }}
runs-on: ubuntu-latest
runs-on: ubuntu-20.04
strategy:
fail-fast: false
matrix:
config:
- { name: "cmake_gcc", cc: "gcc", cxx: "g++", tool: "cmake", args: "" }
- { name: "cmake_gcc_no_nls", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_NLS=OFF" }
- { name: "cmake_gcc_py2", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_PYTHON2=ON" }
- { name: "cmake_gcc_coverage", cc: "gcc", cxx: "g++", tool: "cmake", args: "-DENABLE_CODE_COVERAGE=ON" }
- { name: "cmake_clang", cc: "clang", cxx: "clang++", tool: "cmake", args: "" }
@@ -25,9 +28,10 @@ jobs:
- name: Install dependencies
run: |
sudo apt-add-repository --yes ppa:ondrej/php
sudo apt-get update -qq
sudo apt-get --yes --no-install-recommends install devscripts equivs python-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.4-dev libphp7.4-embed libargon2-0-dev libsodium-dev pylint3 asciidoctor
sudo -H pip install --ignore-installed msgcheck
sudo apt-get --yes --no-install-recommends install devscripts equivs python3-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python2-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.4-dev libphp7.4-embed libargon2-0-dev libsodium-dev pylint asciidoctor
sudo -H pip3 install --ignore-installed msgcheck
- name: Test patches
run: ./tools/build-debian.sh test-patches
@@ -37,10 +41,11 @@ jobs:
- name: Check Python scripts
run: |
pylint3 --additional-builtins=_ doc/docgen.py
pylint3 tests/scripts/python/testapigen.py
pylint3 tests/scripts/python/testapi.py
pylint3 tests/scripts/python/unparse.py
pylint --additional-builtins=_ doc/docgen.py
pylint doc/python_stub.py
pylint tests/scripts/python/testapigen.py
pylint tests/scripts/python/testapi.py
pylint tests/scripts/python/unparse.py
- name: Build and run tests
env:
+5
View File
@@ -37,12 +37,15 @@ Alphabetically:
* 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
@@ -55,6 +58,7 @@ Alphabetically:
* Hasan Kiran (turgay)
* Ivan Sichmann Freitas
* Jakub Jirutka
* Jan Palus
* Jason A. Donenfeld (zx2c4)
* JD Horelick (jdhore)
* jesopo
@@ -83,6 +87,7 @@ Alphabetically:
* Matt Robinson
* Matthew Horan
* Matthew Martin
* Matti Virkkunen
* Max Anton Teufel
* Maxim Baz
* Michael Siegel
+3 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007-2008 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
#
@@ -134,23 +134,11 @@ if(ENABLE_TESTS AND NOT ENABLE_HEADLESS)
endif()
# option WEECHAT_HOME
if(NOT DEFINED WEECHAT_HOME OR "${WEECHAT_HOME}" STREQUAL "")
set(WEECHAT_HOME "~/.weechat")
endif()
set(WEECHAT_HOME "${WEECHAT_HOME}" CACHE
STRING "WeeChat home directory for config, logs, scripts.. (default is \"~/.weechat\")"
STRING "Force a single WeeChat home directory for config, logs, scripts, etc."
FORCE)
mark_as_advanced(CLEAR WEECHAT_HOME)
# option CA_FILE
if(NOT DEFINED CA_FILE OR "${CA_FILE}" STREQUAL "")
set(CA_FILE "/etc/ssl/certs/ca-certificates.crt")
endif()
set(CA_FILE "${CA_FILE}" CACHE
STRING "File containing the certificate authorities (default is \"/etc/ssl/certs/ca-certificates.crt\"). This is the default value of option \"weechat.network.gnutls_ca_file\"."
FORCE)
mark_as_advanced(CLEAR CA_FILE)
if(COMMAND cmake_policy)
if(POLICY CMP0003)
cmake_policy(SET CMP0003 NEW)
@@ -170,6 +158,7 @@ check_include_files("langinfo.h" HAVE_LANGINFO_CODESET)
check_include_files("sys/resource.h" HAVE_SYS_RESOURCE_H)
check_function_exists(mallinfo HAVE_MALLINFO)
check_function_exists(mallinfo2 HAVE_MALLINFO2)
check_symbol_exists("eat_newline_glitch" "term.h" HAVE_EAT_NEWLINE_GLITCH)
+101 -4
View File
@@ -15,6 +15,103 @@ https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
(file _ReleaseNotes.adoc_ in sources).
[[v3.2]]
== Version 3.2 (2021-06-13)
New features::
* core: use XDG directories by default (config, data, cache, runtime) (issue #1285)
* core: add option weechat.network.gnutls_ca_system, rename option weechat.network.gnutls_ca_file to weechat.network.gnutls_ca_user (now evaluated), delete and reload certificates when options are changed (issue #972)
* core: evaluate option weechat.plugin.path, change default value to "${weechat_data_dir}/plugins"
* core: add options to customize commands executed on system signals received (SIGHUP, SIGQUIT, SIGTERM, SIGUSR1, SIGUSR2) (issue #1595)
* core: quit WeeChat by default when signal SIGHUP is received in normal run, reload configuration in weechat-headless (issue #1595)
* core: add signals "cursor_start" and "cursor_end"
* api: add function crypto_hmac (issue #1628)
* api: add translated string in evaluation of expressions with "translate:xxx"
* api: add evaluation of WeeChat directories with "${weechat_xxx_dir}" in evaluated strings
* api: add optional key "directory" in hashtable options of function/modifier string_eval_path_home
* api: add supported prefixes "${weechat_xxx_dir}" in function mkdir_home
* api: add infos "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" and "weechat_runtime_dir"
* api: add support of pointer names in function string_eval_expression (direct and in hdata)
* api: add info "weechat_daemon"
* buflist: add option buflist.format.tls_version
* fifo: change default value of option fifo.file.path to "${weechat_runtime_dir}/weechat_fifo_${info:pid}"
* irc: add support of SASL mechanisms SCRAM-SHA-1, SCRAM-SHA-256 and SCRAM-SHA-512 (issue #1628)
* irc: add variable "${target}" (target nick) in commands /kick and /kickban
* irc: add bar item "tls_version", add options irc.color.item_tls_version_ok, irc.color.item_tls_version_deprecated and irc.color.item_tls_version_insecure (issue #1622)
* irc: evaluate server options "sasl_key" and "ssl_cert"
* logger: change default value of option logger.file.path to "${weechat_data_dir}/logs"
* python: add stub for WeeChat API (issue #1377)
* relay: evaluate option relay.network.ssl_cert_key, change default value to "${weechat_config_dir}/ssl/relay.pem"
* script: change default value of option script.scripts.path to "${weechat_cache_dir}/script"
* trigger: add variables "${tg_shell_argc}" and "${tg_shell_argvN}" in command trigger evaluated strings (issue #1624)
* xfer: change default value of option xfer.file.download_path to "${weechat_data_dir}/xfer"
Bug fixes::
* core: split startup commands before evaluating them (issue #1643)
* core: set server name when connecting to server with TLS (SNI extension) only if it's not an IPV4/IPv6 (issue #1635)
* core: use function mallinfo2 instead of mallinfo when available (issue #1636)
* core: display a warning when the file with certificate authorities is not found (option weechat.network.gnutls_ca_file)
* core: evaluate left/right part of comparison after split on the comparison operator in ${if:xxx} (issue #1627)
* core: prevent switching to start of visited buffers when jumping to next (issue #1591, issue #1592)
* core: recreate buflist and fset bars on /reload when WeeChat is started without configuration files (issue #1618)
* buflist: fix comparison of hotlists in option buflist.look.sort (issue #1621)
* irc: split server command before evaluating it (issue #1643)
* xfer: make file transfer fail when option xfer.file.auto_rename is off and file already exists (issue #1633)
Tests::
* core: switch from Ubuntu 18.04 to 20.04 in CI
* trigger: add tests on main trigger functions
Build::
* core: remove build option CA_FILE
* core: set WeeChat home to empty string by default in CMake and autotools
[[v3.1]]
== Version 3.1 (2021-03-07)
New features::
* core: add options weechat.look.hotlist_update_on_buffer_switch and weechat.look.read_marker_update_on_buffer_switch (issue #992, issue #993)
* core: add option sec.crypt.passphrase_command to read passphrase from an external program on startup, remove option sec.crypt.passphrase_file (issue #141)
* core: improve debug in command /eval: display more verbose debug with two "-d", add indentation and colors
* core: add options "setvar" and "delvar" in command /buffer, rename option "localvar" to "listvar"
* core: add buffer local variable "completion_default_template" (evaluated) to override the value of option "weechat.completion.default_template" (issue #1600)
* core: add option "recreate" in command /filter
* core: add raw string in evaluation of expressions with "raw:xxx" (issue #1611)
* core: add evaluation of conditions in evaluation of expressions with "eval_cond:xxx" (issue #1582)
* api: add info_hashtable "secured_data"
* irc: add info "irc_is_message_ignored"
* irc: add server option "default_chantypes", used when the server does not send them in message 005 (issue #1610)
* trigger: add variable "${tg_trigger_name}" in command trigger evaluated strings (issue #1580)
Bug fixes::
* core: fix quoted line in cursor mode (issue #1602)
* core: fix wrong size of the new window after vertical split (issue #1612)
* core: do not remove quotes in arguments of command /eval as they can be part of the evaluated expression/condition (issue #1601)
* core: display an error when the buffer is not found with command /command -buffer
* buflist: add option buflist.look.use_items to speed up display of buflist (issue #1613)
* irc: add bar item "irc_nick_prefix"
* irc: fix separator between nick and host in bar item "irc_nick_host"
* irc: fix completion of commands /halfop and /dehalfop
Documentation::
* do not build weechat-headless man page if headless binary is disabled (issue #1607)
[[v3.0.1]]
== Version 3.0.1 (2021-01-31)
Bug fixes::
* exec: fix search of command by identifier
* spell: fix refresh of bar item "spell_suggest" when the input becomes empty (issue #1586)
* spell: fix crash with IRC color codes in command line (issue #1589)
[[v3.0]]
== Version 3.0 (2020-11-11)
@@ -151,7 +248,7 @@ New features::
* buflist: add pointer "window" in bar item evaluation
* irc: add support of fake servers (no I/O, for testing purposes)
* relay: accept hash of password in init command of weechat protocol with option "password_hash" (PBKDF2, SHA256, SHA512)
* relay: reject client with weechat protocol if password or totp is received in init command but not set in WeeChat (issue #1435)
* relay: reject client with weechat protocol if password or TOTP is received in init command but not set in WeeChat (issue #1435)
Bug fixes::
@@ -202,7 +299,7 @@ New features::
* core: add option weechat.look.nick_color_hash_salt to shuffle nick colors (issue #635)
* core: add different icons sizes (16x16 to 512x512) (issue #1347)
* core: add file weechat.desktop
* core: add reverse of string for screen in evaluation of expressions with "revscr:"
* core: add reverse of string for screen in evaluation of expressions with "revscr:xxx"
* core: add length of string (number of chars and on screen) in evaluation of expressions with "length:xxx" and "lengthscr:xxx"
* core: add calculation of expression in evaluation of expressions with "calc:xxx" (issue #997)
* core: add optional default path (evaluated) in completion "filename"
@@ -437,7 +534,7 @@ Build::
New features::
* core: change default value of option weechat.look.hotlist_add_conditions to check connected relay clients via weechat protocol (issue #1206)
* core: add reverse of string in evaluation of expressions with "rev:" (issue #1200)
* core: add reverse of string in evaluation of expressions with "rev:xxx" (issue #1200)
* core: send buffer pointer (when possible) in signal "hotlist_changed" (issue #1133)
* core: add support of list options in curl (issue #826, issue #219)
* core: allow merge of buffers by name in command /buffer (issue #1108, issue #1159)
@@ -632,7 +729,7 @@ New features::
* core: add option weechat.completion.nick_case_sensitive (issue #981)
* core: add wildcard matching operator (`+=*+` and `+!*+`) in evaluation of expressions (issue #611)
* core: add cut of string in evaluation of expressions with "cut:" (number of chars) and "cutscr:" (number of chars displayed on screen)
* core: add cut of string in evaluation of expressions with "cut:xxx" (number of chars) and "cutscr:xxx" (number of chars displayed on screen)
* core: add ternary operator (condition) in evaluation of expressions (`${if:condition?value_if_true:value_if_false}`)
* core: add resize of window parents with /window resize [h/v]size (task #11461, issue #893)
* core: add hotlist pointer in buffer structure
+1 -1
View File
@@ -82,7 +82,7 @@ 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: _chat.freenode.net_, channel _#weechat_).
(server: _irc.libera.chat_, channel _#weechat_).
Before submitting any pull request, be sure you have read the
https://weechat.org/files/doc/devel/weechat_dev.en.html#coding_rules[coding rules]
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2006-2009 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -114,7 +114,7 @@ $ ctest -V
== Copyright
Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
This file is part of WeeChat, the extensible chat client.
+236 -7
View File
@@ -17,6 +17,235 @@ https://weechat.org/files/changelog/ChangeLog-devel.html[ChangeLog]
(file _ChangeLog.adoc_ in sources).
[[v3.2]]
== Version 3.2 (2021-06-13)
[[v3.2_xdg_directories]]
=== XDG directories
Support of XDG directories has been added. For compatibility, if the directory
_~/.weechat_ exists, WeeChat will still use it for all files.
If you want to switch to XDG directories, you must create and move manually
all files in the appropriate directories. +
See https://specs.weechat.org/specs/001285-follow-xdg-base-dir-spec.html#weechat-home[WeeChat XDG specification]
for more information.
Some options have new default value: `%h` is replaced by `${weechat_xxx_dir}`. +
If you didn't change the value, it is recommended to set the new default value,
by doing `/unset <option>` on each option:
[width="100%",cols="2m,2m,5m",options="header"]
|===
| Option | Old default value | New default value
| fifo.file.path | %h/weechat_fifo | ${weechat_runtime_dir}/weechat_fifo_${info:pid}
| logger.file.path | %h/logs/ | ${weechat_data_dir}/logs
| relay.network.ssl_cert_key | %h/ssl/relay.pem | ${weechat_config_dir}/ssl/relay.pem
| script.scripts.path | %h/script | ${weechat_cache_dir}/script
| weechat.plugin.path | %h/plugins | ${weechat_data_dir}/plugins
| xfer.file.download_path | %h/xfer | ${weechat_data_dir}/xfer
|===
The following scripts are updated to take care of XDG directories, be sure
they are all up-to-date, otherwise files may be saved in wrong directories or
the script may not find some files:
* https://weechat.org/scripts/source/autoconf.py/[autoconf.py] 0.4
* https://weechat.org/scripts/source/axolotl.py/[axolotl.py] 0.1.1
* https://weechat.org/scripts/source/beinc.py/[beinc.py] 4.2
* https://weechat.org/scripts/source/buddylist.pl/[buddylist.pl] 2.1
* https://weechat.org/scripts/source/bufsave.py/[bufsave.py] 0.5
* https://weechat.org/scripts/source/chanop.py/[chanop.py] 0.3.4
* https://weechat.org/scripts/source/chanstat.py/[chanstat.py] 0.2
* https://weechat.org/scripts/source/colorize_lines.pl/[colorize_lines.pl] 4.0
* https://weechat.org/scripts/source/confversion.py/[confversion.py] 0.4
* https://weechat.org/scripts/source/country.py/[country.py] 0.6.2
* https://weechat.org/scripts/source/cron.py/[cron.py] 0.5
* https://weechat.org/scripts/source/crypt.py/[crypt.py] 1.4.5
* https://weechat.org/scripts/source/grep.py/[grep.py] 0.8.5
* https://weechat.org/scripts/source/growl.py/[growl.py] 1.0.7
* https://weechat.org/scripts/source/histman.py/[histman.py] 0.8.2
* https://weechat.org/scripts/source/hl2file.py/[hl2file.py] 0.3
* https://weechat.org/scripts/source/hotlist2extern.pl/[hotlist2extern.pl] 1.0
* https://weechat.org/scripts/source/jnotify.pl/[jnotify.pl] 1.2
* https://weechat.org/scripts/source/latex_unicode.py/[latex_unicode.py] 1.2
* https://weechat.org/scripts/source/luanma.pl/[luanma.pl] 0.3
* https://weechat.org/scripts/source/otr.py/[otr.py] 1.9.3
* https://weechat.org/scripts/source/pop3_mail.pl/[pop3_mail.pl] 0.4
* https://weechat.org/scripts/source/purgelogs.py/[purgelogs.py] 0.5
* https://weechat.org/scripts/source/query_blocker.pl/[query_blocker.pl] 1.3
* https://weechat.org/scripts/source/queryman.py/[queryman.py] 0.6
* https://weechat.org/scripts/source/queue.py/[queue.py] 0.4.3
* https://weechat.org/scripts/source/rslap.pl/[rslap.pl] 1.4
* https://weechat.org/scripts/source/rssagg.pl/[rssagg.pl] 1.3
* https://weechat.org/scripts/source/slack.py/[slack.py] 2.8.0
* https://weechat.org/scripts/source/stalker.pl/[stalker.pl] 1.6.2
* https://weechat.org/scripts/source/substitution.rb/[substitution.rb] 0.0.2
* https://weechat.org/scripts/source/triggerreply.py/[triggerreply.py] 0.4.3
* https://weechat.org/scripts/source/update_notifier.py/[update_notifier.py] 0.6
* https://weechat.org/scripts/source/url_olde.py/[url_olde.py] 0.8
* https://weechat.org/scripts/source/urlserver.py/[urlserver.py] 2.6
* https://weechat.org/scripts/source/weetext.py/[weetext.py] 0.1.3
* https://weechat.org/scripts/source/zncplayback.py/[zncplayback.py] 0.2.1
To check if XDG directories are used, you can run command `/debug dirs`, which
should show different directories for config/data/cache/runtime, like this:
----
Directories:
home:
config: /home/user/.config/weechat
data: /home/user/.local/share/weechat
cache: /home/user/.cache/weechat
runtime: /run/user/1000/weechat
lib: /usr/lib/x86_64-linux-gnu/weechat
lib (extra): -
share: /usr/share/weechat
locale: /usr/share/locale
----
With the legacy _~/.weechat_ directory, the output would be:
----
Directories:
home:
config: /home/user/.weechat
data: /home/user/.weechat
cache: /home/user/.weechat
runtime: /home/user/.weechat
lib: /usr/lib/x86_64-linux-gnu/weechat
lib (extra): -
share: /usr/share/weechat
locale: /usr/share/locale
----
[[v3.2_gnutls_ca]]
=== GnuTLS certificate authorities
A new option has been added to load system's default trusted certificate
authorities on startup: _weechat.network.gnutls_ca_system_ (boolean, enabled
by default).
The option _weechat.network.gnutls_ca_file_ has been renamed to
_weechat.network.gnutls_ca_user_ and is now used for extra certificates
(not the system ones). +
This option now supports multiple files, separated by colons.
If you have set a user CA file in option _weechat.network.gnutls_ca_file_,
then you must set this same value in the new option
_weechat.network.gnutls_ca_user_.
When one of these options are changed, all certificates are purged and reloaded
from files.
[[v3.2_split_commands_before_eval]]
=== Split of commands before evaluation
The split of commands is now performed before the evaluation of string, in the
following cases:
* IRC server option _irc.server_default.command_ or _irc.server.xxx.command_
* startup option with command line parameter `-r` / `--run-command`
* options _weechat.startup.command_before_plugins_ and _weechat.startup.command_after_plugins_.
If ever you used here multiple commands that are found by evaluation, then
you must use multiple commands directly.
For example if you did this:
----
/secure set commands "/command1 secret1;/command2 secret2"
/set irc.server.libera.command "${sec.data.commands}"
----
This will now execute a single command: `/command1` with two parameters:
`secret1;/command2` and `secret2`, which is not what you expect.
So you must now do this instead:
----
/secure set command1 "/command1 secret1"
/secure set command2 "/command2 secret2"
/set irc.server.libera.command "${sec.data.command1};${sec.data.command2}"
----
You could also do this, but be careful, there are two evaluations of strings
(the secured data itself is evaluated as well):
----
/secure set commands "/command1 secret1;/command2 secret2"
/set irc.server.libera.command "/eval -s ${sec.data.commands}"
----
[[v3.1]]
== Version 3.1 (2021-03-07)
[[v3.1_secure_data_passphrase_command]]
=== External program to read secured data passphrase
A new option `sec.crypt.passphrase_command` has been added to read the passphrase
from the output of an external program (like a password manager).
The option `sec.crypt.passphrase_file` has been removed, because the command
can now read a file as well. If you used a file to read the passphrase, you
must now setup the command like this:
----
/set sec.crypt.passphrase_command "cat ~/.weechat-passphrase"
----
For security reasons, it is of course highly recommended to use a password manager
or a program to decrypt a file with your passphrase rather than using a file with
the clear password. +
For example with password-store (command `pass`):
----
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
----
[[v3.1_window_splitv]]
=== Vertical split of windows
The vertical split of windows has been fixed (see issue #1612): now the new
window has the asked size, instead of the original window.
For example with this command the new window (on the right) has size 80% instead
of 20% in previous releases:
----
/window splitv 80
----
[[v3.1_command_buffer_listvar]]
=== List of buffer local variables
The command `/buffer localvar` has been renamed to `/buffer listvar`.
The option `localvar` is still supported to stay compatible with scripts
calling it or referencing it in the documentation. +
It is deprecated and will be removed in a future release.
New options `setvar` and `delvar` were also added in command `/buffer`,
see `/help buffer`.
[[v3.1_buflist_option_use_items]]
=== Buflist option buflist.look.use_items
A new buflist option `buflist.look.use_items` has been added to speed up
display of buflist, in case you use a single buflist item (the most common use case).
If ever you use more than one item (item "buflist2" or even "buflist3"), you
must adjust the value of the new option, which defaults to 1:
----
/set buflist.look.use_items 2
----
[[v3.0.1]]
== Version 3.0.1 (2021-01-31)
Bug fix and maintenance release.
[[v3.0]]
== Version 3.0 (2020-11-11)
@@ -133,7 +362,7 @@ using this modifier and the "modifier_data" argument must be updated.
The old format contained plugin name + ";" + buffer name + ";" + tags:
----
irc;freenode.#weechat;tag1,tag2,tag3
irc;libera.#weechat;tag1,tag2,tag3
----
The new format contains buffer pointer + ";" + tags:
@@ -145,7 +374,7 @@ The new format contains buffer pointer + ";" + tags:
The following scripts are updated consequently to be compatible with all
WeeChat versions:
* https://weechat.org/scripts/source/colorize_lines.pl.html/[colorize_lines.pl] 3.9
* https://weechat.org/scripts/source/colorize_lines.pl/[colorize_lines.pl] 3.9
* https://weechat.org/scripts/source/colorize_nicks.py/[colorize_nicks.py] 27
* https://weechat.org/scripts/source/colorizer.rb/[colorizer.rb] 0.2
* https://weechat.org/scripts/source/curiousignore.pl/[curiousignore.pl] 0.4
@@ -209,8 +438,8 @@ For example you can do that:
----
/secure passphrase my_secret_passphrase
/secure set freenode my_password
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
/secure set libera my_password
/set irc.server.libera.sasl_password "${sec.data.libera}"
----
This will be displayed like that in WeeChat, using the new regex value of
@@ -218,8 +447,8 @@ _cmd_pass_ trigger:
----
/secure passphrase ********************
/secure set freenode ***********
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
/secure set libera ***********
/set irc.server.libera.sasl_password "${sec.data.libera}"
----
If you want to use the new trigger regex after upgrade, you can do:
@@ -1031,7 +1260,7 @@ Globally (default value for all servers):
For a specific server:
----
/set irc.server.freenode.nicks_alternate off
/set irc.server.libera.nicks_alternate off
----
[[v1.3]]
+1 -1
View File
@@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2005-2006 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2014-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2014-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2007 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2011-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2011-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,6 +1,6 @@
#
# Copyright (C) 2017 Adam Saponara <as@php.net>
# Copyright (C) 2017-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2017-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2015-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2015-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -5,6 +5,7 @@
#cmakedefine HAVE_BACKTRACE
#cmakedefine ICONV_2ARG_IS_CONST 1
#cmakedefine HAVE_MALLINFO
#cmakedefine HAVE_MALLINFO2
#cmakedefine HAVE_EAT_NEWLINE_GLITCH
#cmakedefine HAVE_ASPELL_VERSION_STRING
#cmakedefine HAVE_ENCHANT_GET_VERSION
@@ -17,5 +18,4 @@
#define WEECHAT_SHAREDIR "@WEECHAT_SHAREDIR@"
#define LOCALEDIR "@LOCALEDIR@"
#define WEECHAT_HOME "@WEECHAT_HOME@"
#define CA_FILE "@CA_FILE@"
#define _GNU_SOURCE 1
+8 -16
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2005 Benoit Papillault <benoit.papillault@free.fr>
# Copyright (C) 2005-2006 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2005-2009 Emmanuel Bouthenot <kolter@openics.org>
@@ -98,6 +98,7 @@ AC_MSG_RESULT($ac_cv_type_socklen_t)
AC_FUNC_SELECT_ARGTYPES
AC_TYPE_SIGNAL
AC_CHECK_FUNCS([mallinfo])
AC_CHECK_FUNCS([mallinfo2])
# Variables in config.h
@@ -133,8 +134,7 @@ AH_VERBATIM([PLUGIN_XFER], [#undef PLUGIN_XFER])
AH_VERBATIM([TESTS], [#undef TESTS])
AH_VERBATIM([MAN], [#undef MAN])
AH_VERBATIM([DOC], [#undef DOC])
AH_VERBATIM([WEECHAT_HOME], [#define WEECHAT_HOME "~/.weechat"])
AH_VERBATIM([CA_FILE], [#define CA_FILE "/etc/ssl/certs/ca-certificates.crt"])
AH_VERBATIM([WEECHAT_HOME], [#define WEECHAT_HOME ""])
# Arguments for ./configure
@@ -171,19 +171,10 @@ AC_ARG_ENABLE(tests, [ --enable-tests turn on build of tests (d
AC_ARG_ENABLE(man, [ --enable-man turn on build of man page (default=not built)],enable_man=$enableval,enable_man=no)
AC_ARG_ENABLE(doc, [ --enable-doc turn on build of documentation (default=not built)],enable_doc=$enableval,enable_doc=no)
AC_ARG_VAR(WEECHAT_HOME, [WeeChat home directory for config, logs, scripts.. (default is "~/.weechat")])
AC_ARG_VAR(CA_FILE, [File containing the certificate authorities (default is "/etc/ssl/certs/ca-certificates.crt"). This is the default value of option "weechat.network.gnutls_ca_file".])
AC_ARG_VAR(WEECHAT_HOME, [Force a single WeeChat home directory for config, logs, scripts, etc.])
if test "x$WEECHAT_HOME" = "x" ; then
WEECHAT_HOME="~/.weechat"
fi
AC_DEFINE_UNQUOTED(WEECHAT_HOME, "$WEECHAT_HOME")
if test "x$CA_FILE" = "x" ; then
CA_FILE="/etc/ssl/certs/ca-certificates.crt"
fi
AC_DEFINE_UNQUOTED(CA_FILE, "$CA_FILE")
not_asked=""
not_found=""
@@ -1547,7 +1538,6 @@ echo " Compile with debug..... : $msg_debug"
echo " Compile tests.......... : $msg_tests"
echo " Man page............... : $msg_man"
echo " Documentation.......... : $msg_doc"
echo " Certificate authorities : ${CA_FILE}"
if test "x$not_asked" != "x" || test "x$not_found" != "x"; then
echo ""
@@ -1561,8 +1551,10 @@ if test "x$not_asked" != "x" || test "x$not_found" != "x"; then
fi
echo ""
echo "WeeChat home directory is ${WEECHAT_HOME}"
echo ""
if test "x$WEECHAT_HOME" != "x" ; then
echo "WeeChat home directory is forced by default to: ${WEECHAT_HOME}"
echo ""
fi
eval echo "WeeChat will be installed in $bindir"
echo ""
echo "configure complete, now type 'make' to build WeeChat $VERSION"
+1 -1
View File
@@ -20,7 +20,7 @@ Build-Depends:
libgcrypt20-dev,
libgnutls28-dev,
zlib1g-dev
Standards-Version: 4.4.0
Standards-Version: 4.5.1
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
+14
View File
@@ -1,3 +1,17 @@
weechat (3.0.1-1) unstable; urgency=medium
* New upstream release
* Bump Standards-Version to 4.5.1
-- Emmanuel Bouthenot <kolter@debian.org> Wed, 03 Mar 2021 05:30:44 +0000
weechat (3.0-1) unstable; urgency=medium
* New upstream release
* Build against Guile 3.0 (instead of 2.2) (Closes: #969680)
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 21 Nov 2020 07:34:12 +0000
weechat (2.9-1) unstable; urgency=medium
* New upstream release
+1 -1
View File
@@ -20,7 +20,7 @@ Build-Depends:
libgcrypt20-dev,
libgnutls28-dev,
zlib1g-dev
Standards-Version: 4.4.0
Standards-Version: 4.5.1
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
+1 -1
View File
@@ -4,7 +4,7 @@ Upstream-Contact: Sébastien Helleu <flashcode@flashtux.org>
Source: https://weechat.org/
Files: *
Copyright: 2003-2020, Sébastien Helleu <flashcode@flashtux.org>
Copyright: 2003-2021, Sébastien Helleu <flashcode@flashtux.org>
License: GPL-3+
Files: src/core/wee-command.c
+2 -2
View File
@@ -1,2 +1,2 @@
version=3
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/files/src/weechat-(\d.*)\.tar\.bz2
version=4
opts=pgpsigurlmangle=s/$/.asc/ https://weechat.org/download/ /files/src/weechat-(\d.*)\.tar\.xz
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2009 Emmanuel Bouthenot <kolter@openics.org>
#
# This file is part of WeeChat, the extensible chat client.
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+16 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,19 +32,21 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/cs/man1)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.cs.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (cs)"
)
add_custom_target(doc-man-weechat-headless-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/cs/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.cs.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.cs.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (cs)"
)
add_custom_target(doc-man-weechat-headless-cs ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/cs/man1)
endif()
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+4 -4
View File
@@ -16,11 +16,11 @@
(works only with the command *weechat-headless*, not compatible with option
"--daemon").
// TRANSLATION MISSING
*-d*, *--dir* _<path>_::
Nastav cestu jako dovmský adresář pro WeeChat (použitou pro konfigurační
soubory, logy, uživatelské pluginy a skripty), výchozí hodnota je
"~/.weechat" (poznámka: složka bude vytvořena pokud nebude nalezena
Weechatem)
Force a single directory for all WeeChat files (directory is created if not found).
Four directories can be given, separated by colons (in this order: config,
data, cache, runtime).
Pokud tato volba není zadána, použije se promněná prostředí WEECHAT_HOME
(pokud není prázdná)
+27 -27
View File
@@ -8,7 +8,7 @@ S irc pluginem se můžete doččasně připojit na server s URL jako:
K připojení na IRC kanál Weechatu pro podporu s přezdívkou "mynick":
irc://mynick@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#weechat
IPv6 adresa může být uzavřena do hranatých závorek k přidání portu, například:
@@ -16,79 +16,79 @@ IPv6 adresa může být uzavřena do hranatých závorek k přidání portu, nap
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
hlavní konfigurační soubor WeeChatu
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
soubor konfigurace pluginů
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
konfigurační soubor s chráněnými daty
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
configurační soubor pro _alias_ plugin
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
konfigurační soubor pro _buflist_ plugin
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
konfigurační soubor pro _charset_ plugin
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
konfigurační soubor pro _exec_ plugin
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
konfigurační soubor pro _fifo_ plugin
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
konfigurační soubor pro _fset_ plugin
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
konfigurační soubor pro _guile_ plugin
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
konfigurační soubor pro _irc_ plugin
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
konfigurační soubor pro _javascript_ plugin
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
konfigurační soubor pro _logger_ plugin
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
konfigurační soubor pro _lua_ plugin
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
konfigurační soubor pro _perl_ plugin
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
konfigurační soubor pro _php_ plugin
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
konfigurační soubor pro _python_ plugin
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
konfigurační soubor pro _relay_ plugin
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
konfigurační soubor pro _ruby_ plugin
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
konfigurační soubor pro _script_ plugin
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
konfigurační soubor pro _spell_ plugin
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
konfigurační soubor pro _tcl_ plugin
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
konfigurační soubor pro _trigger_ plugin
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
konfigurační soubor pro _xfer_ plugin
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
soubor záznamů WeeChatu
// end::files[]
@@ -96,7 +96,7 @@ $HOME/.weechat/weechat.log::
WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
souboru AUTHORS.adoc).
Copyright (C) 2003-2020 {author}
Copyright (C) 2003-2021 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+21 -28
View File
@@ -113,13 +113,13 @@ Použijte příkaz `/plugin` k zobrazení nahraných pluginů, pravděpodobně u
Můžete přidat irc server příkazem `/server`, například:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
// TRANSLATION MISSING
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
In this command, `libera` is the internal server name used by WeeChat:
you'll be able to connect with `/connect libera` and the server options
are _irc.server.libera.xxx_.
Jako obvykle je poskytována nápověda pokud se ztratíte:
@@ -138,45 +138,38 @@ Pro každou serverovou volbu WeeChat použije její hodnotu pokud je definována
(není "prázdná"). Jinak WeeChat použije výchozí hodnotu ("irc.server_default.xxx).
Například, je zde výchozí přezdívka (založena na vašem un*x loginu), můžete
ji přepsat pro freenode s následujícím příkazem:
ji přepsat pro libera s následujícím příkazem:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
Nastavení username a realname:
----
/set irc.server.freenode.username "Mé uživatelské jméno"
/set irc.server.freenode.realname "Mé skutečné jméno"
/set irc.server.libera.username "Mé uživatelské jméno"
/set irc.server.libera.realname "Mé skutečné jméno"
----
K zapnutí automatického připojení při spuštění:
----
/set irc.server.freenode.autoconnect on
----
K připojení s SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
Pokud je na serveru podporován SASL, můžete jej použít pro autentizaci (mužete
být identifikován před připojením kanálů):
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
K spuštění příkazů po připojení k serveru, například k autentizaci s nickserv
(pouze pokud nepoužíváte autentizaci přes SASL):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -194,24 +187,24 @@ First setup a passphrase:
----
// TRANSLATION MISSING
Then add a secured data with your freenode password:
Then add a secured data with your libera password:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
Then you can use `+${sec.data.libera_password}+` instead of your password in
IRC options mentioned above, for example:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
K automatickému připojení některých kanálů při připojování k serveru:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
// TRANSLATION MISSING
@@ -224,25 +217,25 @@ K smazání hodnoty serverové volby a k použití výchozí hodnoty místo ní,
například k požití výchozích přezdívek (irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Ostatní volby: můžete nastavit ostatní volby s následujícím příkazem ("xxx" je
název volby):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
[[connect_to_irc_server]]
== Připojení k IRC serveru
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera server and auto-joins the
channels configured in the "autojoin" server option.
// TRANSLATION MISSING
+16 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,19 +32,21 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/de/man1)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.de.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (de)"
)
add_custom_target(doc-man-weechat-headless-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/de/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.de.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.de.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (de)"
)
add_custom_target(doc-man-weechat-headless-de ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/de/man1)
endif()
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
+15 -11
View File
@@ -18,23 +18,23 @@
| guile | guile_script | Liste der Skripten
| irc | irc_channel | aktueller IRC-Channel
| irc | irc_channel | aktueller IRC-Kanal
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Channels
| irc | irc_channel_nicks_hosts | Liste der Nicks und Hostnamen des aktuellen Kanals
| irc | irc_channel_topic | Thema des aktuellen IRC-Channels
| irc | irc_channel_topic | Thema des aktuellen IRC-Kanals
| irc | irc_channels | Channels auf allen IRC Servern
| irc | irc_channels | Kanäle auf allen IRC Servern
| irc | irc_ignores_numbers | Anzahl für festgelegte Ignorierungen
| irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Channel; benötigtes Argument: modelist mode
| irc | irc_modelist_masks | Modelist Maske für aktuellen IRC Kanal; benötigtes Argument: modelist mode
| irc | irc_modelist_numbers | Modelist Nummern für aktuellen IRC Channel; benötigtes Argument: modelist mode
| irc | irc_modelist_numbers | Modelist Nummern für aktuellen IRC Kanal; benötigtes Argument: modelist mode
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Channel wirft
| irc | irc_msg_kick | Standardmitteilung wenn man jemanden aus einem Kanal wirftchannel
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Channels
| irc | irc_msg_part | Standardmitteilung beim Verlassen (/part) eines IRC-Kanals
| irc | irc_notify_nicks | Nicks für die eine Benachrichtigung existiert
@@ -44,17 +44,17 @@
| irc | irc_server | aktueller IRC-Server
| irc | irc_server_channels | Channels des derzeitigen IRC-Server
| irc | irc_server_channels | Kanäle des derzeitigen IRC-Server
| irc | irc_server_nick | Nick beim derzeitigen IRC-Server
| irc | irc_server_nicks | Nicks für alle Channels auf dem aktuellen IRC-Server
| irc | irc_server_nicks | Nicks für alle Kanäle auf dem aktuellen IRC-Server
| irc | irc_server_privates | Privat auf aktuellem IRC Server
| irc | irc_servers | IRC-Server (interne Namen)
| irc | nick | Liste der Nicks im aktuellen Channel
| irc | nick | Liste der Nicks im aktuellen Kanal
| javascript | javascript_script | Liste der Skripten
@@ -120,6 +120,10 @@
| weechat | bars_options | Einstellungen für Infobars
| weechat | buffer_local_variable_value | Wert einer lokalen Buffervariablen
| weechat | buffer_local_variables | lokale Buffervariablen
| weechat | buffer_properties_get | Eigenschaften die für den Buffer gelesen werden können
| weechat | buffer_properties_set | Eigenschaften die für den Buffer gesetzt werden können
+6 -2
View File
@@ -53,7 +53,7 @@ _next_script_   (pointer, hdata: "guile_script") +
| irc
| [[hdata_irc_channel]]<<hdata_irc_channel,irc_channel>>
| IRC-Channel
| IRC-Kanal
| -
| _type_   (integer) +
_name_   (string) +
@@ -87,7 +87,7 @@ _next_channel_   (pointer, hdata: "irc_channel") +
| irc
| [[hdata_irc_channel_speaking]]<<hdata_irc_channel_speaking,irc_channel_speaking>>
| IRC channel_speaking
| irc channel_speaking
| -
| _nick_   (string) +
_time_last_message_   (time) +
@@ -233,6 +233,10 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
@@ -18,17 +18,17 @@
| guile | guile_script | Liste der Skripten | Skript Pointer (optional) | Name des Skriptes (Platzhalter "*" kann verwendet werden) (optional)
| irc | irc_channel | Liste der Channels eines IRC-Servers | Channel Pointer (optional) | Server,Channel (Channel ist optional)
| irc | irc_channel | Liste der Kanäle eines IRC-Servers | Pointer vom Kanal (optional) | Server,Kanal (Kanal ist optional)
| irc | irc_color_weechat | Zuordnung der IRC Farbkodierung und der WeeChat Farbnamen | - | -
| irc | irc_ignore | Liste von ignorierten IRCs | Ignore Pointer (optional) | -
| irc | irc_modelist | Liste der Channel-Mode-Liste für einen IRC-Channel | Modelist Pointer (optional) | Server,Channel,Type (Type ist optional)
| irc | irc_modelist | Liste der Kanalmoduslisten für einen IRC-Kanal | Modelist Pointer (optional) | Server,Channel,Type (Type ist optional)
| irc | irc_modelist_item | Liste der Items in der Channel-Modeliste | Modelist Item Pointer (optional) | Server,Channel,Type,Nummer (Nummer ist optional)
| irc | irc_modelist_item | Liste der Items in der Kanal-Modeliste | Modelist Item Pointer (optional) | Server,Channel,Type,Nummer (Nummer ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Channel | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_nick | Liste der Nicks im IRC-Kanal | Nick Pointer (optional) | server,channel,nick (nick ist optional)
| irc | irc_notify | Liste mit Benachrichtigungen | Benachrichtigungspointer (optional) | Servername (Platzhalter "*" kann verwendet werden) (optional)
+17 -5
View File
@@ -16,9 +16,11 @@
| guile | guile_version | Version des verwendeten Interpreters | -
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Channel/Nick | server,channel,nick (Channel und Nicks sind optional)
| irc | irc_buffer | holt Buffer Pointer für einen IRC Server/Kanal/Nick | server,channel,nick (Kanal und Nicks sind optional)
| irc | irc_is_channel | 1, falls die Zeichenkette ein gültiger IRC-Channelname für den Server ist | Server,Channel (Server ist optional)
| irc | irc_is_channel | 1, falls die Zeichenkette ein gültiger IRC-Kanalname für den Server ist | Server,Kanal (Server ist optional)
| irc | irc_is_message_ignored | 1, wenn der Nick ignoriert wird (Meldung wird nicht angezeigt) | Server,Nachricht (Nachricht ist die unverarbeitete IRC Nachricht)
| irc | irc_is_nick | 1, falls die Zeichenkette ein gültiger IRC Nickname ist | Server,Nickname (Server ist optional)
@@ -58,7 +60,7 @@
| php | php_version | Version des verwendeten Interpreters | -
| python | python2_bin | Pfad für Python 2.x Interpreter | -
| python | python2_bin | Pfad zum Python 2.x Interpreter (*veraltet*, seit WeeChat Version 2.6 müssen Skripten Python3 verwenden) | -
| python | python_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -74,7 +76,7 @@
| ruby | ruby_version | Version des verwendeten Interpreters | -
| spell | spell_dict | durch Kommata getrennte Liste von Wörterbüchern, die in diesem Buffer genutzt werden sollen | Buffer-Pointer ("0x12345678") oder der vollständige Buffername ("irc.freenode.#weechat")
| spell | spell_dict | durch Kommata getrennte Liste von Wörterbüchern, die in diesem Buffer genutzt werden sollen | Buffer-Pointer ("0x12345678") oder der vollständige Buffername ("irc.libera.#weechat")
| tcl | tcl_eval | Evaluierung des Quelltextes | Quelltext welcher ausgeführt werden soll
@@ -132,7 +134,15 @@
| weechat | version_number | WeeChat-Version (als Zahl) | -
| weechat | weechat_dir | WeeChat Verzeichnis | -
| weechat | weechat_cache_dir | WeeChat Cache-Verzeichnis | -
| weechat | weechat_config_dir | WeeChat Konfigurationsverzeichnis | -
| weechat | weechat_daemon | 1, falls WeeChat im Daemon-Modus ausgeführt wird (ohne Oberfläche, im Hintergrund) | -
| weechat | weechat_data_dir | WeeChat-Datenverzeichnis | -
| weechat | weechat_dir | WeeChat-Verzeichnis (*veraltet* seit Version 3.2, ersetzt durch "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" und "weechat_runtime_dir") | -
| weechat | weechat_headless | 1, falls WeeChat im Hintergrundmodus ausgeführt wird | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | "lokales" Verzeichnis von WeeChat | -
| weechat | weechat_runtime_dir | WeeChat-Laufzeitverzeichnis | -
| weechat | weechat_sharedir | WeeChat "share" Verzeichnis | -
| weechat | weechat_site | WeeChat Seite | -
@@ -8,11 +8,13 @@
|===
| Erweiterung | Name | Beschreibung | Hashtable (Eingabe) | Hashtable (Ausgabe)
| irc | irc_message_parse | Parse eine IRC Nachricht | "message": IRC Nachricht, "server": Servername (optional) | "tags": Tags, "message_without_tags": Nachrichten ohne Tags, "nick": Nick, "user": Benutzername, "host": Host, "command": Befehl, "channel": Channel, "arguments": Argumente (schließt Channel ein), "text": Text (zum Beispiel eine Nachricht von einem User), "pos_command": Index der "command" Nachricht ("-1" falls "command" nicht gefunden wird), "pos_arguments": Index der "arguments" Nachricht ("-1" falls "arguments" nicht gefunden wird), "pos_channel": Index der "channel" Nachricht ("-1" falls "channel" nicht gefunden wird),"pos_text": Index für "text" Nachricht ("-1" falls "text" nicht gefunden wird)
| irc | irc_message_parse | Parse eine IRC Nachricht | "message": IRC Nachricht, "server": Servername (optional) | "tags": Tags, "message_without_tags": Nachrichten ohne Tags, "nick": Nick, "user": Benutzername, "host": Host, "command": Befehl, "channel": Kanal, "arguments": Argumente (schließt Kanal ein), "text": Text (zum Beispiel eine Nachricht von einem User), "pos_command": Index der "command" Nachricht ("-1" falls "command" nicht gefunden wird), "pos_arguments": Index der "arguments" Nachricht ("-1" falls "arguments" nicht gefunden wird), "pos_channel": Index der "channel" Nachricht ("-1" falls "channel" nicht gefunden wird),"pos_text": Index für "text" Nachricht ("-1" falls "text" nicht gefunden wird)
| irc | irc_message_split | trennt eine IRC Nachricht (standardmäßig in 512 Bytes große Nachrichten) | "message": IRC Nachricht, "server": Servername (optional) | "msg1" ... "msgN": Nachrichten die versendet werden sollen (ohne abschließendes "\r\n"), "args1" ... "argsN": Argumente für Nachrichten, "count": Anzahl der Nachrichten
| weechat | focus_info | Fokusinformationen abrufen | "x": x-Koordinate (Zeichenfolge mit Ganzzahl >= 0), "y": y-Koordinate (Zeichenfolge mit Ganzzahl >= 0) | siehe Funktion "hook_focus" in API Dokumentation
| weechat | secured_data | schutzwürdige Daten | - | schutzwürdige Daten: Namen und Werte (Vorsicht: Dies sind vertrauliche Daten: drucken oder protokollieren Sie diese NICHT)
|===
// end::infos_hashtable[]
+185 -157
View File
@@ -14,32 +14,32 @@ target: Servername
----
[[command_irc_allchan]]
* `+allchan+`: führt einen Befehl aus der an alle Channels gesendet wird, die mit einem Server verbunden sind
* `+allchan+`: führt einen Befehl aus der an alle Kanäle gesendet wird, die mit einem Server verbunden sind
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command>
[-current] -include=<channel>[,<channel>...] <command>
-current: führt einen Befehl aus der an alle Channels des aktuellen Servers gesendet wird
-exclude: dient zum Ausschluss ausgewählter Channels (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Channels (Platzhalter "*" kann verwendet werden)\n
-current: führt einen Befehl aus der an alle Kanäle des aktuellen Servers gesendet wird
-exclude: dient zum Ausschluss ausgewählter Kanäle (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Kanäle (Platzhalter "*" kann verwendet werden)\n
command: Befehl der ausgeführt werden soll
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Channel
$channel Name des Kanals
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
${irc_channel.xxx} Variable xxx von Kanal
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle Channels aus:
führe den Befehl '/me Ich teste gerade etwas...' für alle Kanäle aus:
/allchan /me Ich teste gerade etwas...
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel:
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal:
/allchan -exclude=#weechat Hallo Welt
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel und Channels die mit #linux beginnen:
schicke 'Hallo Welt' an jeden Kanal, ausgenommen an den #weechat Kanal und Kanäle die mit #linux beginnen:
/allchan -exclude=#weechat,#linux* Hallo Welt
schickt den Text 'Hallo' an alle Channels die mit #linux beginnen:
schickt den Text 'Hallo' an alle Kanäle die mit #linux beginnen:
/allchan -include=#linux* Hallo
----
@@ -57,10 +57,10 @@ Beispiele:
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Channel
$channel Name des Kanals
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
${irc_channel.xxx} Variable xxx von Kanal
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle privaten Buffer aus:
@@ -106,10 +106,10 @@ Beispiele:
----
/ban [<channel>] [<nick> [<nick>...]]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Channel angezeigt.
Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Kanal angezeigt.
----
[[command_irc_cap]]
@@ -161,7 +161,7 @@ Beispiele:
Um eine Verbindung zum Server, oder Verbindungsversuche, zu beenden wird der Befehl /disconnect verwendet.
Beispiele:
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -177,7 +177,7 @@ Beispiele:
/ctcp [-server <server>] <target>[,<target>...] <type> [<arguments>]
server: an diesen Server senden (interner Servername)
target: Nick- oder Channelname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktuellen Channel)
target: Nick- oder Kanalname an welchen eine CTCP-Nachricht geschickt werden soll ('*' = aktueller Kanal)
type: CTCP-Nachricht (Beispiele: "version", "ping", usw.)
arguments: Argumente für CTCP
@@ -188,12 +188,12 @@ Beispiele:
----
[[command_irc_cycle]]
* `+cycle+`: Einen Channel verlassen und wieder betreten
* `+cycle+`: Einen Kanal verlassen und wieder betreten
----
/cycle [<channel>[,<channel>...]] [<message>]
channel: Name des Channels
channel: Name des Kanals
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -219,9 +219,10 @@ Beispiel:
----
/dehalfop <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den half-operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Kanal den half-operator-Status, ausgenommen sich selber
----
[[command_irc_deop]]
@@ -232,7 +233,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den Operator-Status, ausgenommen sich selber
*: entzieht allen Nicks im Kanal den Operator-Status, ausgenommen sich selber
----
[[command_irc_devoice]]
@@ -243,7 +244,7 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: entzieht allen Nicks im Channel den voice-Status
*: entzieht allen Nicks im Kanal den voice-Status
----
[[command_irc_die]]
@@ -275,11 +276,11 @@ target: Servername
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den half-operator-Status
*: vergibt an alle Nicks im Kanal den half-operator-Status
----
[[command_irc_ignore]]
* `+ignore+`: Ignoriert Nicks/Hosts von Channels oder Servern
* `+ignore+`: Ignoriert Nicks/Hosts von Kanälen oder Servern
----
/ignore list
@@ -293,17 +294,17 @@ nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
number: Nummer der Ignorierung die entfernt werden soll (nutze "list" um den entsprechenden Eintrag zu finden)
-all: entfernt alle Einträge
server: interner Name des Server auf welchem die Ignorierung statt finden soll
channel: Name des Channel, in dem die Ignorierung statt finden soll
channel: Name des Kanals, in dem die Ignorierung statt finden soll
Hinweis: Um zwischen Groß-und Kleinschreibung zu unterscheiden muss am Wortanfang "(?-i)" genutzt werden.
Beispiele:
ignoriert den Nick "toto" global:
/ignore add toto
ignoriert den Host "toto@domain.com" auf dem freenode Server:
/ignore add toto@domain.com freenode
ignoriert den Host "toto*@*.domain.com" im Chat freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
ignoriert den Host "toto@domain.com" auf dem libera Server:
/ignore add toto@domain.com libera
ignoriert den Host "toto*@*.domain.com" im Chat libera/#weechat:
/ignore add toto*@*.domain.com libera #weechat
----
[[command_irc_info]]
@@ -316,13 +317,13 @@ target: Servername
----
[[command_irc_invite]]
* `+invite+`: Eine Person in einen Channel einladen
* `+invite+`: Eine Person in einen Kanal einladen
----
/invite <nick> [<nick>...] [<channel>]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_ison]]
@@ -335,43 +336,43 @@ nick: Nickname
----
[[command_irc_join]]
* `+join+`: einen Channel betreten
* `+join+`: einen Kanal betreten
----
/join [-noswitch] [-server <server>] [<channel1>[,<channel2>...]] [<key1>[,<key2>...]]
-noswitch: es wird nicht zu dem angegebenen Channel gewechselt
-noswitch: es wird nicht zu dem angegebenen Kanal gewechselt
server: an angegebenen Server (interner Name) senden
channel: Name des Channels, der betreten werden soll
key: Zugriffsschlüssel für einen Channel (Channel, die einen Zugriffsschlüssel benötigen, müssen zuerst aufgeführt werden)
channel: Name des Kanals, der betreten werden soll
key: Zugriffsschlüssel für einen Kanal (Kanäle, die einen Zugriffsschlüssel benötigen, müssen zuerst aufgeführt werden)
Beispiele:
/join #weechat
/join #geschützter_Channel,#weechat Zugriffsschlüssel
/join -server freenode #weechat
/join #geschützter_Kanal,#weechat Zugriffsschlüssel
/join -server libera #weechat
/join -noswitch #weechat
----
[[command_irc_kick]]
* `+kick+`: wirft einen User aus einem Channel
* `+kick+`: wirft einen User aus einem Kanal
----
/kick [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
nick: Nick der rausgeworfen werden soll
reason: Begründung für den Rauswurf (Variablen die genutzt werden können: $nick, $channel und $server)
reason: Begründung für den Rauswurf (evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)
----
[[command_irc_kickban]]
* `+kickban+`: wirft einen User aus einem Channel und sein Host kommt auf die Bannliste
* `+kickban+`: wirft einen User aus einem Kanal und sein Host kommt auf die Bannliste
----
/kickban [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
nick: Nickname der rausgeworfen und gebannt werden soll
reason: Begründung weshalb der User rausgeworfen wurde (Variablen die genutzt werden können: $nick, $channel und $server)
reason: Begründung für den Rauswurf (evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)
Es ist möglich kick/ban mittels einer Maske auszuführen. Der Nick wird aus der Maske heraus gefiltert und durch "*" ersetzt.
@@ -401,22 +402,22 @@ server_mask: die aufzulistenden Server sollen diesem Muster entsprechen
----
[[command_irc_list]]
* `+list+`: Channels mit ihrem Thema auflisten
* `+list+`: Kanäle und deren Themen auflisten
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
server: an diesen Server senden (interner Name)
regexp: erweiterter regulärer POSIX Ausdruck, der auf die Ausgabe angewendet werden soll (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden)
channel: aufzulistender Channel
channel: aufzulistender Kanal
target: Servername
Beispiele:
listet alle Channels des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Kanäle des Servers auf (dies kann bei großen Netzwerken sehr lange dauern):
/list
listet den Channel #weechat auf:
listet den Kanal #weechat auf:
/list #weechat
listet alle Channels auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
listet alle Kanäle auf die mit "#weechat" beginnen (dies kann bei großen Netzwerken sehr lange dauern):
/list -re #weechat.*
----
@@ -437,7 +438,7 @@ target: Server, der die Anfrage weiterleiten soll
----
[[command_irc_me]]
* `+me+`: eine CTCP ACTION an den aktuellen Channel senden
* `+me+`: eine CTCP ACTION an den aktuellen Kanal senden
----
/me <message>
@@ -446,26 +447,26 @@ message: zu sendende Nachricht
----
[[command_irc_mode]]
* `+mode+`: Eigenschaften eines Channel oder von einem User ändern
* `+mode+`: Eigenschaften eines Kanals oder von einem User ändern
----
/mode [<channel>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<arguments>]
<nick> [+|-]i|s|w|o
Channel-Eigenschaften:
channel: zu ändernder Channel (standardmäßig der erste Channel)
Kanal-Eigenschaften:
channel: zu ändernder Kanal (standardmäßig der erste Kanal)
o: vergibt/entzieht Operator Privilegien
p: privater Channel
s: geheimer Channel
i: geschlossener Channel (Zutritt nur mit Einladung)
p: privater Kanal
s: geheimer Kanal
i: geschlossener Kanal (Zutritt nur mit Einladung)
t: nur Operatoren dürfen das Thema setzen
n: keine Nachrichten von außerhalb des Channels zulassen
m: moderierter Channel (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Channel festlegen
n: keine Nachrichten von außerhalb des Kanals zulassen
m: moderierter Kanal (schreiben nur mit Voice)
l: maximale Anzahl an Usern im Kanal festlegen
b: Bannmaske für zu sperrende User (in nick!ident@host-Form)
e: legt Ausnahmemaske fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Channels
k: legt ein Passwort für den Channel fest
v: vergibt/entzieht Schreibrechte (voice) in moderierten Kanälen
k: legt ein Passwort für den Kanal fest
User-Eigenschaften:
nick: zu ändernder Nickname
i: User als unsichtbar kennzeichnen
@@ -492,23 +493,23 @@ target: Servername
----
[[command_irc_msg]]
* `+msg+`: Nachricht an Nick/Channel verschicken
* `+msg+`: Nachricht an Nick/Kanal verschicken
----
/msg [-server <server>] <target>[,<target>...] <text>
server: schicke an diesen Server (interner Servername)
target: Nick oder Channel (darf eine Maske sein, '*' = aktueller Channel)
target: Nick oder Kanal (darf eine Maske sein, '*' = aktueller c)
text: zu sendender Text
----
[[command_irc_names]]
* `+names+`: Nicknamen in Channels auflisten
* `+names+`: Nicknamen des Kanals auflisten
----
/names [<channel>[,<channel>...]]
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_nick]]
@@ -528,7 +529,7 @@ nick: neuer Nickname
/notice [-server <server>] <target> <text>
server: an diesen Server senden (interner Name)
target: Nick- oder Channelname
target: Nick- oder Kanalname
text: zu sendender Text
----
@@ -551,21 +552,21 @@ Ohne Angabe von Argumenten werden alle Benachrichtigungen für den aktuellen Ser
Beispiele:
Benachrichtigung falls sich "toto" am aktuellen Server an- oder abmeldet:
/notify add toto
Benachrichtigung falls sich "toto" am freenode Server an- oder abmeldet:
/notify add toto freenode
Benachrichtigung falls "toto" den Befehl away am freenode Server nutzt:
/notify add toto freenode -away
Benachrichtigung falls sich "toto" am libera Server an- oder abmeldet:
/notify add toto libera
Benachrichtigung falls "toto" den Befehl away am libera Server nutzt:
/notify add toto libera -away
----
[[command_irc_op]]
* `+op+`: Channel-Operator Status an Nicknamen vergeben
* `+op+`: Status des Kanal-Operator an Nicknamen vergeben
----
/op <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den Operator-Status
*: vergibt an alle Nicks im Kanal den Operator-Status
----
[[command_irc_oper]]
@@ -579,12 +580,12 @@ password: Passwort
----
[[command_irc_part]]
* `+part+`: Einen Channel verlassen
* `+part+`: Einen Kanal verlassen
----
/part [<channel>[,<channel>...]] [<message>]
channel: Name des Channels welcher verlassen werden soll
channel: Name des Kanals welcher verlassen werden soll
message: Abschiedsnachricht (wird anderen Usern angezeigt)
----
@@ -621,15 +622,15 @@ target: Nickname
----
[[command_irc_quiet]]
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Channel erst schreiben, wenn sie "+v" oder höher besitzen)
* `+quiet+`: Nicks oder Hosts das Wort entziehen (User können im Kanal erst schreiben, wenn sie "+v" oder höher besitzen)
----
/quiet [<channel>] [<nick> [<nick>...]]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Channel angezeigt.
Ohne Angabe von Argumenten wird die Quiet-Liste für den aktuellen Kanal angezeigt.
----
[[command_irc_quote]]
@@ -651,7 +652,7 @@ data: unbearbeitete (RAW) Daten die gesendet werden sollen
server: Servername zu welchem neu verbunden werden soll (interner Name)
-all: mit allen Servern neu verbinden
-nojoin: Channels werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-nojoin: Kanäle werden nicht betreten (auch falls autojoin für diesen Server aktiviert ist)
-switch: wechselt zur nächsten Server-Adresse
----
@@ -665,12 +666,12 @@ option: zusätzliche Einstellung, die von manchen Servern berücksichtigt wird
----
[[command_irc_remove]]
* `+remove+`: zwingt einen User einen Channel zu verlassen
* `+remove+`: zwingt einen User einen Kanal zu verlassen
----
/remove [<channel>] <nick> [<reason>]
channel: Channelname
channel: Kanalname
nick: Nick der rausgeworfen werden soll
reason: Begründung für den Rauswurf (Variablen die genutzt werden können: $nick, $channel und $server)
----
@@ -685,23 +686,23 @@ target: Servername
----
[[command_irc_sajoin]]
* `+sajoin+`: fordert einen User auf einen oder mehrere Channel zu betreten
* `+sajoin+`: fordert einen User auf einen oder mehrere Kanäle zu betreten
----
/sajoin <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_samode]]
* `+samode+`: ändert den Modus des Channels ohne das Operator-Privilegien vorliegen
* `+samode+`: ändert den Modus des Kanals ohne das Operator-Privilegien vorliegen
----
/samode [<channel>] <mode>
Channel: Name des Channel
Mode: neuer Modus für Channel
Channel: Name des Kanals
Mode: neuer Modus für Kanal
----
[[command_irc_sanick]]
@@ -715,13 +716,13 @@ new_nick: neuer Nickname
----
[[command_irc_sapart]]
* `+sapart+`: zwingt einen User den oder die Channel(s) zu verlassen
* `+sapart+`: zwingt einen User den oder die Kanäle zu verlassen
----
/sapart <nick> <channel>[,<channel>...]
nick: Nickname
channel: Name des Channels
channel: Name des Kanals
----
[[command_irc_saquit]]
@@ -774,16 +775,16 @@ nooption: stellt die Boolean Einstellung auf 'off' (Beispiel: -nossl)
Beispiele:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -845,7 +846,7 @@ target: Name des Servers
user: Benutzername
target: Servername
channel: Channelname
channel: Kanalname
----
[[command_irc_time]]
@@ -858,14 +859,14 @@ target: Zeit des angegebenen Servers abfragen
----
[[command_irc_topic]]
* `+topic+`: Thema des Channels abfragen/setzen
* `+topic+`: Thema des Kanals abfragen/setzen
----
/topic [<channel>] [<topic>|-delete]
channel: Name des Channels
topic: neues Thema für den Channel
-delete: entfernt das Thema des Channels
channel: Name des Kanals
topic: neues Thema für den Kanal
-delete: entfernt das Thema des Kanals
----
[[command_irc_trace]]
@@ -883,7 +884,7 @@ target: Servername
----
/unban [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
number: ban Nummer (wird beim Befehl /ban angezeigt)
----
@@ -894,7 +895,7 @@ channel: Name des Channel
----
/unquiet [<channel>] <nick>|<number> [<nick>|<number>...]
channel: Name des Channel
channel: Name des Kanals
nick: Nick oder Host
number: Quiet-Nummer (wird beim Befehl /quiet angezeigt)
----
@@ -932,18 +933,19 @@ target: Servername
----
/voice <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den voice-Status
*: vergibt an alle Nicks im Kanal den voice-Status
----
[[command_irc_wallchops]]
* `+wallchops+`: Nachricht an Channel-Operator verschicken
* `+wallchops+`: Nachricht an Kanal-Operator verschicken
----
/wallchops [<channel>] <text>
channel: Name des Channel
channel: Name des Kanals
text: Text der versendet werden soll
----
@@ -976,7 +978,7 @@ target: Name des Servers (interner Servername)
nick: Nick, welcher abgefragt werden soll (es kann auch eine Maske genutzt werden)
Ohne Angabe von Argumenten, nutzt /whois folgende Regel:
- den eigenen Nick, falls es sich um einen Server/Channel Buffer handelt
- den eigenen Nick, falls es sich um einen Server/Kanal-Buffer handelt
- den Nick des Gesprächspartners, falls es sich um einen privaten Buffer handelt.
Sollte die Einstellung irc.network.whois_double_nick aktiviert sein dann wird ein Nick zweimal verwendet (sofern der Nick nur einmal angegeben wurde), um die Idle-Zeit zu erhalten.
@@ -1020,7 +1022,7 @@ Anmerkung: Im Befehl können Variablen genutzt werden, die dann durch den entspr
$n-m: Argumente von 'n' bis 'm'
$*: alle Argumente
$~: letztes Argument
$var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer localvar)
$var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer listvar)
Beispiel: $nick, $channel, $server, $plugin, $name
Beispiele:
@@ -1113,7 +1115,9 @@ Beispiele:
renumber [<number1> [<number2> [<start>]]]
close [<n1>[-<n2>]|<name>...]
notify [<level>]
localvar [<number>|<name>]
listvar [<number>|<name>]
setvar <name> [<value>]
delvar <name>
set <property> [<value>]
get <property>
<number>|-|+|<name>
@@ -1137,7 +1141,9 @@ renumber: Buffer werden umnummeriert (Einstellung weechat.look.buffer_auto_renum
message: Benachrichtigung bei Nachrichten von Usern + Highlights
all: Benachrichtigung bei allen Nachrichten
reset: Benachrichtigung auf Standardwert zurück setzen (all)
localvar: zeigt die lokalen Variablen für den aktuellen Buffer an
listvar: zeigt die lokalen Variablen für den aktuellen Buffer an
setvar: legt eine lokale Variable für den aktuellen Buffer an
delvar: löscht eine lokale Variable des aktuellen Buffers
set: setzt eine Eigenschaft für den aktuellen Buffer
get: zeigt eine Eigenschaft für den aktuellen Buffer an
number: wechselt von einem Buffer zu einem anderen, mögliche Optionen:
@@ -1296,11 +1302,11 @@ infolists: zeigt Information über die Infolists an
----
/eval [-n|-s] [-d] <expression>
[-n] [-d] -c <expression1> <operator> <expression2>
[-n] [-d [-d]] -c <expression1> <operator> <expression2>
-n: gibt das Ergebnis aus, ohne dass dieses in den Buffer gesendet wird (debug Modus)
-s: teilt Ausdrücke, bevor sie evaluiert werden (mehrere Befehle können durch Semikolon getrennt werden)
-d: eine Debug-Ausgabe nach Auswertung anzeigen
-d: eine Debug-Ausgabe nach Auswertung anzeigen (Nutzung von zwei -d: ausführliche Debug-Ausgabe)
-c: Auswertung als Bedingung: nutzt Operatoren und runde Klammern, Rückgabewert als Boolean-Wert ("0" oder "1")
expression: Ausdruck welcher verarbeitet werden soll. Variablen im Format ${variable} werden ersetzt (siehe unten); mehrere Befehle werden durch ein Semikolon voneinander getrennt
operator: ein logischer oder vergleichender Operand:
@@ -1335,25 +1341,28 @@ Um einen Vergleich zwischen zwei Zeichenketten zu erzwingen, müssen die Ausdrü
"50" > "100" ==> 1
Einige Variablen werden im Ausdruck mittels der Formatierung ${variable} ersetzt. Mögliche Variablen sind, nach Reihenfolge ihrer Priorität:
1. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
2. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
3. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
4. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:+Max,Suffix,Zeichenkette")
1. die Zeichenfolge selbst ohne Auswertung (Format: "raw:xxx")\n
2. eine evaluierte Teilzeichenkette (Format: "eval:xxx")
3. eine evaluierte Bedingung (Format: "eval_cond:xxx")
4. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
5. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
6. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:max,suffix,string" oder "cut:+max,suffix,string")
oder maximale Anzahl an Zeichen die auf dem Bildschirm angezeigt werden sollen (Format: "cutscr:Max,Suffix,Zeichenkette oder "cutscr:+Max,Suffix,Zeichenkette")
5. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
6. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
7. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
8. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
9. ein Modifizierer (Format: "info:Name,Argumente", Argumente sind optional)
10. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
11. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
12. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
13. eine Umgebungsvariable (Format: "env:XXX")
14. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
15. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
16. eine Option (Format: "file.section.option")
17. eine lokale Variable eines Buffers
18. ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
7. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
8. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
9. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
10. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
11. zum modifizieren (Format: "modifier:name,data,string")
12. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
13. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
14. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
15. eine Umgebungsvariable (Format: "env:XXX")
16. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
17. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
18. eine übersetzte Zeichenkette (Format: "translate:xxx")
19. eine Option (Format: "file.section.option")
20. eine lokale Variable eines Buffers
21. ein(e) hdata - Name/Variable (der Wert wird automatisch in eine Zeichenkette konvertiert), standardmäßig wird für "window" und "buffer" das aktuelle Fenster/Buffer verwendet.
Das Format für hdata kann wie folgt aufgebaut sein:
hdata.var1.var2...: startet mit hdata (der Pointer muss bekannt sein) und fragt eine Variable nach der anderen ab (weitere hdata können folgen)
hdata[list].var1.var2...: startet hdata mittels einer Liste, zum Beispiel:
@@ -1361,13 +1370,16 @@ Das Format für hdata kann wie folgt aufgebaut sein:
${plugin[weechat_plugins].name}: Name der ersten Erweiterung, in der verknüpften Liste aller Erweiterungen
hdata[pointer].var1.var2...: startet hdata mittels einem Pointer, zum Beispiel:
${buffer[0x1234abcd].full_name}: vollständiger Name eines Buffers und des dazugehörigen Pointers (kann in triggern benutzt werden)
${buffer[my_pointer].full_name}: vollständiger Name des Buffers mit dem entsprechenden Pointernamen (kann in Triggern verwendet werden)
Die vorhandenen Namen für hdata und Variablen sind in der "Anleitung für API Erweiterung", Bereich "weechat_hdata_get". beschrieben
Beispiele (einfache Zeichenketten):
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.freenode_password} ==> geheim
/eval -n ${sec.data.password} ==> geheim
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1384,6 +1396,7 @@ Beispiele (einfache Zeichenketten):
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Erweiterung
Beispiele (Bedingungen):
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1406,6 +1419,7 @@ Beispiele (Bedingungen):
enable|disable|toggle [<name>|@]
add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
rename <name> <new_name>
recreate <name>
del <name>|-all
list: alle Filter auflisten
@@ -1416,10 +1430,11 @@ Beispiele (Bedingungen):
add: Filter hinzufügen
addreplace: erzeugt neuen Filter oder ersetzt einen schon existierenden Filter
rename: benennt einen Filter um
recreate: in die Eingabezeile wird die entsprechende Filtereinstellung übernommen, um diese dann editieren zu können
del: Filter entfernen
-all: entfernt alle Filter
buffer: durch Kommata getrennte Liste von Buffer in denen der Filter aktiv sein soll:
- ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.freenode.#weechat" oder "irc.server.freenode")
- ist der vollständige Name eines Buffer inklusive seiner Erweiterung (Beispiel: "irc.libera.#weechat" oder "irc.server.libera")
- "*" bedeutet, alle Buffer
- beginnt ein Name mit '!' wird für diesen Buffer kein Filter genutzt
- Platzhalter "*" kann verwendet werden
@@ -1454,11 +1469,11 @@ Beispiele:
filtert Nicks wenn diese den Channel betreten oder durch den Befehl "/names" angezeigt werden:
/filter add nicks * irc_366 *
filtert Nick "toto" im IRC Channel #weechat:
/filter add toto irc.freenode.#weechat nick_toto *
/filter add toto irc.libera.#weechat nick_toto *
filtert IRC join/action Nachrichten von Nick "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtert Zeilen die "weechat sucks" im IRC Channel #weechat enthalten:
/filter add sucks irc.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter Zeilen die exakt "WeeChat sucks" lauten und das in allen Buffern:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1660,7 +1675,7 @@ Beispiele:
-core: keine Ausgabe im WeeChat Core Buffer
-current: Ausgabe im aktuellen Buffer wird unterdrückt
-buffer: Ausgabe im ausgewählten Buffer wird unterdrückt
name: vollständiger Buffername (Beispiel: "irc.server.freenode", "irc.freenode.#weechat")
name: vollständiger Buffername (Beispiel: "irc.server.libera", "irc.libera.#weechat")
command: Befehl der ohne Textausgabe ausgeführt werden soll (das Präfix, '/', wird automatisch hinzugefügt, falls es dem Befehl nicht vorangestellt wurde)
Wird kein Buffer ausgewählt (-core, -current oder -buffer), dann wird die Textausgabe generell unterdrückt.
@@ -1668,10 +1683,10 @@ Wird kein Buffer ausgewählt (-core, -current oder -buffer), dann wird die Texta
Beispiele:
Speichern der Konfiguration:
/mute save
Nachricht in den aktuellen Channel senden:
Nachricht in den aktuellen Kanal senden:
/mute -current msg * hi!
Nachricht an den #weechat Channel senden:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
Nachricht an den #weechat Kanal senden:
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1739,7 +1754,7 @@ Beispiele:
zeigt eine Nachricht im Core-Buffer mit dem Präfix "abc" an:
/print -core abc\tmeine Nachricht
es wird eine Nachricht im Channel #weechat ausgegeben:
/print -buffer irc.freenode.#weechat Nachricht an #weechat
/print -buffer irc.libera.#weechat Nachricht an #weechat
gibt einen Schneemann aus (U+2603):
/print -escape \u2603
verschickt Alarm (BEL):
@@ -1861,7 +1876,7 @@ Tastenbefehle für den secure-Buffer:
alt+v Werte werden in Klartext angezeigt bzw. verborgen
Wird eine Passphrase verwendet (Daten liegen verschlüsselt vor), fragt WeeChat beim Start die Passphrase ab.
Setzt man die Umgebungsvariable "WEECHAT_PASSPHRASE", kann die Eingabeaufforderung der Passphrase beim Programmstart vermieden werden (diese Variable wird von WeeChat auch beim /upgrade verwendet). Es ist auch möglich in der Option sec.crypt.passphrase_file eine Datei anzugeben die die Passphrase beinhaltet (siehe /help sec.crypt.passphrase_file)
Setzt man die Umgebungsvariable "WEECHAT_PASSPHRASE", kann die Eingabeaufforderung der Passphrase beim Programmstart vermieden werden (diese Variable wird von WeeChat auch beim /upgrade verwendet). Es ist auch möglich mittels der Option sec.crypt.passphrase_command die Passphrase aus der Ausgabe eines externen Befehls, wie eines Passwort-Managers zu lesen (siehe /help sec.crypt.passphrase_command )
schutzwürdige Daten mit dem Format ${sec.data.xxx} können wie folgt genutzt werden:
- Befehl /eval.
@@ -1872,14 +1887,16 @@ schutzwürdige Daten mit dem Format ${sec.data.xxx} können wie folgt genutzt we
Beispiele:
festlegen eine Passphrase:
/secure passphrase Dies ist meine Passphrase
verschlüsselt freenode SASL Passwort:
/secure set freenode meinPasswort
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
nutze Programm "pass" um die Passphrase beim Start auszulesen:
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
verschlüsselt libera SASL Passwort:
/secure set libera meinPasswort
/set irc.server.libera.sasl_password "${sec.data.libera}"
verschlüsselt oftc Passwort für nickserv:
/secure set oftc meinPasswort
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
Alternativbefehl um den eigenen Nick zu ghosten:
/alias add ghost /eval /msg -server freenode nickserv ghost meinNick ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost meinNick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1966,7 +1983,7 @@ Nutzt man die "-quit" Funktion ist die Abfolge geringfügig anders:
5. WeeChat wird beendet
Die Sitzung kann zu einem späteren Zeitpunkt wiederhergestellt werden: weechat --upgrade
WICHTIG: Die Sitzung muss mit exakt den selben Konfigurationsdateien wiederhergestellt werden (*.conf)
Es ist möglich die WeeChat-Sitzung auf einem anderen Rechner wiederherzustellen, sofern man den Inhalt des "~/.weechat" Verzeichnisses dorthin kopiert.
Es ist möglich, die WeeChat-Sitzung auf einem anderen Computer wiederherzustellen, wenn Sie den Inhalt der WeeChat Verzeichnisse kopieren (siehe / debug dirs).
----
[[command_weechat_uptime]]
@@ -2008,7 +2025,7 @@ command: Befehl welcher ausgeführt werden soll (oder ein Text der an einen Buff
Hinweis: Der Befehl wird in dem Buffer ausgeführt, in welchem der /wait Befehl ausgeführt wurde (sollte der Buffer nicht mehr existieren, wird der Befehl nicht ausgeführt).
Beispiele:
Betritt nach 10 Sekunden den Channel #test:
Betritt nach 10 Sekunden den Kanal #test:
/wait 10 /join #test
Setzt nach 15 Minuten eine globale Abwesenheit:
/wait 15m /away -all Bin dann mal eben weg
@@ -2131,7 +2148,7 @@ Die folgenden Variablen können in den obigen Optionen genutzt werden:
- ${buffer.short_name}
- ${buffer.nicklist_nicks_count}
- irc_server: IRC Serverdaten, ausschließlich genutzt bei einem IRC Buffer (siehe hdata "irc_server" in API Dokumentation)
- irc_channel: IRC Channeldaten, ausschließlich genutzt bei einem IRC Channel Buffer (siehe hdata "irc_channel" in API Dokumentation)
- irc_channel: IRC Kanaldaten, ausschließlich genutzt bei einem IRC Kanal-Buffer (siehe hdata "irc_channel" in API Dokumentation)
- zusätzliche Variablen die durch buflist bereitgestellt werden:
- ${format_buffer}: der evaluierte Wert der Option buflist.format.buffer; dies kann in der Option buflist.format.buffer_current genutzt werden um zum Beispiel die Hintergrundfarbe zu verändern
- ${current_buffer}: ein Boolean ("0" oder "1"), "1" falls es sich um den aktuellen Buffer handelt; dies kann in einer Bedingung verwendet werden: ${if:${current_buffer}?...:...}
@@ -2151,6 +2168,7 @@ Die folgenden Variablen können in den obigen Optionen genutzt werden:
- ${hotlist}: die Hotlist in der Rohform
- ${hotlist_priority}: "none", "low", "message", "private" oder "highlight"
- ${format_lag}: die Verzögerung für einen IRC Server-Buffer, ist leer falls es keine Verzögerung gibt (evaluiert aus Option buflist.format.lag)
- ${format_tls_version}: Indikator der TLS Version für den Serverbuffer, Channels bleiben unberührt (evaluiert aus Option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2257,14 +2275,14 @@ disable: deaktivieren der FIFO pipe
toggle: Status der FIFO pipe umschalten
Die FIFO-Pipe wird als Fernbedienung genutzt, es können Befehle oder Text von der Shell an die FIFO-Pipe geschickt werden
Standardmäßig ist die FIFO-Pipe in ~/.weechat/weechat_fifo
Standardmäßig heißt die FIFO-Pipe weechat_fifo_xxx (wobei xxx die WeeChat-Prozess-ID ist) und befindet sich im WeeChat-Laufzeitverzeichnis (siehe /debug dirs).
Folgendes Format wird erwartet:
plugin.buffer *Text oder Befehl an dieser Stelle
*Text oder Befehl an dieser Stelle
Beispiel um den eigenen Nick auf dem Server freenode zu ändern:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
Beispiel um den eigenen Nick auf dem Server libera zu ändern:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Bitte lese die Benutzeranleitung für weitere Informationen und Beispiele.
@@ -2513,7 +2531,7 @@ disable: die Protokollierung wird für den aktuellen Buffer deaktiviert (der Lev
Die Einstellungen "logger.level.*" und "logger.mask.*" können genutzt werden um den Level der Protokollierung festzulegen und um eine Maske für einen oder mehrere Buffer zu definieren.
Level der Protokollierung, die die IRC Erweiterung unterstützt:
1: Nachrichten von Usern (private und öffentliche Nachrichten) , notice (Server und Channel)
1: Nachrichten von Usern (private und öffentliche Nachrichten) , notice (Server und Kanal)
2: Wechsel von Nicks (/nick)
3: Nachrichten vom Server
4: join/part/quit Nachrichten
@@ -2528,7 +2546,7 @@ Beispiele:
/set logger.level.irc 3
Die Protokollierung, für den WeeChat Haupt-Buffer, wird deaktiviert:
/set logger.level.core.weechat 0
Für jeden IRC-Server wird ein separates Verzeichnis erstellt und darin eine eigene Protokoll-Datei, für jeden Channel:
Für jeden IRC-Server wird ein separates Verzeichnis erstellt und darin eine eigene Protokoll-Datei, für jeden Kanal:
/set logger.mask.irc "$server/$channel.weechatlog"
----
// end::logger_commands[]
@@ -2701,7 +2719,7 @@ Ohne Angabe eines Argumentes listet dieser Befehl alle geladenen Skripten auf.
stop: schließt den Server Socket (Clients bleiben verbunden)
name: Name des Relays (siehe Format weiter unten)
port: Port der für Relay genutzt werden soll
path: Pfad der für Relay genutzt werden soll (ausschließlich für UNIX Domain Socket); "%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: ("~/.weechat"), Inhalt ist evaluiert (siehe /help eval)
path: Pfad der für Relay genutzt werden soll (ausschließlich für UNIX Domain Socket); Pfad ist evaluiert (siehe Funktion string_eval_path_home in Erweiterung API Referenz)/n
raw: öffnet einen Buffer mit Relay-Rohdaten
sslcertkey: setzt SSL Zertifikat/Schlüssel mittels Pfad in Einstellung relay.network.ssl_cert_key
@@ -2720,10 +2738,10 @@ Das "weechat" Protokoll wird von einem Remote-Interface genutzt um eine Verbindu
Ohne Angabe von Argumenten werden alle Relay-Clients in einem neuen Buffer dargestellt.
Beispiele:
IRC Proxy für Server "freenode":
/relay add irc.freenode 8000
IRC Proxy, für Server "freenode", mit SSL:
/relay add ssl.irc.freenode 8001
IRC Proxy für Server "libera":
/relay add irc.libera 8000
IRC Proxy, für Server "libera", mit SSL:
/relay add ssl.irc.libera 8001
IRC Proxy für alle Server (Client wählt aus), mit SSL:
/relay add ssl.irc 8002
WeeChat Protokoll:
@@ -2737,7 +2755,7 @@ Beispiele:
WeeChat Protokoll, mit SSL, mit IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
Weechat Protokoll über UNIX Domain Socket:
/relay add unix.weechat %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
@@ -2817,7 +2835,17 @@ Im Skript-Buffer, werden folgende Statusangaben für ein Skript angezeigt:
| | | gehalten
| | Skript wird beim Start, von WeeChat, automatisch geladen
| Skript ist installiert (wird aber nicht ausgeführt)
es wird empfohlen dieses Skript zu installieren
beliebtes Skript
In der Ausgabe von /script list, wird der Status für ein Skript angegeben:
* ? i a H N
| | | | | |
| | | | | obsolete (neue Version verfügbar)
| | | | gehalten
| | | Skript wird beim Start, von WeeChat, automatisch geladen
| | Skript ist installiert (wird aber nicht ausgeführt)
| unbekanntes Skript (dieses Skript kann nicht heruntergeladen/aktualisiert werden)
beliebtes Skript
Tastenbefehle die im Skript-Buffer genutzt werden können:
alt+i installiert Skript (physikalisch)
@@ -2948,7 +2976,7 @@ listdefault: zeigt die standardmäßig genutzten Trigger an
modifier: Name(en) des modifier (erforderlich)
line: Buffertyp ("formatted", "free" oder "*"), Liste von Buffermasken, Tags
print: Buffer, Tags, Nachricht, Farben entfernen
command: Befehl (erforderlich), Beschreibung, Argumente, Beschreibung der Argumente, Vervollständigung (Alle Argumente, außer dem Befehl werden ausgewertet, siehe /help eval)
command: Befehl (erforderlich), Beschreibung, Argumente, Beschreibung der Argumente, Vervollständigung (alle Argumente, außer dem Befehl werden ausgewertet, "${tg_trigger_name}" wird durch den Triggernamen ersetzt, siehe /help eval)
command_run: Befehl(e) (erforderlich)
timer: Intervall (erforderlich), Anpassung an Sekunden (erforderlich), maximale Anzahl an Aufrufen
config: Name der Einstellung (erforderlich)
@@ -2980,7 +3008,7 @@ post_action: Aktion welche nach der Abarbeitung des Triggers ausgeführt werden
restore: stellt Trigger mit Standardwerten wieder her (funktioniert nur bei vorgegebenen Triggern)
default: stellt die standardmäßigen Trigger wieder her
monitor: öffnet den Trigger Monitor-Buffer, mit optionaler Filterfunktion:
Filter: zeigt Hooks/Trigger an (ein Hook muss mit "@" beginnen, zum Beispiel "@signal"), mehrere Filter können durch Kommata voneinander getrennt werden; Platzhalter "*" kann im Namen des Trigger verwendet werden
filter: filtert Hooks/Trigger zum Anzeigen (ein Hook muss mit "@" beginnen, zum Beispiel "@signal"), mehrere Filter können durch Kommata voneinander getrennt werden; Platzhalter "*" kann im Namen des Trigger verwendet werden
Wenn ein Trigger-Callback aufgerufen wird, dann wird folgende Befehlskette ausgeführt:
1. Überprüfung von Bedingungen; falls unwahr, beenden
+153 -69
View File
@@ -16,8 +16,8 @@
** Werte: sha224, sha256, sha384, sha512
** Standardwert: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** Beschreibung: pass:none[Pfad zu einer Datei die die Passphrase enthält um damit schutzwürdige Daten zu ver- und entschlüsseln. Diese Einstellung findet nur Anwendung, wenn die Datei sec.conf gelesen wird. Es wird auch nur die erste Zeile eingelesen. Diese Datei wird nur verwendet, falls die Umgebungsvariable "WEECHAT_PASSPHRASE" nicht genutzt wird (die Umgebungsvariable besitzt eine höhere Priorität). Sicherheitshinweis: Es ist anzuraten dieser Datei nur für die eigene Person Leserechte zu gewähren und die Datei nicht im Heimatverzeichnis von WeeChat zu sichern (zum Beispiel im /home/ Order); Beispiel: "~/.weechat-passphrase"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** Beschreibung: pass:none[Auslesen der Passphrase aus der Ausgabe des angegebenen Befehls (nur die erste Zeile wird verwendet und darf kein zusätzliches Zeichen enthalten); Diese Option wird nur verwendet, wenn die Datei sec.conf gelesen wird und wenn die Umgebungsvariable "WEECHAT_PASSPHRASE" nicht festgelegt ist (die Umgebungsvariable hat eine höhere Priorität); Beispiel mit Passwortspeicher: "/usr/bin/pass show weechat / passphrase"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -55,7 +55,7 @@
** Standardwert: `+white+`
* [[option_weechat.color.chat_channel]] *weechat.color.chat_channel*
** Beschreibung: pass:none[Farbe für den Channel-Namen]
** Beschreibung: pass:none[Farbe für den Kanalnamen]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+white+`
@@ -403,7 +403,7 @@
** Standardwert: `+default+`
* [[option_weechat.color.status_number]] *weechat.color.status_number*
** Beschreibung: pass:none[Farbe des aktuellen Channels in der Statuszeile]
** Beschreibung: pass:none[Farbe des aktuellen Kanals in der Statuszeile]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+yellow+`
@@ -846,6 +846,12 @@
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** Beschreibung: pass:none[Aktualisiert die Hotlist, wenn der Buffer gewechselt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** Beschreibung: pass:none[Anzahl an Zeichen die nach links verschoben werden sollen, falls das Ende der Eingabezeile erreicht wird]
** Typ: integer
@@ -1140,6 +1146,12 @@
** Werte: beliebige Zeichenkette
** Standardwert: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** Beschreibung: pass:none[Aktualisiert das Lesezeichen, wenn der Buffer gewechselt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** Beschreibung: pass:none[die aktuelle Konfiguration wird beim Beenden automatisch gesichert]
** Typ: boolesch
@@ -1248,11 +1260,17 @@
** Werte: 1 .. 2147483647
** Standardwert: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** Beschreibung: pass:none[Datei beinhaltet die digitalen Zertifikate ("%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: "~/.weechat")]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** Beschreibung: pass:none[lädt die standardmäßigen vertrauenswürdigen Zertifizierungsstellen des Systems beim Start; Dies kann deaktiviert werden, um Speicherplatz zu sparen, falls keine SSL-Verbindungen verwendet werden]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** Beschreibung: pass:none[zusätzliche Datei(en) bei den Zertifizierungsstellen; mehrere Dateien müssen durch Doppelpunkte getrennt werden (jeder Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/etc/ssl/certs/ca-certificates.crt"+`
** Standardwert: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** Beschreibung: pass:none[Zeitüberschreitung für gnutls Handshake (in Sekunden)]
@@ -1285,10 +1303,10 @@
** Standardwert: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** Beschreibung: pass:none[Suchpfad für Erweiterungen ("%h"' wird durch das WeeChat-Basisverzeichnis ersetzt, voreingestellt ist "~/.weechat")]
** Beschreibung: pass:none[Pfad für die Suche nach Erweiterungen (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/plugins"+`
** Standardwert: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** Beschreibung: pass:none[speichert Konfigurationen, falls Erweiterungen beendet werden]
@@ -1296,14 +1314,44 @@
** Werte: on, off
** Standardwert: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** Beschreibung: pass:none[Befehl welcher ausgeführt werden soll, wenn das Signal empfangen wird. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** Beschreibung: pass:none[Nach dem Start von WeeChat wird dieser Befehl aufgerufen. Dies geschieht nachdem die Erweiterungen geladen worden sind (mehrere Befehle sind durch ";" zu trennen) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Befehl wird ausgeführt, wenn WeeChat gestartet wird, nachdem die Erweiterungen geladen wurden. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** Beschreibung: pass:none[Nach dem Start von WeeChat wird dieser Befehl aufgerufen. Dies geschieht bevor die Erweiterungen geladen werden (mehrere Befehle sind durch ";" zu trennen) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Befehl wird ausgeführt, wenn WeeChat gestartet wird, bevor Erweiterungen geladen werden. Mehrere Befehle können durch Semikolons getrennt werden (Hinweis: Inhalt wird ausgewertet, siehe / help eval)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1409,10 +1457,10 @@
** Standardwert: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** Beschreibung: pass:none[Pfad für WeeChat Protokolldateien; "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat"); eine Datumsspezifikation ist zulässig (siehe: man strftime) (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Pfad für WeeChat-Protokolldateien; Datumsangaben sind zulässig (siehe man strftime) (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/logs/"+`
** Standardwert: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** Beschreibung: pass:none[Ersatzzeichen für Dateinamen, falls der Dateiname Sonderzeichen beinhaltet (z.B. das Trennzeichen bei Verzeichnissen "/")]
@@ -1675,7 +1723,7 @@
** Standardwert: `+"${color:default},"+`
* [[option_buflist.format.indent]] *buflist.format.indent*
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Channel und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Zeichenkette die beim Einrücken von Kanal und privaten Buffern angezeigt wird (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+" "+`
@@ -1693,7 +1741,7 @@
** Standardwert: `+"${name}"+`
* [[option_buflist.format.nick_prefix]] *buflist.format.nick_prefix*
** Beschreibung: pass:none[Format des Nick-Präfix für einen Channel (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Beschreibung: pass:none[Format des Nick-Präfix für einen Kanal (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"${color_nick_prefix}${nick_prefix}"+`
@@ -1704,6 +1752,12 @@
** Werte: beliebige Zeichenkette
** Standardwert: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** Beschreibung: pass:none[Format für die TLS-Version für einen IRC-Serverbuffer (Hinweis: Inhalt wird evaluiert, siehe /help buflist)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** Beschreibung: pass:none[fügt einen Zeilenumbruch zwischen die einzelnen Buffer hinzu um pro Zeile einen Buffer anzuzeigen (empfohlen); falls deaktiviert muss ein Zeilenumbruch manuell hinzugefügt werden, "${\\n}", des Weiteren ist die Mausunterstützung nicht mehr gegeben]
** Typ: boolesch
@@ -1765,10 +1819,16 @@
** Standardwert: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes Feld ist entweder eine hdata Variable von Buffer ("var"), eine hdata Variable vom Typ IRC Server ("irc_server.var") oder eine hdata Variable vom Typ IRC Channel ("irc_channel.var"); wird das "-" Zeichen vor einem Feld angewendet, wird die Ausgabe umgekehrt, um bei einem Vergleich nicht zwischen Groß- und Kleinschreibung zu unterscheiden wird das Zeichen "~" verwendet; Beispiel: "-~short_name" sortiert die Buffer nach ihrem Kurznamen, wobei dies invertiert passiert und nicht zwischen Groß-oder Kleinschreibung unterschieden wird (Hinweis: der Inhalt ist evaluiert, nur der Pointer der bar_item kann genutzt werden, Beispiel "bar_item.name")]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Feldern um die Buffer zu sortieren; jedes Feld ist entweder eine hdata Variable von Buffer ("var"), eine hdata Variable vom Typ IRC Server ("irc_server.var") oder eine hdata Variable vom Typ IRC Kanal ("irc_channel.var"); wird das "-" Zeichen vor einem Feld angewendet, wird die Ausgabe umgekehrt, um bei einem Vergleich nicht zwischen Groß- und Kleinschreibung zu unterscheiden wird das Zeichen "~" verwendet; Beispiel: "-~short_name" sortiert die Buffer nach ihren Kurznamen, wobei dies invertiert passiert und nicht zwischen Groß-oder Kleinschreibung unterschieden wird (Hinweis: der Inhalt ist evaluiert, vor dem Aufteilen in Felder, kann nur die Variable "bar_item" genutzt werden, um zwischen verschiedenen Buffer-Items zu unterscheiden, zum Beispiel "${bar_item.name}")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** Beschreibung: pass:none[Anzahl der Buflist-Bar-Items, die verwendet werden können; die Item-Namen sind: "buflist", "buflist2", "buflist3"; Seien Sie vorsichtig, wenn Sie mehr als ein Bar-Item verwenden, wird die Anzeige der Bufferliste verlangsamt]
** Typ: integer
** Werte: 1 .. 3
** Standardwert: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** Standardwert: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** Beschreibung: pass:none[Pfad für eingehende Dateien: "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat"); WeeChat PID kann mit ${info:pid} genutzt werden (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Pfad für FIFO-Datei; WeeChat PID kann im Pfad mit ${info:pid} verwendet werden (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/weechat_fifo"+`
** Standardwert: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** Standardwert: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nicks deren Chat- und Transferanfragen automatisch akzeptiert werden. Format : "server.nick" (für einen speziellen Server) oder "nick" (global, für alle Server); Beispiel: "freenode.FlashCode,andrew"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nicks deren Chat- und Transferanfragen automatisch akzeptiert werden. Format : "server.nick" (für einen speziellen Server) oder "nick" (global, für alle Server); Beispiel: "libera.FlashCode,andrew"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -1883,10 +1943,10 @@
** Standardwert: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** Beschreibung: pass:none[Pfad für eingehende Dateien: "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Pfad zum Schreiben eingehender Dateien (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/xfer"+`
** Standardwert: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** Beschreibung: pass:none[Dateiendung der temporären Datei, die während eines eingehenden Datei-Transfers genutzt wird und die gelöscht wird, sobald die Übertragung erfolgreich beendet wurde; wenn -leer-, dann wird keine temporäre Dateiendung während des Transfers genutzt]
@@ -1895,7 +1955,7 @@
** Standardwert: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** Beschreibung: pass:none[Pfad für ausgehende Dateien (falls kein Pfad durch den Anwender angegeben wurde): "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[Pfad zum Lesen von Dateien beim Senden (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"~"+`
@@ -1981,7 +2041,7 @@
** Standardwert: `+lightcyan+`
* [[option_irc.color.item_channel_modes]] *irc.color.item_channel_modes*
** Beschreibung: pass:none[Farbe der Channel-Modes (neben dem Channelnamen)]
** Beschreibung: pass:none[Farbe der Kanal-Modes (neben des Kanalnamens)]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
@@ -2004,6 +2064,24 @@
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** Beschreibung: pass:none[Farbe die für eine unsicherere TLS-Version im Bar-Item "tls_version" genutzt wird]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** Beschreibung: pass:none[Farbe die für eine unsichere TLS-Versionen im Bar-Item "tls_version" genutzt wirdFarbe für unsichere TLS-Versionen im Balkenelement "tls_version"]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** Beschreibung: pass:none[Farbe die für eine sicherere TLS-Version im Bar-Item "tls_version" genutzt wird]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** Beschreibung: pass:none[Textfarbe für "account" Nachrichten]
** Typ: Farbe
@@ -2017,7 +2095,7 @@
** Standardwert: `+brown+`
* [[option_irc.color.message_join]] *irc.color.message_join*
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Betreten eines Channels angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Betreten eines Kanals angezeigt werden soll]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+green+`
@@ -2029,7 +2107,7 @@
** Standardwert: `+red+`
* [[option_irc.color.message_quit]] *irc.color.message_quit*
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Verlassen/Beenden eines Channels angezeigt werden soll]
** Beschreibung: pass:none[Textfarbe in der die Meldungen für das Verlassen/Beenden eines Kanals angezeigt werden soll]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+red+`
@@ -2065,49 +2143,49 @@
** Standardwert: `+default+`
* [[option_irc.color.topic_current]] *irc.color.topic_current*
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Channels dargestellt werden soll (wenn ein Channel betreten oder der Befehl /topic genutzt wird)]
** Beschreibung: pass:none[Farbe in dem das aktuelle Thema des Kanals dargestellt werden soll (wenn ein Kanal betreten oder der Befehl /topic genutzt wird)]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.color.topic_new]] *irc.color.topic_new*
** Beschreibung: pass:none[Farbe in dem das neue Thema des Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Beschreibung: pass:none[Farbe in dem das neue Thema des Kanals dargestellt werden soll, falls das Thema des Kanals geändert wurde]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+white+`
* [[option_irc.color.topic_old]] *irc.color.topic_old*
** Beschreibung: pass:none[Farbe in dem das alte Thema des Channels dargestellt werden soll, falls das Thema des Channels geändert wurde]
** Beschreibung: pass:none[Farbe in dem das alte Thema des Kanals dargestellt werden soll, falls das Thema des Kanals geändert wurde]
** Typ: Farbe
** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen
** Standardwert: `+default+`
* [[option_irc.look.buffer_open_before_autojoin]] *irc.look.buffer_open_before_autojoin*
** Beschreibung: pass:none[betritt man automatisch einen Channel-Buffer (mittels autojoin Option) wird dieser direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten; dies ist sinnvoll um die Channels immer an der selben Position bei einem Neustart zu öffnen]
** Beschreibung: pass:none[betritt man automatisch einen Kanal-Buffer (mittels autojoin Option) wird dieser direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten; dies ist sinnvoll um die Kanäle immer an der selben Position bei einem Neustart zu öffnen]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.buffer_open_before_join]] *irc.look.buffer_open_before_join*
** Beschreibung: pass:none[betritt man mittels dem /join Befehl einen Channel wird der Buffer direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten]
** Beschreibung: pass:none[betritt man mittels dem /join Befehl einen Kanal wird der Buffer direkt geöffnet, ohne auf die JOIN Nachricht des Servers zu warten]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
* [[option_irc.look.buffer_switch_autojoin]] *irc.look.buffer_switch_autojoin*
** Beschreibung: pass:none[wechselt automatisch zum Channel-Buffer falls dieser automatisch betreten wurde (mittels der Serveroption "autojoin")]
** Beschreibung: pass:none[wechselt automatisch zum Kanal-Buffer falls dieser automatisch betreten wurde (mittels der Serveroption "autojoin")]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.buffer_switch_join]] *irc.look.buffer_switch_join*
** Beschreibung: pass:none[wechselt automatisch zum Channel-Buffer falls dieser manuell betreten wurde (mittels dem /join Befehl)]
** Beschreibung: pass:none[wechselt automatisch zum Kanal-Buffer falls dieser manuell betreten wurde (mittels dem /join Befehl)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.color_nicks_in_names]] *irc.look.color_nicks_in_names*
** Beschreibung: pass:none[nutzt in der Ausgabe von /names die jeweiligen Farbe des Nick (oder bei der Auflistung der Nicks wenn man einen Channel betritt)]
** Beschreibung: pass:none[nutzt in der Ausgabe von /names die jeweiligen Farbe des Nick (oder bei der Auflistung der Nicks wenn man einen Kanal betritt)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2125,7 +2203,7 @@
** Standardwert: `+on+`
* [[option_irc.look.color_pv_nick_like_channel]] *irc.look.color_pv_nick_like_channel*
** Beschreibung: pass:none[nutzt die selbe Farbe für die Darstellung des Nicks im Channel wie auch im privaten Buffer]
** Beschreibung: pass:none[nutzt die selbe Farbe für die Darstellung des Nicks im Kanal wie auch im privaten Buffer]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2137,7 +2215,7 @@
** Standardwert: `+"%a, %d %b %Y %T %z"+`
* [[option_irc.look.display_away]] *irc.look.display_away*
** Beschreibung: pass:none[zeigt eine Nachricht an, sobald der Abwesenheitsstatus ein- bzw. ausgeschaltet wird (off: zeigt/sendet keine Nachricht, local: eine Nachricht wird lokal angezeigt, channel: sendet eine Nachricht an die Channels)]
** Beschreibung: pass:none[zeigt eine Nachricht an, sobald der Abwesenheitsstatus ein- bzw. ausgeschaltet wird (off: zeigt/sendet keine Nachricht, local: eine Nachricht wird lokal angezeigt, channel: sendet eine Nachricht an die Kanäle)]
** Typ: integer
** Werte: off, local, channel
** Standardwert: `+local+`
@@ -2179,13 +2257,13 @@
** Standardwert: `+on+`
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten die beim Betreten eines Channels angezeigt werden sollen: 324 = Channel-Modi, 329 = Erstellungsdatum des Channels, 332 = Topic, 333 = Nick/Datum für Topic, 353 = genutzte Namen im Channel, 366 = Anzahl der Nicks im Channel]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten die beim Betreten eines Kanals angezeigt werden sollen: 324 = Channel-Modi, 329 = Erstellungsdatum des Kanals, 332 = Topic, 333 = Nick/Datum für Topic, 353 = genutzte Namen im Kanal, 366 = Anzahl der Nicks im Kanal]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"329,332,333,366"+`
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** Beschreibung: pass:none[zeige das alte Thema an, falls das Thema des Channels geändert wurde]
** Beschreibung: pass:none[zeige das alte Thema an, falls das Thema des Kanals geändert wurde]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2209,7 +2287,7 @@
** Standardwert: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Wörtern die in Channel-Buffern als Highlight erscheinen sollen (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden; des Weiteren können folgende Variablen genutzt werden: $nick, $channel und $server). Wird ein Buffer geöffnet, dann werden die angegeben Wörter dem Buffer-Merkmal "highlight_words" hinzugefügt. Dies bedeutet, dass diese Einstellung keinen direkten Einfluss auf schon geöffnete Buffer hat. Eine leere Zeichenkette deaktiviert ein Highlight für den Nick. Beispiel: "$nick", "(?-i)$nick"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Wörtern die im Kanal-Buffern als Highlight erscheinen sollen (zwischen Groß- und Kleinschreibung wird nicht unterschieden. Um zwischen Groß- und Kleinschreibung zu unterscheiden muss zu Beginn "(?-i)" genutzt werden; des Weiteren können folgende Variablen genutzt werden: $nick, $channel und $server). Wird ein Buffer geöffnet, dann werden die angegeben Wörter dem Buffer-Merkmal "highlight_words" hinzugefügt. Dies bedeutet, dass diese Einstellung keinen direkten Einfluss auf schon geöffnete Buffer hat. Eine leere Zeichenkette deaktiviert ein Highlight für den Nick. Beispiel: "$nick", "(?-i)$nick"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"$nick"+`
@@ -2233,7 +2311,7 @@
** Standardwert: `+"irc_privmsg,irc_notice"+`
* [[option_irc.look.item_channel_modes_hide_args]] *irc.look.item_channel_modes_hide_args*
** Beschreibung: pass:none[unterdrückt die Ausgabe von Argumenten die die Channel-Modi betreffen, sofern der entsprechende Modus für den Channel gesetzt ist ("*" unterdrückt jedwede Ausgabe von Argumenten; wird kein Wert angegeben, dann werden alle Argumente angezeigt); Beispiele: "kf" unterdrückt die Argumente, falls "k" oder "f" für den Channel gesetzt sind]
** Beschreibung: pass:none[unterdrückt die Ausgabe von Argumenten die die Kanalmodi betreffen, sofern der entsprechende Modus für den Kanal gesetzt ist ("*" unterdrückt jedwede Ausgabe von Argumenten; wird kein Wert angegeben, dann werden alle Argumente angezeigt); Beispiele: "kf" unterdrückt die Argumente, falls "k" oder "f" für den Kanal gesetzt sind]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"k"+`
@@ -2257,7 +2335,7 @@
** Standardwert: `+on+`
* [[option_irc.look.join_auto_add_chantype]] *irc.look.join_auto_add_chantype*
** Beschreibung: pass:none[es wird dem Channelnamen automatisch der Channel-Typ vorangestellt, falls bei der Benutzung des /join Befehls der angegebene Channel-Name keinen gültigen Typ besitzt; Beispiel: "/join weechat" wird als: "/join #weechat" versendet]
** Beschreibung: pass:none[es wird dem Kanalnamen automatisch der Kanal-Typ vorangestellt, falls bei der Benutzung des /join Befehls der angegebene Kanalname keinen gültigen Typ besitzt; Beispiel: "/join weechat" wird als: "/join #weechat" versendet]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2269,13 +2347,13 @@
** Standardwert: `+current+`
* [[option_irc.look.new_channel_position]] *irc.look.new_channel_position*
** Beschreibung: pass:none[ein neu geöffneter Channel wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Channel/privaten Buffer des jeweiligen Servers)]
** Beschreibung: pass:none[ein neu geöffneter Kanal wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Kanal/privaten Buffer des jeweiligen Servers)]
** Typ: integer
** Werte: none, next, near_server
** Standardwert: `+none+`
* [[option_irc.look.new_pv_position]] *irc.look.new_pv_position*
** Beschreibung: pass:none[ein neuer privater Buffer wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Channel/privaten Buffer des jeweiligen Servers)]
** Beschreibung: pass:none[ein neuer privater Buffer wird auf eine Position gezwungen (none = standardmäßige Position (sollte der letzte Buffer in der Liste sein), next = aktueller Buffer + 1, near_server = nach dem letztem Kanal/privaten Buffer des jeweiligen Servers)]
** Typ: integer
** Werte: none, next, near_server
** Standardwert: `+none+`
@@ -2311,13 +2389,13 @@
** Standardwert: `+auto+`
* [[option_irc.look.notice_welcome_redirect]] *irc.look.notice_welcome_redirect*
** Beschreibung: pass:none[automatische Weiterleitung von Willkommen Nachrichten in den entsprechenden Channel-Buffer. Solche Nachrichten haben als Empfänger den entsprechenden Nick. Der Channelname wird aber der Nachricht vorangestellt. Eine solche ENTRYMSG Nachricht sieht auf dem Atheme IRC Server wie folgt aus: "[#channel\] Herzlich Willkommen in diesem Channel ..."]
** Beschreibung: pass:none[automatische Weiterleitung von Willkommen Nachrichten in den entsprechenden Kanal-Buffer. Solche Nachrichten haben als Empfänger den entsprechenden Nick. Der Kanalname wird aber der Nachricht vorangestellt. Eine solche ENTRYMSG Nachricht sieht auf dem Atheme IRC Server wie folgt aus: "[#channel\] Herzlich Willkommen in diesem Kanal ..."]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
* [[option_irc.look.notice_welcome_tags]] *irc.look.notice_welcome_tags*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Schlagwörtern für Willkommen-Nachrichten die in einen Channel umgeleitet werden. Zum Beispiel: "notify_private"]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Schlagwörtern für Willkommen-Nachrichten die in einen Kanal umgeleitet werden. Zum Beispiel: "notify_private"]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2335,7 +2413,7 @@
** Standardwert: `+"notify_message"+`
* [[option_irc.look.part_closes_buffer]] *irc.look.part_closes_buffer*
** Beschreibung: pass:none[schließt den Buffer wenn "/part" im Channel ausgeführt wird]
** Beschreibung: pass:none[schließt den Buffer wenn "/part" im Kanal ausgeführt wird]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2365,7 +2443,7 @@
** Standardwert: `+merge_with_core+`
* [[option_irc.look.smart_filter]] *irc.look.smart_filter*
** Beschreibung: pass:none[filtert join/part/quit/nick Nachrichten für einen Nick der einige Minuten im Channel inaktiv gewesen ist (dazu muss ein Filter mit dem Schlagwort "irc_smart_filter" erstellt werden, siehe /help filter)]
** Beschreibung: pass:none[filtert join/part/quit/nick Nachrichten für einen Nick der einige Minuten im Kanal inaktiv gewesen ist (dazu muss ein Filter mit dem Schlagwort "irc_smart_filter" erstellt werden, siehe /help filter)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+on+`
@@ -2395,7 +2473,7 @@
** Standardwert: `+on+`
* [[option_irc.look.smart_filter_join_unmask]] *irc.look.smart_filter_join_unmask*
** Beschreibung: pass:none[Verzögerung (in Minuten) um Join Mitteilungen rückwirkend anzuzeigen, falls diese mittels "irc_smart_filter" unterdrückt wurden. Sollte ein Nick während der vorgegeben Zeit etwas im Channel schreiben, dann wird seine Join Mitteilung angezeigt. Dies bezieht sich auf Nachrichten, eine Notice, Änderungen am Topic oder falls der Nick gewechselt wird (0 = deaktiviert: join-Mitteilungen bleiben verborgen)]
** Beschreibung: pass:none[Verzögerung (in Minuten) um Join Mitteilungen rückwirkend anzuzeigen, falls diese mittels "irc_smart_filter" unterdrückt wurden. Sollte ein Nick während der vorgegeben Zeit etwas im Kanal schreiben, dann wird seine Join Mitteilung angezeigt. Dies bezieht sich auf Nachrichten, eine Notice, Änderungen am Topic oder falls der Nick gewechselt wird (0 = deaktiviert: join-Mitteilungen bleiben verborgen)]
** Typ: integer
** Werte: 0 .. 10080
** Standardwert: `+30+`
@@ -2425,7 +2503,7 @@
** Standardwert: `+off+`
* [[option_irc.look.topic_strip_colors]] *irc.look.topic_strip_colors*
** Beschreibung: pass:none[Farben werden im Channel-Thema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Beschreibung: pass:none[Farben werden im Kanalthema entfernt (wird nur genutzt wenn der Buffer-Titel angezeigt wird)]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
@@ -2545,7 +2623,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.autojoin]] *irc.server_default.autojoin*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Channels, die beim Verbinden mit dem Server automatisch betreten werden (nachdem die Einstellungen command + delay ausgeführt wurden). Channels die einen Schlüssel benötigen müssen in der Auflistung als erstes aufgeführt werden. Die Schlüssel, zu den jeweiligen Channels, werden nach den Channels aufgeführt (eine Trennung von Channels und Schlüssel erfolgt mittels einem Leerzeichen. Schlüssel werden untereinander auch durch Kommata voneinander getrennt) (Beispiel: "#channel1,#channel2,#channnel3 key1,key2", #channel1 und #channel2 sind durch jeweils einen Schlüssel, key1 und key2, geschützt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Kanälen, die beim Verbinden mit dem Server automatisch betreten werden (nachdem die Einstellungen command + delay ausgeführt wurden). Kanäle, die einen Schlüssel benötigen, müssen in der Auflistung als erstes aufgeführt werden. Die Schlüssel, zu den jeweiligen Kanälen, werden nach den Kanälen aufgeführt (eine Trennung von Kanälen und Schlüssel erfolgt mittels eines Leerzeichens. Schlüssel werden hintereinander auch durch Kommata voneinander getrennt) (Beispiel: "#channel1,#channel2,#channnel3 key1,key2", #channel1 und #channel2 sind durch jeweils einen Schlüssel, key1 und key2, geschützt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2563,13 +2641,13 @@
** Standardwert: `+10+`
* [[option_irc.server_default.autorejoin]] *irc.server_default.autorejoin*
** Beschreibung: pass:none[Channels automatisch betreten, falls man rausgeworfen wurde. Es kann eine lokale Buffer Variable für einen Channel erstellt werden, diese lokale Variable wird vorrangig behandelt (Name der lokalen Variable: "autorejoin", Wert: "on" oder "off")]
** Beschreibung: pass:none[Kanäle automatisch betreten, falls man rausgeworfen wurde. Es kann eine lokale Buffer Variable für einen Kanal erstellt werden, diese lokale Variable wird vorrangig behandelt (Name der lokalen Variable: "autorejoin", Wert: "on" oder "off")]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
* [[option_irc.server_default.autorejoin_delay]] *irc.server_default.autorejoin_delay*
** Beschreibung: pass:none[Wartezeit, in Sekunden, die verstreichen soll bevor man den Channel automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Beschreibung: pass:none[Wartezeit, in Sekunden, die verstreichen soll bevor man den Kanal automatisch erneut betritt (nachdem man rausgeworfen wurde)]
** Typ: integer
** Werte: 0 .. 86400
** Standardwert: `+30+`
@@ -2581,7 +2659,7 @@
** Standardwert: `+0+`
* [[option_irc.server_default.away_check_max_nicks]] *irc.server_default.away_check_max_nicks*
** Beschreibung: pass:none[Die Abwesenheit von Nutzern in Channels wird nicht überprüft wenn die Anzahl der Nutzer höher ist, als der angegebene Wert (0 = unbegrenzte Anzahl an Nutzern im Channel)]
** Beschreibung: pass:none[Die Abwesenheit von Nutzern in Kanälen wird nicht überprüft wenn die Anzahl der Nutzer höher ist, als der angegebene Wert (0 = unbegrenzte Anzahl an Nutzern im Kanal)]
** Typ: integer
** Werte: 0 .. 1000000
** Standardwert: `+25+`
@@ -2593,19 +2671,19 @@
** Standardwert: `+""+`
* [[option_irc.server_default.charset_message]] *irc.server_default.charset_message*
** Beschreibung: pass:none[Teil der IRC Nachricht (empfangen oder gesendet) die zum Zielzeichensatz dekodiert/kodiert werden soll; message = die komplette IRC Nachricht (Standard), channel = beginnend mit dem Channel-Namen (sofern dieser gefunden wird, ansonsten Fallback auf text), text = beginnend mit dem Nachrichtentext (dieser Wert sollte ausprobiert werden, falls es Probleme bei der Kodierung des Channel-Namen geben sollte)]
** Beschreibung: pass:none[Teil der IRC Nachricht (empfangen oder gesendet) die zum Zielzeichensatz dekodiert/kodiert werden soll; message = die komplette IRC Nachricht (Standard), channel = beginnend mit dem Kanalnamen (sofern dieser gefunden wird, ansonsten Fallback auf text), text = beginnend mit dem Nachrichtentext (dieser Wert sollte ausprobiert werden, falls es Probleme bei der Kodierung des Kanalnamens geben sollte)]
** Typ: integer
** Werte: message, channel, text
** Standardwert: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** Beschreibung: pass:none[Befehl(e) welche nach einem Verbindungsaufbau zum Server und vor dem automatischem Betreten von Channels ausgeführt werden sollen (mehrere Befehle müssen durch ";" getrennt werden, soll ein Semikolon genutzt werden, schreibt man "\;", die Platzhalter $nick,$channel und $server werden durch den entsprechenden Wert ersetzt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[Befehl(e) welche nach einem Verbindungsaufbau zum Server und vor dem automatischem Betreten von Kanälen ausgeführt werden sollen (mehrere Befehle können durch ";" getrennt werden, will man ein Semikolon nutzen, schreibt man "\;", die Platzhalter $nick,$channel und $server werden durch den entsprechenden Wert ersetzt) (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_irc.server_default.command_delay]] *irc.server_default.command_delay*
** Beschreibung: pass:none[Wartezeit (in Sekunden) nach Ausführung des Befehls und bevor Channels automatisch betreten werden (Beispiel: es wird eine gewisse Zeit gewartet, um eine Authentifizierung zu ermöglichen)]
** Beschreibung: pass:none[Wartezeit (in Sekunden) nach Ausführung des Befehls und bevor Kanäle automatisch betreten werden (Beispiel: es wird eine gewisse Zeit gewartet, um eine Authentifizierung zu ermöglichen)]
** Typ: integer
** Werte: 0 .. 3600
** Standardwert: `+0+`
@@ -2616,6 +2694,12 @@
** Werte: 1 .. 3600
** Standardwert: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** Beschreibung: pass:none[Kanal-Typ-Präfix, die verwendet werden sollen, wenn der Server diese nicht in Nachricht 005 sendet (Standard ist "#&")]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** Beschreibung: pass:none[bei der Kommunikation mit dem Server wird das IPv6 Protokoll genutzt (sollte IPv6 nicht verfügbar sein dann wird automatisch auf IPv4 umgeschaltet); wird die Funktion deaktiviert, dann wird ausschließlich IPv4 genutzt]
** Typ: boolesch
@@ -2629,7 +2713,7 @@
** Standardwert: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** Beschreibung: pass:none[Standardmitteilung einer kick-Nachricht, für die Befehle "/kick" und "/kickban" (Hinweis: Inhalt wird evaluiert, siehe /help eval; Variablen die genutzt werden können: ${nick}, ${channel} und ${server})]
** Beschreibung: pass:none[Standardmitteilung einer kick-Nachricht, für die Befehle "/kick" und "/kickban" (Hinweis: Inhalt wird evaluiert, siehe /help eval; besondere Variablen ${nick} (eigener Nick), ${target} (betroffener Nick), ${channel} und ${server}, werden durch den entsprechenden Wert ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2689,15 +2773,15 @@
** Standardwert: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** Beschreibung: pass:none[Datei mit privatem ECC Schlüssel für den "ecdsa-nist256p-challenge" Mechanismus ("%h" wird durch das WeeChat Verzeichnis ersetzt, standardmäßig "~/.weechat")]
** Beschreibung: pass:none[Datei mit privatem ECC-Schlüssel für den Mechanismus "ecdsa-nist256p-challenge" (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** Beschreibung: pass:none[Verfahren welches bei einer SASL Authentifizierung angewandt werden soll: "plain" Passwort wird im Klartext gesendet, "ecdsa-nist256p-challenge" für öffentlich/private Schlüsselmethode, "external" SSL Zertifikat welches auf Client Seite vorliegt wird verwendet, "dh-blowfish" Passwort wird mittels blowfish verschlüsselt (unsicher, wird nicht empfohlen), "dh-aes" Passwort wird mittels AES verschlüsselt (unsicher, wird nicht empfohlen)]
** Beschreibung: pass:none[Verfahren welches bei einer SASL Authentifizierung angewandt werden soll: "plain" Passwort wird im Klartext gesendet, "scram-sha-1" für SCRAM-Authentifizierung mit SHA-1-Digest-Algorithmus, "scram-sha-256" für SCRAM-Authenrifizierung mit SHA-256 Digest-Algorithmus, "scram-sha-512" für SCRAM-Authentifizierung mit SHA-512 Digest-Algorithmus, "ecdsa-nist256p-challenge" für öffentlich/private Schlüsselmethode, "external" SSL Zertifikat welches auf Client Seite vorliegt wird verwendet, "dh-blowfish" Passwort wird mittels blowfish verschlüsselt (unsicher, wird nicht empfohlen), "dh-aes" Passwort wird mittels AES verschlüsselt (unsicher, wird nicht empfohlen)]
** Typ: integer
** Werte: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Werte: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** Standardwert: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2731,7 +2815,7 @@
** Standardwert: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** Beschreibung: pass:none[Datei für SSL Zertifikat um automatisch den eigenen Nick zu identifizieren ("%h" wird durch das WeeChat Verzeichnis ersetzt, Standardverzeichnis: "~/.weechat")]
** Beschreibung: pass:none[SSL-Zertifikatdatei zur automatischen Identifizierung Ihres Nick (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2767,7 +2851,7 @@
** Standardwert: `+on+`
* [[option_irc.server_default.usermode]] *irc.server_default.usermode*
** Beschreibung: pass:none[Usermode(s) der direkt nach der Verbindung zum Server gesetzt werden soll. Dies geschieht bevor Befehle für den Server ausgeführt und bevor Channels automatisch betreten werden; Beispiele: "+R" (um den Modus "R" zu setzen), "+R-i" (setzt den Modus "R" und entfernt den Modus "i"); siehe /help mode um den Befehlssatz angezeigt zu bekommen (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Beschreibung: pass:none[Usermode(s) der direkt nach der Verbindung zum Server gesetzt werden soll. Dies geschieht bevor Befehle für den Server ausgeführt und bevor Kanäle automatisch betreten werden; Beispiele: "+R" (um den Modus "R" zu setzen), "+R-i" (setzt den Modus "R" und entfernt den Modus "i"); siehe /help mode um den Befehlssatz angezeigt zu bekommen (Hinweis: Inhalt wird evaluiert, siehe /help eval; Serveroptionen sind mittels ${irc_server.xxx} evaluiert und ${server} wird durch den eigentlichen Servernamen ersetzt)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+""+`
@@ -2835,13 +2919,13 @@
** Standardwert: `+white+`
* [[option_relay.irc.backlog_max_minutes]] *relay.irc.backlog_max_minutes*
** Beschreibung: pass:none[Zeitangabe, in Minuten, wie lange die Zeilen im Verlaufsspeicher für jeden IRC Channel gehalten werden sollen (0 = unbegrenzt, Beispiele: 1440 = einen Tag, 10080 = eine Woche, 43200 = einen Monat, 525600 = ein Jahr)]
** Beschreibung: pass:none[Zeitangabe, in Minuten, wie lange die Zeilen im Verlaufsspeicher für jeden IRC Kanal gehalten werden sollen (0 = unbegrenzt, Beispiele: 1440 = einen Tag, 10080 = eine Woche, 43200 = einen Monat, 525600 = ein Jahr)]
** Typ: integer
** Werte: 0 .. 2147483647
** Standardwert: `+0+`
* [[option_relay.irc.backlog_max_number]] *relay.irc.backlog_max_number*
** Beschreibung: pass:none[maximale Anzahl an Zeilen im Verlaufsspeicher. Dies gilt für jeden IRC Channel (0: keine Zeilenbegrenzung)]
** Beschreibung: pass:none[maximale Anzahl an Zeilen im Verlaufsspeicher. Dies gilt für jeden IRC Kanal (0: keine Zeilenbegrenzung)]
** Typ: integer
** Werte: 0 .. 2147483647
** Standardwert: `+1024+`
@@ -2859,7 +2943,7 @@
** Standardwert: `+off+`
* [[option_relay.irc.backlog_tags]] *relay.irc.backlog_tags*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten-Tags welche im Verlaufsspeicher von IRC Channels angezeigt werden (unterstützte Tags: "irc_join", "irc_part", "irc_quit", "irc_nick", "irc_privmsg"), "*" = alle unterstützten Tags]
** Beschreibung: pass:none[durch Kommata getrennte Liste von Nachrichten-Tags welche im Verlaufsspeicher von IRC Kanälen angezeigt werden (unterstützte Tags: "irc_join", "irc_part", "irc_quit", "irc_nick", "irc_privmsg"), "*" = alle unterstützten Tags]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"irc_privmsg"+`
@@ -2955,10 +3039,10 @@
** Standardwert: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** Beschreibung: pass:none[Datei mit SSL Zertifikat und privatem Schlüssel (zur Nutzung von Clients mit SSL)]
** Beschreibung: pass:none[Datei mit SSL-Zertifikat und privatem Schlüssel (zum Bedienen von Clients mit SSL) (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/ssl/relay.pem"+`
** Standardwert: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** Beschreibung: pass:none[Zeichenkette mit Prioritäten für gnutls (für die korrekte Syntax siehe gnutls Dokumentation unter Funktion gnutls_priority_init. Gebräuchliche Zeichenketten sind: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3261,7 +3345,7 @@
** Standardwert: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** Beschreibung: pass:none[Format in welchem die Spalten im Skript Buffer dargestellt werden sollen. Es können folgende Spaltenbezeichnungen genutzt werden: %a=Autor, %d=Beschreibung, %D=hinzugefügt, %e=Dateierweiterung, %l=Programmiersprache, %L=Lizenz, %n=Skriptname, mit Dateierweiterung, %N=Skriptname, %r=Voraussetzungen, %s=Status, %t=Schlagwörter, %u=Datum der letzten Überarbeitung, %v=Version, %V=installierte Version, %w=min_WeeChat_Version, %W=max_WeeChat_Version)]
** Beschreibung: pass:none[Format in welchem die Spalten im Skript-Buffer dargestellt werden sollen. Es können folgende Spaltenbezeichnungen genutzt werden: %a=Autor, %d=Beschreibung, %D=Skript hinzugefügt, %e=Dateierweiterung, %l=Programmiersprache, %L=Lizenz, %n=Skriptname, mit Dateierweiterung, %N=Skriptname, %r=Voraussetzungen, %s=Status, %t=Schlagwörter, %u=Datum der letzten Überarbeitung, %v=Version, %V=installierte Version, %w=min_WeeChat_Version, %W=max_WeeChat_Version)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%s %n %V %v %u | %d | %t"+`
@@ -3339,10 +3423,10 @@
** Standardwert: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** Beschreibung: pass:none[lokales Cache-Verzeichnis für die Script-Erweiterung; "%h" wird durch das WeeChat Verzeichnis ersetzt (Standardpfad: "~/.weechat") (Hinweis: Inhalt wird evaluiert, siehe /help eval)]
** Beschreibung: pass:none[lokales Cache-Verzeichnis für Skripten (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"%h/script"+`
** Standardwert: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** Beschreibung: pass:none[URL für Datei mit der Auflistung aller Skripten]
+2 -3
View File
@@ -16,9 +16,8 @@
"--daemon").
*-d*, *--dir* _<path>_::
legt den Konfigurationsordner für WeeChat fest in welchem die Erweiterungen,
Skripten, Protokolldateien etc.pp. gesichert werden (Voreinstellung: "~/.weechat").
Sollte das Verzeichnis nicht existieren wird es beim Start angelegt.
Erzwingen Sie ein einzelnes Verzeichnis für alle WeeChat-Dateien (Verzeichnis wird erstellt, wenn es nicht gefunden wird).
Es können vier Verzeichnisse angegeben werden, die durch Doppelpunkte getrennt sind (folgende Reihenfolge: Konfiguration, Daten, Cache, Laufzeit).
Wird diese Option nicht genutzt, wird die Umgebungsvariable WEECHAT_HOME genutzt
(sofern diese vorhanden ist).
+27 -27
View File
@@ -9,7 +9,7 @@ indem man eine URL verwendet:
Um dem WeeChat IRC Support-Channel, mit dem Nick "mynick", beizutreten:
irc://mynick@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#weechat
Um eine IPv6 Adresse zu nutzen, muss diese in eckige Klammern gesetzt werden:
@@ -17,79 +17,79 @@ Um eine IPv6 Adresse zu nutzen, muss diese in eckige Klammern gesetzt werden:
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
WeeChats Konfigurationsdatei
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
Konfigurationsdatei für Erweiterungen
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
Konfigurationsdatei mit schutzwürdigen Daten
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
Konfigurationsdatei für _alias_ Erweiterung
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
Konfigurationsdatei für _buflist_ Erweiterung
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
Konfigurationsdatei für _charset_ Erweiterung
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
Konfigurationsdatei für _exec_ Erweiterung
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
Konfigurationsdatei für _fifo_ Erweiterung
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
Konfigurationsdatei für _fset_ Erweiterung
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
Konfigurationsdatei für _guile_ Erweiterung
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
Konfigurationsdatei für _irc_ Erweiterung
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
Konfigurationsdatei für _javascript_ Erweiterung
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
Konfigurationsdatei für _logger_ Erweiterung
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
Konfigurationsdatei für _lua_ Erweiterung
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
Konfigurationsdatei für _perl_ Erweiterung
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
Konfigurationsdatei für _php_ Erweiterung
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
Konfigurationsdatei für _python_ Erweiterung
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
Konfigurationsdatei für _relay_ Erweiterung
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
Konfigurationsdatei für _ruby_ Erweiterung
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
Konfigurationsdatei für _script_ Erweiterung
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
Konfigurationsdatei für _spell_ Erweiterung
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
Konfigurationsdatei für _tcl_ Erweiterung
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
Konfigurationsdatei für _trigger_ Erweiterung
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
Konfigurationsdatei für _xfer_ Erweiterung
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat Protokolldatei
// end::files[]
@@ -97,7 +97,7 @@ $HOME/.weechat/weechat.log::
WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
findet man in der AUTHORS.adoc Datei).
Copyright (C) 2003-2020 {author}
Copyright (C) 2003-2021 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+61 -34
View File
@@ -249,6 +249,31 @@ Die Tasten "meta-OP" und "meta-OQ" können im Hinblick auf das jeweils genutzte
Um die korrekten Tasten zu finden, sollte man mit kbd:[Alt+k] die gewünschte Tastenkombination einfangen.
Siehe auch: link:weechat_user.de.html#key_bindings_command_line[Benutzerhandbuch / Tastenbelegung].
[[customize_buflist]]
=== Wie kann ich die Darstellung der Bufferliste anpassen, z.B. die Farbe des aktiven Buffers?
Mit folgendem Befehl können alle Optionen der Buflist angezeigt werden:
----
/fset buflist
----
Die Hintergrundfarbe des aktiven Buffers ist standardmäßig blau. Sie können diese
Farbe folgendermaßen ändern, z.B. in "red":
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
Vor dem Farbnamen "red" steht ein Komma, da die Farbe als Hintergrund und nicht als Textfarbe verwendet wird. +
Es kann auch eine beliebige numerische Farbe anstelle von "Rot" verwendet werden, z. B. "237" für Dunkelgrau.
Die Buflist-Erweiterung bietet viele Optionen, zum individualisieren. Bitte lesen Sie dazu die Hilfe von jeder Option.
Es gibt auch eine Wiki-Seite mit Beispielen, wie eine erweiterte Konfiguration aussehen kann:
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== Wie kann ich die Länge eines Nicknamens begrenzen oder die Ausrichtung des Nicks im Chatbereich entfernen?
@@ -750,7 +775,8 @@ anstelle der kbd:[Shift]-Taste gedrückt werden).
Falls macOS genutzt wird,
muss mittels Homebrew `openssl` installiert werden.
Eine CA-Datei wird mittels Zertifikaten vom Systemschlüssel geladen.
Der Pfad zu den Zertifikaten kann in WeeChat eingestellt werden:
Ab WeeChat ≤ 3.1 können Sie den Pfad zu Systemzertifikaten festlegen:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -792,10 +818,11 @@ Im folgenden Beispiel muss "xxx" durch den betroffenen Servernamen ersetzt werde
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== Wie kann ich eine SSL gesicherte Verbindung zum freenode Server herstellen?
[[irc_ssl_libera]]
=== Wie kann ich eine SSL gesicherte Verbindung zum libera Server herstellen?
Die Option _weechat.network.gnutls_ca_file_ sollte auf die Zertifikationsdatei zeigen:
Ab WeeChat ≤ 3.1 kann mit der Option _weechat.network.gnutls_ca_file_ eine Datei mit
Zertifikaten ausgewählt werden:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -815,9 +842,9 @@ dass die Zertifikate in einer anderen Datei bereitgestellt werden:
Konfiguration des Servers, Port angeben, SSL aktivieren und Verbindung herstellen:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -844,8 +871,8 @@ ist es ratsam auf diese Funktion zurückzugreifen
und sich nicht mittels "nickserv" zu authentifizieren:
----
/set irc.server.freenode.sasl_username "meinNick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "meinNick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Unterstützt der Server keine SASL Authentifizierung,
@@ -853,7 +880,7 @@ kann eine Verzögerung aktiviert werden,
um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
@@ -861,10 +888,10 @@ um sich vor dem Betreten von Channels bei "nickserv" zu identifizieren:
Um die Liste der autojoin Channels zu editieren,
kann der Befehl `/set` genutzt werden.
In folgendem Beispiel wird der "freenode"-Server angepasst:
In folgendem Beispiel wird der "libera"-Server angepasst:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1064,16 +1091,16 @@ das Skript _buffer_autoset.py_ nutzen:
----
Um zum Beispiel Highlights (Hervorhebungen) von Nick "mike" im Channel
#weechat auf dem IRC Server freenode zu deaktivieren:
#weechat auf dem IRC Server libera zu deaktivieren:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
Um dies auf den kompletten freenode Server anzuwenden:
Um dies auf den kompletten libera Server anzuwenden:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
Für weitere Beispiele, siehe `+/help buffer_autoset+`.
@@ -1111,16 +1138,18 @@ Die Skripten für WeeChat sind mit anderen IRC-Clients nicht kompatibel und vice
[[scripts_update]]
=== Der Befehl "/script update" liest die Skriptliste nicht ein, wie kann ich das beheben?
Als erstes sollte das Kapitel über SSL Verbindungen in dieser FAQ gelesen werden
(besonders über die Option _weechat.network.gnutls_ca_file_).
Als erstes sollte das Kapitel über SSL Verbindungen in dieser FAQ gelesen werden.
Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
folgenden Befehl in der Shell ausführen:
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
Ab WeeChat ≤ 3.1, sollte der Pfad: _~/.weechat/script/plugins.xml.gz_ lauten.
Danach sollte man noch einmal versuchen die Datei herunter zu laden:
----
@@ -1140,7 +1169,7 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
* und in der Shell, mit installiertem curl:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1192,9 +1221,8 @@ Damit WeeChat weniger Speicher benötigt, solltest Du folgende Tipps umsetzen:
Fifo, Logger, Perl, Python, Ruby, Lua, Tcl, Guile, JavaScript, PHP, Spell, Xfer
(wird für DCC benötigst), siehe `/help weechat.plugin.autoload`.
* installiere ausschließlich Skripten die Du auch nutzt
* falls man SSL *NICHT* nutzt, sollte kein Zertifikat geladen werden. In diesem
Fall, einfach den Eintrag in folgender Option leer lassen:
_weechat.network.gnutls_ca_file_
* Laden Sie keine Systemzertifikate, wenn SSL *NICHT* verwendet wird: Deaktivieren Sie diese Option:
_weechat.network.gnutls_ca_system_.
* der Wert der Option _weechat.history.max_buffer_lines_number_ sollte möglichst
niedrig eingestellt werden oder die Option _weechat.history.max_buffer_lines_minutes_
verwendet werden.
@@ -1253,22 +1281,20 @@ Beispiel:
----
/secure passphrase xxxxxxxxxx
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
[[sharing_config_files]]
=== Ich möchte meine WeeChat Konfiguration teilen. Welche Dateien kann ich weitergeben und welche sollte ich behalten?
Es können alle _~/.weechat/*.conf_ Dateien geteilt werden.
Hiervon ausgenommen ist die Datei _sec.conf_,
die durch eine Passphrase verschlüsselte sensible Daten enthalten kann.
Sie können Ihre _*.conf_ Konfigurationsdateien teilen, mit Ausnahme der Datei _sec.conf_, die Ihre mit
Ihrer Passphrase verschlüsselten Kennwörter enthält.
In einigen Dateien wie _irc.conf_ können sensible Daten,
z.B. Passwörter für Server oder Channels im Klartext hinterlegt sein.
(Das heißt, insofern diese nicht mit Hilfe des Befehls `/secure` verschlüsselt in der Datei _sec.conf_ gesichert wurden).
Einige andere Dateien enthalten möglicherweise vertrauliche Informationen wie
Kennwörter (sofern sie nicht mit dem Befehl `/secure` in _sec.conf_ gesichert werden).
Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse]
für weitere Informationen über Konfigurationsdateien.
@@ -1304,7 +1330,8 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
[[supported_os]]
=== Auf welchen Plattformen läuft WeeChat und wird es noch auf andere Betriebssysteme portiert?
Eine vollständige Liste der Portierungen findest Du unter: https://weechat.org/download.
WeeChat läuft auf den meisten Linux/BSD-Distributionen, GNU/Hurd, Mac OS und
Windows (Cygwin und Windows Subsystem für Linux) einwandfrei.
Wir geben unser Bestes, WeeChat auf möglichst viele Plattformen zu portieren.
Deshalb ist jede Hilfe gerne gesehen, die es uns ermöglicht,
+25 -32
View File
@@ -123,13 +123,13 @@ Um eine Verbindung zu einem IRC Server herzustellen, wird der
`/server` Befehl verwendet. Beispiel:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
In diesem Beispiel ist `freenode` der interne, von Weechat genutzte Servername.
Mit dem Befehl `/connect freenode` kann jetzt die Verbindung
zu diesem Freenode-IRC-Server aufgebaut werden.
Alle für den Server relevanten Optionen sind unter _irc.server.freenode.xxx_ zu finden.
In diesem Beispiel ist `libera` der interne, von Weechat genutzte Servername.
Mit dem Befehl `/connect libera` kann jetzt die Verbindung
zu diesem Libera-IRC-Server aufgebaut werden.
Alle für den Server relevanten Optionen sind unter _irc.server.libera.xxx_ zu finden.
Verwende die Hilfe, falls noch Fragen offen sind:
@@ -149,31 +149,24 @@ definiert ist (nicht "null"). Andernfalls verwendet WeeChat die Vorgabewerte
(_irc.server_default.xxx_).
Beispielsweise werden Standard Nicks verwendet (basierend auf dem Un*x Login).
Sollen speziell für den freenode-Server andere Nicks genutzt werden,
Sollen speziell für den libera-Server andere Nicks genutzt werden,
können diese mit folgendem Befehl angepasst werden:
----
/set irc.server.freenode.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
/set irc.server.libera.nicks "meinNick,meinNick2,meinNick3,meinNick4,meinNick5"
----
Benutzernamen und wirklichen Namen (realname) anpassen:
----
/set irc.server.freenode.username "Mein Benutzername"
/set irc.server.freenode.realname "Mein wirklicher Name"
/set irc.server.libera.username "Mein Benutzername"
/set irc.server.libera.realname "Mein wirklicher Name"
----
Beim Start von WeeChat automatisch die Verbindung zu einem Server herstellen:
----
/set irc.server.freenode.autoconnect on
----
Beim Verbindungsaufbau SSL (sichere Verbindung) nutzen:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
Wenn der Server SASL unterstützt,
@@ -182,8 +175,8 @@ Der Benutzer wird auf diese Weise gegenüber dem IRC-Server identifiziert,
noch bevor Server-Befehle übermittelt oder Cannels (Chaträume) betreten werden können.
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Wenn der Server keine SASL-Authentifizierung unterstützt,
@@ -191,7 +184,7 @@ muss der Benutzer sich nach dem Verbindungsaufbau bei "nickserv" identifizieren.
Der dafür notwendige IRC-Server-Befehl kann auch automatisch übermittelt werden:
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -207,19 +200,19 @@ Zuerst sollte die Passphrase gesetzt werden:
----
Jetzt wird das Passwort (`xxxxxx`)
für den Zugang zum Freenode-Server verschlüsselt
und mit dem Bezeichner `freenode_password` verknüpft:
für den Zugang zum Libera-Server verschlüsselt
und mit dem Bezeichner `libera_password` verknüpft:
----
/secure set freenode_password xxxxxx
/secure set libera_password xxxxxx
----
Das geschützte Freenode-Passwort kann nun in anderen Optionen genutzt werden.
Das geschützte Libera-Passwort kann nun in anderen Optionen genutzt werden.
Dazu wird anstelle des Klartext-Passwortes die Variable
`+${sec.data.freenode_password}+` eingesetzt:
`+${sec.data.libera_password}+` eingesetzt:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Das automatische Betreten (auto-join) von Channels (Chaträume) direkt nach dem
@@ -227,7 +220,7 @@ Verbindungsaufbau zum IRC-Server kann durch den Eintrag der gewünschten Channel
in folgender Option erreicht werden:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
[TIP]
@@ -239,28 +232,28 @@ sein kann).
Mit dem Befehl `/unset` können Server-Optionen zurückgesetzt werden.
Ist eine Server-Option zurückgesetzt, _wirkt_ der entsprechende Vorgabewert
aus dem fall-back-Bereich `irc.server_default.xxx`. So nimmt, beispielsweise
nach dem Rücksetzen der Freenode-Nicks, diese Server-Option _automatisch_ den Wert
nach dem Rücksetzen der Libera-Nicks, diese Server-Option _automatisch_ den Wert
der entsprechenden fall-back-Option `irc.server_default.nicks` an:
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
*Andere Optionen:*
Werte anderer Server-Optionen (`xxx`) können festgelegt werden mit:
----
/set irc.server.freenode.xxx Wert
/set irc.server.libera.xxx Wert
----
[[connect_to_irc_server]]
== Verbinden mit dem IRC-Server
----
/connect freenode
/connect libera
----
Mittels obigem Befehl stellt WeeChat eine Verbindung zum freenode Server
Mittels obigem Befehl stellt WeeChat eine Verbindung zum libera Server
her und betritt automatisch die Kanäle die in der "autojoin" Server-Option
aufgeführt sind.
+91 -67
View File
@@ -72,13 +72,18 @@ und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_
[[languages_specificities]]
=== Besonderheiten der einzelnen Skriptsprachen
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat definiert ein `weechat` Module welches mittels `import weechat`
importiert werden muss.
importiert werden muss. +
Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
[[python_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
@@ -86,6 +91,7 @@ Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
Die Funktionen `+print*+` werden bei python durch `+prnt*+` ersetzt
(`print` war ein reserviertes Schlüsselwort unter Python 2).
[[python_strings]]
===== In Callbacks empfangene Zeichen
Mit Python 3 und WeeChat ≥ 2.7 sind die Zeichenketten in Callbacks
@@ -142,18 +148,23 @@ Mit Python 2, das mittlerweile veraltet ist und nicht mehr verwendet werden soll
Zeichenkette die an die Callbacks gesendet wird immer vom Typ `str` und kann deshalb bei den
oben genannten Fällen, ungültige UTF-8 Daten enthalten.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialization
Es muss _weechat_init_ definiert werden und darin dann _register_ ausgeführt werden.
[[ruby_functions]]
===== Functions
Funktionen werden aufgerufen mittels `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -178,20 +189,26 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+(weechat:xxx arg1 arg2 ...)+`.
@@ -204,14 +221,18 @@ für andere Funktionen), da die Anzahl der Argumente die zulässige Anzahl in Gu
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Funktionen
Funktionen werden aufgerufen mittels `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Functions
Funktionen werden aufgerufen mittels `+weechat_xxx(arg1, arg2, ...);+`.
@@ -222,11 +243,11 @@ Funktionen werden aufgerufen mittels `+weechat_xxx(arg1, arg2, ...);+`.
Ein WeeChat-Skript muss sich bei WeeChat "registrieren". Dazu muss das Skript
zuerst die "register" Funktion ausführen.
Prototyp:
Prototyp (Python):
[source,python]
----
weechat.register(Name, Author, Version, Lizenz, Beschreibung, Shutdown_Funktion, Zeichensatz)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Argumente:
@@ -349,7 +370,7 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
Ein Beispiel für ein Python-Skript:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -792,58 +813,58 @@ Liste der Konstanten in Skript API:
| Kategorie | Konstanten
| return codes |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| Konfigurationsdatei |
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
`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 +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| Hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook Prozesse |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook Connect |
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
`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 +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -886,13 +907,13 @@ weechat.prnt("", "%sfalsche Anzahl an Argumenten" % weechat.prefix("error"))
weechat.prnt("", "Text %sGeld auf Blau" % weechat.color("yellow,blue"))
# sucht einen bestimmten Buffer und gibt dort einen Text aus
# (der Name des Buffers muss folgendes Format besitzen Erweiterung.Name, Beispiel: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (der Name des Buffers muss folgendes Format besitzen Erweiterung.Name, Beispiel: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "Nachricht im #weechat Channel")
# die zweite Möglichkeit einen Buffer zu suchen (empfohlen!)
# (bitte beachten Sie dass der Server- und Channelname durch ein Komma zu trennen sind)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "Nachricht im #weechat Channel")
----
@@ -914,7 +935,7 @@ Beispiele:
weechat.command("", "/help")
# sendet den Text "Hallo" in den IRC Channel #weechat (die Teilnehmer des Channels sehen diese Nachricht)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "Hallo")
----
@@ -988,7 +1009,7 @@ Um zu sehen welche lokalen Variablen für einen Buffer gesetzt sind führen Sie
bitte in WeeChat folgenden Befehl aus:
----
/buffer localvar
/buffer listvar
----
[[hooks]]
@@ -1221,7 +1242,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# Das Signal lautet: "freenode,irc_in2_join"
# Das Signal lautet: "libera,irc_in2_join"
# signal_data enthält die IRC Nachricht, zum Beispiel: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1275,63 +1296,66 @@ Das Ergebnis ist eine Hashtabelle mit folgenden Schlüsseln
(das Beispiel bezieht sich auf folgende IRC Nachricht:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Schlüssel | WeeChat version | Beschreibung | Beispiel
| Schlüssel | Seit WeeChat ^(1)^ | Beschreibung | Beispiel
| Tags | 0.4.0 |
| Tags | 0.4.0 |
Tags in der Nachricht (kann leer sein). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
Die IRC Nachricht ohne Tags (wie eine Nachricht ohne Tags). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
der ursprüngliche Nick. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
der ursprüngliche Benutzer. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
der ursprüngliche Host (beinhaltet den Nick). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
der Befehl (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
der Zielchanne.l|
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
das Argument des Befehls (beinhaltet den Channel). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
der Text (zum Beispiel eine Nachricht eines Users). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
Index von _command_ innerhalb einer Nachricht ("-1" falls _command_ nicht gefunden wird). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
Index von_arguments_ innerhalb einer Nachricht ("-1" falls _arguments_ nicht gefunden wird). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
Index von _channel_ innerhalb einer Nachricht ("-1" falls _channel_ nicht gefunden wird). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
Index von _text_ innerhalb einer Nachricht ("-1" falls _text_ nicht gefunden wird). |
`+65+`
|===
[NOTE]
^(1)^ Der Schlüssel wurde mit dieser WeeChat Version eingeführt.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1393,8 +1417,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# WeeChat Hauptverzeichnis, zum Beispiel: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat Hauptverzeichnis: %s" % weechat.info_get("weechat_dir", ""))
# Zum Beispiel, das WeeChat-Konfigurationsverzeichnis: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# Inaktivität der Tastatur
weechat.prnt("", "Tastatur ist seit %s Sekunden nicht mehr betätigt worden" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -141,7 +141,7 @@ prahle vor Anderen, dass Du die neueste WeeChat-Version verwendest :)
Solltest Du nun ein merkwürdiges Verhalten bemerken (es können diverse Probleme
oder Abstürze auftreten oder einfach Dein Bier überkochen) zögere nicht, komme
in den Channel _#weechat_ auf _chat.freenode.net_ (A.d.Ü.: englischsprachig) und
in den Channel _#weechat_ auf _irc.libera.chat_ (A.d.Ü.: englischsprachig) und
berichte uns darüber.
Auch falls alles korrekt funktionieren sollte gib uns trotzdem Bescheid, wir
File diff suppressed because it is too large Load Diff
+3 -3
View File
@@ -1,6 +1,6 @@
#!/usr/bin/env python3
#
# Copyright (C) 2008-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2008-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
@@ -674,7 +674,7 @@ class AutogenDoc():
for info in sorted(infos[plugin]):
_inf = infos[plugin][info]
desc = translate(_inf['description'])
args_desc = translate(_inf['args_description'] or '-')
args_desc = translate(_inf['args_description']) or '-'
self.write('| %s | %s | %s | %s\n',
escape(plugin), escape(info), escape(desc),
escape(args_desc))
@@ -694,7 +694,7 @@ class AutogenDoc():
for info in sorted(infos_hashtable[plugin]):
_inh = infos_hashtable[plugin][info]
desc = translate(_inh['description'])
args_desc = translate(_inh['args_description'])
args_desc = translate(_inh['args_description']) or '-'
output_desc = translate(_inh['output_description']) or '-'
self.write('| %s | %s | %s | %s | %s\n',
escape(plugin), escape(info), escape(desc),
+1 -1
View File
@@ -1,6 +1,6 @@
<!--
Custom styles for Asciidoctor
Copyright (C) 2016-2020 Sébastien Helleu <flashcode@flashtux.org>
Copyright (C) 2016-2021 Sébastien Helleu <flashcode@flashtux.org>
-->
<style>
#header,#content,#footnotes,#footer {
+16 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,19 +32,21 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/man1)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.en.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (en)"
)
add_custom_target(doc-man-weechat-headless-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.en.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.en.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (en)"
)
add_custom_target(doc-man-weechat-headless-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/man1)
endif()
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
@@ -120,6 +120,10 @@
| weechat | bars_options | options for bars
| weechat | buffer_local_variable_value | value of a buffer local variable
| weechat | buffer_local_variables | buffer local variables
| weechat | buffer_properties_get | properties that can be read on a buffer
| weechat | buffer_properties_set | properties that can be set on a buffer
@@ -233,6 +233,10 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
+15 -3
View File
@@ -20,6 +20,8 @@
| irc | irc_is_channel | 1 if string is a valid IRC channel name for server | server,channel (server is optional)
| irc | irc_is_message_ignored | 1 if the nick is ignored (message is not displayed) | server,message (message is the raw IRC message)
| irc | irc_is_nick | 1 if string is a valid IRC nick name | server,nickname (server is optional)
| irc | irc_nick | get current nick on a server | server name
@@ -58,7 +60,7 @@
| php | php_version | version of the interpreter used | -
| python | python2_bin | path to python 2.x interpreter | -
| python | python2_bin | path to Python 2.x interpreter (*deprecated* since version 2.6, scripts must use Python 3 only) | -
| python | python_eval | evaluation of source code | source code to execute
@@ -74,7 +76,7 @@
| ruby | ruby_version | version of the interpreter used | -
| spell | spell_dict | comma-separated list of dictionaries used in buffer | buffer pointer ("0x12345678") or buffer full name ("irc.freenode.#weechat")
| spell | spell_dict | comma-separated list of dictionaries used in buffer | buffer pointer ("0x12345678") or buffer full name ("irc.libera.#weechat")
| tcl | tcl_eval | evaluation of source code | source code to execute
@@ -132,7 +134,15 @@
| weechat | version_number | WeeChat version (as number) | -
| weechat | weechat_dir | WeeChat directory | -
| weechat | weechat_cache_dir | WeeChat cache directory | -
| weechat | weechat_config_dir | WeeChat config directory | -
| weechat | weechat_daemon | 1 if WeeChat is running in daemon mode (headless, in background) | -
| weechat | weechat_data_dir | WeeChat data directory | -
| weechat | weechat_dir | WeeChat directory (*deprecated* since version 3.2, replaced by "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" and "weechat_runtime_dir") | -
| weechat | weechat_headless | 1 if WeeChat is running headless | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | WeeChat "locale" directory | -
| weechat | weechat_runtime_dir | WeeChat runtime directory | -
| weechat | weechat_sharedir | WeeChat "share" directory | -
| weechat | weechat_site | WeeChat site | -
@@ -14,5 +14,7 @@
| weechat | focus_info | get focus info | "x": x coordinate (string with integer >= 0), "y": y coordinate (string with integer >= 0) | see function "hook_focus" in Plugin API reference
| weechat | secured_data | secured data | - | secured data: names and values (be careful: the values are sensitive data: do NOT print/log them anywhere)
|===
// end::infos_hashtable[]
+97 -69
View File
@@ -161,7 +161,7 @@ Examples:
To disconnect from a server or stop any connection attempt, use command /disconnect.
Examples:
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -219,6 +219,7 @@ Examples:
----
/dehalfop <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: remove channel half-operator status from everybody on channel except yourself
@@ -300,10 +301,10 @@ Note: the regular expression can start with "(?-i)" to become case sensitive.
Examples:
ignore nick "toto" everywhere:
/ignore add toto
ignore host "toto@domain.com" on freenode server:
/ignore add toto@domain.com freenode
ignore host "toto*@*.domain.com" on freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
ignore host "toto@domain.com" on libera server:
/ignore add toto@domain.com libera
ignore host "toto*@*.domain.com" on libera/#weechat:
/ignore add toto*@*.domain.com libera #weechat
----
[[command_irc_info]]
@@ -348,7 +349,7 @@ nick: nick
Examples:
/join #weechat
/join #protectedchan,#weechat key
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -360,7 +361,7 @@ Examples:
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
----
[[command_irc_kickban]]
@@ -371,7 +372,7 @@ channel: channel name
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)
It is possible to kick/ban with a mask, nick will be extracted from mask and replaced by "*".
@@ -401,7 +402,7 @@ server_mask: list of servers must match this mask
----
[[command_irc_list]]
* `+list+`: list channels and their topic
* `+list+`: list channels and their topics
----
/list [-server <server>] [-re <regex>] [<channel>[,<channel>...]] [<target>]
@@ -551,10 +552,10 @@ Without argument, this command displays notifications for current server (or all
Examples:
notify when "toto" joins/quits current server:
/notify add toto
notify when "toto" joins/quits freenode server:
/notify add toto freenode
notify when "toto" is away or back on freenode server:
/notify add toto freenode -away
notify when "toto" joins/quits libera server:
/notify add toto libera
notify when "toto" is away or back on libera server:
/notify add toto libera -away
----
[[command_irc_op]]
@@ -672,7 +673,7 @@ option: extra option, for some servers
channel: channel name
nick: nick
reason: reason (special variables $nick, $channel and $server are replaced by their value)
reason: reason (special variables $nick, $channel and $server are replaced by their values)
----
[[command_irc_restart]]
@@ -774,16 +775,16 @@ nooption: set boolean option to 'off' (for example: -nossl)
Examples:
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -932,6 +933,7 @@ target: server name
----
/voice <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: give voice to everybody on channel
@@ -1020,7 +1022,7 @@ Note: in command, special variables are replaced:
$n-m: arguments from 'n' to 'm'
$*: all arguments
$~: last argument
$var: where "var" is a local variable of buffer (see /buffer localvar)
$var: where "var" is a local variable of buffer (see /buffer listvar)
examples: $nick, $channel, $server, $plugin, $name
Examples:
@@ -1113,7 +1115,9 @@ Examples:
renumber [<number1> [<number2> [<start>]]]
close [<n1>[-<n2>]|<name>...]
notify [<level>]
localvar [<number>|<name>]
listvar [<number>|<name>]
setvar <name> [<value>]
delvar <name>
set <property> [<value>]
get <property>
<number>|-|+|<name>
@@ -1137,8 +1141,10 @@ renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumb
message: for messages from users + highlights
all: all messages
reset: reset to default value (all)
localvar: display local variables for the buffer
set: set a property for current buffer
listvar: display local variables in a buffer
setvar: set a local variable in the current buffer
delvar: delete a local variable from the current buffer
set: set a property in the current buffer
get: display a property of current buffer
number: jump to buffer by number, possible prefix:
'+': relative jump, add number to current
@@ -1296,11 +1302,11 @@ infolists: display infos about infolists
----
/eval [-n|-s] [-d] <expression>
[-n] [-d] -c <expression1> <operator> <expression2>
[-n] [-d [-d]] -c <expression1> <operator> <expression2>
-n: display result without sending it to buffer (debug mode)
-s: split expression before evaluating it (many commands can be separated by semicolons)
-d: display debug output after evaluation
-d: display debug output after evaluation (with two -d: more verbose debug)
-c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
expression: expression to evaluate, variables with format ${variable} are replaced (see below); many commands can be separated by semicolons
operator: a logical or comparison operator:
@@ -1335,39 +1341,45 @@ To force a string comparison, you can add double quotes around each expression,
"50" > "100" ==> 1
Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
1. an evaluated sub-string (format: "eval:xxx")
2. a string with escaped chars (format: "esc:xxx" or "\xxx")
3. a string with chars to hide (format: "hide:char,string")
4. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
1. the string itself without evaluation (format: "raw:xxx")
2. an evaluated sub-string (format: "eval:xxx")
3. an evaluated condition (format: "eval_cond:xxx")
4. a string with escaped chars (format: "esc:xxx" or "\xxx")
5. a string with chars to hide (format: "hide:char,string")
6. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
5. a reversed string (format: "rev:xxx" or "revscr:xxx")
6. a repeated string (format: "repeat:count,string")
7. length of a string (format: "length:xxx" or "lengthscr:xxx")
8. a color (format: "color:xxx", see "Plugin API reference", function "color")
9. a modifier (format: "modifier:name,data,string")
10. an info (format: "info:name,arguments", arguments are optional)
11. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
12. current date/time (format: "date" or "date:format")
13. an environment variable (format: "env:XXX")
14. a ternary operator (format: "if:condition?value_if_true:value_if_false")
15. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
16. an option (format: "file.section.option")
17. a local variable in buffer
18. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
7. a reversed string (format: "rev:xxx" or "revscr:xxx")
8. a repeated string (format: "repeat:count,string")
9. length of a string (format: "length:xxx" or "lengthscr:xxx")
10. a color (format: "color:xxx", see "Plugin API reference", function "color")
11. a modifier (format: "modifier:name,data,string")
12. an info (format: "info:name,arguments", arguments are optional)
13. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
14. current date/time (format: "date" or "date:format")
15. an environment variable (format: "env:XXX")
16. a ternary operator (format: "if:condition?value_if_true:value_if_false")
17. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
18. a translated string (format: "translate:xxx")
19. an option (format: "file.section.option")
20. a local variable in buffer
21. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
Format for hdata can be one of following:
hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
hdata[list].var1.var2...: start with a hdata using a list, for example:
hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, for example:
${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
hdata[pointer].var1.var2...: start with a hdata using a pointer, for example:
${buffer[0x1234abcd].full_name}: full name of the buffer with this pointer (can be used in triggers)
${buffer[my_pointer].full_name}: full name of the buffer with this pointer name (can be used in triggers)
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1384,6 +1396,7 @@ Examples (simple strings):
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Extension
Examples (conditions):
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1406,6 +1419,7 @@ Examples (conditions):
enable|disable|toggle [<name>|@]
add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
rename <name> <new_name>
recreate <name>
del <name>|-all
list: list all filters
@@ -1416,10 +1430,11 @@ Examples (conditions):
add: add a filter
addreplace: add or replace an existing filter
rename: rename a filter
recreate: set input with the command used to edit the filter
del: delete a filter
-all: delete all filters
buffer: comma separated list of buffers where filter is active:
- this is full name including plugin (example: "irc.freenode.#weechat" or "irc.server.freenode")
- this is full name including plugin (example: "irc.libera.#weechat" or "irc.server.libera")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
@@ -1454,11 +1469,11 @@ Examples:
filter nicks displayed when joining channels or with /names:
/filter add nicks * irc_366 *
filter nick "toto" on IRC channel #weechat:
/filter add toto irc.freenode.#weechat nick_toto *
/filter add toto irc.libera.#weechat nick_toto *
filter IRC join/action messages from nick "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filter lines containing "weechat sucks" on IRC channel #weechat:
/filter add sucks irc.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1660,7 +1675,7 @@ Examples:
-core: no output on WeeChat core buffer
-current: no output on current buffer
-buffer: no output on specified buffer
name: full buffer name (examples: "irc.server.freenode", "irc.freenode.#weechat")
name: full buffer name (examples: "irc.server.libera", "irc.libera.#weechat")
command: command to execute silently (a '/' is automatically added if not found at beginning of command)
If no target is specified (-core, -current or -buffer), then default is to mute all buffers.
@@ -1671,7 +1686,7 @@ Examples:
message to current IRC channel:
/mute -current msg * hi!
message to #weechat channel:
/mute -buffer irc.freenode.#weechat msg #weechat hi!
/mute -buffer irc.libera.#weechat msg #weechat hi!
----
[[command_weechat_plugin]]
@@ -1739,7 +1754,7 @@ Examples:
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
/print -buffer irc.libera.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
@@ -1861,7 +1876,7 @@ Keys on secure buffer:
alt+v toggle values
When a passphrase is used (data encrypted), it is asked by WeeChat on startup.
It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_file to read the passphrase from a file (see /help sec.crypt.passphrase_file).
It is possible to set environment variable "WEECHAT_PASSPHRASE" to prevent the prompt (this same variable is used by WeeChat on /upgrade), or to set option sec.crypt.passphrase_command to read the passphrase from the output of an external command like a password manager (see /help sec.crypt.passphrase_command).
Secured data with format ${sec.data.xxx} can be used in:
- command /eval
@@ -1872,14 +1887,16 @@ Secured data with format ${sec.data.xxx} can be used in:
Examples:
set a passphrase:
/secure passphrase this is my passphrase
encrypt freenode SASL password:
/secure set freenode mypassword
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
use program "pass" to read the passphrase on startup:
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
encrypt libera SASL password:
/secure set libera mypassword
/set irc.server.libera.sasl_password "${sec.data.libera}"
encrypt oftc password for nickserv:
/secure set oftc mypassword
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias to ghost the nick "mynick":
/alias add ghost /eval /msg -server freenode nickserv ghost mynick ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost mynick ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1966,7 +1983,7 @@ With option "-quit", the process is slightly different:
5. quit WeeChat
Then later you can restore session with command: weechat --upgrade
IMPORTANT: you must restore the session with exactly same configuration (files *.conf).
It is possible to restore WeeChat session on another machine if you copy the content of directory "~/.weechat".
It is possible to restore WeeChat session on another machine if you copy the content of WeeChat home directories (see /debug dirs).
----
[[command_weechat_uptime]]
@@ -2151,6 +2168,7 @@ The following variables can be used in these options:
- ${hotlist}: the raw hotlist
- ${hotlist_priority}: "none", "low", "message", "private" or "highlight"
- ${format_lag}: the lag for an IRC server buffer, empty if there's no lag (evaluation of option buflist.format.lag)
- ${format_tls_version}: indicator of TLS version for a server buffer, empty for channels (evaluation of option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2257,14 +2275,14 @@ disable: disable FIFO pipe
toggle: toggle FIFO pipe
FIFO pipe is used as remote control of WeeChat: you can send commands or text to the FIFO pipe from your shell.
By default the FIFO pipe is in ~/.weechat/weechat_fifo
By default the FIFO pipe is called weechat_fifo_xxx (where xxx is the WeeChat process id) and located in the WeeChat runtime directory (see /debug dirs).
The expected format is one of:
plugin.buffer *text or command here
*text or command here
For example to change your freenode nick:
echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo
For example to change your libera nick:
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
Please read the user's guide for more info and examples.
@@ -2701,7 +2719,7 @@ Without argument, this command lists all loaded scripts.
stop: close the server socket (clients remain connected)
name: relay name (see format below)
port: port used for relay
path: path used for relay (for UNIX domain socket only); "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default), content is evaluated (see /help eval)
path: path used for relay (for UNIX domain socket only); path is evaluated (see function string_eval_path_home in plugin API reference)
raw: open buffer with raw Relay data
sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
@@ -2720,10 +2738,10 @@ The "weechat" protocol allows a remote interface to connect on the port, see the
Without argument, this command opens buffer with list of relay clients.
Examples:
irc proxy, for server "freenode":
/relay add irc.freenode 8000
irc proxy, for server "freenode", with SSL:
/relay add ssl.irc.freenode 8001
irc proxy, for server "libera":
/relay add irc.libera 8000
irc proxy, for server "libera", with SSL:
/relay add ssl.irc.libera 8001
irc proxy, for all servers (client will choose), with SSL:
/relay add ssl.irc 8002
weechat protocol:
@@ -2737,7 +2755,7 @@ Examples:
weechat protocol with SSL, using IPv4 + IPv6:
/relay add ipv4.ipv6.ssl.weechat 9001
weechat protocol over UNIX domain socket:
/relay add unix.weechat %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
@@ -2819,6 +2837,16 @@ On script buffer, the possible status for each script are:
| installed
popular script
In output of /script list, the possible status for each script are:
* ? i a H N
| | | | | |
| | | | | obsolete (new version available)
| | | | held
| | | autoloaded
| | installed
| unknown script (can not be downloaded/updated)
popular script
Keys on script buffer:
alt+i install script
alt+r remove script
@@ -2948,7 +2976,7 @@ listdefault: list default triggers
modifier: name(s) of modifier (required)
line: buffer type ("formatted", "free" or "*"), list of buffer masks, tags
print: buffer, tags, message, strip colors
command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, see /help eval)
command: command (required), description, arguments, description of arguments, completion (all arguments except command are evaluated, "${tg_trigger_name}" is replaced by the trigger name, see /help eval)
command_run: command(s) (required)
timer: interval (required), align on second, max calls
config: name(s) of option (required)
+118 -34
View File
@@ -16,8 +16,8 @@
** values: sha224, sha256, sha384, sha512
** default value: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** description: pass:none[path to a file containing the passphrase to encrypt/decrypt secured data; this option is used only when reading file sec.conf; only first line of file is used; this file is used only if the environment variable "WEECHAT_PASSPHRASE" is not set (the environment variable has higher priority); security note: it is recommended to keep this file readable only by you and store it outside WeeChat home (for example in your home); example: "~/.weechat-passphrase"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** description: pass:none[read the passphrase from the output of this system command (only the first line is used and it must not contain any extra character); this option is used only when reading file sec.conf and if the environment variable "WEECHAT_PASSPHRASE" is not set (the environment variable has higher priority); example with password-store: "/usr/bin/pass show weechat/passphrase"]
** type: string
** values: any string
** default value: `+""+`
@@ -846,6 +846,12 @@
** values: on, off
** default value: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** description: pass:none[update the hotlist when switching buffers]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** description: pass:none[number of chars displayed after end of input line when scrolling to display end of line]
** type: integer
@@ -1140,6 +1146,12 @@
** values: any string
** default value: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** description: pass:none[update the read marker when switching buffers]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** description: pass:none[save configuration file on exit]
** type: boolean
@@ -1248,11 +1260,17 @@
** values: 1 .. 2147483647
** default value: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** description: pass:none[file containing the certificate authorities ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** description: pass:none[load system's default trusted certificate authorities on startup; this can be turned off to save some memory only if you are not using SSL connections at all]
** type: boolean
** values: on, off
** default value: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** description: pass:none[extra file(s) with certificate authorities; multiple files must be separated by colons (each path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"/etc/ssl/certs/ca-certificates.crt"+`
** default value: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** description: pass:none[timeout (in seconds) for gnutls handshake]
@@ -1285,10 +1303,10 @@
** default value: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[path for searching plugins ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** description: pass:none[path for searching plugins (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/plugins"+`
** default value: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** description: pass:none[save configuration files when unloading plugins]
@@ -1296,14 +1314,44 @@
** values: on, off
** default value: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** description: pass:none[command to execute when the signal is received, multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** description: pass:none[command executed when WeeChat starts, after loading plugins (note: content is evaluated, see /help eval)]
** description: pass:none[command executed when WeeChat starts, after loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** description: pass:none[command executed when WeeChat starts, before loading plugins (note: content is evaluated, see /help eval)]
** description: pass:none[command executed when WeeChat starts, before loading plugins; multiple commands can be separated by semicolons (note: commands are evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+""+`
@@ -1409,10 +1457,10 @@
** default value: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** description: pass:none[path for WeeChat log files; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default); date specifiers are permitted (see man strftime) (note: content is evaluated, see /help eval)]
** description: pass:none[path for WeeChat log files; date specifiers are permitted (see man strftime) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/logs/"+`
** default value: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** description: pass:none[replacement char for special chars in filename built with mask (like directory delimiter)]
@@ -1704,6 +1752,12 @@
** values: any string
** default value: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** description: pass:none[format for TLS version on an IRC server buffer (note: content is evaluated, see /help buflist)]
** type: string
** values: any string
** default value: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** description: pass:none[add newline between the buffers displayed, so each buffer is displayed on a separate line (recommended); if disabled, newlines must be manually added in the formats with "${\n}", and the mouse actions are not possible any more]
** type: boolean
@@ -1765,10 +1819,16 @@
** default value: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: content is evaluated, only the pointer to bar_item can be used, for example "bar_item.name")]
** description: pass:none[comma-separated list of fields to sort buffers; each field is a hdata variable of buffer ("var"), a hdata variable of IRC server ("irc_server.var") or a hdata variable of IRC channel ("irc_channel.var"); char "-" can be used before field to reverse order, char "~" can be used to do a case insensitive comparison; example: "-~short_name" for case insensitive and reverse sort on buffer short name (note: the content is evaluated, before being split into fields, but at that time "bar_item" is the only variable that can be used, to distinguish between different buflist items, for example "${bar_item.name}")]
** type: string
** values: any string
** default value: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** description: pass:none[number of buflist bar items that can be used; the item names are: "buflist", "buflist2", "buflist3"; be careful, using more than one bar item slows down the display of buffers list]
** type: integer
** values: 1 .. 3
** default value: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** default value: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** description: pass:none[path for FIFO file; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default); WeeChat PID can be used in path with ${info:pid} (note: content is evaluated, see /help eval)]
** description: pass:none[path for FIFO file; WeeChat PID can be used in path with ${info:pid} (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/weechat_fifo"+`
** default value: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** default value: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** description: pass:none[comma-separated list of nicks for which the incoming files and chats are automatically accepted; format is "server.nick" (for a specific server) or "nick" (for all servers); example: "freenode.FlashCode,andrew"]
** description: pass:none[comma-separated list of nicks for which the incoming files and chats are automatically accepted; format is "server.nick" (for a specific server) or "nick" (for all servers); example: "libera.FlashCode,andrew"]
** type: string
** values: any string
** default value: `+""+`
@@ -1883,10 +1943,10 @@
** default value: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** description: pass:none[path for writing incoming files: "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** description: pass:none[path for writing incoming files (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/xfer"+`
** default value: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** description: pass:none[temporary filename suffix used during the transfer for a file received, it is removed after successful transfer; if empty string, no filename suffix is used during the transfer]
@@ -1895,7 +1955,7 @@
** default value: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** description: pass:none[path for reading files when sending (when no path is specified by user): "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** description: pass:none[path for reading files when sending (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"~"+`
@@ -2004,6 +2064,24 @@
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** description: pass:none[color for deprecated TLS versions in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** description: pass:none[color for insecure TLS versions in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** description: pass:none[color for higher supported TLS version in bar item "tls_version"]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** description: pass:none[color for text in account messages]
** type: color
@@ -2209,19 +2287,19 @@
** default value: `+off+`
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** description: pass:none[comma separated list of words to highlight in channel buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in channel buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** description: pass:none[comma separated list of words to highlight in private buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in private buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** description: pass:none[comma separated list of words to highlight in server buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** description: pass:none[comma separated list of words to highlight in server buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their values), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"]
** type: string
** values: any string
** default value: `+"$nick"+`
@@ -2599,7 +2677,7 @@
** default value: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** description: pass:none[command(s) to run after connection to server and before auto-join of channels (many commands can be separated by ";", use "\;" for a semicolon, special variables $nick, $channel and $server are replaced by their value) (note: content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)]
** description: pass:none[command(s) to run after connection to server and before auto-join of channels (many commands can be separated by ";", use "\;" for a semicolon, special variables $nick, $channel and $server are replaced by their values) (note: commands are evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)]
** type: string
** values: any string
** default value: `+""+`
@@ -2616,6 +2694,12 @@
** values: 1 .. 3600
** default value: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** description: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** type: string
** values: any string
** default value: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** description: pass:none[use IPv6 protocol for server communication (try IPv6 then fallback to IPv4); if disabled, only IPv4 is used]
** type: boolean
@@ -2629,19 +2713,19 @@
** default value: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** description: pass:none[default kick message used by commands "/kick" and "/kickban" (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value)]
** description: pass:none[default kick message used by commands "/kick" and "/kickban" (note: content is evaluated, see /help eval; special variables ${nick} (self nick), ${target} (target nick), ${channel} and ${server} are replaced by their values)]
** type: string
** values: any string
** default value: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** description: pass:none[default part message (leaving channel) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** description: pass:none[default part message (leaving channel) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** type: string
** values: any string
** default value: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** description: pass:none[default quit message (disconnecting from server) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their value; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** description: pass:none[default quit message (disconnecting from server) (note: content is evaluated, see /help eval; special variables ${nick}, ${channel} and ${server} are replaced by their values; "%v" is replaced by WeeChat version if there is no ${...} in string)]
** type: string
** values: any string
** default value: `+"WeeChat ${info:version}"+`
@@ -2689,15 +2773,15 @@
** default value: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** description: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** description: pass:none[file with ECC private key for mechanism "ecdsa-nist256p-challenge" (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** description: pass:none[mechanism for SASL authentication: "plain" for plain text password, "ecdsa-nist256p-challenge" for key-based challenge authentication, "external" for authentication using client side SSL cert, "dh-blowfish" for blowfish crypted password (insecure, not recommended), "dh-aes" for AES crypted password (insecure, not recommended)]
** description: pass:none[mechanism for SASL authentication: "plain" for plain text password, "scram-sha-1" for SCRAM authentication with SHA-1 digest algorithm, "scram-sha-256" for SCRAM authentication with SHA-256 digest algorithm, "scram-sha-512" for SCRAM authentication with SHA-512 digest algorithm, "ecdsa-nist256p-challenge" for key-based challenge authentication, "external" for authentication using client side SSL cert, "dh-blowfish" for blowfish crypted password (insecure, not recommended), "dh-aes" for AES crypted password (insecure, not recommended)]
** type: integer
** values: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** values: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** default value: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2731,7 +2815,7 @@
** default value: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** description: pass:none[SSL certificate file used to automatically identify your nick ("%h" will be replaced by WeeChat home, "~/.weechat" by default)]
** description: pass:none[SSL certificate file used to automatically identify your nick (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+""+`
@@ -2955,10 +3039,10 @@
** default value: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** description: pass:none[file with SSL certificate and private key (for serving clients with SSL)]
** description: pass:none[file with SSL certificate and private key (for serving clients with SSL) (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/ssl/relay.pem"+`
** default value: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** description: pass:none[string with priorities for gnutls (for syntax, see documentation of function gnutls_priority_init in gnutls manual, common strings are: "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3261,7 +3345,7 @@
** default value: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** description: pass:none[format of columns displayed in script buffer: following column identifiers are replaced by their value: %a=author, %d=description, %D=date added, %e=extension, %l=language, %L=license, %n=name with extension, %N=name, %r=requirements, %s=status, %t=tags, %u=date updated, %v=version, %V=version loaded, %w=min_weechat, %W=max_weechat)]
** description: pass:none[format of columns displayed in script buffer: following column identifiers are replaced by their values: %a=author, %d=description, %D=date added, %e=extension, %l=language, %L=license, %n=name with extension, %N=name, %r=requirements, %s=status, %t=tags, %u=date updated, %v=version, %V=version loaded, %w=min_weechat, %W=max_weechat)]
** type: string
** values: any string
** default value: `+"%s %n %V %v %u | %d | %t"+`
@@ -3339,10 +3423,10 @@
** default value: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** description: pass:none[local cache directory for scripts; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default) (note: content is evaluated, see /help eval)]
** description: pass:none[local cache directory for scripts (path is evaluated, see function string_eval_path_home in plugin API reference)]
** type: string
** values: any string
** default value: `+"%h/script"+`
** default value: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** description: pass:none[URL for file with list of scripts]
+3 -3
View File
@@ -15,9 +15,9 @@
"--daemon").
*-d*, *--dir* _<path>_::
Set path as home for WeeChat (used for configuration files, logs, user
plugins and scripts), default value is "~/.weechat" (note: directory is
created if not found by WeeChat).
Force a single directory for all WeeChat files (directory is created if not found).
Four directories can be given, separated by colons (in this order: config,
data, cache, runtime).
If this option is not given, the environment variable WEECHAT_HOME is used
(if not empty).
+27 -27
View File
@@ -8,7 +8,7 @@ With irc plugin, you can connect to temporary server with an URL like:
To join WeeChat IRC channel support with nick "mynick":
irc://mynick@chat.freenode.net/#weechat
irc://mynick@irc.libera.chat/#weechat
IPv6 address can be enclosed in brackets to add a port after address, for
example:
@@ -17,79 +17,79 @@ example:
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
main WeeChat configuration file
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
plugins configuration file
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
configuration file with secured data
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
configuration file for _alias_ plugin
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
configuration file for _buflist_ plugin
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
configuration file for _charset_ plugin
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
configuration file for _exec_ plugin
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
configuration file for _fifo_ plugin
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
configuration file for _fset_ plugin
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
configuration file for _guile_ plugin
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
configuration file for _irc_ plugin
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
configuration file for _javascript_ plugin
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
configuration file for _logger_ plugin
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
configuration file for _lua_ plugin
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
configuration file for _perl_ plugin
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
configuration file for _php_ plugin
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
configuration file for _python_ plugin
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
configuration file for _relay_ plugin
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
configuration file for _ruby_ plugin
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
configuration file for _script_ plugin
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
configuration file for _spell_ plugin
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
configuration file for _tcl_ plugin
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
configuration file for _trigger_ plugin
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
configuration file for _xfer_ plugin
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
WeeChat log file
// end::files[]
@@ -97,7 +97,7 @@ $HOME/.weechat/weechat.log::
WeeChat is written by Sébastien Helleu and contributors (complete list is in
the AUTHORS.adoc file).
Copyright (C) 2003-2020 {author}
Copyright (C) 2003-2021 {author}
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
+15 -16
View File
@@ -98,6 +98,7 @@ The main WeeChat directories are:
|       gui/ | Unit tests for interfaces functions.
|       plugins/ | Unit tests for plugins.
|          irc/ | Unit tests for IRC plugin.
|          trigger/ | Unit tests for trigger plugin.
| doc/ | Documentation.
| po/ | Translations files (gettext).
| debian/ | Debian packaging.
@@ -127,6 +128,7 @@ WeeChat "core" is located in following directories:
|    wee-config.c | Configuration options for WeeChat core (file weechat.conf).
|    wee-crypto.c | Cryptographic functions.
|    wee-debug.c | Some debug functions.
|    wee-dir.c | Directory/file functions.
|    wee-eval.c | Evaluation of expressions with references to internal vars.
|    wee-hashtable.c | Hashtables.
|    wee-hdata.c | Hdata (direct access to data using hashtables).
@@ -140,6 +142,7 @@ WeeChat "core" is located in following directories:
|    wee-secure.c | Secured data functions.
|    wee-secure-buffer.c | Secured data buffer.
|    wee-secure-config.c | Secured data options (file sec.conf).
|    wee-signal.c | Signal functions.
|    wee-string.c | Functions on strings.
|    wee-upgrade-file.c | Internal upgrade system.
|    wee-upgrade.c | Upgrade for WeeChat core (buffers, lines, history, ...).
@@ -394,13 +397,16 @@ WeeChat "core" is located in following directories:
|          test-core-arraylist.cpp | Tests: arraylists.
|          test-core-calc.cpp | Tests: calculation of expressions.
|          test-core-crypto.cpp | Tests: cryptographic functions.
|          test-core-dir.cpp | Tests: directory/file functions.
|          test-core-eval.cpp | Tests: evaluation of expressions.
|          test-core-hashtble.cpp | Tests: hashtables.
|          test-core-hdata.cpp | Tests: hdata.
|          test-core-hook.cpp | Tests: hooks.
|          test-core-infolist.cpp | Tests: infolists.
|          test-core-list.cpp | Tests: lists.
|          test-core-network.cpp | Tests: network functions.
|          test-core-secure.cpp | Tests: secured data.
|          test-core-signal.cpp | Tests: signals.
|          test-core-string.cpp | Tests: strings.
|          test-core-url.cpp | Tests: URLs.
|          test-core-utf8.cpp | Tests: UTF-8.
@@ -420,6 +426,8 @@ WeeChat "core" is located in following directories:
|             test-irc-nick.cpp | Tests: IRC nicks.
|             test-irc-protocol.cpp | Tests: IRC protocol.
|             test-irc-server.cpp | Tests: IRC server.
|          trigger/ | Root of unit tests for trigger plugin.
|             test-trigger.cpp | Tests: triggers.
|          relay/ | Root of unit tests for Relay plugin.
|             test-relay-auth.cpp | Tests: clients authentication.
@@ -495,7 +503,7 @@ Example in C:
/*
* weechat.c - core functions for WeeChat
*
* Copyright (C) 2020 Your Name <your@email.com>
* Copyright (C) 2021 Your Name <your@email.com>
*
* This file is part of WeeChat, the extensible chat client.
*
@@ -1090,18 +1098,12 @@ Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
(made with `git diff` or `git format-patch`).
Format of commit message is the following (to close a GitHub issue):
Format of commit message is the following (with automatic close of a GitHub issue):
----
component: fix a problem (closes #123)
----
For a Savannah bug:
----
component: fix a problem (bug #12345)
----
Where _component_ is one of following:
* WeeChat core: _core_ (files in root directory, _po/_ and _src/_,
@@ -1114,20 +1116,17 @@ Some rules to follow:
* Use only English.
* Use infinitive form of verb.
* If commit is related to something in tracker, write it in parenthesis after
the message, with this format:
** GitHub: closes #123
** Savannah: bug #12345, task #12345, patch #12345
* If commit is related to a GitHub issue, write it in parenthesis after
the message, with this format: `(issue #123)` or `(closes #123)` to close it.
Examples of commit messages:
----
irc: add command /unquiet (closes #36)
core: add callback "nickcmp" for nick comparison in buffers
irc: fix freeze when reading on socket with SSL enabled (bug #35097)
ruby: add detection of ruby version 1.9.3 in CMake
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
ruby: add detection of ruby version 1.9.3 in CMake
----
[[translations]]
+63 -31
View File
@@ -227,6 +227,34 @@ For example to use kbd:[F1], kbd:[F2], kbd:[Alt+F1] and kbd:[Alt+F2]:
Keys "meta-OP" and "meta-OQ" may be different in your terminal. To find key
code press kbd:[Alt+k] then key.
[[customize_buflist]]
=== How can I customize the list of buffers list, like the color of the active buffer?
You can browse all buflist options with the command:
----
/fset buflist
----
The background of the active buffer is blue by default, you can change it
like this, for example to `red`:
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
There's a comma before the color name "red" because it is used as the background,
not the text color. +
You can also use any numeric color instead of `red`,
like `237` for dark gray.
The buflist plugin provides lot of options that you can customize, please read
the help on each option.
There's also a wiki page with examples of advanced buflist configuration:
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== How can I reduce length of nicks or remove nick alignment in chat area?
@@ -699,7 +727,8 @@ you have to use kbd:[Alt] instead of kbd:[Shift]).
If you are using macOS, you must install `openssl` from Homebrew.
A CA file will be bootstrapped using certificates from the system keychain.
You can then set the path to certificates in WeeChat:
With WeeChat ≤ 3.1, you can then set the path to system certificates:
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -736,10 +765,11 @@ by your server name:
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== How can I connect to freenode server using SSL?
[[irc_ssl_libera]]
=== How can I connect to libera server using SSL?
Set option _weechat.network.gnutls_ca_file_ to file with certificates:
With WeeChat ≤ 3.1, set option _weechat.network.gnutls_ca_file_ to file with
certificates:
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -758,9 +788,9 @@ Check that you have this file on your system (commonly brought by package
Setup server port, SSL, then connect:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -785,25 +815,25 @@ If the server supports SASL, you should use that instead of sending the
command for nickserv authentication, for example:
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
If the server does not support SASL, you can add a delay (between command and
join of channels):
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
=== How can I add/remove channels from autojoin option?
You can use the `/set` command to edit the list of autojoin channels,
for example for the "freenode" server:
for example for the "libera" server:
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -974,16 +1004,16 @@ _buffer_autoset.py_ script:
----
For example, to permanently disable highlights from "mike" on #weechat
on the IRC server freenode:
on the IRC server libera:
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
To apply it to the entire freenode server instead:
To apply it to the entire libera server instead:
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
For more examples, see `+/help buffer_autoset+`.
@@ -1019,15 +1049,17 @@ Scripts are not compatible with other IRC clients.
[[scripts_update]]
=== The command "/script update" can not read scripts, how to fix that?
First check questions about SSL connection in this FAQ
(especially the option _weechat.network.gnutls_ca_file_).
First check questions about SSL connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell):
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
With WeeChat ≤ 3.1, the path should be: _~/.weechat/script/plugins.xml.gz_.
And update scripts again in WeeChat:
----
@@ -1047,7 +1079,7 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
@@ -1097,8 +1129,8 @@ You can try following tips to consume less memory:
fifo, logger, perl, python, ruby, lua, tcl, guile, javascript, php, spell,
xfer (used for DCC). See `/help weechat.plugin.autoload`.
* Load only scripts that you really need.
* Do not load certificates if SSL is *NOT* used: set empty string in option
_weechat.network.gnutls_ca_file_.
* Do not load system certificates if SSL is *NOT* used: turn off this option:
_weechat.network.gnutls_ca_system_.
* Reduce value of option _weechat.history.max_buffer_lines_number_ or set value
of option _weechat.history.max_buffer_lines_minutes_.
* Reduce value of option _weechat.history.max_commands_.
@@ -1154,21 +1186,20 @@ For example:
----
/secure passphrase xxxxxxxxxx
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
[[sharing_config_files]]
=== I want to share my WeeChat configuration, what files should I share and what should I keep private?
You can share files _~/.weechat/*.conf_ except the file _sec.conf_ which
You can share configuration files _*.conf_ except the file _sec.conf_ which
contains your passwords ciphered with your passphrase.
Some other files like _irc.conf_ may contain sensitive info like passwords
for servers/channels (if they are not stored in _sec.conf_ with the `/secure`
command).
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories]
for more information about configuration files.
@@ -1204,7 +1235,8 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?
The full list is on this page: https://weechat.org/download
WeeChat runs fine on most Linux/BSD distributions, GNU/Hurd, Mac OS and Windows
(Cygwin and Windows Subsystem for Linux).
We do our best to run on as many platforms as possible. Help is welcome for
some OS' we don't have, to test WeeChat.
File diff suppressed because it is too large Load Diff
+21 -28
View File
@@ -105,12 +105,12 @@ other plugins in the list.
You can add an IRC server with the `/server` command, for example:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
In this command, `libera` is the internal server name used by WeeChat:
you'll be able to connect with `/connect libera` and the server options
are _irc.server.libera.xxx_.
As usual, help is available if you're lost:
@@ -129,45 +129,38 @@ For each server option, WeeChat uses its value if it is defined (not
"null"). Otherwise WeeChat uses default value ("irc.server_default.xxx").
For example there are default nicks (based on your un*x login), and you can
override them for the freenode server with following command:
override them for the libera server with following command:
----
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
/set irc.server.libera.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
----
To set the user and real names:
----
/set irc.server.freenode.username "My user name"
/set irc.server.freenode.realname "My real name"
/set irc.server.libera.username "My user name"
/set irc.server.libera.realname "My real name"
----
To enable auto-connect to server at startup:
----
/set irc.server.freenode.autoconnect on
----
To connect with SSL:
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
If SASL is available on the server, you can use it for authentication (you will be
identified before you join channels):
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
To run a command after connection to server, for example to authenticate
with nickserv (only if you don't use SASL for authentication):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -182,23 +175,23 @@ First setup a passphrase:
/secure passphrase this is my secret passphrase
----
Then add a secured data with your freenode password:
Then add a secured data with your libera password:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
Then you can use `+${sec.data.freenode_password}+` instead of your password in the
Then you can use `+${sec.data.libera_password}+` instead of your password in the
IRC options mentioned above, for example:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
To auto-join some channels when connecting to server:
----
/set irc.server.freenode.autojoin "#channel1,#channel2"
/set irc.server.libera.autojoin "#channel1,#channel2"
----
[TIP]
@@ -210,24 +203,24 @@ To remove a value of a server option, and use the default value instead,
for example to use default nicks (irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Other options: you can setup other options with the following command ("xxx" is
option name):
----
/set irc.server.freenode.xxx value
/set irc.server.libera.xxx value
----
[[connect_to_irc_server]]
== Connect to IRC server
----
/connect freenode
/connect libera
----
With this command, WeeChat connects to the freenode server and auto-joins the
With this command, WeeChat connects to the libera server and auto-joins the
channels configured in the "autojoin" server option.
[NOTE]
+72 -72
View File
@@ -436,11 +436,11 @@ hda:
item 2:
__path: ['0x558d62840ea0']
number: 1
full_name: 'irc.server.freenode'
full_name: 'irc.server.libera'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
* Request all lines of first buffer:
@@ -588,15 +588,15 @@ inf: ('version_number', '34144256')
* Request WeeChat directory:
----
(info_weechat_dir) info weechat_dir
(info_weechat_config_dir) info weechat_config_dir
----
Response:
[source,python]
----
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
----
[[command_infolist]]
@@ -747,7 +747,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#weechat_)
Examples:
@@ -856,10 +856,10 @@ hda:
prefix_color: None
----
* Request nicklist for buffer "irc.freenode.#weechat":
* Request nicklist for buffer "irc.libera.#weechat":
----
(nicklist_weechat) nicklist irc.freenode.#weechat
(nicklist_weechat) nicklist irc.libera.#weechat
----
Response:
@@ -948,7 +948,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#weechat_)
* _data_: data to send to buffer: if beginning by `/`, this will be executed as
a command on buffer, otherwise text is sent as input of buffer
@@ -963,7 +963,7 @@ input core.weechat /help filter
* Send message "hello!" to #weechat channel:
----
input irc.freenode.#weechat hello!
input irc.libera.#weechat hello!
----
[[command_completion]]
@@ -983,7 +983,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_)
_core.weechat_ or _irc.libera.#weechat_)
* _position_: position for completion in string (starts to 0);
if the value is -1, the position is the length of _data_ (so the completion
is made at the end of _data_)
@@ -1144,7 +1144,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_); name "*" can be used to
_core.weechat_ or _irc.libera.#weechat_); name "*" can be used to
specify all buffers
* _options_: one of following keywords, separated by commas (default is
_buffers,upgrade,buffer,nicklist_ for "*" and _buffer,nicklist_ for a buffer):
@@ -1179,14 +1179,14 @@ sync core.buffer
* Synchronize #weechat channel, without nicklist:
----
sync irc.freenode.#weechat buffer
sync irc.libera.#weechat buffer
----
* Get general signals + all signals for #weechat channel:
----
sync * buffers,upgrade
sync irc.freenode.#weechat
sync irc.libera.#weechat
----
[[command_desync]]
@@ -1209,7 +1209,7 @@ Syntax:
Arguments:
* _buffer_: pointer (eg: "0x1234abcd") or full name of buffer (for example:
_core.weechat_ or _irc.freenode.#weechat_); name "*" can be used to
_core.weechat_ or _irc.libera.#weechat_); name "*" can be used to
specify all buffers
* _options_: one of following keywords, separated by commas (default is
_buffers,upgrade,buffer,nicklist_ for "*" and _buffer,nicklist_ for a buffer);
@@ -1217,7 +1217,7 @@ Arguments:
[NOTE]
When using buffer "*", the other buffers synchronized (using a name) are kept. +
So if you send: "sync *", then "sync irc.freenode.#weechat", then "desync *",
So if you send: "sync *", then "sync irc.libera.#weechat", then "desync *",
the updates on #weechat channel will still be sent by WeeChat (you must remove
it explicitly to stop updates).
@@ -1235,13 +1235,13 @@ desync * buffers,upgrade,buffer,nicklist
* Desynchronize nicklist for #weechat channel (keep buffer updates):
----
desync irc.freenode.#weechat nicklist
desync irc.libera.#weechat nicklist
----
* Desynchronize #weechat channel:
----
desync irc.freenode.#weechat
desync irc.libera.#weechat
----
[[command_test]]
@@ -1481,7 +1481,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| short_name | string | Short name (example: _#weechat_).
| nicklist | integer | 1 if buffer has a nicklist, otherwise 0.
| title | string | Buffer title.
@@ -1490,8 +1490,8 @@ Data sent as hdata:
| next_buffer | pointer | Pointer to next buffer.
|===
Example: channel _#weechat_ joined on freenode, new buffer
_irc.freenode.#weechat_:
Example: channel _#weechat_ joined on libera, new buffer
_irc.libera.#weechat_:
[source,python]
----
@@ -1511,13 +1511,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
@@ -1535,12 +1535,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ moved to number 2:
Example: buffer _irc.libera.#weechat_ moved to number 2:
[source,python]
----
@@ -1556,7 +1556,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
----
@@ -1573,12 +1573,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ merged with buffer #2:
Example: buffer _irc.libera.#weechat_ merged with buffer #2:
[source,python]
----
@@ -1594,7 +1594,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1611,12 +1611,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ unmerged:
Example: buffer _irc.libera.#weechat_ unmerged:
[source,python]
----
@@ -1632,7 +1632,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1651,12 +1651,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ hidden:
Example: buffer _irc.libera.#weechat_ hidden:
[source,python]
----
@@ -1672,7 +1672,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1691,12 +1691,12 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| prev_buffer | pointer | Pointer to previous buffer.
| next_buffer | pointer | Pointer to next buffer.
|===
Example: buffer _irc.freenode.#weechat_ unhidden:
Example: buffer _irc.libera.#weechat_ unhidden:
[source,python]
----
@@ -1712,7 +1712,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1729,7 +1729,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| short_name | string | Short name (example: _#weechat_).
| local_variables | hashtable | Local variables.
|===
@@ -1750,15 +1750,15 @@ hda:
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.freenode.Flash2'
full_name: 'irc.libera.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'freenode',
'server': 'libera',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'freenode.Flash2',
'name': 'libera.Flash2',
}
----
@@ -1774,7 +1774,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| title | string | Buffer title.
|===
@@ -1793,7 +1793,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
----
@@ -1811,10 +1811,10 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
|===
Example: buffer _irc.freenode.#weechat_ has been cleared:
Example: buffer _irc.libera.#weechat_ has been cleared:
[source,python]
----
@@ -1828,7 +1828,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_buffer_type_changed]]
@@ -1843,7 +1843,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| type | integer | Buffer type: 0 = formatted (default), 1 = free content.
|===
@@ -1879,11 +1879,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ added in buffer _irc.freenode.#weechat_:
Example: local variable _test_ added in buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1898,15 +1898,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'freenode',
'server': 'libera',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1922,11 +1922,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ updated in buffer _irc.freenode.#weechat_:
Example: local variable _test_ updated in buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1941,7 +1941,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1949,7 +1949,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1965,11 +1965,11 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
| local_variables | hashtable | Local variables.
|===
Example: local variable _test_ removed from buffer _irc.freenode.#weechat_:
Example: local variable _test_ removed from buffer _irc.libera.#weechat_:
[source,python]
----
@@ -1984,14 +1984,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
full_name: 'irc.libera.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -2017,7 +2017,7 @@ Data sent as hdata:
| message | string | Message.
|===
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.freenode.#weechat_:
Example: new message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_:
[source,python]
----
@@ -2066,10 +2066,10 @@ Data sent as hdata:
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1).
| full_name | string | Full name (example: _irc.freenode.#weechat_).
| full_name | string | Full name (example: _irc.libera.#weechat_).
|===
Example: buffer _irc.freenode.#weechat_ is being closed by WeeChat:
Example: buffer _irc.libera.#weechat_ is being closed by WeeChat:
[source,python]
----
@@ -2083,7 +2083,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_nicklist]]
@@ -2109,7 +2109,7 @@ Data sent as hdata:
| prefix_color | string | Prefix color (only for a nick).
|===
Example: nicklist for buffer _irc.freenode.#weechat_:
Example: nicklist for buffer _irc.libera.#weechat_:
[source,python]
----
@@ -2529,7 +2529,7 @@ objects, and then set of objects (path with pointers, then objects).
* _values_: list of values (number of values is number of keys returned for
hdata)
Example of hdata with two buffers (weechat core and freenode server) and two
Example of hdata with two buffers (weechat core and libera server) and two
keys (_number_ and _full_name_):
....
@@ -2537,10 +2537,10 @@ keys (_number_ and _full_name_):
hdata buffer:gui_buffers(*) number,full_name
# response
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬─────────────────────
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └─────────────────────────────────
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
h-path keys count buffer 1 buffer 2
....
@@ -2682,7 +2682,7 @@ An item is:
** _type_: type of variable (_int_, _str_, ...)
** _value_: value of variable
Example of infolist with two buffers (weechat core and freenode server):
Example of infolist with two buffers (weechat core and libera server):
....
# command
+91 -67
View File
@@ -66,12 +66,17 @@ link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference].
[[languages_specificities]]
=== Languages specificities
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat defines a `weechat` module which must be imported with `import weechat`.
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi].
[[python_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
@@ -79,6 +84,7 @@ Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
Functions `+print*+` are called `+prnt*+` in python (because `print` was a
reserved keyword in Python 2).
[[python_strings]]
===== Strings received in callbacks
In Python 3 and with WeeChat ≥ 2.7, the strings received in callbacks have type
@@ -132,18 +138,23 @@ In Python 2, which is now deprecated and should not be used any more, the
strings sent to callbacks are always of type `str`, and may contain invalid
UTF-8 data, in the cases mentioned above.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Functions
Functions are called with `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialization
You have to define _weechat_init_ and call _register_ inside.
[[ruby_functions]]
===== Functions
Functions are called with `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -168,20 +179,26 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Functions
Functions are called with `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Functions
Functions are called with `+(weechat:xxx arg1 arg2 ...)+`.
@@ -194,14 +211,18 @@ arguments in Guile:
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Functions
Functions are called with `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Functions
Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
@@ -212,11 +233,11 @@ Functions are called with `+weechat_xxx(arg1, arg2, ...);+`.
All WeeChat scripts must "register" themselves to WeeChat, and this must be
first WeeChat function called in script.
Prototype:
Prototype (Python):
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Arguments:
@@ -337,7 +358,7 @@ WeeChat is starting.
For example with Python:
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -776,58 +797,58 @@ List of constants in script API:
| Category | Constants
| return codes |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (integer) +
`WEECHAT_RC_OK_EAT` (integer) +
`WEECHAT_RC_ERROR` (integer)
| configuration files |
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
`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 +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (string) +
`WEECHAT_LIST_POS_BEGINNING` (string) +
`WEECHAT_LIST_POS_END` (string)
| hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`WEECHAT_HOTLIST_LOW` (string) +
`WEECHAT_HOTLIST_MESSAGE` (string) +
`WEECHAT_HOTLIST_PRIVATE` (string) +
`WEECHAT_HOTLIST_HIGHLIGHT` (string)
| hook process |
WEECHAT_HOOK_PROCESS_RUNNING +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (integer) +
`WEECHAT_HOOK_PROCESS_ERROR` (integer)
| hook connect |
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
`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 +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (string) +
`WEECHAT_HOOK_SIGNAL_INT` (string) +
`WEECHAT_HOOK_SIGNAL_POINTER` (string)
|===
[[common_tasks]]
@@ -868,13 +889,13 @@ weechat.prnt("", "%swrong arguments" % weechat.prefix("error"))
weechat.prnt("", "text %syellow on blue" % weechat.color("yellow,blue"))
# search buffer and display message
# (full name of buffer is plugin.name, for example: "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (full name of buffer is plugin.name, for example: "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "message on #weechat channel")
# other solution to find an IRC buffer (better)
# (note that server and channel are separated by a comma)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message on #weechat channel")
----
@@ -895,7 +916,7 @@ Examples:
weechat.command("", "/help")
# send "hello" to #weechat IRC channel (users on channel will see message)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "hello")
----
@@ -965,7 +986,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "")
To see local variables of a buffer, do this command in WeeChat:
----
/buffer localvar
/buffer listvar
----
[[hooks]]
@@ -1196,7 +1217,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal is for example: "freenode,irc_in2_join"
# signal is for example: "libera,irc_in2_join"
# signal_data is IRC message, for example: ":nick!user@host JOIN :#channel"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1248,63 +1269,66 @@ The result is a hashtable with following keys
(the example values are built with this message:
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`):
[width="100%",cols="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Key | WeeChat version | Description | Example
| Key | Since WeeChat ^(1)^ | Description | Example
| tags | 0.4.0 |
| tags | 0.4.0 |
The tags in message (can be empty). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
The message without the tags (the same as message if there are no tags). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
The origin nick. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
The origin user. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
The origin host (includes the nick). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
The command (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
The target channel. |
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
The command arguments (includes the channel). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
The text (for example user message). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
The index of _command_ in message ("-1" if _command_ was not found). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
The index of _arguments_ in message ("-1" if _arguments_ was not found). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
The index of _channel_ in message ("-1" if _channel_ was not found). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
The index of _text_ in message ("-1" if _text_ was not found). |
`+65+`
|===
[NOTE]
^(1)^ The key has been introduced in this WeeChat version.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1365,8 +1389,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# WeeChat home directory, for example: "/home/xxxx/.weechat"
weechat.prnt("", "WeeChat home dir: %s" % weechat.info_get("weechat_dir", ""))
# WeeChat config directory, for example: "/home/user/.config/weechat"
weechat.prnt("", "WeeChat config dir: %s" % weechat.info_get("weechat_config_dir", ""))
# keyboard inactivity
weechat.prnt("", "Inactivity since %s seconds" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -126,6 +126,6 @@ If you're still awake you should see the familiar interface and brag about
having the newest possible version of WeeChat. ;)
Now if you experience strange behavior (it may have issues or crash or boil
your beer) don't hesitate to join _#weechat_ at _chat.freenode.net_ and tell us.
your beer) don't hesitate to join _#weechat_ at _irc.libera.chat_ and tell us.
If it doesn't crash - tell us too, we need your feedback!
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2012-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2012-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2012-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2012-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
+103 -141
View File
@@ -1,4 +1,4 @@
= WeeChat Quick Start Guide
= WeeChat guía rápida
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: es
@@ -7,57 +7,54 @@
:docinfo1:
// TRANSLATION MISSING
Translators:
Traductores:
* Lázaro A. <uranio-235@myopera.com>, 2012
* Victorhck <victorhck@mailbox.org>, 2021
[[start]]
== Iniciar WeeChat
Es recomendable una terminal emulada para X (pero no indispensable)
Es recomendable un emulador de terminal para X (pero no indispensable)
rxvt-unicode: tiene un buen soporte para UTF-8, y no da problemas con
los atajas de teclados predeterminados.
los atajos de teclado predeterminados.
// TRANSLATION MISSING
Run from your shell:
Ejecuta desde una consola:
----
$ weechat
----
[[help]]
== Ayuda en linea
== Ayuda en línea
WeeChat tiene ayuda para todos los comandos, solo teclee:
WeeChat tiene ayuda para todos los comandos, simplemente escriba:
----
/help
----
Para obtener ayuda específicamente de un comando, teclee:
Para obtener ayuda específica de un comando, escriba:
----
/help comando
----
// TRANSLATION MISSING
Help is available for options as well:
También hay ayuda disponible para las opciones:
----
/help config.section.option
----
(donde `config` es el nombre de la configuración del núcleo o del
plugin que desea configurar, `section`, la sección de esa configuración
complemento que desea configurar, `section`, la sección de esa configuración
y `option` el nombre de la opción).
// TRANSLATION MISSING
[[options]]
== Set options
== Configurar las opciones
Para configurar una opción, use:
Para configurar una opción, utilice:
----
/set config.section.option valor
@@ -66,75 +63,66 @@ Para configurar una opción, use:
WeeChat usará inmediatamente el nuevo valor asignado (*no* es necesario
reiniciar WeeChat después de aplicar cambios a la configuración).
Todas las opciones se salvarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar la forzar a WeeChat a
Todas las opciones se guardarán de manera automática cuando cierre
WeeChat o usando el comando `/save` para forzar a WeeChat a
guardar todos los archivos de configuración.
// TRANSLATION MISSING
[IMPORTANT]
It is *not recommended* to edit configuration files by hand because WeeChat
may write them at any time (for example on `/quit`) and after any change
you must run the command `/reload` (with the risk of losing other changes
that were not yet saved with `/save`). +
You can use the command `/set`, which checks the value and applies immediately
the changes.
*No se recomienda* editar los archivos de configuración a mano porque WeeChat
puede escribirlos en cualquier momento (por ejemplo al ejecutar `/quit`) y después de cualquier cambio
debería ejecutar el comando `/reload` (con el riesgo de perder otros cambios
que todavía no fueron guardados con `/save`). +
Puede utilizar el comando `/set`, que comprueba el valor y aplica inmediatamente
los cambios.
// TRANSLATION MISSING
The plugin _fset_ allows you to easily browse options and change them.
El complemento _fset_ le permite navegar fácilmente por las opciones y cambiarlas.
// TRANSLATION MISSING
For example to display WeeChat options:
Por ejemplo para mostrar las opciones de WeeChat:
----
/fset weechat.*
----
// TRANSLATION MISSING
IRC options:
Opciones de IRC:
----
/fset irc.*
----
// TRANSLATION MISSING
The `/fset` command has completion on part of option names, so for example if
you type `/fset hot` and press kbd:[Tab] this is completed as `/fset hotlist`.
If you press kbd:[Enter], options about the hotlist are displayed.
El comando `/fset` dispone de autocompletado de parte de los nombres de opciones, así por ejemplo si
escribe `/fset hot` y presiona kbd:[Tab] el resto del comando será autocompletado como `/fset hotlist`.
Si pulsa kbd:[Enter], se mostrarán las opciones sobre los atajos de teclado.
// TRANSLATION MISSING
For more information about `/fset` command and keys, see `/help fset`.
Para más información sobre el comando `/fset` y las teclas, vea `/help fset`.
[[core_vs_plugins]]
== Núcleo vs Plugins
== Núcleo vs Complementos
Llamaremos "Núcleo de WeeChat" a la aplicación que solo se usa para
mostrar información en pantalla e interactuar con el usuario, eso es lo
único que hace el núcleo de WeeChat sin no tiene plugins. (para los
único que hace el núcleo de WeeChat sin no tiene complementos. (para los
fieles seguidores: IRC fue parte del núcleo para las versiones ≤
0.2.6).
Todos los protocolos de red como IRC, provienen en plugins separados.
Todos los protocolos de red como IRC, provienen de complementos separados.
Use el comando `/plugin` para ver una lista de los plugins cargados,
Use el comando `/plugin` para ver una lista de los complementos cargados,
seguramente vera irc y otros.
// TRANSLATION MISSING
[[add_irc_server]]
== Add an IRC server
== Añadir un servidor IRC
// TRANSLATION MISSING
You can add an IRC server with `/server` command, for example:
Puede añadir un servidor IRC mediante el comando `/server`, por ejemplo:
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
// TRANSLATION MISSING
In this command, `freenode` is the internal server name used by WeeChat:
you'll be able to connect with `/connect freenode` and the server options
are _irc.server.freenode.xxx_.
En este comando, `libera` es el nombre interno del servidor utilizado por WeeChat:
más tarde podrá conectar con ese servidor mediante `/connect libera` y las opciones del servidor
serán _irc.server.libera.xxx_.
La ayuda está disponible; si te pierdes:
Si se encuentra perdido, puede consultar la ayuda disponible:
----
/help server
@@ -143,9 +131,9 @@ La ayuda está disponible; si te pierdes:
[[irc_server_options]]
== Personalizar las opciones de un servidor IRC
WeeChat usa las opciones por defecto para todos los servidores
WeeChat usa las opciones predeterminadas para todos los servidores
("predeterminado") si no le especifica un valor individual a un servidor
en específico. Esas opciones por defectos son las que se muestran en
en específico. Esas opciones predeterminadas son las que se muestran en
"irc.server_default.*"
Para cada opción de "server", WeeChat usa estos valores previamente
@@ -153,123 +141,105 @@ asignados siempre y cuando no sean Nulos. Si no hay nada asignado,
WeeChat usara los valores predeterminados ("irc.server_default.xxx")
Por ejemplo, tenemos el nick por defecto (que se basa en su login) pero
usted puedes sobreescribirlo para el servidor identificado como freenode
usted puedes sobreescribirlo para el servidor identificado como libera
de la siguiente manera:
----
/set irc.server.freenode.nicks "nick,nick2,nick3,nick4,nick5"
/set irc.server.libera.nicks "nick,nick2,nick3,nick4,nick5"
----
También para configurar el nombre de usuario y el nombre real:
----
/set irc.server.freenode.username "Mi nombre de usuario"
/set irc.server.freenode.realname "Mi nombre real"
/set irc.server.libera.username "Mi nombre de usuario"
/set irc.server.libera.realname "Mi nombre real"
----
Para que el servidor se conecte cuando WeeChat inicie:
----
/set irc.server.freenode.autoconnect on
/set irc.server.libera.autoconnect on
----
// TRANSLATION MISSING
To connect with SSL:
Si la opción SASL está disponible en el servidor, puede utilizarla para autentificarse (será
identificado o identificada antes de unirse a los canales):
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.sasl_username "nick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
// TRANSLATION MISSING
If SASL is available on server, you can use it for authentication (you will be
identified before you join channels):
Para ejecutar un comando después de conectarse al servidor, por ejemplo autentificarse
con el servicio de identificación de nicks nickserv (solo si no utiliza SASL para autentificarse):
----
/set irc.server.freenode.sasl_username "nick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
// TRANSLATION MISSING
To run a command after connection to server, for example to authenticate
with nickserv (only if you don't use SASL for authentication):
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----
// TRANSLATION MISSING
[NOTE]
Many commands in option _command_ can be separated by `;` (semi-colon).
Muchos comandos en la opción _command_ pueden ser separados por `;` (punto y coma).
// TRANSLATION MISSING
If you want to protect your password in configuration files, you can use
secured data.
Si quiere proteger su contraseña en los archivos de configuración, puede utilizar
una securización de los datos.
// TRANSLATION MISSING
First setup a passphrase:
Primero configure una frase de contraseña
----
/secure passphrase this is my secret passphrase
----
// TRANSLATION MISSING
Then add a secured data with your freenode password:
Después añada un dato securizado con su contraseña de libera:
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
// TRANSLATION MISSING
Then you can use `+${sec.data.freenode_password}+` instead of your password in
IRC options mentioned above, for example:
Después puede utilizar `+${sec.data.libera_password}+` en vez de su contraseña en
las opciones de IRC mencionadas anteriormente, por ejemplo:
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Para unirse automáticamente a canales cuando el servidor se conecte:
----
/set irc.server.freenode.autojoin "#uncanal,#otrocanal"
/set irc.server.libera.autojoin "#uncanal,#otrocanal"
----
// TRANSLATION MISSING
[TIP]
You can complete name and value of options with the kbd:[Tab] key
and kbd:[Shift+Tab] for a partial completion (useful for long words like
the name of option).
Puede completar el nombre y el valor de las opciones con la tecla kbd:[Tab]
y kbd:[Shift+Tab] para un autocompletado parcial (útil para palabras largas como
el nombre de la opción).
Para eliminar un valor asignado a una opción de servidor y usar los
valores por defecto en su lugar, por ejemplo, usar el nick por defecto
valores predeterminados en su lugar, por ejemplo, usar el nick predeterminado
(irc.server_default.nicks):
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Otras opciones: pude configurar otras opciones con el siguiente comando,
Otras opciones: puede configurar otras opciones con el siguiente comando,
donde "xxx" es el nombre de la opción.
----
/set irc.server.freenode.xxx valor
/set irc.server.libera.xxx valor
----
[[connect_to_irc_server]]
== Conectarse a un servidor IRC
----
/connect freenode
/connect libera
----
// TRANSLATION MISSING
With this command, WeeChat connects to the freenode server and auto-joins the
channels configured in the "autojoin" server option.
Con este comando, WeeChat se conecta al servidor de libera y inicia sesión automáticamente en
los canales configurados en la opción del servidor "autojoin".
// TRANSLATION MISSING
[NOTE]
Este comando también puede usarse para crear y conectarse a un nuevo
servidor sin usar el comando `/server` (see `/help connect`).
servidor sin usar el comando `/server` (vea `/help connect`).
Por defecto, todos los buffers del servidor están junto al buffer de
núcleo. Para cambiar entre el buffer del núcleo y el buffer de los
@@ -297,36 +267,32 @@ Sale de un canal (mantiene el buffer abierto):
/part [mensaje de partida]
----
// TRANSLATION MISSING
Close a server, channel or private buffer (`/close` is an alias for
Cierra un servidor, canal o buffer privado (`/close` es un alias para
`/buffer close`):
----
/close
----
// TRANSLATION MISSING
[WARNING]
Closing the server buffer will close all channel/private buffers.
Al cerrar el buffer del servidor cerrará todos los buffer de canales/privados
// TRANSLATION MISSING
Disconnect from server, on the server buffer:
Para desconectar del servidor, en el buffer del servidor ejecute:
----
/disconnect
----
// TRANSLATION MISSING
[[irc_private_messages]]
== IRC private messages
== Mensajes privados en IRC
Open a buffer and send a message to another user (nick _foo_):
Abre un buffer y envíe un mensaje a otra persona (nick _foo_):
----
/query foo this is a message
/query foo esto es un mensaje
----
Close the private buffer:
Cierra el buffer privado:
----
/close
@@ -335,11 +301,11 @@ Close the private buffer:
[[buffer_window]]
== Manipulando buffer/ventana
Un buffer, es un componente vinculado a un plugin con un número, una
Un buffer, es un componente vinculado a un complemento con un número, una
categoría y un nombre. El buffer contiene los datos que se muestran en
la pantalla.
Una ventana es una vista de un buffer. Por defecto, una sola ventana
Una ventana es una vista de un buffer. De manera predeterminada, una sola ventana
muestra un solo buffer. Si divide la pantalla, podrá ver muchas
ventanas conteniendo varios buffer al mismo tiempo.
@@ -357,8 +323,7 @@ junto a otras mas grande (2/3) use el comando
/window splitv 33
----
// TRANSLATION MISSING
To remove the split:
Para eliminar esa división:
----
/window merge
@@ -367,19 +332,19 @@ To remove the split:
[[key_bindings]]
== Atajos de teclado
WeeChat usa muchas teclas por defecto. Las mismas, están bien
WeeChat usa muchas teclas por defecto. Éstas, están bien
explicadas en la documentación pero debe conocer al menos la mas
importantes.
- kbd:[Alt+←] / kbd:[Alt+→] o kbd:[F5] / kbd:[F6]: Cambiara al buffer
- kbd:[Alt+←] / kbd:[Alt+→] o kbd:[F5] / kbd:[F6]: Cambiará al buffer
siguiente/anterior
// TRANSLATION MISSING
- kbd:[F1] / kbd:[F2]: scroll bar with list of buffers ("buflist")
- kbd:[F7] / kbd:[F8]: Cambiara a la siguiente/anterior ventana (cuando la pantalla
- kbd:[F1] / kbd:[F2]: desplazará la barra de scroll con la lista de buffers ("buflist")
- kbd:[F7] / kbd:[F8]: cambiará a la siguiente/anterior ventana (cuando la pantalla
este dividida)
- kbd:[F9] / kbd:[F10]: desplazamiento del texto en la barra de titulo
- kbd:[F11] / kbd:[F12]: desplazamiento del texto en la lista de nick
- kbd:[Tab]: Completa los textos o nick que se escriben
- kbd:[F9] / kbd:[F10]: desplazamiento del texto en la barra de título
- kbd:[F11] / kbd:[F12]: desplazamiento del texto en la lista de nicks
- kbd:[Tab]: completa los textos o nicks que se escriben
- kbd:[PgUp] / kbd:[PgDn]: desplazamiento del texto en el buffer
- kbd:[Alt+a]: salta al siguiente buffer con actividad reciente
@@ -391,10 +356,10 @@ alguna tecla.
Por ejemplo, para asignar la combinación kbd:[Alt+!] al comando `/buffer close`:
----
/key bind (presionamos alt-k) (presionamos alt-!) /buffer close
/key bind (presionamos Alt-k) (presionamos Alt-!) /buffer close
----
El comando se vera mas o menos así:
El comando tendrá un aspecto similar a esto:
----
/key bind meta-! /buffer close
@@ -407,28 +372,25 @@ Para eliminar una combinación:
----
[[plugins_scripts]]
== Plugins/scripts
== Complementos/scripts
En algunas distribuciones como Debian, los plugins están disponibles en
En algunas distribuciones como Debian, los complementos están disponibles en
un paquete separado (como weechat-plugin).
Los plugins se cargan de manera automática cuando son encontrados por WeeChat
Los complementos se cargan de manera automática cuando son encontrados por WeeChat
(por favor, refierase a la documentación de WeeChat para ver como cargar/descargar
plugins y scripts).
complementos y scripts).
// TRANSLATION MISSING
Many external scripts (from contributors) are available for WeeChat, you can
download and install scripts from the repository with the `/script` command,
for example:
Muchos scripts externo (ofrecidos por colaboradores) están disponibles para WeeChat, puede
descargar e instalar scripts desde el repositorio mediante el comando `/script`,
por ejemplo:
----
/script install go.py
----
// TRANSLATION MISSING
See `/help script` for more info.
Vea `/help script` para obtener más información.
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or at this URL:
Hay una lista de scripts disponibles en WeeChat mediante el comando `/script` o en este enlace:
https://weechat.org/scripts
[[more_doc]]
@@ -437,4 +399,4 @@ https://weechat.org/scripts
Ahora puede usar WeeChat y leer las FAQ/documentación para cada pregunta
en: https://weechat.org/doc
Disfrute de WeeChat!
¡Disfrute de WeeChat!
+16 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,19 +32,21 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/fr/man1)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.fr.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (fr)"
)
add_custom_target(doc-man-weechat-headless-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/fr/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.fr.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.fr.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (fr)"
)
add_custom_target(doc-man-weechat-headless-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/fr/man1)
endif()
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2006 Julien Louis <ptitlouis@sysif.net>
#
# This file is part of WeeChat, the extensible chat client.
@@ -120,6 +120,10 @@
| weechat | bars_options | options pour les barres
| weechat | buffer_local_variable_value | valeur d'une variable locale du tampon
| weechat | buffer_local_variables | variables locales du tampon
| weechat | buffer_properties_get | propriétés qui peuvent être lues sur un tampon
| weechat | buffer_properties_set | propriétés qui peuvent être changées sur un tampon
@@ -233,6 +233,10 @@ _hook_connect_   (pointer, hdata: "hook") +
_hook_fd_   (pointer, hdata: "hook") +
_hook_timer_connection_   (pointer, hdata: "hook") +
_hook_timer_sasl_   (pointer, hdata: "hook") +
_sasl_scram_client_first_   (string) +
_sasl_scram_salted_pwd_   (other) +
_sasl_scram_salted_pwd_size_   (integer) +
_sasl_scram_auth_message_   (string) +
_is_connected_   (integer) +
_ssl_connected_   (integer) +
_disconnected_   (integer) +
+15 -3
View File
@@ -20,6 +20,8 @@
| irc | irc_is_channel | 1 si la chaîne est un nom de canal IRC valide pour le serveur | serveur,canal (le serveur est optionnel)
| irc | irc_is_message_ignored | 1 si le pseudo est ignoré (le message n'est pas affiché) | serveur,message (message est le message brut IRC)
| irc | irc_is_nick | 1 si la chaîne est un pseudo IRC valide | serveur,pseudo (le serveur est optionnel)
| irc | irc_nick | retourne le pseudo utilisé actuellement sur un serveur | nom de serveur
@@ -58,7 +60,7 @@
| php | php_version | version de l'interpréteur utilisé | -
| python | python2_bin | chemin vers l'interpréteur python 2.x | -
| python | python2_bin | chemin vers l'interpréteur Python 2.x (*obsolète* depuis la version 2.6, les scripts doivent utiliser seulement Python 3) | -
| python | python_eval | évaluation de code source | code source à exécuter
@@ -74,7 +76,7 @@
| ruby | ruby_version | version de l'interpréteur utilisé | -
| spell | spell_dict | liste de dictionnaires (séparés par des virgules) utilisés sur le tampon | pointeur vers un tampon ("0x12345678") ou nom complet de tampon ("irc.freenode.#weechat")
| spell | spell_dict | liste de dictionnaires (séparés par des virgules) utilisés sur le tampon | pointeur vers un tampon ("0x12345678") ou nom complet de tampon ("irc.libera.#weechat")
| tcl | tcl_eval | évaluation de code source | code source à exécuter
@@ -132,7 +134,15 @@
| weechat | version_number | version de WeeChat (sous forme de nombre) | -
| weechat | weechat_dir | répertoire de WeeChat | -
| weechat | weechat_cache_dir | répertoire du cache WeeChat | -
| weechat | weechat_config_dir | répertoire de la configuration WeeChat | -
| weechat | weechat_daemon | 1 si WeeChat tourne en mode démon (sans interface, en tâche de fond) | -
| weechat | weechat_data_dir | répertoire des données WeeChat | -
| weechat | weechat_dir | répertoire de WeeChat (*obsolète depuis la version 3.2, remplacé par "weechat_config_dir", "weechat_data_dir", "weechat_cache_dir" et "weechat_runtime_dir") | -
| weechat | weechat_headless | 1 si WeeChat tourne sans interface | -
@@ -140,6 +150,8 @@
| weechat | weechat_localedir | répertoire "locale" de WeeChat | -
| weechat | weechat_runtime_dir | répertoire de "runtime" WeeChat | -
| weechat | weechat_sharedir | répertoire "share" de WeeChat | -
| weechat | weechat_site | site WeeChat | -
@@ -14,5 +14,7 @@
| weechat | focus_info | obtenir l'information de focus | "x" : coordonnée x (chaîne avec un entier >= 0), "y" : coordonnée y (chaîne avec un entier >= 0) | voir la fonction hook_focus dans la Référence API extension
| weechat | secured_data | données sécurisées | - | données sécurisées : noms et valeurs (attention : les valeurs sont des données sensibles : il ne faut PAS les afficher/logger)
|===
// end::infos_hashtable[]
+96 -68
View File
@@ -161,7 +161,7 @@ nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
Pour se déconnecter du serveur ou stopper toute tentative de connexion, utilisez la commande /disconnect.
Exemples :
/connect freenode
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
@@ -219,6 +219,7 @@ Exemples :
----
/dehalfop <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : retirer le statut de demi-opérateur de tout le monde sur le canal excepté vous-même
@@ -300,10 +301,10 @@ Note : l'expression régulière peut commencer par "(?-i)" pour devenir sensibl
Exemples :
ignorer le pseudo "toto" partout :
/ignore add toto
ignorer le hôte "toto@domain.com" sur le serveur freenode :
/ignore add toto@domain.com freenode
ignorer le hôte "toto*@*.domain.com" sur freenode/#weechat :
/ignore add toto*@*.domain.com freenode #weechat
ignorer le hôte "toto@domain.com" sur le serveur libera :
/ignore add toto@domain.com libera
ignorer le hôte "toto*@*.domain.com" sur libera/#weechat :
/ignore add toto*@*.domain.com libera #weechat
----
[[command_irc_info]]
@@ -348,7 +349,7 @@ pseudo : pseudo
Exemples :
/join #weechat
/join #protectedchan,#weechat key
/join -server freenode #weechat
/join -server libera #weechat
/join -noswitch #weechat
----
@@ -360,7 +361,7 @@ Exemples :
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
----
[[command_irc_kickban]]
@@ -371,7 +372,7 @@ raison : raison (les variables spéciales $nick, $channel et $server sont rempl
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
Il est possible d'éjecter/bannir avec un masque, le pseudo sera extrait du masque et remplacé par "*".
@@ -401,7 +402,7 @@ masque_serveur : liste des serveurs correspondant au masque
----
[[command_irc_list]]
* `+list+`: lister les canaux et leur titre
* `+list+`: lister les canaux et leurs titres
----
/list [-server <serveur>] [-re <regex>] [<canal>[,<canal>...]] [<cible>]
@@ -551,10 +552,10 @@ Sans paramètre, cette commande affiche les notifications pour le serveur couran
Exemples :
notifier quand "toto" rejoint/quitte le serveur courant :
/notify add toto
notifier quand "toto" rejoint/quitte le serveur freenode :
/notify add toto freenode
notifier quand "toto" est absent ou de retour sur le serveur freenode :
/notify add toto freenode -away
notifier quand "toto" rejoint/quitte le serveur libera :
/notify add toto libera
notifier quand "toto" est absent ou de retour sur le serveur libera :
/notify add toto libera -away
----
[[command_irc_op]]
@@ -672,7 +673,7 @@ option : option supplémentaire, pour certains serveurs
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs)
----
[[command_irc_restart]]
@@ -774,16 +775,16 @@ nom_machine : nom ou adresse IP du serveur avec port en option (défaut : 6667
Exemples :
/server listfull
/server add freenode chat.freenode.net
/server add freenode chat.freenode.net/6697 -ssl -autoconnect
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy freenode freenode-test
/server rename freenode-test freenode2
/server reorder freenode2 freenode
/server del freenode
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:freenode
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
@@ -932,6 +933,7 @@ pseudo : pseudo
----
/voice <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : donner la voix à tout le monde sur le canal
@@ -1020,7 +1022,7 @@ Note : dans la commande, les variables spéciales sont remplacées :
$n-m : paramètres de 'n' à 'm'
$* : tous les paramètres
$~ : le dernier paramètre
$var : où "var" est une variable locale du tampon (voir /buffer localvar)
$var : où "var" est une variable locale du tampon (voir /buffer listvar)
exemples : $nick, $channel, $server, $plugin, $name
Exemples :
@@ -1113,7 +1115,9 @@ Exemples :
renumber <nombre1> [<nombre2> [<départ>]]
close [<n1>[-<n2>]|<nom>...]
notify [<niveau>]
localvar [<nombre>|<nom>]
listvar [<nombre>|<nom>]
setvar <nom> [<valeur>]
delvar <nom>
set <propriété> [<valeur>]
get <propriété>
<nombre>|<nom>
@@ -1137,7 +1141,9 @@ renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.l
message : pour les messages d'utilisateurs + highlights
all : pour tous les messages
reset : réinitialise à valeur par défaut (all)
localvar : afficher la liste des variables locales pour le tampon
listvar : afficher la liste des variables locales d'un tampon
setvar : modifier une variable locale du tampon courant
delvar : supprimer une variable locale du tampon courant
set : modifier une propriété du tampon courant
get : afficher une propriété du tampon courant
nombre : sauter au tampon qui a ce numéro, préfixe possible :
@@ -1295,12 +1301,12 @@ infolists : afficher des infos sur les infolists
* `+eval+`: évaluer une expression
----
/eval [-n|-s] [-d] <expression>
/eval [-n|-s] [-d [-d]] <expression>
[-n] [-d] -c <expression1> <opérateur> <expression2>
-n : afficher le résultat sans envoyer au tampon (mode debug)
-s : découper l'expression avant de l'évaluer (plusieurs commandes peuvent être séparées par des points-virgules)
-d : afficher la sortie de debug après l'évaluation
-d : afficher la sortie de debug après l'évaluation (avec deux -d : mode debug plus verbeux)
-c : évaluer comme une condition : utiliser les opérateurs et les parenthèses, retourner une valeur booléenne ("0" ou "1")
expression : expression à évaluer, les variables avec le format ${variable} sont remplacées (voir ci-dessous) ; plusieurs commandes peuvent être séparées par des points-virgules
opérateur : un opérateur logique ou de comparaison :
@@ -1335,39 +1341,45 @@ Pour forcer une comparaison de chaînes, vous pouvez ajouter des guillemets auto
"50" > "100" ==> 1
Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
1. une sous-chaîne évaluée (format : "eval:xxx")
2. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
3. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
4. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
1. la chaîne elle-même sans évaluation (format : "raw:xxx")
2. une sous-chaîne évaluée (format : "eval:xxx")
3. une condition évaluée (format : "eval_cond:xxx")
4. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
5. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
6. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
5. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
6. une chaîne répétée (format : "repeat:nombre,chaîne")
7. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
8. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
9. un modificateur (format : "modifier:nom,données,chaîne")
10. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
11. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
12. la date/heure courante (format : "date" ou "date:format")
13. une variable d'environnement (format : "env:XXX")
14. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
15. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
16. une option (format : "fichier.section.option")
17. une variable locale du tampon
18. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
7. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
8. une chaîne répétée (format : "repeat:nombre,chaîne")
9. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
10. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
11. un modificateur (format : "modifier:nom,données,chaîne")
12. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
13. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
14. la date/heure courante (format : "date" ou "date:format")
15. une variable d'environnement (format : "env:XXX")
16. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
17. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
18. une chaîne traduite (format : "translate:xxx")
19. une option (format : "fichier.section.option")
20. une variable locale du tampon
21. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
Le format du hdata peut être le suivant :
hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, par exemple :
${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
${buffer[my_pointer].full_name} : nom complet du tampon avec ce nom de pointeur (peut être utilisé dans les triggers)
Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".
Exemples (chaînes simples) :
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.freenode_password} ==> secret
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
@@ -1384,6 +1396,7 @@ Exemples (chaînes simples) :
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Extension
Exemples (conditions) :
/eval -n -c ${window.buffer.number} > 2 ==> 0
@@ -1406,6 +1419,7 @@ Exemples (conditions) :
enable|disable|toggle [<nom>|@]
add|addreplace <nom> <tampon>[,<tampon>...] <étiquettes> <regex>
rename <nom> <nouveau_nom>
recreate <nom>
del <nom>|-all
list : lister tous les filtres
@@ -1416,10 +1430,11 @@ Exemples (conditions) :
add : ajouter un filtre
addreplace : ajouter ou remplacer un filtre existant
rename : renommer un filtre
recreate : définir la ligne de commande utilisée pour modifier le filtre
del : supprimer un filtre
-all : supprimer tous les filtres
tampon : liste des tampons, séparés par des virgules, où le filtre est actif :
- il s'agit du nom complet incluant l'extension (exemple : "irc.freenode.#weechat" ou "irc.server.freenode")
- il s'agit du nom complet incluant l'extension (exemple : "irc.libera.#weechat" ou "irc.server.libera")
- "*" signifie tous les tampons
- un nom commençant par '!' est exclu
- le caractère joker "*" est autorisé
@@ -1454,11 +1469,11 @@ Exemples :
filtrer les pseudos afficher en rejoignant les canaux ou avec /names :
/filter add nicks * irc_366 *
filtrer le pseudo "toto" sur le canal IRC #weechat :
/filter add toto irc.freenode.#weechat nick_toto *
/filter add toto irc.libera.#weechat nick_toto *
filtrer les messages IRC join/action du pseudo "toto" :
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat :
/filter add sucks irc.freenode.#weechat * weechat sucks
/filter add sucks irc.libera.#weechat * weechat sucks
filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -1660,7 +1675,7 @@ Exemples :
-core : pas d'affichage sur le tampon core WeeChat
-current : pas d'affichage sur le tampon courant
-buffer : pas d'affichage sur le tampon spécifié
nom : nom complet du tampon (exemples : "irc.server.freenode", "irc.freenode.#weechat")
nom : nom complet du tampon (exemples : "irc.server.libera", "irc.libera.#weechat")
commande : commande à exécuter silencieusement (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
Si aucune cible n'est spécifiée (-core, -current ou -buffer), alors par défaut tous les tampons seront silencieux.
@@ -1671,7 +1686,7 @@ Exemples :
message au canal IRC courant :
/mute -current msg * bonjour !
message au canal #weechat :
/mute -buffer irc.freenode.#weechat msg #weechat bonjour !
/mute -buffer irc.libera.#weechat msg #weechat bonjour !
----
[[command_weechat_plugin]]
@@ -1739,7 +1754,7 @@ Exemples :
afficher un message sur le tampon core avec le préfixe "abc" :
/print -core abc\tLe message
afficher un message sur le canal #weechat :
/print -buffer irc.freenode.#weechat Message sur #weechat
/print -buffer irc.libera.#weechat Message sur #weechat
afficher un bonhomme de neige (U+2603) :
/print -escape \u2603
envoyer une alerte (BEL) :
@@ -1861,7 +1876,7 @@ Les touches sur le tampon des données sécurisées :
alt+v afficher/cacher les valeurs
Lorsqu'une phrase de chiffrement est utilisée (données chiffrées), elle est demandée au démarrage de WeeChat.
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade) ou de définir l'option sec.crypt.passphrase_file pour lire la phrase de chiffrement depuis un fichier (voir /help sec.crypt.passphrase_file).
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade) ou de définir l'option sec.crypt.passphrase_command pour lire la phrase de chiffrement depuis la sortie d'une commande externe comme un coffre-fort à mots de passe (voir /help sec.crypt.passphrase_command).
Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans :
- la commande /eval
@@ -1872,14 +1887,16 @@ Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisée
Exemples :
définir une phrase de chiffrement :
/secure passphrase ceci est ma phrase de chiffrement
chiffrer le mot de passe freenode SASL :
/secure set freenode motdepasse
/set irc.server.freenode.sasl_password "${sec.data.freenode}"
utiliser le programme "pass" pour lire la phrase de chiffrement au démarrage :
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
chiffrer le mot de passe libera SASL :
/secure set libera motdepasse
/set irc.server.libera.sasl_password "${sec.data.libera}"
chiffrer le mot de passe oftc pour nickserv :
/secure set oftc motdepasse
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias pour ghost du pseudo "pseudo" :
/alias add ghost /eval /msg -server freenode nickserv ghost pseudo ${sec.data.freenode}
/alias add ghost /eval /msg -server libera nickserv ghost pseudo ${sec.data.libera}
----
[[command_weechat_set]]
@@ -1966,7 +1983,7 @@ Avec l'option "-quit", le processus est légèrement différent :
5. quitter WeeChat
Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade
IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf).
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu du répertoire "~/.weechat".
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu des répertoires personnels de WeeChat (voir /debug dirs).
----
[[command_weechat_uptime]]
@@ -2151,6 +2168,7 @@ Les variables suivantes peuvent être utilisées dans ces options :
- ${hotlist} : la hotlist brute
- ${hotlist_priority} : "none", "low", "message", "private" ou "highlight"
- ${format_lag} : le lag pour un tampon de serveur IRC, vide s'il n'y a pas de lag (évaluation de l'option buflist.format.lag)
- ${format_tls_version}: indicateur de la version de TLS pour le serveur courant, vide pour les canaux (évaluation de l'option buflist.format.tls_version)
----
// end::buflist_commands[]
@@ -2257,14 +2275,14 @@ disable : désactiver le tube FIFO
toggle : activer/désactiver le tube FIFO
Le tube FIFO est utilisé comme contrôle à distance de WeeChat : vous pouvez envoyer des commandes ou du texte au tube FIFO depuis votre shell.
Par défaut le tube FIFO est dans ~/.weechat/weechat_fifo
Par défaut le tube FIFO se nomme weechat_fifo_xxx (où xxx est l'id du processus WeeChat) et situé dans le répertoire "runtime" de WeeChat (voir /debug dirs).
Le format attendu est l'un des suivants :
plugin.buffer *texte ou commande ici
*texte ou commande ici
Par exemple pour changer votre pseudo sur freenode :
echo 'irc.server.freenode */nick autrepseudo' >~/.weechat/weechat_fifo
Par exemple pour changer votre pseudo sur libera :
echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
Merci de lire le guide utilisateur pour plus d'information et des exemples.
@@ -2701,7 +2719,7 @@ Sans paramètre, cette commande liste les scripts chargés.
stop : fermer le socket serveur (les clients restent connectés)
nom : nom du relai (voir le format ci-dessous)
port : port utilisé pour le relai
chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat"), le contenu est évalué (voir /help eval)
chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; le chemin est évalué (voir la fonction string_eval_path_home dans la référence API extension)
raw : ouvrir le tampon avec les données brutes Relay
sslcertkey : définir le certificat/clé SSL en utilisant le chemin de l'option relay.network.ssl_cert_key
@@ -2720,10 +2738,10 @@ Le protocole "weechat" permet à une interface distante de se connecter sur le p
Sans paramètre, cette commande ouvre le tampon avec la liste des clients pour le relai.
Exemples :
proxy irc, pour le serveur "freenode" :
/relay add irc.freenode 8000
proxy irc, pour le serveur "freenode", avec SSL :
/relay add ssl.irc.freenode 8001
proxy irc, pour le serveur "libera" :
/relay add irc.libera 8000
proxy irc, pour le serveur "libera", avec SSL :
/relay add ssl.irc.libera 8001
proxy irc, pour tous les serveurs (le client choisira), avec SSL :
/relay add ssl.irc 8002
protocole weechat :
@@ -2737,7 +2755,7 @@ Exemples :
protocole weechat avec SSL, en utilisant IPv4 + IPv6 :
/relay add ipv4.ipv6.ssl.weechat 9001
protocole weechat avec un socket de domaine UNIX :
/relay add unix.weechat %h/relay_socket
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
@@ -2819,6 +2837,16 @@ Sur le tampon des scripts, les statuts pour chaque script sont :
| installé
script populaire
Dans la sortie de /script list, les statuts pour chaque script sont :
* ? i a H N
| | | | | |
| | | | | obsolète (nouvelle version disponible)
| | | | figé
| | | chargé auto
| | installé
| script inconnu (ne peut pas être téléchargé/mis à jour)
script populaire
Les touches sur le tampon des scripts :
alt+i installer le script
alt+r supprimer le script
@@ -2948,7 +2976,7 @@ listdefault : lister les triggers par défaut
modifier : nom(s) de modificateur (obligatoire)
line : type de tampon ("formatted", "free" ou "*"), liste de masques de tampons, étiquettes
print : tampon, étiquettes, message, suppression des couleurs (0/1)
command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, voir /help eval)
command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, "${tg_trigger_name}" est remplacé par le nom du trigger, voir /help eval)
command_run : commande(s) (obligatoire)
timer : intervalle (obligatoire), alignement sur la seconde, nombre max d'appels
config : nom(s) de l'option (obligatoire)
+115 -31
View File
@@ -16,8 +16,8 @@
** valeurs: sha224, sha256, sha384, sha512
** valeur par défaut: `+sha256+`
* [[option_sec.crypt.passphrase_file]] *sec.crypt.passphrase_file*
** description: pass:none[chemin vers un fichier contenant la phrase de chiffrement pour (dé)chiffrer les données sécurisées ; cette option est utilisée seulement lors de la lecture du fichier sec.conf ; seulement la première ligne du fichier est utilisée ; ce fichier est utilisé seulement si la variable d'environnement "WEECHAT_PASSPHRASE" n'est pas définie (la variable d'environnement a une priorité plus haute) ; note de sécurité : il est recommandé de garder ce fichier en lecture seulement par vous et de le stocker en dehors du "home" WeeChat (par exemple dans votre "home") ; exemple : "~/.weechat-passphrase"]
* [[option_sec.crypt.passphrase_command]] *sec.crypt.passphrase_command*
** description: pass:none[lire la phrase de chiffrement depuis la sortie de cette commande système (seule la première ligne est utilisée et elle ne doit contenir aucun autre caractère) ; cette option est utilisée seulement pour lire le fichier sec.conf et si la variable d'environnement "WEECHAT_PASSPHRASE" n'est pas définie (la variable d'environnement a une priorité plus haute) ; exemple avec password-store : "/usr/bin/pass show weechat/passphrase"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -846,6 +846,12 @@
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.hotlist_update_on_buffer_switch]] *weechat.look.hotlist_update_on_buffer_switch*
** description: pass:none[mettre à jour la hotlist lors du changement de tampon]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.input_cursor_scroll]] *weechat.look.input_cursor_scroll*
** description: pass:none[nombre de caractères affichés après la fin de la ligne de saisie lors d'un défilement pour afficher la fin de la ligne]
** type: entier
@@ -1140,6 +1146,12 @@
** valeurs: toute chaîne
** valeur par défaut: `+"- "+`
* [[option_weechat.look.read_marker_update_on_buffer_switch]] *weechat.look.read_marker_update_on_buffer_switch*
** description: pass:none[mettre à jour le marqueur de données non lues lors du changement de tampon]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.look.save_config_on_exit]] *weechat.look.save_config_on_exit*
** description: pass:none[sauvegarder la configuration en quittant]
** type: booléen
@@ -1248,11 +1260,17 @@
** valeurs: 1 .. 2147483647
** valeur par défaut: `+60+`
* [[option_weechat.network.gnutls_ca_file]] *weechat.network.gnutls_ca_file*
** description: pass:none[fichier contenant les autorités de certification ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
* [[option_weechat.network.gnutls_ca_system]] *weechat.network.gnutls_ca_system*
** description: pass:none[charger les certificats des autorités de certification système au démarrage ; cela peut être désactivée pour économiser de la mémoire, seulement si vous n'utilisez pas du tout de connexions SSL]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.network.gnutls_ca_user]] *weechat.network.gnutls_ca_user*
** description: pass:none[fichier(s) supplémentaire(s) avec des autorités de certification ; plusieurs fichiers doivent être séparés par ":" (chaque chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/etc/ssl/certs/ca-certificates.crt"+`
** valeur par défaut: `+""+`
* [[option_weechat.network.gnutls_handshake_timeout]] *weechat.network.gnutls_handshake_timeout*
** description: pass:none[délai d'attente maximum (en secondes) pour la poignée de main (handshake) gnutls]
@@ -1285,10 +1303,10 @@
** valeur par défaut: `+".so,.dll"+`
* [[option_weechat.plugin.path]] *weechat.plugin.path*
** description: pass:none[chemin de recherche des extensions ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** description: pass:none[chemin de recherche des extensions (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/plugins"+`
** valeur par défaut: `+"${weechat_data_dir}/plugins"+`
* [[option_weechat.plugin.save_config_on_unload]] *weechat.plugin.save_config_on_unload*
** description: pass:none[sauvegarder les fichiers de configuration lors du déchargement des extensions]
@@ -1296,14 +1314,44 @@
** valeurs: on, off
** valeur par défaut: `+on+`
* [[option_weechat.signal.sighup]] *weechat.signal.sighup*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"${if:${info:weechat_headless}?/reload:/quit -yes}"+`
* [[option_weechat.signal.sigquit]] *weechat.signal.sigquit*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/quit -yes"+`
* [[option_weechat.signal.sigterm]] *weechat.signal.sigterm*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"/quit -yes"+`
* [[option_weechat.signal.sigusr1]] *weechat.signal.sigusr1*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.signal.sigusr2]] *weechat.signal.sigusr2*
** description: pass:none[commande à exécuter lorsque le signal est reçu, plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.startup.command_after_plugins]] *weechat.startup.command_after_plugins*
** description: pass:none[commande exécutée quand WeeChat démarre, après le chargement des extensions (note : le contenu est évalué, voir /help eval)]
** description: pass:none[commande exécutée quand WeeChat démarre, après le chargement des extensions ; plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_weechat.startup.command_before_plugins]] *weechat.startup.command_before_plugins*
** description: pass:none[commande exécutée quand WeeChat démarre, avant le chargement des extensions (note : le contenu est évalué, voir /help eval)]
** description: pass:none[commande exécutée quand WeeChat démarre, avant le chargement des extensions ; plusieurs commandes peuvent être séparées par des point-virgules (note : les commandes sont évaluées, voir /help eval)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1409,10 +1457,10 @@
** valeur par défaut: `+""+`
* [[option_logger.file.path]] *logger.file.path*
** description: pass:none[chemin pour les fichiers de log WeeChat ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; les caractères de formatage de date sont autorisés (voir man strftime) (note : le contenu est évalué, voir /help eval)]
** description: pass:none[chemin pour les fichiers de log WeeChat ; les caractères de formatage de date sont autorisés (voir man strftime) (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/logs/"+`
** valeur par défaut: `+"${weechat_data_dir}/logs"+`
* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** description: pass:none[caractère de remplacement dans le nom de fichier construit avec le masque (comme le délimiteur de répertoire)]
@@ -1704,6 +1752,12 @@
** valeurs: toute chaîne
** valeur par défaut: `+"${color:green}${number}${if:${number_displayed}?.: }"+`
* [[option_buflist.format.tls_version]] *buflist.format.tls_version*
** description: pass:none[format pour la version de TLS sur un serveur IRC (note : le contenu est évalué, voir /help buflist)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+" ${color:default}(${if:${tls_version}==TLS1.3?${color:green}:${if:${tls_version}==TLS1.2?${color:yellow}:${color:red}}}${translate:${tls_version}}${color:default})"+`
* [[option_buflist.look.add_newline]] *buflist.look.add_newline*
** description: pass:none[ajouter une nouvelle ligne entre les tampons affichés, de sorte que chaque tampon est affiché sur une ligne séparée (recommandé) ; si désactivé, les nouvelles lignes doivent être ajoutées dans les formats avec "${\n}", et les actions de souris ne sont plus possibles]
** type: booléen
@@ -1765,10 +1819,16 @@
** valeur par défaut: `+""+`
* [[option_buflist.look.sort]] *buflist.look.sort*
** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, seul le pointeur vers bar_item peut être utilisé, par exemple "bar_item.name")]
** description: pass:none[liste de champs séparés par des virgules pour trier les tampons ; chaque champ est une variable hdata du tampon ("var"), une variable hdata du serveur IRC ("irc_server.var") ou une variable hdata du canal IRC ("irc_channel.var") ; le caractère "-" peut être utilisé pour inverser l'ordre, le caractère "~" peut être utilisé pour effectuer une comparaison insensible à la casse ; exemple : "-~short_name" pour un tri inverse insensible à la casse sur le nom court du tampon (note : le contenu est évalué, avant d'être découpé en champs, mais à cet instant "bar_item" est la seule variable qui peut être utilisée, pour distinguer les différents objets de barre buflist, par exemple "${bar_item.name}")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"number,-active"+`
* [[option_buflist.look.use_items]] *buflist.look.use_items*
** description: pass:none[nombre d'objets de barre buflist qui peuvent être utilisés ; les objets de barre sont : "buflist", "buflist2", "buflist3" ; attention, utiliser plus d'un objet de barre ralentit l'affichage de la liste des tampons]
** type: entier
** valeurs: 1 .. 3
** valeur par défaut: `+1+`
// end::buflist_options[]
// tag::fifo_options[]
@@ -1779,10 +1839,10 @@
** valeur par défaut: `+on+`
* [[option_fifo.file.path]] *fifo.file.path*
** description: pass:none[chemin pour le tube FIFO ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") ; le PID de WeeChat peut être utilisé dans le chemin avec ${info:pid} (note : le contenu est évalué, voir /help eval)]
** description: pass:none[chemin pour le tube FIFO ; le PID de WeeChat peut être utilisé dans le chemin avec ${info:pid} (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/weechat_fifo"+`
** valeur par défaut: `+"${weechat_runtime_dir}/weechat_fifo_${info:pid}"+`
// end::fifo_options[]
// tag::xfer_options[]
@@ -1853,7 +1913,7 @@
** valeur par défaut: `+off+`
* [[option_xfer.file.auto_accept_nicks]] *xfer.file.auto_accept_nicks*
** description: pass:none[liste de pseudos (séparés par des virgules) pour lesquels les demandes d'envoi de fichiers et de discussion sont automatiquement acceptées ; le format est "serveur.pseudo" (pour un serveur spécifique) ou "pseudo" (pour tous les serveurs) ; exemple : "freenode.FlashCode,andrew"]
** description: pass:none[liste de pseudos (séparés par des virgules) pour lesquels les demandes d'envoi de fichiers et de discussion sont automatiquement acceptées ; le format est "serveur.pseudo" (pour un serveur spécifique) ou "pseudo" (pour tous les serveurs) ; exemple : "libera.FlashCode,andrew"]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -1883,10 +1943,10 @@
** valeur par défaut: `+on+`
* [[option_xfer.file.download_path]] *xfer.file.download_path*
** description: pass:none[chemin où écrire les fichiers reçus : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** description: pass:none[chemin où écrire les fichiers reçus (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/xfer"+`
** valeur par défaut: `+"${weechat_data_dir}/xfer"+`
* [[option_xfer.file.download_temporary_suffix]] *xfer.file.download_temporary_suffix*
** description: pass:none[suffixe de fichier temporaire utilisé pendant le transfert pour un fichier reçu, il est supprimé après un transfert réussi ; si chaîne vide, aucun suffixe de fichier n'est utilisé pendant le transfert]
@@ -1895,7 +1955,7 @@
** valeur par défaut: `+".part"+`
* [[option_xfer.file.upload_path]] *xfer.file.upload_path*
** description: pass:none[chemin pour lire les fichiers envoyés (quand aucun chemin n'est spécifié par l'utilisateur) : "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** description: pass:none[chemin lire les fichiers à envoyer (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"~"+`
@@ -2004,6 +2064,24 @@
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+default+`
* [[option_irc.color.item_tls_version_deprecated]] *irc.color.item_tls_version_deprecated*
** description: pass:none[couleur pour les versions obsolètes de TLS dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+yellow+`
* [[option_irc.color.item_tls_version_insecure]] *irc.color.item_tls_version_insecure*
** description: pass:none[couleur pour les versions non sécurisées de TLS dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+red+`
* [[option_irc.color.item_tls_version_ok]] *irc.color.item_tls_version_ok*
** description: pass:none[couleur pour la version de TLS la plus haute dans l'objet de barre "tls_version"]
** type: couleur
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné
** valeur par défaut: `+green+`
* [[option_irc.color.message_account]] *irc.color.message_account*
** description: pass:none[couleur pour le texte dans les messages account]
** type: couleur
@@ -2599,7 +2677,7 @@
** valeur par défaut: `+message+`
* [[option_irc.server_default.command]] *irc.server_default.command*
** description: pass:none[commande(s) à exécuter après la connexion au serveur et avant le "join" automatique des canaux (plusieurs commandes peuvent être séparées par ";", utilisez "\;" pour un point-virgule, les variables spéciales $nick, $channel et $server sont remplacées par leur valeur) (note : le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)]
** description: pass:none[commande(s) à exécuter après la connexion au serveur et avant le "join" automatique des canaux (plusieurs commandes peuvent être séparées par ";", utilisez "\;" pour un point-virgule, les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs) (note : les commandes sont évaluées, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -2616,6 +2694,12 @@
** valeurs: 1 .. 3600
** valeur par défaut: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** description: pass:none[préfixes de types de canaux à utiliser si le serveur ne les envoie pas dans le message 005 (par défaut "#&")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** description: pass:none[utiliser le protocole IPv6 pour la communication avec le serveur (essayer IPv6 puis repli sur l'IPv4) ; si désactivé, seulement l'IPv4 est utilisé]
** type: booléen
@@ -2629,19 +2713,19 @@
** valeur par défaut: `+""+`
* [[option_irc.server_default.msg_kick]] *irc.server_default.msg_kick*
** description: pass:none[message par défaut pour l'éjection utilisé par les commandes "/kick" et "/kickban" (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur)]
** description: pass:none[message par défaut pour l'éjection utilisé par les commandes "/kick" et "/kickban" (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_irc.server_default.msg_part]] *irc.server_default.msg_part*
** description: pass:none[message par défaut pour le part (en quittant un canal) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** description: pass:none[message par défaut pour le part (en quittant un canal) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeurs ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"WeeChat ${info:version}"+`
* [[option_irc.server_default.msg_quit]] *irc.server_default.msg_quit*
** description: pass:none[message de fin par défaut (lors de la déconnexion du serveur) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leur valeur ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** description: pass:none[message de fin par défaut (lors de la déconnexion du serveur) (note : le contenu est évalué, voir /help eval ; les variables spéciales ${nick}, ${channel} et ${server} sont remplacées par leurs valeurs ; "%v" est remplacé par la version de WeeChat s'il n'y a pas de ${...} dans la chaîne)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"WeeChat ${info:version}"+`
@@ -2689,15 +2773,15 @@
** valeur par défaut: `+continue+`
* [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
** description: pass:none[fichier avec la clé privée ECC pour le mécanisme "ecdsa-nist256p-challenge" ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** description: pass:none[fichier avec la clé privée ECC pour le mécanisme "ecdsa-nist256p-challenge" (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
* [[option_irc.server_default.sasl_mechanism]] *irc.server_default.sasl_mechanism*
** description: pass:none[mécanisme pour l'authentification SASL : "plain" pour un mot de passe en clair, "ecdsa-nist256p-challenge" pour une authentification par challenge avec clé, "external" pour une authentification en utilisant un certificat SSL côté client, "dh-blowfish" pour un mot de passe chiffré avec blowfish (non sûr, non recommandé), "dh-aes" pour un mot de passe chiffré avec AES (non sûr, non recommandé)]
** description: pass:none[mécanisme pour l'authentification SASL : "plain" pour un mot de passe en clair, "scram-sha-1" pour une authentification SCRAM avec algorithme de hachage SHA-1, "scram-sha-256" pour une authentification SCRAM avec algorithme de hachage SHA-256, "scram-sha-512" pour une authentification SCRAM avec algorithme de hachage SHA-512, "ecdsa-nist256p-challenge" pour une authentification par challenge avec clé, "external" pour une authentification en utilisant un certificat SSL côté client, "dh-blowfish" pour un mot de passe chiffré avec blowfish (non sûr, non recommandé), "dh-aes" pour un mot de passe chiffré avec AES (non sûr, non recommandé)]
** type: entier
** valeurs: plain, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeurs: plain, scram-sha-1, scram-sha-256, scram-sha-512, ecdsa-nist256p-challenge, external, dh-blowfish, dh-aes
** valeur par défaut: `+plain+`
* [[option_irc.server_default.sasl_password]] *irc.server_default.sasl_password*
@@ -2731,7 +2815,7 @@
** valeur par défaut: `+off+`
* [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
** description: pass:none[fichier de certificat SSL utilisé pour identifier automatiquement votre pseudo ("%h" sera remplacé par le répertoire de base WeeChat, par défaut : "~/.weechat")]
** description: pass:none[fichier de certificat SSL utilisé pour identifier automatiquement votre pseudo (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+""+`
@@ -2955,10 +3039,10 @@
** valeur par défaut: `+100000+`
* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
** description: pass:none[fichier avec le certificat et la clé privée SSL (pour servir les clients avec SSL)]
** description: pass:none[fichier avec le certificat et la clé privée SSL (pour servir les clients avec SSL) (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/ssl/relay.pem"+`
** valeur par défaut: `+"${weechat_config_dir}/ssl/relay.pem"+`
* [[option_relay.network.ssl_priorities]] *relay.network.ssl_priorities*
** description: pass:none[chaîne avec les priorités pour gnutls (pour la syntaxe, voir la documentation de la fonction gnutls_priority_init du manuel gnutls, les chaînes courantes sont : "PERFORMANCE", "NORMAL", "SECURE128", "SECURE256", "EXPORT", "NONE")]
@@ -3261,7 +3345,7 @@
** valeur par défaut: `+lightmagenta+`
* [[option_script.look.columns]] *script.look.columns*
** description: pass:none[format des colonnes affichées dans le tampon des scripts : les identifiants de colonne suivants sont remplacés par leur valeur : %a=auteur, %d=description, %D=date d'ajout, %e=extension, %l=langage, %L=licence, %n=nom avec extension, %N=nom, %r=dépendances, %s=statuts, %t=étiquettes, %u=date de mise à jour, %v=version, %V=version chargée, %w=min_weechat, %W=max_weechat]
** description: pass:none[format des colonnes affichées dans le tampon des scripts : les identifiants de colonne suivants sont remplacés par leurs valeurs : %a=auteur, %d=description, %D=date d'ajout, %e=extension, %l=langage, %L=licence, %n=nom avec extension, %N=nom, %r=dépendances, %s=statuts, %t=étiquettes, %u=date de mise à jour, %v=version, %V=version chargée, %w=min_weechat, %W=max_weechat]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%s %n %V %v %u | %d | %t"+`
@@ -3339,10 +3423,10 @@
** valeur par défaut: `+""+`
* [[option_script.scripts.path]] *script.scripts.path*
** description: pass:none[répertoire du cache local pour les scripts ; "%h" au début de la chaîne est remplacé par le répertoire de base WeeChat (par défaut : "~/.weechat") (note : le contenu est évalué, voir /help eval)]
** description: pass:none[répertoire du cache local pour les scripts (le chemin est évalué, voir la fonction string_eval_path_home dans la référence API extension)]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"%h/script"+`
** valeur par défaut: `+"${weechat_cache_dir}/script"+`
* [[option_script.scripts.url]] *script.scripts.url*
** description: pass:none[URL pour le fichier avec la liste des scripts]
+4 -4
View File
@@ -15,10 +15,10 @@
*weechat-headless*, non compatible avec l'option "--daemon").
*-d*, *--dir* _<répertoire>_::
Définir le répertoire comme étant la base de WeeChat
(utilisé pour les fichiers de configuration, logs, extensions
et scripts de l'utilisateur), la valeur par défaut est "~/.weechat"
(note : le répertoire est créé s'il n'est pas trouvé par WeeChat).
Forcer un unique répertoire pour tous les fichiers WeeChat (le répertoire
est créé s'il n'est pas trouvé).
Quatre répertoires peuvent être donnés, séparés par ":" (dans cet ordre :
config, data, cache, runtime).
Si cette option n'est pas donnée, la variable d'environnement WEECHAT_HOME
est utilisée (si non vide).
+27 -27
View File
@@ -10,7 +10,7 @@ temporaire avec une URL, comme ceci :
Pour rejoindre le canal IRC de support WeeChat avec le pseudo "monpseudo" :
irc://monpseudo@chat.freenode.net/#weechat
irc://monpseudo@irc.libera.chat/#weechat
Les adresses IPv6 peuvent être entourées par des crochets pour ajouter un port
après, par exemple :
@@ -19,79 +19,79 @@ après, par exemple :
// end::plugin_options[]
// tag::files[]
$HOME/.weechat/weechat.conf::
$HOME/.config/weechat/weechat.conf::
fichier de configuration principal de WeeChat
$HOME/.weechat/plugins.conf::
$HOME/.config/weechat/plugins.conf::
fichier de configuration des extensions
$HOME/.weechat/sec.conf::
$HOME/.config/weechat/sec.conf::
fichier de configuration avec les données sécurisées
$HOME/.weechat/alias.conf::
$HOME/.config/weechat/alias.conf::
fichier de configuration pour l'extension _alias_
$HOME/.weechat/buflist.conf::
$HOME/.config/weechat/buflist.conf::
fichier de configuration pour l'extension _buflist_
$HOME/.weechat/charset.conf::
$HOME/.config/weechat/charset.conf::
fichier de configuration pour l'extension _charset_
$HOME/.weechat/exec.conf::
$HOME/.config/weechat/exec.conf::
fichier de configuration pour l'extension _exec_
$HOME/.weechat/fifo.conf::
$HOME/.config/weechat/fifo.conf::
fichier de configuration pour l'extension _fifo_
$HOME/.weechat/fset.conf::
$HOME/.config/weechat/fset.conf::
fichier de configuration pour l'extension _fset_
$HOME/.weechat/guile.conf::
$HOME/.config/weechat/guile.conf::
fichier de configuration pour l'extension _guile_
$HOME/.weechat/irc.conf::
$HOME/.config/weechat/irc.conf::
fichier de configuration pour l'extension _irc_
$HOME/.weechat/javascript.conf::
$HOME/.config/weechat/javascript.conf::
fichier de configuration pour l'extension _javascript_
$HOME/.weechat/logger.conf::
$HOME/.config/weechat/logger.conf::
fichier de configuration pour l'extension _logger_
$HOME/.weechat/lua.conf::
$HOME/.config/weechat/lua.conf::
fichier de configuration pour l'extension _lua_
$HOME/.weechat/perl.conf::
$HOME/.config/weechat/perl.conf::
fichier de configuration pour l'extension _perl_
$HOME/.weechat/php.conf::
$HOME/.config/weechat/php.conf::
fichier de configuration pour l'extension _php_
$HOME/.weechat/python.conf::
$HOME/.config/weechat/python.conf::
fichier de configuration pour l'extension _python_
$HOME/.weechat/relay.conf::
$HOME/.config/weechat/relay.conf::
fichier de configuration pour l'extension _relay_
$HOME/.weechat/ruby.conf::
$HOME/.config/weechat/ruby.conf::
fichier de configuration pour l'extension _ruby_
$HOME/.weechat/script.conf::
$HOME/.config/weechat/script.conf::
fichier de configuration pour l'extension _script_
$HOME/.weechat/spell.conf::
$HOME/.config/weechat/spell.conf::
fichier de configuration pour l'extension _spell_
$HOME/.weechat/tcl.conf::
$HOME/.config/weechat/tcl.conf::
fichier de configuration pour l'extension _tcl_
$HOME/.weechat/trigger.conf::
$HOME/.config/weechat/trigger.conf::
fichier de configuration pour l'extension _trigger_
$HOME/.weechat/xfer.conf::
$HOME/.config/weechat/xfer.conf::
fichier de configuration pour l'extension _xfer_
$HOME/.weechat/weechat.log::
$HOME/.local/share/weechat/weechat.log::
fichier de log de WeeChat
// end::files[]
@@ -99,7 +99,7 @@ $HOME/.weechat/weechat.log::
WeeChat est écrit par Sébastien Helleu et des contributeurs (la liste complète
est dans le fichier AUTHORS.adoc).
Copyright (C) 2003-2020 {author}
Copyright (C) 2003-2021 {author}
WeeChat est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier
sous les termes de la GNU General Public License telle que publiée par la
+1 -1
View File
@@ -25,7 +25,7 @@ WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre,
rapide et léger, conçu pour différents systèmes d'exploitation.
Il est hautement paramétrable et extensible avec des scripts.
La commande *weechat-headless* lance WeeChat en mode « headless » (sans interface).
La commande *weechat-headless* lance WeeChat en mode « headless » (sans interface).
Elle peut être utilisée pour des tests ou lancer WeeChat en daemon
avec l'option "--daemon".
+18 -18
View File
@@ -68,7 +68,7 @@ Les répertoires principaux de WeeChat sont :
|       hook/ | Fonctions sur les "hooks".
|    gui/ | Fonctions pour les tampons, fenêtres, ... (utilisées par toutes les interfaces).
|       curses/ | Interface Curses.
|          headless/ | Mode sans interface (« headless »).
|          headless/ | Mode sans interface (« headless »).
|          normal/ | Interface Curses.
|    plugins/ | API extension/script.
|       alias/ | Extension Alias.
@@ -100,6 +100,7 @@ Les répertoires principaux de WeeChat sont :
|       gui/ | Tests unitaires pour les fonctions de l'interface.
|       plugins/ | Tests unitaires pour les extensions.
|          irc/ | Tests unitaires pour l'extension IRC.
|          trigger/ | Tests unitaires pour l'extension trigger.
| doc/ | Documentation.
| po/ | Fichiers de traductions (gettext).
| debian/ | Empaquetage Debian.
@@ -129,6 +130,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    wee-config.c | Options de configuration du cœur de WeeChat (fichier weechat.conf).
|    wee-crypto.c | Fonctions de cryptographie.
|    wee-debug.c | Quelques fonctions de debug.
|    wee-dir.c | Fonctions sur les répertoires/fichiers.
|    wee-eval.c | Évaluation d'expressions avec des références à des variables internes.
|    wee-hashtable.c | Tables de hachage.
|    wee-hdata.c | Hdata (accès direct aux données en utilisant des tables de hachage).
@@ -142,6 +144,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|    wee-secure.c | Fonctions pour les données sécurisées.
|    wee-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).
|    wee-signal.c | Fonctions sur les signaux.
|    wee-string.c | Fonctions sur les chaînes de caractères.
|    wee-upgrade-file.c | Système de mise à jour interne.
|    wee-upgrade.c | Mise à jour du cœur de WeeChat (tampons, lignes, historique, ...).
@@ -199,7 +202,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|       gui-curses-mouse.c | Souris.
|       gui-curses-term.c | Fonctions pour le terminal.
|       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.
|          ncurses-fake.c | Fausse bibliothèque ncurses.
|       normal/ | Interface Curses.
@@ -396,13 +399,16 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|          test-core-arraylist.cpp | Tests : listes avec tableau (« arraylists »).
|          test-core-calc.cpp | Tests : calcul d'expressions.
|          test-core-crypto.cpp | Tests : fonctions cryptographiques.
|          test-core-dir.cpp | Tests : répertoires/fichiers.
|          test-core-eval.cpp | Tests : évaluation d'expressions.
|          test-core-hashtble.cpp | Tests : tables de hachage.
|          test-core-hdata.cpp | Tests : hdata.
|          test-core-hook.cpp | Tests : hooks.
|          test-core-infolist.cpp | Tests : infolists.
|          test-core-list.cpp | Tests : listes.
|          test-core-network.cpp | Tests : fonctions réseau.
|          test-core-secure.cpp | Tests : données sécurisées.
|          test-core-signal.cpp | Tests : signaux.
|          test-core-string.cpp | Tests : chaînes.
|          test-core-url.cpp | Tests : URLs.
|          test-core-utf8.cpp | Tests : UTF-8.
@@ -422,6 +428,8 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|             test-irc-nick.cpp | Tests : pseudos IRC.
|             test-irc-protocol.cpp | Tests : protocole IRC.
|             test-irc-server.cpp | Tests : serveur IRC.
|          trigger/ | Racine des tests unitaires pour l'extension trigger.
|             test-trigger.cpp | Tests : triggers.
|          relay/ | Racine des tests unitaires pour l'extension Relay.
|             test-relay-auth.cpp | Tests : authentification des clients.
|===
@@ -496,7 +504,7 @@ Exemple en C :
/*
* weechat.c - core functions for WeeChat
*
* Copyright (C) 2020 Your Name <your@email.com>
* Copyright (C) 2021 Your Name <your@email.com>
*
* This file is part of WeeChat, the extensible chat client.
*
@@ -1108,18 +1116,13 @@ Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur
branche master, 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 (pour fermer un bug GitHub) :
Le format du message de commit est le suivant (avec fermeture automatique
du bug GitHub) :
----
component: fix a problem (closes #123)
----
Pour un bug Savannah :
----
component: fix a problem (bug #12345)
----
Où _component_ est :
* pour le cœur WeeChat : _core_ (les fichiers dans le répertoire racine, _po/_
@@ -1132,20 +1135,17 @@ Quelques règles à suivre :
* Utilisez seulement l'anglais.
* Utilisez des verbes à l'infinitif.
* Si le commit est relatif au tracker, écrivez-le entre parenthèses après le
message, avec ce format :
** GitHub : closes #123
** Savannah : bug #12345, task #12345, patch #12345
* Si le commit est relatif à un bug GitHub, écrivez-le entre parenthèses après
le message, avec ce format : `(issue #123)` ou `(closes #123)` pour le fermer.
Exemples de messages de commit :
----
irc: add command /unquiet (closes #36)
core: add callback "nickcmp" for nick comparison in buffers
irc: fix freeze when reading on socket with SSL enabled (bug #35097)
ruby: add detection of ruby version 1.9.3 in CMake
core: update Japanese translations
irc: add command /unquiet (closes #36)
python: fix crash when unloading a script without pointer to interpreter
core: update Japanese translations (patch #7783)
ruby: add detection of ruby version 1.9.3 in CMake
----
[[translations]]
+67 -35
View File
@@ -237,6 +237,34 @@ Par exemple pour utiliser kbd:[F1], kbd:[F2], kbd:[Alt+F1] et kbd:[Alt+F2] :
Les touches "meta-OP" et "meta-OQ" peuvent être différentes dans votre terminal.
Pour trouver le code de la touche appuyez sur kbd:[Alt+k] puis la touche.
[[customize_buflist]]
=== Comment puis-je configurer la liste des tampons, comme la couleur du tampon actif ?
Vous pouvez afficher toutes les options buflist avec la commande :
----
/fset buflist
----
Le fond du tampon actif est bleu par défaut, vous pouvez le changer comme ceci,
par exemple en rouge (`red`) :
----
/set buflist.format.buffer_current "${color:,red}${format_buffer}"
----
[NOTE]
Il y a une virgule avant le nom de la couleur "red" parce qu'elle est utilisée
comme couleur de fond et non de texte. +
Vous pouvez aussi utiliser une couleur numérique à la place de `red`, comme
`237` pour du gris foncé.
L'extension buflist met à disposition beaucoup d'options que vous pouvez changer,
merci de lire l'aide sur chaque option.
Il y a aussi une page wiki avec des examples avancés de configuration buflist :
https://github.com/weechat/weechat/wiki/buflist
[[customize_prefix]]
=== Comment puis-je réduire la longueur des pseudos ou supprimer l'alignement des pseudos dans la zone de discussion ?
@@ -722,8 +750,9 @@ kbd:[Alt] au lieu de kbd:[Shift]).
=== J'ai des problèmes pour me connecter au serveur avec SSL, que puis-je faire ?
Si vous utilisez macOS, vous devez installer `openssl` depuis Homebrew.
Un fichier CA sera installé avec le le trousseau système. Vous pouvez alors
définie le chemin vers les certificats sous WeeChat :
Un fichier CA sera installé avec le le trousseau système.
Avec WeeChat ≤ 3.1, vous pouvez définir le chemin vers les certificats système :
----
/set weechat.network.gnutls_ca_file "/usr/local/etc/openssl/cert.pem"
@@ -761,11 +790,11 @@ seulement), remplacez "xxx" par le nom de votre serveur :
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
----
[[irc_ssl_freenode]]
=== Comment puis-je me connecter à freenode avec SSL ?
[[irc_ssl_libera]]
=== Comment puis-je me connecter à libera avec SSL ?
Positionnez l'option _weechat.network.gnutls_ca_file_ avec le fichier des
certificats :
Avec WeeChat ≤ 3.1, positionnez l'option _weechat.network.gnutls_ca_file_ avec
le fichier des certificats :
----
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
@@ -785,9 +814,9 @@ Vérifiez que vous avez bien ce fichier (fourni généralement par le paquet
Configurez le port du serveur, SSL, puis connectez-vous :
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/connect freenode
/set irc.server.libera.addresses "irc.libera.chat/6697"
/set irc.server.libera.ssl on
/connect libera
----
[[irc_oauth]]
@@ -812,25 +841,25 @@ Si le serveur supporte SASL, vous devriez l'utiliser au lieu d'envoyer une
commande pour l'authentification avec nickserv, par exemple :
----
/set irc.server.freenode.sasl_username "mynick"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "mynick"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Si le serveur ne supporte pas SASL, vous pouvez ajouter un délai (entre la
commande et le join des canaux) :
----
/set irc.server.freenode.command_delay 5
/set irc.server.libera.command_delay 5
----
[[edit_autojoin]]
=== Comment puis-je ajouter/supprimer des canaux de l'option autojoin ?
Vous pouvez utiliser la commande `/set` pour éditer la liste des canaux de
l'autojoin, par exemple pour le serveur freenode :
l'autojoin, par exemple pour le serveur libera :
----
/set irc.server.freenode.autojoin [TAB]
/set irc.server.libera.autojoin [TAB]
----
[NOTE]
@@ -1010,16 +1039,16 @@ du script _buffer_autoset.py_ :
----
Par exemple, pour désactiver de manière permanente les highlights de "mike" sur
#weechat sur le serveur IRC freenode :
#weechat sur le serveur IRC libera :
----
/buffer_autoset add irc.freenode.#weechat hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera.#weechat hotlist_max_level_nicks_add mike:2
----
Pour l'appliquer à l'ensemble du serveur freenode :
Pour l'appliquer à l'ensemble du serveur libera :
----
/buffer_autoset add irc.freenode hotlist_max_level_nicks_add mike:2
/buffer_autoset add irc.libera hotlist_max_level_nicks_add mike:2
----
Pour plus d'exemples, voir `+/help buffer_autoset+`.
@@ -1058,16 +1087,18 @@ Les scripts ne sont pas compatibles avec d'autres clients IRC.
[[scripts_update]]
=== La commande "/script update" ne peut pas lire les scripts, comment corriger ça ?
Consultez d'abord les questions à propos des connexions SSL dans cette FAQ
(en particulier l'option _weechat.network.gnutls_ca_file_).
Consultez d'abord les questions à propos des connexions SSL dans cette FAQ.
Si cela ne fonctionne toujours pas, essayez de supprimer manuellement le fichier
avec les scripts (dans votre shell) :
----
$ rm ~/.weechat/script/plugins.xml.gz
$ rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
Avec WeeChat ≤ 3.1, le chemin devrait être : _~/.weechat/script/plugins.xml.gz_.
Et mettez à jour les scripts à nouveau dans WeeChat :
----
@@ -1088,12 +1119,12 @@ vous-même pour obtenir les mises à jour) :
* dans votre shell, avec curl installé :
----
$ cd ~/.weechat/script
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
----
[[spell_dictionaries]]
=== J'ai installé des dictionnaires aspell sur mon système, comment les utiliser sans redémarrer WeeChat ?
=== J'ai installé des dictionnaires aspell sur mon système, comment les utiliser sans redémarrer WeeChat ?
Vous devez recharger l'extension spell :
@@ -1142,8 +1173,8 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
spell, xfer (utilisé pour les DCC).
Voir `/help weechat.plugin.autoload`.
* Charger uniquement les scripts dont vous avez vraiment besoin.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : affecter une
chaîne vide pour l'option _weechat.network.gnutls_ca_file_.
* Ne pas charger les certificats si SSL n'est *PAS* utilisé : désactiver
l'option _weechat.network.gnutls_ca_system_.
* Réduire la valeur de l'option _weechat.history.max_buffer_lines_number_ ou
affecter une valeur à l'option _weechat.history.max_buffer_lines_minutes_.
* Réduire la valeur de l'option _weechat.history.max_commands_.
@@ -1202,22 +1233,22 @@ Par exemple :
----
/secure passphrase xxxxxxxxxx
/secure set freenode_username username
/secure set freenode_password xxxxxxxx
/set irc.server.freenode.sasl_username "${sec.data.freenode_username}"
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/secure set libera_username username
/secure set libera_password xxxxxxxx
/set irc.server.libera.sasl_username "${sec.data.libera_username}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
[[sharing_config_files]]
=== Je souhaite partager ma configuration de WeeChat, quels fichiers dois-je partager et que dois-je garder privé ?
=== Je souhaite partager ma configuration de WeeChat, quels fichiers dois-je partager et que dois-je garder privé ?
Vous pouvez partager les fichiers _~/.weechat/*.conf_ sauf le fichier
Vous pouvez partager les fichiers de configuration _*.conf_ sauf le fichier
_sec.conf_ qui contient vos mots de passes chiffrés avec votre phrase
de chiffrement.
Quelques autres fichiers comme _irc.conf_ peuvent contenir des informations
sensibles comme les mots de passes des serveurs/canaux (s'ils ne sont pas
stockés dans _sec.conf_ avec la commande `/secure`).
Quelques autres fichiers peuvent contenir des informations sensibles comme
des mots de passes (s'ils ne sont pas stockés dans _sec.conf_ avec la commande
`/secure`).
Voir le link:weechat_user.fr.html#files_and_directories[Guide utilisateur / Fichiers et répertoires]
pour plus d'informations sur les fichiers de configuration.
@@ -1253,7 +1284,8 @@ $ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
[[supported_os]]
=== Quelle est la liste des plates-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ?
La liste complète est sur cette page : https://weechat.org/download
WeeChat tourne bien sur la plupart des distributions Linux/BSD, GNU/Hurd, Mac OS
et Windows (Cygwin et Windows Subsystem for Linux).
Nous faisons le maximum pour supporter le plus de plates-formes possible.
Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pour y
File diff suppressed because it is too large Load Diff
+21 -28
View File
@@ -110,12 +110,12 @@ devriez voir "irc" et d'autres extensions dans cette liste.
Vous pouvez ajouter un serveur IRC avec la commande `/server`, par exemple :
----
/server add freenode chat.freenode.net
/server add libera irc.libera.chat/6697 -ssl
----
Dans cette commande, `freenode` est le nom interne du serveur utilisé par
WeeChat : vous pourrez vous connecter avec `/connect freenode` et les options
du serveur sont _irc.server.freenode.xxx_.
Dans cette commande, `libera` est le nom interne du serveur utilisé par
WeeChat : vous pourrez vous connecter avec `/connect libera` et les options
du serveur sont _irc.server.libera.xxx_.
Comme d'habitude, de l'aide est disponible si vous êtes perdus :
@@ -135,38 +135,31 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut
("irc.server_default.xxx").
Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
vous pouvez les écraser pour le serveur freenode avec la commande suivante :
vous pouvez les écraser pour le serveur libera avec la commande suivante :
----
/set irc.server.freenode.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
/set irc.server.libera.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
----
Pour modifier le nom d'utilisateur et nom réel :
----
/set irc.server.freenode.username "Mon nom d'utilisateur"
/set irc.server.freenode.realname "Mon nom réel"
/set irc.server.libera.username "Mon nom d'utilisateur"
/set irc.server.libera.realname "Mon nom réel"
----
Pour activer la connexion automatique au serveur lors du démarrage :
----
/set irc.server.freenode.autoconnect on
----
Pour se connecter avec SSL :
----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
/set irc.server.libera.autoconnect on
----
Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour
l'authentification (vous serez identifié avant de rejoindre les canaux) :
----
/set irc.server.freenode.sasl_username "pseudo"
/set irc.server.freenode.sasl_password "xxxxxxx"
/set irc.server.libera.sasl_username "pseudo"
/set irc.server.libera.sasl_password "xxxxxxx"
----
Pour lancer une commande après connexion au serveur, par exemple pour
@@ -174,7 +167,7 @@ s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour
l'authentification) :
----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
/set irc.server.libera.command "/msg nickserv identify xxxxxxx"
----
[NOTE]
@@ -190,23 +183,23 @@ Définissez d'abord une phrase de chiffrement :
/secure passphrase this is my secret passphrase
----
Puis ajoutez une donnée sécurisée avec votre mot de passe freenode :
Puis ajoutez une donnée sécurisée avec votre mot de passe libera :
----
/secure set freenode_password xxxxxxx
/secure set libera_password xxxxxxx
----
Vous pouvez alors utiliser `+${sec.data.freenode_password}+` au lieu de votre
Vous pouvez alors utiliser `+${sec.data.libera_password}+` au lieu de votre
mot de passe dans les options IRC mentionnées ci-dessus, par exemple :
----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
/set irc.server.libera.sasl_password "${sec.data.libera_password}"
----
Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
----
/set irc.server.freenode.autojoin "#canal1,#canal2"
/set irc.server.libera.autojoin "#canal1,#canal2"
----
[TIP]
@@ -219,24 +212,24 @@ défaut à la place, par exemple pour utiliser les pseudos par défaut
(irc.server_default.nicks) :
----
/unset irc.server.freenode.nicks
/unset irc.server.libera.nicks
----
Autres options : vous pouvez modifier les autres options avec la commande
suivante ("xxx" est le nom d'une option) :
----
/set irc.server.freenode.xxx valeur
/set irc.server.libera.xxx valeur
----
[[connect_to_irc_server]]
== Se connecter au serveur IRC
----
/connect freenode
/connect libera
----
Avec cette commande, WeeChat se connecte au serveur freenode et rejoint
Avec cette commande, WeeChat se connecte au serveur libera et rejoint
automatiquement les canaux configurés dans l'option "autojoin" du serveur.
[NOTE]
+72 -72
View File
@@ -447,11 +447,11 @@ hda:
item 2:
__path: ['0x558d62840ea0']
number: 1
full_name: 'irc.server.freenode'
full_name: 'irc.server.libera'
item 3:
__path: ['0x558d62a9cea0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
* Demander toutes les lignes du premier tampon :
@@ -599,15 +599,15 @@ inf: ('version_number', '34144256')
* Demander le répertoire de WeeChat :
----
(info_weechat_dir) info weechat_dir
(info_weechat_config_dir) info weechat_config_dir
----
Réponse :
[source,python]
----
id: 'info_weechat_dir'
inf: ('weechat_dir', '/home/xxx/.weechat')
id: 'info_weechat_config_dir'
inf: ('weechat_config_dir', '/home/user/.config/weechat')
----
[[command_infolist]]
@@ -759,7 +759,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#weechat_)
Exemples :
@@ -868,10 +868,10 @@ hda:
prefix_color: None
----
* Demander la liste de pseudos pour le tampon "irc.freenode.#weechat" :
* Demander la liste de pseudos pour le tampon "irc.libera.#weechat" :
----
(nicklist_weechat) nicklist irc.freenode.#weechat
(nicklist_weechat) nicklist irc.libera.#weechat
----
Réponse :
@@ -960,7 +960,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#weechat_)
* _données_ : données à envoyer au tampon : si elles commencent par `/`,
cela sera exécuté comme une commande sur le tampon, sinon le texte est envoyé
comme entrée sur le tampon
@@ -976,7 +976,7 @@ input core.weechat /help filter
* Envoyer le message "bonjour !" sur le canal #weechat :
----
input irc.freenode.#weechat bonjour !
input irc.libera.#weechat bonjour !
----
[[command_completion]]
@@ -996,7 +996,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.freenode.#weechat_)
_core.weechat_ ou _irc.libera.#weechat_)
* _position_ : position dans la chaîne pour la complétion (démarre à 0) ;
si la valeur est -1, la position est la longueur de _données_ (donc la
complétion se fait à la fin de _données_)
@@ -1157,7 +1157,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.libera.#weechat_); le nom "*" peut être utilisé pour
spécifier tous les tampons
* _options_ : un ou plusieurs mots-clés, séparés par des virgules (par défaut
_buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un
@@ -1194,14 +1194,14 @@ sync core.buffer
* Synchroniser le canal #weechat, sans la liste de pseudos :
----
sync irc.freenode.#weechat buffer
sync irc.libera.#weechat buffer
----
* Obtenir les signaux généraux + tous les signaux pour le canal #weechat :
----
sync * buffers,upgrade
sync irc.freenode.#weechat
sync irc.libera.#weechat
----
[[command_desync]]
@@ -1225,7 +1225,7 @@ Syntaxe :
Paramètres :
* _tampon_ : pointeur (par exemple : "0x1234abcd") ou nom complet du tampon (par exemple :
_core.weechat_ ou _irc.freenode.#weechat_); le nom "*" peut être utilisé pour
_core.weechat_ ou _irc.libera.#weechat_); le nom "*" peut être utilisé pour
spécifier tous les tampons
* _options_ : un ou plusieurs mots-clés, séparés par des virgules (le défaut est
_buffers,upgrade,buffer,nicklist_ pour "*" et _buffer,nicklist_ pour un
@@ -1234,7 +1234,7 @@ Paramètres :
[NOTE]
En utilisant le tampon "*", les autres tampons synchronisés (en utilisant un
nom) sont gardés. +
Donc si vous envoyez : "sync *", puis "sync irc.freenode.#weechat", puis
Donc si vous envoyez : "sync *", puis "sync irc.libera.#weechat", puis
"desync *", les mises à jour sur le canal #weechat seront toujours envoyées par
WeeChat (vous devez le retirer explicitement pour stopper les mises à jour).
@@ -1253,13 +1253,13 @@ desync * buffers,upgrade,buffer,nicklist
mises à jour du tampon) :
----
desync irc.freenode.#weechat nicklist
desync irc.libera.#weechat nicklist
----
* Désynchroniser le canal #weechat :
----
desync irc.freenode.#weechat
desync irc.libera.#weechat
----
[[command_test]]
@@ -1504,7 +1504,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| short_name | chaîne | Nom court (exemple : _#weechat_).
| nicklist | entier | 1 si le tampon a une liste de pseudos, sinon 0.
| title | chaîne | Titre du tampon.
@@ -1513,8 +1513,8 @@ Données envoyées dans le hdata :
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : canal _#weechat_ rejoint sur freenode, nouveau tampon
_irc.freenode.#weechat_ :
Exemple : canal _#weechat_ rejoint sur libera, nouveau tampon
_irc.libera.#weechat_ :
[source,python]
----
@@ -1534,13 +1534,13 @@ hda:
item 1:
__path: ['0x35a8a60']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
short_name: None
nicklist: 0
title: None
local_variables: {
'plugin': 'irc',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
prev_buffer: '0x34e7400'
next_buffer: '0x0'
@@ -1558,12 +1558,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ déplacé vers le numéro 2 :
Exemple : tampon _irc.libera.#weechat_ déplacé vers le numéro 2 :
[source,python]
----
@@ -1579,7 +1579,7 @@ hda:
item 1:
__path: ['0x34588c0']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x347b9f0'
next_buffer: '0x3471bc0'
----
@@ -1596,12 +1596,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ mélangé avec le tampon n°2 :
Exemple : tampon _irc.libera.#weechat_ mélangé avec le tampon n°2 :
[source,python]
----
@@ -1617,7 +1617,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1634,12 +1634,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ sorti du mélange :
Exemple : tampon _irc.libera.#weechat_ sorti du mélange :
[source,python]
----
@@ -1655,7 +1655,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1674,12 +1674,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ masqué :
Exemple : tampon _irc.libera.#weechat_ masqué :
[source,python]
----
@@ -1695,7 +1695,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 2
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1714,12 +1714,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| prev_buffer | pointeur | Pointeur vers le tampon précédent.
| next_buffer | pointeur | Pointeur vers le tampon suivant.
|===
Exemple : tampon _irc.freenode.#weechat_ démasqué :
Exemple : tampon _irc.libera.#weechat_ démasqué :
[source,python]
----
@@ -1735,7 +1735,7 @@ hda:
item 1:
__path: ['0x4db4c00']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
prev_buffer: '0x4cef9b0'
next_buffer: '0x0'
----
@@ -1752,7 +1752,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| short_name | chaîne | Nom court (exemple : _#weechat_).
| local_variables | table de hachage | Variables locales.
|===
@@ -1773,15 +1773,15 @@ hda:
item 1:
__path: ['0x4df7b80']
number: 5
full_name: 'irc.freenode.Flash2'
full_name: 'irc.libera.Flash2'
short_name: 'Flash2'
local_variables: {
'server': 'freenode',
'server': 'libera',
'plugin': 'irc',
'type': 'private',
'channel': 'FlashCode',
'nick': 'test',
'name': 'freenode.Flash2',
'name': 'libera.Flash2',
}
----
@@ -1797,7 +1797,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| title | chaîne | Titre du tampon.
|===
@@ -1816,7 +1816,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
title: 'Welcome on #weechat! https://weechat.org/'
----
@@ -1834,10 +1834,10 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
|===
Exemple : tampon _irc.freenode.#weechat_ vidé :
Exemple : tampon _irc.libera.#weechat_ vidé :
[source,python]
----
@@ -1851,7 +1851,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_buffer_type_changed]]
@@ -1866,7 +1866,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| type | entier | Type de tampon : 0 = formaté (par défaut), 1 = contenu libre.
|===
@@ -1902,12 +1902,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ ajoutée dans le tampon
_irc.freenode.#weechat_ :
_irc.libera.#weechat_ :
[source,python]
----
@@ -1922,15 +1922,15 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'freenode',
'server': 'libera',
'test': 'value',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1946,12 +1946,12 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ mise à jour dans le tampon
_irc.freenode.#weechat_ :
_irc.libera.#weechat_ :
[source,python]
----
@@ -1966,7 +1966,7 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
local_variables: {
'server': 'local',
'test': 'value2',
@@ -1974,7 +1974,7 @@ hda:
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -1990,11 +1990,11 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
| local_variables | table de hachage | Variables locales.
|===
Exemple : variable locale _test_ supprimée du tampon _irc.freenode.#weechat_ :
Exemple : variable locale _test_ supprimée du tampon _irc.libera.#weechat_ :
[source,python]
----
@@ -2009,14 +2009,14 @@ hda:
item 1:
__path: ['0x4a73de0']
number: 3
full_name: 'irc.freenode.#prout'
full_name: 'irc.libera.#prout'
local_variables: {
'server': 'local',
'plugin': 'irc',
'type': 'channel',
'channel': '#weechat',
'nick': 'test',
'name': 'freenode.#weechat',
'name': 'libera.#weechat',
}
----
@@ -2043,7 +2043,7 @@ Données envoyées dans le hdata :
|===
Exemple : nouveau message _hello!_ du pseudo _FlashCode_ sur le tampon
_irc.freenode.#weechat_ :
_irc.libera.#weechat_ :
[source,python]
----
@@ -2092,10 +2092,10 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| number | entier | Numéro de tampon (≥ 1).
| full_name | chaîne | Nom complet (exemple : _irc.freenode.#weechat_).
| full_name | chaîne | Nom complet (exemple : _irc.libera.#weechat_).
|===
Exemple : tampon _irc.freenode.#weechat_ en cours de fermeture par WeeChat :
Exemple : tampon _irc.libera.#weechat_ en cours de fermeture par WeeChat :
[source,python]
----
@@ -2109,7 +2109,7 @@ hda:
item 1:
__path: ['0x4a715d0']
number: 3
full_name: 'irc.freenode.#weechat'
full_name: 'irc.libera.#weechat'
----
[[message_nicklist]]
@@ -2137,7 +2137,7 @@ Données envoyées dans le hdata :
| prefix_color | chaîne | Couleur du préfixe (seulement pour un pseudo).
|===
Exemple : liste de pseudos pour le tampon _irc.freenode.#weechat_ :
Exemple : liste de pseudos pour le tampon _irc.libera.#weechat_ :
[source,python]
----
@@ -2567,17 +2567,17 @@ objets).
retournées pour le hdata)
Exemple de hdata avec deux tampons (tampon "core" weechat et le serveur
freenode) et deux clés (_number_ et _full_name_) :
libera) et deux clés (_number_ et _full_name_) :
....
# commande
hdata buffer:gui_buffers(*) number,full_name
# réponse
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬─────────────────────
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.freenode
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴─────────────────────
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────
┌────────┬──────────────────────────┬───╥─────────┬───┬──────────────╥─────────┬───┬───────────────────┐
│ buffer │ number:int,full_name:str │ 2 ║ 0x12345 │ 1 │ core.weechat ║ 0x6789a │ 2 │ irc.server.libera
└────────┴──────────────────────────┴───╨─────────┴───┴──────────────╨─────────┴───┴───────────────────┘
└──────┘ └────────────────────────┘ └─┘ └──────────────────────────┘ └───────────────────────────────┘
h-path clés nombre tampon 1 tampon 2
....
@@ -2721,7 +2721,7 @@ Un élément est :
** _value_ : valeur de la variable
Exemple d'infolist avec deux tampons (tampon "core" weechat et le serveur
freenode) :
libera) :
....
# commande
+91 -67
View File
@@ -72,12 +72,17 @@ link:weechat_plugin_api.en.html#_hook_process[Référence API extension WeeChat]
[[languages_specificities]]
=== Spécificités des langages
[[language_python]]
==== Python
[[python_module]]
===== Module
WeeChat définit un module `weechat` qui doit être importé avec `import 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].
[[python_functions]]
===== Fonctions
Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`.
@@ -85,6 +90,7 @@ Les fonctions sont appelées avec `+weechat.xxx(arg1, arg2, ...)+`.
Les fonctions `+print*+` se nomment `+prnt*+` en python (car `print` était un
mot clé réservé en Python 2).
[[python_strings]]
===== Chaînes reçues dans les fonctions de rappel
En Python 3 et avec WeeChat ≥ 2.7, les chaînes reçues dans les fonctions de
@@ -141,18 +147,23 @@ En Python 2, qui est déconseillé et ne devrait plus être utilisé, les chaîn
envoyées aux fonctions de rappel sont toujours de type `str`, et peuvent contenir
des données invalides UTF-8, dans les cas mentionnés ci-dessus.
[[language_perl]]
==== Perl
[[perl_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat::xxx(arg1, arg2, ...);+`.
[[language_ruby]]
==== Ruby
[[ruby_init]]
===== Initialisation
Vous devez définir _weechat_init_ et appeler _register_ dedans.
[[ruby_functions]]
===== Fonctions
Les fonctions sont appelées par `+Weechat.xxx(arg1, arg2, ...)+`.
@@ -178,20 +189,26 @@ Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical"
["default", "default", "default", "default"], "0", "items")
----
[[language_lua]]
==== Lua
[[lua_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...)+`.
[[language_tcl]]
==== Tcl
[[tcl_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat::xxx arg1 arg2 ...+`.
[[language_guile]]
==== Guile (Scheme)
[[guile_functions]]
===== Fonctions
Les fonctions sont appelées par `+(weechat:xxx arg1 arg2 ...)+`.
@@ -204,14 +221,18 @@ excède la limite de Guile :
* config_new_option
* bar_new
[[language_javascript]]
==== JavaScript
[[javascript_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat.xxx(arg1, arg2, ...);+`.
[[language_php]]
==== PHP
[[php_functions]]
===== Fonctions
Les fonctions sont appelées par `+weechat_xxx(arg1, arg2, ...);+`.
@@ -222,11 +243,11 @@ Les fonctions sont appelées par `+weechat_xxx(arg1, arg2, ...);+`.
Tous les scripts WeeChat doivent s'enregistrer ("register") auprès de WeeChat,
et cela doit être la première fonction WeeChat appelée dans le script.
Prototype :
Prototype (Python) :
[source,python]
----
weechat.register(name, author, version, license, description, shutdown_function, charset)
def register(name: str, author: str, version: str, license: str, description: str, shutdown_function: str, charset: str) -> int: ...
----
Paramètres :
@@ -349,7 +370,7 @@ automatiquement le script quand WeeChat démarre.
Par exemple en Python :
----
$ cd ~/.weechat/python/autoload
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
----
@@ -796,58 +817,58 @@ Liste des constantes de l'API script :
| Catégorie | Constantes
| codes retour |
WEECHAT_RC_OK +
WEECHAT_RC_OK_EAT +
WEECHAT_RC_ERROR
`WEECHAT_RC_OK` (entier) +
`WEECHAT_RC_OK_EAT` (entier) +
`WEECHAT_RC_ERROR` (entier)
| fichiers de configuration |
WEECHAT_CONFIG_READ_OK +
WEECHAT_CONFIG_READ_MEMORY_ERROR +
WEECHAT_CONFIG_READ_FILE_NOT_FOUND +
WEECHAT_CONFIG_WRITE_OK +
WEECHAT_CONFIG_WRITE_ERROR +
WEECHAT_CONFIG_WRITE_MEMORY_ERROR +
WEECHAT_CONFIG_OPTION_SET_OK_CHANGED +
WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE +
WEECHAT_CONFIG_OPTION_SET_ERROR +
WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND +
WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_RESET +
WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED +
WEECHAT_CONFIG_OPTION_UNSET_ERROR
`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 +
WEECHAT_LIST_POS_BEGINNING +
WEECHAT_LIST_POS_END
`WEECHAT_LIST_POS_SORT` (chaîne) +
`WEECHAT_LIST_POS_BEGINNING` (chaîne) +
`WEECHAT_LIST_POS_END` (chaîne)
| hotlist |
WEECHAT_HOTLIST_LOW +
WEECHAT_HOTLIST_MESSAGE +
WEECHAT_HOTLIST_PRIVATE +
WEECHAT_HOTLIST_HIGHLIGHT
`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 +
WEECHAT_HOOK_PROCESS_ERROR
`WEECHAT_HOOK_PROCESS_RUNNING` (entier) +
`WEECHAT_HOOK_PROCESS_ERROR` (entier)
| hook connect |
WEECHAT_HOOK_CONNECT_OK +
WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND +
WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED +
WEECHAT_HOOK_CONNECT_PROXY_ERROR +
WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR +
WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR +
WEECHAT_HOOK_CONNECT_MEMORY_ERROR +
WEECHAT_HOOK_CONNECT_TIMEOUT +
WEECHAT_HOOK_CONNECT_SOCKET_ERROR
`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 +
WEECHAT_HOOK_SIGNAL_INT +
WEECHAT_HOOK_SIGNAL_POINTER
`WEECHAT_HOOK_SIGNAL_STRING` (chaîne) +
`WEECHAT_HOOK_SIGNAL_INT` (chaîne) +
`WEECHAT_HOOK_SIGNAL_POINTER` (chaîne)
|===
[[common_tasks]]
@@ -889,13 +910,13 @@ weechat.prnt("", "%smauvais paramètres" % weechat.prefix("error"))
weechat.prnt("", "texte %sjaune sur bleu" % weechat.color("yellow,blue"))
# chercher un tampon et afficher un message
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.freenode.#weechat")
buffer = weechat.buffer_search("irc", "freenode.#weechat")
# (le nom complet d'un tampon est extension.nom, par exemple : "irc.libera.#weechat")
buffer = weechat.buffer_search("irc", "libera.#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
# autre solution pour chercher un tampon IRC (meilleure)
# (notez que le serveur et le canal sont séparés par une virgule)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.prnt(buffer, "message sur le canal #weechat")
----
@@ -917,7 +938,7 @@ Exemples :
weechat.command("", "/help")
# envoyer "bonjour" au canal IRC #weechat (les utilisateurs sur le canal verront le message)
buffer = weechat.info_get("irc_buffer", "freenode,#weechat")
buffer = weechat.info_get("irc_buffer", "libera,#weechat")
weechat.command(buffer, "bonjour")
----
@@ -992,7 +1013,7 @@ Pour voir les variables locales d'un tampon, exécutez cette commande dans
WeeChat :
----
/buffer localvar
/buffer listvar
----
[[hooks]]
@@ -1230,7 +1251,7 @@ xxx,irc_raw_in2_yyy::
[source,python]
----
def join_cb(data, signal, signal_data):
# signal est par exemple : "freenode,irc_in2_join"
# signal est par exemple : "libera,irc_in2_join"
# signal_data est le message IRC, par exemple : ":nick!user@host JOIN :#canal"
server = signal.split(",")[0]
msg = weechat.info_get_hashtable("irc_message_parse", {"message": signal_data})
@@ -1285,64 +1306,67 @@ Le résultat est une table de hachage avec les clés suivantes
(les exemples de valeurs sont construits avec ce message :
`+@time=2015-06-27T16:40:35.000Z :nick!user@host PRIVMSG #weechat :hello!+`) :
[width="100%",cols="1,^2,10,8",options="header"]
[width="100%",cols="3,^2,10,7",options="header"]
|===
| Clé | Version de WeeChat | Description | Exemple
| Clé | Depuis WeeChat ^(1)^ | Description | Exemple
| tags | 0.4.0 |
| tags | 0.4.0 |
Les étiquettes dans le message (peut être vide). |
`+time=2015-06-27T16:40:35.000Z+`
| message_without_tags | 0.4.0 |
| message_without_tags | 0.4.0 |
Le message sans les étiquettes (la même chose que le message s'il n'y a pas
d'étiquettes). |
`+:nick!user@host PRIVMSG #weechat :hello!+`
| nick | 0.3.4 |
| nick | 0.3.4 |
Le pseudo d'origine. |
`+nick+`
| user | 2.7 |
| user | 2.7 |
L'utilisateur d'origine. |
`+user+`
| host | 0.3.4 |
| host | 0.3.4 |
L'hôte d'origine (incluant le pseudo). |
`+nick!user@host+`
| command | 0.3.4 |
| command | 0.3.4 |
La commande (_PRIVMSG_, _NOTICE_, ...). |
`+PRIVMSG+`
| channel | 0.3.4 |
| channel | 0.3.4 |
Le canal cible. |
`+#weechat+`
| arguments | 0.3.4 |
| arguments | 0.3.4 |
Les paramètres de la commande (incluant le canal). |
`+#weechat :hello!+`
| text | 1.3 |
| text | 1.3 |
Le texte (par exemple un message utilisateur). |
`+hello!+`
| pos_command | 1.3 |
| pos_command | 1.3 |
La position de _command_ dans le message ("-1" si _command_ n'a pas été trouvé). |
`+47+`
| pos_arguments | 1.3 |
| pos_arguments | 1.3 |
La position de _arguments_ dans le message ("-1" si _arguments_ n'a pas été trouvé). |
`+55+`
| pos_channel | 1.3 |
| pos_channel | 1.3 |
La position de _channel_ dans le message ("-1" si _channel_ n'a pas été trouvé). |
`+55+`
| pos_text | 1.3 |
| pos_text | 1.3 |
La position de _text_ dans le message ("-1" si _text_ n'a pas été trouvé). |
`+65+`
|===
[NOTE]
^(1)^ La clé a été introduite dans cette version de WeeChat.
[source,python]
----
dict = weechat.info_get_hashtable(
@@ -1405,8 +1429,8 @@ weechat.prnt("", "Version %s" % weechat.info_get("version", ""))
[source,python]
----
# répertoire de WeeChat, par exemple : "/home/xxxx/.weechat"
weechat.prnt("", "Répertoire WeeChat : %s" % weechat.info_get("weechat_dir", ""))
# répertoire de config WeeChat, par exemple : "/home/user/.config/weechat"
weechat.prnt("", "Répertoire de config WeeChat : %s" % weechat.info_get("weechat_config_dir", ""))
# inactivité clavier
weechat.prnt("", "Inactivité depuis %s secondes" % weechat.info_get("inactivity", ""))
+1 -1
View File
@@ -132,7 +132,7 @@ Si vous êtes encore éveillé, vous devriez voir une interface familière et
pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;)
Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez
pas à nous en avertir sur _#weechat_, serveur _chat.freenode.net_.
pas à nous en avertir sur _#weechat_, serveur _irc.libera.chat_.
S'il n'y a pas de plantage, dites-le nous aussi, nous avons besoin de votre
retour et de vos impressions !
File diff suppressed because it is too large Load Diff
+16 -14
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
@@ -32,19 +32,21 @@ if(ENABLE_MAN)
add_custom_target(doc-man-weechat-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/it/man1)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.it.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (it)"
)
add_custom_target(doc-man-weechat-headless-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/it/man1)
if(ENABLE_HEADLESS)
# man page: weechat-headless
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1
COMMAND ${ASCIIDOCTOR_EXECUTABLE} ARGS ${ASCIIDOCTOR_ARGS} -b manpage -o weechat-headless.1 ${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.it.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.it.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (it)"
)
add_custom_target(doc-man-weechat-headless-it ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/it/man1)
endif()
endif()
if(ENABLE_DOC)
+1 -1
View File
@@ -1,5 +1,5 @@
#
# Copyright (C) 2003-2020 Sébastien Helleu <flashcode@flashtux.org>
# Copyright (C) 2003-2021 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#

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