-// http://doc.spip.org/@puce_statut_article_dist
-function puce_statut_changement_rapide($id, $statut, $id_rubrique, $type='article', $ajax = false, $menu_rapide=_ACTIVER_PUCE_RAPIDE) {
+/**
+ * Retourne le contenu d'une puce avec changement de statut possible
+ * si on en a l'autorisation, sinon simplement l'image de la puce
+ *
+ * @param int $id
+ * Identifiant de l'objet
+ * @param string $statut
+ * Statut actuel de l'objet
+ * @param int $id_rubrique
+ * Identifiant du parent, une rubrique
+ * @param string $type
+ * Type d'objet
+ * @param bool $ajax
+ * Indique s'il ne faut renvoyer que le coeur du menu car on est
+ * dans une requete ajax suite à un post de changement rapide
+ * @param bool $menu_rapide
+ * Indique si l'on peut changer le statut, ou si on l'affiche simplement
+ * @return string
+ * Code HTML de l'image de puce de statut à insérer (et du menu de changement si présent)
+ **/
+function puce_statut_changement_rapide(
+ $id,
+ $statut,
+ $id_rubrique,
+ $type = 'article',
+ $ajax = false,
+ $menu_rapide = _ACTIVER_PUCE_RAPIDE
+) {