home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / geos / programming / geoProgrammer.errata.cvt (.txt) < prev    next >
Encoding:
GEOS ConVerT  |  1998-01-13  |  3.1 KB  |  33 lines
  1. prog errata
  2. prg FORMATTED geos FILE v1.0
  3. wRITE iMAGE v2.0
  4. GEOwRITE    v2.0
  5. t-gRAB dATA v2
  6. pLEASE sELECT oPTION:
  7. NEW DOCUMENT
  8. EXISTING DOCUMENT
  9. TO DESKtOP
  10. iNSERT NEW DISK INTO DISK 
  11. subj: eRRATA ii                        from: geos tech   01/25/88   s#: 79063   
  12. 1) tHERE IS A PROBLEM WITH THE LINKER AND vlir FILES. wE ARE WORKING ON A PATCH FOR THIS. bE CAREFUL DELETING vlir FILES CREATED WITH gEOlINKER IN THE MEANTIME.
  13. 2) lOCAL LABELS: IF YOU HAVE 255 OR MORE BYTES OF CODE AND/OR BITMAPS BETWEEN ANY TWO GLOBAL LABELS, THEN YOU CANNOT USE LOCAL LABELS FOR THE REST OF THAT ASSEMBLY. yES, THIS IS A BUG. sOLUTIONS: kEEP YOUR ROUTINES SHORT, SO YOU HAVE GLOBAL LABELS FREQUENTLY, AND IF YOU HAVE ANY LARGE BITMAPS, PLACE THEM AT THE END OF YOUR ASSEMBLY FILE, OR ASSEMBLE THEM SEPARATELY.
  14. 3) tHE .HEADER DIRECTIVE ACTUALLY CHECKS THE FOLLOWING 12 LINES, NOT 11 AS STATED IN THE MANUAL. tHE 12TH LINE IS A 20-CHARACTER NULL-TERMINATED AUTHOR NAME. sEE THE EXAMPLE ON PAGE 5-53.
  15. 4) mAKE SURE EACH FILE YOU ASSEMBLE HAS A .INCLUDE GEOSsYM, SO THE LINKER DOES NOT HAVE TO WORK AS HARD.
  16. 5) yOU WILL GET A WARNING IF YOU WRITE:
  17.  LDA #true
  18. BECAUSE true=-1, WHICH IS $FFFF, A WORD VALUE. uSE THIS INSTEAD:
  19.  LDA #[true
  20. 6) cHANGE THE .PSECT $5000 IN THE sAMvLIR.LNK FILE TO .PSECT $3000. tHIS
  21. WILL ALLOW THE SAMPLE VLIR TO RUN WITH THE MINI-DEBUGGER.
  22. 7) cHANGE THE "vertical" ITEMS UNDER mENUtABLE IN sAMsEQ AND sAMvLIRrES TO
  23. "sub-menu", WHERE "-" IS AN UNDERLINE CHARACTER.
  24. 8) gEOaSSEMBLER WILL NOT ATTEMPT TO SUBSTITUTE ABSOLUTE MODE ADDRESSING WHEN A ZERO PAGE OPERAND IS USED WITH AN INSTRUCTION THAT DOES NOT SUPPORT ZERO-PAGE ADDRESSING. eXAMPLE: JMP $30
  25. WILL PRODUCE AN ERROR. wE WILL FIX THIS.
  26. 9) iF THE ASSEMBLER OR LINKER TERMINATE AFTER A DISK ERROR, DO NOT ATTEMPT TO OPEN OR USE THE NEWLY CREATED FILES (.REL, .ERR, .DBG, .SYM). tHEY HAVE NOT BEEN PROPERLY CLOSED. vALIDATE THE DISK AND DELETE THOSE FILES. wE HAVE FIXED THIS, IT WILL BE IN THE UPGRADE.
  27. 10) dO NOT MAKE ANY FORWARD REFERENCES TO ZERO PAGE VARIABLES OR CONSTANTS. mAKE SURE YOU DEFINE ZERO PAGE VARIABLES AND CONSTANTS BEFORE THE CODE WHICH USES THEM. tHERE IS A BUG WHICH WILL CAUSE ALL OF YOUR LABELS TO BE OFFSET BY AN AMOUNT IF YOU DO THIS.
  28. aN EASY WAY FOR THIS TO HAPPEN IS WHEN YOU WRITE:
  29.  LDA constant
  30. WHEN YOU REALLY MEAN TO DO:
  31.  LDA #constant
  32. iF constant IS FORWARD REFERENCED AND IT IS LESS THAN $100, THE ASSEMBLER WILL SEE THIS AS A FORWARD REFERENCE TO A ZERO-PAGE VARIABLE AND GENERATE THE WRONG OBJECT CODE (LABEL REFERENCES MAY BE OFF BY ONE OR MORE BYTES). 
  33.