New documentation, $langDefs is less used (#163) and warnings after l…

…anguage rename (#113).

JS Doc is added with JS DOC and PHP Doc with phpDocumentor.
New global LWT_LANGUAGES_ARRAY.
When renaming a language, text to speech was broken, it is fixed.

.dockerignore

@@ -1,12 +1,23 @@
 # Folder that shoud not be included in the image
+
 .github/*
 docker/*
+# Documentation
 docs/*
+# NPM, for debugging only
 node_modules/*
+# Phive products
+.phive/*
+tools/*
+
+# phpDocumentor cache
+.phpdoc/*
 
 *.md
 .dockerignore
 .git
 .gitignore
+# MarkDown and PHP documentation generation
 Doxyfile
+# Media files for LWT
 media/*

.gitignore

@@ -25,6 +25,7 @@ vendor/
 
 composer.phar
 
+# JS unit testing and documentation
 node_modules/
 
 # Editor
@@ -33,3 +34,11 @@ node_modules/
 _*
 # For Mac Users
 .DS_Store
+
+
+# Phive products
+.phive/*
+tools/*
+
+# phpDocumentor cache
+.phpdoc/*

all_words_wellknown.php

@@ -9,6 +9,9 @@
  *       all_words_wellknown.php?text=[textid]&status=[statusint] 
  *                              (mark with a specific status, normally 98 or 99)
  * 
+ * PHP version 8.1
+ * 
+ * @category Helper_Frame
  * @package Lwt
  * @author  LWT Project <[email protected]>
  * @license Unlicense <http://unlicense.org/>
@@ -47,12 +50,12 @@ function all_words_wellknown_get_words($txid)
  * @param string $termlc Same as $term, but in lowercase.
  * @param int    $langid Language ID
  *
- * @return (int|string)[] Number of rows edited and a javascript query.
+ * @return array [int, string] Number of rows edited and a javascript query.
  *
  * @since 2.5.3-fork Do not crash when echoing an error
  * @since 2.5.3-fork Do not crash when a word is already registred to the database
  *
- * @psalm-return array{0: int, 1: string}
+ * @psalm-return list{int, string}
  */
 function all_words_wellknown_process_word($status, $term, $termlc, $langid): array
 {
@@ -109,11 +112,11 @@ function all_words_wellknown_process_word($status, $term, $termlc, $langid): arr
  * @param int $txid   Text ID
  * @param int $status New status to apply to all words.
  *
- * @return (int|string)[] Number of edited words, and JavaScript query to change their display
+ * @return array [int, string] Number of edited words, and JavaScript query to change their display
  *
  * @since 2.5.3-fork Use 'let' instead of 'var' in returned JS
  *
- * @psalm-return array{0: int, 1: string}
+ * @psalm-return list{int, string}
  */
 function all_words_wellknown_main_loop($txid, $status): array
 {