Add missing test of urlencoding '%'.
Add notes about percent encoding, expand supporting API.

Add notes about how to handle percent encoding since it's difficult to
get right. To help library users who may not have good library support
elsewhere, provide some helper functions that do a better job than the
old, broad URLencoding we previously provided.