I use comments for API documentation in header file libraries, for explaining messy code, and for documenting "state" -- both a reminder of what the program sta

I use comments for API documentation in header file libraries, for explaining messy code, and for documenting "state" -- both a reminder of what the program state should be on executing a given line and my mental state when writing it. Example: https://github.com/torstenvl/cpgtou/blob/master/cpgtou.h https://github.com/torstenvl/cpgtou/blob/master/cpgtou.h