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