Mise en conformité du PHPDoc et du comportement de la fonction envoyer_mail...

Mise en conformité du PHPDoc et du comportement de la fonction envoyer_mail avec son extension proposée par le plugin Facteur :
la fonction reste compatible avec les appels existants, mais le format a préférer devient :
$envoyer_mail($destinataire, $sujet, $corps)
ou $corps est un tableau d'entrées.

En l'etat, la fonction supporte nativement les entrées suivantes pour $corps :
texte, from et headers comme historiquement

De plus, si une fonction 'mail_embarquer_pieces_jointes' est fournies, elle est appelee avec le contenu de l'entree 'pieces_jointes', charge à elle de convertir les dites pieces en une variable texte $parts qui représente les pieces jointes encodées, et qui sera ajoutée dans le corps du mail avec les boundary. 
Cela permet de merger l'évolution proposée par r18188 reportee en r18190 en restant dans la ligne de ce que propose Facteur.

Par ce commit, on assure aussi le fonctionnement a minima des appels étendus destinés à Facteur, ce qui n'était pas le cas jusqu'ici (un $corps au format tableau provoquant un mail vide)

/**
 * Envoi d'un mail
 * http://doc.spip.org/@inc_envoyer_mail_dist
 *
 * @param string $destinataire
 * @param string $sujet
 * @param string|array $corps
 *   au format string, c'est un corps d'email au format texte, comme supporte nativement par le core
 *   au format array, c'est un corps etendu qui peut contenir
 *     string texte : le corps d'email au format texte
 *     string from : email de l'envoyeur (prioritaire sur argument $from de premier niveau, deprecie)
 *     array headers : tableau d'en-tetes personalises, une entree par ligne d'en-tete
 *     --- Support partiel par une fonction mail_embarquer_pieces_jointes a fournir, --- 
 *     --- chargee de convertir en texte encodee les pieces jointes ---
 *     array pieces_jointes : listes de pieces a embarquer dans l'email, chacune au format array :
 *       string chemin : chemin file system pour trouver le fichier a embarquer
 *       string nom : nom du document tel qu'apparaissant dans l'email
 *       string encodage : encodage a utiliser, parmi 'base64', '7bit', '8bit', 'binary', 'quoted-printable'
 *       string mime : mime type du document
 *     --- Non implemente ici ---
 *     string html : le corps d'email au format html
 *     string nom_envoyeur : un nom d'envoyeur pour completer l'email from
 *     string cc : destinataires en copie conforme
 *     string bcc : destinataires en copie conforme cachee
 *     string adresse_erreur : addresse de retour en cas d'erreur d'envoi
 * @param string $from (deprecie, utiliser l'entree from de $corps)
 * @param string $headers (deprecie, utiliser l'entree headers de $corps)
 * @return bool
 */