Club Amiga de Montreal

home *** CD-ROM | disk | FTP | other *** search

/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 552.lha / Browser_II_v1.0 / BrowserII.docF.pp / BrowserII.docF

Wrap

Text File | 1991-09-09 | 20.2 KB | 566 lines

BrowserII V1.0 Copyright: ---------- ParM et BrowserII sont CopyRight, ils ne peuvent être vendus dans un logiciel commercial sans notre autorisation écrite, ils ne peuvent être distribués pour plus de 15 FF ( disk + port ), il ne peuvent être mis en téléchargement sur un serveur qui en fait une opération commerciale, plus généralement il est interdit de faire des profits avec ces logiciels sans notre autorisation écrite. Avertissement: -------------- Nous déclinons toute responsabilité quand a l'utilisation de ces programmes et aux dommages qu'ils pourraient vous causer. Utilisez les a vos propres risques. Neanmoins, nous estimons, qu'après plus de 2 mois d'utilisation par 4 personnes, les avoir suffisamment testés et utilisés pour vous dire qu'ils sont fiables. L'histoire: BrowserII à été écrit après 2 ans d'utilisation de Browser 1.6a (de Peter Da Silva). Nous n'étions pas contents de certaines limitations de Browser, aussi lorsque nous nous en sommes sentis capables, nous avons décidé d'écrire un programme qui devait combler ses lacunes. C'est ainsi qu'est né "BrowserII.... le retour !" Etant très content de la présentation de Browser nous avons décidé de la garder, puis de garder son nom aussi car ainsi tout les anciens utilisateurs pourront comprendre facilement l'usage de BrowserII. N'ayant jamais vu les sources de Browser, nous avons écrit BrowserII en partant de zéro. Installation: Vous pouvez mettre BrowserII ou vous voulez, vous devez mettre arp.library, parm.library et req.library dans votre répertoire Libs:. Si vous voulez utiliser les menus paramètrables de BrowserII, n'oubliez pas de copier votre fichier BrowserII.menu dans votre répertoire S:. Les Menus: * "BrowserII"->"Update menus" Recharge le fichier de menu paramètrable: "S:BrowserII.menu". Ce fichier est en ascii et à la même syntaxe que les fichier configurations de ParM. Une option a été rajoutée: l'insertion des fichier sélectionnés dans les fenêtres BrowserII se fera à l'emplacement des []. Ex: ITEM Sizer SHELL Sizer [] ; WaitReturn donnera si vous avez sélectionné "S:": Sizer S: WaitReturn EndCLI >Nil: S'il n'y a pas de [] les sélections seront rajoutés à la fin de la commande. Un fichier exemple est fournit. * "BrowserII"->"Cmd Mode"->"Simple" "BrowserII"->"Cmd Mode"->"Shell" Même usage que dans ParM. * "BrowserII"->"Cmd Mode"->"Command" Même usage que dans ParM. * "BrowserII"->"Screen"->"Workbench" BrowserII ouvre ses fenêtres dans l'écran WorkBench. * "BrowserII"->"Screen"->"Custom" BrowserII ouvre un écran à son usage et ouvre toute ses fenêtres à l'intérieur. Pour l'instant l'écran possède les même caracteristiques que celui du WorkBench et cette option n'est prise en compte qu'au démarrage. Si vous voulez un Custom Screen, vous devez : - Sélectionner "BrowserII"->"Screen"->"Custom" - Sélectionner "BrowserII"->"Save Config" - quitter puis recharger BrowserII * "BrowserII"->"Run Mode" Précise le mode de lancement des fichiers sur lesquels vous DoubleCliquez, si d'autres fichiers sont sélectionnés lors du double clic, ceux-ci deviennent les paramètres de la commande. Si le fichier possède un icône, ("NomDuProgramme.info") il sera automatiquement lancé en mode WB. A Noter que BrowserII fait toujours un CD dans la fenêtre active avant de lancer votre programme (sauf en mode WB), que ce soit par un DoubleClick, par une sélection dans vos menus, ou pour Command. Ceci est souvent TRES utile. * "BrowserII"->"Run Mode"->"RunBack" Lance le programme sur lequel vous DoubleClickez en tâche de fond, aucune fenêtre n'est ouverte et aucun fichier commande n'est demandé. A noter que ce mode n'est sûr a 100% que si vous utiliser le NULL-Handler, ceci est a une limitation connue de NIL: que BrowserII utilise lorsqu'il ne trouve pas NULL:. * "BrowserII"->"Run Mode"->"Shell" Lance le programme sur lequel vous DoubleClickez via un Shell comme si vous l'aviez ouvert vous même et y aviez tappé le nom du programme, ce mode est sûr a 100% quel que soit la commande mais nécessite un accès a votre commande SHELL (spécifié dans le fichier "S:BrowserII.menu") ainsi qu'a EndCLI, c'est pourquoi nous conseillons de le mettre dans la ArpResident list. ( 1>ARes C:Shell, 1>ARes C:EndCLI ) * "BrowserII"->"Run Mode"->"Request" Si cette option est activée, un requester apparaîtra avant le lancement d'un programme afin de vous permettre d'eventuellement modifier la ligne de commande. Si cette option est désactivée, le programme sera lancé sans avertissement. Cette option est inactive sur le lancement en mode WB. * "BrowserII"->"Copy Mode"->Context Lorsque vous déplacez un fichier, BrowserII fera un rename si la source et la destination sont sur le même volume (déplacement du fichier), et une copie si il s'agit de volumes différents. * "BrowserII"->"Copy Mode"->"Allways Copy" BrowserII fera systématiquement une copie du fichier. * "BrowserII"->"Copy Mode"->"Allways Move" BrowserII fera systématiquement une copie+delete: BrowserII fera d'abord une copie du fichier, puis effacera le fichier source. * "BrowserII"->"Copy Mode"->"Update" BrowserII ne copie le fichier que si le source est plus récent que le destination (ou si celui ci n'existe pas). * "BrowserII"->"Copy Mode"->"Don't overwrite files" BrowserII n'écrase pas les fichiers déjà présents dans le répertoire destination, c'est à dire que si vous avez sélectionné un fichier et qu'il existe déjà dans le répertoire destination, celui ci ne sera pas copié. * "BrowserII"->"Copy Mode"->"Ask before overwrite" BrowserII demande confirmation avant d'écraser un fichier déjà existant dans la destination. Cette option est exclusive avec "BrowserII"->"Copy Mode"->"Don't overwite files". * "BrowserII"->"Copy Mode"->"Copy empty dirs" Si cette option est mise BrowserII créera aussi dans la destination les répertoires vides. Ceci permet de ne pas copier de répertoires vide si l'option est désactivée. * "BrowserII"->"Copy Mode"->"Copy hierarchy" Si cette option n'est pas mise, BrowserII copiera tout les fichiers dans le répertoire destination. Tout les fichiers copiés seront placés dans le même répertoire. * "BrowserII"->"Copy Flags"->"Clone" Tout les attributs d'un fichier seront aussi copiés (date, commentaire, et bits de protection). Le nouveau fichier aura les mêmes attributs que l'original. * "BrowserII"->"Copy Flags"->"Date" Le fichier destination hérite de la même date que le fichier source. * "BrowserII"->"Copy Flags"->"Protect" Le fichier destination hérite des mêmes bits de protection que le fichier source. * "BrowserII"->"Copy Flags"->"Comment" Le fichier destination hérite du même commentaire que le fichier source. * "BrowserII"->"Display"->"Devices" * "BrowserII"->"Display"->"Volumes" * "BrowserII"->"Display"->"Assigns" La fenêtre principale de BrowserII affiche le type demandé. * "BrowserII"->"Options"->"Keep selected" Après une action, (Makedir, Delete, Copy, etc...) les fichiers sont resélectionnés. * "BrowserII"->"Options"->"Toggle selection" Lorsque cette option est mise, BrowserII désélectionne l'entrée sur laquelle vous avez cliquez si celle-ci était déjà sélectionnée. Si cette option n'est pas mise, BrowserII ne désélectionne pas l'entrée. (Vous pouvez forcer la désélection, en appuyant simultanément sur Ctrl). * "BrowserII"->"Options"->"Move files into subdirectories" Si cette option est mise, BrowserII placera les fichiers sélectionnées dans le répertoire sur lequel vous avez lâché le pointeur. Sinon il les placera dans la fenêtre contenant ce répertoire. * "BrowserII"->"Options"->"Ask before moving into subdirectories" Si cette option est mise, BrowserII vous demandera confirmation, lorsque vous déplacerez des entrées dans un répertoire. * "BrowserII"->"Options"->"Asynchronous Actions" Ceci est sans doute l'option que vous apprécierez la plus: si elle est mise, toute les actions, les lancements de programme, ainsi que les copies, deviennent asynchrones, c'est à dire qu'elles s'exécutent en tâche de fond, vous rendant la main aussitôt. C'est comme le multitâche de l'Amiga, vous ne pourrez plus vous en passer ! !! Essayez la !! Ceci est optionnel principalement pour pouvoir débugguer les actions avec sdb qui ne peut debugguer les process. * "BrowserII"->"Save config" Sauvegarde toutes vos options dans le fichier "Devs:BrowserII.cfg", (à ne pas confondre avec les menus personnels) ainsi que le contenu du requester de filtre de la fenêtre courante et de sélection. * "BrowserII"->"Quit" Quitte BrowserII. Nous n'avions pas prévu cette option, mais à la demande généralise nous l'avons rajouté. A noter qu'il n'est pas possible de quitter BrowserII, si une action asynchrone est en cours. N'est-ce pas logique ? * "Window"->"Rescan" BrowserII réexamine le répertoire de la fenêtre active. * "Window"->"Open Parent" Ouvre le répertoire parent (si possible) de la fenêtre active. N'oubliez pas que les répertoires racines n'ont pas de parent. * "Window"->"Open Dir..." Ouvre un répertoire particulier, dont vous entrez le chemin COMPLET, au clavier. * "Window"->"Select Match" Sélectionne les entrées de la fenêtre courante qui répondent aux critères que vous choisissez. Le requester sera décrit plus tard. * "Window"->"Select All" Sélectionne toute les entrées de la fenêtre active. * "Window"->"Filters"-> Ceci est une autre fonctionalité importante de BrowserII. Seul les fichiers qui répondent aux critères demandé seront visible, les autres seront enregistre et compté par BrowserII (cf: BottomString) mais pas affiché. * "Window"->"Filters"->"Set..." Appel le requester des filtres pour la fenêtre en cours. * "Window"->"Filters"->"Prefs" Remet les filtres enregistrées dans vos préférences ("BrowserII.cfg"). * "Window"->"Filters"->"No .info" Ceci est un filtre pré-définit, qui cache les fichiers icônes (Ex: TrucMuch.info). Ce filtre se rajoute aux filtres préexistant. * "Window"->"Filters"->"Clear" Enlève tous les filtres, tous les fichiers seront donc visibles. * "Window"->"Filters"->"Invert" Inverse les résultats des filtres, tout les fichiers cachés seront visible et vice-versa. Utile pour vérifier rapidement si un fichier théoriquement présent n'est pas caché par le filtre. (Ex: vérifier si un fichier à une icône). * "Window"->"File Info"->"Size in Bytes" Montre la taille en octets. * "Window"->"File Info"->"Size in Blocks" Montre la taille en blocks. * "Window"->"File Info"->"Protection" Montre les bits de protection (ou attributs du fichier). * "Window"->"File Info"->"Date" Montre la date du fichier. Cette date correspond à la dernière modification du fichier. * "Window"->"File Info"->"Disk Key" Montre le DiskKey de l'entrée. Ceci Correspond au numéro du block d'entête du fichier. Permet de connaître l'emplacement du début de fichier sur le support. Rarement utile mais simple à implementer. * "Window"->"Sort By" Type de tri des entrées dans la fenêtre. Pour des raisons évidente chaque type de tri exclu tout autre. * "Window"->"Sort By"->"Name" Tri par ordre alphabétique. * "Window"->"Sort By"->"Date" Tri par date dans l'ordre chronologique. * "Window"->"Sort By"->"Size" Tri par taille ascendante. * "Window"->"Sort By"->"Key" Tri par DiskKey. * "Window"->"Sort By"->"Type" Ceci n'est pas vraiment un type de tri, mais affecte tous les tris. Si il est mis les fichiers et les répertoires seront triés séparément. Les répertoires étant affichés en premiers. * "Window"->"Affect all" Les préférences de la fenêtre active sont copiées dans toutes les fenêtres. (Filtres, Sort, et File Info). * "Actions"->"Rename" Renomme l'entrée sélectionnée. Si plusieurs entrée sont sélectionnées, permet de renommer avec des jokers à la manière de Arp. Si vous ne connaissez pas faites vous la main sur des fichiers sans importance avant d'essayer. * "Actions"->"MakeDir" Créé des répertoires dans la fenêtre active, vous pouvez rentrez plusieurs répertoires en même temps en les séparant pas des espaces. Ex: Work Jeux Work/Src Attention: "Work/Src Work" est invalide car Work n'existe pas encore. faite bien "Work Work/Src". * "Actions"->"Duplicate" Fait une copie du fichier, un nouveau nom vous sera demandé. * "Actions"->"Touch" Met la date de(s) l'entrée(s) sélectionnée(s) à la date actuelle. * "Actions"->"Set Comment" Affecte un nouveau commentaire à l'entrée sélectionnée, l'ancien , si il existe, vous sera donné, 80 caractères maximum. (Limitation AmigaDos). * "Actions"->"Set Protect" Donne de nouveaux bits d'état à l'entrée sélectionnée. Vous ne pouvez pas mettre le bit C car il ne s'agit pas d'un vrai bit d'état mais vous pouvez l'enlever ce qui aura pour effet de détruire le commentaire. * "Actions"->"Delete" Efface les fichiers. Une confirmation de sécurité vous sera demandé. Lorsque au moins un répertoire est sélectionné, deux delete sont possible: - "Delete" efface les répertoires seulement s'ils sont vides. - "Delete All" efface tout: fichiers ET répertoires même non vides. Les Requesters: * Filtres: BrowserII teste tous les fichiers, si le résultat est positif alors le fichier est montré. Plusieurs types de filtres sont possibles et combinables à volonté: - Files: - Y: si l'entrée est un fichier, le résultat est positif. - N: si l'entrée est un fichier, le résultat est négatif. - ?: le résultat dépend du résultat du test de Pattern, size, ... - Dirs: idem pour les répertoires. - Pattern: il s'agit de Pattern Arp et/ou AmigaDos. Ex: *.doc ne montre que les fichier .doc Ex: ~*.(o|dbg) cache le fichiers .o et .dbg Se référer au documentations Arp/AmigaDos pour plus de détails. - Min Size: taille minimale, si plus petit alors caché - Max Size: taille maximale, si plus grand alors caché - Since : si plus vieux alors caché = montré si plus récent - Before: si plus récent alors caché = montré si plus vieux - Protection : si le fichier ne répond pas au filtre, il est caché: C H S P A R W E D Ex: _ - _ _ _ _ _ _ _ cache les fichiers qui on le bit H Ex: _ _ _ _ + _ _ _ _ montre que les fichiers qui on le bit A * Sélection: (Select Match) Ce requester est le même que celui des filtres, mais avec un gadget supplémentaire "Affect subdirs". Ceci permet de virtuellement sélectionner des fichiers dans les sous répertoires sélectionnés. Un bon exemple vaut mieux qu'un long discours. Supposez que vous vouliez enlever le bit d'archive de tous les fichiers d'un disque qui ont ce même bit d'archive. 1. Ouvrez la fenêtre du volume désiré. 2. Appeler Select Match. 3. Mettez Files sur ? et Dirs sur N 4. Mettez A sur + dans les bits de Protection. 5. Selectionnez Affect subdirs 6. Validez le requester. Résultat: Les fichiers qui ont le bit d'archive sont selectionnés, mais aucun répertoire ne l'est puisque vous avez mis Dirs sur N. 7. Maintenez <Shift> enfoncé tout en sélectionnant tous les répertoires de la fenêtre. 8. Faîtes Set Protect. 9. Mettez les bit dans l'état: C H S P A R W E D _ _ _ _ - _ _ _ _ 10. Validez. Et voilà! A chaque fois que vous cliquez sur le bouton gauche de la souris dans une fenêtre BrowserII, si vous ne pressez PAS simultanément une touche Shift, le fichier sous la souris, s'il y en a un, est sélectionné, tous les autres sont déselectionnés, et le bit Affect subdirs est effacé. Ceci veut dire qu'après une opération faite avec Affect subdirs, cette option n'est plus active (sauf si vous maintenez toujours shift enfoncé), et si vous désirez faire une deuxième opération avec cette option, il vous faudra à chaque fois la resélectionner. Dans les actions avec Affect subdirs, si un répertoire répond aux filtres, l'opération aura lieu aussi sur le répertoire une fois le répertoire examiné. Même si le répertoire ne répond pas aux filtres, il sera toujours examiné, et les fichiers qu'il contient seront éventuellement affectés par l'action. Ceci est un peu différent pour les copies. Si un répertoire ne répond pas aux filtres, il ne sera pas copié, et donc pas examiné. Par contre, partant de l'hippothèse qu'un répertoire puisse être intéressant que s'il n'est pas vide, on peut demander de ne pas copier les répertoires vides. Ceci se fait grâce à l'option "Copy Empty Dirs". Mais ceci va beaucoup plus loin. Si par exemple vous ne mettez pas cette option, les répertoires vides ne seront pas copiés, mais les répertoires non-vides dans lesquels aucun fichier n'a répondu aux filtres seront aussi considérés comme vides, et ne seront pas créés dans le répertoire destination. Ceci permet donc de faire des sauvegardes sélectives, sans avoir de hiérarchies vides dans le volume destination. Taille des buffers de copie: BrowserII teste si au moins un des volumes source et le volume destination sont mounté simultanément, auquel cas, BrowserII utilisera au maximum 200Ko de tampons. Sinon, vous verrez durant la copie: "Please, insert volume XXX in any drive", situation prevue par BrowserII qui utilisera des tampons au maximum de 880Ko (taille d'un floppy disk) pour minimiser "le phénomène de grille pain". Il n'est plus nécessaire de copier d'abord dans le "Ram Disk:" et il est possible de copier une fichier de plus de 512Ko sur un amiga de base équipe seulement de 512Ko. Dans tous les cas, BrowserII n'utilisera pas plus de 80% de la mémoire pour ses tampons. Les petits trucs sympas de BrowserII: * Si vous fermez une fenêtre tout en pressant une touche Shift, BrowserII ferme toute les fenêtres du même volume. * Pour Valider et quitter en même temps le requester des filtres, faîtes Shift-Return. * Les volumes non "mountés" apparaisent en caractères gras. * Les fichiers qui viennent d'être effacés sont affichés en italique et ne sont pas sélectionnables. parm.library: Les programmeurs sont autorisés à utiliser la parm.library, lire le fichier ParMBase.h pour l'utiliser. Pour l'instant aucune doc n'est faite, referez vous au source de ParM et BrowserII pour plus de détails. ShareWare/Distribution: BrowserII et ParM sont tout deux en ShareWare: si vous les utilisez, vous avez l'obligation morale de nous envoyer une contribution. Tout donateur de plus de 50FF sera 'enregistré' et recevra automatiquement une version supérieure. N'oubliez pas donc d'indiquer votre version de ParM/BrowserII, si il n'existe pas de version supérieure lors de la réception de votre donation, nous vous mettrons en attente et vous enverrons une UpDate dès sa création. Nous n'avons reçu que 5 contributions pour ParM, nous espérons que ce chiffre va augmenter pour BrowserII. Merci à: Rey Philippe (FF) Hennion Marcel (FF) Craig L. Blackman ($US) Christian König (Bière: une blague dans ParM V1.6) Dr. H. Schneider (Bière: une blague dans ParM V1.6) pour leur donations, et à: ASDG pour le genialissime CygnusEd ! Pierre Ardichvili pour sont amabilité et sont soutient à l'Amiga Lyman Epp pour son très bon QMouse 1.6 W. S. Hawes pour ARexx. S.R. & P.C.