Good evening!

There is only one frustrating thing for me in NetBeans IDE since I started using it for 3 years ago. 
That is the invisibility of acceptable variables I can pass to method that was declared as PHPDoc @method attribute.


/**
 * @method int addFlights() addFlights(array $flights, $ignore = true) Adds flights to the Airplain
 */
class Airplain
{
  /**
   * @return bool
   */
  public function configure (stdClass $flightCode)
  {
    // ...
  }

  public function __call ($method, $args)
  {
    // ...
  }
}


When auto-completion dialog triggered after "$f14->" there will be 3 methods:

$f14 = new Airplain();
$f14->
    +--------------------------------------------+
    + * __call($method, $args)          Airplain +
    + * addFlights()                    Airplain +
    + * removeFlight(strClass $setup)   Airplain +
    +--------------------------------------------+

There are missing for me "addFlights" method arguments.

Expecting result of auto-completion dialog is:

$f14 = new Airplain();
$f14->
    +--------------------------------------------------------+
    + * __call($method, $args)                      Airplain +
    + * addFlights(array $flights, $ignore = true)  Airplain +
    + * removeFlight(strClass $setup)               Airplain +
    +--------------------------------------------------------+


If you decide to implement it, you will be first have implemented it in PHP-IDEs.

Based on http://manual.phpdoc.org/HTMLframesConverter/default/phpDocumentor/tutorial_tags.method.pkg.html it is allowed to declare variables in PHPDoc @method section.

Thanks for the attention.