Fix function comments of tor_snprintf callers
Some functions return the return value they get from tor_snprintf. But they document it poorly: some are wrong, and others don't say what they return. (But the few places we check the return values, we handle them correctly.)
Please merge the branch fix-snprintf-users on my github. It's a comment-only change.