Would any byond developers find a utility that takes your comments and turns them into a formated HTML document useful?
You would comment a special way. Which would then display your comments in a table type format.
Example
// This function gives damage to the thing you attack.
// @param mob victim Thing being attacked.
// @param num dmg The damage being caused.
// @author Green Lime
// @version 1
mob/proc/takedamage(victim,dmg)
victim.hp -= dmg
[..other code here..]
As you can see, comments would go before the thing you want to comment on. Except for single line comments. I haven't figured out how Im going to do that yet. But it would be like.
var/a = 2 // change a to 2.
How would you like it to handle the comments?
ID:8480
 Feb 7 2006, 11:21 am
|
|
|
Feb 7 2006, 11:37 am
|
|
National Guardsmen
 |
hmm sure id find a use for it
|
Like javadoc. I think this is very good for libraries, not much use for other things unless you're working in a team environment. Good luck parsing. :)
| |