From Vim Tips Wiki

Tip 407 Previous Tip • Next Tip

Created: January 18, 2003 Complexity: intermediate Author: Klaus Horsten Minimum version: 6.0 Karma: 16/4 Imported from: Tip#407

---

Use JCommenter.vim for php-scripts:

jcommenter.vim : A script for automatically generating JavaDoc comments

PHPdoc is an imitation of JAVAdoc. The syntax between the two languages is very close, see the examples below:

Contents 1 Example 1 2 Example 2 3 Example 3 4 Note 5 Comments

[edit] Example 1

A PHP function.

function serialize_it($something) {
  $person = serialize($something);
  return $person;
}

Put the cursor on the first line and type :call JCommentWriter()<CR>

You get:

/**
 *
 *
 * @param $something
 * @return
 */
function serialize_it($something) {
  $personen = serialize($something);
  return $personen;
}

[edit] Example 2

A PHP class.

class submenu {
 ...
}

Put the cursor on the first line and type :call JCommentWriter()<CR>

You get:

/**
 *
 *
 * @author
 * @version
 */
class submenu {
 ...
}

[edit] Example 3

For a class-variable you get:

/**
 *
 */
var $urls;

[edit] Note

It does not work if you have = like in

function serialize_it($something = ) {}

But I think jscript.vim can be adapted for the use with PHP.

[edit] Comments