Date: Tue, 6 Jun 1995 11:21:23 -0700 (PDT)
From: "Kent D. Lottis" <kentl AT bdc DOT cirrus DOT com>
To: Kent Lottis <kentl AT bdc DOT cirrus DOT com>
Cc: djgpp AT sun DOT soe DOT clarkson DOT edu
Subject: Re: VOTE: CODE STANDARDS

On Tue, 6 Jun 1995, Eli Zaretskii wrote:

> > Only DJ's ideas of coding style differ from mine, like your hair color
> > is different. Maybe you might like my hair color, and get your
> > hair dyed. No big deal. Just maybe we can both be happy.
> 
> We don't usually discuss each other's hair color, not on this newsgroup,
> anyway.
> 

Or when we do, we do it with a level of politeness not seen often
in Cyberspace.


> >	Well still doesnt change the facts - the code is basically
> > undocumented, and has been that way since day one. Maybe its time
> > we started documenting things (emx is a good example). Sure if we
> > turn a blind eye to the state of the code, we'll all be fatter
> > and happier,
> 
> No, he will be much happier to see people with critical eye contribute those
> missing docs.
> 

Hear, hear! Use it? Don't like it? Fix it.


> >	It would be wise to put it to a vote; "does djgpp need some
> > coding standards?". Any self respecting programmer would have to
> > agree. Even demo coders have standards (and commented code i must
> > add) ....
> 
> Such pointless holy wars again belong to other forums.
> 

In my opinion, holy wars belong in the toilet, but then that's one
of the reason I (we all?) like this list (scratch that, newsgroup) so
much.

Junaid, your point is well taken. The code could use some documentation.
However, this is the GNU project, not a commercial venture. The burden
of contributing effort to the project is, in principle, on the one
who has the idea   :-)

Maybe what we could do is comment the code for DJ. This would have
a gazillion advantages, some of which I will enumerate.

1) The code would be commented.
2) The people doing the comments would be doubly illuminated.
3) This effort would have the effect of a design review. This
   would be especially appropriate on V2.
4) The effect would be to spread knowledge and understanding of
   djgpp into a much wider community.


Of course, there's the small matter of coordinating efforts, but me?
I'm just talking...


= = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
=  Kent D. Lottis                 kentl AT bdc DOT cirrus DOT com    =
=  Cirrus Logic, Inc., Bellevue Design Center             =
=                                                         =
=  Located in Washington state, home of exploding         =
=  mountains, sinking bridges, the Mariners, uncountable  =
=  tons of spent nuclear fuel, and Bill Gates.            =
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = =