[feature/passwords] Mark old hashing functions as deprecated

PHPBB3-11610

phpBB/includes/functions.php

@@ -368,33 +368,13 @@ function still_on_time($extra_time = 15)
 }
 
 /**
-*
-* @version Version 0.1 / slightly modified for phpBB 3.1.x (using $H$ as hash type identifier)
-*
-* Portable PHP password hashing framework.
-*
-* Written by Solar Designer <solar at openwall.com> in 2004-2006 and placed in
-* the public domain.
-*
-* There's absolutely no warranty.
-*
-* The homepage URL for this framework is:
-*
-*	http://www.openwall.com/phpass/
-*
-* Please be sure to update the Version line if you edit this file in any way.
-* It is suggested that you leave the main version number intact, but indicate
-* your project name (after the slash) and add your own revision information.
-*
-* Please do not change the "private" password hashing method implemented in
-* here, thereby making your hashes incompatible.  However, if you must, please
-* change the hash type identifier (the "$P$") to something different.
-*
-* Obviously, since this code is in the public domain, the above are not
-* requirements (there can be none), but merely suggestions.
-*
-*
 * Hash the password
+*
+* @deprecated 3.1.0-a2 (To be removed: 3.3.0)
+*
+* @param string $password Password to be hashed
+*
+* @return string Password hash or false if something went wrong during hashing
 */
 function phpbb_hash($password)
 {
@@ -407,6 +387,8 @@ function phpbb_hash($password)
 /**
 * Check for correct password
 *
+* @deprecated 3.1.0-a2 (To be removed: 3.3.0)
+*
 * @param string $password The password in plain text
 * @param string $hash The stored password hash
 *