Go Back   Angband Forums > Angband > Development

Thread Tools Display Modes
Prev Previous Post   Next Post Next
Old May 30, 2011, 06:14   #1
Derakon's Avatar
Join Date: Dec 2009
Posts: 9,023
Derakon is on a distinguished road
A plea for comments

I decided to take a stab at allowing ego items to have negative pvals, which requires understanding how the file parser works. This is...not helped by the fact that there are basically no comments for any of the code.

I know that the 2.8.3 days had very verbosely commented code; practically every line had a comment. That's not really necessary IMO, but on the flipside, every function more complicated than a getter or setter needs to have a comment. Please, when you modify a function, if you know what it does, comment it! If that function has a complex block within it, comment that too. You'll make everyones' lives easier. Commenting's not really fun, I know, but it'd be a big help in convincing people to contribute.
Derakon is offline   Reply With Quote

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
r1886 bug(s) and comments Psi Development 4 January 7, 2010 14:39
A Few Comments about V Malatar Vanilla 20 January 5, 2010 22:40
3.1.0 Comments/Observations evariste Vanilla 6 January 17, 2009 02:25
3.10 Comments awldune Vanilla 3 January 11, 2009 14:29
squelch comments/complaints ChodTheWacko Vanilla 2 July 28, 2007 17:50

All times are GMT +1. The time now is 14:14.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2020, vBulletin Solutions Inc.