From e469f0ef48bbfcff074fa1ffeec196253e8cd55b Mon Sep 17 00:00:00 2001 From: Sebastien Helleu Date: Sun, 23 Nov 2003 13:15:27 +0000 Subject: [PATCH] WeeChat documentation --- doc/Makefile | 33 +++ doc/weechat_doc_en.texi | 495 +++++++++++++++++++++++++++++++ doc/weechat_doc_fr.texi | 496 ++++++++++++++++++++++++++++++++ doc/weechat_doc_pt.texi | 364 +++++++++++++++++++++++ doc/weechat_image.pdf | Bin 0 -> 15499 bytes weechat/doc/Makefile | 33 +++ weechat/doc/weechat_doc_en.texi | 495 +++++++++++++++++++++++++++++++ weechat/doc/weechat_doc_fr.texi | 496 ++++++++++++++++++++++++++++++++ weechat/doc/weechat_doc_pt.texi | 364 +++++++++++++++++++++++ weechat/doc/weechat_image.pdf | Bin 0 -> 15499 bytes 10 files changed, 2776 insertions(+) create mode 100644 doc/Makefile create mode 100644 doc/weechat_doc_en.texi create mode 100644 doc/weechat_doc_fr.texi create mode 100644 doc/weechat_doc_pt.texi create mode 100644 doc/weechat_image.pdf create mode 100644 weechat/doc/Makefile create mode 100644 weechat/doc/weechat_doc_en.texi create mode 100644 weechat/doc/weechat_doc_fr.texi create mode 100644 weechat/doc/weechat_doc_pt.texi create mode 100644 weechat/doc/weechat_image.pdf diff --git a/doc/Makefile b/doc/Makefile new file mode 100644 index 000000000..657e3965f --- /dev/null +++ b/doc/Makefile @@ -0,0 +1,33 @@ +# Copyright (c) 2003 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 2 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, write to the Free Software +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +# + +all: weechat_doc_fr.texi weechat_doc_en.texi weechat_doc_pt.texi + export LANG=fr_FR && makeinfo --html --no-split --number-sections weechat_doc_fr.texi + export LANG=fr_FR && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_fr.texi >weechat_doc_fr.txt + export LANG=en_EN && makeinfo --html --no-split --number-sections weechat_doc_en.texi + export LANG=en_EN && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_en.texi >weechat_doc_en.txt + export LANG=pt_PT && makeinfo --html --no-split --number-sections weechat_doc_pt.texi + export LANG=pt_PT && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_pt.texi >weechat_doc_pt.txt + export LANG=fr_FR && texi2pdf weechat_doc_fr.texi + export LANG=en_EN && texi2pdf weechat_doc_en.texi + export LANG=pt_PT && texi2pdf weechat_doc_pt.texi + +clean: + rm -rf weechat_doc_*.aux weechat_doc_*.cp weechat_doc_*.fn \ + weechat_doc_*.html weechat_doc_*.ky weechat_doc_*.log \ + weechat_doc_*.pdf weechat_doc_*.pg weechat_doc_*.toc \ + weechat_doc_*.tp weechat_doc_*.txt weechat_doc_*.vr diff --git a/doc/weechat_doc_en.texi b/doc/weechat_doc_en.texi new file mode 100644 index 000000000..c2241a00a --- /dev/null +++ b/doc/weechat_doc_en.texi @@ -0,0 +1,495 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_en.info +@settitle WeeChat - fast, light and extensible IRC client +@c %**end of header + +@c WeeChat documentation (english version) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_en.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_en.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage en + +@titlepage + +@title WeeChat - User guide +@subtitle Fast, light and extensible IRC client +@subtitle Documentation for WeeChat v0.0.4 - November, 23 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +This manual documents WeeChat IRC client, it is part of WeeChat.@* +@* +Latest version of this document can be found on this page:@* +@uref{http://weechat.flashtux.org/doc.php?lang=en}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +This document may be used under the terms the GNU General Public License +version 2 or higher. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Page @thispage + +@contents + +@node Top, Introduction, (dir), (dir) +@menu +* Introduction:: What is WeeChat ? +* Installation:: WeeChat installation +* Usage:: WeeChat usage +* Extensions:: WeeChat extensions +* Authors / Support:: Contact authors and get support +@end menu + + +@c ******************************* Introduction ******************************* + +@node Introduction, Installation, Top, Top +@chapter Introduction + +@menu +* Description:: +* Pre-requisites:: +@end menu + +@node Description, Pre-requisites, Introduction, Introduction +@section Description + +WeeChat (Wee Enhanced Environment for Chat) is a free IRC client, fast and light, +designed for many operating systems.@* +@* +Main features are: +@itemize @minus +@item +multi-servers connection +@item +many GUI (Graphical User Interface): Curses, Gtk and Qt +@item +small, fast and light +@item +customizable and extensible with scripts +@item +compliant with RFCs 1459, 2810, 2811, 2812, and 2813 +@item +multi-platform (Gnu/Linux, *BSD, Windows and other) +@item +100% GPL, free software +@end itemize + +@* +WeeChat homepage is here:@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requisites, , Description, Introduction +@section Pre-requisites + +In order to install WeeChat, you @b{need}:@* + +@itemize @bullet +@item +A running Gnu/Linux system (with compiler tools for source package) +@item +"root" privileges (to install WeeChat) +@item +According to GUI, one of the following libraries: +@itemize @minus +@item +Curses: ncurses library, +@item +Gtk: *** GUI not developed ***, +@item +Qt: *** GUI not developed ***, +@end itemize +@end itemize + + +@c ******************************* Installation ******************************* + +@node Installation, Usage, Introduction, Top +@chapter Installation + +@menu +* Binary package:: +* Source package:: +* CVS sources:: +@end menu + +@node Binary package, Source package, Installation, Installation +@section Binary package + +Binary packages are available for these distributions: +@itemize @bullet +@item +Debian (or any Debian compatible distribution)@* +To install: @kbd{dpkg -i /path/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (or any RPM compatible distribution)@* +To install: @kbd{rpm -i /path/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +To install: see Gentoo documentation +@item +*BSD (not available!) +@item +Slackware (not available!) +@item +Windows (not available!) +@end itemize + +where x.y.z is the version (for example 0.0.1) +@* + +@node Source package, CVS sources, Binary package, Installation +@section Source package + +All you have to do is to run in a console or a terminal:@* +@kbd{./configure}@* +@kbd{make}@* +Nota: to build only some interfaces, you can give parameters +to ./configure, type @kbd{./configure --help} for help about options.@* + +Then get root privileges and install WeeChat:@* +@kbd{su -}@* +(enter root password)@* +@kbd{make install}@* + +@node CVS sources, , Source package, Installation +@section CVS sources + +Warning: CVS sources are for advanced users: it may not compile or not be stable. +You're warned!@* + +To get CVS sources, issue these commands:@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(when prompted for a password, just press Enter key)@* + +Execute this script:@* +@kbd{./autogen.sh}@* + +Then follow instructions for source package - @xref{Source package}. + + +@c ********************************** Usage *********************************** + +@node Usage, Extensions, Installation, Top +@chapter Usage + +@menu +* Run WeeChat:: +* Key bindings:: +* WeeChat commands:: +@end menu + +@node Run WeeChat, Key bindings, Usage, Usage +@section Run WeeChat + +@subsection Command line parameters + +@table @code +@item -h, --help +Display help screen@* +@item -l, --license +Display WeeChat license@* +@item -v, --version +Display WeeChat version@* +@end table + +@subsection Run WeeChat + +Just issue this command to run WeeChat:@* +@kbd{weechat}@* +or @kbd{weechat-gtk} (for Gtk front-end)@* +or @kbd{weechat-qt} (for Qt front-end)@* + +When you run WeeChat for the first time, a default configuration file is +created, with default options.@* +The default configuration file is: ~/.weechat/weechat.rc@* + +You can edit this file at your convenience to configure WeeChat, or you can +set parameters with @kbd{/set} command in WeeChat - @xref{WeeChat commands}. + +@node Key bindings, WeeChat commands, Run WeeChat, Usage +@section Key bindings + +@table @kbd +@item Left arrow / Right arrow +Go to previous / next char in command line@* +@* +@item Ctrl + left arrow / Ctrl + right arrow +Go to previous / next word in command line@* +@* +@item Home / End +Go to the beginning / end of command line@* +@* +@item Backspace / Delete +Erase previous / next char of command line@* +@* +@item Ctrl + Backspace +Erase previous word of command line@* +@* +@item Tab +Complete command or nick (@kbd{Tab} again: find next completion)@* +@* +@item Any char +Insert char to cursor position in the command line@* +@* +@item Enter +Execute command or send message@* +@* +@item Up arrow / Down arrow +Call again last commands/messages@* +@* +@item PageUp / PageDown +Show window history@* +@* +@item F6 / F7 +Switch to previous / next window@* +@* +@item Alt + left arrow / Alt + right arrow +Same as F6 / F7@* +@* +@end table + +@node WeeChat commands, , Key bindings, Usage +@section WeeChat commands + +NOT WRITTEN! + + +@c ******************************* Extensions ********************************* + +@node Extensions, Authors / Support, Usage, Top +@chapter Extensions + +@menu +* Perl scripts:: +* Python scripts:: +* Ruby scripts:: +@end menu + +@node Perl scripts, Python scripts, Extensions, Extensions +@section Perl scripts + +@subsection Load/unload Perl scripts + +Perl scripts are loaded and unloaded with @command{/perl} command. +(type @kbd{/help perl} within WeeChat to get help about command).@* + +@itemize @bullet +@item +Perl script loading example:@* +@kbd{/perl load /tmp/sample.pl}@* +@item +Perl script unloading example:@* +@kbd{/perl unload sample}@* +Notice: "sample" is the first parameter of @command{IRC::register} function.@* +@item +List all Perl script loaded:@* +@kbd{/perl}@* +@end itemize + +@subsection WeeChat / Perl API + +@itemize @bullet +@item +@command{IRC::register ( name, version, shutdown_function, description );}@* +@* +This is first function to call in Perl script.@* +All Perl scripts for WeeChat should call this function.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: unique name to identify script (each script must have +unique name) +@item @option{version}: script's version +@item @option{shutdown_function}: Perl function called when script is +unloaded (optional parameter, empty string means nothing is called at the end) +@item @option{description}: short description of script. +@end itemize +@* +@emph{Example:}@* +@code{IRC::register ("sample", "1.0", "sample_end", "Sample script!");}@* + +@item +@command{IRC::print ( message );}@* +@* +Print message in current window (channel or server).@* + +@emph{Arguments:} +@itemize @minus +@item @option{message}: message to display +@end itemize +@* +@emph{Example:}@* +@code{IRC::print ("message");}@* + +@item +@command{IRC::add_message_handler ( name, function );}@* +@* +Attach a Perl function to an IRC message.@* +Function will be called each time IRC message will be received.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: name of IRC message@* +To know list of IRC messages, please refer to RFC 1459 and/or 2812:@* +RFC 1459: @uref{ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt}@* +RFC 2812: @uref{ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt} +@item @option{function}: Perl function called when message is received +@end itemize +@* +@emph{Example:}@* +@code{IRC::add_message_handler ("privmsg", my_function);}@* +@code{sub my_function}@* +@code{@{ }@* +@code{@ @ @ @ ($null, $channel, $message) = split ":",@@_[0],3;}@* +@code{@ @ @ @ ($hostmask, $null, $channel) = split " ", $channel;}@* +@code{@ @ @ @ IRC::print ("host=$hostmask, chan=$channel, msg=$message\n");}@* +@code{@} }@* + +@item +@command{IRC::add_command_handler ( name, function );}@* +@* +Create new WeeChat command, linked with Perl function.@* +Function will be called when user will launch command with @kbd{/name}.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: name of new command@* +This name may be existing command, so that the command is overrided by +Perl function. Be careful when overriding WeeChat commands, they'll not be +available until your Perl script will be unloaded. +@item @option{function}: Perl function linked with command +@end itemize +@* +@emph{Example:}@* +@code{IRC::add_command_handler ("command", my_command);}@* +@code{sub my_command}@* +@code{@{ }@* +@code{@ @ @ @ IRC::print("Arguments: ".@@_[0]);}@* +@code{@ @ @ @ return 0;}@* +@code{@} }@* + +@end itemize + +@node Python scripts, Ruby scripts, Perl scripts, Extensions +@section Python scripts + +Not developed! + +@node Ruby scripts, , Python scripts, Extensions +@section Ruby scripts + +Not developed! + + +@c **************************** Authors / Support ***************************** + +@node Authors / Support, , Extensions, Top +@chapter Authors / Support + +@ifhtml +@menu +* Authors:: +* Get support:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Authors:: +* Get support:: +@end menu +@end ifnothtml + +@node Authors, Get support, Authors / Support, Authors / Support +@section Authors + +WeeChat is developed by:@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Get support, Copyright, Authors, Authors / Support +@end ifhtml +@ifnothtml +@node Get support, , Authors, Authors / Support +@end ifnothtml +@section Get support + +Before asking for support, be sure you've read documentation and FAQ provided +with WeeChat.@* +(documentation is this document, if you don't read all lines until this sentence, +you can start again!)@* + +@itemize @bullet +@item +Support with IRC:@* +- server: @b{irc.freenode.net}@* +- channel: @b{#weechat}@*@* +@item +WeeChat forum: soon!@*@* +@item +Support with mailing list:@* +- to subscribe/unsubscribe:@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- to send mail to all mailing list subscribers, send your mail to@*@email{weechat-support@@nongnu.org}.@* + +Mailing archives are available here:@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Look for WeeChat support page for detail:@* +@uref{http://weechat.flashtux.org/support.php?lang=en} + +@end itemize + +@ifhtml +@node Copyright, , Get support, Authors / Support +@section Copyright + +This manual documents WeeChat IRC client, it is part of WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +This document may be used under the terms the GNU General Public License +version 2 or higher. +@end ifhtml + +@bye diff --git a/doc/weechat_doc_fr.texi b/doc/weechat_doc_fr.texi new file mode 100644 index 000000000..85f0ce587 --- /dev/null +++ b/doc/weechat_doc_fr.texi @@ -0,0 +1,496 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_fr.info +@settitle WeeChat - Client IRC rapide, leger et extensible +@c %**end of header + +@c WeeChat documentation (french version) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_fr.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_fr.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage fr + +@titlepage + +@title WeeChat - Guide utilisateur +@subtitle Client IRC rapide, l@'eger et extensible +@subtitle Documentation pour WeeChat v0.0.4 - 23 novembre 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +Ce manuel documente le client IRC WeeChat, il fait partie de WeeChat.@* +@* +La derni@`ere version de ce document peut @^etre t@'el@'echarg@'ee sur cette page :@* +@uref{http://weechat.flashtux.org/doc.php}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Ce document peut @^etre utilis@'e sous les termes de la licence GNU General Public +License version 2 ou plus. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Page @thispage + +@contents + +@node Top, Introduction, (dir), (dir) +@menu +* Introduction:: Description de WeeChat +* Installation:: Installation de WeeChat +* Utilisation:: Utilisation de WeeChat +* Extensions:: Extensions de WeeChat +* Auteurs / Support:: Contacter les auteurs et obtenir du support +@end menu + + +@c ******************************* Introduction ******************************* + +@node Introduction, Installation, Top, Top +@chapter Introduction +@menu +* Description:: +* Pre-requis:: +@end menu + +@node Description, Pre-requis, Introduction, Introduction +@section Description + +WeeChat (Wee Enhanced Environment for Chat) est un client IRC libre, rapide et l@'eger, +concu pour diff@'erents syst@`emes d'exploitation.@* +@* +Ses principales caract@'eristiques sont les suivantes : +@itemize @minus +@item +connexion multi-serveurs +@item +plusieurs interfaces : Curses, Gtk et Qt +@item +petit, rapide et l@'eger +@item +param@'etrable et extensible avec des scripts +@item +conforme aux RFCs 1459, 2810, 2811, 2812, et 2813 +@item +multi-plateformes (Gnu/Linux, *BSD, Windows et d'autres syst@`emes) +@item +100% GPL, logiciel libre +@end itemize + +@* +La page d'accueil de WeeChat est ici :@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requis, , Description, Introduction +@section Pr@'e-requis + +Pour installer WeeChat, vous @b{devez} avoir :@* + +@itemize @bullet +@item +Un syst@`eme Gnu/Linux (avec le compilateur et les outils associ@'es pour le paquet des sources) +@item +Droits "root" (pour installer WeeChat) +@item +Selon l'interface, une des biblioth@`eques suivantes : +@itemize @minus +@item +Curses: la librairie ncurses, +@item +Gtk: *** interface non d@'evelopp@'ee ***, +@item +Qt: *** interface non d@'evelopp@'ee ***, +@end itemize +@end itemize + + +@c ******************************* Installation ******************************* + +@node Installation, Utilisation, Introduction, Top +@chapter Installation + +@menu +* Paquet binaire:: +* Paquet source:: +* Sources CVS:: +@end menu + +@node Paquet binaire, Paquet source, Installation, Installation +@section Paquet binaire + +Les paquets binaires sont disponibles pour les distributions suivantes : +@itemize @bullet +@item +Debian (ou toute distribution compatible Debian)@* +Pour installer : @kbd{dpkg -i /chemin/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (ou toute distribution compatible avec les RPM)@* +Pour installer : @kbd{rpm -i /chemin/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +Pour installer : voir la documentation Gentoo +@item +*BSD (non disponible !) +@item +Slackware (non disponible !) +@item +Windows (non disponible !) +@end itemize + +o@`u x.y.z est la version (par exemple 0.0.1) +@* + +@node Paquet source, Sources CVS, Paquet binaire, Installation +@section Paquet source + +Tapez simplement dans une console ou un terminal :@* +@kbd{./configure}@* +@kbd{make}@* +Note: pour ne construire que certaines interfaces, vous pouvez passer des param@`etres +@`a ./configure, tapez @kbd{./configure --help} pour de l'aide sur ces options.@* + +Obtenez les droits root et installez WeeChat :@* +@kbd{su -}@* +(entrez le mot de passe de root)@* +@kbd{make install}@* + +@node Sources CVS, , Paquet source, Installation +@section Sources CVS + +Attention: les sources CVS sont r@'eserv@'es aux utilisateurs avanc@'es : il se peut +que WeeChat ne compile pas et qu'il soit tr@`s instable. +Vous @^etes pr@'evenus !@* + +Pour r@'ecup@'erer les sources CVS, tapez ces commandes :@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(lorsqu'un mot de passe est demand@'e, tapez simplement sur Entr@'ee)@* + +Ex@'ecutez ce script :@* +@kbd{./autogen.sh}@* + +Suivez alors les instructions du paquet sources - @xref{Paquet source}. + + +@c ******************************* Utilisation ******************************** + +@node Utilisation, Extensions, Installation, Top +@chapter Utilisation + +@menu +* Lancer WeeChat:: +* Raccourcis clavier:: +* Commandes WeeChat:: +@end menu + +@node Lancer WeeChat, Raccourcis clavier, Utilisation, Utilisation +@section Lancer WeeChat + +@subsection Param@`etres de ligne de commande + +@table @code +@item -h, --help +Afficher l'aide@* +@item -l, --license +Afficher la licence de WeeChat@* +@item -v, --version +Afficher la version de WeeChat@* +@end table + +@subsection Lancer WeeChat + +Tapez simplement cette commande pour lancer WeeChat :@* +@kbd{weechat-curses}@* +ou @kbd{weechat-gtk} (pour l'interface Gtk)@* +ou @kbd{weechat-qt} (pour l'interface Qt)@* + +Lorsque vous lancez WeeChat pour la premi@`ere fois, un fichier de configuration +par d@'efaut est cr@'e@'e, avec les options par d@'efaut.@* +Le fichier de configuration par d@'efaut est : ~/.weechat/weechat.rc@* + +Vous pouvez @'editer ce fichier pour configurer WeeChat @`a votre convenance, ou +vous pouvez modifier les param@`etres dans WeeChat avec la commande @kbd{/set} - @xref{Commandes WeeChat}. + +@node Raccourcis clavier, Commandes WeeChat, Lancer WeeChat, Utilisation +@section Raccourcis clavier + +@table @kbd +@item Fl@`eche gauche / Fl@`eche droite +Aller au caract@`ere pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Ctrl + fl@`eche gauche / Ctrl + fl@`eche droite +Aller au mot pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Home / End +Aller au d@'ebut / @`a la fin de la ligne de commande@* +@* +@item Backspace / Delete +Effacer le mot pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Ctrl + Backspace +Effacer le mot pr@'ec@'edent sur la ligne de commande@* +@* +@item Tab +Compl@'eter la commande ou le pseudo (@kbd{Tab} @`a nouveau : trouver la compl@'etion suivante)@* +@* +@item Tout caract@`ere +Ins@'erer le caract@`ere @`a la position du curseur sur la ligne de commande@* +@* +@item Entr@'ee +Ex@'ecuter la commande ou envoyer le message@* +@* +@item Fl@`eche haut / Fl@`eche bas +Rappeler les derni@`eres commandes/messages@* +@* +@item PageUp / PageDown +Afficher l'historique de la fen@^etre@* +@* +@item F6 / F7 +Aller @`a la fen@^etre pr@'ec@'edente / suivante@* +@* +@item Alt + fl@`eche gauche / Alt + fl@`eche droite +Identique @`a F6 / F7@* +@* +@end table + +@node Commandes WeeChat, , Raccourcis clavier, Utilisation +@section Commandes WeeChat + +NON ECRIT ! + + +@c ******************************* Extensions ********************************* + +@node Extensions, Auteurs / Support, Utilisation, Top +@chapter Extensions + +@menu +* Scripts Perl:: +* Scripts Python:: +* Scripts Ruby:: +@end menu + +@node Scripts Perl, Scripts Python, Extensions, Extensions +@section Scripts Perl + +@subsection Charger/d@'echarger des scripts Perl + +Les scripts Perl sont charg@'es et d@'echarg@'es avec la commande @command{/perl} +(tapez @kbd{/help perl} dans WeeChat pour obtenir de l'aide sur la commande).@* + +@itemize @bullet +@item +Exemple de chargement d'un script Perl :@* +@kbd{/perl load /tmp/essai.pl}@* +@item +Exemple de d@'echargement d'un script Perl :@* +@kbd{/perl unload essai}@* +A noter: le nom "essai" est le premier param@`etre de la fonction @command{IRC::register.}@* +@item +Liste des scripts Perl charg@'es :@* +@kbd{/perl}@* +@end itemize + +@subsection Interface WeeChat / Perl + +@itemize @bullet +@item +@command{IRC::register ( nom, version, fonction_de_fin, description );}@* +@* +C'est la premi@`ere fonction @`a appeler dans le script Perl.@* +Tout script Perl pour WeeChat doit appeler cette fonction.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom unique pour identifier le script (chaque script doit +avoir un nom diff@'erent) +@item @option{version}: version du script +@item @option{fonction_de_fin}: fonction Perl appel@'ee quand le script est +d@'echarg@'e (param@`etre facultatif, une cha@^ine vide signifiant qu'il n'y a pas +de fonction @`a appeler) +@item @option{description}: description br@`eve du script. +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::register ("essai", "1.0", "fin_essai", "Script d'essai !");}@* + +@item +@command{IRC::print ( message );}@* +@* +Affiche un message dans la fen@^etre courante (canal ou serveur).@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{message}: message @`a afficher +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::print ("message");}@* + +@item +@command{IRC::add_message_handler ( nom, fonction );}@* +@* +Attache une fonction Perl @`a un message IRC particulier.@* +La fonction sera appel@'ee @`a chaque fois que le message IRC sera re@,{c}u.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom du message IRC pour lequel la fonction est appel@'ee@* +Pour conna@^itre la liste des messages IRC disponibles, merci de consulter les +RFC 1459 et/ou 2812 :@* +RFC 1459 : @uref{ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt}@* +RFC 2812 : @uref{ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt} +@item @option{fonction}: fonction Perl appel@'ee lorsque le message est re@,{c}u +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::add_message_handler ("privmsg", ma_fonction);}@* +@code{sub ma_fonction}@* +@code{@{ }@* +@code{@ @ @ @ ($null, $canal, $message) = split ":",@@_[0],3;}@* +@code{@ @ @ @ ($masque, $null, $canal) = split " ", $canal;}@* +@code{@ @ @ @ IRC::print ("masque=$masque, canal=$canal, message=$message\n");}@* +@code{@} }@* + +@item +@command{IRC::add_command_handler ( nom, fonction );}@* +@* +Cr@'e@'e une nouvelle commande WeeChat, associ@'ee @`a une fonction Perl.@* +La fonction sera appel@'ee lorsque l'utilisateur lancera la commande par @kbd{/nom}.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom de la nouvelle commande@* +Il peut s'agir d'une commande existante, auquel cas celle-ci est @'ecras@'ee par +la fonction Perl. Soyez prudent en @'ecrasant les commandes WeeChat, car elles +ne seront plus accessibles tant que le script Perl sera charg@'e. +@item @option{fonction}: fonction Perl associ@'ee @`a la commande +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::add_command_handler ("commande", ma_commande);}@* +@code{sub ma_commande}@* +@code{@{ }@* +@code{@ @ @ @ IRC::print("Param@`etres : ".@@_[0]);}@* +@code{@ @ @ @ return 0;}@* +@code{@} }@* + +@end itemize + +@node Scripts Python, Scripts Ruby, Scripts Perl, Extensions +@section Scripts Python + +Non d@'evelopp@'e ! + +@node Scripts Ruby, , Scripts Python, Extensions +@section Scripts Ruby + +Non d@'evelopp@'e ! + +@c **************************** Auteurs / Support ***************************** + +@node Auteurs / Support, , Extensions, Top +@chapter Auteurs / Support + +@ifhtml +@menu +* Auteurs:: +* Obtenir du support:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Auteurs:: +* Obtenir du support:: +@end menu +@end ifnothtml + +@node Auteurs, Obtenir du support, Auteurs / Support, Auteurs / Support +@section Auteurs + +WeeChat est d@'evelopp@'e par :@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Obtenir du support, Copyright, Auteurs, Auteurs / Support +@end ifhtml +@ifnothtml +@node Obtenir du support, , Auteurs, Auteurs / Support +@end ifnothtml +@section Obtenir du support + +Avant de faire appel au support, merci de lire la documentation et la +FAQ de WeeChat.@* +(la documentation est le document que vous @^etes en train de lire, si vous +n'avez pas tout lu jusqu'ici, il est encore temps de recommencer !)@* + +@itemize @bullet +@item +Support par IRC:@* +- serveur : @b{irc.freenode.net}@* +- canal : @b{#weechat}@*@* +@item +Forum WeeChat : bient@^ot !@*@* +@item +Support par la liste de diffusion :@* +- pour souscrire/d@'esinscrire :@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- pour envoyer un mail @`a la liste de diffusion, envoyer @`a :@*@email{weechat-support@@nongnu.org}.@* + +Les archives de la liste de diffusion sont ici :@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Voir la page support WeeChat pour plus de d@'etails :@* +@uref{http://weechat.flashtux.org/support.php} + +@end itemize + +@ifhtml +@node Copyright, , Obtenir du support, Auteurs / Support +@section Copyright + +Ce manuel documente le client IRC WeeChat, il fait partie de WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Ce document peut @^etre utilis@'e sous les termes de la licence GNU General Public +License version 2 ou plus. +@end ifhtml + +@bye diff --git a/doc/weechat_doc_pt.texi b/doc/weechat_doc_pt.texi new file mode 100644 index 000000000..198da130c --- /dev/null +++ b/doc/weechat_doc_pt.texi @@ -0,0 +1,364 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_pt.info +@settitle WeeChat - Um cliente de IRC r@'apido, leve e extenc@'ivel +@c %**end of header + +@c WeeChat documentation (vers@~ao partuguesa) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_pt.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_pt.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage pt + +@titlepage + +@title WeeChat - Guia do Utilizador +@subtitle Cliente de IRC rapido, leve e extenc@'ivel +@subtitle Documenta@,{c}@~ao do WeeChat v0.0.3 - 26 de Outubro de 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +Este manual documenta o cliente de IRC WeeChat, ele faz parte do WeeChat.@* +@* +A ultima versão deste documento pode ser descarregada de :@* +@uref{http://weechat.flashtux.org/doc.php}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Este documento pode ser utilizado sobre os termos da Licença P@'ublica geral GNU (GNU General Public +License) vers@~ao 2 ou superior. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Pagina @thispage + +@contents + +@node Top, Introduç@~ao, (dir), (dir) +@menu +* Introduç@~ao:: Descriç@~ao do WeeChat +* Instalaç@~ao:: Instalaç@~ao do WeeChat +* Utilizaç@~ao:: Utilizaç@~ao do WeeChat +* Autores / Suporte:: Contactar os autores e obter suporte +@end menu + + +@c ******************************* Introduç@~ao ******************************* + +@node Introduç@~ao, Instalaç@~ao, Top, Top +@chapter Introduç@~ao +@menu +* Descriç@~ao:: +* Pre-requisitos:: +@end menu + +@node Descriç@~ao, Pre-requisitos, Introduç@~ao, Introduç@~ao +@section Descriç@~ao + +O WeeChat (Wee Enhanced Environment for Chat) @'e um cliente de IRC livre, r@'apido e leve, +concebido para funcionar em diversos sistemas operativos.@* +@* +As suas caracter@'isticas prinicpais s@~ao as seguintes : +@itemize @minus +@item +liga@,{c}@~ao a m@'ultiplos servidores +@item +v@'arias interfaces : Curses, Gtk e Qt +@item +pequeno r@'apido e leve +@item +configuravel e extenc@'ivel com scripts +@item +compat@'ivel com RFCs 1459, 2810, 2811, 2812, e 2813 +@item +multiplataforma (Gnu/Linux, *BSD, Windows e outros) +@item +100% GPL, Software Livre +@end itemize + +@* +A p@'agina Web do Weechat @'e aqui :@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requisitos, ,Descriç@~ao, Introduç@~ao +@section Pr@'e-requisitos + +Para instalar o Weechat, vais @b{precisar} de ter :@* + +@itemize @bullet +@item +Um sistema Gnu/Linux (com um compilador e outros utilit@'arios associados aos pacotes de c@'odigo fonte) +@item +Direitos de "root" (para instalar) +@item +Consoante a interface escolhida, uma das seguintes bibliotecas : +@itemize @minus +@item +Curses: a biblioteca ncurses, +@item +Gtk: *** interface n@~ao desenvolvida ***, +@item +Qt: *** interface n@~ao desenvolvida ***, +@end itemize +@end itemize + + +@c ******************************* Instalaç@~ao ******************************* + +@node Instalaç@~ao, Utilizaç@~ao, Introduç@~ao, Top +@chapter Instalaç@~ao +@menu +* Binarios:: +* Codigo Fonte:: +* Codigo Fonte via CVS:: +@end menu + +@node Binarios, Codigo Fonte, Instalaç@~ao, Instalaç@~ao +@section Bin@'arios + +Os pacotes bin@'arios est@'ao dispon@'iveis para as seguintes distribui@,{c}@~oes : +@itemize @bullet +@item +Debian (ou compat@'ivel)@* +Instala@,{c}@~ao : @kbd{dpkg -i /chemin/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (ou outra distro compat@'ivel com RPMs)@* +Instala@,{c}@~ao : @kbd{rpm -i /chemin/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +Instala@,{c}@~ao : ver a documenta@,{c}@~ao da Gentoo +@item +*BSD (non disponible !) +@item +Slackware (n@~ao dispon@'ivel !) +@item +Windows (n@~ao dispon@'ivel !) +@end itemize + +Onde x.y.z @'e a vers@~ao (por exemplo 0.0.1) +@* + +@node Codigo Fonte, Codigo Fonte via CVS, Binarios, Instalaç@~ao +@section C@'odigo Fonte + +Escreve simplesmente numa consola ou num terminal :@* +@kbd{./configure}@* +@kbd{make}@* +Nota: Para compilar certas interfaces, podes passar par@^ametros +ao ./configure, escreve @kbd{./configure --help} para veres as op@,{c}@~oes.@* + +Obter os direitos do root e instalar o Weechat :@* +@kbd{su -}@* +(escreve aqui a palavra-passe do superutilizador)@* +@kbd{make install}@* + +@node Codigo Fonte via CVS, , Codigo Fonte, Instalaç@~ao +@section C@'odigo Fonte via CVS + +Aten@,{c}@~ao: o c@'odigo fonte CVS est@'a reservado aos utilizadores avan@,{c}ados : o WeeChat pode n@~ao compilar ou ficar inst@'avel.@* +Considera-te avisado !@* + +Para sacares o c@'odigo fonte via CVS, escreve estes comandos :@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(quando te pedirem a palavra-passe, primen simplesmente Enter)@* + +Executa o script :@* +@kbd{./autogen.sh}@* + +Segue agora as instru@,{c}@~oes para compilar o c@'odigo fonte - @xref{Codigo Fonte}. + + +@c ******************************* Utilizaç@~ao ******************************** + +@node Utilizaç@~ao, Autores / Suporte, Instalaç@~ao, Top +@chapter Utilizaç@~ao + +@menu +* Invocar o WeeChat:: +* Recursos de teclado:: +* Comandos do WeeChat:: +@end menu + +@node Invocar o WeeChat, Recursos de teclado, Utilizaç@~ao, Utilizaç@~ao +@section Invocar o WeeChat + +@subsection Par@^ametros de linha de comandos + +@table @code +@item -h, --help +Mostrar a ajuda@* +@item -l, --license +Mostrar a licen@,{c}a do WeeChat@* +@item -v, --version +Mostrar a vers@~ao do WeeChat@* +@end table + +@subsection Invocar o WeeChat + +Escreve simplesmente este comando para invoceres o WeeChat :@* +@kbd{weechat-curses}@* +ou @kbd{weechat-gtk} (para a interface em Gtk)@* +ou @kbd{weechat-qt} (para a interface em Qt)@* + +Logo que lan@,{c}ares o WeeChat pela primeira vez, um ficheiro de configura@,{c}@~ao +por defeito @'e criado, com as configura@,{c}@~oes por defeito.@* +O ficheiro de configura@,{c}@~ao por defeito @'e : ~/.weechat/weechat.rc@* + +Podes editar esse ficheiro para configurar o WeeChat @`a tua maneira, man tamb@'em podes modificar os par@^ametros dentro do WeeChat utilizando o comando @kbd{/set} - @xref{Comandos do WeeChat}. + +@node Recursos de teclado, Comandos do WeeChat, Invocar o WeeChat, Utilizaç@~ao +@section Recursos de teclado + +@table @kbd +@item Seta esquerda / Seta direita +Ir um caractere para traz / para a frente na linha de comando@* +@* +@item Ctrl + Seta esquerda / Ctrl + Seta Direita +Ir uma palavra para traz / para a frente na linha de comando@* +@* +@item Home / End +Ir para o in@'icio / para o fim da linha de comando@* +@* +@item Backspace / Delete +Apagar o caractere anterior / seguinte na linha de comando@* +@* +@item Ctrl + Backspace +Apagar a palavra anterior na linha de comando +@* +@item Tab +Completar o comando ou o nick (@kbd{Tab} novamente : encontrar a pr@'oxima sugest@~ao)@* +@* +@item Qualquer caractere +Inserir o caractere na linha de comando, no s@'itio do cursor@* +@* +@item Enter +Executa o comando ou envia a mensagem@* +@* +@item Seta para cima / Seta para baixo +Repetir os ultimos comandos/mensagens@* +@* +@item PageUp / PageDown +Navegar no hist@'orico da janela@* +@* +@item F6 / F7 +Ir para a janela anterior/seguinte@* +@* +@item Alt + Seta da esquerda / Alt + Seta da direita +Identico a F6 / F7@* +@* +@end table + +@node Comandos do WeeChat, , Recursos de teclado, Utilizaç@~ao +@section Comandos do WeeChat + +N@~AO ESCRITO ! + + +@c **************************** Autores / Suporte ***************************** + +@node Autores / Suporte, , Utilizaç@~ao, Top +@chapter Autores / Suporte + +@ifhtml +@menu +* Autores:: +* Obter Suporte:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Autores:: +* Obter Suporte:: +@end menu +@end ifnothtml + +@node Autores, Obter Suporte, Autores / Suporte, Autores / Suporte +@section Autores + +O WeeChat @'e desenvolvido por :@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Obter Suporte, Copyright, Autores, Autores / Suporte +@end ifhtml +@ifnothtml +@node Obter Suporte, , Autores, Autores / Suporte +@end ifnothtml +@section Obter Suporte + +Antes de pedires suporte, agradecemos se leres toda a documenta@,{c}@~ao e a FAQ.@* +(a documenta@,{c}@~ao @'e este documento que est@'as a ler, se n@~ao leste tudo at@'e aqui, est@'a na hora de come@,{c}ares do in@'icio !)@* + +@itemize @bullet +@item +Suporte por IRC:@* +- servidor : @b{irc.freenode.net}@* +- canal : @b{#weechat}@*@* +@item +Forum do WeeChat : mais tarde !@*@* +@item +Suporte por lista de correio-e :@* +- para te inscreveres/desinscreveres :@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- para enviares uma mensagem para a lista :@*@email{weechat-support@@nongnu.org}.@* + +Os arquivos da lista est@~ao aqui :@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Para mais detalhes, v@^e tamb@'em a p@'agina de suporte do WeeChat :@* +@uref{http://weechat.flashtux.org/support.php} + +@end itemize + +@ifhtml +@node Copyright, , Obter Suporte, Autores / Suporte +@section Copyright + +Este manual documenta o cliente de IRC WeeChat, Ele faz parte do WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +Tradu@,{c}@~ao portuguesa de Jo@~ao Jer@'onimo <@email{j_j_b_o@@sapo.pt, j_j_b_o AT sapo.pt}>@* +@* +A utiliza@,{c}@~ao deste documento @'e regida pela GNU General Public +License vers@~ao 2 ou posterior.@* + +@end ifhtml + +@bye diff --git a/doc/weechat_image.pdf b/doc/weechat_image.pdf new file mode 100644 index 0000000000000000000000000000000000000000..16ca5c6b2d00e0c4bedf911263d2dcf6a773a503 GIT binary patch literal 15499 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 +# +# 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 2 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, write to the Free Software +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +# + +all: weechat_doc_fr.texi weechat_doc_en.texi weechat_doc_pt.texi + export LANG=fr_FR && makeinfo --html --no-split --number-sections weechat_doc_fr.texi + export LANG=fr_FR && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_fr.texi >weechat_doc_fr.txt + export LANG=en_EN && makeinfo --html --no-split --number-sections weechat_doc_en.texi + export LANG=en_EN && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_en.texi >weechat_doc_en.txt + export LANG=pt_PT && makeinfo --html --no-split --number-sections weechat_doc_pt.texi + export LANG=pt_PT && makeinfo --no-headers --no-warn --no-split --number-sections weechat_doc_pt.texi >weechat_doc_pt.txt + export LANG=fr_FR && texi2pdf weechat_doc_fr.texi + export LANG=en_EN && texi2pdf weechat_doc_en.texi + export LANG=pt_PT && texi2pdf weechat_doc_pt.texi + +clean: + rm -rf weechat_doc_*.aux weechat_doc_*.cp weechat_doc_*.fn \ + weechat_doc_*.html weechat_doc_*.ky weechat_doc_*.log \ + weechat_doc_*.pdf weechat_doc_*.pg weechat_doc_*.toc \ + weechat_doc_*.tp weechat_doc_*.txt weechat_doc_*.vr diff --git a/weechat/doc/weechat_doc_en.texi b/weechat/doc/weechat_doc_en.texi new file mode 100644 index 000000000..c2241a00a --- /dev/null +++ b/weechat/doc/weechat_doc_en.texi @@ -0,0 +1,495 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_en.info +@settitle WeeChat - fast, light and extensible IRC client +@c %**end of header + +@c WeeChat documentation (english version) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_en.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_en.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage en + +@titlepage + +@title WeeChat - User guide +@subtitle Fast, light and extensible IRC client +@subtitle Documentation for WeeChat v0.0.4 - November, 23 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +This manual documents WeeChat IRC client, it is part of WeeChat.@* +@* +Latest version of this document can be found on this page:@* +@uref{http://weechat.flashtux.org/doc.php?lang=en}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +This document may be used under the terms the GNU General Public License +version 2 or higher. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Page @thispage + +@contents + +@node Top, Introduction, (dir), (dir) +@menu +* Introduction:: What is WeeChat ? +* Installation:: WeeChat installation +* Usage:: WeeChat usage +* Extensions:: WeeChat extensions +* Authors / Support:: Contact authors and get support +@end menu + + +@c ******************************* Introduction ******************************* + +@node Introduction, Installation, Top, Top +@chapter Introduction + +@menu +* Description:: +* Pre-requisites:: +@end menu + +@node Description, Pre-requisites, Introduction, Introduction +@section Description + +WeeChat (Wee Enhanced Environment for Chat) is a free IRC client, fast and light, +designed for many operating systems.@* +@* +Main features are: +@itemize @minus +@item +multi-servers connection +@item +many GUI (Graphical User Interface): Curses, Gtk and Qt +@item +small, fast and light +@item +customizable and extensible with scripts +@item +compliant with RFCs 1459, 2810, 2811, 2812, and 2813 +@item +multi-platform (Gnu/Linux, *BSD, Windows and other) +@item +100% GPL, free software +@end itemize + +@* +WeeChat homepage is here:@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requisites, , Description, Introduction +@section Pre-requisites + +In order to install WeeChat, you @b{need}:@* + +@itemize @bullet +@item +A running Gnu/Linux system (with compiler tools for source package) +@item +"root" privileges (to install WeeChat) +@item +According to GUI, one of the following libraries: +@itemize @minus +@item +Curses: ncurses library, +@item +Gtk: *** GUI not developed ***, +@item +Qt: *** GUI not developed ***, +@end itemize +@end itemize + + +@c ******************************* Installation ******************************* + +@node Installation, Usage, Introduction, Top +@chapter Installation + +@menu +* Binary package:: +* Source package:: +* CVS sources:: +@end menu + +@node Binary package, Source package, Installation, Installation +@section Binary package + +Binary packages are available for these distributions: +@itemize @bullet +@item +Debian (or any Debian compatible distribution)@* +To install: @kbd{dpkg -i /path/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (or any RPM compatible distribution)@* +To install: @kbd{rpm -i /path/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +To install: see Gentoo documentation +@item +*BSD (not available!) +@item +Slackware (not available!) +@item +Windows (not available!) +@end itemize + +where x.y.z is the version (for example 0.0.1) +@* + +@node Source package, CVS sources, Binary package, Installation +@section Source package + +All you have to do is to run in a console or a terminal:@* +@kbd{./configure}@* +@kbd{make}@* +Nota: to build only some interfaces, you can give parameters +to ./configure, type @kbd{./configure --help} for help about options.@* + +Then get root privileges and install WeeChat:@* +@kbd{su -}@* +(enter root password)@* +@kbd{make install}@* + +@node CVS sources, , Source package, Installation +@section CVS sources + +Warning: CVS sources are for advanced users: it may not compile or not be stable. +You're warned!@* + +To get CVS sources, issue these commands:@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(when prompted for a password, just press Enter key)@* + +Execute this script:@* +@kbd{./autogen.sh}@* + +Then follow instructions for source package - @xref{Source package}. + + +@c ********************************** Usage *********************************** + +@node Usage, Extensions, Installation, Top +@chapter Usage + +@menu +* Run WeeChat:: +* Key bindings:: +* WeeChat commands:: +@end menu + +@node Run WeeChat, Key bindings, Usage, Usage +@section Run WeeChat + +@subsection Command line parameters + +@table @code +@item -h, --help +Display help screen@* +@item -l, --license +Display WeeChat license@* +@item -v, --version +Display WeeChat version@* +@end table + +@subsection Run WeeChat + +Just issue this command to run WeeChat:@* +@kbd{weechat}@* +or @kbd{weechat-gtk} (for Gtk front-end)@* +or @kbd{weechat-qt} (for Qt front-end)@* + +When you run WeeChat for the first time, a default configuration file is +created, with default options.@* +The default configuration file is: ~/.weechat/weechat.rc@* + +You can edit this file at your convenience to configure WeeChat, or you can +set parameters with @kbd{/set} command in WeeChat - @xref{WeeChat commands}. + +@node Key bindings, WeeChat commands, Run WeeChat, Usage +@section Key bindings + +@table @kbd +@item Left arrow / Right arrow +Go to previous / next char in command line@* +@* +@item Ctrl + left arrow / Ctrl + right arrow +Go to previous / next word in command line@* +@* +@item Home / End +Go to the beginning / end of command line@* +@* +@item Backspace / Delete +Erase previous / next char of command line@* +@* +@item Ctrl + Backspace +Erase previous word of command line@* +@* +@item Tab +Complete command or nick (@kbd{Tab} again: find next completion)@* +@* +@item Any char +Insert char to cursor position in the command line@* +@* +@item Enter +Execute command or send message@* +@* +@item Up arrow / Down arrow +Call again last commands/messages@* +@* +@item PageUp / PageDown +Show window history@* +@* +@item F6 / F7 +Switch to previous / next window@* +@* +@item Alt + left arrow / Alt + right arrow +Same as F6 / F7@* +@* +@end table + +@node WeeChat commands, , Key bindings, Usage +@section WeeChat commands + +NOT WRITTEN! + + +@c ******************************* Extensions ********************************* + +@node Extensions, Authors / Support, Usage, Top +@chapter Extensions + +@menu +* Perl scripts:: +* Python scripts:: +* Ruby scripts:: +@end menu + +@node Perl scripts, Python scripts, Extensions, Extensions +@section Perl scripts + +@subsection Load/unload Perl scripts + +Perl scripts are loaded and unloaded with @command{/perl} command. +(type @kbd{/help perl} within WeeChat to get help about command).@* + +@itemize @bullet +@item +Perl script loading example:@* +@kbd{/perl load /tmp/sample.pl}@* +@item +Perl script unloading example:@* +@kbd{/perl unload sample}@* +Notice: "sample" is the first parameter of @command{IRC::register} function.@* +@item +List all Perl script loaded:@* +@kbd{/perl}@* +@end itemize + +@subsection WeeChat / Perl API + +@itemize @bullet +@item +@command{IRC::register ( name, version, shutdown_function, description );}@* +@* +This is first function to call in Perl script.@* +All Perl scripts for WeeChat should call this function.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: unique name to identify script (each script must have +unique name) +@item @option{version}: script's version +@item @option{shutdown_function}: Perl function called when script is +unloaded (optional parameter, empty string means nothing is called at the end) +@item @option{description}: short description of script. +@end itemize +@* +@emph{Example:}@* +@code{IRC::register ("sample", "1.0", "sample_end", "Sample script!");}@* + +@item +@command{IRC::print ( message );}@* +@* +Print message in current window (channel or server).@* + +@emph{Arguments:} +@itemize @minus +@item @option{message}: message to display +@end itemize +@* +@emph{Example:}@* +@code{IRC::print ("message");}@* + +@item +@command{IRC::add_message_handler ( name, function );}@* +@* +Attach a Perl function to an IRC message.@* +Function will be called each time IRC message will be received.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: name of IRC message@* +To know list of IRC messages, please refer to RFC 1459 and/or 2812:@* +RFC 1459: @uref{ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt}@* +RFC 2812: @uref{ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt} +@item @option{function}: Perl function called when message is received +@end itemize +@* +@emph{Example:}@* +@code{IRC::add_message_handler ("privmsg", my_function);}@* +@code{sub my_function}@* +@code{@{ }@* +@code{@ @ @ @ ($null, $channel, $message) = split ":",@@_[0],3;}@* +@code{@ @ @ @ ($hostmask, $null, $channel) = split " ", $channel;}@* +@code{@ @ @ @ IRC::print ("host=$hostmask, chan=$channel, msg=$message\n");}@* +@code{@} }@* + +@item +@command{IRC::add_command_handler ( name, function );}@* +@* +Create new WeeChat command, linked with Perl function.@* +Function will be called when user will launch command with @kbd{/name}.@* + +@emph{Arguments:} +@itemize @minus +@item @option{name}: name of new command@* +This name may be existing command, so that the command is overrided by +Perl function. Be careful when overriding WeeChat commands, they'll not be +available until your Perl script will be unloaded. +@item @option{function}: Perl function linked with command +@end itemize +@* +@emph{Example:}@* +@code{IRC::add_command_handler ("command", my_command);}@* +@code{sub my_command}@* +@code{@{ }@* +@code{@ @ @ @ IRC::print("Arguments: ".@@_[0]);}@* +@code{@ @ @ @ return 0;}@* +@code{@} }@* + +@end itemize + +@node Python scripts, Ruby scripts, Perl scripts, Extensions +@section Python scripts + +Not developed! + +@node Ruby scripts, , Python scripts, Extensions +@section Ruby scripts + +Not developed! + + +@c **************************** Authors / Support ***************************** + +@node Authors / Support, , Extensions, Top +@chapter Authors / Support + +@ifhtml +@menu +* Authors:: +* Get support:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Authors:: +* Get support:: +@end menu +@end ifnothtml + +@node Authors, Get support, Authors / Support, Authors / Support +@section Authors + +WeeChat is developed by:@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Get support, Copyright, Authors, Authors / Support +@end ifhtml +@ifnothtml +@node Get support, , Authors, Authors / Support +@end ifnothtml +@section Get support + +Before asking for support, be sure you've read documentation and FAQ provided +with WeeChat.@* +(documentation is this document, if you don't read all lines until this sentence, +you can start again!)@* + +@itemize @bullet +@item +Support with IRC:@* +- server: @b{irc.freenode.net}@* +- channel: @b{#weechat}@*@* +@item +WeeChat forum: soon!@*@* +@item +Support with mailing list:@* +- to subscribe/unsubscribe:@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- to send mail to all mailing list subscribers, send your mail to@*@email{weechat-support@@nongnu.org}.@* + +Mailing archives are available here:@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Look for WeeChat support page for detail:@* +@uref{http://weechat.flashtux.org/support.php?lang=en} + +@end itemize + +@ifhtml +@node Copyright, , Get support, Authors / Support +@section Copyright + +This manual documents WeeChat IRC client, it is part of WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +This document may be used under the terms the GNU General Public License +version 2 or higher. +@end ifhtml + +@bye diff --git a/weechat/doc/weechat_doc_fr.texi b/weechat/doc/weechat_doc_fr.texi new file mode 100644 index 000000000..85f0ce587 --- /dev/null +++ b/weechat/doc/weechat_doc_fr.texi @@ -0,0 +1,496 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_fr.info +@settitle WeeChat - Client IRC rapide, leger et extensible +@c %**end of header + +@c WeeChat documentation (french version) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_fr.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_fr.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage fr + +@titlepage + +@title WeeChat - Guide utilisateur +@subtitle Client IRC rapide, l@'eger et extensible +@subtitle Documentation pour WeeChat v0.0.4 - 23 novembre 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +Ce manuel documente le client IRC WeeChat, il fait partie de WeeChat.@* +@* +La derni@`ere version de ce document peut @^etre t@'el@'echarg@'ee sur cette page :@* +@uref{http://weechat.flashtux.org/doc.php}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Ce document peut @^etre utilis@'e sous les termes de la licence GNU General Public +License version 2 ou plus. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Page @thispage + +@contents + +@node Top, Introduction, (dir), (dir) +@menu +* Introduction:: Description de WeeChat +* Installation:: Installation de WeeChat +* Utilisation:: Utilisation de WeeChat +* Extensions:: Extensions de WeeChat +* Auteurs / Support:: Contacter les auteurs et obtenir du support +@end menu + + +@c ******************************* Introduction ******************************* + +@node Introduction, Installation, Top, Top +@chapter Introduction +@menu +* Description:: +* Pre-requis:: +@end menu + +@node Description, Pre-requis, Introduction, Introduction +@section Description + +WeeChat (Wee Enhanced Environment for Chat) est un client IRC libre, rapide et l@'eger, +concu pour diff@'erents syst@`emes d'exploitation.@* +@* +Ses principales caract@'eristiques sont les suivantes : +@itemize @minus +@item +connexion multi-serveurs +@item +plusieurs interfaces : Curses, Gtk et Qt +@item +petit, rapide et l@'eger +@item +param@'etrable et extensible avec des scripts +@item +conforme aux RFCs 1459, 2810, 2811, 2812, et 2813 +@item +multi-plateformes (Gnu/Linux, *BSD, Windows et d'autres syst@`emes) +@item +100% GPL, logiciel libre +@end itemize + +@* +La page d'accueil de WeeChat est ici :@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requis, , Description, Introduction +@section Pr@'e-requis + +Pour installer WeeChat, vous @b{devez} avoir :@* + +@itemize @bullet +@item +Un syst@`eme Gnu/Linux (avec le compilateur et les outils associ@'es pour le paquet des sources) +@item +Droits "root" (pour installer WeeChat) +@item +Selon l'interface, une des biblioth@`eques suivantes : +@itemize @minus +@item +Curses: la librairie ncurses, +@item +Gtk: *** interface non d@'evelopp@'ee ***, +@item +Qt: *** interface non d@'evelopp@'ee ***, +@end itemize +@end itemize + + +@c ******************************* Installation ******************************* + +@node Installation, Utilisation, Introduction, Top +@chapter Installation + +@menu +* Paquet binaire:: +* Paquet source:: +* Sources CVS:: +@end menu + +@node Paquet binaire, Paquet source, Installation, Installation +@section Paquet binaire + +Les paquets binaires sont disponibles pour les distributions suivantes : +@itemize @bullet +@item +Debian (ou toute distribution compatible Debian)@* +Pour installer : @kbd{dpkg -i /chemin/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (ou toute distribution compatible avec les RPM)@* +Pour installer : @kbd{rpm -i /chemin/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +Pour installer : voir la documentation Gentoo +@item +*BSD (non disponible !) +@item +Slackware (non disponible !) +@item +Windows (non disponible !) +@end itemize + +o@`u x.y.z est la version (par exemple 0.0.1) +@* + +@node Paquet source, Sources CVS, Paquet binaire, Installation +@section Paquet source + +Tapez simplement dans une console ou un terminal :@* +@kbd{./configure}@* +@kbd{make}@* +Note: pour ne construire que certaines interfaces, vous pouvez passer des param@`etres +@`a ./configure, tapez @kbd{./configure --help} pour de l'aide sur ces options.@* + +Obtenez les droits root et installez WeeChat :@* +@kbd{su -}@* +(entrez le mot de passe de root)@* +@kbd{make install}@* + +@node Sources CVS, , Paquet source, Installation +@section Sources CVS + +Attention: les sources CVS sont r@'eserv@'es aux utilisateurs avanc@'es : il se peut +que WeeChat ne compile pas et qu'il soit tr@`s instable. +Vous @^etes pr@'evenus !@* + +Pour r@'ecup@'erer les sources CVS, tapez ces commandes :@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(lorsqu'un mot de passe est demand@'e, tapez simplement sur Entr@'ee)@* + +Ex@'ecutez ce script :@* +@kbd{./autogen.sh}@* + +Suivez alors les instructions du paquet sources - @xref{Paquet source}. + + +@c ******************************* Utilisation ******************************** + +@node Utilisation, Extensions, Installation, Top +@chapter Utilisation + +@menu +* Lancer WeeChat:: +* Raccourcis clavier:: +* Commandes WeeChat:: +@end menu + +@node Lancer WeeChat, Raccourcis clavier, Utilisation, Utilisation +@section Lancer WeeChat + +@subsection Param@`etres de ligne de commande + +@table @code +@item -h, --help +Afficher l'aide@* +@item -l, --license +Afficher la licence de WeeChat@* +@item -v, --version +Afficher la version de WeeChat@* +@end table + +@subsection Lancer WeeChat + +Tapez simplement cette commande pour lancer WeeChat :@* +@kbd{weechat-curses}@* +ou @kbd{weechat-gtk} (pour l'interface Gtk)@* +ou @kbd{weechat-qt} (pour l'interface Qt)@* + +Lorsque vous lancez WeeChat pour la premi@`ere fois, un fichier de configuration +par d@'efaut est cr@'e@'e, avec les options par d@'efaut.@* +Le fichier de configuration par d@'efaut est : ~/.weechat/weechat.rc@* + +Vous pouvez @'editer ce fichier pour configurer WeeChat @`a votre convenance, ou +vous pouvez modifier les param@`etres dans WeeChat avec la commande @kbd{/set} - @xref{Commandes WeeChat}. + +@node Raccourcis clavier, Commandes WeeChat, Lancer WeeChat, Utilisation +@section Raccourcis clavier + +@table @kbd +@item Fl@`eche gauche / Fl@`eche droite +Aller au caract@`ere pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Ctrl + fl@`eche gauche / Ctrl + fl@`eche droite +Aller au mot pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Home / End +Aller au d@'ebut / @`a la fin de la ligne de commande@* +@* +@item Backspace / Delete +Effacer le mot pr@'ec@'edent / suivant sur la ligne de commande@* +@* +@item Ctrl + Backspace +Effacer le mot pr@'ec@'edent sur la ligne de commande@* +@* +@item Tab +Compl@'eter la commande ou le pseudo (@kbd{Tab} @`a nouveau : trouver la compl@'etion suivante)@* +@* +@item Tout caract@`ere +Ins@'erer le caract@`ere @`a la position du curseur sur la ligne de commande@* +@* +@item Entr@'ee +Ex@'ecuter la commande ou envoyer le message@* +@* +@item Fl@`eche haut / Fl@`eche bas +Rappeler les derni@`eres commandes/messages@* +@* +@item PageUp / PageDown +Afficher l'historique de la fen@^etre@* +@* +@item F6 / F7 +Aller @`a la fen@^etre pr@'ec@'edente / suivante@* +@* +@item Alt + fl@`eche gauche / Alt + fl@`eche droite +Identique @`a F6 / F7@* +@* +@end table + +@node Commandes WeeChat, , Raccourcis clavier, Utilisation +@section Commandes WeeChat + +NON ECRIT ! + + +@c ******************************* Extensions ********************************* + +@node Extensions, Auteurs / Support, Utilisation, Top +@chapter Extensions + +@menu +* Scripts Perl:: +* Scripts Python:: +* Scripts Ruby:: +@end menu + +@node Scripts Perl, Scripts Python, Extensions, Extensions +@section Scripts Perl + +@subsection Charger/d@'echarger des scripts Perl + +Les scripts Perl sont charg@'es et d@'echarg@'es avec la commande @command{/perl} +(tapez @kbd{/help perl} dans WeeChat pour obtenir de l'aide sur la commande).@* + +@itemize @bullet +@item +Exemple de chargement d'un script Perl :@* +@kbd{/perl load /tmp/essai.pl}@* +@item +Exemple de d@'echargement d'un script Perl :@* +@kbd{/perl unload essai}@* +A noter: le nom "essai" est le premier param@`etre de la fonction @command{IRC::register.}@* +@item +Liste des scripts Perl charg@'es :@* +@kbd{/perl}@* +@end itemize + +@subsection Interface WeeChat / Perl + +@itemize @bullet +@item +@command{IRC::register ( nom, version, fonction_de_fin, description );}@* +@* +C'est la premi@`ere fonction @`a appeler dans le script Perl.@* +Tout script Perl pour WeeChat doit appeler cette fonction.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom unique pour identifier le script (chaque script doit +avoir un nom diff@'erent) +@item @option{version}: version du script +@item @option{fonction_de_fin}: fonction Perl appel@'ee quand le script est +d@'echarg@'e (param@`etre facultatif, une cha@^ine vide signifiant qu'il n'y a pas +de fonction @`a appeler) +@item @option{description}: description br@`eve du script. +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::register ("essai", "1.0", "fin_essai", "Script d'essai !");}@* + +@item +@command{IRC::print ( message );}@* +@* +Affiche un message dans la fen@^etre courante (canal ou serveur).@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{message}: message @`a afficher +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::print ("message");}@* + +@item +@command{IRC::add_message_handler ( nom, fonction );}@* +@* +Attache une fonction Perl @`a un message IRC particulier.@* +La fonction sera appel@'ee @`a chaque fois que le message IRC sera re@,{c}u.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom du message IRC pour lequel la fonction est appel@'ee@* +Pour conna@^itre la liste des messages IRC disponibles, merci de consulter les +RFC 1459 et/ou 2812 :@* +RFC 1459 : @uref{ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt}@* +RFC 2812 : @uref{ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt} +@item @option{fonction}: fonction Perl appel@'ee lorsque le message est re@,{c}u +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::add_message_handler ("privmsg", ma_fonction);}@* +@code{sub ma_fonction}@* +@code{@{ }@* +@code{@ @ @ @ ($null, $canal, $message) = split ":",@@_[0],3;}@* +@code{@ @ @ @ ($masque, $null, $canal) = split " ", $canal;}@* +@code{@ @ @ @ IRC::print ("masque=$masque, canal=$canal, message=$message\n");}@* +@code{@} }@* + +@item +@command{IRC::add_command_handler ( nom, fonction );}@* +@* +Cr@'e@'e une nouvelle commande WeeChat, associ@'ee @`a une fonction Perl.@* +La fonction sera appel@'ee lorsque l'utilisateur lancera la commande par @kbd{/nom}.@* + +@emph{Param@`etres :} +@itemize @minus +@item @option{nom}: nom de la nouvelle commande@* +Il peut s'agir d'une commande existante, auquel cas celle-ci est @'ecras@'ee par +la fonction Perl. Soyez prudent en @'ecrasant les commandes WeeChat, car elles +ne seront plus accessibles tant que le script Perl sera charg@'e. +@item @option{fonction}: fonction Perl associ@'ee @`a la commande +@end itemize +@* +@emph{Exemple :}@* +@code{IRC::add_command_handler ("commande", ma_commande);}@* +@code{sub ma_commande}@* +@code{@{ }@* +@code{@ @ @ @ IRC::print("Param@`etres : ".@@_[0]);}@* +@code{@ @ @ @ return 0;}@* +@code{@} }@* + +@end itemize + +@node Scripts Python, Scripts Ruby, Scripts Perl, Extensions +@section Scripts Python + +Non d@'evelopp@'e ! + +@node Scripts Ruby, , Scripts Python, Extensions +@section Scripts Ruby + +Non d@'evelopp@'e ! + +@c **************************** Auteurs / Support ***************************** + +@node Auteurs / Support, , Extensions, Top +@chapter Auteurs / Support + +@ifhtml +@menu +* Auteurs:: +* Obtenir du support:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Auteurs:: +* Obtenir du support:: +@end menu +@end ifnothtml + +@node Auteurs, Obtenir du support, Auteurs / Support, Auteurs / Support +@section Auteurs + +WeeChat est d@'evelopp@'e par :@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Obtenir du support, Copyright, Auteurs, Auteurs / Support +@end ifhtml +@ifnothtml +@node Obtenir du support, , Auteurs, Auteurs / Support +@end ifnothtml +@section Obtenir du support + +Avant de faire appel au support, merci de lire la documentation et la +FAQ de WeeChat.@* +(la documentation est le document que vous @^etes en train de lire, si vous +n'avez pas tout lu jusqu'ici, il est encore temps de recommencer !)@* + +@itemize @bullet +@item +Support par IRC:@* +- serveur : @b{irc.freenode.net}@* +- canal : @b{#weechat}@*@* +@item +Forum WeeChat : bient@^ot !@*@* +@item +Support par la liste de diffusion :@* +- pour souscrire/d@'esinscrire :@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- pour envoyer un mail @`a la liste de diffusion, envoyer @`a :@*@email{weechat-support@@nongnu.org}.@* + +Les archives de la liste de diffusion sont ici :@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Voir la page support WeeChat pour plus de d@'etails :@* +@uref{http://weechat.flashtux.org/support.php} + +@end itemize + +@ifhtml +@node Copyright, , Obtenir du support, Auteurs / Support +@section Copyright + +Ce manuel documente le client IRC WeeChat, il fait partie de WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Ce document peut @^etre utilis@'e sous les termes de la licence GNU General Public +License version 2 ou plus. +@end ifhtml + +@bye diff --git a/weechat/doc/weechat_doc_pt.texi b/weechat/doc/weechat_doc_pt.texi new file mode 100644 index 000000000..198da130c --- /dev/null +++ b/weechat/doc/weechat_doc_pt.texi @@ -0,0 +1,364 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename weechat_doc_pt.info +@settitle WeeChat - Um cliente de IRC r@'apido, leve e extenc@'ivel +@c %**end of header + +@c WeeChat documentation (vers@~ao partuguesa) +@c +@c Copyright (c) 2003 by FlashCode +@c +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.2 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". + +@c pdf : texi2pdf weechat_doc_pt.texi +@c html: makeinfo --html --no-split --number-sections weechat_doc_pt.texi + +@c tex +@c \overfullrule=0pt +@c end tex + +@documentlanguage pt + +@titlepage + +@title WeeChat - Guia do Utilizador +@subtitle Cliente de IRC rapido, leve e extenc@'ivel +@subtitle Documenta@,{c}@~ao do WeeChat v0.0.3 - 26 de Outubro de 2003 + +@image{weechat_image} + +@author FlashCode <@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> + +@page + +Este manual documenta o cliente de IRC WeeChat, ele faz parte do WeeChat.@* +@* +A ultima versão deste documento pode ser descarregada de :@* +@uref{http://weechat.flashtux.org/doc.php}@* +@* +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +@* +Este documento pode ser utilizado sobre os termos da Licença P@'ublica geral GNU (GNU General Public +License) vers@~ao 2 ou superior. + +@end titlepage + +@everyheading @thischapter @| @| +@everyfooting @thistitle @| @| Pagina @thispage + +@contents + +@node Top, Introduç@~ao, (dir), (dir) +@menu +* Introduç@~ao:: Descriç@~ao do WeeChat +* Instalaç@~ao:: Instalaç@~ao do WeeChat +* Utilizaç@~ao:: Utilizaç@~ao do WeeChat +* Autores / Suporte:: Contactar os autores e obter suporte +@end menu + + +@c ******************************* Introduç@~ao ******************************* + +@node Introduç@~ao, Instalaç@~ao, Top, Top +@chapter Introduç@~ao +@menu +* Descriç@~ao:: +* Pre-requisitos:: +@end menu + +@node Descriç@~ao, Pre-requisitos, Introduç@~ao, Introduç@~ao +@section Descriç@~ao + +O WeeChat (Wee Enhanced Environment for Chat) @'e um cliente de IRC livre, r@'apido e leve, +concebido para funcionar em diversos sistemas operativos.@* +@* +As suas caracter@'isticas prinicpais s@~ao as seguintes : +@itemize @minus +@item +liga@,{c}@~ao a m@'ultiplos servidores +@item +v@'arias interfaces : Curses, Gtk e Qt +@item +pequeno r@'apido e leve +@item +configuravel e extenc@'ivel com scripts +@item +compat@'ivel com RFCs 1459, 2810, 2811, 2812, e 2813 +@item +multiplataforma (Gnu/Linux, *BSD, Windows e outros) +@item +100% GPL, Software Livre +@end itemize + +@* +A p@'agina Web do Weechat @'e aqui :@* +@uref{http://weechat.flashtux.org}@* + +@node Pre-requisitos, ,Descriç@~ao, Introduç@~ao +@section Pr@'e-requisitos + +Para instalar o Weechat, vais @b{precisar} de ter :@* + +@itemize @bullet +@item +Um sistema Gnu/Linux (com um compilador e outros utilit@'arios associados aos pacotes de c@'odigo fonte) +@item +Direitos de "root" (para instalar) +@item +Consoante a interface escolhida, uma das seguintes bibliotecas : +@itemize @minus +@item +Curses: a biblioteca ncurses, +@item +Gtk: *** interface n@~ao desenvolvida ***, +@item +Qt: *** interface n@~ao desenvolvida ***, +@end itemize +@end itemize + + +@c ******************************* Instalaç@~ao ******************************* + +@node Instalaç@~ao, Utilizaç@~ao, Introduç@~ao, Top +@chapter Instalaç@~ao +@menu +* Binarios:: +* Codigo Fonte:: +* Codigo Fonte via CVS:: +@end menu + +@node Binarios, Codigo Fonte, Instalaç@~ao, Instalaç@~ao +@section Bin@'arios + +Os pacotes bin@'arios est@'ao dispon@'iveis para as seguintes distribui@,{c}@~oes : +@itemize @bullet +@item +Debian (ou compat@'ivel)@* +Instala@,{c}@~ao : @kbd{dpkg -i /chemin/weechat_x.y.z-1_i386.deb} +@item +Mandrake/Redhat (ou outra distro compat@'ivel com RPMs)@* +Instala@,{c}@~ao : @kbd{rpm -i /chemin/weechat-x.y.z-1.i386.rpm} +@item +Gentoo@* +Instala@,{c}@~ao : ver a documenta@,{c}@~ao da Gentoo +@item +*BSD (non disponible !) +@item +Slackware (n@~ao dispon@'ivel !) +@item +Windows (n@~ao dispon@'ivel !) +@end itemize + +Onde x.y.z @'e a vers@~ao (por exemplo 0.0.1) +@* + +@node Codigo Fonte, Codigo Fonte via CVS, Binarios, Instalaç@~ao +@section C@'odigo Fonte + +Escreve simplesmente numa consola ou num terminal :@* +@kbd{./configure}@* +@kbd{make}@* +Nota: Para compilar certas interfaces, podes passar par@^ametros +ao ./configure, escreve @kbd{./configure --help} para veres as op@,{c}@~oes.@* + +Obter os direitos do root e instalar o Weechat :@* +@kbd{su -}@* +(escreve aqui a palavra-passe do superutilizador)@* +@kbd{make install}@* + +@node Codigo Fonte via CVS, , Codigo Fonte, Instalaç@~ao +@section C@'odigo Fonte via CVS + +Aten@,{c}@~ao: o c@'odigo fonte CVS est@'a reservado aos utilizadores avan@,{c}ados : o WeeChat pode n@~ao compilar ou ficar inst@'avel.@* +Considera-te avisado !@* + +Para sacares o c@'odigo fonte via CVS, escreve estes comandos :@* +@kbd{cvs -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat login}@* +@kbd{cvs -z3 -d:pserver:anoncvs@@subversions.gnu.org:/cvsroot/weechat co weechat}@* +(quando te pedirem a palavra-passe, primen simplesmente Enter)@* + +Executa o script :@* +@kbd{./autogen.sh}@* + +Segue agora as instru@,{c}@~oes para compilar o c@'odigo fonte - @xref{Codigo Fonte}. + + +@c ******************************* Utilizaç@~ao ******************************** + +@node Utilizaç@~ao, Autores / Suporte, Instalaç@~ao, Top +@chapter Utilizaç@~ao + +@menu +* Invocar o WeeChat:: +* Recursos de teclado:: +* Comandos do WeeChat:: +@end menu + +@node Invocar o WeeChat, Recursos de teclado, Utilizaç@~ao, Utilizaç@~ao +@section Invocar o WeeChat + +@subsection Par@^ametros de linha de comandos + +@table @code +@item -h, --help +Mostrar a ajuda@* +@item -l, --license +Mostrar a licen@,{c}a do WeeChat@* +@item -v, --version +Mostrar a vers@~ao do WeeChat@* +@end table + +@subsection Invocar o WeeChat + +Escreve simplesmente este comando para invoceres o WeeChat :@* +@kbd{weechat-curses}@* +ou @kbd{weechat-gtk} (para a interface em Gtk)@* +ou @kbd{weechat-qt} (para a interface em Qt)@* + +Logo que lan@,{c}ares o WeeChat pela primeira vez, um ficheiro de configura@,{c}@~ao +por defeito @'e criado, com as configura@,{c}@~oes por defeito.@* +O ficheiro de configura@,{c}@~ao por defeito @'e : ~/.weechat/weechat.rc@* + +Podes editar esse ficheiro para configurar o WeeChat @`a tua maneira, man tamb@'em podes modificar os par@^ametros dentro do WeeChat utilizando o comando @kbd{/set} - @xref{Comandos do WeeChat}. + +@node Recursos de teclado, Comandos do WeeChat, Invocar o WeeChat, Utilizaç@~ao +@section Recursos de teclado + +@table @kbd +@item Seta esquerda / Seta direita +Ir um caractere para traz / para a frente na linha de comando@* +@* +@item Ctrl + Seta esquerda / Ctrl + Seta Direita +Ir uma palavra para traz / para a frente na linha de comando@* +@* +@item Home / End +Ir para o in@'icio / para o fim da linha de comando@* +@* +@item Backspace / Delete +Apagar o caractere anterior / seguinte na linha de comando@* +@* +@item Ctrl + Backspace +Apagar a palavra anterior na linha de comando +@* +@item Tab +Completar o comando ou o nick (@kbd{Tab} novamente : encontrar a pr@'oxima sugest@~ao)@* +@* +@item Qualquer caractere +Inserir o caractere na linha de comando, no s@'itio do cursor@* +@* +@item Enter +Executa o comando ou envia a mensagem@* +@* +@item Seta para cima / Seta para baixo +Repetir os ultimos comandos/mensagens@* +@* +@item PageUp / PageDown +Navegar no hist@'orico da janela@* +@* +@item F6 / F7 +Ir para a janela anterior/seguinte@* +@* +@item Alt + Seta da esquerda / Alt + Seta da direita +Identico a F6 / F7@* +@* +@end table + +@node Comandos do WeeChat, , Recursos de teclado, Utilizaç@~ao +@section Comandos do WeeChat + +N@~AO ESCRITO ! + + +@c **************************** Autores / Suporte ***************************** + +@node Autores / Suporte, , Utilizaç@~ao, Top +@chapter Autores / Suporte + +@ifhtml +@menu +* Autores:: +* Obter Suporte:: +* Copyright:: +@end menu +@end ifhtml +@ifnothtml +@menu +* Autores:: +* Obter Suporte:: +@end menu +@end ifnothtml + +@node Autores, Obter Suporte, Autores / Suporte, Autores / Suporte +@section Autores + +O WeeChat @'e desenvolvido por :@* + +@itemize @bullet +@item +FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}> +@item +Bounga +<@email{bounga@@altern.org, bounga AT altern.org}> +@item +Xahlexx +<@email{xahlexx@@tuxfamily.org, xahlexx AT tuxfamily.org}> +@item +Crevetor +<@email{crevetor@@caramail.com, crevetor AT caramail.com}> + +@end itemize + +@ifhtml +@node Obter Suporte, Copyright, Autores, Autores / Suporte +@end ifhtml +@ifnothtml +@node Obter Suporte, , Autores, Autores / Suporte +@end ifnothtml +@section Obter Suporte + +Antes de pedires suporte, agradecemos se leres toda a documenta@,{c}@~ao e a FAQ.@* +(a documenta@,{c}@~ao @'e este documento que est@'as a ler, se n@~ao leste tudo at@'e aqui, est@'a na hora de come@,{c}ares do in@'icio !)@* + +@itemize @bullet +@item +Suporte por IRC:@* +- servidor : @b{irc.freenode.net}@* +- canal : @b{#weechat}@*@* +@item +Forum do WeeChat : mais tarde !@*@* +@item +Suporte por lista de correio-e :@* +- para te inscreveres/desinscreveres :@*@uref{http://mail.nongnu.org/mailman/listinfo/weechat-support}.@* +- para enviares uma mensagem para a lista :@*@email{weechat-support@@nongnu.org}.@* + +Os arquivos da lista est@~ao aqui :@* +@uref{http://mail.nongnu.org/archive/html/weechat-support}@*@* +@item +Para mais detalhes, v@^e tamb@'em a p@'agina de suporte do WeeChat :@* +@uref{http://weechat.flashtux.org/support.php} + +@end itemize + +@ifhtml +@node Copyright, , Obter Suporte, Autores / Suporte +@section Copyright + +Este manual documenta o cliente de IRC WeeChat, Ele faz parte do WeeChat.@* + +Copyright @copyright{} 2003 FlashCode +<@email{flashcode@@flashtux.org, flashcode AT flashtux.org}>@* +Tradu@,{c}@~ao portuguesa de Jo@~ao Jer@'onimo <@email{j_j_b_o@@sapo.pt, j_j_b_o AT sapo.pt}>@* +@* +A utiliza@,{c}@~ao deste documento @'e regida pela GNU General Public +License vers@~ao 2 ou posterior.@* + +@end ifhtml + +@bye diff --git a/weechat/doc/weechat_image.pdf b/weechat/doc/weechat_image.pdf new file mode 100644 index 0000000000000000000000000000000000000000..16ca5c6b2d00e0c4bedf911263d2dcf6a773a503 GIT binary patch literal 15499 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