unknown.hss 2.0 KB

123456789101112131415161718192021222324252627282930313233
  1. [Main]
  2. Title=Documenting Unknown Functions
  3. [Top]
  4. The TIGCC Library still contains a lot of unknown functions.
  5. They are defined in <A HREF="$$LINK(unknown.h/)">unknown.h</A>.
  6. For some of them, prototypes are already available; some are even partially
  7. documented. Others are completely unknown.
  8. <BR><BR>
  9. If you have information about one of these functions (also from TI's
  10. <A HREF="http://education.ti.com/downloads/pdf/us/sdk8992pguide.pdf">documentation</A>,
  11. but you may not simply copy the information there for copyright reasons),
  12. please take the time to document it. The way to do this is very simple, and
  13. you will be doing everyone using this library a big favor.
  14. <BR><BR>
  15. At first, you need the GCC4TI source code, available from the <A HREF="http://trac.godzil.net/gcc4ti/">GCC4TI Website</A>.
  16. Set up the documentation system according to the <CODE>Readme</CODE> and <CODE>HelpSystem.ini</CODE> files, and check
  17. whether you can update at least the header files by running <CODE>UpdateInclude.exe</CODE>.
  18. <BR><BR>
  19. To document a file, or to change the file's prototype, you simply need to edit
  20. the appropriate <CODE>.hsf</CODE> file in the <CODE>unknown.h</CODE> subfolder of the help system.
  21. If you have enough documentation to move it to another header file, simply move the <CODE>.hsf</CODE> file
  22. to the appropriate folder, and update all links from and to the file. (For links from other files to this one,
  23. you will probably want to use a string replacement program to make the conversion automatically.)
  24. Then run <CODE>UpdateInclude.exe</CODE> on both the new folder and on
  25. <CODE>unknown.h</CODE> (if it used to be in <CODE>unknown.h</CODE>).
  26. Now you will be able to view your documentation in a web browser, and test the
  27. function with its new prototype.
  28. <BR><BR>
  29. When you are finished, please simply send the resulting <CODE>.hsf</CODE> file to
  30. <A HREF="mailto:tigccpp@box.godzil.net">the GCC4TI mailing list</A>.
  31. We prefer compressed files because mail systems sometimes mess up attached
  32. text files, but it doesn't really matter a lot.