home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / cli / cliva / cliva_fra.doc < prev    next >
Text File  |  1993-04-05  |  36KB  |  869 lines
  1. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###########################
  2. @@@@@@     @@   @@@@@     @@   @@@   @@@@   @@@@@@####     #######     ######
  3. @@@@@   @@@@@   @@@@@@   @@@   @@@   @@@     @@@@@###  ###  #####  ###  #####
  4. @@@@@   @@@@@   @@@@@@   @@@   @@@   @@   @   @@@@########  #####  ###  #####
  5. @@@@@   @@@@@   @@@@@@   @@@@   @   @@@       @@@@####     ######  ###  #####
  6. @@@@@   @@@@@   @@@@@@   @@@@   @   @@   @@@   @@@###  ##########  ###  #####
  7. @@@@@@     @@      @@     @@@@    @@@@   @@@   @@@###      ##  ###     ######
  8. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###########################
  9.  
  10. CliVa v2.0 Copyright © 1991 1992 1993 Christian Warren  Tous droits réservés.
  11. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12.    Cliva est placé dans le Domaine Publique pour l'Amiga. Une contribution
  13. de 15$ est suggérée pour l'utiliser. Sentez vous libre de l'utiliser, mais A
  14. VOS PROPRES RISQUES, car je ne pourrais pas être tenu responsable pour
  15. des dommages que ce programme pourrait causer à votre système.
  16.  
  17. Introduction
  18. ~~~~~~~~~~~~
  19.    CliVa permet de créer une interface entièrement configurable pour lancer
  20. tous programmes à partir de Boutons.  Pour avoir une meilleur idée des
  21. possibilité de CliVa, je vous conseille de jeter un coup d'oeil au exemple
  22. fournis dans l'archive.
  23.    Pour l'utiliser, il faut absolument que les libraries 'PowerPacker' (permet
  24. de dé-compresser les configs) et 'Req' soit présent dans votre répertoire
  25. 'libs:'.  Ces dernière sont fournis dans l'archive, si vous executer le script
  26. 'Example' ils seront chargées en mémoire.  Vous pourrez ensuite les installer
  27. sur votre système si vous le désirer.
  28.  
  29. Information sur l'exécutable CliVa
  30. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  31.    - CliVa est 'pure', il peut donc être mis resident.
  32.  
  33.    SHELL usage:
  34.             CliVa {-configuration} Autre.config {-configuration}
  35.  
  36.    WORKBENCH usage:
  37.             -configuration
  38.             ...
  39.             Other.config
  40.             ...
  41.  
  42.    argument:
  43.       '-configuration' ==> CliVa fait comme si l'argument aurait été placé au
  44.                            début de la config.
  45.                         ex.
  46.                            CliVa "-TASK_PRIORITE 3" "-SET_VAR BLACK 0"
  47.       'Autre.config' ==> Config à charger.  Par défaut, CliVa recherche le
  48.                          fichier 'CliVa.config' dans le répertoire courant
  49.                          puis le répertoire 'S:'.
  50.                       ex.
  51.                          CliVa AutreConfig.config
  52.  
  53. Exigence
  54. ~~~~~~~~
  55.    - CliVa doit pouvoir accéder aux librairies 'PowerPacker', 'Req' et
  56.    'DiskFont' dans le répertoire LIBS:
  57.    - Les fichiers 'echo', 'execute', 'newshell' et 'mouse' doivent être
  58.    accessible.
  59.    - L'OS 2.0 N'EST PAS nécessaire à CliVa...
  60.  
  61. Commande pour configurer CliVa
  62. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63.  
  64.      Nom:  TASK_PRIORITY
  65.   format:  -TASK_PRIORITY priorité
  66.   défaut:  priorité = 0
  67. fonction:  Définie la priorité de la tâche CliVa, doit être entre -19 et
  68.            +19.
  69.  
  70.      Nom:  DEF_WINDOW_EXECUTE
  71.   format:  -DEF_WINDOW_EXECUTE définition_du_Shell
  72.   défaut:  "CON:000/095/640/105/CliVa_Shell"
  73. fonction:  Définie les informations sur le Shell qui sera ouvert lors de
  74.            l'exécution de bouton nécessitant une fenêtre de sortie.
  75.  
  76.      Nom:  ON_SCREEN
  77.   format:  -ON_SCREEN nom_écran
  78.   défaut:  "Workbench"
  79. fonction:  Ouvre CliVa sur un écran en particulier. Le nom de l'écran
  80.            fournit peut être définie que par les premières lettres du
  81.            titre réel. Si l'écran n'est pas trouvé, alors CliVa ouvrira
  82.            sur l'écran de défaut. Vous devez vous assurer de fermer CliVa
  83.            avant que l'écran en question se referme sinon vous pourriez
  84.            avoir a méditer sur votre erreur durant le rebootage de votre
  85.            système... :-)
  86.            ex. -ON_SCREEN CED  -> Ouvre Cliva sur l'écran de Cygnus Ed
  87.  
  88.  
  89.      Nom:  ICONIFIED
  90.   format:  -ICONIFIED
  91. fonction:  CliVa débutera sous forme d'iconne.
  92.  
  93.      Nom:  ICON_WHEN_EXECUTE
  94.   format:  -ICON_WHEN_EXECUTE
  95. fonction:  L'option 'AutoIconify' du menu sera selectionné.
  96.            (voir plus loin pour la fonction d'AutoIconifie)
  97.  
  98.  
  99.      Nom:  WINDOW_TITLE
  100.   format:  -WINDOW_TITLE titre
  101.   défaut:  "CliVa 2.0 (c) 1991-1993 Christian Warren"
  102. fonction:  Change le titre de la fenêtre. Si la configuration de CliVa
  103.            comporte plus d'une page, la chaine "   (Page xxx/max )" sera
  104.            ajouté au titre. Si l'option NO_DRAG_BAR est utilisé, le titre
  105.            sera affiché dans la bordure supérieur de l'écran.
  106.  
  107.      Nom:  NO_DRAG_BAR
  108.   format:  -NO_DRAG_BAR
  109. fonction:  La fenêtre ne comportera pas de DragBar visible. CliVa créera des
  110.            boutons invisibles pour remplacer les boutons ainsi éliminés.
  111.            Ces boutons invisible seront placés dans l'espace se trouvant
  112.            au haut de la fenêtre.
  113.  
  114.      Nom:  NO_MENU
  115.   format:  -NO_MENU
  116. fonction:  N'attache pas les menus à la fenêtre. Vous devez vous assurez
  117.            de définir au moins un bouton 'Quitter' si vous voulez que
  118.            l'utilisateur puisse quitter CliVa...
  119.  
  120.      Nom:  FONT
  121.   format:  -FONT fonte hauteur
  122.   défaut:  fonte par défaut du système.
  123. fonction:  Définie la fonte utilisé et sa hauteur.
  124.            ex. -FONT Diamond.font 14
  125.  
  126.      Nom:  POS_WINDOW
  127.   format:  -POS_WINDOW position_x position_y
  128.   défaut:  position_x = 0             position_y = 11
  129. fonction:  Définie la position du coin supérieur gauche de la fenêtre. Si
  130.            la fenêtre dépasse la bordure de l'écran, la position sera
  131.            ajusté pour que la fenêtre puisse être affiché. Par exemple, si
  132.            vous definissez la position en X à 2000, alors la fenêtre de
  133.            CliVa sera toujours collée sur la bordure droite de l'écran,
  134.            et ce, quelque soit la largeur de la fenêtre.
  135.  
  136.      Nom:  COLOR_WINDOW
  137.   format:  -COLOR_WINDOW couleur_Lettre couleur_Fond
  138.   défaut:  couleur_Lettre = 2         couleur_Fond = 1
  139. fonction:  Définie les couleurs utilisées pour la fenêtre. Ces couleurs
  140.            sont utilisées, entre autres, pour les menus et la bordure de
  141.            la fenêtre.
  142.  
  143.      Nom:  COLOR_BACKGROUND
  144.   format:  -COLOR_BACKGROUND couleur
  145.   défaut:  couleur = 2
  146. fonction:  Définie la couleur utilisée pour le fond de la fenêtre.
  147.  
  148.      Nom:  NB_GADGETS
  149.   format:  -NB_GADGETS nb_horizontal nb_vertical
  150.   défaut:  nb_horizontal = 5          nb_vertical = 4
  151. fonction:  Définie le nombre de bouton horizontale et verticale.
  152.  
  153.      Nom:  UP_TO_DOWN
  154.   format:  -UP_TO_DOWN
  155. fonction:  Les boutons seront numérotés de bas en haut, au lieu de gauche
  156.            à droite.
  157.  
  158.            NORMAL               UPDOWN
  159.            1  2  3              1  4  7
  160.            4  5  6              2  5  8
  161.            7  8  9              3  6  9
  162.  
  163.      Nom:  SIZE_GADGET
  164.   format:  -SIZE_GADGET largeur hauteur
  165.   défaut:  largeur = 112              hauteur = 13
  166. fonction:  Définie la largeur et la hauteur des boutons.
  167.  
  168.      Nom:  PIXEL_BETWEEN_GADGET
  169.   format:  -PIXEL_BETWEEN_GADGET espace_x espace_y
  170.   défaut:  espace_x = 12              espace_y = 4
  171. fonction:  Définie l'espace, en pixels, entre les boutons.
  172.  
  173.      Nom:  PIXEL_FROM_BORDER
  174.   format:  -PIXEL_FROM_BORDER gauche droite haut bas
  175.   défaut:  gauche = 16    droite = 16    haut = 5    bas = 5
  176. fonction:  Définie l'espace, en pixels, entre les boutons et la bordure de
  177.            la fenêtre.
  178.  
  179.      Nom:  COLOR_BORDER_GADGET
  180.   format:  -COLOR_BORDER_GADGET couleur_Haut couleur_Bas
  181.   défaut:  couleur_Haut = 1           couleur_Bas = 0
  182. fonction:  Définie les couleurs utilisées pour le contour des boutons.
  183.  
  184.      Nom:  COLOR_GADGET_DEF
  185.   format:  -COLOR_GADGET_DEF couleur_lettre couleur_fond
  186.   défaut:  couleur_lettre = 1         couleur_fond = 2
  187. fonction:  Définie les couleurs par défaut pour les boutons.
  188.  
  189.      Nom:  FONT_STYLE
  190.   format:  -FONT_STYLE style
  191.   défaut:  NORMAL
  192. fonction:  Définie le style par défaut pour les boutons.  Vous devez
  193.            entrer un chiffre définissant le style de la fonte.
  194.            NORMAL   = 0             SOULIGNE = 1
  195.            GRAS     = 2             ITALIQUE = 4
  196.            EXTENDED = 8
  197.            ex. GRAS + ITALIQUE -> 2 + 4  ==> -FONT_STYLE 6
  198.  
  199.  
  200.      Nom:  GADGET_ICONIFIED
  201.   format:  -GADGET_ICONIFIED nom
  202.   défaut:  "CliVa"
  203. fonction:  Définie ce qui sera écrit dans la fenêtre iconifié de CliVa.
  204.  
  205.      Nom:  DEF_ICON
  206.   format:  -DEF_ICON position_x position_y largeur
  207.   défaut:  position_x = 0     position_y = 11     largeur = 100
  208. fonction:  Définie la position du coin supérieur gauche et la largeur de
  209.            la fenêtre iconifié de CliVa. (Largueur minimum = 26)
  210.            Les positions en X et Y sont régis par les mêmes remarques que
  211.            POS_WINDOW. La hauteur de la fenêtre iconifié sera calculé en
  212.            fonction de la hauteur des boutons.
  213.  
  214.  
  215.      Nom:  SET_VAR
  216.   format:  -SET_VAR nom valeur_numérique
  217. fonction:  Définie une variable servant à faciliter la création des
  218.            scripts.  Vous pouvez définir autant de variable que vous
  219.            voulez.  Une fois définie, CliVa remplacera -nom- par la
  220.            -valeur_numérique- lorsqu'une configuration demande un chiffre
  221.            comme argument.  Si un nom de variable est définie plus d'une
  222.      fois, seul la première affectation sera utilisé.  Les variables
  223.      sont conseillées pour créer des scripts facilement modifiable.
  224.  
  225.            ex.   -SET_VAR rouge             3
  226.                  -SET_VAR bleu              2
  227.                  -SET_VAR GRAS_SOULIGNER    3
  228.  
  229.                  -COLOR_GADGET_DEF rouge bleu
  230.                  -FONT_STYLE GRAS_SOULIGNER
  231.  
  232. Notes.
  233.    - Les variables définies par SET_VAR peuvent être utilisé à tout les
  234.    endroit où l'argument demandé est un chiffre.
  235.    ex. -SET_VAR rouge 2       <= OK
  236.        -SET_VAR Titre "CliVa 2.0"   <= ERREUR
  237.        -COLOR_BACKGROUND rouge   <= OK
  238.        -WINDOW_TITLE Titre    <= ERREUR
  239.        -WINDOW_TITLE rouge    <= titre du window -> 'rouge'
  240.  
  241.    - Les arguments contenant des espaces doivent être encadrer de '"'.
  242.    ex. -WINDOW_TITLE "CliVa 2.0"
  243.  
  244.    - Les configurations doivent ABSOLUMENT être placé avant la
  245.    définition des boutons.  Si une configuration est placé après le
  246.    début de la définition des boutons, alors la ligne de configuration
  247.    sera incluse dans la commande du bouton précédent.
  248.  
  249.    - Vous pouvez placer des commentaires en placant un '#' au début de la
  250.    ligne en question.
  251.  
  252. Définition des Boutons
  253. ~~~~~~~~~~~~~~~~~~~~~~
  254.  
  255.    Ces Arguments sont utilisés pour la définition de bouton.
  256.       Titre du Bouton = Chaine de caractère à être écrit dans le bouton. Le
  257.                         titre du bouton peut comporter des [<numéro>].  Ce
  258.                         qui inserera dans le titre la contenu de la
  259.                         variable <numéro>.  Si la variable change de
  260.                         valeur, le titre du bouton reflétera ce changement.
  261.                         ex.
  262.                            variable 1 = "OS 2.0"
  263.                            titre      = "Couleur [1]"
  264.                            Résultat  -> "Couleur OS 2.0"
  265.       couleur_lettre  = Couleur utilisé pour les lettres du bouton.
  266.       couleur_fond    = Couleur pour le fond du bouton.
  267.       style_fonte     = Style de la fonte du bouton.
  268.                         (voir config. FONT_STYLE)
  269.  
  270.    Neuf sortes de boutons sont possible:
  271.  
  272.    ------------------------ 1. Commande de départ -------------------------
  273.  
  274.       format:
  275.          =S
  276.          Commande
  277.          [Commande ...]
  278.       fonction:
  279.          Définie les commandes qui seront exécuté lors du départ de CliVa.
  280.          Aucun bouton ne sera créé. Ceci peut être pratique pour assigner
  281.          des valeurs par défaut à certaine variable.
  282.       exemple:
  283.          =S
  284.          \vs[1]Workbench
  285.          \vs[2]df0:
  286.          \vs[3]df1:
  287.  
  288.          =D "DiskCopy de [2] à [3]"
  289.          DiskCopy \vu[2] TO \vu[3]
  290.  
  291.    ------------------------------ 2. Bouton -------------------------------
  292.  
  293.       format:
  294.          =D Titre [couleur_lettre] [couleur_fond] [style_fonte]
  295.          Commande
  296.          [Commande ...]
  297.       fonction:
  298.          Définie un bouton.  Vous devez fournir le Titre, les autres
  299.          informations sont facultative.
  300.       exemple:
  301.          =D "Avail" rouge bleu
  302.          Avail\w
  303.  
  304.    ------------------------------- 3. Menu --------------------------------
  305.  
  306.       format:
  307.          =D* Titre [couleur_lettre] [couleur_fond] [style_fonte]
  308.       fonction:
  309.          Définie un 'Menu'.  Ce genre de bouton ne pourra pas executer de
  310.          commande. Ils peuvent servir a séparer les différentes parties de
  311.          votre configuration. Ces boutons n'apparaitront pas surélevé à
  312.          l'écran pour que l'ont puissent les distinguer. Vous devez fournir
  313.          le Titre, les autres informations sont facultative.
  314.       exemple:
  315.          =D* "Utilité" blanc noir
  316.  
  317.    -------------------- 4. définition d'un bouton fixe --------------------
  318.  
  319.       format:
  320.          =[ position Titre [couleur_lettre] [couleur_fond] [style_fonte]
  321.          Commande
  322.          [Commande ...]
  323.       fonction:
  324.          Définie un bouton qui apparaitra sur chaque page, à partir de
  325.          l'endroit où il est défini.  Vous devez fournir la position où
  326.          vous voulez que le bouton apparaisse.  Un chiffre négatif place le
  327.          bouton par rapport à la fin de la page au lieu du début.
  328.          N'oubliez pas de tenir compte de l'option UP_TO_DOWN. Le nombre
  329.          de bouton Fixe est limité à 29. Faite attention de ne pas définir
  330.          des boutons fixe pour chaque position d'une fenêtre. Dans cette
  331.          situation, CliVa se trouvera dans une boucle sans fin, il créera
  332.          des zillions de boutons...
  333.       exemple:
  334.          Si NOMBRE_BOUTON_HORIZONTAL = 4
  335.             NOMBRE_BOUTON_VERTICAL   = 3
  336.  
  337.          Alors les boutons seront numeroté comme suit:
  338.  
  339.             1    2    3    4           -12  -11  -10   -9
  340.             5    6    7    8     ou     -8   -7   -6   -5
  341.             9   10   11   12            -4   -3   -2   -1
  342.  
  343.                   =[ 11 "Page suivante" noir rouge
  344.                   \np
  345.  
  346.                   *** est équivalent à ***
  347.  
  348.                   =[ -2 "Page suivante" noir rouge
  349.                   \np
  350.  
  351.    --------------------- 5. définition d'un Menu fixe ---------------------
  352.  
  353.       format:
  354.          =[* position Titre [couleur_lettre] [couleur_fond] [style_fonte]
  355.       fonction:
  356.          Définie un Menu qui apparaitra sur chaque page, à partir de
  357.          l'endroit où il est défini.  Pour le reste, c'est identique à un
  358.          bouton fixe.
  359.  
  360.    ------------- 6. destruction d'un bouton ou d'un Menu fixe -------------
  361.  
  362.       format:
  363.          =] position
  364.       fonction:
  365.           Détruit un bouton ou un Menu fixe.
  366.       exemple:
  367.          ... plusieurs page SANS le bouton Bidon ...
  368.          =[* 2 "Bidon"
  369.          ... plusieurs page AVEC le bouton Bidon ...
  370.          =] 2
  371.          ... plusieurs page SANS le bouton Bidon ...
  372.  
  373.    ---------------------------- 7. Bouton Vide ----------------------------
  374.  
  375.       format:
  376.          =E
  377.       fonction:
  378.          Définie un bouton vide. Equivalent à la définition:
  379.          =D* ""
  380.  
  381.    -------------- 8. Bouton Vide jusqu'à la prochaine ligne ---------------
  382.  
  383.       format:
  384.          =L
  385.       fonction:
  386.          Place des boutons 'vides' tant que nous ne somme pas au début
  387.          d'une ligne, si la position est déja au début d'une ligne alors
  388.          rien n'est fait.
  389.  
  390.    -------------- 9. Bouton Vide jusqu'à la prochaine page ----------------
  391.  
  392.       format:
  393.          =P
  394.       fonction:
  395.          Place des boutons 'vides' tant que nous ne somme pas au début
  396.          d'une page, si la position est déja au début d'une page alors
  397.          rien n'est fait.
  398.  
  399.  
  400. Options disponible dans les commandes
  401. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  402.  
  403. Toutes les options commencent par un backslash ('\') et sont suivies
  404. d'arguments définies entre accolades ('[', ']').  Si un argument est sous
  405. la forme [^<numéro>], alors le contenu de la variable <numéro> sera utilisé.
  406.    ex.
  407.    \vs[1]Vous avez sélectionné le fichier \f1!
  408.    \pa[Information][^1][OK]
  409.  
  410. Notes.
  411.  - Lorsque l'argument d'une commande est 'Répertoire de départ', vous
  412.    pouvez placer un [-] pour garder le répertoire déja en place. Cette
  413.    fonction n'est utile que lorsque vous voulez fournir des valeurs aux
  414.    autres arguments (ex. le Titre) sans pour autant définir un nouveau
  415.    répertoire de départ.
  416.    exemple.
  417.        Copy \f1[dh0:][De quel fichier?] TO \f1[][Vers quel fichier?]
  418.    => De cette façon, le répertoire de départ du deuxième \f1 sera le
  419.    répertoire courant.  Tandis que si vous remplacez le deuxième
  420.    \f1 par '\f1[-][Vers quel fichier?]' alors son répertoire de
  421.    départ sera le répertoire du fichier à copier. Ce qui est
  422.    beaucoup plus pratique...
  423.  - Lorsque l'argument d'une commande est 'Question', vous pouvez placer
  424.    des '@' dans la Question, ce qui fera en sorte d'inserer des sauts de
  425.    ligne à ces endroits.
  426.  
  427.  - Les variables utilisées dans cette partie de CliVa sont définie par
  428.     un numéro de variable (1 à 15000) et par le contenu de la variable en
  429.    question. Une fois définie, la variable peut être utilisé un peu
  430.    partout. Par exemple, le contenu de la variable pourrait apparaitre dans
  431.    un titre de bouton (voir Définition des Boutons). Il ne faut toute fois
  432.    pas mélanger les variables utilisées par CliVa et les variables qui se
  433.    trouve dans votre répertoire 'ENV:', pour utiliser les variables 'ENV:'
  434.    il vous faut absolument utiliser les fonction \vfe et \vte. Ces
  435.    dernière feront en sorte d'importer ou d'exporter le contenu d'une
  436.    variable 'ENV:' dans une variable de CliVa.
  437.  
  438. ---------------------------------------------------------------------------
  439.  
  440.     option: \b
  441.   fonction: Effectue un backspace dans la commande.
  442.    exemple: Copy df0: to df0:\b\b1:  =>  Copy df0: to df1:
  443.  
  444. ---------------------------------------------------------------------------
  445.  
  446.     option: \d[répertoire de départ][Titre de la fenêtre]
  447. Arg oblig.: Aucun.
  448.   fonction: Ouvre un solliciteur de répertoire.
  449.    exemple: cd \d[ram:][Quelle répertoire?]
  450.  
  451. ---------------------------------------------------------------------------
  452.  
  453.     option: \dl
  454.   fonction: Insère le dernier répertoire sélectionné.  Si \f1 ou \fm a été
  455.             utilisé, le répertoire du fichier est insèré.  Cette
  456.             particuliarité peut être très pratique, comme le temoigne
  457.             l'exemple ci-dessous.
  458.    exemple: \vs[1]\f1[][Fichier à exécuter?]
  459.             cd \dl         => Le répertoire courant est celui où se
  460.             \vu[1]         => trouve le fichier à être exécuté.
  461.  
  462. ---------------------------------------------------------------------------
  463.  
  464.     option: \f1[répertoire de départ][Titre de la fenêtre][Motif]
  465. Arg oblig.: Aucun.
  466.   fonction: Ouvre un solliciteur de fichier. Le fichier sélectionné sera
  467.             inseré dans le script.
  468.    exemple: Unwarp \f1[download:][Quel fichier warp?][*.wrp]
  469.  
  470. ---------------------------------------------------------------------------
  471.  
  472.     option: \fl[extension]
  473. Arg oblig.: Aucun.
  474.   fonction: Insère le dernier fichier sélectionné. Vous pouvez changer
  475.             l'extension de ce fichier.
  476.    exemple: shamsharp \f1 \fl[iff]  ==>  shamsharp "image.gif" "image.iff"
  477.  
  478. ---------------------------------------------------------------------------
  479.  
  480.     option: \fm[répertoire de départ][Titre de la fenêtre][Motif][max]
  481. Arg oblig.: Aucun.
  482.   fonction: Ouvre un solliciteur multiple de fichier. Vous pouvez lui
  483.             donner un maximum de fichier sélectionnable.
  484.    exemple: View80 \fm[texte:][Textes à lire?][*][10]
  485.  
  486. ---------------------------------------------------------------------------
  487.  
  488.     option: \g et \G
  489.   fonction: Par défaut, les fichiers et répertoires sont encadrés de
  490.             guillemets. Ces options permettent de d'annuler ou de remettre
  491.             cette option.
  492.             \q -> Ne mets plus de guillemets.
  493.             \Q -> Mets des guillemets.
  494.    exemple: View80 \f \g\f \G\f    => view80 "fichier1" fichier2 "fichier3"
  495.  
  496. ---------------------------------------------------------------------------
  497.  
  498.     option: \o et \O
  499.   fonction: Par défaut, les fichiers sont précédés de leur chemin (path).
  500.             Ces options permettent de d'annuler ou de remettre cette
  501.             option.
  502.             \o -> Ne met pas de chemin.
  503.             \O -> Met le chemin.
  504.    exemple: Deksid \f1        =>  Deksid "dh0:rep/fichier"
  505.             Deksid \o\f1      =>  Deksid "fichier"
  506.             Deksid \O\f1      =>  Deksid "dh0:rep/fichier"
  507.  
  508. ---------------------------------------------------------------------------
  509.  
  510.     option: \pa[Titre fenêtre][Question][Rép Gauche][Rép Milieu][Rép Droite]
  511.                            [Contenu Gauche][Contenu Milieu][Contenu Droite]
  512. Arg oblig.: Titre et Question.
  513.   fonction: Ouvre un solliciteur. Si la réponse Gauche est choisi alors le
  514.             Contenu Gauche sera inséré dans le script.  Si vous placez un
  515.             '@' dans la Question, une saut de ligne sera inseré à cet
  516.             endroit. Ceci est vrai dans tout les arguments intitulés
  517.             'Question'.
  518.    exemple: \pa[Info][Quelle lecteur de disque?][df0:][][df1:][df0:][][df1:]
  519.  
  520. ---------------------------------------------------------------------------
  521.  
  522.     option: \q[contenu de défaut][Titre de la fenêtre]
  523. Arg oblig.: Contenu et Titre.
  524.   fonction: Pose une question.
  525.    exemple: Unwarp \f1 \q[df0:][Quelle lecteur de disque?]
  526.  
  527. ---------------------------------------------------------------------------
  528.  
  529.     option: \ql
  530.   fonction: Insère la dernière réponse à une question.
  531.    exemple: cd \q[df0:][Quelle lecteur de disque?]
  532.             Unwarp \f1 \ql
  533.  
  534. ---------------------------------------------------------------------------
  535.  
  536.     option: \ivs[numéro de variable]
  537. Arg oblig.: Numéro de la variable.
  538.   fonction: Si la variable N'EST PAS définie, le restant de la ligne en cours
  539.             sera analysée.
  540.    exemple: \ivs[1]\vs[1]\d[ram:][Ouvrir un Shell avec quelle répertoire?]
  541.             NewShell \vu[1] => La première fois que ce bouton sera exécuté,
  542.                                le répertoire sera demandé.  Par la suite,
  543.                                la commande "NewShell répertoire" sera
  544.                                exécuté sans que vous ayez à rentrer quoi
  545.                                que ce soit.
  546.  
  547. ---------------------------------------------------------------------------
  548.  
  549.     option: \vc[numéro de variable]
  550. Arg oblig.: Aucun.
  551.   fonction: Efface une ou toute les variables de CliVa. Si aucun argument
  552.             n'est passé à cette fonction, toute les variables seront
  553.             effacées. Prenez l'habitude de toujours effacer les variables
  554.             locales à un seul bouton, car chaque variable nécessite de la
  555.             mémoire.
  556.    exemple: \vs[1]Vous avez sélectionné le fichier \f1
  557.             \pa[Info][^1]
  558.             \vc[1]
  559.  
  560. ---------------------------------------------------------------------------
  561.  
  562.     option: \ved[numéro de variable][contenu visé]
  563. Arg oblig.: Numéro de la variable et le contenu visé.
  564.   fonction: Si la variable est définie et que son contenu EST EGAL au
  565.             contenu visé, le restant de la ligne en cours sera analysée.
  566.    exemple: \vs[1]\pa[Info][Question?][Choix a][Choix b][Choix c][a][b][c]
  567.             \ved[1][a]Commande pour choix a.
  568.             \ved[1][a]Autre commande pour choix a.
  569.             \ved[1][b]Commande pour choix b.
  570.             \ved[1][c]Commande pour choix c.
  571.  
  572. ---------------------------------------------------------------------------
  573.  
  574.     option: \vnd[numéro de variable][contenu visé]
  575. Arg oblig.: Numéro de la variable et le contenu visé.
  576.   fonction: Si la variable est définie et que son contenu N'EST PAS EGAL au
  577.             contenu visé, le restant de la ligne en cours sera analysée.
  578.  
  579. ---------------------------------------------------------------------------
  580.  
  581.     option: \vfe[numéro de variable CliVa][nom de la variable ENV:]
  582. Arg oblig.: Numéro de la variable et le nom de la variable ENV:.
  583.   fonction: Importe le contenu de la variable 'ENV:' dans une variable
  584.             'CliVa'. Vous êtes obligez d'utiliser cette fonction si vous
  585.             voulez, par exemple, modifier le contenu d'une variable 'ENV:'.
  586.             A Noter: Le nom de la variable 'ENV:' peut contenir un chemin
  587.             (ex. 'ram:env/Workbench') mais il ne faut pas qu'il y es des
  588.             guillemets qui encadrent le nom de la variable. Voir exemple.
  589.    exemple: \vs[1]\g\o\f1[ENV:][Modifier quelle variable ENV:?]
  590.             \vfe[2][^1]
  591.             \vm[2]
  592.             \vte[2][^1]
  593.  
  594. ---------------------------------------------------------------------------
  595.  
  596.     option: \vm[numéro de variable]
  597. Arg oblig.: Numérode la variable.
  598.   fonction: Modifie le contenu d'une variable. Le titre de la fenêtre sera
  599.             'Modify variable', si ce titre ne vous convient pas, vous
  600.             pouvez toujours utiliser l'option \q qui est plus général.
  601.             \vm[1]    ===     \vs[1]\q[^1][Autre Titre]
  602.    exemple: \vs[1]\f1         => 'ram:env/Workbench'
  603.             \vm[1]
  604.             Deksid \vu[1]\vc[1]
  605.  
  606. ---------------------------------------------------------------------------
  607.  
  608.     option: \vs[numéro de variable][Contenu]
  609. Arg oblig.: Numéro de la variable.
  610.   fonction: Assigne un contenu à une variable. Si Contenu est fournis, alors
  611.             Contenu sera assigné à la variable.  Sinon le contenu assigné sera
  612.             le résultat de l'analyse de la ligne sur lequel le \vs apparait.
  613.             Le numéro de la variable doit être compris entre 1 et 15000.  Si
  614.             vous entrez un numéro hors de cette intervale, CliVa l'acceptera
  615.             mais les résultats pourrait être surprenant.
  616.    exemple: Vous avez choisit le fichier \f1.\vs[1]
  617.                      => Variable 1 = 'Vous avez choisit le fichier "fic".'
  618.             \vs[1][Bidon1]\vs[2][Bidon2]
  619.                      => Variable 1 = 'Bidon1' et Variable 2 = 'Bidon2'
  620.  
  621. ---------------------------------------------------------------------------
  622.  
  623.     option: \vte[numéro de variable CliVa][nom de la variable ENV:]
  624. Arg oblig.: Numéro de la variable et le nom de la variable ENV:.
  625.   fonction: Exporte le contenu de la variable CliVa vers une variable
  626.             ENV:.
  627.             A Noter: Contrairement à \vfe, le nom de la variable ENV: ne
  628.             peut pas contenir de chemin...
  629.    exemple: \vfe[2][WorkBench]
  630.             \vm[2]
  631.             \vte[2][WorkBench]
  632.  
  633. ---------------------------------------------------------------------------
  634.  
  635.     option: \vu[numéro de variable][contenu par défaut]
  636. Arg oblig.: Numéro de la variable.
  637.   fonction: Insère dans le script le contenu de la variable. Si la variable
  638.             n'est pas définie, le contenu par défaut sera utilisé.
  639.    exemple: Format \vu[1][df0:]
  640.  
  641. ---------------------------------------------------------------------------
  642.  
  643.     option: \I
  644.   fonction: Après que le script de ce bouton est exécuter, CliVa s'iconifie.
  645.    exemple: CliVa s:Autre.config\I
  646.  
  647. ---------------------------------------------------------------------------
  648.  
  649.     option: \Q
  650.   fonction: Après que le script de ce bouton est exécuter, CliVa quitte.
  651.    exemple: CliVa s:CliVa.config\Q  ==>  simule un RE-LOAD config.
  652.  
  653. ---------------------------------------------------------------------------
  654.  
  655.     option: \np
  656.   fonction: Après que le script de ce bouton est exécuter, le numéro de
  657.             page sera incrémenter de 1. Plusieurs \np peuvent se trouver
  658.             dans une même commande.
  659.    exemple: =D "Prochaine Page"
  660.             \np
  661.  
  662. ---------------------------------------------------------------------------
  663.  
  664.     option: \pp
  665.   fonction: Après que le script de ce bouton est exécuter, le numéro de
  666.             page sera décrémenter de 1. Plusieurs \pp peuvent se trouver
  667.             dans une même commande.
  668.    exemple: =D "Précédente Page"
  669.             \pp
  670.  
  671. ---------------------------------------------------------------------------
  672.  
  673.     option: \p[numéro de page]
  674. Arg oblig.: Numéro de page.
  675.   fonction: Après que le script de ce bouton est exécuter, le numéro de
  676.             page sera changé pour le numéro de page fournis.
  677.    exemple: =D "Allez à la page 3"
  678.             \p[3]
  679.  
  680. ---------------------------------------------------------------------------
  681.  
  682.     option: \sa
  683.   fonction: DéSélectionne l'option AutoIconifie dans le menu.
  684.  
  685. ---------------------------------------------------------------------------
  686.  
  687.     option: \sA
  688.   fonction: Sélectionne l'option AutoIconifie dans le menu.
  689.  
  690. ---------------------------------------------------------------------------
  691.  
  692.     option: \sm
  693.   fonction: DéSélectionne l'option Modify dans le menu.
  694.  
  695. ---------------------------------------------------------------------------
  696.  
  697.     option: \sM
  698.   fonction: Sélectionne l'option Modify dans le menu.
  699.  
  700. ---------------------------------------------------------------------------
  701.  
  702.     option: \m
  703.   fonction: La ligne sur lequel \m se trouve pourra être modifié lorsque
  704.             l'ont exécutera ce bouton. Voir l'option 'Modifie Commande'.
  705.    exemple: cd dh0:     ==>   ne modifie pas
  706.             Avail\m     ==>   modifie
  707.             dir         ==>   ne modifie pas
  708.  
  709. ---------------------------------------------------------------------------
  710.  
  711.     option: \M
  712.   fonction: A partir de la ligne sur lequel \M se trouve, tout les lignes
  713.             pourront être modifié lorsque l'ont exécutera ce bouton.  Voir
  714.             l'option 'Modifie Commande'.
  715.    exemple: cd dh0:     ==>   ne modifie pas
  716.             Avail\M     ==>   modifie
  717.             dir         ==>   modifie
  718.  
  719. ---------------------------------------------------------------------------
  720.  
  721.     option: \ael[Titre fenêtre][Question][Rép Positive][Rép Negative]
  722. Arg oblig.: Titre fenêtre et Question.
  723.   fonction: Si la réponse à la question est Positive, alors le reste de la
  724.             ligne en cours sera analysé. Si vous placez un '@' dans la
  725.             Question, une saut de ligne sera inseré à cet endroit.
  726.    exemple: avail
  727.             \eal[Question][Executer Deksid avant dir?][Oui][Non]Deksid
  728.             dir
  729.  
  730. ---------------------------------------------------------------------------
  731.  
  732.     option: \aes[Titre fenêtre][Question][Rép Positive][Rép Negative]
  733. Arg oblig.: Titre fenêtre et Question.
  734.   fonction: Si la réponse à la question est Positive, alors le reste des
  735.             commande pour ce bouton seront analysées.
  736.    exemple: avail
  737.             \aes[Question][Executer Deksid et dir?][Oui][Non]Deksid
  738.             dir
  739.  
  740. ---------------------------------------------------------------------------
  741.  
  742.     option: \des[Titre fenêtre][Question][Rép Positive][Rép Negative]
  743. Arg oblig.: Aucun
  744.   fonction: Si la réponse à la question est Negative ou que le titre et la
  745.             question ne sont pas fournis, alors le script ne sera pas
  746.             executé.
  747.    exemple: avail
  748.             \des[Question][Executer Avail, Deksid et dir?][Oui][Non]Deksid
  749.             dir
  750.  
  751. ---------------------------------------------------------------------------
  752.  
  753.     option: \es
  754.   fonction: Execute le contenu du script après que la ligne en cours es été
  755.             analysé même si l'analyse de toute les commandes n'est pas
  756.             encore completé.  Une fois que l'exécution du script a été
  757.             amorcé, le reste des commandes seront analysées.
  758.    exemple: avail\es\w
  759.             dir\es\w       => ouvre 2 fenêtres de sortie, et execute
  760.                               simultanément avail et dir.
  761.  
  762. ---------------------------------------------------------------------------
  763.  
  764.     option: \nd
  765.   fonction: Par défaut, si l'option \w est utilisé, les commandes DOS
  766.             suivantes seront ajoutés au script 'echo Press mouse button' et
  767.             'mouse'.  Ce qui fera en sorte de bloquer la fenêtre de sortie
  768.             tant que vous n'aurez pas cliqué sur un des boutons de la
  769.             sortie.  Avec \nd aucune de ces 2 commandes ne sera ajoutés.
  770.    exemple: echo "lisez vite :)"\w\nd
  771.  
  772. ---------------------------------------------------------------------------
  773.  
  774.     option: \w
  775.   fonction: Signale que le script nécessite une fenêtre de sortie. En gros,
  776.             la commande DOS executé sera
  777.                'NewShell "définition_du_Shell" from script'
  778.             au lieu de
  779.                'Execute script'
  780.    exemple: avail\w
  781.  
  782. ---------------------------------------------------------------------------
  783.  
  784.     option: \X
  785.   fonction: Execute immediatement la ligne sur lequel \X apparait. La ligne
  786.             en question n'apparaitra dans le script final. L'analyse des
  787.             commandes sera interrompu tant que l'exécution de la ligne ne
  788.             sera pas completé.
  789.    exemple: more texte\X
  790.             \pa[Question][Le texte vous plait-il?][Oui][Peut-etre][Non]
  791.  
  792. ---------------------------------------------------------------------------
  793.  
  794. SPECIAL
  795. ~~~~~~~
  796.  - Lorsque vous cliquez sur un bouton, vous pouvez presser en même temps sur
  797. les touches de fonctions (Control, Alt, Amiga). Les variables suivantes
  798. seront alors initialisé:
  799.    - variable numéro 15001 <- 'CONTROL'  si la touche CONTROL est enfoncé.
  800.    - variable numéro 15002 <- 'R-ALT'    si la touche ALT-DROITE est enfoncé.
  801.    - variable numéro 15003 <- 'L-ALT'    si la touche ALT-GAUCHE est enfoncé.
  802.    - variable numéro 15004 <- 'ALT'      si une des touches ALT est enfoncé.
  803.    - variable numéro 15005 <- 'R-AMIGA'  si la touche ALT-AMIGA est enfoncé.
  804.    - variable numéro 15006 <- 'L-AMIGA'  si la touche ALT-AMIGA est enfoncé.
  805.    - variable numéro 15007 <- 'AMIGA'    si une des touches AMIGA est enfoncé.
  806.  
  807. Exemple de bouton.
  808.    =D "Avail"
  809.    \ved[15001][CONTROL] Avail          => si touche CONTROL enfoncé -> 'Avail'
  810.    \vnd[15001][CONTROL] Avail flush    => sinon 'Avail flush'
  811.  
  812. MENU
  813. ~~~~
  814.  - AutoIconifie : Lorsque cette option est sélectionnée CliVa
  815.         s'iconise automatiquement après chaque exécution
  816.         d'un bouton comportant au moins une commande DOS. De
  817.              cette manière, les boutons du genre 'Prochaine Page'
  818.         pourront être exécuter sans que CliVa s'iconise sans
  819.         arrêt...
  820.  - Modifie: Tout les lignes pourront être modifiées avant d'être
  821.        inseré dans le script. Si une des deux clés SHIFT
  822.        est pressé lorsque vous cliquer sur un bouton,
  823.        l'option 'Modifie' sera en fonction durant l'analyse
  824.        des commandes.
  825.  
  826. Histoire
  827. ~~~~~~~~
  828.    version 2.0:            30 mars 93
  829.    ------------
  830.                - Première version officiel.
  831.  
  832. A Faire
  833. ~~~~~~~
  834.    - Utiliser la ReqTools.library au lieu de la req.library.
  835.    - Rajouter des 'shortcuts' au bouton.
  836.    - Possibilité d'utiliser des noms pour les variables, au lieu de
  837.      chiffres.
  838.    - Faire une version plus spécifique à l'OS 2.0.
  839.  
  840. Pour me rejoindre, et m'encourager:
  841. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  842.         CLIVA est un produit Shareware, ce qui veut dire qu'il faut le
  843. payer si on l'utilise beaucoup.  Une contribution de 15$ est recommandée,
  844. mais toute autre contribution sera acceptée.  N'hésitez pas non plus à me
  845. laisser des messages sur les réseaux pour me donner vos commentaires sur
  846. CLIVA. Les groupes d'usagés Amiga et les collections de programmes Domaine
  847. Publiques, tels que Fred Fish, sont encouragés à mettre CLIVA dans leurs
  848. collections.
  849.  
  850.                      1:167.151.0@fidonet
  851.  Christian Warren   40:600/151.0@amiganet
  852.                    101:166/106.0@francomedia
  853.  
  854.                    Christian Warren
  855.                    2201 Edouard-MontPetit #11
  856.                    Montréal, Qué, CANADA
  857.                    H3T 1J3
  858.  
  859. Remerciement à
  860. ~~~~~~~~~~~~~~
  861. - C.W. Fox et Bruce Dawson: Pour leurs fantastiques librairies de File
  862.              Requester et Color Requester.
  863. - Nico Francois: Pour ses merveilleuses librairies.
  864.                  (ReqTools et PowerPacker).
  865. - Denis Turcotte: Pour avoir traduit les docs, pour avoir été le Beta
  866.         testeur officiel de CliVa et pour m'avoir 'forcé' à
  867.         rajouter un paquet de fonctions. Va-t'il faire les .guide!!
  868.  
  869.