Ici, j'ai prvue de mettre un peu de documentation sur les diffrentes
possibilits de Dinel.

Sommaire :
 1. Installation et mise en route
 2. Utilisation standard
 3. gestion des dinorcs locals
 4. gestion du dinorc du serveur
 5. filtre

*********************************************************************
  1. Instalation et mise en route
*********************************************************************

Tout est expliquer dans le README

*********************************************************************
  2. Utilisation standard
*********************************************************************

Affichage :

dans la "mode line" (barre en dessous du buffer courant) on trouve
trois indicateur 
* : dinorc non sauv
w : en train de discuter avec le serveur
m : il reste des messages non lu

on trouve aussi suivant les buffers le nom du themes courant et le
nombre de message du theme courant  lire.

Les touches intressantes :

n : message (non lu) suivant
> : message suivant dans le theme courant
< : message prcedent dans le theme courant
t : change vers un themes o il y a des messages non lu
( : empile un message
) : depile un message
P : affiche la pile
m : ecrit un nouveau message
r : repond au message courant
R : rpond au message en courant en l'incluant
f : affiche un message filtr
s : sauve les dinorcs
q : quitte dinel
g : vat dans un themes
-/+ : ce ballader en suivant la suite des messages (donc d'une
      certaine faon perpendiculairement au theme)


C-h b : liste de tout les racourcies clavier.

Ces racourcie marche a peu pres partout (quand ils ont un sens)

Pendant la composition d'un message :
C-x k : anule la composition du message (enter ou y pour confirmer)
C-c C-c : envoie le message

sinon, c'est un buffer relativement normal (pour l'dition de texte). 

Les messages compos et ni envoyer ni anuler sont sauver
automatiquement dans le repertoire ~/.dino.d/

*********************************************************************
 3. gestion des dinorcs locals
*********************************************************************

Depuis la version 2.0 de dinel, deux version existe pour le dinorc
(fichier o sont stocker la liste des messages lu) :
- l'ancien qui stocke la lecture en disant que tout les messages
  avant un certain numro sont lu dans un thme donn
- le nouveaux qui stocke (de faon compacte) la liste des messages lu
  (avec ventuellement des trous)

par dfaut, dinel utilise le (ou les) format(s) dj existant sur le
disque, l'ancien s'il n'y en a pas.

Dans le menu, on trouve deux sous menus :
dinorc pour l'ancien
dinorc2 pour le nouveau

ils permetent : de sauv un format (mme si on ne l'utilisait pas
avant), de le relire (si on a utilis deux clients en mme temps par
exemple) ou de le dtruire (pour ne plus l'utiliser).

Un des deux formats ce doit d'exister (dinel refusera de suprimer un
des deux si l'autre n'existe pas).

on peux utiliser la touche "s" pour sauver le (les) dinorc(s), il est
aussi sauv : quand on quitte dinel avec la touche "q", quand on a
finit de lire tout les messages d'un thme et si Emacs n'a pas t
utilis au court des 5 dernieres minutes.

Pour changer ce temps (de 5 minutes), mettre ds le .emacs :
(setq dino-auto-save-time 100)
(pour 100 seconde)


*********************************************************************
 4. gestion du dinorc du serveur
*********************************************************************

Depuis la version 2.0 de dinel, et les version rcente du serveur, on
peux sauvegard sont dinorc sur le serveur, et donc ne plus avoir a le
copier en passant d'un endroit a l'autre.

Dinel n'utilise ce dinorc que si il existe dj, ou si on lui demande
explicitement. Pour le demander explicitement, utiliser "sauve" dans
le sous menu "dinorc serveur" du menu dino.

La sauvegarde est efectuer : quand on quitte dinel avec la touche "q", 
au bout de 30 minute d'inutilisation d'Emacs et quand on appuis sur a
touche "s" (mais dans tout les cas, seulement s'il existait dj).

Pour changer ce temps, mettre dans le .emacs :
(setq dino-auto-save-serveur-time 200)
pour 200 seconde

il faut que dino-auto-save-serveur-time > dino-auto-save-time (enfin,
c'est prfrable). (strict l'ingalit).

*********************************************************************
 5. filtre
*********************************************************************

dinel inclue maintenant une possibilit (limit) de filtre :

il faut mettre dans la variable dino-filtre une liste de liste de la
forme :

(HEADER ACCEPT REGLE)
ou
(HEADER ACCEPT REGLE MODIFIER)

HEADER doit contenir un des symboles suivant :
sujet       filtre sur le sujet
auteur      filtre sur l auteur
signe       filtre sur le nom de la personne signant
censure     filtre sur la censure

si ACCEPT est non nil alors si la rgle est positive, le message est
accepter, si il vaut nil alors si la rgle est positive, le message
est filtr

REGLE dcide si la rgle est positive ou ngative (MODIFIER peux
modifier le rsultat), par dfaut (MODIFIER absent ou nil):

si REGLE est une chane de caractre, elle est alors interprt comme
une regexp, et la rgle est positive si la valeur du champ match la
REGLE ou si le champ est absent
si REGLE est une fonction, elle est appeler avec comme unique argument
la valeur du champ (nil si absent) et doit renvoyer non nil si la
rgle est positive, nil sinon.


MODIFIER permet de modifier le comportement par dfaut :
- ou-absent alors si le champs est absent, la rgle devient positive
- inverse alors la rgle est positive si le champs est prsent et ne 
  correspond par  REGLE
- inverse-ou-absent alors la regle est positive si le champ est absent
  ou si il ne correspond pas  REGLE
- nil : comportement par dfaut

chaque lment de la liste est utiliser les un aprs les autres,
jusqu' trouver une premire rgle positive alors le rsultat de
ACCEPT est utilise, sinon le message est accepter.

dino-filtre peux aussi tre une fonction au quelle cas cette fonction
est appeler avec quatre argument : sujet auteur signe censure (dans
cette ordre) et doit renvoyer nil pour les messages refuser, non-nil
sinon

Quand un message est filtr, la touche f dans dino-message affiche le
message quand mme.

par exemple :

(setq dino-filtre '((censure () "")))

filtre les messages censur

(setq dino-filtre '((auteur () "^\\(PasBo\\|Mechant\\)$")))

filtre les messages de PasBo et de Mechant (sans regarder les
signatures). 

(setq dino-filtre '((signe t "")
                    (auteur () "")))

ici, si un message est sign, il est accepter, et sinon (s'il a un
auteur, tout les message ont un auteur) il est refus : filtre tout
les messages non signs.

on peux aussi faire 
(setq dino-filtre '((signe () "" inverse-ou-absent)))

(a fait la mme chose).

voir aussi :
(setq dino-filtre '((censure () "")
                    (auteur t "^darklight$")
                    (auteur () "")))

ici sont filtrs tout les messages censurs, et tout ceux dont
l'auteur n'est pas darklight.



