
**************************************************************************

                 Rock v1.3 - Mailer Fidonet pour points
                  Copyright (C) 1995  Jean-Marc Xiume'
           Ce logiciel est distribué selon les termes de la
  Licence Publique Générale GNU. Lire "license.doc" pour plus de détails.

**************************************************************************



Introduction
------------

Rock est l'un des plus petits mailers pour points sur Amiga.
Il est écrit en languages WPL et Arexx.

Rock est basé sur POP v0.9 par Denis Turcotte, ainsi que sur JAZ v1.01
par Robert Williamson (pour le script rock.rexx).

Rock est très facile à installer et à configurer, peu gourmand en mémoire
et place disque, et permet d'appeler tour à tour les différents numéros
du boss si la ligne est occupée.

Pour les appels autres que le boss, il gère la nodelist si vous possedez
la traplist.library, sinon il demande le numéro de téléphone.

Le protocole de négociation fido est WAZOO, celui d'échange de fichier
est ZEDZAP. Aucun autre protocole n'est supporté.

Un exemple de configuration (rock.cfg) est fourni, ainsi qu'une
documentation associée (RockCfg_Fr.doc).



Installation
------------

Copiez simplement le répertoire ROCK où vous voulez, et assignez "rock:"
au chemin de ce répertoire. Il est préférable d'ajouter une ligne comme
celle-ci dans la user-startup:

Assign rock: DH1:Fidonet/Rock

Il faut aussi que les libraries présentes dans le répertoire libs de la
distribution (wpl.library, xferq.library, et xprzedzap.library) soient
accessibles au système. Vous pouvez soit les copier dans libs: , soit
ajouter dans la user-startup la ligne suivante:

Assign libs: rock:libs add

Lors de l'extraction de l'archive, utilisez l'option -a de LHA pour
préserver les attributs des fichiers, ou bien ajoutez manuellement le
flag "s" aux scripts "rock" et "boss" grâce à la commande protect
( ex: protect rock +s )

Avant d'utiliser Rock, il faut le configurer. Lizez "RockCfg_Fr.doc" puis
modifiez le fichier de configuration "rock.cfg" selon vos besoins.

Il est possible d'utiliser la Nodelist Fidonet au format traplist.
Le logiciel traplist doit être installé, et la traplist.library doit être
présente dans le répertoire libs: .


Les Points du BBS Ramses n'ayant pas de modem V34 ou VFC peuvent utiliser
le fichier de configuration "rock.cfg.ramses144" ainsi que le script de
lancement "rock.ramses144" figurant dans le répertoire rock:extras pour
optimiser l'occupation des 3 lignes du BBS.



Utilisation
-----------

Template amigados: rock ADDRESS,CONFIG

Pour démarrer une session avec son boss, il suffit de taper "rock" dans
le shell, ou de cliquer sur l'icône BOSS (le flag "s" doit être positionné
pour ces fichiers, voir installation).

Pour appeler un autre système, il faut donner son adresse comme argument
sur la ligne de commande (ex: rock 1:167/151.0), rock demandera alors le
numéro de téléphone et le mot de passe pour ce système.

Si vous utilisez la nodelist (cf le paramètre nodelist dans le fichier de
config), rock ira y chercher ces données. S'il ne les trouve pas, une
entrée manuelle sera demmandée, comme ci-dessus.

Il est possible de donner en argument le nom du fichier de configuration
à utiliser, dans le cas où vous vous connectez à différents BBS par exemple.
C'est un template amigados standard, donc si vous voulez indiquer un
fichier de config sans donner d'adresse il faut mettre le mot clé "config".

Exemples:
    rock
    rock 2:320/104
    rock 2:320/109 tlcsbbs.cfg
    rock config tlcsbbs.cfg


Rock peut être interrompu par un control-c dans sa fenêtre.



Scripts annexes
---------------

Le script "KillRock" sert, comme son nom l'indique, à terminer
l'exécution de rock (par exemple si les choses se passent mal).


Le script arexx "WaitRock" permet d'attendre, dans un script amigados par
exemple, que l'exécution de rock soit terminée:
  ...
  rock:rock             ;démarrage de rock
  wait 3                ;le temps qu'il se lance et déclare son port arexx
  rx rock:waitrock.rexx ;attends jusqu'à ce que la session soit terminée
  ...
Ce script accepte en argument le nombre de secondes à attendre entre chaque
test, pour optimiser le temps CPU utilisé.


Pour démarrer Rock depuis Spot, utiliser le script "StartRock.spot"
depuis le menu Arexx de Spot.



Remarques
---------

Rock est MailWare. Si vous l'utilisez, envoyez moi une 'tite carte sympa
de votre région (ou si vous êtes trop paresseux un NetMail suffira :-) )
ca fait toujours plaisir et me permet d'enregistrer les utilisateurs pour
un meilleur support.


Amusez vous bien... :-)

Commentaires et suggestions sont les bienvenus:

smail:     Jean-Marc Xiumé
           Parc du Belvédère
           83120 Sainte-Maxime
           FRANCE

fidonet :  2:320/104.22
amiganet:  39:180/1.22
usenet  :  jmx@ramses.fdn.org
           jmx@ramses.telesys-innov.fr




Remerciements à
---------------

- Tous ceux qui ont crée WPL
- Denis Turcotte pour l'idée et le script wpl d'origine
- Robert Williamson pour le script de gestion XferQ

- Arnaud Meurgues, Alain Chofardet, et Luc Gibert pour les béta-tests
  et des idées d'améliorations.



Historique
----------

* Rock 1.3 - 01 mars 1995

- Script "waitrock". Attends la fin de rock.
 

* Rock 1.3béta5 - 12 fév 1995

- ** Attention, fichier de configuration modifié ! Lire la doc !! **
  . Séparation en 5 sections (nets,fido,modem,display,files).
  . Ajout des adresses des différents réseaux du BBS (Fidonet, Amiganet...).
  . Ajout des paramètres  initloop  et  initwait  pour l'initialisation du
    modem.
  . Ajout du paramètre minbaud, pour raccrocher le modem dans le cas ou la
    vitesse de connexion avec le boss est inférieure à minbaud.
  . Changement de nom des variables d'affichage.
  . Ajout du paramètre closestatus, pour choisir si la fenêtre de rock doit
    se fermer ou non après la fin du programme.
  . Ajout du paramètre nodelist indiquant le chemin du répertoire ou se
    trouvent les fichiers de la nodelist.
- Il est maintenant possible d'utiliser la NodeList ! (format traplist).
- Les paramètres de configuration ont maintenant une valeur par defaut, sauf
  évidemment ceux de la partie FIDO.
- Suppression de la partie gestion des .FLO du script "rock". Maintenant
  tout cela est effectué par le nouveau script "bossflo.rexx".
- Il n'est plus nécessaire de modifier le script de lancement "rock" ni pour
  l'adresse du boss, ni pour les différents réseaux, tout se fait maintenant
  dans "rock.cfg".
- Initialisation du modem modifiée.
- Création du répertoire xferq automatisée (script "assignxferq")
- Version française et mise à jour de la doc du fichier de config.  A lire
  absolument.
- La validité de l'adresse donnée est maintenant vérifiée par le nouveau
  script "addrcheck.rexx".
- Nouveau script "nodelist.rexx" pour chercher le numéro de téléphone et le
  mot de passe du node appelé.
- Bug dans rock.rexx corrigé. Les fichiers .?LO contenant des CR comme fin
  de ligne sont maintenant correctement traités.
- Nouvel argument "config" pour le script "rock", pour permettre
  l'utilisation du fichier de config de votre choix.


* Rock 1.2c - 30 dec 1994

Version de developpement, non distribuée.


* Rock 1.2b - 14 dec 1994

- Quelques modifications mineures.


* Rock 1.2a - 01 oct 1994

- Rock peut maintenant ouvrir ses fenêtres sur un écran public.


* Rock 1.2  - 28 sep 1994

- Modification du script de lancement amigados "rock" pour concaténer les
  les  .FLO des différents réseaux en un seul,  à l'adresse principale du
  boss. Avant, rock n'envoyait que les fichiers du réseau fidonet.
- Ajout des différentes adresses du boss dans le fichier de configuration,
  pour avoir l'adresse correcte selon le numéro de téléphone appelé.
- Script "bossoutbound.rexx" pour renommer les fichiers .?LO, .?UT et .REQ
  selon l'adresse du boss à lequelle on est connecté. Rock ne gére pas les
  AKAs, et n'envoie que les fichiers destinés à l'adresse courante.
- Le logfile reporte si l'adresse donnée ne correspond pas à celle du site
  ou l'on est connecté.
- Rock.wpl modifié selon les changements ci-dessus.


* Rock 1.1  - 24 sep 1994

- Le script rock.rexx a été corrigé, l'ancien n'envoyait pas les fichiers
  en file-attach (du moins pas d'après mes tests entre  Rock et Trapdoor).
- Utilisation de l'assign ROCK: au lieu de Mail: pour les fichiers de rock.
- Le logfile fournit beaucoup plus de renseignements:
  . date et heure à chaque ligne.
  . début et fin du programme.
  . addresse et numéro de téléphone du système appelé.
  . report du message renvoyé par le modem en cas d'erreur de connexion.
  . précise si une erreur s'est produite ou si la session a été
    interrompue manuellement.
  . après la négociation, précise le nom du système appelé, le nom du
    sysop, et le mailer utilisé.
  . durée de la connexion.
- Divers changements dans rock.wpl.
- Script KillRock pour quitter rock au cas ou ;)


* POP v0.9 *

version originale par Denis Turcotte.
