fix a error in doc

simplify the logic of save binary

Add checks for valid values
Fix wording on some errors

Declare vars as locally as possible

Initialize local variables

Remove unused var "total"
Declare vars as locally as possible

Issue #2114

This follows SURF changes in 1f261c2f