@database T.H.E. @$VER: THE.guide 1.2.1 (24.12.2012) © by Nils Görs and Frank Ruthe @REMARK Translation 1.1 (19.12.1999) @node main "Documentation de T.H.E." Éditeur de menus et de raccourcis pour le Workbench. @{" Qu'est-ce que T.H.E.? " link Overview} @{" Copyright et garantie " link Copyright} @{" Système requis " link Requirements} @{" Installation " link Installation} @{" Bugs connues " link knownErrors} @{" Utilisation " link usage} @{" Commandes ARexx " link arexx} @{" Remerciement " link thanks} @{" Historique " link History 9999} @{" FAQ " link FAQ} @{b}ATTENTION! This guide is outdated. If you like to contribute a current version of this guide in français - feel free to contact me! (see THE2.readme)@{ub} T.H.E. est copyright © 2012 par Nils Görs et Frank Ruthe. Aucune utilisation commerciale n'est permise sans l'autorisation de l'auteur. Lire la partie @{"copyright" link Copyright}! EMail: frank\@ruthe.info @endnode @node Overview "Qu'est-ce que T.H.E.?" T.H.E. est un éditeur pour les nouvelles fonctions de la bibliothèque « workbench.library ». Il est maintenant possible d'ajouter, d'effacer et de modifier les touches de raccourcis du workbench et le menu outil via le workbench lui-même. @endnode @node Requirements "Système requis" Pour utiliser T.H.E. vous avez besoin des choses suivantes : - OS3.5 `-> CD-ROM Disque dur 68020 ou mieux Amiga avec ROM 3.1 4 Mo FastRAM - AWNPipe 2.22 ou plus récent. (Voir plus loin) @endnode @node Installation Utilisez le script d'installation. @endnode @node knownErrors "Erreurs connues" Pendant la programmation de T.H.E. j'ai trouvé des erreurs dans les classes ClassAction/ReAction. - Si vous choisissez une entrée à partir de la liste du menu outil, le raccourcis ne sera pas mis dans le champ du gadget de chaîne. * C'est pourquoi « awnpipe-handler » v2.22 qui contourne se problème a été inclus. - Merci Bill ! - Si vous ajoutez une nouvelle entrée dans la liste du gadget de chaîne, celle-ci ne sera pas activée automatiquement. Cela pourrait provoquer un crash du système dans certaines circonstances particulière. @endnode @node Copyright Cette licence s'applique au programme connu sous le nom de "T.H.E.". Le programme, ci-dessous fait référence à ce programme. Les programmes et les fichiers de cette distribution sont libre de diffusion sous les conditions et restrictions définis ci-dessous, mais sont aussi sous le copyright © de Nils Görs. Additional contributors are mentioned in the respective files. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . @endnode @node Usage "Utilisation" L'interface ----------- Le gadget de page alterne entre l'éditeur du menu outil et des raccourcis claviers. La liste affiche les entrées de l'un ou de l'autre. Vous pouvez vous déplacer à l'aide des touches de déplacement. Pour aller directement en haut de la liste, utilisez [HOME] et pour aller tout en bas, utilisez [END]. [TAB] alternera entre la page pour les raccourcis clavier et celle du menu outil. Ajouter - ajoute une nouvelle commande à la liste. La nouvelle entrée sera placée sous le curseur. Effacer - efface l'entrée sélectionnée. Dupliquer - Crée une nouvelle entrée en copiant les éléments de l'entrée sélectionnée. + Haut - La ligne sélectionnée est remontée d'une position. + Bas - La ligne sélectionnée est descendue d'une position. Pour ajouter une ligne de séparation, choisissez un nom et utilisez un des symboles suivants : « - », « ~ » ou « _ ». N'utilisez pas d'espace dans les nom de fichiers ou de répertoires. Je n'ai implémenté qu'une routine de base pour vérifier les arguments. Le fichier de configuration --------------------------- T.H.E. crée un script ARexx qui sera placé dans le répertoire WBStartup. Lors du démarrage, c'est ce script qui installera les raccourcis et les outils du menu outils. @endnode @node arexx Depuis la version 1.1, T.H.E. offre un port ARexx du nom de « T.H.E. ». Ce qui permet la gestion de quelques commandes décrites plus bas : 1. UNICONIFY Si T.H.E. est icônifié, sa fenêtre s'ouvrira. 2. ICONIFY Icônifie la fenêtre de T.H.E.. 3. QUIT Quittera T.H.E. @{b}sans@{ub} requête. 4. ACTIVATE Active la fenêtre de T.H.E.. @endnode @node thanks "Remerciements" Je remercie : William Parker - pour le support et l'aide apportée avec AWNPipe. Oliver Tacke - pour le support rapide des icônes fab. Kurt Berghaus - il a eu l'idée de la localisation après avoir vu une photo d'écran avec une interface en anglais. @{"Ynot7" link /ynot7.jpg/MAIN} - pour la plus fab thai rock music que j'ai entendu durant le développement de T.H.E ("rUang kii mah"). Je me dois de remercier les personnes suivantes pour la traduction du catalogue (ordre alphabétique par pays !) : - Vit Sindlar - Jacob Laursen - Alfredo Soro - Hervé Dupont - Andrea Monni & Marco De Vitis - Guno Heitman - Mario Gonzalez - Alfredo Martins - Jari Komulainen @endnode @node FAQ "Les questions les plus fréquemment posées" Q : Comment puis-je lancer un programme (Shell) sans utiliser startexe.rexx ? R : J'ai écrit startexe.rexx pour simplifier l'utilisation des programmes Shell. Si vous préférez démarrer les programmes shell directement, effacez la commande présente dans le gadget de chaîne de la commande et utilisez le gadget de chaîne d'arguments à la place : 'address command ''''' Exemple : 'address command ''WBRun StackSnoop''' Q : J'aimerais envoyer une commande ARexx à un autre port, est-ce possible ? R : Oui, rien de plus facile. Effacer la chaîne de commande et utilisez la chaîne prévu pour les arguments à la place : 'address ''hostname'' ' Exemple : 'address ''ZPoint'' BOARDMENU' Q : Comment puis-je utiliser le port ARexx à partir du Workbench R : De nouveau, effacez la chaîne de commande et utilisez celle d'arguments. '' Exemple : 'MENU INVOKE WORKBENCH.ABOUT' Q : Est-il possible de mettre un raccourci à un menu, par exemple « Snapshot all » à l'aide de T.H.E. ? R : Non, ce n'est pas possible. Vous pouvez seulement modifier le menu outils mais vous pouvez associer un raccourci à chaque fonction du menu ou bien ajouter dans le menu outils : 'options results; GETATTR OBJECT WINDOWS.ACTIVE; MENU WINDOW result INVOKE WINDOW.SNAPSHOT.ALL' @endnode @node History "Historique" v0.1 - v0.10 : - Versions internes - v1.0 : - 1ère diffusion publique - v1.1 : - Ajout d'un @{"Port ARexx" link arexx}. - Erreur dans le passage des paramètres retirée, ce qui pouvait forcer le script à s'arrêter. - Correction d'une erreur provoquant des troubles lors du retrait d'espaces de la zone de saisie. - L'ajout d'une nouvelle entrée la placera sous le curseur. - Ajout d'un nouveau bouton « Dupliquer ». - Implémentation des mouvements du curseur. - Le support des touches [TAB], [Home] et [End] a été ajouté. - behaviour of buttons changed completly. - GUI will be locked under special circumstances. - Amélioration du passage des arguments. - Petites optimisations. - standard language is not part of the main program. Le fichier THE.strings n'est plus nécessaire. - Plus de fonctions prédéfinies (Touches de fonctions). v1.2 : - J'avais oublié de refermer le catalogue ! (Hervé Dupont) - Le catalogue sera également recherché dans PROGDIR: (Hervé Dupont) - Il est possible de supprimer l'affichage des lignes de séparation horizontales dans le gadget de liste. (Hervé Dupont) - Quelques petits changements internes. @endnode