Author Topic: SGDK2 Programming Reference  (Read 3658 times)

bluemonkmn

  • SGDK Author
  • Administrator
  • Fanatic
  • *****
  • Posts: 2761
    • ICQ Messenger - 2678251
    • MSN Messenger - BlueMonkMN@gmail.com
    • View Profile
    • http://sgdk2.sf.net/
    • Email
SGDK2 Programming Reference
« on: 2007-04-26, 06:07:19 AM »
Wow, XML documentation is so cool.  It's not done yet, but you can get a peek at how nice the rule function documentation and coding documentation is going to be from here:
http://enigmadream.com/files/SGDK2DevRef.zip

I've been working on the documentation for the SpriteBase class, so that's where most of the nicest documentation is so far... but even that class isn't done yet.

Jam0864

  • Contributor
  • Fanatic
  • **
  • Posts: 744
    • MSN Messenger - marmalade0864@hotmail.com
    • View Profile
    • Jam0864's Content Dump
    • Email
Re: SGDK2 Programming Reference
« Reply #1 on: 2007-04-27, 01:27:17 AM »
It's really well organized. Easy to find what you want.  :)

bluemonkmn

  • SGDK Author
  • Administrator
  • Fanatic
  • *****
  • Posts: 2761
    • ICQ Messenger - 2678251
    • MSN Messenger - BlueMonkMN@gmail.com
    • View Profile
    • http://sgdk2.sf.net/
    • Email
Re: SGDK2 Programming Reference
« Reply #2 on: 2007-04-27, 05:11:01 AM »
Yah, these documentation tools are really nice to use:
  • Visual Studio automatically creates comment blocks above each function with tags to describe each parameter and add a summary and remarks about the function itself.
  • When Visual Studio compiles a project, is creates an XML file containing this documentation.
  • NDoc (http://ndoc.sf.net/) uses this XML file and the compiled code together to generate documentation in a format identical to Microsoft's own MSDN documentation.

And practically all I have to do is fill in the blanks.  Programming and documentation has never been this fun :).

bluemonkmn

  • SGDK Author
  • Administrator
  • Fanatic
  • *****
  • Posts: 2761
    • ICQ Messenger - 2678251
    • MSN Messenger - BlueMonkMN@gmail.com
    • View Profile
    • http://sgdk2.sf.net/
    • Email
Re: SGDK2 Programming Reference
« Reply #3 on: 2007-05-06, 09:32:24 PM »
Whew... I think I'm done documenting the code... the file link above has been updated with the completed programming documentation (has not been proofread yet).  Next I just have to link the main help into this help.