[ticket/11854] Fix various comments

PHPBB3-11854

phpBB/phpbb/captcha/factory.php

@@ -40,8 +40,12 @@ class factory
 		$this->plugins = $plugins;
 	}
 
-	//static public function get_instance($name)
-
+	/**
+	* Return a new instance of a given plugin
+	*
+	* @param $name
+	* @return object
+	*/
 	public function get_instance($name)
 	{
 		return $this->container->get($name);

phpBB/phpbb/captcha/plugins/recaptcha.php

@@ -72,7 +72,7 @@ class recaptcha extends \phpbb\captcha\plugins\captcha_abstract
 	}
 
 	/**
-	* @return string the name of the class used to generate the captcha
+	* This function is implemented because required by the upper class, but is never used for reCaptcha.
 	*/
 	function get_generator_class()
 	{