Docs: Improve documentation for WP_Upgrader::release_lock(), introduced in [36349].

See #34878. See #35986.


git-svn-id: https://develop.svn.wordpress.org/trunk@36822 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-admin/includes/class-wp-upgrader.php

@@ -799,14 +799,16 @@ class WP_Upgrader {
 	}
 
 	/**
- 	 * Release a lock created by `WP_Upgrader::create_lock()`.
+ 	 * Releases an upgrader lock.
  	 *
  	 * @since 4.5.0
  	 * @access public
  	 * @static
+	 *
+	 * @see WP_Upgrader::create_lock()
  	 *
  	 * @param string $lock_name The name of this unique lock.
- 	 * @return bool
+	 * @return bool True if the lock was successfully released. False on failure.
  	 */
 	public static function release_lock( $lock_name ) {
 		return delete_option( $lock_name . '.lock' );