From a6568e988b0de61cb7d20369ef604a42758a2613 Mon Sep 17 00:00:00 2001
From: Ivan Lanin <ivanlanin@gmail.com>
Date: Wed, 26 Mar 2014 17:21:23 +0700
Subject: [PATCH] Proposed simplified docblock

---
 src/PhpWord/PhpWord.php             | 22 +++-------------
 tests/PhpWord/Tests/PhpWordTest.php | 39 ++++++++++++++++++++++++++---
 2 files changed, 39 insertions(+), 22 deletions(-)

diff --git a/src/PhpWord/PhpWord.php b/src/PhpWord/PhpWord.php
index eb8c45ec..1fa0c4b8 100644
--- a/src/PhpWord/PhpWord.php
+++ b/src/PhpWord/PhpWord.php
@@ -2,25 +2,11 @@
 /**
  * PHPWord
  *
- * Copyright (c) 2014 PHPWord
+ * PHP version 5.3
  *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
- *
- * @copyright  Copyright (c) 2014 PHPWord
- * @license    http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt    LGPL
- * @version    0.9.0
+ * @copyright   2014 PHPWord
+ * @license     http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
+ * @version     0.9.0
  */
 
 namespace PhpOffice\PhpWord;
diff --git a/tests/PhpWord/Tests/PhpWordTest.php b/tests/PhpWord/Tests/PhpWordTest.php
index bcabcfb3..f7133358 100644
--- a/tests/PhpWord/Tests/PhpWordTest.php
+++ b/tests/PhpWord/Tests/PhpWordTest.php
@@ -1,4 +1,14 @@
 <?php
+/**
+ * PHPWord
+ *
+ * PHP version 5.3
+ *
+ * @copyright   2014 PHPWord
+ * @license     http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
+ * @version     0.9.0
+ */
+
 namespace PhpOffice\PhpWord\Tests;
 
 use PhpOffice\PhpWord\PhpWord;
@@ -7,13 +17,16 @@ use PhpOffice\PhpWord\Section;
 use PhpOffice\PhpWord\Style;
 
 /**
- * @coversDefaultClass          \PhpOffice\PhpWord\PhpWord
+ * Test for PHPWord main class
+ *
+ * @coversDefaultClass \PhpOffice\PhpWord\PhpWord
  * @runTestsInSeparateProcesses
  */
 class PhpWordTest extends \PHPUnit_Framework_TestCase
 {
     /**
-     * @covers ::__construct
+     * Test object creation
+     *
      * @covers ::getDocumentProperties
      * @covers ::getDefaultFontName
      * @covers ::getDefaultFontSize
@@ -27,6 +40,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test set/get document properties
+     *
      * @covers ::setDocumentProperties
      * @covers ::getDocumentProperties
      */
@@ -41,6 +56,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test create/get section
+     *
      * @covers ::createSection
      * @covers ::getSections
      */
@@ -53,6 +70,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test set/get default font name
+     *
      * @covers ::setDefaultFontName
      * @covers ::getDefaultFontName
      */
@@ -66,6 +85,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test set/get default font size
+     *
      * @covers ::setDefaultFontSize
      * @covers ::getDefaultFontSize
      */
@@ -79,6 +100,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test set default paragraph style
+     *
      * @covers ::setDefaultParagraphStyle
      * @covers ::loadTemplate
      */
@@ -90,6 +113,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test add styles
+     *
      * @covers ::addParagraphStyle
      * @covers ::addFontStyle
      * @covers ::addTableStyle
@@ -114,6 +139,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test add title style
+     *
      * @covers ::addTitleStyle
      */
     public function testAddTitleStyle()
@@ -126,6 +153,8 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
+     * Test load template
+     *
      * @covers ::loadTemplate
      */
     public function testLoadTemplate()
@@ -140,14 +169,16 @@ class PhpWordTest extends \PHPUnit_Framework_TestCase
     }
 
     /**
-     * @covers            ::loadTemplate
+     * Test load template exception
+     *
+     * @covers ::loadTemplate
      * @expectedException \PhpOffice\PhpWord\Exceptions\Exception
      */
     public function testLoadTemplateException()
     {
         $templateFqfn = \join(
             \DIRECTORY_SEPARATOR,
-            array(\PHPWORD_TESTS_BASE_DIR, 'PhpWord', 'Tests', 'data', 'templates', 'blanks.docx')
+            array(\PHPWORD_TESTS_BASE_DIR, 'PhpWord', 'Tests', '_files', 'templates', 'blanks.docx')
         );
         $phpWord = new PhpWord();
         $phpWord->loadTemplate($templateFqfn);