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

Compare commits

...

291 Commits

Author SHA1 Message Date
Sébastien Helleu 89afeb5aa2 Version 4.4.4 2024-11-30 09:03:02 +01:00
Sébastien Helleu a4fd1df891 debian: update changelog 2024-11-30 08:52:21 +01:00
Sébastien Helleu bff4ab7808 ci: fix macOS CI
This is a workaround for https://github.com/actions/runner-images/issues/10984
2024-11-26 07:44:03 +01:00
Sébastien Helleu ef1b6a27f1 core: update ChangeLog (issue #2214, issue #2215) 2024-11-26 07:44:03 +01:00
Trygve Aaberge e6cdd40056 script: don't try to display the old line if it's NULL
This fixes a crash which would happen if you scrolled the script buffer
and then did a search which got fewer search results than the index of
the selected line before the search. E.g. press page down to go to the
second page and then search for `test`.
2024-11-26 07:44:03 +01:00
Sébastien Helleu e0b01d3628 perl: add midding #define of __USE_XOPEN to call wcwidth defined in wchar.h 2024-11-26 07:44:03 +01:00
Sébastien Helleu 3fce54e0ca core: update ChangeLog (issue #2213) 2024-11-25 21:28:48 +01:00
Trygve Aaberge fb7a84589d perl: only set Perl locale if the locale is broken
It turns out that Debian has reverted the commit in Perl that broke the
locale in their 5.38 branch, so it did not have the issue. However, the
workaround we added to fix the locale apparently makes the version
Debian/Ubuntu has crash on perl_destruct. I'm not sure why it makes it
crash, but since it doesn't crash on newer Perl versions, I'm assuming
that it's another bug with the locale handling in that Perl version.

To avoid the crash, make sure to only set the locale if we detect that
it has been broken by Perl. We do this by checking if the value returned
by wcwidth (160) (the first non-ascii printable character) has changed.
If this value is not the same after the call to perl_construct, the
locale has been broken.

I moved the call to Perl_setlocale to right after perl_construct, as the
call to perl_construct is what breaks the locale.
2024-11-25 21:27:42 +01:00
Sébastien Helleu c7017f2fce core: update ChangeLog (issue #2209) 2024-11-24 16:25:28 +01:00
Trygve Aaberge a8c1725566 Fix crash when unloading Perl scripts with Perl 5.38
Apparently the issue with the locale being reset with Perl 5.38 can
cause a crash when unloading the scripts on some systems (at least
Ubuntu 24.04). There was a workaround added in commit f4b9cad72, but it
doesn't work to avoid the crash. However if we set LC_ALL instead of
LC_CTYPE the crash doesn't occur.

Fixes #2187
2024-11-24 16:25:09 +01:00
Sébastien Helleu f8c7ed65e6 build: remove our own Ruby detection and rely on CMake detection, require CMake 3.18 (issue #1156)
This fixes the detection of Ruby on macOS 14.
2024-11-05 11:12:28 +01:00
Sébastien Helleu 712227da38 ci: switch from macOS 12 to 14 2024-11-05 10:19:23 +01:00
LuK1337 c079852deb tests: migrate away from removed ast features
See https://github.com/python/cpython/pull/119563.
2024-11-04 18:49:13 +01:00
Sébastien Helleu aab657bcfd core: remove use of arraylist in function gui_buffer_merge 2024-11-04 18:40:29 +01:00
Sébastien Helleu aa2153827e core: send signal "buffer_moved" only when the buffer number changes (issue #2097) 2024-11-04 18:40:27 +01:00
Sébastien Helleu f9660feb94 core: fix too many sorts of hotlist when buffers are moved (issue #2097)
A performance issue was happening when buffers are moved to another position
and when the hotlist contains a lot of buffers: each time a signal
"buffer_moved" is sent, the hotlist is sorted again.

This fix delays the resort of hotlist after all the moves are done using a
timer with a very small delay (one millisecond).
2024-11-03 23:42:23 +01:00
Sébastien Helleu 5ab0ff656f relay, xfer: fix letters with actions displayed on top of buffer
Since WeeChat 4.0.0, the actions are now case sensitive and must be typed as
lower case.

This fixes the help line displayed on top of relay and xfer buffers: letters
for actions are now displayed with lower case instead of upper case.
2024-10-31 20:38:39 +01:00
Sébastien Helleu 53aa046476 build: add a retry build mechanism on make in Debian packaging
When the environment variable `RETRY_BUILD` is set to `1`, the file
`debian/rules` is patched to run `dh_auto_build` multiple times, until the
build succeeds.

This is a workaround for an issue with the build in an arm64 chroot, where the
compiler randomly segfaults.
2024-10-30 14:10:51 +01:00
Sébastien Helleu c51be0a6a8 Version 4.4.4-dev 2024-10-30 12:44:58 +01:00
Sébastien Helleu eb446f099d Version 4.4.3 2024-10-30 12:13:22 +01:00
Sébastien Helleu 4edbbddf2c build: fix check of WeeChat git repository
The `.git` directory can also be a regular file in a git worktree.
2024-10-30 08:00:00 +01:00
Sébastien Helleu 276990699a debian: update changelog 2024-10-30 07:47:22 +01:00
Sébastien Helleu 8dc7bb409d doc: replace font-awesome icons by translated captions
This removes use of a remote CDN (Cloudflare), as font-awesome is no longer
used.
2024-10-30 07:47:16 +01:00
Sébastien Helleu 410ffb2418 debian: bump Standards-Version to 4.7.0 2024-10-30 07:47:07 +01:00
Sébastien Helleu 1ba3e3530b debian: add file CHANGELOG.md in weechat-core.docs 2024-10-30 07:47:04 +01:00
Sébastien Helleu 36332d11c8 doc: rename git branch master to main in URLs 2024-10-16 20:39:15 +02:00
Sébastien Helleu 53da9df883 tests: fix URL to Python unparser 2024-10-16 20:38:03 +02:00
Sébastien Helleu 956befb655 core: always send the signal "buffer_switch", even when the buffer is opening (issue #2198) 2024-10-06 21:00:50 +02:00
Sébastien Helleu 03bd118854 core: remove extra parenthesis in ChangeLog 2024-10-05 14:08:18 +02:00
Sébastien Helleu 57224f4cee irc: fix crash on /list buffer when a filter is set (issue #2197) 2024-10-05 09:17:55 +02:00
Sébastien Helleu 39ea49b9c5 core: set max version for Curl symbol CURLAUTH_NTLM_WB 2024-09-25 21:13:48 +02:00
Sébastien Helleu ccc45c9284 core: add CVE id in ChangeLog 2024-09-25 20:41:20 +02:00
Sébastien Helleu 639c05dd36 core: update ChangeLog (issue #2180) 2024-09-10 07:27:44 +02:00
Fredrik Fornwall f9eb31d517 core: Fix build on Android to define htobe64 2024-09-10 07:26:52 +02:00
Sébastien Helleu bcd3594b38 Version 4.4.3-dev 2024-09-08 11:56:54 +02:00
Sébastien Helleu 26da6bda4d Version 4.4.2 2024-09-08 11:49:21 +02:00
Sébastien Helleu 1abeb71603 core: update ChangeLog (issue #2178) 2024-09-07 10:54:01 +02:00
Sébastien Helleu 172d383fd1 trigger: fix integer overflow in loop (issue #2178) 2024-09-07 10:53:01 +02:00
Sébastien Helleu de30a87a21 relay: fix integer overflow in loops (issue #2178) 2024-09-07 10:52:59 +02:00
Sébastien Helleu 70cd508cf0 irc: fix integer overflow in loops (issue #2178) 2024-09-07 10:52:57 +02:00
Sébastien Helleu 0973fe0ad4 core: fix integer overflow in loops (issue #2178) 2024-09-07 10:52:54 +02:00
Yiheng Cao db65071db5 core: fix integer overflow in string_free_split functions (issue #2178) 2024-09-07 10:52:52 +02:00
Sébastien Helleu 90ba9264de tests: add tests on function string_rebuild_split_string with empty items 2024-09-07 10:52:48 +02:00
Sébastien Helleu 82a425d226 core, plugins: add missing parentheses when dereferencing a pointer with an array index 2024-09-07 10:52:39 +02:00
Sébastien Helleu af2b48c69e core: fix typo in French translation 2024-09-07 10:51:41 +02:00
Sébastien Helleu 8dfd54ae3d doc/faq: fix suggested value for option irc.server.xxx.tls_priorities 2024-09-07 09:18:54 +02:00
Sébastien Helleu aeb973fdbe doc: fix color of text with syntax highlighting and light theme 2024-09-07 09:17:57 +02:00
Sébastien Helleu 677efe8184 build: replace deprecated "DEPEND" by "BUILD_REQUIRES" in Cygwin packaging 2024-09-07 09:17:02 +02:00
Sébastien Helleu 9b30137dd4 build: add license in Cygwin packaging 2024-09-07 09:16:57 +02:00
Sébastien Helleu 230c637565 Version 4.4.2-dev 2024-08-19 20:00:40 +02:00
Sébastien Helleu e3c76cd7e6 Version 4.4.1 2024-08-19 19:57:29 +02:00
LuK1337 4f45828fd6 cmake: find 'lua' first
On Fedora, `lua` is an up to date package.
2024-08-17 11:29:00 +02:00
LuK1337 25809ff592 lua: fix broken LUA_VERSION check
/usr/include/lua-5.1/lua.h:19:25: error: token ""Lua 5.1"" is not valid
in preprocessor expressions
2024-08-17 10:10:53 +02:00
Sébastien Helleu 1d620ce7c7 Version 4.4.1-dev 2024-08-17 09:22:19 +02:00
Sébastien Helleu 532008e172 Version 4.4.0 2024-08-17 08:33:14 +02:00
Sébastien Helleu 55d7e4c474 relay/weechat: fix uninitialized pointer in infolist command 2024-08-17 08:10:21 +02:00
Sébastien Helleu f153b7e463 core: fix memory leak when trying to add a bar that already exists 2024-08-17 07:58:29 +02:00
Sébastien Helleu c8dffad56c core: add signals "layout_buffers_applied" and "layout_windows_applied" (closes #2167) 2024-08-16 12:36:31 +02:00
Sébastien Helleu 4de6fa11d5 core: add link to file UPGRADING.md in version 4.3.1 2024-08-16 12:05:12 +02:00
Sébastien Helleu 0182153511 core: send signal "buffer_moved" for all buffers affected by merge/unmerge 2024-08-15 21:35:38 +02:00
Sébastien Helleu 6de0195d0a irc: fix send of split messages when server option "anti_flood" set to 0 (closes #2172) 2024-08-15 19:41:08 +02:00
Sébastien Helleu e2edc019cc relay/api: add extra checks on function parameters 2024-08-15 17:48:20 +02:00
Sébastien Helleu b31a8bc1ef doc/faq: add key Alt+Shift+N in questions about copy/paste and URLs 2024-08-15 17:25:36 +02:00
Sébastien Helleu bbb2515b0e doc/faq: add command to set "size_max" for nicklist when bar is moved to top 2024-08-15 16:49:31 +02:00
Sébastien Helleu b6cccb7cee core: add version 4.3.6 in ChangeLog 2024-08-15 15:48:08 +02:00
LuK1337 5b58356390 core: replace manual endianness swap with htobe64() call
This fixes generation of TOTP and tests on FreeBSD.
2024-08-14 12:15:55 +02:00
Sébastien Helleu 17d225ad73 relay: fix compiler warnings on unused parameters when CJSON is disabled 2024-08-14 07:51:41 +02:00
Sébastien Helleu e810cc5f70 doc: add command line option --build-info in man pages and user's guide 2024-08-13 09:46:12 +02:00
Sébastien Helleu 22453e1a37 core: fix German translation 2024-08-13 09:42:36 +02:00
Nils Görs 8e2dda1bc9 core: update German translations 2024-08-13 09:07:44 +02:00
Sébastien Helleu 9c8a39b09e ci: add command weechat --build-info 2024-08-12 22:07:00 +02:00
Sébastien Helleu 0a99ed5f2c core: fix define of CMAKE_BUILD_TYPE and CMAKE_INSTALL_PREFIX in config.h (issue #449) 2024-08-12 21:55:34 +02:00
Sébastien Helleu 071f8f87e7 core: add command line option --build-info / -i to display information about build options (closes #449) 2024-08-12 21:36:17 +02:00
Nils Görs f09855540e core: update German translations 2024-08-12 12:04:59 +02:00
Sébastien Helleu 0637e9f629 lua: remote string "Lua" from Lua version in output of /debug libs 2024-08-12 08:22:48 +02:00
Sébastien Helleu b63f63f001 relay/api: fix send of data to remote after command /upgrade executed in the remote client 2024-08-11 23:35:51 +02:00
Sébastien Helleu 1de8fec2ee relay/api: automatically reconnect to remotes with "autoconnect" enabled after /upgrade 2024-08-11 14:26:36 +02:00
Sébastien Helleu 970aa55f7f relay/api: remove unneeded free of client->http_req->id 2024-08-11 12:27:37 +02:00
Sébastien Helleu a317c785fb relay/api: add automatic reconnection to remote (closes #2166)
New options:

- remote option "autoreconnect_delay"
- relay.api.remote_autoreconnect_delay_growing
- relay.api.remote_autoreconnect_delay_max
2024-08-11 12:18:28 +02:00
Sébastien Helleu fc6811341a irc: fix typo in comment 2024-08-11 11:57:35 +02:00
Sébastien Helleu 6e0f8392b9 doc/relay/api: add event "buffer_time_for_each_line_changed" 2024-08-10 19:06:39 +02:00
Sébastien Helleu 8010eeece3 relay/api: add support of time displayed in remote client buffers 2024-08-10 14:29:30 +02:00
Sébastien Helleu aeac9f02f9 core: add signal "buffer_time_for_each_line_changed" 2024-08-10 14:27:53 +02:00
Sébastien Helleu 24734c4fe0 relay/api: add field "tmie_displayed" in GET /api/buffers 2024-08-10 13:58:58 +02:00
Sébastien Helleu 41ab22554c tests/relay/api: add missing fields in test of buffer to json function 2024-08-10 13:42:38 +02:00
Sébastien Helleu bb2387ec38 relay/api: add support of hidden buffers in remote client (issue #2159) 2024-08-10 12:55:17 +02:00
Sébastien Helleu b00f94dc70 relay/api: add field "hidden" in GET /api/buffers (issue #2159) 2024-08-10 12:42:55 +02:00
Sébastien Helleu 07ef722c06 relay/api: disconnect cleanly when the remote is quitting (closes #2168) 2024-08-09 23:37:33 +02:00
Sébastien Helleu 0296957cce relay/api: add event "quit", sent to clients when WeeChat is quitting (issue #2168) 2024-08-09 23:32:33 +02:00
Sébastien Helleu b4d0054f07 relay/api: disconnect from remote in case of error when sending data 2024-08-09 18:26:02 +02:00
Sébastien Helleu 995cbe542e relay/api: automatically disconnect when the command /upgrade is executed on the remote 2024-08-09 18:23:23 +02:00
Sébastien Helleu 6e775e4768 relay/api: close obsolete buffers when reconnecting to the remote
This closes all buffers that exist locally but not on the remote any more,
after reconnecting to the remote.
2024-08-09 18:08:31 +02:00
Sébastien Helleu e5b6eab2f6 relay/api: do not reset input text on existing buffers when reconnecting to remote 2024-08-09 18:06:42 +02:00
Sébastien Helleu c132adc52c relay/api: fix buffers synchronization with existing buffers that have been renamed on remote in the meanwhile (closes #2169) 2024-08-09 18:04:10 +02:00
Sébastien Helleu 78f0a3e087 relay/api: replace calls to strcmp by weechat_strcmp 2024-08-09 18:02:42 +02:00
Sébastien Helleu eb5399518e relay/api: clear lines and nicklist on all remote buffers upon successful connection to the remote (closes #2161) 2024-08-09 18:01:59 +02:00
Sébastien Helleu 87a5620623 tests: fix typo in header 2024-08-09 07:24:11 +02:00
Sébastien Helleu 828c498a12 core: set proxy option ipv6 to auto by default when creating a new proxy (issue #2164) 2024-08-08 12:43:31 +02:00
Sébastien Helleu eaf6d33f22 core: update translations (issue #2164) 2024-08-06 08:29:23 +02:00
Sébastien Helleu 4e1a0731e7 core: convert proxy option ipv6 from boolean to enum (disable, auto, force) (issue #2164) 2024-08-06 08:27:09 +02:00
Sébastien Helleu 5fe3b38892 irc: convert server option ipv6 from boolean to enum (disable, auto, force) (issue #2164) 2024-08-06 08:25:42 +02:00
Sébastien Helleu e051af0376 api: add constants for IPv6 and allow force of IPv6 in function hook_connect (issue #2164) 2024-08-06 08:25:42 +02:00
Sébastien Helleu ab2bcbac4e doc/plugin: fix Python example of function hook_connect 2024-07-27 09:47:03 +02:00
Sébastien Helleu 8c48b2f310 relay/api: fix connection to remote using an IPv6 address with square brackets (closes #2156) 2024-07-22 17:24:50 +02:00
Sébastien Helleu 9ece7b4d8c core, plugins: fix typo in comments 2024-07-22 11:49:26 +02:00
Sébastien Helleu cadd04693a irc: add support of message 569 (whois, connecting from) (closes #2162) 2024-07-22 10:39:03 +02:00
Sébastien Helleu 1c04f9419c tests: fix comment on test of IRC message 344 2024-07-22 10:38:13 +02:00
Sébastien Helleu 03d8fddafd core: add contributor (issue #2136) 2024-07-21 11:44:53 +02:00
miko e4e0b9764d plugins: refactor macro weechat_va_format with the same behavior as string_asprintf 2024-07-21 11:34:02 +02:00
Sébastien Helleu d3ca619526 relay/api: fix connection to remote without password (closes #2158) 2024-07-20 16:26:53 +02:00
Sébastien Helleu fc197df056 relay/api: allow clients without authentication when no relay password is defined and option relay.network.allow_empty_password is on (issue #2158) 2024-07-20 15:57:56 +02:00
Nils Görs 484b90d39a core: update German translations 2024-07-19 12:59:31 +02:00
Sébastien Helleu 66707dbdf9 relay: add option reconnect in command /remote (closes #2160) 2024-07-19 09:19:34 +02:00
Nils Görs 66792445b4 core: update German translations 2024-07-18 16:14:18 +02:00
Sébastien Helleu b316a7a0c6 script: add info "script_info" 2024-07-17 22:38:47 +02:00
Sébastien Helleu c486a4f60a relay: fix crash when sending data to a remote buffer when the remote has been deleted (closes #2157) 2024-07-16 23:51:46 +02:00
Sébastien Helleu 2646d1b5ad core: add version 4.3.5 in ChangeLog 2024-07-16 23:03:48 +02:00
Sébastien Helleu 40b074c6d6 ruby: fix crash in plugin initialization (closes #2163)
This regression was introduced by commit
701f64afc1.
2024-07-15 09:39:54 +02:00
Sébastien Helleu ceba5f4947 doc/relay: remove duplicated description of data in message "_buffer_line_data_changed"
A link to "_buffer_line_added" is provided as data is exactly the same in this
message.
2024-07-14 09:39:01 +02:00
Sébastien Helleu 620e0dd8b6 doc/relay: fix title of chapter "_buffer_line_changed" in Japanese doc 2024-07-14 09:22:59 +02:00
Sébastien Helleu a957266279 relay: translate connection status in output of commands /relay list and /relay listfull 2024-07-13 10:33:06 +02:00
Sébastien Helleu 2d534aed68 relay: display connection status in output of commands /remote list and /remote listfull 2024-07-13 10:32:56 +02:00
Ivan Pešić b86bd39975 Update Serbian translation 2024-07-10 21:26:59 +02:00
Eric Lalonde 5bd581f8cf irc: fix lag check interval comment
The network lag check interval is stored in irc_config_network_lag_check, which does not default to 5 seconds.
2024-07-08 21:59:49 +02:00
Sébastien Helleu 8e2275cebc relay/api: fix timezone of dates sent to clients (closes #2151) 2024-07-08 19:10:27 +02:00
Sébastien Helleu 7e73da310e relay/api: remove unused macro MSG_ADD_HDATA_TIME (issue #2151) 2024-07-08 19:08:41 +02:00
Sébastien Helleu a75db3488d relay/api: allow body type "buffers" in remote client 2024-07-08 18:16:56 +02:00
Nils Görs 8511fd7b7b core: update German translations 2024-07-08 10:46:19 +02:00
Sébastien Helleu 9d98dee7d9 spell: improve error displayed when a word can not be added to the dictionary (closes #2144) 2024-07-06 11:57:26 +02:00
Nils Görs c6092b67d0 core: update German translations 2024-07-04 11:23:53 +02:00
Sébastien Helleu 42fd085388 core: add version 4.3.4 in ChangeLog 2024-07-03 22:09:05 +02:00
Sébastien Helleu 06685b6e68 core: add info "window" (closes #2141) 2024-07-01 21:23:36 +02:00
Sébastien Helleu 62c89c1e3b core: allow mask in command /item refresh 2024-07-01 20:52:31 +02:00
Sébastien Helleu cac5717b41 relay/api: add body types buffers and lines (array) 2024-06-30 13:01:29 +02:00
Sébastien Helleu a9ed58fae3 core: add relay protocol in ChangeLog entries 2024-06-30 00:38:06 +02:00
Sébastien Helleu 8f13a9cff0 relay/api: fix "body_type" returned when lines or nicks of a buffer are requested
The "body_type" returned is now this one, instead of "buffer":

- `GET /api/buffers/xxx/lines`: "line"
- `GET /api/buffers/xxx/nicks`: "nick_group"
2024-06-30 00:36:29 +02:00
Sébastien Helleu 3828a9f987 tests: add field "request_id" in tests of relay api protocol 2024-06-30 00:22:46 +02:00
Sébastien Helleu 270a822f41 relay/api: bump version in OpenAPI document 2024-06-30 00:15:25 +02:00
Sébastien Helleu 259615d436 relay/api: add field "request_id" in websocket frame (request and response) 2024-06-30 00:11:29 +02:00
Sébastien Helleu 1cacbde6b7 relay: remove check of NULL pointers before calling free functions 2024-06-30 00:11:00 +02:00
Sébastien Helleu f8f6e100d0 relay/api: always set "body_type" and "body" (null if there is no body) in websocket frame 2024-06-29 23:59:59 +02:00
Sébastien Helleu 2184af9d99 relay: flatten JSON event object sent to api relay clients 2024-06-29 19:48:34 +02:00
Sébastien Helleu 86c4f3979a doc/user: change port in examples of weechat relay from 9000 to 9500 2024-06-29 17:37:47 +02:00
Sébastien Helleu 701f64afc1 ruby: fix builtin functions not available (closes #2109) 2024-06-29 07:59:06 +02:00
Sébastien Helleu e6e0843698 core: add missing command /filter in ChangeLog (issue #1956) 2024-06-29 07:41:58 +02:00
Brad Smith de6fe1f3e1 tests: fix compilation of tests on OpenBSD 2024-06-28 23:23:15 +02:00
Sébastien Helleu 3993aa310f relay: send event "buffer_line_data_changed" to clients of "weechat" protocol 2024-06-27 22:21:09 +02:00
Sébastien Helleu 7d6afff01c relay: add line id in buffer lines sent to clients with weechat protocol 2024-06-27 22:12:34 +02:00
Sébastien Helleu 555632b615 relay/remote: update buffer line on event "buffer_line_data_changed" 2024-06-27 21:39:21 +02:00
Sébastien Helleu d5975c96e9 relay: send event "buffer_line_data_changed" to API clients 2024-06-27 21:37:47 +02:00
Sébastien Helleu e9d46b41a1 api: send new signal "buffer_line_data_changed" when a line is updated in a buffer via hdata 2024-06-27 20:55:42 +02:00
Sébastien Helleu b04e1ffd27 relay: fix read of one buffer line in API protocol 2024-06-27 20:55:42 +02:00
Sébastien Helleu f076db4767 api: add function line_search_by_id 2024-06-27 20:55:42 +02:00
Sébastien Helleu 0e9ed21edf tests/scripts: add tests on window functions 2024-06-27 20:55:42 +02:00
Sébastien Helleu 74fabe1946 tests/scripts: add tests on buffer functions 2024-06-27 20:55:42 +02:00
Sébastien Helleu 476708923c tests/scripts: fix comment 2024-06-27 20:55:42 +02:00
Sébastien Helleu c6a4ffb1a7 core: fix crash when deleting a bar that has no items (closes #2138) 2024-06-27 18:52:12 +02:00
Sébastien Helleu 85c7494dc7 python: call empty eval workaround before auto-load of scripts (issue #2046, issue #2126)
This should definitely fix the crash with Python 3.12, even when scripts are
auto-loaded (the previous fix was working only when the scripts are loaded
manually).
2024-06-26 18:44:35 +02:00
Sébastien Helleu 3d3d8f2ea7 scripts: fix reset of "quiet" status in case of nested calls (issue #2046, issue #2126) 2024-06-26 18:43:40 +02:00
Nils Görs dc283dd1c7 core: update German translations 2024-06-24 10:58:24 +02:00
Sébastien Helleu cb4aa8ea65 core: add hdata_count in /help eval 2024-06-23 22:45:09 +02:00
Sébastien Helleu 7cab57fba1 core: update ChangeLog (issue #2046, issue #2126) 2024-06-23 18:42:01 +02:00
Trygve Aaberge 830b152776 python: unload script interpreters before eval interpreter
The workaround in the previous commit didn't work for one user, so try
unloading the eval interpreter last to see if that helps.
2024-06-23 18:40:18 +02:00
Trygve Aaberge c325dedf05 python: add workaround for crash on unload with Python 3.12
Python 3.12 has a bug where it crashes when you unload all the
interpreters unless you make sure to unload the first interpreter you
loaded last. For some reason, loading the eval interpreter before any
scripts also seems to prevent the issue, even if the eval interpreter is
unloaded before the other interpreters.

So this just evals an empty string at the end of initing the Python
plugin if the Python version is 3.12, to make sure the eval interpreter
is loaded first.

Fixes #2046
2024-06-23 18:40:18 +02:00
Sébastien Helleu 03048895ec core: add distribution in bug report template 2024-06-23 13:34:19 +02:00
Sébastien Helleu 0f1441a78c core: fix command /bar addreplace with input bar (issue #2095)
Now the bar item "input_text" is added only after creating the new input bar,
so it can be added or replaced like the other bars.
2024-06-23 09:47:05 +02:00
Krzysztof Korościk c885a5031f core: update polish translation 2024-06-22 19:44:25 +02:00
Sébastien Helleu 4fbea53439 core: add version 4.3.3 in ChangeLog 2024-06-22 11:50:09 +02:00
Sébastien Helleu c34d522bb7 core: fix cast of pointer to unsigned long long
This fixes a warning displayed by the gcc compiler.
2024-06-22 10:21:00 +02:00
Sébastien Helleu 2a6b16d1de tests: add tests of hdata returning NULL pointer in eval 2024-06-22 09:08:47 +02:00
Sébastien Helleu bdfa1bd51c core, plugins: return "0x0" instead of "(nil)" for pointers formatted in strings
This is a partial revert of the commit
965beb37de.
2024-06-22 08:54:08 +02:00
Sébastien Helleu a75a947f5f irc: fix apply of custom buffer property "short_name" when a channel buffer is renamed 2024-06-19 21:43:08 +02:00
Sébastien Helleu 0d8e3a48ee core: apply buffer properties (options weechat.buffer.*) when a buffer name is changed 2024-06-19 21:42:38 +02:00
Sébastien Helleu 7cd8312bf9 irc: fix property "short_name" of channel buffer when the joined channel has a different case than the /join command 2024-06-19 20:52:02 +02:00
Sébastien Helleu 1fcf5ac5b3 core, plugins: force "short_name" in buffers to non-empty value (name by default), remove buffer property "short_name_is_set" 2024-06-18 20:34:58 +02:00
Sébastien Helleu eb83e8d018 doc/relay: add doc on "api" relay 2024-06-18 20:32:05 +02:00
Sébastien Helleu 7d4e0acfef doc/relay: move diagram to an include file 2024-06-16 20:27:57 +02:00
Sébastien Helleu b18af8dcf4 doc: add shell syntax highlighting 2024-06-16 20:05:45 +02:00
Sébastien Helleu 94bcf98c63 doc/relay: add "api" in list of other relay protocols 2024-06-16 20:05:45 +02:00
Sébastien Helleu 23e3a60e4e debian: add Serbian docs in packaging 2024-06-16 20:05:45 +02:00
Sébastien Helleu 7b39706716 debian: add Czech quickstart guide in packaging 2024-06-16 20:05:45 +02:00
Sébastien Helleu 8e7597815f doc: rename doc "weechat_relay_protocol" to "weechat_relay_weechat" 2024-06-16 20:05:45 +02:00
Ivan Pešić 8f952a4b29 doc: Update Serbian documentation 2024-06-16 20:04:28 +02:00
Ivan Pešić 3155764eb5 core: Update Serbian translation 2024-06-16 20:04:28 +02:00
Sébastien Helleu 36ca300b8d Revert "core: replace "%lx" by "%p" in function relay_weechat_msg_add_pointer"
This reverts commit 8923ecc7d8.
2024-06-16 10:16:51 +02:00
Sébastien Helleu 740aa49271 irc: rename parameter -re to -raw in command /list (closes #2124) 2024-06-16 09:15:03 +02:00
Sébastien Helleu d171c1682c doc/api: replace format "%lx" by "%p" in examples 2024-06-14 22:14:28 +02:00
Sébastien Helleu 8923ecc7d8 core: replace "%lx" by "%p" in function relay_weechat_msg_add_pointer 2024-06-14 18:10:45 +02:00
Sébastien Helleu f8d98bbd5e core: replace "%lx" by "%p" in dump of relay data 2024-06-14 18:10:18 +02:00
Sébastien Helleu d0830b9255 relay: fix dump of variable "websocket_key" 2024-06-14 18:09:53 +02:00
Sébastien Helleu e482360eba core: replace "%lx" by "%p" in debug of windows 2024-06-14 18:02:45 +02:00
Sébastien Helleu e64ab3c675 core, plugins: replace "%lx" by "%p" in calls to sscanf 2024-06-14 17:59:02 +02:00
Sébastien Helleu ce79d218a4 core: remove duplicate search of pointer in hashtable for evaluation of "hdata_count" 2024-06-14 17:37:47 +02:00
Sébastien Helleu c83b08fae8 tests: add test on function hdata_count with empty list "gui_layouts" 2024-06-14 17:37:11 +02:00
Sébastien Helleu ce3c5f0caa core: add hdata count in evaluation of expressions
Syntax is one of:

- `hdata_count:name[list]`: uses a hdata name and list
- `hdata_count:name[pointer]`: uses a hdata name and pointer (count starts at
  this pointer)
2024-06-14 17:04:06 +02:00
Sébastien Helleu 8945b7bf33 core: add function hdata_count 2024-06-14 17:04:06 +02:00
Sébastien Helleu 24e023d467 core: fix id of core buffer in hashtable gui_buffer_by_id after /upgrade 2024-06-11 08:13:20 +02:00
Sébastien Helleu 79a7766466 core: fix typo in comment 2024-06-11 08:09:32 +02:00
Sébastien Helleu 9b356733a9 core: allow buffer id in commands /buffer and /print, in addition to number and name 2024-06-11 08:03:09 +02:00
Sébastien Helleu 63148c5cc8 doc/api: add type "long long" in function hashtable_get_string 2024-06-11 07:17:28 +02:00
Sébastien Helleu 8366c32b0a core: add hashtable to quickly find buffers by id 2024-06-10 23:55:34 +02:00
Sébastien Helleu 70417a1ac6 api: add hashtable type "longlong" 2024-06-10 23:55:34 +02:00
Sébastien Helleu 93433e5dd7 tests: add tests on hashtable with different key/value types 2024-06-10 19:42:57 +02:00
Sébastien Helleu dc902b4e0a api: allow NULL value for key in hashtable 2024-06-10 19:42:47 +02:00
Sébastien Helleu 26c01e30c3 core, plugins: remove unneeded break after return 2024-06-10 15:10:25 +02:00
Sébastien Helleu 023a3b90fa core: fix refresh of bar item "scroll" in root bar after /buffer clear (closes #590) 2024-06-10 14:29:29 +02:00
Sébastien Helleu 7395387ebe core: add issue #446 in ChangeLog 2024-06-10 13:45:09 +02:00
Sébastien Helleu 3ee5341fbc perl: use lower case for CMake keywords 2024-06-10 09:01:27 +02:00
Sébastien Helleu 39cb0942a2 perl: fix quote of variable PERL_LFLAGS in CMake file 2024-06-10 08:59:36 +02:00
Sébastien Helleu 920d06bd27 core, plugins: fix return code of command callbacks in case of error 2024-06-10 08:17:25 +02:00
Sébastien Helleu 3835351226 tests: add placeholder for tests on function irc_list_export 2024-06-09 23:51:00 +02:00
Sébastien Helleu b0f0afd7fa fset: fix typo in /help fset 2024-06-09 23:16:32 +02:00
Sébastien Helleu 8824ff7d6c irc: add option -export in command /list, add option irc.look.list_buffer_format_export 2024-06-09 23:15:26 +02:00
Sébastien Helleu fb86ddc770 irc: clear /list buffer when disconnecting from server (closes #2133) 2024-06-09 18:35:22 +02:00
Sébastien Helleu d63553a73d irc: display an explicit message on /list buffer when the list of channels is empty (issue #2133) 2024-06-09 18:34:35 +02:00
Sébastien Helleu 85c8866407 relay: add option addreplace in command /remote (issue #2095) 2024-06-09 16:58:37 +02:00
Sébastien Helleu 337c9c840d relay: add option addreplace in command /relay (issue #2095) 2024-06-09 16:58:25 +02:00
Sébastien Helleu eaead31b11 irc: add option addreplace in command /server (issue #2095) 2024-06-09 16:58:12 +02:00
Sébastien Helleu a8525b41b3 irc: add option addreplace in command /notify (issue #2095) 2024-06-09 16:58:00 +02:00
Sébastien Helleu b7d2bd5c9e irc: add option addreplace in command /ignore (issue #2095) 2024-06-09 16:57:44 +02:00
Sébastien Helleu f4aab20bb4 core: add option addreplace in command /proxy (issue #2095) 2024-06-09 16:55:53 +02:00
Sébastien Helleu b45584114f core: remove "breaking" tag in ChangeLog 2024-06-09 16:53:36 +02:00
Krzysztof Korościk 37eda67776 updated polish translation
Signed-off-by: Krzysztof Korościk <soltys@soltys.info>
2024-06-09 14:51:39 +02:00
Sébastien Helleu e06e4d1457 core, plugins: use variable "argv" in calls to macro COMMAND_MIN_ARGS 2024-06-09 10:53:05 +02:00
Sébastien Helleu ea3486dae3 core: add option addreplace in command /bar (issue #2095) 2024-06-09 10:17:27 +02:00
Sébastien Helleu 6499d77e1d alias: add options addreplace and addreplacecompletion in command /alias (issue #2095)
The commands `/alias add` and `/alias addcompletion` now return an error if the
alias already exists.
2024-06-09 10:15:44 +02:00
Sébastien Helleu df67f7a0ea core: fix completion of command /item refresh 2024-06-09 09:11:03 +02:00
Sébastien Helleu 12b8ebe4e4 core: add completion "bars_items" 2024-06-09 09:09:09 +02:00
Sébastien Helleu 6306bac20b core: fix French translation of parameter "refresh" in /help item 2024-06-09 09:06:55 +02:00
Sébastien Helleu 843dcd49b5 tests: add more tests on function string_split_shell 2024-06-08 14:24:43 +02:00
LuK1337 44238650bc tests: relay: fix relay_http_parse_header function prototype 2024-06-07 12:39:40 +02:00
Sébastien Helleu 6b7137aa25 tests: reset option relay.network.websocket_allowed_origins after changing it in tests (closes #2127)
This fixes a test failure when the test changing the option is executed before
this one:

…/tests/unit/plugins/relay/api/test-relay-api-protocol.cpp:799: error: Failure in TEST(RelayApiProtocolWithClient, RecvJson)
        expected <HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: Z5uTZwvwYNDm9w4HFGk26ijp/p0=

>
        but was  <HTTP/1.1 403 Forbidden
Content-Length: 0

>
        difference starts at position 9 at: < HTTP/1.1 403 Forbid>
2024-06-07 12:33:17 +02:00
Sébastien Helleu 3d20ad8b5c doc/user: mention pkgconf with pkg-config in dependencies 2024-06-07 07:44:39 +02:00
Sébastien Helleu da97614e03 ci: install pkg-config with homebrew 2024-06-07 07:44:03 +02:00
Sébastien Helleu c6481451cb ci: replace package pkg-config by pkgconf 2024-06-07 07:38:05 +02:00
Sébastien Helleu f59eb83da4 debian: update changelog 2024-06-06 22:51:09 +02:00
Sébastien Helleu 2648d87a65 debian: replace pkg-config build dependency by pkgconf 2024-06-06 22:50:33 +02:00
Sébastien Helleu 1a21ab10fa core: add version 4.3.2 in ChangeLog 2024-06-06 22:09:02 +02:00
Sébastien Helleu 396f47e9ae xfer: fix display of input prompt in DCC chat buffers (issue #2128) 2024-06-06 13:30:25 +02:00
Sébastien Helleu 0b1e940829 irc: fix display of input prompt in private buffers (closes #2128) 2024-06-05 21:03:44 +02:00
Sébastien Helleu 7cf45707ea tests: add test on info "irc_buffer" with a valid server and a non-existing channel 2024-06-02 23:08:03 +02:00
Sébastien Helleu f104b4119a irc: don't return pointer to irc server if the channel or nick is not found in info "irc_buffer" 2024-06-02 22:49:41 +02:00
Sébastien Helleu 4d0378d579 core: fix style for breaking changes in ChangeLog 2024-06-02 22:48:00 +02:00
Sébastien Helleu a12419b888 core: add link to issue #1549 for ChangeLog entries about permessage-deflate 2024-06-02 09:54:47 +02:00
Sébastien Helleu 26fa0ea1b8 relay: enable websocket extension "permessage-deflate" with "api" relay only 2024-06-02 09:05:40 +02:00
Krzysztof Korościk 7b90b1fbf4 doc: update polish translation 2024-06-01 22:23:05 +02:00
Krzysztof Korościk 61f31eafcf core: update polish translation 2024-06-01 22:07:06 +02:00
Sébastien Helleu 9264803bc3 relay: fix websocket permessage-deflate extension when the client doesn't send the max window bits parameters 2024-06-01 15:15:01 +02:00
Sébastien Helleu d05df9ee21 relay: fix allocation and reinit of field "client_context_takeover" in websocket deflate structure 2024-06-01 14:42:55 +02:00
Sébastien Helleu 8dad5403ee relay: add quotes around protocol names in options, mention "api" before "weechat" 2024-06-01 13:05:27 +02:00
Sébastien Helleu e39a309365 relay: add option relay.network.websocket_permessage_deflate 2024-06-01 12:58:17 +02:00
Nils Görs b5b063a836 core: update German translations 2024-05-31 20:33:09 +02:00
Sébastien Helleu 2dd083554b core: remove duplicate entry in upgrade guidelines 2024-05-31 13:58:25 +02:00
Sébastien Helleu d6e69792ca core: add version 4.3.1 in ChangeLog and upgrade guidelines 2024-05-31 13:45:34 +02:00
Sébastien Helleu cd75ad0545 core: add version 4.2.3 in ChangeLog 2024-05-31 13:44:06 +02:00
Sébastien Helleu d6ffe1857b doc/api: fix typo in function string_cut 2024-05-31 12:24:33 +02:00
Sébastien Helleu b38cf0e9a3 relay: use API function string_cut to truncate raw relay messages
This is faster than the custom function that was adding " (...) " in the middle
of the message.
2024-05-31 12:04:13 +02:00
Sébastien Helleu 768416983c xfer: fix send of data on the DCC chat buffer after /upgrade if the buffer was opened before the upgrade (closes #2092) 2024-05-31 08:11:55 +02:00
Nils Görs ce1fc02dee core: update German translations 2024-05-29 23:22:31 +02:00
Sébastien Helleu e841c11b54 relay: add option relay.look.raw_messages_max_length (issue #2122) 2024-05-29 23:07:58 +02:00
Sébastien Helleu 6152812bff doc/user: add internal links to commands and options 2024-05-29 21:14:25 +02:00
Nils Görs 5cff9c0e46 core: update German translations 2024-05-27 22:27:27 +02:00
Sébastien Helleu bd8e0d8bfa relay/remote: add translations for some messages displayed 2024-05-27 21:46:24 +02:00
Sébastien Helleu 3d39f7e86c core: remove versions without upgrade guidelines 2024-05-27 12:12:24 +02:00
Sébastien Helleu 030d82148c core: update examples in Debian build script 2024-05-27 08:58:56 +02:00
Sébastien Helleu bf4e47b9f2 core: fix detection of libgcrypt ≥ 1.11 (debian #1071960)
Use pkg-config to detect libgcrypt, since command `libgcrypt-config` is not
available any more.

Remove patches for Debian/Raspbian Buster and Ubuntu Bionic: detection of
libgcrypt don't work any more with version 1.8.4 on Debian Buster and 1.8.1 on
Ubuntu Bionic (both versions don't provide the file `libgcrypt.pc`).
2024-05-27 08:15:59 +02:00
Sébastien Helleu 85c02e9137 irc: close /list buffer when the server buffer is closed (closes #2121) 2024-05-27 07:40:03 +02:00
Sébastien Helleu 8d86d85b66 relay: fix compiler warnings when cJSON is disabled 2024-05-26 23:46:52 +02:00
Sébastien Helleu 5a8751b9eb core, relay: fix include directory of libcjson and libzstd 2024-05-26 23:13:49 +02:00
Sébastien Helleu 96f9942aed php: fix return value of function hdata_longlong 2024-05-26 16:24:16 +02:00
Sébastien Helleu 449e5ae705 core: add link to issues in ChangeLog 2024-05-26 16:05:56 +02:00
Sébastien Helleu 51d2d71a04 core: update ChangeLog 2024-05-26 16:02:46 +02:00
LuK1337 4e01c077d6 tcl: fix return value for hdata_longlong
Using API_RETURN_LONG() here breaks tests on i368.
2024-05-26 15:59:12 +02:00
Sébastien Helleu 917054c58d tests: fix compilation of tests on Rocky 9.4 2024-05-26 15:41:52 +02:00
Sébastien Helleu d1ae17a8e0 core: add note about lag in buflist in upgrade guidelines 2024-05-26 14:37:48 +02:00
Sébastien Helleu d616f5bc55 core: update ChangeLog 2024-05-26 14:10:10 +02:00
LuK1337 14187b3834 tests: relay: fix HotlistToJson test on s390x
1: error: Failure in TEST(RelayApiMsg, HotlistToJson)
1: 	expected <2024-05-26T10:29:37.716512Z>
1: 	but was  <2024-05-26T10:29:37.000000Z>
1: 	difference starts at position 20 at: <T10:29:37.000000Z   >
2024-05-26 14:03:04 +02:00
LuK1337 9bd1ea1e5e tests: scripts: fix wrong ifdef check 2024-05-26 14:00:07 +02:00
LuK1337 6f774a8e8e tests: relay: add missing <string.h> include
Fixes build error on Fedora 40.
2024-05-26 13:58:35 +02:00
Sébastien Helleu 62ab68715d relay: add infos "relay_api_version" and "relay_api_version_number" 2024-05-26 10:44:23 +02:00
Sébastien Helleu 603c44a64d core: replace emails by links to GitHub accounts in AUTHORS.md 2024-05-26 10:27:30 +02:00
Sébastien Helleu a86c329b4c core: rename and convert AUTHORS.adoc to AUTHORS.md 2024-05-26 10:27:30 +02:00
Sébastien Helleu d0d1d2e4b9 core: rename and convert README.adoc to README.md 2024-05-26 10:27:30 +02:00
Sébastien Helleu 5d0784bd52 core: rename and convert Contributing.adoc to CONTRIBUTING.md 2024-05-26 10:27:30 +02:00
Sébastien Helleu 3653f4b7a2 core: rename and convert ReleaseNotes.adoc to UPGRADING.md 2024-05-26 10:27:25 +02:00
Sébastien Helleu 8260421767 core: rename and convert ChangeLog.adoc to CHANGELOG.md 2024-05-26 10:26:23 +02:00
Sébastien Helleu 688c77d9f5 Version 4.4.0-dev 2024-05-26 09:21:28 +02:00
Sébastien Helleu b407de4c3b Version 4.3.0 2024-05-26 09:16:17 +02:00
Sébastien Helleu 8444670ef1 relay/api: set API version to 0.1.0 in OpenAPI document 2024-05-26 08:39:28 +02:00
Sébastien Helleu 657805ca25 core: add relay options renamed in release notes 2024-05-26 08:24:08 +02:00
Sébastien Helleu 12378b3a19 relay/api: set API version to 0.1.0 2024-05-26 00:04:28 +02:00
332 changed files with 23026 additions and 11692 deletions
+3 -3
View File
@@ -9,7 +9,7 @@ body:
Before submitting a bug, please check that it has not already been reported by searching in [open and closed bugs](https://github.com/weechat/weechat/issues?q=is%3Aissue+label%3Abug).
If you don't use the latest version, please try if possible with the latest stable release to be sure the issue is still present and report the issue on this version.
**IMPORTANT**: please do not report any security issue here, see [Contributing.adoc](https://github.com/weechat/weechat/blob/master/Contributing.adoc#security-reports).
**IMPORTANT**: please do not report any security issue here, see [CONTRIBUTING.md](https://github.com/weechat/weechat/blob/main/CONTRIBUTING.md#security-reports).
- type: textarea
id: bug-description
@@ -85,9 +85,9 @@ body:
- type: input
id: os-version
attributes:
label: What OS are you using?
label: What OS/distribution are you using?
description: Name of the operating system and its version.
placeholder: Debian 12, Ubuntu 23.10, MacOS 14, ...
placeholder: Debian 12, Ubuntu 24.04, MacOS 14, ...
validations:
required: true
+10 -5
View File
@@ -33,7 +33,7 @@ env:
libzstd-dev
ninja-build
php-dev
pkg-config
pkgconf
pylint
python3-bandit
python3-dev
@@ -100,9 +100,10 @@ jobs:
run: |
weechat --help
weechat-curses --help
weechat --version
weechat --build-info
weechat --colors
weechat --license
weechat --version
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
- name: Test Relay OpenAPI
@@ -137,7 +138,7 @@ jobs:
strategy:
matrix:
os:
- macos-12
- macos-14
config:
- { name: "gcc", cc: "gcc", cxx: "g++" }
- { name: "clang", cc: "clang", cxx: "clang++" }
@@ -167,7 +168,9 @@ jobs:
/usr/local/bin/python3.11 \
/usr/local/bin/python3.11-config \
;
brew install asciidoctor cjson guile lua pkg-config ruby
# workaround for https://github.com/actions/runner-images/issues/10984
brew uninstall --ignore-dependencies --force pkg-config@0.29.2
brew install asciidoctor aspell cjson guile lua ruby
- uses: actions/checkout@v2
@@ -187,9 +190,10 @@ jobs:
run: |
weechat --help
weechat-curses --help
weechat --version
weechat --build-info
weechat --colors
weechat --license
weechat --version
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
build_debian:
@@ -227,6 +231,7 @@ jobs:
weechat --help
weechat-curses --help
weechat --version
weechat --build-info
weechat --run-command "/debug dirs;/debug libs" --run-command "/quit"
codeql-analysis:
-164
View File
@@ -1,164 +0,0 @@
= WeeChat Authors
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
== Developers
* General code
** Sébastien Helleu (FlashCode) <flashcode@flashtux.org>
* Scripts plugins, debian packager
** Emmanuel Bouthenot (kolter) <kolter@openics.org>
== Contributors
Alphabetically:
* Adam Saponara (adsr)
* Adrian Bjugård
* Ailin Nemui (Nei)
* Aleksey V Zapparov
* Alex Tarkovsky
* Anders Bergh
* Andrew Potter (talisein)
* Antoine Pietri (seirl)
* Arvydas Sidorenko
* Asakura
* Bazerka
* Benoit Papillault (benoit)
* Chris Hills
* Christian Duerr
* Christian Heinz
* Christopher O'Neill (deltafire)
* coypoop
* Danilo Spinella
* David Flatz
* Dmitry Kobylin
* Dominik Honnef
* Dominique Martinet
* dotflac
* Eduardo Elias
* Eli Schwartz
* Elizabeth Myers (Elizacat)
* Elián Hanisch (m4v)
* Emanuele Giaquinta
* Emir Sarı
* emk
* Érico Nogueira
* Esteban I. Ruiz Moreno (Exio)
* Evgeny Shmarnev
* Felix Eckhofer
* Frank Zacharias
* Fredrik Fornwall
* Grant Wu
* Gu1ll4um3r0m41n
* Guido Berhoerster
* Gwenn
* Hasan Kiran (turgay)
* Ivan Pešić
* Ivan Sichmann Freitas
* Jakub Jirutka
* Jan Palus
* Jason A. Donenfeld (zx2c4)
* JD Horelick (jdhore)
* jesopo
* Jim Ramsay (lack)
* Jiri Golembiovsky (GolemJ)
* Joey Pabalinas (alyptik)
* Johan Rylander
* Johannes Kuhn
* Joram Schrijver
* Jos Ahrens
* Joseph Kichline
* Juan Francisco Cantero Hurtado
* Julien Louis (ptitlouis)
* Karthik K
* Koka El Kiwi (KiwiDash)
* Krzysztof Koroscik (soltys)
* Kyle Fuller (kylef)
* Kyle Sabo
* Latchezar Tzvetkoff
* Lázaro A.
* Leonid Evdokimov
* Linus Heckemann
* LuK1337
* Maarten de Vries
* Mantas Mikulėnas (grawity)
* Marco Paolone
* Marco Sirabella
* Mario Campos
* Mateusz Poszwa
* Matt Robinson
* Matthew Horan
* Matthew Martin
* Matti Virkkunen
* Max Anton Teufel
* Maxim Baz
* Michael Siegel
* Miroslav Koskar
* Murilo Opsfelder Araujo
* Neui
* Nick (SolitaryCipher)
* Nicolas Cavigneaux
* Nils Görs (nils_2)
* nyuszika7h
* Odin
* Ondřej Súkup
* Patrick Steinhardt
* Patrik Janoušek
* Paul Komkoff
* Pavel Shevchuk (Stalwart)
* Peter Boström (pbos)
* Phillip Sz
* Pierre Carru
* Piotr Szymaniak
* Pistos
* Quentin Glidic (SardemFF7)
* Quentin Pradet
* Quico Noizeux
* rafasc
* Raghavendra Prabhu
* raspbeguy
* Rettub
* Rob Campbell
* Romero B. de S. Malaquias
* Rudolf Polzer (divVerent)
* Ruslan Bekenev
* Ryan Farley
* Ryan Qian
* Ryuunosuke Ayanokouzi
* scumjr
* Sergio Durigan Junior
* Shane McCarron
* Shawn Smith
* Shun Sakai
* Simmo Saan (sim642)
* Simon Arlott
* Simon Kuhnle
* Simon Ser
* Stefano Pigozzi
* Stfn
* Sven Knurr (Cthulhux)
* Tim D. Smith
* Tim Harder
* Tobias Stoeckmann
* Tom Alsberg
* Tom Fitzhenry
* Tomoe Mami
* Tor Hveem (xt)
* Trevor Bergeron
* Valentin Lorentz (progval)
* Vasco Almeida
* Victorhck
* Voroskoi
* wfrsk
* Wojciech Kwolek
* W. Trevor King
* Yannick Palanque
* ZethJack
* Ørjan Malde
== Contact
See the https://weechat.org/about/support/[support page].
+161
View File
@@ -0,0 +1,161 @@
# WeeChat Authors
## Developers
- General code
- [Sébastien Helleu](https://github.com/flashcode) (FlashCode)
- Scripts plugins, debian packager
- [Emmanuel Bouthenot](https://github.com/k0lter) (kolter)
## Contributors
Alphabetically:
- Adam Saponara (adsr)
- Adrian Bjugård
- Ailin Nemui (Nei)
- Aleksey V Zapparov
- Alex Tarkovsky
- Anders Bergh
- Andrew Potter (talisein)
- Antoine Pietri (seirl)
- Arvydas Sidorenko
- Asakura
- Bazerka
- Benoit Papillault (benoit)
- Chris Hills
- Christian Duerr
- Christian Heinz
- Christopher O'Neill (deltafire)
- coypoop
- Danilo Spinella
- David Flatz
- Dmitry Kobylin
- Dominik Honnef
- Dominique Martinet
- dotflac
- Eduardo Elias
- Eli Schwartz
- Elizabeth Myers (Elizacat)
- Elián Hanisch (m4v)
- Emanuele Giaquinta
- Emir Sarı
- emk
- Érico Nogueira
- Esteban I. Ruiz Moreno (Exio)
- Evgeny Shmarnev
- Felix Eckhofer
- Frank Zacharias
- Fredrik Fornwall
- Grant Wu
- Gu1ll4um3r0m41n
- Guido Berhoerster
- Gwenn
- Hasan Kiran (turgay)
- Ivan Pešić
- Ivan Sichmann Freitas
- Jakub Jirutka
- Jan Palus
- Jason A. Donenfeld (zx2c4)
- JD Horelick (jdhore)
- jesopo
- Jim Ramsay (lack)
- Jiri Golembiovsky (GolemJ)
- Joey Pabalinas (alyptik)
- Johan Rylander
- Johannes Kuhn
- Joram Schrijver
- Jos Ahrens
- Joseph Kichline
- Juan Francisco Cantero Hurtado
- Julien Louis (ptitlouis)
- Karthik K
- Koka El Kiwi (KiwiDash)
- Krzysztof Koroscik (soltys)
- Kyle Fuller (kylef)
- Kyle Sabo
- Latchezar Tzvetkoff
- Lázaro A.
- Leonid Evdokimov
- Linus Heckemann
- LuK1337
- Maarten de Vries
- Mantas Mikulėnas (grawity)
- Marco Paolone
- Marco Sirabella
- Mario Campos
- Mateusz Poszwa
- Matt Robinson
- Matthew Horan
- Matthew Martin
- Matti Virkkunen
- Max Anton Teufel
- Maxim Baz
- Michael Siegel
- Miko
- Miroslav Koskar
- Murilo Opsfelder Araujo
- Neui
- Nick (SolitaryCipher)
- Nicolas Cavigneaux
- Nils Görs (nils_2)
- nyuszika7h
- Odin
- Ondřej Súkup
- Patrick Steinhardt
- Patrik Janoušek
- Paul Komkoff
- Pavel Shevchuk (Stalwart)
- Peter Boström (pbos)
- Phillip Sz
- Pierre Carru
- Piotr Szymaniak
- Pistos
- Quentin Glidic (SardemFF7)
- Quentin Pradet
- Quico Noizeux
- rafasc
- Raghavendra Prabhu
- raspbeguy
- Rettub
- Rob Campbell
- Romero B. de S. Malaquias
- Rudolf Polzer (divVerent)
- Ruslan Bekenev
- Ryan Farley
- Ryan Qian
- Ryuunosuke Ayanokouzi
- scumjr
- Sergio Durigan Junior
- Shane McCarron
- Shawn Smith
- Shun Sakai
- Simmo Saan (sim642)
- Simon Arlott
- Simon Kuhnle
- Simon Ser
- Stefano Pigozzi
- Stfn
- Sven Knurr (Cthulhux)
- Tim D. Smith
- Tim Harder
- Tobias Stoeckmann
- Tom Alsberg
- Tom Fitzhenry
- Tomoe Mami
- Tor Hveem (xt)
- Trevor Bergeron
- Valentin Lorentz (progval)
- Vasco Almeida
- Victorhck
- Voroskoi
- wfrsk
- Wojciech Kwolek
- W. Trevor King
- Yannick Palanque
- ZethJack
- Ørjan Malde
## Contact
See the [support page](https://weechat.org/about/support/).
+4277
View File
File diff suppressed because it is too large Load Diff
+9 -9
View File
@@ -19,7 +19,7 @@
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
#
cmake_minimum_required(VERSION 3.5)
cmake_minimum_required(VERSION 3.18)
project(weechat C)
@@ -206,9 +206,10 @@ if(ENABLE_LARGEFILE)
endif()
# Check for libgcrypt
find_package(GCRYPT REQUIRED)
pkg_check_modules(LIBGCRYPT REQUIRED libgcrypt)
add_definitions(-DHAVE_GCRYPT)
list(APPEND EXTRA_LIBS ${GCRYPT_LDFLAGS})
include_directories(${LIBGCRYPT_INCLUDE_DIRS})
list(APPEND EXTRA_LIBS ${LIBGCRYPT_LDFLAGS})
# Check for GnuTLS
find_package(GnuTLS REQUIRED)
@@ -259,7 +260,6 @@ add_subdirectory(icons)
if(ENABLE_NLS)
find_package(Gettext REQUIRED)
add_definitions(-DENABLE_NLS)
find_package(Intl REQUIRED)
list(APPEND EXTRA_LIBS "${Intl_LIBRARIES}")
add_subdirectory(po)
@@ -321,11 +321,11 @@ configure_file("${CMAKE_CURRENT_SOURCE_DIR}/weechat.cygport.in" "${CMAKE_CURRENT
# install some files (only on Cygwin)
if(CYGWIN)
install(FILES
"${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/ChangeLog.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/Contributing.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/README.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/ReleaseNotes.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/AUTHORS.md"
"${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md"
"${CMAKE_CURRENT_SOURCE_DIR}/CONTRIBUTING.md"
"${CMAKE_CURRENT_SOURCE_DIR}/README.md"
"${CMAKE_CURRENT_SOURCE_DIR}/UPGRADING.md"
DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}"
)
endif()
+109
View File
@@ -0,0 +1,109 @@
# Contributing to WeeChat
## Reporting bugs
First, some basic things:
- Use only English to communicate with developers.
- Search in issues if the same problem or feature request has already been
reported (a duplicate is waste of time for you and the developers!).
- If you can, please check if the problem has been fixed in development version
(if you are using a stable release or old version).
- Report only one bug or feature request per issue.
### Security reports
Please **DO NOT** file a GitHub issue for security related problems, but send an
email to [security@weechat.org](mailto:security@weechat.org) instead.
### Required info
When reporting [issues](https://github.com/weechat/weechat/issues) on GitHub,
please include:
- Your **WeeChat version**: the output of `/v` in WeeChat, for example:
`WeeChat 1.7-dev (git: v1.6-6-g997f47f)`.\
If WeeChat does not start at all, please include the version displayed by
`weechat --help` (or the version installed with your package manager).
- Your **operating system**: its name and version (examples: Linux Debian Bookworm,
FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit…).
- The **steps to reproduce**: if possible, please include a reproducible example:
explain the steps which led you to the problem.\
It's even better if you can reproduce the problem with a new config (and no
scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
problem here.
- The **gdb's backtrace** (only for a crash): if you can reproduce the crash
(or if you have a core file), please include the backtrace from gdb (look at
[User's guide](https://weechat.org/doc/weechat/user/#report_crashes) for more info).
- The **actual result**.
- The **expected result**: the correct result you are expecting.
> [!IMPORTANT]
> Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_)
is **NOT USEFUL** to fix the bug, so please report this file **ONLY** if a developer
asked you to send it (and be extremely careful, this file can contain personal
data like passwords and contents of your chats).
### Scripts related issues
If you are using scripts, they can cause problems/crashes. To check if the
problem is related to one script, try to unload them one by one (using
command `/script unload <name>`).
Many issues reported are in fact related to bugs in scripts, so please first
check that before reporting any issue on WeeChat itself.
If you think the problem comes from a specific script, please report the issue
in the [scripts git repository](https://github.com/weechat/scripts/issues) instead.
## Translations
Pull requests on GitHub for fixes or new translations are welcome at any
time, for [WeeChat](https://github.com/weechat/weechat) and the website
[weechat.org](https://github.com/weechat/weechat.org).
To start a translation in a new language (not yet supported), please look at
[translations](https://weechat.org/doc/weechat/dev/#translations)
in Developer's guide.
## Feature requests
WeeChat is under active development, so your idea may already have been
implemented, or scheduled for a future version (you can check in
[roadmap](https://weechat.org/dev/) or
[milestones](https://github.com/weechat/weechat/milestones) on GitHub.
Pull requests on GitHub are welcome for minor new features.
For major new features, it's better to discuss about it in IRC
(server: `irc.libera.chat`, channel `#weechat`).
Before submitting any pull request, be sure you have read the
[coding rules](https://weechat.org/doc/weechat/dev/#coding_rules)
in Developer's guide, which contains info about styles used, naming convention
and other useful info.
## Semantic versioning
Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
It is based on [Semantic Versioning](https://semver.org/) but in a less strict way:
breaking changes in API with low user impact don't bump the major version.
The version number is on three digits `X.Y.Z`, where:
- `X` is the major version
- `Y` is the minor version
- `Z` is the patch version.
Rules to increment the version number:
- the **major version** number (`X`) is incremented only when intentional breaking changes
target feature areas that are actively consumed by users, scripts or C plugin API
- the **minor version** number (`Y`) is incremented for any new release of WeeChat
that includes new features and bug fixes, possibly breaking API with low impact on users
- the **patch version** number (`Z`) is reserved for releases that address severe bugs
or security issues found after the release.
For more information, see the
[specification](https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html).
-4195
View File
File diff suppressed because it is too large Load Diff
-109
View File
@@ -1,109 +0,0 @@
= Contributing to WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
== Reporting bugs
First, some basic things:
* Use only English to communicate with developers.
* Search in issues if the same problem or feature request has already been
reported (a duplicate is waste of time for you and the developers!).
* If you can, please check if the problem has been fixed in development version
(if you are using a stable release or old version).
* Report only one bug or feature request per issue.
=== Security reports
Please *DO NOT* file a GitHub issue for security related problems, but send an
email to <security@weechat.org> instead.
=== Required info
When reporting https://github.com/weechat/weechat/issues[issues] on GitHub,
please include:
* Your *WeeChat version*: the output of `/v` in WeeChat, for example:
_WeeChat 1.7-dev (git: v1.6-6-g997f47f)_. +
If WeeChat does not start at all, please include the version displayed by
`weechat --help` (or the version installed with your package manager).
* Your *operating system*: its name and version (examples: Linux Debian Bookworm,
FreeBSD 13.0, Windows/Cygwin 64-bit, Windows/Ubuntu 64-bit...).
* The *steps to reproduce*: if possible, please include a reproducible example:
explain the steps which led you to the problem. +
It's even better if you can reproduce the problem with a new config (and no
scripts loaded): try `weechat --dir /tmp/weechat` and check if you have the
problem here.
* The *gdb's backtrace* (only for a crash): if you can reproduce the crash
(or if you have a core file), please include the backtrace from gdb (look at
https://weechat.org/doc/weechat/user/#report_crashes[User's guide] for more info).
* The *actual result*.
* The *expected result*: the correct result you are expecting.
[IMPORTANT]
Most of times, the WeeChat crash log file (_weechat_crash_YYYYMMDD_xxx.log_) is
*NOT USEFUL* to fix the bug, so please report this file *ONLY* if a developer
asked you to send it (and be extremely careful, this file can contain personal
data like passwords and contents of your chats).
=== Scripts related issues
If you are using scripts, they can cause problems/crashes. To check if the
problem is related to one script, try to unload them one by one (using
command `/script unload <name>`).
Many issues reported are in fact related to bugs in scripts, so please first
check that before reporting any issue on WeeChat itself.
If you think the problem comes from a specific script, please report the issue
in the https://github.com/weechat/scripts/issues[scripts git repository]
instead.
== Translations
Pull requests on GitHub for fixes or new translations are welcome at any
time, for https://github.com/weechat/weechat[WeeChat] and the website
https://github.com/weechat/weechat.org[weechat.org].
To start a translation in a new language (not yet supported), please look at
https://weechat.org/doc/weechat/dev/#translations[translations]
in Developer's guide.
== Feature requests
WeeChat is under active development, so your idea may already have been
implemented, or scheduled for a future version (you can check in
https://weechat.org/dev/[roadmap] or
https://github.com/weechat/weechat/milestones[milestones] on GitHub.
Pull requests on GitHub are welcome for minor new features.
For major new features, it's better to discuss about it in IRC
(server: _irc.libera.chat_, channel _#weechat_).
Before submitting any pull request, be sure you have read the
https://weechat.org/doc/weechat/dev/#coding_rules[coding rules]
in Developer's guide, which contains info about styles used, naming convention
and other useful info.
== Semantic versioning
Since version 4.0.0, WeeChat is following a "practical" semantic versioning.
It is based on https://semver.org/[Semantic Versioning] but in a less strict way: breaking changes in API with low user impact don't bump the major version.
The version number is on three digits `X.Y.Z`, where:
* `X` is the major version
* `Y` is the minor version
* `Z` is the patch version.
Rules to increment the version number:
* the *major version* number (`X`) is incremented only when intentional breaking changes target feature areas that are actively consumed by users, scripts or C plugin API
* the *minor version* number (`Y`) is incremented for any new release of WeeChat that includes new features and bug fixes, possibly breaking API with low impact on users
* the *patch version* number (`Z`) is reserved for releases that address severe bugs or security issues found after the release.
For more information, see the https://specs.weechat.org/specs/2023-003-practical-semantic-versioning.html[specification].
-67
View File
@@ -1,67 +0,0 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
pass:[<p align="center">] image:https://weechat.org/media/images/weechat_logo_large.png[align="center"] pass:[</p>]
image:https://img.shields.io/badge/mastodon-follow-blue.svg["Mastodon", link="https://hostux.social/@weechat"]
image:https://img.shields.io/badge/diaspora*-follow-blue.svg["Diaspora*", link="https://diasp.eu/u/weechat"]
image:https://img.shields.io/badge/x-follow-blue.svg["Twitter", link="https://x.com/WeeChatClient"]
image:https://img.shields.io/badge/devel%20blog-follow-blue.svg["Devel blog", link="https://blog.weechat.org/"]
image:https://img.shields.io/badge/slant-recommend-28acad.svg["Slant", link="https://www.slant.co/topics/1323/~best-irc-clients-for-linux"]
image:https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg["Donate", link="https://weechat.org/donate/"]
image:https://github.com/weechat/weechat/workflows/CI/badge.svg["CI", link="https://github.com/weechat/weechat/actions"]
image:https://codecov.io/gh/weechat/weechat/branch/master/graph/badge.svg["Code coverage", link="https://codecov.io/gh/weechat/weechat"]
*WeeChat* (Wee Enhanced Environment for Chat) is a free chat client, fast and
light, designed for many operating systems.
It is highly customizable and extensible with scripts.
Homepage: https://weechat.org/
== Features
* *Modular chat client*: WeeChat has a lightweight core and optional https://weechat.org/doc/weechat/user/#plugins[plugins]. All plugins (including https://weechat.org/doc/weechat/user/#irc[IRC]) are independent and can be unloaded.
* *Multi-platform*: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
* *Multi-protocols*: WeeChat is designed to support multiple protocols by plugins, like IRC.
* *Standards-compliant*: the IRC plugin is compliant with RFCs https://datatracker.ietf.org/doc/html/rfc1459[1459], https://datatracker.ietf.org/doc/html/rfc2810[2810], https://datatracker.ietf.org/doc/html/rfc2811[2811], https://datatracker.ietf.org/doc/html/rfc2812[2812], https://datatracker.ietf.org/doc/html/rfc2813[2813] and https://datatracker.ietf.org/doc/html/rfc7194[7194].
* *Small, fast, and very light*: the core is and should stay as light and fast as possible.
* *Customizable and extensible*: there are a lot of options to customize WeeChat, and it is extensible with C plugins and https://weechat.org/scripts/[scripts] (https://weechat.org/scripts/language/perl/[Perl], https://weechat.org/scripts/language/python/[Python], https://weechat.org/scripts/language/ruby[Ruby], https://weechat.org/scripts/language/lua/[Lua], https://weechat.org/scripts/language/tcl/[Tcl], https://weechat.org/scripts/language/guile/[Scheme], https://weechat.org/scripts/language/javascript/[JavaScript] and https://weechat.org/scripts/language/php/[PHP]).
* *Fully documented*: there is comprehensive https://weechat.org/doc/weechat/[documentation], which is https://weechat.org/doc/weechat/dev/#translations[translated] into several languages.
* *Developed from scratch*: WeeChat was built from scratch and is not based on any other client.
* *Free software*: WeeChat is released under https://www.gnu.org/licenses/gpl-3.0.html[GPLv3].
pass:[<p align="center">] image:https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png[align="center"] pass:[</p>]
On WeeChat's website you can find https://weechat.org/about/screenshots/[more screenshots].
== Installation
WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.
For detailed instructions, please check the https://weechat.org/doc/weechat/user/#install[WeeChat user's guide].
== Semantic versioning
WeeChat is following a "practical" semantic versioning, see file link:Contributing.adoc#semantic-versioning[Contributing.adoc].
== Copyright
Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
This file is part of WeeChat, the extensible chat client.
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
WeeChat is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
+66
View File
@@ -0,0 +1,66 @@
# WeeChat
<p align="center">
<img src="https://weechat.org/media/images/weechat_logo_large.png" alt="WeeChat" />
</p>
[![Mastodon](https://img.shields.io/badge/mastodon-follow-blue.svg)](https://hostux.social/@weechat)
[![Diaspora*](https://img.shields.io/badge/diaspora*-follow-blue.svg)](https://diasp.eu/u/weechat)
[![X](https://img.shields.io/badge/x-follow-blue.svg)](https://x.com/WeeChatClient)
[![Devel blog](https://img.shields.io/badge/devel%20blog-follow-blue.svg)](https://blog.weechat.org/)
[![Slant](https://img.shields.io/badge/slant-recommend-28acad.svg)](https://www.slant.co/topics/1323/~best-irc-clients-for-linux)
[![Donate](https://img.shields.io/badge/help-donate%20%E2%9D%A4-ff69b4.svg)](https://weechat.org/donate/)
[![CI](https://github.com/weechat/weechat/workflows/CI/badge.svg)](https://github.com/weechat/weechat/actions)
[![Code coverage](https://codecov.io/gh/weechat/weechat/branch/main/graph/badge.svg)](https://codecov.io/gh/weechat/weechat)
**WeeChat** (Wee Enhanced Environment for Chat) is a free chat client, fast and light, designed for many operating systems.\
It is highly customizable and extensible with scripts.
Homepage: [https://weechat.org/](https://weechat.org/)
## Features
- **Modular chat client**: WeeChat has a lightweight core and optional [plugins](https://weechat.org/doc/weechat/user/#plugins). All plugins (including [IRC](https://weechat.org/doc/weechat/user/#irc)) are independent and can be unloaded.
- **Multi-platform**: WeeChat runs on GNU/Linux, *BSD, GNU/Hurd, Haiku, macOS and Windows (Bash/Ubuntu and Cygwin).
- **Multi-protocols**: WeeChat is designed to support multiple protocols by plugins, like IRC.
- **Standards-compliant**: the IRC plugin is compliant with RFCs [1459](https://datatracker.ietf.org/doc/html/rfc1459), [2810](https://datatracker.ietf.org/doc/html/rfc2810), [2811](https://datatracker.ietf.org/doc/html/rfc2811), [2812](https://datatracker.ietf.org/doc/html/rfc2812), [2813](https://datatracker.ietf.org/doc/html/rfc2813) and [7194](https://datatracker.ietf.org/doc/html/rfc7194).
- **Small, fast, and very light**: the core is and should stay as light and fast as possible.
- **Customizable and extensible**: there are a lot of options to customize WeeChat, and it is extensible with C plugins and [scripts](https://weechat.org/scripts/) ([Perl](https://weechat.org/scripts/language/perl/), [Python](https://weechat.org/scripts/language/python/), [Ruby](https://weechat.org/scripts/language/ruby), [Lua](https://weechat.org/scripts/language/lua/), [Tcl](https://weechat.org/scripts/language/tcl/), [Scheme](https://weechat.org/scripts/language/guile/), [JavaScript](https://weechat.org/scripts/language/javascript/) and [PHP](https://weechat.org/scripts/language/php/)).
- **Fully documented**: there is comprehensive [documentation](https://weechat.org/doc/weechat/), which is [translated](https://weechat.org/doc/weechat/dev/#translations) into several languages.
- **Developed from scratch**: WeeChat was built from scratch and is not based on any other client.
- **Free software**: WeeChat is released under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html).
<p align="center">
<img src="https://weechat.org/media/images/screenshots/weechat/medium/weechat_2013-04-27_phlux_shadow.png" alt="WeeChat" />
</p>
On WeeChat's website you can find [more screenshots](https://weechat.org/about/screenshots/).
## Installation
WeeChat can be installed using your favorite package manager (recommended) or by compiling it yourself.\
For detailed instructions, please check the [WeeChat user's guide](https://weechat.org/doc/weechat/user/#install).
## Semantic versioning
WeeChat is following a "practical" semantic versioning, see file [CONTRIBUTING.md](CONTRIBUTING.md#semantic-versioning).
## Copyright
Copyright © 2003-2024 [Sébastien Helleu](https://github.com/flashcode)
This file is part of WeeChat, the extensible chat client.
WeeChat is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
WeeChat is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
File diff suppressed because it is too large Load Diff
-53
View File
@@ -1,53 +0,0 @@
#
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
# WeeChat is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# WeeChat is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
#
# - Find Gcrypt
# This module finds if libgcrypt is installed and determines where
# the include files and libraries are.
#
# This code sets the following variables:
#
# GCRYPT_CFLAGS = cflags to use to compile
# GCRYPT_LDFLAGS = ldflags to use to compile
#
find_program(LIBGCRYPT_CONFIG_EXECUTABLE NAMES libgcrypt-config)
set(GCRYPT_LDFLAGS)
set(GCRYPT_CFLAGS)
if(LIBGCRYPT_CONFIG_EXECUTABLE)
execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --libs RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_LDFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
execute_process(COMMAND ${LIBGCRYPT_CONFIG_EXECUTABLE} --cflags RESULT_VARIABLE _return_VALUE OUTPUT_VARIABLE GCRYPT_CFLAGS OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET)
if(NOT DEFINED ${GCRYPT_CFLAGS})
set(GCRYPT_CFLAGS " ")
endif()
endif()
# handle the QUIETLY and REQUIRED arguments and set GCRYPT_FOUND to TRUE if
# all listed variables are TRUE
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(GCRYPT REQUIRED_VARS GCRYPT_LDFLAGS GCRYPT_CFLAGS)
if(GCRYPT_FOUND)
mark_as_advanced(GCRYPT_CFLAGS GCRYPT_LDFLAGS)
endif()
+1 -1
View File
@@ -35,5 +35,5 @@ endif()
find_package(PkgConfig)
if(PKG_CONFIG_FOUND)
pkg_search_module(LUA lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50 lua)
pkg_search_module(LUA lua lua5.4 lua-5.4 lua54 lua5.3 lua-5.3 lua53 lua5.2 lua-5.2 lua52 lua5.1 lua-5.1 lua51 lua-5.0 lua5.0 lua50)
endif()
-45
View File
@@ -1,45 +0,0 @@
#
# Copyright (C) 2003-2024 Sébastien Helleu <flashcode@flashtux.org>
#
# This file is part of WeeChat, the extensible chat client.
#
# WeeChat is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# WeeChat is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with WeeChat. If not, see <https://www.gnu.org/licenses/>.
#
# - Find Ruby
# This module finds if Ruby is installed and determines where the include files
# and libraries are. It also determines what the name of the library is. This
# code sets the following variables:
#
# RUBY_INCLUDE_DIRS = C flags to compile with ruby
# RUBY_LIBRARY_DIRS = linker flags to compile with ruby (found with pkg-config)
# RUBY_LIB = ruby library (found without pkg-config)
if(RUBY_FOUND)
# Already in cache, be silent
set(RUBY_FIND_QUIETLY TRUE)
endif()
find_package(PkgConfig)
if(PKG_CONFIG_FOUND)
if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
# set specific search path for macOS
set(ENV{PKG_CONFIG_PATH} "$ENV{PKG_CONFIG_PATH}:/usr/local/opt/ruby/lib/pkgconfig")
endif()
pkg_search_module(RUBY ruby-3.3 ruby-3.2 ruby-3.1 ruby-3.0 ruby-2.7 ruby-2.6 ruby-2.5 ruby-2.4 ruby-2.3 ruby-2.2 ruby-2.1 ruby-2.0 ruby-1.9 ruby)
if(RUBY_FOUND AND ${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
# FIXME: weird hack: hardcoding the Ruby lib location on macOS
set(RUBY_LDFLAGS "${RUBY_LDFLAGS} -L/usr/local/opt/ruby/lib")
endif()
endif()
+40
View File
@@ -1,3 +1,39 @@
#cmakedefine01 ENABLE_NCURSES
#cmakedefine01 ENABLE_HEADLESS
#cmakedefine01 ENABLE_NLS
#cmakedefine01 ENABLE_LARGEFILE
#cmakedefine01 ENABLE_ZSTD
#cmakedefine01 ENABLE_CJSON
#cmakedefine01 ENABLE_ALIAS
#cmakedefine01 ENABLE_BUFLIST
#cmakedefine01 ENABLE_CHARSET
#cmakedefine01 ENABLE_EXEC
#cmakedefine01 ENABLE_FIFO
#cmakedefine01 ENABLE_FSET
#cmakedefine01 ENABLE_IRC
#cmakedefine01 ENABLE_LOGGER
#cmakedefine01 ENABLE_RELAY
#cmakedefine01 ENABLE_SCRIPT
#cmakedefine01 ENABLE_SCRIPTS
#cmakedefine01 ENABLE_PERL
#cmakedefine01 ENABLE_PYTHON
#cmakedefine01 ENABLE_RUBY
#cmakedefine01 ENABLE_LUA
#cmakedefine01 ENABLE_TCL
#cmakedefine01 ENABLE_GUILE
#cmakedefine01 ENABLE_JAVASCRIPT
#cmakedefine01 ENABLE_PHP
#cmakedefine01 ENABLE_SPELL
#cmakedefine01 ENABLE_ENCHANT
#cmakedefine01 ENABLE_TRIGGER
#cmakedefine01 ENABLE_TYPING
#cmakedefine01 ENABLE_XFER
#cmakedefine01 ENABLE_MAN
#cmakedefine01 ENABLE_DOC
#cmakedefine01 ENABLE_DOC_INCOMPLETE
#cmakedefine01 ENABLE_TESTS
#cmakedefine01 ENABLE_CODE_COVERAGE
#cmakedefine HAVE_SYS_RESOURCE_H
#cmakedefine HAVE_FLOCK
#cmakedefine HAVE_LANGINFO_CODESET
@@ -11,6 +47,10 @@
#cmakedefine HAVE_ASPELL_VERSION_STRING
#cmakedefine HAVE_ENCHANT_GET_VERSION
#cmakedefine HAVE_GUILE_GMP_MEMORY_FUNCTIONS
#define CMAKE_BUILD_TYPE "@CMAKE_BUILD_TYPE@"
#define CMAKE_INSTALL_PREFIX "@CMAKE_INSTALL_PREFIX@"
#define PACKAGE_VERSION "@VERSION@"
#define PACKAGE "@PROJECT_NAME@"
#define PACKAGE_NAME "@PROJECT_NAME@"
+3 -2
View File
@@ -6,7 +6,8 @@ Build-Depends:
asciidoctor (>= 1.5.4),
ruby-pygments.rb,
debhelper (>= 12),
cmake, pkg-config,
cmake,
pkgconf,
libncurses-dev,
gem2deb,
libperl-dev,
@@ -23,7 +24,7 @@ Build-Depends:
libzstd-dev,
zlib1g-dev,
libcjson-dev
Standards-Version: 4.6.2
Standards-Version: 4.7.0
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
-3
View File
@@ -16,8 +16,5 @@ override_dh_auto_configure:
-DCMAKE_SKIP_RPATH:BOOL=ON \
-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
override_dh_installchangelogs:
dh_installchangelogs ChangeLog.adoc
%:
dh $@ --builddirectory=$(BUILDDIR)
@@ -0,0 +1,10 @@
Document: weechat-dev-sr
Title: WeeChat developer's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_dev.sr.html
@@ -0,0 +1,10 @@
Document: weechat-faq-sr
Title: WeeChat FAQ (Serbian)
Author: Sébastien Helleu
Abstract: This document answers frequently asked questions
about the WeeChat IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_faq.sr.html
@@ -0,0 +1,10 @@
Document: weechat-plugin-sr
Title: WeeChat plugin API reference (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_plugin_api.sr.html
@@ -0,0 +1,9 @@
Document: weechat-quickstart-cs
Title: WeeChat quick start guide (Czech)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Czech version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.cs.html
@@ -0,0 +1,9 @@
Document: weechat-quickstart-sr
Title: WeeChat quick start guide (Serbian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_quickstart.sr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-api-en
Title: WeeChat Relay "api" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-api-fr
Title: WeeChat Relay "api" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-en
Title: WeeChat Relay protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-fr
Title: WeeChat Relay protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.fr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-ja
Title: WeeChat Relay protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_protocol.ja.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-en
Title: WeeChat Relay "weechat" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-fr
Title: WeeChat Relay "weechat" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.fr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-ja
Title: WeeChat Relay "weechat" protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.ja.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-sr
Title: WeeChat Relay "weechat" protocol (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_weechat.sr.html
@@ -0,0 +1,10 @@
Document: weechat-scripting-sr
Title: WeeChat scripting guide (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_scripting.sr.html
@@ -0,0 +1,10 @@
Document: weechat-user-sr
Title: WeeChat user's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_user.sr.html
+34
View File
@@ -1,3 +1,37 @@
weechat (4.4.3-1) unstable; urgency=medium
* New upstream release
* Remove (fixed upstream) the fix for a possible privacy breach with html
documentation which includes stylesheets and fonts (font-awesome) hosted
on remote CDN (Cloudflare).
-- Emmanuel Bouthenot <kolter@debian.org> Wed, 06 Nov 2024 21:27:08 +0000
weechat (4.4.2-1) unstable; urgency=medium
* New upstream release
- fix crash where exiting (Closes: #1076532)
- fix a minor security issue (Closes: #1081942)
* Bump Standards-Version to 4.7.0
-- Emmanuel Bouthenot <kolter@debian.org> Sun, 22 Sep 2024 13:08:28 +0000
weechat (4.3.1-1) unstable; urgency=medium
* New upstream release (Closes: #1067608)
- fix FTBFS against libgcrypt 1.11 (Closes: #1071960)
* Add build dependency on libcjson-dev
* Replace pkg-config build dependency by pkgconf
* Minor updates in debian/copyright
-- Emmanuel Bouthenot <kolter@debian.org> Sat, 01 Jun 2024 14:21:02 +0000
weechat (4.1.1-1) unstable; urgency=medium
* New upstream release (Closes: #1055278)
-- Emmanuel Bouthenot <kolter@debian.org> Fri, 03 Nov 2023 20:23:37 +0000
weechat (4.0.5-1) unstable; urgency=medium
* New upstream release
+3 -2
View File
@@ -6,7 +6,8 @@ Build-Depends:
asciidoctor (>= 1.5.4),
ruby-pygments.rb,
debhelper (>= 12),
cmake, pkg-config,
cmake,
pkgconf,
libncurses-dev,
gem2deb,
libperl-dev,
@@ -23,7 +24,7 @@ Build-Depends:
libzstd-dev,
zlib1g-dev,
libcjson-dev
Standards-Version: 4.6.2
Standards-Version: 4.7.0
Homepage: https://weechat.org/
Vcs-Git: https://salsa.debian.org/kolter/weechat.git
Vcs-Browser: https://salsa.debian.org/kolter/weechat
-3
View File
@@ -16,8 +16,5 @@ override_dh_auto_configure:
-DCMAKE_SKIP_RPATH:BOOL=ON \
-DCMAKE_VERBOSE_MAKEFILE:BOOL=ON
override_dh_installchangelogs:
dh_installchangelogs ChangeLog.adoc
%:
dh $@ --builddirectory=$(BUILDDIR)
+5 -4
View File
@@ -1,4 +1,5 @@
AUTHORS.adoc
Contributing.adoc
README.adoc
ReleaseNotes.adoc
AUTHORS.md
CHANGELOG.md
CONTRIBUTING.md
README.md
UPGRADING.md
+1
View File
@@ -7,3 +7,4 @@ usr/share/man/it/man1/weechat.1.gz usr/share/man/it/man1/weechat-curses.1.gz
usr/share/man/ja/man1/weechat.1.gz usr/share/man/ja/man1/weechat-curses.1.gz
usr/share/man/pl/man1/weechat.1.gz usr/share/man/pl/man1/weechat-curses.1.gz
usr/share/man/ru/man1/weechat.1.gz usr/share/man/ru/man1/weechat-curses.1.gz
usr/share/man/sr/man1/weechat.1.gz usr/share/man/sr/man1/weechat-curses.1.gz
@@ -0,0 +1,10 @@
Document: weechat-relay-api-en
Title: WeeChat Relay "api" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-api-fr
Title: WeeChat Relay "api" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "api" protocol, used by
remote GUI or WeeChat to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
Files: /usr/share/doc/weechat-devel-doc/html/weechat_relay_api.fr.html
+10
View File
@@ -0,0 +1,10 @@
Document: weechat-dev-sr
Title: WeeChat developer's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_dev.sr.html
+10
View File
@@ -0,0 +1,10 @@
Document: weechat-faq-sr
Title: WeeChat FAQ (Serbian)
Author: Sébastien Helleu
Abstract: This document answers frequently asked questions
about the WeeChat IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_faq.sr.html
@@ -0,0 +1,10 @@
Document: weechat-plugin-sr
Title: WeeChat plugin API reference (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_plugin_api.sr.html
@@ -0,0 +1,9 @@
Document: weechat-quickstart-cs
Title: WeeChat quick start guide (Czech)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Czech version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html
Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.cs.html
@@ -0,0 +1,9 @@
Document: weechat-quickstart-sr
Title: WeeChat quick start guide (Serbian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_quickstart.sr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-en
Title: WeeChat Relay protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.en.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-fr
Title: WeeChat Relay protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.fr.html
@@ -1,10 +0,0 @@
Document: weechat-relay-protocol-ja
Title: WeeChat Relay protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay Protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_protocol.ja.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-en
Title: WeeChat Relay "weechat" protocol (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (English version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.en.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-fr
Title: WeeChat Relay "weechat" protocol (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.fr.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-ja
Title: WeeChat Relay "weechat" protocol (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Japanese version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.ja.html
@@ -0,0 +1,10 @@
Document: weechat-relay-weechat-sr
Title: WeeChat Relay "weechat" protocol (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat Relay "weechat" protocol, used by
remote GUI to communicate with Relay plugin (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_relay_weechat.sr.html
@@ -0,0 +1,10 @@
Document: weechat-scripting-sr
Title: WeeChat scripting guide (Serbian)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_scripting.sr.html
@@ -0,0 +1,10 @@
Document: weechat-user-sr
Title: WeeChat user's guide (Serbian)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Serbian version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_user.sr.html
Files: /usr/share/doc/weechat-doc/html/weechat_user.sr.html
+45 -60
View File
@@ -28,7 +28,8 @@ if(ENABLE_MAN OR ENABLE_DOC)
set(SCRIPTING_LANG de en fr it ja pl sr)
set(FAQ_LANG de en es fr it ja pl sr)
set(QUICKSTART_LANG cs de en es fr it ja pl ru sr)
set(RELAY_LANG en fr ja sr)
set(RELAY_API_LANG en fr)
set(RELAY_WEECHAT_LANG en fr ja sr)
set(DEV_LANG en fr ja sr)
find_package(Asciidoctor)
@@ -39,7 +40,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a reproducible
-a "prewrap!"
-a "webfonts!"
-a icons=font
-a revnumber="${VERSION}"
-a sectanchors
-a source-highlighter=pygments
@@ -93,8 +93,17 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a docinfo1
)
# asciidoctor arguments for relay protocol
set(ASCIIDOCTOR_RELAY_ARGS
# asciidoctor arguments for relay "api"
set(ASCIIDOCTOR_RELAY_API_ARGS
-a toc=left
-a toclevels=3
-a sectnums
-a sectnumlevels=2
-a docinfo1
)
# asciidoctor arguments for relay "weechat"
set(ASCIIDOCTOR_RELAY_WEECHAT_ARGS
-a toc=left
-a toclevels=3
-a sectnums
@@ -111,54 +120,6 @@ if(ENABLE_MAN OR ENABLE_DOC)
-a docinfo1
)
# sed arguments used to replace links in ChangeLog and release notes
set(SED_LINKS_ARGS
-e "'s/issue #\\([0-9][0-9]*\\)/https:\\/\\/github.com\\/weechat\\/weechat\\/issues\\/\\1[issue #\\1^]/g'"
-e "'s/bug #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/bugs\\/?\\1[bug #\\1^]/g'"
-e "'s/task #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/task\\/?\\1[task #\\1^]/g'"
-e "'s/patch #\\([0-9][0-9]*\\)/https:\\/\\/savannah.nongnu.org\\/patch\\/?\\1[patch #\\1^]/g'"
-e "'s/debian #\\([0-9][0-9]*\\)/http:\\/\\/bugs.debian.org\\/cgi-bin\\/bugreport.cgi?bug=\\1[debian bug #\\1^]/g'"
-e "'s/\\(CVE-[0-9][0-9]*-[0-9][0-9]*\\)/https:\\/\\/cve.mitre.org\\/cgi-bin\\/cvename.cgi?name=\\1[\\1^]/g'"
)
# ChangeLog
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/../ChangeLog.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
)
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ChangeLog.html "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_BINARY_DIR}/ChangeLog-links.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building ChangeLog.html"
)
add_custom_target(changelog DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ChangeLog.html")
# Release notes
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
COMMAND sed ARGS ${SED_LINKS_ARGS} "${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc" > "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/../ReleaseNotes.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
)
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} -o ReleaseNotes.html "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes-links.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building ReleaseNotes.html"
)
add_custom_target(rn DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/ReleaseNotes.html")
if(ENABLE_DOC)
set(AUTOGEN_FILES "")
foreach(lang ${AUTOGEN_LANG})
@@ -243,6 +204,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_user.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/cmdline_options.${lang}.adoc"
doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_user_commands.${lang}.adoc"
@@ -263,6 +225,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_plugin_api.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_completions.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_api_config_priority.${lang}.adoc"
@@ -286,6 +249,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_scripting.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
doc-autogen
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_functions.${lang}.adoc"
"${CMAKE_CURRENT_BINARY_DIR}/autogen/autogen_scripting_constants.${lang}.adoc"
@@ -303,6 +267,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_faq.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_faq.${lang}.html"
)
@@ -317,25 +282,44 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_quickstart.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_quickstart.${lang}.html"
)
add_custom_target(doc-quickstart-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_quickstart.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach()
# relay protocol
foreach(lang ${RELAY_LANG})
# relay "api"
foreach(lang ${RELAY_API_LANG})
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_ARGS} -o "weechat_relay_protocol.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_API_ARGS} -o "weechat_relay_api.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_protocol.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_api.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_relay_protocol.${lang}.html"
COMMENT "Building weechat_relay_api.${lang}.html"
)
add_custom_target(doc-relay-protocol-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
add_custom_target(doc-relay-api-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_api.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach()
# relay "weechat"
foreach(lang ${RELAY_WEECHAT_LANG})
add_custom_command(
OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html"
COMMAND "${ASCIIDOCTOR_EXECUTABLE}" ARGS ${ASCIIDOCTOR_ARGS} ${ASCIIDOCTOR_RELAY_WEECHAT_ARGS} -o "weechat_relay_weechat.${lang}.html" "${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_relay_weechat.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/relay.${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_relay_weechat.${lang}.html"
)
add_custom_target(doc-relay-weechat-${lang} ALL DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html")
install(FILES "${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_weechat.${lang}.html" DESTINATION "${DATAROOTDIR}/doc/${PROJECT_NAME}")
endforeach()
# developer's guide
foreach(lang ${DEV_LANG})
@@ -345,6 +329,7 @@ if(ENABLE_MAN OR ENABLE_DOC)
DEPENDS
"${CMAKE_CURRENT_SOURCE_DIR}/docinfo.html"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/weechat_dev.${lang}.adoc"
"${CMAKE_CURRENT_SOURCE_DIR}/${lang}/includes/attributes-${lang}.adoc"
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
COMMENT "Building weechat_dev.${lang}.html"
)
+23
View File
@@ -0,0 +1,23 @@
// czech translation, for reference only; matches the built-in behavior of core
:appendix-caption: Příloha
:appendix-refsig: {appendix-caption}
:caution-caption: Upozornění
:chapter-signifier: Kapitola
:chapter-refsig: {chapter-signifier}
:example-caption: Příklad
:figure-caption: Obrázek
:important-caption: Důležité
:last-update-label: Změněno
ifdef::listing-caption[:listing-caption: Seznam]
ifdef::manname-title[:manname-title: Název]
:note-caption: Poznámka
:part-signifier: Část
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Úvod]
:section-refsig: Oddíl
:table-caption: Tabulka
:tip-caption: Tip
:toc-title: Obsah
:untitled-label: Nepojmenovaný
:version-label: Verze
:warning-caption: Varování
+4
View File
@@ -39,6 +39,10 @@
*-h*, *--help*::
Zobrazí nápovědu.
// TRANSLATION MISSING
*-i*, *--build-info*::
Display build information and exit.
*-l*, *--license*::
Zobrazí licenci WeeChatu.
+1 -1
View File
@@ -97,7 +97,7 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[]
WeeChat je napsán Sébastienem Helleu a přispěvovateli (kompletní seznam je v
souboru AUTHORS.adoc).
souboru AUTHORS.md).
Copyright (C) 2003-2024 {author}
+3 -1
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: cs
include::includes/attributes-cs.adoc[]
[[start]]
== Spuštění WeeChatu
@@ -12,8 +13,9 @@ klávesových zkratek.
Spustění z Vašeho shellu:
[source,shell]
----
$ weechat
weechat
----
[[help]]
+23
View File
@@ -0,0 +1,23 @@
// German translation, courtesy of Florian Wilhelm
:appendix-caption: Anhang
:appendix-refsig: {appendix-caption}
:caution-caption: Achtung
:chapter-signifier: Kapitel
:chapter-refsig: {chapter-signifier}
:example-caption: Beispiel
:figure-caption: Abbildung
:important-caption: Wichtig
:last-update-label: Zuletzt aktualisiert
ifdef::listing-caption[:listing-caption: Listing]
ifdef::manname-title[:manname-title: Bezeichnung]
:note-caption: Anmerkung
:part-signifier: Teil
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Vorwort]
:section-refsig: Abschnitt
:table-caption: Tabelle
:tip-caption: Hinweis
:toc-title: Inhaltsverzeichnis
:untitled-label: Ohne Titel
:version-label: Version
:warning-caption: Warnung
+3
View File
@@ -35,6 +35,9 @@
*-h*, *--help*::
zeigt einen Hilfstext an.
*-i*, *--build-info*::
Build-Informationen anzeigen und beenden.
*-l*, *--license*::
zeigt die Lizenz von WeeChat an.
+1 -1
View File
@@ -98,7 +98,7 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[]
WeeChat wird programmiert von Sébastien Helleu und weiteren Beteiligten (eine vollständige Auflistung
findet man in der AUTHORS.adoc Datei).
findet man in der AUTHORS.md Datei).
Copyright (C) 2003-2024 {author}
+26 -7
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: de
:toc-title: Inhaltsverzeichnis
include::includes/attributes-de.adoc[]
Übersetzer:
@@ -54,12 +54,14 @@ Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.
Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird.
Hilfe erhält man mittels:
[source,shell]
----
brew info weechat
----
WeeChat kann durch folgenden Befehl installiert werden:
[source,shell]
----
brew install weechat
----
@@ -331,11 +333,16 @@ unterstützt (rxvt-unicode, konsole, gnome-terminal, ... um nur einige zu nennen
Im Normalfall erfolgt die Markierung des Textes mittels der Tasten kbd:[Ctrl+Alt]
in Verbindung mit der Auswahl durch die Maus.
// TRANSLATION MISSING
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Eine weitere Möglichkeit besteht darin,
die Benutzerliste am oberen oder unteren Rand des WeeChat-Bildschirmes zu positionieren:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
[[urls]]
@@ -345,10 +352,14 @@ Dazu kann man den vereinfachten Anzeigemodus nutzen (Standardtaste: kbd:[Alt+l]
Um URLs einfacher zu öffnen, können alternativ folgende Optionen gesetzt werden:
// TRANSLATION MISSING
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
* Die Benutzerliste am oberen Bildschirmbereich positionieren.
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
* Die Ausrichtung bei einem Zeilenumbruch innerhalb eines Wortes deaktivieren.
@@ -399,6 +410,7 @@ Umgebungsvariable `TZ` muss auf einen entsprechenden Wert eingestellt werden.
Am Besten machen Sie dies in Ihrer Shell-Initialisierungsdatei oder in der
Befehlszeile, bevor Sie WeeChat starten:
[source,shell]
----
export TZ=Europe/Berlin
----
@@ -713,8 +725,9 @@ Entsprechend der ausgegebenen Information, wird ggf. eine Maus nicht unterstütz
Um zu testen ob eine Mausunterstützung vom Terminal bereitgestellt wird, sollte
man folgende Zeile im Terminal eingeben:
[source,shell]
----
$ printf '\033[?1002h'
printf '\033[?1002h'
----
Jetzt klickt man mit der Maus auf das erste Zeichen im Terminal (linke obere
@@ -722,8 +735,9 @@ Ecke). Als Ergebnis sollte man folgende Zeichenkette erhalten: " !!#!!".
Um die Mausunterstützung im Terminal zu beenden:
[source,shell]
----
$ printf '\033[?1002l'
printf '\033[?1002l'
----
[[mouse_coords]]
@@ -790,7 +804,7 @@ Man sollte versuchen, eine andere Priorität zu nutzen; Im folgenden Beispiel
muss "xxx" durch den betroffenen Servernamen ersetzt werden:
----
/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
----
[[irc_tls_libera]]
@@ -1067,8 +1081,9 @@ Als erstes sollte das Kapitel über TLS Verbindungen in dieser FAQ gelesen werde
Wenn das nicht hilft, sollte die Skriptliste von Hand gelöscht werden. Dazu
folgenden Befehl in der Shell ausführen:
[source,shell]
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
@@ -1092,15 +1107,17 @@ Das bedeutet aber auch, dass die Skripten von Hand aktuell gehalten werden müss
* und in der Shell, mit installiertem curl:
[source,shell]
----
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz
----
Wenn Sie macOS ausführen und die heruntergeladene Datei eine Größe von 0 Byte hat,
versuchen Sie, diese Variable in Ihrer Shell-Initialisierungsdatei oder auf der
Befehlszeile zu setzen. Bevor Sie WeeChat starten:
[source,shell]
----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
----
@@ -1272,6 +1289,7 @@ siehe https://weechat.org/about/support/[this page ^↗^^].
Falls man WeeChat in gdb ausführt, kann folgende Fehlermeldung erscheinen:
[source,shell]
----
$ gdb /Pfad/zu/weechat
(gdb) run
@@ -1282,6 +1300,7 @@ Cannot find new threads: generic error
Um diesen Fehler zu beheben, sollte man gdb wie folgt aufrufen (der Pfad zu
libpthread und WeeChat muss natürlich an das eigene System angepasst werden):
[source,shell]
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /Pfad/zu/weechat
(gdb) run
+3 -2
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: de
:toc-title: Inhaltsverzeichnis
include::includes/attributes-de.adoc[]
Übersetzer:
@@ -19,8 +19,9 @@ keine Probleme mit der Standard Tastaturbelegung.
Programmstart aus deiner Shell:
[source,shell]
----
$ weechat
weechat
----
[[help]]
+5 -4
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: de
:toc-title: Inhaltsverzeichnis
include::includes/attributes-de.adoc[]
Übersetzer:
@@ -73,7 +73,7 @@ und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_
WeeChat definiert ein `weechat` Module welches mittels `import weechat`
importiert werden muss. +
Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Funktionen
@@ -373,9 +373,10 @@ anlegen, der in das Verzeichnis _Skriptsprache/autoload_ zeigt.
Ein Beispiel für ein Python-Skript:
[source,shell]
----
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
cd ~/.local/share/weechat/python/autoload
ln -s ../script.py
----
[NOTE]
+89 -60
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: de
:toc-title: Inhaltsverzeichnis
include::includes/attributes-de.adoc[]
Übersetzer:
@@ -115,7 +115,7 @@ Die folgende Tabelle zeigt eine Auflistung der Pakete, die zum Erstellen von Wee
| cmake | ≥ 3.0
| bauen.
| pkg-config |
| pkgconf / pkg-config |
| entdeckt installierte Bibliotheken.
| libncurses-dev |
@@ -227,8 +227,9 @@ Falls eine Debian/Ubuntu basierte Distribution genutzt wird und man einen
es mit folgendem Befehl möglich alle notwendigen Abhängigkeiten zu
installieren:
[source,shell]
----
# apt-get build-dep weechat
sudo apt-get build-dep weechat
----
[[build]]
@@ -236,22 +237,24 @@ installieren:
* Installation in das Systemverzeichnis (benötigt _root_ Privilegien):
[source,shell]
----
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install
mkdir build
cd build
cmake ..
make
sudo make install
----
* Installation in ein benutzerdefiniertes Verzeichnis (zum Beispiel ins Heimatverzeichnis):
[source,shell]
----
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
$ make
$ make install
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/Pfad/zum/Verzeichnis
make
make install
----
Optionen für CMake können mit dem Format, `-DOPTION=VALUE`, genutzt werden.
@@ -387,14 +390,16 @@ Liste der verfügbaren Optionen:
Weitere Optionen können mit folgendem Befehl angezeigt werden:
[source,shell]
----
$ cmake -LA
cmake -LA
----
oder mittels der Curses-Oberfläche:
[source,shell]
----
$ ccmake ..
ccmake ..
----
[[tests]]
@@ -407,14 +412,16 @@ Folgende Pakete werden *benötigt* um Tests zu kompilieren:
Tests muss aktiviert werden wenn WeeChat kompiliert wird:
[source,shell]
----
$ cmake .. -DENABLE_TESTS=ON
cmake .. -DENABLE_TESTS=ON
----
Nach der Kompilierung wird die Testumgebung im build-Verzeichnis ausgeführt:
[source,shell]
----
$ ctest -V
ctest -V
----
[[git_sources]]
@@ -425,8 +432,9 @@ sich die Quellen nicht kompilieren oder der Code ist nicht stabil. Sie sind hier
Um die Git Quellen zu beziehen nutzen Sie folgende Befehle:
[source,shell]
----
$ git clone https://github.com/weechat/weechat.git
git clone https://github.com/weechat/weechat.git
----
Folgen Sie bitte der Anleitung zur Erstellung aus Quellpaketen (siehe <<source_package,Quellpakete>>).
@@ -447,8 +455,9 @@ Falls WeeChat abgestürzt sein sollte und Sie diesen Fehler melden möchten:
Bei der Kompilierung mit CMake muss folgende Option gesetzt werden:
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake .. -DCMAKE_BUILD_TYPE=Debug
----
[[address_sanitizer]]
@@ -457,8 +466,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Sie können zusätzlich den Adress-Sanitizer aktivieren, der bei Problemen sofort
zum Absturz von WeeChat führt:
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
@@ -467,8 +477,9 @@ Absturz zu provozieren. Diese Funktion wird im produktiven Einsatz nicht empfohl
Nach dem Kompilieren und Installieren müssen Sie WeeChat folgendermaßen ausführen:
[source,shell]
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
Im Falle eines Absturzes befinden sich zusätzliche Informationen in der Datei, `asan.log`.
@@ -489,12 +500,14 @@ aktivieren, bevor WeeChat gestaret wird, wird der Befehl `ulimit` benötigt.
Zum Beispiel muss unter Linux in einer _bash_ Shell folgender Befehl in die `~/.bashrc`
Datei eingetragen werden:
[source,shell]
----
ulimit -c unlimited
----
optional kann noch die maximale Dateigröße bestimmt werden:
[source,shell]
----
ulimit -c 200000
----
@@ -518,6 +531,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich
in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen:
[source,shell]
----
gdb /usr/bin/weechat /home/user/core
----
@@ -565,6 +579,7 @@ Um eine laufende Sitzung von WeeChat zu debuggen (zum Beispiel wenn WeeChat nich
mehr reagieren sollte) sollte man gdb mit der Prozess-ID starten (_12345_ muss durch
die PID des laufenden weechat Prozesses ersetzt werden):
[source,shell]
----
gdb /usr/bin/weechat 12345
----
@@ -580,8 +595,9 @@ Sollte WeeChat abgestürzt sein, muss der Befehl `bt full` genutzt werden:
Um WeeChat zu starten muss folgender Befehl ausgeführt werden:
[source,shell]
----
$ weechat
weechat
----
Wird WeeChat das erste mal ausgeführt, wird die Standardkonfiguration und
@@ -799,25 +815,24 @@ Dies speichert den aktuellen Status in `*.upgrade`-Dateien. Sie können dann ent
die gesamten WeeChat-Verzeichnisse (Konfiguration, Daten, Cache) neu starten oder auf
einen anderen Computer verschieben und WeeChat später mit diesem Befehl neu starten:
[source,shell]
----
$ weechat --upgrade
weechat --upgrade
----
[[restart_after_upgrade]]
=== Neustart nach Upgrade
[[restart_release_notes]]
==== Versionshinweise
[[restart_upgrading_notes]]
==== Hinweise zum Upgrade
Nach einem Upgrade wird *dringend empfohlen* die,
https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^^]
zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob
eventuell ein manuelles Eingreifen erforderlich sein könnte.
Nach einem Upgrade, wird *dringend empfohlen* das Dokukment
https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
zu lesen. Dieses Dokument enthält wichtige Informationen zu wichtigen Änderungen und
einige manuelle Aktionen, die erforderlich sein könnten.
Sie müssen die Versionshinweise aller Versionen zwischen Ihrer alten (abgelaufenen)
und Ihrer neuen Version (enthalten) lesen. +
Wenn Sie beispielsweise von Version 3.0 auf 3.2 wechseln, müssen Sie die Versionshinweise
der Versionen 3.1 und 3.2 lesen.
Es sollten die Versionen zwischen der alten (abgelaufenen) und der neuen Version (eingeschlossen) gelesen werden. +
Wenn beispielsweise von Version 4.0.0 auf 4.3.0 gewechselt wurde, ist es ratsam die Versionen von 4.0.1 bis 4.3.0 zu lesen.
[[restart_configuration_upgrade]]
==== Konfigurations-Upgrade
@@ -1342,7 +1357,7 @@ Tags die häufig verwendet werden (keine vollständige Auflistung):
| no_filter | Zeile kann nicht gefiltert werden.
| no_highlight | die Zeile kann nicht gehiglighted werden.
| no_log | Zeile wird nicht in die Log-Datei geschrieben.
| log0 … log9 | Grad der Protokollierung (siehe `/help logger`).
| log0 … log9 | Grad der Protokollierung (siehe den Befehl <<command_logger_logger,/logger>>).
| notify_none | Diese Zeile wird erzeugt keinen Hotlist-Eintrag. ^(1)^
| notify_message | Diese Zeile ist eine User Nachricht. ^(1)^
| notify_private | Diese Zeile ist eine private Nachricht. ^(1)^
@@ -2849,8 +2864,9 @@ Option in die Sektion "option" der Aspell-Konfiguration hinzufügt.
Den Name der Option findet man in der ASpell-Konfigurationsdatei. Eine Auflistung aller
möglichen Optionen erhält man durch:
[source,shell]
----
$ aspell config
aspell config
----
Um zum Beispiel die Option "ignore-case" einzuschalten:
@@ -3302,7 +3318,7 @@ Passwörter beinhalten. Dies dient dazu Passwörter nicht im Klartext als
Wert einer Option zu sichern. Dazu wird folgendes Format, anstelle des
Passwortes, verwendet: "${sec.data.xxx}". "xxx" ist hierbei der Name den man
dem Passwort zugeordnet hat (siehe oben, mittels `/secure set xxx ...`). +
Für eine vollständige Liste aller unterstützten Optionen, siehe `/help secure`.
Für eine vollständige Liste der unterstützen Optionen, siehe den Befehl <<command_weechat_secure,/secure>>.
Um z.B. das oben eingestellte _libera_ Passwort für eine
<<irc_sasl_authentication,SASL Authentifizierung>> zu nutzen:
@@ -3425,8 +3441,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
Beispiel: Anmelden beim Server _irc.libera.chat_ mit dem Nick _alice_ und betreten
der Kanäle _#weechat_ und _#weechat-fr_ (Standardport (6667) wird genutzt):
[source,shell]
----
$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
----
[[irc_servers]]
@@ -3584,9 +3601,10 @@ die Verbindung mit einer vorherigen Version (<0.3.1) funktioniert hat.
* Importieren Sie die Zertifikate in einer Shell:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
mkdir -p ~/.config/weechat/tls
wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
----
[NOTE]
@@ -3607,10 +3625,11 @@ Es ist möglich mehrere Zertifikate in der Datei CAs.pem zu verwenden.
* Erstellen Sie ein Zertifikat in der Shell:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
----
[NOTE]
@@ -3659,8 +3678,9 @@ dadurch kein Passwort während des Verbindungsaufbaus benötigt).
Ein Schlüssel kann mit folgendem Befehl erzeugt werden:
[source,shell]
----
$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
----
[NOTE]
@@ -3670,8 +3690,9 @@ das auch beispielsweise `~/.weechat` sein kann.
Um den öffentlichen Schlüssel zu erhalten (base64 enkodiert) muss
folgender Befehl ausgeführt werden:
[source,shell]
----
$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
----
Nun Verbindung zum Server herstellen, identifizieren (z.B. mittels "nickserv identify")
@@ -3741,8 +3762,9 @@ Privatsphäre und Sicherheit im Internet verbessern können.
Im ersten Schritt muss Tor installiert werden. Für Debian (und Derivate):
[source,shell]
----
$ sudo apt-get install tor
sudo apt-get install tor
----
In WeeChat muss nun ein socks5-Proxy für den Tor Service erstellt werden (Hostname/IP
@@ -4166,7 +4188,7 @@ Schlüssel erfordert, aber nicht `#channel2`:
/set irc.server.libera.autojoin "#channel1,#channel2 key1"
----
Um eine Hilfe über das Format zu erhalten, siehe `/help irc.server.libera.autojoin`.
Hilfe zum Format findet man unter Option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
[[irc_private_messages]]
=== private Nachrichten
@@ -4215,7 +4237,7 @@ damit die Zeilen im Buffer unterdrückt werden. Zum Beispiel:
----
Dabei ist es möglich, einen Filter für nur einen Kanal oder für mehrere Kanäle zu erstellen, die mit
dem selben Namen beginnen (siehe `/help filter`):
dem selben Namen beginnen (siehe den Befehl <<command_weechat_filter,/filter>>):
----
/filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4671,10 +4693,11 @@ Der Standardpfad zum Zertifikat/Schlüssel wird durch die Option definiert
Ein Zertifikat und einen privaten Schlüssel kann man mit folgenden Befehlen
erstellen:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
----
[NOTE]
@@ -4778,10 +4801,10 @@ dieses Protokoll verbinden.
Zum Beispiel:
----
/relay add weechat 9000
/relay add weechat 9500
----
Nun kann man über den Port 9000 mittels einer Oberfläche und dem Passwort
Nun kann man über den Port 9500 mittels einer Oberfläche und dem Passwort
"meinPasswort" eine Verbindung zu WeeChat herstellen.
[[relay_websocket]]
@@ -4798,10 +4821,10 @@ Ein WebSocket kann in HTML5, mit einer JavaScript Zeile, geöffnet werden:
[source,javascript]
----
websocket = new WebSocket("ws://server.com:9000/weechat");
websocket = new WebSocket("ws://server.com:9500/weechat");
----
Der Port (im Beispiel: 9000) ist der Port der in der Relay Erweiterung angegeben wurde.
Der Port (im Beispiel: 9500) ist der Port der in der Relay Erweiterung angegeben wurde.
Die URI muss mit „/weechat“ für die Protokolle _irc_ und _weechat_ und mit „/api“
für das Protokoll _api_ enden.
@@ -4824,8 +4847,9 @@ andere Ports nicht geöffnet werden können.
OpenSSH nutzen:
[source,shell]
----
$ ssh -L 9000:.weechat/relay_socket user@hostname
ssh -L 9000:.weechat/relay_socket user@hostname
----
Dies leitet lokale relay Client Verbindungen von Port 9000 um, zu
@@ -4913,34 +4937,39 @@ einige Beispiele:
* Ändert den eigenen Nick auf dem IRC Server libera in "newnick":
[source,shell]
----
$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
----
* Schickt eine Nachrich in den IRC #weechat Channel:
[source,shell]
----
$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Sendet eine mehrzeilige Nachricht in den IRC Kanal #test, wenn die Fähigkeit "draft/multiline"
auf dem Ergo Server aktiviert ist:
[source,shell]
----
$ echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Schickt eine Nachricht in den aktuellen Buffer:
[source,shell]
----
$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Sendet zwei Befehle um alle Python-Skripten zu entfernen und dann neu zu laden (die beiden Befehle müssen
mit "\n" getrennt werden):
[source,shell]
----
$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
----
[[fifo_commands]]
+4
View File
@@ -198,6 +198,10 @@ mark {
/* syntax highlighting tuning */
pre.pygments {
color: #ddd !important;
}
pre.pygments .tok-cp {
color: #44cfaf;
}
+23
View File
@@ -0,0 +1,23 @@
// English translation, for reference only; matches the built-in behavior of core
:appendix-caption: Appendix
:appendix-refsig: {appendix-caption}
:caution-caption: Caution
:chapter-signifier: Chapter
:chapter-refsig: {chapter-signifier}
:example-caption: Example
:figure-caption: Figure
:important-caption: Important
:last-update-label: Last updated
ifdef::listing-caption[:listing-caption: Listing]
ifdef::manname-title[:manname-title: Name]
:note-caption: Note
:part-signifier: Part
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Preface]
:section-refsig: Section
:table-caption: Table
:tip-caption: Tip
:toc-title: Table of Contents
:untitled-label: Untitled
:version-label: Version
:warning-caption: Warning
+3
View File
@@ -35,6 +35,9 @@
*-h*, *--help*::
Display help.
*-i*, *--build-info*::
Display build information and exit.
*-l*, *--license*::
Display WeeChat license.
+1 -1
View File
@@ -98,7 +98,7 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[]
WeeChat is written by Sébastien Helleu and contributors (complete list is in
the AUTHORS.adoc file).
the AUTHORS.md file).
Copyright (C) 2003-2024 {author}
+18
View File
@@ -0,0 +1,18 @@
// tag::diagram[]
....
┌──────────┐ Workstation
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS, …)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Mobile device
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone, …)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Other devices
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
network servers ncurses interface relay remote interfaces
....
// end::diagram[]
+20 -13
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat.
@@ -502,6 +503,7 @@ WeeChat "core" is located in following directories:
|          relay/ | Root of unit tests for Relay plugin.
|             test-relay-auth.cpp | Tests: clients authentication.
|             test-relay-http.cpp | Tests: HTTP functions for Relay plugin.
|             test-relay-raw.cpp | Tests: raw messages functions for Relay plugin.
|             test-relay-remote.cpp | Tests: remote functions for Relay plugin.
|             test-relay-websocket.cpp | Tests: websocket functions for Relay plugin.
|             api/ | Root of unit tests for Relay "api" protocol.
@@ -531,7 +533,8 @@ Documentation files:
|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^^].
|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^].
|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces).
|       weechat_relay_api.XX.adoc | link:weechat_relay_api.en.html[Relay "api" protocol ^↗^^] (for remote interfaces).
|       weechat_relay_weechat.XX.adoc | link:weechat_relay_weechat.en.html[Relay "weechat" protocol ^↗^^] (for remote interfaces).
|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^^].
|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^^].
|       includes/ | Files included in documentation.
@@ -1170,7 +1173,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].
Any patch for bug or new feature must be done on master branch, preferred way
Any patch for bug or new feature must be done on branch `main`, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
(made with `git diff` or `git format-patch`).
@@ -1187,15 +1190,15 @@ Where _component_ is one of following:
| Component | Files | Description
| core
| AUTHORS.adoc +
ChangeLog.adoc +
Contributing.adoc +
| AUTHORS.md +
CHANGELOG.md +
CONTRIBUTING.md +
.github/FUNDING.yml +
.github/ISSUE_TEMPLATE/* +
icons/* +
po/* +
README.adoc +
ReleaseNotes.adoc +
README.md +
UPGRADING.md +
src/core/* +
src/gui/* +
version.sh +
@@ -1252,8 +1255,9 @@ Where _component_ is one of following:
| Plugin API reference
| doc/relay
| doc/xx/weechat_relay_protocol.xx.adoc
| Relay protocol
| doc/xx/weechat_relay_api.xx.adoc +
doc/xx/weechat_relay_weechat.xx.adoc
| Relay protocols
| doc/dev
| doc/xx/weechat_dev.en.adoc
@@ -1297,9 +1301,10 @@ Gettext files are in directory _po/_.
If you want to initialize a new language, use command `msginit`. For example to
create a file which is ready to translate to Dutch:
[source,shell]
----
$ cd po
$ msginit -i weechat.pot -l nl_NL -o nl.po
cd po
msginit -i weechat.pot -l nl_NL -o nl.po
----
Base language for WeeChat is English, so you must of course perfectly understand
@@ -1308,8 +1313,9 @@ English in order to translate to your language.
After changes in sources, you can regenerate all translations files: run this
command in the CMake "build" directory:
[source,shell]
----
$ make translations && make update-po
make translations && make update-po
----
Then you can edit .po files (if you can translate in a language).
@@ -1317,8 +1323,9 @@ Then you can edit .po files (if you can translate in a language).
When done, you *have* to check your file with
https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
[source,shell]
----
$ msgcheck.py xx.po
msgcheck.py xx.po
----
And then you can recompile WeeChat to use the new translations.
+24 -6
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
[[general]]
== General
@@ -48,12 +49,14 @@ If you still have issues, please report them to the developers.
It is recommended to use https://brew.sh/[Homebrew ^↗^^],
you can get help with:
[source,shell]
----
brew info weechat
----
You can install WeeChat with this command:
[source,shell]
----
brew install weechat
----
@@ -313,10 +316,14 @@ You can use a terminal with rectangular selection (like rxvt-unicode,
konsole, gnome-terminal, etc.). Key is usually kbd:[Ctrl] + kbd:[Alt] + mouse
selection.
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Another solution is to move nicklist to top or bottom, for example:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
[[urls]]
@@ -326,10 +333,13 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
To make opening URLs easier, you can:
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
* move nicklist to top:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
* disable alignment for multiline words:
@@ -379,6 +389,7 @@ There is no option in WeeChat to change the timezone, the environment variable
In your shell initialization file or on command line, before starting WeeChat:
[source,shell]
----
export TZ=America/New_York
----
@@ -682,16 +693,18 @@ According to terminfo used, mouse may not be supported.
You can test mouse support in terminal:
[source,shell]
----
$ printf '\033[?1002h'
printf '\033[?1002h'
----
And then click on first char of terminal (upper left). You should see " !!#!!".
To disable mouse in terminal:
[source,shell]
----
$ printf '\033[?1002l'
printf '\033[?1002l'
----
[[mouse_coords]]
@@ -746,7 +759,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
You can try a different priority string, replace "xxx" by your server name:
----
/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
----
[[irc_tls_libera]]
@@ -999,8 +1012,9 @@ First check questions about TLS connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell):
[source,shell]
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
@@ -1024,15 +1038,17 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
[source,shell]
----
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz
----
If you're running macOS and the downloaded file has a size of 0 bytes,
try to set this variable in your shell initialization file or on command line,
before starting WeeChat:
[source,shell]
----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
----
@@ -1202,6 +1218,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
When you run WeeChat under gdb, you may have this error:
[source,shell]
----
$ gdb /path/to/weechat
(gdb) run
@@ -1212,6 +1229,7 @@ Cannot find new threads: generic error
To fix that, you can run gdb with this command (replace path to libpthread and
WeeChat with paths on your system):
[source,shell]
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run
+109 -35
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat.
@@ -165,9 +166,10 @@ required.
To compile a plugin which has one file "toto.c" (under GNU/Linux):
[source,shell]
----
$ gcc -fPIC -Wall -c toto.c
$ gcc -shared -fPIC -o toto.so toto.o
gcc -fPIC -Wall -c toto.c
gcc -shared -fPIC -o toto.so toto.o
----
[[load_plugin]]
@@ -636,7 +638,7 @@ Arguments:
* _string_: string to cut
* _length_: max chars
* _count_suffix_: if 1, the length of suffix is counter in the max length
* _count_suffix_: if 1, the length of suffix is counted in the max length
* _screen_: if 1, the cut is based on width of chars displayed
* _cut_suffix_: the suffix added after the string if it is cut
@@ -2616,8 +2618,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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0._
_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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0, 4.4.0._
Evaluate an expression and return result as a string.
Special variables with format `+${variable}+` are expanded (see table below).
@@ -3332,6 +3333,12 @@ expanded to last):
| >> `+${define:len,${calc:5+3}}${len}x${len}+` +
== `+8x8+`
| `+${hdata_count:name[list]}+` +
`+${hdata_count:name[pointer]}+` | 4.4.0
| Number of items in a hdata list or starting at `pointer`.
| >> `+${hdata_count:buffer[gui_buffers]}+` +
== `+15+`
| `+${sec.data.name}+` |
| Value of the secured data `name`.
| >> `+${sec.data.libera_pass}+` +
@@ -5808,7 +5815,7 @@ Hashtable functions.
==== hashtable_new
_WeeChat ≥ 0.3.3._
_WeeChat ≥ 0.3.3, updated in 4.4.0._
Create a new hashtable.
@@ -5837,12 +5844,14 @@ Arguments:
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
* _type_values_: type for values in hashtable:
** _WEECHAT_HASHTABLE_INTEGER_
** _WEECHAT_HASHTABLE_STRING_
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
* _callback_hash_key_: callback used to "hash" a key (key as integer value), can
be NULL if key type is not "buffer" (a default hash function is used),
arguments and return value:
@@ -6203,12 +6212,14 @@ Arguments:
*** _pointer_: pointer
*** _buffer_: buffer
*** _time_: time
*** _longlong_: long long integer
** _type_values_: type for values:
*** _integer_: integer
*** _string_: string
*** _pointer_: pointer
*** _buffer_: buffer
*** _time_: time
*** _longlong_: long long integer
** _keys_: string with list of keys (format: "key1,key2,key3")
** _keys_sorted_: string with list of sorted keys (format: "key1,key2,key3")
** _values_: string with list of values (format: "value1,value2,value3")
@@ -11116,7 +11127,7 @@ hook2 = weechat.hook_url("http://localhost:8080/", options, 20000, "my_url_cb",
==== hook_connect
_Updated in 1.5, 2.0._
_Updated in 1.5, 2.0, 4.4.0._
Hook a connection (background connection to a remote host).
@@ -11151,7 +11162,10 @@ Arguments:
without proxy)
* _address_: name or IP address to connect to
* _port_: port number
* _ipv6_: 1 to use IPv6 (with fallback to IPv4), 0 to use only IPv4
* _ipv6_:
** `WEECHAT_HOOK_CONNECT_IPV6_DISABLE` ^(1)^: disable IPv6 (use only IPv4)
** `WEECHAT_HOOK_CONNECT_IPV6_AUTO` ^(1)^: use IPv6 with fallback to IPv4
** `WEECHAT_HOOK_CONNECT_IPV6_FORCE` ^(1)^: force IPv6 (do not use IPv4) _(WeeChat ≥ 4.4.0)_
* _retry_: retry count, used to fallback to IPv4 hosts if IPv6 hosts connect
but then fail to accept the client
* _gnutls_sess_: GnuTLS session (optional)
@@ -11171,7 +11185,7 @@ Arguments:
return value:
** _const void *pointer_: pointer
** _void *data_: pointer
** _int status_: connection status:
** _int status_: connection status ^(2)^:
*** _WEECHAT_HOOK_CONNECT_OK_: connection OK
*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_: address not found
*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_: IP address not found
@@ -11183,8 +11197,8 @@ Arguments:
*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_: insufficient memory
*** _WEECHAT_HOOK_CONNECT_TIMEOUT_: timeout
*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_: unable to create socket
** _gnutls_rc_: return value of _gnutls_handshake()_
** _sock_: socket used to connect
** _gnutls_rc_: return value of _gnutls_handshake()_ ^(2)^
** _sock_: socket used to connect ^(2)^
** _const char *error_: return value of _gnutls_strerror(gnutls_rc)_
** _const char *ip_address_: IP address found
** return value:
@@ -11195,16 +11209,19 @@ Arguments:
if not NULL, it must have been allocated with malloc (or similar function)
and it is automatically freed when the hook is deleted
Return value:
* pointer to new hook, NULL if error occurred
[IMPORTANT]
In scripts, with WeeChat ≥ 2.0, the callback arguments _status_, _gnutls_rc_
[NOTE]
^(1)^ Constants for parameter _ipv6_ are available since WeeChat 4.4.0. +
For older releases, allowed values are `1` (use IPv6 with fallback to IPv4) and
`0` (disable IPv6, use only IPv4). +
^(2)^ In scripts, with WeeChat ≥ 2.0, the callback arguments _status_, _gnutls_rc_
and _sock_ are integers (with WeeChat ≤ 1.9, they were strings). +
To be compatible with all versions, it is recommended to convert the argument
to integer before using it, for example in Python: `int(sock)`.
Return value:
* pointer to new hook, NULL if error occurred
C example:
[source,c]
@@ -11254,7 +11271,8 @@ my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc,
struct t_hook *my_connect_hook = weechat_hook_connect (NULL,
"my.server.org", 1234,
1, 0,
WEECHAT_HOOK_CONNECT_IPV6_AUTO,
0,
NULL, NULL, 0, /* GnuTLS */
NULL,
&my_connect_cb, NULL, NULL);
@@ -11270,31 +11288,32 @@ def hook_connect(proxy: str, address: str, port: int, ipv6: int, retry: int, loc
# example
def my_connect_cb(data: str, status: int, gnutls_rc: int, sock: int, error: str, ip_address: str) -> int:
if status == WEECHAT_HOOK_CONNECT_OK:
if status == weechat.WEECHAT_HOOK_CONNECT_OK:
# ...
elif status == WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
elif status == weechat.WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
# ...
elif status == WEECHAT_HOOK_CONNECT_PROXY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_PROXY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_TIMEOUT:
elif status == weechat.WEECHAT_HOOK_CONNECT_TIMEOUT:
# ...
elif status == WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
# ...
return weechat.WEECHAT_RC_OK
hook = weechat.hook_connect("", "my.server.org", 1234, 1, 0, "",
hook = weechat.hook_connect("", "my.server.org", 1234,
weechat.WEECHAT_HOOK_CONNECT_IPV6_AUTO, 0, "",
"my_connect_cb", "")
----
@@ -12106,6 +12125,10 @@ List of signals sent by WeeChat and plugins:
| Pointer: line.
| Line added in a buffer.
| weechat | [[hook_signal_buffer_line_data_changed]] buffer_line_data_changed | 4.4.0
| Pointer: line data.
| Line data has been updated in a buffer.
| weechat | [[hook_signal_buffer_lines_hidden]] buffer_lines_hidden |
| Pointer: buffer.
| Lines hidden in buffer.
@@ -12150,6 +12173,10 @@ List of signals sent by WeeChat and plugins:
| Pointer: buffer.
| Modes of buffer changed.
| weechat | [[hook_signal_buffer_time_for_each_line_changed]] buffer_time_for_each_line_changed | 4.4.0
| Pointer: buffer.
| Display time for each line changed.
| weechat | [[hook_signal_buffer_type_changed]] buffer_type_changed |
| Pointer: buffer.
| Type of buffer changed.
@@ -12260,6 +12287,14 @@ List of signals sent by WeeChat and plugins:
| String: key combo.
| Key combo in _cursor_ context.
| weechat | [[hook_signal_layout_buffers_applied]] layout_buffers_applied | 4.4.0
| String: layout name.
| Layout applied for buffers.
| weechat | [[hook_signal_layout_windows_applied]] layout_windows_applied | 4.4.0
| String: layout name.
| Layout applied for windows.
| weechat | [[hook_signal_mouse_enabled]] mouse_enabled | 1.1
| -
| Mouse enabled.
@@ -14608,7 +14643,6 @@ Arguments:
** _number_: number of buffer (starts to 1)
** _layout_number_: number of buffer saved in layout
** _layout_number_merge_order_: order in merge for layout
** _short_name_is_set_: 1 if short name is set, 0 if not set
** _type_: buffer type (0: formatted, 1: free content)
** _notify_: notify level for buffer
** _num_displayed_: number of windows displaying buffer
@@ -14780,7 +14814,7 @@ C example:
[source,c]
----
weechat_printf (NULL, "plugin pointer of my buffer: %lx",
weechat_printf (NULL, "plugin pointer of my buffer: %p",
weechat_buffer_get_pointer (my_buffer, "plugin"));
----
@@ -15192,6 +15226,46 @@ if buffer:
weechat.prnt("", "%d" % weechat.buffer_match_list(buffer, "irc.oftc.*,python.*")) # 0
----
[[buffer_lines]]
=== Buffer lines
Functions for buffer lines.
==== line_search_by_id
_WeeChat ≥ 4.4.0._
Search line in buffer by identifier.
Prototype:
[source,c]
----
struct t_gui_line *weechat_line_search_by_id (struct t_gui_buffer *buffer, int id);
----
Return value:
* pointer to line found, NULL if not found
C example:
[source,c]
----
struct t_gui_line *line = weechat_line_search_by_id (buffer, 123);
----
Script (Python):
[source,python]
----
# prototype
def line_search_by_id(buffer: str, line_id: int) -> str: ...
# example
line = weechat.line_search_by_id(buffer, 123)
----
[[windows]]
=== Windows
@@ -15256,7 +15330,7 @@ C example:
[source,c]
----
weechat_printf (NULL,
"window displaying core buffer: %lx",
"window displaying core buffer: %p",
weechat_window_search_with_buffer (weechat_buffer_search_main ()));
----
@@ -15393,7 +15467,7 @@ C example:
[source,c]
----
weechat_printf (NULL,
"buffer displayed in current window: %lx",
"buffer displayed in current window: %p",
weechat_window_get_pointer (weechat_current_window (), "buffer"));
----
@@ -19261,7 +19335,7 @@ C example:
----
struct t_hdata *hdata = weechat_hdata_get ("buffer");
struct t_gui_buffer *buffer = weechat_buffer_search_main ();
weechat_printf (NULL, "lines = %lx", weechat_hdata_pointer (hdata, buffer, "lines"));
weechat_printf (NULL, "lines = %p", weechat_hdata_pointer (hdata, buffer, "lines"));
----
Script (Python):
+3 -1
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
[[start]]
== Start WeeChat
@@ -11,8 +12,9 @@ It has good UTF-8 support and works well with WeeChat's default key bindings.
Run from your shell:
[source,shell]
----
$ weechat
weechat
----
[[help]]
File diff suppressed because it is too large Load Diff
@@ -2,11 +2,12 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
[[introduction]]
== Introduction
This document is the specification of WeeChat Relay protocol: the protocol used
This document is the specification of _weechat_ relay protocol: the protocol used
to relay WeeChat data to clients, which are mostly remote interfaces.
[[terminology]]
@@ -24,28 +25,11 @@ The following terms are used in this document:
The _clients_ are connected to _relay_ like shown in this diagram:
....
┌──────────┐ Workstation
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS ...)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Mobile device
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone ...)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Other devices
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
network servers ncurses interface relay remote interfaces
protocol
....
include::includes/relay.en.adoc[tag=diagram]
[NOTE]
All clients here are clients using _weechat_ protocol in _relay_ plugin. The
_relay_ plugin also allows IRC clients, then _relay_ plugin acts as an
_IRC proxy_ (not described in this document).
All clients here are clients using _weechat_ protocol in _relay_ plugin. +
The _relay_ plugin also allows _api_ and _irc_ protocols (not described in this document).
[[protocol_generalities]]
== Protocol generalities
@@ -1505,6 +1489,9 @@ WeeChat reserved identifiers:
| _buffer_line_added | buffer | hdata: line
| Line added in buffer. | Display line in buffer.
| _buffer_line_data_changed | buffer | hdata: line
| Line changed in buffer. | Update line displayed in buffer.
| _nicklist | nicklist | hdata: nicklist_item
| Nicklist for a buffer. | Replace nicklist.
@@ -2059,6 +2046,7 @@ Data sent as hdata:
|===
| Name | Type | Description
| buffer | pointer | Buffer pointer.
| id | integer | Line identifier.
| date | time | Date of message.
| date_usec | integer | Microseconds of date.
| date_printed | time | Date when WeeChat displayed message.
@@ -2079,6 +2067,7 @@ id: '_buffer_line_added'
hda:
keys: {
'buffer': 'ptr',
'id': 'int',
'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim',
@@ -2094,6 +2083,58 @@ hda:
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
id: 12
date: 1362728993
date_usec: 902765
date_printed: 1362728993
date_usec_printed: 902765
displayed: 1
notify_level: 1
highlight: 0
tags_array: [
'irc_privmsg',
'notify_message',
'prefix_nick_142',
'nick_FlashCode',
'log1',
]
prefix: 'F06@F@00142FlashCode'
message: 'hello!'
----
[[message_buffer_line_data_changed]]
==== _buffer_line_data_changed
This message is sent to the client when the signal "buffer_line_data_changed"
is sent by WeeChat.
Data sent as hdata: same data as <<message_buffer_line_added,_buffer_line_added>>.
Example: message _hello!_ from nick _FlashCode_ on buffer _irc.libera.#weechat_ has been updated:
[source,python]
----
id: '_buffer_line_data_changed'
hda:
keys: {
'buffer': 'ptr',
'id': 'int',
'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim',
'date_usec_printed': 'int',
'displayed': 'chr',
'notify_level': 'chr',
'highlight': 'chr',
'tags_array': 'arr',
'prefix': 'str',
'message': 'str',
}
path: ['line_data']
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
id: 12
date: 1362728993
date_usec: 902765
date_printed: 1362728993
+5 -3
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat.
@@ -67,7 +68,7 @@ link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Functions
@@ -362,9 +363,10 @@ WeeChat is starting.
For example with Python:
[source,shell]
----
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
cd ~/.local/share/weechat/python/autoload
ln -s ../script.py
----
[NOTE]
+89 -58
View File
@@ -2,6 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
include::includes/attributes-en.adoc[]
This manual documents WeeChat chat client, it is part of WeeChat.
@@ -110,7 +111,7 @@ WeeChat:
| cmake | ≥ 3.0
| Build.
| pkg-config |
| pkgconf / pkg-config |
| Detect installed libraries.
| libncurses-dev |
@@ -220,8 +221,9 @@ If you are using a Debian/Ubuntu based distribution, and if you have some
"deb-src" source entries in your file _/etc/apt/sources.list_, you can install
all dependencies with the command:
[source,shell]
----
# apt-get build-dep weechat
sudo apt-get build-dep weechat
----
[[build]]
@@ -229,22 +231,24 @@ all dependencies with the command:
* Installation in system directories (requires _root_ privileges):
[source,shell]
----
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install
mkdir build
cd build
cmake ..
make
sudo make install
----
* Installation in custom directory (for example your home):
[source,shell]
----
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
$ make
$ make install
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/directory
make
make install
----
Options can be used for CMake, with format: `-DOPTION=VALUE`.
@@ -380,14 +384,16 @@ List of available options:
The other options can be displayed with this command:
[source,shell]
----
$ cmake -LA
cmake -LA
----
Or with Curses interface:
[source,shell]
----
$ ccmake ..
ccmake ..
----
[[tests]]
@@ -400,14 +406,16 @@ Following packages are *required* to compile tests:
Tests must be enabled when compiling WeeChat:
[source,shell]
----
$ cmake .. -DENABLE_TESTS=ON
cmake .. -DENABLE_TESTS=ON
----
They can be launched after compilation from the build directory:
[source,shell]
----
$ ctest -V
ctest -V
----
[[git_sources]]
@@ -418,8 +426,9 @@ stable. You're warned!
To get Git sources, issue this command:
[source,shell]
----
$ git clone https://github.com/weechat/weechat.git
git clone https://github.com/weechat/weechat.git
----
Then follow instructions for source package (see
@@ -442,8 +451,9 @@ you have to:
If you're compiling with CMake:
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake .. -DCMAKE_BUILD_TYPE=Debug
----
[[address_sanitizer]]
@@ -452,8 +462,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
You can additionally enable the address sanitizer, which causes WeeChat to
crash immediately in case of problem:
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
@@ -462,8 +473,9 @@ this is not recommended in production.
Then once compiled and installed, you must run WeeChat like this:
[source,shell]
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
In case of crash, the backtrace is in file `asan.log`.
@@ -483,12 +495,14 @@ starts, you can use `ulimit` command.
For example under Linux with _bash_ shell, add this line to your `~/.bashrc`:
[source,shell]
----
ulimit -c unlimited
----
Or max size:
[source,shell]
----
ulimit -c 200000
----
@@ -510,6 +524,7 @@ https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
For example if _weechat_ is installed in _/usr/bin/_ and _core_ file is
in _/home/user/_, then run gdb with this command:
[source,shell]
----
gdb /usr/bin/weechat /home/user/core
----
@@ -557,6 +572,7 @@ Thank you for your help!
To debug a running WeeChat (for example if WeeChat seems blocked), you can use
gdb with process id (replace _12345_ with PID of weechat process):
[source,shell]
----
gdb /usr/bin/weechat 12345
----
@@ -572,8 +588,9 @@ Then like for a crash, use command `bt full`:
To start WeeChat, issue this command:
[source,shell]
----
$ weechat
weechat
----
When you run WeeChat for the first time, the default configuration files are
@@ -789,25 +806,25 @@ This saves the current state in `*.upgrade` files. You can then either reboot
or move the whole WeeChat directories (config, data, cache) to another machine,
and restart WeeChat later with this command:
[source,shell]
----
$ weechat --upgrade
weechat --upgrade
----
[[restart_after_upgrade]]
=== Restart after upgrade
[[restart_release_notes]]
==== Release notes
[[restart_upgrading_notes]]
==== Upgrading notes
After an upgrade, it is *strongly recommended* to read the
https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
which contain important information about breaking changes and some
After an upgrade, it is *strongly recommended* to read the file
https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
which contains important information about breaking changes and some
manual actions that could be required.
You must read the release notes of all versions between your old (excluded) and
your new version (included). +
For example if you switch from version 3.0 to 3.2, you must read release notes
of versions 3.1 and 3.2.
You must read the versions between your old (excluded) and your new version (included). +
For example if you switch from version 4.0.0 to 4.3.0, you must read versions
4.0.1 to 4.3.0.
[[restart_configuration_upgrade]]
==== Configuration upgrade
@@ -1326,7 +1343,7 @@ Tags commonly used (non-exhaustive list):
| no_filter | Line can not be filtered.
| no_highlight | No highlight is possible on line.
| no_log | Line is not written in log file.
| log0 … log9 | Level of log for line (see `/help logger`).
| log0 … log9 | Level of log for line (see the <<command_logger_logger,/logger>> command).
| notify_none | The line must not be added to hotlist. ^(1)^
| notify_message | The line is a user message. ^(1)^
| notify_private | The line is a private message. ^(1)^
@@ -2807,8 +2824,9 @@ configuration.
The option name is an aspell configuration option. List of options can be found
in a shell with following command:
[source,shell]
----
$ aspell config
aspell config
----
For example, to enable option "ignore-case":
@@ -3244,7 +3262,7 @@ buffer to see values), just do:
Secured data can be used in some options that can contain private data like
password, using this format: "${sec.data.xxx}" where "xxx" is the name of
secured data (used with `/secure set xxx ...`). +
For a complete list of supported options, see `/help secure`.
For a complete list of supported options, see the <<command_weechat_secure,/secure>> command.
To use the _libera_ password, for example with
<<irc_sasl_authentication,SASL authentication>>:
@@ -3368,8 +3386,9 @@ irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
Example to join _#weechat_ and _#weechat-fr_ on server _irc.libera.chat_ server,
default port (6667), with nick _alice_:
[source,shell]
----
$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
----
[[irc_servers]]
@@ -3523,9 +3542,10 @@ even if it was OK with versions prior to 0.3.1.
* Import certificate in shell:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
mkdir -p ~/.config/weechat/tls
wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
----
[NOTE]
@@ -3546,10 +3566,11 @@ It is possible to concatenate many certificates in file CAs.pem.
* Create certificate in shell:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
----
[NOTE]
@@ -3597,8 +3618,9 @@ ECDSA-NIST256P-CHALLENGE mechanism (no password is required on connection).
You can generate the key with this command:
[source,shell]
----
$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
----
[NOTE]
@@ -3607,8 +3629,9 @@ which can also be for example `~/.weechat`.
Get the public key (encoded as base64) with this command:
[source,shell]
----
$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
----
Connect to the server, identify (for example with "nickserv identify") and set
@@ -3675,8 +3698,9 @@ privacy and security on the Internet.
In first place, install Tor. For Debian (and derived):
[source,shell]
----
$ sudo apt-get install tor
sudo apt-get install tor
----
In WeeChat you need to add a socks5 proxy for Tor service (hostname/IP and
@@ -4097,7 +4121,7 @@ for example if `#channel1` requires a key but not `#channel2`:
/set irc.server.libera.autojoin "#channel1,#channel2 key1"
----
For help on the format, see `/help irc.server.libera.autojoin`.
For help on the format, see option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
[[irc_private_messages]]
=== Private messages
@@ -4144,7 +4168,7 @@ buffers, for example:
----
It is possible to create filter for one channel only or channels beginning with
same name (see `/help filter`):
same name (see the <<command_weechat_filter,/filter>> command):
----
/filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4589,10 +4613,11 @@ The default path to certificate/key is defined by option
You can create a certificate and private key with following commands:
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
----
[NOTE]
@@ -4692,10 +4717,10 @@ WeeChat itself can NOT connect to another WeeChat with this protocol.
For example:
----
/relay add weechat 9000
/relay add weechat 9500
----
Now you can connect on port 9000 with a remote interface using password
Now you can connect on port 9500 with a remote interface using password
"mypassword".
[[relay_websocket]]
@@ -4713,10 +4738,10 @@ A WebSocket can be opened in a HTML5 with a single line of JavaScript:
[source,javascript]
----
websocket = new WebSocket("ws://server.com:9000/weechat");
websocket = new WebSocket("ws://server.com:9500/weechat");
----
The port (9000 in example) is the port defined in Relay plugin.
The port (9500 in example) is the port defined in Relay plugin.
The URI must end with "/weechat" for _irc_ and _weechat_ protocols and "/api"
for _api_ protocol.
@@ -4737,8 +4762,9 @@ SSH forwarding for relay clients, when other ports cannot be opened.
Using OpenSSH:
[source,shell]
----
$ ssh -L 9000:.weechat/relay_socket user@hostname
ssh -L 9000:.weechat/relay_socket user@hostname
----
This redirects local relay clients connecting on port 9000 to the WeeChat
@@ -4824,34 +4850,39 @@ Some examples:
* Change nick on IRC server libera to "newnick":
[source,shell]
----
$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
----
* Send a message on IRC #weechat channel:
[source,shell]
----
$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Send a multiline message on IRC #test channel, if capability "draft/multiline"
is enabled on the ergo server:
[source,shell]
----
$ echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.ergo.#test \hello\n...on two lines!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Send a message on current buffer:
[source,shell]
----
$ echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
echo '*hello!' >/run/user/1000/weechat/weechat_fifo_12345
----
* Send two commands to unload/reload Python scripts (you have to separate them
with "\n"):
[source,shell]
----
$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
----
[[fifo_commands]]
+23
View File
@@ -0,0 +1,23 @@
// Spanish translation, courtesy of Eddú Meléndez <eddu.melendez@gmail.com> with updates from Fede Mendez <federicomh@gmail.com>
:appendix-caption: Apéndice
:appendix-refsig: {appendix-caption}
:caution-caption: Precaución
:chapter-signifier: Capítulo
:chapter-refsig: {chapter-signifier}
:example-caption: Ejemplo
:figure-caption: Figura
:important-caption: Importante
:last-update-label: Ultima actualización
ifdef::listing-caption[:listing-caption: Lista]
ifdef::manname-title[:manname-title: Nombre]
:note-caption: Nota
:part-signifier: Parte
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Prefacio]
:section-refsig: Sección
:table-caption: Tabla
:tip-caption: Sugerencia
:toc-title: Tabla de Contenido
:untitled-label: Sin título
:version-label: Versión
:warning-caption: Aviso
+26 -7
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: es
:toc-title: Índice
include::includes/attributes-es.adoc[]
Traductores
@@ -58,12 +58,14 @@ If you still have issues, please report them to the developers.
Se recomienda utilizar https://brew.sh/[Homebrew ^↗^^],
puede obtener ayuda con el comando:
[source,shell]
----
brew info weechat
----
Puede instalar WeeChat con este comando:
[source,shell]
----
brew install weechat
----
@@ -326,10 +328,15 @@ Puede utilizar una terminal con selección rectangualr (como rxvt-unicode,
konsole, gnome-terminal, etc.). La tecla normalmente es kbd:[Ctrl] + kbd:[Alt] + la selección
con el ratón.
// TRANSLATION MISSING
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Otra solución es mover la lista de apodos a la parte superior o inferior, por ejemplo:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
[[urls]]
@@ -340,10 +347,14 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
Para abrir direcciones URL más fácilmente, puede:
// TRANSLATION MISSING
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
* mover la lista de apodos a la parte superior con este comando:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
* inhabilitar la alineación de palabras multilínea:
@@ -394,6 +405,7 @@ No hay razón en WeeChat para cambiar la zona horaria, la variable de entorno
En el archivo de inicialización de su shell o en la línea de comando, antes de ejecutar WeeChat:
[source,shell]
----
export TZ=America/New_York
----
@@ -701,16 +713,18 @@ De acuerdo a la información usada, el ratón podrá o no estar soportado.
Puede comprobar el soporte del ratón en la terminal:
[source,shell]
----
$ printf '\033[?1002h'
printf '\033[?1002h'
----
Y después haga clic en el primer caracter de la terminal (superior izquierdo). Debería ver " !!#!!".
Para inhabilitar el ratón en la terminal:
[source,shell]
----
$ printf '\033[?1002l'
printf '\033[?1002l'
----
[[mouse_coords]]
@@ -766,7 +780,7 @@ Puede intentar una cadena de prioridad diferente, reemplace "xxx" por el nombre
de su servidor:
----
/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
----
[[irc_tls_libera]]
@@ -1033,8 +1047,9 @@ Primero compruebe las preguntas sobre la conexión TLS en este documento.
Si todavía no funciona, trate de manera manual eliminar los archivos de scripts (escriba en su terminal):
[source,shell]
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
rm ~/.cache/weechat/script/plugins.xml.gz
----
// TRANSLATION MISSING
@@ -1059,9 +1074,10 @@ que actualizar manualmente el archivo usted mismo para obtener las actualizacion
* en su terminal, con el software curl instalado:
[source,shell]
----
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz
----
// TRANSLATION MISSING
@@ -1069,6 +1085,7 @@ If you're running macOS and the downloaded file has a size of 0 bytes,
try to set this variable in your shell initialization file or on command line,
before starting WeeChat:
[source,shell]
----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
----
@@ -1243,6 +1260,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
Cuando ejecuta WeeChat bajo gdb, puede tener este error:
[source,shell]
----
$ gdb /ruta/a/weechat
(gdb) run
@@ -1253,6 +1271,7 @@ Cannot find new threads: generic error
Para solucionar esto, puede ejecutar gdb con este comando (reemplace la ruta a libpthread y
WeeChat con las rutas de su sistema):
[source,shell]
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /ruta/a/weechat
(gdb) run
+3 -2
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: es
:toc-title: Índice
include::includes/attributes-es.adoc[]
Traductores:
@@ -18,8 +18,9 @@ los atajos de teclado predeterminados.
Ejecuta desde una consola:
[source,shell]
----
$ weechat
weechat
----
[[help]]
+23
View File
@@ -0,0 +1,23 @@
// French translation, courtesy of Nicolas Comet <nicolas.comet@gmail.com> with updates from Maheva Bagard Laursen <mblaursen@gbif.org>
:appendix-caption: Annexe
:appendix-refsig: {appendix-caption}
:caution-caption: Attention
:chapter-signifier: Chapitre
:chapter-refsig: {chapter-signifier}
:example-caption: Exemple
:figure-caption: Figure
:important-caption: Important
:last-update-label: Dernière mise à jour
ifdef::listing-caption[:listing-caption: Liste]
ifdef::manname-title[:manname-title: Nom]
:note-caption: Note
:part-signifier: Partie
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Préface]
:section-refsig: Section
:table-caption: Tableau
:tip-caption: Astuce
:toc-title: Table des matières
:untitled-label: Sans titre
:version-label: Version
:warning-caption: Avertissement
+3
View File
@@ -36,6 +36,9 @@
*-h*, *--help*::
Afficher l'aide.
*-i*, *--build-info*::
Afficher les informations de construction et quitter.
*-l*, *--license*::
Afficher la licence de WeeChat.
+1 -1
View File
@@ -100,7 +100,7 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[]
WeeChat est écrit par Sébastien Helleu et des contributeurs (la liste complète
est dans le fichier AUTHORS.adoc).
est dans le fichier AUTHORS.md).
Copyright (C) 2003-2024 {author}
+18
View File
@@ -0,0 +1,18 @@
// tag::diagram[]
....
┌──────────┐ Station de travail
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS, …)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Appareil mobile
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone, …)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Autres appareils
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
serveurs interface ncurses relay interfaces distantes
....
// end::diagram[]
+20 -14
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
@@ -504,6 +504,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
|          relay/ | Racine des tests unitaires pour l'extension Relay.
|             test-relay-auth.cpp | Tests : authentification des clients.
|             test-relay-http.cpp | Tests : fonctions HTTP pour l'extension Relay.
|             test-relay-raw.cpp | Tests : fonctions sur les messages bruts pour l'extension Relay.
|             test-relay-remote.cpp | Tests : fonctions remote pour l'extension Relay.
|             test-relay-websocket.cpp | Tests : fonctions websocket pour l'extension Relay.
|             api/ | Racine des tests unitaires pour le protocole relay "api".
@@ -533,7 +534,8 @@ Fichiers de documentation :
|       weechat_faq.XX.adoc | link:weechat_faq.fr.html[FAQ ^↗^^] (questions fréquemment posées).
|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.fr.html[Référence API extension ^↗^^].
|       weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage ^↗^^].
|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay ^↗^^] (pour les interfaces distantes).
|       weechat_relay_api.XX.adoc | link:weechat_relay_api.fr.html[Protocole relay "api" ^↗^^] (pour les interfaces distantes).
|       weechat_relay_weechat.XX.adoc | link:weechat_relay_weechat.fr.html[Protocole relay "weechat" ^↗^^] (pour les interfaces distantes).
|       weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts ^↗^^].
|       weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur ^↗^^].
|       includes/ | Fichiers inclus dans la documentation.
@@ -1190,7 +1192,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000,
Le dépôt Git est sur https://github.com/weechat/weechat[GitHub ^↗^^].
Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la
branche master, le format préféré étant une "pull request" sur GitHub. Un patch
branche `main`, le format préféré étant une "pull request" sur GitHub. Un patch
peut aussi être envoyé par e-mail (fait avec `git diff` ou `git format-patch`).
Le format du message de commit est le suivant (avec fermeture automatique
@@ -1207,15 +1209,15 @@ Où _composant_ est :
| Composant | Fichiers | Description
| core
| AUTHORS.adoc +
ChangeLog.adoc +
Contributing.adoc +
| AUTHORS.md +
CHANGELOG.md +
CONTRIBUTING.md +
.github/FUNDING.yml +
.github/ISSUE_TEMPLATE/* +
icons/* +
po/* +
README.adoc +
ReleaseNotes.adoc +
README.md +
UPGRADING.md +
src/core/* +
src/gui/* +
version.sh +
@@ -1272,8 +1274,9 @@ Où _composant_ est :
| Référence extension API
| doc/relay
| doc/xx/weechat_relay_protocol.xx.adoc
| Protocole relay
| doc/xx/weechat_relay_api.xx.adoc +
doc/xx/weechat_relay_weechat.xx.adoc
| Protocoles relay
| doc/dev
| doc/xx/weechat_dev.en.adoc
@@ -1317,9 +1320,10 @@ Si vous souhaitez initialiser une nouvelle langue, utilisez la commande
`msginit`. Par exemple pour créer un fichier qui est prêt à traduire en
néerlandais :
[source,shell]
----
$ cd po
$ msginit -i weechat.pot -l nl_NL -o nl.po
cd po
msginit -i weechat.pot -l nl_NL -o nl.po
----
La langue de base pour WeeChat est l'anglais, donc vous devez évidemment
@@ -1328,8 +1332,9 @@ comprendre parfaitement l'anglais pour traduire vers votre langue.
Après des changements dans les sources, vous pouvez regénérer toutes les
traductions : lancez cette commande dans le répertoire "build" de CMake :
[source,shell]
----
$ make translations && make update-po
make translations && make update-po
----
Vous pouvez alors éditer les fichiers .po (si vous pouvez traduire dans une
@@ -1338,8 +1343,9 @@ langue).
Une fois terminé, vous *devez* vérifier votre fichier avec
https://github.com/flashcode/msgcheck[msgcheck ^↗^^] :
[source,shell]
----
$ msgcheck.py xx.po
msgcheck.py xx.po
----
Et vous pouvez alors recompiler WeeChat pour utiliser les nouvelles traductions.
+25 -7
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
== Général
@@ -50,12 +50,14 @@ Si vous avez toujours des problèmes, merci de les remonter aux développeurs.
Il est recommandé d'utiliser https://brew.sh/[Homebrew ^↗^^],
vous pouvez avoir de l'aide avec :
[source,shell]
----
brew info weechat
----
Vous pouvez installer WeeChat avec cette commande :
[source,shell]
----
brew install weechat
----
@@ -324,11 +326,15 @@ Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme
rxvt-unicode, konsole, gnome-terminal, etc.). La touche est habituellement
kbd:[Ctrl] + kbd:[Alt] + sélection à la souris.
Vous pouvez afficher/cacher la liste des pesudos et la rendre visible seulement
lorsque c'est nécessaire, avec la touche kbd:[Alt+Shift+N].
Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par
exemple :
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
[[urls]]
@@ -338,10 +344,14 @@ Vous pouvez utiliser l'affichage dépouillé (touche par défaut : kbd:[Alt+l]
Pour rendre le clic d'URL plus facile, vous pouvez :
* afficher/cacher la liste des pseudos et la rendre visible seulement lorsque
c'est nécessaire, avec la touche kbd:[Alt+Shift+N]
* déplacer la liste des pseudos en haut :
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
* désactiver l'alignement pour les mots sur plusieurs lignes :
@@ -393,6 +403,7 @@ d'environnement `TZ` doit être positionnée à la valeur appropriée.
Dans votre fichier d'initialisation du shell ou sur la ligne de commande, avant
de démarrer WeeChat :
[source,shell]
----
export TZ=Europe/Paris
----
@@ -704,8 +715,9 @@ Selon le terminfo utilisé, la souris peut ne pas être supportée.
Vous pouvez tester le support de la souris dans le terminal :
[source,shell]
----
$ printf '\033[?1002h'
printf '\033[?1002h'
----
Et cliquez sur le premier caractère du terminal (en haut à gauche). Vous devriez
@@ -713,8 +725,9 @@ voir " !!#!!".
Pour désactiver la souris dans le terminal :
[source,shell]
----
$ printf '\033[?1002l'
printf '\033[?1002l'
----
[[mouse_coords]]
@@ -772,7 +785,7 @@ Vous pouvez essayer une chaîne de priorité différente, remplacez "xxx" par
le nom de votre serveur :
----
/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
----
[[irc_tls_libera]]
@@ -1035,8 +1048,9 @@ Consultez d'abord les questions à propos des connexions TLS dans cette FAQ.
Si cela ne fonctionne toujours pas, essayez de supprimer manuellement le fichier
avec les scripts (dans votre shell) :
[source,shell]
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
rm ~/.cache/weechat/script/plugins.xml.gz
----
[NOTE]
@@ -1062,15 +1076,17 @@ vous-même pour obtenir les mises à jour) :
* dans votre shell, avec curl installé :
[source,shell]
----
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz
----
Si vous êtes sous macOS et que le fichier téléchargé a une taille de 0 octet,
essayez de définir cette variable dans votre fichier d'initialisation du shell
ou sur la ligne de commande, avant de démarrer WeeChat :
[source,shell]
----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
----
@@ -1252,6 +1268,7 @@ Voir https://weechat.org/about/support/[cette page ^↗^^].
Quand vous lancez WeeChat sous gdb, vous pouvez avoir cette erreur :
[source,shell]
----
$ gdb /path/to/weechat
(gdb) run
@@ -1262,6 +1279,7 @@ Cannot find new threads: generic error
Pour corriger ça, vous pouvez lancer gdb avec cette commande (remplacez le
chemin vers libpthread et WeeChat avec les chemins sur votre système) :
[source,shell]
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run
+109 -36
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
@@ -170,9 +170,10 @@ _weechat-plugin.h_ est requis.
Pour compiler l'extension qui n'a qu'un fichier "toto.c" (sous GNU/Linux) :
[source,shell]
----
$ gcc -fPIC -Wall -c toto.c
$ gcc -shared -fPIC -o toto.so toto.o
gcc -fPIC -Wall -c toto.c
gcc -shared -fPIC -o toto.so toto.o
----
[[load_plugin]]
@@ -2663,8 +2664,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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0._
_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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0, 4.4.0._
É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
@@ -3390,6 +3390,12 @@ première étendue à la dernière) :
| >> `+${define:len,${calc:5+3}}${len}x${len}+` +
== `+8x8+`
| `+${hdata_count:name[list]}+` +
`+${hdata_count:name[pointer]}+` | 4.4.0
| Nombre d'éléments dans la liste hdata ou en démarrant à `pointer`.
| >> `+${hdata_count:buffer[gui_buffers]}+` +
== `+15+`
| `+${sec.data.nom}+` |
| Valeur de la donnée sécurisée `nom`.
| >> `+${sec.data.libera_pass}+` +
@@ -5898,7 +5904,7 @@ Fonctions pour les tables de hachage.
==== hashtable_new
_WeeChat ≥ 0.3.3._
_WeeChat ≥ 0.3.3, mis à jour dans la 4.4.0._
Créer une nouvelle table de hachage.
@@ -5928,12 +5934,14 @@ Paramètres :
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
* _type_values_ : type pour les valeurs dans la table de hachage :
** _WEECHAT_HASHTABLE_INTEGER_
** _WEECHAT_HASHTABLE_STRING_
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
* _callback_hash_key_ : fonction appelée pour rendre le hachage d'une clé (la
clé sous forme de nombre entier), peut être NULL si le type de clé n'est pas
"buffer" (une fonction de hachage par défaut est utilisée), paramètres et
@@ -6301,12 +6309,14 @@ Paramètres :
*** _pointer_ : pointeur
*** _buffer_ : buffer
*** _time_ : heure
*** _longlong_: entier de type "long long"
** _type_values_ : type pour les valeurs :
*** _integer_ : entier
*** _string_ : chaîne
*** _pointer_ : pointeur
*** _buffer_ : buffer
*** _time_ : heure
*** _longlong_: entier de type "long long"
** _keys_ : chaîne avec la liste des clés (format : "clé1,clé2,clé3")
** _keys_sorted_ : chaîne avec la liste triée des clés (format :
"clé1,clé2,clé3")
@@ -11328,7 +11338,7 @@ hook2 = weechat.hook_url("http://localhost:8080/", options, 20000, "my_url_cb",
==== hook_connect
_Mis à jour dans la 1.5, 2.0._
_Mis à jour dans la 1.5, 2.0, 4.4.0._
Accrocher une connexion (connexion à une machine distante en tâche de fond).
@@ -11363,8 +11373,10 @@ Paramètres :
une connexion sans proxy)
* _address_ : nom ou adresse IP de la machine à laquelle se connecter
* _port_ : numéro de port
* _ipv6_ : 1 pour utiliser IPv6 (avec repli sur IPv4), 0 pour utiliser seulement
IPv4
* _ipv6_:
** `WEECHAT_HOOK_CONNECT_IPV6_DISABLE` ^(1)^: désactiver IPv6 (utiliser seulement IPv4)
** `WEECHAT_HOOK_CONNECT_IPV6_AUTO` ^(1)^: utiliser IPv6 avec repli sur IPv4
** `WEECHAT_HOOK_CONNECT_IPV6_FORCE` ^(1)^: forcer IPv6 (ne pas utiliser IPv4) _(WeeChat ≥ 4.4.0)_
* _retry_ : numéro de nouvelle tentative, utilisé pour se rabattre sur les
adresses IPv4 si la connexion IPv6 échoue
* _gnutls_sess_ : session GnuTLS (optionnel)
@@ -11386,7 +11398,7 @@ Paramètres :
paramètres et valeur de retour :
** _const void *pointer_ : pointeur
** _void *data_ : pointeur
** _int status_ : statut de connexion :
** _int status_ : statut de connexion ^(2)^:
*** _WEECHAT_HOOK_CONNECT_OK_ : connexion ok
*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_ : adresse non trouvée
*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_ : adresse IP non trouvée
@@ -11399,8 +11411,8 @@ Paramètres :
*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_ : mémoire insuffisante
*** _WEECHAT_HOOK_CONNECT_TIMEOUT_ : temps maximum dépassé
*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_ : erreur de création socket
** _gnutls_rc_ : valeur retour de _gnutls_handshake()_
** _sock_ : socket utilisé pour la connexion
** _gnutls_rc_ : valeur retour de _gnutls_handshake()_ ^(2)^
** _sock_ : socket utilisé pour la connexion ^(2)^
** _const char *error_ : valeur retour de _gnutls_strerror(gnutls_rc)_
** _const char *ip_address_ : adresse IP trouvée
** valeur de retour :
@@ -11413,17 +11425,21 @@ Paramètres :
fonction similaire) et est automatiquement libéré (par free) lorsque le
"hook" est supprimé
Valeur de retour :
* pointeur vers le nouveau "hook", NULL en cas d'erreur
[IMPORTANT]
Dans les scripts, avec WeeChat ≥ 2.0, les paramètres de la fonction de rappel
[NOTE]
^(1)^ Les constantes pour le paramètre _ipv6_ sont disponibles à partir de
WeeChat 4.4.0. +
Pour les versions plus anciennes, les valeurs autorisées sont `1` (utiliser IPv6
avec repli sur IPv4) et `0` (désactiver IPv6, utiliser seulement IPv4). +
^(2)^ Dans les scripts, avec WeeChat ≥ 2.0, les paramètres de la fonction de rappel
_status_, _gnutls_rc_ et _sock_ sont des entiers (avec WeeChat ≤ 1.9, ils étaient
des chaînes). +
Pour être compatible avec toutes les versions, il est recommandé de convertir
le paramètre avant de l'utiliser, par exemple en Python: `int(sock)`.
Valeur de retour :
* pointeur vers le nouveau "hook", NULL en cas d'erreur
Exemple en C :
[source,c]
@@ -11473,7 +11489,8 @@ my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc,
struct t_hook *my_connect_hook = weechat_hook_connect (NULL,
"my.server.org", 1234,
1, 0,
WEECHAT_HOOK_CONNECT_IPV6_AUTO,
0,
NULL, NULL, 0, /* GnuTLS */
NULL,
&my_connect_cb, NULL, NULL);
@@ -11489,31 +11506,32 @@ def hook_connect(proxy: str, address: str, port: int, ipv6: int, retry: int, loc
# exemple
def my_connect_cb(data: str, status: int, gnutls_rc: int, sock: int, error: str, ip_address: str) -> int:
if status == WEECHAT_HOOK_CONNECT_OK:
if status == weechat.WEECHAT_HOOK_CONNECT_OK:
# ...
elif status == WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
elif status == weechat.WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
# ...
elif status == WEECHAT_HOOK_CONNECT_PROXY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_PROXY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_TIMEOUT:
elif status == weechat.WEECHAT_HOOK_CONNECT_TIMEOUT:
# ...
elif status == WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
# ...
return weechat.WEECHAT_RC_OK
hook = weechat.hook_connect("", "my.server.org", 1234, 1, 0, "",
hook = weechat.hook_connect("", "my.server.org", 1234,
weechat.WEECHAT_HOOK_CONNECT_IPV6_AUTO, 0, "",
"my_connect_cb", "")
----
@@ -12357,6 +12375,10 @@ Liste des signaux envoyés par WeeChat et les extensions :
| Pointeur : ligne.
| Ligne ajoutée dans un tampon.
| weechat | [[hook_signal_buffer_line_data_changed]] buffer_line_data_changed | 4.4.0
| Pointeur: données de la ligne.
| Les données de la ligne ont changé dans un tampon.
| weechat | [[hook_signal_buffer_lines_hidden]] buffer_lines_hidden |
| Pointeur : tampon.
| Lignes cachées dans le tampon.
@@ -12401,6 +12423,10 @@ Liste des signaux envoyés par WeeChat et les extensions :
| Pointeur : tampon.
| Modes du tampon changés.
| weechat | [[hook_signal_buffer_time_for_each_line_changed]] buffer_time_for_each_line_changed | 4.4.0
| Pointeur : tampon.
| Affichage de l'heure pour chaque ligne changé.
| weechat | [[hook_signal_buffer_type_changed]] buffer_type_changed |
| Pointeur : tampon.
| Type de tampon changé.
@@ -12513,6 +12539,14 @@ Liste des signaux envoyés par WeeChat et les extensions :
| Chaîne : combinaison de touches.
| Combinaison de touches dans le contexte _cursor_.
| weechat | [[hook_signal_layout_buffers_applied]] layout_buffers_applied | 4.4.0
| Chaîne: nom de la disposition.
| Disposition appliquée pour les tampons.
| weechat | [[hook_signal_layout_windows_applied]] layout_windows_applied | 4.4.0
| Chaîne: nom de la disposition.
| Disposition appliquée pour les fenêtres.
| weechat | [[hook_signal_mouse_enabled]] mouse_enabled | 1.1
| -
| Souris activée.
@@ -14925,7 +14959,6 @@ Paramètres :
** _number_ : numéro du tampon (commence à 1)
** _layout_number_ : numéro du tampon sauvegardé dans le "layout"
** _layout_number_merge_order_ : ordre du tampon mélangé pour le "layout"
** _short_name_is_set_ : 1 si le nom court est défini, 0 si non défini
** _type_ : type de tampon (0 : formaté, 1 : contenu libre)
** _notify_ : niveau de notification du tampon
** _num_displayed_ : nombre de fenêtres affichant ce tampon
@@ -15097,7 +15130,7 @@ Exemple en C :
[source,c]
----
weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %lx",
weechat_printf (NULL, "pointeur vers l'extension de mon tampon : %p",
weechat_buffer_get_pointer (mon_tampon, "plugin"));
----
@@ -15523,6 +15556,46 @@ if buffer:
weechat.prnt("", "%d" % weechat.buffer_match_list(buffer, "irc.oftc.*,python.*")) # 0
----
[[buffer_lines]]
=== Lignes de tampons
Fonctions pour les lignes de tampons.
==== line_search_by_id
_WeeChat ≥ 4.4.0._
Rechercher une ligne du tampon par son identifiant.
Prototype:
[source,c]
----
struct t_gui_line *weechat_line_search_by_id (struct t_gui_buffer *buffer, int id);
----
Valeur de retour:
* pointeur vers la ligne trouvée, NULL si non trouvée
Exemple en C:
[source,c]
----
struct t_gui_line *line = weechat_line_search_by_id (buffer, 123);
----
Script (Python):
[source,python]
----
# prototype
def line_search_by_id(buffer: str, line_id: int) -> str: ...
# exemple
line = weechat.line_search_by_id(buffer, 123)
----
[[windows]]
=== Fenêtres
@@ -15588,7 +15661,7 @@ Exemple en C :
[source,c]
----
weechat_printf (NULL,
"fenêtre affichant le tampon core : %lx",
"fenêtre affichant le tampon core : %p",
weechat_window_search_with_buffer (weechat_buffer_search_main ()));
----
@@ -15733,7 +15806,7 @@ Exemple en C :
[source,c]
----
weechat_printf (NULL,
"tampon affiché dans la fenêtre courante : %lx",
"tampon affiché dans la fenêtre courante : %p",
weechat_window_get_pointer (weechat_current_window (), "buffer"));
----
@@ -19664,7 +19737,7 @@ Exemple en C :
----
struct t_hdata *hdata = weechat_hdata_get ("buffer");
struct t_gui_buffer *buffer = weechat_buffer_search_main ();
weechat_printf (NULL, "lines = %lx", weechat_hdata_pointer (hdata, buffer, "lines"));
weechat_printf (NULL, "lines = %p", weechat_hdata_pointer (hdata, buffer, "lines"));
----
Script (Python) :
+3 -2
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
[[start]]
== Démarrer WeeChat
@@ -13,8 +13,9 @@ touches par défaut.
Lancer depuis votre shell :
[source,shell]
----
$ weechat
weechat
----
[[help]]
File diff suppressed because it is too large Load Diff
@@ -2,12 +2,12 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
[[introduction]]
== Introduction
Ce document est une spécification du protocole Relay de WeeChat : le protocole
Ce document est une spécification du protocole relay _weechat_ : le protocole
utilisé pour relayer les données de WeeChat aux clients, qui sont surtout des
interfaces distantes.
@@ -27,28 +27,11 @@ Les termes suivants sont utilisés dans ce document :
Les _clients_ sont connectés au _relay_ comme dans le diagramme ci-dessous :
....
┌──────────┐ Station de travail
┌────────┐ ┌───┤ client 1 │ (Linux, Windows,
│ irc │◄──┐ ╔═══════════╤═══════╗ │ └──────────┘ BSD, macOS ...)
└────────┘ └──╢ │ ║◄───┘ ┌──────────┐
...... ║ WeeChat │ Relay ║◄───────┤ client 2 │ Appareil mobile
┌────────┐ ┌──╢ │ ║◄───┐ └──────────┘ (Android, iPhone ...)
│ jabber │◄──┘ ╚═══════════╧═══════╝ │ ......
└────────┘ │ ┌──────────┐
...... └───┤ client N │ Autres appareils
└──────────┘
└────────────┘ └───────────────────┘╘══════╛└────────────────────────────────┘
serveurs interface ncurses protocole interfaces distantes
relay
....
include::includes/relay.fr.adoc[tag=diagram]
[NOTE]
Tous les clients ici utilisent le protocole _weechat_ dans l'extension _relay_.
L'extension _relay_ autorise aussi des clients IRC, et _relay_ agit alors comme
un _proxy IRC_ (non décrit dans ce document).
L'extension _relay_ autorise aussi les protocoles _api_ et _irc_ (non décrits dans ce document).
[[protocol_generalities]]
== Généralités sur le protocole
@@ -1531,6 +1514,9 @@ Les identifiants réservés par WeeChat :
| _buffer_line_added | buffer | hdata : line
| Ligne ajoutée dans le tampon. | Afficher la ligne dans le tampon.
| _buffer_line_data_changed | buffer | hdata: line
| Ligne changée dans le tampon. | Modifier la ligne affichée dans le tampon.
| _nicklist | nicklist | hdata : nicklist_item
| Liste de pseudos pour un tampon. | Remplacer la liste de pseudos.
@@ -2087,6 +2073,7 @@ Données envoyées dans le hdata :
|===
| Nom | Type | Description
| buffer | pointeur | Pointeur vers le tampon.
| id | entier | Identifiant de ligne.
| date | date/heure | Date du message.
| date_usec | entier | Microsecondes de la date.
| date_printed | date/heure | Date d'affichage du message.
@@ -2108,6 +2095,7 @@ id: '_buffer_line_added'
hda:
keys: {
'buffer': 'ptr',
'id': 'int',
'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim',
@@ -2123,6 +2111,59 @@ hda:
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
id: 12
date: 1362728993
date_usec: 902765
date_printed: 1362728993
date_usec_printed: 902765
displayed: 1
notify_level: 1
highlight: 0
tags_array: [
'irc_privmsg',
'notify_message',
'prefix_nick_142',
'nick_FlashCode',
'log1',
]
prefix: 'F06@F@00142FlashCode'
message: 'hello!'
----
[[message_buffer_line_data_changed]]
==== _buffer_line_data_changed
Ce message est envoyé au client lorsque le signal "buffer_line_data_changed"
est envoyé par WeeChat.
Données envoyées dans le hdata : mêmes données que pour
<<message_buffer_line_added,_buffer_line_added>>.
Exemple : le message _hello!_ du pseudo _FlashCode_ sur le tampon _irc.libera.#weechat_ a été mis à jour:
[source,python]
----
id: '_buffer_line_data_changed'
hda:
keys: {
'buffer': 'ptr',
'id': 'int',
'date': 'tim',
'date_usec': 'int',
'date_printed': 'tim',
'date_usec_printed': 'int',
'displayed': 'chr',
'notify_level': 'chr',
'highlight': 'chr',
'tags_array': 'arr',
'prefix': 'str',
'message': 'str',
}
path: ['line_data']
item 1:
__path: ['0x4a49600']
buffer: '0x4a715d0'
id: 12
date: 1362728993
date_usec: 902765
date_printed: 1362728993
+5 -4
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
@@ -73,7 +73,7 @@ link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat
WeeChat définit un module `weechat` qui doit être importé avec `import weechat`. +
Un "stub" Python pour l'API WeeChat est disponible dans le dépôt :
https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
https://raw.githubusercontent.com/weechat/weechat/main/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Fonctions
@@ -376,9 +376,10 @@ automatiquement le script quand WeeChat démarre.
Par exemple en Python :
[source,shell]
----
$ cd ~/.local/share/weechat/python/autoload
$ ln -s ../script.py
cd ~/.local/share/weechat/python/autoload
ln -s ../script.py
----
[NOTE]
+89 -58
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
:toc-title: Table des matières
include::includes/attributes-fr.adoc[]
Ce manuel documente le client de messagerie instantanée WeeChat, il fait
partie de WeeChat.
@@ -110,7 +110,7 @@ Le tableau suivant liste les paquets *requis* pour construire WeeChat :
| cmake | ≥ 3.0
| Construction.
| pkg-config |
| pkgconf / pkg-config |
| Détection des bibliothèques installées.
| libncurses-dev |
@@ -219,8 +219,9 @@ Si vous utilisez une distribution basée sur Debian ou Ubuntu, et si vous avez
des entrées source "deb-src" dans votre fichier _/etc/apt/sources.list_, vous
pouvez installer toutes les dépendances avec la commande :
[source,shell]
----
# apt-get build-dep weechat
sudo apt-get build-dep weechat
----
[[build]]
@@ -228,22 +229,24 @@ pouvez installer toutes les dépendances avec la commande :
* Installation dans les répertoires systèmes (nécessite les droits _root_) :
[source,shell]
----
$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install
mkdir build
cd build
cmake ..
make
sudo make install
----
* Installation dans un répertoire spécifique (par exemple dans votre "home") :
[source,shell]
----
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/chemin/vers/répertoire
$ make
$ make install
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/chemin/vers/répertoire
make
make install
----
Des options peuvent être utilisées pour CMake, avec le format : `-DOPTION=VALUE`.
@@ -380,14 +383,16 @@ Liste des options disponibles :
Les autres options peuvent être affichées avec cette commande :
[source,shell]
----
$ cmake -LA
cmake -LA
----
Ou avec l'interface Curses :
[source,shell]
----
$ ccmake ..
ccmake ..
----
[[tests]]
@@ -400,14 +405,16 @@ Les paquets suivants sont nécessaires pour compiler les tests :
Les tests doivent être activés pour compiler WeeChat :
[source,shell]
----
$ cmake .. -DENABLE_TESTS=ON
cmake .. -DENABLE_TESTS=ON
----
Ils peuvent être lancés après compilation depuis le répertoire de construction :
[source,shell]
----
$ ctest -V
ctest -V
----
[[git_sources]]
@@ -418,8 +425,9 @@ que WeeChat ne compile pas et qu'il soit très instable. Vous êtes prévenus !
Pour récupérer les sources Git, tapez cette commande :
[source,shell]
----
$ git clone https://github.com/weechat/weechat.git
git clone https://github.com/weechat/weechat.git
----
Suivez alors les instructions du paquet source (voir
@@ -442,8 +450,9 @@ futur de WeeChat, vous devez :
Si vous compilez avec CMake :
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake .. -DCMAKE_BUILD_TYPE=Debug
----
[[address_sanitizer]]
@@ -452,8 +461,9 @@ $ cmake .. -DCMAKE_BUILD_TYPE=Debug
Vous pouvez aussi activer la vérification des adresses (« address sanitizer »),
ce qui provoquera immédiatement un plantage de WeeChat en cas de problème :
[source,shell]
----
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
----
[WARNING]
@@ -462,8 +472,9 @@ provoquer un plantage, ce qui n'est pas recommandé en production.
Une fois compilé et installé, vous devez lancer WeeChat comme ceci :
[source,shell]
----
$ ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
ASAN_OPTIONS="detect_odr_violation=0 log_path=asan.log" weechat
----
En cas de plantage, la trace se trouve dans le fichier `asan.log`.
@@ -484,12 +495,14 @@ WeeChat ne démarre, vous pouvez utiliser la commande `ulimit`.
Par exemple sous Linux avec le shell _bash_, ajoutez cette ligne dans votre
`~/.bashrc` :
[source,shell]
----
ulimit -c unlimited
----
Ou une taille maximum :
[source,shell]
----
ulimit -c 200000
----
@@ -513,6 +526,7 @@ https://wiki.archlinux.org/title/Core_dump[page wiki ^↗^^].
Par exemple si _weechat_ est installé dans _/usr/bin/_ et que le fichier
_core_ se trouve dans _/home/user/_, alors il faut lancer gdb avec cette commande :
[source,shell]
----
gdb /usr/bin/weechat /home/user/core
----
@@ -561,6 +575,7 @@ Pour déboguer WeeChat qui tourne (par exemple si WeeChat semble bloqué), vous
pouvez utiliser gdb avec l'identifiant du processus (remplacez _12345_ par le
PID du processus weechat) :
[source,shell]
----
gdb /usr/bin/weechat 12345
----
@@ -576,8 +591,9 @@ Ensuite comme pour un crash, utilisez la commande `bt full` :
Pour lancer WeeChat, tapez cette commande :
[source,shell]
----
$ weechat
weechat
----
Lorsque vous lancez WeeChat pour la première fois, les fichiers de configuration
@@ -801,25 +817,26 @@ Cela sauvegarde l'état actuel dans des fichiers `*.upgrade`. Vous pouvez soit
rebooter ou déplacer les répertoires WeeChat (config, data, cache) vers une
autre machine, et redémarrer WeeChat plus tard avec cette commande :
[source,shell]
----
$ weechat --upgrade
weechat --upgrade
----
[[restart_after_upgrade]]
=== Redémarrage après mise à jour
[[restart_release_notes]]
==== Notes de version
[[restart_upgrading_notes]]
==== Notes de mise à jour
Après une mise à jour, il est *fortement recommandé* de lire les
https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[notes de version ^↗^^]
qui contiennent des informations importantes sur les changements majeurs et
Après une mise à jour, il est *fortement recommandé* de lire le fichier
https://github.com/weechat/weechat/blob/main/UPGRADING.md[UPGRADING.md ^↗^^]
qui contient des informations importantes sur les changements majeurs et
quelques actions manuelles qui pourraient être nécessaires.
Vous devez lire les notes des versions entre votre version ancienne (exclue)
Vous devez lire les versions entre votre version ancienne (exclue)
et votre nouvelle version (incluse). +
Par exemple si vous passez de la version 3.0 à 3.2, vous devez lire les notes
des versions 3.1 et 3.2.
Par exemple si vous passez de la version 4.0.0 à 4.3.0, vous devez lire les
versions 4.0.1 à 4.3.0.
[[restart_configuration_upgrade]]
==== Mise à jour de la configuration
@@ -1350,7 +1367,7 @@ Les étiquettes couramment utilisées (liste non exhaustive) :
| no_filter | La ligne ne peut pas être filtrée.
| no_highlight | Aucun highlight n'est possible sur cette ligne.
| no_log | La ligne n'est pas écrite dans le fichier de log.
| log0 … log9 | Niveau de log pour la ligne (voir `/help logger`).
| log0 … log9 | Niveau de log pour la ligne (voir la commande <<command_logger_logger,/logger>>).
| notify_none | La ligne ne doit pas être ajoutée à la "hotlist". ^(1)^
| notify_message | La ligne est un message utilisateur. ^(1)^
| notify_private | La ligne est un message privé. ^(1)^
@@ -2876,8 +2893,9 @@ options dans la section "option" de la configuration aspell.
Le nom de l'option est une option de configuration aspell. La liste des options
peut être trouvée par la commande suivante sous le shell :
[source,shell]
----
$ aspell config
aspell config
----
Par exemple, pour activer l'option "ignore-case" :
@@ -3339,7 +3357,7 @@ Les données sécurisées peuvent être utilisées dans quelques options qui peu
contenir des données sensibles comme un mot de passe, en utilisant ce format :
"${sec.data.xxx}" où "xxx" est le nom de la donnée sécurisée (utilisé dans la
commande `/secure set xxx ...`). +
Pour une liste complète des options supportées, voir `/help secure`.
Pour une liste complète des options supportées, voir la commande <<command_weechat_secure,/secure>>.
Pour utiliser le mot de passe _libera_, par exemple avec
<<irc_sasl_authentication,l'authentification SASL>> :
@@ -3465,8 +3483,9 @@ irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/canal][,canal[...]]
Exemple pour rejoindre _#weechat_ et _#weechat-fr_ sur le serveur
_irc.libera.chat_, port par défaut (6667), avec le pseudo _alice_ :
[source,shell]
----
$ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
----
[[irc_servers]]
@@ -3624,9 +3643,10 @@ et peut échouer, même si cela pouvait être OK dans les versions inférieures
* Importer le certificat sous le shell :
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
mkdir -p ~/.config/weechat/tls
wget -O ~/.config/weechat/tls/CAs.pem https://www.spi-inc.org/ca/spi-cacert.crt
----
[NOTE]
@@ -3647,10 +3667,11 @@ Il est possible de concaténer plusieurs certificats dans le fichier CAs.pem.
* Créer le certificat sous le shell :
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
----
[NOTE]
@@ -3700,8 +3721,9 @@ connexion).
Vous pouvez générer la clé avec cette commande :
[source,shell]
----
$ openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
openssl ecparam -genkey -name prime256v1 -out ~/.config/weechat/ecdsa.pem
----
[NOTE]
@@ -3710,8 +3732,9 @@ config WeeChat qui peut aussi être par exemple `~/.weechat`.
Récupérez la clé publique (encodée en base64) avec cette commande :
[source,shell]
----
$ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem | grep '^pub:' -A 3 | tail -n 3 | tr -d ' \n:' | xxd -r -p | base64
----
Connectez-vous au serveur, identifiez vous (par exemple avec
@@ -3781,8 +3804,9 @@ sur Internet.
En premier lieu, installez Tor. Pour Debian (et dérivés) :
[source,shell]
----
$ sudo apt-get install tor
sudo apt-get install tor
----
Sous WeeChat vous devez ajouter un proxy socks5 pour le service Tor (le nom/IP
@@ -4215,7 +4239,7 @@ des clés, par exemple si `#canal1` requiert une clé mais pas `#canal2`:
/set irc.server.libera.autojoin "#canal1,#canal2 cle1"
----
Pour de l'aide sur le format, voir `/help irc.server.libera.autojoin`.
Pour de l'aide sur le format, voir l'option <<option_irc.server_default.autojoin,irc.server_default.autojoin>>.
[[irc_private_messages]]
=== Messages privés
@@ -4264,7 +4288,7 @@ pour cacher les lignes sur les tampons, par exemple :
----
Il est possible de créer un filtre pour un canal seulement ou plusieurs canaux
commençant par le même nom (voir `/help filter`) :
commençant par le même nom (voir la commande <<command_weechat_filter,/filter>>) :
----
/filter add irc_smart_weechat irc.libera.#weechat* irc_smart_filter *
@@ -4723,10 +4747,11 @@ Le chemin par défaut vers le certificat/clé est défini par l'option
Vous pouvez créer le certificat et la clé privée avec les commandes suivantes :
[source,shell]
----
$ mkdir -p ~/.config/weechat/tls
$ cd ~/.config/weechat/tls
$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
mkdir -p ~/.config/weechat/tls
cd ~/.config/weechat/tls
openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
----
[NOTE]
@@ -4832,10 +4857,10 @@ protocole.
Par exemple :
----
/relay add weechat 9000
/relay add weechat 9500
----
Maintenant vous pouvez vous connecter sur le port 9000 avec une interface
Maintenant vous pouvez vous connecter sur le port 9500 avec une interface
distante en utilisant le mot de passe "motdepasse".
[[relay_websocket]]
@@ -4855,10 +4880,10 @@ JavaScript :
[source,javascript]
----
websocket = new WebSocket("ws://server.com:9000/weechat");
websocket = new WebSocket("ws://server.com:9500/weechat");
----
Le port (9000 dans l'exemple) est le port défini dans l'extension Relay.
Le port (9500 dans l'exemple) est le port défini dans l'extension Relay.
L'URI doit se terminer par "/weechat" pour les protocoles _irc_ et _weechat_ et
"/api" pour le protocole _api_.
@@ -4881,8 +4906,9 @@ _/run/user/1000/weechat/relay_socket_. Cela est utile pour autoriser le
Avec OpenSSH :
[source,shell]
----
$ ssh -L 9000:.weechat/relay_socket user@hostname
ssh -L 9000:.weechat/relay_socket user@hostname
----
Cela redirige les clients relay locaux qui se connectent au port 9000 vers
@@ -4970,34 +4996,39 @@ Quelques exemples :
* Changer le pseudo sur libera en "autrepseudo" :
[source,shell]
----
$ echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
----
* Envoyer un message sur le canal IRC #weechat :
[source,shell]
----
$ echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.libera.#weechat *bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
----
* Envoyer un message multi-lignes sur le canal IRC #test, si la capacité
"draft/multiline" est activée sur le serveur ergo :
[source,shell]
----
$ echo 'irc.ergo.#test \bonjour\n...sur deux lignes !' >/run/user/1000/weechat/weechat_fifo_12345
echo 'irc.ergo.#test \bonjour\n...sur deux lignes !' >/run/user/1000/weechat/weechat_fifo_12345
----
* Envoyer un message sur le tampon courant :
[source,shell]
----
$ echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
echo '*bonjour !' >/run/user/1000/weechat/weechat_fifo_12345
----
* Envoyer deux commandes pour décharger/recharger les scripts Python (vous devez
les séparer par "\n") :
[source,shell]
----
$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
----
[[fifo_commands]]
+23
View File
@@ -0,0 +1,23 @@
// Italian translation, courtesy of Marco Ciampa <ciampix@posteo.net>
:appendix-caption: Appendice
:appendix-refsig: {appendix-caption}
:caution-caption: Attenzione
:chapter-signifier: Capitolo
:chapter-refsig: {chapter-signifier}
:example-caption: Esempio
:figure-caption: Figura
:important-caption: Importante
:last-update-label: Ultimo aggiornamento
ifdef::listing-caption[:listing-caption: Elenco]
ifdef::manname-title[:manname-title: Nome]
:note-caption: Nota
:part-signifier: Parte
:part-refsig: {part-signifier}
ifdef::preface-title[:preface-title: Prefazione]
:section-refsig: Sezione
:table-caption: Tabella
:tip-caption: Suggerimento
:toc-title: Indice
:untitled-label: Senza titolo
:version-label: Versione
:warning-caption: Attenzione
+4
View File
@@ -39,6 +39,10 @@
*-h*, *--help*::
Mostra l'aiuto.
// TRANSLATION MISSING
*-i*, *--build-info*::
Display build information and exit.
*-l*, *--license*::
Mostra la licenza di WeeChat.
+1 -1
View File
@@ -101,7 +101,7 @@ $HOME/.local/share/weechat/weechat.log::
// tag::copyright[]
// TRANSLATION MISSING
WeeChat is written by Sébastien Helleu and contributors (complete list is in
the AUTHORS.adoc file).
the AUTHORS.md file).
Copyright (C) 2003-2024 {author}
+26 -7
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: it
:toc-title: Indice
include::includes/attributes-it.adoc[]
// TRANSLATION MISSING
Translators:
@@ -62,6 +62,7 @@ If you still have issues, please report them to the developers.
It is recommended to use https://brew.sh/[Homebrew ^↗^^],
you can get help with:
[source,shell]
----
brew info weechat
----
@@ -69,6 +70,7 @@ brew info weechat
// TRANSLATION MISSING
You can install WeeChat with this command:
[source,shell]
----
brew install weechat
----
@@ -348,10 +350,15 @@ just the contents of the currently selected window, without any formatting.
rxvt-unicode, konsole, gnome-terminal, ...). La combinazione tasti in
generale è kbd:[Ctrl] + kbd:[Alt] + selezione mouse.
// TRANSLATION MISSING
You can toggle nicklist and make it visible only when needed, with key
kbd:[Alt+Shift+N].
Un'altra soluzione è spostare la lista nick in alto o in basso, per esempio:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
[[urls]]
@@ -363,11 +370,15 @@ You can use the bare display (default key: kbd:[Alt+l] (`L`)).
// TRANSLATION MISSING
To make opening URLs easier, you can:
// TRANSLATION MISSING
* toggle nicklist and make it visible only when needed, with key kbd:[Alt+Shift+N]
// TRANSLATION MISSING
* move nicklist to top:
----
/set weechat.bar.nicklist.position top
/set weechat.bar.nicklist.size_max 8
----
// TRANSLATION MISSING
@@ -424,6 +435,7 @@ There is no option in WeeChat to change the timezone, the environment variable
// TRANSLATION MISSING
In your shell initialization file or on command line, before starting WeeChat:
[source,shell]
----
export TZ=Europe/Rome
----
@@ -750,8 +762,9 @@ In base al terminale usato, il mouse potrebbe non essere supportato.
È possibile testare il supporto al mouse nel terminale:
[source,shell]
----
$ printf '\033[?1002h'
printf '\033[?1002h'
----
E poi cliccare sul primo carattere del terminale (in alto a sinistra. Dovrebbe
@@ -759,8 +772,9 @@ essere possibile vedere !!#!!".
Per disabilitare il mouse nel terminale:
[source,shell]
----
$ printf '\033[?1002l'
printf '\033[?1002l'
----
[[mouse_coords]]
@@ -818,7 +832,7 @@ should be, you can specify the fingerprint (SHA-512, SHA-256 or SHA-1):
Provare una stringa di priorità diversa, sostituendo "xxx" con il nome del server:
----
/set irc.server.xxx.tls_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
/set irc.server.xxx.tls_priorities "NORMAL:%COMPAT"
----
[[irc_tls_libera]]
@@ -1096,8 +1110,9 @@ First check questions about TLS connection in this FAQ.
If still not working, try to manually delete the scripts file (in your shell):
[source,shell]
----
$ rm ~/.cache/weechat/script/plugins.xml.gz
rm ~/.cache/weechat/script/plugins.xml.gz
----
// TRANSLATION MISSING
@@ -1122,9 +1137,10 @@ have to update manually the file yourself to get updates):
* in your shell, with curl installed:
[source,shell]
----
$ cd ~/.cache/weechat/script
$ curl -O https://weechat.org/files/plugins.xml.gz
cd ~/.cache/weechat/script
curl -O https://weechat.org/files/plugins.xml.gz
----
// TRANSLATION MISSING
@@ -1132,6 +1148,7 @@ If you're running macOS and the downloaded file has a size of 0 bytes,
try to set this variable in your shell initialization file or on command line,
before starting WeeChat:
[source,shell]
----
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
----
@@ -1322,6 +1339,7 @@ See https://weechat.org/about/support/[this page ^↗^^].
Quando viene eseguito WeeChat all'interno di gdb, potrebbe verificarsi
questo errore:
[source,shell]
----
$ gdb /path/to/weechat
(gdb) run
@@ -1332,6 +1350,7 @@ Cannot find new threads: generic error
Per correggerlo, è possibile eseguire gdb con questo comando (sostituire il
path di libpthread e WeeChat con i path del proprio sistema):
[source,shell]
----
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
(gdb) run
+123 -36
View File
@@ -2,7 +2,7 @@
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: it
:toc-title: Indice
include::includes/attributes-it.adoc[]
// TRANSLATION MISSING
Translators:
@@ -185,9 +185,10 @@ il file _weechat-plugin.h_.
Per compilare un plugin che ha un file "tizio.c" (in GNU/Linux):
[source,shell]
----
$ gcc -fPIC -Wall -c tizio.c
$ gcc -shared -fPIC -o tizio.so tizio.o
gcc -fPIC -Wall -c tizio.c
gcc -shared -fPIC -o tizio.so tizio.o
----
[[load_plugin]]
@@ -676,7 +677,7 @@ Argomenti:
* _string_: string to cut
* _length_: max chars
* _count_suffix_: if 1, the length of suffix is counter in the max length
* _count_suffix_: if 1, the length of suffix is counted in the max length
* _screen_: if 1, the cut is based on width of chars displayed
* _cut_suffix_: the suffix added after the string if it is cut
@@ -2772,8 +2773,7 @@ str3 = weechat.string_input_for_buffer("//test") # "/test"
// TRANSLATION MISSING
==== 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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0._
_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, 2.9, 3.1, 3.2, 3.3, 3.4, 3.6, 3.8, 4.0.0, 4.2.0, 4.3.0, 4.4.0._
Evaluate an expression and return result as a string.
Special variables with format `+${variable}+` are expanded (see table below).
@@ -3487,6 +3487,12 @@ expanded to last):
| >> `+${define:len,${calc:5+3}}${len}x${len}+` +
== `+8x8+`
| `+${hdata_count:name[list]}+` +
`+${hdata_count:name[pointer]}+` | 4.4.0
| Number of items in a hdata list or starting at `pointer`.
| >> `+${hdata_count:buffer[gui_buffers]}+` +
== `+15+`
| `+${sec.data.name}+` |
| Value of the secured data `name`.
| >> `+${sec.data.libera_pass}+` +
@@ -6068,7 +6074,8 @@ Funzioni per le tabelle hash.
==== hashtable_new
_WeeChat ≥ 0.3.3._
// TRANSLATION MISSING
_WeeChat ≥ 0.3.3, updated in 4.4.0._
Crea una nuova tabella hash.
@@ -6097,12 +6104,14 @@ Argomenti:
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
* _type_values_: tipo per i valori nella tabella hash:
** _WEECHAT_HASHTABLE_INTEGER_
** _WEECHAT_HASHTABLE_STRING_
** _WEECHAT_HASHTABLE_POINTER_
** _WEECHAT_HASHTABLE_BUFFER_
** _WEECHAT_HASHTABLE_TIME_
** _WEECHAT_HASHTABLE_LONGLONG_ _(WeeChat ≥ 4.4.0)_
// TRANSLATION MISSING
* _callback_hash_key_: callback used to "hash" a key (key as integer value), can
be NULL if key type is not "buffer" (a default hash function is used),
@@ -6472,12 +6481,16 @@ Argomenti:
*** _pointer_: puntatore
*** _buffer_: buffer
*** _time_: tempo
// TRANSLATION MISSING
*** _longlong_: long long integer
** _type_values_: tipo per i valori:
*** _integer_: intero
*** _string_: stringa
*** _pointer_: puntatore
*** _buffer_: buffer
*** _time_: tempo
// TRANSLATION MISSING
*** _longlong_: long long integer
** _keys_: stringa con la lista di chiavi (formato: "chiave1,chiave2,chiave3")
** _keys_sorted_: stringa con l'elenco di chiavi ordinate (formato: "chiave1,chiave2,chiave3")
** _values_: stringa con la lista di valori (formato: "valore1,valore2,valore3")
@@ -11530,7 +11543,7 @@ hook2 = weechat.hook_url("http://localhost:8080/", options, 20000, "my_url_cb",
==== hook_connect
// TRANSLATION MISSING
_Updated in 1.5, 2.0._
_Updated in 1.5, 2.0, 4.4.0._
Hook su una connessione (connessione in secondo piano ad un host remoto).
@@ -11566,7 +11579,13 @@ Argomenti:
* _address_: nome o indirizzo IP al quale connettersi
* _port_: numero della porta
// TRANSLATION MISSING
* _ipv6_: 1 to use IPv6 (with fallback to IPv4), 0 to use only IPv4
* _ipv6_:
// TRANSLATION MISSING
** `WEECHAT_HOOK_CONNECT_IPV6_DISABLE` ^(1)^: disable IPv6 (use only IPv4)
// TRANSLATION MISSING
** `WEECHAT_HOOK_CONNECT_IPV6_AUTO` ^(1)^: use IPv6 with fallback to IPv4
// TRANSLATION MISSING
** `WEECHAT_HOOK_CONNECT_IPV6_FORCE` ^(1)^: force IPv6 (do not use IPv4) _(WeeChat ≥ 4.4.0)_
// TRANSLATION MISSING
* _retry_: retry count, used to fallback to IPv4 hosts if IPv6 hosts connect
but then fail to accept the client
@@ -11589,7 +11608,7 @@ Argomenti:
successo oppure no, argomenti e valore restituito:
** _const void *pointer_: puntatore
** _void *data_: puntatore
** _int status_: stato della connessione:
** _int status_: stato della connessione ^(2)^:
*** _WEECHAT_HOOK_CONNECT_OK_: connessione avvenuta con successo
*** _WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND_: indirizzo non trovato
*** _WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND_: indirizzo IP non trovato
@@ -11601,8 +11620,8 @@ Argomenti:
*** _WEECHAT_HOOK_CONNECT_MEMORY_ERROR_: memoria insufficiente
*** _WEECHAT_HOOK_CONNECT_TIMEOUT_: timeout
*** _WEECHAT_HOOK_CONNECT_SOCKET_ERROR_: errore nella creazione socket
** _gnutls_rc_: valore del risultato di _gnutls_handshake()_
** _sock_: socket utilizzato per la connessione
** _gnutls_rc_: valore del risultato di _gnutls_handshake()_ ^(2)^
** _sock_: socket utilizzato per la connessione ^(2)^
** _const char *error_: valore del risultato di _gnutls_strerror(gnutls_rc)_
** _const char *ip_address_: indirizzo IP trovato
** valore restituito:
@@ -11614,17 +11633,20 @@ Argomenti:
if not NULL, it must have been allocated with malloc (or similar function)
and it is automatically freed when the hook is deleted
Valore restituito:
* puntatore al nuovo hook, NULL in caso di errore
// TRANSLATION MISSING
[IMPORTANT]
In scripts, with WeeChat ≥ 2.0, the callback arguments _status_, _gnutls_rc_
[NOTE]
^(1)^ Constants for parameter _ipv6_ are available since WeeChat 4.4.0. +
For older releases, allowed values are `1` (use IPv6 with fallback to IPv4) and
`0` (disable IPv6, use only IPv4). +
^(2)^ In scripts, with WeeChat ≥ 2.0, the callback arguments _status_, _gnutls_rc_
and _sock_ are integers (with WeeChat ≤ 1.9, they were strings). +
To be compatible with all versions, it is recommended to convert the argument
to integer before using it, for example in Python: `int(sock)`.
Valore restituito:
* puntatore al nuovo hook, NULL in caso di errore
Esempio in C:
[source,c]
@@ -11674,7 +11696,8 @@ my_connect_cb (const void *pointer, void *data, int status, int gnutls_rc,
struct t_hook *my_connect_hook = weechat_hook_connect (NULL,
"my.server.org", 1234,
1, 0,
WEECHAT_HOOK_CONNECT_IPV6_AUTO,
0,
NULL, NULL, 0, /* GnuTLS */
NULL,
&my_connect_cb, NULL, NULL);
@@ -11690,31 +11713,32 @@ def hook_connect(proxy: str, address: str, port: int, ipv6: int, retry: int, loc
# esempio
def my_connect_cb(data: str, status: int, gnutls_rc: int, sock: int, error: str, ip_address: str) -> int:
if status == WEECHAT_HOOK_CONNECT_OK:
if status == weechat.WEECHAT_HOOK_CONNECT_OK:
# ...
elif status == WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
elif status == weechat.WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND:
# ...
elif status == WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
elif status == weechat.WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED:
# ...
elif status == WEECHAT_HOOK_CONNECT_PROXY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_PROXY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_MEMORY_ERROR:
# ...
elif status == WEECHAT_HOOK_CONNECT_TIMEOUT:
elif status == weechat.WEECHAT_HOOK_CONNECT_TIMEOUT:
# ...
elif status == WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
elif status == weechat.WEECHAT_HOOK_CONNECT_SOCKET_ERROR:
# ...
return weechat.WEECHAT_RC_OK
hook = weechat.hook_connect("", "my.server.org", 1234, 1, 0, "",
hook = weechat.hook_connect("", "my.server.org", 1234,
weechat.WEECHAT_HOOK_CONNECT_IPV6_AUTO, 0, "",
"my_connect_cb", "")
----
@@ -12605,6 +12629,11 @@ List of signals sent by WeeChat and plugins:
| Puntatore: riga.
| Riga aggiunta in un buffer.
// TRANSLATION MISSING
| weechat | [[hook_signal_buffer_line_data_changed]] buffer_line_data_changed | 4.4.0
| Pointer: line data.
| Line data has been updated in a buffer.
| weechat | [[hook_signal_buffer_lines_hidden]] buffer_lines_hidden |
| Puntatore: buffer.
| Righe nascoste nel buffer.
@@ -12652,6 +12681,11 @@ List of signals sent by WeeChat and plugins:
| Pointer: buffer.
| Modes of buffer changed.
// TRANSLATION MISSING
| weechat | [[hook_signal_buffer_time_for_each_line_changed]] buffer_time_for_each_line_changed | 4.4.0
| Pointer: buffer.
| Display time for each line changed.
| weechat | [[hook_signal_buffer_type_changed]] buffer_type_changed |
| Puntatore: buffer.
| Tipo di buffer modificato.
@@ -12776,6 +12810,16 @@ List of signals sent by WeeChat and plugins:
| String: key combo.
| Key combo in _cursor_ context.
// TRANSLATION MISSING
| weechat | [[hook_signal_layout_buffers_applied]] layout_buffers_applied | 4.4.0
| String: layout name.
| Layout applied for buffers.
// TRANSLATION MISSING
| weechat | [[hook_signal_layout_windows_applied]] layout_windows_applied | 4.4.0
| String: layout name.
| Layout applied for windows.
// TRANSLATION MISSING
| weechat | [[hook_signal_mouse_enabled]] mouse_enabled | 1.1
| -
@@ -15279,7 +15323,6 @@ Argomenti:
** _number_: numero del buffer (inizia da 1)
** _layout_number_: numero del buffer salvato nel layout
** _layout_number_merge_order_: ordine di unione per i layout
** _short_name_is_set_: 1 se il nome breve è impostato, 0 in caso contrario
** _type_: tipo dibuffer (0: formattato, 1: contenuto libero)
** _notify_: livello di notifica per il buffer
** _num_displayed_: numero delle finestre che visualizzano il buffer
@@ -15490,7 +15533,7 @@ Esempio in C:
[source,c]
----
weechat_printf (NULL, "plugin pointer of my buffer: %lx",
weechat_printf (NULL, "plugin pointer of my buffer: %p",
weechat_buffer_get_pointer (my_buffer, "plugin"));
----
@@ -15942,6 +15985,50 @@ if buffer:
weechat.prnt("", "%d" % weechat.buffer_match_list(buffer, "irc.oftc.*,python.*")) # 0
----
// TRANSLATION MISSING
[[buffer_lines]]
=== Buffer lines
// TRANSLATION MISSING
Functions for buffer lines.
==== line_search_by_id
_WeeChat ≥ 4.4.0._
// TRANSLATION MISSING
Search line in buffer by identifier.
Prototipo:
[source,c]
----
struct t_gui_line *weechat_line_search_by_id (struct t_gui_buffer *buffer, int id);
----
Valore restituito:
// TRANSLATION MISSING
* pointer to line found, NULL if not found
Esempio in C:
[source,c]
----
struct t_gui_line *line = weechat_line_search_by_id (buffer, 123);
----
Script (Python):
[source,python]
----
# prototipo
def line_search_by_id(buffer: str, line_id: int) -> str: ...
# esempio
line = weechat.line_search_by_id(buffer, 123)
----
[[windows]]
=== Finestre
@@ -16007,7 +16094,7 @@ Esempio in C:
[source,c]
----
weechat_printf (NULL,
"window displaying core buffer: %lx",
"window displaying core buffer: %p",
weechat_window_search_with_buffer (weechat_buffer_search_main ()));
----
@@ -16147,7 +16234,7 @@ Esempio in C:
[source,c]
----
weechat_printf (NULL,
"buffer displayed in current window: %lx",
"buffer displayed in current window: %p",
weechat_window_get_pointer (weechat_current_window (), "buffer"));
----
@@ -20163,7 +20250,7 @@ Esempio in C:
----
struct t_hdata *hdata = weechat_hdata_get ("buffer");
struct t_gui_buffer *buffer = weechat_buffer_search_main ();
weechat_printf (NULL, "lines = %lx", weechat_hdata_pointer (hdata, buffer, "lines"));
weechat_printf (NULL, "lines = %p", weechat_hdata_pointer (hdata, buffer, "lines"));
----
Script (Python):

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