diff options
Diffstat (limited to 'doc/en')
-rw-r--r-- | doc/en/weechat_scripting.en.asciidoc | 374 |
1 files changed, 276 insertions, 98 deletions
diff --git a/doc/en/weechat_scripting.en.asciidoc b/doc/en/weechat_scripting.en.asciidoc index 10ecb0c7a..2deff4bed 100644 --- a/doc/en/weechat_scripting.en.asciidoc +++ b/doc/en/weechat_scripting.en.asciidoc @@ -382,85 +382,235 @@ _WeeChat Plugin API Reference_. List of functions in script API: -[width="100%",cols="^1,10",options="header"] +[width="75%",cols="1,3",options="header"] |=== -| Category | Functions -| general | +| Category | Functions + +| general | register -| plugins | + +| plugins | plugin_get_name -| strings | - charset_set, iconv_to_internal, iconv_from_internal, gettext, ngettext, + - strlen_screen, string_match, string_has_highlight, string_has_highlight_regex, - string_mask_to_regex, string_remove_color, string_is_command_char, - string_input_for_buffer, string_eval_expression, string_eval_path_home -| directories | - mkdir_home, mkdir, mkdir_parents -| sorted lists | - list_new, list_add, list_search, list_search_pos, list_casesearch, - list_casesearch_pos, list_get, list_set, list_next, list_prev, list_string, - list_size, list_remove, list_remove_all, list_free + +| strings | + charset_set + + iconv_to_internal + + iconv_from_internal + + gettext + + ngettext + + strlen_screen + + string_match + + string_has_highlight + + string_has_highlight_regex + + string_mask_to_regex + + string_remove_color + + string_is_command_char + + string_input_for_buffer + + string_eval_expression + + string_eval_path_home + +| directories | + mkdir_home + + mkdir + + mkdir_parents + +| sorted lists | + list_new + + list_add + + list_search + + list_search_pos + + list_casesearch + + list_casesearch_pos + + list_get + + list_set + + list_next + + list_prev + + list_string + + list_size + + list_remove + + list_remove_all + + list_free + | configuration files | - config_new, config_new_section, config_search_section, config_new_option, - config_search_option, + - config_string_to_boolean, config_option_reset, config_option_set, - config_option_set_null, config_option_unset, config_option_rename, - config_option_is_null, config_option_default_is_null, + - config_boolean, config_boolean_default, config_integer, config_integer_default, - config_string, config_string_default, config_color, config_color_default, + - config_write_option, config_write_line, config_write, config_read, - config_reload, + - config_option_free, config_section_free_options, config_section_free, - config_free, + - config_get, config_get_plugin, config_is_set_plugin, config_set_plugin, - config_set_desc_plugin, config_unset_plugin -| key bindings | - key_bind, key_unbind -| display | - prefix, color, print (for python: prnt), print_date_tags (for python: - prnt_date_tags), print_y (for python: prnt_y), log_print -| hooks | - hook_command, hook_command_run, hook_timer, hook_fd, hook_process, - hook_process_hashtable, hook_connect, hook_print, hook_signal, - hook_signal_send, hook_hsignal, hook_hsignal_send, hook_config, - hook_completion, hook_completion_list_add, hook_modifier, hook_modifier_exec, - hook_info, hook_info_hashtable, hook_infolist, hook_focus, hook_set, unhook, + config_new + + config_new_section + + config_search_section + + config_new_option + + config_search_option + + config_string_to_boolean + + config_option_reset + + config_option_set + + config_option_set_null + + config_option_unset + + config_option_rename + + config_option_is_null + + config_option_default_is_null + + config_boolean + + config_boolean_default + + config_integer + + config_integer_default + + config_string + + config_string_default + + config_color + + config_color_default + + config_write_option + + config_write_line + + config_write + + config_read + + config_reload + + config_option_free + + config_section_free_options + + config_section_free + + config_free + + config_get + + config_get_plugin + + config_is_set_plugin + + config_set_plugin + + config_set_desc_plugin + + config_unset_plugin + +| key bindings | + key_bind + + key_unbind + +| display | + prefix + + color + + print (for python: prnt) + + print_date_tags (for python: + prnt_date_tags) + + print_y (for python: prnt_y) + + log_print + +| hooks | + hook_command + + hook_command_run + + hook_timer + + hook_fd + + hook_process + + hook_process_hashtable + + hook_connect + + hook_print + + hook_signal + + hook_signal_send + + hook_hsignal + + hook_hsignal_send + + hook_config + + hook_completion + + hook_completion_list_add + + hook_modifier + + hook_modifier_exec + + hook_info + + hook_info_hashtable + + hook_infolist + + hook_focus + + hook_set + + unhook + unhook_all -| buffers | - buffer_new, current_buffer, buffer_search, buffer_search_main, buffer_clear, - buffer_close, buffer_merge, buffer_unmerge, buffer_get_integer, - buffer_get_string, buffer_get_pointer, buffer_set, - buffer_string_replace_local_var, buffer_match_list -| windows | - current_window, window_search_with_buffer, window_get_integer, - window_get_string, window_get_pointer, window_set_title -| nicklist | - nicklist_add_group, nicklist_search_group, nicklist_add_nick, - nicklist_search_nick, nicklist_remove_group, nicklist_remove_nick, - nicklist_remove_all, nicklist_group_get_integer, nicklist_group_get_string, - nicklist_group_get_pointer, nicklist_group_set, nicklist_nick_get_integer, - nicklist_nick_get_string, nicklist_nick_get_pointer, nicklist_nick_set -| bars | - bar_item_search, bar_item_new, bar_item_update, bar_item_remove, bar_search, - bar_new, bar_set, bar_update, bar_remove -| commands | + +| buffers | + buffer_new + + current_buffer + + buffer_search + + buffer_search_main + + buffer_clear + + buffer_close + + buffer_merge + + buffer_unmerge + + buffer_get_integer + + buffer_get_string + + buffer_get_pointer + + buffer_set + + buffer_string_replace_local_var + + buffer_match_list + +| windows | + current_window + + window_search_with_buffer + + window_get_integer + + window_get_string + + window_get_pointer + + window_set_title + +| nicklist | + nicklist_add_group + + nicklist_search_group + + nicklist_add_nick + + nicklist_search_nick + + nicklist_remove_group + + nicklist_remove_nick + + nicklist_remove_all + + nicklist_group_get_integer + + nicklist_group_get_string + + nicklist_group_get_pointer + + nicklist_group_set + + nicklist_nick_get_integer + + nicklist_nick_get_string + + nicklist_nick_get_pointer + + nicklist_nick_set + +| bars | + bar_item_search + + bar_item_new + + bar_item_update + + bar_item_remove + + bar_search + + bar_new + + bar_set + + bar_update + + bar_remove + +| commands | command -| infos | - info_get, info_get_hashtable -| infolists | - infolist_new, infolist_new_item, infolist_new_var_integer, - infolist_new_var_string, infolist_new_var_pointer, infolist_new_var_time, + - infolist_get, infolist_next, infolist_prev, infolist_reset_item_cursor, + - infolist_fields, infolist_integer, infolist_string, infolist_pointer, + - infolist_time, infolist_free -| hdata | - hdata_get, hdata_get_var_offset, hdata_get_var_type_string, - hdata_get_var_array_size, hdata_get_var_array_size_string, - hdata_get_var_hdata, hdata_get_list, hdata_check_pointer, hdata_move, - hdata_search, hdata_char, hdata_integer, hdata_long, hdata_string, - hdata_pointer, hdata_time, hdata_hashtable, hdata_update, hdata_get_string -| upgrade | - upgrade_new, upgrade_write_object, upgrade_read, upgrade_close + +| infos | + info_get + + info_get_hashtable + +| infolists | + infolist_new + + infolist_new_item + + infolist_new_var_integer + + infolist_new_var_string + + infolist_new_var_pointer + + infolist_new_var_time + + infolist_get + + infolist_next + + infolist_prev + + infolist_reset_item_cursor + + infolist_fields + + infolist_integer + + infolist_string + + infolist_pointer + + infolist_time + + infolist_free + +| hdata | + hdata_get + + hdata_get_var_offset + + hdata_get_var_type_string + + hdata_get_var_array_size + + hdata_get_var_array_size_string + + hdata_get_var_hdata + + hdata_get_list + + hdata_check_pointer + + hdata_move + + hdata_search + + hdata_char + + hdata_integer + + hdata_long + + hdata_string + + hdata_pointer + + hdata_time + + hdata_hashtable + + hdata_update + + hdata_get_string + +| upgrade | + upgrade_new + + upgrade_write_object + + upgrade_read + + upgrade_close |=== [[script_api_constants]] @@ -468,35 +618,63 @@ List of functions in script API: List of constants in script API: -[width="100%",cols="^1,10",options="header"] +[width="75%",cols="1,3",options="header"] |=== -| Category | Constants -| return codes | - WEECHAT_RC_OK, WEECHAT_RC_OK_EAT, WEECHAT_RC_ERROR +| Category | Constants + +| return codes | + WEECHAT_RC_OK + + WEECHAT_RC_OK_EAT + + WEECHAT_RC_ERROR + | configuration files | - WEECHAT_CONFIG_READ_OK, WEECHAT_CONFIG_READ_MEMORY_ERROR, - WEECHAT_CONFIG_READ_FILE_NOT_FOUND, WEECHAT_CONFIG_WRITE_OK, - WEECHAT_CONFIG_WRITE_ERROR, WEECHAT_CONFIG_WRITE_MEMORY_ERROR, + - WEECHAT_CONFIG_OPTION_SET_OK_CHANGED, WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE, - WEECHAT_CONFIG_OPTION_SET_ERROR, WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND, - WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET, WEECHAT_CONFIG_OPTION_UNSET_OK_RESET, - WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED, WEECHAT_CONFIG_OPTION_UNSET_ERROR -| sorted lists | - WEECHAT_LIST_POS_SORT, WEECHAT_LIST_POS_BEGINNING, WEECHAT_LIST_POS_END -| hotlist | - WEECHAT_HOTLIST_LOW, WEECHAT_HOTLIST_MESSAGE, WEECHAT_HOTLIST_PRIVATE, + WEECHAT_CONFIG_READ_OK + + WEECHAT_CONFIG_READ_MEMORY_ERROR + + WEECHAT_CONFIG_READ_FILE_NOT_FOUND + + WEECHAT_CONFIG_WRITE_OK + + WEECHAT_CONFIG_WRITE_ERROR + + WEECHAT_CONFIG_WRITE_MEMORY_ERROR + + WEECHAT_CONFIG_OPTION_SET_OK_CHANGED + + WEECHAT_CONFIG_OPTION_SET_OK_SAME_VALUE + + WEECHAT_CONFIG_OPTION_SET_ERROR + + WEECHAT_CONFIG_OPTION_SET_OPTION_NOT_FOUND + + WEECHAT_CONFIG_OPTION_UNSET_OK_NO_RESET + + WEECHAT_CONFIG_OPTION_UNSET_OK_RESET + + WEECHAT_CONFIG_OPTION_UNSET_OK_REMOVED + + WEECHAT_CONFIG_OPTION_UNSET_ERROR + +| sorted lists | + WEECHAT_LIST_POS_SORT + + WEECHAT_LIST_POS_BEGINNING + + WEECHAT_LIST_POS_END + +| hotlist | + WEECHAT_HOTLIST_LOW + + WEECHAT_HOTLIST_MESSAGE + + WEECHAT_HOTLIST_PRIVATE + WEECHAT_HOTLIST_HIGHLIGHT -| hook process | - WEECHAT_HOOK_PROCESS_RUNNING, WEECHAT_HOOK_PROCESS_ERROR -| hook connect | - WEECHAT_HOOK_CONNECT_OK, WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND, - WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND, WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED, - WEECHAT_HOOK_CONNECT_PROXY_ERROR, WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR, - WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR, WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR, - WEECHAT_HOOK_CONNECT_MEMORY_ERROR, WEECHAT_HOOK_CONNECT_TIMEOUT, + +| hook process | + WEECHAT_HOOK_PROCESS_RUNNING + + WEECHAT_HOOK_PROCESS_ERROR + +| hook connect | + WEECHAT_HOOK_CONNECT_OK + + WEECHAT_HOOK_CONNECT_ADDRESS_NOT_FOUND + + WEECHAT_HOOK_CONNECT_IP_ADDRESS_NOT_FOUND + + WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED + + WEECHAT_HOOK_CONNECT_PROXY_ERROR + + WEECHAT_HOOK_CONNECT_LOCAL_HOSTNAME_ERROR + + WEECHAT_HOOK_CONNECT_GNUTLS_INIT_ERROR + + WEECHAT_HOOK_CONNECT_GNUTLS_HANDSHAKE_ERROR + + WEECHAT_HOOK_CONNECT_MEMORY_ERROR + + WEECHAT_HOOK_CONNECT_TIMEOUT + WEECHAT_HOOK_CONNECT_SOCKET_ERROR -| hook signal | - WEECHAT_HOOK_SIGNAL_STRING, WEECHAT_HOOK_SIGNAL_INT, WEECHAT_HOOK_SIGNAL_POINTER + +| hook signal | + WEECHAT_HOOK_SIGNAL_STRING + + WEECHAT_HOOK_SIGNAL_INT + + WEECHAT_HOOK_SIGNAL_POINTER |=== [[common_tasks]] |