Upgrade to 3.1.0

kirby/src/Cms/Language.php

@@ -11,8 +11,19 @@ use Kirby\Toolkit\F;
 use Kirby\Toolkit\Str;
 
 /**
- * Represents a content language
- * in a multi-language setup
+ * The `$language` object represents
+ * a single language in a multi-language
+ * Kirby setup. You can, for example,
+ * use the methods of this class to get
+ * the name or locale of a language,
+ * check for the default language,
+ * get translation strings and many
+ * more things.
+ *
+ * @package   Kirby Cms
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      http://getkirby.com
+ * @copyright Bastian Allgeier
  */
 class Language extends Model
 {
@@ -145,6 +156,7 @@ class Language extends Model
     /**
      * Creates a new language object
      *
+     * @internal
      * @param array $props
      * @return self
      */
@@ -179,6 +191,7 @@ class Language extends Model
      * Delete the current language and
      * all its translation files
      *
+     * @internal
      * @return boolean
      */
     public function delete(): bool
@@ -321,6 +334,7 @@ class Language extends Model
     /**
      * Saves the language settings in the languages folder
      *
+     * @internal
      * @return self
      */
     public function save(): self
@@ -447,6 +461,7 @@ class Language extends Model
     /**
      * Update language properties and save them
      *
+     * @internal
      * @param array $props
      * @return self
      */