Monday, January 03, 2005

For Shayne

What follows is for Shayne. Anyone else is free to read it but I don't think many will care.

So I started working on my project today, and I was thinking about how to comment my C++ code. I started look around and found something I thought was nice: the Doxygen documentation system. I checked it out some, and I think with a little time one could use it well. My question is do I really need such a thing, and is there better ones out there? Later

2 comments:

Redsaz said...

It looks interesting. I'll check it out a little more, but from what I've seen, it is more regulated to large scale projects. One of their headline examples is Mozilla, and that thing is crazy insane. And loco.

That being the case, it's no substitute for self-documenting code, but rather will benefit you (the programmer), other programmers you are working with, and other stuff, IF you use good coding techniques.

Redsaz said...

for Beibs:

I have no idea what you just said. Even If I mentally put in the periods and commas, that whole first part makes no sense. "what exactly you wanting to learn(sic)" What is that? If I put in an 'are', maybe that would help: "What exactly are you wanting to learn?" Ok, but Ada is a programming language, it's not specifically discussing code commenting or documentation, or at all, in the article link you gave.

Putting that aside, however, I did take a look at gnat and the language, Ada95. Ada also seems to have been able to withstand the test of time. Did you know that Ada has been around since the 1970's? I remembered hearing about Ada somewhere, but I finally found it, in my Programming Languages book by Tucker and Noonan. Ada came about because the US Department of Defense wanted its own language to program software, instead of hundreds of different languages. Needless to say, it was a major dissapointment in its real-time implementation. Of course, they were able to refine it, and those problems virtually don't exist.

Ada in its form today is capable of near-C-performance. I say that with no experience with the language, and with only the propaganda I read supporting Ada. So I know nothing.

Perhaps in the future, I might want to learn yet another language. But for now, I'd better refine my skills in the languages I already know.
Wikipedia Article on Ada.