Add phpdoc to properties
|Reported by:||vminakov||Owned by:|
Modern IDEs are able parse @phpdoc comments to allow smart code completition. This is very useful and helpful feature, especially when developing plugins for Roundcube, which provides large API.
Roundcube lacks proper phpdoc comments for properties. For example, following @phpdoc comment in rcmail class would trigger code completition for rcube_template, if developers type rcmail::get_instance()->output-> in their plugins:
<?php /** * Stores template. * * @var rcmail_template */ public $output; ...
The same applies to methods: they return instances of rcube_user or rcube_template, however @phpdocs for these methods say they're returning just "object".
Change History (6)
comment:2 Changed 3 years ago by vminakov
- Type changed from Feature Requests to Feature Patches
- Version changed from 0.4-stable to svn-trunk