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.