17 Jan
2008
17 Jan
'08
6:04 p.m.
Am 17.01.2008 um 08:27 schrieb Robert Strandh:
I am starting to think that docstrings are evil (because they are mostly noise to the person reading the code). I would like to discuss the possibility of using (SETF DOCUMENTATION) instead.
Doc strings are for users of those functions/macros. It helps me to understand what the function does, how I call it, what results I get back and so on. I really like that feature.
If for some code the documentation string gets in he way, using (SETF DOCUMENTATION) is absolutely fine.