diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2023-06-03 17:08:17 +0200 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2023-06-03 17:08:17 +0200 |
commit | dd4eb80e81a5db8bda4a5a8fbe2a59d81cca025a (patch) | |
tree | 3b0f4a17243b57a58b5929f9398af9d0b2b9dd4b /doc/en | |
parent | 498aa3256fcc375424d228a885b7c411436ffbaf (diff) | |
download | weechat-dd4eb80e81a5db8bda4a5a8fbe2a59d81cca025a.zip |
doc: fix formatting issues with links that target a blank window
Diffstat (limited to 'doc/en')
-rw-r--r-- | doc/en/weechat_dev.en.adoc | 26 | ||||
-rw-r--r-- | doc/en/weechat_faq.en.adoc | 46 | ||||
-rw-r--r-- | doc/en/weechat_plugin_api.en.adoc | 26 | ||||
-rw-r--r-- | doc/en/weechat_quickstart.en.adoc | 4 | ||||
-rw-r--r-- | doc/en/weechat_relay_protocol.en.adoc | 16 | ||||
-rw-r--r-- | doc/en/weechat_scripting.en.adoc | 22 | ||||
-rw-r--r-- | doc/en/weechat_user.en.adoc | 146 |
7 files changed, 143 insertions, 143 deletions
diff --git a/doc/en/weechat_dev.en.adoc b/doc/en/weechat_dev.en.adoc index ff116c415..48c9cdf1b 100644 --- a/doc/en/weechat_dev.en.adoc +++ b/doc/en/weechat_dev.en.adoc @@ -6,7 +6,7 @@ This manual documents WeeChat chat client, it is part of WeeChat. Latest version of this document can be found on -https://weechat.org/doc/[this page ^↗^,window=_blank]. +https://weechat.org/doc/[this page ^↗^^]. [[introduction]] == Introduction @@ -26,7 +26,7 @@ This manual documents WeeChat internals: == Repositories WeeChat repositories are on GitHub organization -https://github.com/weechat[weechat ^↗^,window=_blank]. +https://github.com/weechat[weechat ^↗^^]. List of repositories: @@ -37,7 +37,7 @@ scripts:: the _official_ scripts submitted on weechat.org weechat.org:: - source of https://weechat.org/[WeeChat website ^↗^,window=_blank] + source of https://weechat.org/[WeeChat website ^↗^^] weercd:: IRC testing server @@ -475,13 +475,13 @@ Documentation files: |    docinfo.html | Asciidoctor style. |    XX/ | Documentation for language XX (languages: en, fr, de, it, ...). |       weechat.1.XX.adoc | Man page (`man weechat`). -|       weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide ^↗^,window=_blank] (this document). -|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^,window=_blank]. -|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^,window=_blank]. -|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank]. -|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^,window=_blank] (for remote interfaces). -|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^,window=_blank]. -|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^,window=_blank]. +|       weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide ^↗^^] (this document). +|       weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^^]. +|       weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^]. +|       weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^^]. +|       weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces). +|       weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^^]. +|       weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^^]. |       includes/ | Files included in documentation. |          cmdline_options.XX.adoc | Command-line options (file included in man pages and user's guide). |          man.XX.adoc | Part of man pages: plugin options, files and copyright. @@ -735,7 +735,7 @@ new_hook_fd = malloc (sizeof (*new_hook_fd)); [[coding_python_style]] === Python style -See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank]. +See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^^]. [[core_internals]] == Core internals @@ -1117,7 +1117,7 @@ server->hook_timer_sasl = weechat_hook_timer (timeout * 1000, [[git_repository]] === Git repository -Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank]. +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 is a GitHub pull request. A patch can also be sent by e-mail @@ -1264,7 +1264,7 @@ $ make translations && make update-po Then you can edit .po files (if you can translate in a language). When done, you *have* to check your file with -https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]: +https://github.com/flashcode/msgcheck[msgcheck ^↗^^]: ---- $ msgcheck.py xx.po diff --git a/doc/en/weechat_faq.en.adoc b/doc/en/weechat_faq.en.adoc index a8c2d73ab..052374675 100644 --- a/doc/en/weechat_faq.en.adoc +++ b/doc/en/weechat_faq.en.adoc @@ -21,7 +21,7 @@ apply to WeeChat!). Because WeeChat is very light and brings innovating features. More info on the WeeChat -https://weechat.org/about/features/[features page ^↗^,window=_blank]. +https://weechat.org/about/features/[features page ^↗^^]. [[compilation_install]] == Compilation / install @@ -30,14 +30,14 @@ https://weechat.org/about/features/[features page ^↗^,window=_blank]. === I've heard about many GUIs for WeeChat. How can I compile/use them? Some remote GUIs are available, see the -https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank]. +https://weechat.org/about/interfaces/[remote interfaces page ^↗^^]. [[compile_git]] === I can't compile WeeChat after cloning git repository, why? WeeChat must be compiled with CMake. -Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank] +Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^] and ensure all required dependencies are installed. If you still have issues, please report them to the developers. @@ -45,7 +45,7 @@ If you still have issues, please report them to the developers. [[compile_macos]] === How can I install WeeChat on macOS? -It is recommended to use https://brew.sh/[Homebrew ^↗^,window=_blank], +It is recommended to use https://brew.sh/[Homebrew ^↗^^], you can get help with: ---- @@ -62,12 +62,12 @@ brew install weechat === I've launched WeeChat, but I'm lost, what can I do? For help you can type `/help`. For help about a command, type `/help command`. -link:weechat_user.en.html#key_bindings[Keys ^↗^,window=_blank] and -link:weechat_user.en.html#commands_and_options[commands ^↗^,window=_blank] +link:weechat_user.en.html#key_bindings[Keys ^↗^^] and +link:weechat_user.en.html#commands_and_options[commands ^↗^^] are listed in documentation. It's recommended for new users to read the -link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank]. +link:weechat_quickstart.en.html[Quickstart guide ^↗^^]. [[display]] == Display @@ -95,7 +95,7 @@ It's a common issue with a variety of causes, please read carefully and check ** If you are using screen, check that it is run with UTF-8 mode ("`defutf8 on`" in ~/.screenrc or `screen -U` to run screen). * Check that option - link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank] + link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^] is off (this option may cause display bugs). [NOTE] @@ -110,9 +110,9 @@ This may be caused by a libc bug in function _wcwidth_, which should be fixed in glibc 2.22 (maybe not yet available in your distribution). There is a workaround to use the fixed _wcwidth_ function: -https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank] +https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^] -See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank] +See this https://github.com/weechat/weechat/issues/79[bug report ^↗^^] for more information. [[bars_background]] @@ -170,7 +170,7 @@ windows. [[buffers_list]] === How to display the buffers list on the left side? -The plugin link:weechat_user.en.html#buflist[buflist ^↗^,window=_blank] +The plugin link:weechat_user.en.html#buflist[buflist ^↗^^] is loaded and enabled by default. To limit size of bar: @@ -216,7 +216,7 @@ like `237` for dark gray. The buflist plugin provides lot of options that you can customize, please read the help on each option. -There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank] +There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^] with examples of advanced buflist configuration. [[customize_prefix]] @@ -260,7 +260,7 @@ These colors can be changed with the options __weechat.color.status_data_*__ (buffers) and __weechat.color.status_count_*__ (counters). + Other hotlist options can be changed with the options __weechat.look.hotlist_*__. -See link:weechat_user.en.html#screen_layout[User's guide / Screen layout ^↗^,window=_blank] +See link:weechat_user.en.html#screen_layout[User's guide / Screen layout ^↗^^] for more info about the hotlist. [[input_bar_size]] @@ -420,7 +420,7 @@ you can change it with these two commands: You can use any color number in options (optional: you can add color aliases with command `/color`). -Please read the link:weechat_user.en.html#colors[User's guide / Colors ^↗^,window=_blank] +Please read the link:weechat_user.en.html#colors[User's guide / Colors ^↗^^] for more information about colors management. [[search_text]] @@ -429,7 +429,7 @@ for more information about colors management. The default key is kbd:[Ctrl+r] (command is: `+/input search_text_here+`). And jump to highlights: kbd:[Alt+p] / kbd:[Alt+n]. -See link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank] +See link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^^] for more info about this feature. [[terminal_focus]] @@ -603,7 +603,7 @@ You can bind a key, for example: ---- List of default keys is in -link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank]. +link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^^]. To jump to buffers with number ≥ 100, you could define a trigger and then use commands like `/123` to jump to buffer #123: @@ -821,7 +821,7 @@ disable filters (by default, the key kbd:[Alt+=] toggles filters). [[filter_irc_join_part_quit]] === How can I filter join/part/quit and other annoying messages on IRC channels? -See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank]. +See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^]. [[filter_irc_join_channel_messages]] === How can I filter some messages displayed when I join an IRC channel? @@ -915,7 +915,7 @@ Other scripts on this subject: === How can I disable highlights for specific nicks? You can use the -link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank] +link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^] buffer property to set the max hotlist level for some nicks, per buffer, or per group of buffers (like IRC servers). @@ -1114,7 +1114,7 @@ Unload and disable auto-loading of "xfer" plugin (used for IRC DCC): Define a passphrase and use secured data wherever you can for sensitive data like passwords: see `/help secure` and `/help` on options (if you can use secured data, it is written in the help). -See also link:weechat_user.en.html#secured_data[User's guide / Secured data ^↗^,window=_blank]. +See also link:weechat_user.en.html#secured_data[User's guide / Secured data ^↗^^]. For example: @@ -1135,7 +1135,7 @@ contains your passwords ciphered with your passphrase. Some other files may contain sensitive info like passwords (if they are not stored in _sec.conf_ with the `/secure` command). -See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories ^↗^,window=_blank] +See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories ^↗^^] for more information about configuration files. [[development]] @@ -1144,7 +1144,7 @@ for more information about configuration files. [[bug_task_patch]] === How should I report bugs, ask for new features or send patches? -See https://weechat.org/about/support/[this page ^↗^,window=_blank]. +See https://weechat.org/about/support/[this page ^↗^^]. [[gdb_error_threads]] === When I run WeeChat under gdb, there is an error about threads, what can I do? @@ -1181,10 +1181,10 @@ some OS' we don't have, to test WeeChat. There are many tasks to do (testing, code, documentation, etc.) Please contact us via IRC or mail, look at -https://weechat.org/about/support/[support page ^↗^,window=_blank]. +https://weechat.org/about/support/[support page ^↗^^]. [[donate]] === Can I give money or other things to WeeChat developers? You can give us money to help development. -Details on https://weechat.org/donate/[donation page ^↗^,window=_blank]. +Details on https://weechat.org/donate/[donation page ^↗^^]. diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc index a8854b94c..b450ef8d2 100644 --- a/doc/en/weechat_plugin_api.en.adoc +++ b/doc/en/weechat_plugin_api.en.adoc @@ -6,7 +6,7 @@ This manual documents WeeChat chat client, it is part of WeeChat. Latest version of this document can be found on -https://weechat.org/doc/[this page ^↗^,window=_blank]. +https://weechat.org/doc/[this page ^↗^^]. [[introduction]] == Introduction @@ -279,7 +279,7 @@ Functions to register a script: used only by scripting API, not the C API. Register the script. For more information, see the -link:weechat_scripting.en.html#register_function[WeeChat scripting guide ^↗^,window=_blank]. +link:weechat_scripting.en.html#register_function[WeeChat scripting guide ^↗^^]. Script (Python): @@ -1978,7 +1978,7 @@ Split a string like the shell does for a command with arguments. This function is a C conversion of Python class "shlex" (file: Lib/shlex.py in Python repository), see -https://docs.python.org/3/library/shlex.html[this page ^↗^,window=_blank]. +https://docs.python.org/3/library/shlex.html[this page ^↗^^]. Prototype: @@ -3822,7 +3822,7 @@ The result is the return value of function `wcwidth` (see `man wcwidth`), with exception for the following chars, that have a specific behavior in WeeChat: * U+0009 (Tabulation): value of option - link:weechat_user.en.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank] + link:weechat_user.en.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^] * U+0001 (1) to U+001F (31), except U+0009 (Tabulation): 1 * U+00AD (173, soft hyphen): -1 * U+200B (8203, zero width space): -1 @@ -7113,7 +7113,7 @@ option5 = weechat.config_new_option(config_file, section, "option5", "color", [NOTE] In Ruby, the 3 callbacks + data (6 strings) must be given in an array of 6 strings (due to a Ruby limitation of 15 arguments by function), see the -link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank] +link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^^] for more info _(fixed in version 0.4.1)_. ==== config_search_option @@ -9186,7 +9186,7 @@ Arguments: * _tags_: comma separated list of tags (NULL means no tags) * _message_: message to display -See the link:weechat_user.en.html#lines_tags[WeeChat user's guide / Lines tags ^↗^,window=_blank] +See the link:weechat_user.en.html#lines_tags[WeeChat user's guide / Lines tags ^↗^^] for a list of commonly used tags in WeeChat. C example: @@ -9975,7 +9975,7 @@ In scripting API, the function _name_ is called directly and its result [TIP] If you want to retrieve infos about WeeChat (like current stable version, latest git commit, etc.), you can use URLs on -https://weechat.org/dev/info/[this page ^↗^,window=_blank]. +https://weechat.org/dev/info/[this page ^↗^^]. [NOTE] Buffer size for sending data to callback is 64KB (there are 2 buffers: one for @@ -12538,13 +12538,13 @@ List of modifiers defined by WeeChat and plugins that can be used: | - | Any string. | String with IRC tag value escaped, - see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank]. + see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^]. | [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3 | - | Any string. | String with IRC tag value unescaped, - see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank]. + see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^]. | [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0 | "1" to keep colors, "0" to remove colors @@ -15684,7 +15684,7 @@ Arguments: ** _inactive_: bar is displayed in inactive windows only ** _nicklist_: bar is displayed in windows with nicklist ** evaluated expression: see the - link:weechat_user.en.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^,window=_blank] + link:weechat_user.en.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^^] * _position_: _top_, _bottom_, _left_ or _right_ * _filling_top_bottom_: ** _horizontal_: items are filled horizontally (space after each item) @@ -15746,7 +15746,7 @@ bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg, color_bg_inactive) must be given in an array of 4 strings (due to a Ruby limitation of 15 arguments by function), see the -link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank] +link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^^] for more info. ==== bar_set @@ -16439,7 +16439,7 @@ if (hashtable_in) ---- [NOTE] -See the link:weechat_scripting.en.html#irc_message_parse[WeeChat scripting guide / Parse message ^↗^,window=_blank] +See the link:weechat_scripting.en.html#irc_message_parse[WeeChat scripting guide / Parse message ^↗^^] for more info about "irc_message_parse" output. Script (Python): @@ -18080,7 +18080,7 @@ Arguments: * _search_: expression to evaluate, default pointer in expression is the name of hdata (and this pointer changes for each element in list); for help on expression, see the - link:weechat_user.en.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^,window=_blank] + link:weechat_user.en.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^^] * _pointers_: hashtable for call to function <<_string_eval_expression,string_eval_expression>> * _extra_vars_: hashtable for call to function diff --git a/doc/en/weechat_quickstart.en.adoc b/doc/en/weechat_quickstart.en.adoc index cdb1dff47..7b532452d 100644 --- a/doc/en/weechat_quickstart.en.adoc +++ b/doc/en/weechat_quickstart.en.adoc @@ -377,13 +377,13 @@ for example: See `/help script` for more info. A list of scripts is available in WeeChat with `/script` or on -https://weechat.org/scripts/[this page ^↗^,window=_blank]. +https://weechat.org/scripts/[this page ^↗^^]. [[more_doc]] == More documentation You can now use WeeChat and read -https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank] +https://weechat.org/doc/[FAQ/documentation ^↗^^] for any other questions. Enjoy using WeeChat! diff --git a/doc/en/weechat_relay_protocol.en.adoc b/doc/en/weechat_relay_protocol.en.adoc index 0fe44d2d9..0ca1fbf49 100644 --- a/doc/en/weechat_relay_protocol.en.adoc +++ b/doc/en/weechat_relay_protocol.en.adoc @@ -127,8 +127,8 @@ Arguments: if compression is enabled, messages from _relay_ to client are compressed to save bandwidth; allowed values are: *** _off_: no compression (default if option is not given) -*** _zlib_: compress with https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_ -*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]: +*** _zlib_: compress with https://zlib.net/[zlib ^↗^^] _(WeeChat ≥ 0.3.7)_ +*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^^]: better compression and much faster than _zlib_ for both compression and decompression _(WeeChat ≥ 3.5)_ @@ -170,8 +170,8 @@ WeeChat replies with a hashtable containing the following keys and values: in the password hash algorithm) * _compression_: compression type: ** _off_: messages are not compressed -** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^,window=_blank] -** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] +** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^^] +** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^^] [TIP] With WeeChat ≤ 2.8, the command _handshake_ is not implemented, WeeChat silently @@ -1377,8 +1377,8 @@ Messages are sent as binary data, using following format (with size in bytes): (including this field) * _compression_ (byte): flag: ** _0x00_: following data is not compressed -** _0x01_: following data is compressed with https://zlib.net/[zlib ^↗^,window=_blank] -** _0x02_: following data is compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] +** _0x01_: following data is compressed with https://zlib.net/[zlib ^↗^^] +** _0x02_: following data is compressed with https://facebook.github.io/zstd/[Zstandard ^↗^^] * _id_ (string, 4 bytes + content): identifier sent by client (before command name); it can be empty (string with zero length and no content) if no identifier was given in command @@ -1389,8 +1389,8 @@ Messages are sent as binary data, using following format (with size in bytes): === Compression If flag _compression_ is equal to 0x01 or 0x02, then *all* data after is compressed -with https://zlib.net/[zlib ^↗^,window=_blank] or -https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank], +with https://zlib.net/[zlib ^↗^^] or +https://facebook.github.io/zstd/[Zstandard ^↗^^], and therefore must be uncompressed before being processed. [[message_identifier]] diff --git a/doc/en/weechat_scripting.en.adoc b/doc/en/weechat_scripting.en.adoc index 40251446c..824cb4dd0 100644 --- a/doc/en/weechat_scripting.en.adoc +++ b/doc/en/weechat_scripting.en.adoc @@ -6,7 +6,7 @@ This manual documents WeeChat chat client, it is part of WeeChat. Latest version of this document can be found on -https://weechat.org/doc/[this page ^↗^,window=_blank]. +https://weechat.org/doc/[this page ^↗^^]. [[introduction]] == Introduction @@ -54,7 +54,7 @@ function, this can crash WeeChat. + If something must be run in background, the function `+hook_process+` can be used. See example in the chapter <<hook_process,Run a background process>> and the documentation on the function `+hook_process+` in the -link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank]. +link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^]. [[languages_specificities]] === Languages specificities @@ -67,7 +67,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 ^↗^,window=_blank]. +https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^]. [[python_functions]] ===== Functions @@ -102,7 +102,7 @@ receive a string of type `str` or `bytes` (this list is not exhaustive): It is recommended to use modifier `+irc_in2_yyy+` instead, the string received is always UTF-8 valid. + See function `+hook_modifier+` in the - link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference ^↗^,window=_blank]. + link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference ^↗^^]. | hook_signal | xxx,irc_out_yyy + @@ -117,7 +117,7 @@ receive a string of type `str` or `bytes` (this list is not exhaustive): It is recommended to use signal `+xxx,irc_out1_yyy+` instead, the string received is always UTF-8 valid. + See function `+hook_signal+` in the - link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference ^↗^,window=_blank]. + link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference ^↗^^]. | hook_process + hook_process_hashtable @@ -198,7 +198,7 @@ You can pass this constant when a function accepts null as an argument and you will get it as the value of an argument in a callback function if the argument value is null. To see which functions accept null values and passes null values to callbacks, look at the Python prototypes in the -link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank]. +link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^]. [[language_guile]] ==== Guile (Scheme) @@ -375,7 +375,7 @@ directory is automatically created. == Differences with C API Script API is almost the same as C plugin API. -You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank] +You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^] for detail about each function in API: prototype, arguments, return values, examples. It's important to make difference between a _plugin_ and a _script_: a @@ -542,7 +542,7 @@ weechat_hook_timer(1000, 0, 1, $timer_cb, 'test'); == Script API For more information about functions in API, please read the -link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank]. +link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^]. [[script_api_functions]] === Functions @@ -864,7 +864,7 @@ List of constants in script API: This chapter shows some common tasks, with examples. Only partial things in API are used here, for full reference, see the -link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank]. +link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^]. [[buffers]] === Buffers @@ -1134,7 +1134,7 @@ weechat.hook_process("url:https://weechat.org/dev/info/stable/", [TIP] All infos available about WeeChat are on -https://weechat.org/dev/info/[this page ^↗^,window=_blank]. +https://weechat.org/dev/info/[this page ^↗^^]. Example of URL transfer with an option: download latest WeeChat development package in file _/tmp/weechat-devel.tar.gz_: @@ -1153,7 +1153,7 @@ weechat.hook_process_hashtable("url:https://weechat.org/files/src/weechat-devel. For more information about URL transfer and available options, see functions `+hook_process+` and `+hook_process_hashtable+` in -link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank]. +link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^]. [[config_options]] === Config / options diff --git a/doc/en/weechat_user.en.adoc b/doc/en/weechat_user.en.adoc index fdce4e3af..006e238f5 100644 --- a/doc/en/weechat_user.en.adoc +++ b/doc/en/weechat_user.en.adoc @@ -6,7 +6,7 @@ This manual documents WeeChat chat client, it is part of WeeChat. Latest version of this document can be found on -https://weechat.org/doc/[this page ^↗^,window=_blank]. +https://weechat.org/doc/[this page ^↗^^]. [[introduction]] == Introduction @@ -24,18 +24,18 @@ Main features are: * small, fast and light * customizable and extensible with plugins and scripts * compliant with IRC RFCs - https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank], - https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank], - https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank], - https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank], - https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] and - https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank] + 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 ^↗^^] * IRC proxy and relay for remote interfaces * multi-platform (GNU/Linux, *BSD, macOS, Windows and other) * 100% GPL, free software The list of all features can be found on -https://weechat.org/about/features/[this page ^↗^,window=_blank]. +https://weechat.org/about/features/[this page ^↗^^]. [[prerequisites]] === Prerequisites @@ -60,7 +60,7 @@ Binary packages are available for many distributions, including: * Debian/Ubuntu (or any Debian compatible distribution): `apt-get install weechat-curses weechat-plugins` + For latest versions and nightly builds: - https://weechat.org/download/debian/[Debian repositories ^↗^,window=_blank] + https://weechat.org/download/debian/[Debian repositories ^↗^^] * Fedora Core: `dnf install weechat` * FreeBSD: `pkg install weechat` * Gentoo: `emerge weechat` @@ -68,7 +68,7 @@ Binary packages are available for many distributions, including: `rpm -i /path/to/weechat-x.y.z-1.i386.rpm` * openSUSE: `zypper in weechat` * Sourcemage: `cast weechat` -* macOS (with https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat` +* macOS (with https://brew.sh/[Homebrew ^↗^^]): `brew install weechat` (for help: `brew info weechat`) Some additional packages may be useful, like weechat-plugins. @@ -80,9 +80,9 @@ instructions. === Containers Containers with WeeChat can be built or installed directly from the -https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. + +https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. + For more information, see the README in the -https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank] +https://github.com/weechat/weechat-container[weechat-container ^↗^^] repository. [[source_package]] @@ -91,7 +91,7 @@ repository. WeeChat must be built with CMake. [NOTE] -On macOS, you can use https://brew.sh/[Homebrew ^↗^,window=_blank]: +On macOS, you can use https://brew.sh/[Homebrew ^↗^^]: `brew install --build-from-source weechat`. [[dependencies]] @@ -128,12 +128,12 @@ WeeChat: | zlib1g-dev | | Logger plugin: compression of rotated log files (gzip). + - Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^,window=_blank] (weechat protocol). + + Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). + Script plugin: read of repository index file (gzip). | libzstd-dev | ≥ 0.8.1 | Logger plugin: compression of rotated log files. + - Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat protocol). + Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol). |=== [NOTE] @@ -456,7 +456,7 @@ directory where WeeChat is installed!). On some systems like Archlinux, core dumps could be in another directory like _/var/lib/systemd/coredump_ and you must use the command `coredumpctl` to read it. + For more information, see this -https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^,window=_blank]. +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: @@ -610,7 +610,7 @@ you can change it with these two commands: ==== XDG directories WeeChat uses XDG directories by default (according to the -https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). + +https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). + A single home directory for all files can be forced by CMake option `WEECHAT_HOME`, the environment variable `WEECHAT_HOME` or the command-line option `-d` / `--dir`. @@ -751,7 +751,7 @@ $ weechat --upgrade ==== Release notes After an upgrade, it is *strongly recommended* to read the -https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^,window=_blank] +https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^] which contain important information about breaking changes and some manual actions that could be required. @@ -2066,7 +2066,7 @@ To see all charsets used, use following command: ==== Troubleshooting For any problem with charsets, please look at -link:weechat_faq.en.html#charset[WeeChat FAQ / Charset ^↗^,window=_blank]. +link:weechat_faq.en.html#charset[WeeChat FAQ / Charset ^↗^^]. [[charset_commands]] ==== Commands @@ -2405,7 +2405,7 @@ It is possible to define a max size for log files, and when it is reached, there is automatic rotation of log file. The rotated log files can be compressed with gzip or -https://facebook.github.io/zstd/[zstd ^↗^,window=_blank]. +https://facebook.github.io/zstd/[zstd ^↗^^]. [NOTE] As the compression of a file can take some time, it is performed in background. @@ -2501,7 +2501,7 @@ kbd:[Alt] instead of kbd:[Shift]). [NOTE] For any problem with mouse, please look at -link:weechat_faq.en.html#mouse[WeeChat FAQ / Mouse ^↗^,window=_blank]. +link:weechat_faq.en.html#mouse[WeeChat FAQ / Mouse ^↗^^]. [[mouse_bind_events]] ==== Bind mouse events to commands @@ -3204,7 +3204,7 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr By default no servers are defined. You can add as many servers as you want with the <<command_irc_server,/server>> command. -For example to connect to https://libera.chat/[libera.chat ^↗^,window=_blank] +For example to connect to https://libera.chat/[libera.chat ^↗^^] with TLS (encrypted trafic): ---- @@ -3388,7 +3388,7 @@ which can also be for example `~/.weechat`. ---- For more information, please look at -https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank]. +https://www.oftc.net/NickServ/CertFP/[this page ^↗^^]. [[irc_sasl_authentication]] ==== SASL authentication @@ -3492,7 +3492,7 @@ server buffers: [[irc_tor_sasl]] ==== Connect with Tor and SASL -Some servers support connections with https://www.torproject.org/[Tor ^↗^,window=_blank], +Some servers support connections with https://www.torproject.org/[Tor ^↗^^], a network of virtual tunnels that allows people and groups to improve their privacy and security on the Internet. @@ -3540,7 +3540,7 @@ And finally, connect to the server: [[irc_ircv3_support]] === IRCv3 support -WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]: +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^^]: * <<irc_ircv3_account_notify,account-notify>> * <<irc_ircv3_account_tag,account-tag>> @@ -3567,12 +3567,12 @@ automatically enabled (see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>). Tables with comparison of different IRC clients, including WeeChat, are available -on https://ircv3.net/software/clients[this page ^↗^,window=_blank]. +on https://ircv3.net/software/clients[this page ^↗^^]. [[irc_ircv3_account_notify]] ==== account-notify -Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^] This capability allows the server to send messages when users identify or unidentify on the server. + @@ -3591,7 +3591,7 @@ Examples: [[irc_ircv3_account_tag]] ==== account-tag -Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^] This capability allows the server to send account as message tag to commands sent to the client. + @@ -3620,7 +3620,7 @@ Message with tags: [[irc_ircv3_away_notify]] ==== away-notify -Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^] This capability allows the server to send away notifications for users present on the same channels as you. @@ -3635,7 +3635,7 @@ with a specific color in the nicklist, using the following options: [[irc_ircv3_batch]] ==== batch -Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^^] This capability allows the server to send batched events (grouping of several messages that are related). @@ -3646,7 +3646,7 @@ later, when the batch ends. [[irc_ircv3_cap_notify]] ==== cap-notify -Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^] This capability allows the server to advertise on new or removed capabilities on the server (via `CAP NEW` and `CAP DEL` commands). @@ -3662,7 +3662,7 @@ Examples: [[irc_ircv3_chghost]] ==== chghost -Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^] This capability allows the server to send messages when users change name or host. + When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>> @@ -3680,7 +3680,7 @@ Example: [[irc_ircv3_draft_multiline]] ==== draft/multiline -Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^] This capability allows the client and server to send messages with multiple lines, using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well. @@ -3733,7 +3733,7 @@ Display of the message sent in WeeChat: [[irc_ircv3_echo_message]] ==== echo-message -Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^] This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages back to WeeChat. @@ -3746,7 +3746,7 @@ clients connected to the server as well. [[irc_ircv3_extended_join]] ==== extended-join -Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^] This capability allows the server to send account and real name when users join channels. + @@ -3763,7 +3763,7 @@ Example: [[irc_ircv3_invite_notify]] ==== invite-notify -Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^] This capability allows the server to send invite messages when users are invited to channels. @@ -3777,7 +3777,7 @@ Example: [[irc_ircv3_message_tags]] ==== message-tags -Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^] This capability allows to add metadata in messages. + These tags can be displayed using the command `/debug tags`. @@ -3787,7 +3787,7 @@ It must be enabled to use <<typing_notifications,typing notifications>>. [[irc_ircv3_monitor]] ==== monitor -Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^] This capability allows the server to send notifications when clients become online/offline. + @@ -3797,7 +3797,7 @@ WeeChat automatically uses this extension if available when using the [[irc_ircv3_multi_prefix]] ==== multi-prefix -Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^] This capability allows the server to send all user modes at once in <<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. + @@ -3823,14 +3823,14 @@ Example: output of `/whois alice`: [[irc_ircv3_sasl]] ==== SASL -Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^] See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>. [[irc_ircv3_server_time]] ==== server-time -Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^] This capability allows the server to send time for messages as message tag. + When the time is received in a message, WeeChat uses it to display the message @@ -3843,7 +3843,7 @@ in the backlog sent upon connection. [[irc_ircv3_setname]] ==== setname -Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^^] This capability lets you change your real name by using the <<command_irc_setname,/setname>> command. @@ -3851,14 +3851,14 @@ This capability lets you change your real name by using the [[irc_ircv3_typing]] ==== typing -Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank] +Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^^] See the dedicated chapter <<typing_notifications,Typing notifications>>. [[irc_ircv3_userhost_in_names]] ==== userhost-in-names -Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^] This capability allows the server to send hostnames in <<command_irc_names,/names>> responses. @@ -3881,7 +3881,7 @@ Example of raw IRC messages received with the capability: [[irc_ircv3_whox]] ==== WHOX -Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank] +Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^] This capability lets you request additional fields in the WHO response (via the <<command_irc_who,/who>> command). + @@ -4263,7 +4263,7 @@ show a list of users currently typing a message on the buffer. It is used by IRC plugin on channel and private buffers, when the "message-tags" capability is enabled (you can check with <<command_irc_cap,/cap>> command). + Under the hood, typing client tag is used, following -https://ircv3.net/specs/client-tags/typing[this specification ^↗^,window=_blank]. +https://ircv3.net/specs/client-tags/typing[this specification ^↗^^]. [[typing_activation]] === Activation @@ -4355,7 +4355,7 @@ The Relay plugin is used to relay data via network, using different protocols: * _irc_: IRC proxy: used to share connections to IRC servers with one or many other IRC clients * _weechat_: protocol used by remote interfaces to display and interact with - WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^,window=_blank]. + WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^]. [[relay_password]] === Password @@ -4380,12 +4380,12 @@ This is optional and increases the security level. One-time passwords can be generated with applications, for example: * FreeOTP: - https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank], - https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank] - (https://freeotp.github.io/[website ^↗^,window=_blank]) + https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^], + https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^] + (https://freeotp.github.io/[website ^↗^^]) * Google Authenticator: - https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank], - https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank] + https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^], + https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^] The TOTP secret must be set in WeeChat and the application used to generate one-time passwords. @@ -4471,7 +4471,7 @@ commands: The Relay plugin can send data to remote interface using WeeChat protocol. You can connect with a remote interface, see -https://weechat.org/about/interfaces/[this page ^↗^,window=_blank]. +https://weechat.org/about/interfaces/[this page ^↗^^]. [IMPORTANT] WeeChat itself can NOT connect to another WeeChat with this protocol. @@ -4488,7 +4488,7 @@ Now you can connect on port 9000 with a remote interface using password [[relay_websocket]] === WebSocket -WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank]) +WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^]) is supported in Relay plugin for all protocols. The WebSocket handshake is automatically detected and socket becomes ready for @@ -4654,7 +4654,7 @@ circumstances. Using triggers require you to know how the signals, modifiers, ... are working. So you might consider reading the -link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank]. +link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^^]. [[trigger_default]] === Default triggers @@ -4709,7 +4709,7 @@ A trigger has the following options (names are | hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`, `+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+` | The hook used in trigger. For more information, see - link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank]. + link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^^]. | arguments | string | The arguments for the hook, it depends on the hook type used. @@ -4778,14 +4778,14 @@ The arguments depend on the hook used. They are separated by semicolons. | `+*,irc_in_privmsg+` + `+*,irc_in_privmsg;*,irc_in_notice+` + `+signal_sigwinch+` -| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^^] | hsignal | 1. signal name (priority allowed) (required) + 2. signal name (priority allowed) + 3. ... | `+nicklist_nick_added+` -| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^^] | modifier | 1. modifier name (priority allowed) (required) + @@ -4793,7 +4793,7 @@ The arguments depend on the hook used. They are separated by semicolons. 3. ... | `+weechat_print+` + `+5000\|input_text_display;5000\|history_add+` -| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^^] | line | 1. buffer type + @@ -4804,7 +4804,7 @@ The arguments depend on the hook used. They are separated by semicolons. `+*;irc.libera.*+` + `+*;irc.libera.#weechat+` + `+formatted;irc.libera.#weechat;irc_notice+` -| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^^] | print | 1. buffer name + @@ -4815,7 +4815,7 @@ The arguments depend on the hook used. They are separated by semicolons. `+irc.libera.#weechat+` + `+irc.libera.#weechat;irc_notice+` + `+*;;;1+` -| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^^] | command | 1. command name (priority allowed) (required) + @@ -4826,14 +4826,14 @@ The arguments depend on the hook used. They are separated by semicolons. | `+test+` + `+5000\|test+` + `+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+` -| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^^] | command_run | 1. command (priority allowed) (required) + 2. command (priority allowed) + 3. ... | `+/cmd arguments+` -| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^^] | timer | 1. interval in milliseconds (required) + @@ -4841,35 +4841,35 @@ The arguments depend on the hook used. They are separated by semicolons. 3. max number of calls (default: 0, which means "no end") | `+3600000+` + `+60000;0;5+` -| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^^] | config | 1. option name (priority allowed) (required) + 2. option name (priority allowed) + 3. ... | `+weechat.look.*+` -| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^^] | focus | 1. area name (priority allowed) (required) + 2. area name (priority allowed) + 3. ... | `+buffer_nicklist+` -| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^^] | info | 1. info name (priority allowed) (required) + 2. info name (priority allowed) + 3. ... | `+my_info+` -| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^^] | info_hashtable | 1. info name (priority allowed) (required) + 2. info name (priority allowed) + 3. ... | `+my_info+` -| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank] +| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^^] |=== [[trigger_conditions]] @@ -5485,8 +5485,8 @@ Default plugins are: |=== To learn more about plugin or script development (through API), please read the -link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank] or the -link:weechat_scripting.en.html[WeeChat scripting guide ^↗^,window=_blank]. +link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^] or the +link:weechat_scripting.en.html[WeeChat scripting guide ^↗^^]. [[scripts]] === Scripts @@ -5496,7 +5496,7 @@ WeeChat provides 8 scripting plugins: Python, Perl, Ruby, Lua, Tcl, Guile These plugins can load, execute and unload scripts for these languages. For more information about how to write scripts, or WeeChat API for -scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide ^↗^,window=_blank]. +scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide ^↗^^]. [[script_manager]] ==== Script manager @@ -5504,7 +5504,7 @@ scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide The script manager (command <<command_script_script,/script>>) is used to load/unload scripts of any language, and install/remove scripts of WeeChat scripts repository, which are visible on -https://weechat.org/scripts/[this page ^↗^,window=_blank]. +https://weechat.org/scripts/[this page ^↗^^]. For privacy considerations, the download of scripts is disabled by default. + To enable it, type this command: @@ -5733,4 +5733,4 @@ For support with IRC, on server _irc.libera.chat_: ** _#weechat-fi_ (Finnish) For other ways of support, see -https://weechat.org/about/support/[this page ^↗^,window=_blank]. +https://weechat.org/about/support/[this page ^↗^^]. |