Rename mutate_query_pairs to query_pairs_mut.

This is more in line with standard library convensions,
and we’ll add path_segments_mut later.

src/form_urlencoded.rs

@@ -238,7 +238,7 @@ impl<'a> Target for &'a mut String {
 //   (and so can not be constructed with struct literal syntax outside of this crate),
 // * It has no constructor
 // * It is only visible (on the type level) to users in the return type of
-//   `Url::mutate_query_pairs` which is `Serializer<UrlQuery>`
+//   `Url::query_pairs_mut` which is `Serializer<UrlQuery>`
 // * `Serializer` keeps its target in a private field
 // * Unlike in other `Target` impls, `UrlQuery::finished` does not return `Self`.
 impl<'a> Target for ::UrlQuery<'a> {

src/lib.rs

@@ -645,11 +645,11 @@ impl Url {
     /// let mut url = Url::parse("https://example.net?lang=fr#nav").unwrap();
     /// assert_eq!(url.query(), Some("lang=fr"));
     ///
-    /// url.mutate_query_pairs().append_pair("foo", "bar");
+    /// url.query_pairs_mut().append_pair("foo", "bar");
     /// assert_eq!(url.query(), Some("lang=fr&foo=bar"));
     /// assert_eq!(url.as_str(), "https://example.net/?lang=fr&foo=bar#nav");
     ///
-    /// url.mutate_query_pairs()
+    /// url.query_pairs_mut()
     ///     .clear()
     ///     .append_pair("foo", "bar & baz")
     ///     .append_pair("saisons", "Été+hiver");
@@ -658,11 +658,11 @@ impl Url {
     ///            "https://example.net/?foo=bar+%26+baz&saisons=%C3%89t%C3%A9%2Bhiver#nav");
     /// ```
     ///
-    /// Note: `url.mutate_query_pairs().clear();` is equivalent to `url.set_query(Some(""))`,
+    /// Note: `url.query_pairs_mut().clear();` is equivalent to `url.set_query(Some(""))`,
     /// not `url.set_query(None)`.
     ///
     /// The state of `Url` is unspecified if this return value is leaked without being dropped.
-    pub fn mutate_query_pairs(&mut self) -> form_urlencoded::Serializer<UrlQuery> {
+    pub fn query_pairs_mut(&mut self) -> form_urlencoded::Serializer<UrlQuery> {
         let fragment = self.take_fragment();
 
         let query_start;
@@ -1361,7 +1361,7 @@ fn io_error<T>(reason: &str) -> io::Result<T> {
     Err(io::Error::new(io::ErrorKind::InvalidData, reason))
 }
 
-/// Implementation detail of `Url::mutate_query_pairs`. Typically not used directly.
+/// Implementation detail of `Url::query_pairs_mut`. Typically not used directly.
 pub struct UrlQuery<'a> {
     url: &'a mut Url,
     fragment: Option<String>,