README 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. GCC4TI Cross Compiler for the TI-89 and TI-92 Plus v0.96 Beta 10
  2. ================================================================
  3. Xavier Vassor Xavier@tigcc.ticalc.org (original linker and tigcc)
  4. Zeljko Juric Zeljko@tigcc.ticalc.org (library and documentation)
  5. Kevin Kofler Kevin@tigcc.ticalc.org (linker, fixes for A68k, GCC,
  6. GAS, library, ...)
  7. Sebastian Reichelt Sebastian@tigcc.ticalc.org (linker, IDE, GCC fixes)
  8. Niklas Brunlid Niklas@tigcc.ticalc.org (bugfixes and additions)
  9. Jean Canazzi Jean@tigcc.ticalc.org (first modification of GCC)
  10. Philipp Winkler p.winkler@atn.nu (library help file conversion)
  11. Lionel Debroux lionel_debroux@yahoo.fr
  12. Patrick Pelissier patrick.pelissier@gmail.com
  13. Manoel Trapier godzil@godzil.net
  14. Email us at: tigccpp@box.godzil.net
  15. +-------------------------------+
  16. | README CONTENTS |
  17. |===============================|
  18. | 1. Disclaimer |
  19. | 2. About GCC4TI |
  20. | 3. Installation |
  21. | 4. The Library |
  22. | 5. The Command Line Compiler |
  23. | 6. The IDE |
  24. | 7. Examples |
  25. | 8. Bug Reports |
  26. | 9. History |
  27. +-------------------------------+
  28. 1. Disclaimer
  29. -------------
  30. Original files Copyright (C) 1999-2005 Xavier Vassor, Niklas Brunlid,
  31. and Jean Canazzi
  32. ld-tigcc Copyright (C) 2002-2009 Sebastian Reichelt and Kevin Kofler
  33. Library & Documentation Copyright (C) 2000-2009 Zeljko Juric and contributors
  34. IDE Copyright (C) 2000-2009 Sebastian Reichelt and contributors
  35. TIGCC Tools Suite Copyright (C) 2000-2009 Thomas Nussbaumer
  36. (http://tict.ticalc.org/)
  37. Included programs with different licenses:
  38. A68k Copyright (C) 1987-2009 Charlie Gibbs, David Ellsworth, Kevin Kofler,
  39. Julien Muchembled, and Paul Froissart
  40. Setup executable created using NSIS (http://nsis.sourceforge.net) and
  41. compressed using LZMA (http://www.7-zip.org/sdk.html) for the data and UPX
  42. (http://upx.sourceforge.net/) for the stub.
  43. This program is free software; you can redistribute it and/or modify it under
  44. the terms of the GNU General Public License as published by the Free Software
  45. Foundation; either version 2 of the License, or (at your option) any later
  46. version.
  47. This program is distributed in the hope that it will be useful, but WITHOUT
  48. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  49. FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  50. details.
  51. You should have received a copy of the GNU General Public License along with
  52. this program; if not, write to the Free Software Foundation, Inc.,
  53. 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  54. Some components (TIGCCLIB, ttpack, pstarter) have additional permissions
  55. beyond the GPL.
  56. A different license applies to A68k.
  57. 2. About GCC4TI
  58. --------------
  59. GCC4TI is a fork ( http://en.wikipedia.org/wiki/Fork_(software_development) )
  60. of TIGCC, with different goals and different planning.
  61. Please check out http://trac.godzil.net/gcc4ti/ , the official GCC4TI site,
  62. for more information on the todo/wish list.
  63. 3. Installation
  64. ---------------
  65. In the ZIP file containing GCC4TI, you will find a program called
  66. 'setup-gcc4ti.exe'. Run this program and follow the instructions of the setup
  67. program. It will add a few new items to your start menu, so you should not
  68. use a program group that already exists.
  69. If you want to uninstall GCC4TI, you can do this at any time from either the
  70. start menu or the control panel. Please be aware that this will remove the
  71. whole folder in which the program was installed, not only the files which
  72. were installed by the setup program.
  73. If you experience any problems installing GCC4TI, or running it after it has
  74. been installed, please use the GCC4TI mailing list, tigccpp@box.godzil.net .
  75. 4. The Library
  76. --------------
  77. The library included in this release of GCC4TI is a collection of over 750
  78. functions. With this library, it is possible to create kernel-free (so-called
  79. "nostub") programs as well as programs that make use of kernel features. A
  80. very detailed documentation in HTML Help format is included, in which more
  81. than 600 TIOS entries are described in detail. This documentation may be very
  82. valuable for assembly programmers too. To read the documentation, open
  83. 'tigcc.chm', located in the 'Doc' folder, or click on the appropriate item in
  84. the start menu.
  85. 5. The Command Line Compiler
  86. ----------------------------
  87. The following paragraphs apply only to the command line compiler. If you want
  88. to use the IDE instead, you do not need to worry about these topics.
  89. The command line compiler (tigcc.exe) works almost the same way that the
  90. standard gcc.exe does. Aside from accepting .asm files as parameters and
  91. calling the a68k assembler to compile them, it also supports a few
  92. non-standard options:
  93. -pack <varname>
  94. Compress the file generated during compilation. 'varname' is the name of
  95. the on-calc packed variable. Although 'varname' cannot have an extension,
  96. the variable on the calculator will always have the extension 'ppg'.
  97. 'varname' cannot be the same as the on-calc name of the program itself.
  98. When you use this switch, two variables will be created; one with the
  99. extension '.89y' or '.9xy', and one '.89z' or '.9xz' variable.
  100. This option comes from Thomas Nussbaumer's (thomas.nussbaumer@gmx.net)
  101. excellent TIGCC Tools Suite, where this feature is called "ExePack
  102. Technology." You can read about it on the official TI-Chess Team site
  103. (tict.ticalc.org).
  104. -q
  105. Keep as quiet as possible while assembling and linking. This option is not
  106. needed by the compiler because it is always quiet, but the linker and
  107. especially the assembler output some information.
  108. -v0
  109. This switch is an addition to the '-v' switch. It tells tigcc.exe to output
  110. only the commands that are run directly. This was the default in some
  111. previous releases.
  112. -g
  113. The '-g' switch in GCC turns on debugging information in the preferred
  114. format for the target. In GCC4TI, this is DWARF 2, which can be used with a
  115. GDB-enabled TiEmu.
  116. -standalone
  117. Do not link against tigcc.a. All of GCC's internal functions are
  118. implemented in this library, as well as all non-TIOS functions. Using one
  119. of these will result in an error from the linker.
  120. -ar
  121. Create an archive (a static library) instead of a program. The resulting
  122. file will have a '.a' ending.
  123. -bsr
  124. This option is ignored for compatibility.
  125. For more info about standard options that are recognized by the compiler,
  126. have a look at the GCC4TI Documentation, or visit
  127. http://gcc.gnu.org/onlinedocs/gcc_3.html.
  128. In addition, you can use '-WA,...' instead of '-Wa,...' to pass options to
  129. the A68k assembler.
  130. We suggest that you use the '-O2' or '-Os' switch in all your compilations;
  131. it increases speed and decreases the program size at the cost of compilation
  132. time.
  133. There is an important difference to the standard gcc.exe: tigcc.exe always
  134. overwrites assembly or object files. For example, if a file 'test.c' is
  135. compiled, the files 'test.s' and 'test.o' will be created and overwritten if
  136. necessary, but they will automatically be deleted again if neither '-c' or
  137. '-S' nor '-g' are specified.
  138. 6. The IDE
  139. ----------
  140. Documentation of the IDE is included in the manual and will be installed by
  141. the setup program. You can access it from the start menu or from the IDE
  142. itself.
  143. 7. Examples
  144. -----------
  145. There are some examples made by Zeljko Juric in the folder "Examples". You
  146. can compile and modify them to learn how to use GCC4TI. Most of them can also
  147. be found at some place in the documentation, with explanations and in some
  148. sort of context.
  149. 8. Bug Reports
  150. --------------
  151. There may still be some bugs in the linker, in tigcc.exe, and in the IDE. If
  152. you encounter a bug, please use the GCC4TI mailing list, tigccpp@box.godzil.net
  153. 9. History
  154. -----------
  155. See http://tigcc.ticalc.org/doc/info.html#history for the TIGCC history.