-//
-// Selecteur de rubriques pour l'espace prive
-// En entree :
-// - l'id_rubrique courante (0 si NEW)
-// - le type d'objet a placer (une rubrique peut aller a la racine
-// mais pas dans elle-meme, les articles et sites peuvent aller
-// n'importe ou (defaut), et les breves dans les secteurs.
-// $idem : en mode rubrique = la rubrique soi-meme
-// http://doc.spip.org/@inc_chercher_rubrique_dist
-function inc_chercher_rubrique_dist ($id_rubrique, $type, $restreint, $idem=0, $do='aff') {
- if (sql_countsel('spip_rubriques')<1)
+
+/**
+ * Sélecteur de rubriques pour l'espace privé
+ *
+ * @uses selecteur_rubrique_html()
+ * @uses selecteur_rubrique_ajax()
+ *
+ * @param int $id_rubrique
+ * Identifiant de rubrique courante (0 si NEW)
+ * @param string $type
+ * Type de l'objet à placer.
+ *
+ * Une rubrique peut aller à la racine mais pas dans elle-même,
+ * les articles et sites peuvent aller n'importe où (défaut),
+ * et les brèves dans les secteurs.
+ * @param bool $restreint
+ * True pour indiquer qu'il faut limiter les rubriques affichées
+ * aux rubriques éditables par l'admin restreint
+ * @param int $idem
+ * En mode rubrique, identifiant de soi-même
+ * @param string $do
+ * Type d'action
+ * @return string
+ * Code HTML du sélecteur
+ **/
+function inc_chercher_rubrique_dist($id_rubrique, $type, $restreint, $idem = 0, $do = 'aff') {
+ if (sql_countsel('spip_rubriques') < 1) {