-// http://doc.spip.org/@typo
-function typo($letexte, $echapper=true, $connect=null, $env=array()) {
+/**
+ * Applique la typographie générale
+ *
+ * Effectue un traitement pour que les textes affichés suivent les règles
+ * de typographie. Fait une protection préalable des balises HTML et SPIP.
+ * Transforme les balises `<multi>`
+ *
+ * @filtre
+ * @uses traiter_modeles()
+ * @uses corriger_typo()
+ * @uses echapper_faux_tags()
+ * @see propre()
+ *
+ * @param string $letexte
+ * Texte d'origine
+ * @param bool $echapper
+ * Échapper ?
+ * @param string|null $connect
+ * Nom du connecteur à la bdd
+ * @param array $env
+ * Environnement (pour les calculs de modèles)
+ * @return string $t
+ * Texte transformé
+ **/
+function typo($letexte, $echapper = true, $connect = null, $env = array()) {