X-Git-Url: http://git.cyclocoop.org/?a=blobdiff_plain;f=www%2Fplugins%2Fsaisies%2Fbalise%2Fvoir_saisie.php;h=8ed9f94529db96f1eec0f0ec039191f4a45802b2;hb=d24ea3eed933e1a140e426c8c4dd395f2e7b0279;hp=3498901e8923268bf21819263e0ec5b5e63d77b3;hpb=9bbff73a71a636a626a1be365cbf48c07f1f7220;p=lhc%2Fweb%2Fwww.git

diff --git a/www/plugins/saisies/balise/voir_saisie.php b/www/plugins/saisies/balise/voir_saisie.php
index 3498901e..8ed9f945 100644
--- a/www/plugins/saisies/balise/voir_saisie.php
+++ b/www/plugins/saisies/balise/voir_saisie.php
@@ -1,21 +1,34 @@
 <?php
 
+/**
+ * Déclaration de la balise `#VOIR_SAISIE`
+ *
+ * @package SPIP\Saisies\Balises
+**/
+
+
 // Sécurité
 if (!defined("_ECRIRE_INC_VERSION")) return;
 
-/* 
- * #VOIR_SAISIE{type,nom} : champs obligatoires
+/**
+ * Compile la balise `#VOIR_SAISIE` qui retourne le code HTML de la vue d'une saisie indiquée
+ *
+ * Cette balise incluera le squelette `saisies-vues/_base.html` et lui-même `saisies-vues/{type}.html`
  * 
- * collecte des arguments en fonctions du parametre "nom"
- * ajoute des arguments
- * appelle #INCLURE avec les arguments collectes en plus
+ * @syntaxe `#VOIR_SAISIE{type,nom[,option=valeur,...]}`
+ * @uses Pile::recuperer_et_supprimer_argument_balise()
+ * @uses Pile::creer_et_ajouter_argument_balise()
+ * @uses Pile::creer_balise()
+ * @see balise_INCLURE_dist()
  * 
+ * @param Champ $p
+ * @return Champ
  */
 function balise_VOIR_SAISIE_dist ($p) {
 
 	// on recupere les parametres sans les traduire en code d'execution php
 	$type_saisie = Pile::recuperer_et_supprimer_argument_balise(1, $p);
-	$nom       = Pile::recuperer_et_supprimer_argument_balise(1, $p);
+	$nom         = Pile::recuperer_et_supprimer_argument_balise(1, $p);
 
 	// creer #ENV*{$titre} (* pour les cas de tableau serialises par exemple, que l'on veut reutiliser)
 	$env_nom   = Pile::creer_balise('ENV', array('param' => array($nom), 'etoile' => '*')); // #ENV*{nom}
@@ -29,11 +42,10 @@ function balise_VOIR_SAISIE_dist ($p) {
 
 	// on appelle la balise #INCLURE
 	// avec les arguments ajoutes
-	if(function_exists('balise_INCLURE'))
+	if(function_exists('balise_INCLURE')) {
 		return balise_INCLURE($p);
-	else
-		return balise_INCLURE_dist($p);	
-		
-}
+	} else {
+		return balise_INCLURE_dist($p);
+	}
 
-?>
+}