home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 552.lha / ParM_v3.0 / ParM.docF.pp / ParM.docF
Text File  |  1991-09-08  |  31KB  |  678 lines
  1.  
  2.  
  3. Documentation pour ParM
  4.  
  5.  
  6. ParM signifie Parametrable Menu.
  7.  
  8. ParM  vous  permet  de  construire  vos propres menus de manière à pouvoir
  9. lancer  tous  les  programmes  de  votre choix.  ParM est particulièrement
  10. utile  si  vous possédez un disque dur avec des programmes situés dans les
  11. profondeurs des répertoires.  Vous pourrez alors les lancer par une simple
  12. sélection  de menu et donc sans avoir besoin d'ouvrir tous les répertoires
  13. succéssifs aussi bien sous CLI que sous WorkBench.
  14. Avec  ParM, vous pouvez lancer vos programmes aussi bien en mode WorkBench
  15. qu'en  mode  CLI.   L'avantage du mode WorkBench est que le répertoire par
  16. défaut  de  votre  programme sera celui dans lequel le programme se situe.
  17. Mais tous les programmes ne peuvent être exécutés dans ce mode.
  18.  
  19.  
  20. Création:
  21.  
  22.     ParM  a  été  programmé  en  C avec l'AztecC 5.0a, CygnusEd 2 et ARexx
  23.     1.10.   Les  en-têtes  de  fichiers sont faits de telle manière que la
  24.     compilation  puisse  être  lancée depuis Ced.  J'utilise pour cela mon
  25.     propre  DevKit,  complètement  réécrit car la version 1.2 originale ne
  26.     fonctionnait pas du tout.
  27.  
  28.     ParM  a  besoin  de  la  librairie  arp.library  version 39.1 et de la
  29.     req.library  version  1.   J'ai  écrit  mes  propres  librairies  pour
  30.     l'éditeur  de  lien Manx.  Celles utilisées ici se nomment arps.lib et
  31.     req.lib.   La  arps.lib  fourni  un petit code de startup et les glues
  32.     pour  les fonctions arp qui ne peuvent être prototypées, et la req.lib
  33.     est  le  fichier objet reqglue.o fourni avec Ced réécrit sous forme de
  34.     librairie. A partir de la version 2.6, il faut aussi mettre le fichier
  35.     parm.library dans votre répertoire LIBS:.
  36.  
  37.  
  38. Installation:
  39.  
  40.     Installez  ParM  avec  son  icone  là où vous le désirez, et mettez le
  41.     fichier  de  configuration  ParM.cfg  dans  le  répertoire S:  si vous
  42.     l'utilisez.   Sinon,  vous devrez systématiquement spécifier le nom du
  43.     fichier  config  sur  la  ligne  de  commande ou dans les TOOLTYPES de
  44.     l'icone  de  ParM.   Dans  le  cas  contraire,  vous  devrez  répondre
  45.     l'alerte signifiant l'absence de fichier config et vous n'aurez pas de
  46.     menus.   Assurez  vous  bien  d'avoir placé les librairies arp.library
  47.     39.1 ou superieure et req.library dans LIBS:.
  48.  
  49.  
  50. Exécution:
  51.  
  52.     Il  est recommandé de lancer ParM depuis un CLI si vous voulez que vos
  53.     programmes aient un Path autre que le répertoire courant et C:  ce qui
  54.     est le cas si vous le lancez depuis workbench.
  55.  
  56.     ParM peut fonctionner de trois manières différentes:
  57.     1)  Vous  pouvez  attacher ParM à la fenêtre du CLI que vous utilisez.
  58.         Dans ce cas, si vous ne spécifiez aucune des options concernant la
  59.         fenêtre,  les  menus  seront  attachés  au  CLI depuis lequel vous
  60.         l'avez  lancé.  Il est préférable alors de lancer avec la commande
  61.         Run  et  non  RunBack  pour  vous  empêcher  de  fermer le CLI par
  62.         inadvertance.
  63.     2)  ParM  peut  avoir  sa propre fenêtre.  C'est toujours le cas quand
  64.         ParM  est  exécuté  depuis  WorkBench,  mais vous pouvez aussi lui
  65.         demander  d'ouvrir  sa fenêtre quand vous le lancez depuis un CLI.
  66.         Pour  cela,  il  suffit  de spécifier l'option "-w" ou toute autre
  67.         option  ayant  rapport  avec  les  caractéristiques de la fenêtre.
  68.         Dans  ce  cas,  vous devriez le lancer avec la commande RunBack de
  69.         manière  à  pouvoir fermer le CLI par la suite.  N'utilisez pas la
  70.         commande  arp  ARun  avec l'option NOIO car certains programmes ne
  71.         l'aiment pas et ne fonctionneront pas depuis ParM.
  72.     3)  ParM peut être rattaché aux menus du Workbench, comme MyMenu.
  73.  
  74.     Attention:   Ne lancez pas ParM avec la commande "Run >NIL:  ParM" car
  75.     il  serait  détaché  du  CLI  mais  conserverais  la  fenêtre pour ces
  76.     fichiers  standards  d'entrée  et  de sortie et certaines commandes en
  77.     mode RUN peuvent planter si vous avez fermé le CLI.  Notez que RunBack
  78.     utilise  la  commande C:Run et vous devriez mettre dans C:  la version
  79.     arp  de  Run à la place de celle de Commodore si vous désirez utiliser
  80.     ParM en résident.
  81.  
  82.     ParM a des options accessibles aussi bien sous WorkBench que sous CLI.
  83.     Seules deux d'entre elles ne sont accessibles que sous CLI.  '-w' pour
  84.     Window puisque ParM ouvre toujours sa fenêtre dans ce cas, et '-o' car
  85.     c'est par défaut sous WorkBench vu l'absence de fenêtre.
  86.  
  87.     Liste des options:
  88.  
  89.     CLI      WB
  90.  
  91.     -m    MYMENU        Rattache ParM au Workbench. (Comme MyMenu !)
  92.     -w                  Ouvre sa propre fenêtre
  93.     -x    LEFTEDGE      Position horizontale de la fenêtre (défaut 0)
  94.     -y    TOPEDGE       Position verticale de la fenêtre (défaut 0)
  95.     -d    DETAILPEN     Couleur "d'avant-plan" de la fenêtre (défaut 3)
  96.     -b    BLOCKPEN      Couleur de fond de la fenêtre (défaut 2)
  97.     -c    MENUCOLOR     Couleur du menu principal (défaut: Detail Pen)
  98.     -r    NODRAGBAR     Rend la fenêtre non déplaçable (=1 pour activer)
  99.     -g    DEPTHGADGETS  Gadgets de profondeur (=1 pour activer)
  100.     -s    STACKSIZE     Taille de la pile par défaut pour les commandes.
  101.                         (Ce n'est pas la pile de ParM)
  102.     -f    CONFIGFILE    Fichier de configuration.
  103.     -o                  Redirige les entrées/sorties des commandes à NULL:
  104.  
  105.     -h ou n'importe quoi d'autre pour avoir de l'aide.
  106.  
  107.  
  108.     Pour  utiliser les TOOLTYPES de l'icône de ParM, il suffit d'entrer le
  109.     mot clé suivit d'un "=" et de la valeur nécessaire. Par exemple:
  110.  
  111.         DETAILPEN=1
  112.  
  113.     C'est équivalent à
  114.  
  115.         RunBack >NIL: ParM -d1  sous CLI.
  116.  
  117.     Si  vous spécifiez une des options -x,-y,-d,-b,-g,-r, une fenêtre sera
  118.     ouverte et "-w" est inutile.
  119.  
  120.  
  121. Fichier de configuration:
  122.  
  123.     Vous   comprendrez   mieux  ce  qui  va  suivre  avec  le  fichier  de
  124.     configuration fourni sous les yeux.
  125.  
  126.     Un  fichier  de  configuration ressemble à un programme structuré.  Il
  127.     est  recommandé  d'indenter  les  lignes  pour rendre ce fichier aussi
  128.     lisible  que possible.  Le fichier de configuration par défaut doit se
  129.     trouver  dans le répertoire S:  et nommé ParM.cfg.  Ce fichier définit
  130.     les  menus  que  vous  désirez  et les commandes correspondantes.  Les
  131.     commentaires commencent avec un '#' et continuent jusqu'à la fin de la
  132.     ligne.  Les majuscules/minuscules ne sont pas distinguées.
  133.  
  134.  
  135.     Mots clés:
  136.  
  137.     CMDWIN  console
  138.  
  139.         Cette  commande redéfinira la console par défaut utilisée par ParM
  140.         ("CON:0/11/640/100/Command Window")   pour  la  fonction  Command.
  141.         Peut être placé n'importe où dans le fichier mais il vaut mieux le
  142.         mettre au début.
  143.  
  144.     SHELLWIN  console
  145.  
  146.         Cette  commande redéfinira la console par défaut utilisée par ParM
  147.         ("CON:0/11/640/100/ParM Shell")  pour  les commandes en mode SHELL
  148.         sans  spécification de fenêtre.  Peut être placé n'importe où dans
  149.         le fichier mais il vaut mieux le mettre au début.
  150.  
  151.     SHELLCMD  commande
  152.  
  153.         Cette  commande  redéfinira  la commande utilisée par ParM pour la
  154.         création  d'un  shell interactif qui est par défaut 'AShell'.  Par
  155.         exemple, si vous possédez WShell, vous pouvez utiliser NewWSH ici.
  156.         Peut être placé n'importe où dans le fichier mais il vaut mieux le
  157.         mettre au début.
  158.  
  159.     WAITCMD  commande
  160.  
  161.         Cette  commande  redéfinira  la  commande  utilisée  par ParM pour
  162.         attendre  une  réponse  de  l'utilisateur avant de fermer un shell
  163.         (défaut:   WaitReturn).   Peut  être  placé  n'importe  où dans le
  164.         fichier mais il vaut mieux le mettre au début.
  165.  
  166.     TMPDIR  path
  167.  
  168.         Cette  commande  redéfinira  le répertoire par défaut (T:) utilisé
  169.         pour  la  création des fichiers scripts temporaires en mode SHELL.
  170.         Si  votre répertoire n'est pas la racine d'un device (exemple T:),
  171.         vous  devez  ajouter  un  slash  '/'  après  le  nom du répertoire
  172.         (exemple  RAM:T/).   Peut  être placé n'importe où dans le fichier
  173.         mais il vaut mieux le mettre au début.
  174.  
  175.     SHORTCUTQUAL qual
  176.  
  177.         Ceci   permet  d'ajouter  une  ou  plusieurs  touche  d'acces  aux
  178.         raccourci-clavier  pour les menus.  Par exemple Amiga-gauche, ALT,
  179.         ou encore SHIFT ou Control. Si vous desirez plusieurs possibilités
  180.         vous pouvez ajouter les codes si dessous.
  181.         Liste des codes:
  182.             SHIFT gauche    1
  183.             SHIFT droit     2
  184.             CONTROL         8
  185.             ALT gauche      16
  186.             ALT droit       32
  187.             Amiga gauche    64
  188.  
  189.         Si par exemple vous desirez que les deux touches ALT puissent vous
  190.         servir de touche raccourci, faites:         ( 16 + 32 = 48 ! )
  191.             SHORTCUTQUAL 48
  192.  
  193.         Si  vous  desirez  des  raccourcis sans qualifier, (lettre seule),
  194.         vous pouvez utiliser  32768  (IEQUALIFIER_RELATIVEMOUSE),  qui est
  195.         toujours  present dans les évennements de type RAWKEY. (Attention,
  196.         a utiliser avec précaution).
  197.         Ceci  ne marche que si ParM a sa propre fenêtre ou est rattaché au
  198.         Workbench, mais ne marche pas dans un CLI.
  199.  
  200.  
  201.     ACTIVATEKEY [SCREENTOFRONT] [PASSTHROUGH] [NOCHECK] qualifier rawkey
  202.  
  203.         Ceci permet de définir un "Hot-Key" pour ParM ou plus généralement
  204.         pour  tout  programme qui utilise les menus de la parm.library, et
  205.         donc "The great BrowserII" !
  206.         Attention, rawkey est le code de touche du clavier, et non pas le
  207.         code ascii du caractère généré par la touche.
  208.         Comme  son  nom  l'indique,  ceci  une  séquence de touches qui va
  209.         activer la fenêtre de ParM, et ceci avec trois options.
  210.  
  211.         Pour expérimenter les codes qui passent dans le handler, installez
  212.         la version 'debug' de la librairie dans LIBS:.
  213.         Méthode:
  214.             Assurez vous que parm.library ne soit pas en mémoire (Rebooter
  215.             si nécessaire).
  216.             Copy parm.library.debug libs:parm.library
  217.             Run ParM -w
  218.         Une fenêtre affiche alors dans l'ordre:
  219.             Class  SubClass  Code  Qualifier.
  220.         Ces codes sont en hexadécimal et seuls Code et Qualifier vous sont
  221.         utiles. Vous devez les transformer en décimal pour ParM.
  222.         Une  fois  les  infos  recueillies, réinstallez la version normale
  223.         de la parm.library.
  224.  
  225.         Options:
  226.             1. SCREENTOFRONT
  227.                 L'écran qui contient la fenêtre de  ParM  passera en avant
  228.                 plan.
  229.             2. PASSTHROUGH
  230.                 Ceci  risque  d'être  un peu délicat à comprendre pour les
  231.                 non-programmeurs.   Disons  que  si  vous ne spécifiez pas
  232.                 cette option, la séquence n'aura pour action que d'activer
  233.                 la  fenêtre.  Si vous la mettez, la fenêtre que vous venez
  234.                 d'activer  recevra  la  séquence  de  touche,  et si cette
  235.                 séquence  correspond  à  un  raccourci  clavier d'un menu,
  236.                 l'option  de  menu  sera  exécutée.   Ceci  est  donc très
  237.                 puissant  puisque  bien  paramétré,  cela  vous  permet de
  238.                 lancer  un  programme grace a ParM sans toucher la souris,
  239.                 même si la fenêtre de ParM n'est pas active.
  240.  
  241.                 Exemple:
  242.                 
  243.                     SHORTCUTQUAL 64                 (Amiga gauche)
  244.                     ACTIVATEKEY PASSTHROUGH 64 50   (Amiga gauche - X)
  245.  
  246.                     Menu System
  247.                         Item {X} Xoper RUN Xoper
  248.  
  249.                     Ceci permet de lancer Xoper à tout moment sans toucher
  250.                     ni la souris, ni ParM.
  251.  
  252.                 Autre exemple:
  253.  
  254.                     # Left ALT - Right Mouse Button
  255.                     ACTIVATEKEY PASSTHROUGH SCREENTOFRONT 8208 105
  256.  
  257.                     Ceci active la fenêtre ParM, et les Menus. Essayez.
  258.                     Plus besoin d'aller cliquer dans la petite fenêtre.
  259.  
  260.             3. NOCHECK
  261.                 La  librarie  maintient  une  liste des "Hot-Keys".  Quand
  262.                 vous  ajoutez  un  Hot-Key,  ParM controle qu'il n'est pas
  263.                 déjà utilisé.  Si c'est le cas, vous en serez averti et il
  264.                 ne  sera pas pris en compte.  Si vous spécifez NOCHECK, il
  265.                 sera  systématiquement  installé  en  tête  de liste, sans
  266.                 contrôle, et sera prioritaire sur l'ancien.
  267.                 Ceci  me  permet la chose suivante:  Un Hot-Key de ParM me
  268.                 charge  BrowserII.  Le même Hot-Key est déclaré en NOCHECK
  269.                 dans BrowserII.menu.
  270.                 Ceci  a  l'effet suivant:  Si BrowserII est chargé, il est
  271.                 activé  et  son écran passe en avant plan.  sinon, ParM le
  272.                 charge.
  273.  
  274.                 ParM.cfg :
  275.  
  276.                     SHORTCUTQUAL 64
  277.  
  278.                     # Left Amiga - Z   (Load BrowserII)
  279.                     ACTIVATEKEY PASSTHROUGH 64 49
  280.  
  281.                     menu Tools
  282.                         item {Z} BrowserII      RUN HD:Tools/BrowserII
  283.  
  284.                 BrowserII.menu :
  285.  
  286.                     SHORTCUTQUAL 64
  287.  
  288.                     # Left Amiga - Z
  289.                     ACTIVATEKEY SCREENTOFRONT NOCHECK 64 49
  290.  
  291.  
  292.     COLOR  n
  293.  
  294.         Après  cette instruction, les menus seront de la couleur n.  Cette
  295.         couleur  est  par  défaut  la  couleur  d'avant plan de la fenêtre
  296.         (detail  pen).  Si vous demandez la couleur de fond, alors ParM la
  297.         remplacera par la couleur du detail pen.
  298.  
  299.     MENU  nom_du_menu
  300.  
  301.         Créé  un nouveau menu.  Chaque menu doit contenir au moins un item
  302.         ou un sousmenu.
  303.  
  304.     SUBMENU  nom_du_sousmenu
  305.  
  306.         Créé  un nouveau sousmenu.  Chaque sousmenu doit contenir au moins
  307.         un item et ne peut avoir de sousmenu.
  308.         Chaque SUBMENU doit se terminer par un ENDSUBMENU
  309.  
  310.     ENDSUBMENU
  311.  
  312.         voir SUBMENU.
  313.  
  314.  
  315.     ITEM [{raccourci-clavier}]  nom_de_l_item  definition_de_la_commande
  316.  
  317.         Definit  une  nouvelle  entrée  de menu.  Chaque definition 'item'
  318.         doit  avoir  un  nom  d'item et une commande associée.  L'item est
  319.         ajouté  au menu ou sousmenu courant.  Un ENDSUBMENU indique à ParM
  320.         la  fin  du sousmenu courant et d'ajouter le prochain item au menu
  321.         courant  plutôt  qu'au  sousmenu.   Un raccourci-clavier optionnel
  322.         peut être indiqué entre {}.  La syntaxe d'une commande est definie
  323.         dessous.
  324.  
  325.         definition_de_la_commande
  326.  
  327.             Les programmes peuvent être lancés de 4 façons différentes:  ARUN,
  328.             RUN,  SHELL, et WB.  Pour tous les modes, STACK (pile) et PRI sont
  329.             optionnels.  Si la pile est < 4000 octets, la taille sera celle de
  330.             la pile de ParM, c'est à dire, la pile par défaut du cli au moment
  331.             où ParM a été lancé.  Il y a une exception:  si ParM est résident,
  332.             la pile de ParM sera toujours de 4000 octets.
  333.  
  334.  
  335.             1) syntaxe de ARUN
  336.  
  337.             ARUN [WIN console] [STACK n] [PRI n] commande [args]
  338.  
  339.             Ce mode devrait remplir la plupart de vos besoins.  La console
  340.             est   maintenant   optionnelle.    C'est   un  mode  de  style
  341.             CreateProc().   Certains programmes ne l'aiment pas, mais il y
  342.             en  a peu.  Par exemple, les scripts ne peuvent être exécutés.
  343.             D'une   manière  générale,  les  commandes  du  répertoire  C:
  344.             fonctionnent   mieux  en  mode  RUN.   Ce  mode  a  les  mêmes
  345.             limitations  que  la  commande  arp  ARUN.   Actuellement,  la
  346.             console  est immédiatement fermée à la fin du programme.  Nous
  347.             espérons  régler  ce  problème  dans  une version future.  Les
  348.             commandes ne peuvent pas être redirigées dans ce mode.
  349.             Note:  Le mode ARUN avec une console (ARUN WIN console...) est
  350.             le  même  que  l'ancien mode CLI.  Si vous utilisez un ParM de
  351.             version   antérieure  à  la  2.2  vous  pouvez  effectuer  un
  352.             search/replace  sur votre ancien fichier de configuration pour
  353.             changer 'CLI' en 'ARUN WIN'.
  354.  
  355.  
  356.             2) syntaxe RUN
  357.  
  358.             RUN [STACK n] [PRI n] commande [args]
  359.  
  360.             Ce  mode  lance la commande en background shell.  Ce mode doit
  361.             être  utilisé  pour les scripts.  Si le bit s de votre fichier
  362.             script est mis, il sera exécuté automatiquement (Pas besoin de
  363.             la  commande  Execute).  Dans ce mode, les commandes ne seront
  364.             pas  détachées  si  ParM  est attaché à un CLI, c'est pourquoi
  365.             vous  devriez plutôt utiliser ARUN aussi souvent que possible.
  366.             Vos commandes peuvent être redirigées dans ce mode.
  367.  
  368.  
  369.             3) syntaxe SHELL
  370.  
  371.             SHELL [WIN console] [STACK n] [PRI n] commande [args][;commande [args]]...
  372.  
  373.             Ce  mode  crée un shell interactif.  Ce mode doit être utilisé
  374.             pour  les  scripts demandant des entrées de l'utilisateur.  Si
  375.             le  bit  s  de  votre  fichier script est mis, il sera exécuté
  376.             automatiquement  (Pas  besoin  de  la  commande  Execute).  Un
  377.             avantage  supplémentaire de ce mode est que vous pouvez mettre
  378.             plusieurs  commandes séparées par des point-virgules ';'.  Par
  379.             exemple:  CD SYS:Utilities;Dir.  En fait, ParM crée un fichier
  380.             script  temporaire  dans  un répertoire de votre choix qui est
  381.             par  défaut  T:.   Donc,  vous  pouvez  réaliser  un véritable
  382.             fichier  script  en  remplaçant  les retours chariot de fin de
  383.             ligne  par  des  point-virgules.  Pour  réaliser ceci, prennez
  384.             votre   éditeur   de   texte   préféré,  tappez  votre  script
  385.             normalement,  puis  à  chaque  fin de ligne, ajoutez un ';' et
  386.             faites un  'Del'  pour enlever le retour chariot (ou faites un
  387.             'join line').  De  cette manière, votre script tiendra sur une
  388.             seule  ligne,  et pourra être intégré tel quel dans le fichier
  389.             de  configuration  de ParM.  Si vous avez besoin d'un ';' dans
  390.             une  commande,  ce  qui  ne  devrait pas se produire car c'est
  391.             normalement  le  délimiteur  de  commentaires d'un shell, vous
  392.             pouvez  utiliser  le  caractère spécial '\'.  Exemple:  ';' ->
  393.             '\;' et '\' -> '\\'.  Si vous ne spécifiez pas de console (WIN
  394.             console), la console shell par défaut sera utilisée.
  395.  
  396.  
  397.             WB [STACK n] [PRI n] commande
  398.  
  399.             Lance  la  commande  en  mode  WorkBench,  comme si vous aviez
  400.             cliqué  sur  son icône.  Attention, si vous spécifiez une pile
  401.             (STACK)  ici,  elle  prendra  le pas sur la pile indiquée dans
  402.             l'icône.   Votre  commande  risque  donc  de  planter  si vous
  403.             utilisez une pile trop petite.  Sachez ce que vous faîtes.
  404.  
  405.  
  406.             5) option CFG
  407.  
  408.             CFG Fichier_de_Configuration
  409.  
  410.             ParM  charge  le  fichier de configuration comme si vous aviez
  411.             fait  Open  dans  le menu ParM et sélectionné ce même fichier.
  412.             Très  utile  pour utiliser des fichiers config sur des disques
  413.             différents pour choisir les programmes de ces disques.
  414.  
  415.  
  416.     Dans tous les modes à l'exception de WB, la commande est cherchée dans
  417.     la liste des programmes résident arp (commande arp ARes), puis dans le
  418.     Path  actif au moment ou ParM a été lancé.  Pour connaître ce Path, il
  419.     suffit  d'entrer  la  commande  Path  dans le requester de la fonction
  420.     Command  du  menu ParM, ou d'ouvrir un shell depuis ParM, et de tapper
  421.     la commande Path.
  422.  
  423.     Un fichier de configuration est donné en exemple.
  424.  
  425.  
  426. Commandes du menu ParM.
  427.  
  428.     Open:       Ouvre le sélecteur de fichier pour selectionner le fichier
  429.                 à charger.
  430.     Update:     Met  à  jour  les  menus  en  rechargeant  le  fichier  de
  431.                 configuration  courant.   Utile si vous avez mofifié votre
  432.                 fichier config pendant que ParM tourne.
  433.     Std Cfg:    Charge  le fichier config par défaut S:ParM.cfg.  Pratique
  434.                 après exécution d'une commande CFG.
  435.     Cmd Mode:   Deux  modes  sont  disponibles.  Simple et Shell.  Le mode
  436.                 courant  est indiqué par une marque.  Ces modes concernent
  437.                 la  fonction  Command  ci-dessous.  En mode 'Simple', ParM
  438.                 restera  figé  (Busy)  tant  que votre command ne sera pas
  439.                 exécutée,  alors qu'en mode Shell, Command est asynchrone.
  440.                 Pour  cela,  un  shell est créé et votre (vos) commande(s)
  441.                 sont  mises dans un fichier script temporaire.  Les règles
  442.                 régissant ce mode sont identiques au mode SHELL du fichier
  443.                 de  configuration.   Si  vous  possédez WShell et que vous
  444.                 utilisez  PatchDOS,  vous  aurez  accès  aux ressources de
  445.                 WShell, c'est à dire alias, resident...
  446.     Command:    Permet d'exécuter une commande CLI. voir ci-dessus.
  447.     ChangeDir:  Change   le   répertoire  courant  de  ParM.   Toutes  les
  448.                 commandes  héritent  du  répertoire  courant  de ParM sauf
  449.                 celles lancées en mode WB.
  450.     Quit:       Pourquoi? ParM n'est il pas mignon!
  451.  
  452.  
  453. Commandes séparées:
  454.  
  455.   End:
  456.  
  457.     La  commande  End  permet  de  fermer un shell dans lequel un ParM est
  458.     attaché.   End a besoin de EndCLI pour fonctionner.  S'il n'y a pas de
  459.     ParM  attaché  au  shell, End fera seulement un EndCLI.  End et EndCLI
  460.     peuvent  être  mis résident pour une rapidité maximale.  Grace à cette
  461.     commande,   vous   pouvez   mettre  ParM  dans  votre  CLI-Startup  ou
  462.     Shell-Startup  pour  avoir  des  menus  dans chaque CLI/Shell, et vous
  463.     pourrez  les  fermer  à  l'aide  de End à la place de EndCLI sans vous
  464.     soucier  de  ParM.   Attention:   N'utilisez  pas  cette commande avec
  465.     WShell  car  il  n'accepte  que sa version 'Built-in' de EndCLI et End
  466.     charge le EndCLI du répertoire C:.
  467.  
  468.  
  469.   ParMCD:
  470.  
  471.     ParMCD  change  le  répertoire courant du ParM attaché au CLI courant.
  472.     Sans argument, ParM prendra le répertoire courant du CLI.  Vous pouver
  473.     spécifier  le  répertoire  en  argument  à ParMCD.  Cette commande est
  474.     pure, vous pouvez la mettre en résident.
  475.  
  476.  
  477.   WaitReturn:
  478.  
  479.     La commande WaitReturn est utilisée par défaut par la fonction Command
  480.     en  mode Shell.  Vous pouvez l'utiliser dans vos scripts.  Elle attend
  481.     que  l'utilisateur  appuie  sur  la touche return.  Cette commande est
  482.     pure, vous pouvez la mettre en résident.
  483.  
  484.  
  485. Limitations:
  486.  
  487.     Les  scripts  ne fonctionnent pas en mode ARUN.  Utilisez RUN ou SHELL
  488.     la place.
  489.  
  490.     Si une commande en mode RUN échoue, vous ne le saurez pas, si ce n'est
  491.     que vous ne la verrez pas fonctionner.  C'est un peu ennuyeux pour les
  492.     utilitaires qui ne se manifestent pas de manière visible à l'oeil.
  493.  
  494.     Quand  ParM  est attaché à un CLI, les commandes exécutées en mode RUN
  495.     ne  seront  pas détachées, c'est à dire que vous ne pourrez pas fermer
  496.     le  CLI  avant  que  ces commandes ne soient terminées.  C'est le même
  497.     problème que si vous aviez lancé votre commande avec la commande Run:
  498.             1> Run ma_commande
  499.     D'un  autre  coté,  ces commandes conservent la console comme fichiers
  500.     standards  d'entrée/sortie, et vous pouvez en tirer avantage.  Si vous
  501.     ne  voulez pas que votre CLI soit perturbé par l'affichage intempestif
  502.     de  ces  commandes,  vous  pouvez  les  rediriger  à NIL:  ou utiliser
  503.     l'option '-o'. Dans ce cas seulement, les commandes seront détachée de
  504.     votre CLI.
  505.  
  506.     ParM  ne  peut  être  mis  résident  qu'en  arp,  c'est à dire avec la
  507.     commande  arp  ARes.   Ceci parce que ParM n'est pas pure.  L'avantage
  508.     des résidents arp et que l'on peut savoir si le programme est résident
  509.     ou  pas.   S'il  est  résident, les variables globales sont dupliquées
  510.     pour  chaque processus ParM, ce qui n'est pas le cas s'il ne l'est pas
  511.     ou  s'il  est  en  résident  Commodore  ou  WShell.  Même si vous avez
  512.     WShell,  placez  ParM  en  arp résident avec ARes et lancez le avez la
  513.     version arp de la commande Run.
  514.  
  515.     En mode MyMenu,  si vous utilisez Command en mode Simple,  le workbench
  516.     sera inactif tant que vous n'aurez pas terminé.
  517.  
  518.  
  519. Bugs connues: (ou devrais-je dire boggues!)
  520.  
  521.     En mode SHELL, PRI n'est pas pris en compte. La priorité est toujours 0
  522.  
  523.  
  524. Projets d'amélioration:
  525.  
  526. -   Faire descendre la taille de l'exécutable en dessous de 2 K !!!
  527. -   Faire un seul mode Command asynchrone n'utilisant aucune commande  sur
  528.     disque.
  529.  
  530.  
  531. Historique:
  532.  
  533.     1.0:    Interne. Refonte de MyMenu.
  534.  
  535.     1.1:    Première version officielle. (Envoyée à Fred Fish)
  536.             Ancien mode CLI changé en RB (RunBack)
  537.             Nouveau mode CLI ajouté.
  538.             Syntaxe du fichier de configuration changée.
  539.  
  540.     1.4:    Interne. Options -l, -d, et WBRun améliorées.
  541.             Vous   pouvez   maintenant  lancer  des  projets  en  mode  WB
  542.             constitués  d'une  icône  seulement.   Ex:  Serial, Pointer et
  543.             Printer de répertoire Prefs.
  544.  
  545.     1.6:    Seconde version officielle. 29/09/90.
  546.             Code réarrangé.
  547.             Nouvelle option CFG ajoutée.
  548.             Nouvelle fonction 'Std cfg' ajoutée.
  549.  
  550.     1.7:    Interne.
  551.             N'utilise plus la c16.lib, mais les miennes à la place.
  552.             Taille du code diminuée de 1.5 K.
  553.  
  554.     2.0:    Troisième version officielle. 13/10/90.
  555.             ParM peut maintenant être mis résident.
  556.             Commande End crée.
  557.             Le path est indiqué dans Change Dir.
  558.  
  559.     2.1:    Commande ParMCD crée.
  560.     2.1r:   Cette version utilise la librairie req.library (r pour req!).
  561.  
  562.     2.2r:   Disparition  des  modes  RB  et  CLI.  les nouveaux modes sont
  563.             ARUN,  RUN  et  SHELL.
  564.             STACK  et  PRI  sont  optionnels  pour tous les modes sauf WB.
  565.             Plus  besoin de la commande Run du répertoire C:.
  566.             Les  erreurs  de  syntaxe  du  fichier  de  configuration sont
  567.             maintenant reportées sous forme de ligne, colonne.
  568.  
  569.     2.3r:   Disparition du message 'Workbench processes still active'.
  570.             ParM  crée  maintenant  un  MsgPort  public  pour les messages
  571.             workbench commun à tous les ParM, et le laisse si des messages
  572.             sont encore en attente quand vous quittez ParM.
  573.             Maintenant,  si  votre console possède un gadget de fermeture,
  574.             vous  pourrez  quitter  ParM en le cliquant.  Particulièrement
  575.             utile pour les heureux possesseurs de WShell.
  576.             Les caractères de valeur ascii > 127 sont supportés (accents).
  577.             WAITCMD ajouté.
  578.  
  579.     2.4r:   Mode WB réécrit. STACK et PRI optionnels dans tous le modes.
  580.             Le  mode  WB  ne plante plus si la commande n'est pas trouvée.
  581.             Vous  pouvez  maintenant  lancer  des programmes qui n'ont pas
  582.             d'icône.
  583.             La  mémoire  pour les menus est allouée par blocks de 1 K pour
  584.             diminuer la fragmentation de la mémoire.
  585.  
  586.     2.5r:   Options -s et -o ajoutées.
  587.             -s  est utile si ParM est résident car dans ce cas, la pile de
  588.             ParM  est toujours de 4000 octets, alors qu'il prend la taille
  589.             de  pile  du CLI normalement.  Comme les commandes lancées par
  590.             ParM  prennent  par  défaut la taille de pile de ParM, -s vous
  591.             permet  d'avoir une pile par défaut autre que 4000 octet quand
  592.             ParM est résident.
  593.  
  594.     2.51r:  Mise à jour mineure. Correction de quelques bugs.
  595.             ParM  ne  plante  plus  quand  lancé  depuis  le  workbench en
  596.             l'absence de l'arp.library.
  597.  
  598.     2.6r:   ParM est maintenant implementé en librairie. Cela permet a
  599.             BrowserII de profiter de la creation de menus paramétrables de
  600.             ParM. Installez "parm.library" dans LIBS:.
  601.             La fenêtre de ParM passe maintenant à l'avant plan si elle est
  602.             complètement recouverte par une autre fenêtre. (Option ajoutée
  603.             a la demande d'utilisateurs).
  604.  
  605.     2.7:    L'  option  -o  utilise maintenant le gestionnaire NULL:  à la
  606.             place  de  NIL:   si  possible.   Cela permet d'éviter que des
  607.             programmes  ouvrant  le  fichier "*" plantent si le CLI depuis
  608.             lequel  ParM a été lancé a été fermé.  Avec NULL:, le mode RUN
  609.             est  maintenant  sûr et devrait fonctionner dans tous les cas.
  610.             Si  NULL:  n'existe pas, NIL:  sera utilisé.
  611.             'r'  enlevé  de  la  version.   Une version n'utilisant pas la
  612.             req.library n'est plus planifiée.
  613.  
  614.     2.8:    Correction de quelques bugs.
  615.             Le qualifier pour les raccourcis-clavier rendu parametrable.
  616.  
  617.     2.9:    Implementation d'un input handler dans parm.library. Cela rend
  618.             possible  le  lancement d'une commande sans toucher la souris,
  619.             ou  d'activer  les menus sans prealablement activer la fenêtre
  620.             de ParM.
  621.  
  622.     3.0:    Suite  à  la demande d'utilisateurs, ParM peut maintenant être
  623.             rattaché au Workbench,  comme MyMenu.  (Code pris a MyMenu une
  624.             fois de plus). Desolé et Merci, Darin et John.
  625.             ParM  est  maintenant  compatible avec Console-Buffer.  Il y a
  626.             néanmoins une limitation.  Vous devez installer ParM APRES CB,
  627.             et vous ne devez pas quitter CB avant ParM.
  628.             Possibilité de mettre plusieurs commandes séparées par un ; en
  629.             mode RUN et dans Command comme en mode SHELL.
  630.  
  631.  
  632. Remerciements:
  633.  
  634.     La  première  version  de ParM (interne) était une refonte complète de
  635.     MyMenu de Darin Johnson.  Le problème était qu'il n'était pas possible
  636.     d'avoir  MyMenu sans le workbench, et que les programmes lancés depuis
  637.     MyMenu n'avaient pas de Path.
  638.     Un grand merci donc à Darin Johnson pour les allocations de menu et le
  639.     workbench  run.   L'idée  d'attacher des menus au CLI m'est venue d'un
  640.     ami   qui   avait  fait  un  programme  similaire  mais  peu  pratique
  641.     à configurer.
  642.  
  643.     Un  autre grand merci à Olaf 'Olsen' Barthel pour ses mises à jour des
  644.     startup  arp  pour l'aztec 5.0, code qui m'a servi à créer mes propres
  645.     libs.
  646.  
  647.     Merci  aussi  à  Colin  Fox  et  Bruce  Dawson  pour  leur fantastique
  648.     req.library.    Nous   encourageons   tous   les  programmeurs  et  en
  649.     particulier  professionnels  à utiliser cette librairie qui possède le
  650.     plus  beau  requester  de  fichier du monde, et une tonne de facilités
  651.     pour la gestion des petits requesters et des gadgets.
  652.  
  653.     Merci à Darin Johnson pour MyMenu.
  654.     Merci à William S. Hawes pour ARexx et WShell.
  655.     Merci à Pierre 'Zorglub' Ardichvili pour son aide.
  656.     Merci  à  CygnusSoft  et  ASDG  pour  leur fabuleux, génial, démoniac,
  657.     démentiel, extraordinaire, divin,...  éditeur de texte CygnusEd 2.
  658.  
  659.  
  660. Signature:
  661.  
  662.     S.R. & P.C.
  663.     Ce n'est pas Status Register et Program Counter mais
  664.     Sylvain Rougier & Pierre Carrette.
  665.  
  666.  
  667. Donnations:
  668.  
  669.     Ce  programme  n'est pas domaine public.  Ce programme est 'ShearWare'.
  670.     Si  vous  l'utilisez,  veuillez  envoyer  une donnation et/ou
  671.     constatation de bugs à:  Sylvain Rougier
  672.  
  673.         Coiffure W
  674.         39 rue Carnot
  675.         86000 Poitiers
  676.         France.
  677.  
  678.