home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 1: Amiga
/
FrozenFish-Apr94.iso
/
bbs
/
alib
/
d5xx
/
d540
/
browser.lha
/
Browser
/
BrowserII.docF
< prev
next >
Wrap
Text File
|
1991-08-27
|
21KB
|
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.