Somewhere in my code at home, there is a function of (roughly) 50 lines of code (excluding blank lines) that follows a (roughly) 45-line comment, explaining what it does (not how, that's what the code is there for). It's an implementation of getpwent(3) for a /etc/passwd replacement using a directory structure (linear searches get So Slow when you hit 30k+ users, you know). It's all horrendously stateful and stuff, doing Plain Nasty Things in order to actually work.
no subject