X-Git-Url: https://git.cyclocoop.org/?a=blobdiff_plain;f=includes%2Fsite%2FMediaWikiPageNameNormalizer.php;h=8a12c4f7ce683e3ceb374edf1c2536e126afe298;hb=4e7673c5b0aa1d53e69c850ccc58446abf29b3d5;hp=3e073f088266d936120f2d90b4962b50badf68fc;hpb=579319d960107d1d61b6778b11e359e7046ce10d;p=lhc%2Fweb%2Fwiklou.git

diff --git a/includes/site/MediaWikiPageNameNormalizer.php b/includes/site/MediaWikiPageNameNormalizer.php
index 3e073f0882..8a12c4f7ce 100644
--- a/includes/site/MediaWikiPageNameNormalizer.php
+++ b/includes/site/MediaWikiPageNameNormalizer.php
@@ -54,6 +54,7 @@ class MediaWikiPageNameNormalizer {
 	 * Returns the normalized form of the given page title, using the
 	 * normalization rules of the given site. If the given title is a redirect,
 	 * the redirect will be resolved and the redirect target is returned.
+	 * Only titles of existing pages will be returned.
 	 *
 	 * @note This actually makes an API request to the remote site, so beware
 	 *   that this function is slow and depends on an external service.
@@ -65,7 +66,9 @@ class MediaWikiPageNameNormalizer {
 	 * @param string $pageName
 	 * @param string $apiUrl
 	 *
-	 * @return string|false
+	 * @return string|false The normalized form of the title,
+	 * or false to indicate an invalid title, a missing page,
+	 * or some other kind of error.
 	 * @throws \MWException
 	 */
 	public function normalizePageName( $pageName, $apiUrl ) {