X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;f=includes%2Fsite%2FMediaWikiSite.php;h=14c9a7315d3adff2899c6750039a21a9c6743be6;hb=018d340dd6541775a65e6b3c8d6be0945901528a;hp=0ff7e8bad486c794992fe2c8c9c2d022207d1e2d;hpb=9b00306abe57ff7b9f92728c664e60a29eb1791b;p=lhc%2Fweb%2Fwiklou.git diff --git a/includes/site/MediaWikiSite.php b/includes/site/MediaWikiSite.php index 0ff7e8bad4..14c9a7315d 100644 --- a/includes/site/MediaWikiSite.php +++ b/includes/site/MediaWikiSite.php @@ -22,7 +22,7 @@ use MediaWiki\Site\MediaWikiPageNameNormalizer; * * @file * @ingroup Site - * @license GNU GPL v2+ + * @license GPL-2.0-or-later * @author John Erling Blad < jeblad@gmail.com > * @author Daniel Kinzler * @author Jeroen De Dauw < jeroendedauw@gmail.com > @@ -65,6 +65,7 @@ class MediaWikiSite extends Site { * 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. @@ -79,7 +80,9 @@ class MediaWikiSite extends Site { * * @param string $pageName * - * @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 ) {