#summary The @interface tag
== Usage ==
@interface [_[ModifierReference modifiers]_] _interface_name_
== Description ==
Declare and document an interface. Defines a new namespace. Interfaces could be used to describe cases when algorithm expects an object with certain set of attributes.

TODO: Link to page that describes how namespaces work.
== Example ==
{{{
// When a function expects to receive an object that has members foo, bar and method
// doSomething, it could be documented in the following way:
// interface definition
/**
 * This is an example of interface definition
 * @interface myInterface
 */
/** @variable {int} foo */
/** @variable {string} bar */
/** @function {boolean function(int)} doSomething */

//usage of the interface
/**
 * @function {int} my.namespace.myFunction
 * @param {myInterface} param - some kind of parameter
 */
}}}
== Details ==
|| Since || v1.0 ||