Correct various pieces of yardoc

Author: rastating

lib/wpxf/core/payload.rb

@@ -36,7 +36,7 @@ def escape_single_quotes(val)
     end
 
     # Generate a random variable name.
-    # @return [String] a random name beetween 1 and 9 alpha characters.
+    # @return [String] a random name beetween 5 and 20 alpha characters.
     def random_var_name
       Utility::Text.rand_alpha(rand(5..20))
     end

lib/wpxf/net/http_server.rb

@@ -41,7 +41,11 @@ def http_server_bind_port
   # @param path [String] the path requested.
   # @param params [Hash] the query string parameters.
   # @param headers [Hash] the HTTP headers.
-  # @return [String] the response body to send to the client.
+  # @return [String, Hash] if a string is returned, it will be used as the response body
+  #  to send to the client. If a {Hash} is returned, it should contain the keys:
+  #  * +:body+ - the body text of the response.
+  #  * +:type+ - the MIME type of the response.
+  #  * +:headers+ - a {Hash} of header keys and values.
   def on_http_request(path, params, headers)
   end
 

lib/wpxf/wordpress/stored_xss.rb

@@ -24,7 +24,7 @@ def store_script
     raise 'Required method "store_script" has not been implemented'
   end
 
-  # Call #store_script and validate the response.
+  # Call {store_script} and validate the response.
   # @return [Boolean] return true if the script was successfully stored.
   def store_script_and_validate
     res = store_script