/*========================================================================== * \__________/ Copyright 1988-90 Jean-Michel Forgeas & The Software Winery. * \° ° / All Rights Reserved. This program may not be distributed * \ ° °/ without the permission of the author: * \ ° / Jean-Michel Forgeas * \ °/ 4 rue du Général Leclerc * || 95210 Saint-Gratien FRANCE * || Contact The Software Winery at : * || BBS : +33 (1) 39 55 84 59 (V23 Videotex) * || MAIL : c/o Alain DIDIERJEAN 69 rue Dunois * || 75646 Paris cedex 13 FRANCE * «====» INTERNET: rouaix@inria.inria.fr or groult@ibp.fr *========================================================================== */ ========================================================================== || || || AZ : Mode d'Emploi || || -version courante : 1.50 (06-Fev-90)- || ========================================================================= AVERTISSEMENT Le Mode d'Emploi d'AZ se veut complet et détaillé, il est donc passablement long et touffu. Un conseil : ne commencez pas par le lire, au risque de renoncer à utiliser AZ avant d'avoir pu savourer toutes ses qualités. L'interface utilisateur est suffisamment intuitive pour qu'on puisse travailler longtemps avec AZ sans jamais avoir recours à sa documentation. Ce n'est que lorsqu'on a le sentiment qu'il "manque quelque chose", qu'une action devrait pouvoir être exécutée avec une séquence de commandes plus concise qu'il devient urgent de se plonger dans le Mode d'Emploi. N'oubliez pas que ce Mode d'Emploi a été conçu pour être lu dans AZ. Dés lors que le texte vous semble obscur ou ambigüe, expérimentez, tout s'éclairera aussitôt (bien entendu vous travaillerez avec une copie). 1- PRESENTATION AZ est un EDITEUR DE TEXTES, ce qui veut dire que toute l'information contenue dans les fichiers qu'il crée est constituée de caractères, imprimables ou non. Contrairement à un traitement de textes, AZ n'ajoute pas à l'enregistrement de commandes codées qui, soustraites du texte à la lecture, sont interprétées pour modifier l'affichage ou l'impression (formatage, justification, changement de police de caractères dans le texte...). Moyennant quoi : - les 256 caractères de la table de caractères (keymap) active peuvent être enregistrés, soit en les entrant au clavier, soit par le biais de la commande menu "Tools/Insert Hex" ou de son équivalent clavier . - les textes produits par AZ peuvent être directement soumis à un interpréteur, un compilateur ou un assembleur. 1.1- Technique : 1.1.1- AZ est multi-fenêtres : on peut ouvrir simultanément plusieurs fenêtres en lançant la commande menu "Tools/New Window"ou un de ses équivalents clavier ou . Commode pour visualiser ou travailler dans plus d'un texte à la fois. 1.1.2- AZ est multitâches : lancer un travail long ne bloque pas AZ mais seulement la fenêtre concernée. Rien n'empêche alors de travailler dans une autre. Par exemple, on peut imaginer trois textes A, B, C chargés dans trois fenêtres d'AZ et simultanément : - imprimer A - envoyer B vers le modem - écrire dans C. 1.1.3- le code d'AZ est réentrant et partagé : en clair, le code d'AZ n'est chargé que lorsqu'AZ est lancé, après quoi toute fenêtre ouverte est une nouvelle tâche d'AZ exploitant le MEME code, en commun avec les autres tâches. Ce code ne sera déchargé qu'à la fermeture de la dernière fenêtre d'AZ. 1.2- Ergonomie : l'interface utilisateur d'AZ a été conçue en prenant en compte les critères suivants : 1.2.1- affichage permanent des informations de base : - les ascenseurs donnent la position de la page affichée dans le fichier. - la barre de titre (cf 5.1) - le bloc sélectionné est visualisé 1.2.2- évidence des commandes de base : le déplacement du curseur, la sélection de bloc, le défilement du texte, la gestion des fichiers sont faits pour être "découverts" par un utilisateur d'Amiga sans avoir recours au Manuel. 1.2.3- redondance des commandes : les commandes les plus fréquemment utilisées ont de multiples points d'accès pour tomber toujours sous la main, que celle-ci manipule le clavier ou la souris. Par exemple, pour iconifier une fenêtre on peut : - avec la souris, cliquer dans le gadget de la barre de titre, ou appeler le menu "Tools/Iconify". - au clavier, entrer ( étant la touche Amiga droite ou gauche) ou la touche . N.B. certaines touche du clavier, dont , ont un effet non-standard, détaillé au chapitre 6.1. 1.3- Limites : Le nombre des fenêtres ouvertes dans AZ et la taille des fichiers édités ne sont limités que par la mémoire disponible. Chaque ligne est longue au maximum de 256 caractères. 1.4- Variantes : AZ est proposé en deux variantes, selon que le code des Requesters a été intégré au code de AZ lors de l'édition de liens (variante "longue" 63096 octets) ou qu'il est chargé en mémoire (sous forme de "librairie partagée") lorsqu'AZ est lancé (variante "courte" 45868 octets) - avec menus en français, respectivement 63252 o et 46024 o. 1.4.1- La version longue : a l'avantage d'être immédiatement disponible. 1.4.2- La version courte : partage le code des Requesters avec d'autres programmes, par exemple d'autres AZ lancés avec des paramètres différents. Ce code, contenu dans "isup.library" n'est chargé en mémoire qu'une fois. Les possibilités d'AZ sont strictement identiques quelle que soit la version. AZ se veut un outil FACILE D'EMPLOI, RAPIDE et ECONOME EN MEMOIRE. A vous de juger... 2- INSTALLATION L'installation d'AZ est simplissime : 2.1 La version "longue" : environ 65 ko, sera copiée avec son icône dans le répertoire de votre choix, disquette, disque dur, disque virtuel et pourra être utilisée aussitôt. 2.2 La version "courte" : s'installe de la même façon que la version longue, mais il faudra en outre vous assurer de la présence de "isup.library" dans le répertoire "LIBS:". "isup.library" se trouve dans le même tiroir qu'AZ version "courte" ( environ 45 ko). 3- LANCEMENT 3.1- Les Options : 3.1.1- L'option -a : inverse la couleur d'activation de la barre de titre de la fenêtre (cf 5.2.2). 3.1.2- L'option -b : modifie les couleurs: couleur 0 pour le fond et 1 pour le texte. Par défaut c'est le contraire (cf 5.2.2). 3.1.3- L'option -cn : fixe le nombre maximum de colonnes par ligne: -c80 pour des lignes de 80 colonnes. Par défaut, la ligne est longue au maximum de 256 caractères. 3.1.4- L'option -d : désactive l'effacement automatique d'un bloc lorsqu'on appuie sur une touche ou lors d'un Paste. Il faut alors avoir recours à la commande Cut ou à la touche pour effacer un bloc. 3.1.5- L'option -e : lance l'exécution d'une commande par AZ avant que la première fenêtre s'ouvre, et/ou après que la dernière a été fermée. -eb"Assign X: mydir" commande exécutée avant (before) -ea"mwb c" commande exécutée après (after) trés utile dans les alias. Exemple: pour le Shell Amiga: alias AZ AZ -eb"mwb n" -ea"mwb c" [] ('mwb' est un programme de Matt Dillon qui permet d'utiliser plusieurs écrans WorkBench). Avec cette commande AZ ouvre donc une fenêtre sur un nouvel écran, puis ferme l'écran dès que l'on quitte AZ. 3.1.6- L'option -fn : La police de caractères est topaz, corps identique à celui du WorkBench par défaut. Cette option permet d'utiliser topaz avec un autre corps : -f9 = topaz/9. (Que le corps utilisé par le WorkBench soit 8 ou 9). -f11 = topaz/11 . ce qui peut beaucoup améliorer la lisibilité si une fenêtre AZ est destinée à être utilisée dans un écran entrelacé (cf 5.2.1 et 5.2.3). 3.1.7- L'option -i : pour rechercher des chaînes de caractères sans différencier les Majuscules des minuscules. Cette option peut être modifiée en cours d'édition par la commande menu "Find/Case: Insensitive", ou son équivalent clavier . A noter qu'une zone de la barre de titre indique quand Majuscules et minuscules sont différenciées en affichant un 'S' (cf 5.1.5). 3.1.8- L'option -k : assure la sauvegarde automatique de la version précédant la version courante : à chaque demande de sauvegarde, AZ copie d'abord le fichier qui va être écrasé dans T:, sous le nom "AZ-.bkp ( est en hexadécimal). ATTENTION : une fenêtre = une tâche, si vous multipliez les fenêtres, vous multipliez les fichiers de sauvegarde et vous risquez d'encombrer le disque ou la mémoire. 3.1.9- L'option -l : la sélection de bloc se fait alors par lignes entières. Il n'est donc plus possible de sélectionner un bloc par caractères ou par mots. De même, l'insertion de texte ne se fait plus immédiatement avant le curseur, mais sur la ligne précédant celle du curseur. 3.1.10- L'option -m : rend la commande menu "Edit/Send Selected" compatible avec le Minitel. Le texte est envoyé à 1200 bauds vers le Minitel, AZ ajoutant alors des temporisations après chaque ligne, pour obtenir un débit moyen de 75 bauds. Par ailleurs, il faut s'assurer que le port série est configuré ainsi dans Preferences : - Baud Rate 1200 - Buffer Size de 512 à 4096 - Read Bits 7 - Write Bits 7 - Stop Bits 1 - Parity Even - Handshaking None 3.1.11- L'option -o : fixe le mode de création des caractères, qui viennent alors en remplacement des caractères du fichier. Ce sera le mode initial de toutes les fenêtres ouvertes à partir de cette occurrence d'AZ. Par défaut, les caractères créés sont insérés dans le texte. La commande menu "Edit/Mode Ins/repl" permet de modifier ce choix en cours d'édition dans une fenêtre à la fois. Le mode actif est rappelé dans la barre de titre de la fenêtre par les lettres 'I' ou 'R' (cf 5.1.5). 3.1.12- L'option -p : permet de filtrer les fichiers affichés dans le FileRequester. Par défaut, tous les fichiers d'un répertoire sont affichés, à l'exception de ceux qui se terminent par ".info". Les jokers utilisés sont ceux d'Unix : - * remplace une chaîne de caractères, - ? remplace un caractère, - [c1 c2 c3...] n'importe quel caractère parmi c1 c2 c3... - [c1-cn] n'importe quel caractère dans l'intervalle c1 à cn Quelques exemples : -p* tous les fichiers (équivalent au filtre par défaut) -p*.c tous les fichiers se terminant par ".c" -p*?? tous les fichiers d'au moins 2 lettres -p*?.[ahc] tous les fichiers comportant au moins une lettre avant le suffixe ".a", ".h" ou ".c". -p[A-Z]*[0-9] tous les fichiers commençant par une majuscule et se terminant par un chiffre. -p???? tous les fichiers de quatre lettres... Voir aussi la documentation du FileRequester de Gauthier GROULT. 3.1.13- L'option -r : par défaut crée une ligne nouvelle et place le curseur sur la même colonne que le premier caractère de la ligne située immédiatement au-dessus. Si cette ligne est vide, le curseur est placé dans la première colonne (la plus à gauche). Cette option permet de placer le curseur après un dans la même colonne que le premier caractère de la première ligne non vide du dessus. Pour ramener le curseur plus à gauche on utilisera ou , ou la souris... Cette option aura le même effet sur . 3.1.14- L'option -s : le nom de fichier indiqué dans la fenêtre est celui qui sera utilisé par la commande menu "Project/Save" et son équivalent clavier . Par défaut, ce nom reste inchangé après la commande menu "Project/Save As" et son équivalent clavier . Cette option donne au fichier en cours le nom utilisé par la dernière sauvegarde. 3.1.15- L'option -tc : règle la taille d'une tabulation. AZ soustrait 48 au code ASCII 'c': -t8 --> une tabulation = 8 espaces. -tB --> une tabulation = 18 espaces. Le défaut est 4, et si 'c' est inférieur à 1, tab. = 4 espaces. 3.1.16- L'option -x : cette option place le curseur au début du bloc inséré par les commandes menu "Edit/Paste" (ou

), "Edit/Undel Block" (ou ) et , alors que par défaut il est placé en fin. 3.2- A partir du CLI : 3.2.1- la ligne de commande : est de la forme : - AZ [-a][-b][-cn][-d][-e(a|b)][-fn][-i][-k][-l][-m][-o][-p] [-r][-s][-tc][-x] [[dir] | [file1]...[fileN]] [-a]....[-x] : les options, toutes facultatives [dir] : un répertoire sur lequel le FileRequester fera ses recherches OU (exclusif) : [file1]...[fileN] : une liste de fichiers, chacun ouvrant une fenêtre puis s'iconifiant, sauf le dernier qui reste affiché. 3.2.2- "Run" inutile : AZ rend la main au CLI dès qu'il est chargé. Le CLI peut alors être utilisé pour lancer d'autres tâches, voire fermé. Il est donc tout à fait inutile d'avoir recours à "Run" ou à "Runback" pour lancer AZ. 3.2.3- "Resident" interdit : Les commandes "Resident" (AmigaDOS) "ARes" (ARP) "Resi" (WShell) ou similaires ne peuvent qu'attirer le GURU. Bien que réentrant, le code d'AZ sait modifier ses propres segments, ce qui lui donne des propriétés intéressantes mais le rend incompatible avec les commandes ci-dessus. Elles sont d'ailleurs peu utiles, puisque le code d'AZ est chargé une seule fois à l'ouverture de la première fenêtre, sera partagé par toutes les fenêtre successivement ouvertes et ne sera déchargé qu'à la fermeture de la dernière fenêtre : il suffit donc de garder au minimum une fenêtre vide iconifiée pour que le code d'AZ reste disponible. Le fait qu'AZ ne peut être résident permet de charger plusieurs fois le code d'AZ avec des options différentes. 3.3- A partir du WorkBench : 3.3.1- appel d'AZ : tout à fait standard : soit - Cliquer sur l'icône d'AZ. - Cliquer sur l'icône d'un fichiers texte ayant AZ comme outil par défaut. - Sélectionner les icônes de fichiers texte, puis, la touche demeurant enfoncée, double-cliquez sur l'icône AZ. 3.3.2- passage de paramètres : les options décrites en 1.1 peuvent être passées à AZ lancé depuis le WorkBench, de même que des noms de fichiers. Pour cela, après avoir appelé la fenêtre Info correspondant à AZ, cliquer sur le gadget ADD de TOOL TYPES et entrer : PARM=[opt1][opt2]...[optn][[dir] | [fichier1]...[fichiern]] -ex : PARM=-m -k -t8 mem.c data.c Le mot "PARM=" est obligatoire. Pas d'espace autour de '='. 3.3.3- icônes : AZ ne crée pas d'icônes. Si vous désirez que vos fichiers texte en dispose, c'est à vous de les créer. 4- MANIPULATION DE FICHIERS La manipulation de fichiers fait beaucoup appel au FileRequester de Gauthier GROULT. Celui-ci fait l'objet d'une documentation séparée intégrée dans le Manuel sous le nom "FR.man". Les commandes de manipulation de fichiers sont regroupées dans le menu "Project". On y trouve, successivement : 4.1- New : La fenêtre se vide de son texte, tandis que la Barre de Titre affiche "Untitled" à l'emplacement du nom de fichier. 4.2- Open : Equivalent clavier : . Appelle le FileRequester en vue de charger un fichier. 4.3- Load Binary : Appelle le FileRequester en vue de charger un fichier binaire. Dans ce cas, les ne sont pas convertis en espaces. Par contre les espaces en fin de ligne sont éliminés, ce qui peut poser des problèmes si vous tentez de sauvegarder le fichier. Moralité : utilisez AZ pour explorer un fichier binaire, pas pour le patcher. 4.4- Save : Equivalent clavier : , . Sauvegarde le fichier en cours sous son nom actuel, dans le répertoire actuel, tel qu'il est affiché dans la barre de titre. Cependant, si le fichier a été créé dans AZ et n'a jamais été sauvegardé (il s'appelle "Untitled"), "Save" ce comporte alors comme "Save as". Lors de toute sauvegarde, les flags de protection lus lors du chargement sont restaurés. 4.5- Save as : Equivalent clavier : . Permet de sauvegarder le fichier en cours en modifiant son nom, son répertoire ou les deux. Par défaut, la fenêtre ne modifie pas le nom du fichier en cours (IMPORTANT : cf 3.1.14). 4.6- Cur Dir : Equivalent clavier : . Permet de modifier le répertoire courant, celui qu'explorera le FileRequester lorsqu'il sera appelé. Le FileRequester qui apparait est modifié : la ligne de saisie du nom de fichier n'est pas accessible. 4.7- Erase : Permet d'effacer un fichier sélectionné avec le FileRequester. Comme à chaque fois qu'il y a risque de destruction d'un fichier, un Requester demande confirmation avant toute action. 4.8- Quit : Equivalent clavier : . Permet de quitter la fenêtre active. Action identique à un clic dans le gadget de fermeture de fenêtre (cf 5.1.1). La touche permet de combiner sauvegarde et fermeture de fenêtre. 5- LA FENETRE 5.1- La Barre de Titre : Par défaut, la barre de titre s'affiche dans la couleur 0 de Préférences (les couleurs étant numérotées de gauche à droite de 0 à 3) lorsqu'elle est active, dans la couleur 3 sinon. Cette convention peut être inversée par utilisation de l'option -a lors du chargement d'AZ. On y trouve, de gauche à droite: 5.1.1- un gadget de fermeture de fenêtre : qui fonctionne de façon habituelle, à ceci près : - si le texte à l'écran a été modifié depuis la dernière sauvegarde, un requester apparait, qui demande confirmation avant de fermer la fenêtre. - si la fenêtre à fermer est la dernière fenêtre d'AZ, le code d'AZ sera déchargé. 5.1.2- un indicateur de position verticale du curseur : de la forme : 'n/t' où 'n' est la ligne où est située le curseur et 't' le nombre total de lignes du texte à l'écran. 5.1.3- un indicateur de position horizontale du curseur : de la forme : 'n', 'n' étant la colonne où est située le curseur. 5.1.4- code ASCII : un nombre hexadécimal (forme '0xhh') indique le code ASCII du caractère situé sous le curseur. 5.1.5- un indicateur du mode de création des caractères : - I est affiché si les caractères nouveaux sont insérés dans le texte à l'écran. - R est affiché si les caractères nouveaux viennent en remplacement des caractères affichés. Cet indicateur est modifié par le menu "Edit/Mode Inst/Repl". 5.1.6- un indicateur de "sensibilité" des fonctions 1de recherche aux majuscules/minuscules : - S signifie que les recherches tiendront compte des Majuscules et des minuscules. - rien n'est affiché dans le cas contraire. Cet indicateur est modifié par le menu "Find/Case: Sensitive", "Find/Case: Insensitive". 5.1.7- le nom complet du fichier en cours d'édition : "Untitled" dans le cas où il n'a pas encore reçu de nom. A noter que si le nom du fichier est trop long, il est tronqué à droite. 5.1.8- la mention "(modified)" : si le fichier à l'écran a été modifié depuis sa dernière sauvegarde. 5.1.9- un gadget d'icônification : de la fenêtre (cf 5.4). 5.1.10- un gadget modifiant la taille de la fenêtre : affichant alternativement la fenêtre en plein écran et en taille réduite. A noter qu'AZ se souvient de la taille réduite et de la position attribuées précédemment à une fenêtre, et restitue celles-ci lors de l'emploi du gadget. Equivalent clavier : . 5.1.11- une paire de gadgets de profondeur. 5.2- L'Affichage du texte : 5.2.1- police de caractères : La police de caractères utilisée par AZ est topaz, corps identique à celui du WorkBench par défaut. Le corps peut être modifié par l'option -fn au chargement, où 'n' est le corps désiré. Ex : - -f11 charge AZ avec topaz/11 ce qui permet une bonne lisibilité en mode entrelacé et - -f8 force le corps à 8 même si le corps 9 est sélectionné dans Preferences. Une fenêtre occupant tout l'écran affiche : - PAL écran 640*256 topaz/8 29 lignes de 76 caractères - topaz/9 26 lignes de 61 caractères - topaz/11 20 lignes de 76 caractères - NTSC écran 640*200 topaz/8 22 lignes de 76 caractères - topaz/9 20 lignes de 61 caractères - topaz/11 15 lignes de 76 caractères le nombre de lignes affichées est doublé dans un écran en mode entrelacé. 5.2.2- couleurs : Les couleurs qu'AZ utilise par défaut sont - couleur 1 pour le fond - couleur 0 pour le texte édité - couleur 0 pour le texte du titre si la fenêtre est active - couleur 3 pour le texte du titre si la fenêtre est inactive l'option -b affiche - couleur 0 pour le fond - couleur 1 pour le texte édité l'option -a affiche - couleur 3 pour le texte du titre si la fenêtre est active - couleur 0 pour le texte du titre si la fenêtre est inactive Rappelons que les couleurs de Preferences sont numérotées de gauche à droite, de 0 à 3. 5.2.3- écran : L'écran où se charge AZ est l'écran du WorBench. La commande menu "Tools/To Front Screen" permet de transférer la fenêtre d'où est lancée la commande dans l'écran le plus en avant. Il est possible ainsi d'avoir plusieurs fenêtres dans des écrans différents, en haute résolution (largeur 640 pixels), entrelacés ou non (hauteur 512 ou 256 pixels). Il est également possible de transférer une fenêtre d'AZ dans un écran basse résolution (320*256 ou 320*200), la fenêtre s'ajustant d'elle-même à la taille d'écran; la Barre de Menu est amputée, et toute tentative d'utiliser le FileRequester est vouée à l'échec (il est plus large que 320 pixels). 5.3- Défilement du texte : 5.3.1- Barres de défilement : la partie inférieure et la partie gauche d'une fenêtre d'AZ sont occupées par des barres de défilement. La barre de gauche commande le défilement vertical du texte et comporte, de haut en bas : - un gadget double de défilement. Un clic du bouton gauche de la souris fait monter ou descendre le texte d'une ligne selon le sens de la flèche pointée. Si le bouton gauche est maintenu enfoncé, le texte défile en continu. - un ascenseur standard Amiga, dont le fonctionnement est décrit dans votre Manuel Amiga. - un autre gadget double de défilement identique à celui du haut. La présence de deux gadgets identiques réduit les déplacements de la souris. - à noter que pendant le défilement du texte commandé par un gadget double, la position de l'ascenseur n'est pas modifiée, ce qui permet un défilement rapide. La barre inférieure est identique et commande le défilement horizontal du texte. La position du curseur n'est pas affectée par la manipulation des barres de défilement. Frapper une touche quelconque, outre son effet habituel, centre le texte sur la ligne contenant le curseur. Très pratique pour aller se placer sur une autre partie du texte via les Gadgets, puis revenir à son point de départ à l'aide d'une (les flèches permettent de ne pas modifier le texte). 5.3.2- Le Menu "Tools/Go To Line" : et son équivalent clavier fait apparaître un Requester dans lequel on entre un numéro de ligne. La ligne recherchée se place au milieu de la fenêtre. 5.3.3- Défilement lié aux mouvements du curseur : Lorsque le curseur est déplacé hors de la partie du texte à l'écran, AZ modifie l'affichage pour montrer la zone de texte centrée sur la nouvelle position du curseur. Les déplacements de texte de ce type sont décrits en "6.3- Déplacement du curseur". 5.3.4- Défilement lié à la définition d'un bloc : Si l'on dépasse les limites de la fenêtre alors qu'on sélectionne un bloc, le texte défile dans la direction où l'on dépasse. Ce type de défilement de texte est décrit en "7.1- Selection d'un bloc". 5.3.5- Défilement commandé par les touches flèches : déplace le curseur (et l'affichage) d'une hauteur de fenêtre vers le haut ou le bas. Lorsqu'un bloc est défini, les touches flèches commandent le défilement du texte dans la direction de la flèche (sauf si l'option -d a été utilisée au chargement). 5.4- Icônification : Il est souvent commode de profiter des possibilités de multi-fenêtrage d'AZ pour avoir plusieurs fichiers disponibles à la fois. Cependant, la multiplication des fenêtres de travail pose très vite un problème de lisibilité de l'écran. La solution proposée dans AZ est l'icônification. 5.4.1- définition : une fenêtre icônifiée est une fenêtre réduite à sa barre de titre dépourvue de tout gadget. La seule indication qui y figure est le nom du fichier qu'elle contient, sans son chemin d'accès. 5.4.2- couleurs : la couleur du fond est la couleur 3, le texte étant de la couleur 2, si le fichier est à jour de sauvegarde. Dans le cas contraire (équivalent à la mention "(Modifié)" de la fenêtre normale, les couleurs sont inversées. 5.4.3- les commandes d'icônification : - par gadget dans la Barre de Titre de la fenêtre - par le menu "Tools/Iconify" - par le clavier - par la touche de fonction 5.4.4- position : par défaut, AZ aligne les fenêtres icônifiées dans la Barre de Menu. Cependant une fenêtre icônifiée peut être déplacée. AZ se souvient de l'emplacement de l'icône lorsque la fenêtre est agrandie. C'est là qu'il placera la fenêtre icônifiée à la première occasion. 5.4.5- retour à une taille de travail : pour agrandir une fenêtre icônifiée, il suffit de la rendre active et d'y faire une entrée quelconque (touche du clavier, bouton droit de la souris). A l'exception de qui commande l'ouverture d'une nouvelle fenêtre. lors du retour à une taille de travail, toutes les caractéristiques de la fenêtre originelle sont restituées : - police de caractères, - couleurs du fond et du texte, - couleurs de la Barre de Titre, - position du texte, - position du curseur, - définition de bloc. 6- LE CLAVIER 6.1- Particularités du clavier : Le clavier fonctionne de façon standard, avec cependant quelques exceptions: 6.1.1- La touche : crée une nouvelle ligne où va se placer le curseur, sans pour autant déplacer la partie de texte située initialement après le curseur. Pour couper la ligne au niveau du curseur, il faut frapper . Autre particularité d'AZ, après un , le curseur ira se placer sous la première colonne non-vide de la première ligne non-vide au-dessus si l'on a fait appel à l'option -r (cf 3.1.13). Pour retourner à la première colonne de la ligne en cours, il faut taper . 6.1.2- La touche : a des caractéristiques semblables à , à ceci près que le curseur va se placer sur la nouvelle ligne à une tabulation arrière de la première colonne occuppée de la ligne précédente (dé-indentation). 6.1.3- Les touches : positionne le curseur sur le premier caractère non-blanc de la ligne. 6.1.4- Les touches : reculent le curseur d'une tabulation. 6.1.5- Les touches : effacent la ligne courante. Le texte effacé est rangé dans le ClipBoard 1 et peut donc être récupéré par la commande "Edit/Undel Block". Très commode pour déplacer une ligne : - on place le curseur dessus - l'efface - on place le curseur au début de la position recherchée - insère la ligne. 6.1.6- Les touches : effacent de la position du curseur à la fin de la ligne. Comme précédemment, le texte effacé est copié dans le ClipBoard 1. 6.2- Le Keymap : AZ se configure sur le Keymap courant au moment du chargement. Dans le cas où vous souhaitez utiliser un Keymap différent de celui du CLI, il est possible d'utiliser l'option -e (cf 3.1.5). - alias USAZ AZ -eb"system:setmap usa1" -ea"system:setmap f" [] A l'aide d'un editeur de keymap (ex: KeymapEd de Tim Friest du domaine public, dans les Fish ou sur Sgt FLAM) il est donc possible de configurer une touche ou combinaison de touches, par exemple : - devient (double tabulation arrière). - devient "Je vous prie de bien vouloir agréer, cher Monsieur le Directeur, l'expression de ma respectueuse considération". 6.3- Déplacement du curseur : 6.3.1- Avec la souris : un clic sur le bouton de gauche, et le curseur va se placer sous le pointeur de la souris. Dans le cas où le pointeur est situé sous la dernière ligne du texte, le curseur se placera sur la dernière ligne, dans la même colonne que que le pointeur. 6.3.2- Au clavier : les quatres touches flèches sont dédiées aux mouvements du curseur : - une frappe, et le curseur se déplace dans la direction de la flèche. - : le curseur se place sur la colonne 1. - : le curseur se place une colonne après le dernier caractère de la ligne. - ou - : le curseur se déplace d'une hauteur de fenêtre dans la direction de la flèche. 6.4- Les touches de fonctions : Elles permettent de passer à AZ les commandes les plus fréquemment utilisées ou des commandes combinées. 6.4.1- La touche : fait apparaître un Requester où sont résumés : - les commandes passées par les touches de fonction. - le fonctionnement de la touche . 6.4.2- "Insert File" : appelle le FileRequester, copie le fichier choisi dans le ClipBoard 0, et insère le contenu du ClipBoard 0 dans le texte, immédiatement avant le curseur par défaut (cf 3.1.16). Equivalent aux commandes "Edit/Copy From File" plus "Edit Paste". 6.4.3- "Save Selected" : copie le texte sélectionné dans le ClipBoard 0, et sauve le contenu du ClipBoard 0 dans le fichier choisi via le FileRequester. Equivalent aux commandes "Edit/Copy" plus "Edit/Paste To File". 6.4.4- "New Window" : comme "Tools/New Window" et , crée une nouvelle fenêtre d'AZ. 6.4.5- "Copy" : comme "Edit/Copy" et , copie le texte sélectionné dans le ClipBoard 0 (cf 7.4). 6.4.6- "Paste" : comme "Edit/Paste" et

, insère le contenu du ClipBoard 0 immédiatement avant le curseur (cf 7.3). 6.4.7- "Find" : comme "Find/Find" et , appelle un Requester de saisie, puis recherche la chaîne qui y a été affichée (cf 8.1). 6.4.8- "Go To Line" : comme "Tools/Go To Line" et , appelle un Requester de saisie, puis place le curseur sur la ligne dont le numéro a été entré (cf 9.2). 6.4.9- "Iconify" : Iconifie la fenêtre (cf 5.4 et 9.1). 6.4.10- "Switch Size" : change la taille de la fenêtre active. 6.4.11- "Save" : Sauvegarde le fichier en cours (cf 4.4). 6.4.12- "Save and Quit" : ferme la fenêtre après sauvegarde du fichier qu'elle contient. 7- EDITION ET MANIPULATION DES BLOCS Certaines opérations n'affectent qu'une partie du fichier en cours; aussi, avant de les lancer, convient-il de délimiter la zone de texte qui sera traitée : c'est le bloc. Dans AZ, un bloc à une couleur différente du reste du texte : les caractères sont dans la couleur 2 de l'écran et le fond dans la couleur 3. Un bloc contient au moins un caractère, au plus l'ensemble du fichier en cours. 7.1- Sélection d'un bloc : 7.1.1- à l'aide de la souris : il suffit de maintenir enfoncé le bouton gauche de la souris et de la déplacer pour voir le bloc se dessiner dynamiquement. - en enfonçant directement le bouton, la sélection se fait caractère par caractère. - un double clic, l'unité de sélection est le mot. - un triple clic, l'unité de sélection est alors la ligne. - si AZ a été lancé avec l'option -l, l'unité de sélection est la ligne dans tous les cas (cf 3.1.9). Pour définir un bloc statiquement, placer le curseur à une extrémité du bloc à définir, puis, en maintenant une des touches enfoncée, aller cliquer sur l'autre extrémité. Un bloc est immédiatement défini entre ces deux points. Pour annuler un bloc, il suffit de cliquer sur la position du texte où on souhaite placer le curseur. NB : si la sélection d'un bloc va au-delà du dernier caractère de la dernière ligne, alors la ligne toute entière est sélectionnée. 7.1.2- au clavier : on peut également définir les blocs à partir du clavier, en utilisant la touche en combinaison avec les touches flèches, ou avec la barre d'espace utilisée comme le bouton de gauche de la souris. La combinaison est particulièrement intéressante lorsqu'on a "raté" un bloc en le dessinant à la souris. Il est plus rapide d'ajouter ou de retrancher quelques caractères en fin de bloc que de redéfinir le bloc en entier. La combinaison définit un bloc entre la position actuelle du curseur et la fin du fichier dans la direction de la flèche. A noter que si la dernière ligne du fichier n'est pas terminée par un , le bloc se positionne dans la colonne 1 de la dernière ligne. La combinaison désélectionne le bloc, le curseur étant alors placé sur le dernier caractère du bloc annulé par défaut (cf option -x 3.1.16). 7.1.3- par menu : voir plus bas "Edit/Select Word" (7.9) et "Edit/Select All" (7.10). 7.2- Effacement d'un bloc : Par défaut, un bloc est remplacé à l'écran par tout caractère entré. Cette caractéristique d'AZ peut être désactivée par l'option -d (cf 3.1.4). Il est simplement effacé si est frappé. Dans tous les cas où le texte est effacé, il est placé dans le ClipBoard 1 où il reste disponible tant qu'un nouveau bloc n'est pas effacé par ce moyen (cf. 7.14). Les commandes d'édition sont regroupées dans le menu "Edit". On y trouve, successivement : 7.3- Paste : Equivalent clavier :

et . Commande la copie du texte contenu dans le ClipBoard 0, à partir du curseur, le curseur étant placé par défaut à la fin du texte inséré (cf option -x 3.1.16). 7.4- Copy : Equivalent clavier : et . Doit être précédé de la définition d'un bloc. Copie le texte du bloc dans le ClipBoard 0. 7.5- Cut : Equivalent clavier : . Doit être précédé de la définition d'un bloc. Transfère le texte du bloc dans le ClipBoard 0 (en effaçant le texte sélectionné). 7.6- Clone Line : Equivalent clavier : . Recopie la ligne contenant le curseur sur la ligne immédiatement au-dessous. 7.7- Join Lines : Equivalent clavier : . Insère un espace à la fin de la ligne courante, puis y joint la ligne suivante. 7.8- Mode Ins/Repl : Equivalent clavier : . Bascule le mode de création des caractères d'insertion (le défaut) à remplacement, et inversement, et le signale sur la Barre de Titre (cf 3.1.11 et 5.1.5). 7.9- Select Word : Equivalent clavier : <1>. permet de sélectionner le mot portant le curseur (cf aussi 8.6). 7.10- Select All : Equivalent clavier : sélectionne l'ensemble d'un fichier courant. 7.11- Copy From File : Appelle le FileRequester puis copie le fichier choisi dans le ClipBoard 0. 7.12- Paste To File : Sauvegarde le contenu du ClipBoard 0 dans le fichier choisi avec le FileRequester. 7.13- Print Selected : Equivalent clavier : <;>. Doit être précédé de la définition d'un bloc. Envoie le texte du bloc à l'imprimante en utilisant les réglages définis dans Preferences. Les lignes de début et de fin du bloc sont imprimées en entier. A noter qu'il est possible d'interrompre l'impression en cours en appuyant sur . 7.14- Send Selected : Doit être précédé de la définition d'un bloc. Envoie le texte du bloc vers le port série en utilisant les réglages définis dans Preferences. Les lignes de début et de fin du bloc sont envoyées en entier. Peut être utilisé avec un Minitel grâce à l'option -m (cf 3.1.10 en particulier pour la configuration de Preferences). Le code ajouté à la fin de chaque ligne est choisi dans le sous-menu : 7.14.1- CR : ou Carriage Return (retour chariot) (0x0D). 7.14.2- LF : ou Line Feed (saut de ligne) (0x0A) 7.14.3- CRLF : ou Carriage Return+Line Feed (0x0D 0x0A) 7.14.4- SUITE : Touche du Minitel (0x13 0x48) permet l'envoi de texte vers un serveur Vidéotex et donc traduit les caractères accentués Amiga en caractères accentués Minitel. Noter que pour obtenir 'O dans E' ou 'o dans e' sur le minitel il faut écrire 'Æ' ou 'æ' dans AZ (Insert Hex: C6 et E6). Il peut être utile de connaître les touches de fonction du Minitel. Elles émettent deux codes, et une lettre de A à I: - ENVOI: A (0x13 0x41) - RETOUR: B (0x13 0x42) - REPETITION: C (0x13 0x43) - GUIDE: D (0x13 0x44) - ANNULATION: E (0x13 0x45) - SOMMAIRE: F (0x13 0x46) - CORRECTION: G (0x13 0x47) - SUITE: H (0x13 0x48) - CONNEXION/FIN: I (0x13 0x49) 7.14.5- ASIS : lire "as is", tel quel. AZ n'utilise pas un caractère pour marquer les fins de ligne, le bloc est donc transmis sans marques de fin de ligne. A noter qu'il est possible d'interrompre le transfert en cours en appuyant sur . 7.15- Undel Block : Equivalent clavier : . AZ gère un ClipBoard 1 où est placé le dernier bloc effacé autrement que par la commande menu "Edit/Cut". Cette commande permet de copier le contenu du ClipBoard 1 à partir du curseur. En particulier si elle est lancée immédiatement après l'effacement accidentel d'un bloc, sans que le curseur aie été déplacé, elle restaurera le texte dans son état antérieur (cf 6.1.5). 7.16- Indentation par bloc de lignes entières : Si un bloc a été défini par lignes entières (par triple clic ou option -l), il devient possible de l'indenter ou de le dé-indenter en une seule opération : on utilise et pour le déplacer par tabulations entières, et les flèches horizontales pour le déplacer d'un caractère à la fois. 8- RECHERCHE Les commandes de recherches de texte sont réunies dans le menu "Find". Pour des raisons de clarté, nous ne suivrons pas tout à fait l'ordre où elles sont proposées. 8.1- Find : Equivalent clavier : et . Envoie un Requester où peut être saisie la chaîne de caractères à rechercher. Après validation du Requester, le fichier est exploré entre la position courante du curseur et la fin du texte. Si la recherche aboutit, la première occurence de la chaîne est sélectionnée. En cas d'échec, un Requester vous informe et le curseur n'est pas déplacé. A noter que la chaîne saisie sera affichée au prochain appel du Requester. 8.2- Find Selected : Equivalent clavier : <2>. Effectue le même travail que "Find", à ceci près que la chaîne selectionnée dans un bloc est directement saisie, sans intervention du Requester (cf aussi 8.6). 8.3- Find Next : Equivalent clavier : . Cherche à partir de la position courante du curseur vers la fin du texte la prochaine occurence de la chaîne saisie précemment. 8.4- Find Back : Equivalent clavier : . Cherche à partir de la position courante du curseur vers le début du texte la prochaine occurence de la chaîne saisie précemment. 8.5- Exchange : Equivalent clavier : . Propose un Requester où seront saisies deux chaînes de caractères, la seconde étant destinée à se substituer à la première. Après validation du Requester, le fichier est exploré entre la position courante du curseur et la fin du texte. Si la recherche aboutit, la première occurence de la chaîne à remplacer est sélectionnée. La substitution sera effectuée par les commandes "Exchange Next". ou "Exchange All" (cf 8.7 et 8.9). En cas d'échec, un Requester vous informe et le curseur n'est pas déplacé. A noter que les chaînes saisies seront affichées au prochain appel du Requester. La chaîne recherchée est également copiée dans le Requester appelé par "Find". Très utile lorsque l'on ne veut pas remplacer toutes les occurences d'une chaîne : - si l'on veut effectuer le remplacement de la chaîne sélectionnée, on fait "Find/Exchange Next" pour aller rechercher l'occurence suivante. - si l'on veut simplement rechercher la prochaine occurence, on fait "Find/Find Next". 8.6- Exchange Selected : Equivalent clavier : <3>. Propose un Requester où est affichée deux fois la chaîne sélectionée. Il suffit en général de la modifier dans la ligne de substitution pour que le Requester soit prêt à être validé. Dans ce cas, la première substitution aura lieu et le curseur ira se placer en fin de la chaîne substituée. L'équivalent clavier a été choisi en pensant à une séquence de travail fréquemment répétée : - <1> <3> : je sélectionne le mot sous le curseur et je le saisis dans le Requester de substitution - <1> <2> : je sélectionne le mot sous le curseur et je recherche sa première occurence dans la suite du texte (cf 7.9 et 8.2). 8.7- Exchange Next : Equivalent clavier : . Effectue la substitution de la chaîne sélectionnée, et va selectionner sa prochaine occurence vers la fin du texte. Pour que cette commande soit active, la chaîne à rechercher et la chaîne a lui substituer doivent avoir été saisies. Dans le cas contraire, un message d'erreur est affiché. 8.8- Exchange Back : Equivalent clavier : . L'action est identique à celle de "Exchange Next" (8.7), la recherche étant menée en revenant vers le début du texte. 8.9- Exchange All : Equivalent clavier : <=>. Effectue toutes les substitutions possibles à partir du curseur en allant vers la fin du texte. 9- LES OUTILS : Diverses fonctions utilitaires d'AZ ont été regroupées dans le menu "Tools". On y trouve : 9.1- Iconify : Equivalent clavier : et . Provoque l'icônification de la fenêtre (cf 5.4), de même que la touche et un gadget de la barre de titre (5.1.9). 9.2- Go To Line : Equivalent clavier : et . Appelle un Requester où sera saisi le numéro de la ligne à atteindre. Le curseur ira prendre place sur cette ligne dès la validation du Requester. 9.3- New Window : Equivalent clavier : , . Ouvre une nouvelle fenêtre d'AZ. 9.4- Insert Hex : Equivalent clavier : . Appelle un Requester où seront saisies des valeurs en hexadécimal. A la validation du Requester, l'équivalent ASCII de chaque groupe de deux chiffres sera affiché à l'emplacement du curseur. Si un nombre impair de chiffres hexadécimaux a été saisi, c'est le dernier chiffre qui sera interprété isolément. Grace à cette commande, AZ peut afficher TOUS les caractères ASCII, de 0 () à FF (ÿ), quand bien même ils ne sont pas accessibles par une combinaison de touches. A noter que '0A' sera visualisé comme une fin de ligne. 9.5- To Front Screen : Permet de transférer la fenêtre courante d'AZ vers l'écran le plus en avant. Concrètement, il faut : - placer l'écran de destination au premier plan - le baissez-le un peu pour pouvoir - lancer la commande "Tools/To Front Screen" sur l'écran d'AZ - la fenêtre active d'AZ vient alors se placer sur l'écran de destination D'autres détails sont donnés en 5.2.3, en particulier les difficultés à attendre d'un transfert vers un écran en basse résolution (320*256 pixels). 9.6- Switch Case : Equivalent clavier : . C'est une bascule minuscules/Majuscules : la lettre sous le curseur, ou les lettres sélectionnées dans un bloc sont changées : - les minuscules deviennent Majuscules. - les Majuscules deviennent minuscules. 9.7- Execute Block : Equivalent clavier : . Considère le bloc sélectionné comme une ou plusieurs commandes du CLI, et la ou les lance. Le texte retourné va s'inscrire à la fin du texte courant. A noter que, dans AZ : - Path a pour valeur initiale "Current Directory C:" - CD a pour valeur initiale le répertoire courant du FileRequester. 9.8- Match [] {} () : Equivalent clavier : <\>. Quand le curseur est posé sur un des caractères spécifiés, va placer le curseur sur le caractère qui lui est apparié. Si le caractère initial est ouvrant, le caractère apparié fermant est recherché vers la fin du texte, et inversement, si le caractère initial est fermant, le caractère apparié ouvrant est recherché vers le début du texte. 9.9- Match All Text : Vérifie que les caractères [ et ], { et }, ( et ) sont appariés. La vérification est faite sur l'ensemble du texte, simultanément pour les trois paires de caractères. 10- DIVERS 10.1- Les Requesters : A l'exception des commandes "Project/Save" et "Project/Save As", dans tous les cas où la commande passée à AZ risque d'entrainer une perte d'information, AZ lance un Requester de mise en garde. La commande ne sera exécutée qu'après confirmation. 10.1.1- Les mises en garde : le texte des mises en garde est explicite, il ne sera donc donné ici qu'une traduction. - "! File was modified !" = "! Fichier modifié !" - "No ClipBoard.device" = "Pas de ClipBoard.device" - "Is it in DEVS: ?" = "Est-ce dans DEVS: ?" - "No more memory..." = "Plus de mémoire" - "Can't open this file" = "Ce fichier ne peut être ouvert" - "Read error" = "Erreur de lecture" - "Can't create this file" = "Ce fichier ne peut être crée" - "Write error..." = "Erreur d'écriture" - "Stop requested" = "Arrêt demandé" - "Printer not ready" = "Imprimante pas prête" - "Print error..." = "Erreur d'impression" - "Serial not ready" = "RS232 pas prête" - "Send error..." = "Erreur de transmission" - "Do I erase this file ?" = "J'efface ce fichier ?" - "Can't erase this file" = "Je ne peux effacer ce fichier" - "Block not specified" = "Bloc non spécifié" - "Out of limits:" = "Hors limites:" - "No Find pattern" = "Rien à chercher" - "Line too long" = "Ligne trop longue" - "not found" = "Pas trouvé" 10.1.2- Commandes clavier : Les Requesters portent les Gadgets habituels de confirmation et d'abandon ("CANCEL"), mais il n'est pas impératif de quitter le clavier pour les activer : - confirme l'exécution de la commande. - équivaut à "CANCEL" et entraîne l'abandon de la commande. 10.2- Trucs et Astuces : Ici seront regroupées toutes les manipulations un peu tortueuses d'AZ, toutes les possibilités à explorer, toutes les bidouilles, les raccourcis.. Vous pouvez prendre contact avec nous, si vous avez une suggestion. 10.2.1- Changer de police de caractères: c'est possible, il suffit qu'AZ pense avoir à faire à un nouveau corps de topaz : - copier le nouveau corps (ni 8 ni 9 ni 11 bien sur) dans le tiroir FONTS:Topaz/ - puis lancer la commande "SYS:System/FixFonts" pour mettre à jour le fichier FONTS:topaz.font. 10.2.2- Echange de blocs : Il est possible d'interchanger deux blocs en un minimum d'opérations, sans utiliser de fichier intermédiaire. Pour cela, il faut se souvenir tout bloc effacé est copié dans un ClipBoard distinct du ClipBoard 0 utilisé par "Edit/Cut". Donc : - définir le premier bloc à déplacer, puis faire "Edit/Cut" (le bloc est effacé du texte et copié dans le ClipBoard 0) - définir le second bloc et faire "Edit/Paste" (le second bloc est copié dans le ClipBoard 1, effacé du texte. Le premier bloc vient prendre sa place). - replacer le curseur à l'endroit où doit s'insèrer le second bloc et faire "Edit/Undel Block" (ce qui copie le contenu du ClipBoard 1 dans le texte). 10.2.3- Rappels : - Pensez à utiliser pour insérer une nouvelle ligne avant la première (dans ce cas mettre le curseur au début de la première ligne). - Pour rappeler le curseur dans la partie affichée du texte sans utiliser la souris, pensez à qui mettra le curseur sous le pointeur de la souris (c'est une fonctionnalité de Intuition qu'on oublie toujours). - Pour faire défiler le texte de quelques ligne ou colonnes sans utiliser la souris faites: - pour faire un bloc de 1 caractère - Défiler ensuite avec les touches flêchées Il suffira après d'un pour dé-sélectionner le bloc. - Après "Copy From File" ou après F1, n'oubliez pas que vous pouvez continuer à "Paster" où vous voulez tant que vous n'avez pas modifé le contenu du ClipBoard 0 par "Cut" ou "Copy". - Attention: l'action de "Exchange All" commence A PARTIR du curseur. 10.3- Bugs Connus : 10.3.1- Commande "Load Binary" : Lors de l'édition, les espaces en fin de ligne sont constament enlevés. Ce n'est un bug que si l'on utilise l'option 'Load Binary' car à la sauvegarde, le fichier binaire pourra avoir des espaces en moins. Donc si vous patchez un exécutable, vérifiez que la version patchée ait la même taille que l'originale. 10.3.2- Caractères nuls : Il arrive qu'un caractère nul "" apparaisse au début d'une ou plusieurs lignes pendant l'édition. Ce bug est rare et n'a pu être reproduit à ce jour. Bien entendu, les rapports de bug, qu'ils concernent le bug décrit ci-dessus ou tout autre qui n'aurait pas été encore repérés seront les bienvenus. 10.4- L'Avenir d'AZ : L'avenir d'AZ dépend aussi de vous. Vos suggestions seront bien accueillies. Ce qui est prévu, pour l'instant : 10.4.1- Une interface AREXX : AREXX sera standard dans le WB 1.4, et votre éditeur favori pourra être piloté dans ce langage. 10.4.2- Un FontRequester : qui permettra de choisir à tout instant la police et le corps de caractères affiché. Attention : il n'y aura ni justification ni plusieurs polices dans un même fichier. 10.4.3- Un fichier de configuration . 10.4.4- Possibilité de blocs rectangulaires . 10.4.5- Option "Interlace" . 10.4.6- Lecture IFF du ClipBoard plus évoluée.