-// Recupere les donnees d'un article pour composer un formulaire d'edition
-// id_article = numero d'article existant
-// id_rubrique = ou veut-on l'installer (pas obligatoire)
-// lier_trad = l'associer a l'article numero $lier_trad
-// new=oui = article a creer si on valide le formulaire
-// http://doc.spip.org/@inc_article_select_dist
-function inc_precharger_article_dist($id_article, $id_rubrique=0, $lier_trad=0) {
+/**
+ * Retourne les valeurs à charger pour un formulaire d'édition d'un article
+ *
+ * Lors d'une création, certains champs peuvent être préremplis
+ * (c'est le cas des traductions)
+ *
+ * @param string|int $id_article
+ * Identifiant de l'article, ou "new" pour une création
+ * @param int $id_rubrique
+ * Identifiant éventuel de la rubrique parente
+ * @param int $lier_trad
+ * Identifiant éventuel de la traduction de référence
+ * @return array
+ * Couples clés / valeurs des champs du formulaire à charger.
+ **/
+function inc_precharger_article_dist($id_article, $id_rubrique = 0, $lier_trad = 0) {