encoded url query support

plus little bit more in-code documentation