title: How to align phpdoc comments in vim
body: <p>Is there a easy way to align phpdoc comment blocks in vim?</p>
  
  <p>I want </p>
  
  <pre><code>/**
   * Call an API method.
   * @param string $method The API method to call, e.g. 'lists/list'
   * @param array $args An array of arguments to pass to the method. Will be json-encoded for you.
   * @return array Associative array of json decoded API response.
   */
  </code></pre>
  
  <p>to be formatted as</p>
  
  <pre><code>/**
   * Call an API method.
   * @param  string $method The API method to call, e.g. 'lists/list'
   * @param  array  $args   An array of arguments to pass to the method. Will be json-encoded for you.
   * @return array          Associative array of json decoded API response.
   */
  </code></pre>
  
  <p>Formatting the line that contains @return may be tough, because it doesn't contain the third column. So even if I can come up with a way to align only the lines that contain @param that would be great.</p>
  
  <p><strong>Edit</strong>:</p>
  
  <p>I have already tried the <a href="https://github.com/godlygeek/tabular" rel="nofollow">tabular addon</a>, but that doesn't work since in the above case, we can't use space as the delimeter.</p>
  
  <p><strong>Edit 2</strong>:</p>
  
  <p>This is the second usecase for which @PeterRincker answer is failing</p>
  
  <pre><code>/**
   * Call an API method.
   * @since 1.7
   * @param string $method The API method to call, e.g. 'lists/list'
   * @param array $args An array of arguments to pass to the method. Will be json-encoded for you.
   * @return array Associative array of json decoded API response.
   */
  </code></pre>
  
  <p>It becomes</p>
  
  <pre><code>/**
   * Call an API method.
   * @since  1      .7
   * @param  string $method The API method to call, e.g. 'lists/list'
   * @param  array  $args   An array of arguments to pass to the method. Will be json-encoded for you.
   * @return array          Associative array of json decoded API response.
   */
  </code></pre>