home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 2: PC
/
frozenfish_august_1995.bin
/
bbs
/
d09xx
/
d0934.lha
/
AZap
/
AZap.doc
< prev
next >
Wrap
Text File
|
1993-12-20
|
22KB
|
521 lines
AZap - Manuel de rΘfΘrence
AboutThisDoc
Ce manuel dΘcrit la version 2.11 de l'utilitaire AZap. Ce programme
est (c)1992-1993 par Denis GOUNELLE, toute utilisation commerciale ou vente
sans autorisation Θcrite est strictement interdite. Vous pouvez copier et
diffuser ce programme aux conditions suivantes :
- l'ensemble des fichiers doit Ωtre fourni
- aucun fichier ne doit avoir ΘtΘ modifiΘ
- vous ne devez pas demander plus de 40FF pour cela
MalgrΘ de nombreux tests, je ne peux garantir que AZap ne contient
aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES ET PERILS. Je ne
pourrai en aucun cas Ωtre tenu pour responsable de tout dommage, direct ou
indirect, rΘsultant de l'utilisation de AZap.
Introduction
AZap est un Θditeur binaire "nouvelle gΘnΘration", capable d'Θditer
aussi bien un fichier que la mΘmoire, ou encore une disquette (mΩme s'il
n'offre pas d'outils pour vous aider α rΘcupΘrer une disquette endommagΘe).
AZap peut ouvrir plusieurs fenΩtres d'Θdition en mΩme temps et dispose de
nombreuses fonctions, comme l'impression d'un bloc, le remplissage d'un
bloc, la recherche d'une chaine, etc...
NOTE IMPORTANTE :
Il est interdit de se servir de ce programme pour modifier
des indications de copyright, ou pour toute autre usage
contraire α la loi. De plus, je dΘconseille vivement aux
utilisateurs non expΘrimentΘs d'utiliser ce programme : vous
risquez de rendre des programmes inutilisables, ou de perdre
toutes les informations stockΘes sur votre disque dur !
Vos critiques et suggestions sur ce programme seront toujours les
bienvenues. N'hΘsitez pas α m'Θcrire, α l'adresse suivante :
M. GOUNELLE Denis
Boite 71
6, rue des cailloux
92110 CLICHY - FRANCE
Vous pouvez Θgalement m'adresser un message α l'adresse Internet
"gounelle@alphanet.ch". Notez qu'il s'agit d'une boite α lettre mise α ma
disposition par un ami, aussi veuillez n'envoyer que de courts messages. De
plus, n'ayant pas accΦs directement α mes messages, n'espΘrez pas avoir une
rΘponse avant une dizaine de jours.
Merci α Pierre ARDICHVILI et α Jean-Yves PROUX pour leurs
suggestions.
En France, la derniΦre version de ce programme est disponible auprΦs
de Serge HAMMOUCHE, 3 rue Anatole France, 13220 Chateauneuf-les-Martigues.
Pour recevoir le catalogue complet, il vous suffit d'envoyer deux timbres α
cette adresse.
Installation
AZap utilise la bibliothΦque "reqtools.library" (version 2.0C ou
supΘrieure), que vous devez copier dans votre rΘpertoire "LIBS:", si ce
n'est dΘjα fait. La bibliothΦque "reqtools.library" est (c)1990-1993 par
Nico FRANCOIS.
AZap est dΘsormais localisΘ, c'est-α-dire qu'il peut s'adapter α la
langue par dΘfaut si vous avez le systΦme 2.1 ou plus. Il vous faudra alors
copier le fichier catalogue dΘsirΘ dans le rΘpertoire correspondant α votre
langue par dΘfaut. Par exemple, s'il s'agit du franτais, copiez le fichier
"franτais.catalog" dans le rΘpertoire "SYS:Locale/Catalogs/Franτais", sous
le nom "AZap.catalog"
Appel_depuis_le_CLI
AZap se dΘtache automatiquement du CLI. Les arguments acceptΘs sont
les suivants :
WBENCH
Normalement, AZap ouvre son propre Θcran. Cette option permet de
travailler sur l'Θcran Workbench.
LACE
Si cette option est prΘsente, AZap ouvre un Θcran entrelacΘ au
lieu d'un Θcran normal. Notez que cette option est ignorΘe si
vous avez indiquΘ l'option WBENCH.
FONT nom
Par dΘfaut, AZap utilise une police interne de 6x9. Vous pouvez
cependant demander α utiliser une autre police : "nom" doit Ωtre
sous la forme <nom de la police><taille en Y> (par exemple
"courier9"). AZap refusera si la police est proportionnelle, ou
si elle est trop grande pour pouvoir afficher un bloc de 512
octets.
MEMORY
Au dΘmarrage, AZap ouvre une fenΩtre d'Θdition de la mΘmoire.
DEVICE nom
Au dΘmarrage, AZap ouvre une fenΩtre d'Θdition pour l'unitΘ
"nom". N'oubliez pas les deux-points (":") α la fin du nom.
Tout autre argument est considΘrΘ comme un nom de fichier α ouvrir. Vous
pouvez indiquer plusieurs noms de fichiers, mais seuls les huit premiers
seront pris en compte. Il est bien Θvidemment possible d'indiquer α la fois
des noms de fichiers, l'option MEMORY, et l'option DEVICE. Si aucun argument
n'est indiquΘ, une requΩte de fichier apparait (voir Le_menu_Projet) pour
que vous puissiez sΘlectionner le fichier α Θditer.
Appel_depuis_le_Workbench
Vous pouvez indiquer les arguments suivants, dans le champ "TOOL
TYPES" de l'ic⌠ne de AZap :
OPTIONS=WBENCH ou OPTIONS=LACE
Voir description des options WBENCH et LACE au chapitre
Appel_depuis_le_CLI.
FONT=nom
Voir description de l'option FONT au chapitre prΘcΘdent
Appel_depuis_le_CLI.
Au dΘmarrage, une requΩte de fichier apparait (voir Le_menu_Projet) pour que
vous puissiez sΘlectionner le fichier α Θditer.
La_fenΩtre_d'Θdition
La partie gauche de l'affichage montre le contenu du bloc en
hexadΘcimal, par groupe de 4 octets. La partie droite montre l'Θquivalent en
caractΦres, les codes non imprimables Θtant remplacΘs par un point (".").
En bas et α droite sont affichΘes quelques informations : l'adresse
du bloc (relative au dΘbut, en hexadΘcimal), le dΘplacement dans le bloc (en
hexadΘcimal), le numΘro de bloc (relatif au dΘbut, en dΘcimal), et le type
de bloc. Cette derniΦre information n'a de sens que quand vous Θditez une
unitΘ DOS. Quand les donnΘes du bloc ont ΘtΘ modifiΘes, une Θtoile ("*") est
affichΘe α droite de la premiΦre ligne. Si la somme de contr⌠le du bloc est
valide, le caractΦre "V" est affichΘ α droite de la seconde ligne (n'a de
sens que quand vous Θditez une unitΘ DOS).
A l'ouverture de la fenΩtre, le permier bloc est affichΘ, et le
curseur est positionnΘ sur le premier caractΦre de la partie droite. La
position correspondante dans l'autre partie est montrΘe par un affichage
dans une couleur diffΘrente. Vous pouvez vous dΘplacer α l'aide des touches
du curseur. Pour passer de la partie droite α la partie gauche (et
inversement) utilisez la touche de tabulation. Vous pouvez Θgalement vous
positionner n'importe o∙ α l'aide de la souris. Pour modifier les donnΘes,
tapez simplement les nouvelles valeurs. Dans la partie gauche, seuls les
caractΦres "0" α "9", "a" α "f" et "A" α "F" sont acceptΘs. AZap garde en
mΘmoire les 32 derniΦres modifications. Tant que vous n'avez pas changΘ de
bloc, vous pouvez annuler ces changements en sens inverse, α l'aide de la
touche <ESC>. Les touches suivantes sont Θgalement reconnues :
ctrl-haut va en dΘbut de fichier
ctrl-bas va en fin de fichier
ctrl-gauche va au bloc prΘcΘdent
ctrl-droit va au bloc suivant
shift-haut va sur la premiΦre ligne
shift-bas va sur la derniΦre ligne
shift-gauche va au dΘbut de la ligne
shift-droit va en fin de ligne
La rangΘe de boutons en bas de la fenΩtre offre les fonctions
suivantes (de gauche α droite) : aller au premier bloc, aller au bloc
prΘcΘdent, Θcriture des modifications, aller au bloc suivant, aller au
dernier bloc. Le bouton tout α droite (GOTO) provoque l'apparition d'une
boite de requΩte. Vous Ωtes alors invitΘ α entrer une adresse, sous une des
formes suivantes :
nbr saut α l'adresse 'nbr'
ºnbr saut au bloc 'nbr'
@nbr saut α l'adresse contenue dans le long mot α l'adresse
'nbr' (utilisable seulement en Θdition de mΘmoire)
#nbr saut α la zone mΘmoire numΘro 'nbr' (utilisable
seulement en Θdition de mΘmoire)
Dans tous les cas, 'nbr' est une expression entiΦre, dont la syntaxe est
dΘcrite au chapitre "Syntaxe_des_expressions".
L'ascenseur en bas de la fenΩtre permet Θgalement le dΘplacement.
Notez que, dans tous les cas, si vous changez de bloc sans sauvegarder vos
modifications, elles seront perdues !
Pour fermer la fenΩtre d'Θdition, il vous suffit de cliquer sur son
gadget de fermeture. Si le bloc a ΘtΘ modifiΘ mais non sauvΘ, AZap vous
demandera confirmation. Le programme s'arrΩte automatiquement quand vous
fermez la derniΦre fenΩtre.
Le_menu_Projet
Ouvre fichier...
Permet d'Θditer un fichier : une requΩte de fichier apparait,
sΘlectionnez le fichier dΘsirΘ. AZap ouvre alors une fenΩtre
supplΘmentaire d'Θdition. Si vous avez sΘlectionnΘ "RAM:", la
fenΩtre sera une fenΩtre d'Θdition de la mΘmoire. Si vous avez
sΘlectionnΘ un nom d'unitΘ (par exemple "DH0:" ou "Work:"), AZap
ouvrira une fenΩtre d'Θdition d'unitΘ.
Ouvre mΘmoire
Ouvre une fenΩtre supplΘmentaire, permettant l'Θdition de la
mΘmoire.
Ouvre unitΘ
Un sous-menu vous permet de sΘlectionner l'unitΘ α Θditer. AZap
ouvre alors une fenΩtre supplΘmentaire d'Θdition.
Palette...
Vous permet de modifier les couleurs de l'Θcran (une requΩte de
couleur apparait).
Sauve prefs
Vous permet de sauvegarder la configuration de AZap : les
couleurs de l'Θcran et la police de caractΦres. Les options de
la fenΩtre courante sont Θgalement enregistrΘes comme options
par dΘfaut. Le nom du fichier de configuration est
"S:AZap.Config".
A propos...
Affiche des informations sur le programme.
Quitte
Termine l'exΘcution de AZap. Le programme vous demandera
confirmation.
Le_menu_Edite
Annule
Relit le bloc courant. Ceci permet d'annuler toutes les
modifications, tant que vous ne les avez pas enregistrΘes.
Revient
Chaque fois que vous vous dΘplacez avec les boutons "aller au
premier bloc", "aller au dernier bloc", ou "GOTO", l'ancienne
position est conservΘe en mΘmoire, et cette commande vous permet
d'y revenir par la suite. L'ancienne position est Θgalement
mΘmorisΘe dans ce cas, ce qui peut Ωtre utile si vous travaillez
toujours sur les deux mΩmes blocs.
Bloc suivant
Lorsque vous Θditez une unitΘ DOS, cette commande vous permet
d'aller soit au premier bloc de donnΘes (si vous Ωtes sur une
entΩte de fichier), soit au bloc suivant (si vous Ωtes sur un
bloc de donnΘes d'une disquette en OFS).
Bloc parent
Lorsque vous Θditez une unitΘ DOS et que le bloc courant est une
entΩte de fichier (ou un rΘpertoire), cette commande vous permet
d'aller au bloc de type "rΘpertoire" correspondant au rΘpertoire
pΦre de ce fichier (ou rΘpertoire).
Bloc racine
Lorsque vous Θditez une unitΘ DOS, cette commande vous permet de
vous positionner directement sur le bloc racine de cette unitΘ.
Bloc d'entΩte
Lorsque vous Θditez une unitΘ DOS, cette commande vous permet de
vous positionner sur le bloc d'entΩte (de fichier ou de
rΘpertoire) suivant.
Dans les quatre cas prΘcΘdents, l'ancienne position est mΘmorisΘe
afin que vous puissiez y revenir avec la commande "Revient" (voir
chapitre "Le_menu_Edite").
Le_menu_Outils
Infos
Affiche les caractΘristiques de ce que vous Θditez
(fichier/mΘmoire/unitΘ).
Examine
Lorsque vous Θditez une unitΘ DOS et que le bloc courant est un
bloc d'entΩte, cette commande vous permet d'afficher les mΩmes
informations que la commande "Infos" sur le fichier ou
rΘpertoire correspondant α ce bloc d'entΩte.
Imprime...
Vous permet d'imprimer un ou plusieurs blocs α partir du bloc
courant. Une boite de requΩte apparait pour vous permettre
Θventuellement d'envoyez la sortie vers un fichier, plut⌠t que
vers l'imprimante ("PRT:"). AZap vous demandera ensuite le
nombre de bloc α imprimer.
Conversion
Fait apparaitre une fenΩtre supplΘmentaire, avec quatre gadgets,
qui vous permet d'effectuer des conversions entre nombres
binaires, dΘcimaux, hexadΘcimaux et chaines de caractΦres. Toute
valeur saisie, c'est-α-dire une expression complΩte pour les
gadgets "BIN", "DEC", et "HEX" ou une chaine de caractΦres pour
le gadget "ASC", est convertie dans les autres unitΘes. Notez
que cette fenΩtre ne bloque pas les fenΩtres d'Θdition.
Sauve bloc
Vous permet de sauver le contenu d'un ou de plusieurs blocs α
partir du bloc courant. Une requΩte de fichier apparait pour
vous permettre d'indiquer le fichier o∙ sauver les blocs. AZap
vous demandera ensuite le nombre de bloc α sauver.
Remplit bloc...
Vous permet de mettre tous les octets du bloc courant α la mΩme
valeur. Une boite de requΩte apparait, entrez la valeur
dΘsirΘe : soit 'c' pour remplir avec le caractΦre "c", soit un
nombre qui indique le code ASCII du caractΦre (prΘcΘdΘ par "0x"
pour une valeur hexadΘcimale).
Le_menu_Recherche
Cherche...
Vous permet de commencer une recherche. Une boite de requΩte
apparaεt, entrez la valeur α chercher : soit une valeur
hexadΘcimale (prΘcΘdΘe par "0x", attention α donner un nombre
pair de chiffres), soit une chaine de caractΦre (recherche
ASCII). Pour chercher une chaine commenτant par "0x", mettez
toute la chaine entre guillemets.
Cherche texte...
Vous permet de chercher des suites de caractΦres affichables.
Cela peut Ωtre utile par exemple pour chercher une zone de
textes. Une boite de requΩte apparaεt, entrez le nombre minimal
de caractΦres que doit avoir une suite pour Ωtre prise en
compte. Une valeur infΘrieure α 4 n'est en gΘnΘral pas trΦs
intΘressante.
Cherche suivant
Vous permet de poursuivre la recherche α partir de la position
courante.
Dans les trois cas prΘcΘdents, si la valeur que vous avez entrez est
trouvΘe, AZap se positionne automatiquement α l'endroit
correspondant. L'ancienne position est mΘmorisΘe afin que vous
puissiez y revenir avec la commande "Revient" (voir chapitre
"Le_menu_Edite"). Il est possible d'interrompre la recherche, et
AZap est capable de trouver une chaine α cheval sur deux blocs.
Cherche fichier
Vous permet de vous positionner directement sur le bloc d'entΩte
d'un fichier ou d'un rΘpertoire. Une requΩte de fichier
apparait, pour que vous puissiez sΘlectionner le fichier α
chercher. AZap ouvre alors une fenΩtre d'Θdition sur l'unitΘ
correspondante, et se place sur le bloc d'entΩte du fichier.
Le_menu_Options
Notez que les options sont locales α chaque fenΩtre : changer une
option n'affectera que la fenΩtre courante. Lorsque vous ouvrez une nouvelle
fenΩtre, elle hΘrite des options de la fenΩtre courante.
Somme de contr⌠le
Vous permet d'indiquer α AZap quand il doit recalculer les
sommes de contr⌠le des blocs (ceci n'est pris en compte que si
vous Θditez une unitΘ). Les choix sont : "Recalcule" (AZap
recalcule la somme de contr⌠le pour *TOUS* les blocs), "Demande"
(AZap vous posera la question α chaque Θcriture), "Blocs 0 & 1"
(seulement pour le bloc d'amorτage) et "Automatique" (seulement
si la somme de contr⌠le Θtait correcte α la lecture).
Sauveg. auto
AZap sauvegarde automatiquement tout bloc modifiΘ dΦs que vous
demandez α changer de bloc.
Lecture seule
AZap interdit toute modification des donnΘes.
min = MAJ
Indique si les majuscules et les minuscules seront diffΘrenciΘes
ou non lors des recherches.
Copie de sauveg.
Indique si AZap doit crΘer une copie de sauvegarde des fichiers
ΘditΘs. Si cette option est sΘlectionnΘe, α la prochaine
tentative d'Θcriture, une boite de requΩte apparaitra pour vous
demander le nom de la copie α crΘer. AZap fera alors une copie
du fichier, avant d'enregistrer vos modifications. En cas
d'erreur pendant la copie, la boite de requΩte rΘapparaitra,
pour vous permettre d'indiquer un autre nom. Si vous cliquez sur
"Cancel", aucune copie ne sera faite mais les modifications
seront enregistrΘes quand mΩme.
Syntaxe_des_expressions
AZap est capable de calculer des expressions entiΦres. La base par
dΘfaut est soit le dΘcimal pour la saisie des adresses (gadget "GOTO") soit
la base correspondant au gadget pour la fenΩtre de conversion. Il est
possible de prΘciser la base, en prΘfixant un nombre par "%" pour le
binaire, "#" pour le dΘcimal, et "$" ou "0x" pour l'hexadΘcimal. Les
opΘrateurs connus sont :
+ addition
- soustraction
| "ou" logique
& "et" logique
* multiplication
/ division entiΦre
% reste de la division entiΦre
< dΘcalage α gauche
> dΘcalage α droite
Normalement, les opΘrateurs "*", "/", "%", "<" et ">" sont plus prioritaires
que les autres, mais vous pouvez utiliser des parenthΦses. En cas d'erreur
de syntaxe, le rΘsultat d'une expression sera Θgal α -1.
Remarques_importantes
Lors du dΘmarrage du programme, AZap consulte la structure ExecBase
pour connaitre votre configuration mΘmoire. Seules les zones indiquΘes dans
les listes de gestion de mΘmoire peuvent Ωtre ΘditΘes. Sauf lors des
recherches, AZap considΦre ces zones comme contigⁿes et passe
automatiquement de l'une α l'autre. Utilisez la commande "Infos" (voir
chapitre "Le_menu_Outils" pour avoir la liste des zones mΘmoires. Notez que
la lecture et l'Θcriture des blocs mΘmoire se fait aprΦs blocage temporaire
du multi-tΓches, afin d'Θviter des conflits d'accΦs.
Lorsque vous ouvrez une fenΩtre d'Θdition sur une unitΘ, AZap est
capable de dΘtecter son type. Certaines opΘrations seront impossibles sur
une unitΘ non AmigaDOS (commandes "bloc suivant", "bloc pΦre" et "bloc
racine", voir chapitre "Le_menu_Edite"), mais pensez α dΘsactiver le
recalcul de la somme de contr⌠le ! Le programme sait reconnaitre le systΦme
de fichier utilisΘ (OFS = Old File System, FFS = Fast File System) et gΘrer
ces deux systΦmes.
Historique
AZap a ΘtΘ Θcrit principalement en langage C, sur un Amiga 3000
UNIX-1 (10 Mo de mΘmoire, lecteur de disquettes interne HD, disque interne
de 100 Mo, lecteur SyQuest externe de 88 Mo, lecteur de disquettes externe,
moniteur 1960 et imprimante Star LC24-10) connectΘ par un cable null-modem α
un A500 avec 1 Mo de mΘmoire.
v1.00 14-Oct-92, 36084 octets (Fish #759)
o PremiΦre version diffusΘe
v1.01 16-Oct-92, 36084 octets
o Bug corrigΘ: ne marchait pas si l'Θcran public par dΘfaut faisait
moins de 648 pixels de large
v1.10 15-Nov-92, 36960 octets
o Ajout des commandes "Bloc d'entΩte" et "Examine"
o AprΦs une requΩte de fichier, ouvre une fenΩtre mΘmoire si on a
choisi "RAM:" ou une fenΩtre d'unitΘ si on a choisi un nom d'unitΘ
(e.g. "DH0:")
v1.11 21-Nov-92, 36976 octets
o Bug corrigΘ: ne comprenait plus la forme "ºn" pour le GOTO.
v1.20 25-Dec-92, 40000 octets
o CompilΘ avec le SAS/C 6.1
o Ajout de la fonction "Cherche fichier"
o La requΩte de la commande "GOTO" conserve l'ancienne valeur saisie
o Si une recherche de chaine Θchoue, affiche un message "toto non
trouvΘ"
o Les unitΘs peuvent Ωtre dΘsignΘes par leur nom logique (α l'appel
et dans la requΩte de fichier, sauf RAM:)
v1.30 02-Jan-93, 40612 octets
o Ajout de la fonction "Sauve bloc"
o La fonction "Imprime" demande le nombre de blocs α imprimer
o La fonction "Infos" donne le type de disque (OFS/FFS/NDOS)
o Fonctions de recherche regroupΘes dans un nouveau menu
o Fonction "Remplit bloc" dΘplacΘe dans le menu "Outils"
o Quelques erreurs corrigΘes dans la gestion de la police par
dΘfaut, et de l'Θcran WorkBench
v2.00 07-Feb-93, 42116 octets
o CompilΘ avec le SAS/C 6.2
o EntiΦrement localisΘ
v2.01 21-Feb-93, 41768 octets
o Gestion de la requΩte de fichier amΘliorΘe
o Quelques erreurs corrigΘes dans la gestion des options des
fenΩtres
v2.02 13-Mar-93, 42264 octets
o Plus de gourous avec un 68000 (quelques pointeurs mal alignΘs)
o Se dΘtache α nouveau du CLI
o La fenΩtre "A propos..." a un gadget de fermeture
v2.03 15-Apr-93, 42292 octets
o Quelques erreurs corrigΘes dans l'Θvaluation des expressions
o Erreur corrigΘ: oubliait parfois de remettre α zΘro l'indicateur
"bloc modifiΘ" quand on changait de bloc
v2.04 24-Apr-93, 42468 octets (Fish #875)
o Indique le nom complet des fichiers dans le titre de la fenΩtre et
dans la fenΩtre "info"
o Reconnait tous les systΦmes de fichiers de l'OS 3.0
o Quelques erreurs corrigΘes dans la gestion des menus
v2.05 10-May-93, 42604 octets
o Plusieurs erreurs corrigΘes dans la fonction de recherche (hexa et
chaine)
v2.06 18-May-93, 42692 octets
o Quelques erreurs corrigΘes dans la fonction de convertion
(bin/dec/hex/asc)
v2.07 03-Jul-93, 43548 octets
o CompilΘ avec le SAS/C 6.3
v2.08 29-Jul-93, 43580 octets
o En cas d'erreur de lecture sur une disquette ou un disque, fait
flasher l'Θcran et affiche un secteur α zΘro.
v2.10 15-Sep-93, 44200 octets
o Ajout d'un ascenseur en bas de la fenΩtre
o Utilise les nouvelles versions des fonctions GetDefaultTextFont()
et OuvreEcran()
v2.11 22-Sep-93, 44184 octets
o Erreur trΦs dr⌠le corrigΘe dans la recherche: en cas d'Θchec,
l'affichage n'Θtait pas mis α jour. Du coup, les valeurs des
octets Θtaient modifiΘes quand on dΘplaτait le curseur. Dans
certain cas on pouvait mΩme faire descendre le curseur en dessous
de la derniΦre ligne, et les valeurs des octets s'affichaient par
dessus les boutons.