1
0
mirror of https://github.com/weechat/weechat.git synced 2026-06-25 04:16:38 +02:00

Compare commits

..

41 Commits

Author SHA1 Message Date
Sebastien Helleu f25dd0c81e Version 0.4.3 2014-02-09 09:52:53 +01:00
Sebastien Helleu 2b4401339a doc: clean temporary files used to build man pages (autotools) 2014-02-08 23:40:21 +01:00
Sebastien Helleu 7b0e01265b doc: add missing Polish docs in Makefile.am 2014-02-08 23:38:31 +01:00
Ryuunosuke Ayanokouzi 1eedace713 doc: update Japanese translations, user/developer's guide and plugin API reference 2014-02-08 15:15:18 +01:00
Sebastien Helleu 43fb54f51d core: fix apply of layout when buffers that are not in layout are before some buffers in layout
Now when a layout is applied, the buffers in layout are inserted/sorted
first in the new list. Then the other buffers (not in layout) are added
after this loop, and then they are added after all layout buffers.
2014-02-07 17:07:45 +01:00
Sebastien Helleu bbd212c675 weercd.py: use /usr/bin/env in python shebang 2014-02-07 15:01:39 +01:00
Sebastien Helleu 52fb9fc237 core: fix typo in FindGnuTLS.cmake 2014-02-06 17:26:36 +01:00
Sebastien Helleu 0ffb61617a core: fix hotlist problems after apply of a layout (bug #41481)
This commit fixes a problem when computing the value of "num_displayed"
in all buffers. For merged buffers (with same number), the num_displayed
of each merged buffer must be incremented (and not only the current
active buffer).
2014-02-06 15:17:00 +01:00
Krzysztof Koroscik 6c33b0d6e6 doc: update Polish translations and user's guide 2014-02-06 11:25:35 +01:00
Sebastien Helleu d8b9e0a6bf ruby: add detection and fix compilation with Ruby 2.0 (patch #8209)
Now the search for Ruby is first performed with pkg-config and includes
detection of Ruby 2.0.
If not found, the old code for detection is used (for old distros or
old Ruby versions).

The specific test on Ruby 1.9.0 (to disable this version) has been
removed (1.9.0 was a dev/unstable version from 2007, quite old now).
2014-02-05 17:27:36 +01:00
Sebastien Helleu 15394897e3 core: remove multiple detections of pkg-config in configure.ac 2014-02-05 13:58:07 +01:00
Patrick Steinhardt 47ced4833d core: fix installation of weechat-plugin.h with autotools (patch #8305) 2014-02-04 22:18:12 +01:00
Sebastien Helleu a3b5ae5e65 alias: add default alias /beep => /print -stderr \a 2014-02-04 16:20:55 +01:00
Sebastien Helleu 7fa74d89f7 core: fix a French translation 2014-02-04 10:59:29 +01:00
Sebastien Helleu bc7ed9f3a2 doc: fix typos in French relay protocol 2014-02-04 10:58:23 +01:00
Sebastien Helleu b91378fedc core: use structure itself for sizeof in two malloc 2014-02-04 08:34:05 +01:00
Sebastien Helleu 944972bc95 doc: add French version of relay protocol 2014-02-03 15:41:33 +01:00
Sebastien Helleu a2839fabb5 ruby: fix compilation warning 2014-02-02 20:33:03 +01:00
Sebastien Helleu 6c47428e78 core: fix compilation on Android (replace include of sys/termios.h by termios.h) (bug #41434) 2014-02-02 15:12:37 +01:00
Sebastien Helleu fcd120fa50 doc: minor changes in developer's guide 2014-02-02 11:10:33 +01:00
Sebastien Helleu 092f70aa7e core: update ChangeLog 2014-02-02 09:59:32 +01:00
Sebastien Helleu 01129cbc79 Version 0.4.3-rc2 2014-02-02 09:57:51 +01:00
Sebastien Helleu 74d236dfeb doc: add French developer's guide 2014-02-02 09:49:59 +01:00
Nils Görs 6b0bd1302a core: update German translations 2014-02-02 09:28:42 +01:00
Sebastien Helleu 01fb345fe0 core: fix compilation on Android (replace calls to rindex by strrchr) (bug #41420, patch #8301) 2014-02-02 09:00:46 +01:00
Sebastien Helleu 9db356bd9b core: fix crash when creating two bars with same name but different case (bug #41418) 2014-02-01 09:12:51 +01:00
Sebastien Helleu 219f75b225 irc: clear the gnutls session in all cases after SSL connection error 2014-01-31 19:24:26 +01:00
Sebastien Helleu 59481611dd relay: send backlog for irc private buffers 2014-01-31 16:41:12 +01:00
Sebastien Helleu ac4e762a0e doc: replace weeget.py by script plugin in plugin API reference 2014-01-30 12:33:09 +01:00
Sebastien Helleu f3d614460b core: fix typos in translations and docs 2014-01-29 22:37:33 +01:00
Sebastien Helleu 537f5617cf core: fix typo in NEWS 2014-01-28 22:24:45 +01:00
Sebastien Helleu f285fdafa0 irc: add value "353" in option irc.look.display_join_message
So now the values mean:
- 353: names on channel
- 366: names count (before this commit it meant 353 + 366)
2014-01-28 18:31:03 +01:00
Sebastien Helleu ff92b79712 core: fix typo in ChangeLog 2014-01-27 18:51:25 +01:00
Sebastien Helleu 1b2f4108fd core: fix display of read marker when all buffers line are unread
The bug is when all buffer lines are unread (so "last_read_line" pointer
is NULL), and that the option weechat.look.read_marker_always_show is on.
The read marker was displayed at bottom after switch to the buffer.

Thanks to Nils Görs.
2014-01-27 18:32:32 +01:00
Sebastien Helleu b8ffa87b5c logger: replace backslashs in name by logger replacement char under Cygwin (bug #41207) 2014-01-27 16:31:36 +01:00
Sebastien Helleu 58c615f33b core: fix memory leak in regex matching when evaluating expression 2014-01-26 20:04:05 +01:00
Sebastien Helleu f566de5d60 doc: update german auto-generated files with WeeChat commands and IRC options 2014-01-26 10:23:03 +01:00
Nils Görs 518dcfe9d9 core: update german translations and user's guide 2014-01-26 10:06:02 +01:00
Sebastien Helleu 0fbbbb4435 irc: add command "monitor" in /help irc.look.notify_tags_ison 2014-01-25 13:37:41 +01:00
Sebastien Helleu 86a99af606 scripts: fix script interpreter used after register during load of script in python/perl/ruby/lua/guile plugins (bug #41345) 2014-01-25 13:04:25 +01:00
Sebastien Helleu 97cede06b5 core: add support of escaped unicode chars in commands /print and "/input insert" 2014-01-24 12:53:23 +01:00
155 changed files with 5199 additions and 2005 deletions
+2 -1
View File
@@ -54,6 +54,7 @@ Alphabetically:
* Nicolas Cavigneaux
* Nils Görs (nils_2)
* Odin
* Patrick Steinhardt
* Paul Komkoff
* Pavel Shevchuk (Stalwart)
* Peter Boström (pbos)
@@ -82,4 +83,4 @@ Alphabetically:
Developers are connected to IRC:
* server: 'irc.freenode.net'
* channels: '#weechat' (english) and '#weechat-fr' (french)
* channels: '#weechat' (English) and '#weechat-fr' (French)
+1 -1
View File
@@ -33,7 +33,7 @@ ENDIF(PREFIX)
SET(VERSION_MAJOR "0")
SET(VERSION_MINOR "4")
SET(VERSION_PATCH "3-rc1")
SET(VERSION_PATCH "3")
SET(VERSION ${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH})
SET(LICENSE "GPL3")
SET(PKG_STRING "${PROJECT_NAME} ${VERSION}")
+23 -5
View File
@@ -9,10 +9,19 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
(file 'NEWS' in sources).
== Version 0.4.3 (under dev)
== Version 0.4.3 (2014-02-09)
* core: fix hotlist problems after apply of a layout (bug #41481)
* core: fix installation of weechat-plugin.h with autotools (patch #8305)
* core: fix compilation on Android (bug #41420, patch #8301, bug #41434)
* core: fix crash when creating two bars with same name but different case
(bug #41418)
* core: fix display of read marker when all buffer lines are unread and that
option weechat.look.read_marker_always_show is on
* core: fix memory leak in regex matching when evaluating expression
* core: add signals "signal_sighup" and "signal_sigwinch" (terminal resized)
* core: add command /print
* core: add command /print, add support of more escaped chars in command
"/input insert"
* core: add option weechat.look.tab_width
* core: add completion "plugins_installed"
* core: fix crash in /eval when config option has a NULL value
@@ -67,6 +76,7 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
* core: fix truncated prefix when filters are toggled (bug #40204)
* core: add options to customize default text search in buffers:
weechat.look.buffer_search_{case_sensitive|force_default|regex|where}
* doc: add French developer's guide and relay protocol
* doc: add Japanese plugin API reference and developer's guide
* doc: add Polish man page and user's guide
* api: add function "infolist_search_var"
@@ -78,9 +88,11 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
string_eval_expression and command /eval
* api: add support for C++ plugins
* api: fix read of arrays in hdata functions hdata_<type> (bug #40354)
* alias: add default alias /beep => /print -stderr \a
* aspell: fix detection of nicks with non-alphanumeric chars
* guile: disable guile gmp allocator (fix crash on unload of relay plugin)
(bug #40628)
* irc: clear the gnutls session in all cases after SSL connection error
* irc: use MONITOR instead of ISON for /notify when it is available on server
(task #11477)
* irc: do not display names by default when joining a channel (task #13045)
@@ -109,11 +121,17 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
* irc: add option irc.look.notice_welcome_tags
* irc: add server option "default_msg_kick" to customize default kick/kickban
message (task #12777)
* logger: replace backslashs in name by logger replacement char under Cygwin
(bug #41207)
* lua: fix detection of Lua 5.2 in autotools (patch #8270)
* lua: fix crash on calls to callbacks during load of script
* python: fix load of scripts with python >= 3.3
* relay: send backlog for irc private buffers
* relay: fix memory leak on unload of relay plugin
* ruby: fix ruby init with ruby >= 2.0 (bug #41115)
* ruby: add detection and fix compilation with Ruby 2.0 (patch #8209)
* ruby: fix ruby init with Ruby >= 2.0 (bug #41115)
* scripts: fix script interpreter used after register during load of script
in python/perl/ruby/lua/guile plugins (bug #41345)
* xfer: add support of IPv6 for DCC chat/file (patch #7992)
* xfer: use same infolist for hook and signals (patch #7974)
* xfer: add option xfer.file.auto_check_crc32 (patch #7963)
@@ -598,7 +616,7 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
* relay: add object type "arr" (array) in WeeChat protocol
* relay: fix freeze when writing on relay socket (use non-blocking sockets in
relay for irc and weechat protocols) (bug #36655)
* ruby: detect ruby version 1.9.3 in cmake and autotools
* ruby: detect Ruby version 1.9.3 in cmake and autotools
* script: new plugin "script" (scripts manager, replacing scripts weeget.py and
script.pl)
* scripts: add signals for scripts loaded/unloaded/installed/removed
@@ -752,7 +770,7 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
string_regex_flags, string_regcomp, hashtable_map_string,
hook_process_hashtable, hdata_check_pointer, hdata_char, hdata_hashtable and
nicklist_get_next_item
* alias: add default alias umode => /mode $nick
* alias: add default alias /umode => /mode $nick
* aspell: fix URL detection (do not check spelling of URLs) (bug #34040)
* irc: fix memory leak in SASL/blowfish authentication
* irc: fix memory leak when a server is deleted
+16 -1
View File
@@ -11,7 +11,7 @@ http://weechat.org/files/changelog/ChangeLog-devel.html[ChangeLog]
(file 'ChangeLog' in sources).
== Version 0.4.3 (under dev)
== Version 0.4.3 (2014-02-09)
=== Colors in messages
@@ -67,6 +67,21 @@ The default value for status bar items becomes:
/set weechat.bar.status.items "[time],[buffer_count],[buffer_plugin],buffer_number+:+buffer_name+(buffer_modes)+{buffer_nicklist_count}+buffer_zoom+buffer_filter,[lag],[hotlist],completion,scroll"
----
=== IRC messages on channel join
The names are not displayed any more by default on channel join (they are in
nicklist anyway).
Names can be displayed with the value "353" in option
'irc.look.display_join_message' (which is not in default value). +
The value "366" shows only names count on channel.
If you want to display all messages on join (including names), you can do:
----
/set irc.look.display_join_message "329,332,333,353,366"
----
=== Maximum lag in IRC
Option 'irc.network.lag_max' has been added.
+1 -1
View File
@@ -43,7 +43,7 @@ EXECUTE_PROCESS(COMMAND ${PKG_CONFIG_EXECUTABLE} --variable=prefix gnutls
EXECUTE_PROCESS(COMMAND ${PKG_CONFIG_EXECUTABLE} --cflags gnutls
OUTPUT_VARIABLE GNUTLS_CFLAGS
)
STRING(REGEX REPLACE "[\r\n]" "" GNUTLS_CFLAGS "${GNUTLS_FLAGS}")
STRING(REGEX REPLACE "[\r\n]" "" GNUTLS_CFLAGS "${GNUTLS_CFLAGS}")
EXECUTE_PROCESS(COMMAND ${PKG_CONFIG_EXECUTABLE} --libs gnutls
OUTPUT_VARIABLE GNUTLS_LDFLAGS
+57 -50
View File
@@ -22,71 +22,78 @@
# and libraries are. It also determines what the name of the library is. This
# code sets the following variables:
#
# RUBY_EXECUTABLE = full path to the ruby binary
# RUBY_INCLUDE_PATH = path to where ruby.h can be found
# RUBY_LIBRARY = path to where libruby.so* can be found
# 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(RUBY_FOUND)
FIND_PROGRAM(RUBY_EXECUTABLE
NAMES ruby1.9.3 ruby193 ruby1.9.2 ruby192 ruby1.9.1 ruby191 ruby1.9 ruby19 ruby1.8 ruby18 ruby1.6 ruby16 ruby
PATHS /usr/bin /usr/local/bin /usr/pkg/bin
)
FIND_PACKAGE(PkgConfig)
IF(PKG_CONFIG_FOUND)
pkg_search_module(RUBY ruby-2.0 ruby-1.9 ruby-1.8)
ENDIF(PKG_CONFIG_FOUND)
IF(RUBY_EXECUTABLE)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['rubyhdrdir'] || RbConfig::CONFIG['archdir']"
OUTPUT_VARIABLE RUBY_ARCH_DIR
IF(RUBY_FOUND)
SET(RUBY_LIB "")
MARK_AS_ADVANCED(RUBY_LIB)
ELSE(RUBY_FOUND)
FIND_PROGRAM(RUBY_EXECUTABLE
NAMES ruby1.9.3 ruby193 ruby1.9.2 ruby192 ruby1.9.1 ruby191 ruby1.9 ruby19 ruby1.8 ruby18 ruby
PATHS /usr/bin /usr/local/bin /usr/pkg/bin
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['arch']"
OUTPUT_VARIABLE RUBY_ARCH
)
IF(RUBY_EXECUTABLE)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['libdir']"
OUTPUT_VARIABLE RUBY_POSSIBLE_LIB_PATH
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['rubyhdrdir'] || RbConfig::CONFIG['archdir']"
OUTPUT_VARIABLE RUBY_ARCH_DIR
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['rubylibdir']"
OUTPUT_VARIABLE RUBY_RUBY_LIB_PATH
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['arch']"
OUTPUT_VARIABLE RUBY_ARCH
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['ruby_version']"
OUTPUT_VARIABLE RUBY_VERSION
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['libdir']"
OUTPUT_VARIABLE RUBY_POSSIBLE_LIB_PATH
)
FIND_PATH(RUBY_INCLUDE_PATH
NAMES ruby.h
PATHS ${RUBY_ARCH_DIR}
)
EXECUTE_PROCESS(
COMMAND ${RUBY_EXECUTABLE} -r rbconfig -e "print RbConfig::CONFIG['rubylibdir']"
OUTPUT_VARIABLE RUBY_RUBY_LIB_PATH
)
SET(RUBY_ARCH
"${RUBY_INCLUDE_PATH}/${RUBY_ARCH}")
FIND_PATH(RUBY_INCLUDE_DIRS
NAMES ruby.h
PATHS ${RUBY_ARCH_DIR}
)
FIND_LIBRARY(RUBY_LIBRARY
NAMES ruby-1.9.3 ruby1.9.3 ruby193 ruby-1.9.2 ruby1.9.2 ruby192 ruby-1.9.1 ruby1.9.1 ruby191 ruby1.9 ruby19 ruby1.8 ruby18 ruby1.6 ruby16 ruby
PATHS ${RUBY_POSSIBLE_LIB_PATH} ${RUBY_RUBY_LIB_PATH}
)
SET(RUBY_INCLUDE_ARCH "${RUBY_INCLUDE_DIRS}/${RUBY_ARCH}")
IF(RUBY_LIBRARY AND RUBY_INCLUDE_PATH)
SET(RUBY_FOUND TRUE)
ENDIF(RUBY_LIBRARY AND RUBY_INCLUDE_PATH)
FIND_LIBRARY(RUBY_LIB
NAMES ruby-1.9.3 ruby1.9.3 ruby193 ruby-1.9.2 ruby1.9.2 ruby192 ruby-1.9.1 ruby1.9.1 ruby191 ruby1.9 ruby19 ruby1.8 ruby18 ruby
PATHS ${RUBY_POSSIBLE_LIB_PATH} ${RUBY_RUBY_LIB_PATH}
)
IF(${RUBY_VERSION} STREQUAL "1.9.0")
SET(RUBY_FOUND FALSE)
ENDIF(${RUBY_VERSION} STREQUAL "1.9.0")
IF(RUBY_LIB AND RUBY_INCLUDE_DIRS)
SET(RUBY_FOUND TRUE)
ENDIF(RUBY_LIB AND RUBY_INCLUDE_DIRS)
MARK_AS_ADVANCED(
RUBY_EXECUTABLE
RUBY_LIBRARY
RUBY_ARCH
RUBY_INCLUDE_PATH
)
ENDIF(RUBY_EXECUTABLE)
SET(RUBY_INCLUDE_DIRS "${RUBY_INCLUDE_DIRS};${RUBY_INCLUDE_ARCH}")
MARK_AS_ADVANCED(
RUBY_INCLUDE_DIRS
RUBY_LIBRARY_DIRS
RUBY_LIB
)
ENDIF(RUBY_EXECUTABLE)
ENDIF(RUBY_FOUND)
+46 -51
View File
@@ -24,7 +24,7 @@
# Process this file with autoconf to produce a configure script.
AC_PREREQ(2.56)
AC_INIT(WeeChat, 0.4.3-rc1, flashcode@flashtux.org)
AC_INIT(WeeChat, 0.4.3, flashcode@flashtux.org)
AC_CONFIG_SRCDIR([configure.ac])
AM_CONFIG_HEADER(config.h)
AM_INIT_AUTOMAKE
@@ -553,31 +553,34 @@ fi
RUBY_VERSION=
if test "x$enable_ruby" = "xyes" ; then
AC_PATH_PROGS(RUBY, ruby1.9.3 ruby1.9.2 ruby1.9.1 ruby1.9 ruby1.8 ruby)
if test -z $RUBY ; then
AC_MSG_WARN([
RUBY_CFLAGS=""
RUBY_LFLAGS=""
for v in "2.0" "1.9" "1.8" ; do
pkgconfig_ruby_found=`$PKGCONFIG --exists ruby-$v 2>/dev/null`
if test "x$?" = "x0" ; then
RUBY_VERSION=`$PKGCONFIG --modversion ruby-$v`
RUBY_CFLAGS=`$PKGCONFIG --cflags ruby-$v`
RUBY_LFLAGS=`$PKGCONFIG --libs ruby-$v`
break
fi
done
if test "x$RUBY_CFLAGS" = "x" -o "x$RUBY_LFLAGS" = "x" ; then
AC_PATH_PROGS(RUBY, ruby1.9.3 ruby1.9.2 ruby1.9.1 ruby1.9 ruby1.8 ruby)
if test -z $RUBY ; then
AC_MSG_WARN([
*** Ruby must be installed on your system but ruby interpreter couldn't be found in path.
*** Please check that ruby is in path, or install it with your software package manager.
*** WeeChat will be built without Ruby support.])
enable_ruby="no"
not_found="$not_found ruby"
else
RUBY_VERSION=`$RUBY -rrbconfig -e "puts RbConfig::CONFIG[['ruby_version']]"`
if test "$RUBY_VERSION" = "1.9.0"; then
AC_MSG_WARN([
*** Ruby header files have been found, but they're of the version 1.9.0.
*** Ruby 1.9.0 is an unstable release and should not be used in production.
*** Please install Ruby 1.8.x (>= 1.8.6) or >= 1.9.1.
*** WeeChat will be built without Ruby support.])
enable_ruby="no"
not_found="$not_found ruby"
else
RUBY_VERSION=`$RUBY -rrbconfig -e "puts RbConfig::CONFIG[['MAJOR']] + '.' + RbConfig::CONFIG[['MINOR']] + '.' + RbConfig::CONFIG[['TEENY']]"`
RUBY_INCLUDE=`$RUBY -rrbconfig -e "puts RbConfig::CONFIG[['rubyhdrdir']] || RbConfig::CONFIG[['archdir']]"`
RUBY_ARCH=`$RUBY -rrbconfig -e 'print RbConfig::CONFIG[["arch"]]'`
AC_MSG_CHECKING(for Ruby header files)
if test -d "$RUBY_INCLUDE/"; then
M_RUBY_VERSION=`$RUBY -rrbconfig -e "puts RbConfig::CONFIG[['ruby_version']].gsub(/\./, '')[[0,3]]"`
RUBY_CFLAGS="-I$RUBY_INCLUDE/ -I$RUBY_INCLUDE/$RUBY_ARCH -DRUBY_VERSION=$M_RUBY_VERSION"
RUBY_CFLAGS="-I$RUBY_INCLUDE/ -I$RUBY_INCLUDE/$RUBY_ARCH"
else
AC_MSG_WARN([
*** Ruby header files couldn't be found on your system.
@@ -621,27 +624,23 @@ if test "x$enable_lua" = "xyes" ; then
fi
if test "x$LUA_CFLAGS" = "x" -o "x$LUA_LFLAGS" = "x" ; then
PKGCONFIG=""
AC_CHECK_PROGS(PKGCONFIG, pkg-config)
if test "x$PKGCONFIG" != "x"; then
AC_MSG_CHECKING(for Lua headers and librairies with pkg-config)
echo
for l in "$lua_suffix" "" "51" "5.1" "50" "5.0" ; do
pkgconfig_lua_found=`$PKGCONFIG --exists lua$l 2>/dev/null`
if test "x$?" = "x0" ; then
LUA_VERSION=`$PKGCONFIG --modversion lua$l`
LUA_CFLAGS="$LUA_CFLAGS "`$PKGCONFIG --cflags lua$l`
LUA_LFLAGS="$LUA_LFLAGS "`$PKGCONFIG --libs lua$l`
AC_MSG_CHECKING(for Lua headers and librairies with pkg-config)
echo
for l in "$lua_suffix" "" "51" "5.1" "50" "5.0" ; do
pkgconfig_lua_found=`$PKGCONFIG --exists lua$l 2>/dev/null`
if test "x$?" = "x0" ; then
LUA_VERSION=`$PKGCONFIG --modversion lua$l`
LUA_CFLAGS="$LUA_CFLAGS "`$PKGCONFIG --cflags lua$l`
LUA_LFLAGS="$LUA_LFLAGS "`$PKGCONFIG --libs lua$l`
pkgconfig_lualib_found=`$PKGCONFIG --exists lualib$l 2>/dev/null`
if test "x$?" = "x0"; then
LUA_CFLAGS="$LUA_CFLAGS "`$PKGCONFIG --cflags lualib$l`
LUA_LFLAGS="$LUA_LFLAGS "`$PKGCONFIG --libs lualib$l`
fi
break
pkgconfig_lualib_found=`$PKGCONFIG --exists lualib$l 2>/dev/null`
if test "x$?" = "x0"; then
LUA_CFLAGS="$LUA_CFLAGS "`$PKGCONFIG --cflags lualib$l`
LUA_LFLAGS="$LUA_LFLAGS "`$PKGCONFIG --libs lualib$l`
fi
done
fi
break
fi
done
fi
if test "x$LUA_CFLAGS" = "x" -o "x$LUA_LFLAGS" = "x" ; then
@@ -773,22 +772,18 @@ if test "x$enable_guile" = "xyes" ; then
enable_plugins="yes"
guile_found="no"
PKGCONFIG=""
AC_CHECK_PROGS(PKGCONFIG, pkg-config)
if test "x$PKGCONFIG" != "x"; then
AC_MSG_CHECKING(for Guile headers and librairies)
echo
for v in "2.0" ; do
pkgconfig_guile_found=`$PKGCONFIG --exists guile-$v 2>/dev/null`
if test "x$?" = "x0" ; then
GUILE_VERSION=`$PKGCONFIG --modversion guile-$v`
GUILE_CFLAGS=`$PKGCONFIG --cflags guile-$v`
GUILE_LFLAGS=`$PKGCONFIG --libs guile-$v`
guile_found="yes"
break
fi
done
fi
AC_MSG_CHECKING(for Guile headers and librairies)
echo
for v in "2.0" ; do
pkgconfig_guile_found=`$PKGCONFIG --exists guile-$v 2>/dev/null`
if test "x$?" = "x0" ; then
GUILE_VERSION=`$PKGCONFIG --modversion guile-$v`
GUILE_CFLAGS=`$PKGCONFIG --cflags guile-$v`
GUILE_LFLAGS=`$PKGCONFIG --libs guile-$v`
guile_found="yes"
break
fi
done
if test "x$guile_found" = "xno" ; then
AC_MSG_WARN([
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-dev-en
Title: WeeChat Developer's Guide (English)
Title: WeeChat developer's guide (English)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (English version).
+10
View File
@@ -0,0 +1,10 @@
Document: weechat-dev-fr
Title: WeeChat developer's guide (French)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (French version).
Section: Network/Communication
Format: HTML
Index: /usr/share/doc/weechat-doc/html/weechat_dev.fr.html
Files: /usr/share/doc/weechat-doc/html/weechat_dev.fr.html
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-dev-ja
Title: WeeChat Developer's Guide (Japanese)
Title: WeeChat developer's guide (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes WeeChat internals and
how to contribute to WeeChat (Japanese version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-plugin-en
Title: WeeChat plugins API (English)
Title: WeeChat plugin API reference (English)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (English version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-plugin-fr
Title: WeeChat plugins API (French)
Title: WeeChat plugin API reference (French)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (French version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-plugin-it
Title: WeeChat plugins API (Italian)
Title: WeeChat plugin API reference (Italian)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Italian version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-plugin-ja
Title: WeeChat plugins API (Japanese)
Title: WeeChat plugin API reference (Japanese)
Author: Sébastien Helleu
Abstract: This document describes the API to create plugins
for WeeChat (Japanese version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-de
Title: WeeChat Quickstart (German)
Title: WeeChat quick start guide (German)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (German version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-en
Title: WeeChat Quickstart (English)
Title: WeeChat quick start guide (English)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (English version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-es
Title: WeeChat Quickstart (Spanish)
Title: WeeChat quick start guide (Spanish)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Spanish version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-fr
Title: WeeChat Quickstart (French)
Title: WeeChat quick start guide (French)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (French version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-it
Title: WeeChat Quickstart (Italian)
Title: WeeChat quick start guide (Italian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Italian version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-ja
Title: WeeChat Quickstart (Japanese)
Title: WeeChat quick start guide (Japanese)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Japanese version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-pl
Title: WeeChat Quickstart (Polish)
Title: WeeChat quick start guide (Polish)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Polish version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-quickstart-ru
Title: WeeChat Quickstart (Russian)
Title: WeeChat quick start guide (Russian)
Author: Sébastien Helleu
Abstract: A short HowTo for new WeeChat users (Russian version).
Section: Network/Communication
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-relay-protocol-en
Title: WeeChat Relay Protocol (English)
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).
+10
View File
@@ -0,0 +1,10 @@
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 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-de
Title: WeeChat Scripting Guide (German)
Title: WeeChat scripting guide (German)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (German version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-en
Title: WeeChat Scripting Guide (English)
Title: WeeChat scripting guide (English)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (English version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-fr
Title: WeeChat Scripting Guide (French)
Title: WeeChat scripting guide (French)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (French version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-it
Title: WeeChat Scripting Guide (Italian)
Title: WeeChat scripting guide (Italian)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Italian version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-ja
Title: WeeChat Scripting Guide (Japanese)
Title: WeeChat scripting guide (Japanese)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Japanese version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-scripting-pl
Title: WeeChat Scripting Guide (Polish)
Title: WeeChat scripting guide (Polish)
Author: Sébastien Helleu
Abstract: This document describes the API to create scripts
for WeeChat (Polish version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-de
Title: WeeChat Tester's Guide (German)
Title: WeeChat tester's guide (German)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (German version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-en
Title: WeeChat Tester's Guide (English)
Title: WeeChat tester's guide (English)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (English version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-fr
Title: WeeChat Tester's Guide (French)
Title: WeeChat tester's guide (French)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (French version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-it
Title: WeeChat Tester's Guide (Italian)
Title: WeeChat tester's guide (Italian)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (Italian version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-ja
Title: WeeChat Tester's Guide (Japanese)
Title: WeeChat tester's guide (Japanese)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (Japanese version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-tester-pl
Title: WeeChat Tester's Guide (Polish)
Title: WeeChat tester's guide (Polish)
Author: Sébastien Helleu
Abstract: This document describes how to test and report
bugs against the WeeChat IRC Client (Polish version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-de
Title: WeeChat User's Guide (German)
Title: WeeChat user's guide (German)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (German version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-en
Title: WeeChat User's Guide (English)
Title: WeeChat user's guide (English)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (English version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-fr
Title: WeeChat User's Guide (French)
Title: WeeChat user's guide (French)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (French version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-it
Title: WeeChat User's Guide (Italian)
Title: WeeChat user's guide (Italian)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Italian version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-ja
Title: WeeChat User's Guide (Japanese)
Title: WeeChat user's guide (Japanese)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Japanese version).
+1 -1
View File
@@ -1,5 +1,5 @@
Document: weechat-user-pl
Title: WeeChat User's Guide (Polish)
Title: WeeChat user's guide (Polish)
Author: Sébastien Helleu
Abstract: This manual describes how to use the WeeChat
IRC client (Polish version).
+1 -1
View File
@@ -99,5 +99,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1
-rm -f weechat.1 weechat.1.de.txt cmdline_options.de.txt
-rm -f *.html
+3 -3
View File
@@ -134,9 +134,9 @@
** Werte: on, off (Standardwert: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** Beschreibung: `durch Kommata getrennte Liste von Nachrichten die beim betreten eines Channels angezeigt werden sollen: 329 = Erstellungsdatum des Channels, 332 = Topic, 333 = Nick/Datum für Topic, 366 = genutzte Namen im Channel`
** Beschreibung: `durch Kommata getrennte Liste von Nachrichten die beim Betreten eines Channels angezeigt werden sollen: 329 = Erstellungsdatum des Channels, 332 = Topic, 333 = Nick/Datum für Topic, 353 = genutzte Namen im Channel, 366 = Anzahl der Nicks im Channel`
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette (Standardwert: `"329,332,333"`)
** Werte: beliebige Zeichenkette (Standardwert: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** Beschreibung: `Zeige das alte Thema an, falls das Thema des Channels geändert wurde`
@@ -264,7 +264,7 @@
** Werte: beliebige Zeichenkette (Standardwert: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** Beschreibung: `durch Kommata getrennte Liste von Schlagwörtern die in notify-Nachrichten genutzt werden sollen, falls ein Nick einen Server betritt oder verlässt (Rückgabe durch Befehl ison), zum Beispiel: "notify_message", "notify_private" oder "notify_highlight"`
** Beschreibung: `durch Kommata getrennte Liste von Schlagwörtern die in notify-Nachrichten genutzt werden sollen, falls ein Nick einen Server betritt oder verlässt (Rückgabewert des Befehls ison oder monitor), zum Beispiel: "notify_message", "notify_private" oder "notify_highlight"`
** Typ: Zeichenkette
** Werte: beliebige Zeichenkette (Standardwert: `"notify_message"`)
+1 -1
View File
@@ -159,7 +159,7 @@
** Werte: beliebige Zeichenkette (Standardwert: `"p,n"`)
* [[option_script.look.translate_description]] *script.look.translate_description*
** Beschreibung: `Für die Beschreibung der Skripten wird die Muttersprache verwendet (sollte keine Übersetzung in der eigenen Sprache verfügbar sein, wird auf die englische Beschreibung zurückgegriffen)`
** Beschreibung: `für die Beschreibung der Skripten wird die Muttersprache verwendet (sollte keine Übersetzung in der eigenen Sprache verfügbar sein, wird auf die englische Beschreibung zurückgegriffen)`
** Typ: boolesch
** Werte: on, off (Standardwert: `on`)
+12 -9
View File
@@ -363,7 +363,7 @@ value: Anzahl der gewünschten Einträgen im Befehlsverlauf anzeigen
----
/input <action> [<arguments>]
Auflistung der möglichen Funktionen:
Auflistung der möglichen Aktionen:
return: simuliert die "enter" Taste
complete_next: vervollständigt Wort mit nächster Komplettierung
complete_previous: vervollständigt Word mit vorheriger Komplettierung
@@ -410,7 +410,7 @@ Auflistung der möglichen Funktionen:
switch_active_buffer: springt zum nächsten zusammengefügten Buffer
switch_active_buffer_previous: springt zum vorherigen zusammengefügten Buffer
zoom_merged_buffer: zoomt in zusammengefügte Buffer
insert: fügt einen Text in die Eingabezeile ein
insert: fügt einen Text in die Eingabezeile ein (Escapesequenzen sind möglich, siehe /help print)
paste_start: Einfügen wird gestartet (bracketed paste mode)
paste_stop: Einfügen wird beendet (bracketed paste mode)
@@ -579,12 +579,13 @@ Ohne Angabe eines Arguments werden alle installierten Erweiterungen angezeigt.
time: hh:mm:ss (Beispiel: 04:32:55)
-tags: durch Kommata getrennte Liste von Tags (siehe /help filter für eine Liste von Tags die häufig genutzt werden)
text: Text der ausgegeben werden soll (Präfix und Nachricht muss durch \t getrennt werden)
-stdout: Text wird an stdout geschickt (und nicht im Buffer dargestellt)
-stderr: Text wird an stderr geschickt (und nicht im Buffer dargestellt)
-stdout: Text wird an stdout geschickt (Escapesequenzen werden umgewandelt)
-stderr: Text wird an stderr geschickt (Escapesequenzen werden umgewandelt)
Die Option -action ... -quit nutzt den Präfix der in der Option "weechat.look.prefix_*" definiert ist.
Die Optionen -stdout und -stderr wandeln Escapesequenzen automatisch um.
Folgende Escapesequenzen werden unterstützt:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Beispiele:
zeigt eine Erinnerung, mit Highlight, im Core-Buffer dar:
@@ -595,6 +596,8 @@ Beispiele:
/print -core abc\tmeine Nachricht
es wird eine Nachricht im Channel #weechat ausgegeben:
/print -buffer irc.freenode.#weechat Message on #weechat
gibt einen Schneemann aus (U+2603):
/print -escape \u2603
verschickt Alarm (BEL):
/print -stderr \a
----
@@ -809,8 +812,8 @@ Es ist möglich die WeeChat-Sitzung auf einem anderen Rechner wiederherzustellen
----
/uptime [-o | -ol]
-o: sendet die WeeChat Laufzeit in den aktuellen Buffer (englisch)
-ol: sendet die WeeChat Laufzeit in den aktuellen Buffer (in der voreingestellten Landessprache)
-o: die Laufzeit von WeeChat wird in den aktuellen Buffer geschrieben (in englischer Sprache)
-ol: die Laufzeit von WeeChat wird in den aktuellen Buffer geschrieben (in der voreingestellten Landessprache)
----
[[command_weechat_version]]
@@ -819,8 +822,8 @@ Es ist möglich die WeeChat-Sitzung auf einem anderen Rechner wiederherzustellen
----
/version [-o | -ol]
-o: sendet die WeeChat Version in den aktuellen Buffer (englisch)
-ol: sendet die WeeChat Version in den aktuellen Buffer (in der Voreingestellten Landessprache)
-o: die Version von WeeChat wird in den aktuellen Buffer geschrieben (in englischer Sprache)
-ol: die Version von WeeChat wird in den aktuellen Buffer geschrieben (in der voreingestellten Landessprache)
----
[[command_weechat_wait]]
+1 -1
View File
@@ -740,7 +740,7 @@ Damit WeeChat weniger Speicher benötigt, solltest Du folgende Tipps umsetzen:
Es gibt drei Möglichkeiten:
. Du kannst zu uns in den IRC kommen: 'irc.freenode.net', channel '#weechat'
. Du kannst die Internetseite savannah nutzen:
. Du kannst die Internetseite Savannah nutzen:
* Einen Fehler melden: https://savannah.nongnu.org/bugs/?group=weechat
* Einen Verbesserungsvorschlag machen: https://savannah.nongnu.org/task/?group=weechat
* Einen Patch einsenden: https://savannah.nongnu.org/patch/?group=weechat
+1 -1
View File
@@ -35,7 +35,7 @@ Allerdings ist die API für alle Skriptsprachen nahezu identisch.
[[scripts_in_weechat]]
== Skripten in WeeChat
[[languages_specifities]]
[[languages_specificities]]
=== Besonderheiten der einzelnen Skriptsprachen
==== Python
+3 -5
View File
@@ -38,7 +38,7 @@ wesentliche Merkmale:
Die WeeChat Homepage findet man unter: http://weechat.org/
[[pre-requisites]]
[[prerequisites]]
=== Vorbereitung
Um WeeChat zu installieren wird folgendes benötigt:
@@ -2267,10 +2267,8 @@ Unvollständige Liste der IRC Nachrichten bzw. Alias die angepasst werden könne
| 671 | whois | whois (sichere Verbindung)
| 728 | quietlist | quiet Liste
| 729 | quietlist | Ende der quiet Liste
// TRANSLATION MISSING
| 732 | monitor | list of monitored nicks
// TRANSLATION MISSING
| 733 | monitor | list of monitored nicks (end)
| 732 | monitor | Liste der Nicks welche überwacht werden
| 733 | monitor | Liste der Nicks welche überwacht werden (Ende)
| 901 | | Sie sind nun eingelogged
|===
+11 -11
View File
@@ -104,17 +104,6 @@ IF(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
ADD_CUSTOM_TARGET(doc-tester-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.en.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.en.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
# developer's guide
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html
COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -f ${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.conf -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.en.txt
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.en.txt
COMMENT "Building weechat_dev.en.html"
)
ADD_CUSTOM_TARGET(doc-dev-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
# relay protocol
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.en.html
@@ -126,4 +115,15 @@ IF(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
ADD_CUSTOM_TARGET(doc-relay-protocol-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.en.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.en.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
# developer's guide
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html
COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -f ${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.conf -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.en.txt
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.en.txt
COMMENT "Building weechat_dev.en.html"
)
ADD_CUSTOM_TARGET(doc-dev-en ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.en.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
ENDIF(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
+4 -4
View File
@@ -29,8 +29,8 @@ EXTRA_DIST = CMakeLists.txt \
weechat_faq.en.txt \
weechat_quickstart.en.txt \
weechat_tester.en.txt \
weechat_dev.en.txt \
weechat_relay_protocol.en.txt \
weechat_dev.en.txt \
$(wildcard autogen/user/*.txt) \
$(wildcard autogen/plugin_api/*.txt)
@@ -46,8 +46,8 @@ if DOC
weechat_faq.en.html \
weechat_quickstart.en.html \
weechat_tester.en.html \
weechat_dev.en.html \
weechat_relay_protocol.en.html
weechat_relay_protocol.en.html \
weechat_dev.en.html
doc_install = install-doc
doc_uninstall = uninstall-doc
endif
@@ -118,5 +118,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1
-rm -f weechat.1 weechat.1.en.txt cmdline_options.en.txt
-rm -f *.html
+3 -3
View File
@@ -134,9 +134,9 @@
** values: on, off (default value: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** description: `comma-separated list of messages to display after joining a channel: 329 = channel creation date, 332 = topic, 333 = nick/date for topic, 366 = names on channel`
** description: `comma-separated list of messages to display after joining a channel: 329 = channel creation date, 332 = topic, 333 = nick/date for topic, 353 = names on channel, 366 = names count`
** type: string
** values: any string (default value: `"329,332,333"`)
** values: any string (default value: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** description: `display old topic when channel topic is changed`
@@ -264,7 +264,7 @@
** values: any string (default value: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** description: `comma separated list of tags used in messages displayed by notify when a nick joins or quits server (result of command ison), for example: "notify_message", "notify_private" or "notify_highlight"`
** description: `comma separated list of tags used in messages displayed by notify when a nick joins or quits server (result of command ison or monitor), for example: "notify_message", "notify_private" or "notify_highlight"`
** type: string
** values: any string (default value: `"notify_message"`)
+1 -1
View File
@@ -159,7 +159,7 @@
** values: any string (default value: `"p,n"`)
* [[option_script.look.translate_description]] *script.look.translate_description*
** description: `translate description of scripts (if translation is available in your language, otherwise english version is used)`
** description: `translate description of scripts (if translation is available in your language, otherwise English version is used)`
** type: boolean
** values: on, off (default value: `on`)
+9 -6
View File
@@ -410,7 +410,7 @@ list of actions:
switch_active_buffer: switch to next merged buffer
switch_active_buffer_previous: switch to previous merged buffer
zoom_merged_buffer: zoom on merged buffer
insert: insert text in command line
insert: insert text in command line (escaped chars are allowed, see /help print)
paste_start: start paste (bracketed paste mode)
paste_stop: stop paste (bracketed paste mode)
@@ -579,12 +579,13 @@ Without argument, this command lists loaded plugins.
time: hh:mm:ss (example: 04:32:55)
-tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
text: text to display (prefix and message must be separated by \t)
-stdout: display text on stdout (not in a buffer)
-stderr: display text on stderr (not in a buffer)
-stdout: display text on stdout (escaped chars are interpreted)
-stderr: display text on stderr (escaped chars are interpreted)
The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
With options -stdout and -stderr, escaped chars are always interpreted.
Following escaped chars are supported:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Examples:
display a reminder on core buffer with a highlight:
@@ -595,6 +596,8 @@ Examples:
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
/print -stderr \a
----
@@ -809,7 +812,7 @@ It is possible to restore WeeChat session on another machine if you copy the con
----
/uptime [-o | -ol]
-o: send uptime to current buffer as input (english string)
-o: send uptime to current buffer as input (English string)
-ol: send uptime to current buffer as input (translated string)
----
@@ -819,7 +822,7 @@ It is possible to restore WeeChat session on another machine if you copy the con
----
/version [-o | -ol]
-o: send version to current buffer as input (english string)
-o: send version to current buffer as input (English string)
-ol: send version to current buffer as input (translated string)
----
+85 -74
View File
@@ -1,4 +1,4 @@
= WeeChat Developer's Guide
= WeeChat developer's guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
@@ -24,7 +24,7 @@ This manual documents WeeChat internals:
* coding rules
* core internals
* plugin internals
* how to contribute to WeeChat
* how to contribute to WeeChat.
[[repository]]
== Repository
@@ -34,7 +34,7 @@ WeeChat has two main repositories:
* core repository: it contains source code and documentation,
URL is: http://git.savannah.gnu.org/gitweb/?p=weechat.git
* scripts: the 'official' scripts submitted on weechat.org,
URL is: http://git.savannah.gnu.org/gitweb/?p=weechat/scripts.git;a=summary
URL is: http://git.savannah.gnu.org/gitweb/?p=weechat/scripts.git
This manual documents only core repository.
@@ -46,7 +46,6 @@ The main WeeChat directories are:
[width="100%",cols="1v,5",options="header"]
|===
| Directory | Description
| debian/ | Debian packaging
| src/ | Root of sources
| core/ | Core functions: entry point, internal structures
| gui/ | Functions for buffers, windows, ... (used by all interfaces)
@@ -56,7 +55,7 @@ The main WeeChat directories are:
| aspell/ | Aspell plugin
| charset/ | Charset plugin
| fifo/ | Fifo plugin (FIFO pipe used to remotely send commands to WeeChat)
| irc/ | IRC plugin
| irc/ | IRC (Internet Relay Chat) plugin
| logger/ | Logger plugin (write messages displayed to files)
| relay/ | Relay plugin (irc proxy + relay for remote interfaces)
| rmodifier/ | Rmodifier plugin (alter modifier strings with regular expressions)
@@ -67,10 +66,11 @@ The main WeeChat directories are:
| lua/ | Lua scripting API
| tcl/ | Tcl scripting API
| guile/ | Guile (scheme) scripting API
| xfer/ | Xfer (IRC DCC file/chat)
| xfer/ | Xfer plugin (IRC DCC file/chat)
| doc/ | Documentation
| po/ | Translations files (gettext)
| test/ | Weercd: WeeChat flood irc server, written in Python
| test/ | Tools/files to test WeeChat (like Weercd, an IRC server)
| debian/ | Debian packaging
|===
[[sources]]
@@ -79,7 +79,7 @@ The main WeeChat directories are:
[[sources_core]]
==== Core
WeeChat "core" reside in following directories:
WeeChat "core" is located in following directories:
* 'src/core/': core functions (for data manipulation)
* 'src/gui/': functions about interface (buffers, windows, ...)
@@ -89,21 +89,21 @@ WeeChat "core" reside in following directories:
| Path/file | Description
| core/ | Core functions: entry point, internal structures
| weechat.c | Entry point, command line options, main functions, startup
| wee-backtrace.c | Display backtrace after a segfault
| wee-backtrace.c | Display a backtrace after a crash
| wee-command.c | WeeChat core commands
| wee-completion.c | Completion on command line
| wee-completion.c | Default completions
| wee-config-file.c | Configuration file management
| wee-config.c | Configuration options for WeeChat core (file weechat.conf)
| wee-debug.c | Some debug functions
| wee-eval.c | Evaluate expressions with references to internal vars
| wee-eval.c | Evaluation of expressions with references to internal vars
| wee-hashtable.c | Hashtables
| wee-hdata.c | Hdata (direct access to data using hashtables)
| wee-hook.c | Hooks
| wee-infolist.c | Infolists (lists built with data about objects)
| wee-infolist.c | Infolists (lists with objects data)
| wee-input.c | Input of commands/text
| wee-list.c | Sorted lists
| wee-log.c | Write to WeeChat log file (weechat.log)
| wee-network.c | Network functions (connection to servers, proxy)
| wee-network.c | Network functions (connection to servers/proxies)
| wee-proxy.c | Proxy management
| wee-secure.c | Secured data options (file sec.conf)
| wee-string.c | Functions on strings
@@ -120,11 +120,11 @@ WeeChat "core" reside in following directories:
| gui-buffer.c | Buffers
| gui-chat.c | Chat functions (display message, ...)
| gui-color.c | Color functions
| gui-completion.c | Default completions
| gui-completion.c | Completion on command line
| gui-cursor.c | Cursor mode (free movement of cursor)
| gui-filter.c | Filters
| gui-focus.c | Functions about focus (for cursor mode and mouse)
| gui-history.c | commands/text saved in buffers
| gui-history.c | Commands/text saved in buffers
| gui-hotlist.c | Hotlist management (list of buffers with activity)
| gui-input.c | Input functions (input bar)
| gui-key.c | Keyboard functions
@@ -183,7 +183,7 @@ WeeChat "core" reside in following directories:
| irc-bar-item.c | IRC bar items
| irc-buffer.c | IRC buffers
| irc-channel.c | IRC channels
| irc-color.c | Color functions
| irc-color.c | IRC colors
| irc-command.c | IRC commands
| irc-completion.c | IRC completions
| irc-config.c | IRC config options (file irc.conf)
@@ -201,14 +201,14 @@ WeeChat "core" reside in following directories:
| irc-raw.c | IRC raw buffer
| irc-redirect.c | Redirection of IRC command output
| irc-sasl.c | SASL authentication with IRC server
| irc-server.c | I/O communication with IRC servers
| irc-upgrade.c | Save/restore IRC data when upgrading WeeChat
| irc-server.c | I/O communication with IRC server
| irc-upgrade.c | Save/restore of IRC data when upgrading WeeChat
| logger/ | Logger plugin
| logger.c | Main logger functions
| logger-buffer.c | Logger buffer list management
| logger-config.c | Logger config options (file logger.conf)
| logger-info.c | Logger info/infolists/hdata
| logger-tail.c | Return last lines of a file
| logger-tail.c | Functions to get last lines of a file
| lua/ | Lua plugin
| weechat-lua.c | Main lua functions (load/unload scripts, execute lua code)
| weechat-lua-api.c | Lua scripting API functions
@@ -229,12 +229,12 @@ WeeChat "core" reside in following directories:
| relay-network.c | Network functions for relay
| relay-raw.c | Relay raw buffer
| relay-server.c | Relay server
| relay-upgrade.c | Save/restore relay data when upgrading WeeChat
| relay-websocket.c | Websocket server functions for relay (RFC 6455)
| relay-upgrade.c | Save/restore of relay data when upgrading WeeChat
| relay-websocket.c | WebSocket server functions (RFC 6455)
| irc/ | IRC proxy
| relay-irc.c | Main IRC proxy functions
| weechat/ | Relay for remote interface
| relay-weechat.c | Relay for remote interface (main functions)
| weechat/ | Relay for remote interfaces
| relay-weechat.c | Relay for remote interfaces (main functions)
| relay-weechat-msg.c | Send binary messages to clients
| relay-weechat-nicklist.c | Nicklist functions
| relay-weechat-protocol.c | Read commands from clients
@@ -250,7 +250,7 @@ WeeChat "core" reside in following directories:
| weechat-ruby-api.c | Ruby scripting API functions
| script/ | Scripts manager
| script.c | Main functions for scripts manager
| script-action.c | Actions on scripts (load/unload, install/remove, hold, ...)
| script-action.c | Actions on scripts (load/unload, install/remove, ...)
| script-buffer.c | Buffer for scripts manager
| script-command.c | Commands for scripts manager
| script-completion.c | Completions for scripts manager
@@ -263,15 +263,15 @@ WeeChat "core" reside in following directories:
| xfer/ | Xfer plugin (IRC DCC file/chat)
| xfer.c | Main xfer functions
| xfer-buffer.c | Xfer buffer
| xfer-chat.c | Xfer DCC chat
| xfer-chat.c | DCC chat
| xfer-command.c | Xfer commands
| xfer-completion.c | Xfer completions
| xfer-config.c | Xfer config options (file xfer.conf)
| xfer-dcc.c | Xfer DCC file
| xfer-dcc.c | DCC file transfer
| xfer-file.c | File functions for xfer
| xfer-info.c | Xfer info/infolists/hdata
| xfer-network.c | Network functions for xfer
| xfer-upgrade.c | Save/restore xfer data when upgrading WeeChat
| xfer-upgrade.c | Save/restore of xfer data when upgrading WeeChat
|===
[[documentation_translations]]
@@ -285,9 +285,9 @@ Documentation files:
| doc/ | Documentation
| asciidoc.conf | Asciidoc configuration file (some macros)
| asciidoc.css | Asciidoc style
| docgen.py | Python script to build files in "autogen/" directory (see below)
| docgen.py | Python script to build files in 'autogen/' directory (see below)
| XX/ | Documentation for language XX (languages: en, fr, de, it, ...)
| weechat.1.XX.txt | Man page
| weechat.1.XX.txt | Man page (`man weechat`)
| weechat_quickstart.XX.txt | Quickstart guide
| weechat_user.XX.txt | User's guide
| weechat_faq.XX.txt | FAQ
@@ -295,14 +295,15 @@ Documentation files:
| weechat_scripting.XX.txt | Scripting guide
| weechat_tester.XX.txt | Tester's guide
| weechat_dev.XX.txt | Developer's guide (this document)
| weechat_relay_protocol.XX.txt | Relay protocol
| weechat_relay_protocol.XX.txt | Relay protocol (for remote interfaces)
| cmdline_options.XX.txt | Command-line options (file included in man page and user's guide)
| autogen/ | Files auto-built with script docgen.py (do *NEVER* update manually!)
| autogen/ | Files auto-built with script docgen.py
| user/ | Files auto-built for user's guide (do *NEVER* update manually!)
| plugin_api/ | Files auto-built for plugin API (do *NEVER* update manually!)
|===
Translations for WeeChat and plugins are done with gettext, files are in 'po/' directory:
Translations for WeeChat and plugins are done with gettext, files are in 'po/'
directory:
[width="100%",cols="1v,5",options="header"]
|===
@@ -319,9 +320,15 @@ Translations for WeeChat and plugins are done with gettext, files are in 'po/' d
=== General rules
* In source code, your comments, variable names, .. must be written in English
*only* (no other language is allowed)
* Use a copyright header in each new source file, with date, name, e-mail,
license and below that a short description of file. Example in C:
*only* (no other language is allowed).
* Use a copyright header in each new source file with:
** short description of file (one line),
** date,
** name,
** e-mail,
** license.
Example in C:
[source,C]
----
@@ -356,8 +363,8 @@ Some basic rules you *must* follow when you write C code:
* Try to not exceed 80 chars by line, except if this is needed to increase
readability.
* Use comments `/* comment */` (not C99-style comments like `// comment`).
* Add a comment before any function, to explain what does the function (always
use a multi-line comment, even if description is very short).
* Add a comment before any function, to explain what it does (always use a
multi-line comment, even if description is very short).
Example:
@@ -406,7 +413,7 @@ foo ()
----
* Use parentheses to explicitly show how expression is evaluated, even if
they are not required, for example: write `x + (y * z)` instead of `x + y * z`
they are not required, for example: write `x + (y * z)` instead of `x + y * z`.
* Place curly brackets `{ }` alone on lines, and indent them with number of
spaces used for line above opening curly bracket (the `if` in example):
@@ -462,7 +469,7 @@ irc_server_outqueue_send (struct t_irc_server *server)
----
* Indent the `if` conditions, and use parentheses around conditions with an
operator (not needed for single booleans), like this:
operator (not needed for single boolean), like this:
[source,C]
----
@@ -492,19 +499,19 @@ else
----
switch (string[0])
{
case 'A': /* first case */
case 'A': /* first case */
foo ("abc", "def");
break;
case 'B': /* second case */
case 'B': /* second case */
bar (1, 2, 3);
break;
default: /* other cases */
default: /* other cases */
baz ();
break;
}
----
* Use `typedef` for function prototypes, not structures:
* Use `typedef` for function prototypes but not for structures:
[source,C]
----
@@ -526,7 +533,7 @@ struct t_hook_fd *new_hook_fd;
new_hook_fd = malloc (sizeof (*new_hook_fd));
----
* This lisp code can be used in your '~/.emacs.el' to indent properly if you are
* This Lisp code can be used in your '~/.emacs.el' to indent properly if you are
using Emacs as text editor:
[source,lisp]
@@ -554,8 +561,8 @@ See http://www.python.org/dev/peps/pep-0008/
==== Files
File names are composed by letters and hyphens, with format: 'xxx-yyyyy.[ch]',
where 'xxx' is directory/component (can be abbreviation) where the file is, and
'yyyyy' a name for the file, which shows the purpose of file.
where 'xxx' is directory/component (can be abbreviation) and 'yyyyy' a name for
the file.
The main file of a directory may have same name as directory, for example
'irc.c' in irc plugin.
@@ -625,7 +632,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */
----
There is no naming convention for local variables (in functions). The only
recommendation is that name is explicit (not too short).
recommendation is that name is explicit (not too short). +
Nevertheless, pointers to structures are often named 'ptr_xxxx', for example a
pointer on a 'struct t_gui_buffer *' will be: '*ptr_buffer'.
@@ -633,7 +640,7 @@ pointer on a 'struct t_gui_buffer *' will be: '*ptr_buffer'.
==== Functions
Naming convention for functions is the same as
<<naming_convention_variables,variables,>>.
<<naming_convention_variables,variables>>.
Example: creation of a new window (from 'src/gui/gui-window.c'):
@@ -730,7 +737,7 @@ In following table, these conventions are used:
All combinations are summarized in this table:
[width="100%",cols="3,2,1,5",options="header"]
[width="100%",cols="4,2,2,8",options="header"]
|===
| Code | Example | Areas | Description
| hex[19] + STD | hex[19]`01` | chat + bars | Set attributes and color using option, see table below
@@ -753,16 +760,17 @@ All combinations are summarized in this table:
| hex[19] + "b" + "#" | hex[19]`b#` | input bar | Move cursor char (used only in item "input_text")
| hex[19] + "b" + "i" | hex[19]`bi` | bars | Start item
| hex[19] + "b" + "l" (lower L) | hex[19]`bl` | bars | Start line item
| hex[19] + "E" | hex[19]`E` | chat + bars | Emphasize text _(new in version 0.4.2)_
| hex[19] + "E" | hex[19]`E` | chat + bars | Emphasize text _(WeeChat ≥ 0.4.2)_
| hex[19] + hex[1C] | hex[19]hex[1C] | chat + bars | Reset color (keep attributes)
| hex[1A] + ATTR | hex[1A]`*` | chat + bars | Set attribute
| hex[1B] + ATTR | hex[1B]`*` | chat + bars | Remove attribute
| hex[1C] | hex[1C] | chat + bars | Reset attributes and color
|===
Color codes using options (see 't_gui_color_enum', in file 'src/gui/gui-color.h'):
Color codes using options (see 't_gui_color_enum', in file
'src/gui/gui-color.h'):
[width="60%",cols="^1m,10",options="header"]
[width="70%",cols="^1m,10",options="header"]
|===
| Code | Option
| 00 | weechat.color.separator
@@ -799,21 +807,21 @@ Color codes using options (see 't_gui_color_enum', in file 'src/gui/gui-color.h'
| 31 | weechat.color.chat_text_found
| 32 | weechat.color.chat_value
| 33 | weechat.color.chat_prefix_buffer
| 34 | weechat.color.chat_tags _(new in version 0.3.6)_
| 35 | weechat.color.chat_inactive_window _(new in version 0.3.6)_
| 36 | weechat.color.chat_inactive_buffer _(new in version 0.3.6)_
| 37 | weechat.color.chat_prefix_buffer_inactive_buffer _(new in version 0.3.6)_
| 38 | weechat.color.chat_nick_offline _(new in version 0.3.9)_
| 39 | weechat.color.chat_nick_offline_highlight _(new in version 0.3.9)_
| 40 | weechat.color.chat_nick_prefix _(new in version 0.4.1)_
| 41 | weechat.color.chat_nick_suffix _(new in version 0.4.1)_
| 42 | weechat.color.emphasis _(new in version 0.4.2)_
| 43 | weechat.color.chat_day_change _(new in version 0.4.2)_
| 34 | weechat.color.chat_tags _(WeeChat ≥ 0.3.6)_
| 35 | weechat.color.chat_inactive_window _(WeeChat ≥ 0.3.6)_
| 36 | weechat.color.chat_inactive_buffer _(WeeChat ≥ 0.3.6)_
| 37 | weechat.color.chat_prefix_buffer_inactive_buffer _(WeeChat ≥ 0.3.6)_
| 38 | weechat.color.chat_nick_offline _(WeeChat ≥ 0.3.9)_
| 39 | weechat.color.chat_nick_offline_highlight _(WeeChat ≥ 0.3.9)_
| 40 | weechat.color.chat_nick_prefix _(WeeChat ≥ 0.4.1)_
| 41 | weechat.color.chat_nick_suffix _(WeeChat ≥ 0.4.1)_
| 42 | weechat.color.emphasis _(WeeChat ≥ 0.4.2)_
| 43 | weechat.color.chat_day_change _(WeeChat ≥ 0.4.2)_
|===
WeeChat colors are:
[width="40%",cols="^1m,6",options="header"]
[width="70%",cols="^1m,6",options="header"]
|===
| Code | Color
| 00 | Default (terminal foreground/background)
@@ -837,7 +845,7 @@ WeeChat colors are:
Examples of color codes:
[width="50%",cols="1,2",options="header"]
[width="70%",cols="1,2",options="header"]
|===
| Code | Description
| hex[19]`01` | Color of option "01" (chat text)
@@ -853,13 +861,13 @@ Examples of color codes:
== Plugin internals
The file 'src/plugins/weechat-plugin.h' defines and exports all functions
available for API.
available in the API.
A structure called 't_weechat_plugin' is used to store info about plugin
(filename, name, author, description, ...) and all API functions, as pointers
to WeeChat functions.
Then some macros are defined to call these functions in an easier way.
Then some macros are defined to call these functions.
For example, function 'hook_timer' is defined in structure 't_weechat_plugin'
like this:
@@ -915,7 +923,7 @@ component: fix a problem (bug #12345)
Where 'component' is one of following:
* WeeChat core: 'core' (files in directory 'src/' except doc and plugins)
* WeeChat core: 'core' (files in directory 'src/' except 'doc' and 'plugins')
* documentation files: 'doc' (files in directory 'doc/')
* name of a plugin: 'irc', 'python', 'relay', ... (files in directory 'src/plugins/')
@@ -943,16 +951,17 @@ core: update Japanese translations (patch #7783)
==== Gettext
Gettext files are in directory 'po/'.
If you want to initialize a new language, use command `msginit`. For example to
create a dutch empty file:
create a file which is ready to translate to Dutch:
----
$ cd po
$ msginit -i weechat.pot -l nl_NL -o nl.po
----
Base language for WeeChat is English, so you must of course understand English
in order to translate to your language.
Base language for WeeChat is English, so you must of course perfectly understand
English in order to translate to your language.
When done, you *have* to check your file with script 'msgcheck.py'
(https://github.com/flashcode/msgcheck):
@@ -980,18 +989,20 @@ Then create this alias to build files:
/alias doc /perl unload; /python unload; /ruby unload; /lua unload; /tcl unload; /guile unload; /python load docgen.py; /wait 1ms /docgen
----
And use command `/doc` to build all auto-generated files (for all languages).
And use command `/doc` to build all files, for all languages.
[IMPORTANT]
When using command `/doc`, be sure all C plugins (irc, charset, ...) are loaded,
because files are built using options currently in memory.
because files are built using data currently in memory.
[[asciidoc]]
==== Asciidoc
Asciidoc files are in directory 'doc/XX/' where 'XX' is language (en, fr, de, it, ...)
Asciidoc files are in directory 'doc/XX/' where 'XX' is language (en, fr, de,
it, ...).
First make a copy of an English asciidoc file (in directory 'doc/en/'), then work on it.
First make a copy of an English asciidoc file (in directory 'doc/en/'), then
work on it.
The translations missing in files are indicated by this string:
+1 -1
View File
@@ -701,7 +701,7 @@ You can try following tips to consume less memory:
There are 3 ways:
. you can join us on IRC: 'irc.freenode.net', channel '#weechat'
. you can use the savannah website:
. you can use the Savannah website:
* report a bug: https://savannah.nongnu.org/bugs/?group=weechat
* request a new feature: https://savannah.nongnu.org/task/?group=weechat
* send a patch: https://savannah.nongnu.org/patch/?group=weechat
+27 -25
View File
@@ -1,4 +1,4 @@
= WeeChat Plugin API Reference
= WeeChat plugin API reference
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
@@ -136,7 +136,7 @@ Under WeeChat:
=== Plugin example
Full example of plugin, which adds a command '/double': displays two times
arguments on current buffer, or execute two times a command (ok that's not
arguments on current buffer, or execute two times a command (OK that's not
very useful, but that's just an example!):
[source,C]
@@ -263,7 +263,7 @@ name = weechat.plugin_get_name(plugin)
=== Strings
Many string functions below are already available thru standard C functions,
but it's recommended to use functions in this API because they are ok with
but it's recommended to use functions in this API because they are OK with
UTF-8 and locale.
==== weechat_charset_set
@@ -1115,7 +1115,7 @@ Arguments:
Return value:
* same return code as function `regcomp` (0 if ok, other value for error,
* same return code as function `regcomp` (0 if OK, other value for error,
see `man regcomp`)
C example:
@@ -1428,7 +1428,7 @@ C examples:
[source,C]
----
/* examples with english locale */
/* examples with English locale */
char *str = weechat_string_format_size (0); /* str == "0 byte" */
/* ... */
@@ -3632,7 +3632,7 @@ Arguments:
Return value:
* 1 if ok, 0 if error
* 1 if OK, 0 if error
C example:
@@ -4151,7 +4151,7 @@ Arguments:
** 'struct t_config_option *option': option pointer
** 'const char *value': new value for option
** return value:
*** 1 if value is ok
*** 1 if value is OK
*** 0 if value is invalid
* 'callback_check_value_data': pointer given to check_value callback when it
is called by WeeChat
@@ -6472,7 +6472,7 @@ beginning of hooks list, so it will be found and executed before other hooks.
It's useful for modifiers, because execution order is important.
To set a priority, you must use this syntax, for argument where priority is
allowed: "nnn|name" where "nnn" is nonnegative integer with priority and "name"
allowed: "nnn|name" where "nnn" is non-negative integer with priority and "name"
the name for argument (priority does not appear in name, it is automatically
removed from string).
@@ -6870,7 +6870,7 @@ Arguments:
** 'const char *command': command executed by child
** 'int return_code': return code:
*** '>= 0': child return code for a command, and for URL possible values are:
**** '0': transfer ok
**** '0': transfer OK
**** '1': invalid URL
**** '2': transfer error
**** '3': not enough memory
@@ -6907,8 +6907,8 @@ will be called more than one time.
[IMPORTANT]
Even if most of times your callback is called only once, you must ensure that
many calls to callback are ok in your code: you must concatenate data issued by
many calls and use data only when return code is nonnegative.
many calls to callback are OK in your code: you must concatenate data issued by
many calls and use data only when return code is non-negative.
C example:
@@ -7211,11 +7211,11 @@ Arguments:
** 'EXPORT'
** 'NONE'
* 'local_hostname': local hostname to use for connection (optional)
* 'callback': function called when connection is ok or failed, arguments and
* 'callback': function called when connection is OK or failed, arguments and
return value:
** 'void *data': pointer
** 'int status': connection status:
*** 'WEECHAT_HOOK_CONNECT_OK': connection ok
*** '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
*** 'WEECHAT_HOOK_CONNECT_CONNECTION_REFUSED': connection refused
@@ -8122,7 +8122,7 @@ The callback will do following actions when receiving signal:
. create link to new script in directory '~/.weechat/xxx/autoload/'
. load new script
These signals are used by script 'weeget.py' to install scripts.
These signals are used by 'script' plugin to install scripts.
Argument is a string with path to script to install.
@@ -8155,7 +8155,7 @@ Five signals can be sent to remove list of scripts, according to language:
For each script in list, the callback will unload then remove script.
These signals are used by script 'weeget.py' to remove scripts.
These signals are used by 'script' plugin to remove scripts.
Argument is a string with comma-separated list of script to remove (script
is name without path, for example 'script.py').
@@ -8910,12 +8910,14 @@ List of modifiers used by WeeChat and plugins:
| irc_out1_xxx ^(1)^ +
_(WeeChat ≥ 0.3.7)_ |
Server name |
Content of message about to be sent to IRC server (before automatic split to fit in 512 bytes) |
Content of message about to be sent to IRC server (before automatic split to
fit in 512 bytes) |
New content of message
| irc_out_xxx ^(1)^ |
Server name |
Content of message about to be sent to IRC server (after automatic split to fit in 512 bytes) |
Content of message about to be sent to IRC server (after automatic split to
fit in 512 bytes) |
New content of message
| bar_condition_yyy ^(2)^ |
@@ -11804,8 +11806,8 @@ Arguments:
** 'columns_horizontal': items are filled horizontally, displayed with columns
** 'columns_vertical': items are filled vertically, displayed with columns
* 'filling_left_right':
** 'horizontal': items are filled horitontally (space after each item)
** 'vertical': items are filled verticaly (new line after each item)
** 'horizontal': items are filled horizontally (space after each item)
** 'vertical': items are filled vertically (new line after each item)
** 'columns_horizontal': items are filled horizontally, displayed with columns
** 'columns_vertical': items are filled vertically, displayed with columns
* 'size': bar size in chars (0 means automatic size)
@@ -12015,7 +12017,7 @@ Network functions.
==== weechat_network_pass_proxy
Establish a connection/authentification to a proxy.
Establish a connection/authentication to a proxy.
[IMPORTANT]
This function is blocking on call to connect(), so it must be called in a forked
@@ -12040,7 +12042,7 @@ Arguments:
Return value:
* 1 if connection is ok, 0 if an error occurred
* 1 if connection is OK, 0 if an error occurred
C example:
@@ -14231,7 +14233,7 @@ Arguments:
Return value:
* 1 if ok, 0 if error
* 1 if OK, 0 if error
C example:
@@ -14454,7 +14456,7 @@ Arguments:
Return value:
* 1 if ok, 0 if error
* 1 if OK, 0 if error
C example:
@@ -14462,7 +14464,7 @@ C example:
----
if (weechat_upgrade_write_object (upgrade_file, 1, &infolist))
{
/* ok */
/* OK */
}
else
{
@@ -14514,7 +14516,7 @@ Arguments:
Return value:
* 1 if ok, 0 if error
* 1 if OK, 0 if error
C example:
+1 -1
View File
@@ -1,4 +1,4 @@
= WeeChat Quick Start Guide
= WeeChat quick start guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
+210 -167
View File
@@ -1,4 +1,4 @@
= WeeChat Relay Protocol
= WeeChat Relay protocol
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
@@ -6,7 +6,7 @@
:toclevels: 4
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.
@@ -21,7 +21,7 @@ The following terms are used in this document:
* 'relay': this is the WeeChat with relay plugin, which acts as "server" and
allows 'clients' to connect
* 'client': this is another software, connected to 'relay' via a network
connection; in most cases, this 'client' is a remote interface
connection; in most cases, this 'client' is a remote interface.
[[network_diagram]]
=== Network diagram
@@ -49,15 +49,14 @@ network servers ncurses interface relay remote interfaces
[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).
'IRC proxy' (not described in this document).
[[protocol_generalities]]
== Protocol generalities
* Connections from 'client' to 'relay' are made using TCP sockets on IP/port
used by 'relay' plugin to listen to new connections
(option 'relay.port.weechat' in WeeChat).
* Number of 'clients' is not limited.
used by 'relay' plugin to listen to new connections.
* Number of 'clients' is limited by the option 'relay.network.max_clients'.
* Each 'client' is independent from other clients.
* Messages from 'client' to 'relay' are called 'commands', they are sent as text
(a string).
@@ -76,7 +75,7 @@ Fields are:
("_") (ids starting with underscore are reserved for WeeChat 'event' messages)
* 'command': a command (see table below)
* 'arguments': optional arguments for command (many arguments are separated by
spaces)
spaces).
List of available commands (detail in next chapters):
@@ -84,10 +83,10 @@ List of available commands (detail in next chapters):
|===
| Command | Description
| init | Initialize connection with 'relay'
| hdata | Request hdata
| info | Request info
| infolist | Request infolist
| nicklist | Request nicklist
| hdata | Request a 'hdata'
| info | Request an 'info'
| infolist | Request an 'infolist'
| nicklist | Request a 'nicklist'
| input | Send data to a buffer (text or command)
| sync | Synchronize buffer(s) (get updates for buffer(s))
| desync | Desynchronize buffer(s) (stop updates for buffer(s))
@@ -113,11 +112,11 @@ Arguments:
** 'password': password used to authenticate on 'relay' (option
'relay.network.password' in WeeChat)
** 'compression': compression type:
*** 'zlib': enable zlib compression for messages sent by 'relay'
*** 'zlib': enable 'zlib' compression for messages sent by 'relay'
*** 'off': disable compression
[NOTE]
Compression 'zlib' is enabled by default if 'relay' supports zlib compression.
Compression 'zlib' is enabled by default if 'relay' supports 'zlib' compression.
Examples:
@@ -132,7 +131,7 @@ init password=mypass,compression=off
[[command_hdata]]
=== hdata
Request hdata.
Request a 'hdata'.
Syntax:
@@ -149,9 +148,8 @@ Arguments:
(count allowed, see below)
** 'var': a variable name in parent hdata (previous name in path)
(count allowed, see below)
* 'keys': comma-separated list of keys to return in hdata returned (if not
specified, all keys are returned, which is not recommended on large hdata
structures)
* 'keys': comma-separated list of keys to return in hdata (if not specified, all
keys are returned, which is not recommended on large hdata structures)
A count is allowed after pointer and variables, with format "(N)". Possible
values are:
@@ -164,21 +162,21 @@ Examples:
----
# request all buffers, hdata of type "buffer" is returned
# keys number and name are returned for each buffer
# keys "number" and "name" are returned for each buffer
hdata buffer:gui_buffers(*) number,name
# request all lines of all buffers, hdata of type "line_data" is returned
# all keys are returned
hdata buffer:gui_buffers(*)/lines/first_line(*)/data
# request full_name of first buffer
# request full name of first buffer
hdata buffer:gui_buffers full_name
----
[[command_info]]
=== info
Request info.
Request an 'info'.
Syntax:
@@ -199,7 +197,7 @@ info version
[[command_infolist]]
=== infolist
Request infolist.
Request an 'infolist'.
[IMPORTANT]
Content of infolist is a duplication of actual data. Wherever possible, use
@@ -209,13 +207,14 @@ faster, uses less memory and returns smaller objects in message).
Syntax:
----
(id) infolist <name> <arguments>
(id) infolist <name> [<pointer> [<arguments>]]
----
Arguments:
* 'name': name of infolist to retrieve
* 'arguments': arguments for infolist
* 'pointer': pointer (optional)
* 'arguments': arguments (optional)
Example:
@@ -226,7 +225,7 @@ infolist buffer
[[command_nicklist]]
=== nicklist
Request nicklist, for one or all buffers.
Request a 'nicklist', for one or all buffers.
Syntax:
@@ -271,7 +270,7 @@ Examples:
----
input core.weechat /help filter
input irc.freenode.#weechat hello guys!
input irc.freenode.#weechat hello!
----
[[command_sync]]
@@ -284,7 +283,7 @@ Synchronize one or more buffers, to get updates.
[IMPORTANT]
It is recommended to send this command immediately after you asked
data for buffers (lines, ...). It can be send in same message (after a new
line).
line char: "\n").
Syntax:
@@ -300,14 +299,14 @@ Arguments:
* 'options': one of following keywords, separated by commas (default is
'buffers,upgrade,buffer,nicklist' for "*" and 'buffer,nicklist' for a buffer):
** 'buffers': receive signals about buffers (opened/closed, moved, renamed,
merged/unmerged, renamed); this can be used only with name "*"
_(new in version 0.4.1)_
merged/unmerged); this can be used only with name "*"
_(WeeChat ≥ 0.4.1)_
** 'upgrade': receive signals about WeeChat upgrade (upgrade, upgrade ended);
this can be used only with name "*"
_(new in version 0.4.1)_
_(WeeChat ≥ 0.4.1)_
** 'buffer': receive signals about buffer (new lines, type changed, title
changed, local variable added/removed, and same signals as 'buffers' for the
buffer) _(updated in version 0.4.1)_
changed, local variable added/removed, and same signals as 'buffers' for the
buffer) _(updated in version 0.4.1)_
** 'nicklist': receive nicklist after changes
Examples:
@@ -340,7 +339,7 @@ Desynchronize one or more buffers, to stop updates.
[NOTE]
This will remove 'options' for buffers. If some options are still active for
buffers, the client will still receive updates for buffers.
buffers, the client will still receive updates for these buffers.
Syntax:
@@ -355,7 +354,7 @@ Arguments:
specify all buffers
* 'options': one of following keywords, separated by commas (default is
'buffers,upgrade,buffer,nicklist' for "*" and 'buffer,nicklist' for a buffer);
see <<command_sync,command sync>> for values.
see <<command_sync,command sync>> for values
[NOTE]
When using buffer "*", the other buffers synchronized (using a name) are kept. +
@@ -385,11 +384,12 @@ desync irc.freenode.#weechat
Test command: WeeChat will reply with various different objects.
This command is useful to test the decoding of objects returned by WeeChat.
This command is useful to test the decoding of binary objects returned by
WeeChat.
[IMPORTANT]
You must not use the pointer values returned by this command, they are not
valid. This command should only be used to test decoding of a message sent by
valid. This command must be used only to test decoding of a message sent by
WeeChat.
Syntax:
@@ -422,19 +422,19 @@ Returned objects (in this order):
| pointer | ptr | 0x1234abcd
| pointer | ptr | NULL
| time | tim | 1321993456
| array of strings | arr str | { "abc", "de" }
| array of integers | arr int | { 123, 456, 789 }
| array of strings | arr str | [ "abc", "de" ]
| array of integers | arr int | [ 123, 456, 789 ]
|===
[[command_ping]]
=== ping
_Added in version 0.4.2._
_WeeChat ≥ 0.4.2._
Send a ping to WeeChat which will reply with a message "_pong" and same arguments.
This command is useful to test that connection with WeeChat is still alive and
measure the network lag.
measure the response time.
Syntax:
@@ -483,10 +483,10 @@ Messages are sent as binary data, using following format (with size in bytes):
....
* 'length' (unsigned integer): number of bytes of whole message (including
this length)
this field)
* 'compression' (byte): flag:
** '0x00': following data is not compressed
** '0x01': following data is zlib-compressed
** '0x01': following data is compressed with 'zlib'
* 'id' (string): 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
@@ -497,12 +497,12 @@ Messages are sent as binary data, using following format (with size in bytes):
=== Compression
If flag 'compression' is equal to 0x01, then *all* data after is compressed
with zlib, and therefore must be uncompressed before being processed.
with 'zlib', and therefore must be uncompressed before being processed.
[[message_identifier]]
=== Identifier
There are two different identifiers ('id'):
There are two types of identifiers ('id'):
* 'id' sent by 'client': 'relay' will answer with same 'id' in its answer
* 'id' of an event: on some events, 'relay' will send message to 'client' using
@@ -512,30 +512,66 @@ WeeChat reserved identifiers:
[width="100%",cols="5,5,3,4,7",options="header"]
|===
| Identifier | Description | Received with sync | Data sent | Recommended action in client
| _buffer_opened | Buffer opened | buffers / buffer | hdata: buffer | Open buffer
| _buffer_moved | Buffer moved | buffers / buffer | hdata: buffer | Move buffer
| _buffer_merged | Buffer merged | buffers / buffer | hdata: buffer | Merge buffer
| _buffer_unmerged | Buffer unmerged | buffers / buffer | hdata: buffer | Unmerge buffer
| _buffer_renamed | Buffer renamed | buffers / buffer | hdata: buffer | Rename buffer
| _buffer_title_changed | Title of buffer changed | buffers / buffer | hdata: buffer | Change title of buffer
| _buffer_type_changed | Type of buffer changed | buffer | hdata: buffer | Change type of buffer
| _buffer_localvar_added | Local variable added | buffer | hdata: buffer | Add local variable in buffer
| _buffer_localvar_changed | Local variable changed | buffer | hdata: buffer | Change local variable in buffer
| _buffer_localvar_removed | Local variable removed | buffer | hdata: buffer | Remove local variable from buffer
| _buffer_line_added | Line added in buffer | buffer | hdata: line | Display line in buffer
| _buffer_closing | Buffer closing | buffers / buffer | hdata: buffer | Close buffer
| _nicklist | Nicklist for a buffer | nicklist | hdata: nicklist_item | Replace nicklist
| _nicklist_diff | Nicklist diffs for a buffer | nicklist | hdata: nicklist_item | Update nicklist
| _pong | Answer to a "ping" | (always) | string: ping arguments | Measure network lag
| _upgrade | WeeChat is upgrading | upgrade | (empty) | Desync from WeeChat (or disconnect)
| _upgrade_ended | Upgrade of WeeChat done | upgrade | (empty) | Sync/resync with WeeChat
| Identifier | Received with 'sync' | Data sent |
Description | Recommended action in client
| _buffer_opened | buffers / buffer | hdata: buffer |
Buffer opened | Open buffer
| _buffer_moved | buffers / buffer | hdata: buffer |
Buffer moved | Move buffer
| _buffer_merged | buffers / buffer | hdata: buffer |
Buffer merged | Merge buffer
| _buffer_unmerged | buffers / buffer | hdata: buffer |
Buffer unmerged | Unmerge buffer
| _buffer_renamed | buffers / buffer | hdata: buffer |
Buffer renamed | Rename buffer
| _buffer_title_changed | buffers / buffer | hdata: buffer |
Title of buffer changed | Change title of buffer
| _buffer_type_changed | buffer | hdata: buffer |
Type of buffer changed | Change type of buffer
| _buffer_localvar_added | buffer | hdata: buffer |
Local variable added | Add local variable in buffer
| _buffer_localvar_changed | buffer | hdata: buffer |
Local variable changed | Change local variable in buffer
| _buffer_localvar_removed | buffer | hdata: buffer |
Local variable removed | Remove local variable from buffer
| _buffer_line_added | buffer | hdata: line |
Line added in buffer | Display line in buffer
| _buffer_closing | buffers / buffer | hdata: buffer |
Buffer closing | Close buffer
| _nicklist | nicklist | hdata: nicklist_item |
Nicklist for a buffer | Replace nicklist
| _nicklist_diff | nicklist | hdata: nicklist_item |
Nicklist diffs for a buffer | Update nicklist
| _pong | (always) | string: ping arguments |
Answer to a "ping" | Measure response time
| _upgrade | upgrade | (empty) |
WeeChat is upgrading | Desync from WeeChat (or disconnect)
| _upgrade_ended | upgrade | (empty) |
Upgrade of WeeChat done | Sync/resync with WeeChat
|===
[[message_buffer_opened]]
==== _buffer_opened
It is sent to the client when the signal "buffer_opened" is sent by WeeChat.
This message is sent to the client when the signal "buffer_opened" is sent by
WeeChat.
Data sent as hdata:
@@ -552,7 +588,7 @@ Data sent as hdata:
| next_buffer | pointer | Pointer to next buffer
|===
Example: join of channel '#weechat' on freenode, new buffer
Example: channel '#weechat' joined on freenode, new buffer
'irc.freenode.#weechat':
[source,python]
@@ -577,17 +613,18 @@ hda:
[[message_buffer_moved]]
==== _buffer_moved
It is sent to the client when the signal "buffer_moved" is sent by WeeChat.
This message is sent to the client when the signal "buffer_moved" is sent by
WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
|===
Example: buffer 'irc.freenode.#weechat' moved to number 2:
@@ -609,17 +646,18 @@ hda:
[[message_buffer_merged]]
==== _buffer_merged
It is sent to the client when the signal "buffer_merged" is sent by WeeChat.
This message is sent to the client when the signal "buffer_merged" is sent by
WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
|===
Example: buffer 'irc.freenode.#weechat' merged with buffer #2:
@@ -641,17 +679,18 @@ hda:
[[message_buffer_unmerged]]
==== _buffer_unmerged
It is sent to the client when the signal "buffer_unmerged" is sent by WeeChat.
This message is sent to the client when the signal "buffer_unmerged" is sent by
WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| prev_buffer | pointer | Pointer to previous buffer
| next_buffer | pointer | Pointer to next buffer
|===
Example: buffer 'irc.freenode.#weechat' unmerged:
@@ -673,7 +712,8 @@ hda:
[[message_buffer_renamed]]
==== _buffer_renamed
It is sent to the client when the signal "buffer_renamed" is sent by WeeChat.
This message is sent to the client when the signal "buffer_renamed" is sent by
WeeChat.
Data sent as hdata:
@@ -706,17 +746,17 @@ hda:
[[message_buffer_title_changed]]
==== _buffer_title_changed
It is sent to the client when the signal "buffer_title_changed" is sent by
WeeChat.
This message is sent to the client when the signal "buffer_title_changed" is
sent by WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| title | string | Buffer title
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| title | string | Buffer title
|===
Example: topic changed on channel '#weechat':
@@ -737,19 +777,20 @@ hda:
[[message_buffer_type_changed]]
==== _buffer_type_changed
It is sent to the client when the signal "buffer_type_changed" is sent by WeeChat.
This message is sent to the client when the signal "buffer_type_changed" is sent
by WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| type | integer | Buffer type: 0 = formatted (default), 1 = free content
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| type | integer | Buffer type: 0 = formatted (default), 1 = free content
|===
Example: type of buffer 'script.scripts' changed from 'formatted' (0) to free
Example: type of buffer 'script.scripts' changed from formatted (0) to free
content (1):
[source,python]
@@ -768,8 +809,8 @@ hda:
[[message_buffer_localvar_added]]
==== _buffer_localvar_added
It is sent to the client when the signal "buffer_localvar_added" is sent by
WeeChat.
This message is sent to the client when the signal "buffer_localvar_added" is
sent by WeeChat.
Data sent as hdata:
@@ -801,8 +842,8 @@ hda:
[[message_buffer_localvar_changed]]
==== _buffer_localvar_changed
It is sent to the client when the signal "buffer_localvar_changed" is sent by
WeeChat.
This message is sent to the client when the signal "buffer_localvar_changed" is
sent by WeeChat.
Data sent as hdata:
@@ -834,8 +875,8 @@ hda:
[[message_buffer_localvar_removed]]
==== _buffer_localvar_removed
It is sent to the client when the signal "buffer_localvar_removed" is sent by
WeeChat.
This message is sent to the client when the signal "buffer_localvar_removed" is
sent by WeeChat.
Data sent as hdata:
@@ -866,24 +907,25 @@ hda:
[[message_buffer_line_added]]
==== _buffer_line_added
It is sent to the client when the signal "buffer_line_added" is sent by WeeChat.
This message is sent to the client when the signal "buffer_line_added" is sent
by WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| buffer | pointer | Buffer pointer
| date | time | Date of message
| date_printed | time | Date when WeeChat displayed message
| displayed | char | 1 if message is displayed, 0 if message is filtered (hidden)
| highlight | char | 1 if line has a highlight, otherwise 0
| tags_array | array of strings | List of tags for line
| prefix | string | Prefix
| message | string | Message
| Name | Type | Description
| buffer | pointer | Buffer pointer
| date | time | Date of message
| date_printed | time | Date when WeeChat displayed message
| displayed | char | 1 if message is displayed, 0 if message is filtered (hidden)
| highlight | char | 1 if line has a highlight, otherwise 0
| tags_array | array of strings | List of tags for line
| prefix | string | Prefix
| message | string | Message
|===
Example: new message 'hello!' from nick 'FlashCode' in buffer 'irc.freenode.#weechat':
Example: new message 'hello!' from nick 'FlashCode' on buffer 'irc.freenode.#weechat':
[source,python]
----
@@ -907,15 +949,16 @@ hda:
[[message_buffer_closing]]
==== _buffer_closing
It is sent to the client when the signal "buffer_closing" is sent by WeeChat.
This message is sent to the client when the signal "buffer_closing" is sent by
WeeChat.
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
| Name | Type | Description
| number | integer | Buffer number (≥ 1)
| full_name | string | Full name (example: 'irc.freenode.#weechat')
|===
Example: buffer 'irc.freenode.#weechat' is being closed by WeeChat:
@@ -935,8 +978,8 @@ hda:
[[message_nicklist]]
==== _nicklist
It is sent to the client when large updates are made on a nicklist (groups/nicks
added/removed/changed). The message contains full nicklist.
This message is sent to the client when large updates are made on a nicklist
(groups/nicks added/removed/changed). The message contains full nicklist.
When small updates are made on a nicklist (for example just add one nick),
another message with identifier '_nicklist_diff' is sent (see below).
@@ -945,14 +988,14 @@ Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| group | char | 1 for a group, 0 for a nick
| visible | char | 1 if group/nick is displayed, otherwise 0
| level | integer | Level of group (0 for a nick)
| name | string | Name of group/nick
| color | string | Name color
| prefix | string | Prefix (only for a nick)
| prefix_color | string | Prefix color (only for a nick)
| Name | Type | Description
| group | char | 1 for a group, 0 for a nick
| visible | char | 1 if group/nick is displayed, otherwise 0
| level | integer | Level of group (0 for a nick)
| name | string | Name of group/nick
| color | string | Name color
| prefix | string | Prefix (only for a nick)
| prefix_color | string | Prefix color (only for a nick)
|===
Example: nicklist for buffer 'irc.freenode.#weechat':
@@ -1023,25 +1066,25 @@ hda:
[[message_nicklist_diff]]
==== _nicklist_diff
_New in version 0.4.1._
_WeeChat ≥ 0.4.1._
It is sent to the client when small updates are made on a nicklist (groups/nicks
added/removed/changed). The message contains nicklist differences (between old
nicklist and current one).
This message is sent to the client when small updates are made on a nicklist
(groups/nicks added/removed/changed). The message contains nicklist differences
(between old nicklist and current one).
Data sent as hdata:
[width="100%",cols="3m,2,10",options="header"]
|===
| Name | Type | Description
| _diff | char | Type of diff (see below)
| group | char | 1 for a group, 0 for a nick
| visible | char | 1 if group/nick is displayed, otherwise 0
| level | integer | Level of group (0 for a nick)
| name | string | Name of group/nick
| color | string | Name color
| prefix | string | Prefix (only for a nick)
| prefix_color | string | Prefix color (only for a nick)
| Name | Type | Description
| _diff | char | Type of diff (see below)
| group | char | 1 for a group, 0 for a nick
| visible | char | 1 if group/nick is displayed, otherwise 0
| level | integer | Level of group (0 for a nick)
| name | string | Name of group/nick
| color | string | Name color
| prefix | string | Prefix (only for a nick)
| prefix_color | string | Prefix color (only for a nick)
|===
The value of '_diff' can be:
@@ -1118,21 +1161,21 @@ hda:
[[message_pong]]
==== _pong
_New in version 0.4.2._
_WeeChat ≥ 0.4.2._
It is sent to the client when WeeChat receives a "ping" message.
This message is sent to the client when 'relay' receives a "ping" message.
Data sent as string: arguments received in the ping message.
Data sent as string: arguments received in the "ping" message.
The recommended action in client is to measure network lag and disconnect if
network lag is high.
The recommended action in client is to measure the response time and disconnect
if it is high.
[[message_upgrade]]
==== _upgrade
_New in version 0.3.8._
_WeeChat ≥ 0.3.8._
It is sent to the client when WeeChat is starting upgrade process.
This message is sent to the client when WeeChat is starting upgrade process.
There is no data in the message.
@@ -1141,15 +1184,16 @@ The recommended action in client is to desynchronize from WeeChat (send command
will change).
[NOTE]
During WeeChat upgrade, the socket remains opened (except if connection was made
with SSL).
During WeeChat upgrade, the socket remains opened (except if connection uses
SSL).
[[message_upgrade_ended]]
==== _upgrade_ended
_New in version 0.3.8._
_WeeChat ≥ 0.3.8._
It is sent to the client when WeeChat has finished the upgrade process.
This message is sent to the client when WeeChat has finished the upgrade
process.
There is no data in the message.
@@ -1159,15 +1203,14 @@ commands sent on startup after the 'init'.
[[objects]]
=== Objects
Objects are identified by 3 letters, called 'type'. Following types are
available:
Objects are identified by 3 letters, called 'type'. Following types are used:
[width="100%",cols="^2m,5,10",options="header"]
|===
| Type | Value | Length
| chr | Signed char | 1 byte
| int | Signed integer | 4 bytes
| lon | Signed long integer | 1 byte + length of long as string
| lon | Signed long integer | 1 byte + length of integer as string
| str | String | 4 bytes + length of string (without final '\0')
| buf | Buffer of bytes | 4 bytes + length of data
| ptr | Pointer | 1 byte + length of pointer as string
@@ -1176,13 +1219,13 @@ available:
| hda | Hdata content | Variable
| inf | Info: name + content | Variable
| inl | Infolist content | Variable
| arr | Array of values | 3 bytes (type) + number of items + data
| arr | Array of objects | 3 bytes (type) + number of objects + data
|===
[[object_char]]
==== Char
A signed char is 1 byte.
A signed char is stored as 1 byte.
Example:
@@ -1195,8 +1238,8 @@ Example:
[[object_integer]]
==== Integer
A signed integer is 4 bytes, encoded as big-endian format (most significant byte
first).
A signed integer is stored as 4 bytes, encoded as big-endian format (most
significant byte first).
Range: -2147483648 to 2147483647.
@@ -1364,8 +1407,8 @@ objects, and then set of objects (path with pointers, then objects).
* 'values': list of values (number of values is number of keys returned for
hdata)
Example of hdata with 2 buffers (weechat core and freenode server) and two keys
('number' and 'full_name'):
Example of hdata with two buffers (weechat core and freenode server) and two
keys ('number' and 'full_name'):
....
# command
@@ -1509,7 +1552,7 @@ An item is:
** 'type': type of variable ('int', 'str', ...)
** 'value': value of variable
Example of infolist with 2 buffers (weechat core and freenode server):
Example of infolist with two buffers (weechat core and freenode server):
....
# command
@@ -1532,9 +1575,9 @@ infolist buffer
[[object_array]]
==== Array
An array is a type (3 bytes) + number of items (integer on 4 bytes) + data.
An array is a type (3 bytes) + number of objects (integer on 4 bytes) + data.
Example of array with 2 strings:
Example of array with two strings:
....
┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥──
@@ -1544,13 +1587,13 @@ Example of array with 2 strings:
type number of strings length
──╥────┬────┬────╥────┬────┬────┬────╥────┬────┐
... ║ 61 │ 62 │ 63 ║ 00 │ 00 │ 00 │ 02 ║ 64 │ 65 │ ────► { "abc", "de" }
... ║ 61 │ 62 │ 63 ║ 00 │ 00 │ 00 │ 02 ║ 64 │ 65 │ ────► [ "abc", "de" ]
──╨────┴────┴────╨────┴────┴────┴────╨────┴────┘
└────────────┘ └─────────────────┘ └───────┘
'a' 'b' 'c' length 'd' 'e'
....
Example of array with 3 integers:
Example of array with three integers:
....
┌─────╥────┬────┬────┬────╥────┬────┬────┬────╥──
@@ -1560,7 +1603,7 @@ Example of array with 3 integers:
type number of integers 123 (0x7B)
──╥────┬────┬────┬────╥────┬────┬────┬────┐
... ║ 00 │ 00 │ 01 │ C8 ║ 00 │ 00 │ 03 │ 15 │ ────► { 123, 456, 789 }
... ║ 00 │ 00 │ 01 │ C8 ║ 00 │ 00 │ 03 │ 15 │ ────► [ 123, 456, 789 ]
──╨────┴────┴────┴────╨────┴────┴────┴────┘
└─────────────────┘ └─────────────────┘
456 (0x1C8) 789 (0x315)
@@ -1617,8 +1660,8 @@ A 'NULL' array:
║ ║ ║
║ ◄───────────────────────────────╢ ║
measure ║ msg: id: "_pong" ... ║ ║
lag ║ ║ ║
║ ........ ║ ........ ║
response ║ ║ ║
time ║ ........ ║ ........ ║
║ ║ ║
╟───────────────────────────────► ║ ║
║ cmd: quit ║ disconnect client ║
+2 -2
View File
@@ -1,4 +1,4 @@
= WeeChat Scripting Guide
= WeeChat scripting guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
@@ -35,7 +35,7 @@ other languages.
[[scripts_in_weechat]]
== Scripts in WeeChat
[[languages_specifities]]
[[languages_specificities]]
=== Languages specificities
==== Python
+1 -1
View File
@@ -1,4 +1,4 @@
= WeeChat Tester's Guide
= WeeChat tester's guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
+3 -3
View File
@@ -1,4 +1,4 @@
= WeeChat User's Guide
= WeeChat user's guide
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: en
@@ -37,8 +37,8 @@ Main features are:
WeeChat homepage is here: http://weechat.org/
[[pre-requisites]]
=== Pre-requisites
[[prerequisites]]
=== Prerequisites
In order to install WeeChat, you need:
+22
View File
@@ -104,4 +104,26 @@ IF(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
ADD_CUSTOM_TARGET(doc-tester-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_tester.fr.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
# relay protocol
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.fr.html
COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -f ${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.conf -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_relay_protocol.fr.txt
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat_relay_protocol.fr.txt
COMMENT "Building weechat_relay_protocol.fr.html"
)
ADD_CUSTOM_TARGET(doc-relay-protocol-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.fr.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_relay_protocol.fr.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
# developer's guide
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.fr.html
COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -f ${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.conf -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.fr.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.fr.txt
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat_dev.fr.txt
COMMENT "Building weechat_dev.fr.html"
)
ADD_CUSTOM_TARGET(doc-dev-fr ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.fr.html)
INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/weechat_dev.fr.html DESTINATION ${SHAREDIR}/doc/${PROJECT_NAME})
ENDIF(ENABLE_DOC AND SOURCEHIGHLIGHT_FOUND)
+14 -2
View File
@@ -29,6 +29,8 @@ EXTRA_DIST = CMakeLists.txt \
weechat_faq.fr.txt \
weechat_quickstart.fr.txt \
weechat_tester.fr.txt \
weechat_relay_protocol.fr.txt \
weechat_dev.fr.txt \
$(wildcard autogen/user/*.txt) \
$(wildcard autogen/plugin_api/*.txt)
@@ -43,7 +45,9 @@ if DOC
weechat_scripting.fr.html \
weechat_faq.fr.html \
weechat_quickstart.fr.html \
weechat_tester.fr.html
weechat_tester.fr.html \
weechat_relay_protocol.fr.html \
weechat_dev.fr.html
doc_install = install-doc
doc_uninstall = uninstall-doc
endif
@@ -79,6 +83,14 @@ weechat_quickstart.fr.html: weechat_quickstart.fr.txt
weechat_tester.fr.html: weechat_tester.fr.txt
$(ASCIIDOC) -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -f $(abs_top_srcdir)/doc/asciidoc.conf -n -o weechat_tester.fr.html $(abs_top_srcdir)/doc/fr/weechat_tester.fr.txt
# relay protocol
weechat_relay_protocol.fr.html: weechat_relay_protocol.fr.txt
$(ASCIIDOC) -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -f $(abs_top_srcdir)/doc/asciidoc.conf -n -o weechat_relay_protocol.fr.html $(abs_top_srcdir)/doc/fr/weechat_relay_protocol.fr.txt
# developer's guide
weechat_dev.fr.html: weechat_dev.fr.txt
$(ASCIIDOC) -a revision="$(VERSION)" -a stylesheet=$(abs_top_srcdir)/doc/asciidoc.css -f $(abs_top_srcdir)/doc/asciidoc.conf -n -o weechat_dev.fr.html $(abs_top_srcdir)/doc/fr/weechat_dev.fr.txt
# install man/docs
install-data-hook: $(man_install) $(doc_install)
@@ -106,5 +118,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1
-rm -f weechat.1 weechat.1.fr.txt cmdline_options.fr.txt
-rm -f *.html
@@ -1,6 +1,6 @@
[width="100%",cols="^1,^2,6,6,6",options="header"]
|===
| Extension | Nom | Description | Hashtable (entrée) | Hashtable (sortie)
| Extension | Nom | Description | Table de hachage (entrée) | Table de hachage (sortie)
| irc | irc_message_parse | analyse un message IRC | "message": message IRC, "server": nom du serveur (optionnel) | "tags": étiquettes, "message_without_tags": message sans les étiquettes, "nick": pseudo, "host": nom d'hôte, "command": commande, "channel": canal, "arguments": paramètres (inclut le canal)
+5 -5
View File
@@ -34,7 +34,7 @@
** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné (valeur par défaut: `red`)
* [[option_irc.color.mirc_remap]] *irc.color.mirc_remap*
** description: `réassigner les couleurs mirc dans les messages en utilisant une hashtable: les clés sont "fg,bg" sous forme d'entiers entre -1 (non spécifié) et 15, les valeurs sont des noms de couleur WeeChat ou nombres (le format est: "1,-1:couleur1;2,7:couleur2"), exemple: "1,-1:darkgray;1,2:white,blue" pour réassigner le noir en "darkgray" et le noir sur bleu en "white,blue"; les couleurs WeeChat par défaut pour les codes IRC sont: 0:white, 1:black, 2:blue, 3:green, 4:lightred, 5:red, 6:magenta, 7:brown, 8:yellow, 9:lightgreen, 10:cyan, 11:lightcyan, 12:lightblue, 13:lightmagenta, 14:gray, 15:white`
** description: `réassigner les couleurs mirc dans les messages en utilisant une table de hachage: les clés sont "fg,bg" sous forme d'entiers entre -1 (non spécifié) et 15, les valeurs sont des noms de couleur WeeChat ou nombres (le format est: "1,-1:couleur1;2,7:couleur2"), exemple: "1,-1:darkgray;1,2:white,blue" pour réassigner le noir en "darkgray" et le noir sur bleu en "white,blue"; les couleurs WeeChat par défaut pour les codes IRC sont: 0:white, 1:black, 2:blue, 3:green, 4:lightred, 5:red, 6:magenta, 7:brown, 8:yellow, 9:lightgreen, 10:cyan, 11:lightcyan, 12:lightblue, 13:lightmagenta, 14:gray, 15:white`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"1,-1:darkgray"`)
@@ -134,9 +134,9 @@
** valeurs: on, off (valeur par défaut: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** description: `liste de messages (séparés par des virgules) à afficher après avoir rejoint un canal: 329 = date de création du canal, 332 = titre, 333 = pseudo/date pour le titre, 366 = noms sur le canal`
** description: `liste de messages (séparés par des virgules) à afficher après avoir rejoint un canal: 329 = date de création du canal, 332 = titre, 333 = pseudo/date pour le titre, 353 = noms sur le canal, 366 = décompte des noms`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"329,332,333"`)
** valeurs: toute chaîne (valeur par défaut: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** description: `afficher l'ancien titre lorsque le titre du canal est changé`
@@ -264,7 +264,7 @@
** valeurs: toute chaîne (valeur par défaut: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** description: `liste des étiquettes (séparées par des virgules) utilisées dans les messages affichés par notify lorsqu'un pseudo a rejoint ou quitté le serveur (résultat de la commande ison), par exemple: "notify_message", "notify_private" ou "notify_highlight"`
** description: `liste des étiquettes (séparées par des virgules) utilisées dans les messages affichés par notify lorsqu'un pseudo a rejoint ou quitté le serveur (résultat de la commande ison ou monitor), par exemple: "notify_message", "notify_private" ou "notify_highlight"`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `"notify_message"`)
@@ -374,7 +374,7 @@
** valeurs: 0 .. 604800 (valeur par défaut: `60`)
* [[option_irc.network.lag_max]] *irc.network.lag_max*
** description: `lax maximum (en secondes): si ce lag est atteint, WeeChat considérera que la réponse du serveur (pong) ne sera jamais reçue et arrêtera de compter le lag (0 = ne jamais abandonner)`
** description: `lag maximum (en secondes): si ce lag est atteint, WeeChat considérera que la réponse du serveur (pong) ne sera jamais reçue et arrêtera de compter le lag (0 = ne jamais abandonner)`
** type: entier
** valeurs: 0 .. 604800 (valeur par défaut: `1800`)
+8 -5
View File
@@ -410,7 +410,7 @@ liste des actions:
switch_active_buffer: basculer vers le tampon mélangé suivant
switch_active_buffer_previous: basculer vers le tampon mélangé précédent
zoom_merged_buffer: zoom sur le tampon mélangé
insert: insérer du texte dans la ligne de commande
insert: insérer du texte dans la ligne de commande (les caractères échappés sont autorisés, voir /help print)
paste_start: début de collage (mode "bracketed paste")
paste_stop: fin de collage (mode "bracketed paste")
@@ -456,7 +456,7 @@ Pour le contexte "mouse" (possible aussi pour le contexte "cursor"), la touche a
item(*): n'importe quel objet de barre
item(xxx): l'objet de barre "xxx"
La touche peut commencer ou se terminer par '*' pour plusieurs évènements de la souris.
Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la hashtable du focus comme paramètre.
Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la table de hachage du focus comme paramètre.
Une autre valeur spéciale "-" peut être utilisée pour désactiver la touche (elle sera ignorée lors de la recherche de touches).
Exemples:
@@ -579,12 +579,13 @@ Sans paramètre, cette commande liste les extensions chargées.
heure: hh:mm:ss (exemple: 04:32:55)
-tags: liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées)
texte: texte à afficher (le préfixe et le message doivent être séparés par \t)
-stdout: afficher le texte sur stdout (pas dans un tampon)
-stderr: afficher le texte sur stderr (pas dans un tampon)
-stdout: afficher le texte sur stdout (les caractères échappés sont interprétés)
-stderr: afficher le texte sur stderr (les caractères échappés sont interprétés)
Les options -action ... -quit utilisent le préfixe défini dans les options "weechat.look.prefix_*".
Avec les options -stdout et -stderr, les caractères échappés sont toujours interprétés.
Les caractères échappés suivants sont supportés:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Exemples:
afficher un pense-bête sur le tampon core avec un highlight:
@@ -595,6 +596,8 @@ Exemples:
/print -core abc\tLe message
afficher un message sur le canal #weechat:
/print -buffer irc.freenode.#weechat Message sur #weechat
afficher un bonhomme de neige (U+2603):
/print -escape \u2603
envoyer une alerte (BEL):
/print -stderr \a
----
+1 -1
View File
@@ -499,7 +499,7 @@
** valeurs: on, off (valeur par défaut: `off`)
* [[option_weechat.look.command_chars]] *weechat.look.command_chars*
** description: `caractères utilisés pour déterminer si la chaîne entrée est une commande ou non: l'entrée doit démarrer avec un de ces caractères; le slash ("/") est toujours considéré comme un préfixe de commande (exemple: ".$")`
** description: `caractères utilisés pour déterminer si la chaîne entrée est une commande ou non: l'entrée doit démarrer avec un de ces caractères; la barre oblique ("/") est toujours considérée comme un préfixe de commande (exemple: ".$")`
** type: chaîne
** valeurs: toute chaîne (valeur par défaut: `""`)
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -730,7 +730,7 @@ Vous pouvez essayer les astuces suivantes pour consommer moins de mémoire :
Il y a 3 possibilités :
. vous pouvez nous joindre sur IRC : 'irc.freenode.net', canal '#weechat'
. vous pouvez utiliser le site savannah :
. vous pouvez utiliser le site Savannah :
* reporter un bug: https://savannah.nongnu.org/bugs/?group=weechat
* demander une nouvelle fonctionnalité: https://savannah.nongnu.org/task/?group=weechat
* envoyer un patch: https://savannah.nongnu.org/patch/?group=weechat
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,4 +1,4 @@
= Guide de Démarrage Rapide WeeChat
= Guide de démarrage rapide WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
File diff suppressed because it is too large Load Diff
+8 -8
View File
@@ -1,4 +1,4 @@
= WeeChat Guide pour Scripts
= Guide pour scripts WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
@@ -36,7 +36,7 @@ l'API est la même pour les autres langages.
[[scripts_in_weechat]]
== Scripts dans WeeChat
[[languages_specifities]]
[[languages_specificities]]
=== Spécificités des langages
==== Python
@@ -271,7 +271,7 @@ rapport de crash ;)
=== Callbacks
Tous les "callbacks" WeeChat doivent retourner WEECHAT_RC_OK ou
WEECHAT_RC_ERROR (l'exception est le callback du "modifier", qui retourne une
WEECHAT_RC_ERROR (l'exception est le callback du modificateur, qui retourne une
chaîne de caractères).
Les "callbacks" C utilisent un paramètre "data", qui est un pointeur. Dans
@@ -662,9 +662,9 @@ Puis sous WeeChat :
----
[[hook_timer]]
==== Ajouter un timer
==== Ajouter un minuteur
Ajoutez un timer avec `hook_timer`.
Ajoutez un minuteur avec `hook_timer`.
Exemple :
@@ -674,7 +674,7 @@ def timer_cb(data, remaining_calls):
# ...
return weechat.WEECHAT_RC_OK
# timer appelé chaque minute quand la seconde est 00
# minuteur appelé chaque minute quand la seconde est 00
weechat.hook_timer(60 * 1000, 60, 0, "timer_cb", "")
----
@@ -869,8 +869,8 @@ weechat.hook_signal("*,irc_in2_join", "join_cb", "")
[[irc_modify_messages]]
==== Modifier des messages
L'extension IRC envoie un "modifier" appelé "irc_in_xxx" ("xxx" est la commande
IRC) pour un message reçu, de sorte que vous puissiez le modifier.
L'extension IRC envoie un modificateur appelé "irc_in_xxx" ("xxx" est la
commande IRC) pour un message reçu, de sorte que vous puissiez le modifier.
[source,python]
----
+24 -24
View File
@@ -1,4 +1,4 @@
= Guide Utilisateur WeeChat
= Guide utilisateur WeeChat
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: fr
@@ -38,7 +38,7 @@ Ses principales fonctionnalités sont les suivantes :
La page d'accueil de WeeChat est ici : http://weechat.org/
[[pre-requisites]]
[[prerequisites]]
=== Prérequis
Pour installer WeeChat, vous devez avoir :
@@ -1177,17 +1177,17 @@ Vous pouvez modifier ou ajouter des associations avec la commande `/key` en
utilisant le contexte "mouse" (pour la syntaxe voir
<<command_weechat_key,la commande /key>>).
Un nom d'évènement consiste en un modifieur (facultatif), un bouton/roulette et
un geste (facultatif). Les différents éléments sont séparés par "-".
Un nom d'évènement consiste en un modificateur (facultatif), un bouton/roulette
et un geste (facultatif). Les différents éléments sont séparés par "-".
Liste des modifieurs :
Liste des modificateurs :
[width="50%",cols="3m,4",options="header"]
|===
| Modifieur | Description
| ctrl | Touche key[ctrl]
| alt | Touche key[alt]
| ctrl-alt | Touches key[ctrl-]key[alt]
| Modificateur | Description
| ctrl | Touche key[ctrl]
| alt | Touche key[alt]
| ctrl-alt | Touches key[ctrl-]key[alt]
|===
Liste des boutons/roulette :
@@ -1527,9 +1527,9 @@ Sections :
|===
| Section | Commande de contrôle | Description
| debug | <<command_weechat_debug,/debug set>> +
/set weechat.debug.* | Niveau de debug, pour le Debug level, pour le cœur et les extensions (les options peuvent être ajoutées/supprimées dans la section)
/set weechat.debug.* | Niveau de debug, pour le cœur et les extensions (les options peuvent être ajoutées/supprimées dans la section)
| startup | /set weechat.startup.* | Options de démarrage
| look | /set weechat.look.* | Look and feel
| look | /set weechat.look.* | Aspect/présentation
| palette | <<command_weechat_color,/color alias>> +
/set weechat.palette.* | Alias de couleurs (les options peuvent être ajoutées/supprimées dans la section)
| color | /set weechat.color.* | Couleurs
@@ -1599,7 +1599,7 @@ Les extensions par défaut sont :
| irc | Discussion avec le protocole IRC
| logger | Enregistrement des tampons dans des fichiers
| relay | Relai de données via le réseau
| rmodifier | Modification des chaînes de "modifier" avec des expressions régulières
| rmodifier | Modification des chaînes de modificateur avec des expressions régulières
| script | Gestionnaire de scripts
| python | Interface (API) pour scripts Python
| perl | Interface (API) pour scripts Perl
@@ -1918,7 +1918,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set irc.look.* | Look and feel
| look | /set irc.look.* | Aspect/présentation
| color | /set irc.color.* | Couleurs
| network | /set irc.network.* | Options réseau
| msgbuffer | /set irc.msgbuffer.* | <<irc_target_buffer,Tampon cible pour les messages IRC>> (les options peuvent être ajoutées/supprimées dans la section)
@@ -2349,7 +2349,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set logger.look.* | Look and feel
| look | /set logger.look.* | Aspect/présentation
| color | /set logger.color.* | Couleurs
| file | /set logger.file.* | Options pour les fichiers de log
| level | /set logger.level.* | Niveau de log par tampon (les options peuvent être ajoutées/supprimées dans la section)
@@ -2506,7 +2506,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set relay.look.* | Look and feel
| look | /set relay.look.* | Aspect/présentation
| color | /set relay.color.* | Couleurs
| network | /set relay.network.* | Options réseau
| irc | /set relay.irc.* | Options spécifiques au protocole irc (proxy irc)
@@ -2598,7 +2598,7 @@ si aucun serveur n'a été spécifié dans le relai).
L'extension Relay peut envoyer les données à une interface distante en
utilisant le protocole WeeChat.
Vous pouvez vous connected avec une interface distante, voir la liste sur la
Vous pouvez vous connecter avec une interface distante, voir la liste sur la
page de téléchargement : http://weechat.org/download
[IMPORTANT]
@@ -2640,7 +2640,7 @@ L'URI doit toujours se terminer par "/weechat" (pour les protocoles 'irc' et
[[rmodifier_plugin]]
=== Extension Rmodifier
L'extension Rmodifier vous permet de modifier les chaînes de "modifier" avec
L'extension Rmodifier vous permet de modifier les chaînes de modificateur avec
des expressions régulières.
L'utilisation typique est pour cacher les mots de passe lorsque vous les tapez,
@@ -2655,7 +2655,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set rmodifier.look.* | Look and feel
| look | /set rmodifier.look.* | Aspect/présentation
| modifier | <<command_rmodifier_rmodifier,/rmodifier add>> +
/set rmodifier.modifier.* | Rmodifiers
|===
@@ -2674,12 +2674,12 @@ include::autogen/user/rmodifier_commands.txt[]
Un rmodifier se compose de trois éléments :
. un ou plusieurs "modifiers"
. un ou plusieurs modificateurs
. une expression régulière, permettant de capturer des "groupes"
. une chaîne décrivant la sortie en utilisant les numéros de "groupes" capturés
dans l'expression régulière
Pour la liste des modifiers utilisés par WeeChat ou des extensions, voir la
Pour la liste des modificateurs utilisés par WeeChat ou des extensions, voir la
'Référence API Extension WeeChat', fonction 'weechat_hook_modifier'.
Pour chaque groupe capturé, les actions suivantes sont possibles :
@@ -2691,14 +2691,14 @@ Pour chaque groupe capturé, les actions suivantes sont possibles :
Exemple du rmodifier par défaut pour la commande `/oper` :
* modifiers : `history_add,input_text_display`
* modificateurs : `history_add,input_text_display`
** `history_add` : appelé lorsque WeeChat stocke la commande dans l'historique
** `input_text_display` : appelé lorsque la ligne de commande a changé
(agit uniquement sur l'affichage, pas le contenu de la ligne de commande)
* expression régulière : `^(/oper +\S+ +)(.*)`
* groupes : `1,2*`
À chaque fois que les modifiers "history_add" ou "input_text_display" sont
À chaque fois que les modificateurs "history_add" ou "input_text_display" sont
appelés, l'expression régulière est vérifiée. Si la chaîne correspond, alors
elle est remplacée par les groupes capturés, tels que définis dans la chaîne
des groupes.
@@ -2734,7 +2734,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set script.look.* | Look and feel
| look | /set script.look.* | Aspect/présentation
| color | /set script.color.* | Couleurs
| scripts | /set script.scripts.* | Options pour le téléchargement des scripts
|===
@@ -2795,7 +2795,7 @@ Sections :
[width="100%",cols="3m,6m,16",options="header"]
|===
| Section | Commande de contrôle | Description
| look | /set xfer.look.* | Look and feel
| look | /set xfer.look.* | Aspect/présentation
| color | /set xfer.color.* | Couleurs
| network | /set xfer.network.* | Options réseau
| file | /set xfer.file.* | Options pour les fichiers envoyés/reçus
+1 -1
View File
@@ -105,5 +105,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1
-rm -f weechat.1 weechat.1.it.txt cmdline_options.it.txt
-rm -f *.html
+3 -3
View File
@@ -134,9 +134,9 @@
** valori: on, off (valore predefinito: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** descrizione: `elenco separato da virgole di messaggi da mostrare dopo l'ingresso in un canale: 329 = data di creazione del canale, 332 = argomento, 333 = nick/data per l'argomento, 366 = nomi sul canale`
** descrizione: `comma-separated list of messages to display after joining a channel: 329 = channel creation date, 332 = topic, 333 = nick/date for topic, 353 = names on channel, 366 = names count`
** tipo: stringa
** valori: qualsiasi stringa (valore predefinito: `"329,332,333"`)
** valori: qualsiasi stringa (valore predefinito: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** descrizione: `visualizza l'argomento del canale precedente quando viene cambiato`
@@ -264,7 +264,7 @@
** valori: qualsiasi stringa (valore predefinito: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** descrizione: `elenco separato da virgole di tag usati nei messaggi mostrati dalle notifiche quando un nick entra o esce da un server (risultato del comando ison), ad esempio: "notify_message", "notify_private" o "notify_highlight"`
** descrizione: `comma separated list of tags used in messages displayed by notify when a nick joins or quits server (result of command ison or monitor), for example: "notify_message", "notify_private" or "notify_highlight"`
** tipo: stringa
** valori: qualsiasi stringa (valore predefinito: `"notify_message"`)
+1 -1
View File
@@ -159,7 +159,7 @@
** valori: qualsiasi stringa (valore predefinito: `"p,n"`)
* [[option_script.look.translate_description]] *script.look.translate_description*
** descrizione: `translate description of scripts (if translation is available in your language, otherwise english version is used)`
** descrizione: `translate description of scripts (if translation is available in your language, otherwise English version is used)`
** tipo: bool
** valori: on, off (valore predefinito: `on`)
+7 -4
View File
@@ -410,7 +410,7 @@ list of actions:
switch_active_buffer: switch to next merged buffer
switch_active_buffer_previous: switch to previous merged buffer
zoom_merged_buffer: zoom on merged buffer
insert: insert text in command line
insert: insert text in command line (escaped chars are allowed, see /help print)
paste_start: start paste (bracketed paste mode)
paste_stop: stop paste (bracketed paste mode)
@@ -579,12 +579,13 @@ Senza argomento, questo comando elenca i plugin caricati.
time: hh:mm:ss (example: 04:32:55)
-tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
text: text to display (prefix and message must be separated by \t)
-stdout: display text on stdout (not in a buffer)
-stderr: display text on stderr (not in a buffer)
-stdout: display text on stdout (escaped chars are interpreted)
-stderr: display text on stderr (escaped chars are interpreted)
The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
With options -stdout and -stderr, escaped chars are always interpreted.
Following escaped chars are supported:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Examples:
display a reminder on core buffer with a highlight:
@@ -595,6 +596,8 @@ Examples:
/print -core abc\tThe message
display a message on channel #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
display a snowman (U+2603):
/print -escape \u2603
send alert (BEL):
/print -stderr \a
----
+1 -1
View File
@@ -724,7 +724,7 @@ Esistono diversi trucchi per ottimizzare l'uso della memoria:
Esistono 3 modi:
. entrando su IRC: 'irc.freenode.net', canale `#weechat'
. utilizzando il sito savannah:
. utilizzando il sito Savannah:
* segnalare un bug: https://savannah.nongnu.org/bugs/?group=weechat
* richiedere nuove funzionalità: https://savannah.nongnu.org/task/?group=weechat
* inviare una patch: https://savannah.nongnu.org/patch/?group=weechat
+4 -4
View File
@@ -8298,8 +8298,8 @@ La callback compirà le seguenti azioni alla ricezione del segnale:
. crea un link al nuovo script nella cartella '~/.weechat/xxx/autoload/'
. carica il nuovo script
Questi segnali vengono usati dallo script 'weeget.py' per installare gli
script.
// TRANSLATION MISSING
These signals are used by 'script' plugin to install scripts.
L'argomento è una stringa con il percorso dello script da installare.
@@ -8333,8 +8333,8 @@ seconda del linguaggio:
Per ogni script nella lista, la callback scaricherà e rimuoverà lo script.
Questi segnali vengono utilizzati dallo script 'weeget.py' per rimuovere gli
script.
// TRANSLATION MISSING
These signals are used by 'script' plugin to remove scripts.
L'argomento è una stringa con una lista separata da virgole di script da
rimuovere (script è il nome senza percorso, ad esempio 'script.py').
+1 -1
View File
@@ -36,7 +36,7 @@ Quasi tutti gli esempi in questo manuale sono scritti in Python, ma l'API
[[scripts_in_weechat]]
== Script in WeeChat
[[languages_specifities]]
[[languages_specificities]]
=== Specifiche per i linguaggi
==== Python
+1 -1
View File
@@ -39,7 +39,7 @@ Le principali caratteristiche:
La home page di WeeChat si trova qui: http://weechat.org/
[[pre-requisites]]
[[prerequisites]]
=== Requisiti
Per poter installare WeeChat, è necessario:
+1 -1
View File
@@ -111,5 +111,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1
-rm -f weechat.1 weechat.1.ja.txt cmdline_options.ja.txt
-rm -f *.html
+1 -1
View File
@@ -116,7 +116,7 @@
| weechat | plugins_commands | プラグインの定義するコマンド
| weechat | plugins_installed | names of plugins installed
| weechat | plugins_installed | インストールされたプラグインの名前
| weechat | plugins_names | プラグイン名
+4 -4
View File
@@ -134,9 +134,9 @@
** 値: on, off (デフォルト値: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** 説明: `チャンネルに参加した後に表示するメッセージのコンマ区切りリスト: 329 = チャンネル作成日、332 = トピック、333 = トピックを作成したニックネームおよび日付、366 = チャンネル参加者リスト`
** 説明: `チャンネルに参加した後に表示するメッセージのコンマ区切りリスト: 329 = チャンネル作成日、332 = トピック、333 = トピックを作成したニックネームおよび日付、353 = チャンネル参加者リスト、366 = 参加人数`
** タイプ: 文字列
** 値: 未制約文字列 (デフォルト値: `"329,332,333"`)
** 値: 未制約文字列 (デフォルト値: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** 説明: `チャンネルトピックが変更された場合に、古いトピックを表示`
@@ -264,7 +264,7 @@
** 値: 未制約文字列 (デフォルト値: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** 説明: `あるニックネームが参加またはサーバから切断したときの (ison コマンドの結果)notify によって表示されたメッセージに使われたタグのコンマ区切りリスト、例えば: "notify_message"、"notify_highlight"、"notify_private"`
** 説明: `あるニックネームが参加またはサーバから切断したの (ison または monitor コマンドの結果) notify が表示するメッセージで使うタグのコンマ区切りリスト、例えば: "notify_message"、"notify_highlight"、"notify_private"`
** タイプ: 文字列
** 値: 未制約文字列 (デフォルト値: `"notify_message"`)
@@ -574,7 +574,7 @@
** 値: 0 .. 2147483647 (デフォルト値: `2048`)
* [[option_irc.server_default.ssl_fingerprint]] *irc.server_default.ssl_fingerprint*
** 説明: `SHA1 fingerprint of certificate which is trusted and accepted for the server (it must be exactly 40 hexadecimal digits without separators); if this option is set, the other checks on certificates are NOT performed (option "ssl_verify")`
** 説明: `信頼でき、通信を認めるサーバ証明書の SHA1 指紋 (指紋は必ず空白を含まない 40 桁の 16 進数です); このオプションを設定した場合、証明書に対する他の妥当性確認は行われません (オプション "ssl_verify")`
** タイプ: 文字列
** 値: 未制約文字列 (デフォルト値: `""`)
+37 -34
View File
@@ -410,7 +410,7 @@ value: 表示する履歴エントリの数
switch_active_buffer: 次のマージされたバッファに移動
switch_active_buffer_previous: 一つ前のマージされたバッファに移動
zoom_merged_buffer: マージされたバッファにズーム
insert: コマンドラインにテキストを挿入
insert: コマンドラインにテキストを挿入 (エスケープ文字も可、/help print を参照)
paste_start: ペーストの開始 (括弧付きペーストモード)
paste_stop: ペーストの終了 (括弧付きペーストモード)
@@ -482,17 +482,17 @@ listdefault: デフォルトキーをリストアップ
del [<name>] [buffers|windows]
rename <name> <new_name>
store: store current buffers/windows in a layout
apply: apply stored layout
leave: leave current layout (does not update any layout)
del: delete buffers and/or windows in a stored layout
(if neither "buffers" nor "windows" is given after the name, the layout is deleted)
rename: rename a layout
name: name for stored layout (default is "default")
buffers: store/apply only buffers (order of buffers)
windows: store/apply only windows (buffer displayed by each window)
store: レイアウトに現在のバッファ/ウィンドウを保存
apply: 保存されたレイアウトを適用
leave: 現在のレイアウトを保持する (レイアウトを更新しない)
del: レイアウトとして保存されているバッファとウィンドウを削除
(名前の後に "バッファ" や "ウィンドウ" を指定しない場合、レイアウトを削除)
rename: レイアウトのリネーム
name: 保存されたレイアウトの名前 (初期状態は "default")
buffers: バッファのみに対してレイアウトを保存/適用 (バッファの順番)
windows: ウィンドウのみに対してレイアウトを保存/適用 (それぞれのウィンドウに表示されるバッファ)
Without argument, this command displays stored layouts.
引数無しでは、保存されたレイアウトを表示します。
----
[[command_weechat_mouse]]
@@ -562,40 +562,43 @@ arguments: ロードするプラグインに与える引数
----
[[command_weechat_print]]
[command]*`print`* display text on a buffer::
[command]*`print`* バッファ内にテキストを表示::
----
/print [-buffer <number>|<name>] [-core] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] <text>
-stdout|-stderr <text>
-buffer: the buffer where text is displayed (default: current buffer)
-core: alias of "-buffer core.weechat"
-escape: interpret escaped chars (for example \a, \07, \x07)
-date: message date, format can be:
-n: 'n' seconds before now
+n: 'n' seconds in the future
n: 'n' seconds since the Epoch (see man time)
date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
time: hh:mm:ss (example: 04:32:55)
-tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
text: text to display (prefix and message must be separated by \t)
-stdout: display text on stdout (not in a buffer)
-stderr: display text on stderr (not in a buffer)
-buffer: テキストを表示するバッファ (デフォルト: 現在のバッファ)
-core: "-buffer core.weechat" のエイリアス
-escape: エスケープ文字を解釈 (例えば \a\07\x07)
-date: メッセージの日付、フォーマット:
-n: 今から 'n' 秒前
+n: 今から 'n' 秒後
n: エポックから 'n' 秒目 (man time を参照)
日付/時間 (ISO 8601): yyyy-mm-ddThh:mm:ss、例: 2014-01-19T04:32:55
時間: hh:mm:ss (example: 04:32:55)
-tags: タグのコンマ区切りリスト (よく使うタグのリストは /help filter を参照)
text: 表示するテキスト (プレフィックスとメッセージは必ず \t で区切ってください)
-stdout: 標準出力にテキストを表示 (エスケープ文字を解釈)
-stderr: 標準エラー出力にテキストを表示 (エスケープ文字を解釈)
The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
オプション -action ... -quit をつけた場合、プレフィックスは "weechat.look.prefix_*" で定義されているものになります。
With options -stdout and -stderr, escaped chars are always interpreted.
以下のエスケープ文字を使うことができます:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Examples:
display a reminder on core buffer with a highlight:
:
コアバッファにハイライトを付けてリマインダを表示:
/print -core -tags notify_highlight Reminder: buy milk
display an error on core buffer:
コアバッファにエラーを表示:
/print -core -error Some error here
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
コアバッファにプレフィックス "abc" を付けてメッセージを表示:
/print -core abc The message
チャンネル #weechat にメッセージを表示:
/print -buffer irc.freenode.#weechat Message on #weechat
send alert (BEL):
雪だるまを表示 (U+2603):
/print -escape \u2603
警告を送信 (BEL):
/print -stderr \a
----
+3 -3
View File
@@ -539,7 +539,7 @@
** 値: 未制約文字列 (デフォルト値: `""`)
* [[option_weechat.look.highlight_regex]] *weechat.look.highlight_regex*
** 説明: `POSIX extended regular expression used to check if a message has highlight or not, at least one match in string must be surrounded by delimiters (chars different from: alphanumeric, "-", "_" and "|"), regular expression is case insensitive (use "(?-i)" at beginning to make it case sensitive), examples: "flashcode|flashy", "(?-i)FlashCode|flashy"`
** 説明: `メッセージ中のハイライトの有無を判断する POSIX 拡張正規表現、マッチ部分は必ず区切り文字 (アルファベット、"-""_"、"|" 以外の文字) で囲まれていなければいけない、正規表現は大文字小文字を区別しない (最初に "(?-i)" がある場合は区別する)、例: "flashcode|flashy""(?-i)FlashCode|flashy"`
** タイプ: 文字列
** 値: 未制約文字列 (デフォルト値: `""`)
@@ -804,7 +804,7 @@
** 値: on, off (デフォルト値: `on`)
* [[option_weechat.look.save_layout_on_exit]] *weechat.look.save_layout_on_exit*
** 説明: `save layout on exit (buffers, windows, or both)`
** 説明: `終了時にレイアウトを保存 (バッファ、ウィンドウ、両方)`
** タイプ: 整数
** 値: none, buffers, windows, all (デフォルト値: `none`)
@@ -839,7 +839,7 @@
** 値: 未制約文字列 (デフォルト値: `""`)
* [[option_weechat.look.tab_width]] *weechat.look.tab_width*
** 説明: `number of spaces used to display tabs in messages`
** 説明: `メッセージに含まれるタブ文字を表示する際に使う空白文字の数`
** タイプ: 整数
** 値: 1 .. 64 (デフォルト値: `1`)
+44 -39
View File
@@ -34,7 +34,7 @@ WeeChat の主要なリポジトリは 2 つあります:
* コアリポジトリ: ソースコードと文書が含まれています、
URL は: http://git.savannah.gnu.org/gitweb/?p=weechat.git
* スクリプト: weechat.org に投稿された '公式' スクリプト、
URL は: http://git.savannah.gnu.org/gitweb/?p=weechat/scripts.git;a=summary
URL は: http://git.savannah.gnu.org/gitweb/?p=weechat/scripts.git
このマニュアルはコアリポジトリの解説です。
@@ -46,7 +46,6 @@ WeeChat の主要なリポジトリは 2 つあります:
[width="100%",cols="1v,5",options="header"]
|===
| ディレクトリ | 説明
| debian/ | Debian パッケージ用
| src/ | ソースコードのルートディレクトリ
| core/ | コア関数: エントリポイント、内部構造体
| gui/ | バッファ、ウィンドウ、... を操作する関数 (全てのインターフェイスで使う)
@@ -56,7 +55,7 @@ WeeChat の主要なリポジトリは 2 つあります:
| aspell/ | aspell プラグイン
| charset/ | charset プラグイン
| fifo/ | fifo プラグイン (WeeChat にコマンドを送信する FIFO パイプ)
| irc/ | IRC プラグイン
| irc/ | IRC (Internet Relay Chat) プラグイン
| logger/ | logger プラグイン (表示されたメッセージをファイルに書き込む)
| relay/ | relay プラグイン (irc プロキシ + リモートインターフェイス用の中継)
| rmodifier/ | rmodifier プラグイン (正規表現を含む修飾子文字列)
@@ -70,7 +69,8 @@ WeeChat の主要なリポジトリは 2 つあります:
| xfer/ | xfer (IRC DCC ファイル/チャット)
| doc/ | 文書
| po/ | 翻訳ファイル (gettext)
| test/ | Weercd: WeeChat flood irc サーバ、Python 製
| test/ | WeeChat をテストするためのツールおよびファイル (Weercd IRC サーバなど)
| debian/ | Debian パッケージ用
|===
[[sources]]
@@ -89,9 +89,9 @@ WeeChat "core" は以下のディレクトリに配置されています:
| パス/ファイル名 | 説明
| core/ | コア関数: エントリポイント、内部構造体
| weechat.c | エントリポイント、コマンドラインオプション、main 関数、起動
| wee-backtrace.c | セグメンテーション違反の後にバックトレースを表示
| wee-backtrace.c | クラッシュした際にバックトレースを表示
| wee-command.c | WeeChat コアコマンド
| wee-completion.c | コマンドラインの補完
| wee-completion.c | デフォルト補完
| wee-config-file.c | 設定ファイル管理
| wee-config.c | WeeChat コアの設定オプション (weechat.conf ファイル)
| wee-debug.c | デバッグ用関数
@@ -120,7 +120,7 @@ WeeChat "core" は以下のディレクトリに配置されています:
| gui-buffer.c | バッファ
| gui-chat.c | チャット関数 (メッセージの表示、...)
| gui-color.c | 色関数
| gui-completion.c | デフォルト補完
| gui-completion.c | コマンドラインの補完
| gui-cursor.c | カーソルモード (カーソルを自由に移動)
| gui-filter.c | フィルタ
| gui-focus.c | フォーカスについての関数 (カーソルモードとマウス用)
@@ -183,7 +183,7 @@ WeeChat "core" は以下のディレクトリに配置されています:
| irc-bar-item.c | IRC バー要素
| irc-buffer.c | IRC バッファ
| irc-channel.c | IRC チャンネル
| irc-color.c | 色関数
| irc-color.c | IRC
| irc-command.c | IRC コマンド
| irc-completion.c | IRC 補完
| irc-config.c | IRC 設定オプション (irc.conf ファイル)
@@ -250,7 +250,7 @@ WeeChat "core" は以下のディレクトリに配置されています:
| weechat-ruby-api.c | ruby スクリプト作成 API 関数
| script/ | スクリプトマネージャ
| script.c | スクリプトマネージャの主要関数
| script-action.c | スクリプトに対する操作 (ロード/アンロード、インストール/削除、ホールド、...)
| script-action.c | スクリプトに対する操作 (ロード/アンロード、インストール/削除、...)
| script-buffer.c | スクリプトマネージャ用のバッファ
| script-command.c | スクリプトマネージャ用のコマンド
| script-completion.c | スクリプトマネージャ用の補完
@@ -267,7 +267,7 @@ WeeChat "core" は以下のディレクトリに配置されています:
| xfer-command.c | xfer コマンド
| xfer-completion.c | xfer 補完
| xfer-config.c | xfer 設定オプション (xfer.conf ファイル)
| xfer-dcc.c | xfer DCC ファイル
| xfer-dcc.c | DCC ファイル転送
| xfer-file.c | xfer のファイル関数
| xfer-info.c | xfer の情報/インフォリスト/hdata
| xfer-network.c | xfer のネットワーク関数
@@ -285,9 +285,9 @@ WeeChat "core" は以下のディレクトリに配置されています:
| doc/ | 文書
| asciidoc.conf | asciidoc 設定ファイル (マクロ)
| asciidoc.css | asciidoc スタイル
| docgen.py | "autogen/" ディレクトリ内のファイルを作成する Python スクリプト (以下を参照)
| docgen.py | 'autogen/' ディレクトリ内のファイルを作成する Python スクリプト (以下を参照)
| XX/ | 言語コード XX (言語コード: en、fr、de、it、...) 用のディレクトリ
| weechat.1.XX.txt | man ページ
| weechat.1.XX.txt | man ページ (`man weechat`)
| weechat_quickstart.XX.txt | クイックスタートガイド
| weechat_user.XX.txt | ユーザーガイド
| weechat_faq.XX.txt | FAQ
@@ -295,9 +295,9 @@ WeeChat "core" は以下のディレクトリに配置されています:
| weechat_scripting.XX.txt | スクリプト作成ガイド
| weechat_tester.XX.txt | テスターガイド
| weechat_dev.XX.txt | 開発者リファレンス (この文書)
| weechat_relay_protocol.XX.txt | リレープロトコル
| weechat_relay_protocol.XX.txt | リレープロトコル (リモートインターフェイス用)
| cmdline_options.XX.txt | コマンドラインオプション (man ページとユーザガイドに含まれるファイル)
| autogen/ | docgen.py スクリプトが自動生成するファイル (手作業による編集は*禁止* !)
| autogen/ | docgen.py スクリプトが自動生成するファイル
| user/ | ユーザーガイド用の自動生成ファイル (手作業による編集は*禁止* !)
| plugin_api/ | プラグイン API 用の自動生成ファイル (手作業による編集は*禁止* !)
|===
@@ -320,8 +320,12 @@ WeeChat とプラグインの翻訳は gettext で行います、ファイルは
* ソースコード内で使用する、コメント、変数名、...
は必ず*英語* で記述してください (他の言語を使わないでください)
* 新しいファイルのヘッダにはコピーライトを入れてください。日付、名前、電子メールアドレス、ライセンスを明記し、その後に短い説明を入れてください。C
言語の例:
* 新しいファイルにはコピーライトヘッダを入れ、以下の情報を含めてください:
** ファイルの短い説明 (1 行)、
** 日付、
** 名前、
** 電子メールアドレス、
** ライセンス。
[source,C]
----
@@ -491,13 +495,13 @@ else
----
switch (string[0])
{
case 'A': /* first case */
case 'A': /* first case */
foo ("abc", "def");
break;
case 'B': /* second case */
case 'B': /* second case */
bar (1, 2, 3);
break;
default: /* other cases */
default: /* other cases */
baz ();
break;
}
@@ -525,7 +529,7 @@ struct t_hook_fd *new_hook_fd;
new_hook_fd = malloc (sizeof (*new_hook_fd));
----
* Emacs テキストエディタのユーザは以下の lisp コードを
* Emacs テキストエディタのユーザは以下の Lisp コードを
'~/.emacs.el' に追記することで、適切なインデントを行うことができます。
[source,lisp]
@@ -553,8 +557,8 @@ http://www.python.org/dev/peps/pep-0008/ を参照
==== ファイル
ファイル名に使えるのは文字とハイフンだけで、フォーマット: 'xxx-yyyyy.[ch]'
に従ってください。'xxx' はファイルを置くディレクトリおよび構成要素
(略称も可)で、'yyyyy' はファイルの目的を表す名前です。
に従ってください。'xxx' はディレクトリおよび構成要素 (略称も可) で、'yyyyy'
はファイルの名前です。
主要ファイルにはディレクトリと同じ名前を付ける事ができます。例えば
irc プラグインの 'irc.c' など。
@@ -631,7 +635,7 @@ struct t_gui_window *gui_current_window = NULL; /* current window */
[[naming_convention_functions]]
==== 関数
関数に対する命名規則は<<naming_convention_variables,変数,>>と同じです。
関数に対する命名規則は<<naming_convention_variables,変数>>と同じです。
例: 新しいウィンドウの作成 ('src/gui/gui-window.c' より):
@@ -728,7 +732,7 @@ WeeChat は文字列中に独自の色コードを使うことで、属性
以下の表にすべての組み合わせをまとめています:
[width="100%",cols="3,2,1,5",options="header"]
[width="100%",cols="4,2,2,8",options="header"]
|===
| コード | 例 | エリア | 説明
| hex[19] + STD | hex[19]`01` | chat + bars | オプションを使って属性と色を指定、色コードは以下の表を参照
@@ -751,7 +755,7 @@ WeeChat は文字列中に独自の色コードを使うことで、属性
| hex[19] + "b" + "#" | hex[19]`b#` | input bar | カーソル文字を移動 ("input_text" 要素のみで利用可)
| hex[19] + "b" + "i" | hex[19]`bi` | bars | 要素を開始
| hex[19] + "b" + "l" (小文字の L) | hex[19]`bl` | bars | 行要素を開始
| hex[19] + "E" | hex[19]`E` | chat + bars | テキストを強調 _(バージョン 0.4.2 の新機能)_
| hex[19] + "E" | hex[19]`E` | chat + bars | テキストを強調 _(WeeChat ≥ 0.4.2)_
| hex[19] + hex[1C] | hex[19]hex[1C] | chat + bars | 色をリセット (属性は保存)
| hex[1A] + ATTR | hex[1A]`*` | chat + bars | 属性を設定
| hex[1B] + ATTR | hex[1B]`*` | chat + bars | 属性を削除
@@ -760,7 +764,7 @@ WeeChat は文字列中に独自の色コードを使うことで、属性
オプションを使う色コード ('src/gui/gui-color.h' ファイルの 't_gui_color_enum' を参照):
[width="60%",cols="^1m,10",options="header"]
[width="70%",cols="^1m,10",options="header"]
|===
| コード | オプション
| 00 | weechat.color.separator
@@ -797,21 +801,21 @@ WeeChat は文字列中に独自の色コードを使うことで、属性
| 31 | weechat.color.chat_text_found
| 32 | weechat.color.chat_value
| 33 | weechat.color.chat_prefix_buffer
| 34 | weechat.color.chat_tags _(バージョン 0.3.6 の新機能)_
| 35 | weechat.color.chat_inactive_window _(バージョン 0.3.6 の新機能)_
| 36 | weechat.color.chat_inactive_buffer _(バージョン 0.3.6 の新機能)_
| 37 | weechat.color.chat_prefix_buffer_inactive_buffer _(バージョン 0.3.6 の新機能)_
| 38 | weechat.color.chat_nick_offline _(バージョン 0.3.9 の新機能)_
| 39 | weechat.color.chat_nick_offline_highlight _(バージョン 0.3.9 の新機能)_
| 40 | weechat.color.chat_nick_prefix _(バージョン 0.4.1 の新機能)_
| 41 | weechat.color.chat_nick_suffix _(バージョン 0.4.1 の新機能)_
| 42 | weechat.color.emphasis _(バージョン 0.4.2 の新機能)_
| 43 | weechat.color.chat_day_change _(バージョン 0.4.2 の新機能)_
| 34 | weechat.color.chat_tags _(WeeChat ≥ 0.3.6)_
| 35 | weechat.color.chat_inactive_window _(WeeChat ≥ 0.3.6)_
| 36 | weechat.color.chat_inactive_buffer _(WeeChat ≥ 0.3.6)_
| 37 | weechat.color.chat_prefix_buffer_inactive_buffer _(WeeChat ≥ 0.3.6)_
| 38 | weechat.color.chat_nick_offline _(WeeChat ≥ 0.3.9)_
| 39 | weechat.color.chat_nick_offline_highlight _(WeeChat ≥ 0.3.9)_
| 40 | weechat.color.chat_nick_prefix _(WeeChat ≥ 0.4.1)_
| 41 | weechat.color.chat_nick_suffix _(WeeChat ≥ 0.4.1)_
| 42 | weechat.color.emphasis _(WeeChat ≥ 0.4.2)_
| 43 | weechat.color.chat_day_change _(WeeChat ≥ 0.4.2)_
|===
WeeChat 色は:
[width="40%",cols="^1m,6",options="header"]
[width="70%",cols="^1m,6",options="header"]
|===
| コード | 色
| 00 | デフォルト (ターミナルの文字色/背景色)
@@ -835,7 +839,7 @@ WeeChat 色は:
色コードの例:
[width="50%",cols="1,2",options="header"]
[width="70%",cols="1,2",options="header"]
|===
| コード | 説明
| hex[19]`01` | オプション "01" の色 (チャットテキスト)
@@ -941,6 +945,7 @@ core: update Japanese translations (patch #7783)
==== Gettext
Gettext ファイルは 'po/'
ディレクトリに入っています。新しい言語の翻訳を始める際は、コマンド
`msginit` を使ってください。例えばオランダ語の空ファイルを作成するには:
@@ -982,7 +987,7 @@ $ msgcheck.py xx.po
[IMPORTANT]
コマンド `/doc` を使う際に、すべての C 言語プラグイン (irc、charset、...)
がロードされていることを確認して下さい、これはメモリ上にあるオプションを使ってファイルを作成するためです。
がロードされていることを確認して下さい、これはメモリ上にあるデータを使ってファイルを作成するためです。
[[asciidoc]]
==== Asciidoc
+1 -1
View File
@@ -699,7 +699,7 @@ OpenBSD では、プラグインファイル名の末尾が ".so.0.0" です (Li
3 つの方法があります:
. IRC に参加: 'irc.freenode.net' 、チャンネル '#weechat'
. savannah ウェブサイトを利用:
. Savannah ウェブサイトを利用:
* バグ報告: https://savannah.nongnu.org/bugs/?group=weechat
* 新機能のリクエスト: https://savannah.nongnu.org/task/?group=weechat
* パッチ送信: https://savannah.nongnu.org/patch/?group=weechat
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -35,7 +35,7 @@ WeeChat (Wee Enhanced Environment for Chat) はフリー、高速、軽量な
[[scripts_in_weechat]]
== WeeChat のスクリプト
[[languages_specifities]]
[[languages_specificities]]
=== 言語仕様
==== Python
+3 -5
View File
@@ -37,7 +37,7 @@ WeeChat (Wee Enhanced Environment for Chat) はフリーのチャットクライ
WeeChat のホームページ: http://weechat.org/
[[pre-requisites]]
[[prerequisites]]
=== 事前に必要なもの
WeeChat をインストールするには、以下のものが必要です:
@@ -2228,10 +2228,8 @@ weechat::
| 671 | whois | whois (セキュアな接続)
| 728 | quietlist | 発言禁止リスト
| 729 | quietlist | 発言禁止リストの終了
// TRANSLATION MISSING
| 732 | monitor | list of monitored nicks
// TRANSLATION MISSING
| 733 | monitor | list of monitored nicks (end)
| 732 | monitor | 監視中のニックネームのリスト
| 733 | monitor | 監視中のニックネームのリスト (終了)
| 901 | | ログインに成功
|===
+6 -1
View File
@@ -21,10 +21,14 @@
docdir = $(datadir)/doc/$(PACKAGE)
EXTRA_DIST = CMakeLists.txt \
weechat.1.pl.txt \
cmdline_options.pl.txt \
weechat_user.pl.txt \
weechat_scripting.pl.txt \
weechat_faq.pl.txt \
weechat_quickstart.pl.txt \
weechat_tester.pl.txt
weechat_tester.pl.txt \
$(wildcard autogen/user/*.txt)
if MAN
man_targets = weechat.1
@@ -95,4 +99,5 @@ uninstall-doc:
# clean
clean-local:
-rm -f weechat.1 weechat.1.pl.txt cmdline_options.pl.txt
-rm -f *.html
+1 -1
View File
@@ -116,7 +116,7 @@
| weechat | plugins_commands | komendy zdefiniowane przez wtyczki
| weechat | plugins_installed | names of plugins installed
| weechat | plugins_installed | nazwy zainstalowanych wtyczek
| weechat | plugins_names | nazwy wtyczek
+20 -20
View File
@@ -199,23 +199,23 @@ nick: nick lub maska (może zaczynać się lub kończyć "*")
add [re:]<nick> [<serwer> [<kanał>]]
del <numer>|-all
list: list all ignores
add: add an ignore
nick: nick or hostname (can be a POSIX extended regular expression if "re:" is given or a mask using "*" to replace one or more chars)
del: delete an ignore
number: number of ignore to delete (look at list to find it)
-all: delete all ignores
server: internal server name where ignore is working
channel: channel name where ignore is working
list: wyświetla wszystkie ignorowane osoby
add: dodaje nową osobę do ignorowania
nick: nick lub host (jeśli dodamy "re:" można użyć rozszerzonego wyrażenia regularnego POSIX lub maska używając "*", aby zastąpić jeden lub więcej znaków)
del: usuwa wpis o ignorowanej osobie
numer: numer wpisu do usunięcia (znajduję się na liście)
-all: usuwa wszystkie wpisy z listy ignorowanych
serwer: wewnętrzna nazwa serwera, na którym dana osoba ma być ignorowana
kanał: nazwa kanału, na którym dana osoba ma być ignorowana
Note: the regular expression can start with "(?-i)" to become case sensitive.
Uwaga: wyrażenie regularne może zaczynać się od "(?-i)" jeśli wielkość znaków ma mieć znaczenie.
Examples:
ignore nick "toto" everywhere:
Przykłady:
ignoruje wszędzie nick "toto":
/ignore add toto
ignore host "toto@domain.com" on freenode server:
ignoruje host "toto@domain.com" na serwerze freenode:
/ignore add toto@domain.com freenode
ignore host "toto*@*.domain.com" on freenode/#weechat:
ignoruje host "toto*@*.domain.com" na freenode/#weechat:
/ignore add toto*@*.domain.com freenode #weechat
----
@@ -319,16 +319,16 @@ maska: lista serwerów musi pasować do maski
----
/list [<kanał>[,<kanał>...]] [<serwer>] [-re <regex>]
channel: channel to list
server: server name
regex: POSIX extended regular expression used to filter results (case insensitive, can start by "(?-i)" to become case sensitive)
kanał: kanał do listowania
serwer: nazwa serwera
regexp: rozszerzone wyrażenie regularne POSIX użyte do filtrowania wyników (wielkość znaków nie ma znaczenia, jeśli poprzedzone "(?-i)" to wielkość znaków ma znaczenie)
Examples:
list all channels on server (can be very slow on large networks):
Przykłady:
wyświetla wszystkie kanały na serwerze (może być bardzo wolny w dużych sieciach):
/list
list channel #weechat:
wyświetla kanał #weechat:
/list #weechat
list all channels beginning with "#weechat" (can be very slow on large networks):
wyświetla wszystkie kanały zaczynające się od "#weechat" (może być bardzo wolny w dużych sieciach):
/list -re #weechat.*
----
+7 -7
View File
@@ -134,9 +134,9 @@
** wartości: on, off (domyślna wartość: `on`)
* [[option_irc.look.display_join_message]] *irc.look.display_join_message*
** opis: `oddzielona przecinkami lista wiadomości wyświetlanych po wejściu na kanał: 329 = data utworzenia, 332 = temat, 333 = autor/data tematu, 366 = osoby na kanale`
** opis: `oddzielona przecinkami lista wiadomości wyświetlanych po wejściu na kanał: 329 = data utworzenia, 332 = temat, 333 = autor/data tematu, 353 = osoby na kanale, 366 = ilość osób na kanale`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `"329,332,333"`)
** wartości: dowolny ciąg (domyślna wartość: `"329,332,333,366"`)
* [[option_irc.look.display_old_topic]] *irc.look.display_old_topic*
** opis: `wyświetl stary temat, kiedy zmieniany jest temat kanału`
@@ -154,17 +154,17 @@
** wartości: on, off (domyślna wartość: `on`)
* [[option_irc.look.highlight_channel]] *irc.look.highlight_channel*
** opis: `comma separated list of words to highlight in channel buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"`
** opis: `oddzielona przecinkami lista słów do podświetleń w buforach kanałów (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `"$nick"`)
* [[option_irc.look.highlight_pv]] *irc.look.highlight_pv*
** opis: `comma separated list of words to highlight in private buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"`
** opis: `oddzielona przecinkami lista słów do podświetleń w prywatnych buforach (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `"$nick"`)
* [[option_irc.look.highlight_server]] *irc.look.highlight_server*
** opis: `comma separated list of words to highlight in server buffers (case insensitive, use "(?-i)" at beginning of words to make them case sensitive; special variables $nick, $channel and $server are replaced by their value), these words are added to buffer property "highlight_words" only when buffer is created (it does not affect current buffers), an empty string disables default highlight on nick, examples: "$nick", "(?-i)$nick"`
** opis: `oddzielona przecinkami lista słów do podświetleń w buforach serwera (wielkość liter nie ma znaczenia, użyj "(?-i)" na początku słów, dla których wielkość liter ma znaczenie; zmienne specjalne $nick, $channel i $server są zastępowane odpowiednimi wartościami), słowa te są dodawane do zmiennej lokalnej bufora "highlight_words" tylko kiedy bufor jest tworzony (nie ma wpływu na obecne bufory), pusty ciąg wyłącza domyślne podświetlenia nicka, przykłady: "$nick", "(?-i)$nick"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `"$nick"`)
@@ -264,7 +264,7 @@
** wartości: dowolny ciąg (domyślna wartość: `""`)
* [[option_irc.look.notify_tags_ison]] *irc.look.notify_tags_ison*
** opis: `oddzielona przecinkami lista tagów użytych w wiadomościach wyświetlanych przez powiadomienie, kiedy nick wejdzie lub wyjdzie z serwera (rezultat komendy ison), na przykład: "notify_message", "notify_private" lub "notify_higlight"`
** opis: `oddzielona przecinkami lista tagów użytych w wiadomościach wyświetlanych przez powiadomienie, kiedy nick wejdzie lub wyjdzie z serwera (rezultat komendy ison lub monitor), na przykład: "notify_message", "notify_private" lub "notify_higlight"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `"notify_message"`)
@@ -574,7 +574,7 @@
** wartości: 0 .. 2147483647 (domyślna wartość: `2048`)
* [[option_irc.server_default.ssl_fingerprint]] *irc.server_default.ssl_fingerprint*
** opis: `SHA1 fingerprint of certificate which is trusted and accepted for the server (it must be exactly 40 hexadecimal digits without separators); if this option is set, the other checks on certificates are NOT performed (option "ssl_verify")`
** opis: `skrót SHA1 certyfikatu, który jest zaufany i akceptowany dla serwera (40 znaków heksadecymalnych bez separatorów); jeśli ta opcja jest ustawiona, certyfikat NIE jest dalej sprawdzany (opcja "ssl_verify")`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `""`)
+2 -2
View File
@@ -79,7 +79,7 @@
** wartości: 0 .. 65535 (domyślna wartość: `256`)
* [[option_relay.network.allowed_ips]] *relay.network.allowed_ips*
** opis: `POSIX extended regular expression with IPs allowed to use relay (case insensitive, use "(?-i)" at beginning to make it case sensitive); if IPv6 is enabled and that connection is made using IPv4, it will be IPv4-mapped IPv6 address (like: "::ffff:127.0.0.1"), example: "^((::ffff:)?123.45.67.89|192.160.*)$"`
** opis: `dla wtyczki relay dozwolone są rozszerzone wyrażenia regularne POSIX zawierające adresy IP (wielkość znaków nie ma znaczenia, użyj "(?-i)" na początku, aby wielkość znaków miała znaczenie); jeśli obsługa IPv6 jest włączona a połączenie jest z użyciem IPv4, zostanie ono zmapowane na adres IPv6 (jak: "::ffff:127.0.0.1"), przykład: "^((::ffff:)?123.45.67.89|192.160.*)$"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `""`)
@@ -114,7 +114,7 @@
** wartości: dowolny ciąg (domyślna wartość: `"%h/ssl/relay.pem"`)
* [[option_relay.network.websocket_allowed_origins]] *relay.network.websocket_allowed_origins*
** opis: `POSIX extended regular expression with origins allowed in websockets (case insensitive, use "(?-i)" at beginning to make it case sensitive), example: "^http://(www\.)?example\.(com|org)"`
** opis: `rozszerzone wyrażenia regularne POSIX ze źródłami dozwolonymi dla gniazd webowych (nie wrażliwe na wielkość znaków, umieszczenie "(?-i)" na początku sprawi, że wielość znaków będzie miała znaczenie), przykład: "^http://(www\.)?przykład\.(com|org)"`
** typ: ciąg
** wartości: dowolny ciąg (domyślna wartość: `""`)
+16 -16
View File
@@ -8,24 +8,24 @@
missing
default -yes
list: list all rmodifiers
listdefault: list default rmodifiers
add: add a rmodifier
name: name of rmodifier
modifiers: comma separated list of modifiers
groups: action on groups captured in regular expression (inside parentheses): comma separated list of groups (from 1 to 9) with optional "*" after number to hide the group
regex: POSIX extended regular expression (case insensitive, can start by "(?-i)" to become case sensitive)
del: delete a rmodifier
-all: delete all rmodifiers
missing: add missing rmodifiers
default: restore default rmodifiers
list: lista wszystkich rmodifierów
listdefault: lista domyślnych rmodifierów
add: dodaje rmodifier
nazwa: nazwa rmodifiera
modyfikatory: oddzielona przecinkiem lista modyfikatorów
grupy: akcja na grupach przechwyconych w wyrażeniu regularnym (wewnątrz nawiasów): oddzielona przecinkami lista grup (od 1 do 9) z opcjonalnym znakiem "*" po numerze, aby ukryć grupę
regex: rozszerzone wyrażenia regularne POSIX (wielkość znaków nie ma znaczenia, jeśli poprzedzone "(?-i)" wielkość znaków ma znaczenie)
del: usuwa rmodifier
-all: usuwa wszystkie rmodifiery
missing: dodaje brakujące rmodifiery
default: przywraca domyślne rmodifiery
Examples:
hide everything typed after a command /password:
Przykłady:
ukrywa wszystko wpisane za komendą /password:
/rmodifier add password input_text_display 1,2* ^(/password +)(.*)
delete rmodifier "password":
/rmodifier del password
delete all rmodifiers:
usuwa rmodifier "hasło":
/rmodifier del hasło
kasuje wszystkie rmodifiery:
/rmodifier del -all
----
+111 -108
View File
@@ -220,43 +220,43 @@ infolists: wyświetla informacje o infolistach
/eval [-n] <wyrażenie>
[-n] -c <wyrażenie1> <operator> <wyrażenie2>
-n: display result without sending it to buffer (debug mode)
-c: evaluate as condition: use operators and parentheses, return a boolean value ("0" or "1")
expression: expression to evaluate, variables with format ${variable} are replaced (see below)
operator: a logical or comparison operator:
- logical operators:
&& boolean "and"
|| boolean "or"
- comparison operators:
== equal
!= not equal
<= less or equal
< less
>= greater or equal
> greater
=~ is matching POSIX extended regex
!~ is NOT matching POSIX extended regex
-n: wyświetla wynik bez wysyłania go do buforu (tryb debugowania)
-c: przetwarza jako warunek: użyj operatorów i nawiasów, zwraca wartość logiczną ("0" lub "1")
wyrażenie: wyrażenie do przetworzenia, zmienne o formacie ${zmienna} są zastępowane (zobacz niżej)
operator: operator logiczny lub porównania:
- operatory logiczne:
&& boolowskie "i"
|| boolowskie "lub"
- operatory porównania:
== równy
!= różny
<= mniejszy lub równy
< mniejszy
>= większy lub równy
> większy
=~ pasuje do rozszerzonego wyrażenia regularnego POSIX
!~ NIE pasuje do rozszerzonego wyrażenia regularnego POSIX
An expression is considered as "true" if it is not NULL, not empty, and different from "0".
The comparison is made using integers if the two expressions are valid integers.
To force a string comparison, add double quotes around each expression, for example:
Wyrażenie jest uznawane za "prawdziwe" jeśli nie jest NULL, nie jest puste, oraz różni się od "0".
Porównania dokonuje się z użyciem liczb całkowitych jeśli oba wyrażenia są liczbami całkowitymi.
W celu wymuszenia porównywania ciągów, należy umieścić każde wyrażenie w cudzysłowie, na przykład:
50 > 100 ==> 0
"50" > "100" ==> 1
Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority :
1. a color (format: "color:xxx")
2. an info (format: "info:name,arguments", arguments are optional)
3. an option (format: "file.section.option")
4. a local variable in buffer
5. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
Format for hdata can be one of following:
hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
hdata[list].var1.var2...: start with a hdata using a list, for example:
${buffer[gui_buffers].full_name}: full name of first buffer in linked list of buffers
${plugin[weechat_plugins].name}: name of first plugin in linked list of plugins
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Niektóre zmienne w wyrażeniach są zamieniane, poprzez zastosowanie formatu ${zmienna}, według priorytetu zmienną może być:
1. kolor (format color:xxx)
2. informacja (format: "info:nazwa,argumenty", argumenty są opcjonalne)
3. nazwa opcji (format: plik.sekcja.opcja)
4. zmienna lokalna w buforze
5. nazwa hdatay/zmiennej (wartość jest automatycznie konwertowana na ciąg znaków), domyślnie "window" i "buffer" wskazują na aktualne okno/bufor.
Format dla hdata może być jednym z poniższych:
hdata.zmienna1.zmienna2...: inicjuje hdata (wskaźnik musi być znany), następnie wypytuje zmienne jedna po drugiej (inne hdata mogą być następne)
hdata[list].zmienna1.zmienna2...: inicjuje hdata z wykorzystaniem listy, na przykład:
${buffer[gui_buffers].full_name}: pełna nazwa buforu w połączonej liście buforów
${plugin[weechat_plugins].name}: nazwa pierwszej wtyczki w połączonej liście wtyczek
Nazwy hdata i zmiennych, można znaleźć w "Opisie API wtyczek", fukcja "weechat_hdata_get".
Examples:
Przykłady:
/eval -n ${info:version} ==> 0.4.3
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${window} ==> 0x2549aa0
@@ -282,52 +282,52 @@ Examples:
add <nazwa> <bufor>[,<bufor>...] <tagi> <regex>
del <nazwa>|-all
list: list all filters
enable: enable filters (filters are enabled by default)
disable: disable filters
toggle: toggle filters
name: filter name
add: add a filter
del: delete a filter
-all: delete all filters
buffer: comma separated list of buffers where filter is active:
- this is full name including plugin (example: "irc.freenode.#weechat")
- "*" means all buffers
- a name starting with '!' is excluded
- name can start or end with '*' to match many buffers
tags: comma separated list of tags, for example "irc_join,irc_part,irc_quit"
- logical "and": use "+" between tags (for example: "nick_toto+irc_action")
- tags can start or end with '*'
regex: POSIX extended regular expression to search in line
- use '\t' to separate prefix from message, special chars like '|' must be escaped: '\|'
- if regex starts with '!', then matching result is reversed (use '\!' to start with '!')
- two regular expressions are created: one for prefix and one for message
- regex are case insensitive, they can start by "(?-i)" to become case sensitive
list: wyświetla wszystkie filtry
enable: włącza filtry (filtry są domyślnie włączone)
disable: wyłącza filtry
toggle: przełącza filtry
nazwa: nazwa filtru
add: dodaje filtr
del: usuwa filtr
-all: usuwa wszystkie filtry
bufor: oddzielona przecinkami lisa buforów, dla których filtr jest aktywny:
- jest to pełna nazwa zawierająca wtyczkę (przykład: "irc.freenode.#weechat")
- "*" oznacza wszystkie bufory
- nazwa zaczynająca się od '!' jest wykluczana
- nazwa może zaczynać się lub kończyć '*', aby dopasować wiele buforów
tagi: lista tagów oddzielona przecinkiem, np: "irc_join,irc_part,irc_quit"
- logiczne "i": użyj "+" pomiędzy tagami (na przykład: "nick_toto+irc_action")
- tagi mogą zaczynać się i kończyć '*' żeby dopasować wiele buforów
regex: rozszerzone wyrażenie regularne POSIX do wyszukania w linii
- użyj '\t' do oddzielenia prefiksu od wiadomości, znaki specjalne jak '|' muszą zostać poprzedzone '\' np: '\|'
- jeśli wyrażenie zaczyna się od '!', wtedy pasujący wynik jest odwracany (użyj '\!', aby zacząć od '!')
- dwa wyrażenia są tworzone: jedno dla prefiksu, drugie dla wiadomości
- wielkość znaków nie ma znaczenia dla wyrażeń, jeśli zaczynają się od "(?-i)" wielkość znaków ma znaczenie
The default key alt+'=' toggles filtering on/off.
Domyślny skrót klawiszowy alt+'=' włącza/wyłącza filtrowanie.
Tags most commonly used:
no_filter, no_highlight, no_log, log0..log9 (log level),
Najczęściej używane tagi:
no_filter, no_highlight, no_log, log0..log9 (poziom logowania),
notify_none, notify_message, notify_private, notify_highlight,
nick_xxx (xxx is nick in message), prefix_nick_ccc (ccc is color of nick),
irc_xxx (xxx is command name or number, see /server raw or /debug tags),
nick_xxx (xxx to nick w wiadomości), prefix_nick_ccc (ccc to kolor nicka),
irc_xxx (xxx to nazwa komendy lub numer, zobacz /server raw lub /debug tags),
irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
To see tags for lines in buffers: /debug tags
Aby zobaczyć listę tagów w liniach buforów wykonaj: /debug tags
Examples:
use IRC smart filter on all buffers:
Przykłady:
użyj inteligentnego filtru we wszystkich buforach IRC:
/filter add irc_smart * irc_smart_filter *
use IRC smart filter on all buffers except those with "#weechat" in name:
użyj inteligentnego filtru we wszystkich buforach IRC poza tymi zawierającymi "#weechat" w nazwie:
/filter add irc_smart *,!*#weechat* irc_smart_filter *
filter all IRC join/part/quit messages:
filtruj wszystkie wiadomości IRC o join/part/quit:
/filter add joinquit * irc_join,irc_part,irc_quit *
filter nicks displayed when joining channels or with /names:
filtruj nicki wyświetlane przy wejściu na kanał albo za pomocą /names:
/filter add nicks * irc_366 *
filter nick "toto" on IRC channel #weechat:
filtruj nick "toto" na kanale IRC #weechat:
/filter add toto irc.freenode.#weechat nick_toto *
filter IRC join/action messages from nick "toto":
filtruj wejścia/akcje IRC od użytkownika "toto":
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filter lines containing "weechat sucks" on IRC channel #weechat:
filtruj linie zawierające fraze "weechat sucks" na kanale IRC #weechat:
/filter add sucks irc.freenode.#weechat * weechat sucks
----
@@ -476,23 +476,23 @@ Przykłady:
[command]*`layout`* zarządzaj układami buforów/okien::
----
/layout store [<name>] [buffers|windows]
apply [<name>] [buffers|windows]
/layout store [<nazwa>] [buffers|windows]
apply [<nazwa>] [buffers|windows]
leave
del [<name>] [buffers|windows]
rename <name> <new_name>
del [<nazwa>] [buffers|windows]
rename <nazwa> <nowa nazwa>
store: store current buffers/windows in a layout
apply: apply stored layout
leave: leave current layout (does not update any layout)
del: delete buffers and/or windows in a stored layout
(if neither "buffers" nor "windows" is given after the name, the layout is deleted)
rename: rename a layout
name: name for stored layout (default is "default")
buffers: store/apply only buffers (order of buffers)
windows: store/apply only windows (buffer displayed by each window)
store: zachowuje układ używając obecnych buforów/okien
apply: stosuje zapisany układ
leave: opuszcza obecny układ (nie aktualizuje żadnego układu)
del: usuwa bufory i/lub okna w zapisanym układzie
(jeśli zarówno "buffers" jak i "windows" nie zostaną podane po nazwie, układ jest kasowany)
rename: zmienia nazwę układu
nazwa: nazwa zapisanego układu (domyślnie "default")
buffers: zapisuje/stosuje tylko bufory (kolejność buforów)
windows: zapisuje/stosuje tylko okna (bufory wyświetlane w każdym oknie)
Without argument, this command displays stored layouts.
Komenda wywołana bez argumentów wyświetli zapisane układy.
----
[[command_weechat_mouse]]
@@ -562,40 +562,43 @@ Bez argumentów ta komenda wyświetli wszystkie załadowane wtyczki.
----
[[command_weechat_print]]
[command]*`print`* display text on a buffer::
[command]*`print`* wyświetl tekst w buforze::
----
/print [-buffer <number>|<name>] [-core] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] <text>
-stdout|-stderr <text>
/print [-buffer <numer>|<nazwa>] [-core] [-escape] [-date <data>] [-tags <tagi>] [-action|-error|-join|-network|-quit] <tekst>
-stdout|-stderr <tekst>
-buffer: the buffer where text is displayed (default: current buffer)
-core: alias of "-buffer core.weechat"
-escape: interpret escaped chars (for example \a, \07, \x07)
-date: message date, format can be:
-n: 'n' seconds before now
+n: 'n' seconds in the future
n: 'n' seconds since the Epoch (see man time)
date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
time: hh:mm:ss (example: 04:32:55)
-tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
text: text to display (prefix and message must be separated by \t)
-stdout: display text on stdout (not in a buffer)
-stderr: display text on stderr (not in a buffer)
-buffer: bufor, w którym zostanie wyświetlony tekst (domyślnie: obecny bufor)
-core: alias dla bufora "-buffer core.weechat"
-escape: interpretuj znaki poprzedzone \ (na przykład \a, \07, \x07)
-date: data wiadomości, możliwe formaty:
-n: 'n' sekund wcześniej
+n: 'n' sekund później
n: 'n' sekund od Epoch (zobacz man time)
data/czas (ISO 8601): yyyy-mm-ddThh:mm:ss, przykład: 2014-01-19T04:32:55
czas: hh:mm:ss (przykład: 04:32:55)
-tags: oddzielona przecinkami lista tagów (zobacz /help filter w celu wyświetlenia listy najczęstszych tagów)
tekst: tekst do wyświetlenia (prefiks i wiadomość muszą być oddzielone za pomocą \t)
-stdout: wyświetl tekst na standardowe wyjście (znaki poprzedzone \ są interpretowane)
-stderr: wyświetl tekst na standardowe wyjście błędów (znaki poprzedzone \ są interpretowane)
The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
Opcje -action ... -quit używają prefiksów zdefiniowanych w opcjach "weechat.look.prefix_*".
With options -stdout and -stderr, escaped chars are always interpreted.
Wspierane znaczniki specjalne:
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Examples:
display a reminder on core buffer with a highlight:
/print -core -tags notify_highlight Reminder: buy milk
display an error on core buffer:
/print -core -error Some error here
display message on core buffer with prefix "abc":
/print -core abc\tThe message
display a message on channel #weechat:
Przykłady:
wyświetla przypomnienie w buforze głównym z higlightem:
/print -core -tags notify_highlight Reminder: kup mleko
wyświetla błąd w głównym buforze:
/print -core -error Jakiś błąd
wyświetla wiadomość w głównym buforze z prefiksem "abc":
/print -core abc\tWiadomość
wyświetla wiadomość na kanale #weechat:
/print -buffer irc.freenode.#weechat Message on #weechat
send alert (BEL):
wyświetla bałwana (U+2603):
/print -escape \u2603
wysyła alert (BEL):
/print -stderr \a
----

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