Comments extended for better inline documentation

diff --git a/inc/classes/interfaces/response/class_Responseable.php b/inc/classes/interfaces/response/class_Responseable.php
index cc9cc6906452f90c69390735093c7dee1f31fdd0..9830a98f27951c9a388426a34428e36421e95205 100644 (file)
--- a/inc/classes/interfaces/response/class_Responseable.php
+++ b/inc/classes/interfaces/response/class_Responseable.php
@@ -31,7 +31,11 @@ interface Responseable extends FrameworkInterface {
        function setResponseStatus ($status);
 
        /**
-        * Add header element
+        * Adds a header to the response. This method "wraps" the direct header()
+        * function call and so it can be done "generic". E.g. if a local
+        * application like my hub does not support redirects, this method can be
+        * kept empty or it can be done something else which would not be possible
+        * with a direct header() call.
         *
         * @param       $name   Name of header element
         * @param       $value  Value of header element
@@ -80,7 +84,8 @@ interface Responseable extends FrameworkInterface {
 
        /**
         * Redirect to a configured URL. The URL can be absolute or relative. In
-        * case of relative URL it will be extended automatically.
+        * case of relative URL it will be extended automatically with the
+        * 'base_url' from configuration.
         *
         * @param       $configEntry    The configuration entry which holds our URL
         * @return      void