diff --git a/core/lib/Drupal/Core/StringTranslation/TranslationManager.php b/core/lib/Drupal/Core/StringTranslation/TranslationManager.php index 9d3966b..595301d 100644 --- a/core/lib/Drupal/Core/StringTranslation/TranslationManager.php +++ b/core/lib/Drupal/Core/StringTranslation/TranslationManager.php @@ -16,20 +16,25 @@ class TranslationManager implements TranslationInterface, TranslatorInterface { /** - * An array of active translators keyed by priority. + * Holds the array of translators - unsorted. * - * @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. * - * If this is NULL a rebuild will be triggered. + * An associative array of TranslatorInterface objects. It is unkeyed. 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 +67,7 @@ public function __construct(LanguageDefault $default_language) { * @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 +79,8 @@ public function addTranslator(TranslatorInterface $translator, $priority = 0) { /** * 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();