diff options
| -rw-r--r-- | NEWS | 6 | ||||
| -rwxr-xr-x | autogen.sh | 2 | ||||
| -rw-r--r-- | configure.ac | 2 | ||||
| -rw-r--r-- | docs/faq.html | 150 | ||||
| -rw-r--r-- | docs/startup-HOWTO-rus.html | 846 | ||||
| -rw-r--r-- | docs/startup-HOWTO.html | 1123 | ||||
| -rw-r--r-- | scripts/scriptassist.pl | 454 |
7 files changed, 701 insertions, 1882 deletions
@@ -1,4 +1,10 @@ v0.8.18-head 2016-xx-xx The Irssi team <staff@irssi.org> + * Removed --disable-ipv6 + + irssiproxy can now forward all tags through a single port. + + send channel -botcmds immediately when no mask is specified (#175). + - Correctly store te layout of SAFE channels (#183). + +v0.8.18 2016-02-13 The Irssi team <staff@irssi.org> * Modules will now require to define a void MODULENAME ## _abicheck(int *version) method to ensure that they are compiled against the correct Irssi @@ -32,7 +32,7 @@ cat docs/help/Makefile.am.gen|sed "s/@HELPFILES@/$files/g"|sed 's/?/\\?/g'|tr '! # .html -> .txt with lynx or elinks echo "Documentation: html -> txt..." if type lynx >/dev/null 2>&1 ; then - LC_ALL=C lynx -dump docs/faq.html|perl -pe 's/^ *//; if ($_ eq "\n" && $state eq "Q") { $_ = ""; } elsif (/^([QA]):/) { $state = $1 } elsif ($_ ne "\n") { $_ = " $_"; };' > docs/faq.txt + LC_ALL=en_IE.utf8 lynx -dump docs/faq.html|perl -pe 's/^ *//; if ($_ eq "\n" && $state eq "Q") { $_ = ""; } elsif (/^([QA]):/) { $state = $1 } elsif ($_ ne "\n") { $_ = " $_"; };' > docs/faq.txt elif type elinks >/dev/null 2>&1 ; then elinks -dump docs/faq.html|perl -pe 's/^ *//; if ($_ eq "\n" && $state eq "Q") { $_ = ""; } elsif (/^([QA]):/) { $state = $1 } elsif ($_ ne "\n") { $_ = " $_"; };' > docs/faq.txt elif type links >/dev/null 2>&1 ; then diff --git a/configure.ac b/configure.ac index 1a579911..19635ffd 100644 --- a/configure.ac +++ b/configure.ac @@ -1,4 +1,4 @@ -AC_INIT(irssi, 0.8.18-head) +AC_INIT(irssi, 0.8.19-head) AC_CONFIG_SRCDIR([src]) AC_CONFIG_AUX_DIR(build-aux) AC_PREREQ(2.50) diff --git a/docs/faq.html b/docs/faq.html index e2de9799..345060dc 100644 --- a/docs/faq.html +++ b/docs/faq.html @@ -1,152 +1,80 @@ -<h2>FAQ</h2> +<h1>Frequently Asked Questions</h1> +<h3 id="q-why-doesnt-irssi-display-colors-even-when-ircii-etc-displays-them">Q: Why doesn’t irssi display colors even when ircii etc. displays them?</h3> -<h3>Q: Why doesn't irssi display colors even when ircii etc. displays them?</h3> +<p>A: They force ANSI colors even if terminal doesn’t support them. By default, irssi uses colors only if terminfo/termcap so says. The correct way to fix this would be to change your TERM environment to a value where colors work, like xterm-color or color_xterm (eg. <code>TERM=xterm-color irssi</code>). If this doesn’t help, then use the evil way of <code>/SET term_force_colors ON</code>.</p> -<p>A: They force ANSI colors even if terminal doesn't support them. By -default, irssi uses colors only if terminfo/termcap so says. The correct -way to fix this would be to change your TERM environment to a value where -colors work, like xterm-color or color_xterm (eg. <code>TERM=xterm-color -irssi</code>). If this doesn't help, then use the evil way of <code>/SET -term_force_colors ON</code>.</p> - - -<h3>Q: How do I easily write text to channel that starts with '/' character?</h3> +<h3 id="q-how-do-i-easily-write-text-to-channel-that-starts-with--character">Q: How do I easily write text to channel that starts with ‘/’ character?</h3> <p>A: <code>/ /text</code></p> +<h3 id="q-why-doesnt-irssi-update-my-realname-or-whatever-after-i-change-it-with-set-realname-and-reconnect-with-reconnect-or-server">Q: Why doesn’t irssi update my realname (or whatever) after I change it with <code>/SET realname</code> and reconnect with <code>/RECONNECT</code> or <code>/SERVER</code>?</h3> -<h3>Q: Why doesn't irssi update my realname (or whatever) after I change it -with <code>/SET realname</code> and reconnect with <code>/RECONNECT</code> -or <code>/SERVER</code>?</h3> - -<p>A: Irssi is trying to be too smart. This will be fixed in future, but for -now you should use <code>/DISCONNECT</code> and <code>/CONNECT</code>.</p> - +<p>A: Irssi is trying to be too smart. This will be fixed in future, but for now you should use <code>/DISCONNECT</code> and <code>/CONNECT</code>.</p> -<h3>Q: I connected to some server which isn't responding but now irssi tries -to connect back to it all the time! How can I stop it?</h3> +<h3 id="q-i-connected-to-some-server-which-isnt-responding-but-now-irssi-tries-to-connect-back-to-it-all-the-time-how-can-i-stop-it">Q: I connected to some server which isn’t responding but now irssi tries to connect back to it all the time! How can I stop it?</h3> -<p>A: Two ways. The "good way" to do it is with <code>/DISCONNECT</code>. -Check the server tags first with <code>/SERVER</code> without giving it any -parameters, reconnections are those that have tag starting with "recon" -text. So most probably you're going to do <code>/DISCONNECT recon-1</code>. -The other way is to remove all the reconnections with -<code>/RMRECONNS</code>, easier but may remove some connections you actually -wanted to reconnect (if you used multiple servers..).</p> +<p>A: Two ways. The “good way” to do it is with <code>/DISCONNECT</code>. Check the server tags first with <code>/SERVER</code> without giving it any parameters, reconnections are those that have tag starting with “recon” text. So most probably you’re going to do <code>/DISCONNECT recon-1</code>. The other way is to remove all the reconnections with <code>/RMRECONNS</code>, easier but may remove some connections you actually wanted to reconnect (if you used multiple servers..).</p> +<h3 id="q-how-do-i-add-seconds-to-timestamp">Q: How do I add seconds to timestamp?</h3> -<h3>Q: How do I add seconds to timestamp?</h3> +<p>A: <code>/FORMAT timestamp {timestamp %%H:%%M:%%S}</code> - and remember to add the trailing space :)</p> -<p>A: <code>/FORMAT timestamp {timestamp %%H:%%M:%%S}</code> - and remember -to add the trailing space :)</p> +<h3 id="q-why-does-irssi-say-irssi-channel-not-fully-synchronized-yet-try-again-after-a-while-when-i-try-to-use-ban-etc">Q: Why does irssi say “Irssi: Channel not fully synchronized yet, try again after a while” when I try to use /BAN etc?</h3> +<p>A: Possibly a bug in irssi, or ircd you’re using does something that irssi didn’t really notice. The new code should make this happen far less often than before, but one known reason for this is when irssi doesn’t notice that you were unable to join some channel. Currently however I don’t know of any such events irssi doesn’t know about.</p> -<h3>Q: Why does irssi say "Irssi: Channel not fully synchronized yet, try -again after a while" when I try to use /BAN etc?</h3> - -<p>A: Possibly a bug in irssi, or ircd you're using does something that -irssi didn't really notice. The new code should make this happen far less -often than before, but one known reason for this is when irssi doesn't -notice that you were unable to join some channel. Currently however I don't -know of any such events irssi doesn't know about.</p> - -<p>Anyway, if this does happen, do <code>/RAWLOG SAVE ~/rawlog</code> soon -after joining to channel, and either try to figure out yourself why irssi -didn't get reply to WHO request, or send the whole log to cras@irssi.org. Note -that the rawlog is by default only 200 lines and it may not be enough to -show all needed information, so you might want to do <code>/SET rawlog_lines -1000</code> or so.</p> +<p>Anyway, if this does happen, do <code>/RAWLOG SAVE ~/rawlog</code> soon after joining to channel, and either try to figure out yourself why irssi didn’t get reply to WHO request, or open a Github issue with the full log included. Note that the rawlog is by default only 200 lines and it may not be enough to show all needed information, so you might want to do <code>/SET rawlog_lines 1000</code> or so.</p> <p><code>MODE +b</code> still works fine though.</p> +<h3 id="q-wheres-the-gui-version">Q: Where’s the GUI version?</h3> -<h3>Q: Where's the GUI version?</h3> - -<p>A: Read -<a href="http://www.irssi.org/about">http://www.irssi.org/about</a></p> - - -<h3>Q: How do I autorejoin channels after being kicked?</h3> - -<p>A: That's evil and you shouldn't do it. If you get kicked, you should stay -out, at least until the channel forgot you existed :) Most channels I've -joined just ban you if you autorejoin after kick. If you're joined to -channels who kick people for fun, try changing channels or something.</p> - -<p>Anyway, if you REALLY want to do that, and you understand that you're doing -evilness, you can use the autorejoin.pl script that comes with irssi. You'll -still need to specify the channels you wish to rejoin with <code>/SET -autorejoin_channels #chan1 #chan2 ...</code></p> - - -<h3>Q: How do I announce that I'm away/back in all channels I've joined? Or -how do I change my nick when setting myself away/back?</h3> - -<p>A: That's even worse than autorejoin. Who could possibly care every time -you come and go? Many channels will kick you for using this, and I for example -have added several ignores so I'd never need to see these messages. Learn to -use <code>/AWAY</code> command properly and tell its existence to people -who don't know about it. <code>/WII yournick</code> shows your away reason -much better for people who actually want to know if you're there or not.</p> +<p>A: There was one on <a href="https://github.com/irssi-import/xirssi">irssi-import/xirssi</a> but it has not been maintained for a long time.</p> +<h3 id="q-how-do-i-autorejoin-channels-after-being-kicked">Q: How do I autorejoin channels after being kicked?</h3> -<h3>Q: Why does irssi autojoin on invite by default?</h3> +<p>A: That’s evil and you shouldn’t do it. If you get kicked, you should stay out, at least until the channel forgot you existed :) Most channels I’ve joined just ban you if you autorejoin after kick. If you’re joined to channels who kick people for fun, try changing channels or something.</p> -<p>A: The setting is /SET join_auto_chans_on_invite - it's not the same -as regular autojoin-on-invite, which irssi doesn't even have. The only -channels that are joined on invite, are the ones you've added to config -with /CHANNEL ADD -auto. This is very useful with +i channels when you -need to first send an invite request to bot, or if you get accidentally -kicked from channel, the kicker can invite you back immediately.</p> +<p>Anyway, if you REALLY want to do that, and you understand that you’re doing evilness, you can use the autorejoin.pl script that comes with irssi. You’ll still need to specify the channels you wish to rejoin with <code>/SET autorejoin_channels #chan1 #chan2 ...</code></p> -<p>I don't see any bad side effects with this feature, so it's ON by -default. I guess someone could start kicking/inviting you all the time -but server connection shouldn't drop because of that, and you shouldn't -join channels whose operators are that evil.</p> +<h3 id="q-how-do-i-announce-that-im-awayback-in-all-channels-ive-joined-or-how-do-i-change-my-nick-when-setting-myself-awayback">Q: How do I announce that I’m away/back in all channels I’ve joined? Or how do I change my nick when setting myself away/back?</h3> +<p>A: That’s even worse than autorejoin. Who could possibly care every time you come and go? Many channels will kick you for using this, and I for example have added several ignores so I’d never need to see these messages. Learn to use <code>/AWAY</code> command properly and tell its existence to people who don’t know about it. <code>/WII yournick</code> shows your away reason much better for people who actually want to know if you’re there or not.</p> -<h3>Q: How to make UTF-8 support work with irssi?</h3> +<h3 id="q-why-does-irssi-autojoin-on-invite-by-default">Q: Why does irssi autojoin on invite by default?</h3> -<p>A: Make sure your terminal supports UTF-8 (for example, <code>xterm -u8</code>). -If you use screen, you may have to do <code>screen -U</code>. And in Irssi do -<code>/SET term_charset utf-8</code>. (for 0.8.9 and older: <code>/SET term_type utf-8</code>)</p> +<p>A: The setting is /SET join_auto_chans_on_invite - it’s not the same as regular autojoin-on-invite, which irssi doesn’t even have. The only channels that are joined on invite, are the ones you’ve added to config with /CHANNEL ADD -auto. This is very useful with +i channels when you need to first send an invite request to bot, or if you get accidentally kicked from channel, the kicker can invite you back immediately.</p> +<p>I don’t see any bad side effects with this feature, so it’s ON by default. I guess someone could start kicking/inviting you all the time but server connection shouldn’t drop because of that, and you shouldn’t join channels whose operators are that evil.</p> -<h3>Q: Will there be /DETACH-like feature?</h3> +<h3 id="q-how-to-make-utf-8-support-work-with-irssi">Q: How to make UTF-8 support work with irssi?</h3> -<p>A: Maybe. Detach code already is there, attach is just missing :) But I -don't have much interest in coding it, -<a href="http://www.gnu.org/software/screen/screen.html">screen</a> and -<a href="http://dtach.sf.net/">dtach</a> can be used to do it just fine.</p> +<p>A: Make sure your terminal supports UTF-8 (for example, <code>xterm -u8</code>). If you use screen, you may have to do <code>screen -U</code>. And in Irssi do <code>/SET term_charset utf-8</code>. (for 0.8.9 and older: <code>/SET term_type utf-8</code>)</p> +<h3 id="q-will-there-be-detach-like-feature">Q: Will there be /DETACH-like feature?</h3> -<h3>Q: How do I run scripts automatically at startup?</h3> +<p>A: <a href="http://tmux.github.io/">tmux</a>, <a href="http://www.gnu.org/software/screen/screen.html">screen</a> and <a href="http://dtach.sf.net/">dtach</a> can be used to do it just fine.</p> -<p>A: Put them into <code>~/.irssi/scripts/autorun/</code> directory. Or -better would be if you placed them in <code>~/.irssi/scripts/</code> and -created symlinks to autorun directory (eg. <code>cd -~/.irssi/scripts/autorun/ ; ln -s ../script.pl .</code>)</p> +<h3 id="q-how-do-i-run-scripts-automatically-at-startup">Q: How do I run scripts automatically at startup?</h3> +<p>A: Put them into <code>~/.irssi/scripts/autorun/</code> directory. Or better would be if you placed them in <code>~/.irssi/scripts/</code> and created symlinks to autorun directory (eg. <code>cd ~/.irssi/scripts/autorun/ ; ln -s ../script.pl .</code>)</p> -<h3>Q: How do I execute commands automatically at startup?</h3> +<h3 id="q-how-do-i-execute-commands-automatically-at-startup">Q: How do I execute commands automatically at startup?</h3> -<p>A: Put them into <code>~/.irssi/startup</code> file, each command on its -own line. The preceding slash (/) is not necessary.</p> +<p>A: Put them into <code>~/.irssi/startup</code> file, each command on its own line. The preceding slash (/) is not necessary.</p> +<h3 id="q-how-do-i-easily-edit-existing-topic">Q: How do I easily edit existing topic?</h3> -<h3>Q: How do I easily edit existing topic?</h3> +<p>A: <code>/TOPIC <tab></code></p> -<p>A: /TOPIC <tab></p> +<h3 id="q-how-can-i-have-whois-replies-to-active-window">Q: How can I have /WHOIS replies to active window?</h3> -<h3>Q: How can I have /WHOIS replies to active window?</h3> +<p>A: You can disable the status window, or do <code>/WINDOW LEVEL -CRAP</code> in it which would also make several other messages show up in active window. You can also use a <a href="http://dgl.cx/irssi/hack-whois-in-current-window.pl">script</a>.</p> -<p>A: You can disable the status window, or do <code>/WINDOW LEVEL --CRAP</code> in it which would also make several other messages show up in -active window. You can also use a -<a href="http://dgl.cx/irssi/hack-whois-in-current-window.pl">script</a>.</p> +<h3 id="q-how-do-i-add-the-active-network-to-the-statusbar">Q: How do I add the active network to the statusbar</h3> -<h3>Q: How do I add the active network to the statusbar</h3> +<p>A: Modify the window-line in statusbar section in config file to <code>window = "{sb $winref:$tag/$T{sbmode $M}}";</code></p> -<p>A: Modify the window-line in statusbar section in config file to -<code>window = "{sb $winref:$tag/$T{sbmode $M}}";</code></p> +<h3 id="q-how-to-pronounce-irssi">Q: How to pronounce Irssi?</h3> +<p>A: Check <a href="https://irssi.org/assets/irssi.wav">here</a></p> diff --git a/docs/startup-HOWTO-rus.html b/docs/startup-HOWTO-rus.html deleted file mode 100644 index 595d1df0..00000000 --- a/docs/startup-HOWTO-rus.html +++ /dev/null @@ -1,846 +0,0 @@ - <h2>Startup HOWTO</h2> - - <h3> Irssi ( IRC ..)</h3> - - <p>© 2000-2002 by Timo Sirainen, - <a href="http://www.gnu.org/licenses/fdl.html">GNU FDL</a> 1.1.<br/> - NiXoiD' (#xakep @ irc.wenet.ru) - </p> - - -<p> FAQ, :</p> - -<ol> -<li><a href="#c1"> </a> - <ul> - <li> , ircII</li> - </ul></li> -<li><a href="#c2"> </a> - <ul> - <li> "" ( ף "split windows")</li> - <li> ?</li> - <li> alt-1 ... !</li> - </ul></li> -<li><a href="#c3"> </a> - <ul> - <li> ?</li> - <li> ?</li> - <li> ?</li> - </ul></li> -<li><a href="#c4"> </a></li> -<li><a href="#c5"> status msgs & </a> - <ul> - <li> /WHOIS </li> - <li> </li> - </ul></li> -<li><a href="#c6"> irssi </a> - <ul> - <li> , irssi . ??</li> - <li> </li> - </ul></li> -<li><a href="#c7"> /LASTLOG </a> - <ul> - <li> ?</li> - </ul></li> -<li><a href="#c8"> </a></li> -<li><a href="#c9"> </a> - <ul> - <li> F1 -?</li> - </ul></li> -<li><a href="#c10"> </a> - <ul> - <li> irssi-proxy?</li> - </ul></li> -<li><a href="#c11"> Irssi</a></li> -<li><a href="#c12"></a> - <ul> - <li> , !</li> - </ul></li> -</ol> - -<h3><a id="c1">1. </a></h3> - -<p> :</p> - -<p> VT- , :</p> - -<pre> -/SET term_force_colors ON -</pre> - -<p> :</p> - -<pre> -/SET autocreate_own_query OFF -/SET autocreate_query_level DCCMSGS -/SET use_status_window OFF -/SET use_msgs_window ON -</pre> - -<p> (<code>/PART</code>) -(<code>/UNQUERY</code>):</p> - -<pre> -/SET autoclose_windows OFF -/SET reuse_unused_windows ON -</pre> - -<p> irssi ircII :</p> - -<pre> -/SET autocreate_own_query OFF -/SET autocreate_query_level NONE -/SET use_status_window OFF -/SET use_msgs_window OFF -/SET reuse_unused_windows ON -/SET windows_auto_renumber OFF - -/SET autostick_split_windows OFF -/SET autoclose_windows OFF -/SET print_active_channel ON -</pre> - -<p> :</p> - -<p>( OFTC, nickserv 2 )</p> - -<pre> -/IRCNET ADD -autosendcmd "/^msg nickserv identify pass;wait 2000" OFTC -</pre> - -<p> (IRC- ), - irc.kpnqwest.fi IRCNet , irssi -irc.funet.fi:</p> - -<pre> -/SERVER ADD -auto -ircnet ircnet irc.kpnqwest.fi 6667 -/SERVER ADD -ircnet ircnet irc.funet.fi 6667 -/SERVER ADD -auto -ircnet efnet efnet.cs.hut.fi 6667 -</pre> - -<p> - efnet/#irssi:</p> - -<pre> -/CHANNEL ADD -auto #irssi ircnet -/CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet -</pre> - - , : - -<pre> -/HILIGHT _ -</pre> - -<h3><a id="c2">2. </a></h3> - -<p> PgUp PgDown. , Meta-p Meta-n. - <code>/SB HOME</code> <code>/SB END</code>.</p> - -<p> irssi " ". (<code>/JOIN</code>) (<code>/QUERY</code>) - -. :</p> - -<pre> -Meta-1, Meta-2, .. Meta-0 - 1-10 -Meta-q .. Meta-o - 11-19 -/WINDOW <> - -Ctrl-P, Ctrl-N - / -</pre> - -<p> - Meta-. Meta? - ALT. windows- , - windows. , X- -( xterm rxvt):</p> - -<pre> -XTerm*eightBitInput: false -XTerm*metaSendsEscape: true -</pre> - -<p> rxvt - meta, Alt Win :</p> - -<pre> -rxvt*modifier: alt -</pre> - -<p> - xmodmap:</p> - -<pre> -xmodmap -e "keysym Alt_L = Meta_L Alt_L" -</pre> - -<p> - X-? Debian', -<code>/etc/X11/Xresources/xterm</code>, . <code>~/.Xresources</code> -<code>~/.Xdefaults</code> - . , <code>~/.Xresources</code> - <code>xrdb -merge ~/.Xresources</code>. - .</p> - -<p> SSH Windows ALT. , - putty, -<a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/"> -http://www.chiark.greenend.org.uk/~sgtatham/putty/</a>.</p> - -<p>- . , :</p> - -<pre> -/WINDOW NEW - -/WINDOW NEW HIDE - -/WINDOW CLOSE - - -/WINDOW HIDE [<number>|<name>] - -/WINDOW SHOW <number>|<name> - - -/WINDOW SHRINK [<lines>] - -/WINDOW GROW [<lines>] - -/WINDOW BALANCE - -</pre> - -<p> Irssi " ". , , :). :</p> - -<pre> -Split window 1: win#1 - Status window, win#2 - -Split window 2: win#3 - ircnet/#channel1, win#4 - ircnet/#channel2 -Split window 3: win#5 - efnet/#channel1, win#6 - efnet/#channel2 -</pre> - -<p> win#1 ALT-6, irssi -#3 efnet/#channel2 .</p> - -<p> "̣" - ALT-6 win#1 win#6 1 - , win#6 - - , irssi . ircII </p> - -<pre> -/SET autostick_split_windows OFF -</pre> - -<p> , "". , </p> - -<pre> -/SET autocreate_windows OFF [format c: ģ ;) - . .] -</pre> - -<p> , :</p> - -<pre> -/SET print_active_channel ON -</pre> - -<p> - , :</p> - -<pre> -/JOIN -window #channel -/QUERY -window nick -</pre> - -<h3><a id="c3">3. </a></h3> - -<p> Irssi :). , .. :). - 6.</p> - -<p> IRC-, <code>/IRCNET</code>, - , ݣ . , <code>/IRCNET ADD -_</code>. , - , <code>-autosendcmd</code>. - :</p> - -<pre> -/IRCNET ADD -autosendcmd '^msg bot invite' ircnet -/IRCNET ADD -autosendcmd "/^msg nickserv identify pass;wait 2000" OFTC -</pre> - -<p> . :</p> - -<pre> -/SERVER ADD -auto -ircnet ircnet irc.kpnqwest.fi 6667 -/SERVER ADD -auto -ircnet worknet irc.mycompany.com 6667 -</pre> - -<p> <code>-auto</code> , . - - <code>-auto</code> - Irssi , <code>-auto</code> .</p> - -<p> :</p> - -<pre> -/CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet -/CHANNEL ADD -auto #secret ircnet password -</pre> - -<p> <code>-bots</code> <code>-botcmd</code> . - , , - . -<code>-bots</code>, ( ). $0 -<code>-botcmd</code> . ( ) - <code>-botcmd</code> .</p> - -<h3><a id="c4">4. </a></h3> - -<p> ( , ...). - :</p> - -<pre> -/WINDOW MOVE LEFT/RIGHT/ - , -/WINDOW ITEM MOVE <>|<> - -</pre> - -<p> ӣ , , <code>/LAYOUT SAVE</code> - ( <code>/SAVE</code>, ) irssi, . - "" , <code>/LAYOUT SAVE</code> , - <code>/SERVER ADD -auto</code> <code>/CHANNEL ADD -auto</code>.</p> - -<p> , <code>/LAYOUT SAVE</code>. - <code>/LAYOUT RESET.</code></p> - - -<h3><a id="c5">5. status msgs & </a></h3> - -<p> " " . , ( ctcp-). - , , </p> - -<pre> -/SET use_status_window OFF -</pre> - -<p> irssi. , (<code>/WINDOW CLOSE</code>).</p> - -<p> - " ", . - . :</p> - -<pre> -/SET use_msgs_window ON -/SET autocreate_query_level DCCMSGS ( - - DCC- NONE) -</pre> - -<p> - irssi. :</p> - -<pre> -/WINDOW NEW HIDE - -/WINDOW NAME (msgs) - "(msgs)" -/WINDOW LEVEL MSGS - -/WINDOW MOVE 1 - -</pre> - -<p>, use_msgs_window, use_status_window <code>/LAYOUT SAVE</code>.</p> - -<p> .. ? , irssi -" ". : PUBLIC - , -MSGS - CRAP , . </p> - -<pre> -/HELP levels -</pre> - -<p> <code>ALL -MSGS</code>, , , - , . <code>-MSGS</code> .</p> - - -<h3><a id="c6">6. irssi </a></h3> - -<p> ircII IRC- -. IRSSI . . , - , . , :</p> - -<pre> -/CONNECT irc.server.org -</pre> - -<p> <code>/SERVER</code>, -. <code>/SERVER</code> - . :</p> - -<pre> --!- IRCNet: irc.song.fi:6667 (IRCNet) --!- OFTC: irc.oftc.net:6667 (OFTC) --!- RECON-1: 192.168.0.1:6667 () (02:59 left before reconnecting) -</pre> - -<p> , IRCNet OFTC. - IRCNet " " -(IRCnet) IRC-. , . - IRC- - . - , irssi - , ircnet, ircnet2, ircnet3 -...</p> - -<p> , <code>RECON-</code> . - , 192.168.0.1 -irssi 3 .</p> - -<p> :</p> - -<pre> -/DISCONNECT ircnet - "ircnet" -/DISCONNECT recon-1 - RECON-1 -/RMRECONNS - - -/RECONNECT recon-1 - RECON-1 -/RECONNECT ALL - - -</pre> - -<p>, . - - . </p> - -<pre> -/WINDOW SERVER tag - "tag" -Ctrl-X - -</pre> - -<p> . , irssi [_] - , .</p> - -<p> - <code>-_</code> - ţ :</p> - -<pre> -/MSG - -/JOIN - # -/QUERY - -</pre> - -<p> <code>/MSG</code> - - .</p> - -<p> ̣. , - , , - . , - . :</p> - -<pre> -/WINDOW SERVER -sticky tag -</pre> - -<p> . ( ):</p> - -<pre> -/WINDOW NEW HIDE -/WINDOW NAME (status) -/WINDOW LEVEL ALL -MSGS -/WINDOW SERVER -sticky ircnet - -/WINDOW NEW HIDE -/WINDOW NAME (msgs) -/WINDOW LEVEL MSGS -/WINDOW SERVER -sticky ircnet -</pre> - -<h3><a id="c7">7. /LASTLOG </a></h3> - -<p> <code>/LASTLOG</code> . ţ :</p> - -<pre> -/LASTLOG - , "" -/LASTLOG word 10 - 10 , "word" -/LASTLOG -topics - -</pre> - -<p> 1000 , irssi , <code>-force</code>. - , :</p> - -<pre> -/LASTLOG -file ~/irc.log -</pre> - -<p> <code>-file</code> <code>-force</code> - . <code>/LASTLOG</code> . <code>/HELP lastlog</code>.</p> - -<p> , . Irssi <code>/SCROLLBACK</code> ( -ţ - <code>/SB</code>) . - <code>/LASTLOG</code> - <code>/SB GOTO :</code> "" . - <code>/SB -END</code>.</p> - - -<h3><a id="c8">8. </a></h3> - -<p>Irssi -(<code>/AWAY </code>). -(ݣ <code>/AWAY</code>), - . - :</p> - -<pre> -/SET awaylog_level MSGS HILIGHT - -/SET awaylog_file ~/.irssi/away.log - -</pre> - -<p> Irssi - . -Irssi . - :</p> - -<pre> -/SET autolog ON -</pre> - -<p> ӣ CTCPS CRAP -(<code>/WHOIS</code>- ...). , :</p> - -<pre> -/SET autolog_level ALL -CRAP -CLIENTCRAP -CTCPS (this is the default) -</pre> - -<p> irssi ~/irclogs/<_>/<>.log. - :</p> - -<pre> -/SET autolog_path ~/irclogs/$tag/$0.log ( " ") -</pre> - -<p> , . $0 - ( ). Irssi , / . - - "man strftime" :). :</p> - -<pre> -/SET autolog_path ~/irclogs/%Y/$tag/$0.%m-%d.log -</pre> - -<p> - <code>/HELP -log</code></p> - - -<h3><a id="c9">9. </a></h3> - -<p> , irssi. - irssi "" , -shift-backspace - X-.</p> - -<p> <code>/HELP bind</code> , . - "" - . - , . - - <code>cat</code> . - F1:</p> - -<pre> -[cras@hurina] ~% cat -^[OP -</pre> - -<p> irssi "" - F1 <code>/BIND ^[OP /ECHO F1</code>. - , - , - :</p> - -<pre> -/BIND ^[OP key F1 -/BIND ^[11~ key F1 -/BIND F1 /ECHO F1. -</pre> - -<h3><a id="c10">10. </a></h3> - -<p>Irssi IRC- . ӣ , .</p> - -<p> : , -irc.bouncer.org 5000. irc.dal.net irc.efnet.org. :</p> - -<pre> -/SET use_proxy ON ( ) -/SET proxy_address irc.bouncer.org -/SET proxy_port 5000 - -/SET proxy_password _ -/SET -clear proxy_string -/SET proxy_string_after conn %s %d -</pre> - -<p> . -, :</p> - -<pre> -/SERVER ADD -auto -ircnet dalnet irc.dal.net -/SERVER ADD -auto -ircnet efnet irc.efnet.org -</pre> - -<p> , irssi .</p> - -<p> - , -<code>-noproxy</code>.</p> - -<p><strong> :</strong></p> - -<p> :</p> - -<pre> -/SET use_proxy ON -/SET proxy_address < > -/SET proxy_port <> -</pre> - -<p><strong>HTTP proxy</strong></p> - -<p> HTTP-:</p> - -<pre> -/SET -clear proxy_password -/EVAL SET proxy_string CONNECT %s:%d\n\n -</pre> - -<p><strong>BNC</strong></p> - -<pre> -/SET proxy_password _ -/SET -clear proxy_string -/SET proxy_string_after conn %s %d -</pre> - -<p><strong>dircproxy</strong></p> - -<p>dircproxy . ircnet ircpass - OFTC oftcpass, :</p> - -<pre> -/SET -clear proxy_password -/SET -clear proxy_string - -/SERVER ADD -auto -ircnet ircnet fake.ircnet 6667 ircpass -/SERVER ADD -auto -ircnet OFTC fake.oftc 6667 oftcpass -</pre> - -<p> , , ӣ .</p> - -<p><strong>psyBNC</strong></p> - -<p>psyBNC . - . - Irssi:</p> - -<pre> -/SET -clear proxy_password -/SET -clear proxy_string - -/IRCNET ADD -user ircnetuser ircnet -/SERVER ADD -auto -ircnet ircnet fake.ircnet 6667 ircpass -/IRCNET ADD -user oftcuser OFTC -/SERVER ADD -auto -ircnet OFTC fake.oftc 6667 oftcpass -</pre> - -<p> <code>/IRCNET ADD</code> - <code>/SERVER ADD</code>.</p> - -<p><strong>Irssi proxy</strong></p> - -<p>Irssi , configure -<code>--with-proxy</code>. ţ irssi .</p> - -<p>Irssi- -, IRC- , -<strong>irssi- () </strong>. ݣ : <strong> IRC- </strong>.</p> - -<p>Irssi- , 2777- ircnet, 2778 efnet.</p> - -<p> :</p> - -<pre> -/LOAD proxy -/SET irssiproxy_password <> -/SET irssiproxy_ports <IRC_>=<> ... ( ircnet=2777 efnet=2778) -</pre> -<p> <strong></strong> , - <code>/SERVER ADD</code> -<code>/IRCNET ADD</code>. .. , :</p> - -<pre> -/SET irssiproxy_ports *=2777 -</pre> - -<p> :</p> - -<p> , <code>/SET irssiproxy_password</code>. :</p> - -<pre> -/SERVER ADD -ircnet ircnet my.irssi-proxy.org 2777 secret -/SERVER ADD -ircnet efnet my.irssi-proxy.org 2778 secret -</pre> - -<p>Irssi- - irc-.</p> - -<p><strong>SOCKS</strong></p> - -Irssi socks- ( configure <code>--with-socks</code>), - . <code>/SET -proxy</code> . - -<p><strong> </strong></p> - -<p>IRC- - IRC-, . :</p> - -<pre> -/SET proxy_password <> -</pre> - -<p>CONNECT- :</p> - -<pre> -/SET proxy_string CONNECT %s %d -/SET proxy_string_after -</pre> - -<p>proxy_string NICK/USER, -proxy_string_after . %s and %d can be used with both -of them.</p> - -<h3><a id="c11">11. Irssi</a></h3> - -<p> Irssi . - , ( "" ):</p> - -<p><strong> </strong></p> - -<dl> -<dt>/SET autocreate_own_query ON</dt> - <dd> - <code>/MSG</code>.</dd> - -<dt>/SET autocreate_query_level MSGS</dt> - <dd> . MSGS, DCCMSGS NOTICES. - <code>/SET -clear autocreate_query_level</code>.</dd> - -<dt>/SET autoclose_query 0</dt> - <dd> "". . .</dd> -</dl> - -<p><strong></strong></p> - -<dl> -<dt>/SET use_msgs_window OFF</dt> - <dd> . . - . - - /WINDOW LEVEL - MSGS, /WINDOW NAME (msgs).</dd> - -<dt>/SET use_status_window ON</dt> - <dd> . , , /WHOIS ... - <code>/WINDOW LEVEL ALL -MSGS</code>, - <code>/WINDOW NAME (status)</code>.</dd> - -<dt>/SET autocreate_windows ON</dt> - <dd> , </dd> - -<dt>/SET autoclose_windows ON</dt> - <dd> ( (<code>/PART</code>)).</dd> - -<dt>/SET reuse_unused_windows OFF</dt> - <dd> ( ) Irssi - . , . - autoclose_windows .</dd> - -<dt>/SET window_auto_change OFF</dt> - <dd> .</dd> - -<dt>/SET print_active_channel OFF</dt> - <dd> , Irssi , <code><> </code> - , : <code><:> </code>. , , - .</dd> - -<dt>/SET window_history OFF</dt> - <dd> .</dd> -</dl> - - -<p><strong> </strong></p> - -<dl> -<dt>/SET nick</dt> - <dd> </dd> - -<dt>/SET alternate_nick</dt> - <dd> .</dd> - -<dt>/SET user_name</dt> - <dd> . ident, .</dd> - -<dt>/SET real_name</dt> - <dd> .</dd> -</dl> - - -<p><strong> </strong></p> - -<dl> -<dt>/SET skip_motd OFF</dt> - <dd> motd .</dd> - -<dt>/SET server_reconnect_time 300</dt> - <dd> .</dd> - -<dt>/SET lag_max_before_disconnect 300</dt> - <dd> ( ) .</dd> -</dl> - - -<p><strong> </strong></p> - -<dl> -<dt>/SET timestamps ON</dt> - <dd> .</dd> - -<dt>/SET hide_text_style OFF</dt> - <dd> ( , ...).</dd> - -<dt>/SET show_nickmode ON</dt> - <dd> " " , - <code><@nick></code> , <code><+nick></code> ...</dd> - -<dt>/SET show_nickmode_empty ON</dt> - <dd> - " ".</dd> - -<dt>/SET show_quit_once OFF</dt> - <dd> quit- , , .</dd> - -<dt>/SET lag_min_show 100</dt> - <dd> - . 100 .</dd> - -<dt>/SET indent 10</dt> - <dd> , , . . - <code>%|</code>.</dd> - -<dt>/SET activity_hide_targets</dt> - <dd> - , . <code>#boringchannel =bot1 - =bot2</code>. , (highlight).</dd> -</dl> - -<p><strong> </strong></p> - -<dl> -<dt>/SET completion_auto OFF</dt> - <dd> " ". - .</dd> - -<dt>/SET completion_char :</dt> - <dd>" ".</dd> -</dl> - -<h3><a id="c12">12. </a></h3> - -<p> <code>/STATUSBAR</code> :</p> - -<pre> -Name Type Placement Position Visible -window window bottom 0 always -window_inact window bottom 1 inactive -prompt root bottom 100 always -topic root top 1 always -</pre> - -<p><code>/STATUSBAR <></code> ţ . -<code>/STATUSBAR <> ENABLE|DISABLE</code> - . <code>/STATUSBAR <> RESET</code> - , , ţ.</p> - -<p> : windows root - , . -Placement - : top - , bottom - . -Position - , , . - Visible 3 : always, active inactive. active/inactive . - :</p> - -<pre> -/STATUSBAR <> TYPE window|root -/STATUSBAR <> PLACEMENT top|bottom -/STATUSBAR <> POSITION <num> -/STATUSBAR <> VISIBLE always|active|inactive -</pre> - -<p> . - :</p> - -<pre> -/STATUSBAR <> ADD [-before | -after <item>] [-priority #] [-alignment left|right] <(item)> -/STATUSBAR <> REMOVE <(item)> -</pre> - -<p> . - . mail.pl - ( -<code>/STATUSBAR</code>), : <code>/STATUSBAR window ADD -before -act mail</code>.</p> diff --git a/docs/startup-HOWTO.html b/docs/startup-HOWTO.html index 1b912b96..07a9f47c 100644 --- a/docs/startup-HOWTO.html +++ b/docs/startup-HOWTO.html @@ -1,739 +1,501 @@ - <h2>Startup HOWTO</h2> - - <h3>To new Irssi users (not to new IRC users ..)</h3> - - <p>Copyright (c) 2000-2002 by Timo Sirainen, release under - <a href="http://www.gnu.org/licenses/fdl.html">GNU FDL</a> 1.1 license.</p> + <h1>Startup How-To</h1> +<h3 id="to-new-irssi-users-not-to-new-irc-users-">To new Irssi users (not to new IRC users ..)</h3> +<p>Copyright (c) 2000-2002 by Timo Sirainen, release under <a href="http://www.gnu.org/licenses/fdl.html">GNU FDL</a> 1.1 license.</p> <p>Index with some FAQ questions that are answered in the chapter:</p> <ol> -<li><a href="#c1">For all the lazy people</a> - <ul> - <li>This window management is just weird, I want it exactly like ircII</li> - </ul></li> -<li><a href="#c2">Basic user interface usage</a> + <li><a href="#for-all-the-ircii-people">For all the ircII people</a> <ul> - <li>Split windows work in weird way</li> - <li>How can I easily switch between windows?</li> - <li>But alt-1 etc. don't work!</li> - </ul></li> -<li><a href="#c3">Server and channel automation</a> + <li>This window management is just weird, I want it exactly like ircII</li> + </ul> + </li> + <li><a href="#basic-user-interface-usage">Basic user interface usage</a> <ul> - <li>How do I automatically connect to servers at startup?</li> - <li>How do I automatically join to channels at startup?</li> - <li>How do I automatically send commands to server at connect?</li> - </ul></li> -<li><a href="#c4">Setting up windows and automatically restoring them - at startup</a></li> -<li><a href="#c5">Status and msgs windows & message levels</a> + <li>Split windows work in weird way</li> + <li>How can I easily switch between windows?</li> + <li>But alt-1 etc. don’t work!</li> + </ul> + </li> + <li><a href="#server-and-channel-automation">Server and channel automation</a> <ul> - <li>I want /WHOIS to print reply to current window</li> - <li>I want all messages to go to one window, not create new windows</li> - </ul></li> -<li><a href="#c6">How support for multiple servers works in irssi</a> + <li>How do I automatically connect to servers at startup?</li> + <li>How do I automatically join to channels at startup?</li> + <li>How do I automatically send commands to server at connect?</li> + </ul> + </li> + <li><a href="#setting-up-windows-and-automatically-restoring-them-at-startup">Setting up windows and automatically restoring them at startup</a></li> + <li><a href="#status-and-msgs-windows--message-levels">Status and msgs windows & message levels</a> <ul> - <li>I connected to some server that doesn't respond and now irssi - keeps trying to reconnect to it again and again, how can I stop - it??</li> - <li>I want to have own status and/or msgs window for each servers</li> - </ul></li> -<li><a href="#c7">/LASTLOG and jumping around in scrollback</a> + <li>I want /WHOIS to print reply to current window</li> + <li>I want all messages to go to one window, not create new windows</li> + </ul> + </li> + <li><a href="#how-support-for-multiple-servers-works-in-irssi">How support for multiple servers works in irssi</a> <ul> - <li>How can I save all texts in a window to file?</li> - </ul></li> -<li><a href="#c8">Logging</a></li> -<li><a href="#c9">Changing keyboard bindings</a> + <li>I connected to some server that doesn’t respond and now irssi keeps trying to reconnect to it again and again, how can I stop it??</li> + <li>I want to have own status and/or msgs window for each servers</li> + </ul> + </li> + <li><a href="#lastlog-and-jumping-around-in-scrollback">/LASTLOG and jumping around in scrollback</a> <ul> - <li>How do I make F1 key do something?</li> - </ul></li> -<li><a href="#c10">Proxies and IRC bouncers</a> + <li>How can I save all texts in a window to file?</li> + </ul> + </li> + <li><a href="#logging">Logging</a></li> + <li><a href="#changing-keyboard-bindings">Changing keyboard bindings</a> <ul> - <li>What's this irssi-proxy?</li> - </ul></li> -<li><a href="#c11">Irssi's settings</a></li> -<li><a href="#c12">Statusbar</a> + <li>How do I make F1 key do something?</li> + </ul> + </li> + <li><a href="#proxies-and-irc-bouncers">Proxies and IRC bouncers</a></li> + <li><a href="#irssis-settings">Irssi’s settings</a></li> + <li><a href="#statusbar">Statusbar</a> <ul> - <li>I loaded a statusbar script but it's not visible anywhere!</li> - </ul></li> + <li>I loaded a statusbar script but it’s not visible anywhere!</li> + </ul> + </li> </ol> -<h3><a id="c1">1. For all the lazy people</a></h3> +<h2 id="for-all-the-ircii-people">1. For all the ircII people</h2> <p>These settings should give you pretty good defaults (the ones I use):</p> -<p>If colors don't work, and you know you're not going to use some -weird non-VT compatible terminal (you most probably aren't), just -say:</p> +<p>If colors don’t work, and you know you’re not going to use some weird non-VT compatible terminal (you most probably aren’t), just say:</p> -<pre> -/SET term_force_colors ON -</pre> +<pre><code> /SET term_force_colors ON +</code></pre> -<p>I don't like automatic query windows, I don't like status window, I do -like msgs window where all messages go:</p> +<p>I don’t like automatic query windows, I don’t like status window, I do like msgs window where all messages go:</p> -<pre> -/SET autocreate_own_query OFF -/SET autocreate_query_level DCCMSGS -/SET use_status_window OFF -/SET use_msgs_window ON -</pre> +<pre><code> /SET autocreate_own_query OFF + /SET autocreate_query_level DCCMSGS + /SET use_status_window OFF + /SET use_msgs_window ON +</code></pre> -<p>Disable automatic window closing when <code>/PART</code>ing channel or -<code>/UNQUERY</code>ing query:</p> +<p>Disable automatic window closing when <code>/PART</code>ing channel or <code>/UNQUERY</code>ing query:</p> -<pre> -/SET autoclose_windows OFF -/SET reuse_unused_windows ON -</pre> +<pre><code> /SET autoclose_windows OFF + /SET reuse_unused_windows ON +</code></pre> -<p>Here's the settings that make irssi work exactly like ircII in window -management (send me a note if you can think of more):</p> +<p>Here’s the settings that make irssi work exactly like ircII in window management (send me a note if you can think of more):</p> -<pre> -/SET autocreate_own_query OFF -/SET autocreate_query_level NONE -/SET use_status_window OFF -/SET use_msgs_window OFF -/SET reuse_unused_windows ON -/SET windows_auto_renumber OFF - -/SET autostick_split_windows OFF -/SET autoclose_windows OFF -/SET print_active_channel ON -</pre> +<pre><code> /SET autocreate_own_query OFF + /SET autocreate_query_level NONE + /SET use_status_window OFF + /SET use_msgs_window OFF + /SET reuse_unused_windows ON + /SET windows_auto_renumber OFF + + /SET autostick_split_windows OFF + /SET autoclose_windows OFF + /SET print_active_channel ON +</code></pre> <p>And example how to add servers:</p> -<p>(OFTC network, identify with nickserv and wait for 2 seconds before -joining channels)</p> +<p>(OFTC network, identify with nickserv and wait for 2 seconds before joining channels)</p> -<pre> -/NETWORK ADD -autosendcmd "/^msg nickserv identify pass;wait 2000" OFTC -</pre> +<pre><code> /NETWORK ADD -autosendcmd "/^msg nickserv ident pass;wait 2000" OFTC +</code></pre> <p>(NOTE: use /IRCNET with 0.8.9 and older)</p> -<p>Then add some servers to different networks (network is already set up -for them), irc.kpnqwest.fi is used by default for IRCNet but if it fails, -irc.funet.fi is tried next:</p> +<p>Then add some servers to different networks (network is already set up for them), irc.kpnqwest.fi is used by default for IRCNet but if it fails, irc.funet.fi is tried next:</p> -<pre> -/SERVER ADD -auto -network IRCnet irc.kpnqwest.fi 6667 -/SERVER ADD -network IRCnet irc.funet.fi 6667 -/SERVER ADD -auto -network efnet efnet.cs.hut.fi 6667 -</pre> +<pre><code> /SERVER ADD -auto -network IRCnet irc.kpnqwest.fi 6667 + /SERVER ADD -network IRCnet irc.funet.fi 6667 + /SERVER ADD -auto -network efnet efnet.cs.hut.fi 6667 +</code></pre> -<p>Automatically join to channels after connected to server, send op request -to bot after joined to efnet/#irssi:</p> +<p>Automatically join to channels after connected to server, send op request to bot after joined to efnet/#irssi:</p> -<pre> -/CHANNEL ADD -auto #irssi IRCnet -/CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet -</pre> +<pre><code> /CHANNEL ADD -auto #irssi IRCnet + /CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet +</code></pre> -If you want lines containing your nick to hilight: +<p>If you want lines containing your nick to hilight:</p> -<pre> -/HILIGHT nick -</pre> +<pre><code> /HILIGHT nick +</code></pre> -<h3><a id="c2">2. Basic user interface usage</a></h3> +<h2 id="basic-user-interface-usage">2. Basic user interface usage</h2> -<p>Windows can be scrolled up/down with PgUp and PgDown keys. If they don't -work for you, use Meta-p and Meta-n keys. For jumping to beginning or end of -the buffer, use <code>/SB HOME</code> and <code>/SB END</code> commands.</p> +<p>Windows can be scrolled up/down with PgUp and PgDown keys. If they don’t work for you, use Meta-p and Meta-n keys. For jumping to beginning or end of the buffer, use <code>/SB HOME</code> and <code>/SB END</code> commands.</p> -<p>By default, irssi uses "hidden windows" for everything. Hidden window is -created every time you <code>/JOIN</code> a channel or <code>/QUERY</code> -someone. There's several ways you can change between these windows:</p> +<p>By default, irssi uses “hidden windows” for everything. Hidden window is created every time you <code>/JOIN</code> a channel or <code>/QUERY</code> someone. There’s several ways you can change between these windows:</p> -<pre> -Meta-1, Meta-2, .. Meta-0 - Jump directly between windows 1-10 -Meta-q .. Meta-o - Jump directly between windows 11-19 -/WINDOW <number> - Jump to any window with specified number -Ctrl-P, Ctrl-N - Jump to previous / next window -</pre> +<pre><code> Meta-1, Meta-2, .. Meta-0 - Jump directly between windows 1-10 + Meta-q .. Meta-o - Jump directly between windows 11-19 + /WINDOW <number> - Jump to any window with specified number + Ctrl-P, Ctrl-N - Jump to previous / next window +</code></pre> -<p>Clearly the easiest way is to use Meta-number keys. And what is the Meta -key? ESC key always works as Meta, but there's also easier ways. ALT could -work as Meta, or if you have Windows keyboard, left Windows key might work -as Meta. If they don't work directly, you'll need to set a few X resources -(NOTE: these work with both xterm and rxvt):</p> +<p>Clearly the easiest way is to use Meta-number keys. And what is the Meta key? ESC key always works as Meta, but there’s also easier ways. ALT could work as Meta, or if you have Windows keyboard, left Windows key might work as Meta. If they don’t work directly, you’ll need to set a few X resources (NOTE: these work with both xterm and rxvt):</p> -<pre> -XTerm*eightBitInput: false -XTerm*metaSendsEscape: true -</pre> +<pre><code> XTerm*eightBitInput: false + XTerm*metaSendsEscape: true +</code></pre> -<p>With rxvt, you can also specify which key acts as Meta key. So if you -want to use ALT instead of Windows key for it, use:</p> +<p>With rxvt, you can also specify which key acts as Meta key. So if you want to use ALT instead of Windows key for it, use:</p> -<pre> -rxvt*modifier: alt -</pre> +<pre><code> rxvt*modifier: alt +</code></pre> <p>You could do this by changing the X key mappings:</p> -<pre> -xmodmap -e "keysym Alt_L = Meta_L Alt_L" -</pre> +<pre><code> xmodmap -e "keysym Alt_L = Meta_L Alt_L" +</code></pre> -<p>And how exactly do you set these X resources? For Debian, there's -<code>/etc/X11/Xresources/xterm</code> file where you can put them and it's -read automatically when X starts. <code>~/.Xresources</code> and -<code>~/.Xdefaults</code> files might also work. If you can't get anything -else to work, just copy and paste those lines to <code>~/.Xresources</code> -and directly call <code>xrdb -merge ~/.Xresources</code> in some xterm. -The resources affect only the new xterms you start, not existing ones.</p> +<p>And how exactly do you set these X resources? For Debian, there’s <code>/etc/X11/Xresources/xterm</code> file where you can put them and it’s read automatically when X starts. <code>~/.Xresources</code> and <code>~/.Xdefaults</code> files might also work. If you can’t get anything else to work, just copy and paste those lines to <code>~/.Xresources</code> and directly call <code>xrdb -merge ~/.Xresources</code> in some xterm. The resources affect only the new xterms you start, not existing ones.</p> -<p>Many windows SSH clients also don't allow usage of ALT. One excellent -client that does allow is putty, you can download it from -<a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/"> -http://www.chiark.greenend.org.uk/~sgtatham/putty/</a>.</p> +<p>Many windows SSH clients also don’t allow usage of ALT. One excellent client that does allow is putty, you can download it from <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/"> http://www.chiark.greenend.org.uk/~sgtatham/putty/</a>.</p> -<p>Irssi also supports split windows, they've had some problems in past -but I think they should work pretty well now :) Here's some commands -related to them:</p> +<p>Irssi also supports split windows, they’ve had some problems in past but I think they should work pretty well now :) Here’s some commands related to them:</p> -<pre> -/WINDOW NEW - Create new split window -/WINDOW NEW HIDE - Create new hidden window -/WINDOW CLOSE - Close split or hidden window +<pre><code> /WINDOW NEW - Create new split window + /WINDOW NEW HIDE - Create new hidden window + /WINDOW CLOSE - Close split or hidden window -/WINDOW HIDE [<number>|<name>] - Make the split window hidden window -/WINDOW SHOW <number>|<name> - Make the hidden window a split window + /WINDOW HIDE [<number>|<name>] - Make the split window hidden window + /WINDOW SHOW <number>|<name> - Make the hidden window a split window -/WINDOW SHRINK [<lines>] - Shrink the split window -/WINDOW GROW [<lines>] - Grow the split window -/WINDOW BALANCE - Balance the sizes of all split windows -</pre> + /WINDOW SHRINK [<lines>] - Shrink the split window + /WINDOW GROW [<lines>] - Grow the split window + /WINDOW BALANCE - Balance the sizes of all split windows +</code></pre> -<p>By default, irssi uses "sticky windowing" for split windows. This means -that windows created inside one split window cannot be moved to another -split window without some effort. For example you could have following -window layout:</p> +<p>By default, irssi uses “sticky windowing” for split windows. This means that windows created inside one split window cannot be moved to another split window without some effort. For example you could have following window layout:</p> -<pre> -Split window 1: win#1 - Status window, win#2 - Messages window -Split window 2: win#3 - IRCnet/#channel1, win#4 - IRCnet/#channel2 -Split window 3: win#5 - efnet/#channel1, win#6 - efnet/#channel2 -</pre> +<pre><code> Split window 1: win#1 - Status window, win#2 - Messages window + Split window 2: win#3 - IRCnet/#channel1, win#4 - IRCnet/#channel2 + Split window 3: win#5 - efnet/#channel1, win#6 - efnet/#channel2 +</code></pre> -<p>When you are in win#1 and press ALT-6, irssi jumps to split window -#3 and moves the efnet/#channel2 the active window.</p> +<p>When you are in win#1 and press ALT-6, irssi jumps to split window #3 and moves the efnet/#channel2 the active window.</p> -<p>With non-sticky windowing the windows don't have any relationship with -split windows, pressing ALT-6 in win#1 moves win#6 to split window 1 -and sets it active, except if win#6 was already visible in some other -split window irssi just changes to that split window. This it the way -windows work with ircii, if you prefer it you can set it with</p> +<p>With non-sticky windowing the windows don’t have any relationship with split windows, pressing ALT-6 in win#1 moves win#6 to split window 1 and sets it active, except if win#6 was already visible in some other split window irssi just changes to that split window. This it the way windows work with ircii, if you prefer it you can set it with</p> -<pre> -/SET autostick_split_windows OFF -</pre> +<pre><code> /SET autostick_split_windows OFF +</code></pre> -<p>Each window can have multiple channels, queries and other "window -items" inside them. If you don't like windows at all, you disable -automatic creating of them with</p> +<p>Each window can have multiple channels, queries and other “window items” inside them. If you don’t like windows at all, you disable automatic creating of them with</p> -<pre> -/SET autocreate_windows OFF -</pre> +<pre><code> /SET autocreate_windows OFF +</code></pre> -<p>And if you keep all channels in one window, you most probably want -the channel name printed in each line:</p> +<p>And if you keep all channels in one window, you most probably want the channel name printed in each line:</p> -<pre> -/SET print_active_channel ON -</pre> +<pre><code> /SET print_active_channel ON +</code></pre> -<p>If you want to group only some channels or queries in one window, -use</p> +<p>If you want to group only some channels or queries in one window, use</p> -<pre> -/JOIN -window #channel -/QUERY -window nick -</pre> +<pre><code> /JOIN -window #channel + /QUERY -window nick +</code></pre> -<h3><a id="c3">3. Server and channel automation</a></h3> +<h2 id="server-and-channel-automation">3. Server and channel automation</h2> -<p>Irssi's multiple IRC network support is IMHO very good - at least -compared to other clients :) Even if you're only in one IRC network you -should group all your servers to be in the same IRC network as this -helps with reconnecting if your primary server breaks and is probably -useful in some other ways too :) For information how to actually use -irssi correctly with multiple servers see the chapter 6.</p> +<p>Irssi’s multiple IRC network support is IMHO very good - at least compared to other clients :) Even if you’re only in one IRC network you should group all your servers to be in the same IRC network as this helps with reconnecting if your primary server breaks and is probably useful in some other ways too :) For information how to actually use irssi correctly with multiple servers see the chapter 6.</p> -<p>First you need to have your IRC network set, use <code>/NETWORK</code> -command to see if it's already there. If it isn't, use <code>/NETWORK ADD -yournetwork</code>. If you want to execute some commands automatically when -you're connected to some network, use <code>-autosendcmd</code> option. -(NOTE: use /IRCNET with 0.8.9 and older.) Here's some examples:</p> +<p>First you need to have your IRC network set, use <code>/NETWORK</code> command to see if it’s already there. If it isn’t, use <code>/NETWORK ADD yournetwork</code>. If you want to execute some commands automatically when you’re connected to some network, use <code>-autosendcmd</code> option. (NOTE: use /IRCNET with 0.8.9 and older.) Here’s some examples:</p> -<pre> -/NETWORK ADD -autosendcmd '^msg bot invite' IRCnet -/NETWORK ADD -autosendcmd "/^msg nickserv identify pass;wait 2000" OFTC -</pre> +<pre><code> /NETWORK ADD -autosendcmd '^msg bot invite' IRCnet + /NETWORK ADD -autosendcmd "/^msg nickserv ident pass;wait 2000" OFTC +</code></pre> <p>After that you need to add your servers. For example:</p> -<pre> -/SERVER ADD -auto -network IRCnet irc.kpnqwest.fi 6667 -/SERVER ADD -auto -network worknet irc.mycompany.com 6667 password -</pre> +<pre><code> /SERVER ADD -auto -network IRCnet irc.kpnqwest.fi 6667 + /SERVER ADD -auto -network worknet irc.mycompany.com 6667 password +</code></pre> -<p>The <code>-auto</code> option specifies that this server is -automatically connected at startup. You don't need to make more than one -server with <code>-auto</code> option to one IRC network, other servers are -automatically connected in same network if the <code>-auto</code> server -fails.</p> +<p>The <code>-auto</code> option specifies that this server is automatically connected at startup. You don’t need to make more than one server with <code>-auto</code> option to one IRC network, other servers are automatically connected in same network if the <code>-auto</code> server fails.</p> <p>And finally channels:</p> -<pre> -/CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet -/CHANNEL ADD -auto #secret IRCnet password -</pre> - -<p><code>-bots</code> and <code>-botcmd</code> should be the only ones -needing a bit of explaining. They're used to send commands automatically to -bot when channel is joined, usually to get ops automatically. You can -specify multiple bot masks with <code>-bots</code> option separated with -spaces (and remember to quote the string then). The $0 in -<code>-botcmd</code> specifies the first found bot in the list. If you -don't need the bot masks (ie. the bot is always with the same nick, like -chanserv) you can give only the <code>-botcmd</code> option and the command -is always sent.</p> - -<h3><a id="c4">4. Setting up windows and automatically restoring them at startup</a></h3> - -<p>First connect to all the servers, join the channels and create the -queries you want. If you want to move the windows or channels around -use commands:</p> +<pre><code> /CHANNEL ADD -auto -bots *!*bot@host.org -botcmd "/^msg $0 op pass" #irssi efnet + /CHANNEL ADD -auto #secret IRCnet password +</code></pre> -<pre> -/WINDOW MOVE LEFT/RIGHT/number - move window elsewhere -/WINDOW ITEM MOVE <number>|<name> - move channel/query to another window -</pre> +<p><code>-bots</code> and <code>-botcmd</code> should be the only ones needing a bit of explaining. They’re used to send commands automatically to bot when channel is joined, usually to get ops automatically. You can specify multiple bot masks with <code>-bots</code> option separated with spaces (and remember to quote the string then). The $0 in <code>-botcmd</code> specifies the first found bot in the list. If you don’t need the bot masks (ie. the bot is always with the same nick, like chanserv) you can give only the <code>-botcmd</code> option and the command is always sent.</p> -<p>When everything looks the way you like, use <code>/LAYOUT SAVE</code> -command (and <code>/SAVE</code>, if you don't have autosaving enabled) and -when you start irssi next time, irssi remembers the positions of the -channels, queries and everything. This "remembering" doesn't mean that -simply using <code>/LAYOUT SAVE</code> would automatically make irssi -reconnect to all servers and join all channels, you'll need the -<code>/SERVER ADD -auto</code> and <code>/CHANNEL ADD -auto</code> commands -to do that.</p> +<h2 id="setting-up-windows-and-automatically-restoring-them-at-startup">4. Setting up windows and automatically restoring them at startup</h2> -<p>If you want to change the layout, you just rearrange the layout like -you want it and use <code>/LAYOUT SAVE</code> again. If you want to remove -the layout for some reason, use <code>/LAYOUT RESET.</code></p> +<p>First connect to all the servers, join the channels and create the queries you want. If you want to move the windows or channels around use commands:</p> +<pre><code> /WINDOW MOVE LEFT/RIGHT/number - move window elsewhere + /WINDOW ITEM MOVE <number>|<name> - move channel/query to another window +</code></pre> -<h3><a id="c5">5. Status and msgs windows & message levels</a></h3> +<p>When everything looks the way you like, use <code>/LAYOUT SAVE</code> command (and <code>/SAVE</code>, if you don’t have autosaving enabled) and when you start irssi next time, irssi remembers the positions of the channels, queries and everything. This “remembering” doesn’t mean that simply using <code>/LAYOUT SAVE</code> would automatically make irssi reconnect to all servers and join all channels, you’ll need the <code>/SERVER ADD -auto</code> and <code>/CHANNEL ADD -auto</code> commands to do that.</p> -<p>By default, all the "extra messages" go to status window. This means -pretty much all messages that don't clearly belong to some channel or -query. Some people like it, some don't. If you want to remove it, use</p> +<p>If you want to change the layout, you just rearrange the layout like you want it and use <code>/LAYOUT SAVE</code> again. If you want to remove the layout for some reason, use <code>/LAYOUT RESET.</code></p> -<pre> -/SET use_status_window OFF -</pre> +<h2 id="status-and-msgs-windows--message-levels">5. Status and msgs windows & message levels</h2> -<p>This doesn't have any effect until you restart irssi. If you want to -remove it immediately, just <code>/WINDOW CLOSE</code> it.</p> +<p>By default, all the “extra messages” go to status window. This means pretty much all messages that don’t clearly belong to some channel or query. Some people like it, some don’t. If you want to remove it, use</p> -<p>Another common window is "messages window", where all private -messages go. By default it's disabled and query windows are created -instead. To make all private messages go to msgs window, say:</p> +<pre><code> /SET use_status_window OFF +</code></pre> -<pre> -/SET use_msgs_window ON -/SET autocreate_query_level DCCMSGS (or if you don't want queries to - dcc chats either, say NONE) -</pre> +<p>This doesn’t have any effect until you restart irssi. If you want to remove it immediately, just <code>/WINDOW CLOSE</code> it.</p> -<p>use_msgs_window either doesn't have any effect until restarting -irssi. To create it immediately say:</p> +<p>Another common window is “messages window”, where all private messages go. By default it’s disabled and query windows are created instead. To make all private messages go to msgs window, say:</p> -<pre> -/WINDOW NEW HIDE - create the window -/WINDOW NAME (msgs) - name it to "(msgs)" -/WINDOW LEVEL MSGS - make all private messages go to this window -/WINDOW MOVE 1 - move it to first window -</pre> +<pre><code> /SET use_msgs_window ON + /SET autocreate_query_level DCCMSGS (or if you don't want queries to + dcc chats either, say NONE) +</code></pre> -<p>Note that neither use_msgs_window nor use_status_window have any -effect at all if <code>/LAYOUT SAVE</code> has been used.</p> +<p>use_msgs_window either doesn’t have any effect until restarting irssi. To create it immediately say:</p> -<p>This brings us to message levels.. What are they? All messages that -irssi prints have one or more "message levels". Most common are PUBLIC -for public messages in channels, MSGS for private messages and CRAP for -all sorts of messages with no real classification. You can get a whole -list of levels with</p> +<pre><code> /WINDOW NEW HIDE - create the window + /WINDOW NAME (msgs) - name it to "(msgs)" + /WINDOW LEVEL MSGS - make all private messages go to this window + /WINDOW MOVE 1 - move it to first window +</code></pre> -<pre> -/HELP levels -</pre> +<p>Note that neither use_msgs_window nor use_status_window have any effect at all if <code>/LAYOUT SAVE</code> has been used.</p> -<p>Status window has message level <code>ALL -MSGS</code>, meaning that all -messages, except private messages, without more specific place go to status -window. The <code>-MSGS</code> is there so it doesn't conflict with -messages window.</p> +<p>This brings us to message levels.. What are they? All messages that irssi prints have one or more “message levels”. Most common are PUBLIC for public messages in channels, MSGS for private messages and CRAP for all sorts of messages with no real classification. You can get a whole list of levels with</p> +<pre><code> /HELP levels +</code></pre> -<h3><a id="c6">6. How support for multiple servers works in irssi</a></h3> +<p>Status window has message level <code>ALL -MSGS</code>, meaning that all messages, except private messages, without more specific place go to status window. The <code>-MSGS</code> is there so it doesn’t conflict with messages window.</p> -<p>ircii and several other clients support multiple servers by placing -the connection into some window. IRSSI DOES NOT. There is no required -relationship between window and server. You can connect to 10 servers -and manage them all in just one window, or join channel in each one of -them to one single window if you really want to. That being said, here's -how you do connect to new server without closing the old connection:</p> +<h2 id="how-support-for-multiple-servers-works-in-irssi">6. How support for multiple servers works in irssi</h2> -<pre> -/CONNECT irc.server.org -</pre> +<p>ircii and several other clients support multiple servers by placing the connection into some window. IRSSI DOES NOT. There is no required relationship between window and server. You can connect to 10 servers and manage them all in just one window, or join channel in each one of them to one single window if you really want to. That being said, here’s how you do connect to new server without closing the old connection:</p> -<p>Instead of the <code>/SERVER</code> which disconnects the existing -connection. To see list of all active connections, use <code>/SERVER</code> -without any parameters. You should see a list of something like:</p> +<pre><code> /CONNECT irc.server.org +</code></pre> -<pre> --!- IRCNet: irc.song.fi:6667 (IRCNet) --!- OFTC: irc.oftc.net:6667 (OFTC) --!- RECON-1: 192.168.0.1:6667 () (02:59 left before reconnecting) -</pre> +<p>Instead of the <code>/SERVER</code> which disconnects the existing connection. To see list of all active connections, use <code>/SERVER</code> without any parameters. You should see a list of something like:</p> -<p>Here you see that we're connected to IRCNet and OFTC networks. -The IRCNet at the beginning is called the "server tag" while the -(IRCnet) at the end shows the IRC network. Server tag specifies unique -tag to refer to the server, usually it's the same as the IRC network. -When the IRC network isn't known it's some part of the server name. -When there's multiple connections to same IRC network or server, irssi -adds a number after the tag so there could be network, network2, network3 -etc.</p> +<pre><code> -!- IRCNet: irc.song.fi:6667 (IRCNet) + -!- OFTC: irc.oftc.net:6667 (OFTC) + -!- RECON-1: 192.168.0.1:6667 () (02:59 left before reconnecting) +</code></pre> -<p>Server tags beginning with <code>RECON-</code> mean server -reconnections. Above we see that connection to server at 192.168.0.1 wasn't -successful and irssi will try to connect it again in 3 minutes.</p> +<p>Here you see that we’re connected to IRCNet and OFTC networks. The IRCNet at the beginning is called the “server tag” while the (IRCnet) at the end shows the IRC network. Server tag specifies unique tag to refer to the server, usually it’s the same as the IRC network. When the IRC network isn’t known it’s some part of the server name. When there’s multiple connections to same IRC network or server, irssi adds a number after the tag so there could be network, network2, network3 etc.</p> -<p>To disconnect one of the servers, or to stop irssi from -reconnecting, use</p> +<p>Server tags beginning with <code>RECON-</code> mean server reconnections. Above we see that connection to server at 192.168.0.1 wasn’t successful and irssi will try to connect it again in 3 minutes.</p> -<pre> -/DISCONNECT network - disconnect server with tag "network" -/DISCONNECT recon-1 - stop trying to reconnect to RECON-1 server -/RMRECONNS - stop all server reconnections +<p>To disconnect one of the servers, or to stop irssi from reconnecting, use</p> -/RECONNECT recon-1 - immediately try reconnecting back to RECON-1 -/RECONNECT ALL - immediately try reconnecting back to all - servers in reconnection queue -</pre> +<pre><code> /DISCONNECT network - disconnect server with tag "network" + /DISCONNECT recon-1 - stop trying to reconnect to RECON-1 server + /RMRECONNS - stop all server reconnections -<p>Now that you're connected to all your servers, you'll have to know how -to specify which one of them you want to use. One way is to have an -empty window, like status or msgs window. In it, you can specify which -server to set active with</p> + /RECONNECT recon-1 - immediately try reconnecting back to RECON-1 + /RECONNECT ALL - immediately try reconnecting back to all + servers in reconnection queue +</code></pre> -<pre> -/WINDOW SERVER tag - set server "tag" active -Ctrl-X - set the next server in list active -</pre> +<p>Now that you’re connected to all your servers, you’ll have to know how to specify which one of them you want to use. One way is to have an empty window, like status or msgs window. In it, you can specify which server to set active with</p> -<p>When the server is active, you can use it normally. When there's -multiple connected servers, irssi adds [servertag] prefix to all -messages in non-channel/query messages so you'll know where it came -from.</p> +<pre><code> /WINDOW SERVER tag - set server "tag" active + Ctrl-X - set the next server in list active +</code></pre> -<p>Several commands also accept <code>-servertag</code> option to specify -which server it should use:</p> +<p>When the server is active, you can use it normally. When there’s multiple connected servers, irssi adds [servertag] prefix to all messages in non-channel/query messages so you’ll know where it came from.</p> -<pre> -/MSG -tag nick message -/JOIN -tag #channel -/QUERY -tag nick -</pre> +<p>Several commands also accept <code>-servertag</code> option to specify which server it should use:</p> -<p><code>/MSG</code> tab completion also automatically adds the -<code>-tag</code> option when nick isn't in active server.</p> +<pre><code> /MSG -tag nick message + /JOIN -tag #channel + /QUERY -tag nick +</code></pre> -<p>Window's server can be made sticky. When sticky, it will never -automatically change to anything else, and if server gets disconnected, the -window won't have any active server. When the server gets connected again, -it is automatically set active in the window. To set the window's server -sticky use</p> +<p><code>/MSG</code> tab completion also automatically adds the <code>-tag</code> option when nick isn’t in active server.</p> -<pre> -/WINDOW SERVER -sticky tag -</pre> +<p>Window’s server can be made sticky. When sticky, it will never automatically change to anything else, and if server gets disconnected, the window won’t have any active server. When the server gets connected again, it is automatically set active in the window. To set the window’s server sticky use</p> -<p>This is useful if you wish to have multiple status or msgs windows, one -for each server. Here's how to do them (repeat for each server)</p> +<pre><code> /WINDOW SERVER -sticky tag +</code></pre> -<pre> -/WINDOW NEW HIDE -/WINDOW NAME (status) -/WINDOW LEVEL ALL -MSGS -/WINDOW SERVER -sticky network - -/WINDOW NEW HIDE -/WINDOW NAME (msgs) -/WINDOW LEVEL MSGS -/WINDOW SERVER -sticky network -</pre> +<p>This is useful if you wish to have multiple status or msgs windows, one for each server. Here’s how to do them (repeat for each server)</p> -<h3><a id="c7">7. /LASTLOG and jumping around in scrollback</a></h3> +<pre><code> /WINDOW NEW HIDE + /WINDOW NAME (status) + /WINDOW LEVEL ALL -MSGS + /WINDOW SERVER -sticky network -<p><code>/LASTLOG</code> command can be used for searching texts in -scrollback buffer. Simplest usages are</p> + /WINDOW NEW HIDE + /WINDOW NAME (msgs) + /WINDOW LEVEL MSGS + /WINDOW SERVER -sticky network +</code></pre> -<pre> -/LASTLOG word - print all lines with "word" in them -/LASTLOG word 10 - print last 10 occurrences of "word" -/LASTLOG -topics - print all topic changes -</pre> +<h2 id="lastlog-and-jumping-around-in-scrollback">7. /LASTLOG and jumping around in scrollback</h2> -<p>If there's more than 1000 lines to be printed, irssi thinks that you -probably made some mistake and won't print them without <code>-force</code> -option. If you want to save the full lastlog to file, use</p> +<p><code>/LASTLOG</code> command can be used for searching texts in scrollback buffer. Simplest usages are</p> -<pre> -/LASTLOG -file ~/irc.log -</pre> +<pre><code> /LASTLOG word - print all lines with "word" in them + /LASTLOG word 10 - print last 10 occurances of "word" + /LASTLOG -topics - print all topic changes +</code></pre> -<p>With <code>-file</code> option you don't need <code>-force</code> even -if there's more than 1000 lines. <code>/LASTLOG</code> has a lot of other -options too, see <code>/HELP lastlog</code> for details.</p> +<p>If there’s more than 1000 lines to be printed, irssi thinks that you probably made some mistake and won’t print them without <code>-force</code> option. If you want to save the full lastlog to file, use</p> -<p>Once you've found the lines you were interested in, you might want -to check the discussion around them. Irssi has <code>/SCROLLBACK</code> (or -alias <code>/SB</code>) command for jumping around in scrollback buffer. -Since <code>/LASTLOG</code> prints the timestamp when the message was -originally printed, you can use <code>/SB GOTO hh:mm</code> to jump -directly there. To get back to the bottom of scrollback, use <code>/SB -END</code> command.</p> +<pre><code> /LASTLOG -file ~/irc.log +</code></pre> +<p>With <code>-file</code> option you don’t need <code>-force</code> even if there’s more than 1000 lines. <code>/LASTLOG</code> has a lot of other options too, see <code>/HELP lastlog</code> for details.</p> -<h3><a id="c8">8. Logging</a></h3> +<p>Once you’ve found the lines you were interested in, you might want to check the discussion around them. Irssi has <code>/SCROLLBACK</code> (or alias <code>/SB</code>) command for jumping around in scrollback buffer. Since <code>/LASTLOG</code> prints the timestamp when the message was originally printed, you can use <code>/SB GOTO hh:mm</code> to jump directly there. To get back to the bottom of scrollback, use <code>/SB END</code> command.</p> -<p>Irssi can automatically log important messages when you're set away -(<code>/AWAY reason</code>). When you set yourself unaway -(<code>/AWAY</code>), the new messages in away log are printed to screen. -You can configure it with:</p> +<h2 id="logging">8. Logging</h2> -<pre> -/SET awaylog_level MSGS HILIGHT - Specifies what messages to log -/SET awaylog_file ~/.irssi/away.log - Specifies the file to use -</pre> +<p>Irssi can automatically log important messages when you’re set away (<code>/AWAY reason</code>). When you set yourself unaway (<code>/AWAY</code>), the new messages in away log are printed to screen. You can configure it with:</p> -<p>Easiest way to start logging with Irssi is to use autologging. With it -Irssi logs all channels and private messages to specified directory. -You can turn it on with</p> +<pre><code> /SET awaylog_level MSGS HILIGHT - Specifies what messages to log + /SET awaylog_file ~/.irssi/away.log - Specifies the file to use +</code></pre> -<pre> -/SET autolog ON -</pre> +<p>Easiest way to start logging with Irssi is to use autologging. With it Irssi logs all channels and private messages to specified directory. You can turn it on with</p> -<p>By default it logs pretty much everything execept CTCPS or CRAP -(<code>/WHOIS</code> requests, etc). You can specify the logging level -yourself with</p> +<pre><code> /SET autolog ON +</code></pre> -<pre> -/SET autolog_level ALL -CRAP -CLIENTCRAP -CTCPS (this is the default) -</pre> +<p>By default it logs pretty much everything execept CTCPS or CRAP (<code>/WHOIS</code> requests, etc). You can specify the logging level yourself with</p> -<p>By default irssi logs to ~/irclogs/<servertag>/<target>.log. -You can change this with</p> +<pre><code> /SET autolog_level ALL -CRAP -CLIENTCRAP -CTCPS (this is the default) +</code></pre> -<pre> -/SET autolog_path ~/irclogs/$tag/$0.log (this is the default) -</pre> +<p>By default irssi logs to ~/irclogs/<servertag>/<target>.log. You can change this with</target></servertag></p> -<p>The path is automatically created if it doesn't exist. $0 specifies -the target (channel/nick). You can make irssi automatically rotate the -logs by adding date/time formats to the file name. The formats are in -"man strftime" format. For example</p> +<pre><code> /SET autolog_path ~/irclogs/$tag/$0.log (this is the default) +</code></pre> -<pre> -/SET autolog_path ~/irclogs/%Y/$tag/$0.%m-%d.log -</pre> +<p>The path is automatically created if it doesn’t exist. $0 specifies the target (channel/nick). You can make irssi automatically rotate the logs by adding date/time formats to the file name. The formats are in “man strftime” format. For example</p> -<p>For logging only some specific channels or nicks, see <code>/HELP -log</code></p> +<pre><code> /SET autolog_path ~/irclogs/%Y/$tag/$0.%m-%d.log +</code></pre> +<p>For logging only some specific channels or nicks, see <code>/HELP log</code></p> -<h3><a id="c9">9. Changing keyboard bindings</a></h3> +<h2 id="changing-keyboard-bindings">9. Changing keyboard bindings</h2> -<p>You can change any keyboard binding that terminal lets irssi know -about. It doesn't let irssi know everything, so for example -shift-backspace can't be bound unless you modify xterm resources -somehow.</p> +<p>You can change any keyboard binding that terminal lets irssi know about. It doesn’t let irssi know everything, so for example shift-backspace can’t be bound unless you modify xterm resources somehow.</p> -<p><code>/HELP bind</code> tells pretty much everything there is to know -about keyboard bindings. However, there's the problem of how to bind some -non-standard keys. They might differ a bit with each terminal, so you'll -need to find out what exactly the keypress produces. Easiest way to check -that would be to see what it prints in <code>cat</code>. Here's an example -for pressing F1 key:</p> +<p><code>/HELP bind</code> tells pretty much everything there is to know about keyboard bindings. However, there’s the problem of how to bind some non-standard keys. They might differ a bit with each terminal, so you’ll need to find out what exactly the keypress produces. Easiest way to check that would be to see what it prints in <code>cat</code>. Here’s an example for pressing F1 key:</p> -<pre> -[cras@hurina] ~% cat -^[OP -</pre> +<pre><code> [cras@hurina] ~% cat + ^[OP +</code></pre> -<p>So in irssi you would use <code>/BIND ^[OP /ECHO F1 pressed</code>. If -you use multiple terminals which have different bindings for the key, it -would be better to use eg.:</p> +<p>So in irssi you would use <code>/BIND ^[OP /ECHO F1 pressed</code>. If you use multiple terminals which have different bindings for the key, it would be better to use eg.:</p> -<pre> -/BIND ^[OP key F1 -/BIND ^[11~ key F1 -/BIND F1 /ECHO F1 pressed. -</pre> +<pre><code> /BIND ^[OP key F1 + /BIND ^[11~ key F1 + /BIND F1 /ECHO F1 pressed. +</code></pre> -<h3><a id="c10">10. Proxies and IRC bouncers</a></h3> +<h2 id="proxies-and-irc-bouncers">10. Proxies and IRC bouncers</h2> -<p>Irssi supports connecting to IRC servers via a proxy. All server -connections are then made through it, and if you've set up everything -properly, you don't need to do any <code>/QUOTE SERVER</code> commands -manually.</p> +<p>Irssi supports connecting to IRC servers via a proxy. All server connections are then made through it, and if you’ve set up everything properly, you don’t need to do any <code>/QUOTE SERVER</code> commands manually.</p> -<p>Here's an example: You have your bouncer (lets say, BNC or BNC-like) -listening in irc.bouncer.org port 5000. You want to use it to connect -to servers irc.dalnet and irc.efnet.org. First you'd need to setup the -bouncer:</p> +<p>Here’s an example: You have your bouncer (lets say, BNC or BNC-like) listening in irc.bouncer.org port 5000. You want to use it to connect to servers irc.dalnet and irc.efnet.org. First you’d need to setup the bouncer:</p> -<pre> -/SET use_proxy ON -/SET proxy_address irc.bouncer.org -/SET proxy_port 5000 +<pre><code> /SET use_proxy ON + /SET proxy_address irc.bouncer.org + /SET proxy_port 5000 -/SET proxy_password YOUR_BNC_PASSWORD_HERE -/SET -clear proxy_string -/SET proxy_string_after conn %s %d -</pre> + /SET proxy_password YOUR_BNC_PASSWORD_HERE + /SET -clear proxy_string + /SET proxy_string_after conn %s %d +</code></pre> -<p>Then you'll need to add the server connections. These are done -exactly as if you'd want to connect directly to them. Nothing special -about them:</p> +<p>Then you’ll need to add the server connections. These are done exactly as if you’d want to connect directly to them. Nothing special about them:</p> -<pre> -/SERVER ADD -auto -network dalnet irc.dal.net -/SERVER ADD -auto -network efnet irc.efnet.org -</pre> +<pre><code> /SERVER ADD -auto -network dalnet irc.dal.net + /SERVER ADD -auto -network efnet irc.efnet.org +</code></pre> -<p>With the proxy <code>/SET</code>s however, irssi now connects to those -servers through your BNC. All server connections are made through them so -you can just forget that your bouncer even exists.</p> +<p>With the proxy <code>/SET</code>s however, irssi now connects to those servers through your BNC. All server connections are made through them so you can just forget that your bouncer even exists.</p> -<p>If you don't want to use the proxy for some reason, there's -<code>-noproxy</code> option which you can give to <code>/SERVER</code> and -<code>/SERVER ADD</code> commands.</p> +<p>If you don’t want to use the proxy for some reason, there’s <code>-noproxy</code> option which you can give to <code>/SERVER</code> and <code>/SERVER ADD</code> commands.</p> <p><strong>Proxy specific settings:</strong></p> <p>All proxies have these settings in common:</p> -<pre> -/SET use_proxy ON -/SET proxy_address <Proxy host address> -/SET proxy_port <Proxy port> -</pre> +<pre><code> /SET use_proxy ON + /SET proxy_address <Proxy host address> + /SET proxy_port <Proxy port> +</code></pre> <p><strong>HTTP proxy</strong></p> <p>Use these settings with HTTP proxies:</p> -<pre> -/SET -clear proxy_password -/EVAL SET proxy_string CONNECT %s:%d HTTP/1.0\n\n -</pre> +<pre><code> /SET -clear proxy_password + /EVAL SET proxy_string CONNECT %s:%d HTTP/1.0\n\n +</code></pre> <p><strong>BNC</strong></p> -<pre> -/SET proxy_password your_pass -/SET -clear proxy_string -/SET proxy_string_after conn %s %d -</pre> +<pre><code> /SET proxy_password your_pass + /SET -clear proxy_string + /SET proxy_string_after conn %s %d +</code></pre> <p><strong>dircproxy</strong></p> -<p>dircproxy separates the server connections by passwords. So, if you -for example have network connection with password ircpass and -OFTC connection with oftcpass, you would do something like -this:</p> +<p>dircproxy separates the server connections by passwords. So, if you for example have network connection with password ircpass and OFTC connection with oftcpass, you would do something like this:</p> -<pre> -/SET -clear proxy_password -/SET -clear proxy_string +<pre><code> /SET -clear proxy_password + /SET -clear proxy_string -/SERVER ADD -auto -network IRCnet fake.network 6667 ircpass -/SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass -</pre> + /SERVER ADD -auto -network IRCnet fake.network 6667 ircpass + /SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass +</code></pre> -<p>The server name and port you give isn't used anywhere, so you can -put anything you want in there.</p> +<p>The server name and port you give isn’t used anywhere, so you can put anything you want in there.</p> <p><strong>psyBNC</strong></p> -<p>psyBNC has internal support for multiple servers. However, it could -be a bit annoying to use, and some people just use different users for -connecting to different servers. You can manage this in a bit same way -as with dircproxy, by creating fake connections:</p> +<p>psyBNC has internal support for multiple servers. However, it could be a bit annoying to use, and some people just use different users for connecting to different servers. You can manage this in a bit same way as with dircproxy, by creating fake connections:</p> -<pre> -/SET -clear proxy_password -/SET -clear proxy_string +<pre><code> /SET -clear proxy_password + /SET -clear proxy_string -/NETWORK ADD -user networkuser IRCnet -/SERVER ADD -auto -network IRCnet fake.network 6667 ircpass -/NETWORK ADD -user oftcuser OFTC -/SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass -</pre> + /NETWORK ADD -user networkuser IRCnet + /SERVER ADD -auto -network IRCnet fake.network 6667 ircpass + /NETWORK ADD -user oftcuser OFTC + /SERVER ADD -auto -network OFTC fake.oftc 6667 oftcpass +</code></pre> -<p>So, you'll specify the usernames with <code>/NETWORK ADD</code> command, -and the user's password with <code>/SERVER ADD</code>.</p> +<p>So, you’ll specify the usernames with <code>/NETWORK ADD</code> command, and the user’s password with <code>/SERVER ADD</code>.</p> <p>(NOTE: use /IRCNET with 0.8.9 and older.)</p> <p><strong>Irssi proxy</strong></p> -<p>Irssi contains it's own proxy which you can build giving -<code>--with-proxy</code> option to configure. You'll still need to run -irssi in a screen to use it though.</p> +<p>Irssi contains it’s own proxy which you can build giving <code>\--with-proxy</code> option to configure. You’ll still need to run irssi in a screen to use it though.</p> -<p>Irssi proxy is a bit different than most proxies, normally proxies -create a new connection to IRC server when you connect to it, but -<strong>irssi proxy shares your existing IRC connection(s) to multiple -clients</strong>. And even more clearly: <strong>You can use only one IRC -server connection to IRC with as many clients as you want</strong>. Can -anyone figure out even more easier ways to say this, so I wouldn't need to -try to explain this thing for minutes every time? :)</p> +<p>Irssi proxy is a bit different than most proxies, normally proxies create a new connection to IRC server when you connect to it, but <strong>irssi proxy shares your existing IRC connection(s) to multiple clients</strong>. And even more clearly: <strong>You can use only one IRC server connection to IRC with as many clients as you want</strong>. Can anyone figure out even more easier ways to say this, so I wouldn’t need to try to explain this thing for minutes every time? :)</p> -<p>Irssi proxy supports sharing multiple server connections in different -ports, like you can share network in port 2777 and efnet in port 2778.</p> +<p>Irssi proxy supports sharing multiple server connections in different ports, like you can share network in port 2777 and efnet in port 2778.</p> <p>Usage in proxy side:</p> -<pre> -/LOAD proxy -/SET irssiproxy_password <password> -/SET irssiproxy_ports <network>=<port> ... (eg. IRCnet=2777 efnet=2778) -</pre> +<pre><code> /LOAD proxy + /SET irssiproxy_password <password> + /SET irssiproxy_ports <network>=<port> ... (eg. IRCnet=2777 efnet=2778) +</code></pre> -<p><strong>NOTE</strong>: you <strong>MUST</strong> add all the servers you -are using to server and network lists with <code>/SERVER ADD</code> and -<code>/NETWORK ADD</code>. ..Except if you really don't want to for some -reason, and you only use one server connection, you may simply set:</p> +<p><strong>NOTE</strong>: you <strong>MUST</strong> add all the servers you are using to server and network lists with <code>/SERVER ADD</code> and <code>/NETWORK ADD</code>. ..Except if you really don’t want to for some reason, and you only use one server connection, you may simply set:</p> -<pre> -/SET irssiproxy_ports *=2777 -</pre> +<pre><code> /SET irssiproxy_ports *=2777 +</code></pre> <p>The special network name <code>?</code> allows the client to select the network dynamically on connect (see below):</p> @@ -744,13 +506,11 @@ network dynamically on connect (see below):</p> <p>Usage in client side:</p> -<p>Just connect to the irssi proxy like it is a normal server with password -specified in <code>/SET irssiproxy_password</code>. For example:</p> +<p>Just connect to the irssi proxy like it is a normal server with password specified in <code>/SET irssiproxy_password</code>. For example:</p> -<pre> -/SERVER ADD -network IRCnet my.irssi-proxy.org 2777 secret -/SERVER ADD -network efnet my.irssi-proxy.org 2778 secret -</pre> +<pre><code> /SERVER ADD -network IRCnet my.irssi-proxy.org 2777 secret + /SERVER ADD -network efnet my.irssi-proxy.org 2778 secret +</code></pre> <p>Or, if you used <code>?</code> in <code>irssiproxy_ports</code>:</p> @@ -766,231 +526,138 @@ separated by <code>:</code> from the actual proxy password.</p> <p><strong>SOCKS</strong></p> -Irssi can be compiled with socks support (<code>--with-socks</code> option -to configure), but I don't really know how it works, if at all. <code>/SET -proxy</code> settings don't have anything to do with socks however. +<p>Irssi can be compiled with socks support (<code>\--with-socks</code> option to configure), but I don’t really know how it works, if at all. <code>/SET proxy</code> settings don’t have anything to do with socks however.</p> <p><strong>Others</strong></p> -<p>IRC bouncers usually work like IRC servers, and want a password. You can -give it with:</p> +<p>IRC bouncers usually work like IRC servers, and want a password. You can give it with:</p> -<pre> -/SET proxy_password <password> -</pre> +<pre><code> /SET proxy_password <password> +</code></pre> -<p>Irssi's defaults for connect strings are</p> +<p>Irssi’s defaults for connect strings are</p> -<pre> -/SET proxy_string CONNECT %s %d -/SET proxy_string_after -</pre> +<pre><code> /SET proxy_string CONNECT %s %d + /SET proxy_string_after +</code></pre> -<p>The proxy_string is sent before NICK/USER commands, the -proxy_string_after is sent after them. %s and %d can be used with both -of them.</p> +<p>The proxy_string is sent before NICK/USER commands, the proxy_string_after is sent after them. %s and %d can be used with both of them.</p> -<h3><a id="c11">11. Irssi's settings</a></h3> +<h2 id="irssis-settings">11. Irssi’s settings</h2> -<p>You probably don't like Irssi's default settings. I don't like them. -But I'm still convinced that they're pretty good defaults. Here's some -of them you might want to change (the default value is shown):</p> +<p>You probably don’t like Irssi’s default settings. I don’t like them. But I’m still convinced that they’re pretty good defaults. Here’s some of them you might want to change (the default value is shown): Also check the <a href="/documentation/settings/">Settings Documentation</a></p> <p><strong>Queries</strong></p> <dl> -<dt>/SET autocreate_own_query ON</dt> - <dd>Should new query window be created when you send message to someone - (with <code>/MSG</code>).</dd> - -<dt>/SET autocreate_query_level MSGS</dt> - <dd>New query window should be created when receiving messages with - this level. MSGS, DCCMSGS and NOTICES levels work currently. You can - disable this with <code>/SET -clear autocreate_query_level</code>.</dd> - -<dt>/SET autoclose_query 0</dt> - <dd>Query windows can be automatically closed after certain time of - inactivity. Queries with unread messages aren't closed and active - window is neither never closed. The value is given in seconds.</dd> + <dt>/SET autocreate_own_query ON</dt> + <dd>Should new query window be created when you send message to someone (with <code>/MSG</code>).</dd> + <dt>/SET autocreate_query_level MSGS</dt> + <dd>New query window should be created when receiving messages with this level. MSGS, DCCMSGS and NOTICES levels work currently. You can disable this with <code>/SET -clear autocreate_query_level</code>.</dd> + <dt>/SET autoclose_query 0</dt> + <dd>Query windows can be automatically closed after certain time of inactivity. Queries with unread messages aren’t closed and active window is neither never closed. The value is given in seconds.</dd> </dl> <p><strong>Windows</strong></p> <dl> -<dt>/SET use_msgs_window OFF</dt> - <dd>Create messages window at startup. All private messages go to this - window. This only makes sense if you've disabled automatic query - windows. Message window can also be created manually with /WINDOW LEVEL - MSGS, /WINDOW NAME (msgs).</dd> - -<dt>/SET use_status_window ON</dt> - <dd>Create status window at startup. All messages that don't really - have better place go here, like all /WHOIS replies etc. Status window - can also be created manually with <code>/WINDOW LEVEL ALL -MSGS</code>, - <code>/WINDOW NAME (status)</code>.</dd> - -<dt>/SET autocreate_windows ON</dt> - <dd>Should we create new windows for new window items or just place - everything in one window</dd> - -<dt>/SET autoclose_windows ON</dt> - <dd>Should window be automatically closed when the last item in them is - removed (ie. <code>/PART</code>, <code>/UNQUERY</code>).</dd> - -<dt>/SET reuse_unused_windows OFF</dt> - <dd>When finding where to place new window item (channel, query) Irssi - first tries to use already existing empty windows. If this is set ON, - new window will always be created for all window items. This setting is - ignored if autoclose_windows is set ON.</dd> - -<dt>/SET window_auto_change OFF</dt> - <dd>Should Irssi automatically change to automatically created windows - - usually queries when someone sends you a message. To prevent - accidentally sending text meant to some other channel/nick, Irssi - clears the input buffer when changing the window. The text is still in - scrollback buffer, you can get it back with pressing arrow up key.</dd> - -<dt>/SET print_active_channel OFF</dt> - <dd>When you keep more than one channel in same window, Irssi prints - the messages coming to active channel as <code><nick> text</code> - and other channels as <code><nick:channel> text</code>. If this - setting is set ON, the messages to active channels are also printed in - the latter way.</dd> - -<dt>/SET window_history OFF</dt> + <dt>/SET use_msgs_window OFF</dt> + <dd>Create messages window at startup. All private messages go to this window. This only makes sense if you’ve disabled automatic query windows. Message window can also be created manually with /WINDOW LEVEL MSGS, /WINDOW NAME (msgs).</dd> + <dt>/SET use_status_window ON</dt> + <dd>Create status window at startup. All messages that don’t really have better place go here, like all /WHOIS replies etc. Status window can also be created manually with <code>/WINDOW LEVEL ALL -MSGS</code>, <code>/WINDOW NAME (status)</code>.</dd> + <dt>/SET autocreate_windows ON</dt> + <dd>Should we create new windows for new window items or just place everything in one window</dd> + <dt>/SET autoclose_windows ON</dt> + <dd>Should window be automatically closed when the last item in them is removed (ie. <code>/PART</code>, <code>/UNQUERY</code>).</dd> + <dt>/SET reuse_unused_windows OFF</dt> + <dd>When finding where to place new window item (channel, query) Irssi first tries to use already existing empty windows. If this is set ON, new window will always be created for all window items. This setting is ignored if autoclose_windows is set ON.</dd> + <dt>/SET window_auto_change OFF</dt> + <dd>Should Irssi automatically change to automatically created windows - usually queries when someone sends you a message. To prevent accidentally sending text meant to some other channel/nick, Irssi clears the input buffer when changing the window. The text is still in scrollback buffer, you can get it back with pressing arrow up key.</dd> + <dt>/SET print_active_channel OFF</dt> + <dd>When you keep more than one channel in same window, Irssi prints the messages coming to active channel as <code><nick> text</code> and other channels as <code><nick:channel> text</code>. If this setting is set ON, the messages to active channels are also printed in the latter way.</dd> + <dt>/SET window_history OFF</dt> <dd>Should command history be kept separate for each window.</dd> </dl> - <p><strong>User information</strong></p> <dl> -<dt>/SET nick</dt> + <dt>/SET nick</dt> <dd>Your nick name</dd> - -<dt>/SET alternate_nick</dt> + <dt>/SET alternate_nick</dt> <dd>Your alternate nick.</dd> - -<dt>/SET user_name</dt> - <dd>Your username, if you have ident enabled this doesn't affect - anything</dd> - -<dt>/SET real_name</dt> + <dt>/SET user_name</dt> + <dd>Your username, if you have ident enabled this doesn’t affect anything</dd> + <dt>/SET real_name</dt> <dd>Your real name.</dd> </dl> - <p><strong>Server information</strong></p> <dl> -<dt>/SET skip_motd OFF</dt> - <dd>Should we hide server's MOTD (Message Of The Day).</dd> - -<dt>/SET server_reconnect_time 300</dt> - <dd>Seconds to wait before connecting to same server again. Don't set - this too low since it usually doesn't help at all - if the host is - down, the few extra minutes of waiting won't hurt much.</dd> - -<dt>/SET lag_max_before_disconnect 300</dt> - <dd>Maximum server lag in seconds before disconnecting and trying to - reconnect. This happens mostly only when network breaks between you and - IRC server.</dd> + <dt>/SET skip_motd OFF</dt> + <dd>Should we hide server’s MOTD (Message Of The Day).</dd> + <dt>/SET server_reconnect_time 300</dt> + <dd>Seconds to wait before connecting to same server again. Don’t set this too low since it usually doesn’t help at all - if the host is down, the few extra minutes of waiting won’t hurt much.</dd> + <dt>/SET lag_max_before_disconnect 300</dt> + <dd>Maximum server lag in seconds before disconnecting and trying to reconnect. This happens mostly only when network breaks between you and IRC server.</dd> </dl> - <p><strong>Appearance</strong></p> <dl> -<dt>/SET timestamps ON</dt> + <dt>/SET timestamps ON</dt> <dd>Show timestamps before each message.</dd> - -<dt>/SET hide_text_style OFF</dt> + <dt>/SET hide_text_style OFF</dt> <dd>Hide all bolds, underlines, MIRC colors, etc.</dd> - -<dt>/SET show_nickmode ON</dt> - <dd>Show the nick's mode before nick in channels, ie. ops have - <code><@nick></code>, voices <code><+nick></code> and others - <code>< nick></code></dd> - -<dt>/SET show_nickmode_empty ON</dt> - <dd>If the nick doesn't have a mode, use one space. ie. ON: - <code>< nick></code>, OFF: <code><nick></code></dd> - -<dt>/SET show_quit_once OFF</dt> - <dd>Show quit message only once in some of the channel windows the - nick was in instead of in all windows.</dd> - -<dt>/SET lag_min_show 100</dt> - <dd>Show the server lag in status bar if it's bigger than this, the - unit is 1/100 of seconds (ie. the default value of 100 = 1 second).</dd> - -<dt>/SET indent 10</dt> - <dd>When lines are longer than screen width they have to be split to - multiple lines. This specifies how much space to put at the beginning - of the line before the text begins. This can be overridden in text - formats with <code>%|</code> format.</dd> - -<dt>/SET activity_hide_targets</dt> - <dd>If you don't want to see window activity in some certain channels - or queries, list them here. For example <code>#boringchannel =bot1 - =bot2</code>. If any highlighted text or message for you appears in that - window, this setting is ignored and the activity is shown.</dd> + <dt>/SET show_nickmode ON</dt> + <dd>Show the nick’s mode before nick in channels, ie. ops have <code><@nick></code>, voices <code><+nick></code> and others <code>< nick></code></dd> + <dt>/SET show_nickmode_empty ON</dt> + <dd>If the nick doesn’t have a mode, use one space. ie. ON: <code>< nick></code>, OFF: <code><nick></code></dd> + <dt>/SET show_quit_once OFF</dt> + <dd>Show quit message only once in some of the channel windows the nick was in instead of in all windows.</dd> + <dt>/SET lag_min_show 100</dt> + <dd>Show the server lag in status bar if it’s bigger than this, the unit is 1/100 of seconds (ie. the default value of 100 = 1 second).</dd> + <dt>/SET indent 10</dt> + <dd>When lines are longer than screen width they have to be split to multiple lines. This specifies how much space to put at the beginning of the line before the text begins. This can be overridden in text formats with <code>%|</code> format.</dd> + <dt>/SET activity_hide_targets</dt> + <dd>If you don’t want to see window activity in some certain channels or queries, list them here. For example <code>#boringchannel =bot1 =bot2</code>. If any highlighted text or message for you appears in that window, this setting is ignored and the activity is shown.</dd> </dl> <p><strong>Nick completion</strong></p> <dl> -<dt>/SET completion_auto OFF</dt> - <dd>Automatically complete the nick if line begins with start of nick - and the completion character. Learn to use the tab-completion instead, - it's a lot better ;)</dd> - -<dt>/SET completion_char :</dt> + <dt>/SET completion_auto OFF</dt> + <dd>Automatically complete the nick if line begins with start of nick and the completion character. Learn to use the tab-completion instead, it’s a lot better ;)</dd> + <dt>/SET completion_char :</dt> <dd>Completion character to use.</dd> </dl> -<h3><a id="c12">12. Statusbar</a></h3> +<h2 id="statusbar">12. Statusbar</h2> <p><code>/STATUSBAR</code> displays a list of statusbars:</p> -<pre> -Name Type Placement Position Visible -window window bottom 0 always -window_inact window bottom 1 inactive -prompt root bottom 100 always -topic root top 1 always -</pre> +<pre><code> Name Type Placement Position Visible + window window bottom 0 always + window_inact window bottom 1 inactive + prompt root bottom 100 always + topic root top 1 always +</code></pre> -<p><code>/STATUSBAR <name></code> prints the statusbar settings and -it's items. <code>/STATUSBAR <name> ENABLE|DISABLE</code> -enables/disables the statusbar. <code>/STATUSBAR <name> RESET</code> -resets the statusbar to it's default settings, or if the statusbar was -created by you, it will be removed.</p> +<p><code>/STATUSBAR <name></code> prints the statusbar settings and it’s items. <code>/STATUSBAR <name> ENABLE|DISABLE</code> enables/disables the statusbar. <code>/STATUSBAR <name> RESET</code> resets the statusbar to it’s default settings, or if the statusbar was created by you, it will be removed.</p> -<p>Type can be window or root, meaning if the statusbar should be -created for each split window, or just once. Placement can be top or -bottom. Position is a number, the higher the value the lower in screen -it is. Visible can be always, active or inactive. Active/inactive is -useful only with split windows, one split window is active and the rest -are inactive. These settings can be changed with:</p> +<p>Type can be window or root, meaning if the statusbar should be created for each split window, or just once. Placement can be top or bottom. Position is a number, the higher the value the lower in screen it is. Visible can be always, active or inactive. Active/inactive is useful only with split windows, one split window is active and the rest are inactive. These settings can be changed with:</p> -<pre> -/STATUSBAR <name> TYPE window|root -/STATUSBAR <name> PLACEMENT top|bottom -/STATUSBAR <name> POSITION <num> -/STATUSBAR <name> VISIBLE always|active|inactive -</pre> +<pre><code> /STATUSBAR <name> TYPE window|root + /STATUSBAR <name> PLACEMENT top|bottom + /STATUSBAR <name> POSITION <num> + /STATUSBAR <name> VISIBLE always|active|inactive +</code></pre> -<p>When loading a new statusbar scripts, you'll need to also specify -where you want to show it. Statusbar items can be modified with:</p> +<p>When loading a new statusbar scripts, you’ll need to also specify where you want to show it. Statusbar items can be modified with:</p> -<pre> -/STATUSBAR <name> ADD [-before | -after <item>] [-priority #] [-alignment left|right] <item> -/STATUSBAR <name> REMOVE <item> -</pre> +<pre><code> /STATUSBAR <name> ADD [-before | -after <item>] [-priority #] [-alignment left|right] <item> + /STATUSBAR <name> REMOVE <item> +</code></pre> -<p>The item name with statusbar scripts is usually same as the script's -name. Script's documentation should tell if this isn't the case. So, to -add mail.pl before the window activity item (see the list with -<code>/STATUSBAR</code> window), use: <code>/STATUSBAR window ADD -before -act mail</code>.</p> +<p>The item name with statusbar scripts is usually same as the script’s name. Script’s documentation should tell if this isn’t the case. So, to add mail.pl before the window activity item (see the list with <code>/STATUSBAR</code> window), use: <code>/STATUSBAR window ADD -before act mail</code>.</p> diff --git a/scripts/scriptassist.pl b/scripts/scriptassist.pl index dd6d3737..459d97f6 100644 --- a/scripts/scriptassist.pl +++ b/scripts/scriptassist.pl @@ -5,21 +5,19 @@ use strict; -use vars qw($VERSION %IRSSI); -$VERSION = '2003020803'; -%IRSSI = ( +our $VERSION = '2003020804'; +our %IRSSI = ( authors => 'Stefan \'tommie\' Tomanek', contact => 'stefan@pico.ruhr.de', name => 'scriptassist', description => 'keeps your scripts on the cutting edge', license => 'GPLv2', url => 'http://irssi.org/scripts/', - changed => $VERSION, modules => 'Data::Dumper LWP::UserAgent (GnuPG)', commands => "scriptassist" ); -use vars qw($forked %remote_db $have_gpg); +our ($forked, %remote_db, $have_gpg, @complist); use Irssi 20020324; use Data::Dumper; @@ -27,12 +25,11 @@ use LWP::UserAgent; use POSIX; # GnuPG is not always needed -use vars qw($have_gpg @complist); $have_gpg = 0; eval "use GnuPG qw(:algo :trust);"; $have_gpg = 1 if not ($@); -sub show_help() { +sub show_help { my $help = "scriptassist $VERSION /scriptassist check Check all loaded scripts for new available versions @@ -42,15 +39,15 @@ sub show_help() { Search the script database /scriptassist info <scripts> Display information about <scripts> -/scriptassist ratings <scripts> - Retrieve the average ratings of the the scripts -/scriptassist top <num> - Retrieve the first <num> top rated scripts -/scriptassist new <num> +".#/scriptassist ratings <scripts> +# Retrieve the average ratings of the the scripts +#/scriptassist top <num> +# Retrieve the first <num> top rated scripts +"/scriptassist new <num> Display the newest <num> scripts -/scriptassist rate <script> <stars> - Rate the script with a number of stars ranging from 0-5 -/scriptassist contact <script> +".#/scriptassist rate <script> <stars> +# Rate the script with a number of stars ranging from 0-5 +"/scriptassist contact <script> Write an email to the author of the script (Requires OpenURL) /scriptassist cpan <module> @@ -70,7 +67,7 @@ sub show_help() { #theme_box("ScriptAssist", $text, "scriptassist help", 1); } -sub theme_box ($$$$) { +sub theme_box { my ($title, $text, $footer, $colour) = @_; Irssi::printformat(MSGLEVEL_CLIENTCRAP, 'box_header', $title); foreach (split(/\n/, $text)) { @@ -79,31 +76,30 @@ sub theme_box ($$$$) { Irssi::printformat(MSGLEVEL_CLIENTCRAP, 'box_footer', $footer); } -sub draw_box ($$$$) { +sub draw_box { my ($title, $text, $footer, $colour) = @_; my $box = ''; $box .= '%R,--[%n%9%U'.$title.'%U%9%R]%n'."\n"; foreach (split(/\n/, $text)) { $box .= '%R|%n '.$_."\n"; - } $box .= '%R`--<%n'.$footer.'%R>->%n'; + } + $box .= '%R`--<%n'.$footer.'%R>->%n'; $box =~ s/%.//g unless $colour; return $box; } -sub call_openurl ($) { +sub call_openurl { my ($url) = @_; - no strict "refs"; # check for a loaded openurl - if ( %{ "Irssi::Script::openurl::" }) { - &{ "Irssi::Script::openurl::launch_url" }($url); + if (my $code = Irssi::Script::openurl::->can('launch_url')) { + $code->($url); } else { print CLIENTCRAP "%R>>%n Please install openurl.pl"; } - use strict; } -sub bg_do ($) { - my ($func) = @_; +sub bg_do { + my ($func) = @_; my ($rh, $wh); pipe($rh, $wh); if ($forked) { @@ -137,7 +133,6 @@ sub bg_do ($) { $result{data}{update} = update_scripts(\@items, $xml); } elsif ($items[0] eq 'search') { shift(@items); - #$result{data}{search}{-foo} = 0; foreach (@items) { $result{data}{search}{$_} = search_scripts($_, $xml); } @@ -150,14 +145,12 @@ sub bg_do ($) { } elsif ($items[0] eq 'ratings') { shift(@items); @items = @{ loaded_scripts() } if $items[0] eq "all"; - #$result{data}{rating}{-foo} = 1; my %ratings = %{ get_ratings(\@items, '') }; foreach (keys %ratings) { $result{data}{rating}{$_}{rating} = $ratings{$_}->[0]; $result{data}{rating}{$_}{votes} = $ratings{$_}->[1]; } } elsif ($items[0] eq 'rate') { - #$result{data}{rate}{-foo} = 1; $result{data}{rate}{$items[1]} = rate_script($items[1], $items[2]); } elsif ($items[0] eq 'info') { shift(@items); @@ -182,12 +175,16 @@ sub bg_do ($) { my $data = $dumper->Dump; print($wh $data); }; + if ($@) { + print($wh Data::Dumper->new([+{data=>+{error=>$@}}]) + ->Purity(1)->Deepcopy(1)->Indent(0)->Dump); + } close($wh); POSIX::_exit(1); } } -sub get_unknown ($$) { +sub get_unknown { my ($cmd, $db) = @_; foreach (keys %$db) { next unless defined $db->{$_}{commands}; @@ -198,56 +195,90 @@ sub get_unknown ($$) { return undef; } -sub script_info ($) { +sub get_names { + my ($sname, $db) = shift; + $sname =~ s/\s+$//; + $sname =~ s/\.pl$//; + my $plname = "$sname.pl"; + $sname =~ s/^.*\///; + my $xname = $sname; + $xname =~ s/\W/_/g; + my $pname = "${xname}::"; + if ($xname ne $sname || $sname =~ /_/) { + my $dir = Irssi::get_irssi_dir()."/scripts/"; + if ($db && exists $db->{"$sname.pl"}) { + # $found = 1; + } elsif (-e $dir.$plname || -e $dir."$sname.pl" || -e $dir."autorun/$sname.pl") { + # $found = 1; + } else { + # not found + my $pat = $xname; $pat =~ y/_/?/; + my $re = "\Q$xname"; $re =~ s/\Q_/./g; + if ($db) { + my ($cand) = grep /^$re\.pl$/, sort keys %$db; + if ($cand) { + return get_names($cand, $db); + } + } + my ($cand) = glob "'$dir$pat.pl' '${dir}autorun/$pat.pl'"; + if ($cand) { + $cand =~ s/^.*\///; + return get_names($cand, $db); + } + } + } + ($sname, $plname, $pname, $xname) +} + +sub script_info { my ($scripts) = @_; - no strict "refs"; my %result; my $xml = get_scripts(); foreach (@{$scripts}) { - next unless (defined $xml->{$_.".pl"} || ( %{ 'Irssi::Script::'.$_.'::' } && %{ 'Irssi::Script::'.$_.'::IRSSI' })); - $result{$_}{version} = get_remote_version($_, $xml); + my ($sname, $plname, $pname) = get_names($_, $xml); + next unless (defined $xml->{$plname} || ( exists $Irssi::Script::{$pname} && exists $Irssi::Script::{$pname}{IRSSI} )); + $result{$sname}{version} = get_remote_version($sname, $xml); my @headers = ('authors', 'contact', 'description', 'license', 'source'); foreach my $entry (@headers) { - $result{$_}{$entry} = ${ 'Irssi::Script::'.$_.'::IRSSI' }{$entry}; - if (defined $xml->{$_.".pl"}{$entry}) { - $result{$_}{$entry} = $xml->{$_.".pl"}{$entry}; + $result{$sname}{$entry} = $Irssi::Script::{$pname}{IRSSI}{$entry}; + if (defined $xml->{$plname}{$entry}) { + $result{$sname}{$entry} = $xml->{$plname}{$entry}; } } - if ($xml->{$_.".pl"}{signature_available}) { - $result{$_}{signature_available} = 1; + if ($xml->{$plname}{signature_available}) { + $result{$sname}{signature_available} = 1; } - if (defined $xml->{$_.".pl"}{modules}) { - my $modules = $xml->{$_.".pl"}{modules}; - #$result{$_}{modules}{-foo} = 1; + if (defined $xml->{$plname}{modules}) { + my $modules = $xml->{$plname}{modules}; foreach my $mod (split(/ /, $modules)) { my $opt = ($mod =~ /\((.*)\)/)? 1 : 0; $mod = $1 if $1; - $result{$_}{modules}{$mod}{optional} = $opt; - $result{$_}{modules}{$mod}{installed} = module_exist($mod); + $result{$sname}{modules}{$mod}{optional} = $opt; + $result{$sname}{modules}{$mod}{installed} = module_exist($mod); } - } elsif (defined ${ 'Irssi::Script::'.$_.'::IRSSI' }{modules}) { - my $modules = ${ 'Irssi::Script::'.$_.'::IRSSI' }{modules}; + } elsif (defined $Irssi::Script::{$pname}{IRSSI}{modules}) { + my $modules = $Irssi::Script::{$pname}{IRSSI}{modules}; foreach my $mod (split(/ /, $modules)) { my $opt = ($mod =~ /\((.*)\)/)? 1 : 0; $mod = $1 if $1; - $result{$_}{modules}{$mod}{optional} = $opt; - $result{$_}{modules}{$mod}{installed} = module_exist($mod); + $result{$sname}{modules}{$mod}{optional} = $opt; + $result{$sname}{modules}{$mod}{installed} = module_exist($mod); } } - if (defined $xml->{$_.".pl"}{depends}) { - my $depends = $xml->{$_.".pl"}{depends}; + if (defined $xml->{$plname}{depends}) { + my $depends = $xml->{$plname}{depends}; foreach my $dep (split(/ /, $depends)) { - $result{$_}{depends}{$dep}{installed} = 1; #(defined ${ 'Irssi::Script::'.$dep }); + $result{$sname}{depends}{$dep}{installed} = 1; } } } return \%result; } -sub rate_script ($$) { +sub rate_script { my ($script, $stars) = @_; my $ua = LWP::UserAgent->new(env_proxy=>1, keep_alive=>1, timeout=>30); - $ua->agent('ScriptAssist/'.$VERSION); + $ua->agent('ScriptAssist/'.2003020803); my $request = HTTP::Request->new('GET', 'http://ratings.irssi.de/irssirate.pl?&stars='.$stars.'&mode=rate&script='.$script); my $response = $ua->request($request); unless ($response->is_success() && $response->content() =~ /You already rated this script/) { @@ -257,10 +288,10 @@ sub rate_script ($$) { } } -sub get_ratings ($$) { +sub get_ratings { my ($scripts, $limit) = @_; my $ua = LWP::UserAgent->new(env_proxy=>1, keep_alive=>1, timeout=>30); - $ua->agent('ScriptAssist/'.$VERSION); + $ua->agent('ScriptAssist/'.2003020803); my $script = join(',', @{$scripts}); my $request = HTTP::Request->new('GET', 'http://ratings.irssi.de/irssirate.pl?script='.$script.'&sort=rating&limit='.$limit); my $response = $ua->request($request); @@ -278,7 +309,7 @@ sub get_ratings ($$) { return \%result; } -sub get_new ($) { +sub get_new { my ($num) = @_; my $result; my $xml = get_scripts(); @@ -290,7 +321,7 @@ sub get_new ($) { } return $result; } -sub module_exist ($) { +sub module_exist { my ($module) = @_; $module =~ s/::/\//g; foreach (@INC) { @@ -299,63 +330,64 @@ sub module_exist ($) { return 0; } -sub debug_scripts ($) { +sub debug_scripts { my ($scripts) = @_; my %result; + my $xml = get_scripts(); foreach (@{$scripts}) { - my $xml = get_scripts(); - if (defined $xml->{$_.".pl"}{modules}) { - my $modules = $xml->{$_.".pl"}{modules}; + my ($sname, $plname) = get_names($_, $xml); + if (defined $xml->{$plname}{modules}) { + my $modules = $xml->{$plname}{modules}; foreach my $mod (split(/ /, $modules)) { my $opt = ($mod =~ /\((.*)\)/)? 1 : 0; $mod = $1 if $1; - $result{$_}{$mod}{optional} = $opt; - $result{$_}{$mod}{installed} = module_exist($mod); + $result{$sname}{$mod}{optional} = $opt; + $result{$sname}{$mod}{installed} = module_exist($mod); } } } return(\%result); } -sub install_scripts ($$) { +sub install_scripts { my ($scripts, $xml) = @_; my %success; - #$success{-foo} = 1; my $dir = Irssi::get_irssi_dir()."/scripts/"; foreach (@{$scripts}) { - if (get_local_version($_) && (-e $dir.$_.".pl")) { - $success{$_}{installed} = -2; + my ($sname, $plname, $pname) = get_names($_, $xml); + if (get_local_version($sname) && (-e $dir.$plname)) { + $success{$sname}{installed} = -2; } else { - $success{$_} = download_script($_, $xml); + $success{$sname} = download_script($sname, $xml); } } return \%success; } -sub update_scripts ($$) { +sub update_scripts { my ($list, $database) = @_; $list = loaded_scripts() if ($list->[0] eq "all" || scalar(@$list) == 0); my %status; - #$status{-foo} = 1; foreach (@{$list}) { - my $local = get_local_version($_); - my $remote = get_remote_version($_, $database); + my ($sname) = get_names($_, $database); + my $local = get_local_version($sname); + my $remote = get_remote_version($sname, $database); next if $local eq '' || $remote eq ''; if (compare_versions($local, $remote) eq "older") { - $status{$_} = download_script($_, $database); + $status{$sname} = download_script($sname, $database); } else { - $status{$_}{installed} = -2; + $status{$sname}{installed} = -2; } - $status{$_}{remote} = $remote; - $status{$_}{local} = $local; + $status{$sname}{remote} = $remote; + $status{$sname}{local} = $local; } return \%status; } -sub search_scripts ($$) { +sub search_scripts { my ($query, $database) = @_; + $query =~ s/\.pl\Z//; my %result; - #$result{-foo} = " "; foreach (sort keys %{$database}) { my %entry = %{$database->{$_}}; my $string = $_." "; @@ -385,23 +417,22 @@ sub search_scripts ($$) { sub pipe_input { my ($rh, $pipetag) = @{$_[0]}; - my @lines = <$rh>; + my $text = do { local $/; <$rh>; }; close($rh); Irssi::input_remove($$pipetag); $forked = 0; - my $text = join("", @lines); unless ($text) { - print CLIENTCRAP "%R<<%n Something weird happend"; + print CLIENTCRAP "%R<<%n Something weird happend (no text)"; return(); } - no strict "vars"; - my $incoming = eval("$text"); + local our $VAR1; + my $incoming = eval($text); if ($incoming->{db} && $incoming->{timestamp}) { $remote_db{db} = $incoming->{db}; $remote_db{timestamp} = $incoming->{timestamp}; } unless (defined $incoming->{data}) { - print CLIENTCRAP "%R<<%n Something weird happend"; + print CLIENTCRAP "%R<<%n Something weird happend (no data)"; return; } my %result = %{ $incoming->{data} }; @@ -447,10 +478,14 @@ sub pipe_input { if ($result{unknown}) { print_unknown($result{unknown}); } + if (defined $result{error}) { + print CLIENTCRAP "%R<<%n There was an error in background processing:"; chomp($result{error}); + print CLIENTERROR $result{error}; + } } -sub print_unknown ($) { +sub print_unknown { my ($data) = @_; foreach my $cmd (keys %$data) { print CLIENTCRAP "%R<<%n No script provides '/$cmd'" unless $data->{$cmd}; @@ -458,7 +493,7 @@ sub print_unknown ($) { my $text .= "The command '/".$cmd."' is provided by the script '".$data->{$cmd}{$_}{name}."'.\n"; $text .= "This script is currently not installed on your system.\n"; $text .= "If you want to install the script, enter\n"; - my ($name) = /(.*?)\.pl$/; + my ($name) = get_names($_); $text .= " %U/script install ".$name."%U "; my $output = draw_box("ScriptAssist", $text, "'".$_."' missing", 1); print CLIENTCRAP $output; @@ -466,11 +501,12 @@ sub print_unknown ($) { } } -sub check_autorun ($) { +sub check_autorun { my ($script) = @_; + my (undef, $plname) = get_names($script); my $dir = Irssi::get_irssi_dir()."/scripts/"; - if (-e $dir."/autorun/".$script.".pl") { - if (readlink($dir."/autorun/".$script.".pl") eq "../".$script.".pl") { + if (-e $dir."/autorun/".$plname) { + if (readlink($dir."/autorun/".$plname) eq "../".$plname) { return 1; } } @@ -487,7 +523,7 @@ sub array2table { $l =~ s/%%/%/g; $width[$_] = length($l) if $width[$_]<length($l); } - } + } my $text; foreach my $line (@array) { for (0..scalar(@$line)-1) { @@ -503,7 +539,7 @@ sub array2table { } -sub print_info (%) { +sub print_info { my (%data) = @_; my $line; foreach my $script (sort keys(%data)) { @@ -543,7 +579,6 @@ sub print_info (%) { $line .= " <optional>" if $data{$script}{modules}{$_}{optional}; $line .= "\n"; } - #$line .= " Needed Irssi scripts:\n"; $line .= " Needed Irssi Scripts:\n" if $data{$script}{depends}; foreach (sort keys %{$data{$script}{depends}}) { if ( $data{$script}{depends}{$_}{installed} == 1 ) { @@ -551,14 +586,13 @@ sub print_info (%) { } else { $line .= " %r->%n ".$_." (not loaded)"; } - #$line .= " <optional>" if $data{$script}{depends}{$_}{optional}; $line .= "\n"; } } print CLIENTCRAP draw_box('ScriptAssist', $line, 'info', 1) ; } -sub print_rate (%) { +sub print_rate { my (%data) = @_; my $line; foreach my $script (sort keys(%data)) { @@ -571,7 +605,7 @@ sub print_rate (%) { print CLIENTCRAP draw_box('ScriptAssist', $line, 'rating', 1) ; } -sub print_ratings (%) { +sub print_ratings { my (%data) = @_; my @table; foreach my $script (sort {$data{$b}{rating}<=>$data{$a}{rating}} keys(%data)) { @@ -589,12 +623,12 @@ sub print_ratings (%) { print CLIENTCRAP draw_box('ScriptAssist', array2table(@table), 'ratings', 1) ; } -sub print_new ($) { +sub print_new { my ($list) = @_; my @table; foreach (sort {$list->{$b}{last_modified} cmp $list->{$a}{last_modified}} keys %$list) { my @line; - my ($name) = /^(.*?)\.pl$/; + my ($name) = get_names($_); if (get_local_version($name)) { push @line, "%go%n"; } else { @@ -607,7 +641,7 @@ sub print_new ($) { print CLIENTCRAP draw_box('ScriptAssist', array2table(@table), 'new scripts', 1) ; } -sub print_debug (%) { +sub print_debug { my (%data) = @_; my $line; foreach my $script (sort keys %data) { @@ -627,12 +661,12 @@ sub print_debug (%) { } } -sub load_script ($) { +sub load_script { my ($script) = @_; Irssi::command('script load '.$script); } -sub print_install (%) { +sub print_install { my (%data) = @_; my $text; my ($crashed, @installed); @@ -681,17 +715,16 @@ sub print_install (%) { list_sbitems(\@installed); } -sub list_sbitems ($) { +sub list_sbitems { my ($scripts) = @_; my $text; foreach (@$scripts) { - no strict 'refs'; - next unless %{ "Irssi::Script::${_}::" }; - next unless %{ "Irssi::Script::${_}::IRSSI" }; - my %header = %{ "Irssi::Script::${_}::IRSSI" }; - next unless $header{sbitems}; + next unless exists $Irssi::Script::{"${_}::"}; + next unless exists $Irssi::Script::{"${_}::"}{IRSSI}; + my $header = $Irssi::Script::{"${_}::"}{IRSSI}; + next unless $header->{sbitems}; $text .= '%9"'.$_.'"%9 provides the following statusbar item(s):'."\n"; - $text .= ' ->'.$_."\n" foreach (split / /, $header{sbitems}); + $text .= ' ->'.$_."\n" foreach (split / /, $header->{sbitems}); } return unless $text; $text .= "\n"; @@ -699,7 +732,7 @@ sub list_sbitems ($) { print CLIENTCRAP draw_box('ScriptAssist', $text, 'sbitems', 1); } -sub check_sig ($) { +sub check_sig { my ($sig) = @_; my $line; my %trust = ( -1 => 'undefined', @@ -722,7 +755,7 @@ sub check_sig ($) { return $line; } -sub print_search ($%) { +sub print_search { my ($query, %data) = @_; my $text; foreach (sort keys %data) { @@ -738,7 +771,7 @@ sub print_search ($%) { print CLIENTCRAP draw_box('ScriptAssist', $text, 'search: '.$query, 1) ; } -sub print_update (%) { +sub print_update { my (%data) = @_; my $text; my @table; @@ -761,7 +794,7 @@ sub print_update (%) { push @table, ['%yo%n', '%9'.$_.'%9', 'not upgraded']; foreach (split /\n/, check_sig($data{$_})) { push @table, ['', '', $_]; - } + } } elsif ($data{$_}{installed} == -2 && $verbose) { my $local = $data{$_}{local}; push @table, ['%go%n', '%9'.$_.'%9', 'already at the latest version ('.$local.')']; @@ -771,35 +804,44 @@ sub print_update (%) { print CLIENTCRAP draw_box('ScriptAssist', $text, 'update', 1) ; } -sub contact_author ($) { +sub contact_author { my ($script) = @_; - no strict 'refs'; - return unless %{ "Irssi::Script::${script}::" }; - my %header = %{ "Irssi::Script::${script}::IRSSI" }; - if (defined $header{contact}) { - my @ads = split(/ |,/, $header{contact}); + my ($sname, $plname, $pname) = get_names($script); + return unless exists $Irssi::Script::{$pname}; + my $header = $Irssi::Script::{$pname}{IRSSI}; + if ($header && defined $header->{contact}) { + my @ads = split(/ |,/, $header->{contact}); my $address = $ads[0]; $address .= '?subject='.$script; $address .= '_'.get_local_version($script) if defined get_local_version($script); - call_openurl($address); + call_openurl($address) if $address =~ /[\@:]/; } } sub get_scripts { my $ua = LWP::UserAgent->new(env_proxy=>1, keep_alive=>1, timeout=>30); - $ua->agent('ScriptAssist/'.$VERSION); + $ua->agent('ScriptAssist/'.2003020803); $ua->env_proxy(); my @mirrors = split(/ /, Irssi::settings_get_str('scriptassist_script_sources')); my %sites_db; + my $not_modified = 0; my $fetched = 0; my @sources; + my $error; foreach my $site (@mirrors) { my $request = HTTP::Request->new('GET', $site); if ($remote_db{timestamp}) { $request->if_modified_since($remote_db{timestamp}); } my $response = $ua->request($request); - next unless $response->is_success; + if ($response->code == 304) { # HTTP_NOT_MODIFIED + $not_modified = 1; + next; + } + unless ($response->is_success) { + $error = join "\n", $response->status_line(), (grep / at .* line \d+/, split "\n", $response->content()), ''; + next; + } $fetched = 1; my $data = $response->content(); my ($src, $type); @@ -826,9 +868,8 @@ sub get_scripts { $sites_db{$_}{source} = $src; } } else { - ## FIXME Panic?! + die("Unknown script database type ($type).\n"); } - } if ($fetched) { # Clean database @@ -842,32 +883,40 @@ sub get_scripts { } $remote_db{db}{$_} = $sites_db{$_} foreach (keys %sites_db); $remote_db{timestamp} = time(); + } elsif ($not_modified) { + # nothing to do + } else { + die("No script database sources defined in /set scriptassist_script_sources\n") unless @mirrors; + die("Fetching script database failed: $error") if $error; + die("Unknown error while fetching script database\n"); } return $remote_db{db}; } -sub get_remote_version ($$) { +sub get_remote_version { my ($script, $database) = @_; - return $database->{$script.".pl"}{version}; + my $plname = (get_names($script, $database))[1]; + return $database->{$plname}{version}; } -sub get_local_version ($) { +sub get_local_version { my ($script) = @_; - no strict 'refs'; - return unless %{ "Irssi::Script::${script}::" }; - my $version = ${ "Irssi::Script::${script}::VERSION" }; - return $version; + my $pname = (get_names($script))[2]; + return unless exists $Irssi::Script::{$pname}; + my $vref = $Irssi::Script::{$pname}{VERSION}; + return $vref ? $$vref : undef; } -sub compare_versions ($$) { +sub compare_versions { my ($ver1, $ver2) = @_; - my @ver1 = split /\./, $ver1; - my @ver2 = split /\./, $ver2; - #if (scalar(@ver2) != scalar(@ver1)) { - # return 0; - #} + for ($ver1, $ver2) { + $_ = "0:$_" unless /:/; + } + my @ver1 = split /[.:]/, $ver1; + my @ver2 = split /[.:]/, $ver2; my $cmp = 0; ### Special thanks to Clemens Heidinger + no warnings 'uninitialized'; $cmp ||= $ver1[$_] <=> $ver2[$_] || $ver1[$_] cmp $ver2[$_] for 0..scalar(@ver2); return 'newer' if $cmp == 1; return 'older' if $cmp == -1; @@ -875,24 +924,20 @@ sub compare_versions ($$) { } sub loaded_scripts { - no strict 'refs'; my @modules; foreach (sort grep(s/::$//, keys %Irssi::Script::)) { - #my $name = ${ "Irssi::Script::${_}::IRSSI" }{name}; - #my $version = ${ "Irssi::Script::${_}::VERSION" }; - push @modules, $_;# if $name && $version; + push @modules, $_; } return \@modules; - } sub check_scripts { my ($data) = @_; my %versions; - #$versions{-foo} = 1; foreach (@{loaded_scripts()}) { - my $remote = get_remote_version($_, $data); - my $local = get_local_version($_); + my ($sname) = get_names($_, $data); + my $remote = get_remote_version($sname, $data); + my $local = get_local_version($sname); my $state; if ($local && $remote) { $state = compare_versions($local, $remote); @@ -905,51 +950,50 @@ sub check_scripts { $remote = '/'; } if ($state) { - $versions{$_}{state} = $state; - $versions{$_}{remote} = $remote; - $versions{$_}{local} = $local; + $versions{$sname}{state} = $state; + $versions{$sname}{remote} = $remote; + $versions{$sname}{local} = $local; } } return \%versions; } -sub download_script ($$) { +sub download_script { my ($script, $xml) = @_; + my ($sname, $plname) = get_names($script, $xml); my %result; - my $site = $xml->{$script.".pl"}{source}; + my $site = $xml->{$plname}{source}; $result{installed} = 0; $result{signed} = 0; my $dir = Irssi::get_irssi_dir(); my $ua = LWP::UserAgent->new(env_proxy => 1,keep_alive => 1,timeout => 30); - $ua->agent('ScriptAssist/'.$VERSION); + $ua->agent('ScriptAssist/'.2003020803); my $request = HTTP::Request->new('GET', $site.'/scripts/'.$script.'.pl'); my $response = $ua->request($request); if ($response->is_success()) { my $file = $response->content(); mkdir $dir.'/scripts/' unless (-e $dir.'/scripts/'); - local *F; - open(F, '>'.$dir.'/scripts/'.$script.'.pl.new'); - print F $file; - close(F); + open(my $F, '>', $dir.'/scripts/'.$plname.'.new'); + print $F $file; + close($F); if ($have_gpg && Irssi::settings_get_bool('scriptassist_use_gpg')) { my $ua2 = LWP::UserAgent->new(env_proxy => 1,keep_alive => 1,timeout => 30); - $ua->agent('ScriptAssist/'.$VERSION); - my $request2 = HTTP::Request->new('GET', $site.'/signatures/'.$script.'.pl.asc'); + $ua->agent('ScriptAssist/'.2003020803); + my $request2 = HTTP::Request->new('GET', $site.'/signatures/'.$plname.'.asc'); my $response2 = $ua->request($request2); if ($response2->is_success()) { - local *S; my $sig_dir = $dir.'/scripts/signatures/'; mkdir $sig_dir unless (-e $sig_dir); - open(S, '>'.$sig_dir.$script.'.pl.asc'); + open(my $S, '>', $sig_dir.$plname.'.asc'); my $file2 = $response2->content(); - print S $file2; - close(S); + print $S $file2; + close($S); my $sig; foreach (1..2) { # FIXME gpg needs two rounds to load the key my $gpg = new GnuPG(); eval { - $sig = $gpg->verify( file => $dir.'/scripts/'.$script.'.pl.new', signature => $sig_dir.$script.'.pl.asc' ); + $sig = $gpg->verify( file => $dir.'/scripts/'.$plname.'.new', signature => $sig_dir.$plname.'.asc' ); }; } if (defined $sig->{user}) { @@ -975,13 +1019,13 @@ sub download_script ($$) { if ($result{installed}) { my $old_dir = "$dir/scripts/old/"; mkdir $old_dir unless (-e $old_dir); - rename "$dir/scripts/$script.pl", "$old_dir/$script.pl.old" if -e "$dir/scripts/$script.pl"; - rename "$dir/scripts/$script.pl.new", "$dir/scripts/$script.pl"; + rename "$dir/scripts/$plname", "$old_dir/$plname.old" if -e "$dir/scripts/$plname"; + rename "$dir/scripts/$plname.new", "$dir/scripts/$plname"; } return \%result; } -sub print_check (%) { +sub print_check { my (%data) = @_; my $text; my @table; @@ -1001,28 +1045,29 @@ sub print_check (%) { print CLIENTCRAP draw_box('ScriptAssist', $text, 'check', 1) ; } -sub toggle_autorun ($) { +sub toggle_autorun { my ($script) = @_; + my ($sname, $plname) = get_names($script); my $dir = Irssi::get_irssi_dir()."/scripts/"; mkdir $dir."autorun/" unless (-e $dir."autorun/"); - return unless (-e $dir.$script.".pl"); - if (check_autorun($script)) { - if (readlink($dir."/autorun/".$script.".pl") eq "../".$script.".pl") { - if (unlink($dir."/autorun/".$script.".pl")) { - print CLIENTCRAP "%R>>%n Autorun of ".$script." disabled"; + return unless (-e $dir.$plname); + if (check_autorun($sname)) { + if (readlink($dir."/autorun/".$plname) eq "../".$plname) { + if (unlink($dir."/autorun/".$plname)) { + print CLIENTCRAP "%R>>%n Autorun of ".$sname." disabled"; } else { print CLIENTCRAP "%R>>%n Unable to delete link"; } } else { - print CLIENTCRAP "%R>>%n ".$dir."/autorun/".$script.".pl is not a correct link"; + print CLIENTCRAP "%R>>%n ".$dir."/autorun/".$plname." is not a correct link"; } } else { - symlink("../".$script.".pl", $dir."/autorun/".$script.".pl"); - print CLIENTCRAP "%R>>%n Autorun of ".$script." enabled"; + symlink("../".$plname, $dir."/autorun/".$plname); + print CLIENTCRAP "%R>>%n Autorun of ".$sname." enabled"; } } -sub sig_script_error ($$) { +sub sig_script_error { my ($script, $msg) = @_; return unless Irssi::settings_get_bool('scriptassist_catch_script_errors'); if ($msg =~ /Can't locate (.*?)\.pm in \@INC \(\@INC contains:(.*?) at/) { @@ -1032,7 +1077,7 @@ sub sig_script_error ($$) { } } -sub missing_module ($$) { +sub missing_module { my ($module) = @_; my $text; $text .= "The perl module %9".$module."%9 is missing on your system.\n"; @@ -1041,7 +1086,7 @@ sub missing_module ($$) { print CLIENTCRAP &draw_box('ScriptAssist', $text, $module, 1); } -sub cmd_scripassist ($$$) { +sub cmd_scripassist { my ($arg, $server, $witem) = @_; my @args = split(/ /, $arg); if ($args[0] eq 'help' || $args[0] eq '-h') { @@ -1083,27 +1128,34 @@ sub cmd_scripassist ($$$) { } } -sub sig_command_script_load ($$$) { +sub cmd_help { + my ($arg, $server, $witem) = @_; + $arg =~ s/\s+$//; + if ($arg =~ /^scriptassist/i) { + show_help(); + } +} + +sub sig_command_script_load { my ($script, $server, $witem) = @_; - no strict; - $script = $2 if $script =~ /(.*\/)?(.*?)\.pl$/; - if ( %{ "Irssi::Script::${script}::" }) { - if (defined &{ "Irssi::Script::${script}::pre_unload" }) { + my ($sname, $plname, $pname, $xname) = get_names($script); + if ( exists $Irssi::Script::{$pname} ) { + if (my $code = "Irssi::Script::${pname}"->can('pre_unload')) { print CLIENTCRAP "%R>>%n Triggering pre_unload function of $script..."; - &{ "Irssi::Script::${script}::pre_unload" }(); + $code->(); } } } -sub sig_default_command ($$) { +sub sig_default_command { my ($cmd, $server) = @_; return unless Irssi::settings_get_bool("scriptassist_check_unknown_commands"); bg_do('unknown '.$cmd); } -sub sig_complete ($$$$$) { +sub sig_complete { my ($list, $window, $word, $linestart, $want_space) = @_; - return unless $linestart =~ /^.script(assist)? (install|rate|ratings|update|check|contact|info|autorun)/; + return unless $linestart =~ /^.script(assist)? (install|rate|ratings|update|check|contact|info|autorun)/i; my @newlist; my $str = $word; foreach (@complist) { @@ -1114,13 +1166,12 @@ sub sig_complete ($$$$$) { foreach (@{loaded_scripts()}) { push @newlist, $_ if /^(\Q$str\E.*)?$/; } - $want_space = 0; push @$list, $_ foreach @newlist; Irssi::signal_stop(); } -Irssi::settings_add_str($IRSSI{name}, 'scriptassist_script_sources', 'http://scripts.irssi.org/scripts.dmp'); +Irssi::settings_add_str($IRSSI{name}, 'scriptassist_script_sources', 'https://scripts.irssi.org/scripts.dmp'); Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_cache_sources', 1); Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_update_verbose', 1); Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_check_verbose', 1); @@ -1131,24 +1182,37 @@ Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_use_gpg', 1); Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_integrate', 1); Irssi::settings_add_bool($IRSSI{name}, 'scriptassist_check_unknown_commands', 1); -Irssi::signal_add_first("default command", \&sig_default_command); -Irssi::signal_add_first('complete word', \&sig_complete); -Irssi::signal_add_first('command script load', \&sig_command_script_load); -Irssi::signal_add_first('command script unload', \&sig_command_script_load); +Irssi::signal_add_first("default command", 'sig_default_command'); +Irssi::signal_add_first('complete word', 'sig_complete'); +Irssi::signal_add_first('command script load', 'sig_command_script_load'); +Irssi::signal_add_first('command script unload', 'sig_command_script_load'); -if (defined &Irssi::signal_register) { - Irssi::signal_register({ 'script error' => [ 'Irssi::Script', 'string' ] }); - Irssi::signal_add_last('script error', \&sig_script_error); -} +Irssi::signal_register({ 'script error' => [ 'Irssi::Script', 'string' ] }); +Irssi::signal_add_last('script error', 'sig_script_error'); -Irssi::command_bind('scriptassist', \&cmd_scripassist); +Irssi::command_bind('scriptassist', 'cmd_scripassist'); +Irssi::command_bind('help', 'cmd_help'); Irssi::theme_register(['box_header', '%R,--[%n$*%R]%n', 'box_inside', '%R|%n $*', 'box_footer', '%R`--<%n$*%R>->%n', ]); -foreach my $cmd ( ( 'check', 'install', 'update', 'contact', 'search', '-h', 'help', 'ratings', 'rate', 'info', 'echo', 'top', 'cpan', 'autorun', 'new') ) { +foreach my $cmd ( ( 'check', + 'install', + 'update', + 'contact', + 'search', +# '-h', + 'help', +# 'ratings', +# 'rate', + 'info', +# 'echo', +# 'top', + 'cpan', + 'autorun', + 'new' ) ) { Irssi::command_bind('scriptassist '.$cmd => sub { cmd_scripassist("$cmd ".$_[0], $_[1], $_[2]); }); if (Irssi::settings_get_bool('scriptassist_integrate')) { |