Merge pull request #8 from thomascorthals/phpdoc-fixes

PHPdoc fixes

Author: laurynas

lib/DetectLanguage/Client.php

@@ -149,6 +149,11 @@ protected static function getUrl($method)
         return self::getProtocol() . '://' . DetectLanguage::$host . '/' . DetectLanguage::$apiVersion . '/' . $method;
     }
 
+    /**
+     * Get protocol for request.
+     *
+     * @return string 'https' or 'http'
+     */
     protected static function getProtocol()
     {
         return DetectLanguage::$secure ? 'https' : 'http';
@@ -157,7 +162,7 @@ protected static function getProtocol()
     /**
      * Build request headers.
      *
-     * @return string
+     * @return array
      */
     protected static function getHeaders()
     {
@@ -169,6 +174,11 @@ protected static function getHeaders()
         );
     }
 
+    /**
+     * Get User-Agent for the request.
+     *
+     * @return string
+     */
     protected static function getUserAgent()
     {
         return 'detectlanguage-php-' . DetectLanguage::VERSION;

lib/DetectLanguage/DetectLanguage.php

@@ -50,7 +50,7 @@ class DetectLanguage
      * Set API key
      *
      * @static
-     * @var string
+     * @param string $apiKey
      */
     public static function setApiKey($apiKey)
     {
@@ -61,7 +61,7 @@ public static function setApiKey($apiKey)
      * Set secure mode
      *
      * @static
-     * @var boolean
+     * @param boolean $secure
      */
     public static function setSecure($secure)
     {
@@ -72,7 +72,7 @@ public static function setSecure($secure)
      * Detect text language.
      *
      * @static
-     * @param string @text The text for language detection
+     * @param string $text The text for language detection
      * @return array detected languages information
      */
     public static function detect($text)
@@ -86,8 +86,8 @@ public static function detect($text)
      * Simple detection. If you need just the language code.
      *
      * @static
-     * @param string @text The text for language detection
-     * @return string detected language code
+     * @param string $text The text for language detection
+     * @return string|null detected language code
      */
     public static function simpleDetect($text)
     {