Improve docs of language_* functions in bootstrap.inc

Added documentation to language_is_locked() and checked other language functions documentation.

Im gonna review the patch.

Tested if Patch does only modify commented parts.
Patch reviewed. Patch works and may be applied. Improving Docs may also be continued.

+ * @return bool
+ *   1 if more than one language.

If it returns bool, shouldn't it return TRUE if more than one language instead of 1?

Changed per @catch's suggestion. Also added missing space before @return.

+++ b/core/includes/bootstrap.incundefined
@@ -2696,6 +2700,9 @@ function language_types_get_default() {
+ * @return bool
+ *   TRUE if more than one language.

Should this be a sentence instead? ie. "is enabled" is missing at the end.

+++ b/core/includes/bootstrap.incundefined
@@ -2798,10 +2805,10 @@ function language_default_locked_languages($weight = 0) {
- * @return
+ * @return Drupal\core\Language\Language | false

Are we using lowercase FALSE when documenting return types? We use it uppercase in all other cases?!

Fixed those issues, and found a comment that was > 80 chars.

Looks good to me, let's place it with the docs component, so Jennifer will see it directly. Thanks all!

Committed to 8.x. I'm undecided on backporting to 7.x... for the most part we don't have return/param types in 7.x at all, and some of the types here would not be right for 7.x anyway... but some of this patch could be useful maybe?

Yeah, a couple of hunks are still applicable.

Thanks -- that patch is committed to 7.x.