spip / SPIP

ecrire/urls/propres.php

Doc Comments +3 added lines

@@ -62,6 +62,9 @@
 // Retire les marqueurs de type dans une URL propre ancienne maniere
 
 // http://doc.spip.org/@retirer_marqueurs_url_propre
+/**
+ * @param string $url_propre
+ */
 function retirer_marqueurs_url_propre($url_propre) {
 	if (preg_match(',^[+][-](.*?)[-][+]$,', $url_propre, $regs)) {
 		return $regs[1];

ecrire/xml/analyser_dtd.php

Doc Comments +24 added lines

@@ -139,6 +139,9 @@ 
 }
 
 // http://doc.spip.org/@analyser_dtd_comment
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_comment($dtd, &$dtc, $grammaire){
 	// ejecter les commentaires, surtout quand ils contiennent du code.
 	// Option /s car sur plusieurs lignes parfois
@@ -149,6 +152,9 @@ 
 }
 
 // http://doc.spip.org/@analyser_dtd_pi
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_pi($dtd, &$dtc, $grammaire){
 	if (!preg_match('/^<\?.*?>\s*(.*)$/s', $dtd, $m))
 		return -10;
@@ -156,6 +162,9 @@ 
 }
 
 // http://doc.spip.org/@analyser_dtd_lexeme
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_lexeme($dtd, &$dtc, $grammaire){
 
 	if (!preg_match(_REGEXP_ENTITY_DEF,$dtd, $m))
@@ -181,6 +190,9 @@ 
 // ca ne depasse pas 3 ici.
 
 // http://doc.spip.org/@analyser_dtd_data
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_data($dtd, &$dtc, $grammaire){
 
 	if (!preg_match(_REGEXP_INCLUDE_USE,$dtd,$m))
@@ -196,6 +208,9 @@ 
 }
 
 // http://doc.spip.org/@analyser_dtd_notation
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_notation($dtd, &$dtc, $grammaire){
 	if (!preg_match('/^<!NOTATION.*?>\s*(.*)$/s',$dtd, $m))
 		return -8;
@@ -204,6 +219,9 @@ 
 }
 
 // http://doc.spip.org/@analyser_dtd_entity
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_entity($dtd, &$dtc, $grammaire)
 {
 	if (!preg_match(_REGEXP_ENTITY_DECL, $dtd, $m))
@@ -253,6 +271,9 @@ 
 // Fin du controle en finElement
 
 // http://doc.spip.org/@analyser_dtd_element
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_element($dtd, &$dtc, $grammaire)
 {
 	if (!preg_match('/^<!ELEMENT\s+([^>\s]+)([^>]*)>\s*(.*)$/s', $dtd, $m))
@@ -295,6 +316,9 @@ 
 
 
 // http://doc.spip.org/@analyser_dtd_attlist
+/**
+ * @param string $dtd
+ */
 function analyser_dtd_attlist($dtd, &$dtc, $grammaire)
 {
 	if (!preg_match('/^<!ATTLIST\s+(\S+)\s+([^>]*)>\s*(.*)/s', $dtd, $m))

ecrire/xml/sax.php

Doc Comments +18 added lines

@@ -16,6 +16,9 @@ 
 include_spip('xml/interfaces');
 
 // http://doc.spip.org/@xml_debutElement
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_debutElement($phraseur, $name, $attrs)
 {
 	$depth = $phraseur->depth;
@@ -48,6 +51,9 @@ 
 }
 
 // http://doc.spip.org/@xml_finElement
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_finElement($phraseur, $name, $fusion_bal=false)
 {
 	$ouv = $phraseur->ouvrant[$phraseur->depth];
@@ -72,6 +78,9 @@ 
 }
 
 // http://doc.spip.org/@xml_textElement
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_textElement($phraseur, $data)
 {
 	$depth = $phraseur->depth;
@@ -80,6 +89,9 @@ 
 	  : htmlspecialchars($data,ENT_QUOTES);
 }
 
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_piElement($phraseur, $target, $data)
 {
 	$depth = $phraseur->depth;
@@ -97,6 +109,9 @@ 
 
 
 // http://doc.spip.org/@xml_defautElement
+/**
+ * @param IndenteurXML $phraseur
+ */
 function xml_defaultElement($phraseur, $data)
 {
 	$depth = $phraseur->depth;
@@ -128,6 +143,9 @@ 
 }
 
 // http://doc.spip.org/@coordonnees_erreur
+/**
+ * @param string $msg
+ */
 function coordonnees_erreur($phraseur, $msg)
 {
 	$entete_length = substr_count($phraseur->entete,"\n");

prive/formulaires/editer_mot.php

Doc Comments +6 added lines

@@ -96,6 +96,12 @@
 
 
 // http://doc.spip.org/@ajouter_nouveau_mot
+/**
+ * @param integer $id_groupe
+ * @param string $table
+ * @param integer $table_id
+ * @param integer $id
+ */
 function ajouter_nouveau_mot($id_groupe, $table, $table_id, $id_mot, $id)
 {
 	if (un_seul_mot_dans_groupe($id_groupe)) {

prive/formulaires/login.php

Doc Comments +3 added lines

@@ -14,6 +14,9 @@
 
 include_spip('base/abstract_sql');
 
+/**
+ * @param string $cible
+ */
 function is_url_prive($cible){
 	include_spip('inc/filtres_mini');
 	$path = parse_url(tester_url_absolue($cible)?$cible:url_absolue($cible));

squelettes-dist/formulaires/oubli.php

Doc Comments +3 added lines

@@ -19,6 +19,9 @@
 }
 
 // http://doc.spip.org/@message_oubli
+/**
+ * @param string $param
+ */
 function message_oubli($email, $param)
 {
 	$r = formulaires_oubli_mail($email);

squelettes-dist/formulaires/signature.php

Doc Comments +3 added lines

@@ -361,6 +361,9 @@
 // De plus, ca supprime les doublons "en attente de validation".
 
 // http://doc.spip.org/@signature_entrop
+/**
+ * @param string $where
+ */
 function signature_entrop($where)
 {
 	$query = sql_select('id_signature, statut', 'spip_signatures', $where,'',"date_time desc");

ecrire/req/mysql.php

Doc Comments +3 added lines, -3 removed lines

@@ -315,8 +315,8 @@ 
  * @param string|array $select   Champs sélectionnés
  * @param string|array $from     Tables sélectionnées
  * @param string|array $where    Contraintes
- * @param string|array $groupby  Regroupements
- * @param string|array $orderby  Tris
+ * @param string $groupby  Regroupements
+ * @param string $orderby  Tris
  * @param string $limit          Limites de résultats
  * @param string|array $having   Contraintes posts sélections
  * @param string $serveur        Nom de la connexion
@@ -881,7 +881,7 @@ 
  * @param int $row_number  Position. Déplacer le pointeur à cette ligne
  * @param string $serveur  Nom de la connexion
  * @param bool $requeter   Inutilisé
- * @return bool True si déplacement réussi, false sinon.
+ * @return boolean|null True si déplacement réussi, false sinon.
 **/
 function spip_mysql_seek($r, $row_number, $serveur='',$requeter=true) {
 	if ($r and mysqli_num_rows($r)) return mysqli_data_seek($r,$row_number);

ecrire/action/changer_mode_document.php

Doc Comments +3 added lines

@@ -27,6 +27,9 @@
 }
 
 // http://doc.spip.org/@action_virtualiser_post
+/**
+ * @param string[] $r
+ */
 function action_virtualiser_post($r, $url)
 {
 	$url = preg_replace(",^ *https?://$,i", "", rtrim($url));