diff --git a/AUTHORS b/AUTHORS index 2f40a4a50..1834ba04b 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1,47 +1,42 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== +WeeChat Authors +=============== -Developers: +Developers ---------- * General code - FlashCode - Web : http://weechat.flashtux.org - IRC : nick is "FlashCode" @ irc.freenode.net - -* Scripts plugins - - kolter - IRC : nick is "kolter" @ irc.freenode.net +** FlashCode +*** Web: http://weechat.flashtux.org/ +*** IRC: 'FlashCode' on irc.freenode.net -Debian packager: ---------------- +* Scripts plugins, debian packager -Julien Louis - IRC : nick is "ptitlouis" @ irc.freenode.net - Jabber: ptitlouis@amessage.info +** kolter +*** IRC: 'kolter' on irc.freenode.net -Contributors: +Contributors ------------ -Rudolf Polzer , IRC: "divVerent" -Jiri Golembiovsky , IRC: "GolemJ" -Jim Ramsay , IRC: "lack" -Odin , IRC: "Odin" -Pistos, IRC: "pistos" -Gwenn, IRC: "gwenn" -Voroskoi, IRC: "voroskoi" -Frank Zacharias -Pavel Shevchuk, IRC: "Stalwart" +* Julien Louis , IRC: 'ptitlouis' +* Rudolf Polzer , IRC: 'divVerent' +* Jiri Golembiovsky , IRC: 'GolemJ' +* Jim Ramsay , IRC: 'lack' +* Odin , IRC: 'Odin' +* Pistos, IRC: 'pistos' +* Gwenn, IRC: 'gwenn' +* Voroskoi, IRC: 'voroskoi' +* Frank Zacharias +* Pavel Shevchuk, IRC: 'Stalwart' -===== +Contact +------- Whole team is connected to IRC: -server: irc.freenode.net, channels: #weechat and #weechat-fr (french) +server: 'irc.freenode.net', channels: '#weechat' (english) and '#weechat-fr' (french) See README file for licence detail. diff --git a/BUGS b/BUGS deleted file mode 100644 index 2783e33f2..000000000 --- a/BUGS +++ /dev/null @@ -1,5 +0,0 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== - -WeeChat known bugs: -please look at https://savannah.nongnu.org/bugs/?group=weechat diff --git a/ChangeLog b/ChangeLog index 4b77bdec9..e46d49f59 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,735 +1,794 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== - -ChangeLog - 2009-05-11 +WeeChat ChangeLog +================= +FlashCode +v0.3.0-dev, 2009-05-15 -Version 0.3.0 (under dev!): - * irc: add irc plugin (replaces old IRC code in core) - * irc: add smart join/part/quit message filter (task #8503) - * irc: use of many addresses for servers (auto-switch when a connexion - fails), nicks are now set with one option "nicks" (task #6088) - * irc: add some colors in messages from server (for text and nicks) - (task #8926) - * irc: add color decoding in title for IRC channels (task #6030) - * irc: fix lock with SSL servers when connection fails, and when - disconnecting during connection problem (bug #17584) - * irc: command /whois is now authorized in private without argument - (task #7482) - * irc: remove kernel info in CTCP VERSION reply (task #7494) - * irc: add missing commands (328, 369) - * aspell: improve plugin: use of many dictionaries, global dictionary, real - time checking (optional), fix bugs with utf-8 - * xfer: add speed limit for DCC files sending (task #6178) - * xfer: add new option "xfer.file.use_nick_in_filename" for Xfer files - (task #7140) - * relay: add relay plugin (network communication between WeeChat and remote - application) - * logger: add logger plugin with new features: backlog, level for messages - to log (task #8592), level by buffer (task #6687), filename mask by - buffer, option "name_lower_case" (bug #19522) - * alias: fix bug with alias, use current buffer to run commands (bug #22876) - * plugins: add some other plugins: alias, demo, fifo, tcl, xfer - * scripts: new scripts: weeget.py (scripts manager), jabber.py (jabber/XMPP - protocol), go.py (quick jump to buffers), buffers.pl (sidebar with list of - buffers), iset.pl (set options interactively), weetris.pl (tetris-like - game, mastermind.pl, ... - * api: add hooks: command, timer, file descriptor, process, connection, - print, signal, config, completion, modifier, info, infolist - * api: new plugin API with many new functions: hooks, buffer management and - nicklist, bars, configuration files, network, infos/infolists, lists, - upgrade - * gui: new display engine, with prefix and message for each line - * gui: add new type of buffer, with free content - * gui: add tags for lines and custom filtering by tags or regex (task #7674) - * gui: add custom bars, with custom items - * gui: add key to zoom a window (task #7470) - * gui: add new option scroll_page_percent to choose percent of height to - scroll with page_up and page_down keys (task #8702) - * gui: add number of lines remaining after last line displayed in "-MORE-" - indicator (task #6702) - * gui: fix completion with non-latin nicks (bug #18993) - * gui: fix display bug with some weird UTF-8 chars (bug #19687) - * gui: fix bug with wide chars in input (bug #16356) - * gui: fix bug when switching window, scrollback is now preserved - (task #7680) - * network: add support for more than one proxy, with proxy selection for - each IRC server (task #6859) - * network: fix network connection for hostnames resolving to several IPs: - try all IPs in list until one succeeds (bug #21473, debian bug #498610) - * core: add group support in nicklist - * core: improve main loop: higher timout in select(), less CPU usage - * core: add /reload command to reload WeeChat and plugins config files - (signal SIGHUP is catched to reload config files) - * core: add new /layout command and save_layout_on_exit config option, to - save/restore windows and buffers order (task #5453) - * core: add new options for completion, optional stop instead of cycling - with words found (task #5909) - * core: new name for configuration files (*.conf instead of *.rc) - * core: improve /set command, new command /unset (task #6085) - * core: add new input action "set_unread_current_buffer" to set unread - marker for current buffer only (task #7286) - * core: add polish translation (thanks to Soltys) - * core: remove key functions, replaced by /input command - * core: fix nick completion bug (missing space after nick) +Version 0.3.0 (under dev!) +-------------------------- -Version 0.2.6.2 (2009-04-18): - * fix bug with charset decoding (for example with iso2022jp) +* irc: add irc plugin (replaces old IRC code in core) +* irc: add smart join/part/quit message filter (task #8503) +* irc: use of many addresses for servers (auto-switch when a connexion + fails), nicks are now set with one option "nicks" (task #6088) +* irc: add some colors in messages from server (for text and nicks) + (task #8926) +* irc: add color decoding in title for IRC channels (task #6030) +* irc: fix lock with SSL servers when connection fails, and when + disconnecting during connection problem (bug #17584) +* irc: command /whois is now authorized in private without argument + (task #7482) +* irc: remove kernel info in CTCP VERSION reply (task #7494) +* irc: add missing commands (328, 369) +* aspell: improve plugin: use of many dictionaries, global dictionary, real + time checking (optional), fix bugs with utf-8 +* xfer: add speed limit for DCC files sending (task #6178) +* xfer: add new option "xfer.file.use_nick_in_filename" for Xfer files + (task #7140) +* relay: add relay plugin (network communication between WeeChat and remote + application) +* logger: add logger plugin with new features: backlog, level for messages + to log (task #8592), level by buffer (task #6687), filename mask by + buffer, option "name_lower_case" (bug #19522) +* alias: fix bug with alias, use current buffer to run commands (bug #22876) +* plugins: add some other plugins: alias, demo, fifo, tcl, xfer +* scripts: new scripts: weeget.py (scripts manager), jabber.py (jabber/XMPP + protocol), go.py (quick jump to buffers), buffers.pl (sidebar with list of + buffers), iset.pl (set options interactively), weetris.pl (tetris-like + game), mastermind.pl, ... +* api: add hooks: command, timer, file descriptor, process, connection, + print, signal, config, completion, modifier, info, infolist +* api: new plugin API with many new functions: hooks, buffer management and + nicklist, bars, configuration files, network, infos/infolists, lists, + upgrade +* gui: new display engine, with prefix and message for each line +* gui: add new type of buffer, with free content +* gui: add tags for lines and custom filtering by tags or regex (task #7674) +* gui: add custom bars, with custom items +* gui: add key to zoom a window (task #7470) +* gui: add new option scroll_page_percent to choose percent of height to + scroll with page_up and page_down keys (task #8702) +* gui: add number of lines remaining after last line displayed in "-MORE-" + indicator (task #6702) +* gui: fix completion with non-latin nicks (bug #18993) +* gui: fix display bug with some weird UTF-8 chars (bug #19687) +* gui: fix bug with wide chars in input (bug #16356) +* gui: fix bug when switching window, scrollback is now preserved + (task #7680) +* network: add support for more than one proxy, with proxy selection for + each IRC server (task #6859) +* network: fix network connection for hostnames resolving to several IPs: + try all IPs in list until one succeeds (bug #21473, debian #498610) +* core: add group support in nicklist +* core: improve main loop: higher timout in select(), less CPU usage +* core: add /reload command to reload WeeChat and plugins config files + (signal SIGHUP is catched to reload config files) +* core: add new /layout command and save_layout_on_exit config option, to + save/restore windows and buffers order (task #5453) +* core: add new options for completion, optional stop instead of cycling + with words found (task #5909) +* core: new name for configuration files (*.conf instead of *.rc) +* core: improve /set command, new command /unset (task #6085) +* core: add new input action "set_unread_current_buffer" to set unread + marker for current buffer only (task #7286) +* core: add polish translation (thanks to Soltys) +* core: remove key functions, replaced by /input command +* core: fix nick completion bug (missing space after nick) -Version 0.2.6.1 (2009-03-14): - * fix crash with some special chars in IRC messages (bug #25862) +Version 0.2.6.2 (2009-04-18) +---------------------------- -Version 0.2.6 (2007-09-06): - * fix bug with log of plugin messages (option log_plugin_msg) - * add new option "deloutq" to /server command to delete all servers - messages out queues (task #7221) - * fix display bug with some special chars in messages (some words were - truncated on screen) (bug #20944) - * fix UTF-8 bug with color encoding/decoding - * fix crash when searching text in buffer with ctrl-R (bug #20938) - * add string length limit for setup file options - * fix bug with flock() when home is on NFS filesystem (bug #20913) - * add option to align text of messages (except first lines) (task #7246) - * fix user modes in nicklist when ban and nick mode are received in the - same MODE message (bug #20870) - * fix IRC message 333: silently ignore message if error when parsing it - * fix server option "command_delay": does not freeze WeeChat any more - * add paste detection, new options look_paste_max_lines and - col_input_actions (task #5442) - * fix bug with highlight and UTF-8 chars around word (bug #20753) - * add swedish quickstart guide - * add support of channel mode +u (channel user) (bug #20717) - * improve /connect command to connect to a host by creating a temporary - server, add option to /server to create temporary server (task #7095) - * add "copy", "rename" and "keep" options to /server command - * allow clear of multiple selected buffers with /clear (patch #6112) - * add key for setting unread marker on all buffers (default: - ctrl-S + ctrl-U) (task 7180) - * fix nick prefix display on servers that doesn't support all prefixes - (bug #20025) - * fix terminal encoding detection when NLS is disabled (bug #20646) - * fix crash when sending data to channel or pv on disconnected server - (bug #20524) - * improve command /server ant its output - * add 3 default new keys: ctrl-B (left), ctrl-F (right), ctrl-D (delete) - * add "buffer_move" event handler to plugins API (task #6708) - * add key function "jump_previous_buffer" to jump to buffer previously - displayed (new key: alt-J + alt-P) (task #7085) - * add "%*" to completion template, to repeat last completion - * add "-nojoin" option for /connect and /reconnect commands (task #7074) - * fix bugs with IRC color in messages, now color codes are inserted in - command line with ^Cc,^Cb,.. instead of %C,%B,.. (bug #20222, task #7060) - * fix bug with smart nick completion (last speakers first) when a nick - is changed - * fix charset bug with channel names in status bar (bug #20400) - * add "scroll" option to /buffer command - * down key now saves input to history and clears input line (task #7049) - * fix log file when channel name contains "/" (bug #20072) - * command /away allowed when not connected to server (internally stored - and AWAY command is sent when connecting to server) (task #7003) - * add argument for /upgrade command (path to binary) - * fix bug with /topic when channel not open and topic not defined - (bug #20141) - * add hotlist sort with new option "look_hotlist_sort" (task #5870) +* fix bug with charset decoding (for example with iso2022jp) (bug #26228) -Version 0.2.5 (2007-06-07): - * fix QUOTE command: now allowed when socket is ok (even if IRC - connection to server is not ok) (bug #20113) - * add missing IRC commands (327, 378, 379) (bug #20091) - * fix hotlist when exiting search mode: current buffer is removed from - hotlist - * add "%M" for completion with nicks of current server (nicks on open - channels) (task #6931) - * improve key bindings: now possible to bind a key on many commands, - separated by semicolon (task #5444) - * improve IRC long message split: use word boundary (task #6685) - * remove ":" for unknown IRC commands before arguments (bug #19929) - * fix "%C" completion: now completes with all channels of all servers - * fix bug with "/buffer query_name", add server and channel completion - for /buffer command (bug #19928) - * add cmake for weechat compile (patch #5943) - * fix IRC mode parsing when receiving modes with arguments (bug #19902) - * fix crash with IRC JOIN malformed message (bug #19891) - * fix bug with nick prefixes on some IRC servers (bug #19854) - * improve setup file save: now writes temporary file, then rename it - (task #6847) - * fix bug with $nick/$channel/$server variables in commands - * forget current nick when user manually disconnects from server - * fix nick display in input window - * fix bug with erroneous nickname when connecting to server (bug #19812) - * fix display bugs in IRC error messages - * add protocol priority for gnutls (patch #5915) - * add channel admin mode '!' for some IRC servers - * fix bug with iso2022jp locale (bug #18719) - * fix string format bug when displaying string thru plugin script API - * add /reconnect command (task #5448) - * add "-all" option for /connect and /disconnect commands (task #6232) - * improve nick completion: completion with last speakers first and self - nick at the end; add option look_nick_completion_smart, enabled by - default (task #5896) - * fix nick completion in command arguments (bug #19590) - * fix possible crash with nick completion when a nick leaves channel - (bug #19589) - * add color for input text not found in buffer history - * fix USER message when connecting to IRC server (patch #5835) +Version 0.2.6.1 (2009-03-14) +---------------------------- -Version 0.2.4 (2007-03-29): - * fix color bug with IRC messages displayed by plugins (bug #19442) - * fix topic charset, now using channel charset if defined (bug #19386) - * rename log file for DCC chat (now .dcc..weechatlog) - * fix crash when closing a pv if a DCC chat is open on same nick - (bug #19147) - * fix bug with channel topic after reconnection (not erased) (bug #19384) - * add current buffer in hotlist when scrolling up in buffer (task #6664) - * fix bug with explode_string / free_exploded_string when max_items > 0 - * add new key (ctrl-R) for interactive and incremental search in buffer - history (task #6628) - * fix /topic completion when no topic set on current channel (bug #19322) - * improve password hiding, code cleanup (bug #19229) - * add new return code in plugin API to force highlight (for message - handlers only) - * fix bug with server buffer when "look_one_server_buffer" is ON and - server buffer is moved to any number > 1 (bug #19219) - * fix /help command: displays plugin help for redefined commands - (bug #19166) - * prefix '/' disabled in commands (patch #5769) - * fix completion of redefined commands removed by plugins (bug #19176) - * fix memory leaks in perl and python plugins (bug #19163) - * add "call" option to /key command, add new key function "insert" to - insert text on command line (task #6468) - * fix permissions on "dcc" and "logs" directories (bug #18978) - * add event handler to plugin API - * add scots quickstart guide - * add numeric argument for /clear command (buffer number) (patch #5372) - * fix crash when /away command is issued with no server connection - (bug #18839) - * fix crash when closing a buffer opened on many windows - * fix freeze with SSL server when disconnecting after connection loss - (bug #18735) +* fix crash with some special chars in IRC messages (bug #25862) -Version 0.2.3 (2007-01-10): - * fix display bugs with nicklist at top/bottom when look_nicklist_separator - is OFF (bug #18737) - * fix iconv problem, causing truncated words when using iso locale - * fix topic scroll when topic has multi-bytes chars - * fix compilation problem with iconv under FreeBSD - * fix bugs with charset: now decodes/encodes nicks and channels in IRC - messages (bug #18716) +Version 0.2.6 (2007-09-06) +-------------------------- -Version 0.2.2 (2007-01-06): - * fix bug with status bar (missing refresh) when closing a buffer - * fix bug with use of first buffer for a channel if not connected - to server (now allowed only for a server buffer) - * fix refresh bug with private buffer title - * fix bug with nick completion in command args (now uses option - look_nick_completion_ignore) - * fix display bug with color for first line on screen (bug #17719) - * add anti-flood option (irc_anti_flood) (task #5442) - * fix bug with "set_config" function in plugins API (bug #18448) - * plugins: "add_message_handler" now accepts "*" for all IRC messages - * add keys (F9/F10) to scroll topic (task #6030) - * add auto completion with channels and filenames (task #5423) - * fix memleak in keyboard input - * fix refresh bug when changing config options if window is split - * add space between chat and nicklist when position is "right" (bug #17852) - * add option "look_nicklist_separator" (task #5437) - * fix bug with DCC SEND when filename begins with '~' - * add "irc_send_unknown_commands" option to send unknown commands to - IRC server (OFF by default) (task #5947) - * /charset command and charset conversions now made by "charset" plugin - * fix display bug in status bar, wrong length when using UTF-8 - * fix bug with ignore: now any IRC command is allowed - * fix crash with Ctrl-T (transpose) and one char on line (bug #18153) - * add filename completion (task #5425) - * add "modifier" in plugins API - * improve /plugin command - * fix bug on ignore with "mode" IRC command (bug #18058) - * fix crash when loading ruby script if file does not exist, with - Ruby >= 1.9 only (bug #18064) - * add date in plugin function get_buffer_data() - * fix some portability bugs (patch #5271) - * fix iconv detection for BSD (patch #5456) - * fix typo in configure.in (bash specific test) (patch #5450) - * mode changes with /op, /deop, /voice, /devoice, /halfop, /dehalfop are - now sent in one mode command to server (task #5968) - * add more values for config boolean values: y/true/t/1 and n/false/f/0 - * fix bug with /alias and arguments (like $1), now text after - argument(s) is used (bug #17944) - * fix minor display bug with special chars on some arch like PPC +* fix bug with log of plugin messages (option log_plugin_msg) +* add new option "deloutq" to /server command to delete all servers + messages out queues (task #7221) +* fix display bug with some special chars in messages (some words were + truncated on screen) (bug #20944) +* fix UTF-8 bug with color encoding/decoding +* fix crash when searching text in buffer with ctrl-R (bug #20938) +* add string length limit for setup file options +* fix bug with flock() when home is on NFS filesystem (bug #20913) +* add option to align text of messages (except first lines) (task #7246) +* fix user modes in nicklist when ban and nick mode are received in the + same MODE message (bug #20870) +* fix IRC message 333: silently ignore message if error when parsing it +* fix server option "command_delay": does not freeze WeeChat any more +* add paste detection, new options look_paste_max_lines and + col_input_actions (task #5442) +* fix bug with highlight and UTF-8 chars around word (bug #20753) +* add swedish quickstart guide +* add support of channel mode +u (channel user) (bug #20717) +* improve /connect command to connect to a host by creating a temporary + server, add option to /server to create temporary server (task #7095) +* add "copy", "rename" and "keep" options to /server command +* allow clear of multiple selected buffers with /clear (patch #6112) +* add key for setting unread marker on all buffers (default: + ctrl-S + ctrl-U) (task 7180) +* fix nick prefix display on servers that doesn't support all prefixes + (bug #20025) +* fix terminal encoding detection when NLS is disabled (bug #20646) +* fix crash when sending data to channel or pv on disconnected server + (bug #20524) +* improve command /server ant its output +* add 3 default new keys: ctrl-B (left), ctrl-F (right), ctrl-D (delete) +* add "buffer_move" event handler to plugins API (task #6708) +* add key function "jump_previous_buffer" to jump to buffer previously + displayed (new key: alt-J + alt-P) (task #7085) +* add "%*" to completion template, to repeat last completion +* add "-nojoin" option for /connect and /reconnect commands (task #7074) +* fix bugs with IRC color in messages, now color codes are inserted in + command line with ctrl-c, ctrl-b.. instead of %C,%B,.. (bug #20222, + task #7060) +* fix bug with smart nick completion (last speakers first) when a nick + is changed +* fix charset bug with channel names in status bar (bug #20400) +* add "scroll" option to /buffer command +* down key now saves input to history and clears input line (task #7049) +* fix log file when channel name contains "/" (bug #20072) +* command /away allowed when not connected to server (internally stored + and AWAY command is sent when connecting to server) (task #7003) +* add argument for /upgrade command (path to binary) +* fix bug with /topic when channel not open and topic not defined + (bug #20141) +* add hotlist sort with new option "look_hotlist_sort" (task #5870) -Version 0.2.1 (2006-10-01): - * fix crash for DCC receiver when resuming a file (bug #17885) - * fix DCC error for sender when receiver cancels DCC (bug #17838) - * fix random crash with /upgrade command (error when loading buffers) - * fix buffer search by server/channel: now if only channel is specified, - a channel of another server can be found - * fix highlight for DCC, invite and notice: when a window is displaying - buffer, there's no highlight - * command "/away -all" now allowed when not connected to current server - * new signals handled: SIGTERM and SIGHUP (received when terminal is closed): - clean WeeChat quit (send quit to irc servers then quit WeeChat) - * add some new default key bindings for existing keys (for some OS) - * command /key now ok with one arg (key name): display key if found - * fix bug with CTCP VERSION sent on channels (bug #17547) - * add current channel completion for /ctcp command - * fix bugs in get_buffer_data() which breaks the retrieval of buffer - content (perl, lua) - * fix nicklist display bug when top/bottom (not enough lines) (bug #17537) - * fix bug with auto-rejoin of keyed chans (bug #17534) - * add default nick completion when line starts with '//' (bug #17535) - * values yes/no accepted (as on/off) for config boolean values (task #5454) - * add server default notify level (set by /buffer notify on server buffer) - (task #5634) - * fix crashs with /buffer and /charset commands when not connected to any - server (bug #17525) - * add special vars $nick/$channel/$server for server_command, alias and - plugin command handlers - * add arguments $1,$2,..,$9 and $* for alias (task #5831) - * add hotlist in session file when using /upgrade command (task #5449) - * fix nick refresh problem with unrealircd specific modes: chan owner (~) - and chan admin (&) (bug #17340) +Version 0.2.5 (2007-06-07) +-------------------------- -Version 0.2.0 (2006-08-19): - * add 'C'lear option on IRC raw buffer - * IRC raw buffer now uses join/part prefix with color to display messages - * add send of "quit" message to server when using /disconnect - * fix "wallops" command when received, now displayed by WeeChat (bug #17441) - * fix /wallops command (now many words are correctly sent) - * fix command 348 (channel exception list, received by /mode #chan e) - * add missing modes (channel & user), now all modes are allowed (bug #16606) - * add "%m" for completion with self nick (on current server) - * add missing IRC commands (310, 326, 329, 338) - * fix DCC restore after /upgrade (order is now correctly saved) - * fix away after server disconnection (now away is set again when - reconnecting) (bug #16359) - * fix DCC file connection problem (connection from receiver to sender) - * improve DCC speed (up to x5 on LAN) by forking for DCC files and a - new option "dcc_fast_send" (does not wait for ACK) (task #5758) - * fix crash when purging DCC with high number of DCC (> window size) - * fix completion for command handlers (now empty completion_template - means nick completion, "-" string means no completion at all) - * fix nick alignment problem when look_nickmode is off - * add generic function for incoming numeric IRC commands (bug #16611) - * fix crash when doing "/part something" on a server buffer (bug #17201) - * charsets are now checked when set by /charset command - * add "look_save_on_exit" option (patch from Emanuele Giaquinta) - * fix crash on DCC buffer under Darwin 8 (bug #17115) - * add configure option for doc XSL prefix (bug #16991) - * fix bug with spaces in script names (bug #16957) - * fix random crash when "MODE #chan -l" is received - * fix bug in IRC parser (random crash with malformed IRC messages) - * fix refresh bugs when terminal is resized: too many refreshs, - display bug with split windows - * case ignored for channel names in charset options (bug #16858) - * fix crash when setting look_one_server_buffer to ON (bug #16932) - * add new functions in plugin/script API: get window info, - get buffer info, get buffer content - * add polish, russian and czech quickstart guide - * fix display bug with special char (bug #16732) - * add color encoding for some commands like /me - * add aspell plugin - * rename plugins names (remove "lib" prefix in name) - * fix crash when closing DCC/raw buffer if 2 are open (bug #16808) - * fix crashes with DCC chat remove/purge on DCC view (bug #16775) - * fix bug with connection to bnc (bug #16760) - * command /save now writes plugins options (~/.weechat/plugins.rc) - * fix crash with "register" function in plugin scripts (bug #16701) - * fix random crash at exit (/quit or /upgrade) with split windows +* fix QUOTE command: now allowed when socket is ok (even if IRC + connection to server is not ok) (bug #20113) +* add missing IRC commands (327, 378, 379) (bug #20091) +* fix hotlist when exiting search mode: current buffer is removed from + hotlist +* add "%M" for completion with nicks of current server (nicks on open + channels) (task #6931) +* improve key bindings: now possible to bind a key on many commands, + separated by semicolon (task #5444) +* improve IRC long message split: use word boundary (task #6685) +* remove ":" for unknown IRC commands before arguments (bug #19929) +* fix "%C" completion: now completes with all channels of all servers +* fix bug with "/buffer query_name", add server and channel completion + for /buffer command (bug #19928) +* add cmake for weechat compile (patch #5943) +* fix IRC mode parsing when receiving modes with arguments (bug #19902) +* fix crash with IRC JOIN malformed message (bug #19891) +* fix bug with nick prefixes on some IRC servers (bug #19854) +* improve setup file save: now writes temporary file, then rename it + (task #6847) +* fix bug with $nick/$channel/$server variables in commands +* forget current nick when user manually disconnects from server +* fix nick display in input window +* fix bug with erroneous nickname when connecting to server (bug #19812) +* fix display bugs in IRC error messages +* add protocol priority for gnutls (patch #5915) +* add channel admin mode "!" for some IRC servers +* fix bug with iso2022jp locale (bug #18719) +* fix string format bug when displaying string thru plugin script API +* add /reconnect command (task #5448) +* add "-all" option for /connect and /disconnect commands (task #6232) +* improve nick completion: completion with last speakers first and self + nick at the end; add option look_nick_completion_smart, enabled by + default (task #5896) +* fix nick completion in command arguments (bug #19590) +* fix possible crash with nick completion when a nick leaves channel + (bug #19589) +* add color for input text not found in buffer history +* fix USER message when connecting to IRC server (patch #5835) -Version 0.1.9 (2006-05-25): - * fix /squery command (message sent to server, now ok with # args > 2) - * fix /alias command (with an alias name, display content) - * improve lua plugin detection (bug #16574) - * add backtrace when WeeChat crashes, log file automatically renamed - * add lock for log file (~/.weechat/weechat.log), only one WeeChat - process can use this file (bug #16382) - * fix crash with malformed UTF-8 strings - * fix crash with ncurses color when too many colors defined in ncurses - (bug #16556) - * add new key to find previous completion (shift-tab by default) - * fix bug with long outgoing IRC messages (> 512 bytes) (bug #16358) - * fix Ruby crash when handler does not return OK or KO (bug #16552) - * fix UTF-8 display bug with chars using more than one cell on screen - (bug #16356) - * fix display bug with DCC file size when > 1 Gb - * fix refresh bug (deadlock in curses) when terminal is resized - (bug #16542) - * fix nicklist sort bug - * add russian translations (thanks to Pavel Shevchuk) - * add german doc (thanks to Frank Zacharias) - * add missing IRC commands (006, 007, 290, 292, 310, 379, 437, 974) - * fix crash when multiple pv have same name: now it's forbidden - and pv buffer is not renamed (when a nick changes) if another - exists with same name (bug #16369) - * command /clear [-all] now clears hotlist - * fix crash after /upgrade if a line in history is empty (bug #16379) - * fix many crashes with DCC chat (bug #16416) - * add new option to customize input prompt - * add nick modes - * fix commands 332, 333 (/topic now ok when channel is not opened) - * remove color encoding and charset conversion for commands (only - allowed in text sent to channel/private) - * add hostnames associeted to nicks (available for /ban completion) - * add "+p" mode for channels, fix mode display in status bar - * add nick alignment options - * fix /names command: now displays result when not on a channel - * fix refresh bug (too many refresh) when terminal is resized - * fix nicklist display bugs when on top or bottom of chat window - * add keyboard handler to plugin API - * improve script plugin loader - * add hostname/IP option for connection to server - * fix --disable-plugins option in configure script - * add /setp command (set plugin options) - * fix high CPU usage when running under a screen that has been killed - * aliases are executed before WeeChat/IRC commands, add /builtin command - * add /cycle command, /part command does close buffer any more (use - /buffer close (or alias /close) to part and close buffer +Version 0.2.4 (2007-03-29) +-------------------------- -Version 0.1.8 (2006-03-18): - * improve Ruby plugin - * fix /set command when internal server name contains one or many dots - * fix get_info plugin API function when no server at all is opened - * fix display bug when top of buffer is displayed and first line is - removed (according to "history_max_lines" setting) - * fix /mode command output - * improve alias completion (now uses target command for completion) - * fix completion problem in private with nicks - * add missing IRC command (487) - * add inactivity time, available for plugins via get_info("inactivity") - * keys alt-{home|end} to scroll top/bottom, alt-{f11-f12} to scroll - nicklist top/bottom - * add special names for plugin message handlers: weechat_pv, - weechat_highlight, weechat_ctcp, weechat_dcc - * script plugins now load scripts in WeeChat system share directory - * /msg command does not open any buffer any more - * fix crash when using global history (when older entry is removed) - * add IRC raw data buffer (new key: alt-J + alt-R) - * fix display bug with /kill command - * add new plugins functions: add_timer_handler, remove_timer_handler, - remove_infobar - * plugin messages handlers now called when message is ignored (by /ignore) - * new behaviour for messages ignored by a message handler: now WeeChat - executes standard handler, treating message as "ignored" - * many commands allowed for aliases - * many commands allowed when connecting to server - * add Lua script plugin - * add functions in plugins API: get_server_info, free_server_info, - get_channel_info, free_channel_info, get_nick_info, free_nick_info - * add option "look_nick_complete_first" (patch from Gwenn) - * add option "look_open_near_server" (patch from Gwenn) - * fix bug with /upgrade and servers buffer - * fix bug with "get_dcc_info" plugin interface function - * add new scroll keys for a few lines up/down (default: meta-pgup/pgdn) - (patch from Pistos) - * add new option "irc_away_check_max_nicks" to disable away check on - channels with high number of nicks (patch from Gwenn) - * add new command line argument for setting WeeChat homedir (-d or --dir) - (patch from Gwenn) - * fix bug with charset in infobar highlights - * fix bug with buffer detection in plugins/scripts commands - * fix bug with /history command - * add option "irc_show_away_once", to show away message only once in pv - * add partial hungarian translation +* fix color bug with IRC messages displayed by plugins (bug #19442) +* fix topic charset, now using channel charset if defined (bug #19386) +* rename log file for DCC chat (now .dcc..weechatlog) +* fix crash when closing a pv if a DCC chat is open on same nick + (bug #19147) +* fix bug with channel topic after reconnection (not erased) (bug #19384) +* add current buffer in hotlist when scrolling up in buffer (task #6664) +* fix bug with explode_string / free_exploded_string when max_items > 0 +* add new key (ctrl-R) for interactive and incremental search in buffer + history (task #6628) +* fix /topic completion when no topic set on current channel (bug #19322) +* improve password hiding, code cleanup (bug #19229) +* add new return code in plugin API to force highlight (for message + handlers only) +* fix bug with server buffer when "look_one_server_buffer" is ON and + server buffer is moved to any number > 1 (bug #19219) +* fix /help command: displays plugin help for redefined commands + (bug #19166) +* prefix "/" disabled in commands (patch #5769) +* fix completion of redefined commands removed by plugins (bug #19176) +* fix memory leaks in perl and python plugins (bug #19163) +* add "call" option to /key command, add new key function "insert" to + insert text on command line (task #6468) +* fix permissions on "dcc" and "logs" directories (bug #18978) +* add event handler to plugin API +* add scots quickstart guide +* add numeric argument for /clear command (buffer number) (patch #5372) +* fix crash when /away command is issued with no server connection + (bug #18839) +* fix crash when closing a buffer opened on many windows +* fix freeze with SSL server when disconnecting after connection loss + (bug #18735) -Version 0.1.7 (2006-01-14): - * fix msg command (now allowed in private buffer with "*" as target) - * remove "irc_default_msg_away" setting, for RFC 2812 conformity - (/away command wihtout argument only removes away status), - new values for "irc_display_away" (off, local, channel) - * fix refresh bug with Solaris when term size is changed - * replace Texinfo doc by XML Docbook - * add color for window separators (when split) - * add completion system for plugins/scripts commands - * fix plugins autoload - * add charset by server and channel, new command: /charset - * add Ruby script plugin - * add /upgrade command - * add ETA (Estimated Time of Arrival) for DCC files - * /nick command is now allowed when not connected to server - * add server/channel arg to /buffer command for jumping to buffer - * fix display bug in chat window when a message length equals to window - width - * add new keys for switching to other windows: alt-W followed by - alt-{arrow} - * add new keys for scrolling to previous/next highlight: alt-P / alt-N - * add "read marker": an indicator for first unread line in a - server or channel buffer (new key alt-U to scroll to marker) - * new window maganement: custom size for windows, auto resize when - terminal is resized - * fix infinite loop when resizing term to small size - * add /history command +Version 0.2.3 (2007-01-10) +-------------------------- -Version 0.1.6 (2005-11-11): - * new color management system, IRC colors are now correctly - displayed and can be removed by new options irc_colors_receive - and irc_colors_send - * fix scroll problem when one line is bigger than screen size - * add setting for having one server buffer for all servers - (look_one_server_buffer) - * add setting for ignoring some chars when completing nicks - * fix IRC message parser bug - * signal SIGPIPE is now ignored - * add partial match for highlights - * add dcc_own_ip and dcc_port_range settings - * full UTF-8 support, auto-detection of UTF-8 usage (locale) - * add "Day changed to [date]" message when day changes - * new plugin interface, rewritten from scratch: now loads dynamic C - library, and perl/python are script plugins - * log options (for server/channel/private) can now be set while - WeeChat is running - * add channel modes +e and +f - * add some missing IRC commands, fix command 367 - * add colors for input buffer and current channel of status bar - * add online help for config options (with /set full_option_name) - * enhanced "smart" hotlist, with names (new options: - look_hotlist_names_{count|level|length}) +* fix display bugs with nicklist at top/bottom when look_nicklist_separator + is OFF (bug #18737) +* fix iconv problem, causing truncated words when using iso locale +* fix topic scroll when topic has multi-bytes chars +* fix compilation problem with iconv under FreeBSD +* fix bugs with charset: now decodes/encodes nicks and channels in IRC + messages (bug #18716) -Version 0.1.5 (2005-09-24): - * add /ame command (send CTCP action to all channels of all - connected servers) - * add setting "irc_notice_as_pv" to see notices as pv - * add nicks colors in setup file - * fix DCC bug: delete failed file only if really empty (on disk) - * fix IRC message parser bug - * fix scroll problem (screen moving when scrolling and new line - displayed) - * fix infinite loop when scrolling back and displaying long lines - * fix crash when closing a buffer used by more than one window - * add some missing IRC commands - * fix DCC display bug (now decodes string according to charset) - * add /ignore and /unignore commands - * fix bug with strings comparison (str[n]casecmp) and some locales - (like turkish), now using ASCII comparison (thanks to roktas) - * signal SIGQUIT is now ignored - * fix refresh bug when one line is bigger than screen size - * fix look_nicklist_min_size and look_nicklist_max_size options - * fix refresh bug when changing channel modes - * jump to next server now saves current channel buffer for each server - * add keys ctrl-up/ctrl-down to call previous/next command in global - history (common to all buffers) +Version 0.2.2 (2007-01-06) +-------------------------- -Version 0.1.4 (2005-07-30): - * join and part/quit prefixes (arrows) now displayed with different colors - * add "irc_highlight" setting, to get highlight with any word - * fix auto-rejoin for channels with key - * fix /ctcp command (now any command/data allowed) - * add /amsg command (send text to all channels of all connected servers) - * fix SIGSEGV handler (now write a core file by aborting program) - * fix statusbar & infobar background refresh problem with some systems - * add color for private in hotlist (different than color for highlight) - * add DCC resume and timeout - * add function for Perl/Python to get DCC list - * fix FIFO pipe (command now authorized on a buffer not connected - to an IRC server) - * topic completion now decodes UTF-8 string - * fix bug with IRC URL on command line (irc://) - * new keyboard management: keys are setup in config file, add new command - /key, add some new default keys, alt-K key is used to grab key (useful - for /key command) - * add seconds in infobar time (optional thanks to new setting) - * fix some curses refreshs - * add auto-prefix with "#" for channels (if no prefix found), with /join command +* fix bug with status bar (missing refresh) when closing a buffer +* fix bug with use of first buffer for a channel if not connected + to server (now allowed only for a server buffer) +* fix refresh bug with private buffer title +* fix bug with nick completion in command args (now uses option + look_nick_completion_ignore) +* fix display bug with color for first line on screen (bug #17719) +* add anti-flood option (irc_anti_flood) (task #5442) +* fix bug with "set_config" function in plugins API (bug #18448) +* plugins: "add_message_handler" now accepts "*" for all IRC messages +* add keys (F9/F10) to scroll topic (task #6030) +* add auto completion with channels and filenames (task #5423) +* fix memleak in keyboard input +* fix refresh bug when changing config options if window is split +* add space between chat and nicklist when position is "right" (bug #17852) +* add option "look_nicklist_separator" (task #5437) +* fix bug with DCC SEND when filename begins with "~" +* add "irc_send_unknown_commands" option to send unknown commands to + IRC server (OFF by default) (task #5947) +* /charset command and charset conversions now made by "charset" plugin +* fix display bug in status bar, wrong length when using UTF-8 +* fix bug with ignore: now any IRC command is allowed +* fix crash with Ctrl-T (transpose) and one char on line (bug #18153) +* add filename completion (task #5425) +* add "modifier" in plugins API +* improve /plugin command +* fix bug on ignore with "mode" IRC command (bug #18058) +* fix crash when loading ruby script if file does not exist, with + Ruby >= 1.9 only (bug #18064) +* add date in plugin function get_buffer_data() +* fix some portability bugs (patch #5271) +* fix iconv detection for BSD (patch #5456) +* fix typo in configure.in (bash specific test) (patch #5450) +* mode changes with /op, /deop, /voice, /devoice, /halfop, /dehalfop are + now sent in one mode command to server (task #5968) +* add more values for config boolean values: y/true/t/1 and n/false/f/0 +* fix bug with /alias and arguments (like $1), now text after + argument(s) is used (bug #17944) +* fix minor display bug with special chars on some arch like PPC -Version 0.1.3 (2005-07-02): - * proxy support (http, socks4, socks5) with authentification (http, socks5) - and ipv6 support (client to proxy) - * add completion for config option (with /set command) - * commands from users outside channel now authorized (if special user or - channel without "n" flag) - * add IPv6 support - * kill command now received and displayed - * add SSL support - * channel notify levels are saved in config file (new option - "server_notify_levels" for server sections) - * part message now accepts %v (replaced by WeeChat version), like quit message - * errors while loading perl scripts are now displayed in server buffer - (instead of current buffer) - * in python scripts, all messages written in stdin and stderr are redirected - in server buffer - * fix a filename error while loading a python script manually - * fix plugins "print" and "prnt" functions: now ok for writing on server - buffers - * fix color problem with new libcurses version - * fix crash when using alt-S or alt-X on DCC buffer (alt-D) - * fix startup crash when config file (~/.weechat/weechat.rc) is not found - * improve Perl/Python libs detection for ./configure script +Version 0.2.1 (2006-10-01) +-------------------------- -Version 0.1.2 (2005-05-21): - * add Python plugin support, improve Perl interface (and now Perl/Python - libraries are checked by configure script) - * add nicklist scroll keys (alt+{home/end/pgup/pgdn} or F11/F12) - * add transfer rate for DCC files - * add "-all" option for /nick command - * buffers timestamp can now be changed (new option in config file) - * WeeChat now ok under *BSD and Mac OS X - * fix nicklist sort - * fix crash when purging old DCC - * fix crash with 64-bits arch (like AMD64) when converting UTF-8 - * add missing IRC commands (307, 341, 485, 671) +* fix crash for DCC receiver when resuming a file (bug #17885) +* fix DCC error for sender when receiver cancels DCC (bug #17838) +* fix random crash with /upgrade command (error when loading buffers) +* fix buffer search by server/channel: now if only channel is specified, + a channel of another server can be found +* fix highlight for DCC, invite and notice: when a window is displaying + buffer, there's no highlight +* command "/away -all" now allowed when not connected to current server +* new signals handled: SIGTERM and SIGHUP (received when terminal is closed): + clean WeeChat quit (send quit to irc servers then quit WeeChat) +* add some new default key bindings for existing keys (for some OS) +* command /key now ok with one arg (key name): display key if found +* fix bug with CTCP VERSION sent on channels (bug #17547) +* add current channel completion for /ctcp command +* fix bugs in get_buffer_data() which breaks the retrieval of buffer + content (perl, lua) +* fix nicklist display bug when top/bottom (not enough lines) (bug #17537) +* fix bug with auto-rejoin of keyed chans (bug #17534) +* add default nick completion when line starts with "//" (bug #17535) +* values yes/no accepted (as on/off) for config boolean values (task #5454) +* add server default notify level (set by /buffer notify on server buffer) + (task #5634) +* fix crashs with /buffer and /charset commands when not connected to any + server (bug #17525) +* add special vars $nick/$channel/$server for server_command, alias and + plugin command handlers +* add arguments $1,$2,..,$9 and $* for alias (task #5831) +* add hotlist in session file when using /upgrade command (task #5449) +* fix nick refresh problem with unrealircd specific modes: chan owner (~) + and chan admin (&) (bug #17340) -Version 0.1.1 (2005-03-20): - * add nicks count for channel buffers - * add FIFO pipe for remote control - * add crash dump when WeeChat receives SIGSEGV (Segmentation fault) - * add new display engine: doesn't cut words at end of lines - * add DCC send and DCC chat - * add /halfop & /dehalfop commands, fix halfop display bug in nicklist - * add /ban, /unban and /kickban commands - * add spanish translation - * add --irc-commands and --weechat-commands command line options - * connection to IRC server is now made by child process (non blocking) - * add support for UnrealIrcd ("~" for chan owner, "&" for chan admin) - * new key for window switch (now: F5/F6=switch buffer, F7/F8=switch window) - * on server buffer, only server messages are logged - * improve /help command output - * plugins messages are logged with new config option (log_plugin_msg) - * fix /kick command - * fix /invite command (and now invite requests are displayed) - * fix /buffer close command (now ok when disconnected from server) - * fix display bugs when many windows are opened +Version 0.2.0 (2006-08-19) +-------------------------- -Version 0.1.0 (2005-02-12): - * improve /window command: now split and merge are ok - * away nicks are now displayed with another color (new option: "irc_away_check") - * add away indicator in status bar - * add lag indicator (and auto-disconnect after a delay if important lag) - * improve completion: now completes commands arguments (IRC and internal), - when only one completion matches, completion mechanism is stoped (to - complete command arg for example) - * improve /set command: empty strings are allowed, new colors, server - options can be changed while WeeChat is running - * add default away/part/quit messages in config file - * new [irc] section in config file, move option "look_display_away" to - "irc_display_away" - * server messages & errors are all prefixed (by 3 chars, like '-@-') - * add new options for charset (UTF-8 support): look_charset_decode, - look_charset_encode and look_charset_internal - * fix many memory leaks - * fix colors bug: remove "gray" color (replaced by "default"), colors are - ok when terminal has white (or light) background - * fix crash when resizing terminal to small size - * fix crash when multiple servers and big messages received from server - * fix crash when closing some private buffers - * fix crash when unknown section with option(s) in config file - * fix /op, /deop, /voice, /devoice (now ok with many nicks) - * fix /me command (now ok without parameter) - * fix /away command (now ok if not away) - * logs are now disabled by default (server/channel/private) +* add "C"lear option on IRC raw buffer +* IRC raw buffer now uses join/part prefix with color to display messages +* add send of "quit" message to server when using /disconnect +* fix "wallops" command when received, now displayed by WeeChat (bug #17441) +* fix /wallops command (now many words are correctly sent) +* fix command 348 (channel exception list, received by /mode #chan e) +* add missing modes (channel & user), now all modes are allowed (bug #16606) +* add "%m" for completion with self nick (on current server) +* add missing IRC commands (310, 326, 329, 338) +* fix DCC restore after /upgrade (order is now correctly saved) +* fix away after server disconnection (now away is set again when + reconnecting) (bug #16359) +* fix DCC file connection problem (connection from receiver to sender) +* improve DCC speed (up to x5 on LAN) by forking for DCC files and a + new option "dcc_fast_send" (does not wait for ACK) (task #5758) +* fix crash when purging DCC with high number of DCC (> window size) +* fix completion for command handlers (now empty completion_template + means nick completion, "-" string means no completion at all) +* fix nick alignment problem when look_nickmode is off +* add generic function for incoming numeric IRC commands (bug #16611) +* fix crash when doing "/part something" on a server buffer (bug #17201) +* charsets are now checked when set by /charset command +* add "look_save_on_exit" option (patch from Emanuele Giaquinta) +* fix crash on DCC buffer under Darwin 8 (bug #17115) +* add configure option for doc XSL prefix (bug #16991) +* fix bug with spaces in script names (bug #16957) +* fix random crash when "MODE #chan -l" is received +* fix bug in IRC parser (random crash with malformed IRC messages) +* fix refresh bugs when terminal is resized: too many refreshs, + display bug with split windows +* case ignored for channel names in charset options (bug #16858) +* fix crash when setting look_one_server_buffer to ON (bug #16932) +* add new functions in plugin/script API: get window info, + get buffer info, get buffer content +* add polish, russian and czech quickstart guide +* fix display bug with special char (bug #16732) +* add color encoding for some commands like /me +* add aspell plugin +* rename plugins names (remove "lib" prefix in name) +* fix crash when closing DCC/raw buffer if 2 are open (bug #16808) +* fix crashes with DCC chat remove/purge on DCC view (bug #16775) +* fix bug with connection to bnc (bug #16760) +* command /save now writes plugins options (~/.weechat/plugins.rc) +* fix crash with "register" function in plugin scripts (bug #16701) +* fix random crash at exit (/quit or /upgrade) with split windows -Version 0.0.9 (2005-01-01): - * auto-reconnection to server (new options: server_autoreconnect (on/off), - server_autoreconnect_delay (in seconds)) - * fix major bug when socket is closed by server (100% CPU usage), - and disconnections are now ok (all channels are "closed", history is still - visible, and buffer will be used again if reconnection to server) - * option "look_remove_colors_from_msgs" is now working - * fix display of nick mode changes - * new command "/buffer close" (close any server/channel/private buffer) - * fix /notice command (and display when received from server) - * new keys: ctrl+A (=home), ctrl+E (=end), ctrl+W (= ctrl+Backspace), - alt-S (switch to server buffer), alt-X (switch to first channel of next - server) - * add new config option: "server_command_delay" (delay in seconds after - startup command for each server) +Version 0.1.9 (2006-05-25) +-------------------------- -Version 0.0.8 (2004-10-30): - * fix /kick command: now ok with many words as reason - * nickserv passwords hidden (new config option: log_hide_nickserv_pwd on/off) - * auto-rejoin channels when kicked (new config option: server_autorejoin on/off) - * add IRC::command function for Perl scripts - * fix bug when adding alias with same name as other - * /buffer command developed (buffers list, move and notify) - * logging buffers to disk (server/channel/private according to user prefs) - * add config option "look_display_away" to announce away in channels - * fix crash when resizing terminal to very small size - * "-MORE-" message is now erased when switching to another buffer - * DCC file receive ok (alt-D for DCC view) - * /query command now reopens private buffer if already opened - * add key for redrawing terminal (ctrl-L) - * add key for clearing hotlist (alt-R) +* fix /squery command (message sent to server, now ok with # args > 2) +* fix /alias command (with an alias name, display content) +* improve lua plugin detection (bug #16574) +* add backtrace when WeeChat crashes, log file automatically renamed +* add lock for log file (~/.weechat/weechat.log), only one WeeChat + process can use this file (bug #16382) +* fix crash with malformed UTF-8 strings +* fix crash with ncurses color when too many colors defined in ncurses + (bug #16556) +* add new key to find previous completion (shift-tab by default) +* fix bug with long outgoing IRC messages (> 512 bytes) (bug #16358) +* fix Ruby crash when handler does not return OK or KO (bug #16552) +* fix UTF-8 display bug with chars using more than one cell on screen + (bug #16356) +* fix display bug with DCC file size when > 1 Gb +* fix refresh bug (deadlock in curses) when terminal is resized + (bug #16542) +* fix nicklist sort bug +* add russian translations (thanks to Pavel Shevchuk) +* add german doc (thanks to Frank Zacharias) +* add missing IRC commands (006, 007, 290, 292, 310, 379, 437, 974) +* fix crash when multiple pv have same name: now it's forbidden + and pv buffer is not renamed (when a nick changes) if another + exists with same name (bug #16369) +* command /clear [-all] now clears hotlist +* fix crash after /upgrade if a line in history is empty (bug #16379) +* fix many crashes with DCC chat (bug #16416) +* add new option to customize input prompt +* add nick modes +* fix commands 332, 333 (/topic now ok when channel is not opened) +* remove color encoding and charset conversion for commands (only + allowed in text sent to channel/private) +* add hostnames associeted to nicks (available for /ban completion) +* add "+p" mode for channels, fix mode display in status bar +* add nick alignment options +* fix /names command: now displays result when not on a channel +* fix refresh bug (too many refresh) when terminal is resized +* fix nicklist display bugs when on top or bottom of chat window +* add keyboard handler to plugin API +* improve script plugin loader +* add hostname/IP option for connection to server +* fix --disable-plugins option in configure script +* add /setp command (set plugin options) +* fix high CPU usage when running under a screen that has been killed +* aliases are executed before WeeChat/IRC commands, add /builtin command +* add /cycle command, /part command does close buffer any more (use + /buffer close (or alias /close) to part and close buffer -Version 0.0.7 (2004-08-08): - * new "col_status_delimiters" config option - * add command /buffer , buffers ordered by number, auto-jump to active - buffers (alt-A), jump to buffers by number (alt-number) - * add command /window, split terminal horizontally/vertically - * unique color for each nick (based on nickname) - * action messages are now considered as messages, not crappy joins/parts - * fix display bug when nicklist is displayed at bottom of screen - * add history limit (text buffer and commands) - * replace --enable-debug with --with-debug option for ./configure, which is - now integer: 1 = compiler debug flag, 2 = same 1 with verbose debug messages - in WeeChat (default: 0 = no debug) +Version 0.1.8 (2006-03-18) +-------------------------- -Version 0.0.6 (2004-06-05): - * improve channel highlight (priority to message vs join/part) - * fix bug when opened private win and remote user changes his nick - * add command /query (starts private conversation) - * add IRC messages 476, 477 - * /mode command is now ok and channel flags are displayed in status bar - * fix display bug (text was blinking when scrolling) - * CTCP Version reply is now in english only and doesn't show host (security reason) +* improve Ruby plugin +* fix /set command when internal server name contains one or many dots +* fix get_info plugin API function when no server at all is opened +* fix display bug when top of buffer is displayed and first line is + removed (according to "history_max_lines" setting) +* fix /mode command output +* improve alias completion (now uses target command for completion) +* fix completion problem in private with nicks +* add missing IRC command (487) +* add inactivity time, available for plugins via get_info("inactivity") +* keys alt-{home|end} to scroll top/bottom, alt-{f11-f12} to scroll + nicklist top/bottom +* add special names for plugin message handlers: weechat_pv, + weechat_highlight, weechat_ctcp, weechat_dcc +* script plugins now load scripts in WeeChat system share directory +* /msg command does not open any buffer any more +* fix crash when using global history (when older entry is removed) +* add IRC raw data buffer (new key: alt-J + alt-R) +* fix display bug with /kill command +* add new plugins functions: add_timer_handler, remove_timer_handler, + remove_infobar +* plugin messages handlers now called when message is ignored (by /ignore) +* new behaviour for messages ignored by a message handler: now WeeChat + executes standard handler, treating message as "ignored" +* many commands allowed for aliases +* many commands allowed when connecting to server +* add Lua script plugin +* add functions in plugins API: get_server_info, free_server_info, + get_channel_info, free_channel_info, get_nick_info, free_nick_info +* add option "look_nick_complete_first" (patch from Gwenn) +* add option "look_open_near_server" (patch from Gwenn) +* fix bug with /upgrade and servers buffer +* fix bug with "get_dcc_info" plugin interface function +* add new scroll keys for a few lines up/down (default: meta-pgup/pgdn) + (patch from Pistos) +* add new option "irc_away_check_max_nicks" to disable away check on + channels with high number of nicks (patch from Gwenn) +* add new command line argument for setting WeeChat homedir (-d or --dir) + (patch from Gwenn) +* fix bug with charset in infobar highlights +* fix bug with buffer detection in plugins/scripts commands +* fix bug with /history command +* add option "irc_show_away_once", to show away message only once in pv +* add partial hungarian translation -Version 0.0.5 (2004-02-07): - * /set command to modify config options when WeeChat is running - * fix look_nicklist config option, now enables/disables nicklist - * secure code to prevent buffer overflows and memory leaks - * fix QUIT IRC command: now sent to all connected servers (not only current) - * URL command line parameter to connect to server(s) - * new Perl script function to display message in info bar ("IRC::print_infobar") - * info bar highlight notifications - * add info bar timestamp in config ("look_infobar_timestamp") - * add info bar (optional, "look_infobar" to enable it, "on" by default) - * fix crash with /oper command - * for default config file, nick is now based on un*x username (thanks to Witukind) - * fix crash when config file cannot be written - * add -c (or --config) command line parameter to see config file options - * highlight action messages +Version 0.1.7 (2006-01-14) +-------------------------- -Version 0.0.4 (2004-01-01): - * Perl plugin, with auto-load - * when private window is created (another user is talking), WeeChat does not - switch to this window - * highlight when our nick is written in a channel/private window - * catch ctrl-C (ignored) - * debug messages can be enabled via ./configure --enbale-debug option +* fix msg command (now allowed in private buffer with "*" as target) +* remove "irc_default_msg_away" setting, for RFC 2812 conformity + (/away command wihtout argument only removes away status), + new values for "irc_display_away" (off, local, channel) +* fix refresh bug with Solaris when term size is changed +* replace Texinfo doc by XML Docbook +* add color for window separators (when split) +* add completion system for plugins/scripts commands +* fix plugins autoload +* add charset by server and channel, new command: /charset +* add Ruby script plugin +* add /upgrade command +* add ETA (Estimated Time of Arrival) for DCC files +* /nick command is now allowed when not connected to server +* add server/channel arg to /buffer command for jumping to buffer +* fix display bug in chat window when a message length equals to window + width +* add new keys for switching to other windows: alt-W followed by + alt-{arrow} +* add new keys for scrolling to previous/next highlight: alt-P / alt-N +* add "read marker": an indicator for first unread line in a + server or channel buffer (new key alt-U to scroll to marker) +* new window maganement: custom size for windows, auto resize when + terminal is resized +* fix infinite loop when resizing term to small size +* add /history command -Version 0.0.3 (2003-11-03): - * ./configure script to build WeeChat - * nicks are now correctly sorted (op, halfop, voice, other) - * fix problem with '353' IRC message (nicklist) - * fix problem when nick is truncated by server - * fix crash when entering text without any server connection - * fix crash when /set command is executed - * fix display bug (text was blinking when scrolling) - * french translation - * new IRC command: /stats, /service, /squit, /motd, /lusers, /links, /time, - /trace, /admin, /info, /servlist, /squery, /who, /whowas, /die, /summon, - /users, /wallops, /userhost, /ison, /ctcp ping - * code cleanup +Version 0.1.6 (2005-11-11) +-------------------------- -Version 0.0.2 (2003-10-05): - * add commands /rehash and /restart - * and command and auto-join channels when connected to server - * new commands for alias: /alias, /unalias (new section in config file) - * config is now saved automatically when quitting WeeChat, add /save command - * new commands for servers: /server, /connect, /disconnect - * add autoconnect flag for each server in config file - * add "look_set_title" option in config file - * term window title is modified with WeeChat name and version - * fix nicklist display bug - * fix crash when sending command which can only be received - * CTCP version returns more info (about OS) +* new color management system, IRC colors are now correctly + displayed and can be removed by new options irc_colors_receive + and irc_colors_send +* fix scroll problem when one line is bigger than screen size +* add setting for having one server buffer for all servers + (look_one_server_buffer) +* add setting for ignoring some chars when completing nicks +* fix IRC message parser bug +* signal SIGPIPE is now ignored +* add partial match for highlights +* add dcc_own_ip and dcc_port_range settings +* full UTF-8 support, auto-detection of UTF-8 usage (locale) +* add "Day changed to [date]" message when day changes +* new plugin interface, rewritten from scratch: now loads dynamic C + library, and perl/python are script plugins +* log options (for server/channel/private) can now be set while + WeeChat is running +* add channel modes +e and +f +* add some missing IRC commands, fix command 367 +* add colors for input buffer and current channel of status bar +* add online help for config options (with /set full_option_name) +* enhanced "smart" hotlist, with names (new options: + look_hotlist_names_{count|level|length}) -Version 0.0.1 (2003-09-27): - * ncurses GUI with color output - * multi-servers - * channel windows, with nicklist (position: top, bottom, left or right) - * private windows - * IRC commands: away, ctcp, deop, devoice, invite, join, kick, kill, list, - me, mode, msg, names, nick, notice, op, oper, part, ping, pong, quit, - quote, topic, version, voice, whois - * WeeChat commands: clear, help, set (partial) - * many config options - * log file (~/.weechat/weechat.log) - * nicklist can be moved on top, bottom, left or right of window +Version 0.1.5 (2005-09-24) +-------------------------- + +* add /ame command (send CTCP action to all channels of all + connected servers) +* add setting "irc_notice_as_pv" to see notices as pv +* add nicks colors in setup file +* fix DCC bug: delete failed file only if really empty (on disk) +* fix IRC message parser bug +* fix scroll problem (screen moving when scrolling and new line + displayed) +* fix infinite loop when scrolling back and displaying long lines +* fix crash when closing a buffer used by more than one window +* add some missing IRC commands +* fix DCC display bug (now decodes string according to charset) +* add /ignore and /unignore commands +* fix bug with strings comparison (str[n]casecmp) and some locales + (like turkish), now using ASCII comparison (thanks to roktas) +* signal SIGQUIT is now ignored +* fix refresh bug when one line is bigger than screen size +* fix look_nicklist_min_size and look_nicklist_max_size options +* fix refresh bug when changing channel modes +* jump to next server now saves current channel buffer for each server +* add keys ctrl-up/ctrl-down to call previous/next command in global + history (common to all buffers) + +Version 0.1.4 (2005-07-30) +-------------------------- + +* join and part/quit prefixes (arrows) now displayed with different colors +* add "irc_highlight" setting, to get highlight with any word +* fix auto-rejoin for channels with key +* fix /ctcp command (now any command/data allowed) +* add /amsg command (send text to all channels of all connected servers) +* fix SIGSEGV handler (now write a core file by aborting program) +* fix statusbar & infobar background refresh problem with some systems +* add color for private in hotlist (different than color for highlight) +* add DCC resume and timeout +* add function for Perl/Python to get DCC list +* fix FIFO pipe (command now authorized on a buffer not connected + to an IRC server) +* topic completion now decodes UTF-8 string +* fix bug with IRC URL on command line (irc://) +* new keyboard management: keys are setup in config file, add new command + /key, add some new default keys, alt-K key is used to grab key (useful + for /key command) +* add seconds in infobar time (optional thanks to new setting) +* fix some curses refreshs +* add auto-prefix with "#" for channels (if no prefix found), with /join command + +Version 0.1.3 (2005-07-02) +-------------------------- + +* proxy support (http, socks4, socks5) with authentification (http, socks5) + and ipv6 support (client to proxy) +* add completion for config option (with /set command) +* commands from users outside channel now authorized (if special user or + channel without "n" flag) +* add IPv6 support +* kill command now received and displayed +* add SSL support +* channel notify levels are saved in config file (new option + "server_notify_levels" for server sections) +* part message now accepts %v (replaced by WeeChat version), like quit message +* errors while loading perl scripts are now displayed in server buffer + (instead of current buffer) +* in python scripts, all messages written in stdin and stderr are redirected + in server buffer +* fix a filename error while loading a python script manually +* fix plugins "print" and "prnt" functions: now ok for writing on server + buffers +* fix color problem with new libcurses version +* fix crash when using alt-S or alt-X on DCC buffer (alt-D) +* fix startup crash when config file (~/.weechat/weechat.rc) is not found +* improve Perl/Python libs detection for ./configure script + +Version 0.1.2 (2005-05-21) +-------------------------- + +* add Python plugin support, improve Perl interface (and now Perl/Python + libraries are checked by configure script) +* add nicklist scroll keys (alt+{home/end/pgup/pgdn} or F11/F12) +* add transfer rate for DCC files +* add "-all" option for /nick command +* buffers timestamp can now be changed (new option in config file) +* WeeChat now ok under *BSD and Mac OS X +* fix nicklist sort +* fix crash when purging old DCC +* fix crash with 64-bits arch (like AMD64) when converting UTF-8 +* add missing IRC commands (307, 341, 485, 671) + +Version 0.1.1 (2005-03-20) +-------------------------- + +* add nicks count for channel buffers +* add FIFO pipe for remote control +* add crash dump when WeeChat receives SIGSEGV (Segmentation fault) +* add new display engine: doesn't cut words at end of lines +* add DCC send and DCC chat +* add /halfop & /dehalfop commands, fix halfop display bug in nicklist +* add /ban, /unban and /kickban commands +* add spanish translation +* add --irc-commands and --weechat-commands command line options +* connection to IRC server is now made by child process (non blocking) +* add support for UnrealIrcd ("~" for chan owner, "&" for chan admin) +* new key for window switch (now: F5/F6=switch buffer, F7/F8=switch window) +* on server buffer, only server messages are logged +* improve /help command output +* plugins messages are logged with new config option (log_plugin_msg) +* fix /kick command +* fix /invite command (and now invite requests are displayed) +* fix /buffer close command (now ok when disconnected from server) +* fix display bugs when many windows are opened + +Version 0.1.0 (2005-02-12) +-------------------------- + +* improve /window command: now split and merge are ok +* away nicks are now displayed with another color (new option: "irc_away_check") +* add away indicator in status bar +* add lag indicator (and auto-disconnect after a delay if important lag) +* improve completion: now completes commands arguments (IRC and internal), + when only one completion matches, completion mechanism is stoped (to + complete command arg for example) +* improve /set command: empty strings are allowed, new colors, server + options can be changed while WeeChat is running +* add default away/part/quit messages in config file +* new [irc] section in config file, move option "look_display_away" to + "irc_display_away" +* server messages & errors are all prefixed (by 3 chars, like "-@-") +* add new options for charset (UTF-8 support): look_charset_decode, + look_charset_encode and look_charset_internal +* fix many memory leaks +* fix colors bug: remove "gray" color (replaced by "default"), colors are + ok when terminal has white (or light) background +* fix crash when resizing terminal to small size +* fix crash when multiple servers and big messages received from server +* fix crash when closing some private buffers +* fix crash when unknown section with option(s) in config file +* fix /op, /deop, /voice, /devoice (now ok with many nicks) +* fix /me command (now ok without parameter) +* fix /away command (now ok if not away) +* logs are now disabled by default (server/channel/private) + +Version 0.0.9 (2005-01-01) +-------------------------- + +* auto-reconnection to server (new options: server_autoreconnect (on/off), + server_autoreconnect_delay (in seconds)) +* fix major bug when socket is closed by server (100% CPU usage), + and disconnections are now ok (all channels are "closed", history is still + visible, and buffer will be used again if reconnection to server) +* option "look_remove_colors_from_msgs" is now working +* fix display of nick mode changes +* new command "/buffer close" (close any server/channel/private buffer) +* fix /notice command (and display when received from server) +* new keys: ctrl+A (=home), ctrl+E (=end), ctrl+W (= ctrl+Backspace), + alt-S (switch to server buffer), alt-X (switch to first channel of next + server) +* add new config option: "server_command_delay" (delay in seconds after + startup command for each server) + +Version 0.0.8 (2004-10-30) +-------------------------- + +* fix /kick command: now ok with many words as reason +* nickserv passwords hidden (new config option: log_hide_nickserv_pwd on/off) +* auto-rejoin channels when kicked (new config option: server_autorejoin on/off) +* add IRC::command function for Perl scripts +* fix bug when adding alias with same name as other +* /buffer command developed (buffers list, move and notify) +* logging buffers to disk (server/channel/private according to user prefs) +* add config option "look_display_away" to announce away in channels +* fix crash when resizing terminal to very small size +* "-MORE-" message is now erased when switching to another buffer +* DCC file receive ok (alt-D for DCC view) +* /query command now reopens private buffer if already opened +* add key for redrawing terminal (ctrl-L) +* add key for clearing hotlist (alt-R) + +Version 0.0.7 (2004-08-08) +-------------------------- + +* new "col_status_delimiters" config option +* add command /buffer , buffers ordered by number, auto-jump to active + buffers (alt-A), jump to buffers by number (alt-number) +* add command /window, split terminal horizontally/vertically +* unique color for each nick (based on nickname) +* action messages are now considered as messages, not crappy joins/parts +* fix display bug when nicklist is displayed at bottom of screen +* add history limit (text buffer and commands) +* replace --enable-debug with --with-debug option for ./configure, which is + now integer: 1 = compiler debug flag, 2 = same 1 with verbose debug messages + in WeeChat (default: 0 = no debug) + +Version 0.0.6 (2004-06-05) +-------------------------- + +* improve channel highlight (priority to message vs join/part) +* fix bug when opened private win and remote user changes his nick +* add command /query (starts private conversation) +* add IRC messages 476, 477 +* /mode command is now ok and channel flags are displayed in status bar +* fix display bug (text was blinking when scrolling) +* CTCP Version reply is now in english only and doesn't show host (security reason) + +Version 0.0.5 (2004-02-07) +-------------------------- + +* /set command to modify config options when WeeChat is running +* fix look_nicklist config option, now enables/disables nicklist +* secure code to prevent buffer overflows and memory leaks +* fix QUIT IRC command: now sent to all connected servers (not only current) +* URL command line parameter to connect to server(s) +* new Perl script function to display message in info bar ("IRC::print_infobar") +* info bar highlight notifications +* add info bar timestamp in config ("look_infobar_timestamp") +* add info bar (optional, "look_infobar" to enable it, "on" by default) +* fix crash with /oper command +* for default config file, nick is now based on un*x username (thanks to Witukind) +* fix crash when config file cannot be written +* add -c (or --config) command line parameter to see config file options +* highlight action messages + +Version 0.0.4 (2004-01-01) +-------------------------- + +* Perl plugin, with auto-load +* when private window is created (another user is talking), WeeChat does not + switch to this window +* highlight when our nick is written in a channel/private window +* catch ctrl-C (ignored) +* debug messages can be enabled via ./configure --enbale-debug option + +Version 0.0.3 (2003-11-03) +-------------------------- + +* ./configure script to build WeeChat +* nicks are now correctly sorted (op, halfop, voice, other) +* fix problem with "353" IRC message (nicklist) +* fix problem when nick is truncated by server +* fix crash when entering text without any server connection +* fix crash when /set command is executed +* fix display bug (text was blinking when scrolling) +* french translation +* new IRC command: /stats, /service, /squit, /motd, /lusers, /links, /time, + /trace, /admin, /info, /servlist, /squery, /who, /whowas, /die, /summon, + /users, /wallops, /userhost, /ison, /ctcp ping +* code cleanup + +Version 0.0.2 (2003-10-05) +-------------------------- + +* add commands /rehash and /restart +* and command and auto-join channels when connected to server +* new commands for alias: /alias, /unalias (new section in config file) +* config is now saved automatically when quitting WeeChat, add /save command +* new commands for servers: /server, /connect, /disconnect +* add autoconnect flag for each server in config file +* add "look_set_title" option in config file +* term window title is modified with WeeChat name and version +* fix nicklist display bug +* fix crash when sending command which can only be received +* CTCP version returns more info (about OS) + +Version 0.0.1 (2003-09-27) +-------------------------- + +* ncurses GUI with color output +* multi-servers +* channel windows, with nicklist (position: top, bottom, left or right) +* private windows +* IRC commands: away, ctcp, deop, devoice, invite, join, kick, kill, list, + me, mode, msg, names, nick, notice, op, oper, part, ping, pong, quit, + quote, topic, version, voice, whois +* WeeChat commands: clear, help, set (partial) +* many config options +* log file (~/.weechat/weechat.log) +* nicklist can be moved on top, bottom, left or right of window diff --git a/FAQ b/FAQ deleted file mode 100644 index 268bdadd7..000000000 --- a/FAQ +++ /dev/null @@ -1,283 +0,0 @@ -WeeChat FAQ, 2009-05-11 -======================= - -1 - General -2 - Compilation / install -3 - Using WeeChat -4 - Development - - ------------------------------------------------------------------------------- -1.1: Why choosing WeeChat? X-Chat and Irssi are so good... - -Because WeeChat is very light and has new features. -Some features (version >= 0.3.x): - * multi-protocols support via plugins (IRC, Jabber) - * many deported GUI in addition to Curses (coming soon) - * available in many languages - * extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl) - * buffers with free content - * display filtering by tags and regular expressions - * horizontal and vertical window split - * customizable and extensible bars - * nicklist available in all GUI - * incremental text search in buffers, jump to highlights - * FIFO pipe for remote control - * aspell support - * double charset (encoding/decoding) - * developed from scratch (not based on any other client) - * multi-platform - * 100% GPL and free -More info on this page: http://weechat.flashtux.org/features.php - - ------------------------------------------------------------------------------- -2.1: I heard about many GUI for WeeChat. How can I compile/use them? - -Today only Curses GUI is available. Other GUI will be available as remote -client (currently udner development). - - ------------------------------------------------------------------------------- -2.2: I can't compile WeeChat after cloning git repository, why? - -Recommended way to compile WeeChat is with cmake. -If you're compiling with autotools (and not cmake), check that you have latest -version of autoconf and automake (WeeChat is developed with autoconf 2.61 and -automake 1.10.1). -Other way is to install "devel package", which needs less dependencies. This -package is built almost every day using git repository. Note that this package -may not correspond exactly to git base and that it's less convenient than git -cloning for installing updates. - - ------------------------------------------------------------------------------- -3.1: I've launched WeeChat, but I'm lost, what can I do? - -For help you can type /help. For help about a command, type /help command. -Keys and commands are listed in documentation. -It's recommended for new users to read quickstart guide (see doc page on -website). - - ------------------------------------------------------------------------------- -3.2: I heard about "buffers" and "windows", what's the difference? - -A window is used when you split screen vertically or horizontally. -A buffer is a "view" for a window. Each window displays a buffer, and many -windows may display same buffer. -Examples of buffers: server messages, channel, xfer control, .. - - ------------------------------------------------------------------------------- -3.3: I don't see some chars with accents, what can I do? - -For versions < 0.2.3, please upgrade to last stable version. -For versions >= 0.2.3: -- check that weechat-curses is linked to libncursesw (warning: needed on most - distributions but not all): - ldd /path/to/weechat-curses -- check that "Charset" plugin is loaded with /plugin command (if it is not, - then you probably need "weechat-plugins" package) -- check charset line (on server buffer), you should see ISO-XXXXXX or UTF-8 - for terminal charset. If you see ANSI_X3.4-1968 or other values, your locale - is probably wrong. -- setup global decode value, for example: - with WeeChat <= 0.2.6: - /setp charset.global.decode = ISO-8859-15 - with WeeChat >= 0.3.x: - /set charset.default.decode "ISO-8859-15" -- if you are using UTF-8 locale: - - check that your terminal is UTF-8 ready - (terminal recommended for UTF-8 is rxvt-unicode) - - if you are using screen, check that it is run with UTF-8 mode - ("defutf8 on" in ~/.screenrc or "screen -U") - - ------------------------------------------------------------------------------- -3.4: Bars like title and status are not filled, background color stops after -text, why? - -This may be caused by bad value of TERM variable (look at echo $TERM). -Depending on where you launch WeeChat, you should have: -- if WeeChat runs locally or on a remote machine without screen, it depends on - terminal used: "xterm", "rxvt", .. -- if WeeChat runs under screen, you should have "screen". -If needed, fix your TERM variable (export TERM="xxx"). - - ------------------------------------------------------------------------------- -3.5: When I'm using weechat under screen, I have weird chars, when I switch -window for example, how to fix that? - -This may be caused by bad value of TERM variable (look at echo $TERM). -For example, "xterm-color" displays such weird chars, use "xterm" which is ok -(like many other values). -If needed, fix your TERM variable (export TERM="xxx"). - - ------------------------------------------------------------------------------- -3.6: How can I customize key bindings? - -Key bindings are customizable with /key command. -Default key Meta-k (usually Alt-k) lets you grab key code and insert it in -command line. - - ------------------------------------------------------------------------------- -3.7: I'm using OpenBSD and WeeChat does not load any plugin, what's wrong? - -Under OpenBSD, plugin filename ends with ".so.0.0" (".so" for Linux). -You must setup that: -- with WeeChat <= 0.2.6: - /set plugins_extension = ".so.0.0" - /plugin autoload -- with WeeChat >= 0.3.x: - /set weechat.plugin.extension ".so.0.0" - /plugin autoload - - ------------------------------------------------------------------------------- -3.8: How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible -with other IRC clients? - -You can use commands /perl, /python, /ruby, /lua and /tcl to load scripts -(default path for scripts is ~/.weechat//). -Scripts are not compatible with other IRC clients. -Notes: -- scripts in ~/.weechat//autoload are automatically loaded when - WeeChat is starting up. -- plugin "tcl" is available with version >= 0.3.x. - - ------------------------------------------------------------------------------- -3.9: I want to change language used by WeeChat for messages, but without -exiting WeeChat, is it possible? - -Yes, you have to use python script shell.py (available on WeeChat website) and -issue these commands when script is loaded: - /shell setenv LANG=en_US.UTF-8 - /upgrade -To have english messages with UTF-8 encoding for terminal, for ISO users, you -can issue: - /shell setenv LANG=en_US - - ------------------------------------------------------------------------------- -3.10: With Curses GUI, how can I copy/paste text without pasting nicklist? - -You can use a terminal with rectangular selection (like rxvt-unicode, -konsole, ...). Key is usually ctrl + alt + mouse selection. -Other solution is to move nicklist to top or bottom, for example: -- with WeeChat <= 0.2.6: - /set look_nicklist_position = top -- with WeeChat >= 0.3.x: - /bar set nicklist position top - - ------------------------------------------------------------------------------- -3.11: How to be warned when someone highlights me on a channel? - -You can use sound.pl script (available on scripts page), and then setup a -system command (to play sound, display message, ..) with this command: -- with WeeChat <= 0.2.6: - /setp perl.sound.cmd_highlight = "/path/command arguments" -- with WeeChat >= 0.3.x: - /set plugins.var.perl.sound.cmd_highlight "/path/command arguments" - - ------------------------------------------------------------------------------- -3.12: How can I filter join/part/quit messages on IRC channels? - -According to WeeChat version: -- with WeeChat <= 0.2.6: - /ignore * join #weechat freenode - /ignore * part #weechat freenode - /ignore * quit #weechat freenode - (channel and/or server may be "*") - (/help ignore for help) -- with WeeChat >= 0.3.x: - - smart filter (keep join/part/quit from users who spoke recently): - /set irc.look.smart_filter on - /filter add irc_smart * irc_smart_filter * - (/help irc.look.smart_filter and /help filter for help) - - global filter (hide ALL join/part/quit): - /filter add jpk * irc_join,irc_part,irc_quit * - (/help filter for help) - - ------------------------------------------------------------------------------- -3.13: What is the difference between /ignore and /filter commands? - -The /ignore command is an IRC command, so it applies only for IRC buffers -(servers and channels). -It lets you ignore some nicks or hostname for a server or channel (command -will not apply on content of messages). -Matching messages are deleted by IRC plugin before display (so you'll -never see them). - -The /filter command is a core command, so it applies on any buffer. -It lets you filter some lines in buffers with tags or regular expression for -prefix and content of line. -Filtered lines are only hidden, not deleted, and you can see them if you -disable filters (by default, key alt + "=" toggle filters). - - ------------------------------------------------------------------------------- -4.1: How should I report bugs? - -There is 3 ways to report bugs: - 1. you can join us on IRC: irc.freenode.net, channel #weechat - 2. you can submit your bug at this URL: - http://savannah.nongnu.org/bugs/?func=addbug&group=weechat - 3. you can mail your problem, look at support page for developer's mails: - http://weechat.flashtux.org/support.php - (you can subscribe and send to "support" mailing list) - - ------------------------------------------------------------------------------- -4.2: How should I submit patches? - -There is 3 ways to submit patches: - 1. you can join us on IRC: irc.freenode.net, channel #weechat - 2. you can submit your patch at this URL: - http://savannah.nongnu.org/patch/?func=addpatch&group=weechat - 3. you can mail your patch, look at support page for developer's mails: - http://weechat.flashtux.org/support.php - (you can subscribe and send to mailing list called "support") - - ------------------------------------------------------------------------------- -4.3: How should I submit new feature request? - -There is 2 ways to submit your feature request: - 1. you can join us on IRC: irc.freenode.net, channel #weechat - 2. you can mail your feature request, look at support page for developer's - mails: - http://weechat.flashtux.org/support.php - (you can subscribe and send to mailing list called "support") - - ------------------------------------------------------------------------------- -4.4: What is the list of supported platforms for WeeChat? Will it be ported to -other operating systems? - -Full list is on this page: - http://weechat.flashtux.org/download.php?view=supported_os -We do our best to run on as many platforms as possible. Help is welcome for -some OS we don't have, to test WeeChat. - - ------------------------------------------------------------------------------- -4.5: I want to help WeeChat developers. What can I do? - -There's many tasks to do (testing, code, documentation, ...) -Please contact us with IRC or mail, look at support page: - http://weechat.flashtux.org/support.php - - ------------------------------------------------------------------------------- -4.6: Can I give money or other things to WeeChat developers? - -You can give us money to help development. -Details on http://weechat.flashtux.org/donate.php diff --git a/FAQ.fr b/FAQ.fr deleted file mode 100644 index bb448826a..000000000 --- a/FAQ.fr +++ /dev/null @@ -1,304 +0,0 @@ -WeeChat FAQ, 2009-05-11 -======================= - -1 - Général -2 - Compilation / installation -3 - Utilisation de WeeChat -4 - Développement - - ------------------------------------------------------------------------------- -1.1: Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien... - -Parce que WeeChat est très léger et a de nouvelles fonctionnalités. -Quelques fonctionnalités (version >= 0.3.x) : - * support multi-protocoles via extensions (IRC, Jabber) - * plusieurs interfaces déportées en plus de Curses (à venir bientôt) - * disponible en plusieurs langues - * extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl) - * tampons avec contenu libre - * filtrage de l'affichage avec tags et expressions régulières - * découpage de la fenêtre horizontalement et verticalement - * barres personnalisables et extensibles - * liste des pseudos disponible dans toutes les interfaces - * recherche incrémentale de texte dans les tampons, saut aux highlights - * tube FIFO pour contrôle à distance - * support aspell - * double encodage (décodage/encodage) - * développé à partir de zéro (non basé sur un quelconque client) - * multi-platformes - * 100% GPL et libre -Plus d'infos sur cette page : http://weechat.flashtux.org/features.php - - ------------------------------------------------------------------------------- -2.1: J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je -les compiler/utiliser ? - -Aujourd'hui seule l'interface Curses est disponible. -D'autres interfaces seront disponibles en mode distant (actuellement -en développement). - - ------------------------------------------------------------------------------- -2.2: Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ? - -La méthode recommandée pour compiler WeeChat est d'utiliser cmake. -Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien -la dernière version d'autoconf et automake (WeeChat est développé avec autoconf -2.61 et automake 1.10.1). -Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins -de dépendences. Ce paquet est construit quasiment tous les jours à partir de la -base git. Notez que ce paquet peut ne pas correspondre exactement à la base -git et qu'il est moins pratique que de cloner la base git pour installer des -mises à jour. - - ------------------------------------------------------------------------------- -3.1: J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ? - -Pour obtenir de l'aide tapez /help. Pour de l'aide sur une commande, tapez -/help commande. -Les touches et commandes sont listées dans la documentation. -Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage -rapide (voir la page de doc sur le site). - - ------------------------------------------------------------------------------- -3.2: J'ai entendu parler de "buffers" et "windows", quelle est la différence ? - -Une fenêtre ("window") est utilisée quand vous partagez l'écran verticalement -ou horizontalement. -Un tampon ("buffer") est une "vue" pour une fenêtre. Chaque fenêtre affiche un -tampon, et plusieurs fenêtres peuvent afficher le même tampon. -Exemples de tampons : messages serveur, canal, contrôle xfer, etc... - - ------------------------------------------------------------------------------- -3.3: Je ne vois pas bien certains accents dans WeeChat, que faire ? - -Pour les versions < 0.2.3, merci d'installer la dernière version stable. -Pour les versions >= 0.2.3 : -- vérifiez que weechat-curses est lié avec libncursesw (attention : nécessaire - sur beaucoup de distributions, mais pas toutes) : - ldd /chemin/vers/weechat-curses -- vérifiez que l'extension "Charset" est chargée avec la commande /plugin (s'il - ne l'est pas, vous devez peut-être installer le paquet "weechat-plugins") -- vérifiez la ligne charset (sur le tampon serveur), vous devriez voir - ISO-XXXXXX ou UTF-8 pour le charset du terminal. Si vous voyez ANSI_X3.4-1968 - ou d'autres valeurs, votre locale est probablement erronée. -- affectez la valeur pour le décodage global, par exemple : - avec WeeChat <= 0.2.6 : - /setp charset.global.decode = ISO-8859-15 - avec WeeChat >= 0.3.x : - /set charset.default.decode "ISO-8859-15" -- si vous utilisez la locale UTF-8 : - - vérifiez que votre terminal est compatible UTF-8 - (un terminal conseillé pour l'UTF-8 est rxvt-unicode) - - si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8 - ("defutf8 on" dans ~/.screnrc ou "screen -U") - - ------------------------------------------------------------------------------- -3.4: Des barres telles que le titre et le statut ne sont pas remplies, la -couleur de fond s'arrête après le texte, pourquoi ? - -Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez -echo $TERM). -Selon la façon de lancer WeeChat, vous devriez avoir : -- si WeeChat tourne en local ou sur une machine distante sans screen : - cela dépend du terminal utilisé : "xterm", "rxvt", etc... -- si WeeChat tourne sous screen, vous devriez avoir "screen". -Si besoin, corrigez la variable TERM (export TERM="xxx"). - - ------------------------------------------------------------------------------- -3.5: Quand j'utilise weechat sous screen, j'ai des caractères bizarres, -notamment en changeant de fenêtre, comment corriger ça ? - -Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez -echo $TERM). Par exemple "xterm-color" provoque ce genre de problèmes, utilisez -"xterm" qui est ok (comme plein d'autres valeurs). -Si besoin, corrigez la variable TERM (export TERM="xxx"). - - ------------------------------------------------------------------------------- -3.6: Comment puis-je configurer les raccourcis clavier ? - -Les raccourcis clavier sont modifiables avec la commande /key. -La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une -touche et de l'inclure dans la ligne de commande. - - ------------------------------------------------------------------------------- -3.7: J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ? - -Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous -Linux). -Vous devez configurer ça : -- avec WeeChat <= 0.2.6 : - /set plugins_extension = ".so.0.0" - /plugin autoload -- avec WeeChat >= 0.3.x : - /set weechat.plugin.extension ".so.0.0" - /plugin autoload - - ------------------------------------------------------------------------------- -3.8: Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts -sont-ils compatibles avec d'autres clients IRC ? - -Les commandes /perl, /python, /ruby, /lua et /tcl permettent de charger les -scripts Perl (le chemin par défaut est ~/.weechat//). -Les scripts ne sont pas compatibles avec d'autres clients IRC. -Notes : -- les scripts dans ~/.weechat//autoload sont automatiquement chargés - par WeeChat lorsqu'il démarre. -- l'extension "tcl" est disponible à partir de la version 0.3.x. - - ------------------------------------------------------------------------------- -3.9: Je souhaite changer la langue des messages affichés par WeeChat, mais sans -quitter WeeChat, est-ce possible ? - -Oui, il faut utiliser le script python shell.py (disponible sur le site de -WeeChat) et taper ces commandes une fois le script chargé : - /shell setenv LANG=fr_FR.UTF-8 - /upgrade -Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les -utilisateurs en ISO, vous pouvez taper : - /shell setenv LANG=fr_FR - - ------------------------------------------------------------------------------- -3.10: Avec l'interface Curses, comment puis-je copier/coller du texte sans -coller la liste des pseudos ? - -Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme -rxvt-unicode, konsole, etc...). La touche est habituellement ctrl + alt + -sélection à la souris. -Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par -exemple : -- avec WeeChat <= 0.2.6 : - /set look_nicklist_position = top -- avec WeeChat >= 0.3.x : - /bar set nicklist position top - - ------------------------------------------------------------------------------- -3.11: Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ? - -Vous pouvez utiliser le script sound.pl (disponible sur la page des scripts), -puis configurer une commande système (jouant un son, affichant un message à -l'écran, etc...) comme ceci : -- avec WeeChat <= 0.2.6 : - /setp perl.sound.cmd_highlight = "/chemin/commande parametres" -- avec WeeChat >= 0.3.x : - /set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres" - - ------------------------------------------------------------------------------- -3.12: Comment puis-je filter les messages join/part/quit sur les canaux IRC ? - -Selon la version de WeeChat : -- avec WeeChat <= 0.2.6 : - /ignore * join #weechat freenode - /ignore * part #weechat freenode - /ignore * quit #weechat freenode - (le canal et/ou le serveur peuvent être "*") - (/help ignore pour l'aide) -- avec WeeChat >= 0.3.x : - - filtre interlligent (pour garder les join/part/quit des utilisateurs qui - ont parlé récemment) : - /set irc.look.smart_filter on - /filter add irc_smart * irc_smart_filter * - (/help irc.look.smart_filter et /help filter pour l'aide) - - filtre global (pour cacher TOUS les join/part/quit) : - /filter add irc_jpk * irc_join,irc_part,irc_quit * - (/help filter pour l'aide) - - ------------------------------------------------------------------------------- -3.13: Quelle est la différence entre les commandes /ignore et /filter ? - -La commande /ignore est une commande IRC, donc elle s'applique uniquement aux -tampons IRC (serveurs et canaux). -Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal -(la commande ne s'applique pas au contenu des messages). -Les messages corespondants sont supprimés par l'extension IRC avant affichage -(donc vous ne les verrez jamais). - -La commande /filter est une commande "core", donc elle s'applique à n"importe -quel tampon. -Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou -d'expression régulière pour le préfixe et contenu de la ligne. -Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible -de les voir en désactivant les filtres (par défaut, la touche alt + "=" -active/désactive les filtres). - - ------------------------------------------------------------------------------- -4.1: Comment dois-je reporter les bugs ? - -Il y a 3 manières de reporter les bugs : - 1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat - 2. vous pouvez soumettre votre bug à cette adresse : - http://savannah.nongnu.org/bugs/?func=addbug&group=weechat - 3. vous pouvez envoyer votre problème par mail, consultez la page support - pour les mails des développeurs : - http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion nommée - "support") - - ------------------------------------------------------------------------------- -4.2: Comment dois-je soumettre les patches ? - -Il y a 3 manières de soumettre les patches : - 1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat - 2. vous pouvez soumettre votre patch à cette adresse : - http://savannah.nongnu.org/patch/?func=addpatch&group=weechat - 3. vous pouvez envoyer votre patch par mail, consultez la page support pour - les mails des développeurs : - http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion nommée - "support") - - ------------------------------------------------------------------------------- -4.3: Comment dois-je soumettre les demandes de nouvelles fonctionnalités ? - -Il y a 2 manières : - 1. vous pouvez nous joindre sur IRC : irc.freenode.net, canal #weechat - 2. vous pouvez envoyer un mail, consultez la page support pour les mails des - développeurs : - http://weechat.flashtux.org/support.php - (vous pouvez souscrire et envoyer à la liste de diffusion nommée - "support") - - ------------------------------------------------------------------------------- -4.4: Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il -porté sur d'autres systèmes d'exploitation ? - -La liste complète est sur cette page : - http://weechat.flashtux.org/download.php?view=supported_os -Nous faisons le maximum pour supporter le plus de plate-formes possible. -Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pous y -tester WeeChat. - - ------------------------------------------------------------------------------- -4.5: Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ? - -Il y a plusieurs choses à faire (test, code, documentation, etc...) -Merci de prendre contact avec nous par IRC ou mail, consultez la page -support : - http://weechat.flashtux.org/support.php - - ------------------------------------------------------------------------------- -4.6: Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? - -Vous pouvez donner de l'argent pour aider le développement. -Plus de détails sur http://weechat.flashtux.org/donate.php diff --git a/INSTALL b/INSTALL index ae950bd18..a10f747f4 100644 --- a/INSTALL +++ b/INSTALL @@ -1,25 +1,34 @@ -WeeChat - Installation instructions -=================================== +WeeChat Installation instructions +================================= You can build WeeChat with cmake (recommended way) or autotools. -- with cmake: - mkdir build - cd build - cmake .. -DPREFIX=/where/you/want/install -DCMAKE_BUILD_TYPE=Debug - make - make install (as root for installation in system directories) +With cmake +---------- -- with autotools: +------------------------------------------------------------------ +mkdir build +cd build +cmake .. -DPREFIX=/where/you/want/install -DCMAKE_BUILD_TYPE=Debug +make +make install (as root for installation in system directories) +------------------------------------------------------------------ - ./autogen.sh (for cloned git repository only, not devel package) - ./configure --prefix=/where/you/want/install - make - make install (as root for installation in system directories) + +With autotools +-------------- + +---------------------------------------------------------------------- +./autogen.sh (for cloned git repository only, not .tar.XX package) +./configure --prefix=/where/you/want/install +make +make install (as root for installation in system directories) +---------------------------------------------------------------------- If you want to report bugs/crashs to developers, please: + - compile with debug info (type "Debug" for cmake build, default for autotools), - enable core files (for bash shell, add "ulimit -c unlimited" to your ~/.bashrc). diff --git a/Makefile.am b/Makefile.am index 53eccfb64..c93d7ecc4 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,4 +1,4 @@ -# Copyright (c) 2003-2008 FlashCode +# Copyright (c) 2003-2009 FlashCode # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -23,9 +23,6 @@ SUBDIRS = po $(doc_dir) intl src EXTRA_DIST = CMakeLists.txt \ config.rpath \ config.h.cmake \ - BUGS \ - FAQ \ - FAQ.fr \ debian/NEWS \ debian/changelog \ debian/compat \ diff --git a/NEWS b/NEWS index 08cbe3efc..34a75b529 100644 --- a/NEWS +++ b/NEWS @@ -1,107 +1,93 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== - -* FlashCode, 2009-04-18 +WeeChat News +============ +FlashCode, 2009-04-18:: WeeChat 0.2.6.2 released. - + + This version fixes a bug with charset decoding (like iso2022jp). -* FlashCode, 2009-03-14 - +FlashCode, 2009-03-14:: WeeChat 0.2.6.1 released. - + + This version fixes a major bug: crash with some special chars in IRC messages. -* FlashCode, 2007-09-06 - +FlashCode, 2007-09-06:: WeeChat 0.2.6 released. -* FlashCode, 2007-06-07 - +FlashCode, 2007-06-07:: WeeChat 0.2.5 released. -* FlashCode, 2007-03-29 - +FlashCode, 2007-03-29:: WeeChat 0.2.4 released. -* FlashCode, 2007-01-10 - +FlashCode, 2007-01-10:: WeeChat 0.2.3 released. - + + This version fixes several major bugs of version 0.2.2. All users of version 0.2.2 should upgrade to this version. -* FlashCode, 2007-01-06 - +FlashCode, 2007-01-06:: WeeChat 0.2.2 released. - + + Important release notes: - - - new charset plugin: - - for users of any previous version, all your charset settings - in weechat.rc will be LOST! You should save your weechat.rc - to keep your values and set them again with new "charset" plugin. - - for ISO users: history of channels may be without accents - (after /upgrade), this is not recoverable, but this is not a bug. - All new messages should be ok. - - be careful, now default encode is UTF-8 for all channels (before - it was terminal charset). If you still want to send messages as - ISO-8859-1, you should send either global encode or server specific - encode to ISO-8859-1. - For global encode: /setp charset.global.encode = "ISO-8859-1" - For server encode: (on server buffer) /charset encode ISO-8859-1 - - new keys for topic scroll: - - new keys for scrolling topic: F9/F10 - - key F10 was used for "infobar_clear" in previous WeeChat versions, - you have to manually rebind this key (except for new WeeChat users): - /key scroll_topic_right - which gives something like this: - /key meta2-21~ scroll_topic_right - -* FlashCode, 2006-10-01 + * new charset plugin: + ** for users of any previous version, all your charset settings + in weechat.rc will be LOST! You should save your weechat.rc + to keep your values and set them again with new "charset" plugin. + ** for ISO users: history of channels may be without accents + (after /upgrade), this is not recoverable, but this is not a bug. + All new messages should be ok. + ** be careful, now default encode is UTF-8 for all channels (before + it was terminal charset). If you still want to send messages as + ISO-8859-1, you should send either global encode or server specific + encode to ISO-8859-1. + For global encode: /setp charset.global.encode = "ISO-8859-1" + For server encode: (on server buffer) /charset encode ISO-8859-1 + * new keys for topic scroll: + ** new keys for scrolling topic: F9/F10 + ** key F10 was used for "infobar_clear" in previous WeeChat versions, + you have to manually rebind this key (except for new WeeChat users): + /key scroll_topic_right + which gives something like this: + /key meta2-21~ scroll_topic_right +FlashCode, 2006-10-01:: WeeChat 0.2.1 released. -* FlashCode, 2006-08-19 - +FlashCode, 2006-08-19:: WeeChat 0.2.0 released. - + + Important release notes: - - - if you upgraded with /upgrade in WeeChat, you should /disconnect and + * if you upgraded with /upgrade in WeeChat, you should /disconnect and then /reconnect on each server, to display properly channel/user modes - - if you're using plugins, you should remove some old plugins libraries + * if you're using plugins, you should remove some old plugins libraries in WeeChat system library directory (commonly - /usr/local/lib/weechat/plugins): remove lib* files (like libperl.*, - libpython.*, ..) and keep only new libraries (perl.*, python.*, ..) - -* FlashCode, 2006-05-25 + /usr/local/lib/weechat/plugins): remove `lib*` files (like `libperl.*`, + `libpython.*`, ..) and keep only new libraries (`perl.*`, `python.*`, ..) +FlashCode, 2006-05-25:: WeeChat 0.1.9 released. - + + Important release notes: - - - please close all DCC chat buffers before using /upgrade command, + * please close all DCC chat buffers before using /upgrade command, otherwise you may experience problems with DCC chats. - - some changes in script API: now timer handlers functions takes exactly + * some changes in script API: now timer handlers functions takes exactly 0 (zero) argument (in version 0.1.8, two arguments were mandatory but not used: server and args) -* FlashCode, 2006-03-18 - +FlashCode, 2006-03-18:: WeeChat 0.1.8 released. - + + Important release notes: - - - it is recommended for users of version 0.1.7 (or any older), to + * it is recommended for users of version 0.1.7 (or any older), to replace values in setup file (~/.weechat/weechat.rc) : - - option: log_path: replace "~/.weechat/logs" by "%h/logs" - - option: plugins_path: replace "~/.weechat/plugins" by "%h/plugins" - "%h" is replaced by WeeChat home (default: ~/.weechat, may be overriden - by new command line arg --dir) - - after installing 0.1.8 (or with /upgrade), issue both commands (if you + ** option: log_path: replace "~/.weechat/logs" by "%h/logs" + ** option: plugins_path: replace "~/.weechat/plugins" by "%h/plugins" + + + "%h" is replaced by WeeChat home (default: ~/.weechat, may be overriden + by new command line arg --dir) + * after installing 0.1.8 (or with /upgrade), issue both commands (if you didn't redefined these keys (alt-home/end): /key unbind meta-meta2-1~ /key unbind meta-meta2-4~ @@ -109,94 +95,72 @@ WeeChat - Wee Enhanced Environment for Chat Alt-home/end were used for nicklist scroll, they're now replaced by Alt-F11/F12. -* FlashCode, 2006-01-14 - +FlashCode, 2006-01-14:: WeeChat 0.1.7 released. - + + Important release notes: - - - Ruby script plugin has been added but is experimental in this release. + * Ruby script plugin has been added but is experimental in this release. You're warned! - - - "/away" command was changed to be RFC 2812 compliant. + * "/away" command was changed to be RFC 2812 compliant. Now argument is required to set away, and no argument means remove away ("back"). Setting "irc_default_msg_away" has been removed. -* FlashCode, 2005-11-11 - +FlashCode, 2005-11-11:: WeeChat 0.1.6 released. - + + Important release notes: - - - incompatibility with some old scripts: now all handlers have to return + * incompatibility with some old scripts: now all handlers have to return a code for completion, and to do some actions about message to ignore (please look at documentation for detail) - - - on OpenBSD, the new option "plugins_extension" should be set to ".so.0.0" + * on OpenBSD, the new option "plugins_extension" should be set to ".so.0.0" since the plugins names are ending by ".so.0.0" and not ".so" - - - with new and full UTF-8 support, the option "look_charset_internal" + * with new and full UTF-8 support, the option "look_charset_internal" should be set to blank for most cases. Forces it only if your locale is not properly detected by WeeChat (you can set "UTF-8" or "ISO-8859-15" for example, depending on your locale). WeeChat is looking for "UTF-8" in your locale name at startup. -* FlashCode, 2005-09-24 - +FlashCode, 2005-09-24:: WeeChat 0.1.5 released. -* FlashCode, 2005-07-30 - +FlashCode, 2005-07-30:: WeeChat 0.1.4 released. -* FlashCode, 2005-07-02 - +FlashCode, 2005-07-02:: WeeChat 0.1.3 released. -* FlashCode, 2005-05-21 - +FlashCode, 2005-05-21:: WeeChat 0.1.2 released. -* FlashCode, 2005-03-20 - +FlashCode, 2005-03-20:: WeeChat 0.1.1 released. -* FlashCode, 2005-02-12 - +FlashCode, 2005-02-12:: WeeChat 0.1.0 released. -* FlashCode, 2005-01-01 - +FlashCode, 2005-01-01:: WeeChat 0.0.9 released. -* FlashCode, 2004-10-30 - +FlashCode, 2004-10-30:: WeeChat 0.0.8 released. -* FlashCode, 2004-08-08 - +FlashCode, 2004-08-08:: WeeChat 0.0.7 released. -* FlashCode, 2004-06-05 - +FlashCode, 2004-06-05:: WeeChat 0.0.6 released. -* FlashCode, 2004-02-07 - +FlashCode, 2004-02-07:: WeeChat 0.0.5 released. -* FlashCode, 2004-01-01 - +FlashCode, 2004-01-01:: WeeChat 0.0.4 released. -* FlashCode, 2003-11-03 - +FlashCode, 2003-11-03:: WeeChat 0.0.3 released. -* FlashCode, 2003-10-05 - +FlashCode, 2003-10-05:: WeeChat 0.0.2 released. -* FlashCode, 2003-09-27 - +FlashCode, 2003-09-27:: WeeChat 0.0.1 released. diff --git a/README b/README index 205376e3a..82e401823 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== +WeeChat Readme +============== WeeChat (Wee Enhanced Environment for Chat) is a fast and light chat @@ -9,21 +9,25 @@ It is customizable and extensible with scripts. Features -------- - * chat client with multi-protocols/servers connection - * many GUI (curses, Gtk, Qt) (1) - * small, fast and very light - * customizable and extensible with plugins (C, Perl, Python, Ruby, Lua) - * compliant with IRC RFCs 1459, 2810, 2811, 2812 and 2813 - * developed from scratch - * multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & other) (2) - * free software, released under GPLv3 + +* chat client with multi-protocols/servers connection +* many GUI (curses, Gtk, Qt) (1) +* small, fast and very light +* customizable and extensible with plugins (C, Perl, Python, Ruby, Lua) +* compliant with IRC RFCs 1459, 2810, 2811, 2812 and 2813 +* developed from scratch +* multi-platform (GNU/Linux, *BSD, Mac OS X, QNX, Windows & other) (2) +* free software, released under GPLv3 + +NOTE: (1) only Curses interface is available today + + + (2) Windows version is under construction Copyright --------- WeeChat (c) Copyright 2003-2009 by FlashCode -(see AUTHORS file if you want to contact authors) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -37,8 +41,3 @@ GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . - - ---- -(1) only Curses interface is available today -(2) Windows version is under construction diff --git a/TODO b/TODO deleted file mode 100644 index 994fdd3b8..000000000 --- a/TODO +++ /dev/null @@ -1,5 +0,0 @@ -WeeChat - Wee Enhanced Environment for Chat -=========================================== - -WeeChat TODO: -please look at https://savannah.nongnu.org/task/?group=weechat diff --git a/configure.in b/configure.in index 67346153a..dab00cd66 100644 --- a/configure.in +++ b/configure.in @@ -890,6 +890,25 @@ if test "x$enable_doc" = "xyes" ; then AC_SUBST(DOC_XSL_PREFIX) msg_doc="html $msg_doc" fi + + # check for asciidoc + DOC_ASCIIDOC8="" + AC_CHECK_PROGS(ASCIIDOC, [asciidoc]) + if test -n "$ASCIIDOC"; then + AC_MSG_CHECKING([for asciidoc version]) + asciidoc_version=`$ASCIIDOC --version 2>/dev/null` + case "${asciidoc_version}" in + asciidoc' '8*) + DOC_ASCIIDOC8="yes" + AC_MSG_RESULT([${asciidoc_version}]) + msg_doc="asciidoc $msg_doc" + ;; + *) + AC_MSG_RESULT([${asciidoc_version} (too old)]) + ;; + esac + fi + AC_SUBST(DOC_ASCIIDOC8) else not_asked="$not_asked doc" msg_doc="" @@ -1001,11 +1020,6 @@ AC_OUTPUT([Makefile doc/en/Makefile doc/fr/Makefile doc/de/Makefile - doc/ru/Makefile - doc/pl/Makefile - doc/cs/Makefile - doc/sco/Makefile - doc/sv/Makefile src/Makefile src/core/Makefile src/plugins/Makefile diff --git a/debian/weechat-core.docs b/debian/weechat-core.docs index ba6c8ac4b..6f83607c1 100644 --- a/debian/weechat-core.docs +++ b/debian/weechat-core.docs @@ -1,5 +1,3 @@ AUTHORS -BUGS NEWS README -TODO diff --git a/debian/weechat-doc.docs b/debian/weechat-doc.docs index 8e714f795..93e37d1cc 100644 --- a/debian/weechat-doc.docs +++ b/debian/weechat-doc.docs @@ -1,2 +1,6 @@ -FAQ -FAQ.fr +doc/en/weechat_faq.en.txt +doc/en/weechat_quickstart.en.txt +doc/en/weechat_tester.en.txt +doc/fr/weechat_faq.fr.txt +doc/fr/weechat_quickstart.fr.txt +doc/fr/weechat_tester.fr.txt diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 00aaece11..d1f9a679a 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -25,6 +25,12 @@ SET(DOC_LANGS sv ) +SET(DOC_ASCIIDOC_FILES + faq + quickstart + tester + ) + FIND_PROGRAM( COPY cp PATHS /bin /usr/bin /usr/local/bin /usr/pkg/bin @@ -47,6 +53,11 @@ FIND_FILE(DOC_XSL_PREFIX chunk.xsl PATHS DOC "Path to nwalsh xsl stylesheet" ) STRING(REPLACE "/html/chunk.xsl" "" DOC_XSL_PREFIX "${DOC_XSL_PREFIX}") + +FIND_PROGRAM( + ASCIIDOC asciidoc + PATHS /bin /usr/bin /usr/local/bin /usr/pkg/bin +) IF(XSLTPROC AND DOC_XSL_PREFIX AND COPY) SET(BUILD_HTML TRUE) @@ -56,6 +67,10 @@ IF(DBLATEX AND COPY) SET(BUILD_PDF TRUE) ENDIF(DBLATEX AND COPY) +IF(ASCIIDOC) + SET(BUILD_ASCIIDOC TRUE) +ENDIF(ASCIIDOC) + IF(BUILD_HTML) CONFIGURE_FILE( ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in @@ -71,7 +86,7 @@ IF(BUILD_HTML) ENDIF(BUILD_HTML) -IF(BUILD_HTML OR BUILD_PDF) +IF(BUILD_HTML OR BUILD_PDF OR BUILD_ASCIIDOC) EXECUTE_PROCESS( COMMAND date "+%F %T" OUTPUT_VARIABLE DOC_DATE @@ -116,14 +131,14 @@ IF(BUILD_HTML OR BUILD_PDF) ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-doc.css - COMMENT "Building user guide - html doc (${dlang})" + COMMENT "Building user's guide - html doc (${dlang})" ) ADD_CUSTOM_TARGET(doc-user-html-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/user/index.html) ADD_CUSTOM_TARGET(doc-user-html-one-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html-one/${dlang}/user/weechat_user.${dlang}.html) INSTALL(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/user DESTINATION share/doc/${PROJECT_NAME}/html/${dlang}/) ENDIF(BUILD_HTML) - + IF(BUILD_PDF) FILE(REMOVE_RECURSE ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user) FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user) @@ -145,7 +160,7 @@ IF(BUILD_HTML OR BUILD_PDF) ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/autogen/* ${CMAKE_CURRENT_SOURCE_DIR}/date.xml.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in - COMMENT "Building user guide - pdf doc (${dlang})" + COMMENT "Building user's guide - pdf doc (${dlang})" ) ADD_CUSTOM_TARGET(doc-user-pdf-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user/weechat_user.${dlang}.pdf) INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/user/weechat_user.${dlang}.pdf DESTINATION share/doc/${PROJECT_NAME}) @@ -184,7 +199,7 @@ IF(BUILD_HTML OR BUILD_PDF) ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html.xsl.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-doc.css - COMMENT "Building developer guide - html doc (${dlang})" + COMMENT "Building developer's guide - html doc (${dlang})" ) ADD_CUSTOM_TARGET(doc-dev-html-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html/${dlang}/dev/index.html) ADD_CUSTOM_TARGET(doc-dev-html-one-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/html-one/${dlang}/dev/weechat_dev.${dlang}.html) @@ -213,7 +228,7 @@ IF(BUILD_HTML OR BUILD_PDF) ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/autogen/* ${CMAKE_CURRENT_SOURCE_DIR}/date.xml.in ${CMAKE_CURRENT_SOURCE_DIR}/weechat-html-one.xsl.in - COMMENT "Building developer guide - pdf doc (${dlang})" + COMMENT "Building developer's guide - pdf doc (${dlang})" ) ADD_CUSTOM_TARGET(doc-dev-pdf-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/dev/weechat_dev.${dlang}.pdf) INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/pdf/${dlang}/dev/weechat_dev.${dlang}.pdf DESTINATION share/doc/${PROJECT_NAME}) @@ -221,10 +236,32 @@ IF(BUILD_HTML OR BUILD_PDF) ENDIF(BUILD_PDF) ENDIF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/dev/weechat_dev.${dlang}.xml) + +# IF(BUILD_ASCIIDOC) +# +# FILE(MAKE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}) +# +# FOREACH(doc ${DOC_ASCIIDOC_FILES}) +# +# IF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt) +# ADD_CUSTOM_COMMAND( +# OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html +# COMMAND ${ASCIIDOC} ARGS -a toc -n -o ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt +# DEPENDS +# ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt +# COMMENT "Building weechat_${doc}.${dlang}.html" +# ) +# ADD_CUSTOM_TARGET(doc-${doc}-${dlang} ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html) +# INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/asciidoc/${dlang}/weechat_${doc}.${dlang}.html DESTINATION share/doc/${PROJECT_NAME}) +# ENDIF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_${doc}.${dlang}.txt) +# +# ENDFOREACH(doc ${DOC_ASCIIDOC_FILES}) +# +# ENDIF(BUILD_ASCIIDOC) ENDFOREACH(dlang ${DOC_LANGS}) -ENDIF(BUILD_HTML OR BUILD_PDF) +ENDIF(BUILD_HTML OR BUILD_PDF OR BUILD_ASCIIDOC) FOREACH(dlang ${DOC_LANGS}) IF(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/${dlang}/weechat_quickstart.${dlang}.txt) diff --git a/doc/Makefile.am b/doc/Makefile.am index f3f165c84..9c2ad0ddf 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -14,7 +14,7 @@ # along with this program. If not, see . # -SUBDIRS = . en fr de ru pl cs sco sv +SUBDIRS = . en fr de man_MANS = weechat-curses.1 diff --git a/doc/cs/Makefile.am b/doc/cs/Makefile.am deleted file mode 100644 index d0038c6bd..000000000 --- a/doc/cs/Makefile.am +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2003-2009 FlashCode -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 3 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . -# - -LANGCODE = cs -QUICKSTART = weechat_quickstart.$(LANGCODE).txt - -EXTRA_DIST = $(QUICKSTART) - -docdir = $(datadir)/doc/$(PACKAGE) - -# install docs - -install-data-hook: - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ diff --git a/doc/cs/weechat_quickstart.cs.txt b/doc/cs/weechat_quickstart.cs.txt deleted file mode 100644 index 6a5081e40..000000000 --- a/doc/cs/weechat_quickstart.cs.txt +++ /dev/null @@ -1,104 +0,0 @@ -WeeChat (česká verze, WeeChat <= 0.2.6) -======================================= - -1. Spuštění weechat - Podle požadovaného GUI je třeba spustit: - - weechat-curses pro Curses GUI - - weechat-gtk pro GTK GUI (vyvíjí se) - - weechat-qt pro Qt GUI (není vyvíjeno) - - weechat-wxwidgets pro WxWidgets GUI (není vyvíjeno) - -2. Online nápověda / možnosti - - WeeChat má nápovědu pro všechny příkazy (/help příkaz) - Pro získání nápovědy k příkazu se používá /help příkaz - - Pro nastavení voleb použijte /set volba = hodnota - Lze použít /set volba s částečným jménem (zobrazí všechny možnosti - obsahující písmena), nebo pouze s celým jménem volby bez hodnoty - (pro zobrazení dlouhé nápovědy k volbě). - - Důležitá poznámka: nastavení je ukládáno při skončení WeeChat - (nebo pomocí příkazu /save). NEEDITUJTE kontiguracni soubor za - běhu WeeChat, protože do něj můŽe WeeChat kdykoliv zapsat - a není možné jej znovu načíst. Pro změnu jakýchkoliv voleb - použijte příkaz /set, WeeChat okamžitě použije nové nastavení. - -3. Vytvoření serveru - - Například irc.quakenet.org, port 6667: - /server add quakenet irc.quakenet.org 6667 - (pro kompletní nápovědu použijte /help server) - -4. Nastavení vlastních voleb serveru - - Přezdívky: - /set quakenet.server_nick1 = "mujeprezdivka" - /set quakenet.server_nick2 = "mujeprezdivka2" - /set quakenet.server_nick3 = "mujeprezdivka3" - - Uživatelské jméno / skutečné jméno: - /set quakenet.server_username = "moje uživatelské jméno" - /set quakenet.server_realname = "moje skutečné jméno" - - Automatické připojení k serveru: - /set quakenet.server_autoconnect = on - - Ostatní volby: - Pro zobrazení voleb serveru a jejich hodnot použijte /set quakenet - Pro nastavení volby použijte /set quakenet.volba_serveru = hodnota - -5. Připojení k serveru a automatické připojení ke kanálům - - /connect quakenet - -6. Příchod/odchod na/z kanálu - - Příchod na kanál: - /join #kanál - Odchod z kanálu: - /part [ukončovací zpráva] - Odchod z kanálu a zavření bufferu: - /close [ukončovací zpráva] - (/close je alias na /buffer close) - -7. Správa bufferů/oken - - Buffery lze spravovat pomocí příkazu "/buffer" a okna pomocí - příkazu "/window". - Například pro rozdělení okna vertikálně na malé okno (1/3 šíčky) - a velké (2/3) použijte příkaz: - /window splitv 33 - -8. Klávesové zkratky - - Podle Vaší klávesnice a/nebo potřeb si můžete změnit jakoukoliv - klávesu pomocí příkazu "/key". - Užitečná klávesa je meta-k (alt-k) pro nalezení klávesového kódu. - - Například pro napojení meta-y (alt-y) na příkaz "/buffer close"" - /key (stiskněte meta-k) (stiskněte meta-y) /buffer close - Dostanete řádek podobný tomuto: - /key meta-y /buffer close - -9. Pluginy/skripty - - Na některých distibucích jako Debian, jsou pluginy dostupné v samostatném - balíčku (jako weechat-plugins). - Pluginy jsou automatikcy načteny při nalezení. - Pro WeeChat je dostupných spousta pluginů/skriptů, více na: - http://weechat.flashtux.org/plugins.php - Pro načítání/rušení pluginů/skriptů se podívejde do dokumentace WeeChat. - -10. Další dokumentace - - Nyní můžete používat WeeChat a číst FAQ/dokumentaci v případě dalších dotazů: - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Uživejte si WeeChat! - --- -(c) 2006-05-31, napsal FlashCode , přeložil GolemJ -This document is part of WeeChat and is distributed under GPL licence. -Tento dokunet je součástí WeeChat a je distribuován pod licencí GPL. diff --git a/doc/de/Makefile.am b/doc/de/Makefile.am index 494e2e04f..3297e72a0 100644 --- a/doc/de/Makefile.am +++ b/doc/de/Makefile.am @@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \ dev/plugin_c_api.$(LANGCODE).xml \ dev/plugin_script_api.$(LANGCODE).xml -QUICKSTART = weechat_quickstart.$(LANGCODE).txt +#FAQ = weechat_faq.$(LANGCODE).txt +#QUICKSTART = weechat_quickstart.$(LANGCODE).txt +#TESTER = weechat_tester.$(LANGCODE).txt EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \ user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \ dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \ - $(QUICKSTART) + $(FAQ) $(QUICKSTART) $(TESTER) if DBLATEX_FOUND PDF = user-pdf-stamp dev-pdf-stamp @@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE) all-local: user-html-stamp dev-html-stamp $(PDF) -# user guide, HTML output with chunks (many pages) +# user's guide, HTML output with chunks (many pages) user-html: user-html-stamp @@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER cp ../weechat-doc.css html/user/ touch user-html-stamp -# user guide, HTML output, all in one page +# user's guide, HTML output, all in one page user-html1: user-html1-stamp @@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE cp ../weechat-doc.css html1/user/ touch user-html1-stamp -# user guide, PDF output +# user's guide, PDF output user-pdf: user-pdf-stamp @@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER) cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true touch user-pdf-stamp -# dev guide, HTML output with chunks (many pages) +# developer's guide, HTML output with chunks (many pages) dev-html: dev-html-stamp @@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x cp ../weechat-doc.css html/dev/ touch dev-html-stamp -# dev guide, HTML output, all in one page +# developer's guide, HTML output, all in one page dev-html1: dev-html1-stamp @@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV). cp ../weechat-doc.css html1/dev/ touch dev-html1-stamp -# dev guide, PDF output +# developer's guide, PDF output dev-pdf: dev-pdf-stamp @@ -198,7 +200,9 @@ install-data-hook: $(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ $(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ +# $(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/ +# $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ +# $(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/ if DBLATEX_FOUND $(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/ $(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/ diff --git a/doc/de/authors.de.xml b/doc/de/authors.de.xml index ebd4f124c..1c259c02b 100644 --- a/doc/de/authors.de.xml +++ b/doc/de/authors.de.xml @@ -46,14 +46,7 @@ along with this program. If not, see . kolter (Emmanuel Bouthenot) kolter AT openics.org - - Entwickler - - - - - Ptitlouis - ptitlouis AT sysif.net - - erzeugt Debian-Pakete + Entwickler, erzeugt Debian-Pakete @@ -67,6 +60,12 @@ along with this program. If not, see . Die folgenden Personen trugen zur Entwicklung von WeeChat bei: + + + Ptitlouis - + Erzeugt Debian-Pakete + + Jiri Golembiovsky - diff --git a/doc/de/weechat_quickstart.de.txt b/doc/de/weechat_quickstart.de.txt deleted file mode 100644 index ad9b15704..000000000 --- a/doc/de/weechat_quickstart.de.txt +++ /dev/null @@ -1,109 +0,0 @@ -WeeChat Schnellstarter (deutsche Version, für WeeChat <= 0.2.6) -=============================================================== - -1. Weechat starten - - Entsprechend dem gewählten User-Interface müssen Du starten: - - weechat-curses für das Curses GUI - - weechat-gtk für das Gtk GUI (in Entwicklung) - - weechat-qt für das Qt GUI (in Planung) - - weechat-wxwidgets für das WxWidgets GUI (in Planung) - -2. Online-Hilfe / Optionen - - WeeChat hat eine eingebaute Hilfe für all Kommandos, tippe einfach /help - Um Hilfe zu einem Kommando zu bekommen, tippe /help Kommando - - Um Optionen zu verändern, benutzt du /set Option = Wert - Du brauchst /set Option nur mit den Anfangsbuchstaben eingeben - ( zeigt alle Optionen mit den gleichen Buchstaben) oder mit dem vollen - Namen ohne einen Wert, um eine ausführliche Hilfe zu bekommen. - - Wichtig: die Einstellungen werden gespeichert, wenn WeeChat beendet wird - (oder mit dem Befehl /save). Verändere die Einstellungen nicht, wenn WeeChat - läuft, weil WeeChat diese Datei zu jeder Zeit überschreiben kann und - Änderungen verloren sind. Um irgendeine Einstellung zu verändern, verwendest du - das /set Kommando, WeeChat wird die neuen Einstellungen umgehend übernehmen. - -3. Einen Server-Eintrag anlegen - - Zum Beispiel für irc.quakenet.org, Port 6667: - /server add quakenet irc.quakenet.org 6667 - (/help Server für volle Hilfe zu diesem Kommando) - -4. Eigene Server-Optionen setzen - - Nickname: - /set quakenet.server_nick1 = "mynick" - /set quakenet.server_nick2 = "mynick2" - /set quakenet.server_nick3 = "mynick3" - - Username/Klarname: - /set quakenet.server_username = "My username" - /set quakenet.server_realname = "My real name" - - Automatische Server-Verbindung: - /set quakenet.server_autoconnect = on - - Automatisches Betreten eines Channels: - /set quakenet.server_autojoin = "#chan1,#chan2" - - Andere Optionen: - Du kannst die Server-Optionen und ihre Werte mit /set quakenet sehen - Um eine Option zu setzen, tippe /set quakenet.option = Wert - -5. Verbinden zu einem Server und automatisch einen Channel betreten - - /connect quakenet - -6. Channels betreten/verlassen - - Einen Channel betreten: - /join #channel - Einen Channel verlassen: - /part [Nachricht] - Einen Channel verlassen und den Buffer schliessen: - /close [Nachricht] - (/close ist ein Alias für /buffer close) - -7. Buffer/Fenster Management - - Du kannst die einzelnen Buffer mit /buffer und Fenster mit /window - verwalten. - Um zum Beispiel das Fenster in ein kleineres (1/3 breit) und ein - grosses (2/3 breit) zu teilen, nutzt du das folgende Kommando: - /window splitv 33 - -8. Tastenkombinationen - - Entsprechend deiner Tastatur und/oder deinen Wünschen, kannst du jede Taste - mit "/key" neu zuordnen. - Eine nützliche Taste ist meta-k (alt-k), sie zeigt die Tastaturcodes an. - - Um zum Beispiel meta-y (alt-y) dem Kommando "/buffer close" zuzuordnen: - /key (tippe meta-k) (tippe meta-y) /buffer close - Und du bekommst damit die Kommandozeile: - /key meta-y /buffer close - -9. Plugins/Skripte - - In einigen Distributionen, wie zum Beispiel Debian, sind Plugins in separaten - Paketen verfügbar (wie weechat-plugins). Plugins werden automatisch geladen, - wenn welche gefunden wurden. - Viele Plugins/Skripte für WeeChat sind zu finden auf: - http://weechat.flashtux.org/plugins.php - Bitte lies für das Laden/Entladen von Plugins oder Skripten die Dokumentation. - - -10. Mehr Dokumentation - - Jetzt kannst du WeeChat starten und die FAQ/Dokumentation lesen, falls du weitere - Fragen hast: - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Viel Spass mit WeeChat! - --- -(c) 2006-05-31, written by FlashCode -This document is part of WeeChat and is distributed under GPL licence. diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am index faf6223ed..e732941e7 100644 --- a/doc/en/Makefile.am +++ b/doc/en/Makefile.am @@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \ dev/plugin_c_api.$(LANGCODE).xml \ dev/plugin_script_api.$(LANGCODE).xml +FAQ = weechat_faq.$(LANGCODE).txt QUICKSTART = weechat_quickstart.$(LANGCODE).txt +TESTER = weechat_tester.$(LANGCODE).txt EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \ user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \ dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \ - $(QUICKSTART) + $(FAQ) $(QUICKSTART) $(TESTER) if DBLATEX_FOUND PDF = user-pdf-stamp dev-pdf-stamp @@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE) all-local: user-html-stamp dev-html-stamp $(PDF) -# user guide, HTML output with chunks (many pages) +# user's guide, HTML output with chunks (many pages) user-html: user-html-stamp @@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER cp ../weechat-doc.css html/user/ touch user-html-stamp -# user guide, HTML output, all in one page +# user's guide, HTML output, all in one page user-html1: user-html1-stamp @@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE cp ../weechat-doc.css html1/user/ touch user-html1-stamp -# user guide, PDF output +# user's guide, PDF output user-pdf: user-pdf-stamp @@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER) cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true touch user-pdf-stamp -# dev guide, HTML output with chunks (many pages) +# developer's guide, HTML output with chunks (many pages) dev-html: dev-html-stamp @@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x cp ../weechat-doc.css html/dev/ touch dev-html-stamp -# dev guide, HTML output, all in one page +# developer's guide, HTML output, all in one page dev-html1: dev-html1-stamp @@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV). cp ../weechat-doc.css html1/dev/ touch dev-html1-stamp -# dev guide, PDF output +# developer's guide, PDF output dev-pdf: dev-pdf-stamp @@ -198,7 +200,9 @@ install-data-hook: $(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ $(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ + $(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/ $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ + $(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/ if DBLATEX_FOUND $(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/ $(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/ diff --git a/doc/en/authors.en.xml b/doc/en/authors.en.xml index 057f5c653..7d57ba868 100644 --- a/doc/en/authors.en.xml +++ b/doc/en/authors.en.xml @@ -46,14 +46,7 @@ along with this program. If not, see . kolter (Emmanuel Bouthenot) kolter AT openics.org - - developer - - - - - Ptitlouis - ptitlouis AT sysif.net - - Debian packager + developer, Debian packager @@ -67,6 +60,12 @@ along with this program. If not, see . Following people contributed to WeeChat: + + + Ptitlouis - + first debian packager + + Jiri Golembiovsky - diff --git a/doc/en/weechat_faq.en.txt b/doc/en/weechat_faq.en.txt new file mode 100644 index 000000000..1b9c9b3b3 --- /dev/null +++ b/doc/en/weechat_faq.en.txt @@ -0,0 +1,322 @@ +WeeChat Frequently Asked Questions (FAQ) +======================================== +FlashCode +v0.3.0-dev, 2009-05-15 + + +General +------- + + +[[why_choose_weechat]] +Why choose WeeChat? X-Chat and Irssi are so good... +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Because WeeChat is very light and has new features. +Some features (version > = 0.3.x): + +* multi-protocols support via plugins (IRC, Jabber) +* many remote GUI in addition to Curses (coming soon) +* available in many languages +* extensible with plugins (C, Perl, Python, Ruby, Lua, Tcl) +* buffers with free content +* display filtering by tags and regular expressions +* horizontal and vertical window split +* customizable and extensible bars +* nicklist available in all GUI +* incremental text search in buffers, jump to highlights +* FIFO pipe for remote control +* aspell support +* double charset (encoding/decoding) +* developed from scratch (not based on any other client) +* multi-platform +* 100% GPL and free + +More info on this page: +http://weechat.flashtux.org/features.php + + +Compilation / install +--------------------- + + +[[gui]] +I heard about many GUI for WeeChat. How can I compile/use them? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Today only Curses GUI is available. + +Other GUI will be available as remote client (currently under development). + + +[[compile_git]] +I can't compile WeeChat after cloning git repository, why? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Recommended way to compile WeeChat is with cmake. + +If you're compiling with autotools (and not cmake), check that you have latest +version of autoconf and automake (WeeChat is developed with autoconf 2.61 and +automake 1.10.1). + +Other way is to install "devel package", which needs less dependencies. This +package is built almost every day using git repository. Note that this package +may not correspond exactly to git base and that it's less convenient than git +cloning for installing updates. + + +Using WeeChat +------------- + + +[[lost]] +I've launched WeeChat, but I'm lost, what can I do? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For help you can type `/help`. For help about a command, type `/help command`. +Keys and commands are listed in documentation. + +It's recommended for new users to read quickstart guide (see doc page on +website). + + +[[buffer_vs_window]] +I heard about "buffer" and "window", what's the difference? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A 'buffer' is composed by a number, a name, lines displayed (and some other +data). + +A 'window' is a screen area which displays a buffer. It is possible to split +screen into many windows. + +Each window displays one buffer. A buffer can be hidden (not displayed by a +window) or displayed by one or more windows. + + +[[charset]] +I don't see some chars with accents, what can I do? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For versions < 0.2.3, please upgrade to last stable version. + +For versions > = 0.2.3: + +* check that weechat-curses is linked to libncursesw (warning: needed on most + distributions but not all): `ldd /path/to/weechat-curses` +* check that "Charset" plugin is loaded with `/plugin` command (if it is not, + then you probably need "weechat-plugins" package) +* check charset line (on server buffer), you should see 'ISO-XXXXXX' or 'UTF-8' + for terminal charset. If you see 'ANSI_X3.4-1968' or other values, your + locale is probably wrong. +* setup global decode value, for example: +** with WeeChat < = 0.2.6: `/setp charset.global.decode = ISO-8859-15` +** with WeeChat > = 0.3.x: `/set charset.default.decode "ISO-8859-15"` +* if you are using UTF-8 locale: +** check that your terminal is UTF-8 ready (terminal recommended for UTF-8 is + rxvt-unicode) +** if you are using screen, check that it is run with UTF-8 mode + ("`defutf8 on`" in ~/.screenrc or `screen -U` to run screen) + + +[[bars_background]] +Bars like title and status are not filled, background color stops after text, why? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This may be caused by bad value of TERM variable (look at output of +`echo $TERM` in your terminal). + +Depending on where you launch WeeChat, you should have: + +* if WeeChat runs locally or on a remote machine without screen, it depends on + terminal used: 'xterm', 'rxvt', .. +* if WeeChat runs under screen, you should have 'screen'. + +If needed, fix your TERM variable: `export TERM="xxx"`. + + +[[screen_weird_chars]] +When I'm using weechat under screen, I have weird random chars, how to fix that? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This may be caused by bad value of TERM variable (look at output of +`echo $TERM` in your terminal). + +For example, 'xterm-color' displays such weird chars, use 'xterm' which is ok +(like many other values). + +If needed, fix your TERM variable: `export TERM="xxx"`. + + +[[key_bindings]] +How can I customize key bindings? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Key bindings are customizable with /key command. + +Default key Meta-k (usually Alt-k) lets you grab key code and insert it in +command line. + + +[[openbsd_plugins]] +I'm using OpenBSD and WeeChat does not load any plugin, what's wrong? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Under OpenBSD, plugin filename ends with ".so.0.0" (".so" for Linux). + +You must setup that: + +* with WeeChat < = 0.2.6: `/set plugins_extension = ".so.0.0"` +* with WeeChat > = 0.3.x: `/set weechat.plugin.extension ".so.0.0"` + +Then: `/plugin autoload`. + + +[[scripts]] +How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible with other IRC clients? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can use commands `/perl`, `/python`, `/ruby`, `/lua` and `/tcl` to load +scripts (default path for scripts is '~/.weechat//'). + +Scripts are not compatible with other IRC clients. + +Notes: + +* scripts in '~/.weechat//autoload/' are automatically loaded when + WeeChat is starting up. +* plugin 'tcl' is available with version > = 0.3.x. + + +[[change_locale_without_quit]] +I want to change language used by WeeChat for messages, but without exiting WeeChat, is it possible? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Yes, you have to use python script shell.py (available on WeeChat website) and +issue these commands when script is loaded: + + /shell setenv LANG=en_US.UTF-8 + /upgrade + +To have english messages with UTF-8 encoding for terminal, for ISO users, you +can issue: `/shell setenv LANG=en_US`. + + +[[terminal_copy_paste]] +With Curses GUI, how can I copy/paste text without pasting nicklist? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can use a terminal with rectangular selection (like rxvt-unicode, +konsole, ...). Key is usually ctrl + alt + mouse selection. + +Other solution is to move nicklist to top or bottom, for example: + +* with WeeChat < = 0.2.6: `set look_nicklist_position = top` +* with WeeChat > = 0.3.x: `/bar set nicklist position top` + + +[[highlight_notification]] +How to be warned when someone highlights me on a channel? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can use script 'sound.pl' (available on scripts page), and then setup a +system command (to play sound, display message, ..) with this command: + +* with WeeChat < = 0.2.6: + `/setp perl.sound.cmd_highlight = "/path/command arguments"` +* with WeeChat > = 0.3.x: + `/set plugins.var.perl.sound.cmd_highlight "/path/command arguments"` + +Many other scripts exist for notification, please look at plugins/scripts page: +http://weechat.flashtux.org/plugins.php + + +[[filter_irc_join_part_quit]] +How can I filter join/part/quit messages on IRC channels? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +According to WeeChat version: + +* with WeeChat < = 0.2.6: + + `/ignore * join #weechat freenode` + + `/ignore * part #weechat freenode` + + `/ignore * quit #weechat freenode` + + (channel and/or server may be "*", `/help ignore` for help) + +* with WeeChat > = 0.3.x: + +** smart filter (keep join/part/quit from users who spoke recently): + + `/set irc.look.smart_filter on` + + `/filter add irc_smart * irc_smart_filter *` + + (`/help irc.look.smart_filter` and `/help filter` for help) + +** global filter (hide *all* join/part/quit): + + `/filter add jpk * irc_join,irc_part,irc_quit *` + + (`/help filter` for help) + + +[[ignore_vs_filter]] +What is the difference between /ignore and /filter commands? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The `/ignore` command is an IRC command, so it applies only for IRC buffers +(servers and channels). +It lets you ignore some nicks or hostname for a server or channel (command +will not apply on content of messages). +Matching messages are deleted by IRC plugin before display (so you'll +never see them). + +The `/filter` command is a core command, so it applies on any buffer. +It lets you filter some lines in buffers with tags or regular expression for +prefix and content of line. +Filtered lines are only hidden, not deleted, and you can see them if you +disable filters (by default, key alt + "=" toggles filters). + + +Development +----------- + + +[[bug_task_patch]] +How should I report bug, ask new feature or send a patch? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There are 3 ways: + +. you can join us on IRC: 'irc.freenode.net', channel '#weechat' +. you can use 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 +. you can mail developers, look at support page for developer's mails: + http://weechat.flashtux.org/support.php + (you can subscribe and send to "support" mailing list) + + +[[supported_os]] +What is the list of supported platforms for WeeChat? Will it be ported to other operating systems? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Full list is on this page: +http://weechat.flashtux.org/download.php?view=supported_os + +We do our best to run on as many platforms as possible. Help is welcome for +some OS we don't have, to test WeeChat. + + +[[help_developers]] +I want to help WeeChat developers. What can I do? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +There's many tasks to do (testing, code, documentation, ...) + +Please contact us with IRC or mail, look at support page: +http://weechat.flashtux.org/support.php + + +[[donate]] +Can I give money or other things to WeeChat developers? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can give us money to help development. +Details on http://weechat.flashtux.org/donate.php diff --git a/doc/en/weechat_quickstart.en.txt b/doc/en/weechat_quickstart.en.txt index 5dd89dd2c..6cedf1467 100644 --- a/doc/en/weechat_quickstart.en.txt +++ b/doc/en/weechat_quickstart.en.txt @@ -1,210 +1,233 @@ -WeeChat quick start guide (english version, for WeeChat >= 0.3.x) -================================================================= +WeeChat quick start guide +========================= +FlashCode +v0.3.0-dev, 2009-05-15 -1. Launch weechat - A recommended terminal emulator for X (but not mandatory) is rxvt-unicode - (it has good UTF-8 support, and no problem with default keyboard bindings). +[[start]] +Start weechat +------------- - Run "weechat-curses" from your shell. +A recommended terminal emulator for X (but not mandatory) is rxvt-unicode +(it has good UTF-8 support, and no problem with default keyboard bindings). -2. Online help / options +Run "weechat-curses" from your shell. - WeeChat has help for all commands, just issue /help - To get help on a command, issue /help command - To set options, use /set config.section.option value - (where config is configuration name ("weechat" for core, or a plugin - name), "section" the section of this configuration and "option" the - option name). +[[help_options]] +Online help / options +--------------------- - WeeChat immediately uses new value (you *never* need to restart WeeChat - after changes to configuration). +WeeChat has help for all commands, just issue /help +To get help on a command, issue `/help command` - You can use /set option with partial name and wildcard "*" at beginning or - end to display all options containg letters. - For example: +To set options, use `/set config.section.option value` +(where `config` is configuration name (`weechat` for core, or a plugin +name), `section` the section of this configuration and `option` the +option name). - /set => display all options (WeeChat and plugins) - /set weechat.* => display WeeChat options - /set irc.* => display IRC plugin options +WeeChat immediately uses new value (you *never* need to restart WeeChat +after changes to configuration). - You can display help for an option with /help, for example: +You can use `/set` option with partial name and wildcard "*" at beginning or +end to display all options containg letters. +For example: - /help weechat.look.highlight +`/set`:: + display all options (WeeChat and plugins) - All settings are saved when WeeChat ends (or with "/save" command to force - write of options). +`/set weechat.*`:: + display WeeChat options - You can edit configuration files (*.conf) by hand and reload them by - /reload command if you don't want to use /set command. +`/set irc.*`:: + display IRC plugin options -3. Core vs plugins +You can display help for an option with `/help`, for example: +`/help weechat.look.highlight`. - WeeChat "core" is only used to display data on screen and interact with - user, that means weechat core without plugins is useless - (faithful users: IRC was part of core for versions <= 0.2.6). +All settings are saved when WeeChat ends (or with `/save` command to force +write of options). - All network protocols like IRC are provided in separate plugins. +You can edit configuration files (*.conf) by hand and reload them by +`/reload` command if you don't want to use `/set` command. - Use /plugin command to list loaded plugins, you should see "irc" and - other plugins in list. -4. Create an IRC server +[[core_vs_plugins]] +Core vs plugins +--------------- - You can add an IRC server with /server command, for example: +WeeChat "core" is only used to display data on screen and interact with +user, that means weechat core without plugins is useless +(faithful users: IRC was part of core for versions < = 0.2.6). - /server add oftc irc.oftc.org 6667 +All network protocols like IRC are provided in separate plugins. - As usual, help is available if you're lost: +Use `/plugin` command to list loaded plugins, you should see "irc" and +other plugins in list. - /help server -5. Set custom IRC server options +[[create_irc_server]] +Create an IRC server +-------------------- - WeeChat uses default values for all servers ("fallbacks"), if you - don't specify a specific value for a server option. - These default options are "irc.server_default.*". +You can add an IRC server with `/server` command, for example: - For each server option, WeeChat uses its value if it is defined (not - "null"). Otherwise WeeChat uses default value (irc.server_default.xxx). + /server add oftc irc.oftc.org 6667 - For example there's default nicks (based on your un*x login), and you can - override them for oftc server with following command: +As usual, help is available if you're lost: `/help server` - /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5" - To set username and realname: +[[irc_server_options]] +Set custom IRC server options +----------------------------- - /set irc.server.oftc.username "My user name" - /set irc.server.oftc.realname "My real name" +WeeChat uses default values for all servers ("fallbacks"), if you +don't specify a specific value for a server option. +These default options are "irc.server_default.*". - To enable auto-connect to server at startup: +For each server option, WeeChat uses its value if it is defined (not +"null"). Otherwise WeeChat uses default value ("irc.server_default.xxx"). - /set irc.server.oftc.autoconnect on +For example there's default nicks (based on your un*x login), and you can +override them for oftc server with following command: - To run a command after connection to server, for example to identify - with nickserv: + /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5" - /set irc.server.oftc.command "/msg nickserv identify xxxxxx" +To set username and realname: - Note: many commmands can be separated by ';' (semi-colon) + /set irc.server.oftc.username "My user name" + /set irc.server.oftc.realname "My real name" - To auto-join some channels when connecting to server: +To enable auto-connect to server at startup: - /set irc.server.oftc.autojoin "#channel1,#channel2" + /set irc.server.oftc.autoconnect on - To remove value of a server option, and use default value instead, - for example to use default nicks (irc.server_default.nicks): +To run a command after connection to server, for example to identify +with nickserv: - /set irc.server.oftc.nicks null + /set irc.server.oftc.command "/msg nickserv identify xxxxxx" - Other options: - You can setup other options with following command ("xxx" is option - name): +Note: many commmands can be separated by ';' (semi-colon) - /set irc.server.oftc.xxx value +To auto-join some channels when connecting to server: -6. Connect to IRC server and auto-join channels + /set irc.server.oftc.autojoin "#channel1,#channel2" - /connect oftc +To remove value of a server option, and use default value instead, +for example to use default nicks (irc.server_default.nicks): - Note: this command can be used to create and connect to a new server - without using /server command (should I repeat you can see help for - this command with /help connect ? ;) + /set irc.server.oftc.nicks null -7. Join/part IRC channels +Other options: you can setup other options with following command ("xxx" is +option name): - Join a channel: + /set irc.server.oftc.xxx value - /join #channel - Part a channel: +[[connect_to_irc_server]] +Connect to IRC server and auto-join channels +-------------------------------------------- - /part [quit message] + /connect oftc - Close server or channel buffer: +Note: this command can be used to create and connect to a new server +without using `/server` command (should I repeat you can see help for +this command with `/help connect` ? ;) - /close [quit message] - (/close is an alias on /buffer close) +[[join_part_irc_channels]] +Join/part IRC channels +---------------------- -8. Buffer/window management +`/join #channel`:: + join a channel - A buffer is a component linked to a plugin with a number with a category - and a name. Buffer contains data displayed on screen. +`/part [quit message]`:: + part a channel (keeping buffer open) - A window is a view on a buffer. By default there's only one window - displaying one buffer. If you split screen, you will see many windows - with many buffers at same time. +`/close [quit message]`:: + close server or channel buffer (`/close` is an alias on `/buffer close`) - Commands to manage buffers and windows: - /buffer - /window +[[buffer_window]] +Buffer/window management +------------------------ - (I'll not repeat here that you can get help with /help on these commands) +A buffer is a component linked to a plugin with a number with a category +and a name. Buffer contains data displayed on screen. - For example, to split verticaly screen into a small window (1/3 width), - and a large (2/3), use command: +A window is a view on a buffer. By default there's only one window +displaying one buffer. If you split screen, you will see many windows +with many buffers at same time. - /window splitv 33 +Commands to manage buffers and windows: -9. Key bindings + /buffer + /window - WeeChat uses many keys by default. All these keys are in documentation, - but you should know at least some vital keys: - - alt + left/right arrows (or F5/F6): switch to previous/next buffer - - F7/F8: switch to previous/next window (when screen is split) - - F9/F10: scroll title bar - - F11/F12: scroll nicklist - - tab: complete text in input bar, like in your shell - - page up/down: scroll text in current buffer - - alt + A: jump to buffer with activity (in hotlist) +(I'll not repeat here that you can get help with /help on these commands) - According to your keyboard and/or your needs, you can rebind any key - to a command with "/key" command. - A useful key is meta-k (alt-k) to find key codes. +For example, to split verticaly screen into a small window (1/3 width), +and a large (2/3), use command: - For example, to bind meta-y (alt-y) to command "/buffer close": + /window splitv 33 - /key (press meta-k) (press meta-y) /buffer close - You'll have a command line like: +[[key_bindings]] +Key bindings +------------ - /key meta-y /buffer close +WeeChat uses many keys by default. All these keys are in documentation, +but you should know at least some vital keys: - To remove key: +- 'alt + left/right arrows' (or 'F5'/'F6'): switch to previous/next buffer +- 'F7'/'F8': switch to previous/next window (when screen is split) +- 'F9'/'F10': scroll title bar +- 'F11'/'F12': scroll nicklist +- 'tab': complete text in input bar, like in your shell +- 'page up/down': scroll text in current buffer +- 'alt + A': jump to buffer with activity (in hotlist) - /key unbind meta-y +According to your keyboard and/or your needs, you can rebind any key +to a command with `/key` command. +A useful key is meta-k (alt-k) to find key codes. -10. Plugins/scripts +For example, to bind meta-y (alt-y) to command `/buffer close`: - On some distros like Debian, plugins are available via a separate package - (like weechat-plugins). - Plugins are automatically loaded when found. + /key bind (press meta-k) (press meta-y) /buffer close - Some plugins let you use scripts in WeeChat (in many languages like Perl, - Python, Ruby, Lua and Tcl). These plugins must be loaded with /plugin - command and they provide commands like /perl, used to load scripts. +You'll have a command line like: - Many external plugins/scripts (from contributors) are available for - WeeChat, please look at: + /key bind meta-y /buffer close - http://weechat.flashtux.org/plugins.php +To remove key: - Please look at WeeChat documentation to load/unload plugins or scripts. + /key unbind meta-y -11. More documentation - You can now use WeeChat and read FAQ/documentation for any other question: +[[plugins_scripts]] +Plugins/scripts +--------------- - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php +On some distros like Debian, plugins are available via a separate package +(like weechat-plugins). +Plugins are automatically loaded when found. - Enjoy WeeChat! +Some plugins let you use scripts in WeeChat (in many languages like Perl, +Python, Ruby, Lua and Tcl). These plugins must be loaded with `/plugin` +command and they provide commands like `/perl`, used to load scripts. --- -(c) 2006-2009, written by FlashCode -Last edited on 2009-05-11. -This document is part of WeeChat and is distributed under GPL 3 licence. +Many external plugins/scripts (from contributors) are available for +WeeChat: http://weechat.flashtux.org/plugins.php + +Please look at WeeChat documentation to load/unload plugins or scripts. + + +[[more_doc]] +More documentation +------------------ + +You can now use WeeChat and read FAQ/documentation for any other question: +http://weechat.flashtux.org/doc.php + +Enjoy WeeChat! diff --git a/doc/en/weechat_tester.en.txt b/doc/en/weechat_tester.en.txt new file mode 100644 index 000000000..241a3aaa4 --- /dev/null +++ b/doc/en/weechat_tester.en.txt @@ -0,0 +1,140 @@ +WeeChat tester's Guide +====================== +FlashCode +v0.3.0-dev, 2009-05-15 + + +[[purpose]] +Purpose +------- + +Many thankful users ask us how can they help developing WeeChat. The +easiest (and also most tricky) way to help developing WeeChat is +testing! + +Testing is very important part of software development and should not be +underestimated. When some features are implemented it should be tested, but for +some features there are too many use cases or these cases are tricky and +developers can't try out every case. + +For example: notorious charset plugin introduced in WeeChat 0.2.2: noone of us +(developers, contributors and testers) used channels with national characters +in their names and when 0.2.2 was released we got flooded by russian users +blaming us. If we have more testers it should not happen again in future. + +Testing stable version of WeeChat is pointless because developers are busy +implementing new stuff (and fixing old bugs) all the time. + + +[[prepare_system]] +Prepare your system +------------------- + +It would help us a lot if you enable Linux 'core' files: if WeeChat crashes, +Linux will write a file called 'core'. This file contains very useful debug +info, to know exactly where is problem in WeeChat. + +If you're using 'bash' shell, add following line to your `~/.bashrc`: + + ulimit -c unlimited + + +[[download]] +Download devel version +---------------------- + +Fresh code (with last bugs and features) is stored in GIT repository. + +You may decide to build it manually (recommended way): + +* GIT version can be built and installed in parallel to stable version, +* you don't need root access, you don't need to sacrifice stable version of + WeeChat. + +[[get_sources]] +Get and build sources +~~~~~~~~~~~~~~~~~~~~~ + +First create a directory, for example 'weechat-git': + +--------------------- +$ mkdir ~/weechat-git +$ cd ~/weechat-git +--------------------- + +If you have git installed, you can clone git repository (recommended way): + +-------------------------------------------- +$ git clone git://git.sv.gnu.org/weechat.git +$ cd weechat +-------------------------------------------- + +NOTE: Later, you can run "`git pull`" in this directory, to get deltas with +today's version. + +Otherwise you can download and unpack 'devel' package: + +----------------------------------------------------------------- +$ wget http://weechat.flashtux.org/download/weechat-devel.tar.bz2 +$ tar xvjf weechat-devel.tar.bz2 +$ cd weechat-devel +----------------------------------------------------------------- + +To build sources, cmake is recommended: + +-------------------------------------------------------------- +$ mkdir build +$ cd build +$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug +$ make +$ make install +-------------------------------------------------------------- + +If you don't have cmake, it's still possible to use autotools: + +---------------------------------------------------------- +$ ./autogen.sh # (only if you cloned git repository) +$ ./configure --prefix=$HOME/weechat-git +$ make +$ make install +---------------------------------------------------------- + +[[install_binary_package]] +Install binary package +~~~~~~~~~~~~~~~~~~~~~~ + +According to your Linux distribution: + +* Debian: http://debian.flashtux.org/ +* Gentoo: http://weechat.flashtux.org/download.php +* ArchLinux: PKGBUILD from http://aur.archlinux.org/ +* other: we don't know! Eheh. + + +[[run]] +Run WeeChat +----------- + +It's recommended to run WeeChat with another directory (different from stable +version), with option `--dir`. + +Command is: + + ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev + +If you're still awake you should see familiar interface and brag about +having newest possible version of WeeChat. ;) + +Now if you experience strange behavior (it may have issues or crash or boil +your beer) don't hesitate to join `#weechat` at `irc.freenode.net` and tell us. + +If it doesn't crash - tell us too, we need your feedback! + + +[[links]] +Useful links +------------ + +* GIT repository: http://git.savannah.gnu.org/gitweb/?p=weechat.git +* Bug tracker: https://savannah.nongnu.org/bugs/?group=weechat +* WeeChat commits RSS feed: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss diff --git a/doc/fr/Makefile.am b/doc/fr/Makefile.am index d79ab54b9..088c91537 100644 --- a/doc/fr/Makefile.am +++ b/doc/fr/Makefile.am @@ -65,12 +65,14 @@ BOOK_DEV_INCLUDE = dev/plugins.$(LANGCODE).xml \ dev/plugin_c_api.$(LANGCODE).xml \ dev/plugin_script_api.$(LANGCODE).xml +FAQ = weechat_faq.$(LANGCODE).txt QUICKSTART = weechat_quickstart.$(LANGCODE).txt +TESTER = weechat_tester.$(LANGCODE).txt EXTRA_DIST = $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) \ user/$(BOOK_USER).xml $(BOOK_USER_INCLUDE) \ dev/$(BOOK_DEV).xml $(BOOK_DEV_INCLUDE) \ - $(QUICKSTART) + $(FAQ) $(QUICKSTART) $(TESTER) if DBLATEX_FOUND PDF = user-pdf-stamp dev-pdf-stamp @@ -80,7 +82,7 @@ docdir = $(datadir)/doc/$(PACKAGE) all-local: user-html-stamp dev-html-stamp $(PDF) -# user guide, HTML output with chunks (many pages) +# user's guide, HTML output with chunks (many pages) user-html: user-html-stamp @@ -99,7 +101,7 @@ user-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER cp ../weechat-doc.css html/user/ touch user-html-stamp -# user guide, HTML output, all in one page +# user's guide, HTML output, all in one page user-html1: user-html1-stamp @@ -118,7 +120,7 @@ user-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USE cp ../weechat-doc.css html1/user/ touch user-html1-stamp -# user guide, PDF output +# user's guide, PDF output user-pdf: user-pdf-stamp @@ -136,7 +138,7 @@ user-pdf-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) user/$(BOOK_USER) cd build/user-pdf/ ; dblatex -o ../../pdf/user/$(BOOK_USER).pdf -P draft.mode=no -c ../../../dblatex.conf $(BOOK_USER).xml || true touch user-pdf-stamp -# dev guide, HTML output with chunks (many pages) +# developer's guide, HTML output with chunks (many pages) dev-html: dev-html-stamp @@ -155,7 +157,7 @@ dev-html-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV).x cp ../weechat-doc.css html/dev/ touch dev-html-stamp -# dev guide, HTML output, all in one page +# developer's guide, HTML output, all in one page dev-html1: dev-html1-stamp @@ -174,7 +176,7 @@ dev-html1-stamp: $(BOOK_AUTOGEN_INCLUDE) $(BOOK_COMMON_INCLUDE) dev/$(BOOK_DEV). cp ../weechat-doc.css html1/dev/ touch dev-html1-stamp -# dev guide, PDF output +# developer's guide, PDF output dev-pdf: dev-pdf-stamp @@ -198,7 +200,9 @@ install-data-hook: $(mkinstalldirs) $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ $(INSTALL_DATA) html/user/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/user/ $(INSTALL_DATA) html/dev/* $(DESTDIR)$(docdir)/html/$(LANGCODE)/dev/ + $(INSTALL_DATA) $(FAQ) $(DESTDIR)$(docdir)/ $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ + $(INSTALL_DATA) $(TESTER) $(DESTDIR)$(docdir)/ if DBLATEX_FOUND $(INSTALL_DATA) pdf/user/$(BOOK_USER).pdf $(DESTDIR)$(docdir)/ $(INSTALL_DATA) pdf/dev/$(BOOK_DEV).pdf $(DESTDIR)$(docdir)/ diff --git a/doc/fr/authors.fr.xml b/doc/fr/authors.fr.xml index 685f94822..7de05f260 100644 --- a/doc/fr/authors.fr.xml +++ b/doc/fr/authors.fr.xml @@ -46,14 +46,7 @@ along with this program. If not, see . kolter (Emmanuel Bouthenot) kolter AT openics.org - - développeur - - - - - Ptitlouis - ptitlouis AT sysif.net - - empaqueteur Debian + développeur, empaqueteur Debian @@ -67,6 +60,12 @@ along with this program. If not, see . Les personnes suivantes ont contribué à WeeChat : + + + Ptitlouis - + premier empaqueteur Debian + + Jiri Golembiovsky - diff --git a/doc/fr/weechat_faq.fr.txt b/doc/fr/weechat_faq.fr.txt new file mode 100644 index 000000000..5470ccf73 --- /dev/null +++ b/doc/fr/weechat_faq.fr.txt @@ -0,0 +1,338 @@ +WeeChat - Questions Fréquemment Posées (FAQ) +============================================ +FlashCode +v0.3.0-dev, 2009-05-15 + + +Général +------- + + +[[why_choose_weechat]] +Pourquoi choisir WeeChat ? X-Chat et Irssi sont si bien... +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Parce que WeeChat est très léger et a de nouvelles fonctionnalités. +Quelques fonctionnalités (version > = 0.3.x) : + +* support multi-protocoles via extensions (IRC, Jabber) +* plusieurs interfaces déportées en plus de Curses (à venir bientôt) +* disponible en plusieurs langues +* extensible par des extensions (C, Perl, Python, Ruby, Lua, Tcl) +* tampons avec contenu libre +* filtrage de l'affichage avec tags et expressions régulières +* découpage de la fenêtre horizontalement et verticalement +* barres personnalisables et extensibles +* liste des pseudos disponible dans toutes les interfaces +* recherche incrémentale de texte dans les tampons, saut aux highlights +* tube FIFO pour contrôle à distance +* support aspell +* double encodage (décodage/encodage) +* développé à partir de zéro (non basé sur un quelconque client) +* multi-platformes +* 100% GPL et libre + +Plus d'infos sur cette page : +http://weechat.flashtux.org/features.php + + +Compilation / installation +-------------------------- + + +[[gui]] +J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Aujourd'hui seule l'interface Curses est disponible. + +D'autres interfaces seront disponibles en mode distant (actuellement +en développement). + + +[[compile_git]] +Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +La méthode recommandée pour compiler WeeChat est d'utiliser cmake. + +Si vous compilez avec les autotools (et non cmake), vérifiez que vous avez bien +la dernière version d'autoconf et automake (WeeChat est développé avec autoconf +2.61 et automake 1.10.1). + +Une autre façon de faire est de compiler le "paquet devel", qui nécessite moins +de dépendences. Ce paquet est construit quasiment tous les jours à partir de la +base git. Notez que ce paquet peut ne pas correspondre exactement à la base +git et qu'il est moins pratique que de cloner la base git pour installer des +mises à jour. + + +Utilisation de WeeChat +---------------------- + + +[[lost]] +J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez +`/help commande`. Les touches et commandes sont listées dans la documentation. + +Il est recommandé pour les nouveaux utilisateurs de lire le guide de démarrage +rapide (voir la page de doc sur le site). + + +[[buffer_vs_window]] +J'ai entendu parler de "buffer" et "window", quelle est la différence ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Un tampon ('buffer') est composé d'un numéro, un nom, des lignes affichées +(ainsi que d'autres données). + +Une fenêtre ('window') est une zone de l'écran affichant un tampon. Il est +possible de découper l'écran horizontaleent ou verticalement en plusieurs +fenêtres. + +Chaque fenêtre affiche un tampon. Un tampon peut être caché (affiché par +aucune fenêtre) ou affiché par une ou plusieurs fenêtres. + + +[[charset]] +Je ne vois pas bien certains accents dans WeeChat, que faire ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Pour les versions < 0.2.3, merci d'installer la dernière version stable. + +Pour les versions > = 0.2.3 : + +* vérifiez que weechat-curses est lié avec libncursesw (attention : nécessaire + sur beaucoup de distributions, mais pas toutes) : + `ldd /chemin/vers/weechat-curses` +* vérifiez que l'extension "Charset" est chargée avec la commande `/plugin` + (s'il ne l'est pas, vous devez peut-être installer le paquet + "weechat-plugins") +* vérifiez la ligne charset (sur le tampon serveur), vous devriez voir + 'ISO-XXXXXX' ou 'UTF-8' pour le charset du terminal. Si vous voyez + 'ANSI_X3.4-1968' ou d'autres valeurs, votre locale est probablement erronée. +* affectez la valeur pour le décodage global, par exemple : +** avec WeeChat < = 0.2.6 : `/setp charset.global.decode = ISO-8859-15` +** avec WeeChat > = 0.3.x : `/set charset.default.decode "ISO-8859-15"` +* si vous utilisez la locale UTF-8 : +** vérifiez que votre terminal est compatible UTF-8 + (un terminal conseillé pour l'UTF-8 est rxvt-unicode) +** si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8 + ("`defutf8 on`" dans ~/.screnrc ou `screen -U` pour lancer screen) + + +[[bars_background]] +Des barres telles que le titre et le statut ne sont pas remplies, la couleur de fond s'arrête après le texte, pourquoi ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la +sortie de `echo $TERM` dans votre terminal). + +Selon la façon de lancer WeeChat, vous devriez avoir : + +* si WeeChat tourne en local ou sur une machine distante sans screen : + cela dépend du terminal utilisé : 'xterm', 'rxvt', etc... +* si WeeChat tourne sous screen, vous devriez avoir 'screen'. + +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. + + +[[screen_weird_chars]] +Quand j'utilise weechat sous screen, j'ai des caractères bizarres et aléatoires, comment corriger ça ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cela peut être du à la variable TERM qui n'a pas la bonne valeur (regardez la +sortie de `echo $TERM` dans votre terminal). + +Par exemple 'xterm-color' provoque ce genre de problèmes, utilisez +'xterm' qui est ok (comme plein d'autres valeurs). + +Si besoin, corrigez la variable TERM : `export TERM="xxx"`. + + +[[key_bindings]] +Comment puis-je configurer les raccourcis clavier ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Les raccourcis clavier sont modifiables avec la commande /key. + +La touche par défaut Meta-k (souvent Alt-k) permet de capturer le code d'une +touche et de l'inclure dans la ligne de commande. + + +[[openbsd_plugins]] +J'utilise OpenBSD et WeeChat ne charge aucune extension, pourquoi ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Sous OpenBSD, le nom des extensions se termine par ".so.0.0" (".so" sous +Linux). + +Vous devez configurer ça : + +* avec WeeChat < = 0.2.6 : `/set plugins_extension = ".so.0.0"` +* avec WeeChat > = 0.3.x : `/set weechat.plugin.extension ".so.0.0"` + +Puis: `/plugin autoload`. + + +[[scripts]] +Comment puis-je charger des scripts Perl/Python/Ruby/Lua/Tcl ? Les scripts sont-ils compatibles avec d'autres clients IRC ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Les commandes `/perl`, `/python`, `/ruby`, `/lua` et `/tcl` permettent de +charger les scripts (le chemin par défaut est '~/.weechat//'). + +Les scripts ne sont pas compatibles avec d'autres clients IRC. + +Notes : + +* les scripts dans '~/.weechat//autoload/' sont automatiquement chargés + par WeeChat lorsqu'il démarre. +* l'extension 'tcl' est disponible à partir de la version 0.3.x. + + +[[change_locale_without_quit]] +Je souhaite changer la langue des messages affichés par WeeChat, mais sans quitter WeeChat, est-ce possible ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Oui, il faut utiliser le script python shell.py (disponible sur le site de +WeeChat) et taper ces commandes une fois le script chargé : + + /shell setenv LANG=fr_FR.UTF-8 + /upgrade + +Pour avoir des messages anglais avec encodage UTF-8 pour le terminal, pour les +utilisateurs en ISO, vous pouvez taper : `/shell setenv LANG=fr_FR`. + + +[[terminal_copy_paste]] +Avec l'interface Curses, comment puis-je copier/coller du texte sans coller la liste des pseudos ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Vous pouvez utiliser un terminal qui propose la sélection rectangulaire (comme +rxvt-unicode, konsole, etc...). La touche est habituellement ctrl + alt + +sélection à la souris. + +Une autre solution est de déplacer la liste des pseudos en haut ou en bas, par +exemple : + +* avec WeeChat < = 0.2.6 : `/set look_nicklist_position = top` +* avec WeeChat > = 0.3.x : `/bar set nicklist position top` + + +[[highlight_notification]] +Comment être averti lorsque quelqu'un prononce mon pseudo sur un canal ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Vous pouvez utiliser le script 'sound.pl' (disponible sur la page des scripts), +puis configurer une commande système (jouant un son, affichant un message à +l'écran, etc...) comme ceci : + +* avec WeeChat < = 0.2.6 : + `/setp perl.sound.cmd_highlight = "/chemin/commande parametres"` +* avec WeeChat > = 0.3.x : + `/set plugins.var.perl.sound.cmd_highlight "/chemin/commande parametres"` + +De nombreux autres scripts de notification existent, merci de consulter la +liste des extensions/scripts : +http://weechat.flashtux.org/plugins.php + + +[[filter_irc_join_part_quit]] +Comment puis-je filter les messages join/part/quit sur les canaux IRC ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Selon la version de WeeChat : + +* avec WeeChat < = 0.2.6 : + + `/ignore * join #weechat freenode` + + `/ignore * part #weechat freenode` + + `/ignore * quit #weechat freenode` + + (le canal et/ou le serveur peuvent être "*", `/help ignore` pour l'aide) + +* avec WeeChat > = 0.3.x : + +** filtre interlligent (pour garder les join/part/quit des utilisateurs qui + ont parlé récemment) : + + `/set irc.look.smart_filter on` + + `/filter add irc_smart * irc_smart_filter *` + + (`/help irc.look.smart_filter` et `/help filter` pour l'aide) + +** filtre global (pour cacher *tous* les join/part/quit) : + + `/filter add irc_jpk * irc_join,irc_part,irc_quit *` + + (`/help filter` pour l'aide) + + +[[ignore_vs_filter]] +Quelle est la différence entre les commandes /ignore et /filter ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +La commande `/ignore` est une commande IRC, donc elle s'applique uniquement aux +tampons IRC (serveurs et canaux). +Elle permet d'ignorer des pseudos ou nom d'hôtes pour un serveur ou un canal +(la commande ne s'applique pas au contenu des messages). +Les messages corespondants sont supprimés par l'extension IRC avant affichage +(donc vous ne les verrez jamais). + +La commande `/filter` est une commande "core", donc elle s'applique à n"importe +quel tampon. +Elle permet de filtrer des lignes dans les tampons à l'aide de tags ou +d'expression régulière pour le préfixe et contenu de la ligne. +Les lignes filtrées sont simplement cachées, pas supprimées, et il est possible +de les voir en désactivant les filtres (par défaut, la touche alt + "=" +active/désactive les filtres). + + +Développement +------------- + + +[[bug_task_patch]] +Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Il y a 3 possibilités : + +. vous pouvez nous joindre sur IRC : 'irc.freenode.net', canal '#weechat' +. 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 +. vous pouvez envoyer un mail aux développeurs, consultez la page support + pour les mails des développeurs : + http://weechat.flashtux.org/support.php + (vous pouvez souscrire et envoyer à la liste de diffusion nommée "support") + + +[[supported_os]] +Quelle est la liste des plate-formes supportées par WeeChat ? Sera-t-il porté sur d'autres systèmes d'exploitation ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +La liste complète est sur cette page : +http://weechat.flashtux.org/download.php?view=supported_os + +Nous faisons le maximum pour supporter le plus de plate-formes possible. +Toute aide est la bienvenue pour les systèmes que nous n'avons pas, pous y +tester WeeChat. + + +[[help_developers]] +Je souhaiterai aider les développeurs WeeChat. Que puis-je faire ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Il y a plusieurs choses à faire (test, code, documentation, etc...) + +Merci de prendre contact avec nous par IRC ou mail, consultez la page +support : +http://weechat.flashtux.org/support.php + + +[[donate]] +Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Vous pouvez donner de l'argent pour aider le développement. +Plus de détails sur http://weechat.flashtux.org/donate.php diff --git a/doc/fr/weechat_quickstart.fr.txt b/doc/fr/weechat_quickstart.fr.txt index c324b0783..3f9b1f1c7 100644 --- a/doc/fr/weechat_quickstart.fr.txt +++ b/doc/fr/weechat_quickstart.fr.txt @@ -1,220 +1,245 @@ -Guide de démarrage rapide WeeChat (version française, pour WeeChat >= 0.3.x) -============================================================================ +Guide de démarrage rapide WeeChat +================================= +FlashCode +v0.3.0-dev, 2009-05-15 -1. Démarrer weechat - Un émulateur de terminal recommandé pour X (mais pas obligatoire) est - rxvt-unicode (il a un bon support UTF-8, et aucun problème avec les - touches par défaut). +[[start]] +Démarrer weechat +---------------- - Lancer "weechat-curses" depuis votre shell. +Un émulateur de terminal recommandé pour X (mais pas obligatoire) est +rxvt-unicode (il a un bon support UTF-8, et aucun problème avec les +touches par défaut). -2. Aide en ligne / options +Lancer "weechat-curses" depuis votre shell. - WeeChat dispose d'aide pour toutes les commandes, tapez simplement /help - Pour avoir de l'aide sur une commande, tapez /help commande - Pour modifier des options, utilisez /set config.section.option valeur - (où "config" est le nom de la configuration ("weechat" pour le coeur, ou - un nom d'extension), "section" la section de cette configuration et - "option" le nom de l'option). +[[help_options]] +Aide en ligne / options +----------------------- - WeeChat utilise immédiatement la nouvelle valeur (vous n'avez *jamais* - besoin de redémarrer WeeChat après avoir changé la configuration). +WeeChat dispose d'aide pour toutes les commandes, tapez simplement /help +Pour avoir de l'aide sur une commande, tapez `/help commande` - Vous pouvez utiliser /set avec un nom partiel d'option et le caractère - joker "*" au début ou à la fin pour afficher toutes les options contenant - ces lettres. - Par exemple : +Pour modifier des options, utilisez `/set config.section.option valeur` +(où `config` est le nom de la configuration (`weechat` pour le coeur, ou +un nom d'extension), `section` la section de cette configuration et +`option` le nom de l'option). - /set => affiche toutes les options (WeeChat et extensions) - /set weechat.* => affiche les options WeeChat - /set irc.* => affiche les options de l'extension IRC +WeeChat utilise immédiatement la nouvelle valeur (vous n'avez *jamais* +besoin de redémarrer WeeChat après avoir changé la configuration). - Vous pouvez afficher de l'aide sur une option avec /help, par exemple : - /help weechat.look.highlight +Vous pouvez utiliser `/set` avec un nom partiel d'option et le caractère +joker "*" au début ou à la fin pour afficher toutes les options contenant +ces lettres. +Par exemple : - Toutes les options sont sauvées quand WeeChat quitte (ou avec la commande - "/save" pour forcer une écriture des options). +`/set`:: + affiche toutes les options (WeeChat et extensions) - Vous pouvez éditer les fichiers de configuration (*.conf) à la main et les - recharger par la commande /reload si vous ne souhaitez pas utiliser la - commande /set. +`/set weechat.*`:: + affiche les options WeeChat -3. Coeur vs extensions +`/set irc.*`:: + affiche les options de l'extension IRC - Le coeur de WeeChat ("core") ne fait qu'afficher les données à l'écran et - interagir avec l'utilisateur, cela signifie que le coeur sans extension - n'a pas grand intérêt (utilisateurs fidèles: IRC faisait partie du coeur - dans les versions <= 0.2.6). +Vous pouvez afficher de l'aide sur une option avec `/help`, par exemple : +`/help weechat.look.highlight`. - Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions. +Toutes les options sont sauvées quand WeeChat quitte (ou avec la commande +`/save` pour forcer une écriture des options). - Utilisez la commande /plugin pour voir les extensions chargées, vous - devriez voir "irc" et d'autres extensions dans cette liste. +Vous pouvez éditer les fichiers de configuration (*.conf) à la main et les +recharger par la commande `/reload` si vous ne souhaitez pas utiliser la +commande `/set`. -4. Créer un serveur IRC - Vous pouvez ajouter un serveur IRC par la commande /server, par exemple : +[[core_vs_plugins]] +Coeur vs extensions +------------------- - /server add oftc irc.oftc.org 6667 +Le coeur de WeeChat ("core") ne fait qu'afficher les données à l'écran et +interagir avec l'utilisateur, cela signifie que le coeur sans extension +n'a pas grand intérêt (utilisateurs fidèles: IRC faisait partie du coeur +dans les versions < = 0.2.6). - Comme d'habitude, de l'aide est disponible si vous êtes perdus : +Tous les protocoles réseau comme IRC sont fournis sous forme d'extensions. - /help server +Utilisez la commande `/plugin` pour voir les extensions chargées, vous +devriez voir "irc" et d'autres extensions dans cette liste. -5. Définir les options du serveur IRC - WeeChat utilise des valeurs par défaut pour tous les serveurs, si vous ne - spécifiez pas de valeur spécifique pour une option de serveur. - Ces options par défaut sont "irc.server_default.*". +[[create_irc_server]] +Créer un serveur IRC +-------------------- - Pour chaque option d'un serveur, WeeChat utilise sa valeur si elle est - définie (non "null"). Sinon WeeChat utilise la valeur par défaut - (irc.server_default.xxx). +Vous pouvez ajouter un serveur IRC par la commande `/server`, par exemple : - Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et - vous pouvez les écraser pour le serveur oftc avec la commande suivante : + /server add oftc irc.oftc.org 6667 - /set irc.server.oftc.nicks "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5" +Comme d'habitude, de l'aide est disponible si vous êtes perdus : +`/help server` - Pour modifier le nom d'utilisateur et nom réel : - /set irc.server.oftc.username "Mon nom d'utilisateur" - /set irc.server.oftc.realname "Mon nom réel" +[[irc_server_options]] +Définir les options du serveur IRC +---------------------------------- - Pour activer la connexion automatique au serveur lors du démarrage : +WeeChat utilise des valeurs par défaut pour tous les serveurs, si vous ne +spécifiez pas de valeur spécifique pour une option de serveur. +Ces options par défaut sont "irc.server_default.*". - /set irc.server.oftc.autoconnect on +Pour chaque option d'un serveur, WeeChat utilise sa valeur si elle est +définie (non "null"). Sinon WeeChat utilise la valeur par défaut +("irc.server_default.xxx"). - Pour lancer une commande après connexion au serveur, par exemple pour - s'identifier auprès de nickserv : +Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et +vous pouvez les écraser pour le serveur oftc avec la commande suivante : - /set irc.server.oftc.command "/msg nickserv identify xxxxxx" + /set irc.server.oftc.nicks "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5" - NB: plusieurs commandes peuvent être séparées par ';' (point-virgule) +Pour modifier le nom d'utilisateur et nom réel : - Pour rejoindre automatiquement des canaux lors de la connexion au serveur : + /set irc.server.oftc.username "Mon nom d'utilisateur" + /set irc.server.oftc.realname "Mon nom réel" - /set irc.server.oftc.autojoin "#canal1,#canal2" +Pour activer la connexion automatique au serveur lors du démarrage : - Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par - défaut à la place, par exemple pour utiliser les pseudos par défaut - (irc.server_default.nicks) : + /set irc.server.oftc.autoconnect on - /set irc.server.oftc.nicks null +Pour lancer une commande après connexion au serveur, par exemple pour +s'identifier auprès de nickserv : - Autres options : - Vous pouvez modifier les autres options avec la commande suivante ("xxx" - est le nom d'une option) : + /set irc.server.oftc.command "/msg nickserv identify xxxxxx" - /set irc.server.oftc.xxx valeur +NB: plusieurs commandes peuvent être séparées par ';' (point-virgule) -6. Se connecter au serveur IRC et rejoindre les canaux +Pour rejoindre automatiquement des canaux lors de la connexion au serveur : - /connect oftc + /set irc.server.oftc.autojoin "#canal1,#canal2" - Note : cette commande peut aussi être utilisée pour créer et se connecter - au serveur sans utiliser la commande /server (devrais-je répéter que vous - pouvez voir l'aide pour cette commande avec /help connect ? ;) +Pour supprimer la valeur d'une option du serveur et utiliser sa valeur par +défaut à la place, par exemple pour utiliser les pseudos par défaut +(irc.server_default.nicks) : -7. Joindre/quitter les canaux IRC + /set irc.server.oftc.nicks null - Joindre un canal : +Autres options : vous pouvez modifier les autres options avec la commande +suivante ("xxx" est le nom d'une option) : - /join #channel + /set irc.server.oftc.xxx valeur - Quitter un canal : - /part [message de fin] +[[connect_to_irc_server]] +Se connecter au serveur IRC et rejoindre les canaux +--------------------------------------------------- - Quitter un canal et fermer le tampon : + /connect oftc - /close [message de fin] +Note : cette commande peut aussi être utilisée pour créer et se connecter +au serveur sans utiliser la commande `/server` (devrais-je répéter que vous +pouvez voir l'aide pour cette commande avec `/help connect` ? ;) - (/close est un alias sur /buffer close) -8. Gérer les tampons/fenêtres +[[join_part_irc_channels]] +Joindre/quitter les canaux IRC +------------------------------ - Un tampon ("buffer") est un composant lié à une extension, avec une - catégorie et un nom. Le tampon contient les données affichées à l'écran. +`/join #channel`: + joindre un canal - Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a - qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez - alors plusieurs fenêtres avec plusieurs tampons en même temps. +`/part [message de fin]`:: + quitter un canal (en laissant le tampon ouvert) - Commandes pour gérer les tampons et les fenêtres : +`/close [message de fin]`:: + quitter un canal et fermer le tampon (`/close` est un alias sur + `/buffer close`) - /buffer - /window - (je ne répéterai pas que vous pouvez avoir de l'aide sur ces commandes - avec /help) +[[buffer_window]] +Gérer les tampons/fenêtres +-------------------------- - Par exemple, pour découper verticalement l'écran en une petite fenêtre - (1/3 de la largeur) et une large (2/3), utilisez la commande : +Un tampon ("buffer") est un composant lié à une extension, avec une +catégorie et un nom. Le tampon contient les données affichées à l'écran. - /window splitv 33 +Une fenêtre ("window") est une vue sur un tampon. Par défaut il n'y a +qu'une fenêtre affichant un tampon. Si vous divisez l'écran, vous verrez +alors plusieurs fenêtres avec plusieurs tampons en même temps. -9. Raccourcis clavier +Commandes pour gérer les tampons et les fenêtres : - WeeChat utilise un certain nombre de touches par défaut. Toutes ces - touches sont dans la documentation, mais vous devriez connaître au moins - les touches vitales : - - alt + flèches gauche/droite (ou F5/F6): aller au tampon précédent/suivant - - F7/F8: aller à la fenêtre précédente/suivante (quand l'écran est divisé) - - F9/F10: faire défiler la barre de titre - - F11/F12: faire défiler la liste des pseudos - - tab: compléter le texte de la barre d'entrée, comme avec votre shell - - page préc/suiv: faire défiler le texte dans le tampon courant - - alt + A: sauter au tampon avec de l'activité (dans la "hotlist") + /buffer + /window + +(je ne répéterai pas que vous pouvez avoir de l'aide sur ces commandes +avec /help) + +Par exemple, pour découper verticalement l'écran en une petite fenêtre +(1/3 de la largeur) et une large (2/3), utilisez la commande : + + /window splitv 33 + + +[[key_bindings]] +Raccourcis clavier +------------------ + +WeeChat utilise un certain nombre de touches par défaut. Toutes ces +touches sont dans la documentation, mais vous devriez connaître au moins +les touches vitales : + +- 'alt + flèches gauche/droite' (ou 'F5'/'F6'): aller au tampon précédent/suivant +- 'F7'/'F8': aller à la fenêtre précédente/suivante (quand l'écran est divisé) +- 'F9'/'F10': faire défiler la barre de titre +- 'F11'/'F12': faire défiler la liste des pseudos +- 'tab': compléter le texte de la barre d'entrée, comme avec votre shell +- 'page préc/suiv': faire défiler le texte dans le tampon courant +- 'alt + A': sauter au tampon avec de l'activité (dans la "hotlist") - Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe - quelle touche à une commande avec la commande "/key". - Une touche utile est meta-k (alt-k) pour trouver le code des touches. +Selon votre clavier et/ou vos besoins, vous pouvez associer n'importe +quelle touche à une commande avec la commande `/key`. +Une touche utile est meta-k (alt-k) pour trouver le code des touches. - Par exemple, pour associer meta-y (alt-y) à la commande "/buffer close" : +Par exemple, pour associer meta-y (alt-y) à la commande `/buffer close` : - /key (pressez meta-k) (pressez meta-y) /buffer close + /key bind (pressez meta-k) (pressez meta-y) /buffer close - Vous aurez une ligne de commande qui ressemble à ceci : +Vous aurez une ligne de commande qui ressemble à ceci : - /key meta-y /buffer close + /key bind meta-y /buffer close - Pour enlever la touche : +Pour enlever la touche : - /key unbind meta-y + /key unbind meta-y -10. Extensions/scripts - Sur certaines distributions comme Debian, les extensions sont disponibles - via un paquet séparé (par exemple weechat-plugins). - Les extensions sont automatiquement chargées lorsqu'elles sont trouvées. +[[plugins_scripts]] +Extensions/scripts +------------------ - Des extensions permettent d'utiliser des scripts dans WeeChat (dans - différent langages comme Perl, Python, Ruby, Lua et Tcl). Ces extensions - doivent être chargées avec la commande /plugin et elles fournissent des - commandes telles que /perl, utilisées pour charger les scripts. +Sur certaines distributions comme Debian, les extensions sont disponibles +via un paquet séparé (par exemple weechat-plugins). +Les extensions sont automatiquement chargées lorsqu'elles sont trouvées. - Plusieurs extensions/scripts (de contributeurs) sont disponibles pour - WeeChat, voir ici : +Des extensions permettent d'utiliser des scripts dans WeeChat (dans +différent langages comme Perl, Python, Ruby, Lua et Tcl). Ces extensions +doivent être chargées avec la commande `/plugin` et elles fournissent des +commandes telles que `/perl`, utilisées pour charger les scripts. - http://weechat.flashtux.org/plugins.php +Plusieurs extensions/scripts (de contributeurs) sont disponibles pour +WeeChat : http://weechat.flashtux.org/plugins.php - Merci de regarder la documentation WeeChat pour charger/décharger des - extensions ou des scripts. +Merci de regarder la documentation WeeChat pour charger/décharger des +extensions ou des scripts. -11. Plus de documentation - Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour - toute autre question : +[[more_doc]] +Plus de documentation +--------------------- - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php +Vous pouvez maintenant utiliser WeeChat et lire la FAQ/documentation pour +toute autre question : http://weechat.flashtux.org/doc.php - Bon WeeChat ! - --- -(c) 2006-2009, écrit par FlashCode -Dernière édition le 11/05/2009. -Ce document fait partie de WeeChat et est distribué sous license GPL 3. +Bon WeeChat ! diff --git a/doc/fr/weechat_tester.fr.txt b/doc/fr/weechat_tester.fr.txt new file mode 100644 index 000000000..7e10c0784 --- /dev/null +++ b/doc/fr/weechat_tester.fr.txt @@ -0,0 +1,147 @@ +Guide du testeur WeeChat +======================== +FlashCode +v0.3.0-dev, 2009-05-15 + + +[[purpose]] +Objet +----- + +Beaucoup d'utilisateurs nous demandent comment aider WeeChat. La façon +la plus facile (et aussi la plus rusée) consiste à le tester ! + +Le test est une partie très importante du développement de logiciel et +ne devrait pas être sous-estimé. Lorsque de nouvelles fonctionnalités +sont implémentées, elles doivent être testées, mais pour certaines +fonctionnalités il y a trop de cas à tester et les développeurs ne +peuvent pas tout tester. + +Par exemple : l'extension charset introduite dans WeeChat WeeChat 0.2.2 : aucun +de nous (développeurs, contributeurs et testeurs) n'utilisait de canaux avec +des caractères spéciaux dans leurs noms et quand la version 0.2.2 a été rendue +disponible, nous avons reçu de nombreuses remontées d'utilisateurs russes. +Si nous avons plus de testeurs, cela ne devrait pas arriver à nouveau dans le +futur. + +Tester les versions stables de WeeChat est inutile car les +développeurs sont constamment occupés à implémenter de nouvelles +fonctionnalités (et à corriger des anciens bugs). + + +[[prepare_system]] +Préparez votre système +---------------------- + +Cela nous aiderait beaucoup si vous activiez les fichiers 'core' Linux : si +WeeChat se plante, Linux écrit un fichier 'core'. Ce fichier contient des +informations importantes pour le debug, pour savoir exactement où le problème +se situe dans WeeChat). + +Si vous utilisez le shell 'bash', ajoutez cette ligne dans votre `~/.bashrc` : + + ulimit -c unlimited + + +[[download]] +Téléchargement de la version devel +---------------------------------- + +Le code tout frais (avec les derniers bugs et fonctionnalités) est stocké dans +GIT. + +Vous pouvez décider de le construire manuellement (méthode recommandée) : + +* la version GIT peut être construite et installée en parallèle de la version + stable, +* vous n'avez pas besoin d'accès root ni de sacrifier votre version stable de + WeeChat. + +[[get_sources]] +Obtenir et compiler les sources +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Créez tout d'abord un répertoire, par exemple 'weechat-git' : + +--------------------- +$ mkdir ~/weechat-git +$ cd ~/weechat-git +--------------------- + +Si vous avez git installé, vous pouvez cloner la base GIT (recommandé) : + +-------------------------------------------- +$ git clone git://git.sv.gnu.org/weechat.git +$ cd weechat +-------------------------------------------- + +NOTE: Plus tard, vous pourrez utiliser la command "`git pull`" dans ce répertoire +pour obtenir juste les deltas avec la version d'aujourd'hui. + +Sinon vous pouvez installer le paquet 'devel' : + +----------------------------------------------------------------- +$ wget http://weechat.flashtux.org/download/weechat-devel.tar.bz2 +$ tar xvjf weechat-devel.tar.bz2 +$ cd weechat-devel +----------------------------------------------------------------- + +Pour compiler les sources, cmake est recommandé : + +-------------------------------------------------------------- +$ mkdir build +$ cd build +$ cmake .. -DPREFIX=$HOME/weechat-git -DCMAKE_BUILD_TYPE=Debug +$ make +$ make install +-------------------------------------------------------------- + +Si vous n'avez pas cmake, il est toujours possible d'utiliser les autools : + +----------------------------------------------------------------- +$ ./autogen.sh # (seulement si vous avez cloné la base git) +$ ./configure --prefix=$HOME/weechat-git +$ make +$ make install +----------------------------------------------------------------- + +[[install_binary_pcakcge]] +Obtenir un paquet binaire +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Selon votre distribution Linux : + +* Debian: http://debian.flashtux.org/ +* Gentoo: http://weechat.flashtux.org/download.php +* ArchLinux: PKGBUILD depuis http://aur.archlinux.org/ +* autre: nous ne savons pas ! Eheh. + + +[[run]] +Lancer WeeChat +-------------- + +Il est conseillé de lancer WeeChat avec un répertoire différent de la version +stable, avec l'option `--dir`. + +La commande est : + + ~/weechat-git/bin/weechat-curses --dir ~/.weechat-dev + +Si vous êtes encore éveillé, vous devriez voir une interface familière et +pouvoir vous vanter d'utiliser la version la plus récente possible de WeeChat ;) + +Maintenant si vous obtenez un comportement étrange ou un plantage, n'hésitez +pas à nous en avertir sur `#weechat`, serveur `irc.freenode.net`. + +S'il n'y a pas de plantage, dites-le nous aussi, nous avons besoin de votre +retour et de vos impressions ! + + +[[links]] +Liens intéressants +------------------ + +* Base GIT : http://git.savannah.gnu.org/gitweb/?p=weechat.git +* Bug tracker : https://savannah.nongnu.org/bugs/?group=weechat +* Flux RSS des commits WeeChat : http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=rss diff --git a/doc/pl/Makefile.am b/doc/pl/Makefile.am deleted file mode 100644 index 721e6849e..000000000 --- a/doc/pl/Makefile.am +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2003-2009 FlashCode -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 3 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . -# - -LANGCODE = pl -QUICKSTART = weechat_quickstart.$(LANGCODE).txt - -EXTRA_DIST = $(QUICKSTART) - -docdir = $(datadir)/doc/$(PACKAGE) - -# install docs - -install-data-hook: - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ diff --git a/doc/pl/weechat_quickstart.pl.txt b/doc/pl/weechat_quickstart.pl.txt deleted file mode 100644 index afb801363..000000000 --- a/doc/pl/weechat_quickstart.pl.txt +++ /dev/null @@ -1,111 +0,0 @@ -Weechat szybki start (wersja polska, WeeChat <= 0.2.6) - -1. Wczenie - - Aby wybra konkretny interfejs naley wpisa: - - weechat-curses dla interfejsu curses - - weechat-gtk dla interfejsu GTK (w fazie tworzenia) - - weechat-qt dla interfejsu QT (planowany) - - weechat-wxwidgets dla interfejsu WxWidgets (planowany) - - -2. Pomoc online / opcje - - Weechat posiada polecenie pomocy, ktrego mona uy dla kadej dostpnej opcji, wystarczy wpisa /help - Aby otrzyma pomoc odnonie komendy, wpisz /help - - Aby konfigurowa opcje naley wpisa /set = - Moesz wpisa /set z nie pen nazw opcji (pokae to opcje zawierajce wpisany cig znakw), - lub z ca nazw opcji bez wartoci (pokae sie wtedy caa pomoc odnonie opcji). - - Uwaga: ustawienia s zapamitywane podczas wyczania WeeChata (albo po wpisaniu /save ) - NIE EDYTUJ pliku konfiguracyjnego WeeChata podczas pracy programu, poniewa WeeChat moe nadpisa - ten plik w kadej chwili i nie bdzie moliwoci odzyskania ustawie. - Aby zmieni kade z ustawie, uywaj komendy "/set", WeeChat po jej uyciu od razu zacznie korzysta z nowych - parametrw. - -3. Dodawanie serwerw - - Dla przykadu irc.quakenet.org, port 6667: - /server add quakenet irc.quakenet.org 6667 - (wpisz /help server dla penej pomocy) - -4. Ustawianie wasnych ustawie dotyczcych serwera - - Niki: - /set quakenet.server_nick1 = "mj-nick" - /set quakenet.server_nick2 = "mj-nick2" - /set quakenet.server_nick3 = "mj-nick3" - - Imi uytkownika: - /set quakenet.server_username = "My username" - /set quakenet.server_realname = "My real name" - - Automatyczne czenie do serwera przy starcie WeeChata: - /set quakenet.server_autoconnect = on - - Automatyczne wchodzenie na wybrane kanay po poczeniu sie do serwera: - /set quakenet.server_autojoin = "#kana1,#kana2" - - Inne opcje: - Moesz zobaczy inne opcje i ich waciwoci po wpisaniu /set quakenet - Aby ustawi konkretn opcj wpisz /set quakenet.server_opcja = warto - - -5. czenie do serwera i automatyczne wchodzenie na wybrane kanay: - - /connect quakenet - -6. Wchodzenie/wychodzenie na/z kanay/-w - - Wchodzenie na kana: - /join #kana - Wychodzenie z kanau: - /part {wiadomo przy wychodzeniu} - Wyjcie z kanau i zamknicie zakadki: - /close {wiadomo przy wychodzeniu} - ("/close" to alias od "/bufer close") - -7. Zarzdzanie bufory/okna - - Moesz zarzdza buforami przy pomocy polecenia "/buffer" i oknami "/windows" - Przykad: - -aby rozdzieli ekran w pionie na mae okno (1/3 szerokoci), - i na due (2/3), wpisz: - /window splthv 33 - -8. Przypisywanie funkcji do klawiszy: - - W celu atwiejszej pracy mona przypisa dowolnym klawiszom wybrane funkcje/polecenia - przy pomocy komendy "/key" - Uyteczn moe by funkcja meta-k (alt+k) ktra pozwala znale przypisane klawiszom kody. - - Przykad: aby zbindowa (przypisa) meta-y (alt-y) do polecenia "/buffer close": - /key (nacinij meta-k) (nacinij meta-y) /buffer close - Otrzymujesz: - /key meta-y /buffer close - - -9. Wtyczki/skrypty - - Na niektrych systemach operacyjnych, takich jak Debian, wtyczki s dostpne jako oddzielne paczki - (np. weechat-plugins) - Wtyczki s automatycznie adowane przy starcie. - Dodatkowe skrypty i wtyczki do WeeChata dostpne s na: - http://weechat.flashtux.org/plugins.php - Zajrzyj do dokumentacji WeeChata, aby dowiedzie sie jak ladowa i wyadowa wtyczki i skrypty: - http://weechat.flashtux.org/doc.php - -10. Dokumentacja szczegowa - - Wiesz juz jak w podstawowy sposb uywa WeeChata, aby dowiedzie sie wicej poczytaj dokumentacj. - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Miej pracy z WeeChatem! - --- -(c) 2006-05-31, written by FlashCode - Translated by dzik (znajdziecie mnie na irc.freenode.net) -This document is part of WeeChat and is distributed under GPL licence. - diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am deleted file mode 100644 index 9717343f4..000000000 --- a/doc/ru/Makefile.am +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2003-2009 FlashCode -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 3 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . -# - -LANGCODE = ru -QUICKSTART = weechat_quickstart.$(LANGCODE).txt - -EXTRA_DIST = $(QUICKSTART) - -docdir = $(datadir)/doc/$(PACKAGE) - -# install docs - -install-data-hook: - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ diff --git a/doc/ru/weechat_quickstart.ru.txt b/doc/ru/weechat_quickstart.ru.txt deleted file mode 100644 index 3409d5c6d..000000000 --- a/doc/ru/weechat_quickstart.ru.txt +++ /dev/null @@ -1,110 +0,0 @@ -Краткое руководство пользователя (русская версия) (WeeChat <= 0.2.6) -==================================================================== - -1. Запуск WeeChat - - В зависимости от выбранного интерфейса вы должны запустить: - - weechat-curses для Curses интерфейса - - weechat-gtk для GTK интерфейса (в разработке) - - weechat-qt для Qt интерфейса (не разрабатывается) - - weechat-wxwidgets для WxWidgets интерфейса (не разрабатывается) - -2. Справка / настройки - WeeChat содержит справку по всем командам, просто запустите /help - Для получения справки по команде наберите /help команда - - Для настройки используйте /set параметр = значение - Вы можете использовать /set с частичным названием параметра - (выведет все параметры с указанной фразой) или с полным названием - (для получения подробной справки по параметру) - - Внимание: настройки сохраняются при выходе из WeeChat (или командой - "/save"). НЕ РЕДАКТИРУЙТЕ файл конфигурации когда WeeChat запущен, - т.к. WeeChat может в любой момент перезаписать его. Возможности - перезагрузить файл конфигурации нет. Для изменения любых настроек - воспользуйтесь командой "/set", изменения вступят в силу - незамедлительно. - -3. Создание сервера - - Например, irc.quakenet.org, порт 6667: - /server add quakenet irc.quakenet.org 6667 - (/help server выведет подробную справку) - -4. Настройка сервера - - Ники: - /set quakenet.server_nick1 = "mynick" - /set quakenet.server_nick2 = "mynick2" - /set quakenet.server_nick3 = "mynick3" - - Имя пользователя / реальное имя: - /set quakenet.server_username = "Имя пользователя" - /set quakenet.server_realname = "Реальное имя" - - Автоматическое подключение к серверу: - /set quakenet.server_autoconnect = on - - Автоматический заход на некоторые каналы: - /set quakenet.server_autojoin = "#chan1,#chan2" - - Другие настройки: - Чтобы вывести все настройки сервера наберите /set quakenet - Для настройки наберите /set quakenet.параметр_сервера = значение - -5. Подключение к серверу и автоматический заход на каналы: - - /connect quakenet - -6. Заход/покидание каналов - - Зайти на канал: - /join #канал - Покинуть канал: - /part [прощальное сообщение] - Покинуть канал и закрыть буфер: - /close [прощальное сообщение] - (/close - это сокращение для /buffer close) - -7. Управление буферами/окнами - - Вы можете управлять буферами командой "/buffer" и окнами - командой "/window". - Например, чтобы разбить экран по вертикали на маленькое (треть - экрана) и большое (2/3 экрана) окна наберите: - /window splitv 33 - -8. Привязки клавиш - - Вы можете переназначить любую клавишу в соответствии с вашими - пожеланиями командой "/key". - Полезна привязка meta-k (alt-k) для поиска нужных кодов клавиш. - - Например, чтобы привязать meta-y (alt-y) к команде "/buffer close": - /key (нажмите meta-k) (нажмите meta-y) /buffer close - Вы получите команду: - /key meta-y /buffer close - -9. Plugins/скрипты - - В некоторых дистрибутивах pluginы доступны отдельным пакетом - (например, weechat-plugins). - Pluginы загружаются автоматически. - Для WeeChat доступны многочисленные pluginы и скрипты: - http://weechat.flashtux.org/plugins.php - Процесс загрузки и выгрузки pluginов и скриптов подробно описан в - документации. - -10. Другая документация - - Теперь вы можете пользоваться WeeChat и почитать ЧаВо и документацию - для поиска ответов на оставшиеся вопросы: - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Наслаждайтесь WeeChat! - --- -(c) 2006-05-31, автор - FlashCode -(с) 2006-06-04, переводчик - Stalwart -Этот документ является частью WeeChat и распространяется по лицензии GPL. diff --git a/doc/sco/Makefile.am b/doc/sco/Makefile.am deleted file mode 100644 index 8108fdb6b..000000000 --- a/doc/sco/Makefile.am +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2003-2009 FlashCode -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 3 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . -# - -LANGCODE = sco -QUICKSTART = weechat_quickstart.$(LANGCODE).txt - -EXTRA_DIST = $(QUICKSTART) - -docdir = $(datadir)/doc/$(PACKAGE) - -# install docs - -install-data-hook: - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ diff --git a/doc/sco/weechat_quickstart.sco.txt b/doc/sco/weechat_quickstart.sco.txt deleted file mode 100644 index e744740ee..000000000 --- a/doc/sco/weechat_quickstart.sco.txt +++ /dev/null @@ -1,108 +0,0 @@ -WeeChat quik stairt guide (Scots version, WeeChat <= 0.2.6) -=========================================================== - -1. Launch weechat - - Accordin tae choosed GUI, ye hav tae launch: - - weechat-curses fer Curses GUI - - weechat-gtk fer Gtk GUI (under development) - - weechat-qt fer Qt GUI (no developed) - - weechat-wxwidgets fer WxWidgets GUI (no developed yit) - -2. Online help / options - - WeeChat hus help fer awl commands, jus issu /help - Tae get help on a command, issu /help command - - Tae set options, use eh /set option = value - Ye can use /set option wi partial name (displ't awl options - contain leters), or wi ownly a full option nam wi'oot value - (tae see long help fer option). - - Pure Important: settings are saved when WeeChat ends (or wi eh "/save" - command). Gonnae NO(!) edit eh setup file whyle WeeChat is running, cause WeeChat - may write eh file at 'ne time, and its nae possible tae reload it. - Tae chainge any settins, use "/set" command, WeeChat immediately uses new - settings. - -3. Create a server - - Fer example irc.quakenet.org, port 6667: - /server add quakenet irc.quakenet.org 6667 - (/help server fer ful command help) - -4. Set custom server options - - Nicks: - /set quakenet.server_nick1 = "manick" - /set quakenet.server_nick2 = "manick2" - /set quakenet.server_nick3 = "manick3" - - Username/realname: - /set quakenet.server_username = "Ma username" - /set quakenet.server_realname = "Ma real name" - - Auto-connect tae server: - /set quakenet.server_autoconnect = on - - Auto-join fer sum channels: - /set quakenet.server_autojoin = "#chan1,#chan2" - - Other options: - Ye can see servers options and values wi /set quakenet - Tae set an option, use eh /set quakenet.server_option = value - -5. Connect tae server n auto-join channels: - - /connect quakenet - -6. Join/part channels - - Join a channel: - /join #channel - Part a channel: - /part [quit message] - Part a channel n close buffer: - /close [quit message] - (/close is an alias on /buffer close) - -7. Buffer/window management - - Ye can manage buffers wi "/buffer" command and windows - with "/window" command. - Fer example, tae split verticaly screen intae a wee windea (1/3 width), - n a big yin (2/3), use command: - /window splitv 33 - -8. Key bindings - - According tae yer keyboard and/or ya needs, ye can rebind 'ne key - wi "/key" command. - A useful key is meta-k (alt-k) tae find key codes. - - Fer example, tae bind meta-y (alt-y) tae command "/buffer close": - /key (press meta-k) (press meta-y) /buffer close - - Ye wull huv a command line like: - /key meta-y /buffer close - -9. Plugins/scripts - - On som distros lyke Debian, plugins are available via a separate package - (like weechat-plugins). - Plugins are automatically loadet when found. - Many plugins/scripts are available fer WeeChat, please luk at: - http://weechat.flashtux.org/plugins.php - Please luk at WeeChat documentation tae load/unload plugins or scripts. - -10. Mer documentation - - Yae can noo use WeeChat and read FAQ/documentation fer any oths questins: - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Enjoy WeeChat! - --- -(c) 2006-05-31, written by FlashCode , Translate't by AndrewB -This document is part of WeeChat and is distributed under GPL licence. diff --git a/doc/sv/Makefile.am b/doc/sv/Makefile.am deleted file mode 100644 index dd939473a..000000000 --- a/doc/sv/Makefile.am +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2003-2009 FlashCode -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 3 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program. If not, see . -# - -LANGCODE = sv -QUICKSTART = weechat_quickstart.$(LANGCODE).txt - -EXTRA_DIST = $(QUICKSTART) - -docdir = $(datadir)/doc/$(PACKAGE) - -# install docs - -install-data-hook: - $(INSTALL_DATA) $(QUICKSTART) $(DESTDIR)$(docdir)/ diff --git a/doc/sv/weechat_quickstart.sv.txt b/doc/sv/weechat_quickstart.sv.txt deleted file mode 100644 index cea20c4e2..000000000 --- a/doc/sv/weechat_quickstart.sv.txt +++ /dev/null @@ -1,110 +0,0 @@ -Weechat snabbstart guide (svensk version, WeeChat <= 0.2.6) -=========================================================== - -1. Starta weechat - - Beroende på GUI, måste du starta: - - weechat-curses för Curses GUI - - weechat-gtk för Gtk GUI (under utveckling) - - weechat-qt för Qt GUI (inte utvecklad) - - weechat-wxwidgets för WxWidgets GUI (inte utvecklad) - -2. Online hjälp / inställningar - - WeeChat har hjälp information för alla kommandon, skriv /help - För att få hjälp med ett kommando, skriv /help kommando - - För att ställa in inställningar, använd /set inställning = värde - Du kan använda /set inställning med partial namn (visar alla inställningar - som innehåller bokstäver), eller endast ett inställnings namn utan värde - (för att se hjälp information för inställningen). - - Viktigt: inställningar sparas när WeeChat avslutas (eller med "/save" - kommando). Redigera INTE setup filen medan WeeChat körs, därför att - WeeChat får skriva i denna filen när som helst, och det är inte möjligt - att ladda om den. - För att ändra inställningar, använd "/set" kommandot, WeeChat använder då - direkt de nya inställningarna. - -3. Skapa en server - - Till exempel irc.quakenet.org, port 6667: - /server add quakenet irc.quakenet.org 6667 - (/help server för mer hjälp) - -4. Ställ in server inställningar - - Smeknamn: - /set quakenet.server_nick1 = "mittnick" - /set quakenet.server_nick2 = "mittnick2" - /set quakenet.server_nick3 = "mittnick3" - - Användarnamn/Riktigt namn: - /set quakenet.server_username = "Mitt användarnamn" - /set quakenet.server_realname = "Mitt riktiga namn" - - Automatiskt ansluta till server: - /set quakenet.server_autoconnect = on - - Automatiskt joina en/flera kanaler: - /set quakenet.server_autojoin = "#kanal1,#kanal2" - - Andra inställningar: - Du kan se server inställningar och värden med /set quakenet - För att ställa in en inställning, använd /set quakenet.server_option = värde - -5. Anslut till server och automatiskt gå in i kanaler: - - /connect quakenet - -6. Gå in i/lämna kanaler - - Gå in i en kanal: - /join #kanal - Lämna en kanal: - /part [quit message] - Lämna en kanal och stäng buffert: - /close [quit message] - (/close är ett alias av /buffer close) - -7. Buffert/fönster hantering - - Du kan hantera bufferts med "/buffer" kommandot och fönster - med "/window" kommandot. - Till exempel, för att dela på en vertikal skärm till ett litet fönster (1/3 bredd), - och ett stort (2/3), använd kommandot: - /window splitv 33 - -8. Knapp bindningar - - Efter ditt tangentbord och/eller dina behov, kan du binda om vilken knapp som helst - med "/key" kommandot. - En användbar knapp är meta-k (alt-k) för att hitta knapp koder. - - Till exempel, för att binda meta-y (alt-y) till kommandot "/buffer close": - /key (tryck meta-k) (tryck-meta-y) /buffer close - Du ska nu ha en kommando rad som denna: - /key meta-y /buffer close - -9. Insticksprogram/skripts - - På några distributioner såsom Debian, finns insticksprogram via ett separat paket - (som weechat-plugins). - Insticksprogram laddas automatiskt när de hittats. - Det finns många insticksprogram/skripts till WeeChat, kolla: - http://weechat.flashtux.org/plugins.php - Kolla WeeChats dokumentation för att ladda/(unload) insticksprogram eller skripts. - -10. Mer dokumentation - - Du kan nu använda WeeChat och läsa FAQ/dokumentation för övriga frågor: - http://weechat.flashtux.org/faq.php - http://weechat.flashtux.org/doc.php - - Njut av WeeChat! - --- -(c) 2006-05-31, skrivet av FlashCode - 2008-04-08, Översatt till svenska av Robin Karlsson -Det här dokumentet är en del av WeeChat och är distribuerat under GPL -licens. diff --git a/weechat.spec b/weechat.spec index 2c87ce63b..c97063e8a 100644 --- a/weechat.spec +++ b/weechat.spec @@ -17,7 +17,7 @@ # %define name weechat -%define version 0.2.6 +%define version 0.3.0 %define release 1 Name: %{name} @@ -59,7 +59,10 @@ rm -rf $RPM_BUILD_ROOT %files -f %{name}.lang %defattr(-,root,root,0755) -%doc AUTHORS BUGS ChangeLog COPYING FAQ FAQ.fr INSTALL NEWS README TODO +%doc AUTHORS ChangeLog COPYING INSTALL NEWS README +%doc doc/en/weechat_faq.en.txt doc/fr/weechat_faq.fr.txt +%doc doc/en/weechat_quickstart.en.txt doc/fr/weechat_quickstart.fr.txt +%doc doc/en/weechat_tester.en.txt doc/fr/weechat_tester.fr.txt %{_mandir}/man1/%{name}-curses.1* %{_bindir}/%{name}-curses %{_libdir}/%{name}/plugins/*