home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 125.lha / Menucure / Menucure.doc < prev    next >
Encoding:
Text File  |  1986-11-20  |  6.9 KB  |  165 lines
  1. /*********************************************************************
  2. ***********************************************************************
  3. **                                                                   **
  4. **  Menucure.doc                                                     **
  5. **                                                                   **
  6. **  Historique    Nom            Description                         **
  7. **  ----------    ------------   ----------------------------------  **
  8. **   06-05-88     Eric Le Saux   Version originale                   **
  9. **                Jean Pepin                                         **
  10. **                                                                   **
  11. ***********************************************************************
  12.  *********************************************************************/
  13.  
  14. /*********************************************************************
  15. ***********************************************************************
  16. **                                                                   **
  17. **       Club Amiga Montréal (CAM)                                   **
  18. **       C.P. 195 STATION "N"                                        **
  19. **       Montréal (Québec)                                           **
  20. **       H2X 3M2, CANADA                                             **
  21. **                                                                   **
  22. **       Je veux être propagé comme un virus !                       **
  23. **                                                                   **
  24. **       DOMAINE PUBLIC - Distribution non-commerciale               **
  25. **       PUBLIC DOMAIN  - Freely redistributable                     **
  26. **                                                                   **
  27. ***********************************************************************
  28.  *********************************************************************/
  29.  
  30.    -------------------------------------------------------------------
  31.    I   - Objectifs
  32.    -------------------------------------------------------------------
  33.  
  34.       Pouvoir installer, modifier ou enlever des équivalents au
  35.    clavier pour les menus.
  36.  
  37.    -------------------------------------------------------------------
  38.    II  - Appel
  39.    -------------------------------------------------------------------
  40.  
  41.       Workbench :
  42.  
  43.          Outil      - création d'un projet appellé "MenucureListe"
  44.                       contenant tous les items et sous-items de menus
  45.                       présents à ce moment là.
  46.  
  47.          Projet(s)  - mise en place des menus sélectionnés.
  48.  
  49.  
  50.       CLI :
  51.  
  52.          Menucure            - création du fichier "MenucureListe",
  53.                                sans icône.
  54.  
  55.          Menucure Fichier    - mise en place des menus désignés.
  56.  
  57.          Menucure -f Fichier - comme 'Menucure' sauf que la sortie
  58.                                est dirigée dans 'Fichier'.
  59.  
  60.          Menucure ?          - aide.
  61.  
  62.    -------------------------------------------------------------------
  63.    III - Utilisation
  64.    -------------------------------------------------------------------
  65.  
  66.       La première étape est de faire apparaître sur un écran la fenêtre
  67.    dont on veux modifier les menus.
  68.  
  69.       Ensuite on appelle le programme comme mentionné précédemment
  70.    afin qu'il génère une liste des menus rencontrés dans tout l'envi-
  71.    ronnement Amiga.
  72.  
  73.       Avec un éditeur de textes qui supporte l'ascii 8 bits, on
  74.    élimine les lignes du fichier qui représentent des menus qui ne
  75.    nous intéressent pas, et l'on fait les modifications désirées à
  76.    celles qui restent.
  77.  
  78.       On peut maintenant installer ces modifications.
  79.  
  80.       Une alternative utile est de faire une copie des menus originaux,
  81.    afin de pouvoir les réinstaller au besoin.
  82.  
  83.       Si une erreur survient suite à l'exécution à partir du Workbench,
  84.    l'écran s'illuminera.  Pour en connaître plus précisément la cause
  85.    il faudra exécuter à partir du CLI.
  86.  
  87.       L'une des causes d'erreurs possibles, c'est que l'un des menus
  88.    du fichier de données n'ai pas été trouvé.  Çà a pour conséquence
  89.    que le programme ne trouvera pas non-plus les menus subséquents.
  90.  
  91.       Méfiez-vous des menus aux noms variables !
  92.  
  93.    -------------------------------------------------------------------
  94.    IV  - Format du fichier de menus
  95.    -------------------------------------------------------------------
  96.  
  97.       Le fichier contient autant de lignes que d'items ou de sub-items
  98.    de menus rencontrés pendant l'exécution.
  99.  
  100.       Chaque ligne est composée de 6 champs :
  101.  
  102.       - Le titre de l'écran
  103.       - Le titre de la fenêtre
  104.       - Le titre du menu
  105.       - Le titre de l'item
  106.       - Le titre du sub-item (vide quand il n'y a pas de subitem)
  107.       - La commande au clavier (un caractere)
  108.  
  109.       Chacun de ces champs est précédé du séparateur '¹'. (ALT-1)
  110.  
  111.       Lorsque l'item (ou sub-item) n'a pas d'équivalent au clavier,
  112.    il est représenté par le symbole '­'. (ALT-N)
  113.  
  114.    -------------------------------------------------------------------
  115.    V   - Modification du fichier des menus
  116.    -------------------------------------------------------------------
  117.  
  118.       Le principe de base du programme est de rechercher les items ou
  119.    sub-items de menus grâce au noms fournis dans le fichier de données.
  120.  
  121.       Des problèmes surviennent donc avec les programmes dont les titres
  122.    d'écran ou de fenêtre changent.
  123.  
  124.       La solution au problème est l'utilisation de wildcards :
  125.  
  126.       '?'  -   pour substituer un caractère à n'importe quel autre
  127.       '#'  -   pour marquer la fin de la comparaison
  128.  
  129.       Exemples :
  130.  
  131.        "Workbench#"  ==  "Workbench release 1.2.  141763 free memory"
  132.  
  133.        "T?E#"        ==  "TXEd Menucure.doc"
  134.                      ==  "TxEd1 Menucure.h"
  135.                      ==  "T&E Software Bankruptcy Insurances"
  136.  
  137.       IMPORTANT : Bien que l'on puisse éliminer certaines lignes
  138.    du fichier généré, il ne faut jamais changer leur ordre
  139.    d'apparition.
  140.  
  141.       Un fichier peut-être décomposé en plusieurs autres fichiers,
  142.    et plusieurs fichiers peuvent êtres groupés, en autant que la
  143.    remarque précédente est observée.
  144.  
  145.    -------------------------------------------------------------------
  146.    VI  - Compilation des sources
  147.    -------------------------------------------------------------------
  148.  
  149.       Afin de simplifier votre compréhension du programme, les sources
  150.    ont été fournies.  Elles ont été compilées avec Manx 3.6a de la façon
  151.    suivante :
  152.  
  153.            cc Menucure
  154.            ln Menucure +Q -lc
  155.  
  156.       NOTE IMPORTANTE : Pour que la compilation soit correcte, il faut 
  157.       que les constantes TRUE et FALSE dans <exec/types.h> soient
  158.       consistantes avec le type BOOL.  Soit que vous transformiez
  159.       BOOL pour qu'il soit de type 'long', soit que vous enleviez les
  160.       'L' a la suite des constantes.  Je préfère personnellement la
  161.       première option, car elle est compatible avec l'option +L de cc.
  162.  
  163.    -------------------------------------------------------------------
  164.    -------------------------------------------------------------------
  165.