tweaks: improve some comments, and rename a variable for symmetry
2 files changed