BUILD : 1.7.10 (876) BUGS : NOTES : Added something about DevNull to the FAQ

git-svn-id: svn://svn.anope.org/anope/trunk@876 31f1291d-b8d6-0310-a050-a5561fc1590b


git-svn-id: http://anope.svn.sourceforge.net/svnroot/anope/trunk@623 5417fbe8-f217-4b02-8779-1006273d7864

2 files changed, 70 insertions, 53 deletions

diff --git a/docs/FAQ b/docs/FAQ
index d99ac38ad..aaab054d4 100644
--- a/docs/FAQ
+++ b/docs/FAQ
@@ -79,6 +79,9 @@ Table of Contents
     7.3) I selected a language other than English, but sometimes Anope sends
          responses in English instead.
 
+8) DevNull
+    8.1) What is the purpose of DevNull?
+
 -------------------------------------------------------------------------------
 
 1) General
@@ -87,28 +90,28 @@ Table of Contents
 
     Anope is a set of services for IRC networks. See the README file for more
     information. And in case you were wondering, Anope is Epona spelt backwards
-    :)
+    :)

 
 1.2) Where can I find Anope?
 
     The latest version can always be found at the official Anope distribution
-    site:
-    
-        * http://www.anope.org/
-    
+    site:

+    

+        * http://www.anope.org/

+    

     New version announcements can also be found at http://www.anope.org/ in the
-    main page.
+    main page.

 
 1.3) Does Anope run under Windows?
 
     Yes. For more information on how to obtain the windows version of Anope
-    visit http://windows.anope.org/
+    visit http://windows.anope.org/

 
 1.4) Can I send you questions without reading the FAQ, INSTALL or README files?
 
     No. If you don't read those files, your messages will most probably be
     ignored. We don't mean to be rude, but if we took the time to write down
-    some documentation, we'd expect you to take some time to read it.
+    some documentation, we'd expect you to take some time to read it.

 
 1.5) I need support for the XYZ protocol.
 
@@ -129,14 +132,14 @@ Table of Contents
     proposal to be in the next Anope release for sure. As a rule, we usually
     don't add anything that can be equivalently done by other means, or that we
     consider totally useless; see question 1.8 for examples of things we don't
-    plan to add.
-    
+    plan to add.

+    

     Our general intent is for Anope to provide as much functionality as
     possible--while staying as lean as possible.  So features which are
     arguably beneficial will tend to be added, while features of limited or no
     benefit or which can be equally provided by something else already in use
-    will tend to be passed over.
-    
+    will tend to be passed over.

+    

     If you'd like to give us your idea, you can go to our website at
     http://www.anope.org/ and add it on our online Forum, in the Feature
     Requests section.
@@ -146,8 +149,8 @@ Table of Contents
 
     * An option to make ChanServ stay in some/all registered channels: we see
     absolutely no necessity for this feature, since BotServ already does this
-    anyway.
-    
+    anyway.

+    

     * A "current time" field in NickServ and ChanServ INFO displays: Most
     people have clocks of some sort either on their computer screens or on
     their walls (or both), and all IRC servers, as well as Services, have a
@@ -178,15 +181,15 @@ Table of Contents
     GNU make from ftp://prep.ai.mit.edu/pub/gnu/ (or wherever you prefer) and
     use it instead of your system's default "make". Note that GNU make may
     already be installed on your system; try using the command "gmake" instead
-    of "make".
-    
+    of "make".

+    

     The make programs bundled with SunOS/Solaris and FreeBSD have been reported
     not to work; you will need to use GNU make on these systems.
 
 2.2) I get an error like "Makefile.inc not found".
 
     You forgot to run the Config script first.  See the INSTALL file for
-    compilation instructions.
+    compilation instructions.

 
 2.3) I typed "./services" at the command line, but nothing happened!
 
@@ -197,25 +200,25 @@ Table of Contents
     configuration file.  (Also make sure that you are actually running one of
     the supported servers.  There are a gazillion different variations on the
     basic IRC protocol out there, and we have neither the time nor the desire
-    to add support for them.)
-    
+    to add support for them.)

+    

     The recommended server, under which Epona (the original code base used by
     Anope) was developed, is Bahamut. DreamForge 4.6.7 will also work fine, but
     it's a bit obsolete nowadays. Derivatives of Bahamut and DreamForge may
     also work, if they don't change the server<->server protocol too much;
     contact their authors for more information. Most people, though, are
-    running Anope with UnrealIRCd, UltimateIRCd or Bahamut.
-    
+    running Anope with UnrealIRCd, UltimateIRCd or Bahamut.

+    

     As always, you can check the log file (services.log by default) for error
     messages. You can also start services with the -nofork command line option
     to prevent it from running in the background, and it will output the
-    messages written to the log file to the console as well.
+    messages written to the log file to the console as well.

 
 2.4) Whenever I start Anope, I get a message on my IRC server saying
      "connection refused" or something similar, and Anope gives an error
      message from the server saying "Closing Link: ...".
 
-    See section 3 of the INSTALL file.
+    See section 3 of the INSTALL file.

 
 2.5) My IRC server is giving me messages like "Connection to
      services.whatever.net[127.0.0.1] activated" and then "Access denied -- no
@@ -229,7 +232,7 @@ Table of Contents
 
 2.6) When I say "/connect services.*", it doesn't work!
 
-    Of course not.  RTFM (Read The Fine Manual), and see the previous answer.
+    Of course not.  RTFM (Read The Fine Manual), and see the previous answer.

 
 2.7) Anope starts up okay, but if I try to register a nickname, it comes back
      with "Sorry, registration failed."
@@ -250,8 +253,8 @@ Table of Contents
      juped.server introduced by non-hub server services.my.net".
 
     Services' uplink must have an H: line for Services in the ircd.conf file,
-    which looks something like:
-    
+    which looks something like:

+    

         H:*::services.whatever.net
 
 3.2) I can't use the ADMIN command to add Services admins, it tells me
@@ -275,11 +278,11 @@ Table of Contents
 3.5) When I used the OperServ RAW command, Anope and/or my network crashed, or
      did weird things! Please fix this bug!
 
-    "That's not a bug, it's a feature."
-    
+    "That's not a bug, it's a feature."

+    

     Have you ever typed /msg OperServ HELP RAW? It's clearly stated there that
-    this command is dangerous and that its use may result in very bad things.
-    
+    this command is dangerous and that its use may result in very bad things.

+    

     And that's why this command has been disabled by default. If you enabled
     and used it, YOU'RE ON YOUR OWN. All help requests will be ignored, even if
     the problem happens not immediately.
@@ -308,12 +311,12 @@ Table of Contents
     Enabling the OperServ RAW command is VERY dangerous and should never be
     done on a real network without thinking about it very well first. The RAW
     command can easily break your whole network if used incorrectly, and thus
-    you will receive NO SUPPORT if you enable RAW on your network.
-    
+    you will receive NO SUPPORT if you enable RAW on your network.

+    

     Before you enable RAW, be very sure you really want to enable it, and keep
     in mind that you will NOT BE ABLE to receive ANY SUPPORT anymore, because
-    Anope's stability cannot be guaranteed if RAW is enabled.
-    
+    Anope's stability cannot be guaranteed if RAW is enabled.

+    

     The RAW command comes bundled as a core module for operserv. To load it,
     add the os_raw module to the list of OperServ core modules. But be sure to
     keep in mind that when you enable the RAW command, you CANNOT GET ANY
@@ -338,15 +341,15 @@ Table of Contents
     probably out of luck; if you like, you can report it to us anyway, but
     chances are it won't get fixed if we don't have instructions on reproducing
     it.  If you do have such a problem, you may find the crontab utility useful
-    for dealing with it.
-    
+    for dealing with it.

+    

     Also, see the DumpCore directive in the configuration file. It allows Anope
     to dump its core whenever it's segfaulting, usually calling it core and
     placing it into Anope's main directory. Open up gdb by issuing the
-    following command at your shell:
-    
-        * gdb services core
-    
+    following command at your shell:

+    

+        * gdb services core

+    

     (of course replacing 'core' with the name of the core if different) and
     type 'bt' at the gdb prompt. After that, send us the output you got and
     keep the core file in a safe place, in case we need it to dig deeper into
@@ -365,30 +368,30 @@ Table of Contents
      the change.
 
     Make sure EVERY server on your network has a U: line for Services in
-    ircd.conf, for example:
-    
+    ircd.conf, for example:

+    

         U:services.whatever.net:*:*
 
 5.2) Anope ignored the SET SUCCESSOR setting and deleted a channel when the
      founder expired.
 
     Normally, this is because the successor had too many channels registered;
-    in this case, you will see an entry in the log file like the following:
-    
+    in this case, you will see an entry in the log file like the following:

+    

         [date] Successor (SuccessorNick) of channel #somechannel owns too many
-        channels, deleting channel #somechannel
-    
+        channels, deleting channel #somechannel

+    

     If you don't get a message like this or you can verify that the successor
     wasn't running into the channel limit, please report it using the
     bug-reporting procedure below (see section 6 of the README file).
 
 5.3) How to auto voice all those whom join my #channel?
 
-    Execute the following commands (/cs is an alias for /msg ChanServ):
-    
-        /cs set #channel secure off
-        /cs set #channel xop off
-        /cs levels #channel set AUTOVOICE -1
+    Execute the following commands (/cs is an alias for /msg ChanServ):

+    

+        /cs set #channel secure off

+        /cs set #channel xop off

+        /cs levels #channel set AUTOVOICE -1

 
 5.4) My RESTRICTED channel doesn't work, but everything else works perfectly!
 
@@ -409,7 +412,7 @@ Table of Contents
 7.1) Anope complains in the logfile about being unable to load the default
      language.
 
-    You forgot to run "make install".
+    You forgot to run "make install".

 
 7.2) Anope spricht kein Deutsch!, etc. (Anope doesn't speak my language!)
 
@@ -424,3 +427,13 @@ Table of Contents
     wait for the primary translator to provide us with a translation, or do the
     translation yourself and send us the messages translated into your
     language.
+
+
+8) DevNull
+
+8.1) What is the purpose of DevNull?
+
+    DevNull functions as a message sink. Any message sent to it will be
+    ignored. It will not be logged, there will be no response. It will be lost
+    forever. Whether it's useful or not is up to you; we just provide you with
+    the option.
diff --git a/version.log b/version.log
index 67634f351..2db132d39 100644
--- a/version.log
+++ b/version.log
@@ -8,10 +8,14 @@
 VERSION_MAJOR="1"
 VERSION_MINOR="7"
 VERSION_PATCH="10"
-VERSION_BUILD="873"
+VERSION_BUILD="876"
 
 # $Log$
 #
+# BUILD : 1.7.10 (876)
+# BUGS  : 
+# NOTES : Added something about DevNull to the FAQ
+#
 # BUILD : 1.7.10 (873)
 # BUGS  : 
 # NOTES : Added SGLINE support for plexus, and fixed minor other things (by ThaPrince)