The Javadoc for url_base::normalize should explicitly list each of the normalization that it applies, along with examples of before and after for each. Any pull request should modify ONLY the documentation comment attached to the url_base::normalize member function.