Added KDE3 version of kvirc

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kvirc@1095341 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 712 insertions, 0 deletions

diff --git a/FAQ b/FAQ
new file mode 100644
index 00000000..c9355dbf
--- /dev/null
+++ b/FAQ
@@ -0,0 +1,712 @@
+1. PROJECT RELATED QUESTIONS
+
+1.1 What is KVIrc ? What the "KVIrc" name stands for ?
+1.2 Why KVIrc is not totally integrated in KDE ?
+
+
+2. COMPILATION 
+
+2.1 I can't compile kvirc from cvs, what's wrong?
+2.2 Internal Compiler Errors ?
+2.3 On Mandrake 10.0 (or other) KVIrc fails to start
+    saying that it can't find libkvisetup.so.
+2.4 I got 'amarokInterface.cpp:29:31: amarokInterface.moc: No such file or directory'. Whats going wrong?
+2.5 Configure complains about a missing libdl.so but I seem to have it
+
+
+3. INSTALLATION 
+
+3.1 There is a problem during package installation/creation
+     file /usr/share/services/irc.protocol from install
+     kvirc-version.package conflicts with file from package xxx
+
+
+4. IRC
+
+4.1 How do i join a channel ?
+4.2 How do i autojoin channels ?
+4.3 How do I enable automatic NickServ identification ?
+4.4 I can't see my national characters, what's wrong ?
+4.5 I can't connect to an IPV6 server, what's wrong ?
+4.6 /me doesn't support the '$' character, what's wrong ?
+4.7 /me doesn't support the '"' (double quote) character, what's wrong ?
+4.8 /me can't contain the ';' character, what's wrong ?
+4.9 I try to do a /whois on nick blah\ but i get the reply for blah (without the slash)
+4.10 What is AVATAR protocol ? Is there any documentation about it ?
+4.11 The log files seem to be saved randomly, when I open a log
+     I can see only a part of the text that actually should be there
+4.12 The DCC transfers seem to be interrupted after the first few bytes:
+     KVIrc says that the remote end has closed the connection.
+
+
+5. ADVANCED IRC FEATURES
+
+5.1 How do I connect to an SSL-enabled IRC server ?
+5.2 How do I use DCC over SSL ?
+5.3 Do I need a SSL certificate ?
+5.4 How do I create a SSL certificate ?
+5.5 I can't get KVIrc to use my SSL certificate in a DCC, what's wrong ?
+5.6 KVIrc crashes when a certificate is used under Windows, what's wrong ?
+5.7 How do I enable mircryption (encryption in general) for a specific channel ?
+5.8 How do I execute a process and send its output to a channel ?
+5.9 How do I keep channels and queries open after a disconnect ?
+5.10 I have an unreliable ISP connection but KVIrc takes a really long
+    time to detect a disconnection and reconnect.
+5.11 I'm in a LAN and KVIrc uses a wrong IP address in dcc transfers
+
+6. APPAREANCE
+
+6.1 On Windows KVIrc seems to slow-down sometimes, what's wrong ?
+6.2 I don't see the channel popup menus anymore, what's wrong ?
+6.3 Does KVIrc support Themes?
+6.4 I hate all that colors, what can I do about it ?
+6.5 On Windows, how do I use firefox/opera/any_other_browser to open links instead of explorer ?
+
+
+7. CRASHES
+
+7.1 KVIrc crashes when the multiline text input is opened (obsolete)
+7.2 What the heck is a gdb stack trace and how do I get it ?
+7.3 KVIrc hangs up, but doesn't crash. How do i report debug informations ?
+7.4 KVIrc exits by itself or simply "disappears" without any apparent reason.
+7.5 KVIrc dies randomly and "Alarm Clock" is printed in the console
+7.6 KVIrc dies when using alias(identify){ identify password; }
+
+--------------------------------------------------------------------------------
+1. PROJECT RELATED QUESTIONS
+--------------------------------------------------------------------------------
+
+
+1.1 What is KVIrc ?
+
+   KVIrc is a cross-platform Internet Relay Chat client.
+   The name stands for K Visual Internet Relay Chat client.
+   The K prefix comes from the old times, when KVIrc was bound to the
+   KDE project and depended on the KDE libraries to run. Actually this
+   is not true anymore since KVIrc depends only on the Qt library from
+   TrollTech and runs also on platforms where KDE can't run.
+
+
+1.2 Why KVIrc is not totally integrated in KDE ?
+
+   First of all read the answer for question 1.1.
+   We could provide a more complete integration by the means of conditional
+   compilation but since it would require additional efforts to synchronize
+   the KVIrc sources with the KDE library changes we choose not to do it.
+   If you wish to contribute some code that better integrates KVIrc with
+   KDE you're welcome to do so: we will happily accept your patches as long
+   as you promise to mantain them :)
+
+
+--------------------------------------------------------------------------------
+2. COMPILATION
+--------------------------------------------------------------------------------
+
+2.1 I can't compile kvirc from svn, what's wrong?
+
+   Have you checked the requirements ?
+   *Carefully* read the INSTALL file that comes with the distribution:
+   it contains the informations to solve 95% of the problems that
+   you may encounter. You may also try digging in our mailing list
+   archive: many problems have been solved there.
+   If you still can't get it to work please either subscribe to the KVIrc
+   mailing list (see www.kvirc.net) and report the problem there or join #kvirc
+   on IRCNet and ask the channel members for a hint.
+
+
+2.2 Internal Compiler Errors ?
+
+   Compile errors like this:
+       In file [somefile]:[someline] internal error:
+   Segmentation fault
+   Please submit a full bug report,
+   with preprocessed source if appropriate.
+   See <URL:http://bugzilla.redhat.com/bugzilla/> for instructions.
+
+   This error can have multiple reasons.
+   1) A compiler bug: my GCC 3.2 20020903 (default on RH 8.0) spits
+      out 5-6 of them daily. Usually it is solved by simply restarting the "make" command.
+      If it doesn't go away or if it gets really frequent and annoying you might try to upgrade the compiler.
+   2) A memory corruption: this is really frequent: one of your memory banks is spitting random bytes
+      sometimes. Usually the problems come out under heavy system load (kernel, KDE or kvirc compilation for example).
+      You can check for memory corruption by trying different RAM modules (or removing them one at a time to discover
+      the broken bank). You can also try a program called memtest and a kernel
+      patch that can force the broken memory banks to be ignored by the kernel (allocated permanently to a dummy kernel task).
+      These tools can be found by digging the web with your favorite search engine.
+   3) A deeper hardware problem: if upgrading the compiler and changing memory banks doesn't help then
+      it *might* be a deeper hardware problem: bus errors , faulty IDE (or SCSI) controller or even buggy CPU...
+      Well....
+
+
+2.3 On Mandrake 10.0 (or other) KVIrc fails to start
+    saying that it can't find libkvisetup.so.
+
+    Mandrake 10.0 default libtool package is broken. Either upgrade
+    the libtool package or try to run ./autogen.sh --bundled-libtool
+    and then recompile (./configure, make, make install).
+    This *might* apply to other systems too.
+
+
+2.4 I got 'amarokInterface.cpp:29:31: amarokInterface.moc: No such file or directory'. Whats going wrong?
+
+    You have to install qt3 devel tools which include uic and moc. If installed, be sure that uic and moc are in PATH.
+
+
+2.5 Configure complains about a missing libdl.so but I seem to have it
+
+  The most common causes are two:
+
+  1) You have libdl.so.X (where X is usually a number or a set of numbers) but not libdl.so
+
+  You need to do a symbolic link from libdl.so.X to libdl.so. You do it by entering the directory
+  where libdl.so.X is and issuing a ln -s command, for example:
+
+  # cd /lib
+  # ls libdl*
+  # ln -s libdl.so.2 libdl.so
+
+  Then try to ./configure again
+
+  2) You don't have a c++ compiler installed
+
+  The libdl test is the first ./configure test made with a c++ compiler.
+  The confirmation for this error can be found in the config.log file
+  where you can find lines similar to the following:
+
+  configure:21637: g++ -o conftest    conftest.cc -rdynamic -ldl >&5
+  ./configure: line 1: g++: command not found
+  configure:21643: $? = 127
+  configure: failed program was:
+  ...
+
+  Your distribution probably ships the c++ frontend to gcc in a package
+  separated from gcc itself. The package might be also named g++.
+  Look it up on your installation CD and install it, then ./configure again.
+
+-------------------------------------------------------------------------------
+3. INSTALLATION
+-------------------------------------------------------------------------------
+
+3.1 There is a problem during package installation/creation
+     file /usr/share/services/irc.protocol from install
+     kvirc-version.package conflicts with file from package xxx
+
+  This is a known issue with all types of packages that handle
+  file conflicts. KVIrc installs the irc protocol handler for KDE
+  and the same is done by ksirc and kopete (and maybe others).
+  There is no particular reason for KVIrc to fix it in the core
+  distribution (and there is also no simple way to do it).
+  Either the package maker must exclude the irc.protocol
+  file from installation or mark it as "optional" in some way or the
+  users must use some sort of "force" flag during the installation.
+
+
+-------------------------------------------------------------------------------
+4. IRC
+-------------------------------------------------------------------------------
+
+4.1 How do i join a channel ?
+
+  Type "/join #channelname"
+
+
+4.2 How do i autojoin channels?
+
+  There are many ways to do it.
+  For example:
+  Select "Scripting/Events" from the KVIrc menu.
+  Lookup the "OnIrc" entry in the left pane of the window that pops up.
+  Right-click on that entry and select "Add handler".
+  A "default" handler will be created. In the right pane write:
+       join #kvirc
+       join #kde-users
+       join #somechannel
+       ....
+  Now click OK and you're done: you have just created a handler for an event.
+  Reconnect to a server and KVIrc will autojoin the channels that you have selected.
+  Another option (nicer, if you use several servers) is to go to the servers options
+  page and click the button labeled 'Advanced' on the entry for the single server.
+  There is a server-specific "On connect execute..." event.
+
+
+4.3 How do I enable automatic NickServ identification ?
+
+  KVIrc supports two kind of NickServ identification rules: per-network and global.
+  The per-network rules can be accessed from the server options page.
+  You need to select a network in the list view (not a server!) and then click
+  "Advanced...". In the dialog that appears there is a NickServ tab
+  on that you can add your identification rules. Adding a rule
+  should be straightforward (if you stop the mouse over an item you will likely get a small
+  tool tip with the explaination). Each rule is composed of:
+  - the nickname that is being identified: the rule will be applied only
+      when your current nickname corresponds to this one.
+  - a nick server user mask that must be matched by the NickServ user
+      in order for him to be recognized as the real NickServ asking for
+      identification. You will probably use something like NickServ!service@*
+  - a message regular expression that must be matched by the message
+      that the NickServ sends when requesting the identification.
+      You will probably use something like "If this is your nick,
+      identify yourself with /ns IDENTIFY password"
+  - an identification command that will be executed when all the rules
+      above match. You will probably use something like "ns IDENTIFY yourpassword"
+  The global rules can be created in the IRC::NickServ page of the options dialog
+  (accessible from the Settings/Configure KVIrc... menu). The main difference
+  is that each rule has a server mask that must be matched by the current
+  server name for the rule to be applied.
+  KVIrc first looks in the per-network rules and if none matches it looks
+  in the global rules.
+
+
+4.4 I can't see my national characters, what's wrong ?
+
+  There are several ways to fix your national characters display.
+  General encoding:
+      Open the options dialog and go to the "Encoding" page.
+      You can set explicitly the encoding to be used for the whole application.
+      If you choose "Use Language Encoding" KVIrc will try to guess the
+      encoding from your system settings. If this doesn't work then the reasons
+      may be:
+      - Your system settings are wrong
+        You need to fix them
+      - Your server applies some specific encoding to the data
+        See "Server encoding"
+      - You're chatting with people that have different system settings
+        See "Channel & Query encoding"
+  Server encoding
+      Besides the general encoding you can set one encoding per server.
+      This is done in the server options dialog (Click Advanced...).
+      The encoding will be applied to all the text that comes from
+      and goes to the server. If you choose "Use system encoding"
+      then the server will inherit the "General encoding" value above.
+      If this doesn't work then you have either set it incorrectly or
+      you are chatting with people that use different encodings.
+      In this case see "Channel & Query encoding"
+      The server encoding is used also to decode nicknames and
+      channel names on servers that support it.
+  Channel & Query encoding
+      Besides the general and server encoding you can set also per-window
+      encoding in channels and queries. This encoding will be applied
+      ONLY to the text sent to or received from that channel or query.
+      This feature is useful when chatting over a non unicode aware
+      IRC server (nearly all at the time of writing) with people
+      that have settings different than your general defaults or
+      the server default.
+
+  Keep in mind that IRC has a MAJOR problem with character encoding
+  and in fact the formal definition of the protocol requires it
+  to be only 7bit safe. This means that on some servers you may
+  see your national characters eaten by the IRC network and there
+  is almost nothing you can do about that...
+
+  UTF-8 is the best encoding we can get on IRC. Try to convince
+  other people to use it :)     
+
+
+4.5 I can't connect to an IPV6 server, what's wrong ?
+
+  First of all make sure that your IPV6 stack is setup correctly.
+  Can you ping6 other IPV6 other machines ?
+
+        # ping6 www.6bone.net
+
+  Is the IPV6 support enabled in your kvirc executable ?
+  To find it out , try
+
+        /echo $features 
+
+  in the KVIrc commandline. You should get a comma separated list of
+  features compiled in the executable. If the list contains "IPv6" then
+  the support is compiled in, otherwise you must check your compilation
+  stage to guess what went wrong.
+  To connect to an IPV6 server you can use /server -i <servername>
+  If you can ping other IPV6 machines, the IPv6 support is compiled in your
+  executable and you still can't connect to an *existing* IPv6 server then
+  you may have found a bug :) Report it.
+
+
+4.6 /me doesn't support the '$' character, what's wrong ?
+
+  This is NOT a bug : this is a feature : kvirc supports (and substitutes!) variables in all the commands.
+  You can escape your $ sign by using the backslash character: /me has gained \$100 will work correctly
+
+
+4.7 /me doesn't support the '"' (double quote) character, what's wrong ?
+
+  This is NOT a bug : this is a feature : a string enclosed in double quotes will have its whitespace preserved
+  while the other strings will have the whitespace simplified. This is valid for ANY command.
+  You can escape your " sign by using the backslash character: /me feels a bit \"foo\" will work correctly
+
+
+4.8 /me can't contain the ';' character, what's wrong ?
+
+  This is NOT a bug : this is a feature : kvirc supports multiple commands on a single line and uses ';' as a command
+  separator. You can escape your ';' sign by using the backslash character: /me is hungry \;) will work correctly.
+
+
+4.9 I try to do a /whois on nick blah\ but i get the reply for blah (without the slash)
+
+  In KVIrc /whois is a scripting command and the nickname is a command parameter.
+  In scripting commands the backslash is a special character with several "escape"
+  meanings. To include a literal backslash inside a parameter you MUST double it,
+  thus the correct command to issue is /whois blah\\
+
+
+4.10 What is AVATAR protocol? Is there any documentation about it ?
+
+  AVATAR is a simple CTCP based protocol that allows associating images (avatars)
+  to IRC users. The protocol definition is simple:
+
+  - CTCP AVATAR QUERY:
+       :<source> PRIVMSG <target> :<0x01>AVATAR<0x01>
+    Queries the avatar of the <target>.
+  - CTCP AVATAR REPLY:
+       :<source> NOTICE <target> :<0x01>AVATAR <avatar_url><0x01>
+    Asserts that the <source> user's avatar is located at <avatar_url>
+    that usually will be something like http://server.domain.top/avatarimage.jpg.
+
+  KVIrc supports also DCC based avatars that are simply "offered" to the
+  remote users. In this case the <avatar_url> does not contain the http://
+  prefix but is a simple file name. The remote users request the avatars
+  by issuing a DCC GET command. This is an useful but secondary extension
+  and can be ignored by simple implementations. If you need more informations
+  about this method please write to pragma at kvirc dot net.
+
+
+4.11 The log files seem to be saved randomly, when I open a log
+     I can see only a part of the text that actually should be there
+
+   KVIrc does not explicitly flush the log files while writing them. The OS
+   (or the underlying C library) does the flush operation when necessary.
+   This means that blocks of the log file will be added to the file on disk
+   only once in a while. If you really need to see the logs in real time
+   then you can explicitly flush the log files by scripting.
+   Just add a script like this to your OnKVIrcStartup event:
+ 
+   timer(flushlogfiles,30000)
+   {
+       foreach(%x,$window.list(all,any))
+       {
+          if($log.file(%x))
+          {
+              echo -w=%x "Flushing log file...";
+              log.flush -w=%x;
+          }
+       }
+   }
+ 
+   The script above will flush all the log files every 30 seconds. You may
+   remove the echo statement if you're annoyed by the output :)
+
+
+4.12 The DCC transfers seem to be interrupted after the first few bytes:
+     KVIrc says that the remote end has closed the connection.
+
+   Make sure that you don't have activated the "Send ACK for byte 0"
+   option in "Options->DCC->File Transfer->Advanced".
+   This option should be used ONLY IF you have problems without.
+
+
+
+
+-------------------------------------------------------------------------------
+5. ADVANCED IRC FEATURES
+-------------------------------------------------------------------------------
+
+
+5.1 How do I connect to an SSL-enabled IRC server ?
+
+  Use /server -s <servername>
+  It should work also over IPV6.
+  If it doesn't work then your executable might have no SSL support compiled in.
+  To find it out type 
+
+       /echo $features
+
+  in the KVIrc commandline. If "SSL" is not in the list then you must go back
+  to the compilation phase and see what went wrong.
+
+
+5.1 How do I use DCC over SSL ?
+
+  /dcc.chat -s <nickname> should work
+
+
+5.3 Do I need a SSL certificate ?
+
+  No you shouldn't need it, but you can use it if you want.
+
+
+5.4 How do I create a SSL certificate ?
+
+  A test self-signed certificate can be created by using the CA.pl perl script included
+  in the OpenSSL distribution. It will be something like CA.pl -newcert
+
+
+5.5 I can't get KVIrc to use my SSL certificate in a DCC, what's wrong ?
+
+  The SSL protocol doesn't require the "client" to send the certificate: it is
+  sent only if the "server side" requests it (it is not the KVIrc case).
+  The server side may have a certificate and you can set it in the SSL options page.
+  If your Private Key is stored in the certificate file pass the same filename
+  to both Certificate and PrivateKey option.
+  Remember to set the password if needed.
+
+
+5.6 KVIrc crashes when a certificate is used under Windows, what's wrong ?
+
+  This is probably a bug of the SSL dll shipped with the windows version of KVIrc.
+  You might try with a different version of this dll.
+
+
+5.7 Can I encrypt my messages?
+(or: How do I enable mircryption (encryption in general) for a specific channel?)
+
+  KVIrc supports encryption for channels, queries and dcc chats by the means
+  of text transformation engines. You can access the list of the engines
+  by clicking the button with the yellow lock in the upper right corner
+  of the window. In the pane that will appear select "use text transformation"
+  and then choose one of the available engines. 
+  The Mircryption engine is an implementation of the mircryption protocol and 
+  supports both ECB and CBC mode. There is also a wide variety of Rijndael based encryption 
+  engies as well as some funky other text transform tricks.
+  Most of the engines will need a pair of keys to encrypt and decrypt text
+  and in most cases you will use the same key for both encrypting and
+  decrypting. In the particular case of Mircryption you can enable
+  CBC mode by prefixing your key(s) with the "cbc:" string.
+  Once you have entered the keys just click on OK and start "talking" in the
+  window. Any encrypted text will have a "lock" overlay in his icon.
+  If you want to avoid encrypting a particular text line (maybe because
+  you want to allow everyone on a channel to read it) you can start
+  the line with a CTRL+P character.
+
+
+5.8 How do I execute a process and send its output to a channel ?
+
+  The straight way to do this is
+
+    /exec("your command here"){ say $1; }
+
+  Since it is not too much "user friendly", you can alias it in
+  the following way:
+
+    alias(runandsay)
+    {
+        exec($0-){ say $1; }
+    }
+
+  Then you would simply run
+
+    /runandsay cat /proc/cpuinfo
+
+  in the channel window you want the output sent to.
+
+  Keep in mind that this is a "brute" approach and I'm sure that after
+  reading some documentation (start from /help exec) you will be able to
+  find more elaborate and nice ways to send a process output to a channel/query.
+
+
+5.9 How do I keep channels and queries open after a disconnect ?
+
+  KVIrc can keep your channels and queries open when the connection terminates
+  unexpectedly. This will probably make sense only if you plan to
+  reconnect to the same server or at least the same network (either manually
+  or automatically).
+
+  An "unexpected disconnect" is a connection termination not explicitly caused by
+  the KVIrc user. This means that the connection is interrupted, either
+  by the networking stack or by the remote server, without the user
+  having sent a QUIT message (by the means of the /quit command or by pressing
+  the "disconnect" button in the toolbar).
+
+  All this because the normal behaviour of a /QUIT command is, yes, to quit
+  your current connection without leaving traces of it.
+
+  To keep the channels and queries open you just need to select the
+  relative options in the "Connection" page of the options dialog
+  (on unexpected disconnect: "Keep channels open" an/or "Keep queries open").
+  
+  Then you might also select "Automatically reconnect", "Rejoin channels
+  after reconnect" and "Reopen queries after reconnect" to bring your
+  "dead windows" to life again :)
+
+  Finally, you can simulate an "unexpected disconnection" by using the -u switch
+  of the /quit command. This might be useful when you want to explicitly
+  quit your connection while leaving the channels and queries open... maybe
+  because you need to renew the connection to your ISP before reconnecting ;)
+
+
+5.10 I have an unreliable ISP connection but KVIrc takes a really long
+    time to detect a disconnection and reconnect.
+
+  KVIrc doesn't detect itself that the connection has dropped until your
+  kernel explicitly times out. KVIrc measures lag, instead, that will
+  probably grow up a lot when the connection has dropped.
+  You can write a handler for the OnLagCheck event that will detect
+  the lag growing over a certain threshold and reconnect.
+  This involves opening the event editor, selecting OnLagCheck
+  and choosing "Add handler" from the right mouse menu.
+  In the handler write:
+
+     if($1 > 30000){ quit -f -u; }
+
+  30000 is just a sample threshold (it means 30000 milliseconds!), replace
+  it with a value of your choice.
+  quit -f -u will close the current connection immediately (-f = force)
+  and will simulate an "unexpected disconnection" condition (-u = unexpected).
+  If you then enable automatic reconnection (see answer for question 5.9)
+  in the options dialog, KVIrc will automatically reconnect and rejoin channels.
+
+
+5.11 I'm in a LAN and KVIrc uses a wrong IP address in dcc transfers
+
+  KVIrc supports a couple of methods for guessing the right IP address for
+  DCC transfers: you only have to guide it a bit :)
+
+  The first thing to try is "Guess address from IRC when unroutable" (Options->DCC).
+  This will perform a lookup on your own IRC mask once you connect
+  to an IRC server and use the address as source in DCC transfers.
+  (You need to reconnect to the server to make this option work!)
+  This trick will fail when your hostmask is cloaked (mode +x on recent IRC servers):
+  KVIrc will tell you that it couldn't look up the hostname and give up.
+
+  In this case you might try to set a fixed address to be sent as source
+  in the DCC transfers: you just need to fill in the *IP address* of your
+  router in the option field. This field doesn't support hostname lookups
+  and it won't update automatically when you router's IP changes.
+  However, if you router's IP has a dns entry, you can ask KVIrc to fill
+  this field with a simple script to be performed at every connection.
+
+  event(OnIRCConnectionEstabilished,updatedccsource)
+  {
+      ahost(yourrouterhostname.dyndns.org)
+      {
+         option boolDCCSendFakeAddressByDefault 1
+         if($1)option stringDefaultDCCFakeAddress $2
+         else echo "Couldn't look up the router's hostname"
+      }
+  }
+
+  When transferring files to other KVIrc clients you may also try the
+  DCC RSEND protocol instead of DCC SEND. It will ask the remote end
+  to listen instead.
+  
+-------------------------------------------------------------------------------
+6. APPAREANCE
+-------------------------------------------------------------------------------
+
+6.1 On Windows KVIrc seems to slow-down sometimes, what's wrong ?
+
+  This is usually caused by the heavy graphics: try removing some graphic effects like the
+  pseudo-transparency. I have experimented that it happens almost always on 32-bit displays.
+  Switching to 16 or 24 bits may also help.
+
+
+6.2 I don't see the channel popup menus anymore, what's wrong ?
+
+  If something went wrong with KVIrc settings (a crash when the script settings
+  were saved ?) or if you have messed with the scripting options and you
+  want to get back the original behaviour (default script) you can choose
+  "Scripting/Restore default script" from the KVIrc menu.
+  (WARNING: It will erase any script modification you have made!)
+  Update: starting with the cvs of 2005.01.17, KVIrc should be able to
+  detect such situations and automatically suggest the re-installation of the
+  default script.
+
+6.3 Does KVIrc support Themes? 
+
+  Yes, KVIrc now has introduced a Theme Manager. You can find it in the Option dialog.
+  From there you can change the way KVIrc looks: fonts, colors, windows behaviour, 
+  icons, taskbars, and so on. 
+  Once you have changed the theme, you can save it, archive it (tar.bz2 or zip) and share with your friends, 
+  or send it to the KVIrc staff to see it published on the web site. 
+
+
+6.4  I hate all that colors, what can I do about it ?
+
+  By fiddling with the options you can make KVIrc appear even monochromatic.
+  Go to Options/Theme and select the minimalist theme: it will set white text
+  on black background and will disable the displaying of a lot of icons.
+  This is a good starting point for you console addicted hackerz :D
+
+
+6.5 On Windows, how do I use firefox/opera/any_other_browser to open links instead of explorer ?
+
+  Go to the "URL Handlers" options page and set
+
+      run "C:\\path\\to\\your\\browser.exe" "$0"
+
+  as url handler for the protocol you're interested in (maybe in all).
+
+  Suepahfly suggests to use
+
+     rundll32 url.dll,FileProtocolHandler "$0"
+
+  as url handler to open the url in the default windows browser.
+
+
+-------------------------------------------------------------------------------
+7. CRASH
+-------------------------------------------------------------------------------
+
+7.1 KVIrc crashes when the multiline text input is opened (obsolete)
+
+  If you have installed a new version of KVIrc over a previous installation
+  br if you have changed the Qt libraries that KVIrc is linked to then
+  it might be caused by a broken multiline text editor config.
+  Try removing $HOME/.kvircssexeditorrc and starting KVIrc again.
+  Update: this problem has been completely removed during late 2004 developments
+  by completely rewriting the multiline input.
+
+
+7.2 What the heck is a gdb stack trace and how do I get it ?
+
+  A gdb stack trace is a "photography" of the state of the KVIrc internals
+  taken when a certain event has occured. The most common event
+  is a program crash (Segmentation Fault).
+  The stack trace helps (or even allows) the developers to locate the
+  crash cause in the program sources.
+  To obtain a gdb stack trace you must:
+
+  - Compile KVIrc with the --enable-debug ./configure option.
+    Without this switch the stack trace is USELESS.
+  - Have a working installation of gdb (the gnu debugger)
+    This is usually available on your distribution cd
+    and you may already have it installed.
+  - Run KVirc:
+    # gdb kvirc
+    When the gdb prompt appears write:
+    # (gdb) run -f
+    Make KVIrc crash: gdb will tell something about
+    a signal received by the program. Write then:
+    # (gdb) bt
+    The text you see is the stack trace you wanted :)
+    Copy+Paste+Send it to pragma at kvirc dot net or the mailing list.
+
+
+7.3 KVIrc hangs up, but doesn't crash. How do i report debug informations ?
+
+  Use gdb to get a stack trace as in answer to question 7.2.
+  Since your KVIrc doesn't crash you will have to interrupt the execution
+  manually while it is hung up. You can do it by pressing CTRL+C in gdb.
+
+
+7.4 KVIrc exits by itself or simply "disappears" without any apparent reason.
+
+  Yes. It probably crashed but you haven't noticed that.
+  We NEED a gdb stack trace or a working procedure to reproduce the
+  behaviour in order to hunt it.
+
+
+7.5 KVIrc dies randomly and "Alarm Clock" is printed in the console
+
+  Try recompiling kvirc by adding the --with-ignore-sigalarm switch to
+  ./configure. (Note: the reason of the incoming SIGALARM signals
+  on certain systems is acually unknown. Please send hints to pragma at kvirc dot net).
+
+
+7.6 KVIrc dies when using alias(identify){ identify password; };
+
+  This is infinite recursion: a programming error.
+  Take a look at http://en.wikipedia.org/wiki/Infinite_loop , learn
+  that once for all and fix your script.
+