saner variable names, update linuxdoc comments, etc.
Signed-off-by: NAl Viro <viro@zeniv.linux.org.uk>