docs: phpdoc {lang_select}

Explication un peu plus détaillée et exemple pour lever toute ambiguïté sur ce que fait le critère.

public/criteres.php

@@ -163,13 +163,31 @@ function critere_doublons_dist($idb, &$boucles, $crit) {
 /**
  * Compile le critère {lang_select}
  *
- * Permet de restreindre ou non une boucle en affichant uniquement
- * les éléments dans la langue en cours. Certaines boucles
- * tel que articles et rubriques restreignent par défaut sur la langue
- * en cours.
+ * Ce critère indique d'utiliser la langue de l'objet de la boucle
+ * comme langue du contexte intérieur de la boucle.
  *
- * Sans définir de valeur au critère, celui-ci utilise 'oui' comme
- * valeur par défaut.
+ * Cela revient à faire `[(#LANG|lang_select)]` en tout début de boucle.
+ *
+ * En conséquence, <multi>, <:idiome_langue:> et `_T` utiliseront la langue de l'objet
+ * au lieu de la langue du contexte global.
+ *
+ * Certaines boucles telles que articles et rubriques ont ce comportement par défaut.
+ *
+ * Le critère accepte un paramètre optionnel :
+ * - '' ou 'oui' pour activer ce comportement.
+ * - 'non' pour désactiver ce comportement.
+ *
+ * @example
+ * ```
+ * Ici #LANG est celle du contexte global, par exemple le français.
+ * <BOUCLE(ARTICLES) {lang_select} {lang=en} {0,1}>
+ * Ici les balises <multi> et cie sont en anglais, idem article.
+ * </BOUCLE>
+ * <BOUCLE(ARTICLES) {lang_select=non} {lang=en} {0,1}>
+ * Ici les balises <multi> et cie sont en français, idem contexte global.
+ * </BOUCLE>
+ * Ici #LANG est le français.
+ * ```
  *
  * @param string $idb Identifiant de la boucle
  * @param array $boucles AST du squelette