diff --git a/lib/SimpleSAML/Locale/Language.php b/lib/SimpleSAML/Locale/Language.php
index 054557bd2974db6191c6077f2e0d149f0df42385..5972a74bc6948b50f6164d04d7147f421a4c0896 100644
--- a/lib/SimpleSAML/Locale/Language.php
+++ b/lib/SimpleSAML/Locale/Language.php
@@ -153,9 +153,9 @@ class Language
 
 
     /**
-     * Wash configured (available) languages against installed languages
+     * Filter configured (available) languages against installed languages.
      *
-     * @return array The set of langauges both in 'language.available' and $this->language_names
+     * @return array The set of languages both in 'language.available' and $this->language_names.
      */
     private function getInstalledLanguages()
     {
@@ -172,10 +172,12 @@ class Language
     }
 
 
-    /*
-     * Rename to non-idiosyncratic language code
+    /**
+     * Rename to non-idiosyncratic language code.
+     *
+     * @param string $language Language code for the language to rename, if necessary.
      *
-     * @param string $language Language code for the language to rename, if neccesary.
+     * @return string The language code.
      */
     public function getPosixLanguage($language)
     {
@@ -327,9 +329,9 @@ class Language
 
 
     /**
-     * Return an alias for a langcode, if any
+     * Return an alias for a language code, if any.
      *
-     * @return string The alias, or null if alias not found
+     * @return string The alias, or null if the alias was not found.
      */
     public function getLanguageCodeAlias($langcode)
     {