Source code reading list

[David Delony]

Since the best way to learn how to program well is to read other
people's programs, which open source projects written in C stand out
as examples of well-written code?
--
There's no place like ~!
David Delony
E-mail: ic*****@gmail.com
Blog: http://ddelony.livejournal.com

[Malcolm McLean]

"David Delony" <ic*****@gmail.comwrote in message
news:sl*******************@davids-powerbook.local...

Since the best way to learn how to program well is to read other
people's programs, which open source projects written in C stand out
as examples of well-written code?

It really isn't.
You should read other people's code of course, but there are all sorts of
reasons why reading working "real" programs won't tell you how to do a good
job yourself.
Think of a program as a building. Not a house. A functional building like a
factory that has to be built to budget and always has some special
requirements. Normally the procedure will be to buy in a lot of pre-formed
components - walls, stairs, roofs and so on. Then they are bolted together.
But because our factory is a real building housing a unique process, some
will have to be modified. You might need air flow towards the "dirty end",
so you've got to seal all the windows, take out all the firedoors, and put
in fans, for instance. Then because you've taken out the firedoors you might
need to put in a sprinkler system to comply with regulations. So we end up
with a lot of standard components, modified components, and some custom
built components, all welded together and then put under a facade to make up
a finshed building.

To really understand how to make a building like that youself, it is best to
go to the standard components. The finished building will often confuse.
Code, such as mass of defines to make a file compile under both Windows and
Unix, can be well-written in the sense that it achieves the goal, whilst
being very hard for a human to understand and not a good basis for other
code, often not even a good basis for another cross-platform program. Often
there will be bits which have been micro-optimised, or hacked to get round
some late-breaking design problem.

"The only thing that is worse than pseudo-code [in academic texts] is real
code". I don't actually agree with this, but it has a point. Real code can
be hard to read, unless it is deliberately written for the purposes of
instruction.

--
Free games and programming goodies.
http://www.personal.leeds.ac.uk/~bgy1mm

[Richard Heathfield]

Malcolm McLean said:

<snip>

"The only thing that is worse than pseudo-code [in academic texts] is
real code".

Bunk.

I don't actually agree with this,

Neither do I.

but it has a point.

No, it doesn't.

Real code can be hard to read,

Then rewrite it so that it is easy to read.

unless it is deliberately written for the purposes of instruction.

All code should be deliberately written for the purposes of instruction.
If your code isn't readable, it isn't finished yet.

--
Richard Heathfield <http://www.cpax.org.uk>
Email: -www. +rjh@
Google users: <http://www.cpax.org.uk/prg/writings/googly.php>
"Usenet is a strange place" - dmr 29 July 1999

[Ben Pfaff]

Richard Heathfield <rj*@see.sig.invalidwrites:

All code should be deliberately written for the purposes of instruction.
If your code isn't readable, it isn't finished yet.

I just found a new signature.
--
"All code should be deliberately written for the purposes of instruction.
If your code isn't readable, it isn't finished yet."
--Richard Heathfield

[Default User]

Malcolm McLean wrote:

>
"David Delony" <ic*****@gmail.comwrote in message
news:sl*******************@davids-powerbook.local...

Since the best way to learn how to program well is to read other
people's programs, which open source projects written in C stand out
as examples of well-written code?

It really isn't.
You should read other people's code of course, but there are all
sorts of reasons why reading working "real" programs won't tell you
how to do a good job yourself.

I agree with this. I believe that reading other's code teaches you how
to read code. This is an important, allied, skill to programming. It
doesn't teach one to programming. You learn that, not surprisingly, by
programming.

I personally think it's a huge mistake for newbies to do what people
often recommend, go and read code off in sourceforge or whatever. I
think they should (after working though a good textbook and doing many
exercises) find a small project that interests them and code it up.


Brian

[Malcolm McLean]

"pete" <pf*****@mindspring.comwrote in message
news:46**********@mindspring.com...

Richard Heathfield wrote:

>>
Malcolm McLean said:

<snip>

"The only thing that is worse than pseudo-code
[in academic texts] is real code".

Is K&R, an academic text?

No. It's a primer for a computer language. Academic texts describe new
algorithms or mathematical results.

>
A text description accompanied by C code is best,
but given a choice, if I want to learn an algorithm,
I prefer to see it coded in C,
rather than described in English.

I agree with that. However journal editors normally don't. They want to see
funny E notation rather than loops.
What's annoying is that, without fail, there is always one term in the
expression which isn't properly defined in the text, or is hard to obtain,
like "the second derivative of ..." where ... is some stupidly complex thing
with imaginary numbers and the like all over the place, that is quite beyond
my calculus skills.

--
Free games and programming goodies.
http://www.personal.leeds.ac.uk/~bgy1mm

[Old Wolf]

On Jul 22, 4:08 am, David Delony <[e-mail]:

Since the best way to learn how to program well is to read other
people's programs, which open source projects written in C stand out
as examples of well-written code?

Last time I looked, this project had exceptionally
well laid out source code, compared to other
open-source projects:
ftp://ftp.thangorodrim.net/pub/angba...d-3.0.6.tar.gz

[Ben Pfaff]

David Delony <ic*****@gmail.comwrites:

Since the best way to learn how to program well is to read other
people's programs, which open source projects written in C stand out
as examples of well-written code?

If I may be permitted to toot my own horn, I would like to point
to Pintos, an educational operating system, as an example of
well-written, easy to understand code, at
http://www.stanford.edu/class/cs140/.../pintos.tar.gz
or
http://www.stanford.edu/class/cs140/pintos/pintos/
It is not strictly conforming C by any stretch of the
imagination.
--
Ben Pfaff
http://benpfaff.org