add docblocks to all files, classes, methods and variables

[bdrem.git] / src / bdrem / Cli.php

diff --git a/src/bdrem/Cli.php b/src/bdrem/Cli.php
index f108e8e4b8b48cff5567458051538c172054bac0..0525a37634819c231ab7c769ad6a87e2a056550e 100644 (file)
--- a/src/bdrem/Cli.php
+++ b/src/bdrem/Cli.php
@@ -1,8 +1,39 @@
 <?php
 <?php

+/**
+ * Part of bdrem
+ *
+ * PHP version 5
+ *
+ * @category  Tools
+ * @package   Bdrem
+ * @author    Christian Weiske <cweiske@cweiske.de>
+ * @copyright 2014 Christian Weiske
+ * @license   http://www.gnu.org/licenses/agpl.html GNU AGPL v3
+ * @link      http://cweiske.de/bdrem.htm
+ */

 namespace bdrem;
 
 namespace bdrem;
 

+/**
+ * Command line user interface for the terminal/shell.
+ * Renders an ASCII table by default.
+ *
+ * @category  Tools
+ * @package   Bdrem
+ * @author    Christian Weiske <cweiske@cweiske.de>
+ * @copyright 2014 Christian Weiske
+ * @license   http://www.gnu.org/licenses/agpl.html GNU AGPL v3
+ * @version   Release: @package_version@
+ * @link      http://cweiske.de/bdrem.htm
+ */

 class Cli extends UserInterface
 {
 class Cli extends UserInterface
 {

+    /**
+     * Load parameters for the CLI option parser.
+     * Set the default renderer to "console" and adds some CLI-only commands
+     * like "readme" and "config".
+     *
+     * @return \Console_CommandLine CLI option parser
+     */

     protected function loadParameters()
     {
         $parser = parent::loadParameters();
     protected function loadParameters()
     {
         $parser = parent::loadParameters();


@@ -24,6 +55,13 @@ class Cli extends UserInterface
         return $parser;
     }
 
         return $parser;
     }
 

+    /**
+     * Handle any commands given on the CLI
+     *
+     * @param object $res Command line parameters and options
+     *
+     * @return void
+     */

     protected function handleCommands($res)
     {
         if ($res->command_name == '') {
     protected function handleCommands($res)
     {
         if ($res->command_name == '') {


@@ -37,12 +75,22 @@ class Cli extends UserInterface
         }
     }
 
         }
     }
 

+    /**
+     * Handle the "readme" command and output the readme.
+     *
+     * @return void
+     */

     protected function showReadme()
     {
         readfile(__DIR__ . '/../../README.rst');
         exit();
     }
 
     protected function showReadme()
     {
         readfile(__DIR__ . '/../../README.rst');
         exit();
     }
 

+    /**
+     * Handle the "config" command and output the default configuration
+     *
+     * @return void
+     */

     protected function extractConfig()
     {
         readfile(__DIR__ . '/../../data/bdrem.config.php.dist');
     protected function extractConfig()
     {
         readfile(__DIR__ . '/../../data/bdrem.config.php.dist');