home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0759.lha / AZap / AZap.doc < prev    next >
Text File  |  1992-11-06  |  16KB  |  376 lines
  1.  
  2.                AZap - Manuel de rΘfΘrence
  3.  
  4.  
  5.  
  6.  
  7.  
  8.   1. Avertissement
  9.  
  10.       Ce manuel dΘcrit la version 1.00 de l'utilitaire AZap. Ce  programme
  11.   est (c)1992 par Denis GOUNELLE, toute utilisation commerciale ou vente  sans
  12.   autorisation    Θcrite    est  strictement  interdite.  Vous  pouvez  copier  et
  13.   diffuser ce programme aux conditions suivantes :
  14.  
  15.     - l'ensemble des fichiers doit Ωtre fourni
  16.     - aucun fichier ne doit avoir ΘtΘ modifiΘ
  17.     - vous ne devez pas demander plus de 40FF pour cela
  18.  
  19.       MalgrΘ de nombreux tests, je ne peux garantir  qu'AZap  ne  contient
  20.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.    Je  ne
  21.   pourrai en aucun cas Ωtre tenu pour responsable de tout dommage,  direct  ou
  22.   indirect, rΘsultant de l'utilisation d'AZap.
  23.  
  24.   2. Introduction
  25.  
  26.       AZap est un Θditeur binaire "nouvelle gΘnΘration", capable  d'Θditer
  27.   aussi bien un fichier que la mΘmoire, ou encore  une    disquette  (mΩme  s'il
  28.   n'offre pas d'outils pour vous aider α rΘcupΘrer une disquette  endommagΘe).
  29.   AZap peut ouvrir plusieurs fenΩtres d'Θdition en mΩme temps  et  dispose  de
  30.   nombreuses fonctions, comme l'impression  d'un  bloc,  le  remplissage  d'un
  31.   bloc, la recherche d'une chaine, etc...
  32.  
  33.                    NOTE IMPORTANTE :
  34.  
  35.       Il est interdit de se servir  de    ce  programme  pour  modifier  des
  36.       indications de copyright, ou pour toute autre usage contraire  α    la
  37.       loi.  De    plus,  je  dΘconseille    vivement  aux    utilisateurs   non
  38.       expΘrimentΘs d'utiliser ce programme : vous risquez  de  rendre  des
  39.       programmes inutilisables,  ou  de  perdre  toutes  les  informations
  40.       stockΘes sur votre disque dur ! 
  41.  
  42.       Vos critiques et suggestions sur ce programme  seront  toujours  les
  43.   bienvenues. N'hΘsitez pas α m'Θcrire, α l'adresse suivante :
  44.  
  45.                    M. GOUNELLE Denis
  46.                     Boite 71
  47.                   6, rue des cailloux
  48.                  92110 CLICHY - FRANCE
  49.  
  50.       AZap utilise la  bibliothΦque  "reqtools.library"  v2.0C,  que  vous
  51.   devez copier dans votre rΘpertoire  "LIBS:",  si  ce  n'est  dΘjα  fait.  La
  52.   bibliothΦque "reqtools.library" est (c)1990-1991 par Nico FRANCOIS.
  53.       Merci  α  Pierre  ARDICHVILI    et  α  Jean-Yves  PROUX   pour     leurs
  54.   suggestions.
  55.  
  56.   3. Appel depuis le CLI
  57.  
  58.       AZap se dΘtache automatiquement du CLI. Les arguments acceptΘs  sont
  59.   les suivants :
  60.  
  61.       WBENCH
  62.       Normalement, AZap ouvre son propre Θcran. Cette option permet de
  63.       travailler sur l'Θcran Workbench.
  64.  
  65.       LACE
  66.       Si cette option est prΘsente, AZap ouvre un Θcran  entrelacΘ    au
  67.       lieu d'un Θcran normal. Notez que cette option  est  ignorΘe  si
  68.       vous avez indiquΘ l'option WBENCH.
  69.  
  70.       FONT nom
  71.       Par dΘfaut, AZap utilise une police interne de 6x9. Vous  pouvez
  72.       cependant demander α utiliser une autre police : "nom" doit Ωtre
  73.       sous la forme <nom de  la  police><taille  en  Y>  (par  exemple
  74.       "courier9"). AZap refusera si la police est proportionnelle,  ou
  75.       si elle est trop grande pour pouvoir afficher  un  bloc  de  512
  76.       octets.
  77.  
  78.       MEMORY
  79.       Au dΘmarrage, AZap ouvre une fenΩtre d'Θdition de la mΘmoire.
  80.  
  81.       DEVICE nom
  82.       Au dΘmarrage, AZap ouvre  une  fenΩtre  d'Θdition  pour  l'unitΘ
  83.       "nom". N'oubliez pas les deux-points (":") α la fin du nom.
  84.  
  85.   Tout autre argument est considΘrΘ comme un nom de  fichier  α  ouvrir.  Vous
  86.   pouvez indiquer plusieurs noms de fichiers, mais  seuls  les    huit  premiers
  87.   seront pris en compte. Il est bien Θvidemment possible d'indiquer α la  fois
  88.   des noms de fichiers, l'option MEMORY, et l'option DEVICE. Si aucun argument
  89.   n'est indiquΘ, une requΩte  de  fichier  apparait  pour  que  vous  puissiez
  90.   sΘlectionner le fichier α Θditer.
  91.  
  92.   4. Appel depuis le Workbench
  93.  
  94.       Vous pouvez indiquer les arguments suivants,    dans  le  champ  "TOOL
  95.   TYPES" de l'ic⌠ne de AZap :
  96.  
  97.       OPTIONS=WBENCH ou OPTIONS=LACE
  98.       Voir description  des  options  WBENCH  et  LACE  au    paragraphe
  99.       prΘcΘdent.
  100.  
  101.       FONT=nom
  102.       Voir description de l'option FONT au paragraphe prΘcΘdent.
  103.  
  104.   Au dΘmarrage, une  requΩte  de  fichier  apparait  pour  que    vous  puissiez
  105.   sΘlectionner le fichier α Θditer.
  106.  
  107.   5. La fenΩtre d'Θdition
  108.  
  109.       La partie gauche  de    l'affichage  montre  le  contenu  du  bloc  en
  110.   hexadΘcimal, par groupe de 4 octets. La partie droite montre l'Θquivalent en
  111.   caractΦres, les codes non imprimables Θtant remplacΘs par un point (".").
  112.       En bas et α droite sont affichΘes quelques informations :  l'adresse
  113.   du bloc (relative au dΘbut, en hexadΘcimal), le dΘplacement dans le bloc (en
  114.   hexadΘcimal), le numΘro de bloc (relatif au dΘbut, en dΘcimal), et  le  type
  115.   de bloc. Cette derniΦre information n'a de sens que quand  vous  Θditez  une
  116.   unitΘ DOS. Quand les donnΘes du bloc ont ΘtΘ modifiΘes, une Θtoile ("*") est
  117.   affichΘe α droite de la premiΦre ligne. Si la somme de contr⌠le du bloc  est
  118.   valide, le caractΦre "V" est affichΘ α droite de la seconde  ligne  (n'a  de
  119.   sens que quand vous Θditez une unitΘ DOS).
  120.  
  121.       A l'ouverture de la fenΩtre, le permier  bloc  est  affichΘ,  et  le
  122.   curseur est positionnΘ sur le premier caractΦre  de  la  partie  droite.  La
  123.   position correspondante dans l'autre partie est  montrΘe  par  un  affichage
  124.   dans une couleur diffΘrente. Vous pouvez vous dΘplacer α l'aide des  touches
  125.   du curseur. Pour  passer  de    la  partie  droite  α  la  partie  gauche  (et
  126.   inversement) utilisez la touche de tabulation. Vous  pouvez  Θgalement  vous
  127.   positionner n'importe o∙ α l'aide de la souris. Pour modifier  les  donnΘes,
  128.   tapez simplement les nouvelles valeurs. Dans la  partie  gauche,  seuls  les
  129.   caractΦres "0" α "9", "a" α "f" et "A" α "F" sont acceptΘs.  AZap  garde  en
  130.   mΘmoire les 32 derniΦres modifications. Tant que vous n'avez pas  changΘ  de
  131.   bloc, vous pouvez annuler ces changements en sens inverse, α    l'aide  de  la
  132.   touche <ESC>. Les touches suivantes sont Θgalement reconnues :
  133.  
  134.       ctrl-haut      va en dΘbut de fichier
  135.       ctrl-bas      va en fin de fichier
  136.       ctrl-gauche      va au bloc prΘcΘdent
  137.       ctrl-droit      va au bloc suivant
  138.       shift-haut      va sur la premiΦre ligne
  139.       shift-bas      va sur la derniΦre ligne
  140.       shift-gauche      va au dΘbut de la ligne
  141.       shift-droit      va en fin de ligne
  142.  
  143.       La rangΘe de boutons en  bas    de  la    fenΩtre  offre    les  fonctions
  144.   suivantes (de gauche α droite) :  aller  au  premier  bloc,  aller  au  bloc
  145.   prΘcΘdent, Θcriture des modifications,  aller  au  bloc  suivant,  aller  au
  146.   dernier bloc. Le bouton tout α droite  (GOTO)  provoque  l'apparition  d'une
  147.   boite de requΩte. Vous Ωtes alors invitΘ α entrer une adresse, sous une  des
  148.   formes suivantes :
  149.  
  150.       nbr      saut α l'adresse 'nbr'
  151.       ºnbr      saut au bloc 'nbr'
  152.       @nbr      saut α l'adresse contenue dans le long mot α l'adresse
  153.           'nbr' (utilisable seulement en Θdition de mΘmoire)
  154.       #nbr      saut α la zone mΘmoire numΘro 'nbr' (utilisable
  155.           seulement en Θdition de mΘmoire)
  156.  
  157.   Dans tous les cas, 'nbr' est une expression entiΦre,  dont  la  syntaxe  est
  158.   dΘcrite plus loin. Notez que si vous changez de bloc    sans  sauvegarder  vos
  159.   modifications, elles seront perdues !
  160.  
  161.       Pour fermer la fenΩtre d'Θdition, il vous suffit de cliquer sur  son
  162.   gadget de fermeture. Si le bloc a ΘtΘ modifiΘ  mais  non  sauvΘ,  AZap  vous
  163.   demandera confirmation. Le programme    s'arrΩte  automatiquement  quand  vous
  164.   fermez la derniΦre fenΩtre.
  165.  
  166.   6. Le menu "Projet"
  167.  
  168.       Ouvre fichier...
  169.       Permet d'Θditer un fichier : une requΩte  de  fichier  apparait,
  170.       sΘlectionnez le fichier dΘsirΘ. AZap    ouvre  alors  une  fenΩtre
  171.       supplΘmentaire d'Θdition.
  172.  
  173.       Ouvre mΘmoire
  174.       Ouvre une fenΩtre supplΘmentaire,  permettant  l'Θdition  de  la
  175.       mΘmoire.
  176.  
  177.       Ouvre unitΘ
  178.       Un sous-menu vous permet de sΘlectionner l'unitΘ α Θditer.  AZap
  179.       ouvre alors une fenΩtre supplΘmentaire d'Θdition.
  180.  
  181.       Palette...
  182.       Vous permet de modifier les couleurs de l'Θcran (une requΩte  de
  183.       couleur apparait).
  184.  
  185.       Sauve prefs
  186.       Vous permet de  sauvegarder  la  configuration  de  AZap  :  les
  187.       couleurs de l'Θcran et la police de caractΦres. Les  options  de
  188.       la fenΩtre courante sont Θgalement  enregistrΘes  comme  options
  189.       par  dΘfaut.    Le   nom   du    fichier   de   configuration   est
  190.       "S:AZap.Config".
  191.  
  192.       A propos...
  193.       Affiche des informations  sur  le  programme.  Appuyez  sur  une
  194.       touche ou cliquez dans la fenΩtre pour la faire disparaεtre.
  195.  
  196.       Quitte
  197.       Termine  l'exΘcution  de  AZap.  Le  programme  vous   demandera
  198.       confirmation.
  199.  
  200.   7. Le menu "Edite"
  201.  
  202.       Annule
  203.       Relit  le  bloc  courant.  Ceci  permet  d'annuler  toutes   les
  204.       modifications, tant que vous ne les avez pas enregistrΘes.
  205.  
  206.       Reviens
  207.       Chaque fois que vous vous dΘplacez avec les  boutons    "aller  au
  208.       premier bloc", "aller au dernier bloc",  ou  "GOTO",  l'ancienne
  209.       position est conservΘe en mΘmoire, et cette commande vous permet
  210.       d'y revenir par la  suite.  L'ancienne  position  est  Θgalement
  211.       mΘmorisΘe dans ce cas, ce qui peut Ωtre utile si vous travaillez
  212.       toujours sur les deux mΩmes blocs.
  213.  
  214.       Bloc suivant
  215.       Lorsque vous Θditez une unitΘ DOS, cette  commande  vous  permet
  216.       d'aller soit au premier bloc de donnΘes (si vous  Ωtes  sur  une
  217.       entΩte de fichier), soit au bloc suivant (si vous  Ωtes  sur  un
  218.       bloc de donnΘes d'une disquette en OFS).
  219.  
  220.       Bloc parent
  221.       Lorsque vous Θditez une unitΘ DOS et que le bloc courant est une
  222.       entΩte de fichier (ou un rΘpertoire), cette commande vous permet
  223.       d'aller au bloc de type "rΘpertoire" correspondant au rΘpertoire
  224.       pΦre de ce fichier (ou rΘpertoire).
  225.  
  226.       Bloc racine
  227.       Lorsque vous Θditez une unitΘ DOS, cette commande vous permet de
  228.       vous positionner directement sur le bloc racine de cette  unitΘ.
  229.  
  230.       Dans les trois cas prΘcΘdents,  l'ancienne  position  est  mΘmorisΘe
  231.       afin que vous puissiez y revenir avec la commande "Reviens".
  232.  
  233.       Remplis bloc...
  234.       Vous permet de mettre tous les octets du bloc courant α la  mΩme
  235.       valeur.  Une    boite  de  requΩte  apparait,  entrez  la   valeur
  236.       dΘsirΘe : soit 'c' pour remplir avec le caractΦre "c",  soit  un
  237.       nombre qui indique le code ASCII du caractΦre (prΘcΘdΘ par  "0x"
  238.       pour une valeur hexadΘcimale).
  239.  
  240.   8. Le menu "Outils"
  241.  
  242.       Infos
  243.       Affiche   les   caractΘristiques   de   ce   que   vous   Θditez
  244.       (fichier/mΘmoire/unitΘ).
  245.  
  246.       Cherche...
  247.       Vous permet de commencer une recherche.  Une    boite  de  requΩte
  248.       apparaεt,  entrez  la  valeur  α  chercher  :  soit  une  valeur
  249.       hexadΘcimale (prΘcΘdΘe par "0x", attention α  donner  un  nombre
  250.       pair de chiffres),  soit  une  chaine  de  caractΦre    (recherche
  251.       ASCII). Pour chercher une chaine  commenτant    par  "0x",  mettez
  252.       toute la chaine entre guillemets.
  253.  
  254.       Cherche texte...
  255.       Vous permet de chercher des suites  de  caractΦres  affichables.
  256.       Cela peut Ωtre utile par  exemple  pour  chercher  une  zone    de
  257.       textes. Une boite de requΩte apparaεt, entrez le nombre  minimal
  258.       de caractΦres que doit  avoir  une  suite  pour  Ωtre  prise    en
  259.       compte. Une valeur infΘrieure α 4  n'est  en  gΘnΘral  pas  trΦs
  260.       intΘressante.
  261.  
  262.       Cherche suivant
  263.       Vous permet de poursuivre la recherche α partir de  la  position
  264.       courante.
  265.  
  266.       Dans les trois cas prΘcΘdents, si la valeur que vous avez entrez est
  267.       trouvΘe,     AZap    se   positionne   automatiquement   α     l'endroit
  268.       correspondant. L'ancienne  position  est  mΘmorisΘe  afin  que  vous
  269.       puissiez    y  revenir  avec  la  commande    "Reviens".  Sinon  l'Θcran
  270.       "flashe". Il est possible d'interrompre la recherche,  et  AZap  est
  271.       capable de trouver une chaine α cheval sur deux blocs.
  272.  
  273.       Imprime...
  274.       Vous permet d'imprimer le bloc courant.  Une  boite  de  requΩte
  275.       apparait pour vous permettre Θventuellement d'envoyez la  sortie
  276.       vers un fichier, plut⌠t que vers l'imprimante ("PRT:").
  277.  
  278.       Conversion
  279.       Fait apparaitre une fenΩtre supplΘmentaire, avec quatre gadgets,
  280.       qui  vous  permet  d'effectuer  des  conversions  entre  nombres
  281.       binaires, dΘcimaux, hexadΘcimaux et chaines de caractΦres. Toute
  282.       valeur saisie, c'est-α-dire une  expression  complΩte  pour  les
  283.       gadgets "BIN", "DEC", et "HEX" ou une chaine de caractΦres  pour
  284.       le gadget "ASC", est convertie dans les  autres  unitΘes.  Notez
  285.       que cette fenΩtre ne bloque pas les fenΩtres d'Θdition.
  286.  
  287.   9. Le menu "Options"
  288.  
  289.       Somme de contr⌠le
  290.       Vous permet d'indiquer α  AZap  quand  il  doit  recalculer  les
  291.       sommes de contr⌠le des blocs (ceci n'est pris en compte  que  si
  292.       vous Θditez une unitΘ).  Les    choix  sont  :    "Recalcule"  (AZap
  293.       recalcule la somme de contr⌠le pour *TOUS* les blocs), "Demande"
  294.       (AZap vous posera la question α chaque Θcriture), "Blocs 0 &  1"
  295.       (seulement pour le bloc d'amorτage) et "Automatique"  (seulement
  296.       si la somme de contr⌠le Θtait correcte α la lecture).
  297.  
  298.       Sauveg. auto
  299.       AZap sauvegarde automatiquement tout bloc modifiΘ dΦs  que  vous
  300.       demandez α changer de bloc.
  301.  
  302.       Lecture seule
  303.       AZap interdit toute modification des donnΘes.
  304.  
  305.       min = MAJ
  306.       Indique si les majuscules et les minuscules seront diffΘrenciΘes
  307.       ou non lors des recherches.
  308.  
  309.       Copie de sauveg.
  310.       Indique si AZap doit crΘer une copie de sauvegarde des  fichiers
  311.       ΘditΘs.  Si  cette  option  est  sΘlectionnΘe,  α  la  prochaine
  312.       tentative d'Θcriture, une boite de requΩte apparaitra pour  vous
  313.       demander le nom de la copie α crΘer. AZap fera alors    une  copie
  314.       du  fichier,    avant  d'enregistrer  vos  modifications.  En  cas
  315.       d'erreur pendant la copie, la  boite  de  requΩte  rΘapparaitra,
  316.       pour vous permettre d'indiquer un autre nom. Si vous cliquez sur
  317.       "Cancel", aucune copie ne  sera  faite  mais  les  modifications
  318.       seront enregistrΘes quand mΩme.
  319.  
  320.   10. Syntaxe des expressions
  321.  
  322.       AZap est capable de calculer des expressions entiΦres. La  base  par
  323.   dΘfaut est soit le dΘcimal pour la saisie des adresses (gadget "GOTO")  soit
  324.   la base correspondant au gadget  pour  la  fenΩtre  de  conversion.  Il  est
  325.   possible de prΘciser la base,  en  prΘfixant    un  nombre  par  "%"  pour  le
  326.   binaire, "#" pour le  dΘcimal,  et  "$"  ou  "0x"  pour  l'hexadΘcimal.  Les
  327.   opΘrateurs connus sont :
  328.  
  329.       +      addition
  330.       -      soustraction
  331.       |      "ou" logique
  332.       &      "et" logique
  333.       *      multiplication
  334.       /      division entiΦre
  335.       %      reste de la division entiΦre
  336.       <      dΘcalage α gauche
  337.       >      dΘcalage α droite
  338.  
  339.   Normalement, les opΘrateurs "*", "/", "%", "<" et ">" sont plus prioritaires
  340.   que les autres, mais vous pouvez utiliser des parenthΦses. En  cas  d'erreur
  341.   de syntaxe, le rΘsultat d'une expression sera Θgal α -1.
  342.  
  343.   11. Remarques importantes
  344.  
  345.       Lors du dΘmarrage du programme, AZap consulte la structure  ExecBase
  346.   pour connaitre votre configuration mΘmoire. Seules les zones indiquΘes  dans
  347.   les listes de gestion  de  mΘmoire  peuvent  Ωtre  ΘditΘes.  Sauf  lors  des
  348.   recherches,  AZap   considΦre   ces    zones    comme    contigⁿes   et     passe
  349.   automatiquement de l'une α l'autre. Utilisez la  commande  "Infos"  du  menu
  350.   "Outils" pour avoir la liste des zones mΘmoires. Notez  que  la  lecture  et
  351.   l'Θcriture  des  blocs  mΘmoire  se  fait  aprΦs   blocage   temporaire   du
  352.   multi-tΓches, afin d'Θviter des conflits d'accΦs.
  353.  
  354.       Lorsque vous ouvrez une fenΩtre d'Θdition sur une  unitΘ,  AZap  est
  355.   capable de dΘtecter son type. Certaines opΘrations  seront  impossibles  sur
  356.   une unitΘ non AmigaDOS (commandes  "bloc  suivant",  "bloc  pΦre"  et  "bloc
  357.   racine"), mais pensez α dΘsactiver le recalcul de la somme de contr⌠le !  Le
  358.   programme sait reconnaitre le systΦme de fichier utilisΘ  (OFS  =  Old  File
  359.   System, FFS = Fast File System) et gΘrer ces deux systΦmes.
  360.  
  361.   12. Historique
  362.  
  363.       AZap est Θcrit en langage C, et compilΘ avec le SAS/C 5.10b, sur  un
  364.   A3000 UNIX-1 ΘquipΘ de 6 Mo de mΘmoire, de 188 Mo de disque, de  2  lecteurs
  365.   de disquettes, et d'un  moniteur  1960.  Le  dΘveloppement  de  la  premiΦre
  366.   version de ce programme a commencΘ le 08-Sep-92, et s'est terminΘ  aprΦs  50
  367.   heures de travail environ.
  368.  
  369.   v1.00   14-Oct-92, 36084 octets
  370.       o PremiΦre version diffusΘe
  371.  
  372.  
  373.  
  374.  
  375.  
  376.