diff --git a/core/SettingsPiwik.php b/core/SettingsPiwik.php
index a7412d9a3c4b54b0e9c2e07fce43dff1c194a2da..5dd9d6192064d2ca6a21037f2dd91f511f3e6891 100644
--- a/core/SettingsPiwik.php
+++ b/core/SettingsPiwik.php
@@ -64,7 +64,8 @@ class SettingsPiwik
 
             /**
              * This event is triggered when the automatic archiving runs.
-             * You can use it to add segments to the list of segments to pre-process during archiving.
+             * You can use it to add Segments to the list of segments to pre-process during archiving.
+             * Segments specified in this array will be pre-processed for all websites.
              */
             Piwik::postEvent('Segments.getKnownSegmentsToArchiveAllSites', array(&$segmentsToProcess));
 
@@ -80,7 +81,9 @@ class SettingsPiwik
         $segments = array();
 
         /**
-         * @matt
+         * This event is triggered when the automatic archiving runs.
+         * You can use it to add Segments to the list of segments to pre-process during archiving,
+         * for this particular website ID $idSite.
          */
         Piwik::postEvent('Segments.getKnownSegmentsToArchiveForSite', array(&$segments, $idSite));
         return $segments;
diff --git a/plugins/UsersManager/Controller.php b/plugins/UsersManager/Controller.php
index 35954c73cffb408fcfd50adb882f85d53e821cc0..49d2f0bcba8599d90d75c371a12da19e518301b1 100644
--- a/plugins/UsersManager/Controller.php
+++ b/plugins/UsersManager/Controller.php
@@ -336,7 +336,7 @@ class Controller extends Admin
                  *     $rememberMe = $info['rememberMe'];
                  * }
                  * ```
-                 * @matt this event is also triggered twice.
+                 * @todo this event is also triggered twice.
                  */
                 Piwik::postEvent('Login.initSession', array($info));
             }