home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0995.lha / ParM / ParM.DocF < prev    next >
Text File  |  1994-04-05  |  33KB  |  718 lines
  1.  
  2.  
  3. Documentation pour ParM V4.5, SetMouse V2.1, parm.library V10.2
  4.  
  5.  
  6. **************************************************************************
  7. ****************************               *******************************
  8. ****************************   ATTENTION   *******************************
  9. ****************************               *******************************
  10. **************************************************************************
  11.  
  12.     Si  vous  possΘdez  une  version antΘrieure de ParM, et des outils qui
  13. utilisent  la  parm.library,  vous DEVEZ remplacer TOUS ces outils par les
  14. nouvelles  version fournies ici.  La nouvelle parm.library version 7 n'est
  15. pas compatible avec les precedentes.  Ce n'Θtait pas possible.
  16. Comme  promis  dans  la  derniΦre version, ce nouveau ParM ne fonction que
  17. sous AmigaDOS 2.0 (V 37 ou plus).
  18. ParM n'a maintenant plus besoin des librairies arp et req. Merci le 2.0 !
  19.  
  20. **************************************************************************
  21. **************************************************************************
  22.  
  23.  
  24. ParM signifie Parametrable Menu.
  25.  
  26. ParM  vous  permet  de  construire  vos propres menus de maniΦre α pouvoir
  27. lancer  tous  les  programmes  de  votre choix.  ParM est particuliΦrement
  28. utile  si  vous possΘdez un disque dur avec des programmes situΘs dans les
  29. profondeurs des rΘpertoires.  Vous pourrez alors les lancer par une simple
  30. sΘlection  de menu et donc sans avoir besoin d'ouvrir tous les rΘpertoires
  31. succΘssifs aussi bien sous CLI que sous WorkBench.
  32. Avec  ParM, vous pouvez lancer vos programmes aussi bien en mode WorkBench
  33. qu'en  mode  CLI.   L'avantage du mode WorkBench est que le rΘpertoire par
  34. dΘfaut  de  votre  programme sera celui dans lequel le programme se situe.
  35. Mais tous les programmes ne peuvent Ωtre exΘcutΘs dans ce mode.
  36. ParM possΦde maintenant une SunMouse, Θconomiseur d'Θcran, accΘlΘrateur de
  37. souris...   Nous  avons  dΘcidΘ d'ajouter ceci α ParM car un input-handler
  38. Θtait  dΘjα  prΘsent  dans  la  parm.library,  cela  ne prendrait donc pas
  39. beaucoup de code suplΘmentaire, et nous avions 3 fenΩtres dans la barre de
  40. titre  du  workbench.  Une pour l'accΘlΘrateur, une pour la mΘmoire, et la
  41. fenΩtre inutile de ParM.  Maintenant, la fenΩtre de ParM est utile, et est
  42. plus facile α activer pour l'accΦs aux menus vu sa plus grande taille.
  43.  
  44.  
  45. Comment utiliser ParM:
  46. ----------------------
  47.     Si  vous lisez cette documentation sans savoir exactement ce dont vous
  48. avez besoin, vous avez de grandes chances de vous y perdre au vu du nombre
  49. de  possibilitΘs  offertes  par le paramΘtrage de ParM.  A la fin de cette
  50. documentation,  vous  trouverez une aide pour choisir un mode de lancement
  51. pour  chacune  de  vos  commandes suivant la version de KickStart que vous
  52. utilisez.
  53.  
  54.  
  55. Installation:
  56. -------------
  57.     Installez ParM et SetMouse avec leurs icones lα o∙ vous le dΘsirez, et
  58.     mettez  le fichier de configuration ParM.cfg dans le rΘpertoire S:  si
  59.     vous l'utilisez.  Sinon, vous devrez systΘmatiquement spΘcifier le nom
  60.     du  fichier  config  sur la ligne de commande ou dans les TOOLTYPES de
  61.     l'icone de ParM.  Dans le cas contraire, vous devrez rΘpondre l'alerte
  62.     signifiant  l'absence  de fichier config et vous n'aurez pas de menus.
  63.     Assurez vous bien d'avoir placΘ la parm.library dans votre LIBS:.
  64.  
  65.  
  66. ExΘcution:
  67. ----------
  68.     Il  est recommandΘ de lancer ParM depuis un CLI si vous voulez que vos
  69.     programmes aient un Path autre que le rΘpertoire courant et C:  ce qui
  70.     est le cas si vous le lancez depuis workbench.
  71.  
  72.     ParM peut fonctionner de trois maniΦres diffΘrentes:
  73.     1)  Vous  pouvez  attacher ParM α la fenΩtre du CLI que vous utilisez.
  74.         Dans ce cas, si vous ne spΘcifiez aucune des options concernant la
  75.         fenΩtre,  les  menus  seront  attachΘs  au  CLI depuis lequel vous
  76.         l'avez  lancΘ.  Il est prΘfΘrable alors de lancer avec la commande
  77.         Run  et non  Run >NIL:  pour  vous  empΩcher  de fermer le CLI par
  78.         inadvertance.
  79.     2)  ParM  peut  avoir  sa propre fenΩtre.  C'est toujours le cas quand
  80.         ParM  est  exΘcutΘ  depuis  WorkBench,  mais vous pouvez aussi lui
  81.         demander  d'ouvrir  sa fenΩtre quand vous le lancez depuis un CLI.
  82.         Pour  cela,  il  suffit  de  spΘcifier l'option OWNWINDOW ou toute
  83.         autre  option  ayant  rapport  avec  les  caractΘristiques  de  la
  84.         fenΩtre.   Dans  ce  cas,  vous devriez le lancer avec la commande
  85.         Run >NIL:  de maniΦre  α  pouvoir  fermer  le  CLI  par  la suite.
  86.  
  87.     3)  ParM peut Ωtre rattachΘ aux menus du Workbench, comme MyMenu.
  88.  
  89.  
  90.     ParM a des options accessibles aussi bien sous WorkBench que sous CLI.
  91.     La  documentation  des  arguments est maintenant incluse dans ParM lui
  92.     mΩme.   Entrez ParM ?, puis de nouveau ?.  Les arguments avec l'option
  93.     /s  sont  les interrupteurs (switches), et les arguments avec l'option
  94.     /k sont des mots-clΘ (keywords) et nΘcessitent un argument (un nombre,
  95.     ON ou OFF, un nom de fichier,...).
  96.     Depuis  le  workbench,  les mots-clΘ sont les mΩmes.  Vous devez juste
  97.     ajouter =TRUE pour les /s, ou =Argument pour les /k.
  98.  
  99.     CLIWINDOW n'est pas disponible sous workbench.
  100.  
  101.     Aide CLI de ParM:
  102.  
  103. MYMENU/S,CLIWINDOW/S,OWNWINDOW/S,LEFTEDGE/K/N,TOPEDGE/K/N,DETAILPEN/K/N,BLOCKPEN/K/N,
  104. DRAGBAR/K,DEPTH/K,AUTOFRONT/K,SHOWMEM/K,SHOWTIME/K,REFRESHTIME/K/N,MTDETAILPEN/K/N,
  105. MTBLOCKPEN/K/N,MENUCOLOR/K/N,STACKSIZE/K/N,CONFIGFILE/K,USENULL/K: ?
  106.  
  107. ParM V4.2 ⌐ 1990-92 by S.R. & P.C.
  108. MYMENU            Rattache ParM au Workbench. (Comme MyMenu !)
  109. CLIWINDOW         Attache les menus α la fenΩtre CLI/Shell.
  110. OWNWINDOW         Ouvre sa propre fenΩtre
  111. LEFTEDGE          Position horizontale de la fenΩtre (dΘfaut 0)
  112. TOPEDGE           Position verticale de la fenΩtre (dΘfaut 0)
  113. DETAILPEN         Couleur du texte de la fenΩtre (dΘfaut 1)
  114. BLOCKPEN          Couleur de fond de la fenΩtre (dΘfaut 2)
  115. DRAGBAR   ON|OFF  FenΩtre dΘplaτable ou non (defaut: on)
  116. DEPTH     ON|OFF  Gadgets de profondeur (defaut off)
  117. AUTOFRONT ON|OFF  La fenΩtre passe devant dΦs quelle est cachΘe (defaut: on)
  118. SHOWMEM   ON|OFF  Affiche la mΘmoire disponible (defaut off)
  119. SHOWTIME  ON|OFF  Affiche l'heure. (defaut off)
  120. REFRESHTIME       Intervalle de temps pour l'affichage de l'Heure/Memoire (multiple de 0.1s: defaut 1s)
  121. MTDETAILPEN       Couleur du texte pour Memoire/Heure (defaut: DetailPen)
  122. MTBLOCKPEN        Couleur de fond pour Memoire/Heure (defaut: BlockPen)
  123. MENUCOLOR         Couleur du menu principal (default: DetailPen)
  124. STACKSIZE         Taille de la pile par dΘfaut pour les commandes (default: taille de la pile de ParM)
  125. CONFIGFILE        Fichier de configuration (defaut: S:ParM.cfg)
  126. USENULL   ON|OFF  Redirige les entrΘes/sorties des commandes α NULL: (ou NIL:) (defaut: off)
  127.  
  128.  
  129. Variable d'environnement ParMOpt:
  130. ---------------------------------
  131.     En  plus de la ligne de commande, vos paramΦtres prΘfΘrΘs peuvent Ωtre
  132.     mis   dans  la  variable  d'environnement  Env:ParMOpt.   Vous  n'avez
  133.     recopier  tel  quel  vos  arguments  dans  un Θditeur de texte sur une
  134.     ligne,  et  sauvegarder  ce  fichier  sous  le nom de Env:ParMOpt.  Ce
  135.     fichier  sera  alors  examinΘ  en  premier,  et  les  arguments CLI ou
  136.     WorkBench   ensuite,  lesquels  pouront  annuler  un  argument  de  la
  137.     variable.
  138.  
  139.  
  140. Fichier de configuration:
  141. -------------------------
  142.     Vous   comprendrez   mieux  ce  qui  va  suivre  avec  le  fichier  de
  143.     configuration fourni sous les yeux.
  144.  
  145.     Un  fichier  de  configuration ressemble α un programme structurΘ.  Il
  146.     est  recommandΘ  d'indenter  les  lignes  pour rendre ce fichier aussi
  147.     lisible  que possible.  Le fichier de configuration par dΘfaut doit se
  148.     trouver  dans le rΘpertoire S:  et nommΘ ParM.cfg.  Ce fichier dΘfinit
  149.     les  menus  que  vous  dΘsirez  et les commandes correspondantes.  Les
  150.     commentaires commencent avec un '#' et continuent jusqu'α la fin de la
  151.     ligne.  Les majuscules/minuscules ne sont pas distinguΘes.
  152.  
  153.  
  154.     Mots clΘs:
  155.     ----------
  156.  
  157.     CMDWIN  console
  158.  
  159.         Cette  commande redΘfinira la console par dΘfaut utilisΘe par ParM
  160.         ("CON:0000/0011/0640/0100/Command window/AUTO/CLOSE/WAIT") pour la
  161.         fonction  Command.   Peut  Ωtre placΘ n'importe o∙ dans le fichier
  162.         mais  il  vaut  mieux  le mettre au dΘbut.  Cette console sous 2.0
  163.         aura  un  gadget de fermeture (CLOSE), une ouverture diffΘrΘe α la
  164.         premiΦre  Θcriture  (AUTO),  et  attendra que vous cliquiez sur le
  165.         close-gadget avant de se refermer.
  166.         Attention: sous 2.0, si vous utilisez Command en mode Simple, vous
  167.         DEVEZ  ajouter l'option /WAIT α votre console ou elle se refermera
  168.         α la fin avant que vous ayez eu le temps de lire les resultats.
  169.  
  170.     SHELLWIN  console
  171.  
  172.         Cette  commande redΘfinira la console par dΘfaut utilisΘe par ParM
  173.         ("CON:0000/0011/0640/0100/Shell/CLOSE") pour les commandes en mode
  174.         SHELL sans spΘcification de fenΩtre.  Peut Ωtre placΘ n'importe o∙
  175.         dans le fichier mais il vaut mieux le mettre au dΘbut.
  176.  
  177.     SHORTCUTQUAL qual
  178.  
  179.         Ceci   permet  d'ajouter  une  ou  plusieurs  touche  d'acces  aux
  180.         raccourci-clavier  pour les menus.  Par exemple Amiga-gauche, ALT,
  181.         ou encore SHIFT ou Control. Si vous desirez plusieurs possibilitΘs
  182.         vous pouvez ajouter les codes si dessous.
  183.         Liste des codes:
  184.             SHIFT gauche    1
  185.             SHIFT droit     2
  186.             CONTROL         8
  187.             ALT gauche      16
  188.             ALT droit       32
  189.             Amiga gauche    64
  190.  
  191.         Si par exemple vous desirez que les deux touches ALT puissent vous
  192.         servir de touche raccourci, faites:         ( 16 + 32 = 48 ! )
  193.             SHORTCUTQUAL 48
  194.  
  195.         Si  vous  desirez  des  raccourcis sans qualifier, (lettre seule),
  196.         vous pouvez utiliser  32768  (IEQUALIFIER_RELATIVEMOUSE),  qui est
  197.         toujours  present dans les Θvennements de type RAWKEY. (Attention,
  198.         a utiliser avec prΘcaution).
  199.         Ceci  ne marche que si ParM a sa propre fenΩtre ou est rattachΘ au
  200.         Workbench, mais ne marche pas dans un CLI.
  201.  
  202.  
  203.     ACTIVATEKEY [SCREENTOFRONT] [PASSTHROUGH] [NOCHECK] qualifier rawkey
  204.  
  205.         Ceci permet de dΘfinir un "Hot-Key" pour ParM ou plus gΘnΘralement
  206.         pour  tout  programme qui utilise les menus de la parm.library, et
  207.         donc "The great BrowserII" !
  208.         Attention, rawkey est le code de touche du clavier, et non pas le
  209.         code ascii du caractΦre gΘnΘrΘ par la touche.
  210.         Comme  son  nom  l'indique,  ceci  une  sΘquence de touches qui va
  211.         activer la fenΩtre de ParM, et ceci avec trois options.
  212.  
  213.         Pour expΘrimenter les codes qui passent dans le handler, installez
  214.         la version 'debug' de la librairie dans LIBS:.
  215.         MΘthode:
  216.             Assurez vous que parm.library ne soit pas en mΘmoire (Rebooter
  217.             si nΘcessaire).
  218.             Copy parm.library.debug libs:parm.library
  219.             Run ParM -w
  220.         Une fenΩtre affiche alors dans l'ordre:
  221.             Class  SubClass  Code  Qualifier.
  222.         Ces codes sont en hexadΘcimal et seuls Code et Qualifier vous sont
  223.         utiles. Vous devez les transformer en dΘcimal pour ParM.
  224.         Une  fois  les  infos  recueillies, rΘinstallez la version normale
  225.         de la parm.library.
  226.  
  227.         Options:
  228.             1. SCREENTOFRONT
  229.                 L'Θcran qui contient la fenΩtre de  ParM  passera en avant
  230.                 plan.
  231.             2. PASSTHROUGH
  232.                 Ceci  risque  d'Ωtre  un peu dΘlicat α comprendre pour les
  233.                 non-programmeurs.   Disons  que  si  vous ne spΘcifiez pas
  234.                 cette option, la sΘquence n'aura pour action que d'activer
  235.                 la  fenΩtre.  Si vous la mettez, la fenΩtre que vous venez
  236.                 d'activer  recevra  la  sΘquence  de  touche,  et si cette
  237.                 sΘquence  correspond  α  un  raccourci  clavier d'un menu,
  238.                 l'option  de  menu  sera  exΘcutΘe.   Ceci  est  donc trΦs
  239.                 puissant  puisque  bien  paramΘtrΘ,  cela  vous  permet de
  240.                 lancer  un  programme grace a ParM sans toucher la souris,
  241.                 mΩme si la fenΩtre de ParM n'est pas active.
  242.  
  243.                 Exemple:
  244.                 
  245.                     SHORTCUTQUAL 64                 (Amiga gauche)
  246.                     ACTIVATEKEY PASSTHROUGH 64 50   (Amiga gauche - X)
  247.  
  248.                     Menu System
  249.                         Item {X} Xoper RUN Xoper
  250.  
  251.                     Ceci permet de lancer Xoper α tout moment sans toucher
  252.                     ni la souris, ni ParM.
  253.  
  254.                 Autre exemple:
  255.  
  256.                     # Left ALT - Right Mouse Button
  257.                     ACTIVATEKEY PASSTHROUGH SCREENTOFRONT 8208 105
  258.  
  259.                     Ceci active la fenΩtre ParM, et les Menus. Essayez.
  260.                     Plus besoin d'aller cliquer dans la petite fenΩtre.
  261.  
  262.             3. NOCHECK
  263.                 La  librarie  maintient  une  liste des "Hot-Keys".  Quand
  264.                 vous  ajoutez  un  Hot-Key,  ParM controle qu'il n'est pas
  265.                 dΘjα utilisΘ.  Si c'est le cas, vous en serez averti et il
  266.                 ne  sera pas pris en compte.  Si vous spΘcifez NOCHECK, il
  267.                 sera  systΘmatiquement  installΘ  en  tΩte  de liste, sans
  268.                 contr⌠le, et sera prioritaire sur l'ancien.
  269.                 Ceci  me  permet la chose suivante:  Un Hot-Key de ParM me
  270.                 charge  BrowserII.  Le mΩme Hot-Key est dΘclarΘ en NOCHECK
  271.                 dans BrowserII.menu.
  272.                 Ceci  a  l'effet suivant:  Si BrowserII est chargΘ, il est
  273.                 activΘ  et  son Θcran passe en avant plan.  sinon, ParM le
  274.                 charge.
  275.  
  276.                 ParM.cfg :
  277.  
  278.                     SHORTCUTQUAL 64
  279.  
  280.                     # Left Amiga - Z   (Load BrowserII)
  281.                     ACTIVATEKEY PASSTHROUGH 64 49
  282.  
  283.                     menu Tools
  284.                         item {Z} BrowserII      RUN HD:Tools/BrowserII
  285.  
  286.                 BrowserII.menu :
  287.  
  288.                     SHORTCUTQUAL 64
  289.  
  290.                     # Left Amiga - Z
  291.                     ACTIVATEKEY SCREENTOFRONT NOCHECK 64 49
  292.  
  293.  
  294.     COLOR  n
  295.  
  296.         AprΦs  cette instruction, les menus seront de la couleur n.  Cette
  297.         couleur  est  par  dΘfaut  la  couleur  d'avant plan de la fenΩtre
  298.         (detail  pen).  Si vous demandez la couleur de fond, alors ParM la
  299.         remplacera par la couleur du detail pen.
  300.  
  301.     MENU  nom_du_menu
  302.  
  303.         CrΘΘ  un nouveau menu.  Chaque menu doit contenir au moins un item
  304.         ou un sousmenu.
  305.  
  306.     SUBMENU  nom_du_sousmenu
  307.  
  308.         CrΘΘ  un nouveau sousmenu.  Chaque sousmenu doit contenir au moins
  309.         un item et ne peut avoir de sousmenu.
  310.         Chaque SUBMENU doit se terminer par un ENDSUBMENU
  311.  
  312.     ENDSUBMENU
  313.  
  314.         voir SUBMENU.
  315.  
  316.  
  317.     ITEM [{raccourci-clavier}] nom_de_l_item [WBTF] [REQUEST] definition_de_la_commande
  318.  
  319.         Definit  une  nouvelle  entrΘe  de menu.  Chaque definition 'item'
  320.         doit  avoir  un  nom  d'item et une commande associΘe.  L'item est
  321.         ajoutΘ  au menu ou sousmenu courant.  Un ENDSUBMENU indique α ParM
  322.         la  fin  du sousmenu courant et d'ajouter le prochain item au menu
  323.         courant  plut⌠t  qu'au  sousmenu.   Un raccourci-clavier optionnel
  324.         peut  Ωtre  indiquΘ  entre  {}.   WBTF  est aussi optionnel.  Cela
  325.         permet  de  faire  passer  l'Θcran  du  workbench  devant pour les
  326.         programmes lancΘs depuis BrowserII et qui ouvrent une fenΩtre dans
  327.         l'Θcran  du  workbench.   REQUEST  est  aussi optionnel.  Ouvre un
  328.         requester  dans  lequel  vous pouvez modifier la commande avant de
  329.         l'executer.  La syntaxe d'une commande est definie dessous.
  330.  
  331.         definition_de_la_commande
  332.  
  333.             Les  programmes  peuvent  Ωtre lancΘs de 3 faτons diffΘrentes:
  334.             RUN,  SHELL,  et WB.  Pour tous les modes, STACK (pile) et PRI
  335.             sont optionnels.  Si la pile est < 4000 octets, la taille sera
  336.             celle  de la pile de ParM, c'est α dire, la pile par dΘfaut du
  337.             cli  au moment o∙ ParM a ΘtΘ lancΘ.  Il y a une exception:  si
  338.             ParM  est  rΘsident,  la  pile  de  ParM sera toujours de 4000
  339.             octets.
  340.  
  341.  
  342.             2) syntaxe RUN
  343.  
  344.             RUN [WIN console] [STACK n] [PRI n] commande [args][;commande [args]]...
  345.  
  346.             Ce  mode  lance la commande en background shell.  Ce mode doit
  347.             Ωtre  utilisΘ  pour les scripts.  Si le bit s de votre fichier
  348.             script est mis, il sera exΘcutΘ automatiquement (Pas besoin de
  349.             la  commande  Execute).  Dans ce mode, les commandes ne seront
  350.             pas  dΘtachΘes  si  ParM  est attachΘ α un CLI, sauf si vous
  351.             utilisez l'option USENULL.
  352.             Vos commandes peuvent Ωtre redirigΘes dans ce mode.
  353.             Vous pouvez mettre plusieurs commandes sΘparΘes par des ;
  354.             Ce mode fonctionne maintenant en 2.0,  cherche  les programmes
  355.             dans la liste des rΘsidents Commodore (en 2.0) et permet aussi
  356.             l'utilisation d'une console (celle-ci est ignorΘe en 1.3).
  357.  
  358.  
  359.             3) syntaxe SHELL
  360.  
  361.             SHELL [WIN console] [STACK n] [PRI n] commande [args][;commande [args]]...
  362.  
  363.             Ce  mode  est maintenant identique au mode RUN, exceptΘ que si
  364.             aucune  fenΩtre  n'est  spΘcifiΘe, la fenΩtre shell par defaut
  365.             (SHELLWIN) est utilisΘe.
  366.  
  367.  
  368.             WB [STACK n] [PRI n] commande
  369.  
  370.             Lance  la  commande  en  mode  WorkBench,  comme si vous aviez
  371.             cliquΘ  sur  son ic⌠ne.  Attention, si vous spΘcifiez une pile
  372.             (STACK)  ici,  elle  prendra  le pas sur la pile indiquΘe dans
  373.             l'ic⌠ne.   Votre  commande  risque  donc  de  planter  si vous
  374.             utilisez une pile trop petite.  Sachez ce que vous faεtes.
  375.  
  376.  
  377.             5) option CFG
  378.  
  379.             CFG Fichier_de_Configuration
  380.  
  381.             ParM  charge  le  fichier de configuration comme si vous aviez
  382.             fait  Open  dans  le menu ParM et sΘlectionnΘ ce mΩme fichier.
  383.             TrΦs  utile  pour utiliser des fichiers config sur des disques
  384.             diffΘrents pour choisir les programmes de ces disques.
  385.  
  386.     BARLABEL
  387.  
  388.         Ajoute une barre entre le dernier item et le prochain.
  389.  
  390.  
  391.     Dans tous les modes α l'exception de WB, la commande est cherchΘe dans
  392.     la  liste des programmes rΘsident puis dans le Path actif au moment ou
  393.     ParM  a  ΘtΘ  lancΘ.   Pour  connaεtre  ce Path, il suffit d'entrer la
  394.     commande  Path  dans le requester de la fonction Command du menu ParM,
  395.     ou d'ouvrir un shell depuis ParM, et de tapper la commande Path.
  396.  
  397.     Un fichier de configuration est donnΘ en exemple.
  398.  
  399.  
  400. Commandes du menu ParM.
  401.  
  402.     Open:       Ouvre le sΘlecteur de fichier pour selectionner le fichier
  403.                 α charger.
  404.     Update:     Met  α  jour  les  menus  en  rechargeant  le  fichier  de
  405.                 configuration  courant.   Utile si vous avez mofifiΘ votre
  406.                 fichier config pendant que ParM tourne.
  407.     Std Cfg:    Charge  le fichier config par dΘfaut S:ParM.cfg.  Pratique
  408.                 aprΦs exΘcution d'une commande CFG.
  409.                 utilisez  PatchDOS,  vous  aurez  accΦs  aux ressources de
  410.     Command:    Permet  d'exΘcuter  une  commande  CLI.  Votre CMDWIN doit
  411.                 avoir l'option  /Wait  pour que vous ayez le temps de lire
  412.                 son contenu.
  413.     ChangeDir:  Change   le   rΘpertoire  courant  de  ParM.   Toutes  les
  414.                 commandes  hΘritent  du  rΘpertoire  courant  de ParM sauf
  415.                 celles lancΘes en mode WB.
  416.     Quit:       Pourquoi? ParM n'est il pas mignon!
  417.  
  418.  
  419. Commandes sΘparΘes:
  420. -------------------
  421.   End:
  422.  
  423.     La  commande  End  permet  de  fermer un shell dans lequel un ParM est
  424.     attachΘ.   End a besoin de EndCLI pour fonctionner.  S'il n'y a pas de
  425.     ParM  attachΘ  au  shell, End fera seulement un EndCLI.  End et EndCLI
  426.     peuvent  Ωtre  mis rΘsident pour une rapiditΘ maximale.  Grace α cette
  427.     commande,   vous   pouvez   mettre  ParM  dans  votre  CLI-Startup  ou
  428.     Shell-Startup  pour  avoir  des  menus  dans chaque CLI/Shell, et vous
  429.     pourrez  les  fermer  α  l'aide  de End α la place de EndCLI sans vous
  430.     soucier  de  ParM.   Attention:   N'utilisez  pas  cette commande avec
  431.     WShell  car  il  n'accepte  que sa version 'Built-in' de EndCLI.
  432.  
  433.  
  434.   ParMCD:
  435.  
  436.     ParMCD  change  le  rΘpertoire courant du ParM attachΘ au CLI courant.
  437.     Sans argument, ParM prendra le rΘpertoire courant du CLI.  Vous pouver
  438.     spΘcifier  le  rΘpertoire  en  argument  α ParMCD.  Cette commande est
  439.     pure, vous pouvez la mettre en rΘsident.
  440.  
  441.  
  442.   Remarqque:
  443.   ----------
  444.     Ces  commandes ne fonctionnent pas si vous utilisez DHOpts.  DHOpts ne
  445.     supporte  pas  le  packet  ACTION_DISK_INFO  quand ParM a installΘ ses
  446.     menus dans la console.  Ce n'est pas un bug de ParM.
  447.  
  448.  
  449. Limitations:
  450. ------------
  451.     Si une commande en mode RUN Θchoue, vous ne le saurez pas, si ce n'est
  452.     que vous ne la verrez pas fonctionner.  C'est un peu ennuyeux pour les
  453.     utilitaires qui ne se manifestent pas de maniΦre visible α l'oeil.
  454.  
  455.     Quand  ParM  est attachΘ α un CLI, les commandes exΘcutΘes en mode RUN
  456.     ne  seront  pas dΘtachΘes, c'est α dire que vous ne pourrez pas fermer
  457.     le  CLI  avant  que  ces commandes ne soient terminΘes.  C'est le mΩme
  458.     problΦme que si vous aviez lancΘ votre commande avec la commande Run:
  459.             1> Run ma_commande
  460.     D'un  autre  cotΘ,  ces commandes conservent la console comme fichiers
  461.     standards  d'entrΘe/sortie, et vous pouvez en tirer avantage.  Si vous
  462.     ne  voulez pas que votre CLI soit perturbΘ par l'affichage intempestif
  463.     de  ces  commandes,  vous  pouvez  les  rediriger  α NIL:  ou utiliser
  464.     l'option USENULL. Dans ce cas seulement, les commandes seront dΘtachΘe
  465.     de votre CLI.
  466.  
  467.  
  468. Bugs connues: (ou devrais-je dire boggues!)
  469.  
  470.     En mode SHELL, PRI n'est pas pris en compte. La prioritΘ est toujours 0
  471.  
  472.  
  473. Projets d'amΘlioration:
  474.  
  475. -   Localisation. (Francisation en particulier!).
  476.  
  477.  
  478. Historique:
  479.  
  480.     1.0:    Interne. Refonte de MyMenu.
  481.  
  482.     1.1:    PremiΦre version officielle. (EnvoyΘe α Fred Fish)
  483.             Ancien mode CLI changΘ en RB (RunBack)
  484.             Nouveau mode CLI ajoutΘ.
  485.             Syntaxe du fichier de configuration changΘe.
  486.  
  487.     1.4:    Interne. Options -l, -d, et WBRun amΘliorΘes.
  488.             Vous   pouvez   maintenant  lancer  des  projets  en  mode  WB
  489.             constituΘs  d'une  ic⌠ne  seulement.   Ex:  Serial, Pointer et
  490.             Printer de rΘpertoire Prefs.
  491.  
  492.     1.6:    Seconde version officielle. 29/09/90.
  493.             Code rΘarrangΘ.
  494.             Nouvelle option CFG ajoutΘe.
  495.             Nouvelle fonction 'Std cfg' ajoutΘe.
  496.  
  497.     1.7:    Interne.
  498.             N'utilise plus la c16.lib, mais les miennes α la place.
  499.             Taille du code diminuΘe de 1.5 K.
  500.  
  501.     2.0:    TroisiΦme version officielle. 13/10/90.
  502.             ParM peut maintenant Ωtre mis rΘsident.
  503.             Commande End crΘe.
  504.             Le path est indiquΘ dans Change Dir.
  505.  
  506.     2.1:    Commande ParMCD crΘe.
  507.     2.1r:   Cette version utilise la librairie req.library (r pour req!).
  508.  
  509.     2.2r:   Disparition  des  modes  RB  et  CLI.  les nouveaux modes sont
  510.             ARUN,  RUN  et  SHELL.
  511.             STACK  et  PRI  sont  optionnels  pour tous les modes sauf WB.
  512.             Plus  besoin de la commande Run du rΘpertoire C:.
  513.             Les  erreurs  de  syntaxe  du  fichier  de  configuration sont
  514.             maintenant reportΘes sous forme de ligne, colonne.
  515.  
  516.     2.3r:   Disparition du message 'Workbench processes still active'.
  517.             ParM  crΘe  maintenant  un  MsgPort  public  pour les messages
  518.             workbench commun α tous les ParM, et le laisse si des messages
  519.             sont encore en attente quand vous quittez ParM.
  520.             Maintenant,  si  votre console possΦde un gadget de fermeture,
  521.             vous  pourrez  quitter  ParM en le cliquant.  ParticuliΦrement
  522.             utile pour les heureux possesseurs de WShell.
  523.             Les caractΦres de valeur ascii > 127 sont supportΘs (accents).
  524.             WAITCMD ajoutΘ.
  525.  
  526.     2.4r:   Mode WB rΘΘcrit. STACK et PRI optionnels dans tous le modes.
  527.             Le  mode  WB  ne plante plus si la commande n'est pas trouvΘe.
  528.             Vous  pouvez  maintenant  lancer  des programmes qui n'ont pas
  529.             d'ic⌠ne.
  530.             La  mΘmoire  pour les menus est allouΘe par blocks de 1 K pour
  531.             diminuer la fragmentation de la mΘmoire.
  532.  
  533.     2.5r:   Options -s et -o ajoutΘes.
  534.             -s  est utile si ParM est rΘsident car dans ce cas, la pile de
  535.             ParM  est toujours de 4000 octets, alors qu'il prend la taille
  536.             de  pile  du CLI normalement.  Comme les commandes lancΘes par
  537.             ParM  prennent  par  dΘfaut la taille de pile de ParM, -s vous
  538.             permet  d'avoir une pile par dΘfaut autre que 4000 octet quand
  539.             ParM est rΘsident.
  540.  
  541.     2.51r:  Mise α jour mineure. Correction de quelques bugs.
  542.             ParM  ne  plante  plus  quand  lancΘ  depuis  le  workbench en
  543.             l'absence de l'arp.library.
  544.  
  545.     2.6r:   ParM est maintenant implementΘ en librairie. Cela permet a
  546.             BrowserII de profiter de la creation de menus paramΘtrables de
  547.             ParM. Installez "parm.library" dans LIBS:.
  548.             La fenΩtre de ParM passe maintenant α l'avant plan si elle est
  549.             complΦtement recouverte par une autre fenΩtre. (Option ajoutΘe
  550.             a la demande d'utilisateurs).
  551.  
  552.     2.7:    L'  option  -o  utilise maintenant le gestionnaire NULL:  α la
  553.             place  de  NIL:   si  possible.   Cela permet d'Θviter que des
  554.             programmes  ouvrant  le  fichier "*" plantent si le CLI depuis
  555.             lequel  ParM a ΘtΘ lancΘ a ΘtΘ fermΘ.  Avec NULL:, le mode RUN
  556.             est  maintenant  s√r et devrait fonctionner dans tous les cas.
  557.             Si  NULL:  n'existe pas, NIL:  sera utilisΘ.
  558.             'r'  enlevΘ  de  la  version.   Une version n'utilisant pas la
  559.             req.library n'est plus planifiΘe.
  560.  
  561.     2.8:    Correction de quelques bugs.
  562.             Le qualifier pour les raccourcis-clavier rendu parametrable.
  563.  
  564.     2.9:    Implementation d'un input handler dans parm.library. Cela rend
  565.             possible  le  lancement d'une commande sans toucher la souris,
  566.             ou  d'activer  les menus sans prealablement activer la fenΩtre
  567.             de ParM.
  568.  
  569.     3.0:    Suite  α  la demande d'utilisateurs, ParM peut maintenant Ωtre
  570.             rattachΘ au Workbench,  comme MyMenu.  (Code pris a MyMenu une
  571.             fois de plus). DesolΘ et Merci, Darin et John.
  572.             ParM  est  maintenant  compatible avec Console-Buffer.  Il y a
  573.             nΘanmoins une limitation.  Vous devez installer ParM APRES CB,
  574.             et vous ne devez pas quitter CB avant ParM.
  575.             PossibilitΘ de mettre plusieurs commandes sΘparΘes par un ; en
  576.             mode RUN et dans Command comme en mode SHELL.
  577.  
  578.     3.1:    Correction d'erreur dans les coordonnΘes de menu workbench.
  579.  
  580.     3.2:    PremiΦre version du SunMouse/AccΘlΘrateur de souris...
  581.  
  582.     3.3:    Input-Handler rΘΘcrit. Appels α intuition fait depuis une tache
  583.             sΘparΘe (pour Θviter les 'dead-locks').
  584.  
  585.     3.4:    L'input handler et le mode RUN fonctionnent maintenant sous 2.0
  586.             Modes video VGA et SuperHiRes pas encore gΘrΘs.
  587.             La commande shell par dΘfaut et maintenant NewShell (pour le 2.0)
  588.             Les consoles par defaut ont des spΘcifications 2.0.
  589.             Command en mode Simple est asynchore et gΦre les input et CTRL-C
  590.             correctement.
  591.             SetMouse V1.1. Ajout d'un Qualifier optionnel supplΘmentaire
  592.             pour les 'Window To Front'.
  593.  
  594.     3.5:    Correction d'erreur. (incompatibilitΘ entre USENULL et CLIWINDOW).
  595.  
  596.     3.6:    Correction d'erreur en dΘmarrage workbench.
  597.             ParM peut maintenant Ωtre attachΘ au workbench 2.0.
  598.             Vous n'avez plus besoin de NULL: sous 2.0.
  599.             En 2.0, vous pouvez utiliser une console pour le mode RUN.
  600.  
  601.     4.0:    Interne. PremiΦre version spΘcifique pour le 2.0.
  602.             Plus besoin des libraries arp et req.
  603.             Le handler de SetMouse gΦre toutes le rΘsolutions d'Θcran.
  604.             La parm.library n'est pas compatible avec les prΘcΘdentes.
  605.             SHELLCMD, WAITCMD, TMPDIR supprimΘes. Supprimez les de votre
  606.             config actuelle.
  607.             Plus besoin de la commande WaitReturn, avec l'option /Wait des CON:
  608.             ParM ne peux plus Ωtre rΘsident. Qui l'utilisait ?
  609.  
  610.     4.1:    PossibilitΘ d'insertion de BarLabel dans les menus.
  611.             Correction d'erreur dans la gestion des accents. Plus besoin de
  612.             guillemets.
  613.  
  614.     4.2:    Ajout des options REQUEST et WBTF.
  615.             Correction d'erreurs:
  616.                 Tags pour NewCreateProc() identiques au Workbench dans WBRun().
  617.                     (More 37.4 plantait en mode WB).
  618.                 Input Handler initialisΘ dans la ParMHandlerTask.
  619.                 Argument cli CONFIGFILE/K ne fonctionnait pas.
  620.                 Arguments cli numΘriques passΘs en /N
  621.             PremiΦre version spΘciale AmigaDOS 2.0.
  622.  
  623.     4.3:    LocalisΘe, donc en Franτais.
  624.  
  625.     4.4:    GΦre la Pile spΘcifiΘe dans les ic⌠nes Projet.
  626.             Nouvelle option NEWLOOKMENUS pour AmigaDOS 3.0. Ceci enleve
  627.             la possibilite de personnaliser les couleurs des menuitems,
  628.             mais amΘliore l'affichage inverse-video pour les ecrans ayant
  629.             plus de 8 couleurs.
  630.  
  631.     4.5:    SHOWMEM affiche la ram disponible de la carte 24 bits Retina
  632.             si vous en avez une! :-)
  633.  
  634.     4.6:    ParM conserve le Path meme lance depuis le workbench. Vous
  635.             pouvez donc maintenant le mettre dans votre rΘpertoire
  636.             WBStartup sans perdre le Path.
  637.             RecompilΘ avec le SAS 6.50.
  638.  
  639.  
  640. Comment utiliser ParM:
  641. ----------------------
  642.         Maintenant que vous avez lu tout ce dont ParM Θtait capable, je
  643.     pense que vous aimeriez savoir quel mode de lancement vous devez
  644.     utiliser pour vos diffΘrents programmes.
  645.  
  646.     PremiΦrement, quand vous voulez ajouter une entrΘe de menu, vous
  647.     devez savoir:
  648.  
  649.     1) Votre programme peut-it Ωtre lancer sous workbench ?
  650.     2) Voulez vous que votre programme hΘrite du directory courant de ParM
  651.        ou doit-il avoir le sien ?
  652.     3) Votre programme doit-il avoir un Path ?
  653.     4) Votre programme a-t-il besoin d'une console ?
  654.  
  655.  
  656.     KickStart 2.0:
  657.     --------------
  658.         Les modes ARUN et SHELL sont obsolΦtes en 2.0.
  659.         Le choix entre les modes RUN et WB est donc simple.
  660.         Si vous avez besoin d'un path ou d'une console, utilisez le mode RUN.
  661.         Sinon, vous pouvez utiliser le mode WB.
  662.  
  663.  
  664. SetMouse:
  665. ---------
  666.     SetMouse s'emploie sans difficultΘs particuliΦres. Tous les utilitaires
  667.     de ce genre fonctionnent de la mΩme maniΦre.
  668.  
  669.     WToFront Qual:
  670.         Touche α maintenir pendant le double-click pour que la fenΩtre
  671.         passe devant.
  672.     
  673.     L'Θconomiseur d'Θcran coupe la DMA. La prioritΘ du handler peut Ωtre
  674.     modifiΘe en cas de problΦme de compatibilitΘ avec d'autres. Celle-ci
  675.     ne sera prise en compte qu'au prochain chargement de la library, c'est
  676.     α dire au prochain reset.
  677.  
  678.     Remarque: Les options de souris seront actives tant que la parm.library
  679.     aura au moins un utilisateur (BrowserII, ParM, ou SetMouse actuellement).
  680.  
  681.  
  682. Remerciements:
  683. --------------
  684.     La  premiΦre  version  de ParM (interne) Θtait une refonte complΦte de
  685.     MyMenu de Darin Johnson.  Le problΦme Θtait qu'il n'Θtait pas possible
  686.     d'avoir  MyMenu sans le workbench, et que les programmes lancΘs depuis
  687.     MyMenu n'avaient pas de Path.
  688.     Un grand merci donc α Darin Johnson pour les allocations de menu et le
  689.     workbench  run.   L'idΘe  d'attacher des menus au CLI m'est venue d'un
  690.     ami   qui   avait  fait  un  programme  similaire  mais  peu  pratique
  691.     α configurer.
  692.  
  693.     Merci α Darin Johnson pour MyMenu.
  694.     Merci α William S. Hawes pour ARexx et WShell.
  695.     Merci α Pierre 'Zorglub' Ardichvili pour son aide.
  696.     Merci  α  CygnusSoft  et  ASDG  pour  leur fabuleux, gΘnial, dΘmoniac,
  697.     dΘmentiel, extraordinaire, divin,...  Θditeur de texte CygnusEd 2.
  698.  
  699.  
  700. Signature:
  701. ----------
  702.     S.R. & P.C.
  703.     Ce n'est pas Status Register et Program Counter mais
  704.     Sylvain Rougier & Pierre Carrette.
  705.  
  706.  
  707. Donnations:
  708. -----------
  709.     Ce  programme  n'est  pas domaine public.  Ce programme est ShareWare.
  710.     Si  vous  l'utilisez,  veuillez  envoyer  50FF  (100FF  pour  ParM  et
  711.     BrowserII) et/ou constatation de bugs α:
  712.  
  713.         Sylvain Rougier
  714.         39 rue Carnot
  715.         86000 Poitiers
  716.         France.
  717.  
  718.