doc: some FAQ fixes

1 files changed, 90 insertions, 85 deletions

diff --git a/doc/FAQ b/doc/FAQ
index bdbe43cb8..1ae2fe4f0 100644
--- a/doc/FAQ
+++ b/doc/FAQ
@@ -1,13 +1,13 @@
 1. PROJECT RELATED QUESTIONS
 
-1.1 What is KVIrc ? What does the "KVIrc" name stand for ?
-1.2 Why is KVIrc not fully integrated in KDE ?
+1.1 What is KVIrc? What does the KVIrc name stand for?
+1.2 Why is KVIrc not fully integrated in KDE?
 
 
 2. COMPILATION
 
 2.1 I can't compile KVIrc from Git, what's wrong?
-2.2 Internal Compiler Errors ?
+2.2 Internal Compiler Errors?
 
 
 3. INSTALLATION
@@ -19,16 +19,16 @@
 
 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.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.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:
@@ -37,40 +37,40 @@
 
 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.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
+5.11 I'm in a LAN and KVIrc uses a wrong IP address in DCC transfers
 
 
 6. APPEARANCE
 
-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.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 ?
+6.4 I hate all that colors, what can I do about it?
+6.5 On Windows, how do I use Firefox, Opera or any other browser to open links instead of explorer?
 
 
 7. CRASHES
 
-7.1 What the heck is a gdb stack trace and how do I get it ?
-7.2 KVIrc hangs up, but doesn't crash. How do I report debug information ?
-7.3 KVIrc exits by itself or simply "disappears" without any apparent reason.
+7.1 What the heck is a GDB stack trace and how do I get it?
+7.2 KVIrc hangs up, but doesn't crash. How do I report debug information?
+7.3 KVIrc exits by itself or simply disappears without any apparent reason.
 7.4 KVIrc dies when using alias(identify){ identify password; }
 
 
 8. SCRIPTING / ADDONS
 
-8.1 Trying to load a script i get a "can't load the module 'script'" error.
+8.1 Trying to load a script I get a "can't load the module 'script'" error.
 
 
 --------------------------------------------------------------------------------
@@ -78,17 +78,17 @@
 --------------------------------------------------------------------------------
 
 
-1.1 What is KVIrc ? What does the "KVIrc" name stand for ?
+1.1 What is KVIrc? What does the KVIrc name stand for?
 
    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
-   Nokia and runs also on platforms where KDE can't run.
+   is not true anymore since KVIrc depends only on the Qt library from the
+   Qt Company and runs also on platforms where KDE can't run.
 
 
-1.2 Why is KVIrc not totally integrated in KDE ?
+1.2 Why is KVIrc 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
@@ -105,7 +105,7 @@
 
 2.1 I can't compile KVIrc from Git, what's wrong?
 
-   Have you checked the requirements ?
+   Have you checked the requirements?
    *Carefully* read the INSTALL file that comes with the distribution:
    it contains the information which solves 95% of the problems that
    you may encounter. You may also try digging in our mailing list
@@ -116,7 +116,7 @@
    on Freenode and ask the channel members for a hint.
 
 
-2.2 Internal Compiler Errors ?
+2.2 Internal Compiler Errors?
 
    Compile errors like this:
        In file [somefile]:[someline] internal error:
@@ -127,7 +127,7 @@
 
    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.
+      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).
@@ -148,20 +148,20 @@
      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).
+  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.
+  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 ?
+4.1 How do I join a channel?
 
   Type "/join #channelname"
 
@@ -172,8 +172,8 @@
   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:
+  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
@@ -181,11 +181,11 @@
   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 labelled 'Advanced' on the entry for the single server.
+  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 ?
+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.
@@ -213,7 +213,7 @@
   in the global rules.
 
 
-4.4 I can't see my national characters, what's wrong ?
+4.4 I can't see my national characters, what's wrong?
 
   There are several ways to fix your national characters display.
   General encoding:
@@ -243,7 +243,7 @@
       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
+      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.
@@ -258,14 +258,14 @@
   other people to use it :)
 
 
-4.5 I can't connect to an IPV6 server, what's wrong ?
+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 ?
+  Can you ping6 other IPV6 other machines?
 
-        # ping6 ipv6.google.com
+        # ping -6 ipv6.google.com
 
-  Is the IPV6 support enabled in your KVIrc executable ?
+  Is the IPV6 support enabled in your KVIrc executable?
   To find it out, try
 
         /echo $features
@@ -280,7 +280,7 @@
   you may have found a bug :) Report it.
 
 
-4.6 /me doesn't support the '$' character, what's wrong ?
+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:
@@ -291,7 +291,7 @@
   arrow next to the input field and then click the KVS icon.
 
 
-4.7 /me doesn't support the '"' (double quote) character, what's wrong ?
+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.
@@ -303,7 +303,7 @@
   arrow next to the input field and then click the KVS icon.
 
 
-4.8 /me can't contain the ';' character, what's wrong ?
+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:
@@ -325,7 +325,7 @@
   arrow next to the input field and then click the KVS icon.
 
 
-4.10 What is AVATAR protocol? Is there any documentation about it ?
+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:
@@ -385,7 +385,7 @@
 -------------------------------------------------------------------------------
 
 
-5.1 How do I connect to an SSL-enabled IRC server ?
+5.1 How do I connect to an SSL-enabled IRC server?
 
   Use /server -s <servername>
   It should work also over IPV6.
@@ -398,23 +398,23 @@
   to the compilation phase and see what went wrong.
 
 
-5.1 How do I use DCC over SSL ?
+5.1 How do I use DCC over SSL?
 
   /dcc.chat -s <nickname> should work
 
 
-5.3 Do I need a SSL certificate ?
+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 ?
+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 ?
+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).
@@ -424,7 +424,7 @@
   Remember to set the password if needed.
 
 
-5.6 KVIrc crashes when a certificate is used under Windows, what's wrong ?
+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.
@@ -433,7 +433,7 @@
 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
+  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"
@@ -452,7 +452,7 @@
   the line with a CTRL+P character.
 
 
-5.8 How do I execute a process and send its output to a channel ?
+5.8 How do I execute a process and send its output to a channel?
 
   The straight way to do this is
 
@@ -474,7 +474,7 @@
   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 ?
+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
@@ -526,7 +526,7 @@
   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
+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 :)
@@ -542,7 +542,7 @@
   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
+  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)
@@ -563,17 +563,17 @@
 6. APPEARANCE
 -------------------------------------------------------------------------------
 
-6.1 On Windows KVIrc seems to slow-down sometimes, what's wrong ?
+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.
+  Switching to 16 or 24-bit may also help.
 
 
-6.2 I don't see the channel popup menus anymore, what's wrong ?
+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
+  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!)
@@ -589,7 +589,7 @@
   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 ?
+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
@@ -597,8 +597,13 @@
   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 ?
+6.5 On Windows, how do I use Firefox, Opera or any other browser to open links instead of explorer?
 
+  Currently any browsers defined as the default browser, will be used automatically. 
+  Use the instructions below only to set your preferred browser.
+  
+  These days KVIrc uses a "run cmd.exe /c start \ "$0" command to open the currently set default browser.
+  
   Go to the "URL Handlers" options page and set
 
       run "C:\\path\\to\\your\\browser.exe" "$0"
@@ -617,43 +622,43 @@
 7. CRASH
 -------------------------------------------------------------------------------
 
-7.1 What the heck is a gdb stack trace and how do I get it ?
+7.1 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
+  A GDB stack trace is a "photograph" of the state of the KVIrc internals
   taken when a certain event has occurred. 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:
+  To obtain a GDB stack trace you must:
 
   - Compile KVIrc with 'cmake -DDEBUG=1' option.
     Without this switch the stack trace is USELESS.
-  - Have a working installation of gdb (the gnu debugger)
+  - Have a working installation of GDB (the GNU Project 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
+    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 and create a new bug ticket in the web bugtracker
-    (you can find a link on the KVIrc website).
+    Copy+Paste into a new bug ticket at
+    https://github.com/kvirc/KVIrc/issues/new
 
 
-7.2 KVIrc hangs up, but doesn't crash. How do I report debug information ?
+7.2 KVIrc hangs up, but doesn't crash. How do I report debug information?
 
-  Use gdb to get a stack trace as in answer to question 7.1.
+  Use GDB to get a stack trace as in answer to question 7.1.
   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.
+  manually while it is hung up. You can do it by pressing CTRL+C in GDB.
 
 
 7.3 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
+  We NEED a GDB stack trace or a working procedure to reproduce the
   behaviour in order to hunt it.
 
 
@@ -668,7 +673,7 @@
 8. SCRIPTING / ADDONS
 -------------------------------------------------------------------------------
 
-8.1 Trying to load a script i get a "can't load the module 'script'" error.
+8.1 Trying to load a script I get a "can't load the module 'script'" error.
   Full version of the error (this is for Linux, may vary on Windows/other OS):
   ---
   [KVS] Runtime Error: Module command call failed: can't load the module 'script':