[Date Prev][Date Next][Thread Prev][Thread Next]
- Subject: Re: Lua code learning path using annotated source by Steve Donovan
- From: Dirk Laurie <dirk.laurie@...>
- Date: Tue, 20 Dec 2011 21:01:21 +0200
I've been writing code for a week, which leaves little time for
amusements like reading lua-l. So, I'm not really replying: as the
true lua-l member I hope to be, I'm just spouting off the top of my
But, so as not to be guilty of hijacking a thread, here is a quote:
>> Lua code (to the extent I have delved into it by now)
>> seems quite self-documenting.
I wish to remark that there are more ways of documenting code than comments.
Example from C:
if (level==0||head!=choice[level-1]->head) …
Better comment this, it's really obscure.
#define COLUMN_DONE level==0||head!=choice[level-1]->head
if (COLUMN_DONE) …
No comment required.
Examples from Lua are harder to find. I'm not proficient enough to
write obscure Lua code :-)