diff --git a/core/lib/Drupal/Core/StringTranslation/TranslationManager.php b/core/lib/Drupal/Core/StringTranslation/TranslationManager.php index 872d57f631d0..e7c58d82cc51 100644 --- a/core/lib/Drupal/Core/StringTranslation/TranslationManager.php +++ b/core/lib/Drupal/Core/StringTranslation/TranslationManager.php @@ -16,20 +16,24 @@ use Drupal\Core\StringTranslation\Translator\TranslatorInterface; class TranslationManager implements TranslationInterface, TranslatorInterface { /** - * An array of active translators keyed by priority. + * An unsorted array of arrays of active translators. * - * @var array - * Array of \Drupal\Core\StringTranslation\Translator\TranslatorInterface objects + * An associative array. The keys are integers that indicate priority. Values + * are arrays of TranslatorInterface objects. + * + * @var \Drupal\Core\StringTranslation\Translator\TranslatorInterface[][] + * + * @see \Drupal\Core\StringTranslation\TranslationManager::addTranslator() + * @see \Drupal\Core\StringTranslation\TranslationManager::sortTranslators() */ protected $translators = array(); /** - * Holds the array of translators sorted by priority. + * An array of translators, sorted by priority. * * If this is NULL a rebuild will be triggered. * - * @var array - * An array of path processor objects. + * @var null|\Drupal\Core\StringTranslation\Translator\TranslatorInterface[] * * @see \Drupal\Core\StringTranslation\TranslationManager::addTranslator() * @see \Drupal\Core\StringTranslation\TranslationManager::sortTranslators() @@ -62,8 +66,7 @@ class TranslationManager implements TranslationInterface, TranslatorInterface { * @param int $priority * The priority of the logger being added. * - * @return \Drupal\Core\StringTranslation\TranslationManager - * The called object. + * @return $this */ public function addTranslator(TranslatorInterface $translator, $priority = 0) { $this->translators[$priority][] = $translator; @@ -75,8 +78,8 @@ class TranslationManager implements TranslationInterface, TranslatorInterface { /** * Sorts translators according to priority. * - * @return array - * A sorted array of translators objects. + * @return \Drupal\Core\StringTranslation\Translator\TranslatorInterface[] + * A sorted array of translator objects. */ protected function sortTranslators() { $sorted = array();