(eshell-convert-numeric-arguments): Annotated the documentation string

to tell users about `eshell-no-numeric-conversions'.

1 files changed, 12 insertions, 1 deletions

diff --git a/lisp/eshell/esh-util.el b/lisp/eshell/esh-util.el
index 62c72af02ca..4edcb53761c 100644
--- a/lisp/eshell/esh-util.el
+++ b/lisp/eshell/esh-util.el
@@ -84,7 +84,18 @@ Setting this to nil is offered as an aid to debugging only."
 (defcustom eshell-convert-numeric-arguments t
   "*If non-nil, converting arguments of numeric form to Lisp numbers.
 Numeric form is tested using the regular expression
-`eshell-number-regexp'."
+`eshell-number-regexp'.
+
+NOTE: If you find that numeric conversions are intefering with the
+specification of filenames (for example, in calling `find-file', or
+some other Lisp function that deals with files, not numbers), add the
+following in your .emacs file:
+
+  (put 'find-file 'eshell-no-numeric-conversions t)
+
+Any function with the property `eshell-no-numeric-conversions' set to
+a non-nil value, will be passed strings, not numbers, even when an
+argument matches `eshell-number-regexp'."
   :type 'boolean
   :group 'eshell-util)