rename variable, add documentation

thx @ax3l for the documentation