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

Compare commits

...

153 Commits

Author SHA1 Message Date
Sébastien Helleu b20b5f1e41 [WIP] javascript: add compatibility with v8 version 6.8
This is work in progress, the javascript plugin does not yet compile.

Compatibility with old v8 lib will be added later, for now I'm focused on
compiling the plugin with v8 version 6.8.
2021-01-30 14:35:39 +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
Sébastien Helleu 72936fd3be Version 3.0 2020-11-11 08:46:53 +01:00
Sébastien Helleu 3da91d702e debian: update changelog 2020-11-10 18:32:26 +01:00
Sébastien Helleu 43d9b3a723 Version 3.0-rc1 2020-11-01 10:09:17 +01:00
Nils Görs 5beb5d7052 doc: update German documentation 2020-10-30 12:55:53 +01:00
Sébastien Helleu 0ff08e54f5 trigger: add variable "tg_argc" in data set by command trigger (closes #1576) 2020-10-21 19:10:37 +02:00
Sébastien Helleu 30e48336f4 irc: remove SASL timeout message displayed by error after successful SASL authentication (closes #1515)
The SASL timer is removed immediately when the SASL authentication is
successful or has failed.
2020-10-18 09:35:04 +02:00
Sébastien Helleu 2807a8374b doc: update German auto-generated file 2020-10-16 21:15:43 +02:00
Nils Görs da934d9818 core: update German translations 2020-10-16 16:38:50 +02:00
Sébastien Helleu 939b16230c script: allow command /script list when option script.scripts.download_enabled is set to off (closes #1574) 2020-10-15 20:38:43 +02:00
Trygve Aaberge c3707bb6e1 doc: Update hotlist example to match hotlist_prefix
hotlist_prefix defaults to "H: ", so the example should show the same to
make it easier to understand what it is.
2020-10-15 13:46:27 +02:00
Sébastien Helleu fa46a2fe2d exec: add option "-oerr" to send stderr to buffer (now disabled by default) (closes #1566) 2020-10-11 16:33:50 +02:00
Sébastien Helleu 4d696d7cc8 exec: add missing option "-oc" in /help exec 2020-10-11 15:55:40 +02:00
Sébastien Helleu c8f2ebcea3 core: add terminal and terminal multiplexer in GitHub issue template 2020-10-11 08:52:54 +02:00
Sébastien Helleu 72fdd689a2 core: update ChangeLog (issue #1567) 2020-10-10 13:36:26 +02:00
Sébastien Helleu 2384dbe193 trigger: add a function to set variables common to all triggers (issue #1567) 2020-10-10 13:32:36 +02:00
Sébastien Helleu fd72226a71 doc: translate tg_trigger_name variable under triggers (issue #1567) 2020-10-10 13:22:49 +02:00
Simmo Saan 765d2dd277 doc: add tg_trigger_name variable under triggers (issue #1567) 2020-10-10 10:13:42 +03:00
Simmo Saan 8c87b7a1f0 trigger: add tg_trigger_name variable to all triggers (closes #1567) 2020-10-10 10:13:42 +03:00
Sébastien Helleu 07565a4aa6 doc: update German auto-generated file 2020-10-07 20:32:51 +02:00
Nils Görs 79f71a0e1a core: update German translations 2020-10-05 12:22:21 +02:00
Sébastien Helleu c016e7ea87 core: use apt-get option --no-install-recommends instead of modifying config file /etc/apt/apt.conf 2020-10-04 19:11:39 +02:00
Sébastien Helleu bb82dbc0ec tests: add missing braces around if/else in macro WEE_NICK_STRDUP_FOR_COLOR (issue #1565) 2020-10-04 08:53:08 +02:00
Sébastien Helleu f8403c76db api: add optional list of colors in infos "nick_color" and "nick_color_name" (closes #1565) 2020-10-04 08:46:36 +02:00
Sébastien Helleu 657e659c42 core: add argument "num_colors" in function gui_nick_hash_color, add tests on nick functions (issue #1565)
Functions tested:

- gui_nick_hash_djb2_64
- gui_nick_hash_djb2_32
- gui_nick_hash_sum_64
- gui_nick_hash_sum_32
- gui_nick_get_forced_color
- gui_nick_strdup_for_color
- gui_nick_find_color
- gui_nick_find_color_name
2020-10-04 08:46:25 +02:00
Sébastien Helleu 1c5e5824e7 tests: run callback when resetting options in tests 2020-10-03 14:40:59 +02:00
Sébastien Helleu b32f561f77 irc: fix again typo in English plural form of "normal" 2020-09-12 18:49:42 +02:00
Sébastien Helleu 1745b78b57 irc: fix typo in English plural form of "normal" (normals -> normal) 2020-09-12 18:08:13 +02:00
Sébastien Helleu 7ce5dce8f9 doc: update German auto-generated file 2020-09-12 17:22:19 +02:00
Nils Görs 8544d9ef0b core: update German translations 2020-09-08 13:15:31 +02:00
Sébastien Helleu 3c987f3a1c script: add option script.scripts.download_enabled (closes #1548) 2020-09-06 19:15:15 +02:00
Sébastien Helleu 9ccf62979f script: do not automatically download list of scripts on startup if the file is too old (closes #1548)
The repository file is downloaded anyway if too old on any /script action.
2020-09-02 19:22:56 +02:00
Sébastien Helleu 579af1b265 tests: fix compilation with CppUTest ≥ 4.0
MemoryLeakWarningPlugin::turnOnNewDeleteOverloads is replaced by
MemoryLeakWarningPlugin::turnOnThreadSafeNewDeleteOverloads, which is available
in both CppUTest 3.x and 4.0.
2020-08-29 10:18:50 +02:00
Sébastien Helleu 54b7c88553 spell: also skip IRC color attributes codes when checking words in input (issue #1547) 2020-08-28 18:32:50 +02:00
Sébastien Helleu aac14f28dd irc: add comments in functions irc_color_decode and irc_color_encode 2020-08-25 19:37:47 +02:00
Sébastien Helleu e25c364790 spell: skip IRC color codes when checking words in input (closes #1547) 2020-08-25 19:37:42 +02:00
Sébastien Helleu 299f74bfef spell: use dynamic string functions to return modified string 2020-08-24 22:12:45 +02:00
Sébastien Helleu cfd221014c api: add argument "bytes" in function string_dyn_concat 2020-08-23 23:27:57 +02:00
Sébastien Helleu b459dab84b spell: properly skip WeeChat color codes when checking words in input (closes #1547) 2020-08-22 08:56:21 +02:00
Sébastien Helleu 268aa631c6 api: add function string_color_code_size (issue #1547) 2020-08-22 08:55:16 +02:00
Sébastien Helleu 7dd5abd625 fset: fix refresh of option values in fset buffer (issue #1553) 2020-08-20 20:31:07 +02:00
Sébastien Helleu d53fb92a30 irc: replace calls to malloc by calloc
After these calls to malloc the memory is set to zero, so it's better to call
calloc that does it already.
2020-08-17 20:06:17 +02:00
Sébastien Helleu fbc2438c1c core: replace calls to malloc by calloc
After these calls to malloc the memory is set to zero, so it's better to call
calloc that does it already.
2020-08-17 19:57:10 +02:00
Sébastien Helleu fca5a4b42c core: set notify_level to 3 if highlight is forced in gui_line_hook_update (only if tag "notify_none" is not in the line) (issue #1529) 2020-08-16 12:40:41 +02:00
Sébastien Helleu 330d7d50d2 core: set notify_level to 3 in case of highlight in gui_line_hook_update only if tag "notify_none" is not in the line (issue #1529) 2020-08-16 12:40:01 +02:00
Sébastien Helleu 786072806b core: set notify_level to 3 in case of highlight only if tag "notify_none" is not in the line (issue #1529) 2020-08-16 08:27:00 +02:00
Sébastien Helleu d15db0ecbb core: set "notify_level" to 3 if there is a highlight in the line (closes #1529) 2020-08-15 14:02:40 +02:00
Sébastien Helleu 45ce1d7604 doc: update German auto-generated file 2020-08-13 08:38:45 +02:00
Nils Görs 0e1a59cbef core: update German translations 2020-08-11 18:47:46 +02:00
Sébastien Helleu 1054cdf1e9 fset: add option fset.look.auto_refresh (closes #1553) 2020-08-09 10:56:03 +02:00
Sébastien Helleu 0cc5df6649 irc: send all channels in a single JOIN command when reconnecting to the server (closes #1551) 2020-08-05 20:05:36 +02:00
Sébastien Helleu 36c55f6973 tests: fix name of some unit tests 2020-08-05 07:28:30 +02:00
Sébastien Helleu 00c34b0ba8 core: replace "unit" by module for changes in unit tests 2020-08-05 07:22:38 +02:00
Sébastien Helleu 8cf56dfdf9 tests: add tests on GUI line functions
Functions tested:

- gui_line_lines_alloc
- gui_line_lines_free
- gui_line_tags_alloc
- gui_line_tags_free
- gui_line_is_displayed
- gui_line_has_tag_no_filter
- gui_line_search_tag_starting_with
- gui_line_get_nick_tag
2020-08-04 23:42:20 +02:00
Sébastien Helleu 0ab44c02a4 core: check that line is not NULL in functions gui_line_is_displayed and gui_line_get_nick_tag 2020-08-04 23:12:18 +02:00
Sébastien Helleu 6704825d7b core: check that line_data is not NULL in functions gui_line_tags_alloc and gui_line_has_tag_no_filter 2020-08-04 22:56:02 +02:00
Sébastien Helleu ec898732a1 core: rename functions to allocate/free lines 2020-08-04 22:42:59 +02:00
Sébastien Helleu 9262720a65 doc: add instructions to build WeeChat with address sanitizer (user's guide) 2020-08-01 09:53:47 +02:00
Sébastien Helleu 26085575d5 core: disable debug by default in autotools build 2020-08-01 01:41:40 +02:00
Sébastien Helleu 7412f5815c trigger: fix recursive calls to triggers using regex (closes #1546) 2020-07-31 20:50:33 +02:00
Sébastien Helleu 00e25af470 doc: update German auto-generated file 2020-07-21 18:28:38 +02:00
Nils Görs 6fc40fb8d4 core: update German translations 2020-07-21 11:36:35 +02:00
Sébastien Helleu 3e6c8b6a88 core: update ChangeLog (issue #1535, issue #1538) 2020-07-21 08:29:03 +02:00
Sébastien Helleu c002c5f77f doc: add "irc_nick" in hashtable sent to hook_focus callback (plugin API reference) (issue #1538) 2020-07-21 08:28:01 +02:00
Simmo Saan b69e47d0a2 irc: add pointer "irc_nick" in hashtable sent to hook focus callback (closes #1535) 2020-07-21 08:18:43 +02:00
Sébastien Helleu 84e30438d4 irc: allow to send text on buffers with commands /allchan, /allpv and /allserv 2020-07-20 22:39:28 +02:00
Sébastien Helleu ee3a4a1fc0 irc: evaluate command executed by commands /allchan, /allpv and /allserv (closes #1536)
The extra variables are now replaced (in addition to `$server`, `$channel` and
`$nick`):

- `${irc_server.xxx}`: variable xxx in server
- `${irc_channel.xxx}`: variable xxx in channel
2020-07-20 22:20:22 +02:00
Sébastien Helleu 5bf571c60f doc: improve description of tags "notify_xxx" in chapter on lines tags (user's guide) (issue #1529) 2020-07-20 21:48:20 +02:00
Sébastien Helleu e0e905ca7f trigger: check that tag "notify_none" is not present in message to run command of default trigger beep (issue #1529) 2020-07-20 21:08:59 +02:00
Sébastien Helleu 2b16036f08 core: do not add line with highlight and tag "notify_none" to hotlist (closes #1529) 2020-07-20 09:26:36 +02:00
Sébastien Helleu 9ef793fd65 Version 3.0-dev 2020-07-18 14:27:37 +02:00
646 changed files with 13575 additions and 6020 deletions
+2
View File
@@ -39,3 +39,5 @@ labels: bug
- WeeChat version: 
- OS, distribution and version: 
- Terminal: 
- Terminal multiplexer (screen/tmux/…/none): 
+1
View File
@@ -0,0 +1 @@
blank_issues_enabled: false
+1 -2
View File
@@ -25,9 +25,8 @@ jobs:
- name: Install dependencies
run: |
echo 'APT::Install-Recommends "false";' | sudo tee -a /etc/apt/apt.conf
sudo apt-get update -qq
sudo apt-get -y install devscripts equivs python-pip libenchant-dev autopoint cmake lcov pkg-config libncursesw5-dev gem2deb libperl-dev python-dev python3-dev libaspell-dev liblua5.3-dev tcl8.6-dev guile-2.0-dev libv8-dev libcurl4-gnutls-dev libgcrypt20-dev libgnutls28-dev zlib1g-dev curl libcpputest-dev php7.4-dev libphp7.4-embed libargon2-0-dev libsodium-dev pylint3 asciidoctor
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
- name: Test patches
+3
View File
@@ -37,6 +37,7 @@ Alphabetically:
* Dmitry Kobylin
* Dominik Honnef
* Dominique Martinet
* dotflac
* Eduardo Elias
* Eli Schwartz
* Elizabeth Myers (Elizacat)
@@ -55,6 +56,7 @@ Alphabetically:
* Hasan Kiran (turgay)
* Ivan Sichmann Freitas
* Jakub Jirutka
* Jan Palus
* Jason A. Donenfeld (zx2c4)
* JD Horelick (jdhore)
* jesopo
@@ -83,6 +85,7 @@ Alphabetically:
* Matt Robinson
* Matthew Horan
* Matthew Martin
* Matti Virkkunen
* Max Anton Teufel
* Maxim Baz
* Michael Siegel
+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-2008 Julien Louis <ptitlouis@sysif.net>
# Copyright (C) 2008-2009 Emmanuel Bouthenot <kolter@openics.org>
#
+78 -15
View File
@@ -15,6 +15,69 @@ https://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
(file _ReleaseNotes.adoc_ in sources).
[[v3.1]]
== Version 3.1 (under dev)
New features::
* 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 evaluation of conditions in evaluation of expressions with "eval_cond:" (issue #1582)
* 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: 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
* exec: fix search of command by identifier
* irc: fix completion of commands /halfop and /dehalfop
* spell: fix crash with IRC color codes in command line (issue #1589)
* spell: fix refresh of bar item "spell_suggest" when the input becomes empty (issue #1586)
Documentation::
* do not build weechat-headless man page if headless binary is disabled (issue #1607)
[[v3.0]]
== Version 3.0 (2020-11-11)
New features::
* api: add optional list of colors in infos "nick_color" and "nick_color_name" (issue #1565)
* api: add argument "bytes" in function string_dyn_concat
* api: add function string_color_code_size (issue #1547)
* exec: add option "-oerr" to send stderr to buffer (now disabled by default) (issue #1566)
* fset: add option fset.look.auto_refresh (issue #1553)
* irc: add pointer to irc_nick in focus of bar item "buffer_nicklist" (issue #1535, issue #1538)
* irc: allow to send text on buffers with commands /allchan, /allpv and /allserv
* irc: evaluate command executed by commands /allchan, /allpv and /allserv (issue #1536)
* script: add option script.scripts.download_enabled (issue #1548)
* trigger: add variable "tg_argc" in data set by command trigger (issue #1576)
* trigger: add variable "tg_trigger_name" in data set by all triggers (issue #1567, issue #1568)
Bug fixes::
* core: set "notify_level" to 3 if there is a highlight in the line (issue #1529)
* core: do not add line with highlight and tag "notify_none" to hotlist (issue #1529)
* irc: remove SASL timeout message displayed by error after successful SASL authentication (issue #1515)
* irc: send all channels in a single JOIN command when reconnecting to the server (issue #1551)
* script: do not automatically download list of scripts on startup if the file is too old (issue #1548)
* spell: properly skip WeeChat and IRC color codes when checking words in input (issue #1547)
* trigger: fix recursive calls to triggers using regex (issue #1546)
* trigger: add `${tg_tags} !!- ,notify_none,` in conditions of default trigger "beep" (issue #1529)
Tests::
* core: add tests on GUI line functions
Build::
* core: disable debug by default in autotools build
* tests: fix compilation with CppUTest ≥ 4.0
[[v2.9]]
== Version 2.9 (2020-07-18)
@@ -136,9 +199,9 @@ Bug fixes::
Tests::
* scripts: fix generation of test scripts with Python 3.8
* unit: add tests on IRC protocol functions and callbacks
* unit: add tests on function secure_derive_key
* unit: add tests on functions util_get_time_diff and util_file_get_content
* core: add tests on function secure_derive_key
* core: add tests on functions util_get_time_diff and util_file_get_content
* irc: add tests on IRC protocol functions and callbacks
Build::
@@ -201,7 +264,7 @@ Bug fixes::
Tests::
* unit: add tests on GUI color functions
* core: add tests on GUI color functions
Build::
@@ -253,7 +316,7 @@ Bug fixes::
Tests::
* unit: add tests on IRC ignore, message and nick functions
* irc: add tests on IRC ignore, message and nick functions
Build::
@@ -305,7 +368,7 @@ Bug fixes::
Tests::
* unit: add tests on function util_signal_search
* core: add tests on function util_signal_search
Build::
@@ -350,8 +413,8 @@ Bug fixes::
Tests::
* unit: fix UTF-8 and evaluation tests on FreeBSD
* unit: add tests on IRC configuration and protocol functions
* core: fix UTF-8 and evaluation tests on FreeBSD
* irc: add tests on IRC configuration and protocol functions
Build::
@@ -388,7 +451,7 @@ Bug fixes::
Tests::
* unit: add tests on line and hook functions
* core: add tests on line and hook functions
Build::
@@ -453,7 +516,7 @@ Documentation::
Tests::
* unit, scripts: add tests on infolists
* core, scripts: add tests on infolists
Build::
@@ -540,8 +603,8 @@ Bug fixes::
Tests::
* core: display an error if the required locale en_US.UTF-8 is not installed
* scripts: add scripting API tests (issue #104)
* unit: display an error if the required locale en_US.UTF-8 is not installed
Build::
@@ -809,8 +872,8 @@ Documentation::
Tests::
* unit: add a test to check if all plugins are loaded
* unit: fix locale used to execute tests (issue #631)
* core: add a test to check if all plugins are loaded
* core: fix locale used to execute tests (issue #631)
Build::
@@ -1034,7 +1097,7 @@ Bug fixes::
Tests::
* unit: fix memory leak in tests launcher
* core: fix memory leak in tests launcher
Build::
@@ -1202,7 +1265,7 @@ Build::
Tests::
* unit: add unit tests using CppUTest (issue #104)
* core: add unit tests using CppUTest (issue #104)
[[v0.4.3]]
== Version 0.4.3 (2014-02-09)
+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.
+75
View File
@@ -17,6 +17,81 @@ https://weechat.org/files/changelog/ChangeLog-devel.html[ChangeLog]
(file _ChangeLog.adoc_ in sources).
[[v3.1]]
== Version 3.1 (under dev)
[[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.0]]
== Version 3.0 (2020-11-11)
[[v3.0_script_option_download_enabled]]
=== New option to enable download of scripts
A new option has been added to allow the script plugin to download the list of
scripts and the scripts themselves (on weechat.org by default).
This option is `off` by default, so you must opt in if you want to use the
`/script` command, even if you upgraded from an old WeeChat version:
----
/set script.scripts.download_enabled on
----
[NOTE]
When this option is enabled, WeeChat can sometimes download again the list of
scripts when you use the `/script` command, even if you don't install a script.
[[v3.0_irc_commands_allchan_allpv_allserv]]
=== IRC commands /allchan, /allpv and /allserv
The command and arguments given to commands `/allchan`, `/allpv` and `/allserv`
are now evaluated (see /help on the commands for more information).
Additionally, a breaking change has been introduced: the leading `/` is now
required in these commands, so this allows to send text to buffers without
using the command `/msg * xxx`.
So with previous releases, to say "hello" on all channels:
----
/allchan msg * hello
----
Now it can be done like this:
----
/allchan hello
----
If you want to use a command, you must add explicitly the leading `/`:
----
/allchan /msg * hello
----
[[v3.0_trigger_beep]]
=== Default "beep" trigger
The command of "beep" trigger is now executed only if the message does NOT
contain the tag "notify_none" (in addition to existing conditions).
You can restore the default "beep" trigger with the following command:
----
/trigger restore beep
----
[[v2.9]]
== Version 2.9 (2020-07-18)
+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.
#
+2 -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.
#
@@ -33,6 +33,7 @@ endif()
set(V8_INC_PATHS
/usr/include
/usr/include/v8
${CMAKE_INCLUDE_PATH}
)
find_path(V8_INCLUDE_DIR v8.h PATHS ${V8_INC_PATHS})
+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.
#
+2 -2
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>
@@ -166,7 +166,7 @@ AC_ARG_ENABLE(enchant, [ --enable-enchant turn on Enchant lib for S
AC_ARG_ENABLE(trigger, [ --disable-trigger turn off Trigger plugin (default=compiled)],enable_trigger=$enableval,enable_trigger=yes)
AC_ARG_ENABLE(xfer, [ --disable-xfer turn off Xfer (file transfer) plugin (default=compiled)],enable_xfer=$enableval,enable_xfer=yes)
AC_ARG_WITH(tclconfig, [ --with-tclconfig=DIR directory containing tcl configuration (tclConfig.sh)],tclconfig=$withval,tclconfig='')
AC_ARG_WITH(debug, [ --with-debug debugging: 0=no debug, 1=debug compilation (default=1)],debug=$withval,debug=1)
AC_ARG_WITH(debug, [ --with-debug debugging: 0=no debug, 1=debug compilation (default=0)],debug=$withval,debug=0)
AC_ARG_ENABLE(tests, [ --enable-tests turn on build of tests (default=not built)],enable_tests=$enableval,enable_tests=no)
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)
+35
View File
@@ -1,3 +1,38 @@
weechat (2.9-1) unstable; urgency=medium
* New upstream release
* Refresh ASCII Doctor options patch
* Switch debhelper compatibility to 13 and add debian/not-installed
accordingly
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 15 Aug 2020 20:31:09 +0000
weechat (2.8-1) unstable; urgency=medium
* New upstream release
- Fix FTBFS with ruby 2.7 (Closes: #954701, #954789)
- Remove patch to fix compilation error while testing iconv support
- Remove patch to fix a crash when loading script with PHP 7.4
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 04 Apr 2020 09:01:45 +0000
weechat (2.7.1-1) unstable; urgency=medium
* New upstream release
- fix CVE-2020-8955: possible remote DOS via malformed IRC messages
(Closes: #951289)
- rebuilt against python 3.8 (Closes: #953620)
* Remove Guile 2.2 support patch (merged upstream)
* Add a patch to fix compilation error while testing iconv support
* Add a patch to fix a crash when loading script with PHP 7.4
* Bump Standards-Version to 4.5.0
* Replace gem2deb build dependency by ruby-dev to facilitate
transitions to new versions of ruby (Closes: #951713)
* Set Rules-Requires-Root to no
* Switch debhelper compatibility to 12
-- Emmanuel Bouthenot <kolter@debian.org> Mon, 09 Mar 2020 14:59:31 +0000
weechat (2.6-2) unstable; urgency=medium
* Add a patch from upstream to support Guile 2.2 (Closes: #885235)
+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
+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.
#
+1 -1
View File
@@ -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
+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.
@@ -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
+2 -2
View File
@@ -106,9 +106,9 @@
| weechat | locale | Spracheinstellung die für die übersetzten Nachrichten verwendet werden soll | -
| weechat | nick_color | zeigt Farbecode des Nick | Nickname
| weechat | nick_color | zeigt Farbecode des Nick | Nickname;Farben (Farben ist eine optionale Kommata getrennte Liste von Farben die genutzt werden sollen; wenn eine Hintergrundfarbe genutzt werden muss das Format wie folgt aussehen Text:Hintergrund; sind die Farben schon vorhanden, werden die WeeChat Optionen für Nickfarben und erzwungene Nickfarben ignoriert)
| weechat | nick_color_name | zeigt Farbnamen des Nick | Nickname
| weechat | nick_color_name | zeigt Farbnamen des Nick | Nickname;Farben (Farben ist eine optionale Kommata getrennte Liste von Farben die genutzt werden sollen; wenn eine Hintergrundfarbe genutzt werden muss das Format wie folgt aussehen Text:Hintergrund; sind die Farben schon vorhanden, werden die WeeChat Optionen für Nickfarben und erzwungene Nickfarben ignoriert)
| weechat | pid | WeeChat PID (Prozess-ID) | -
+85 -48
View File
@@ -17,71 +17,87 @@ target: Servername
* `+allchan+`: führt einen Befehl aus der an alle Channels gesendet wird, die mit einem Server verbunden sind
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command> [<arguments>]
[-current] -include=<channel>[,<channel>...] <command> [<arguments>]
/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
command: Befehl der ausgeführt werden soll
arguments: Argumente für Befehl (Variablen die genutzt werden können und durch den entsprechenden Wert ersetzt werden: $nick, $channel und $server)
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Channel
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle Channels aus:
/allchan me Ich teste gerade etwas...
/allchan /me Ich teste gerade etwas...
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel:
/allchan -exclude=#weechat msg * Hallo Welt
/allchan -exclude=#weechat Hallo Welt
schicke 'Hallo Welt' an jeden Channel, ausgenommen an den #weechat Channel und Channels die mit #linux beginnen:
/allchan -exclude=#weechat,#linux* msg * Hallo Welt
/allchan -exclude=#weechat,#linux* Hallo Welt
schickt den Text 'Hallo' an alle Channels die mit #linux beginnen:
/allchan -include=#linux* msg * Hallo
/allchan -include=#linux* Hallo
----
[[command_irc_allpv]]
* `+allpv+`: führt einen Befehl aus der an alle privaten Buffer gesendet wird, die mit einem Server verbunden sind
----
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command> [<arguments>]
[-current] -include=<nick>[,<nick>...] <command> [<arguments>]
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command>
[-current] -include=<nick>[,<nick>...] <command>
-current: führt einen Befehl aus der für alle privaten Buffer, des aktuellen Servers, Anwendung findet
-exclude: dient zum Ausschluss ausgewählter Nicks (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Nicks (Platzhalter "*" kann verwendet werden)
command: Befehl der ausgeführt werden soll
arguments: Argumente für Befehl (Variablen die genutzt werden können und durch den entsprechenden Wert ersetzt werden: $nick, $channel und $server)
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$channel Name des Channel
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
${irc_channel.xxx} Variable xxx von Channel
Beispiele:
führe den Befehl '/me Ich teste gerade etwas...' für alle privaten Buffer aus:
/allpv me Ich teste gerade etwas...
/allpv /me Ich teste gerade etwas...
schicke 'Hallo' an alle, ausgenommen an Nick foo:
/allpv -exclude=foo msg * Hallo
/allpv -exclude=foo Hallo
schicke den Text 'Hallo' an alle, ausgenommen für Nick foo und Nicks die mit bar beginnen:
/allpv -exclude=foo,bar* msg * Hallo
/allpv -exclude=foo,bar* Hallo
schicke den Text 'Hallo' an alle Nicks die mit bar beginnen:
/allpv -include=bar* msg * Hallo
/allpv -include=bar* Hallo
schließe alle privaten Buffer:
/allpv close
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: führt einen Befehl aus, der zu allen verbundenen Server gesendet wird
----
/allserv [-exclude=<server>[,<server>...]] <command> [<arguments>]
-include=<server>[,<server>...] <command> [<arguments>]
/allserv [-exclude=<server>[,<server>...]] <command>
-include=<server>[,<server>...] <command>
-exclude: dient zum Ausschluss ausgewählter Server (Platzhalter "*" kann verwendet werden)
-include: findet Anwendung für ausgewählte Server (Platzhalter "*" kann verwendet werden)
command: Befehl der ausgeführt werden soll
arguments: Argumente für Befehl (Variablen die genutzt werden können und durch den entsprechenden Wert ersetzt werden: $nick, $channel und $server)
Argumente und Befehl werden evaluiert (siehe /help eval), folgende Variablen können genutzt werden:
$server Name des Servers
$nick Nickname der auf dem Server genutzt wird
${irc_server.xxx} Variable xxx von Server
Beispiele:
ändere den Nick auf allen Servern:
/allserv nick newnick
/allserv /nick newnick
setzt den Status, auf allen Servern, auf abwesend:
/allserv away I'm away
/allserv /away I'm away
führt ein whois mit meinem nick auf allen Servern aus:
/allserv whois $nick
/allserv /whois $nick
----
[[command_irc_ban]]
@@ -203,6 +219,7 @@ 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
@@ -916,6 +933,7 @@ target: Servername
----
/voice <nick> [<nick>...]
* -yes
nick: Nick oder Maske (Platzhalter "*" kann verwendet werden)
*: vergibt an alle Nicks im Channel den voice-Status
@@ -1004,14 +1022,14 @@ 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:
Alternativbefehl "/split" wird anlegt um ein Fenster horizontal zu teilen:
/alias add split /window splith
Alternativbefehl "/hallo" wird angelegt um in allen Channels, außer im #weechat Channel, den Text "Hallo" auszugeben:
/alias add hallo /allchan -exclude=#weechat msg * hallo
/alias add hallo /allchan -exclude=#weechat hallo
Alternativbefehl "/forcejoin" wird angelegt um den IRC Befehl "forcejoin" mit einer Vervollständigung von /sajoin auszuführen:
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
@@ -1097,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>
@@ -1121,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:
@@ -1280,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:
@@ -1320,24 +1342,25 @@ Um einen Vergleich zwischen zwei Zeichenketten zu erzwingen, müssen die Ausdrü
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")
2. eine evaluierte Bedingung (Format: "eval_cond:xxx")
3. eine Zeichenkette mit Escapesequenzen (Format: "esc:xxx" oder "\xxx")
4. Zeichen, die in einer Zeichenkette nicht dargestellt werden sollen (Format: "hide:Zeichen,Zeichenkette")
5. eine Zeichenkette mit einer maximalen Anzahl an Zeichen (Format: "cut:+Max,Suffix,Zeichenkette")
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.
6. eine Zeichenkette umkehren (Format: "rev:xxx" oder "revscr:xxx")
7. eine Zeichenkette wiederholen (Format: "repeat:Anzahl,Zeichenkette")
8. Länge einer Zeichenkette (Format: "length:xxx" oder "lengthscr:xxx")
9. eine Farbe (Format: "color:xxx", siehe "Anleitung für API Erweiterung", Funktion "color")
10. ein Modifizierer (Format: "info:Name,Argumente", Argumente sind optional)
11. eine Info (Format: "Info:Name,Argumente", Argumente sind optional)
12. eine Basis 16/32/64 kodierte / dekodierte Zeichenfolge (Format: "base_encode:base,xxx" oder "base_decode:base,xxx")
13. aktuelles Datum/Uhrzeit (Format: "date" oder "date:format")
14. eine Umgebungsvariable (Format: "env:XXX")
15. ein Dreifachoperand (Format: "if:Bedingung?Wert_falls_wahr:Wert_falls_unwahr")
16. Ergebnis eines Ausdrucks mit Klammern und Operatoren + - * / // % ** (Format: "calc:xxx")
17. eine Option (Format: "file.section.option")
18. eine lokale Variable eines Buffers
19. 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:
@@ -1348,6 +1371,7 @@ Das Format für hdata kann wie folgt aufgebaut sein:
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 ${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
@@ -1390,6 +1414,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
@@ -1400,6 +1425,7 @@ 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:
@@ -2159,7 +2185,7 @@ charset: wähle neuen Zeichensatz für aktuellen Buffer
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
-in <id> <text>
-inclose <id> [<text>]
-signal <id> <signal>
@@ -2181,6 +2207,7 @@ charset: wähle neuen Zeichensatz für aktuellen Buffer
-oc: gibt die Ausgabe des Befehls im Buffer aus und führt diesen dann aus (betrifft Zeilen die mit "/" beginnen bzw. das benutzerdefinierte Befehlszeichen verwenden) (nicht kompatibel mit Argumenten -bg/-pipe/-hsignal)
-n: gibt die Ausgabe des Befehls in einem neuen Buffer aus (nicht kompatibel mit Argumenten -bg/-pipe/-hsignal)
-nf: gibt die Ausgabe des Befehls in einem neuen Buffer, mit einem freien Inhalt, aus (kein Zeilenumbruch, keine Limitierung in der Anzahl der Zeilen), aus (nicht kompatibel mit Argument -bg/-pipe/-hsignal)
-oerr: sendet stderr (Fehlerausgabe) an den Buffer (kann nur mit den Optionen -o und -oc verwendet werden)
-cl: der neue Buffer wird vor einer Ausgabe gelöscht
-nocl: Ausgabe wird an neuen Buffer angehangen, ohne diesen vorher zu löschen (Standardverhalten)
-sw: es wird zum Ausgabebuffer gewechselt (Standardverhalten)
@@ -2800,7 +2827,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)
@@ -2931,7 +2968,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)
@@ -2963,7 +3000,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
@@ -2616,6 +2616,12 @@
** Werte: 1 .. 3600
** Standardwert: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** Beschreibung: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** 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
@@ -3320,6 +3326,12 @@
** Werte: -1 .. 525600
** Standardwert: `+1440+`
* [[option_script.scripts.download_enabled]] *script.scripts.download_enabled*
** Beschreibung: pass:none[Aktivieren Sie den Download von Dateien aus dem Skript-Repository, wenn der Befehl /script verwendet wird (Liste der Skripten und Skripten selbst). Die Liste der Skripten wird von der in der Option script.scripts.url angegebenen URL heruntergeladen. WeeChat lädt manchmal die Liste der Skripten erneut herunter, wenn Sie den Befehl /script verwenden, auch wenn Sie kein Skript installieren]
** Typ: boolesch
** Werte: on, off
** Standardwert: `+off+`
* [[option_script.scripts.download_timeout]] *script.scripts.download_timeout*
** Beschreibung: pass:none[Zeitüberschreitung (in Sekunden) beim herunterladen von Skripten und der Skriptliste]
** Typ: integer
@@ -3748,6 +3760,12 @@
** Werte: beliebige Zeichenkette
** Standardwert: `+"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:darkgray} -- ${min}..${max}${newline} ${empty_name} ${description}"+`
* [[option_fset.look.auto_refresh]] *fset.look.auto_refresh*
** Beschreibung: pass:none[durch Kommata getrennte Liste von Optionen, die eine Aktualisierung des fset Buffers auslösen (falls dieser geöffnet sein sollte); "*" beschreibt alle Optionen (empfohlen). Beginnt der Name einer Option hingegen mit "!" erzeugt diese Option keine Aktualisierung des Buffers. Im Optionsnamen kann der Platzhalter "*" verwendet werden (Beispiel: "*,!plugin.section.*" )]
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette
** Standardwert: `+"*"+`
* [[option_fset.look.auto_unmark]] *fset.look.auto_unmark*
** Beschreibung: pass:none[die Markierung wird automatisch für alle Optionen gelöscht, sobald eine Aktion bei einer markierten Option durchgeführt wird oder die Liste neu eingelesen wird]
** Typ: boolesch
+1 -1
View File
@@ -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
+28 -4
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?
@@ -1264,11 +1289,10 @@ Beispiel:
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.
die durch eine Passphrase verschlüsselte, sensible, Daten enthalten kann.
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.
+2 -1
View File
@@ -562,6 +562,7 @@ Liste der Skript API Funktionen:
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
@@ -987,7 +988,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]]
+189 -19
View File
@@ -382,12 +382,14 @@ Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_p
Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:
* kompilieren Sie WeeChat mit Debug-Information (oder installieren Sie das Binärpaket mit Debug-Information)
* kompilieren Sie mit:
** Debug-Information (oder installieren Sie das Binärpaket mit Debug-Information)
** Kompilation mit Adressbereiniger (optional)
* aktivieren Sie _core_ Dateien auf Ihrem System
* installieren Sie gdb
[[debug_info]]
==== Debug info
[[build_debug]]
==== Mit Debug-Optionen erstellen
Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:
@@ -395,9 +397,27 @@ Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----
Bei der Kompilierung mit autotools ist debug standardmäßig aktiviert (`--with-debug=1`).
[[build_debug_address_sanitizer]]
==== Erstellen mit Debug-Optionen und Address Sanitizer
Wird ein Binärpaket genutzt dann muss zusätzlich das Paket _weechat-dbg_ installiert werden.
Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort
zum Absturz von WeeChat führt:
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
Sie sollten die Adressbereinigung nur aktivieren, wenn Sie versuchen, einen
Absturz zu provozieren. Diese Funktion wird im produktivem Einsatz nicht empfohlen.
Nach dem Kompilieren und Installieren müssen Sie WeeChat folgendermaßen ausführen:
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
Im Falle eines Absturzes befinden sich zusätzliche Informationen in der Datei, `asan.log`.
[[core_files]]
==== Core Dateien
@@ -538,7 +558,8 @@ Einige Umgebungsvariablen werden von WeeChat genutzt, sofern sie definiert wurde
=== Dateien und Verzeichnisse
WeeChat schreibt standardmäßig seine Konfiguration und andere
Daten in folgendes Verzeichnis: `~/.weechat`
Daten in folgendes Verzeichnis: `~/.weechat` +
Diese Dateien werden, mit Standardwerten, beim ersten Ausführen von WeeChat automatisch erstellt.
[[weechat_directories]]
==== WeeChat Verzeichnisse
@@ -596,7 +617,7 @@ Folgende Dateien befinden sich im WeeChat-Heimatverzeichnis:
| perl.conf | Konfiguration für _perl_-Erweiterung | Nein.
| php.conf | Konfiguration für _php_-Erweiterung | Nein.
| python.conf | Konfiguration für _python_-Erweiterung | Nein.
| relay.conf | Konfiguration für _relay_-Erweiterung | Nein.
| relay.conf | Konfiguration für _relay_-Erweiterung | *Ja*: es kann das Relay-Passwort und das TOTP (Einmalkennwort) enthalten (sofern nicht in `sec.conf` gesichert), erlaubt OP Adressen/Websocket und geöffnete Ports.
| ruby.conf | Konfiguration für _ruby_-Erweiterung | Nein.
| script.conf | Konfiguration für _script_-Erweiterung | Nein.
| spell.conf | Konfiguration für _spell_-Erweiterung | Nein.
@@ -641,7 +662,7 @@ Beispiel des WeeChat-Terminals:
│ │ │ │
│ │ │ │
│ │ │ │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [Act: 3:#abc(2,5), 5] │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]
│ │[@Flashy(i)] hi peter!█ │
└──────────────────────────────────────────────────────────────────────────────────────┘
▲ Bars "status" und "input" Bar "nicklist" ▲
@@ -692,7 +713,7 @@ Die _status_-Bar besitzt als Standardeinträge:
| buffer_filter | `+*+` | Filteranzeige: `+*+` bedeutet das Zeilen gefiltert (unterdrückt) werden. Ein leerer Eintrag zeigt an, dass alle Zeilen dargestellt werden.
| scroll | `-MORE(50)-` | Scroll Indikator, zeigt an wie viele Zeilen unterhalb der zur Zeit dargestellten Zeile vorhanden sind.
| lag | `[Lag: 2.5]` | Verzögerungsanzeige, in Sekunden (keine Anzeige falls Verzögerung gering).
| hotlist | `[Act: 3:#abc(2,5), 5]` | Liste der Buffer mit Aktivität (ungelesene Nachrichten) (für das Beispiel: 2 Highlights und 5 ungelesene Nachrichten im Channel _#abc_, eine ungelesene Nachricht in Buffer #5).
| hotlist | `[H: 3:#abc(2,5), 5]` | Liste der Buffer mit Aktivität (ungelesene Nachrichten) (für das Beispiel: 2 Highlights und 5 ungelesene Nachrichten im Channel _#abc_, eine ungelesene Nachricht in Buffer #5).
| completion | `abc(2) def(5)` | Liste von Wörtern für Vervollständigung, die Zahl zeigt an wie viele Varianten möglich sind.
|===
@@ -1081,8 +1102,8 @@ Beispiele für eine vertikale und horizontale Fensteraufteilung:
▲ Fenster #1 (Buffer #3) ▲ Fenster #2 (Buffer #4)
....
[[buffers_lines]]
=== Zeilen in Buffern
[[buffers]]
=== Buffern
[[lines_format]]
==== Format von Zeilen
@@ -1124,11 +1145,11 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
| no_filter | Zeile kann nicht gefiltert werden.
| no_highlight | die Zeile kann nicht gehiglighted werden.
| no_log | Zeile wird nicht in die Log-Datei geschrieben.
| log0 ... log9 | Grad der Protokollierung (siehe `/help logger`).
| notify_none | Buffer welche die Zeile enthält wird nicht zur Hotlist hinzufügt.
| notify_message | Buffer welche die Zeile enthält wird mit der Stufe "message" zur Hotlist hinzugefügt.
| notify_private | Buffer welche die Zeile enthält wird mit der Stufe "private" zur Hotlist hinzugefügt.
| notify_highlight | Buffer welche die Zeile enthält wird mit der Stufe "highlight" zur Hotlist hinzugefügt.
| log0 log9 | Grad der Protokollierung (siehe `/help logger`).
| notify_none | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^
| notify_message | Diese Zeile ist eine User Nachricht. ^(1)^
| notify_private | Diese Zeile ist eine private Nachricht. ^(1)^
| notify_highlight | Diese Zeile beinhaltet eine Highlight Nachricht. ^(1)^
| self_msg | eigene Nachricht.
| nick_xxx | Nachricht ist vom Nick "xxx".
| prefix_nick_ccc | Präfix für den Nick mit der Farbe "ccc".
@@ -1143,6 +1164,146 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
| away_info | Nachricht mit "away" Information.
|===
[NOTE]
^(1)^ Wenn kein "notify_xxx" Tag vorhanden ist, ist die Benachrichtigungsstufe "low".
Falls ein "notify_xxx" Tag vorhanden ist, kann die tatsächliche Benachrichtigungsstufe
unterschiedlich sein. Wenn beispielsweise der max hotlist level für einen Nick verwendet
wird, kann die Benachrichtigungsstufe niedriger sein als der Wert im Tag.
[[local_variables]]
==== lokale Variablen
Lokale Variablen können für alle Buffer definiert werden.
Eine lokale Variable besteht:
* aus einem Namen (Zeichenkette)
* und aus einem Wert (Zeichenkette, kann leer sein).
Lokale Variablen können von WeeChat, Erweiterungen, Skripten oder manuell,
in der Befehlszeile eines Buffers, festgelegt werden.
So fügen Sie beispielsweise die lokale Variable "completion_default_template" hinzu:
----
/buffer setvar completion_default_template %(my_completion)
----
um sich alle lokalen Variablen des aktuellen Buffers anzeigen zu lassen:
----
/buffer listvar
----
So entfernen Sie die lokale Variable "completion_default_template":
----
/buffer delvar completion_default_template
----
Standardmäßig interpretieren WeeChat und seine Standard-Erweitertungen diese Variablen:
[width="100%",cols="^2m,2,5",options="header"]
|===
| Name | Wert | Beschreibung
| away |
beliebige Zeichenkette |
Abwesenheitsnotiz auf dem Server, wird durch IRC Erweiterung genutzt.
| channel |
beliebige Zeichenkette |
Channel-Name, wird durch irc/xfer Erweiterung und dem Debug-Buffer von relay/trigger Erweiterung genutzt.
| charset_modifier |
beliebige Zeichenkette |
Charset modifier für den Server-Buffer, wird durch IRC Erweiterung genutzt.
| completion_default_template |
beliebige Zeichenkette |
Vorlage für die standardmäßige Vervollständigung innerhalb eines Buffers, überschreibt die Option
`weechat.completion.default_template`.
| filter |
beliebige Zeichenkette |
Filter definiert für einige Buffer `/fset`, `/server raw` (irc) und `/script`.
| host |
beliebige Zeichenkette |
eigener Host (sofern bekannt), wird durch IRC Erweiterung genutzt.
| lag |
beliebige Zeichenkette |
Verzögerung auf dem Server, wird durch IRC Erweiterung genutzt.
| name |
beliebige Zeichenkette |
Buffername (Vorsicht, dies ist nicht der vollständige Name des Buffers und reicht nicht aus, um einen Buffer zu identifizieren oder zu suchen).
| nick |
beliebige Zeichenkette |
eigener Nick, wird durch IRC und xfer Erweiterung genutzt.
| no_log |
`1` (oder jede andere nicht leere Zeichenkette) |
Wenn festgelegt, protokolliert die Logger-Erweiterung nichts für den Buffer.
| plugin |
beliebige Zeichenkette |
Name der Erweiterung welche den Buffer erstellt hat (`core` für WeeChat-Buffer).
| script_close_cb |
beliebige Zeichenkette |
Close callback, für diesen Buffer durch ein Skript definiert.
| script_close_cb_data |
beliebige Zeichenkette |
Daten für ein Close callback, welches durch ein Skript für diesen Buffer definiert wurde.
| script_input_cb |
beliebige Zeichenkette |
Input callback, für diesen Buffer durch ein Skript definiert.
| script_input_cb_data |
beliebige Zeichenkette |
Daten für ein Input callback, welches durch ein Skript für diesen Buffer definiert wurde.
| script_name |
beliebige Zeichenkette |
Name des Skriptes welches den Buffer erstellt hat.
| server |
beliebige Zeichenkette |
Servername, wird durch IRC Erweiterung genutzt und durch den Debug-Buffer von relay/trigger Erweiterung.
| spell_suggest |
beliebige Zeichenkette |
falsch geschriebenes Wort und Korrekturvorschläge (Format: "fehlerhaftes Wort:Korrekturvorschläge"), wird durch
spell-Erweiterung definiert.
| trigger_filter |
beliebige Zeichenkette |
Trigger-Filter, wird durch Trigger-Erweiterung definiert.
| type |
beliebige Zeichenkette, zum Beispiel:
`channel`,
`debug`,
`exec`,
`option`,
`private`,
`relay`,
`script`,
`server`,
`user`,
`xfer` |
Buffertyp, festgelegt von WeeChat und vielen Erweiterungen.
|===
[NOTE]
Externe Erweitertungen und Skripte können andere lokale Variablen definieren und verwenden.
[[bars]]
=== Bars
@@ -3124,7 +3285,7 @@ mit lokalen Buffervariablen zu füllen. Um sich die verfügbaren lokalen Variabl
für den aktuellen Buffer anzeigen zu lassen:
----
/buffer localvar
/buffer listvar
----
Masken werden in absteigender Reihenfolge abgeglichen, beginnend mit
@@ -4103,6 +4264,14 @@ Monitor-Buffer zu öffnen:
/trigger monitor
----
Alle Callbacks setzen folgende Variablen in das hashtable:
[width="100%",cols="3m,2,14",options="header"]
|===
| Variable | Typ | Beschreibung
| tg_trigger_name | string | Name des Trigger.
|===
[[trigger_data_signal]]
===== Signale
@@ -4272,8 +4441,9 @@ Der Callback von "command" legt folgende Variablen in der Hashtable an:
|===
| Variable | Typ | Beschreibung
| buffer | pointer | Buffer.
| tg_argvN | string | Argument #N.
| tg_argv_eolN | string | von Argument #N bis zum Ende der Argumente.
| tg_argc | string | Die Anzahl von Argumenten (der Befehl wird mitgezählt).
| tg_argvN | string | Argument #N (`+tg_argv0+` ist der Befehl selber, die weiteren sind Argumente).
| tg_argv_eolN | string | von Argument #N bis zum Ende der Argumente (`+tg_argv_eol0+` enthält den eigentlichen Befehl).
|===
[[trigger_data_command_run]]
+1 -1
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
+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
+2 -2
View File
@@ -106,9 +106,9 @@
| weechat | locale | locale used for translating messages | -
| weechat | nick_color | get nick color code | nickname
| weechat | nick_color | get nick color code | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | nick_color_name | get nick color name | nickname
| weechat | nick_color_name | get nick color name | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | pid | WeeChat PID (process ID) | -
+87 -50
View File
@@ -17,71 +17,87 @@ target: server name
* `+allchan+`: execute a command on all channels of all connected servers
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command> [<arguments>]
[-current] -include=<channel>[,<channel>...] <command> [<arguments>]
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command>
[-current] -include=<channel>[,<channel>...] <command>
-current: execute command for channels of current server only
-exclude: exclude some channels (wildcard "*" is allowed)
-include: include only some channels (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all channels:
/allchan me is testing
/allchan /me is testing
say 'hello' everywhere but not on #weechat:
/allchan -exclude=#weechat msg * hello
/allchan -exclude=#weechat hello
say 'hello' everywhere but not on #weechat and channels beginning with #linux:
/allchan -exclude=#weechat,#linux* msg * hello
/allchan -exclude=#weechat,#linux* hello
say 'hello' on all channels beginning with #linux:
/allchan -include=#linux* msg * hello
/allchan -include=#linux* hello
----
[[command_irc_allpv]]
* `+allpv+`: execute a command on all private buffers of all connected servers
----
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command> [<arguments>]
[-current] -include=<nick>[,<nick>...] <command> [<arguments>]
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command>
[-current] -include=<nick>[,<nick>...] <command>
-current: execute command for private buffers of current server only
-exclude: exclude some nicks (wildcard "*" is allowed)
-include: include only some nicks (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all private buffers:
/allpv me is testing
/allpv /me is testing
say 'hello' everywhere but not for nick foo:
/allpv -exclude=foo msg * hello
/allpv -exclude=foo hello
say 'hello' everywhere but not for nick foo and nicks beginning with bar:
/allpv -exclude=foo,bar* msg * hello
/allpv -exclude=foo,bar* hello
say 'hello' for all nicks beginning with bar:
/allpv -include=bar* msg * hello
/allpv -include=bar* hello
close all private buffers:
/allpv close
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: execute a command on all connected servers
----
/allserv [-exclude=<server>[,<server>...]] <command> [<arguments>]
-include=<server>[,<server>...] <command> [<arguments>]
/allserv [-exclude=<server>[,<server>...]] <command>
-include=<server>[,<server>...] <command>
-exclude: exclude some servers (wildcard "*" is allowed)
-include: include only some servers (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$nick nick on server
${irc_server.xxx} variable xxx in server
Examples:
change nick on all servers:
/allserv nick newnick
/allserv /nick newnick
set away on all servers:
/allserv away I'm away
/allserv /away I'm away
do a whois on my nick on all servers:
/allserv whois $nick
/allserv /whois $nick
----
[[command_irc_ban]]
@@ -203,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
@@ -916,6 +933,7 @@ target: server name
----
/voice <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: give voice to everybody on channel
@@ -1004,14 +1022,14 @@ 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:
alias /split to split window horizontally:
/alias add split /window splith
alias /hello to say "hello" on all channels but not on #weechat:
/alias add hello /allchan -exclude=#weechat msg * hello
/alias add hello /allchan -exclude=#weechat hello
alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
@@ -1097,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>
@@ -1121,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
@@ -1280,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:
@@ -1320,24 +1342,25 @@ To force a string comparison, you can add double quotes around each expression,
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")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. 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.
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. 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:
@@ -1348,6 +1371,7 @@ Format for hdata can be one of following:
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
/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
@@ -1390,6 +1414,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
@@ -1400,6 +1425,7 @@ 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:
@@ -2159,7 +2185,7 @@ charset: new charset for current buffer
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
-in <id> <text>
-inclose <id> [<text>]
-signal <id> <signal>
@@ -2181,6 +2207,7 @@ charset: new charset for current buffer
-oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
-n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
-nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
-oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
-cl: clear the new buffer before displaying output
-nocl: append to the new buffer without clear (default)
-sw: switch to the output buffer (default)
@@ -2802,6 +2829,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
@@ -2931,7 +2968,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)
@@ -2616,6 +2616,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
@@ -3320,6 +3326,12 @@
** values: -1 .. 525600
** default value: `+1440+`
* [[option_script.scripts.download_enabled]] *script.scripts.download_enabled*
** description: pass:none[enable download of files from the scripts repository when the /script command is used (list of scripts and scripts themselves); the list of scripts is downloaded from the URL specified in the option script.scripts.url; WeeChat will sometimes download again the list of scripts when you use the /script command, even if you don't install a script]
** type: boolean
** values: on, off
** default value: `+off+`
* [[option_script.scripts.download_timeout]] *script.scripts.download_timeout*
** description: pass:none[timeout (in seconds) for download of scripts and list of scripts]
** type: integer
@@ -3748,6 +3760,12 @@
** values: any string
** default value: `+"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:darkgray} -- ${min}..${max}${newline} ${empty_name} ${description}"+`
* [[option_fset.look.auto_refresh]] *fset.look.auto_refresh*
** description: pass:none[comma separated list of options to automatically refresh on the fset buffer (if opened); "*" means all options (recommended), a name beginning with "!" is a negative value to prevent an option to be refreshed, wildcard "*" is allowed in names (example: "*,!plugin.section.*")]
** type: string
** values: any string
** default value: `+"*"+`
* [[option_fset.look.auto_unmark]] *fset.look.auto_unmark*
** description: pass:none[automatically unmark all options after an action on marked options or after a refresh]
** type: boolean
+1 -1
View File
@@ -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
+2 -1
View File
@@ -419,6 +419,7 @@ WeeChat "core" is located in following directories:
|             test-irc-mode.cpp | Tests: IRC modes.
|             test-irc-nick.cpp | Tests: IRC nicks.
|             test-irc-protocol.cpp | Tests: IRC protocol.
|             test-irc-server.cpp | Tests: IRC server.
|          relay/ | Root of unit tests for Relay plugin.
|             test-relay-auth.cpp | Tests: clients authentication.
@@ -494,7 +495,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.
*
+30 -3
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?
@@ -1166,9 +1194,8 @@ For example:
You can share files _~/.weechat/*.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.
+87 -15
View File
@@ -1334,14 +1334,25 @@ Return value:
* same return code as function `regcomp` (0 if OK, other value for error,
see `man regcomp`)
[NOTE]
Regular expression _preg_ must be cleaned by calling "regfree" after use,
if the function returned 0 (OK).
C example:
[source,C]
----
regex_t my_regex;
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) != 0)
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0)
{
/* OK */
/* ... */
regfree (&my_regex);
}
else
{
/* error */
/* ... */
}
----
@@ -1888,6 +1899,55 @@ str = weechat.string_format_size(size)
str = weechat.string_format_size(15200) # == "15.2 KB"
----
==== string_color_code_size
_WeeChat ≥ 3.0._
Return the size (in bytes) of the WeeChat color code at the beginning of
the string.
Prototype:
[source,C]
----
int weechat_string_color_code_size (const char *string);
----
Arguments:
* _string_: string
Return value:
* size (in bytes) of the WeeChat color code at the beginning of the string;
if the string is NULL, empty or does not start with a color code, 0 is returned;
if the string begins with multiple color codes, only the size of the first one
is returned
C examples:
[source,C]
----
int size;
size = weechat_string_color_code_size ("test"); /* size == 0 */
size = weechat_string_color_code_size (weechat_color ("bold")); /* size == 2 */
size = weechat_string_color_code_size (weechat_color ("yellow,red")); /* size == 7 */
----
Script (Python):
[source,python]
----
# prototype
size = weechat.string_color_code_size(string)
# examples
size = weechat.string_color_code_size("test") # size == 0
size = weechat.string_color_code_size(weechat.color("bold")) # size == 2
size = weechat.string_color_code_size(weechat.color("yellow,red")) # size == 7
----
==== string_remove_color
Remove WeeChat colors from a string.
@@ -2149,7 +2209,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
_WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8, 2.0,
2.2, 2.3, 2.7 and 2.9._
2.2, 2.3, 2.7, 2.9 and 3.1._
Evaluate an expression and return result as a string.
Special variables with format `+${variable}+` are expanded (see table below).
@@ -2197,6 +2257,10 @@ Arguments:
** _regex_replace_: the replacement text to use with _regex_, to replace
text in _expr_ (the _regex_replace_ is evaluated on each match of _regex_
against _expr_, until no match is found)
** _debug_: debug level (string with integer number ≥ 1), if enabled, a key
"debug_output" is added in hashtable _options_:
*** _1_: enable debug
*** _2_: enable more verbose debug
Return value:
@@ -2472,6 +2536,12 @@ expanded to last):
`+19:02:45+` (with colors if there are color codes in the option
weechat.look.buffer_time_format)
| `+${eval_cond:xxx}+` +
_(WeeChat ≥ 3.1)_ |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
`+${\xxx}+` +
_(WeeChat ≥ 1.0)_ |
@@ -2770,7 +2840,7 @@ This function is not available in scripting API.
==== string_dyn_concat
_WeeChat ≥ 1.8._
_WeeChat ≥ 1.8, updated in 3.0._
Concatenate a string to a dynamic string.
@@ -2781,13 +2851,16 @@ Prototype:
[source,C]
----
int weechat_string_dyn_concat (char **string, const char *add);
int weechat_string_dyn_concat (char **string, const char *add, int bytes);
----
Arguments:
* _string_: pointer to dynamic string
* _add_: the string to add
* _bytes_: max number of bytes in _add_ to concatenate, must be lower or equal
to length of _add_ (-1 = automatic: concatenate whole string _add_)
_(WeeChat ≥ 3.0)_
Return value:
@@ -2800,7 +2873,7 @@ C example:
char **string = weechat_string_dyn_alloc (256);
if (weechat_string_dyn_copy (string, "test"))
{
if (weechat_string_dyn_concat (string, "abc"))
if (weechat_string_dyn_concat (string, "abc", -1))
{
/* ... */
}
@@ -12104,8 +12177,7 @@ Content of hashtable sent to callback (keys and values are of type "string"):
| _chat | Chat area indicator. |
"0" or "1" | "0"
| _chat_line | Pointer to line +
_(WeeChat ≥ 1.2)_. |
| _chat_line | Pointer to line _(WeeChat ≥ 1.2)_. |
"0x1234abcd" | ""
| _chat_line_x | Column in line ^(3)^. |
@@ -12159,8 +12231,7 @@ Content of hashtable sent to callback (keys and values are of type "string"):
| _bar_item_col | Column in bar item. |
"0" ... "n" | "-1"
| _bar_window | Pointer to bar window +
_(WeeChat ≥ 2.9)_. |
| _bar_window | Pointer to bar window _(WeeChat ≥ 2.9)_. |
"0x1234abcd" | ""
|===
@@ -12175,13 +12246,14 @@ button has been released). +
Extra info for bar item "buffer_nicklist":
[width="100%",cols="1,1,5",options="header"]
[width="100%",cols="^1,^1,5",options="header"]
|===
| Key | Plugin ^(1)^ | Description
| nick | core | Nick name.
| prefix | core | Prefix for nick.
| group | core | Group name.
| irc_host | irc | Host for nick (if known).
| Plugin ^(1)^ | Key | Description
| irc | irc_nick | Pointer to IRC nick _(WeeChat ≥ 3.0)_.
| irc | irc_host | Host for nick (if known).
| weechat | nick | Nick name.
| weechat | prefix | Prefix for nick.
| weechat | group | Group name.
|===
[NOTE]
+2 -1
View File
@@ -546,6 +546,7 @@ List of functions in script API:
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
@@ -964,7 +965,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]]
+193 -22
View File
@@ -375,12 +375,14 @@ Then follow instructions for source package (see
If you experienced crashes, or if you want to report any future WeeChat crash,
you have to:
* Compile it with debug info (or install binary package with debug info).
* Compile with:
** debug info (or install binary package with debug info),
** address sanitizer (optional).
* Enable _core_ files on your system.
* Install gdb.
[[debug_info]]
==== Debug info
[[build_debug]]
==== Build with debug options
If you're compiling with CMake:
@@ -388,9 +390,27 @@ If you're compiling with CMake:
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----
If you're compiling with autotools, debug is default (`--with-debug=1`).
[[build_debug_address_sanitizer]]
==== Build with debug options and address sanitizer
If you installed a binary package, then install package _weechat-dbg_.
You can additionally enable the address sanitizer, which causes WeeChat to
crash immediately in case of problem:
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
You should enable address sanitizer only if you're trying to cause a crash,
this is not recommended in production.
Then once compiled and installed, you must run WeeChat like this:
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
In case of crash, the backtrace is in file `asan.log`.
[[core_files]]
==== Core files
@@ -529,7 +549,8 @@ Some environment variables are used by WeeChat if they are defined:
=== Files and directories
WeeChat writes configuration files and other data in directory `~/.weechat`
by default.
by default. +
These files are created with default values the first time you run WeeChat.
[[weechat_directories]]
==== WeeChat directories
@@ -587,7 +608,7 @@ The files in the WeeChat home directory are:
| perl.conf | Configuration file for _perl_ plugin | No.
| php.conf | Configuration file for _php_ plugin | No.
| python.conf | Configuration file for _python_ plugin | No.
| relay.conf | Configuration file for _relay_ plugin | No.
| relay.conf | Configuration file for _relay_ plugin | *Yes*: it can contain relay password and TOTP secret (if not stored in `sec.conf`), allowed IP addresses/websocket origins and opened ports.
| ruby.conf | Configuration file for _ruby_ plugin | No.
| script.conf | Configuration file for _script_ plugin | No.
| tcl.conf | Configuration file for _tcl_ plugin | No.
@@ -635,7 +656,7 @@ Example of terminal with WeeChat:
│ │ │ │
│ │ │ │
│ │ │ │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [Act: 3:#abc(2,5), 5] │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]
│ │[@Flashy(i)] hi peter!█ │
└──────────────────────────────────────────────────────────────────────────────────────┘
▲ bars "status" and "input" bar "nicklist" ▲
@@ -686,7 +707,7 @@ Bar _status_ has following default items:
| buffer_filter | `+*+` | Filtering indicator: `+*+` means some lines are filtered (hidden), empty value means all lines are displayed.
| scroll | `-MORE(50)-` | Scroll indicator, with number of lines below last line displayed.
| lag | `[Lag: 2.5]` | Lag indicator, in seconds (hidden if lag is low).
| hotlist | `[Act: 3:#abc(2,5), 5]` | List of buffers with activity (unread messages) (in example, 2 highlights and 5 unread messages on _#abc_, one unread message on buffer #5).
| hotlist | `[H: 3:#abc(2,5), 5]` | List of buffers with activity (unread messages) (in example, 2 highlights and 5 unread messages on _#abc_, one unread message on buffer #5).
| completion | `abc(2) def(5)` | List of words for completion, with number of possible completions for each word.
|===
@@ -1065,8 +1086,8 @@ Example of vertical + horizontal splits:
▲ window #1 (buffer #3) ▲ window #2 (buffer #4)
....
[[buffers_lines]]
=== Buffers lines
[[buffers]]
=== Buffers
[[lines_format]]
==== Format of lines
@@ -1108,11 +1129,11 @@ Tags commonly used (non-exhaustive list):
| no_filter | Line can not be filtered.
| no_highlight | No highlight is possible on line.
| no_log | Line is not written in log file.
| log0 ... log9 | Level of log for line (see `/help logger`).
| notify_none | Buffer with line is not added to hotlist.
| notify_message | Buffer with line is added to hotlist with level "message".
| notify_private | Buffer with line is added to hotlist with level "private".
| notify_highlight | Buffer with line is added to hotlist with level "highlight".
| log0 log9 | Level of log for line (see `/help logger`).
| notify_none | The line must not be added to hotlist. ^(1)^
| notify_message | The line is a user message. ^(1)^
| notify_private | The line is a private message. ^(1)^
| notify_highlight | The line is a message with highlight. ^(1)^
| self_msg | Self message.
| nick_xxx | Message is from nick "xxx".
| prefix_nick_ccc | Prefix is a nick with color "ccc".
@@ -1127,6 +1148,147 @@ Tags commonly used (non-exhaustive list):
| away_info | Message with away info.
|===
[NOTE]
^(1)^ When no tag "notify_xxx" is present, the default level is "low". If a tag
"notify_xxx" is present, the real notify level can be different, for example
if a max hotlist level is used for a nick, the notify level can be lower than
the value in the tag.
[[local_variables]]
==== Local variables
Local variables can be defined in all buffers.
A local variable has:
* a name (string)
* a value (string, can be empty).
Local variables can be set by WeeChat, plugins, scripts, or manually on the
command line in the buffer.
For example to add the local variable "completion_default_template":
----
/buffer setvar completion_default_template %(my_completion)
----
To list local variables in the current buffer:
----
/buffer listvar
----
To remove the local variable "completion_default_template":
----
/buffer delvar completion_default_template
----
By default WeeChat and its default plugins interpret these variables:
[width="100%",cols="^2m,2,5",options="header"]
|===
| Name | Value | Description
| away |
any string |
Away message on the server, set by irc plugin.
| channel |
any string |
Channel name, set by irc/xfer plugins and debug buffer of relay/trigger plugins.
| charset_modifier |
any string |
Charset modifier for the server buffer, set by irc plugin.
| completion_default_template |
any string |
Default completion template for the buffer, overriding the option
`weechat.completion.default_template`.
| filter |
any string |
Filter defined on some buffers like `/fset`, `/server raw` (irc) and `/script`.
| host |
any string |
Self host (if known), set by irc plugin.
| lag |
any string |
Lag on the server, set by irc plugin.
| name |
any string |
Buffer name (be careful, this is not the full name and this name is not
enough to identify or search a buffer).
| nick |
any string |
Self nick, set by irc and xfer plugins.
| no_log |
`1` (or any non-empty string) |
If set, the logger plugin does not log anything for the buffer.
| plugin |
any string |
Name of plugin which created the buffer (`core` for WeeChat buffers).
| script_close_cb |
any string |
Close callback defined by a script for a buffer.
| script_close_cb_data |
any string |
Data for close callback defined by a script for a buffer.
| script_input_cb |
any string |
Input callback defined by a script for a buffer.
| script_input_cb_data |
any string |
Data for input callback defined by a script for a buffer.
| script_name |
any string |
Name of the script which created the buffer.
| server |
any string |
Server name, set by irc plugin and debug buffer of relay/trigger plugins.
| spell_suggest |
any string |
Misspelled word and suggestions (format: "misspelled:suggestions"), set by
spell plugin.
| trigger_filter |
any string |
Trigger filter, set by trigger plugin.
| type |
any string, for example:
`channel`,
`debug`,
`exec`,
`option`,
`private`,
`relay`,
`script`,
`server`,
`user`,
`xfer` |
Type of buffer, set by WeeChat and many plugins.
|===
[NOTE]
External plugins and scripts can define and use other local variables.
[[bars]]
=== Bars
@@ -3061,7 +3223,7 @@ It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer localvar
/buffer listvar
----
Masks will be matched on options in descending order of specificity on
@@ -4002,7 +4164,7 @@ can be used in following options:
* _regex_
* _command_
The content of hashtables depend on the hook type.
The content of hashtables depends on the hook type.
A convenient way to see data in a trigger is to open trigger monitor buffer,
using the command:
@@ -4011,6 +4173,14 @@ using the command:
/trigger monitor
----
All callbacks set following variables in hashtable:
[width="100%",cols="3m,2,14",options="header"]
|===
| Variable | Type | Description
| tg_trigger_name | string | Name of trigger.
|===
[[trigger_data_signal]]
===== Signal
@@ -4019,8 +4189,8 @@ The "signal" callback sets following variables in hashtable:
[width="100%",cols="3m,2,14",options="header"]
|===
| Variable | Type | Description
| tg_signal | string | Name of signal
| tg_signal_data | string | Data sent with the signal
| tg_signal | string | Name of signal.
| tg_signal_data | string | Data sent with the signal.
|===
If the signal contains an IRC message, the message is parsed and following data
@@ -4180,8 +4350,9 @@ The "command" callback sets following variables in hashtable:
|===
| Variable | Type | Description
| buffer | pointer | Buffer.
| tg_argvN | string | Argument #N.
| tg_argv_eolN | string | From argument #N until end of arguments.
| tg_argc | string | The number of arguments (the command itself counts for one).
| tg_argvN | string | Argument #N (`+tg_argv0+` is the command itself, the others are command arguments).
| tg_argv_eolN | string | From argument #N until end of arguments (`+tg_argv_eol0+` includes the command itself).
|===
[[trigger_data_command_run]]
+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.
#
+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
+2 -2
View File
@@ -106,9 +106,9 @@
| weechat | locale | locale utilisée pour la traduction des messages | -
| weechat | nick_color | retourne le code couleur du pseudo | pseudo
| weechat | nick_color | retourne le code couleur du pseudo | pseudo;couleurs (couleurs est une liste de couleurs facultative, séparée par des virgules ; un fond est autorisé pour la couleur avec le format texte:fond ; si couleurs est présent, les options WeeChat avec les couleurs de pseudos et couleurs forcées de pseudos sons ignorées)
| weechat | nick_color_name | retourne le nom de la couleur du pseudo | pseudo
| weechat | nick_color_name | retourne le nom de la couleur du pseudo | pseudo;couleurs (couleurs est une liste de couleurs facultative, séparée par des virgules ; un fond est autorisé pour la couleur avec le format texte:fond ; si couleurs est présent, les options WeeChat avec les couleurs de pseudos et couleurs forcées de pseudos sons ignorées)
| weechat | pid | PID (ID de processus) de WeeChat | -
+86 -49
View File
@@ -17,71 +17,87 @@ cible : nom du serveur
* `+allchan+`: exécuter une commande sur tous les canaux de tous les serveurs connectés
----
/allchan [-current] [-exclude=<canal>[,<canal>...]] <commande> [<paramètres>]
[-current] [-include=<canal>[,<canal>...]] <commande> [<paramètres>]
/allchan [-current] [-exclude=<canal>[,<canal>...]] <commande>
[-current] [-include=<canal>[,<canal>...]] <commande>
-current : exécuter la commande pour les canaux du serveur courant seulement
-exclude : exclure certains canaux (le caractère joker "*" est autorisé)
-include : inclure seulement certains canaux (le caractère joker "*" est autorisé)
commande : commande à exécuter
paramètres : paramètres pour la commande (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$channel nom du canal
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
${irc_channel.xxx} variable xxx dans le canal
Exemples :
exécuter '/me teste' sur tous les canaux :
/allchan me teste
/allchan /me teste
dire 'bonjour' partout sauf sur #weechat :
/allchan -exclude=#weechat msg * bonjour
/allchan -exclude=#weechat bonjour
dire 'bonjour' partout sauf sur #weechat et les canaux commençant par #linux :
/allchan -exclude=#weechat,#linux* msg * bonjour
/allchan -exclude=#weechat,#linux* bonjour
dire 'bonjour' sur tous les canaux commençant par #linux :
/allchan -include=#linux* msg * bonjour
/allchan -include=#linux* bonjour
----
[[command_irc_allpv]]
* `+allpv+`: exécuter une commande sur tous les tampons privés de tous les serveurs connectés
----
/allpv [-current] [-exclude=<pseudo>[,<pseudo>...]] <commande> [<paramètres>]
[-current] [-include=<pseudo>[,<pseudo>...]] <commande> [<paramètres>]
/allpv [-current] [-exclude=<pseudo>[,<pseudo>...]] <commande>
[-current] [-include=<pseudo>[,<pseudo>...]] <commande>
-current : exécuter la commande pour les tampons privés du serveur courant seulement
-exclude : exclure certains pseudos (le caractère joker "*" est autorisé)
-include : inclure seulement certains pseudos (le caractère joker "*" est autorisé)
commande : commande à exécuter
paramètres : paramètres pour la commande (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$channel nom du canal
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
${irc_channel.xxx} variable xxx dans le canal
Exemples :
exécuter '/me teste' sur tous les tampons privés :
/allpv me teste
/allpv /me teste
dire 'bonjour' partout sauf sur pour le pseudo foo :
/allpv -exclude=foo msg * bonjour
/allpv -exclude=foo bonjour
dire 'bonjour' partout sauf pour le pseudo foo et les pseudos commençant par bar :
/allpv -exclude=foo,bar* msg * bonjour
/allpv -exclude=foo,bar* bonjour
dire 'bonjour' pour tous les pseudos commençant par bar :
/allpv -include=bar* msg * bonjour
/allpv -include=bar* bonjour
fermer tous les tampons privés :
/allpv close
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: exécuter une commande sur tous les serveurs connectés
----
/allserv [-exclude=<serveur>[,<serveur>...]] <commande> [<paramètres>]
[-include=<serveur>[,<serveur>...]] <commande> [<paramètres>]
/allserv [-exclude=<serveur>[,<serveur>...]] <commande>
[-include=<serveur>[,<serveur>...]] <commande>
-exclude : exclure certains serveurs (le caractère joker "*" est autorisé)
-include : inclure seulement certains serveurs (le caractère joker "*" est autorisé)
commande : commande à exécuter
paramètres : paramètres pour la commande (les variables spéciales $nick, $channel et $server sont remplacées par leur valeur)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
Exemples :
changer de pseudo sur tous les serveurs :
/allserv nick newnick
/allserv /nick newnick
positionner l'absence sur tous les serveurs :
/allserv away Je suis absent
/allserv /away Je suis absent
faire un whois sur mon pseudo sur tous les serveurs :
/allserv whois $nick
/allserv /whois $nick
----
[[command_irc_ban]]
@@ -203,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
@@ -916,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
@@ -1004,14 +1022,14 @@ 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 :
alias /split pour diviser la fenêtre horizontalement :
/alias add split /window splith
alias /hello pour dire "hello" sur tous les canaux mais pas sur #weechat :
/alias add hello /allchan -exclude=#weechat msg * hello
/alias add hello /allchan -exclude=#weechat hello
alias /forcejoin pour envoyer la commande IRC "forcejoin" avec la complétion de /sajoin :
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
@@ -1097,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>
@@ -1121,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 :
@@ -1279,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 :
@@ -1320,24 +1342,25 @@ Pour forcer une comparaison de chaînes, vous pouvez ajouter des guillemets auto
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")
2. une condition évaluée (format : "eval_cond:xxx")
3. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
4. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
5. 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.
6. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
7. une chaîne répétée (format : "repeat:nombre,chaîne")
8. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
9. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
10. un modificateur (format : "modifier:nom,données,chaîne")
11. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
12. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
13. la date/heure courante (format : "date" ou "date:format")
14. une variable d'environnement (format : "env:XXX")
15. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
16. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
17. une option (format : "fichier.section.option")
18. une variable locale du tampon
19. 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 :
@@ -1348,6 +1371,7 @@ Le format du hdata peut être le suivant :
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 ${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
@@ -1390,6 +1414,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
@@ -1400,6 +1425,7 @@ 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 :
@@ -2159,7 +2185,7 @@ charset : nouveau charset pour le tampon courant
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <nom>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] |-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <délai>] [-name <nom>] [-pipe <commande>] [-hsignal <nom>] <commande>
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <nom>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] |-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <délai>] [-name <nom>] [-pipe <commande>] [-hsignal <nom>] <commande>
-in <id> <texte>
-inclose <id> [<texte>]
-signal <id> <signal>
@@ -2181,6 +2207,7 @@ charset : nouveau charset pour le tampon courant
-oc : envoyer la sortie de la commande au tampon et exécuter les commandes (lignes commençant par "/" ou un caractère personnalisé de commande) (non compatible avec les options -bg/-pipe/-hsignal)
-n : afficher la sortie de la commande dans un nouveau tampon (non compatible avec les options -bg/-pipe/-hsignal)
-nf : afficher la sortie de la commande dans un nouveau tampon avec contenu libre (pas de coupure des mots, pas de limite sur le nombre de lignes) (non compatible avec les options -bg/-pipe/-hsignal)
-oerr : envoyer aussi stderr (sortie d'erreur) au tampon (peut être utilisé seulement avec les options -o et -oc)
-cl : effacer le nouveau tampon avant d'afficher la sortie
-nocl : ajouter au nouveau tampon sans effacer (par défaut)
-sw : basculer vers le tampon de sortie (par défaut)
@@ -2802,6 +2829,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
@@ -2931,7 +2968,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)
@@ -2616,6 +2616,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
@@ -3320,6 +3326,12 @@
** valeurs: -1 .. 525600
** valeur par défaut: `+1440+`
* [[option_script.scripts.download_enabled]] *script.scripts.download_enabled*
** description: pass:none[activer le téléchargement des fichiers depuis le dépôt des scripts lorsque la commande /script est utilisée (liste des scripts et les scripts eux-mêmes) ; la liste des scripts est téléchargée depuis l'URL spécifiée dans l'option script.scripts.url ; WeeChat téléchargera parfois à nouveau la liste des scripts quand vous utilisez la commande /script, même si vous n'installez pas un script]
** type: booléen
** valeurs: on, off
** valeur par défaut: `+off+`
* [[option_script.scripts.download_timeout]] *script.scripts.download_timeout*
** description: pass:none[délai d'attente maximum (en secondes) pour le téléchargement des scripts et de la liste des scripts]
** type: entier
@@ -3748,6 +3760,12 @@
** valeurs: toute chaîne
** valeur par défaut: `+"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:darkgray} -- ${min}..${max}${newline} ${empty_name} ${description}"+`
* [[option_fset.look.auto_refresh]] *fset.look.auto_refresh*
** description: pass:none[liste des options à rafraichir automatiquement sur le tampon fset (s'il est ouvert) ; "*" signifie toutes les options (recommandé), un nom commençant par "!" est une valeur négative pour empêcher une option d'être rafraichie, le caractère joker "*" est autorisé dans les noms (exemple : "*,!plugin.section.*")]
** type: chaîne
** valeurs: toute chaîne
** valeur par défaut: `+"*"+`
* [[option_fset.look.auto_unmark]] *fset.look.auto_unmark*
** description: pass:none[démarquer automatiquement toutes les options après une action sur les options marquées ou après un rafraichissement]
** type: booléen
+1 -1
View File
@@ -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".
+4 -3
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.
@@ -199,7 +199,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.
@@ -421,6 +421,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|             test-irc-mode.cpp | Tests : modes IRC.
|             test-irc-nick.cpp | Tests : pseudos IRC.
|             test-irc-protocol.cpp | Tests : protocole IRC.
|             test-irc-server.cpp | Tests : serveur IRC.
|          relay/ | Racine des tests unitaires pour l'extension Relay.
|             test-relay-auth.cpp | Tests : authentification des clients.
|===
@@ -495,7 +496,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.
*
+33 -5
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 ?
@@ -1093,7 +1121,7 @@ $ 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 :
@@ -1209,15 +1237,15 @@ Par exemple :
----
[[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
_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.
+85 -15
View File
@@ -1355,14 +1355,25 @@ Valeur de retour :
* même code retour que la fonction `regcomp` (0 si ok, autre valeur pour une
erreur, voir `man regcomp`)
[NOTE]
L'expression régulière _preg_ doit être nettoyée par un appel à "regfree" après
utilisation, si la fonction a retourné 0 (OK).
Exemple en C :
[source,C]
----
regex_t my_regex;
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) != 0)
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0)
{
/* OK */
/* ... */
regfree (&my_regex);
}
else
{
/* erreur */
/* ... */
}
----
@@ -1922,6 +1933,53 @@ str = weechat.string_format_size(size)
str = weechat.string_format_size(15200) # == "15.2 Ko"
----
==== string_color_code_size
_WeeChat ≥ 3.0._
Retourner la taille (en octets) du code couleur WeeChat au début de la chaîne.
Prototype :
[source,C]
----
int weechat_string_color_code_size (const char *string);
----
Paramètres :
* _string_ : chaîne
Valeur de retour :
* taille (en octets) du code couleur WeeChat au début de la chaîne ;
si la chaîne est NULL, vide ou ne commence pas avec un code couleur, 0 est retourné ;
si la chaîne commence par plusieurs codes couleur, seule la taille du premier est retournée
Exemples en C :
[source,C]
----
int size;
size = weechat_string_color_code_size ("test"); /* size == 0 */
size = weechat_string_color_code_size (weechat_color ("bold")); /* size == 2 */
size = weechat_string_color_code_size (weechat_color ("yellow,red")); /* size == 7 */
----
Script (Python) :
[source,python]
----
# prototype
size = weechat.string_color_code_size(string)
# exemples
size = weechat.string_color_code_size("test") # size == 0
size = weechat.string_color_code_size(weechat.color("bold")) # size == 2
size = weechat.string_color_code_size(weechat.color("yellow,red")) # size == 7
----
==== string_remove_color
Supprimer les couleurs WeeChat dans une chaîne.
@@ -2188,7 +2246,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
==== string_eval_expression
_WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8,
2.0, 2.2, 2.3, 2.7 et 2.9._
2.0, 2.2, 2.3, 2.7, 2.9 et 3.1._
Évaluer l'expression et retourner le résultat sous forme de chaîne.
Les variables spéciales avec le format `+${variable}+` sont étendues (voir le
@@ -2241,6 +2299,10 @@ Paramètres :
remplacer du texte dans _expr_ (_regex_replace_ est évalué sur chaque
correspondance de _regex_ sur _expr_, jusqu'à ce que plus aucune
correspondance ne soit trouvée)
** _debug_ : niveau de debug (chaîne avec un nombre entier ≥ 1), si activé,
une clé "debug_output" est ajoutée dans la table de hachage _options_ :
*** _1_ : activer le debug
*** _2_ : activer le debug plus verbeux
Valeur de retour :
@@ -2517,6 +2579,12 @@ première étendue à la dernière) :
`+19:02:45+` (avec des couleurs s'il y a des codes couleur dans l'option
weechat.look.buffer_time_format)
| `+${eval_cond:xxx}+` +
_(WeeChat ≥ 3.1)_ |
Chaîne à évaluer comme condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
`+${\xxx}+` +
_(WeeChat ≥ 1.0)_ |
@@ -2817,7 +2885,7 @@ Cette fonction n'est pas disponible dans l'API script.
==== string_dyn_concat
_WeeChat ≥ 1.8._
_WeeChat ≥ 1.8, mis à jour en 3.0._
Concaténer une chaîne dans une chaîne dynamique.
@@ -2828,13 +2896,16 @@ Prototype :
[source,C]
----
int weechat_string_dyn_concat (char **string, const char *add);
int weechat_string_dyn_concat (char **string, const char *add, int bytes);
----
Paramètres :
* _string_ : pointeur vers la chaîne dynamique
* _add_ : la chaîne à ajouter
* _bytes_ : nombre maximum d'octets de _add_ à concaténer, doit être inférieur
ou égal à la longueur de _add_ (-1 = automatique : concaténer la totalité de
la chaîne _add_) _(WeeChat ≥ 3.0)_
Valeur de retour :
@@ -2847,7 +2918,7 @@ Exemple en C :
char **string = weechat_string_dyn_alloc (256);
if (weechat_string_dyn_copy (string, "test"))
{
if (weechat_string_dyn_concat (string, "abc"))
if (weechat_string_dyn_concat (string, "abc", -1))
{
/* ... */
}
@@ -12370,8 +12441,7 @@ valeurs sont de type "string") :
| _chat | Indicateur zone "chat". |
"0" ou "1" | "0"
| _chat_line | Pointeur vers la ligne +
_(WeeChat ≥ 1.2)_. |
| _chat_line | Pointeur vers la ligne _(WeeChat ≥ 1.2)_. |
"0x1234abcd" | ""
| _chat_line_x | Colonne de la ligne ^(3)^. |
@@ -12425,8 +12495,7 @@ valeurs sont de type "string") :
| _bar_item_col | Colonne dans l'objet de barre. |
"0" ... "n" | "-1"
| _bar_window | Pointeur vers la fenêtre de barre +
_(WeeChat ≥ 2.9)_. |
| _bar_window | Pointeur vers la fenêtre de barre _(WeeChat ≥ 2.9)_. |
"0x1234abcd" | ""
|===
@@ -12442,13 +12511,14 @@ relâché). +
Informations additionnelles pour l'objet de barre "buffer_nicklist" :
[width="100%",cols="1,1,5",options="header"]
[width="100%",cols="^1,^1,5",options="header"]
|===
| Clé | Extension ^(1)^ | Description
| nick | core | Pseudonyme.
| prefix | core | Préfixe du pseudonyme.
| group | core | Nom du groupe.
| irc_host | irc | Nom d'hôte pour le pseudonyme (si connu).
| Extension ^(1)^ | Clé | Description
| irc | irc_nick | Pointeur vers le pseudo IRC _(WeeChat ≥ 3.0)_.
| irc | irc_host | Nom d'hôte pour le pseudonyme (si connu).
| weechat | nick | Pseudonyme.
| weechat | prefix | Préfixe du pseudonyme.
| weechat | group | Nom du groupe.
|===
[NOTE]
+2 -1
View File
@@ -565,6 +565,7 @@ Liste des fonctions de l'API script :
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
@@ -991,7 +992,7 @@ Pour voir les variables locales d'un tampon, exécutez cette commande dans
WeeChat :
----
/buffer localvar
/buffer listvar
----
[[hooks]]
+203 -23
View File
@@ -386,13 +386,14 @@ Suivez alors les instructions du paquet source (voir
Si vous avez eu des plantages, ou si vous souhaitez rapporter tout plantage
futur de WeeChat, vous devez :
* Compiler avec les infos de debug (ou installer un paquet binaire avec les
infos de debug).
* Compiler avec :
** les infos de debug (ou installer un paquet binaire avec les infos de debug),
** la vérification des adresses (« address sanitizer ») (facultatif).
* Activer les fichiers _core_ sur votre système.
* Installer gdb.
[[debug_info]]
==== Infos de debug
[[build_debug]]
==== Construction avec options de debug
Si vous compilez avec CMake :
@@ -400,10 +401,27 @@ Si vous compilez avec CMake :
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----
Si vous compilez avec les autotools, le debug est par défaut (`--with-debug=1`).
[[build_debug_address_sanitizer]]
==== Construction avec options de debug et la vérification des adresses
Si vous avez installé un paquet binaire, alors installez le paquet
_weechat-dbg_.
Vous pouvez aussi activer la vérification des adresses (« address sanitizer »),
ce qui provoquera immédiatement un plantage de WeeChat en cas de problème :
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
Vous ne devriez activer la vérification des adresses que si vous essayez de
provoquer un plantage, ceci n'est pas recommandé en production.
Une fois compilé et installé, vous devez lancer WeeChat comme ceci :
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
En cas de plantage, la trace est dans le fichier `asan.log`.
[[core_files]]
==== Fichiers core
@@ -545,7 +563,9 @@ Des variables d'environnement sont utilisées par WeeChat si elles sont définie
=== Fichiers et répertoires
WeeChat écrit ses fichiers de configuration et les autres données dans
`~/.weechat` par défaut.
`~/.weechat` par défaut. +
Ces fichiers sont créés avec les valeurs par défaut la première fois que vous
lancez WeeChat.
[[weechat_directories]]
==== Répertoires de WeeChat
@@ -604,7 +624,7 @@ Les fichiers dans le répertoire principal de WeeChat sont :
| perl.conf | Fichier de configuration de l'extension _perl_ | Non.
| php.conf | Fichier de configuration de l'extension _php_ | Non.
| python.conf | Fichier de configuration de l'extension _python_ | Non.
| relay.conf | Fichier de configuration de l'extension _relay_ | Non.
| relay.conf | Fichier de configuration de l'extension _relay_ | *Oui* : il peut contenir le mot de passe relay et le secret TOTP (si non stockés dans `sec.conf`), les adresses IP/origines websocket autorisées et les ports ouverts.
| ruby.conf | Fichier de configuration de l'extension _ruby_ | Non.
| script.conf | Fichier de configuration de l'extension _script_ | Non.
| tcl.conf | Fichier de configuration de l'extension _tcl_ | Non.
@@ -652,7 +672,7 @@ Exemple de terminal avec WeeChat :
│ │ │ │
│ │ │ │
│ │ │ │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [Act: 3:#abc(2,5), 5] │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]
│ │[@Flashy(i)] salut peter !█ │
└──────────────────────────────────────────────────────────────────────────────────────┘
▲ barres "status" et "input" barre "nicklist" ▲
@@ -704,7 +724,7 @@ La barre _status_ contient les objets (items) suivants par défaut :
| buffer_filter | `+*+` | Indicateur de filtrage : `+*+` signifie que des lignes sont filtrées (cachées), une valeur vide signifie que toutes les lignes sont affichées.
| scroll | `-PLUS(50)-` | Indicateur de scroll, avec le nombre de lignes sous la dernière ligne affichée.
| lag | `[Lag: 2.5]` | Indicateur de "lag" (ralentissements réseau), en secondes (caché si le lag est faible).
| hotlist | `[Act: 3:#abc(2,5), 5]` | Liste des tampons où il y a de l'activité (messages non lus) (dans cet exemple, 2 highlights et 5 messages non lus sur _#abc_, un message non lu sur le tampon numéro 5).
| hotlist | `[H: 3:#abc(2,5), 5]` | Liste des tampons où il y a de l'activité (messages non lus) (dans cet exemple, 2 highlights et 5 messages non lus sur _#abc_, un message non lu sur le tampon numéro 5).
| completion | `abc(2) def(5)` | Liste des mots pour la complétion, avec le nombre de complétions possibles pour chaque mot.
|===
@@ -1094,8 +1114,8 @@ Exemple de découpage vertical + horizontal :
▲ fenêtre n°1 (tampon n°3) ▲ fenêtre n°2 (tampon n°4)
....
[[buffers_lines]]
=== Lignes des tampons
[[buffers]]
=== Tampons
[[lines_format]]
==== Format des lignes
@@ -1138,11 +1158,11 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
| no_filter | La ligne ne peut pas être filtrée.
| no_highlight | Aucun highlight n'est possible sur cette ligne.
| no_log | La ligne n'est pas écrite dans le fichier de log.
| log0 ... log9 | Niveau de log pour la ligne (voir `/help logger`).
| notify_none | Le tampon avec la ligne ne sera pas ajouté à la "hotlist".
| notify_message | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "message".
| notify_private | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "private".
| notify_highlight | Le tampon avec la ligne sera ajouté à la "hotlist" avec le niveau "highlight".
| log0 log9 | Niveau de log pour la ligne (voir `/help logger`).
| notify_none | La ligne ne doit pas être ajoutée à la "hotlist". ^(1)^
| notify_message | La ligne est un message utilisateur. ^(1)^
| notify_private | La ligne est un message privé. ^(1)^
| notify_highlight | La ligne est un message avec un highlight. ^(1)^
| self_msg | Message de soi-même.
| nick_xxx | Le message vient du pseudo "xxx".
| prefix_nick_ccc | Le préfixe est un pseudo avec la couleur "ccc".
@@ -1157,6 +1177,156 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
| away_info | Message avec une info d'absence.
|===
[NOTE]
^(1)^ Lorsque aucune étiquette "notify_xxx" n'est présente, le niveau de
notification par défaut est "low". Si une étiquette "notify_xxx" est présente,
le niveau de notification réel peut être différent, par exemple si un niveau
maximum de hotlist est utilisé pour un pseudo, le niveau de notification peut
être inférieur à la valeur de l'étiquette.
[[local_variables]]
==== Variables locales
Des variables locales peuvent être définies dans les tampons.
Une variable locale a :
* un nom (chaîne)
* une valeur (chaîne, peut être vide).
Les variables locales peuvent être définies par WeeChat, les extensions, les
scripts, ou manuellement sur la ligne de commande, dans le tampon.
Par exemple pour ajouter la variable locale "completion_default_template" :
----
/buffer setvar completion_default_template %(my_completion)
----
Pour afficher les variables locales du tampon courant :
----
/buffer listvar
----
Pour supprimer la variable locale "completion_default_template" :
----
/buffer delvar completion_default_template
----
Par défaut WeeChat et ses extensions par défaut interprètent ces variables :
[width="100%",cols="^2m,2,5",options="header"]
|===
| Nom | Valeur | Description
| away |
toute chaîne |
Message d'absence sur le serveur, défini par l'extension irc.
| channel |
toute chaîne |
Nom du canal, défini par les extensions irc/xfer et le tampon de debug des
extensions relay/trigger.
| charset_modifier |
toute chaîne |
Modificateur de charset du tampon serveur, défini par l'extension irc.
| completion_default_template |
toute chaîne |
Modèle de complétion par défaut pour le tampon, qui remplace l'option
`weechat.completion.default_template`.
| filter |
toute chaîne |
Filtre défini sur certains tampons comme `/fset`, `/server raw` (irc) et
`/script`.
| host |
toute chaîne |
Nom d'hôte personnel (si connu), défini par l'extension irc.
| lag |
toute chaîne |
Lag sur le serveur, défini par l'extension irc.
| name |
toute chaîne |
Nom du tampon (attention, ce n'est pas le nom complet du tampon et ce nom
n'est pas suffisant pour identifier ou chercher un tampon).
| nick |
toute chaîne |
Pseudo personnel, défini par les extensions irc et xfer.
| no_log |
`1` (or any non-empty string) |
Si défini, l'extension logger n'écrira pas le "log" du tampon sur disque.
| plugin |
toute chaîne |
Nom de l'extension qui a créé le tampon (`core` pour les tampons WeeChat).
| script_close_cb |
toute chaîne |
Nom de la fonction de rappel pour la fermeture,
défini par un script pour le tampon.
| script_close_cb_data |
toute chaîne |
Données pour la fonction de rappel pour la fermeture,
définies par un script pour le tampon.
| script_input_cb |
toute chaîne |
Nom de la fonction de rappel d'entrée,
défini par un script pour le tampon.
| script_input_cb_data |
toute chaîne |
Données pour la fonction de rappel d'entrée,
définies par un script pour le tampon.
| script_name |
toute chaîne |
Nom du script qui a créé le tampon.
| server |
toute chaîne |
Nom du serveur, défini par l'extension irc et le tampon de debug des extensions
relay/trigger.
| spell_suggest |
toute chaîne |
Mot mal orthographié et ses suggestions (format : "mot:suggestions"), défini
par l'extension spell.
| trigger_filter |
toute chaîne |
Filtre trigger, défini par l'extension trigger.
| type |
toute chaîne, par exemple :
`channel`,
`debug`,
`exec`,
`option`,
`private`,
`relay`,
`script`,
`server`,
`user`,
`xfer` |
Type de tampon, défini par WeeChat et plusieurs extensions.
|===
[NOTE]
Les extensions et script externes peuvent définir et utiliser d'autres
variables locales.
[[bars]]
=== Barres
@@ -3161,7 +3331,7 @@ d'utiliser les variables locales du tampon pour construire le nom de fichier.
Pour voir les variables disponibles sur le tampon courant :
----
/buffer localvar
/buffer listvar
----
Les masques seront utilisés par ordre de priorité descendante sur
@@ -3291,7 +3461,7 @@ Ce mot de passe sera utilisé pour les protocoles _irc_ et _weechat_.
[[relay_totp]]
==== TOTP
TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le
TOTP (« Time-based One-Time Password » : mot de passe à usage unique basé sur le
temps) peut être utilisé comme second facteur d'authentification pour le protocole
_weechat_, en plus du mot de passe.
@@ -3308,7 +3478,7 @@ par exemple :
https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android],
https://itunes.apple.com/fr/app/google-authenticator/id388497605[iOS]
Le « secret » TOTP doit être défini dans WeeChat et dans l'application utilisée
Le « secret » TOTP doit être défini dans WeeChat et dans l'application utilisée
pour générer les mots de passe à usage unique.
Il doit être une chaîne encodée en base32, avec seulement des lettres et des
@@ -4144,6 +4314,15 @@ moniteur des triggers :
/trigger monitor
----
Toutes les fonctions de rappel définissent les variables suivantes dans la table
de hachage :
[width="100%",cols="3m,2,14",options="header"]
|===
| Variable | Type | Description
| tg_trigger_name | chaîne | Nom du trigger.
|===
[[trigger_data_signal]]
===== Signal
@@ -4322,8 +4501,9 @@ de hachage :
|===
| Variable | Type | Description
| buffer | pointeur | Tampon.
| tg_argvN | chaîne | Paramètre n°N.
| tg_argv_eolN | chaîne | Depuis le paramètre n°N jusqu'à la fin des paramètres.
| tg_argc | chaîne | Nombre de paramètres (la commande elle-même compte pour un).
| tg_argvN | chaîne | Paramètre n°N (`+tg_argv0+` est la commande elle-même, les autres sont les paramètres de la commande).
| tg_argv_eolN | chaîne | Depuis le paramètre n°N jusqu'à la fin des paramètres (`+tg_argv_eol0+` inclut la commande elle-même).
|===
[[trigger_data_command_run]]
+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.
#
@@ -120,6 +120,10 @@
| weechat | bars_options | opzioni per le barre
| weechat | buffer_local_variable_value | value of a buffer local variable
| weechat | buffer_local_variables | buffer local variables
| weechat | buffer_properties_get | proprietà che possono essere lette su un buffer
| weechat | buffer_properties_set | proprietà che possono essere impostate su un buffer
+2 -2
View File
@@ -106,9 +106,9 @@
| weechat | locale | locale usato per la traduzione dei messaggi | -
| weechat | nick_color | ottiene il codice del colore del nick | nick
| weechat | nick_color | ottiene il codice del colore del nick | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | nick_color_name | ottiene il nome del colore del nick | nick
| weechat | nick_color_name | ottiene il nome del colore del nick | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | pid | WeeChat PID (process ID) | -
+87 -50
View File
@@ -17,71 +17,87 @@ destinazione: nome server
* `+allchan+`: esegue un comando su tutti i canali di tutti i server connessi
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command> [<arguments>]
[-current] -include=<channel>[,<channel>...] <command> [<arguments>]
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command>
[-current] -include=<channel>[,<channel>...] <command>
-current: execute command for channels of current server only
-exclude: exclude some channels (wildcard "*" is allowed)
-include: include only some channels (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all channels:
/allchan me is testing
/allchan /me is testing
say 'hello' everywhere but not on #weechat:
/allchan -exclude=#weechat msg * hello
/allchan -exclude=#weechat hello
say 'hello' everywhere but not on #weechat and channels beginning with #linux:
/allchan -exclude=#weechat,#linux* msg * hello
/allchan -exclude=#weechat,#linux* hello
say 'hello' on all channels beginning with #linux:
/allchan -include=#linux* msg * hello
/allchan -include=#linux* hello
----
[[command_irc_allpv]]
* `+allpv+`: execute a command on all private buffers of all connected servers
----
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command> [<arguments>]
[-current] -include=<nick>[,<nick>...] <command> [<arguments>]
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command>
[-current] -include=<nick>[,<nick>...] <command>
-current: execute command for private buffers of current server only
-exclude: exclude some nicks (wildcard "*" is allowed)
-include: include only some nicks (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all private buffers:
/allpv me is testing
/allpv /me is testing
say 'hello' everywhere but not for nick foo:
/allpv -exclude=foo msg * hello
/allpv -exclude=foo hello
say 'hello' everywhere but not for nick foo and nicks beginning with bar:
/allpv -exclude=foo,bar* msg * hello
/allpv -exclude=foo,bar* hello
say 'hello' for all nicks beginning with bar:
/allpv -include=bar* msg * hello
/allpv -include=bar* hello
close all private buffers:
/allpv close
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: esegue un comando su tutti i server connessi
----
/allserv [-exclude=<server>[,<server>...]] <command> [<arguments>]
-include=<server>[,<server>...] <command> [<arguments>]
/allserv [-exclude=<server>[,<server>...]] <command>
-include=<server>[,<server>...] <command>
-exclude: exclude some servers (wildcard "*" is allowed)
-include: include only some servers (wildcard "*" is allowed)
command: command to execute
arguments: arguments for command (special variables $nick, $channel and $server are replaced by their value)
command: command to execute (or text to send to buffer if command does not start with '/')
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$nick nick on server
${irc_server.xxx} variable xxx in server
Examples:
change nick on all servers:
/allserv nick newnick
/allserv /nick newnick
set away on all servers:
/allserv away I'm away
/allserv /away I'm away
do a whois on my nick on all servers:
/allserv whois $nick
/allserv /whois $nick
----
[[command_irc_ban]]
@@ -203,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
@@ -916,6 +933,7 @@ target: server name
----
/voice <nick> [<nick>...]
* -yes
nick: nick or mask (wildcard "*" is allowed)
*: give voice to everybody on channel
@@ -1004,14 +1022,14 @@ 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:
alias /split to split window horizontally:
/alias add split /window splith
alias /hello to say "hello" on all channels but not on #weechat:
/alias add hello /allchan -exclude=#weechat msg * hello
/alias add hello /allchan -exclude=#weechat hello
alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
@@ -1097,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>
@@ -1121,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
@@ -1280,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:
@@ -1320,24 +1342,25 @@ To force a string comparison, you can add double quotes around each expression,
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")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. 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.
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. 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:
@@ -1348,6 +1371,7 @@ Format for hdata can be one of following:
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
/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
@@ -1390,6 +1414,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
@@ -1400,6 +1425,7 @@ 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:
@@ -2159,7 +2185,7 @@ set_caratteri: nuovo set di caratteri per il buffer corrente
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
-in <id> <text>
-inclose <id> [<text>]
-signal <id> <signal>
@@ -2181,6 +2207,7 @@ set_caratteri: nuovo set di caratteri per il buffer corrente
-oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
-n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
-nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
-oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
-cl: clear the new buffer before displaying output
-nocl: append to the new buffer without clear (default)
-sw: switch to the output buffer (default)
@@ -2802,6 +2829,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
@@ -2931,7 +2968,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)
@@ -2616,6 +2616,12 @@
** valori: 1 .. 3600
** valore predefinito: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** descrizione: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** descrizione: pass:none[usa il protocollo IPv6 per le comunicazioni con il server (prova con IPv6, se non disponibile usa IPv4); se disabilitato, viene usato solo IPv4]
** tipo: bool
@@ -3320,6 +3326,12 @@
** valori: -1 .. 525600
** valore predefinito: `+1440+`
* [[option_script.scripts.download_enabled]] *script.scripts.download_enabled*
** descrizione: pass:none[enable download of files from the scripts repository when the /script command is used (list of scripts and scripts themselves); the list of scripts is downloaded from the URL specified in the option script.scripts.url; WeeChat will sometimes download again the list of scripts when you use the /script command, even if you don't install a script]
** tipo: bool
** valori: on, off
** valore predefinito: `+off+`
* [[option_script.scripts.download_timeout]] *script.scripts.download_timeout*
** descrizione: pass:none[timeout (in seconds) for download of scripts and list of scripts]
** tipo: intero
@@ -3748,6 +3760,12 @@
** valori: qualsiasi stringa
** valore predefinito: `+"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:darkgray} -- ${min}..${max}${newline} ${empty_name} ${description}"+`
* [[option_fset.look.auto_refresh]] *fset.look.auto_refresh*
** descrizione: pass:none[comma separated list of options to automatically refresh on the fset buffer (if opened); "*" means all options (recommended), a name beginning with "!" is a negative value to prevent an option to be refreshed, wildcard "*" is allowed in names (example: "*,!plugin.section.*")]
** tipo: stringa
** valori: qualsiasi stringa
** valore predefinito: `+"*"+`
* [[option_fset.look.auto_unmark]] *fset.look.auto_unmark*
** descrizione: pass:none[automatically unmark all options after an action on marked options or after a refresh]
** tipo: bool
+1 -1
View File
@@ -100,7 +100,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
+32 -3
View File
@@ -256,6 +256,35 @@ For example to use kbd:[F1], kbd:[F2], kbd:[Alt+F1] and kbd:[Alt+F2]:
I tasti "meta-OP" e "meta-OQ" possono essere differenti nel proprio terminale.
Per trovare il codice tasto digitare kbd:[Alt+k] poi il tast.
// TRANSLATION MISSING
[[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]]
=== Come si può ridurre la lunghezza dei nick o rimuovere l'allineamento nella finestra di chat?
@@ -1268,9 +1297,9 @@ For example:
You can share files _~/.weechat/*.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).
// TRANSLATION MISSING
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.it.html#files_and_directories[User's guide / Files and directories]
for more information about configuration files.
+93 -15
View File
@@ -1400,14 +1400,26 @@ Valore restituito:
* same return code as function `regcomp` (0 if ok, other value for error,
see `man regcomp`)
[NOTE]
// TRANSLATION MISSING
Regular expression _preg_ must be cleaned by calling "regfree" after use,
if the function returned 0 (OK).
Esempio in C:
[source,C]
----
regex_t my_regex;
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) != 0)
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0)
{
/* OK */
/* ... */
regfree (&my_regex);
}
else
{
/* error */
/* ... */
}
----
@@ -1967,6 +1979,57 @@ str = weechat.string_format_size(size)
str = weechat.string_format_size(15200) # == "15.2 KB"
----
==== string_color_code_size
_WeeChat ≥ 3.0._
// TRANSLATION MISSING
Return the size (in bytes) of the WeeChat color code at the beginning of
the string.
Prototipo:
[source,C]
----
int weechat_string_color_code_size (const char *string);
----
Argomenti:
* _string_: stringa
Valore restituito:
// TRANSLATION MISSING
* size (in bytes) of the WeeChat color code at the beginning of the string;
if the string is NULL, empty or does not start with a color code, 0 is returned;
if the string begins with multiple color codes, only the size of the first one
is returned
Esempi:
[source,C]
----
int size;
size = weechat_string_color_code_size ("test"); /* size == 0 */
size = weechat_string_color_code_size (weechat_color ("bold")); /* size == 2 */
size = weechat_string_color_code_size (weechat_color ("yellow,red")); /* size == 7 */
----
Script (Python):
[source,python]
----
# prototipo
size = weechat.string_color_code_size(string)
# esempio
size = weechat.string_color_code_size("test") # size == 0
size = weechat.string_color_code_size(weechat.color("bold")) # size == 2
size = weechat.string_color_code_size(weechat.color("yellow,red")) # size == 7
----
==== string_remove_color
Rimuove i colori di WeeChat da una stringa.
@@ -2243,7 +2306,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
// TRANSLATION MISSING
_WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8, 2.0,
2.2, 2.3, 2.7 and 2.9._
2.2, 2.3, 2.7, 2.9 and 3.1._
// TRANSLATION MISSING
Evaluate an expression and return result as a string.
@@ -2294,6 +2357,11 @@ Argomenti:
** _regex_replace_: the replacement text to use with _regex_, to replace
text in _expr_ (the _regex_replace_ is evaluated on each match of _regex_
against _expr_, until no match is found)
// TRANSLATION MISSING
** _debug_: debug level (string with integer number ≥ 1), if enabled, a key
"debug_output" is added in hashtable _options_:
*** _1_: enable debug
*** _2_: enable more verbose debug
Valore restituito:
@@ -2580,6 +2648,12 @@ expanded to last):
`+19:02:45+` (with colors if there are color codes in the option
weechat.look.buffer_time_format)
| `+${eval_cond:xxx}+` +
_(WeeChat ≥ 3.1)_ |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
`+${\xxx}+` +
_(WeeChat ≥ 1.0)_ |
@@ -2887,7 +2961,8 @@ Questa funzione non è disponibile nelle API per lo scripting.
==== string_dyn_concat
_WeeChat ≥ 1.8._
// TRANSLATION MISSING
_WeeChat ≥ 1.8, updated in 3.0._
// TRANSLATION MISSING
Concatenate a string to a dynamic string.
@@ -2900,7 +2975,7 @@ Prototipo:
[source,C]
----
int weechat_string_dyn_concat (char **string, const char *add);
int weechat_string_dyn_concat (char **string, const char *add, int bytes);
----
Argomenti:
@@ -2908,6 +2983,9 @@ Argomenti:
// TRANSLATION MISSING
* _string_: pointer to dynamic string
* _add_: the string to add
* _bytes_: max number of bytes in _add_ to concatenate, must be lower or equal
to length of _add_ (-1 = automatic: concatenate whole string _add_)
_(WeeChat ≥ 3.0)_
Valore restituito:
@@ -2921,7 +2999,7 @@ Esempio in C:
char **string = weechat_string_dyn_alloc (256);
if (weechat_string_dyn_copy (string, "test"))
{
if (weechat_string_dyn_concat (string, "abc"))
if (weechat_string_dyn_concat (string, "abc", -1))
{
/* ... */
}
@@ -12599,8 +12677,7 @@ Contenuto della tabella hash inviata alla callback (tasti e valori sono di tipo
"0" o "1" | "0"
// TRANSLATION MISSING
| _chat_line | Pointer to line +
_(WeeChat ≥ 1.2)_. |
| _chat_line | Pointer to line _(WeeChat ≥ 1.2)_. |
"0x1234abcd" | ""
| _chat_line_x | Colonna nella riga ^(3)^. |
@@ -12657,8 +12734,7 @@ Contenuto della tabella hash inviata alla callback (tasti e valori sono di tipo
"0" ... "n" | "-1"
// TRANSLATION MISSING
| _bar_window | Pointer to bar window +
_(WeeChat ≥ 2.9)_. |
| _bar_window | Pointer to bar window _(WeeChat ≥ 2.9)_. |
"0x1234abcd" | ""
|===
@@ -12673,13 +12749,15 @@ per sapere dove il pulsante del mouse è stato rilasciato). +
Informazioni aggiuntive per l'elemento barra "buffer_nicklist":
[width="100%",cols="1,1,5",options="header"]
[width="100%",cols="^1,^1,5",options="header"]
|===
| Chiave | Plugin ^(1)^ | Descrizione
| nick | core | Nick.
| prefix | core | Prefisso per il nick.
| group | core | Nome gruppo.
| irc_host | irc | Host per il nick (se conosciuto).
| Plugin ^(1)^ | Chiave | Descrizione
// TRANSLATION MISSING
| irc | irc_nick | Pointer to IRC nick _(WeeChat ≥ 3.0)_.
| irc | irc_host | Host per il nick (se conosciuto).
| weechat | nick | Nick.
| weechat | prefix | Prefisso per il nick.
| weechat | group | Nome gruppo.
|===
[NOTE]
+2 -1
View File
@@ -575,6 +575,7 @@ Elenco di funzioni nelle API per gli script:
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
@@ -1003,7 +1004,7 @@ Per impostare le variabili locali di un buffer, digitare questo comando
in WeeChat:
----
/buffer localvar
/buffer listvar
----
[[hooks]]
+207 -20
View File
@@ -416,13 +416,17 @@ Poi seguire le istruzioni per i sorgenti (consultare
Nel caso in cui si verifichino errori, o si desideri segnalare qualsiasi errore
futuro di WeeChat, è necessario:
* compilarlo con informazioni di debug (o installare il pacchetto binario con
le informazioni di debug)
// TRANSLATION MISSING
* compile with:
** informazioni di debug (o installare il pacchetto binario con le informazioni di debug)
// TRANSLATION MISSING
** address sanitizer (optional)
* abilitare i file _core_ sul proprio sistema
* installare gdb
[[debug_info]]
==== Informazioni di debug
// TRANSLATION MISSING
[[build_debug]]
==== Build with debug options
Se si compila con CMake:
@@ -430,9 +434,32 @@ Se si compila con CMake:
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----
Se compilato con gli autotools, il debug è attivato automaticamente (`--with-debug=1`).
// TRANSLATION MISSING
[[build_debug_address_sanitizer]]
==== Build with debug options and address sanitizer
Se è stato installato il pacchetto binario, installare il pacchetto _weechat-gdb_.
// TRANSLATION MISSING
You can additionally enable the address sanitizer, which causes WeeChat to
crash immediately in case of problem:
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
// TRANSLATION MISSING
[WARNING]
You should enable address sanitizer only if you're trying to cause a crash,
this is not recommended in production.
// TRANSLATION MISSING
Then once compiled and installed, you must run WeeChat like this:
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
// TRANSLATION MISSING
In case of crash, the backtrace is in file `asan.log`.
[[core_files]]
==== File core
@@ -581,7 +608,8 @@ Some environment variables are used by WeeChat if they are defined:
=== Files and directories
WeeChat writes configuration files and other data in directory `~/.weechat`
by default.
by default. +
These files are created with default values the first time you run WeeChat.
[[weechat_directories]]
==== WeeChat directories
@@ -639,7 +667,8 @@ The files in the WeeChat home directory are:
| perl.conf | Configuration file for _perl_ plugin | No.
| php.conf | Configuration file for _php_ plugin | No.
| python.conf | Configuration file for _python_ plugin | No.
| relay.conf | Configuration file for _relay_ plugin | No.
// TRANSLATION MISSING
| relay.conf | Configuration file for _relay_ plugin | *Yes*: it can contain relay password and TOTP secret (if not stored in `sec.conf`), allowed IP addresses/websocket origins and opened ports.
| ruby.conf | Configuration file for _ruby_ plugin | No.
| script.conf | Configuration file for _script_ plugin | No.
| spell.conf | Configuration file for _spell_ plugin | No.
@@ -688,7 +717,7 @@ Esempio di terminale con WeeChat:
│ │ │ │
│ │ │ │
│ │ │ │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [Act: 3:#abc(2,5), 5] │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]
│ │[@Flashy(i)] hi peter!█ │
└──────────────────────────────────────────────────────────────────────────────────────┘
▲ bars "status" and "input" bar "nicklist" ▲
@@ -745,7 +774,7 @@ La barra _status_ ha i seguenti elementi predefiniti:
| buffer_filter | `+*+` | Indicatore filtraggio: `+*+` significa che alcune righe sono filtrate (nascoste), valori vuoti indicano che tutte le righe sono visualizzate.
| scroll | `-ANCORA(50)-` | Indicatore di scorrimento, con il numero di righe sotto l'ultima riga visualizzata.
| lag | `[Ritardo: 2.5]` | Indicatore ritardo, in secondi (nascosto se il ritardo è basso).
| hotlist | `[Act: 3:#abc(2,5), 5]` | Elenco dei buffer con attività (messaggi non letti) (nell'esempio, 2 notifiche e 5 messaggi non letti su #abc, un messaggio non letto sul buffer #5).
| hotlist | `[H: 3:#abc(2,5), 5]` | Elenco dei buffer con attività (messaggi non letti) (nell'esempio, 2 notifiche e 5 messaggi non letti su #abc, un messaggio non letto sul buffer #5).
| completion | `abc(2) def(5)` | Elenco di parole per il completamento, con il numero di completamenti possibili per ogni parola.
|===
@@ -1145,8 +1174,8 @@ Esempio di split orizzontale + verticale:
....
// TRANSLATION MISSING
[[buffers_lines]]
=== Buffers lines
[[buffers]]
=== Buffers
[[lines_format]]
==== Format of lines
@@ -1188,11 +1217,15 @@ Tag usati di frequente (elenco non esaustivo):
| no_filter | La riga non può essere filtrata.
| no_highlight | Evidenziazione non possibile sulla riga.
| no_log | La riga non viene scritta nel file di log.
| log0 ... log9 | Livello di log per la riga (consultare `/help logger`).
| notify_none | Il buffer con la riga non viene aggiunto alla hotlist.
| notify_message | Il buffer con la riga viene aggiunto alla hotlist con il livello "message".
| notify_private | Il buffer con la riga viene aggiunto alla hotlist con il livello "private".
| notify_highlight | Il buffer con la riga viene aggiunto alla hotlist con il livello "higlight".
| log0 log9 | Livello di log per la riga (consultare `/help logger`).
// TRANSLATION MISSING
| notify_none | The line must not be added to hotlist. ^(1)^
// TRANSLATION MISSING
| notify_message | The line is a user message. ^(1)^
// TRANSLATION MISSING
| notify_private | The line is a private message. ^(1)^
// TRANSLATION MISSING
| notify_highlight | The line is a message with highlight. ^(1)^
// TRANSLATION MISSING
| self_msg | Self message.
| nick_xxx | Il messaggio viene dal nick "xxx".
@@ -1209,6 +1242,149 @@ Tag usati di frequente (elenco non esaustivo):
| away_info | Messagio con informazioni sull'assenza.
|===
// TRANSLATION MISSING
[NOTE]
^(1)^ When no tag "notify_xxx" is present, the default level is "low". If a tag
"notify_xxx" is present, the real notify level can be different, for example
if a max hotlist level is used for a nick, the notify level can be lower than
the value in the tag.
// TRANSLATION MISSING
[[local_variables]]
==== Local variables
Local variables can be defined in all buffers.
A local variable has:
* a name (string)
* a value (string, can be empty).
Local variables can be set by WeeChat, plugins, scripts, or manually on the
command line in the buffer.
For example to add the local variable "completion_default_template":
----
/buffer setvar completion_default_template %(my_completion)
----
To list local variables in the current buffer:
----
/buffer listvar
----
To remove the local variable "completion_default_template":
----
/buffer delvar completion_default_template
----
By default WeeChat and its default plugins interpret these variables:
[width="100%",cols="^2m,2,5",options="header"]
|===
| Name | Value | Description
| away |
any string |
Away message on the server, set by irc plugin.
| channel |
any string |
Channel name, set by irc/xfer plugins and debug buffer of relay/trigger plugins.
| charset_modifier |
any string |
Charset modifier for the server buffer, set by irc plugin.
| completion_default_template |
any string |
Default completion template for the buffer, overriding the option
`weechat.completion.default_template`.
| filter |
any string |
Filter defined on some buffers like `/fset`, `/server raw` (irc) and `/script`.
| host |
any string |
Self host (if known), set by irc plugin.
| lag |
any string |
Lag on the server, set by irc plugin.
| name |
any string |
Buffer name (be careful, this is not the full name and this name is not
enough to identify or search a buffer).
| nick |
any string |
Self nick, set by irc and xfer plugins.
| no_log |
`1` (or any non-empty string) |
If set, the logger plugin does not log anything for the buffer.
| plugin |
any string |
Name of plugin which created the buffer (`core` for WeeChat buffers).
| script_close_cb |
any string |
Close callback defined by a script for a buffer.
| script_close_cb_data |
any string |
Data for close callback defined by a script for a buffer.
| script_input_cb |
any string |
Input callback defined by a script for a buffer.
| script_input_cb_data |
any string |
Data for input callback defined by a script for a buffer.
| script_name |
any string |
Name of the script which created the buffer.
| server |
any string |
Server name, set by irc plugin and debug buffer of relay/trigger plugins.
| spell_suggest |
any string |
Misspelled word and suggestions (format: "misspelled:suggestions"), set by
spell plugin.
| trigger_filter |
any string |
Trigger filter, set by trigger plugin.
| type |
any string, for example:
`channel`,
`debug`,
`exec`,
`option`,
`private`,
`relay`,
`script`,
`server`,
`user`,
`xfer` |
Type of buffer, set by WeeChat and many plugins.
|===
[NOTE]
External plugins and scripts can define and use other local variables.
// TRANSLATION MISSING
[[bars]]
=== Bars
@@ -3292,7 +3468,7 @@ le variabili buffer locali per costruire il nome del file. To see available
local variables for current buffer:
----
/buffer localvar
/buffer listvar
----
// TRANSLATION MISSING
@@ -4307,6 +4483,16 @@ using the command:
/trigger monitor
----
// TRANSLATION MISSING
All callbacks set following variables in hashtable:
// TRANSLATION MISSING
[width="100%",cols="3m,2,14",options="header"]
|===
| Variable | Type | Description
| tg_trigger_name | string | Name of trigger.
|===
[[trigger_data_signal]]
===== Signal
@@ -4477,8 +4663,9 @@ The "command" callback sets following variables in hashtable:
|===
| Variable | Type | Description
| buffer | pointer | Buffer.
| tg_argvN | string | Argument #N.
| tg_argv_eolN | string | From argument #N until end of arguments.
| tg_argc | string | The number of arguments (the command itself counts for one).
| tg_argvN | string | Argument #N (`+tg_argv0+` is the command itself, the others are command arguments).
| tg_argv_eolN | string | From argument #N until end of arguments (`+tg_argv_eol0+` includes the command itself).
|===
[[trigger_data_command_run]]
+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-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/ja/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.ja.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.ja.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.ja.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.ja.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (ja)"
)
add_custom_target(doc-man-weechat-headless-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/ja/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.ja.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.ja.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.ja.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.ja.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (ja)"
)
add_custom_target(doc-man-weechat-headless-ja ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/ja/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.
#
@@ -120,6 +120,10 @@
| weechat | bars_options | バーのオプション
| weechat | buffer_local_variable_value | value of a buffer local variable
| weechat | buffer_local_variables | buffer local variables
| weechat | buffer_properties_get | バッファから読み取り可能なプロパティ
| weechat | buffer_properties_set | バッファに指定可能なプロパティ
+2 -2
View File
@@ -106,9 +106,9 @@
| weechat | locale | 翻訳メッセージに利用するロケール | -
| weechat | nick_color | ニックネームの色コードを取得 | ニックネーム
| weechat | nick_color | ニックネームの色コードを取得 | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | nick_color_name | ニックネームの色名を取得 | ニックネーム
| weechat | nick_color_name | ニックネームの色名を取得 | nickname;colors (colors is an optional comma-separated list of colors to use; background is allowed for a color with format text:background; if colors is present, WeeChat options with nick colors and forced nick colors are ignored)
| weechat | pid | WeeChat の PID (プロセス ID) | -
+219 -182
View File
@@ -17,71 +17,87 @@ target: サーバ名
* `+allchan+`: 全てのサーバ、全てのチャンネルに対してコマンドを実行
----
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command> [<arguments>]
[-current] -include=<channel>[,<channel>...] <command> [<arguments>]
/allchan [-current] [-exclude=<channel>[,<channel>...]] <command>
[-current] -include=<channel>[,<channel>...] <command>
-current: 現在のサーバ上のチャンネルに対してコマンドを実行
-exclude: 一部のチャンネルを除く全てのチャンネルに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
-include: 一部のチャンネルに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
command: 実行するコマンド
arguments: コマンドの引数 (特殊変数 $nick、$channel、$server はそれぞれの値に置き換えられます)
-current: execute command for channels of current server only
-exclude: exclude some channels (wildcard "*" is allowed)
-include: include only some channels (wildcard "*" is allowed)
command: command to execute (or text to send to buffer if command does not start with '/')
:
全てのチャンネルに対して '/me is testing' を実行:
/allchan me is testing
チャンネル名が #weechat のチャンネルを除く全てのチャンネルに対して 'hello' と発言:
/allchan -exclude=#weechat msg * hello
チャンネル名が #weechat と #linux で始まるチャンネルを除く全てのチャンネルに対して 'hello' と発言:
/allchan -exclude=#weechat,#linux* msg * hello
チャンネル名が #linux で始まるチャンネルに対して 'hello' と発言:
/allchan -include=#linux* msg * hello
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all channels:
/allchan /me is testing
say 'hello' everywhere but not on #weechat:
/allchan -exclude=#weechat hello
say 'hello' everywhere but not on #weechat and channels beginning with #linux:
/allchan -exclude=#weechat,#linux* hello
say 'hello' on all channels beginning with #linux:
/allchan -include=#linux* hello
----
[[command_irc_allpv]]
* `+allpv+`: 全ての接続済みサーバの全てのプライベートバッファに対してコマンドを実行
----
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command> [<arguments>]
[-current] -include=<nick>[,<nick>...] <command> [<arguments>]
/allpv [-current] [-exclude=<nick>[,<nick>...]] <command>
[-current] -include=<nick>[,<nick>...] <command>
-current: 現在のサーバ上の全てのプライベートバッファに対してコマンドを実行
-exclude: 一部のニックネームを除外した全てのプライベートバッファに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
-include: 一部のニックネームのプライベートバッファに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
command: 実行するコマンド
arguments: コマンドの引数 (特殊変数 $nick、$channel、$server はそれぞれの値に置き換えられます)
-current: execute command for private buffers of current server only
-exclude: exclude some nicks (wildcard "*" is allowed)
-include: include only some nicks (wildcard "*" is allowed)
command: command to execute (or text to send to buffer if command does not start with '/')
:
全てのプライベートバッファに対して '/me is testing' を実行:
/allpv me is testing
ニックネーム foo を除く全てのプライベートバッファに対して 'hello' と発言:
/allpv -exclude=foo msg * hello
ニックネームが foo と bar で始まるニックネームを除く全てのプライベートバッファに対して 'hello' と発言:
/allpv -exclude=foo,bar* msg * hello
ニックネームが bar で始まるニックネームのプライベートバッファに対して 'hello' と発言:
/allpv -include=bar* msg * hello
全てのプライベートバッファを閉じる:
/allpv close
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$channel channel name
$nick nick on server
${irc_server.xxx} variable xxx in server
${irc_channel.xxx} variable xxx in channel
Examples:
execute '/me is testing' on all private buffers:
/allpv /me is testing
say 'hello' everywhere but not for nick foo:
/allpv -exclude=foo hello
say 'hello' everywhere but not for nick foo and nicks beginning with bar:
/allpv -exclude=foo,bar* hello
say 'hello' for all nicks beginning with bar:
/allpv -include=bar* hello
close all private buffers:
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: 全ての接続済みサーバでコマンドを実行
----
/allserv [-exclude=<server>[,<server>...]] <command> [<arguments>]
-include=<server>[,<server>...] <command> [<arguments>]
/allserv [-exclude=<server>[,<server>...]] <command>
-include=<server>[,<server>...] <command>
-exclude: 一部のサーバを除く全てのサーバに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
-include: 一部のサーバのみに対してコマンドを実行 (ワイルドカード "*" を使うことができます)
command: 実行するコマンド
arguments: コマンドの引数 (特殊変数 $nick、$channel、$server はそれぞれの値に置き換えられます)
-exclude: exclude some servers (wildcard "*" is allowed)
-include: include only some servers (wildcard "*" is allowed)
command: command to execute (or text to send to buffer if command does not start with '/')
:
全てのサーバに対してニックネーム変更:
/allserv nick newnick
全てのサーバに対して離席状態を変更:
/allserv away I'm away
全てのサーバに対して自分のニックネームに関する whois を実行:
/allserv whois $nick
Command and arguments are evaluated (see /help eval), the following variables are replaced:
$server server name
$nick nick on server
${irc_server.xxx} variable xxx in server
Examples:
change nick on all servers:
/allserv /nick newnick
set away on all servers:
/allserv /away I'm away
do a whois on my nick on all servers:
/allserv /whois $nick
----
[[command_irc_ban]]
@@ -203,6 +219,7 @@ file: ファイル名 (ローカルホスト上の)
----
/dehalfop <nick> [<nick>...]
* -yes
nick: ニックネームまたはマスク (ワイルドカード "*" を使うことができます)
*: 自分以外のチャンネル参加者からチャンネルの half-operator 権を剥奪
@@ -916,6 +933,7 @@ target: サーバ名
----
/voice <nick> [<nick>...]
* -yes
nick: ニックネームまたはマスク (ワイルドカード "*" を使うことができます)
*: チャンネル参加者全員に voice 権を付与
@@ -988,31 +1006,31 @@ target: マスクに一致するものだけを返す
addcompletion <completion> <alias> [<command>[;<command>...]]
del <alias> [<alias>...]
list: 別名をリストアップ (引数を与えなかった場合、このリストが表示されます)
add: 別名を追加
addcompletion: カスタム補完を指定して別名を追加
del: 別名を削除
completion: 別名の補完: デフォルトでは対象のコマンドに対する補完が行われます
注意: %%command で既存のコマンドに対する補完を利用可能です
alias: 別名の名前
command: 引数を含めたコマンド名 (セミコロンで分割すれば複数のコマンドを指定できます)
list: list aliases (without argument, this list is displayed)
add: add an alias
addcompletion: add an alias with a custom completion
del: delete an alias
completion: completion for alias: by default completion is done with target command
note: you can use %%command to use completion of an existing command
alias: name of alias
command: command name with arguments (many commands can be separated by semicolons)
注意: command の中に含まれる特殊変数は置換されます:
$n: 'n' 番目の引数 (1 から 9)
$-m: 1 から 'm' 番目の引数
$n-: 'n' 番目から最後の引数
$n-m: 'n' から 'm' 番目の引数
$*: 全ての引数
$~: 最後の引数
$var: ここで "var" とはバッファの局所変数 (/buffer localvar を参照してください)
: $nick$channel$server$plugin$name
Note: in command, special variables are replaced:
$n: argument 'n' (between 1 and 9)
$-m: arguments from 1 to 'm'
$n-: arguments from 'n' to last
$n-m: arguments from 'n' to 'm'
$*: all arguments
$~: last argument
$var: where "var" is a local variable of buffer (see /buffer listvar)
examples: $nick, $channel, $server, $plugin, $name
:
/split をウィンドウを水平方向に分割する別名と定義:
Examples:
alias /split to split window horizontally:
/alias add split /window splith
/hello を #weechat を除く全てのチャンネルで "hello" と発言する別名と定義:
/alias add hello /allchan -exclude=#weechat msg * hello
/forcejoin を /sajoin の補完候補を使い IRC コマンド "forcejoin" を送信する別名と定義:
alias /hello to say "hello" on all channels but not on #weechat:
/alias add hello /allchan -exclude=#weechat hello
alias /forcejoin to send IRC command "forcejoin" with completion of /sajoin:
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
// end::alias_commands[]
@@ -1097,7 +1115,9 @@ message: 離席メッセージ (メッセージが無い場合は、離席状態
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>
@@ -1121,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
@@ -1280,11 +1302,11 @@ 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:
@@ -1320,24 +1342,25 @@ To force a string comparison, you can add double quotes around each expression,
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")
2. an evaluated condition (format: "eval_cond:xxx")
3. a string with escaped chars (format: "esc:xxx" or "\xxx")
4. a string with chars to hide (format: "hide:char,string")
5. 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.
6. a reversed string (format: "rev:xxx" or "revscr:xxx")
7. a repeated string (format: "repeat:count,string")
8. length of a string (format: "length:xxx" or "lengthscr:xxx")
9. a color (format: "color:xxx", see "Plugin API reference", function "color")
10. a modifier (format: "modifier:name,data,string")
11. an info (format: "info:name,arguments", arguments are optional)
12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
13. current date/time (format: "date" or "date:format")
14. an environment variable (format: "env:XXX")
15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
17. an option (format: "file.section.option")
18. a local variable in buffer
19. 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:
@@ -1348,6 +1371,7 @@ Format for hdata can be one of following:
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
/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
@@ -1390,60 +1414,62 @@ Examples (conditions):
enable|disable|toggle [<name>|@]
add|addreplace <name> <buffer>[,<buffer>...] <tags> <regex>
rename <name> <new_name>
recreate <name>
del <name>|-all
list: 全てのフィルタをリストアップ
enable: フィルタを有効化 (フィルタはデフォルトで有効になっています)
disable: フィルタを無効化
toggle: フィルタの有効無効を切り替え
name: フィルタの名前 ("@" = 現在のバッファに設定されている全てのフィルタを有効化/無効化)
add: フィルタを追加
addreplace: 既存のフィルタに追加もしくは置換
rename: フィルタをリネーム
del: フィルタを削除
-all: 全てのフィルタを削除
buffer: フィルタが有効化されているバッファのコンマ区切りリスト:
- これはプラグイン名を含む完全な名前です (例: "irc.freenode.#weechat" または "irc.server.freenode")
- "*" は全てのバッファを意味します
- 名前が '!' から始まるものは除外されます
- ワイルドカード "*" を使うことができます
tags: タグのコンマ区切りリスト、例えば "irc_join,irc_part,irc_quit"
- 論理積 "and": タグ同士を "+" でつなげてください (例: "nick_toto+irc_action")
- ワイルドカード "*" を使うことができます
- タグを '!' で始めると、そのタグが付けられたメッセージとそのタグを含むメッセージはフィルタされません
regex: 行単位検索の正規表現
- '\t' を使うと、プレフィックスをメッセージから分離できます。'|' 等の特別な文字は '\|' のようにエスケープしなければいけません
- 正規表現の最初に '!' が含まれる場合は、マッチ結果が反転されます (最初の '!' にマッチさせたければ、'\!' を使ってください)
- 2 種類の正規表現があります: 一方はプレフィックス用、他方はメッセージ用
- 正規表現は大文字小文字を区別しません、"(?-i)" から始まる場合は区別します
list: list all filters
enable: enable filters (filters are enabled by default)
disable: disable filters
toggle: toggle filters
name: filter name ("@" = enable/disable all filters in current buffer)
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")
- "*" means all buffers
- a name starting with '!' is excluded
- wildcard "*" is allowed
tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
- logical "and": use "+" between tags (for example: "nick_toto+irc_action")
- wildcard "*" is allowed
- if tag starts with '!', then it is excluded and must NOT be in message
regex: POSIX extended regular expression to search in line
- use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
- if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
- two regular expressions are created: one for prefix and one for message
- regex are case insensitive, they can start by "(?-i)" to become case sensitive
デフォルトではキー alt+'=' ですべてのバッファについてフィルタリングの on/off を切り替えられます。現在のバッファに限りフィルタリングを切り替えるには alt+'-' を使います。
The default key alt+'=' toggles filtering on/off globally and alt+'-' toggles filtering on/off in the current buffer.
よく使われるタグ:
no_filterno_highlightno_loglog0..log9 (ログレベル)、
notify_nonenotify_messagenotify_privatenotify_highlight
self_msgnick_xxx (xxx はメッセージのニックネーム部分)、prefix_nick_ccc (ccc はニックネームの色)、
host_xxx (xxx はメッセージのユーザ名 + ホスト名部分)、
irc_xxx (xxx はコマンド名または番号、/server raw または /debug tags で確認)、
irc_numericirc_errorirc_actionirc_ctcpirc_ctcp_replyirc_smart_filteraway_info
バッファ内でタグを見るには: /debug tags
Tags most commonly used:
no_filter, no_highlight, no_log, log0..log9 (log level),
notify_none, notify_message, notify_private, notify_highlight,
self_msg, nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
host_xxx (xxx is username + host in message),
irc_xxx (xxx is command name or number, see /server raw or /debug tags),
irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
To see tags for lines in buffers: /debug tags
:
全てのバッファで IRC スマートフィルタを使用:
Examples:
use IRC smart filter on all buffers:
/filter add irc_smart * irc_smart_filter *
名前に "#weechat" を含むバッファを除いた全てのバッファで IRC スマートフィルタを使用:
use IRC smart filter on all buffers except those with "#weechat" in name:
/filter add irc_smart *,!*#weechat* irc_smart_filter *
全ての IRC join/part/quit メッセージをフィルタ:
filter all IRC join/part/quit messages:
/filter add joinquit * irc_join,irc_part,irc_quit *
チャンネルに入った時や /names で表示されるニックネームをフィルタ:
filter nicks displayed when joining channels or with /names:
/filter add nicks * irc_366 *
IRC チャンネル #weechat で "toto" を含むニックネームをフィルタ:
filter nick "toto" on IRC channel #weechat:
/filter add toto irc.freenode.#weechat nick_toto *
ニックネーム "toto" からの IRC の参加/アクションメッセージをフィルタ:
filter IRC join/action messages from nick "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
IRC チャンネル #weechat で "weechat sucks" を含む行をフィルタ:
filter lines containing "weechat sucks" on IRC channel #weechat:
/filter add sucks irc.freenode.#weechat * weechat sucks
すべてのバッファで "WeeChat sucks" と完全に一致する行をフィルタ:
filter lines that are strictly equal to "WeeChat sucks" on all buffers:
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
@@ -2159,7 +2185,7 @@ charset: 現在のバッファの新しい文字セット
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
-in <id> <text>
-inclose <id> [<text>]
-signal <id> <signal>
@@ -2168,55 +2194,56 @@ charset: 現在のバッファの新しい文字セット
-set <id> <property> <value>
-del <id>|-all [<id>...]
-list: コマンドをリストアップ
-sh: コマンドを実行する際にシェルを使う、複数のコマンドをパイプすることも可能 (警告: このオプションを使えるのは、全ての引数が安全な場合だけです、オプション -nosh を参照してください)
-nosh: コマンドを実行する際にシェルを使わない (コマンドに安全でないデータが含まれる場合に必要、例えば他のユーザからのメッセージの内容) (デフォルト)
-bg: プロセスをバックグラウンド実行: プロセスの出力およびリターンコードを表示しない (オプション -o/-oc/-n/-nf/-pipe/-hsignal と同時に利用できません)
-nobg: プロセスの出力を受け取り、リターンコードを表示する (デフォルト)
-stdin: プロセスにデータを送信するパイプを作成する (/exec -in/-inclose を使う)
-nostdin: 標準入力用にパイプを作成しない (デフォルト)
-buffer: コマンドの出力をこのバッファに表示 / 送信する (バッファが見つからない場合、新しいバッファ "exec.exec.xxx" が作られます)
-l: コマンドの出力をカレントバッファに表示 (デフォルト)
-o: コマンドの出力をカレントバッファに送信、カレントバッファは受信した内容をコマンドとして実行しません (オプション -bg/-pipe/-hsignal と同時に利用できません)
-oc: コマンドの出力をカレントバッファに送信、カレントバッファは受信した内容 (先頭に "/" もしくはそれ以外のコマンド開始文字を含む行) をコマンドとして実行します (オプション -bg/-pipe/-hsignal と同時に利用できません)
-n: コマンドの出力を新しいバッファに表示 (オプション -bg/-pipe/-hsignal と同時に利用できません)
-nf: コマンドの出力を自由内容 (禁則処理なし、行数制限なし) の新しいバッファに表示 (オプション -bg/-pipe/-hsignal と同時に利用できません)
-cl: 出力を表示する前に新しいバッファをクリア
-nocl: 新しいバッファをクリアせずに追加 (デフォルト)
-sw: 出力バッファに移動 (デフォルト)
-nosw: 出力バッファに移動しない
-ln: 行数を表示 (新しいバッファに表示する場合はデフォルト)
-noln: 行数を表示しない
-flush: コマンドの出力をすぐに表示 (デフォルト)
-noflush: コマンドの出力をコマンドの終了後に表示
-color: 出力に含まれる ANSI 色に対する挙動:
ansi: ANSI 色をそのままにする
auto: ANSI 色を WeeChat/IRC 色に変換 (デフォルト)
irc: ANSI 色を IRC 色に変換
weechat: ANSI 色を WeeChat 色に変換
strip: ANSI 色を削除
-rc: リターンコードを表示 (デフォルト)
-norc: リターンコードを表示しない
-timeout: コマンドのタイムアウトを設定 (秒単位)
-name: コマンドの名前を設定 (後から名前を付けるには /exec を使う)
-pipe: WeeChat およびプラグインコマンドに出力を送信 (1 行ごと); コマンドおよび引数に空白が含まれる場合、2 重引用符で囲ってください; 引数 $line はその行で置換されます (デフォルトではコマンドの後ろに空白を付けてから行を追加します) (オプション -bg/-o/-oc/-n/-nf と同時に利用できません)
-hsignal: hsignal として出力を送信 (例えばトリガで使われます) (オプション -bg/-o/-oc/-n/-nf と同時に利用できません)
command: 実行するコマンド; "url:" で始まる場合、シェルは無効化され、URL の内容がダウンロードされ、出力として送信されます
id: コマンド識別子: 番号か名前 ("-name xxx" で設定した場合) のどちらか一方
-in: プロセスの標準入力にテキストを送信
-inclose: -in と同じ、ただし使用後に標準入力を閉じる (テキストは任意: テキストが無い場合、標準入力をすぐに閉じる)
-signal: プロセスにシグナルを送信; シグナルは整数値または次の名前の 1 つ: hup、int、quit、kill、term、usr1、usr2
-kill: "-signal <id> kill" のエイリアス
-killall: 全ての実行中プロセスを kill する
-set: フックプロパティを設定 (プラグイン API リファレンスの hook_set 関数を参照してください)
property: フックプロパティ
value: フックプロパティの新しい値
-del: 中断されたコマンドを削除
-all: 全ての中断されたコマンドを削除
-list: list commands
-sh: use the shell to execute the command, many commands can be piped (WARNING: use this option ONLY if all arguments are safe, see option -nosh)
-nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
-bg: run process in background: do not display process output neither return code (not compatible with options -o/-oc/-n/-nf/-pipe/-hsignal)
-nobg: catch process output and display return code (default)
-stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
-nostdin: do not create a pipe for stdin (default)
-buffer: display/send output of command on this buffer (if the buffer is not found, a new buffer with name "exec.exec.xxx" is created)
-l: display locally output of command on buffer (default)
-o: send output of command to the buffer without executing commands (not compatible with options -bg/-pipe/-hsignal)
-oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
-n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
-nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
-oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
-cl: clear the new buffer before displaying output
-nocl: append to the new buffer without clear (default)
-sw: switch to the output buffer (default)
-nosw: don't switch to the output buffer
-ln: display line numbers (default in new buffer only)
-noln: don't display line numbers
-flush: display output of command in real time (default)
-noflush: display output of command after its end
-color: action on ANSI colors in output:
ansi: keep ANSI codes as-is
auto: convert ANSI colors to WeeChat/IRC (default)
irc: convert ANSI colors to IRC colors
weechat: convert ANSI colors to WeeChat colors
strip: remove ANSI colors
-rc: display return code (default)
-norc: don't display return code
-timeout: set a timeout for the command (in seconds)
-name: set a name for the command (to name it later with /exec)
-pipe: send the output to a WeeChat/plugin command (line by line); if there are spaces in command/arguments, enclose them with double quotes; variable $line is replaced by the line (by default the line is added after the command, separated by a space) (not compatible with options -bg/-o/-oc/-n/-nf)
-hsignal: send the output as a hsignal (to be used for example in a trigger) (not compatible with options -bg/-o/-oc/-n/-nf)
command: the command to execute; if beginning with "url:", the shell is disabled and the content of URL is downloaded and sent as output
id: command identifier: either its number or name (if set with "-name xxx")
-in: send text on standard input of process
-inclose: same as -in, but stdin is closed after (and text is optional: without text, the stdin is just closed)
-signal: send a signal to the process; the signal can be an integer or one of these names: hup, int, quit, kill, term, usr1, usr2
-kill: alias of "-signal <id> kill"
-killall: kill all running processes
-set: set a hook property (see function hook_set in plugin API reference)
property: hook property
value: new value for hook property
-del: delete a terminated command
-all: delete all terminated commands
オプション exec.command.default_options でデフォルトオプションの設定が可能です。
Default options can be set in the option exec.command.default_options.
:
Examples:
/exec -n ls -l /tmp
/exec -sh -n ps xu | grep weechat
/exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx
@@ -2802,6 +2829,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
@@ -2931,7 +2968,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)
@@ -2616,6 +2616,12 @@
** 値: 1 .. 3600
** デフォルト値: `+60+`
* [[option_irc.server_default.default_chantypes]] *irc.server_default.default_chantypes*
** 説明: pass:none[channel type prefixes to use if the server does not send them in message 005 (default is "#&")]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"#&"+`
* [[option_irc.server_default.ipv6]] *irc.server_default.ipv6*
** 説明: pass:none[サーバ接続に IPv6 プロトコルを利用 (IPv6 の利用に失敗したら IPv4 を利用); 無効の場合には IPv4 を利用]
** タイプ: ブール
@@ -3320,6 +3326,12 @@
** 値: -1 .. 525600
** デフォルト値: `+1440+`
* [[option_script.scripts.download_enabled]] *script.scripts.download_enabled*
** 説明: pass:none[enable download of files from the scripts repository when the /script command is used (list of scripts and scripts themselves); the list of scripts is downloaded from the URL specified in the option script.scripts.url; WeeChat will sometimes download again the list of scripts when you use the /script command, even if you don't install a script]
** タイプ: ブール
** 値: on, off
** デフォルト値: `+off+`
* [[option_script.scripts.download_timeout]] *script.scripts.download_timeout*
** 説明: pass:none[スクリプトのダウンロードとスクリプトのリストに対するタイムアウト時間 (秒単位)]
** タイプ: 整数
@@ -3748,6 +3760,12 @@
** 値: 未制約文字列
** デフォルト値: `+"${marked} ${name} ${type} ${value2}${newline} ${empty_name} ${_default_value}${color:darkgray} -- ${min}..${max}${newline} ${empty_name} ${description}"+`
* [[option_fset.look.auto_refresh]] *fset.look.auto_refresh*
** 説明: pass:none[comma separated list of options to automatically refresh on the fset buffer (if opened); "*" means all options (recommended), a name beginning with "!" is a negative value to prevent an option to be refreshed, wildcard "*" is allowed in names (example: "*,!plugin.section.*")]
** タイプ: 文字列
** 値: 未制約文字列
** デフォルト値: `+"*"+`
* [[option_fset.look.auto_unmark]] *fset.look.auto_unmark*
** 説明: pass:none[マーク済みオプションに対する操作の後または再読込の後に自動的にすべてのオプションをアンマーク]
** タイプ: ブール
+1 -1
View File
@@ -97,7 +97,7 @@ $HOME/.weechat/weechat.log::
WeeChat は Sébastien Helleu さんと貢献者によって作成されています
(完全なリストは AUTHORS.adoc ファイルを参照してください)。
著作権 (C) 2003-2020 {author}
著作権 (C) 2003-2021 {author}
WeeChat はフリーソフトウェアです。あなたはこれを、フリーソフトウェア財団によって発行された
GNU 一般公衆利用許諾契約書 (バージョン 2 か、希望によってはそれ以降のバージョンのうちどれか)
+3 -1
View File
@@ -439,6 +439,8 @@ WeeChat "core" は以下のディレクトリに配置されています:
|             test-irc-nick.cpp | Tests: IRC nicks.
|             test-irc-protocol.cpp | テスト: IRC プロトコル
// TRANSLATION MISSING
|             test-irc-server.cpp | Tests: IRC server.
// TRANSLATION MISSING
|          relay/ | Root of unit tests for Relay plugin.
// TRANSLATION MISSING
|             test-relay-auth.cpp | Tests: clients authentication.
@@ -515,7 +517,7 @@ WeeChat とプラグインの翻訳は gettext で行います、ファイルは
/*
* 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.
*
+32 -3
View File
@@ -227,6 +227,35 @@ _buffers.pl_
"meta-OP" と "meta-OQ" キーは端末によって異なります。キーコードを見つけるには
kbd:[Alt+k] の後にキーを押してください。
// TRANSLATION MISSING
[[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]]
=== どうすればチャットエリア内のニックネームの最大長さを短く、またはニックネーム整列機能を無効化できますか。
@@ -1168,9 +1197,9 @@ link:weechat_user.ja.html#secured_data[ユーザーズガイド / 暗号化デ
_~/.weechat/*.conf_ ファイルは公開しても問題ありませんが、
パスフレーズで暗号化されたパスワードが含まれる _sec.conf_ ファイルは秘密にしてください。
サーバおよびチャンネルパスワード等の機密情報を `/secure` コマンドで
_sec.conf_ に保存していない場合、これらの情報は _irc.conf_
などのファイルに保存されます。
// TRANSLATION MISSING
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
設定ファイルに関する詳しい情報はlink:weechat_user.ja.html#files_and_directories[ユーザーズガイド / ファイルとディレクトリ]を参照してください。
+95 -15
View File
@@ -1344,14 +1344,26 @@ int weechat_string_regcomp (void *preg, const char *regex, int default_flags)
* `regcomp` 関数と同じ戻り値
(成功の場合は 0、エラーが起きた場合は 0 以外、`man regcomp` を参照)
[NOTE]
// TRANSLATION MISSING
Regular expression _preg_ must be cleaned by calling "regfree" after use,
if the function returned 0 (OK).
C 言語での使用例:
[source,C]
----
regex_t my_regex;
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) != 0)
if (weechat_string_regcomp (&my_regex, "(?i)test", REG_EXTENDED) == 0)
{
/* OK */
/* ... */
regfree (&my_regex);
}
else
{
/* error */
/* ... */
}
----
@@ -1900,6 +1912,57 @@ str = weechat.string_format_size(size)
str = weechat.string_format_size(15200) # == "15.2 KB"
----
==== string_color_code_size
_WeeChat ≥ 3.0._
// TRANSLATION MISSING
Return the size (in bytes) of the WeeChat color code at the beginning of
the string.
プロトタイプ:
[source,C]
----
int weechat_string_color_code_size (const char *string);
----
引数:
* _string_: 文字列
戻り値:
// TRANSLATION MISSING
* size (in bytes) of the WeeChat color code at the beginning of the string;
if the string is NULL, empty or does not start with a color code, 0 is returned;
if the string begins with multiple color codes, only the size of the first one
is returned
C 言語での使用例:
[source,C]
----
int size;
size = weechat_string_color_code_size ("test"); /* size == 0 */
size = weechat_string_color_code_size (weechat_color ("bold")); /* size == 2 */
size = weechat_string_color_code_size (weechat_color ("yellow,red")); /* size == 7 */
----
スクリプト (Python) での使用例:
[source,python]
----
# プロトタイプ
size = weechat.string_color_code_size(string)
# 例
size = weechat.string_color_code_size("test") # size == 0
size = weechat.string_color_code_size(weechat.color("bold")) # size == 2
size = weechat.string_color_code_size(weechat.color("yellow,red")) # size == 7
----
==== string_remove_color
文字列から WeeChat 色コードを削除。
@@ -2163,7 +2226,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
// TRANSLATION MISSING
_WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8, 2.0,
2.2, 2.3, 2.7 and 2.9._
2.2, 2.3, 2.7, 2.9 and 3.1._
式を評価して文字列として返す。`+${variable}+`
という書式で書かれた特殊変数は展開されます (以下の表を参照)。
@@ -2211,6 +2274,11 @@ char *weechat_string_eval_expression (const char *expr,
** _regex_replace_: _regex_ と一緒に使われる置換テキスト、_expr_
に含まれるテキストを置換する (_regex_replace_ は、_expr_ 内で
_regex_ 引数にマッチする部分が見つからなくなるまで、毎回評価されます)
// TRANSLATION MISSING
** _debug_: debug level (string with integer number ≥ 1), if enabled, a key
"debug_output" is added in hashtable _options_:
*** _1_: enable debug
*** _2_: enable more verbose debug
戻り値:
@@ -2492,6 +2560,13 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
`+19:02:45+` (オプション weechat.look.buffer_time_format
内に色コードが存在する場合色付き)
// TRANSLATION MISSING
| `+${eval_cond:xxx}+` +
_(WeeChat バージョン 3.1 以上で利用可)_ |
String to evaluate as condition. |
`+${eval_cond:${window.win_width} > 100}+` |
`+1+`
| `+${esc:xxx}+` +
`+${\xxx}+` +
_(WeeChat バージョン 1.0 以上で利用可)_ |
@@ -2797,7 +2872,8 @@ else
==== string_dyn_concat
_WeeChat バージョン 1.8 以上で利用可_
// TRANSLATION MISSING
_WeeChat バージョン 1.8 以上で利用可, updated in 3.0_
動的文字列に文字列を連結します。
@@ -2808,13 +2884,17 @@ _WeeChat バージョン 1.8 以上で利用可_
[source,C]
----
int weechat_string_dyn_concat (char **string, const char *add);
int weechat_string_dyn_concat (char **string, const char *add, int bytes);
----
引数:
* _string_: 動的文字列へのポインタ
* _add_: 連結する文字列
// TRANSLATION MISSING
* _bytes_: max number of bytes in _add_ to concatenate, must be lower or equal
to length of _add_ (-1 = automatic: concatenate whole string _add_)
_(WeeChat ≥ 3.0)_
戻り値:
@@ -2827,7 +2907,7 @@ C 言語での使用例:
char **string = weechat_string_dyn_alloc (256);
if (weechat_string_dyn_copy (string, "test"))
{
if (weechat_string_dyn_concat (string, "abc"))
if (weechat_string_dyn_concat (string, "abc", -1))
{
/* ... */
}
@@ -12109,8 +12189,7 @@ info を使う前にエリアが一致していることを確認して下さい
| _chat | チャットエリアインジケータ |
"0" または "1" | "0"
| _chat_line | 行へのポインタ +
_(WeeChat バージョン 1.2 以上で利用可)_ |
| _chat_line | 行へのポインタ _(WeeChat バージョン 1.2 以上で利用可)_ |
"0x1234abcd" | ""
| _chat_line_x | 行中の列番号 ^(3)^ |
@@ -12167,8 +12246,7 @@ info を使う前にエリアが一致していることを確認して下さい
"0" ... "n" | "-1"
// TRANSLATION MISSING
| _bar_window | Pointer to bar window +
_(WeeChat ≥ 2.9)_. |
| _bar_window | Pointer to bar window _(WeeChat ≥ 2.9)_. |
"0x1234abcd" | ""
|===
@@ -12183,13 +12261,15 @@ info を使う前にエリアが一致していることを確認して下さい
バー要素 "buffer_nicklist" の追加情報:
[width="100%",cols="1,1,5",options="header"]
[width="100%",cols="^1,^1,5",options="header"]
|===
| キー | プラグイン ^(1)^ | 説明
| nick | core | ニックネーム
| prefix | core | ニックネームのプレフィックス
| group | core | グループ名
| irc_host | irc | ニックネームのホスト名 (判る場合)
| プラグイン ^(1)^ | キー | 説明
| weechat | nick | ニックネーム
| weechat | prefix | ニックネームのプレフィックス
| weechat | group | グループ名
// TRANSLATION MISSING
| irc | irc_nick | Pointer to IRC nick _(WeeChat ≥ 3.0)_.
| irc | irc_host | ニックネームのホスト名 (判る場合)
|===
[NOTE]
+2 -1
View File
@@ -567,6 +567,7 @@ link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス]
string_has_highlight_regex +
string_mask_to_regex +
string_format_size +
string_color_code_size +
string_remove_color +
string_is_command_char +
string_input_for_buffer +
@@ -986,7 +987,7 @@ weechat.buffer_set(buffer, "localvar_del_myvar", "")
バッファに対するローカル変数を見るには、WeeChat で以下のコマンドを実行してください:
----
/buffer localvar
/buffer listvar
----
[[hooks]]
+211 -19
View File
@@ -383,12 +383,16 @@ $ git clone https://github.com/weechat/weechat.git
WeeChat がクラッシュした場合、または WeeChat
をクラッシュさせる操作を報告する場合、以下の手順に従ってください:
* デバッグを有効化してコンパイル (またはデバック情報を含んだバイナリパッケージをインストール)
// TRANSLATION MISSING
* Compile with:
** debug info (or install binary package with debug info),
** address sanitizer (optional).
* システムの _core_ ファイルを有効化
* gdb のインストール
[[debug_info]]
==== デバッグ情報
// TRANSLATION MISSING
[[build_debug]]
==== Build with debug options
CMake でコンパイルする場合:
@@ -396,9 +400,32 @@ CMake でコンパイルする場合:
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----
autotools でコンパイルする場合は、デバックはデフォルトで有効化されています (`--with-debug=1`)。
// TRANSLATION MISSING
[[build_debug_address_sanitizer]]
==== Build with debug options and address sanitizer
バイナリパッケージをインストールする場合は、_weechat-dbg_ パッケージをインストールしてください。
// TRANSLATION MISSING
You can additionally enable the address sanitizer, which causes WeeChat to
crash immediately in case of problem:
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
// TRANSLATION MISSING
[WARNING]
You should enable address sanitizer only if you're trying to cause a crash,
this is not recommended in production.
// TRANSLATION MISSING
Then once compiled and installed, you must run WeeChat like this:
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
// TRANSLATION MISSING
In case of crash, the backtrace is in file `asan.log`.
[[core_files]]
==== Core ファイル
@@ -536,7 +563,9 @@ include::includes/cmdline_options.ja.adoc[tag=debug]
=== ファイルとディレクトリ
デフォルト状態の WeeChat は `~/.weechat`
ディレクトリ内に設定ファイルおよびその他のデータを書き込みます。
ディレクトリ内に設定ファイルおよびその他のデータを書き込みます。 +
// TRANSLATION MISSING
These files are created with default values the first time you run WeeChat.
// TRANSLATION MISSING
[[weechat_directories]]
@@ -597,7 +626,8 @@ WeeChat ホームディレクトリには以下のファイルが含まれます
| perl.conf | _perl_ プラグイン用の設定ファイル | 保護されません
| php.conf | _php_ プラグイン用の設定ファイル | 保護されません
| python.conf | _python_ プラグイン用の設定ファイル | 保護されません
| relay.conf | _relay_ プラグイン用の設定ファイル | 保護されません
// TRANSLATION MISSING
| relay.conf | _relay_ プラグイン用の設定ファイル | *Yes*: it can contain relay password and TOTP secret (if not stored in `sec.conf`), allowed IP addresses/websocket origins and opened ports.
| ruby.conf | _ruby_ プラグイン用の設定ファイル | 保護されません
| script.conf | _script_ プラグイン用の設定ファイル | 保護されません
| spell.conf | _spell_ プラグイン用の設定ファイル | 保護されません
@@ -645,7 +675,7 @@ WeeChat を起動した端末の例:
│ │ │ │
│ │ │ │
│ │ │ │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [Act: 3:#abc(2,5), 5] │
│ │[12:55] [5] [irc/freenode] 2:#test(+n){4}* [H: 3:#abc(2,5), 5]
│ │[@Flashy(i)] hi peter!█ │
└──────────────────────────────────────────────────────────────────────────────────────┘
▲ "status" と "input" バー "nicklist" バー ▲
@@ -697,7 +727,7 @@ WeeChat を起動した端末の例:
| buffer_filter | `+*+` | フィルタ表示: `+*+` の場合いくつかの行がフィルタされ (隠され) ます、空の場合すべての行が表示されます。
| scroll | `-MORE(50)-` | スクロール表示、最後の行が表示されてから追加された行数を含む。
| lag | `[Lag: 2.5]` | 遅延秒表示 (遅延が短い場合は非表示)
| hotlist | `[Act: 3:#abc(2,5), 5]` | 変化のあったバッファのリスト (未読メッセージ) (例では、_#abc_ に 2 個のハイライトと 5 個の未読メッセージ、5 番目のバッファに 1 個の未読メッセージがあることを意味します。)
| hotlist | `[H: 3:#abc(2,5), 5]` | 変化のあったバッファのリスト (未読メッセージ) (例では、_#abc_ に 2 個のハイライトと 5 個の未読メッセージ、5 番目のバッファに 1 個の未読メッセージがあることを意味します。)
| completion | `abc(2) def(5)` | 補完候補の単語リスト、各単語に対して適応される補完候補の数を含む。
|===
@@ -1080,8 +1110,9 @@ _window_
▲ ウィンドウ #1 (バッファ #3) ▲ ウィンドウ #2 (バッファ #4)
....
[[buffers_lines]]
=== バッファの行
// TRANSLATION MISSING
[[buffers]]
=== Buffers
[[lines_format]]
==== 行の書式
@@ -1123,11 +1154,15 @@ WeeChat は様々な目的で各行にタグを付けます:
| no_filter | フィルタできない行
| no_highlight | ハイライトできない行
| no_log | ログファイルに書き込まれない行
| log0 ... log9 | 行に対するログレベル (`/help logger` を参照)
| notify_none | この行を含むバッファはホットリストに追加されません
| notify_message | この行を含むバッファは "message" レベルでホットリストに追加されます
| notify_private | この行を含むバッファは "private" レベルでホットリストに追加されます
| notify_highlight | この行を含むバッファは "highlight" レベルでホットリストに追加されます
| log0 log9 | 行に対するログレベル (`/help logger` を参照)
// TRANSLATION MISSING
| notify_none | The line must not be added to hotlist. ^(1)^
// TRANSLATION MISSING
| notify_message | The line is a user message. ^(1)^
// TRANSLATION MISSING
| notify_private | The line is a private message. ^(1)^
// TRANSLATION MISSING
| notify_highlight | The line is a message with highlight. ^(1)^
| self_msg | 自分のメッセージ
| nick_xxx | ニックネーム "xxx" からのメッセージ
| prefix_nick_ccc | プレフィックスを色 "ccc" のニックネームにします
@@ -1142,6 +1177,149 @@ WeeChat は様々な目的で各行にタグを付けます:
| away_info | 離席状態のメッセージ
|===
// TRANSLATION MISSING
[NOTE]
^(1)^ When no tag "notify_xxx" is present, the default level is "low". If a tag
"notify_xxx" is present, the real notify level can be different, for example
if a max hotlist level is used for a nick, the notify level can be lower than
the value in the tag.
// TRANSLATION MISSING
[[local_variables]]
==== Local variables
Local variables can be defined in all buffers.
A local variable has:
* a name (string)
* a value (string, can be empty).
Local variables can be set by WeeChat, plugins, scripts, or manually on the
command line in the buffer;
For example to add the local variable "completion_default_template":
----
/buffer setvar completion_default_template %(my_completion)
----
To list local variables in the current buffer:
----
/buffer listvar
----
To remove the local variable "completion_default_template":
----
/buffer delvar completion_default_template
----
By default WeeChat and its default plugins interpret these variables:
[width="100%",cols="^2m,2,5",options="header"]
|===
| Name | Value | Description
| away |
any string |
Away message on the server, set by irc plugin.
| channel |
any string |
Channel name, set by irc/xfer plugins and debug buffer of relay/trigger plugins.
| charset_modifier |
any string |
Charset modifier for the server buffer, set by irc plugin.
| completion_default_template |
any string |
Default completion template for the buffer, overriding the option
`weechat.completion.default_template`.
| filter |
any string |
Filter defined on some buffers like `/fset`, `/server raw` (irc) and `/script`.
| host |
any string |
Self host (if known), set by irc plugin.
| lag |
any string |
Lag on the server, set by irc plugin.
| name |
any string |
Buffer name (be careful, this is not the full name and this name is not
enough to identify or search a buffer).
| nick |
any string |
Self nick, set by irc and xfer plugins.
| no_log |
`1` (or any non-empty string) |
If set, the logger plugin does not log anything for the buffer.
| plugin |
any string |
Name of plugin which created the buffer (`core` for WeeChat buffers).
| script_close_cb |
any string |
Close callback defined by a script for a buffer.
| script_close_cb_data |
any string |
Data for close callback defined by a script for a buffer.
| script_input_cb |
any string |
Input callback defined by a script for a buffer.
| script_input_cb_data |
any string |
Data for input callback defined by a script for a buffer.
| script_name |
any string |
Name of the script which created the buffer.
| server |
any string |
Server name, set by irc plugin and debug buffer of relay/trigger plugins.
| spell_suggest |
any string |
Misspelled word and suggestions (format: "misspelled:suggestions"), set by
spell plugin.
| trigger_filter |
any string |
Trigger filter, set by trigger plugin.
| type |
any string, for example:
`channel`,
`debug`,
`exec`,
`option`,
`private`,
`relay`,
`script`,
`server`,
`user`,
`xfer` |
Type of buffer, set by WeeChat and many plugins.
|===
[NOTE]
External plugins and scripts can define and use other local variables.
[[bars]]
=== バー
@@ -3091,7 +3269,7 @@ It is possible to define a filename mask for each buffer, and use local buffer
variables to build filename. To see available local variables for current buffer:
----
/buffer localvar
/buffer listvar
----
// TRANSLATION MISSING
@@ -4042,6 +4220,16 @@ WeeChat によって使われる値に影響を及ぼします
/trigger monitor
----
// TRANSLATION MISSING
All callbacks set following variables in hashtable:
[width="100%",cols="3m,2,14",options="header"]
|===
| 変数 | 型 | 説明
// TRANSLATION MISSING
| tg_trigger_name | string | Name of trigger.
|===
[[trigger_data_signal]]
===== Signal
@@ -4212,8 +4400,12 @@ _weechat_print_ 修飾子では、メッセージタグを使う変数 (下の
|===
| 変数 | 型 | 説明
| buffer | pointer | バッファ
| tg_argvN | string | N 番目の引数
| tg_argv_eolN | string | N 番目の引数から最後の引数まで
// TRANSLATION MISSING
| tg_argc | string | The number of arguments (the command itself counts for one).
// TRANSLATION MISSING
| tg_argvN | string | N 番目の引数 (`+tg_argv0+` is the command itself, the others are command arguments).
// TRANSLATION MISSING
| tg_argv_eolN | string | N 番目の引数から最後の引数まで (`+tg_argv_eol0+` includes the command itself).
|===
[[trigger_data_command_run]]
+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-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat.1 DESTINATION ${MANDIR}/pl/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.pl.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.pl.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.pl.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.pl.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (pl)"
)
add_custom_target(doc-man-weechat-headless-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/pl/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.pl.adoc
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat-headless.1.pl.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/cmdline_options.pl.adoc
${CMAKE_CURRENT_SOURCE_DIR}/includes/man.pl.adoc
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
COMMENT "Building weechat-headless.1 (pl)"
)
add_custom_target(doc-man-weechat-headless-pl ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1)
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat-headless.1 DESTINATION ${MANDIR}/pl/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.
@@ -52,7 +52,7 @@
| irc | irc_server_privates | rozmowy prywatne na obecnym serwerze IRC
| irc | irc_servers | serwery IRC (nazwy wewnętrzne)
| irc | irc_servers | Serwery IRC (nazwy wewnętrzne)
| irc | nick | użytkownicy obecnego kanału IRC
@@ -120,6 +120,10 @@
| weechat | bars_options | opcje pasków
| weechat | buffer_local_variable_value | wartość zmiennej lokalnej bufora
| weechat | buffer_local_variables | zmienne lokalne bufora
| weechat | buffer_properties_get | właściwości, jakie mogą być przeczytane w buforze
| weechat | buffer_properties_set | właściwości, jakie mogą być ustawione w buforze
+1 -1
View File
@@ -678,7 +678,7 @@ _next_completion_   (pointer, hdata: "completion") +
| weechat
| [[hdata_completion_word]]<<hdata_completion_word,completion_word>>
| structure with word found for a completion
| struktura z ze słowem znalezionym dla dopełnienia
| -
| _word_   (string) +
_nick_completion_   (char) +

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