home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / amok_lha / amok01.lha / M2Error / M2err.doc < prev    next >
Encoding:
Text File  |  1993-08-16  |  2.9 KB  |  72 lines
  1. -----------------------------------------------------------------------------
  2.    :Program.    M2Error
  3.    :Author.     Fridtjof Björn Siebert (Amok)
  4.    :Address.    Nobileweg 67, D-7000 Stuttgart-40
  5.    :Phone.      (0)711/822509
  6.    :Shortcut.   [fbs]
  7.    :Version.    1.0
  8.    :Date.       29.03.88
  9.    :Copyright.  PD, but of course contributions are wellcomed.
  10.    :Language.   Modula-II
  11.    :Translator. M2Amiga
  12.    :Imports.    none.
  13.    :Contents.   Program to type compile-errors.
  14.    :Remark.     Usage: M2Error Source
  15.    :Bugs.       none known yet. I still don't know what c1455252H in Error-
  16.    :Bugs.       means, but I guess it's not important.
  17. -----------------------------------------------------------------------------
  18.  
  19. Diese Routine macht im Prinzip nicht viel mehr als das Programm
  20. `M2Error', daß M2Amiga beiliegt. M2Error gibt aber zu jeder fehler-
  21. haften Zeile lediglich die Umgebung, und nicht, was viel nötiger wäre,
  22. die Zeilennummer aus.
  23.  
  24. Bei M2Err ist dieser Mangel beseitigt. Es werden die Zeilennummern der
  25. fehlerhaften Zeilen ausgegeben, so daß man in einem Editor direkt in
  26. diese springen kann, ohne viel zu suchen. Nicht beabsichtigt, aber
  27. dennoch positiv ist, daß M2Err die Fehlerliste fast doppelt so schnell
  28. ausgibt wie M2Error.
  29.  
  30. Außerdem werden von M2Err keine Minuszeichen ausgegeben, die ich bei
  31. M2Error ziemlich häßlich finde. Der Pfeil nach oben wurde durch einen
  32. dezenten Strich ersetzt.
  33.  
  34. Als ich M2Err schrieb viel mir negativ auf, daß ich nirgends eine
  35. Dokumentation der Fehlerdatei und der Fehlerlist fand. Inzwischen ist
  36. mir nach vielen Hexdumps das Format jedoch einigermaßen klar geworden.
  37. Für diejenigen, die auch über die Fehlerdateien bescheidwissen
  38. möchten, hier kurz deren Aufbau:
  39.  
  40. s:Modula-2 Fehlermeldungen:
  41.  
  42.   1. Addresse des nächsten Fehlers (4 Byte)
  43.   2. Fehlernummer                  (2 Byte)
  44.   3. Fehlertext, Ende mit 0        (x Byte)
  45.  
  46.   4. Wie 1. Hierher zeigt der Zeiger bei 1.
  47.   5. Fehlernummer
  48.   etc.
  49.  
  50.   letzter Zeiger zum nächsten Fehler ist 0. Danach ist die
  51.   Fehlernummer auch 0.
  52.  
  53. .modE und .defE -File:
  54.  
  55.   1. LONG(3).     (4 Byte) Bedeutung ist mir unklar
  56.   2. WORD(c145H)  (2 Byte) Bedeutung auch nicht klar. 2. Byte ist `E'
  57.  
  58.   3. WORD(5252H)  (2 Byte) `RR' ergibt mit 2. `ERR'
  59.   4. Adrresse des Fehlers im .mod oder .def-File (4 Byte)
  60.   5. Fehlernummer (2 Byte) Entspricht Nummer in "s:Modula-2 Fehlermeldungen"
  61.      Vorsich: Die Fehlernummer muß nicht in der Fehlerliste enthalten sein.
  62.      Es gibt Fehlernummern, die in der zum M2Amiga-Buch gehörenden Fehler-
  63.      mit xx bei den zwei niederwertigsten Ziffern, die in der Fehlerdatei
  64.      fehlen. Dies ist aber nicht weiter schlimm, da die Fehlermeldungen
  65.      (für mich) unverständlich sind.
  66.   6. WORD(c145H) oder WORD(0FFFFH) (2 Byte). Wenn keines von beidem, dann
  67.      zweite oder dritte Fehlernummer, kann wie 5. behandelt werden. c145H
  68.      zeigt an, daß weitere Fehler folgen. 0FFFFH bedeutet Ende der Fehler-
  69.      dateil.
  70.  
  71. -- Fridtjof.
  72.