From: csteipp <csteipp@wikimedia.org>
Date: Fri, 4 Dec 2015 00:12:41 +0000 (-0800)
Subject: Add warning comment on formatLinksInComment
X-Git-Tag: 1.31.0-rc.0~8825
X-Git-Url: https://git.cyclocoop.org/%7B%24www_url%7Dadmin/compta/exercices/bilan.php?a=commitdiff_plain;h=d20243c06aa157dbfedccf1af26702576e39e922;p=lhc%2Fweb%2Fwiklou.git

Add warning comment on formatLinksInComment

Bug: T120324
Change-Id: If4423e14737a7e9d80661da27ad6f5463798a7d7
---

diff --git a/includes/Linker.php b/includes/Linker.php
index 842d276d2a..5255b9a133 100644
--- a/includes/Linker.php
+++ b/includes/Linker.php
@@ -1393,7 +1393,10 @@ class Linker {
 	 * is ignored
 	 *
 	 * @todo FIXME: Doesn't handle sub-links as in image thumb texts like the main parser
-	 * @param string $comment Text to format links in
+	 * @param string $comment Text to format links in. WARNING! Since the output of this
+	 *	function is html, $comment must be sanitized for use as html. You probably want
+	 *	to pass $comment through Sanitizer::escapeHtmlAllowEntities() before calling
+	 *	this function.
 	 * @param Title|null $title An optional title object used to links to sections
 	 * @param bool $local Whether section links should refer to local page
 	 * @param string|null $wikiId Id of the wiki to link to (if not the local wiki),