Improve Events code quality.

app/Events/AdminRequestedTestMessage.php

@@ -35,13 +35,9 @@ class AdminRequestedTestMessage extends Event
 {
     use SerializesModels;
 
-    /**
+    /** @var string The users IP address */
-     * @var string
-     */
     public $ipAddress;
-    /**
+    /** @var User The user */
-     * @var User
-     */
     public $user;
 
     /**

app/Events/RegisteredUser.php

@@ -34,13 +34,9 @@ class RegisteredUser extends Event
 {
     use SerializesModels;
 
-    /**
+    /** @var string The users IP address */
-     * @var string
-     */
     public $ipAddress;
-    /**
+    /** @var User The user */
-     * @var User
-     */
     public $user;
 
     /**

app/Events/RequestedNewPassword.php

@@ -34,18 +34,12 @@ class RequestedNewPassword extends Event
 {
     use SerializesModels;
 
-    /**
+    /** @var string The users IP address */
-     * @var string
-     */
     public $ipAddress;
-    /**
+    /** @var User The user */
-     * @var string
-     */
-    public $token;
-    /**
-     * @var User
-     */
     public $user;
+    /** @var string The token */
+    public $token;
 
     /**
      * Create a new event instance. This event is triggered when a users tries to reset his or her password.

app/Events/RequestedReportOnJournals.php

@@ -1,4 +1,23 @@
 <?php
+/**
+ * RequestedReportOnJournals.php
+ * Copyright (c) 2018 thegrumpydictator@gmail.com
+ *
+ * This file is part of Firefly III.
+ *
+ * Firefly III is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Firefly III is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Firefly III. If not, see <http://www.gnu.org/licenses/>.
+ */
 
 namespace FireflyIII\Events;
 
@@ -16,9 +35,9 @@ class RequestedReportOnJournals
 {
     use Dispatchable, InteractsWithSockets, SerializesModels;
 
-    /** @var Collection */
+    /** @var Collection The journals to report on. */
     public $journals;
-    /** @var int */
+    /** @var int The ID of the user. */
     public $userId;
 
     /**

app/Events/RequestedVersionCheckStatus.php

@@ -35,9 +35,7 @@ class RequestedVersionCheckStatus extends Event
 {
     use SerializesModels;
 
-    /**
+    /** @var User The user */
-     * @var User
-     */
     public $user;
 
     /**

app/Events/StoredTransactionJournal.php

@@ -28,16 +28,17 @@ use FireflyIII\Models\TransactionJournal;
 use Illuminate\Queue\SerializesModels;
 
 /**
- * @codeCoverageIgnore
  * Class StoredTransactionJournal.
+ *
+ * @codeCoverageIgnore
  */
 class StoredTransactionJournal extends Event
 {
     use SerializesModels;
 
-    /** @var TransactionJournal */
+    /** @var TransactionJournal The journal that was stored. */
     public $journal;
-    /** @var int */
+    /** @var int The piggy bank ID. */
     public $piggyBankId;
 
     /**

app/Events/UpdatedTransactionJournal.php

@@ -37,7 +37,7 @@ class UpdatedTransactionJournal extends Event
 {
     use SerializesModels;
 
-    /** @var TransactionJournal */
+    /** @var TransactionJournal The journal. */
     public $journal;
 
     /**

app/Events/UserChangedEmail.php

@@ -34,13 +34,13 @@ class UserChangedEmail extends Event
 {
     use SerializesModels;
 
-    /** @var string */
+    /** @var string The user's IP address */
     public $ipAddress;
-    /** @var string */
+    /** @var string The user's new email address */
     public $newEmail;
-    /** @var string */
+    /** @var string The user's old email address */
     public $oldEmail;
-    /** @var User */
+    /** @var User The user itself */
     public $user;
 
     /**