L'analyseur de texte
====================

L'analyseur de texte est la partie de Majodormo qui prend le corps du texte et
en extrait les commandes. Dans ce cas ou il analyse une commande par ligne.
Il peut, biensûr, faire beaucoup plus.

L'analyseur regarde seulement dans le texte des parties évidentes de
commandes. Les autres parties ne sont pas traitées. Les Lignes commençant par
'#' sont considérées comme des commentaires, et sont ignorées. Les lignes
finissant par '\' sont continuées à la ligne suivantes.

L'analyseur vérifie la validité de chaque commande et remonte les erreurs. Il
peut aussi il peut aussi ne pas tenir compte de certaines erreurs, et indiquer
le nombre de lignes omises. Si nécessaire, un liste d'anomalie sera ajoutée
basée sur la liste par défaut fournie avec l'analyseur.

Si la ligne de commande se termine par '<<' et  par un mot en majuscule,
toutes les lignes entre la ligne de commande et une autre contenant seulement
un mot spécifique sont considérées comme des arguments à la commande. Ensuite
la routine est lancée et le résultat est remonté.

Il y a peu arguments additionnels pour l'analyseur:

La commande d'approbation 'approve'
-------------------------------------

  La commande 'approve' exécute la commande donnée (avec ses arguments) et
  avec le mot de passe fourni. Eventuellement certaines commandes peuvent être
  exécutées avec des privilèges en utilisant la commande d'approbation. La
  command 'default' décrite plus loin peut faire cela plus facilement en
  approuvant plusieurs commandes à la fois.

  Plusieurs commandes d'administration et de configuration ont peu d'utilité
  sans 'approve' et le mot de passe approprié. Si une commande d'administration
  échoue, vérifiez que vous l'avez correctement approuvée.

    Exemple: approve vespa subscribe scooters jdoe@example.com

    Voir aussi: default

La commande défaut 'default'
----------------------------

  la commande 'default' règle certains paramètres pour la durée de l'analyse.
  Les paramètres suivants peuvent être réglés:

    password:  approuve toutes les commandes qui suivent avec le mot de passe
               fourni. Pour effacer le mot de passe, n'en fournissez pas.

    list:      règle la liste par défaut pour les commandes agissant sur une
               liste. Pour effacer la liste par défaut, ne mettez pas de noms.

    language:  (pas implanté) fixe la langue par défaut de la liste, les
               langues en abrégées sur 2 lettres sont séparées par des
               virgules.

    prefix:    (pas implanté) fixe une préfixe qui (s'il est présent) sera
               éliminé du début de toutes les lignes suivantes.

La commande 'language'(pas implanté), est équivalente à la commande 'default
language', mais elle est enrichie pour le bénéfice des utilisateurs.

    Exemples:  default password vespa
               default list scooters
               default language en,de
               default prefix foo

Supplément pour l'analyseur
---------------------------

En plus de la syntaxe '<<' qui fournit des arguments à la commande, il y a
'<@'. Quand il est suivit d'un nombre, celui ci renvoi à un document joint
au message. (le numéro 1 référence le document joint qui vient juste après la
commande dans le corps du message). Depuis l'interface shell, cela renvoi au
nombre fournit avec l'argument '-f'. (Lisez le mj_shell manuel pour plus
d'informations. Notez que l'interface shell est seulement disponible au
utilisateurs locaux du système ou tourne Majodormo).

Cela autorise l'envoi de fichiers binaires et de leurs semblables, en
attachement à un message de commande et de faire quelque chose qui ressemble à
ce qui suit:

    approve password put=data mylist image/jpeg none base64 Picture <@ 1