hsf2RC.txt 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. hsf2RC ROM_CALL include builder for the TI-89 and TI-92 Plus
  2. ===============================================================
  3. Loïc YHUEL (hwti) hwti@hotmail.com
  4. Copyright (C) 2002 Loïc YHUEL
  5. This archive contains :
  6. - the program ('hsf2RC.exe')
  7. - the source code ('hsf2RC.cpp')
  8. - configuration files : 'os.h.end', 'doorsos.h.end', 'NotDefinedRom_calls' and 'db92_alias'
  9. - license.txt : the GPL license
  10. - this document
  11. How to use it
  12. =============
  13. It must be launched in doc\System\Include subdirectory of TIGCC sources.
  14. If you run it without parameters it builds only 'doorsos.h' and 'os.h'.
  15. If you execute 'hsf2RC /db92' it will build DB92 ROM_CALLS include files ('Romcalls.bin' and 'romcalls.h') too.
  16. OPTIONS
  17. =======
  18. hsf2RC appends 'os.h.end' and 'doorsos.h.end' at the end of 'os.h' and 'doorsos.h'. They contains the macros and consts.
  19. You can modify them if you want.
  20. 'NotDefinedRom_calls' contains ROM_CALLS which are not in TIGCC documentation because they are AMS1 specific or they are implemented as macros.
  21. DB92 SPECIFIC
  22. =============
  23. When you add the '/db92' switch, hsftoRC builds a list of the ROM_CALLS names for DB92.
  24. In this format, each ROM_CALL has an unique name, so :
  25. - if it sees a new name for an already named ROM_CALL, it asks you if you want to keep the first name or use the second
  26. In order to not ask the user each time, it saves the result in 'db92_alias' file wich has a simple format
  27. "[ROM_CALL number in decimal] [y/n]" ('n' means that it keeps the first name, 'y' that it uses the second)
  28. - if a ROM_CALL is unnamed, it prints a warning and in DB92 it will show a blank name.
  29. Portability
  30. -----------
  31. This source code can be compiled without modifications under windows with MS VC++ 7.0 and MinGW32.
  32. I don't know if it can be compiled correctly under Linux. You should be able to use any C++ compiler.