-// http://doc.spip.org/@inc_couleurs_dist
-function inc_couleurs_dist($choix=NULL, $ajouter=false)
-{
+/**
+ * Obtenir ou définir les différents jeux de couleurs de l'espace privé
+ *
+ * - Appelée _sans argument_, cette fonction retourne un tableau décrivant les jeux les couleurs possibles.
+ * - Avec un _argument numérique_, elle retourne les paramètres d'URL
+ * pour les feuilles de style calculées (cf. formulaire configurer_preferences)
+ * - Avec un _argument de type tableau_ :
+ * - soit elle remplace le tableau par défaut par celui donné en argument
+ * - soit elle le complète, si `$ajouter` vaut `true`.
+ *
+ * @see formulaires_configurer_preferences_charger_dist()
+ *
+ * @staticvar array $couleurs_spip
+ * @param null|int|array $choix
+ * @param bool $ajouter
+ * @return array|string
+ */
+function inc_couleurs_dist($choix = null, $ajouter = false) {