[gmpi] Re: low level API
- From: Sebastien Metrot <meeloo@xxxxxxxxxx>
- To: gmpi@xxxxxxxxxxxxx
- Date: Fri, 04 Feb 2005 22:39:06 +0100
David Olofson wrote:
There are 2 exceptions: assembly code (comment every line!)
Uhm... Why? ;-) *remembers the days of 68k hacking on the Amiga*
Actually, when you know a programming language like a second language,
the ammount of commenting needed depends mostly on the problem; not
the language.
That said, most people are not insane enough to learn any asm dialect
well enough not to need serious commenting. ;-)
Well, one of these days you may have to start some nice Altivec and SSE
optimisation for your code... and then you might *really* need multiple
lines of comments per line of code just to keep track of what register
contains what set of values and explain those nice tricks you find in
the course of action but that are absolutely not straighforward to
understant 10 minutes from that ;-).
On a more serious note, I have put together a set of coding convention
(adapted from an existing document) that proved to work reasonably well
over the years, a very interesting read anyway:
http://home.gna.org/ngl/doc_coding.html . The advantage of this document
is not so much in the particular choices that we make but as a nice
framework to help design coding conventions and have them accepted by a
team...
Sebastien
----------------------------------------------------------------------
Generalized Music Plugin Interface (GMPI) public discussion list
Participation in this list is contingent upon your abiding by the
following rules: Please stay on topic. You are responsible for your own
words. Please respect your fellow subscribers. Please do not
redistribute anyone else's words without their permission.
Archive: //www.freelists.org/archives/gmpi
Email gmpi-request@xxxxxxxxxxxxx w/ subject "unsubscribe" to unsubscribe
Other related posts:
