jrd/irssi
1
0
Fork 0
forked from PsychoticNinja/irssi
Code Issues Pull Requests Projects Releases Wiki Activity

FAQ is now in HTML format. Patch by Han.

Browse Source 
git-svn-id: http://svn.irssi.org/repos/irssi/trunk@2541 dbcabf3a-b0e7-0310-adc4-f8d773084564
This commit is contained in:
Timo Sirainen 2002-03-09 10:06:42 +00:00 committed by cras
parent f181dca67d
commit 0e6946eb04
4 changed files with 94 additions and 82 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
autogen.sh
View File

@ -28,6 +28,7 @@ cat docs/help/Makefile.am.gen|sed "s/@HELPFILES@/$files/g"|sed 's/?/\\?/g'|tr '!
# .html -> .txt with lynx # .html -> .txt with lynx
echo "Documentation: html -> txt..." echo "Documentation: html -> txt..."
lynx -dump -nolist docs/startup-HOWTO.html > docs/startup-HOWTO.txt lynx -dump -nolist docs/startup-HOWTO.html > docs/startup-HOWTO.txt
lynx -dump -nolist docs/faq.html|perl -pe 's/^ *//; if ($_ eq "\n" && $state eq "Q") { $_ = ""; } elsif (/^([QA]):/) { $state = $1 } elsif ($_ ne "\n") { $_ = " $_"; };' > docs/faq.txt
echo "Checking auto* tools..." echo "Checking auto* tools..."

1
docs/Makefile.am
View File

@ -5,6 +5,7 @@ doc_DATA = \
design.txt \ design.txt \
formats.txt \ formats.txt \
manual.txt \ manual.txt \
faq.html \
faq.txt \ faq.txt \
perl.txt \ perl.txt \
signals.txt \ signals.txt \

92
docs/faq.html Normal file
View File

@ -0,0 +1,92 @@
<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. 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>
<p>A: <code>/ /text</code></p>
<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>
<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>
<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>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>
<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 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 <code>/SET rawlog_lines
1000</code> or so.</p>
<p><code>MODE +b</code> still works fine though.</p>
<h3>Q: Where's the GUI version?</h3>
<p>A: Read
<a href="http://irssi.org/?page=about">http://irssi.org/?page=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 it's 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>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.</p>

82
docs/faq.txt
View File

@ -1,82 +0,0 @@
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.
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: 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
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.
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.
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.