From e80f024efe63227806bb9d25f0b8ba612d32f2f6 Mon Sep 17 00:00:00 2001
From: Sven Slootweg <admin@cryto.net>
Date: Thu, 9 May 2019 22:55:11 +0200
Subject: [PATCH] Clarify documentation

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index a744877..0f2dd30 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,8 @@ console.log(modified4); // http://example.com:8080/path
 
 Generates a modified URL. Returns the modified URL as a string. Keep in mind that the `query` object is *not* merged by default; see the `mergeQuery` option below to change that.
 
+This function does __not__ change the `baseUrl` string or the `newProperties` object you pass in; it creates and returns a new URL string entirely.
+
 - __baseUrl:__ The URL that you want to modify, as a string.
 - __newProperties:__ The properties of the URL that you want to change, following the naming conventions of the [legacy URL object](https://nodejs.org/api/url.html#url_legacy_url_api). Like in that API, `query` takes precedence over `search`, and `hostname`/`port` take precedence over `host`. All keys are optional.
 - __options:__ *(Optional.)* An object of extra options.