From 2fa057da21a5472887ddf73fa8e5dbb355096f85 Mon Sep 17 00:00:00 2001
From: Evgeniy Tkachenko <et.coder@gmail.com>
Date: Fri, 14 Jan 2022 23:20:57 +0300
Subject: [PATCH] docs: correct Syntax for phpDoc (#495)

Co-authored-by: githubjeka <etcoder@gmail.com>
---
 .../controller/default/controller.php         |  4 ++--
 src/generators/controller/default/view.php    |  8 ++++----
 src/generators/controller/form.php            |  6 +++---
 src/generators/crud/default/controller.php    |  4 ++--
 src/generators/crud/default/search.php        |  4 ++--
 src/generators/crud/default/views/_form.php   | 10 +++++-----
 src/generators/crud/default/views/_search.php | 10 +++++-----
 src/generators/crud/default/views/create.php  |  8 ++++----
 src/generators/crud/default/views/index.php   | 10 +++++-----
 src/generators/crud/default/views/update.php  |  8 ++++----
 src/generators/crud/default/views/view.php    |  8 ++++----
 src/generators/crud/form.php                  |  6 +++---
 src/generators/extension/form.php             |  6 +++---
 src/generators/form/default/action.php        |  4 ++--
 src/generators/form/default/form.php          | 10 +++++-----
 src/generators/form/form.php                  |  6 +++---
 src/generators/model/default/model.php        | 20 +++++++++----------
 src/generators/model/default/query.php        | 20 +++++++++----------
 src/generators/model/form.php                 |  8 ++++----
 src/generators/module/default/controller.php  |  4 ++--
 src/generators/module/default/module.php      |  4 ++--
 src/generators/module/default/view.php        |  4 ++--
 src/generators/module/form.php                |  6 +++---
 src/views/default/diff.php                    |  4 ++--
 src/views/default/index.php                   |  6 +++---
 src/views/default/view.php                    | 16 +++++++--------
 src/views/default/view/files.php              | 10 +++++-----
 src/views/default/view/results.php            |  8 ++++----
 src/views/layouts/generator.php               |  8 ++++----
 src/views/layouts/main.php                    |  4 ++--
 30 files changed, 117 insertions(+), 117 deletions(-)

diff --git a/src/generators/controller/default/controller.php b/src/generators/controller/default/controller.php
index bc3888027..f6d180f1e 100644
--- a/src/generators/controller/default/controller.php
+++ b/src/generators/controller/default/controller.php
@@ -6,8 +6,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\controller\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\controller\Generator $generator */
 
 echo "<?php\n";
 ?>
diff --git a/src/generators/controller/default/view.php b/src/generators/controller/default/view.php
index c46b542af..bad7e26ae 100644
--- a/src/generators/controller/default/view.php
+++ b/src/generators/controller/default/view.php
@@ -3,13 +3,13 @@
  * This is the template for generating an action view file.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\controller\Generator */
-/* @var $action string the action ID */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\controller\Generator $generator */
+/** @var string $action the action ID */
 
 echo "<?php\n";
 ?>
-/* @var $this yii\web\View */
+/** @var yii\web\View $this */
 <?= "?>" ?>
 
 <h1><?= $generator->getControllerSubPath() . $generator->getControllerID() . '/' . $action ?></h1>
diff --git a/src/generators/controller/form.php b/src/generators/controller/form.php
index 9a6e8cd2f..c2df86448 100644
--- a/src/generators/controller/form.php
+++ b/src/generators/controller/form.php
@@ -1,7 +1,7 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\controller\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\controller\Generator $generator */
 
 echo $form->field($generator, 'controllerClass');
 echo $form->field($generator, 'actions');
diff --git a/src/generators/crud/default/controller.php b/src/generators/crud/default/controller.php
index 289541efe..b4f0aab9b 100644
--- a/src/generators/crud/default/controller.php
+++ b/src/generators/crud/default/controller.php
@@ -7,8 +7,8 @@
 use yii\helpers\StringHelper;
 
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 $controllerClass = StringHelper::basename($generator->controllerClass);
 $modelClass = StringHelper::basename($generator->modelClass);
diff --git a/src/generators/crud/default/search.php b/src/generators/crud/default/search.php
index 0ca91d454..81654b3b0 100644
--- a/src/generators/crud/default/search.php
+++ b/src/generators/crud/default/search.php
@@ -6,8 +6,8 @@
 use yii\helpers\StringHelper;
 
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 $modelClass = StringHelper::basename($generator->modelClass);
 $searchModelClass = StringHelper::basename($generator->searchModelClass);
diff --git a/src/generators/crud/default/views/_form.php b/src/generators/crud/default/views/_form.php
index 0720887f6..213442d0e 100644
--- a/src/generators/crud/default/views/_form.php
+++ b/src/generators/crud/default/views/_form.php
@@ -3,8 +3,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 /* @var $model \yii\db\ActiveRecord */
 $model = new $generator->modelClass();
@@ -19,9 +19,9 @@
 use yii\helpers\Html;
 use yii\widgets\ActiveForm;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->modelClass, '\\') ?> */
-/* @var $form yii\widgets\ActiveForm */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->modelClass, '\\') ?> $model */
+/** @var yii\widgets\ActiveForm $form */
 ?>
 
 <div class="<?= Inflector::camel2id(StringHelper::basename($generator->modelClass)) ?>-form">
diff --git a/src/generators/crud/default/views/_search.php b/src/generators/crud/default/views/_search.php
index b65231fc5..9d9251fe4 100644
--- a/src/generators/crud/default/views/_search.php
+++ b/src/generators/crud/default/views/_search.php
@@ -3,8 +3,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 echo "<?php\n";
 ?>
@@ -12,9 +12,9 @@
 use yii\helpers\Html;
 use yii\widgets\ActiveForm;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->searchModelClass, '\\') ?> */
-/* @var $form yii\widgets\ActiveForm */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->searchModelClass, '\\') ?> $model */
+/** @var yii\widgets\ActiveForm $form */
 ?>
 
 <div class="<?= Inflector::camel2id(StringHelper::basename($generator->modelClass)) ?>-search">
diff --git a/src/generators/crud/default/views/create.php b/src/generators/crud/default/views/create.php
index 819bb3abe..cf0c040f2 100644
--- a/src/generators/crud/default/views/create.php
+++ b/src/generators/crud/default/views/create.php
@@ -3,16 +3,16 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 echo "<?php\n";
 ?>
 
 use yii\helpers\Html;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->modelClass, '\\') ?> */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->modelClass, '\\') ?> $model */
 
 $this->title = <?= $generator->generateString('Create ' . Inflector::camel2words(StringHelper::basename($generator->modelClass))) ?>;
 $this->params['breadcrumbs'][] = ['label' => <?= $generator->generateString(Inflector::pluralize(Inflector::camel2words(StringHelper::basename($generator->modelClass)))) ?>, 'url' => ['index']];
diff --git a/src/generators/crud/default/views/index.php b/src/generators/crud/default/views/index.php
index 627b977e7..87895381e 100644
--- a/src/generators/crud/default/views/index.php
+++ b/src/generators/crud/default/views/index.php
@@ -3,8 +3,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 $modelClass = StringHelper::basename($generator->modelClass);
 
@@ -17,9 +17,9 @@
 use <?= $generator->indexWidgetType === 'grid' ? "yii\\grid\\GridView" : "yii\\widgets\\ListView" ?>;
 <?= $generator->enablePjax ? 'use yii\widgets\Pjax;' : '' ?>
 
-/* @var $this yii\web\View */
-<?= !empty($generator->searchModelClass) ? "/* @var \$searchModel " . ltrim($generator->searchModelClass, '\\') . " */\n" : '' ?>
-/* @var $dataProvider yii\data\ActiveDataProvider */
+/** @var yii\web\View $this */
+<?= !empty($generator->searchModelClass) ? "/** @var " . ltrim($generator->searchModelClass, '\\') . " \$searchModel */\n" : '' ?>
+/** @var yii\data\ActiveDataProvider $dataProvider */
 
 $this->title = <?= $generator->generateString(Inflector::pluralize(Inflector::camel2words(StringHelper::basename($generator->modelClass)))) ?>;
 $this->params['breadcrumbs'][] = $this->title;
diff --git a/src/generators/crud/default/views/update.php b/src/generators/crud/default/views/update.php
index 31af00007..20873e38a 100644
--- a/src/generators/crud/default/views/update.php
+++ b/src/generators/crud/default/views/update.php
@@ -3,8 +3,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 $urlParams = $generator->generateUrlParams();
 $modelClassName = Inflector::camel2words(StringHelper::basename($generator->modelClass));
@@ -21,8 +21,8 @@
 
 use yii\helpers\Html;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->modelClass, '\\') ?> */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->modelClass, '\\') ?> $model */
 
 $this->title = <?= $title ?>;
 $this->params['breadcrumbs'][] = ['label' => <?= $generator->generateString(Inflector::pluralize(Inflector::camel2words(StringHelper::basename($generator->modelClass)))) ?>, 'url' => ['index']];
diff --git a/src/generators/crud/default/views/view.php b/src/generators/crud/default/views/view.php
index ec6d8d207..427b2b851 100644
--- a/src/generators/crud/default/views/view.php
+++ b/src/generators/crud/default/views/view.php
@@ -3,8 +3,8 @@
 use yii\helpers\Inflector;
 use yii\helpers\StringHelper;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 $urlParams = $generator->generateUrlParams();
 
@@ -14,8 +14,8 @@
 use yii\helpers\Html;
 use yii\widgets\DetailView;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->modelClass, '\\') ?> */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->modelClass, '\\') ?> $model */
 
 $this->title = $model-><?= $generator->getNameAttribute() ?>;
 $this->params['breadcrumbs'][] = ['label' => <?= $generator->generateString(Inflector::pluralize(Inflector::camel2words(StringHelper::basename($generator->modelClass)))) ?>, 'url' => ['index']];
diff --git a/src/generators/crud/form.php b/src/generators/crud/form.php
index 4f59b8b62..cc1ed582c 100644
--- a/src/generators/crud/form.php
+++ b/src/generators/crud/form.php
@@ -1,7 +1,7 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\crud\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\crud\Generator $generator */
 
 echo $form->field($generator, 'modelClass');
 echo $form->field($generator, 'searchModelClass');
diff --git a/src/generators/extension/form.php b/src/generators/extension/form.php
index 60bb19007..4032dc31a 100644
--- a/src/generators/extension/form.php
+++ b/src/generators/extension/form.php
@@ -1,7 +1,7 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\extension\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\extension\Generator $generator */
 
 ?>
 <div class="alert alert-info">
diff --git a/src/generators/form/default/action.php b/src/generators/form/default/action.php
index 69730e677..10169ccaf 100644
--- a/src/generators/form/default/action.php
+++ b/src/generators/form/default/action.php
@@ -5,8 +5,8 @@
 
 use yii\helpers\Inflector;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\form\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\form\Generator $generator */
 
 echo "<?php\n";
 ?>
diff --git a/src/generators/form/default/form.php b/src/generators/form/default/form.php
index 09be133e2..c2dd2a5b0 100644
--- a/src/generators/form/default/form.php
+++ b/src/generators/form/default/form.php
@@ -3,8 +3,8 @@
  * This is the template for generating an action view file.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\form\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\form\Generator $generator */
 
 $class = str_replace('/', '-', trim($generator->viewName, '_'));
 
@@ -14,9 +14,9 @@
 use yii\helpers\Html;
 use yii\widgets\ActiveForm;
 
-/* @var $this yii\web\View */
-/* @var $model <?= ltrim($generator->modelClass, '\\') ?> */
-/* @var $form ActiveForm */
+/** @var yii\web\View $this */
+/** @var <?= ltrim($generator->modelClass, '\\') ?> $model */
+/** @var ActiveForm $form */
 <?= "?>" ?>
 
 <div class="<?= $class ?>">
diff --git a/src/generators/form/form.php b/src/generators/form/form.php
index 0e2298737..f4d776f84 100644
--- a/src/generators/form/form.php
+++ b/src/generators/form/form.php
@@ -1,7 +1,7 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\form\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\form\Generator $generator */
 
 echo $form->field($generator, 'viewName');
 echo $form->field($generator, 'modelClass');
diff --git a/src/generators/model/default/model.php b/src/generators/model/default/model.php
index ed101a884..f35676362 100644
--- a/src/generators/model/default/model.php
+++ b/src/generators/model/default/model.php
@@ -3,16 +3,16 @@
  * This is the template for generating the model class of a specified table.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\model\Generator */
-/* @var $tableName string full table name */
-/* @var $className string class name */
-/* @var $queryClassName string query class name */
-/* @var $tableSchema yii\db\TableSchema */
-/* @var $properties array list of properties (property => [type, name. comment]) */
-/* @var $labels string[] list of attribute labels (name => label) */
-/* @var $rules string[] list of validation rules */
-/* @var $relations array list of relations (name => relation declaration) */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\model\Generator $generator */
+/** @var string $tableName full table name */
+/** @var string $className class name */
+/** @var string $queryClassName query class name */
+/** @var yii\db\TableSchema $tableSchema */
+/** @var array $properties list of properties (property => [type, name. comment]) */
+/** @var string[] $labels list of attribute labels (name => label) */
+/** @var string[] $rules list of validation rules */
+/** @var array $relations list of relations (name => relation declaration) */
 
 echo "<?php\n";
 ?>
diff --git a/src/generators/model/default/query.php b/src/generators/model/default/query.php
index c362dfe9e..4689f8e0a 100644
--- a/src/generators/model/default/query.php
+++ b/src/generators/model/default/query.php
@@ -3,16 +3,16 @@
  * This is the template for generating the ActiveQuery class.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\model\Generator */
-/* @var $tableName string full table name */
-/* @var $className string class name */
-/* @var $tableSchema yii\db\TableSchema */
-/* @var $labels string[] list of attribute labels (name => label) */
-/* @var $rules string[] list of validation rules */
-/* @var $relations array list of relations (name => relation declaration) */
-/* @var $className string class name */
-/* @var $modelClassName string related model class name */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\model\Generator $generator */
+/** @var string $tableName full table name */
+/** @var string $className class name */
+/** @var yii\db\TableSchema $tableSchema */
+/** @var string[] $labels list of attribute labels (name => label) */
+/** @var string[] $rules list of validation rules */
+/** @var array $relations list of relations (name => relation declaration) */
+/** @var string $className class name */
+/** @var string $modelClassName related model class name */
 
 $modelFullClassName = $modelClassName;
 if ($generator->ns !== $generator->queryNs) {
diff --git a/src/generators/model/form.php b/src/generators/model/form.php
index 050c29593..91df57385 100644
--- a/src/generators/model/form.php
+++ b/src/generators/model/form.php
@@ -3,9 +3,9 @@
 use yii\gii\generators\model\Generator;
 use yii\helpers\Url;
 
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\model\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\model\Generator $generator */
 
 echo $form->field($generator, 'db');
 echo $form->field($generator, 'useTablePrefix')->checkbox();
@@ -13,7 +13,7 @@
 echo $form->field($generator, 'tableName')->textInput([
     'autocomplete' => 'off',
     'data' => [
-        'table-prefix' => $generator->getTablePrefix(), 
+        'table-prefix' => $generator->getTablePrefix(),
         'action' => Url::to(['default/action', 'id' => 'model', 'name' => 'GenerateClassName'])
     ]
 ]);
diff --git a/src/generators/module/default/controller.php b/src/generators/module/default/controller.php
index 719e4419e..20dffbb53 100644
--- a/src/generators/module/default/controller.php
+++ b/src/generators/module/default/controller.php
@@ -3,8 +3,8 @@
  * This is the template for generating a controller class within a module.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\module\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\module\Generator $generator */
 
 echo "<?php\n";
 ?>
diff --git a/src/generators/module/default/module.php b/src/generators/module/default/module.php
index dc6cc898f..6c9ce0884 100644
--- a/src/generators/module/default/module.php
+++ b/src/generators/module/default/module.php
@@ -3,8 +3,8 @@
  * This is the template for generating a module class file.
  */
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\module\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\module\Generator $generator */
 
 $className = $generator->moduleClass;
 $pos = strrpos($className, '\\');
diff --git a/src/generators/module/default/view.php b/src/generators/module/default/view.php
index bacfd8e02..33d9768e6 100644
--- a/src/generators/module/default/view.php
+++ b/src/generators/module/default/view.php
@@ -1,6 +1,6 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\generators\module\Generator */
+/** @var yii\web\View $this */
+/** @var yii\gii\generators\module\Generator $generator */
 ?>
 <div class="<?= $generator->moduleID . '-default-index' ?>">
     <h1><?= "<?= " ?>$this->context->action->uniqueId ?></h1>
diff --git a/src/generators/module/form.php b/src/generators/module/form.php
index 5d1e55e50..bdada957f 100644
--- a/src/generators/module/form.php
+++ b/src/generators/module/form.php
@@ -1,7 +1,7 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $generator yii\gii\generators\module\Generator */
+/** @var yii\web\View $this */
+/** @var yii\widgets\ActiveForm $form */
+/** @var yii\gii\generators\module\Generator $generator */
 
 ?>
 <div class="module-form">
diff --git a/src/views/default/diff.php b/src/views/default/diff.php
index 19a09293f..2b7ba1f69 100644
--- a/src/views/default/diff.php
+++ b/src/views/default/diff.php
@@ -1,6 +1,6 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $diff mixed */
+/** @var yii\web\View $this */
+/** @var mixed $diff */
 ?>
 <div class="default-diff">
     <?php if ($diff === false): ?>
diff --git a/src/views/default/index.php b/src/views/default/index.php
index dcccfa704..4d91ef0bb 100644
--- a/src/views/default/index.php
+++ b/src/views/default/index.php
@@ -1,9 +1,9 @@
 <?php
 use yii\helpers\Html;
 
-/* @var $this \yii\web\View */
-/* @var $generators \yii\gii\Generator[] */
-/* @var $content string */
+/** @var \yii\web\View $this */
+/** @var \yii\gii\Generator[] $generators */
+/** @var string $content */
 
 $generators = Yii::$app->controller->module->generators;
 $this->title = 'Welcome to Gii';
diff --git a/src/views/default/view.php b/src/views/default/view.php
index e0d78ff7a..a52276e94 100644
--- a/src/views/default/view.php
+++ b/src/views/default/view.php
@@ -5,14 +5,14 @@
 use yii\gii\components\ActiveField;
 use yii\gii\CodeFile;
 
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\Generator */
-/* @var $id string panel ID */
-/* @var $form yii\widgets\ActiveForm */
-/* @var $results string */
-/* @var $hasError bool */
-/* @var $files CodeFile[] */
-/* @var $answers array */
+/** @var yii\web\View $this */
+/** @var yii\gii\Generator $generator */
+/** @var string $id panel ID */
+/** @var yii\widgets\ActiveForm $form */
+/** @var string $results */
+/** @var bool $hasError */
+/** @var CodeFile[] $files */
+/** @var array $answers */
 
 $this->title = $generator->getName();
 $templates = [];
diff --git a/src/views/default/view/files.php b/src/views/default/view/files.php
index e780f5226..0b1322ed4 100644
--- a/src/views/default/view/files.php
+++ b/src/views/default/view/files.php
@@ -3,11 +3,11 @@
 use yii\gii\CodeFile;
 use yii\helpers\Html;
 
-/* @var $this \yii\web\View */
-/* @var $generator \yii\gii\Generator */
-/* @var $files CodeFile[] */
-/* @var $answers array */
-/* @var $id string panel ID */
+/** @var \yii\web\View $this */
+/** @var \yii\gii\Generator $generator */
+/** @var CodeFile[] $files */
+/** @var array $answers */
+/** @var string $id panel ID */
 
 ?>
 <div class="default-view-files">
diff --git a/src/views/default/view/results.php b/src/views/default/view/results.php
index 1893beb3e..8a06cf831 100644
--- a/src/views/default/view/results.php
+++ b/src/views/default/view/results.php
@@ -1,8 +1,8 @@
 <?php
-/* @var $this yii\web\View */
-/* @var $generator yii\gii\Generator */
-/* @var $results string */
-/* @var $hasError bool */
+/** @var yii\web\View $this */
+/** @var yii\gii\Generator $generator */
+/** @var string $results */
+/** @var bool $hasError */
 ?>
 <div class="default-view-results">
     <?php
diff --git a/src/views/layouts/generator.php b/src/views/layouts/generator.php
index 95f54fe2b..909e36dd4 100644
--- a/src/views/layouts/generator.php
+++ b/src/views/layouts/generator.php
@@ -1,10 +1,10 @@
 <?php
 use yii\helpers\Html;
 
-/* @var $this \yii\web\View */
-/* @var $generators \yii\gii\Generator[] */
-/* @var $activeGenerator \yii\gii\Generator */
-/* @var $content string */
+/** @var \yii\web\View $this */
+/** @var \yii\gii\Generator[] $generators */
+/** @var \yii\gii\Generator $activeGenerator */
+/** @var string $content */
 
 $generators = Yii::$app->controller->module->generators;
 $activeGenerator = Yii::$app->controller->generator;
diff --git a/src/views/layouts/main.php b/src/views/layouts/main.php
index ddcb964d1..6d90468ea 100644
--- a/src/views/layouts/main.php
+++ b/src/views/layouts/main.php
@@ -3,8 +3,8 @@
 use yii\widgets\Menu;
 use yii\helpers\Html;
 
-/* @var $this \yii\web\View */
-/* @var $content string */
+/** @var \yii\web\View $this */
+/** @var string $content */
 
 $asset = yii\gii\GiiAsset::register($this);
 ?>