Fix broken PHPDoc comments that don't start with /**

Change-Id: I8db56ff0f73873864dde260e51adcd729aa74e94

21 files changed, 42 insertions, 21 deletions

diff --git a/includes/htmlform/CollapsibleFieldsetLayout.php b/includes/htmlform/CollapsibleFieldsetLayout.php
index f45e9a7306d9..210669bf46b7 100644
--- a/includes/htmlform/CollapsibleFieldsetLayout.php
+++ b/includes/htmlform/CollapsibleFieldsetLayout.php
@@ -4,8 +4,9 @@
  * @stable to extend
  */
 class CollapsibleFieldsetLayout extends OOUI\FieldsetLayout {
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( array $config = [] ) {
 		parent::__construct( $config );
diff --git a/includes/htmlform/HTMLFormActionFieldLayout.php b/includes/htmlform/HTMLFormActionFieldLayout.php
index 9f6045db3d70..edaaaf301c03 100644
--- a/includes/htmlform/HTMLFormActionFieldLayout.php
+++ b/includes/htmlform/HTMLFormActionFieldLayout.php
@@ -6,8 +6,9 @@
 class HTMLFormActionFieldLayout extends OOUI\ActionFieldLayout {
 	use HTMLFormElement;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $fieldWidget, $buttonWidget = false, array $config = [] ) {
 		parent::__construct( $fieldWidget, $buttonWidget, $config );
diff --git a/includes/htmlform/HTMLFormFieldLayout.php b/includes/htmlform/HTMLFormFieldLayout.php
index e26ab768cb83..cba2f0fe272f 100644
--- a/includes/htmlform/HTMLFormFieldLayout.php
+++ b/includes/htmlform/HTMLFormFieldLayout.php
@@ -6,8 +6,9 @@
 class HTMLFormFieldLayout extends OOUI\FieldLayout {
 	use HTMLFormElement;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $fieldWidget, array $config = [] ) {
 		parent::__construct( $fieldWidget, $config );
diff --git a/includes/htmlform/OOUIHTMLForm.php b/includes/htmlform/OOUIHTMLForm.php
index 196f1f3e03b2..e9993eee220f 100644
--- a/includes/htmlform/OOUIHTMLForm.php
+++ b/includes/htmlform/OOUIHTMLForm.php
@@ -30,8 +30,9 @@ class OOUIHTMLForm extends HTMLForm {
 	private $oouiErrors;
 	private $oouiWarnings;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $descriptor, $context = null, $messagePrefix = '' ) {
 		parent::__construct( $descriptor, $context, $messagePrefix );
diff --git a/includes/htmlform/fields/HTMLAutoCompleteSelectField.php b/includes/htmlform/fields/HTMLAutoCompleteSelectField.php
index a36401af7533..278cfdc27fe1 100644
--- a/includes/htmlform/fields/HTMLAutoCompleteSelectField.php
+++ b/includes/htmlform/fields/HTMLAutoCompleteSelectField.php
@@ -35,8 +35,9 @@
 class HTMLAutoCompleteSelectField extends HTMLTextField {
 	protected $autocompleteData = [];
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$params += [
diff --git a/includes/htmlform/fields/HTMLButtonField.php b/includes/htmlform/fields/HTMLButtonField.php
index 3e58ba98bc64..5aec32388cd9 100644
--- a/includes/htmlform/fields/HTMLButtonField.php
+++ b/includes/htmlform/fields/HTMLButtonField.php
@@ -29,8 +29,9 @@ class HTMLButtonField extends HTMLFormField {
 
 	protected $mFormnovalidate = false;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $info ) {
 		$info['nodata'] = true;
diff --git a/includes/htmlform/fields/HTMLCheckMatrix.php b/includes/htmlform/fields/HTMLCheckMatrix.php
index 7c7a17738d97..cadd619ca608 100644
--- a/includes/htmlform/fields/HTMLCheckMatrix.php
+++ b/includes/htmlform/fields/HTMLCheckMatrix.php
@@ -33,8 +33,9 @@ class HTMLCheckMatrix extends HTMLFormField implements HTMLNestedFilterable {
 		'columns'
 	];
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$missing = array_diff( self::$requiredParams, array_keys( $params ) );
diff --git a/includes/htmlform/fields/HTMLDateTimeField.php b/includes/htmlform/fields/HTMLDateTimeField.php
index c1e39258aab3..f356813edbaf 100644
--- a/includes/htmlform/fields/HTMLDateTimeField.php
+++ b/includes/htmlform/fields/HTMLDateTimeField.php
@@ -26,8 +26,9 @@ class HTMLDateTimeField extends HTMLTextField {
 
 	protected $mType = 'datetime';
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLFormFieldCloner.php b/includes/htmlform/fields/HTMLFormFieldCloner.php
index 76553f1a7be5..33fa6c41d462 100644
--- a/includes/htmlform/fields/HTMLFormFieldCloner.php
+++ b/includes/htmlform/fields/HTMLFormFieldCloner.php
@@ -46,8 +46,9 @@ class HTMLFormFieldCloner extends HTMLFormField {
 	 */
 	protected $uniqueId;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$this->uniqueId = static::class . ++self::$counter . 'x';
diff --git a/includes/htmlform/fields/HTMLFormFieldWithButton.php b/includes/htmlform/fields/HTMLFormFieldWithButton.php
index 845da8dfa8cb..8e95a7655641 100644
--- a/includes/htmlform/fields/HTMLFormFieldWithButton.php
+++ b/includes/htmlform/fields/HTMLFormFieldWithButton.php
@@ -23,8 +23,9 @@ class HTMLFormFieldWithButton extends HTMLFormField {
 	/** @var string[] Value for the button in this field */
 	protected $mButtonFlags = [ 'progressive' ];
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $info ) {
 		if ( isset( $info['buttonclass'] ) ) {
diff --git a/includes/htmlform/fields/HTMLHiddenField.php b/includes/htmlform/fields/HTMLHiddenField.php
index bf337e2b398a..b931be208b50 100644
--- a/includes/htmlform/fields/HTMLHiddenField.php
+++ b/includes/htmlform/fields/HTMLHiddenField.php
@@ -6,8 +6,9 @@
 class HTMLHiddenField extends HTMLFormField {
 	protected $outputAsDefault = true;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLRestrictionsField.php b/includes/htmlform/fields/HTMLRestrictionsField.php
index b0e0bb9d908c..7ba698190346 100644
--- a/includes/htmlform/fields/HTMLRestrictionsField.php
+++ b/includes/htmlform/fields/HTMLRestrictionsField.php
@@ -17,8 +17,9 @@ use Wikimedia\IPUtils;
 class HTMLRestrictionsField extends HTMLTextAreaField {
 	protected const DEFAULT_ROWS = 5;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( array $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLSelectAndOtherField.php b/includes/htmlform/fields/HTMLSelectAndOtherField.php
index d890f9599399..39a05e1c721c 100644
--- a/includes/htmlform/fields/HTMLSelectAndOtherField.php
+++ b/includes/htmlform/fields/HTMLSelectAndOtherField.php
@@ -16,8 +16,9 @@ class HTMLSelectAndOtherField extends HTMLSelectField {
 	/** @var string[] */
 	private $mFlatOptions;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		if ( array_key_exists( 'other', $params ) ) {
diff --git a/includes/htmlform/fields/HTMLSelectLanguageField.php b/includes/htmlform/fields/HTMLSelectLanguageField.php
index 12f1ab3bf78f..afe6e6bfe099 100644
--- a/includes/htmlform/fields/HTMLSelectLanguageField.php
+++ b/includes/htmlform/fields/HTMLSelectLanguageField.php
@@ -9,8 +9,9 @@ use MediaWiki\MediaWikiServices;
  */
 class HTMLSelectLanguageField extends HTMLSelectField {
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLSelectNamespace.php b/includes/htmlform/fields/HTMLSelectNamespace.php
index 86f56405a1ab..019ff9b2cec2 100644
--- a/includes/htmlform/fields/HTMLSelectNamespace.php
+++ b/includes/htmlform/fields/HTMLSelectNamespace.php
@@ -9,8 +9,9 @@ class HTMLSelectNamespace extends HTMLFormField {
 	/** @var string|null */
 	protected $mAllValue;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLSelectNamespaceWithButton.php b/includes/htmlform/fields/HTMLSelectNamespaceWithButton.php
index dd5cd28acc77..636b54a24e7f 100644
--- a/includes/htmlform/fields/HTMLSelectNamespaceWithButton.php
+++ b/includes/htmlform/fields/HTMLSelectNamespaceWithButton.php
@@ -8,8 +8,9 @@ class HTMLSelectNamespaceWithButton extends HTMLSelectNamespace {
 	/** @var HTMLFormFieldWithButton */
 	protected $mClassWithButton = null;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $info ) {
 		$this->mClassWithButton = new HTMLFormFieldWithButton( $info );
diff --git a/includes/htmlform/fields/HTMLSelectOrOtherField.php b/includes/htmlform/fields/HTMLSelectOrOtherField.php
index 829160edc9e7..d2bb8ea1a9ad 100644
--- a/includes/htmlform/fields/HTMLSelectOrOtherField.php
+++ b/includes/htmlform/fields/HTMLSelectOrOtherField.php
@@ -10,8 +10,9 @@
  */
 class HTMLSelectOrOtherField extends HTMLTextField {
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		parent::__construct( $params );
diff --git a/includes/htmlform/fields/HTMLTextFieldWithButton.php b/includes/htmlform/fields/HTMLTextFieldWithButton.php
index 17e8b6138f8d..6105acb989b3 100644
--- a/includes/htmlform/fields/HTMLTextFieldWithButton.php
+++ b/includes/htmlform/fields/HTMLTextFieldWithButton.php
@@ -8,8 +8,9 @@ class HTMLTextFieldWithButton extends HTMLTextField {
 	/** @var HTMLFormFieldWithButton */
 	protected $mClassWithButton = null;
 
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $info ) {
 		$this->mClassWithButton = new HTMLFormFieldWithButton( $info );
diff --git a/includes/htmlform/fields/HTMLTitleTextField.php b/includes/htmlform/fields/HTMLTitleTextField.php
index 2c56b59ec561..e58c78a580d7 100644
--- a/includes/htmlform/fields/HTMLTitleTextField.php
+++ b/includes/htmlform/fields/HTMLTitleTextField.php
@@ -17,8 +17,9 @@ use MediaWiki\Widget\TitleInputWidget;
  * @since 1.26
  */
 class HTMLTitleTextField extends HTMLTextField {
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$params += [
diff --git a/includes/htmlform/fields/HTMLTitlesMultiselectField.php b/includes/htmlform/fields/HTMLTitlesMultiselectField.php
index 75b665fa3435..c06b62364ea2 100644
--- a/includes/htmlform/fields/HTMLTitlesMultiselectField.php
+++ b/includes/htmlform/fields/HTMLTitlesMultiselectField.php
@@ -21,8 +21,9 @@ use MediaWiki\Widget\TitlesMultiselectWidget;
  * @note This widget is not likely to remain functional in non-OOUI forms.
  */
 class HTMLTitlesMultiselectField extends HTMLTitleTextField {
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$params += [
diff --git a/includes/htmlform/fields/HTMLUserTextField.php b/includes/htmlform/fields/HTMLUserTextField.php
index 99e3b71e84c8..ab4a4cb5f85c 100644
--- a/includes/htmlform/fields/HTMLUserTextField.php
+++ b/includes/htmlform/fields/HTMLUserTextField.php
@@ -18,8 +18,9 @@ use Wikimedia\IPUtils;
  * @since 1.26
  */
 class HTMLUserTextField extends HTMLTextField {
-	/*
+	/**
 	 * @stable to call
+	 * @inheritDoc
 	 */
 	public function __construct( $params ) {
 		$params = wfArrayPlus2d( $params, [