@DATABASE AmiReplace
@$VER: 1.1
@AUTHOR RUSBACK
@INDEX INDEXNODE

@$VER : version 1.1 (03 Juin 2002)


@NODE "MAIN" "Sommaire"
        @{b}AmiReplace Version 1.1  03 Juin 2002@{ub}



    @{"DISTRIBUTION             " LINK Distribution} Copyright...
    @{"PRÉSENTATION, EXIGENCES  " LINK Présentation} En grandes lignes...
    @{"INSTALLATION             " LINK Installation} Rapide...
    @{"LANCEMENT                " LINK Lancement} Comment démarrer (Shell ou Workbench)

    @{"MENU                     " LINK Menus}
    @{"INTERFACE                " LINK Interface}
    @{"FONCTIONNEMENT           " LINK Fonctionnement}

    @{"BUGS (?)                 " LINK Bugs} Ouh la...
    @{"L'auteur                 " LINK Auteur}

@ENDNODE
@NODE "Distribution" "Distribution"
@TOC MAIN

    Le programme AmiReplace a été conçu et écrit par Rusback. Il est
    donc sous Copyright Rusback, il n'appartient pas au domaine public.

    Ce programme est emailware. Son utilisation @{B}personnelle@{UB} est libre.
    Cependant son utilisation commerciale ou professionnelle est interdite
    sans mon accord. Envoyez-moi vos suggestions quand à l'amélioration du programme
    ainsi que les éventuels rapports de bugs.

    Vous pouvez m'envoyer vos courriers éléctroniques à l'adresse suivante:
    rusback@wanadoo.fr

    La distribution de ce programme est interdite sans autorisation,
    Aminet, seul, peut le distribuer sur son réseau et ses CD.
@ENDNODE
@NODE "Présentation" "Présentation, exigences"
@TOC MAIN

    AmiReplace est un programme écrit en langage C (SAS C Compiler 6.58).

    Le programme ne fonctionne que sous système 3.1, avec un processeur 68020
    au moins.

    Ce petit logiciel permet de rechercher une phrase compléte ou un mot
    dans un fichier et de le remplacer par une autre phrase ou mot.
    Il possède une interface MUI. MUI n'est pas distribué avec le logiciel,
    vous pouvez vous le procurer dans le domaine public (site ou CR-ROM Aminet
    par exemple). Le programme ne peut pas fonctionner sans lui.

    Ce programme permet de travailler sur un nombre de fichiers
    théoriquement illimité. 
@ENDNODE
@NODE "Installation" "Installation"
@TOC MAIN

    Le programme peut être copié dans tout répertoire, à votre
    convenance, sous réserve qu'il y ait assez de place libre.
    Le répertoire @{B}Icons@{UB} contenant l'image d'information
    doit être copier dans le même répertoire que le programme AmiReplace.
    Le fichier @{B}AmiReplace.guide@{UB} peut être copié dans tout
    emplacement à votre convenance, 

    ATTENTION: le programme, pour fonctionner, fait appel aux ROM 3.1,
    son fonctionnement est impossible avec une version du système
    antérieure.
@ENDNODE
@NODE "Lancement" "Lancement du programme"
@TOC MAIN

    AmiReplace peut être lancé depuis le CLI ou le Workbench (en cliquant
    deux fois sur son icône).

    @{B}Lancement depuis le CLI@{UB}
        
        Ouvrez tout d'abord une fenêtre @{B}Shell@{UB}.
        Placez vous dans le répertoire où se trouve AmiReplace.
        Ensuite, vous pouvez lancer le programme simplement en tapant @{B}AmiReplace@{UB}

    @{B}Lancement depuis le Workbench@{UB}

        Ouvrez le répertoire où se trouve @{B}AmiReplace@{UB} et cliquer deux fois
        sur l'icône du programme.
@ENDNODE
@NODE "Menus" "Le menu d'AmiReplace"
@TOC Main

    Le programme AmiReplace possède 1 seul menu, pouvant être sélectionné
    de façon classique, à l'aide du bouton droit de la souris. 

    @{"Menu AmiReplace     " LINK "Menu AmiReplace"}

@ENDNODE
@NODE "Menu AmiReplace" "Menu AmiReplace"

    Ce menu comporte 4 entrées:

    @{"Au sujet d'AmiReplace  " LINK "Au sujet d'AmiReplace"}     Affiche quelques informations sur AmiReplace.
    @{"Au sujet de MUI        " LINK "Au sujet de MUI"}     Affiche quelques informations sur MUI.
    @{"Configurer MUI         " LINK "Configuration de MUI"}       Permet de configurer MUI selon vos envies.
    @{"Quitter                " LINK "Quitter"}      Quitte le programme.

@ENDNODE
@NODE "Au sujet d'AmiReplace" "Menu AmiReplace/Au sujet d'AmiReplace"
@TOC Project

    Ce menu affiche l'affichage d'un certain nombre d'informations sur AmiReplace:
    Copyright, date de compilation, etc...

@ENDNODE
@NODE "Au sujet de MUI" "Menu AmiReplace/Au sujet de MUI"
@TOC Project

    Ce menu affiche l'affichage d'un certain nombre d'informations sur MUI:
    Copyright, version de la bibliothéque, version de la réalisation, etc...

@ENDNODE
@NODE "Configuration de MUI" "Menu AmiReplace/Configurer MUI"
@TOC Project

    Ce menu affiche la fenêtre de configuration de MUI.
    Vous pouvez grâce à elle modifier à loisir tous les éléments de MUI.
    Cela va du contrôle des fenêtres en passant par les boutons de texte ou
    encore les listviews, etc...
    Tous les changements que vous effectuerez seront pris en compte lorsque
    vous aurez appuyer sur @{B}Utiliser@{UB} ou @{B}Sauver@{UB}.
    L'interface d'AmiReplace sera bien entendu modifié selon vos changements.

@ENDNODE
@NODE "Quitter" "Menu AmiReplace/Quitter"
@TOC Project

    Ce menu permet de quitter le programme le plus simplement.
    Le programme quitte également en libérant la mémoire qu'il occupait.
    ATTENTION!!! Lorsque vous quittez AmiReplace, votre liste de fichiers
    ne sera pas sauvegardée automatiquement.

@ENDNODE
@NODE "Interface" "Interface"
@TOC MAIN

    La fenêtre principale est constituée de 4 parties.

    -----------------------------------------------------------------------------
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                  1                    |                 2                 |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |                                   |
    |                                       |-----------------------------------|
    |                                       |                                   |
    |                                       |                 3                 |
    |                                       |                                   |
    |---------------------------------------------------------------------------|
    |                                                                           |
    |                                       4                                   |
    |                                                                           |
    -----------------------------------------------------------------------------

    La 1er partie est constituée de 2 éditeurs de texte :

      - En haut se trouve l'éditeur (@{B}Rechercher@{UB}) pour inscrire la phrase ou le mot à rechercher dans le(s) fichier(s).
      - En bas se trouve l'éditeur (@{B}Remplacer par@{UB}) pour inscrire la phrase ou le mot à remplacer dans le(s) fichier(s).

      Dans les 2 cas, le texte peut être inscrit dans l'éditeur en cliquant directement dans la case vide
      ou alors en cliquant sur le petit bouton en forme de rond situé à l'intersection des 2 ascenseurs.

    La 2éme partie est constitué d'une liste (@{B}Fichiers à traiter@{UB}) comportant 3 colonnes (@{B}Repertoire@{UB} | @{B}Fichiers@{UB} | @{B}Taille@{UB})
    ainsi que plusieurs boutons :

     - Un bouton @{B}Tout enlever@{UB} qui vous permet de mettre la liste à zero.
       Tant qu'aucuns fichiers n'apparaissent dans la liste (@{B}Fichiers à traiter@{UB}) il demeure grisé.
     - Un bouton @{B}Enlever@{UB} qui vous permet d'enlever de la liste (@{B}Fichiers à traiter@{UB}) certains fichiers non désirés.
       En effectuant une multi-sélection et ensuite en appuyant sur @{B}Enlever@{UB}, les fichiers disparaîtront de la liste (@{B}Fichiers à traiter@{UB})
       Tant qu'aucuns fichiers n'apparaissent dans la liste (@{B}Fichiers à traiter@{UB}) il demeure grisé.
     - Un bouton @{B}Selectionner@{UB} qui vous permet de selectionner tous les fichiers que vous désirez.
       Ce bouton est opérationnel au départ du programme.

    La 3éme partie (@{B}Projets@{UB}) ne comporte que 2 boutons :

     - Un bouton @{B}Charger@{UB} vous permettra de charger directement une liste de fichiers préalablement sauvegarder
       grâce au bouton @{B}Sauver@{UB}.
       Ce bouton est opérationnel au départ du programme.
     - Un bouton @{B}Sauver@{UB} vous permettra de sauvegarder la liste de fichiers (@{B}Fichiers à traiter@{UB})
       que vous aurez au préalable sélectionner.

       Le format de sauvegarde est du type :

           -- FICHIER --
           Repertoire
           Fichier
           Taille
           -- FIN FICHIER --    voir le fichier example @{B}example.arf@{UB}

       Ce bouton est grisé au départ du programme.

    La 4éme partie se compose d'une ligne d'information ainsi que de 2 boutons :

     - La ligne d'information vous indiquera la progression du traitement des fichiers.
     - Un bouton @{B}Traiter@{UB} qui comme son nom l'indique vous permettra de traiter tous les fichiers de la liste (@{B}Fichiers à traiter@{UB})
     - Un bouton @{B}Annuler@{UB} qui vous permettra de quitter le programme.
       Ce bouton est opérationnel au départ du programme.

    CAS SPECIAL : Le bouton de fermeture de fenêtre habituel sur migouze vous permet içi d'iconifier le programme.

@ENDNODE
@NODE "Fonctionnement" "Fonctionnement"
@TOC MAIN

    A chaque fois que vous lancez AmiReplace, vous voyez apparaître la fenêtre @{"Interface" LINK Interface}
    Dans un premier temps, les boutons @{B}Tout enlever@{UB} @{B}Enlever@{UB} @{B}Sauver@{UB} ainsi que @{B}Traiter@{UB} ne sont
    pas opérationnels.
    1er chose à faire, inscrire dans les éditeurs les phrases ou mots à rechercher et à remplacer par.
      ATTENTION!!! ne rien inscrire dans l'un ou l'autre éditeur ocassionnera un message d'erreur.
    2éme chose à faire, appuyez sur le bouton @{B}selectionner@{UB} et selectionner les fichiers que vous voulez voir traiter.
    ou alors appuyez sur le bouton @{B}Charger@{UB} pour charger une liste de fichiers.
    A ce moment là, les boutons @{B}Tout enlever@{UB} @{B}Enlever@{UB} @{B}Sauver@{UB} ainsi que @{B}Traiter@{UB} deviennent
    opérationnels.

    Plusieurs possibilités s'offrent à vous :

     - Effacer tout la liste (appuyez sur le bouton @{B}Tout enlever@{UB}) et ensuite recommencer à selectionner.
     - Effacer certains éléments de la liste (selectionner les fichiers indésirables et appuyez sur le bouton @{B}Enlever@{UB}).
     - Sauver la liste de fichiers (appuyez sur le bouton @{B}Sauver@{UB}).
     - Traiter la liste de fichiers (appuyez sur le bouton @{B}Traiter@{UB}).
       Lorsque la liste de fichiers est traitée tous les éléments de la fenêtre deviennent non opérationnels (grisés).
       Une fois la liste traitée tous les éléments redeviennent opérationnels.

@ENDNODE
@NODE "Bugs" "BUG(s) ?   (peut être !  (malheureusement... !) )"

    Ce programme m'a demandé beaucoup de travail aussi je vous
    demanderais de bien vouloir être indulgent quant aux erreurs toujours
    possibles survenant lors de son utilisation. Je vous saurais gré de
    bien vouloir @{"m'avertir" LINK "Auteur"} si vous constatez une ou des anomalies.
@ENDNODE
@NODE "Auteur" "L'auteur"

    Pour me contacter:

    Russeil Eric
    12 HLM les poneys
    BLD Mallebay
    24110 Saint Astier
    France

    E-mail: rusback@wanadoo.fr
@ENDNODE
