Merge pull request #20 from barryvdh/master

Export docblock comment

Author: boenrobot

src/phpDocumentor/Reflection/DocBlock.php

@@ -229,6 +229,29 @@ protected function parseTags($tags)
         $this->tags = $result;
     }
 
+    public function getText(){
+        $short = $this->getShortDescription();
+        $long = $this->getLongDescription()->getContents();
+
+        if($long){
+            return $short . "\n\n" . $long;
+        }else{
+            return $short;
+        }
+    }
+
+    /**
+     * Set the short and long description.
+     *
+     * @param string $docblock
+     * @return $this
+     */
+    public function setText($comment){
+        list($short, $long) = $this->splitDocBlock($comment);
+        $this->short_description = $short;
+        $this->long_description = new DocBlock\Description($long, $this);
+        return $this;
+    }
     /**
      * Returns the opening line or also known as short description.
      *
@@ -321,22 +344,22 @@ public function hasTag($name)
 
         return false;
     }
-    
+
     /**
      * Appends a tag at the end of the list of tags.
-     * 
+     *
      * @param Tag $tag The tag to add.
-     * 
+     *
      * @return Tag The newly added tag.
-     * 
+     *
      * @throws \LogicException When the tag belongs to a different DocBlock.
      */
     public function appendTag(Tag $tag)
     {
         if (null === $tag->getDocBlock()) {
             $tag->setDocBlock($this);
         }
-        
+
         if ($tag->getDocBlock() === $this) {
             $this->tags[] = $tag;
         } else {
@@ -348,6 +371,7 @@ public function appendTag(Tag $tag)
         return $tag;
     }
 
+
     /**
      * Builds a string representation of this object.
      *

src/phpDocumentor/Reflection/DocBlock/Serializer.php

@@ -0,0 +1,122 @@
+<?php
+/**
+ * phpDocumentor
+ *
+ * PHP Version 5.3
+ *
+ * @author    Mike van Riel <[email protected]>
+ * @copyright 2010-2011 Mike van Riel / Naenius (http://www.naenius.com)
+ * @license   http://www.opensource.org/licenses/mit-license.php MIT
+ * @link      http://phpdoc.org
+ */
+
+namespace phpDocumentor\Reflection\DocBlock;
+
+use phpDocumentor\Reflection\DocBlock;
+
+/**
+ * Serializes a DocBlock instance
+ *
+ * @author  Barry vd. Heuvel <[email protected]>
+ * @license http://www.opensource.org/licenses/mit-license.php MIT
+ * @link    http://phpdoc.org
+ */
+class Serializer
+{
+
+    /** @var string The string to indent the comment with */
+    protected $indentString;
+
+    /** @var  int The number of times $indentString is repeated */
+    protected $indent;
+
+    /** @var  bool Indent the first line */
+    protected $indentFirstLine;
+
+    /** @var int The max length of a description line. */
+    protected $lineLength = null;
+
+    /**
+     * Create a Serializer instance.
+     *
+     * @param string $indentString
+     * @param int $indent
+     * @param bool $indentFirstLine
+     * @internal param string $indentationString The indentation string.
+     */
+    public function __construct($indentString = ' ', $indent = 4, $indentFirstLine = true)
+    {
+        $this->indentString = $indentString;
+        $this->indent = $indent;
+        $this->indentFirstLine = $indentFirstLine;
+    }
+
+    /**
+     * @param $indentationString
+     * @return $this
+     */
+    public function setIndentationString($indentationString)
+    {
+        $this->indentation = $indentationString;
+        return $this;
+    }
+
+    /**
+     * @param $indent
+     * @return $this
+     */
+    public function setIndent($indent){
+        $this->indent = $indent;
+        return $this;
+    }
+
+    /**
+     * @param $indentFirstLine
+     * @return $this
+     */
+    public function setIndentFirstLine($indentFirstLine){
+        $this->indentFirstLine = $indentFirstLine;
+        return $this;
+    }
+
+    /**
+     * @param $lineLength
+     * @return $this
+     */
+    public function setLineLength($lineLength){
+        $this->lineLength = $lineLength;
+        return $this;
+    }
+
+    /**
+     * Generate a DocBlock Comment
+     *
+     * @param DocBlock  The DocBlock to serialize
+     * @return string
+     */
+    public function getDocComment($phpdoc){
+
+        $indent = '';
+        for($i=0;$i<$this->indent;$i++){
+            $indent .= $this->indentString;
+        }
+        $firstIndent = $this->indentFirstLine ? $indent : '';
+
+        $description = $phpdoc->getText();
+        if($this->lineLength){
+            $description = wordwrap($description, $this->lineLength);
+        }
+        $description = str_replace("\n", "\n$indent * ", $description);
+
+        $comment = "$firstIndent/**\n$indent * $description\n$indent *\n";
+
+        /** @var Tag $tag */
+        foreach ($phpdoc->getTags() as $tag) {
+            $comment .= $indent.' * @'. $tag->getName() . " " . $tag->getContent() . "\n";
+        }
+
+        $comment .= $indent.' */';
+
+        return $comment;
+    }
+}