From: Max Semenik <maxsem.wiki@gmail.com>
Date: Sat, 17 Mar 2018 05:30:19 +0000 (-0700)
Subject: Normalize PHPDoc attributes
X-Git-Tag: 1.31.0-rc.0~356^2
X-Git-Url: https://git.cyclocoop.org/?a=commitdiff_plain;h=369b3fa977a2d5ce07ed14b9b54f30c8803f6b1a;p=lhc%2Fweb%2Fwiklou.git

Normalize PHPDoc attributes

Change-Id: I83e686d099de0ff0aacda7e332972e1c7ee49f04
---

diff --git a/includes/diff/TableDiffFormatter.php b/includes/diff/TableDiffFormatter.php
index 14307b5844..67f9a79b23 100644
--- a/includes/diff/TableDiffFormatter.php
+++ b/includes/diff/TableDiffFormatter.php
@@ -38,7 +38,6 @@ class TableDiffFormatter extends DiffFormatter {
 	}
 
 	/**
-	 * @static
 	 * @param string $msg
 	 *
 	 * @return mixed
diff --git a/includes/htmlform/HTMLForm.php b/includes/htmlform/HTMLForm.php
index 78e7625915..9b58f924f4 100644
--- a/includes/htmlform/HTMLForm.php
+++ b/includes/htmlform/HTMLForm.php
@@ -504,7 +504,7 @@ class HTMLForm extends ContextSource {
 	/**
 	 * Prepare form for submission.
 	 *
-	 * @attention When doing method chaining, that should be the very last
+	 * @warning When doing method chaining, that should be the very last
 	 * method call before displayForm().
 	 *
 	 * @throws MWException
@@ -1006,7 +1006,7 @@ class HTMLForm extends ContextSource {
 	 * Display the form (sending to the context's OutputPage object), with an
 	 * appropriate error message or stack of messages, and any validation errors, etc.
 	 *
-	 * @attention You should call prepareForm() before calling this function.
+	 * @warning You should call prepareForm() before calling this function.
 	 * Moreover, when doing method chaining this should be the very last method
 	 * call just after prepareForm().
 	 *
diff --git a/includes/libs/virtualrest/SwiftVirtualRESTService.php b/includes/libs/virtualrest/SwiftVirtualRESTService.php
index 679d51c5ac..e00bee36a8 100644
--- a/includes/libs/virtualrest/SwiftVirtualRESTService.php
+++ b/includes/libs/virtualrest/SwiftVirtualRESTService.php
@@ -22,7 +22,7 @@
 
 /**
  * Example virtual rest service for OpenStack Swift
- * @TODO: caching support (APC/memcached)
+ * @todo caching support (APC/memcached)
  * @since 1.23
  */
 class SwiftVirtualRESTService extends VirtualRESTService {
diff --git a/includes/parser/StripState.php b/includes/parser/StripState.php
index d329f693fe..855ce1d547 100644
--- a/includes/parser/StripState.php
+++ b/includes/parser/StripState.php
@@ -199,7 +199,7 @@ class StripState {
 	/**
 	 * Get an array of parameters to pass to ParserOutput::setLimitReportData()
 	 *
-	 * @unstable Should only be called by Parser
+	 * @internal Should only be called by Parser
 	 * @return array
 	 */
 	public function getLimitReport() {
diff --git a/includes/profiler/ProfileSection.php b/includes/profiler/ProfileSection.php
index d48f74422f..124e2d3b11 100644
--- a/includes/profiler/ProfileSection.php
+++ b/includes/profiler/ProfileSection.php
@@ -35,7 +35,7 @@ class ProfileSection {
 	 * the same moment that the function to be profiled terminates.
 	 *
 	 * This is typically called like:
-	 * @code$section = new ProfileSection( __METHOD__ );@endcode
+	 * @code $section = new ProfileSection( __METHOD__ ); @endcode
 	 *
 	 * @param string $name Name of the function to profile
 	 */
diff --git a/includes/resourceloader/ResourceLoaderModule.php b/includes/resourceloader/ResourceLoaderModule.php
index 3be687b785..8bf71705d6 100644
--- a/includes/resourceloader/ResourceLoaderModule.php
+++ b/includes/resourceloader/ResourceLoaderModule.php
@@ -620,7 +620,7 @@ abstract class ResourceLoaderModule implements LoggerAwareInterface {
 	 *             'https://example.org/image.png' => [ 'as' => 'image' ],
 	 *         ];
 	 *     }
-	 * @encode
+	 * @endcode
 	 *
 	 * @par Example using HiDPI image variants
 	 * @code
@@ -636,7 +636,7 @@ abstract class ResourceLoaderModule implements LoggerAwareInterface {
 	 *             ],
 	 *         ];
 	 *     }
-	 * @encode
+	 * @endcode
 	 *
 	 * @see ResourceLoaderModule::getHeaders
 	 * @since 1.30