Initial import of the ircii-pana-1.1-final source tree.

git-svn-id: svn://svn.code.sf.net/p/bitchx/code/tags/ircii-pana-1.1-final@1 13b04d17-f746-0410-82c6-800466cd88b0

bitchx-docs/5_Programming/on/set

@@ -0,0 +1,27 @@
+Synopsis:
+   on [<modes>]set [<serial#>] [-|^]<match> { <action> }
+
+Description:
+   This hook is triggered whenever a /set is issued.
+
+Parameters:
+   $0    name of variable to be set.
+         will be "set-error" if an invalid SET variable was specified
+   $1-   value the variable will be set to.
+         will be "No such variable "FOO"", where FOO is the invalid SET
+	 variable if $0 is "set-error"
+
+Examples:
+   To make sure EXEC_PROTECTION stays on:
+      on ^set "exec_protection off" {
+         echo *** You cannot set EXEC_PROTECTION off!
+         set exec_protection on
+      }
+
+   To warn of all invalid /SET attempts:
+      on ^set "set-error *" {
+         echo *** $1-. Please try again
+      }
+See Also:
+   set(4)
+