minor #91 add missing header comment and update doblocks (xabbuh)

This PR was merged into the 1.0-dev branch.

Discussion
----------

add missing header comment and update doblocks

Commits
-------

8868e2e add missing header comment and update doblocks

Author: javiereguiluz

src/Symfony/Installer/NewCommand.php

@@ -1,5 +1,14 @@
 <?php
 
+/*
+ * This file is part of the Symfony Installer package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
 namespace Symfony\Installer;
 
 use Distill\Distill;
@@ -83,6 +92,8 @@ protected function execute(InputInterface $input, OutputInterface $output)
      * given directory.
      *
      * @return NewCommand
+     *
+     * @throws \RuntimeException if a project with the same does already exist
      */
     private function checkProjectName()
     {
@@ -170,8 +181,7 @@ private function checkSymfonyVersionIsInstallable()
      *
      * @return NewCommand
      *
-     * @throws \Distill\Exception\FormatGuesserRequiredException
-     * @throws \Distill\Exception\StrategyRequiredException
+     * @throws \RuntimeException if the Symfony archive could not be downloaded
      */
     private function download()
     {
@@ -263,6 +273,8 @@ private function download()
      * native operating system commands if available or PHP code otherwise.
      *
      * @return NewCommand
+     *
+     * @throws \RuntimeException if the downloaded archive could not be extracted
      */
     private function extract()
     {
@@ -476,6 +488,9 @@ private function formatSize($bytes)
      * Formats the error message contained in the given Requirement item
      * using the optional line length provided.
      *
+     * @param \Requirement $requirement The Symfony requirements
+     * @param int          $lineSize    The maximum line length
+     *
      * @return string
      */
     private function getErrorMessage(\Requirement $requirement, $lineSize = 70)