mail-extr.el: Mention `mail-header-parse-address' in the doc string

* lisp/mail/mail-extr.el (mail-extract-address-components):
Mention `mail-header-parse-address' in the doc string.

1 files changed, 7 insertions, 1 deletions

diff --git a/lisp/mail/mail-extr.el b/lisp/mail/mail-extr.el
index 3e8a41fb24c..0175c687b26 100644
--- a/lisp/mail/mail-extr.el
+++ b/lisp/mail/mail-extr.el
@@ -712,7 +712,13 @@ one recipients, all but the first is ignored.
 ADDRESS may be a string or a buffer.  If it is a buffer, the visible
 \(narrowed) portion of the buffer will be interpreted as the address.
 \(This feature exists so that the clever caller might be able to avoid
-consing a string.)"
+consing a string.)
+
+This function is primarily meant for when you're displaying the
+result to the user: Many prettifications are applied to the
+result returned.  If you want to decode an address for further
+non-display use, you should probably use
+`mail-header-parse-address' instead."
   (let ((canonicalization-buffer (get-buffer-create " *canonical address*"))
         (extraction-buffer (get-buffer-create " *extract address components*"))
         value-list)