*******************************************************************************
* Fichier d'archive de l'application WebMailer (v1)
*
* Creation : 27.03.97
* Auteurs : Philippe PHUNG <pphung@essi.fr> <http://www.essi.fr/~pphung>
*           Thomas HAQUET <haquet@essi.fr>
*******************************************************************************

Sommaire
--------

1. Liste des fichiers contenus dans l'archive
2. Description du contenu des fichiers
3. Compilation et execution
4. Exemple de recherche
5. Conseils d'utilisation
6. Problemes connus

1. Liste des fichiers contenus dans l'archive
---------------------------------------------

Voici le contenu theorique du fichier webmailer.tar.gz.
Si vous n'avez pas la totalite des ces fichiers, vous pouvez recuperer une
archive complete sur http://www.essi.fr/~pphung

   4514 Mar 27 17:57 README
  42577 Mar 27 16:52 Webmailer.java
    923 Mar 26 17:28 barre.gif
    892 Mar 26 17:29 barre0.gif
  14061 Mar 27 17:53 bytecode.tar.gz
     29 Mar 27 16:39 fake_r4
   4565 Mar 24 18:05 finder1.gif
    547 Mar 24 18:07 finder2.gif
    231 Mar 24 18:11 finder3.gif
   5090 Mar 24 18:13 finder4.gif
   5155 Mar 26 17:48 finder6.gif
  23871 Mar 27 17:46 index.html
    181 Mar 27 17:40 message
    793 Mar 26 17:24 progress1.gif
    579 Mar 26 17:49 progress2.gif
 533481 Mar 27 17:54 resultats.tar.gz
   1054 Mar 26 17:40 status.gif

2. Description du contenu des fichiers
--------------------------------------

README          : le fichier que vous etes en train de lire
Webmailer.java  : code source de l'application
index.html      : documentation HTLM de l'application
*.gif           : images gif incluses dans index.html
fake_r4         : mail list utilise pour la simulation
message         : message envoye aux adresses de la mail list
bytecode.tar.gz : contient la version bytecode de l'application
resultats.tar.gz: contient les fichiers intermediaires d'une recherche


3. Compilation et execution
---------------------------

Pour compiler l'application tapez : javac Webmailer.java
Pour l'executer : java Webmailer

Si tout se passe bien une fentre s'affiche.
Si malgre tout vous n'arrivez pas a compiler le code source une version
bytecode est disponible dans bytecode.tar.gz.

Commandes : gzip -d bytecode.tar.gz
	    tar -xvf bytecode.tar
	    java Webmailer 	  

4. Exemple de recherche
-----------------------

Si vous voulez voir le resultat d'une recherche vous pouvez decompresser le
fichier resultats.tar.gz. Il  contient les fichiers intermediaires 
issus d'une recherche sur le mot "robosoft".
Pour "robosoft" AltaVista renvoie 100 references.
- r1 : contient l'integralite des pages reponses d'AltaVista
- r2 : contient le resultat du filtrage des URLs de r1
- r3 : contient l'integralite des pages pointees par les URLs de r2
- r4 : contient la mailing list finale issue du filtrage de r3

5. Conseils d`utilisation
-------------------------

Les performances de ce programme sont fortement liees a la charge du reseau.
Il est donc preferable de l'utiliser pendant les "heures creuses". Le
weekend par exemple ou tot le matin.

Comme le programme sauve sur disque l'integralite des documents HTML, il faut
prevoir l'espace disque necessaire. 
(une moyenne de 8 ko par reference renvoyee par AltaVista).

6. Problemes connus
-------------------

"Connection broken. Please restart"

Cause    : la connexion initiale avec AltaVista a ete coupee prematurement.
Solution : relancer la recherche en appuyant sur Restart. Si cette erreur
           se repete, attendre une heure creuse pour relancer la recherche.

"Le programme bloque dans la phase Collect HTML documents"

Causes   : les causes sont multiples. 
	   a) le reseau est sature
	   b) le document se trouve sur un serveur sature 
	   c) votre machine est saturee
	   d) et bien d'autres ...

Solution: vous pouvez appuyer sur le bouton "Skip step". Vous arretez alors
          de maniere definitive la phase de collecte des documents HTML.
	  Le programme passe alors a la phase suivante : le filtrage des
	  adresses emails sur les documents qui ont ete rapatries.

"La barre de progression du mailing n'est pas de 100% alors que le
programme affiche "Process finished. See ya later"

Cause : vous etes probablement en mode simulation pour le mailing.
        Le programme utilise alors la mail list fake_r4 qui ne contient
	que 2 adresses. 
	Le pourcentage affiche correspond alors au rapport de 2 sur 
	le nombre reel d'adresses emails issues de la recherche.

                              ---- the end ----







