title: What is the correct way to display a multi-line @param using PHPDoc?
body: <p>From what I've done research on, I can't seem to find a correct method to format a multiline phpdoc <code>@param</code> line. What is the recommended way to do so?</p>
  
  <p>Here's an example:</p>
  
  <pre><code>/**
   * Prints 'Hello World'.
   *
   * Prints out 'Hello World' directly to the output.
   * Can be used to render examples of PHPDoc.
   *
   * @param string $noun Optional. Sends a greeting to a given noun instead.
   *                     Input is converted to lowercase and capitalized.
   * @param bool   $surprise Optional. Adds an exclamation mark after the string.
   */
  function helloYou( $noun = 'World', $surprise = false ) {
  
      $string = 'Hello ' . ucwords( strtolower( $string ) );
  
      if( !!$surprise ) {
          $string .= '!';
      }
  
      echo $string;
  
  }
  </code></pre>
  
  <p>Would that be correct, or would you not add indentation, or would you just keep everything on one, long line?</p>