diff --git a/bindings/java/org/collectd/api/CollectdMatchFactoryInterface.java b/bindings/java/org/collectd/api/CollectdMatchFactoryInterface.java
index 24cab5989d5b279f20194ca334d1e87018fde310..7b1c71a470d4f441a68a69c9fb5740ab9c1addb6 100644 (file)
package org.collectd.api;
/**
- * Interface for objects implementing a match factory.
+ * Interface for objects implementing a "match factory".
*
* Objects implementing this interface are used to create objects implementing
* the CollectdMatchInterface interface.
*/
public interface CollectdMatchFactoryInterface
{
+ /**
+ * Create a new "match" object.
+ *
+ * This method uses the configuration provided as argument to create a
+ * new object which must implement the {@link CollectdMatchInterface}
+ * interface.
+ *
+ * This function corresponds to the <code>create</code> member of the
+ * <code>src/filter_chain.h:match_proc_t</code> struct.
+ *
+ * @return New {@link CollectdMatchInterface} object.
+ */
public CollectdMatchInterface createMatch (OConfigItem ci);
}