Consistant style?

Compiling, libraries, modules, coding guidelines and porting

Moderators: jesterKing, stiv

Jamesk
Posts: 239
Joined: Mon Oct 14, 2002 8:15 am
Location: Sweden

Postby Jamesk » Fri Oct 25, 2002 9:23 am

Interesting piece of pie, Cessen! That is more or less the same technique I've been using in my Java projects lately. It's a very good thing and it really helps - not only with understanding the code I wrote myself a couple of months ago, but also as a programming aid while writing the actual code.

Don't know if any of you guys ever coded anything in Java, but one of the benefits is that if you write 'documentation comments' in all the right places in a class, you can use 'javadoc' later on to generate automatic documentation for all classes in a project. And the principles for this are exactly like PIE. Since the output of javadoc will be a series of html files intended to be read 'on the side' so to speak, you are automatically forced to write comments in a conceptual fashion.

PK
Posts: 3
Joined: Tue Oct 22, 2002 2:39 am

Postby PK » Sat Oct 26, 2002 9:45 am

Doxygen works similiar to javadoc for C++/C.
http://www.stack.nl/~dimitri/doxygen/

thorax
Posts: 320
Joined: Sun Oct 27, 2002 6:45 am
Contact:

Postby thorax » Sun Oct 27, 2002 7:06 am

:shock:
This coding convention guidelines was published last year about this
time..

thorax
Posts: 320
Joined: Sun Oct 27, 2002 6:45 am
Contact:

Javadoc is cool

Postby thorax » Sun Oct 27, 2002 7:16 am

I use javadoc all the time, it produces HTML pages
that allow one to easily track down classes and methods
and see relationships between classes (iheritance, fields, usage of, related classes, etc.).. It reads the source code to find out a lot of it, and its really the only way to understand javacode, without it one would be totally lost..
Its also good to have an IDE to develop the source in, currently I'm using Netbeans with the code-completion feature, if you are unsure about a method you just type "classname." and up popsup the options and can find the class being used and the associated method, even jump to where the
method is defined in the source. Really makes coding Java easier.

Anyhow, this has nothing to do with Blender.. But if there was a
coding environment like this for working with blender, I would be in heaven!! :D

Jamesk
Posts: 239
Joined: Mon Oct 14, 2002 8:15 am
Location: Sweden

Postby Jamesk » Mon Oct 28, 2002 9:58 am

No, it doesn't have anything to do with Blender. I'd say I'm merely patting Cessens back by saying that a consistent commenting style is of utmost importance. :)


Return to “Coding Blender”

Who is online

Users browsing this forum: Google [Bot] and 1 guest