From: Alexandre Emsenhuber <mediawiki@emsenhuber.ch>
Date: Tue, 10 Jun 2014 19:52:32 +0000 (+0200)
Subject: Documentation improvements in ChangeTags.php
X-Git-Tag: 1.31.0-rc.0~15148^2
X-Git-Url: http://git.cyclocoop.org/%7B%24admin_url%7Dcompta/comptes/journal.php?a=commitdiff_plain;h=6205d825d622f2a129f7b0a185d5f3bce806dd69;p=lhc%2Fweb%2Fwiklou.git

Documentation improvements in ChangeTags.php

- Variables in ChangeTags::addTags() can be null since it is
  their default value
- Make comment mark consistent

Change-Id: Icc8b2e81cf7213e6d81ce30ac0b4de57f640a638
---

diff --git a/includes/ChangeTags.php b/includes/ChangeTags.php
index 28db8a1bdb..f51a5a8023 100644
--- a/includes/ChangeTags.php
+++ b/includes/ChangeTags.php
@@ -77,9 +77,9 @@ class ChangeTags {
 	 * Add tags to a change given its rc_id, rev_id and/or log_id
 	 *
 	 * @param string|array $tags Tags to add to the change
-	 * @param int $rc_id rc_id of the change to add the tags to
-	 * @param int $rev_id rev_id of the change to add the tags to
-	 * @param int $log_id Log_id of the change to add the tags to
+	 * @param int|null $rc_id rc_id of the change to add the tags to
+	 * @param int|null $rev_id rev_id of the change to add the tags to
+	 * @param int|null $log_id Log_id of the change to add the tags to
 	 * @param string $params params to put in the ct_params field of table 'change_tag'
 	 *
 	 * @throws MWException
@@ -143,7 +143,7 @@ class ChangeTags {
 			'ts_log_id' => $log_id )
 		);
 
-		## Update the summary row.
+		// Update the summary row.
 		// $prevTags can be out of date on slaves, especially when addTags is called consecutively,
 		// causing loss of tags added recently in tag_summary table.
 		$prevTags = $dbw->selectField( 'tag_summary', 'ts_tags', $tsConds, __METHOD__ );