From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 4 Jul 2021 12:04:52 +0000 (+0300)
Subject: * lisp/url/url-util.el (url-unhex-string): Doc fix.
X-Git-Tag: emacs-28.0.90~1962
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3dae1e42e107938ec9d7c93efec2453e7d23ab5b;p=emacs.git

* lisp/url/url-util.el (url-unhex-string): Doc fix.
---

diff --git a/lisp/url/url-util.el b/lisp/url/url-util.el
index 7c913bcb1a9..8b79736d004 100644
--- a/lisp/url/url-util.el
+++ b/lisp/url/url-util.el
@@ -335,10 +335,13 @@ instead of just \"key\" as in the example above."
 
 ;;;###autoload
 (defun url-unhex-string (str &optional allow-newlines)
-  "Remove %XX embedded spaces, etc in a URL.
+  "Decode %XX sequences in a percent-encoded URL.
 If optional second argument ALLOW-NEWLINES is non-nil, then allow the
 decoding of carriage returns and line feeds in the string, which is normally
-forbidden in URL encoding."
+forbidden in URL encoding.
+
+The resulting string in general requires decoding using an
+appropriate coding-system; see `decode-coding-string'."
   (setq str (or str ""))
   (let ((tmp "")
 	(case-fold-search t))