Documentation improvements.

diff --git a/include/argument.h b/include/argument.h
index dfaea65cea9b4ba6d5d54dd39c000ee79b8ad19e..5690e5dbf6ba2973147535ce32d66459ad23dd95 100644 (file)
--- a/include/argument.h
+++ b/include/argument.h
@@ -14,9 +14,9 @@ namespace command {
      * Arguments are non-named parameters of program.
      *
      * Example:
-     *  ./myprog ARGUMENT
-     *  ./myprog /path/to/file
-     *  ./myprog "some argument"
+     *  - ./myprog ARGUMENT
+     *  - ./myprog /path/to/file
+     *  - ./myprog "some argument"
      */
     template<typename ParameterType>
     class Argument : public Parameter, public Callable<ParameterType> {
@@ -41,7 +41,7 @@ namespace command {
         virtual ~Argument() { }
 
         /**
-         *
+         * \inheritdoc
          */
         virtual void handle() {
             this->call(value);

diff --git a/include/option.h b/include/option.h
index 963d662aec681f690a9afeeba4074dcf7e9de2a7..516fce016eb80c6d6e350c6e050fc498e9d3c497 100644 (file)
--- a/include/option.h
+++ b/include/option.h
@@ -13,9 +13,9 @@ namespace command {
      * Options are named parameters of program.
      *
      * Example:
-     *  ./myprog OptionName=OptionValue
-     *  ./myprog -f=/some/file
-     *  ./myprog --level=15
+     *  - ./myprog OptionName=OptionValue
+     *  - ./myprog -f=/some/file
+     *  - ./myprog --level=15
      */
     template<typename ParameterType>
     class Option
@@ -51,7 +51,7 @@ namespace command {
         virtual ~Option() { }
 
         /**
-         *
+         * \inheritdoc
          */
         virtual void handle() {
             this->call(value);

diff --git a/include/parameter.h b/include/parameter.h
index a54a967e36e87bd0c9394d31b5a4b24dde22c541..443111dbd4d0de120589ac9311a1d8d9008b57ff 100644 (file)
--- a/include/parameter.h
+++ b/include/parameter.h
@@ -32,23 +32,34 @@ namespace command {
         virtual ~Parameter() { }
 
         /**
-         * Method used for handling method calls linked with Argument or Option
+         * Method used for handling method calls linked with this Parameter
          */
         virtual void handle() = 0;
 
         /**
          * Method used for checking if the given user value understandable for
          * parameter.
+         *
+         * @return true if passed value is understandable by current Parameter.
+         *      False otherwise.
          */
         virtual bool understand(const std::string & ) = 0;
 
         /**
          * Indicates if current Parameter is required
+         *
+         * @return false, as all Parameters are non-required by default. If you
+         *      want to make Parameter as required, wrap it using Required class
          */
         virtual bool isRequired() {
             return false;
         };
 
+        /**
+         * Indicates if current Parameter has been already used
+         *
+         * @return true if current Parameter has been already used. False otherwise.
+         */
         virtual bool isUsed() {
             return used;
         }

diff --git a/include/required.h b/include/required.h
index bdb629983c5b7504e160c10b031e4e566be3f893..a4e062201430dec369dc3b49bbc96273c8c12014 100644 (file)
--- a/include/required.h
+++ b/include/required.h
@@ -32,17 +32,20 @@ namespace command {
         }
 
         /**
-         * Method used for handling method calls to linked Parameter
+         * Wrapper method around passed Parameter::handle().
+         *
+         * \inheritdoc
          */
         virtual void handle() {
             parameter->handle();
         }
 
         /**
-         * Method used for checking if the given user value is understandable by
-         * parameter.
+         * Wrapper method around passed Parameter::understand()
+         *
+         * @param argv command line value against which test will be made
          *
-         * @param value value from argv to check against
+         * \inheritdoc
          */
         virtual bool understand(const std::string & value) {
             return parameter->understand(value);
@@ -50,13 +53,19 @@ namespace command {
 
         /**
          * Indicates if current Parameter is required
+         *
+         * @return true, as all Parameters wrapped in Required class are set as
+         *      required. In order to make them non-required do not use
+         *      Required class
          */
         virtual bool isRequired() {
             return true;
         };
 
         /**
-         * Indicates if current Parameter is already used
+         * Wrapper method around passed Parameter::isUsed().
+         *
+         * \inheritdoc
          */
         virtual bool isUsed() {
             return parameter->isUsed();