ReadMe.txt 1.5 KB

1234567891011121314151617181920212223242526272829303132
  1. Generates Torque2D and TorqueScript reference documentation.
  2. The latest Doxygen for Windows/OSX can be found here: http://www.stack.nl/~dimitri/doxygen/download.html
  3. Use the manual (A) or automated (B) method. Note that the automated method needs some updating and testing.
  4. ***************
  5. A) Manual
  6. This should work for PC or Mac (or anywhere doxygen and git/svn run)
  7. 1. download Doxygen as noted in the link above. Move the exe/app into this folder.
  8. 2. start in this directory
  9. 3. run doxygen config/torque2DReference.cfg (will produce ./output/torque2DDocs and torque2D.tag)
  10. 4. run doxygen config/torqueScriptReference.cfg (will produce ./output/torqueScriptDocs)
  11. 5. "push" output/torque2DDocs and output/torqueScriptDocs to gh-pages
  12. ***************
  13. B) Automatic
  14. !! the following is an automated method that needs to be updated !!
  15. * Windows ***
  16. Execute the "generateDocs.bat"
  17. This should produce an output file in the sub-folder "input" followed by executing the Win32 Doxygen to generate the documentation in the output sub-folder. The default configuration only outputs HTML however if you change the "scriptReference.Windows.cfg" and change the line "GENERATE_HTMLHELP" to "= YES" you will also get a compiled CHM file.
  18. * OS X ***
  19. Execute the "generateDocs.command"
  20. This should produce an output file in the sub-folder "input" followed by executing the Win32 Doxygen to generate the documentation in the output sub-folder. The default configuration only outputs HTML.