I'm largely in agreement with John here. Documenting what variables are intended to do is something I don't do nearly enough. On the other hand, I sure haven't been impressed by automatic documentation systems in the past. :)