Document ENCAP.

git-svn-id: http://svn.inspircd.org/repository/trunk/inspircd@10705 e03df62e-2008-0410-955e-edbf42e46eb7

diff --git a/include/protocol.h b/include/protocol.h
index 8579f03aacdfc74beafd669911912403ef194bfa..da4c9690722031582bad8529363e4687a04fe9a5 100644 (file)
--- a/include/protocol.h
+++ b/include/protocol.h
@@ -42,6 +42,12 @@ class ProtocolInterface : public Extensible
        ProtocolInterface(InspIRCd* Instance) : ServerInstance(Instance) { }
        virtual ~ProtocolInterface() { }
 
+       /** Generate an ENCAP message.
+        * See the protocol documentation for the purpose of ENCAP.
+        * @param encap This is a list of string parameters, the first of which must be a server ID or glob matching servernames.
+        * The second must be a subcommand. All subsequent parameters are dependant on the subcommand.
+        * ENCAP (should) be used instead of creating new protocol messages for easier third party application support.
+        */
        virtual void SendEncapsulatedData(parameterlist &encap) { }
 
        virtual void SendMetaData(void* target, int type, const std::string &key, const std::string &data) { }