Merged with Irssi CVS.
[silc.git] / apps / irssi / docs / faq.txt
index d8825106d1e18d5cb6e5082ed0e2e9d6b78533c1..499f243bfaff722bd5ed62deb1b5359e357c6872 100644 (file)
+   FAQ
+
 Q: Why doesn't irssi display colors even when ircii etc. displays them?
-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. If this doesn't help, then use the
-   evil way of /SET term_force_colors ON.
+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.
+   TERM=xterm-color  irssi).  If this doesn't help, then use the evil way
+   of /SET term_force_colors ON.
 
 Q: How do I easily write text to channel that starts with '/' character?
 A: / /text
 
-Q: Why doesn't irssi update my realname (or whatever) after I change it
-   with /SET realname and reconnect with /RECONNECT or /SERVER?
-A: Irssi is trying to be too smart. This will be fixed in future, but for
-   now you should use /DISCONNECT + /CONNECT.
+Q: Why doesn't irssi update my realname (or whatever) after I change it with
+   /SET realname and reconnect with /RECONNECT or /SERVER?
+A:  Irssi is trying to be too smart. This will be fixed in future, but
+   for now you should use /DISCONNECT and /CONNECT.
 
-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?
-A: Two ways. The "good way" to do it is with /DISCONNECT. Check the server
-   tags first with /SERVER without giving it any parameters, reconnections
-   are those that have tag starting with "recon" text. So most probably you're
-   going to do /DISCONNECT recon-1. The other way is to remove all the
-   reconnections with /RMRECONNS, easier but may remove some connections
-   you actually wanted to reconnect (if you used multiple servers..).
+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?
+A:  Two  ways.  The "good way" to do it is with /DISCONNECT. Check the
+   server  tags  first  with  /SERVER  without  giving it any parameters,
+   reconnections  are  those that have tag starting with "recon" text. So
+   most probably you're going to do /DISCONNECT recon-1. The other way is
+   to remove all the reconnections with /RMRECONNS, easier but may remove
+   some  connections  you  actually  wanted  to  reconnect  (if  you used
+   multiple servers..).
 
 Q: How do I add seconds to timestamp?
-A: "/FORMAT timestamp {timestamp %%H:%%M:%%S} " - and remember to add the
+A: /FORMAT timestamp {timestamp %%H:%%M:%%S} - and remember to add the
    trailing space :)
 
 Q: Why does irssi say "Irssi: Channel not fully synchronized yet, try again
    after a while" when I try to use /BAN etc?
-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.
-
-   Anyway, if this does happen, do "/RAWLOG SAVE ~/rawlog" 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 tss@iki.fi. 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 /SET rawlog_lines 1000 or so.
+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.
+
+   Anyway,  if  this  does  happen,  do  /RAWLOG SAVE ~/rawlog 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 /SET rawlog_lines 1000 or so.
+
+   MODE +b still works fine though.
 
 Q: Where's the GUI version?
 A: Read http://irssi.org/?page=about
 
 Q: How do I autorejoin channels after being kicked?
-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.
-
-   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
-   /SET autorejoin_channels #chan1 #chan2 ...
-
-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?
-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 /AWAY command properly and tell it's existence to people who don't
-   know about it. /WII yournick shows your away reason much better for people
-   who actually want to know if you're there or not.
-
-   You can script these behaviours if you really wish to of course. But
-   currently there's no public scripts for either of these, and the only way
-   I'm going to add such to irssi.org is if the script contains a setting to
-   specify which specific channels the announcement is sent.
+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.
+
+   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 /SET autorejoin_channels #chan1 #chan2 ...
+
+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?
+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  /AWAY command properly and tell it's
+   existence  to people who don't know about it. /WII yournick shows your
+   away reason much better for people who actually want to know if you're
+   there or not.
+
+   You  can  script these behaviours if you really wish to of course. But
+   currently  there's no public scripts for either of these, and the only
+   way  I'm  going  to  add such to irssi.org is if the script contains a
+   setting to specify which specific channels the announcement is sent.
+
+Q: Why does irssi autojoin on invite by default?
+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.
+
+   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.
+
+Q: How to make UTF-8 support work with irssi?
+A: xterm -u8, screen -U, /SET term_type utf-8
+
+Q: Will there be /DETACH-like feature?
+A:  Maybe. Detach code already is there, attach is just missing :) But
+   I don't have much interest in coding it, and screen works just fine so
+   why bother?
+
+Q: How do I run scripts automatically at startup?
+A:  Put them into ~/.irssi/scripts/autorun/ directory. Or better would
+   be  if  you  placed  them in ~/.irssi/scripts/ and created symlinks to
+   autorun   directory   (eg.   cd   ~/.irssi/scripts/autorun/  ;  ln  -s
+   ../script.pl .)
+
+Q: How do I easily edit existing topic?
+A: /TOPIC <tab>
 
+Q: How can I have /WHOIS replies to active window?
+A:  Currently there's no other way than to close the status window, or
+   at least do /WINDOW LEVEL -CRAP in it, but that would make a lot other
+   messages  show  up  in active window too. I don't have many good ideas
+   how  this  could be easily fixed inside irssi (no, kludging it to only
+   work  with  whois isn't a "fix") - it'd be possible to create a script
+   do this though but currently it doesn't exist.