home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / maj / 2188 / patchlag.txt < prev    next >
Text File  |  1994-05-06  |  10KB  |  257 lines
  1.  
  2.  
  3.                Interpréteur PATCHLAG v1.0
  4.                Manuel de référence
  5.  
  6.                Le Grand Manitou 91a
  7.                (P)1994 Virtual Waves, MWPC2
  8.  
  9.  
  10.  Je suppose dans ce manuel que vous avez déjà assimilé les bases de la
  11.  programmation. Toute personne sachant programmer en Basic et ayant des
  12.  connaissances sur la gestion de fichiers sous MS-DOS n'aura pas difficultés.
  13.  C'est un manuel de REFERENCE, il ne vous apprendra pas à programmer, ni à
  14.  patcher un jeu.
  15.  
  16.  ■ Le fichier de patchs:
  17.    C'est un simple fichier texte dont l'extension est PAT. Vous pouvez
  18.    cependant utiliser l'extension qui vous plait mais je vous recommande
  19.    d'utiliser PAT pour simplifier la reconnaissance et l'échange de ces
  20.    fichiers.
  21.    Vous avez différentes façon de dire au Grand Manitou quel fichier
  22.    de patchs utiliser.
  23.  
  24.    - Si vous ne spécifiez rien au Grand Manitou, il cherchera le fichier
  25.      MANITOU.PAT dans le répertoire actuel.
  26.    - Vous pouvez entrer le chemin et le nom du fichier dans la ligne
  27.      de commande. Exemple : MANITOU c:\utls\toto.pat
  28.    - Vous pouvez spécifier le fichier de patchs par la variable d'environnement
  29.      MANITOU.    Exemple : SET MANITOU=c:\utls\toto.pat
  30.      C'est à mon sens le moyen le plus pratique. Vous pouvez incorporer cette
  31.      commande dans votre AUTOEXEC.BAT.
  32.    - Vous pouvez utiliser le programme résident APPEND (à la manière de PATH)
  33.      et y ajouter le chemin de MANITOU.PAT. Consultez votre manuel du MS-DOS
  34.      pour plus d'informations sur ce programme.
  35.  
  36.  
  37.  ■ Syntaxe générale:   nn cc xxxxxxxxxxxxx...
  38.  
  39.           nn    : numéro de ligne (00 à 99)
  40.           cc    : commande
  41.           xx... : paramètres.
  42.  
  43.     Exemple: 17 DP 5782
  44.  
  45.  ■ Structure de programme nécessaire:
  46.  
  47.        00 NO <nom_du_patch>                 annonce de début de programme
  48.        nn EN                                annonce de fin de programme
  49.  
  50.  ■ Stucture de programme recommandée:
  51.        00 NO <nom_du_patch>
  52.        05 CM <commentaires>
  53.        10 AF <remarques,détails>
  54.        ...
  55.        nn EN
  56.  
  57.  ■ Référence de toutes les instructions:
  58.  
  59.  
  60.   ▒▒ AF <texte>
  61.      AFFICHE
  62.     Affiche le texte spécifié.
  63.          Ex : 23 AF Bonjour !             affichera 'Bonjour !'
  64.  
  65.   ▒▒ AT <secondes>
  66.      ATTEND
  67.     Attend le nombre de secondes spécifiées. L'execution reprend ensuite
  68.     normalement.
  69.     On peut spécifier des décimales.
  70.     Si une touche est pressée, l'execution du programme reprend même si
  71.     le delais <secondes> n'est pas entièrement écoulé.
  72.          Ex:   13 AT 1.5
  73.  
  74.   ▒▒ C2 <nom>
  75.      COPIE
  76.     Copie le fichier actuellement ouvert en donnant le nom <nom> à la
  77.     copie. Si le fichier <nom> existe déjà, il est effacé.
  78.     Le fichier à copier doit avoir été ouvert auparavant avec la
  79.     command OP.
  80.     Attention : cette commande ne conserve pas la position du
  81.     pointeur de fichier.
  82.          Ex: 19 C2 essai.exe
  83.  
  84.   ▒▒ CH <masque>
  85.      CHOISIT FICHIER
  86.     Cette commande permet à l'utilisateur de choisir un fichier à ouvrir.
  87.     On choisit les fichiers avec <masque>, par exemple *.*, *.GAM,
  88.     SAVED?.SVE, etc...
  89.     <masque> s'utilise comme dans la commande DIR du DOS.
  90.     108 fichiers au maximum peuvent être affichés à l'écran en même temps.
  91.     Si il y a plus de 108 fichiers ou si il n'y a aucun fichier qui
  92.     correspondent à <masque>, alors l'éxecution du patch est stoppée.
  93.     La séléction du fichier se fait avec les flèches et [ENTREE].
  94.     Si un fichier est séléctionné avec [ENTREE], il est ouvert (ce qui est
  95.     équivalent à la commande OP).
  96.     Si [ESC] est pressé, l'execution du patch est stoppée et le Grand
  97.     Manitou revient au menu principal.
  98.          Ex: 26 CH *.gam
  99.  
  100.   ▒▒ CK <taille>@<contrôle>
  101.      CHECKSUM (SOMME DE CONTROLE)
  102.     Fait la somme de contrôle des <taille> octets suivants à partir de
  103.     la position du pointeur de fichier.
  104.     Si la somme de contrôle <contrôle> ne concorde pas avec les octets
  105.     lus, l'execution du programme est stoppée.
  106.          Ex: 54 CK 2048@5f3e
  107.  
  108.   ▒▒ CL
  109.      CLOSE (FERMETURE DU FICHIER)
  110.     Ferme le fichier actuellement ouvert.
  111.     Cette commande est sans effet si aucun fichier n'est ouvert.
  112.     Elle peut être utile pour fermer un fichier avant son utilisation
  113.     par un autre logiciel dans une commande SHELL.
  114.          Ex :    78 CL
  115.  
  116.   ▒▒ CM <commentaire>
  117.      COMMENTAIRE
  118.     Cette commande permet d'afficher du texte dans la colonne de droite
  119.     lors de la séléction du patch avec les flèches dans Le Grand Manitou.
  120.          Ex: 04 CM 255 munitions.
  121.  
  122.   ▒▒ CN
  123.      CONTINUER ?
  124.     Attend qu'une touche soit pressée.
  125.     Si cette touche est O ou o, l'execution continue.
  126.     Dans les autres cas, l'execution est stoppée.
  127.     Ceci est utile pour poser des question du style:
  128.         "Voulez-vous continuer (O/N) ?"
  129.          Ex: 17 CN
  130.  
  131.   ▒▒ CR <nom>
  132.      CREER FICHIER
  133.     Créé un nouveau fichier dont le nom est <nom>. Tout fichier ouvert
  134.     précédemment est automatiquement fermé.
  135.          Ex:  24 CR temp.bin
  136.  
  137.   ▒▒ DP <offset>
  138.      DEPLACE
  139.     Déplace le pointeur de fichier à l'offset (l'octet) indiqué.
  140.     Un fichier doit déjà avoir été ouvert avec OP ou CH.
  141.     En plaçant + ou - devant l'offset, on peut faire des déplacements
  142.     relatifs.
  143.          Ex: 12 DP 456                Va au 456ième octet
  144.          12 DP +456               Avance de 456 octets à partir
  145.                       de la position actuelle.
  146.          12 DP -456               Recule de 456 octets
  147.       Si l'offset absolu (SANS + ni -) est supèrieur à la taille du fichier,
  148.       l'execution est stoppée.
  149.       Si l'offset relatif dépasse le fichier, l'offset est mis à la fin du
  150.       fichier pour +, au début du fichier pour -.
  151.  
  152.   ▒▒ EC <hexa>@<contrôle>
  153.      ECRIT
  154.     Ecrit les octets donnés par <hexa>.
  155.     <contrôle> est une somme de contrôle et l'execution est stoppée si
  156.     elle ne concorde pas avec <hexa>.
  157.          Ex: 17 EC 414346@199            écrit ACF
  158.  
  159.   ▒▒ EE
  160.      EFFACE ECRAN
  161.     Efface l'écran
  162.          Ex:  78 EE
  163.  
  164.   ▒▒ EN
  165.      END, Fin de programme
  166.     Signale la fin du programme. L'execution du patch est stoppée et le
  167.     Grand Manitou revient au menu principal.
  168.          Ex: 56 EN
  169.  
  170.   ▒▒ OP <fichier>
  171.      OPEN, ouvre un fichier
  172.     Cette commande ouvre un fichier déjà existant et positionne le pointeur
  173.     de fichier sur le premier octets du fichier.
  174.     A utiliser avant toute instruction C2, CK, DP, EC, RP, RC ou TL.
  175.     Si le fichier est introuvable, l'éxecution du patch est stoppée et
  176.     un message d'erreur s'affiche.
  177.     La commande OP ferme tout fichier ouvert auparavant.
  178.          Ex:   12 OP term2.exe
  179.  
  180.   ▒▒ RC <hexa>@<contrôle>
  181.      RECHERCHE
  182.     Cette commande recherche <hexa> et positionne le pointeur de fichier
  183.     sur le premier octet de <hexa>.
  184.     Si la somme de contrôle <contrôle> ne concorde pas avec <hexa>,
  185.     l'execution du patch est stoppée.
  186.          Ex:   47 RC CB2D3F@1E2
  187.  
  188.   ▒▒ RP <hexa1>/<hexa2>@<contrôle>
  189.      RECHERCHE ET REMPLACE
  190.     Recherche <hexa1> et remplace par <hexa2>.
  191.     <hexa1> et <hexa2> peuvent être de taille différente : <hexa2> sera
  192.     toujours écrit à partir du début de <hexa1>.
  193.     Si <hexa1> est introuvable, l'execution du patch s'arrête.
  194.     Si la somme de contrôle <contrôle> ne concorde pas avec <hexa1> ET
  195.     <hexa2>, l'execution du patch est stoppée.
  196.          Ex: 23 RP F323D1/F4239090@486
  197.  
  198.   ▒▒ SH <commande>
  199.      SHELL
  200.     Lance la commande <commande> en SHELL.
  201.     Si <commande> est omis, un accès au DOS est donné en SHELL.
  202.     (Taper EXIT fait revenir au Grand Manitou et l'execution du patch
  203.      se poursuit).
  204.          Ex: 15 SH del essai.gam
  205.  
  206.   ▒▒ TC
  207.      ATTENTE TOUCHE.
  208.     L'éxecution du programme est suspendue et ne reprend que si une touche
  209.     (n'importe laquelle) est pressée.
  210.          Ex:  64 TC
  211.  
  212.   ▒▒ TL <taille>
  213.      TAILLE
  214.     Si <taille> ne correspond pas à la taille du fichier ouvert,
  215.     l'execution du patch est stoppée.
  216.     Si la taille correspond, l'execution se poursuit normalement.
  217.          Ex:  36 TL 31744
  218.  
  219.  
  220.  Testez vos programmes : si le logiciel affiche trois losanges clignotants,
  221.  c'est qu'une erreur s'est produite. Le nombre entre parenthèses qui suit vous
  222.  indique à quelle ligne s'est produite l'erreur.
  223.  Certaines erreurs dans mes patchs sont tout à fait normales, comme par exemple
  224.  de ne pas trouver un fichier dans un répertoire (avec CH ou OP).
  225.  Dans tous mes patchs, j'affiche d'abord un petit texte qui explique ce que
  226.  fait le patch avant de commencer son action. Je vous recommande d'en faire
  227.  autant.
  228.  
  229.  Avant d'éxecuter le programme en Patchlag, Le Grand Manitou vérifie toutes
  230.  les sommes de contrôles (@xxx) pour les instructions EC, RC et RP.
  231.  Ceci permet d'éviter des erreurs de frappe quand un Patch est recopié à
  232.  la main.
  233.  
  234.  Toute ligne qui ne comporte pas au moins un chiffre dans les deux premiers
  235.  caractères est ignorée. Les commentaires peuvent donc être tapés directement.
  236.  
  237.  N'hésitez pas à consulter le fichier MANITOU.PAT qui contient des exemples.
  238.  
  239.  Je n'ai pas testé l'interpréteur PATCHLAG à fond, et il est possible qu'il
  240.  soit bugué. J'ai cependant mis pas mal de garde-fou pour empêcher les
  241.  erreurs. Il devrait fonctionner même dans de mauvaises conditions.
  242.  Tous les cas n'ont cependant pas étés pris en compte.
  243.  Par exemple, je n'ai pas prévu la gestion d'erreurs dans le cas ou des
  244.  fichiers seraient en READ ONLY. Dans le pire des cas, le programme
  245.  quittera en signalant une erreur.
  246.  
  247.  J'ai testé les patchs du fichier MANITOU.PAT sur chacun des jeux concernés
  248.  et ils ont tous fonctionné.
  249.  
  250.  Le patch de Xenon 2 a été modifié : Le Grand Manitou refusait de modifier
  251.  le fichier XENON2.EXE de certaines éditions. Le patch est maintenant
  252.  executé sur le fichier XENON2.EXE, mais sans aucune vérification.
  253.  Je ne garantis pas son fonctionnement sur toutes les éditions de Xenon 2.
  254.  
  255.  
  256. - fin de la doc de PATCHLAG v1.0 - le 6 mai 1994 -
  257.