avoid superfulous nudefined variable warning
better docs and code comments