home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / canada-remote-systems / c128 / utils / dis128d.seq < prev    next >
Encoding:
Text File  |  2019-04-13  |  4.0 KB  |  101 lines
  1. METEOR DISSASSEMBLER DOCUMENTS
  2. ╦ENNETH ╦AHL ═ARCH 25, 1988
  3.  
  4.    ═ETEOR DISSASSEMBLER IS A PROGRAM 
  5. WHICH ╔ WROTE FOR MY OWN USE WHICH ╔
  6. HAVE DECIDED TO RELEASE ON A SHAREWARE
  7. BASIS.  ┴S FAR AS ╔ KNOW THERE ARE NO 
  8. OTHER TWO PASS SYMBOLIC DISSASSEMBLERS
  9. AVAILABLE FOR THE C128 ON A COMMERCIAL
  10. (OR ANY OTHER) BASIS.
  11.    ╙OME OF THE FEATURES OF THIS PROGRAM
  12. INCLUDE:
  13.      ─ISSASSEMBLES MACHINE LANGUAGE 
  14. PROGRAMS FROM ANY BANK OR FROM DISK 
  15. FILE (UP TO 40K BYTES LONG).
  16.      ╙ENDS ASSEMBLY LANGUAGE SOURCE
  17. TRANSLATION TO SCREEN, PRINTER, OR
  18. WRITES ╨┴╠/SYMASS COMPATABLE SOURCE
  19. DIRECTLY TO DISK.
  20.      ┴SSIGNS PSUEDO LABELS TO ALL
  21. INTERNAL REFERENCES.
  22.      ┴LLOWS USER INPUT OF ADDITIONAL
  23. LABELS AND AUTOMATIC DEFINITION
  24. OF ALL KERNAL CALLS.
  25.      ┼ASY FLAGGING OF PROGRAM TABLE
  26. AREAS TO BE DUMPED AS 'BYTE' TABLES.
  27.      ┴ LIMITED ABILITY TO RECOGNIZE
  28. IMBEDDED TEXT STRINGS.
  29.      ─ETECTS AND FLAGS ALL POSSIBLE
  30. PHASE ERRORS.
  31.    ┴LL OPTIONS IN THIS PROGRAM ARE
  32. MENU SELECTED AND ARE PRETTY MUCH
  33. SELF EXPLAINATORY.
  34.    ╘HERE ARE SOME POSSIBLE PROBLEMS
  35. THAT YOU SHOULD BE AWARE OF HOWEVER:
  36.      1 ╠ABELS WILL BE ASSIGNED TO ALL
  37. BRANCH INSTRUCTIONS.  ╘HIS COULD LEAD
  38. TO PROBLEMS IF THE BRANCH IS TO AN
  39. AREA OUTSIDE OF THE AREA BEING DISS-
  40. ASSEMBLE.  ╘RY TO DISSASSEMBLE ONLY
  41. SELF CONTAINED PRO#RAMS OR SUBROUTINES
  42. TO AVOID THIS.
  43.     2 ╬O LABEL WILL BE GENERATED FOR
  44. MASKED INSTRUCTIONS (EG BIT $00A9 WHICH
  45. MASKS A LDA #$00 INSTRUCTION).  ╔N THE
  46. EXAMPLE ANY BRANCH OR JUMP TO THE LDA
  47. #$00 WOULD NOT HAVE A CORRESPENDING
  48. DESTINATION LABEL.
  49.     3 ┴LL USER ASSIGNED LABELS ARE
  50. DEFINED AT THE START OF THE ASSEMBLY
  51. LISTING FOR REFERENCE.  ╘HIS CAN LEAD
  52. TO REASSIGNED LABEL ERRORS ON ASSEMBLY.
  53. ┘OU MAY HAVE TO DELETE SOME OF DIRECT
  54. LABEL ASSIGNEMENTS IF THE LABELS ARE
  55. FOR AN AREA WITHIN THE PROGRAM.
  56.    4 ╘RY TO AVOID LABELS WHICH CONTAIN
  57. IMBEDED BASIC COMMANDS.  ╘HESE CAN
  58. CAUSE PROBLEMS WHEN YOU START TO EDIT
  59. A LISTING SINCE THEY GET CRUNCHED.
  60. ╘HIS CAN LEAD TO DIFFERENT LABELS
  61. WHICH LIST THE SAME.  ┘OU SHOULD BE
  62. AWARE THAT SOME OF THE KERNAL NAMES
  63. CAN CAUSE PROBLEMS IN THIS REGARD, AND
  64. SOME HEXADECIMAL NUMBERS CONTAIN THE
  65. 'DEF' (DEFINE FUNCTION) COMMAND.
  66. ═NEMONICS WHICH CONTAIN BASIC COMMANDS
  67. (EOR,AND,ETC.) ARE WRITTEN TO THE DISK
  68. SOURCE FILE AS THEIR CRUNCHED FORMS.
  69.    5 ╔ HAVE REMOVED THE SPACES FROM
  70. SOME OF THE KERNAL NAMES.  ╧THERWISE
  71. THEY ARE STANDARD ├OMMODORE NAMES.
  72.    6 ╒NIMPLEMENTED OR 'CODA OBSCURA'
  73. OPCODES ARE NOT DISSASSEMBLED BUT
  74. APPEAR AS 'BYTE' ASSIGNMENTS.
  75.    7 ╒SER ASSIGNED LABELS MAY BE
  76. ASSIGNED TO ANY AREA OF MEMORY WITH
  77. THE EXCEPTION OF THE ZERO PAGE.
  78.    8 ┴LTHOUGH THIS PROGRAM PRODUCES
  79. ╨┴╠/SYMASS COMPATIBLE SOURCE, IT
  80. COULD PROBABLY BE MODIFIED FOR ANY
  81. OTHER ASSEMBLER WHICH USES THE BASIC
  82. EDITOR.
  83.  
  84.   ┴S A FINAL NOTE YOU WILL NOTICE
  85. THAT ╔ AM RELEASING THIS AS A BASIC
  86. PROGRAM AND NOT A COMPILED VERSION
  87. AS IS THE CASE WITH MOST OTHER
  88. SHAREWARE PROGRAMS.  ╔N EFFECT ╔ AM
  89. GIVING OUT THE SOURCE CODE.  ╔ BELIEVE
  90. THAT THIS GREATLY INCREASES THE 
  91. USEFULLNESS OF THE PROGRAM AND WILL
  92. (╔ HOPE) INCREASE MY REVENUES FROM IT.
  93. ╘IME WILL TELL IF THIS EXPERIMENT IS
  94. A SUCCESS OR IF ╔ AM (AS SOME HAVE TOLD
  95. ME) A FOOL.  ╔ HAVE BEEN CALLED
  96. WORSE NAMES FOR BETTER REASONS.
  97.  
  98.                  ┘OURS,
  99.                  ╦ENNETH ┼. ╦AHL
  100.                  73027,454
  101.