diff options
| -rw-r--r-- | lisp/progmodes/executable.el | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/lisp/progmodes/executable.el b/lisp/progmodes/executable.el index 3711ec4f67a..3e92700da6b 100644 --- a/lisp/progmodes/executable.el +++ b/lisp/progmodes/executable.el @@ -21,10 +21,13 @@ ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. ;;; Commentary: - -;; Provide or modify interpreter magic number for buffer, and make file -;; executable if it isn't. Support code for the likes of sh-, awk-, perl-, -;; tcl- or makefile-mode. +;; This is support code for the likes of sh-, awk-, perl-, tcl- or +;; makefile-mode. Those mode-setting commands can call the like of +;; `(executable-set-magic "sh")' or `(executable-set-magic "perl" "-f")'. +;; Unless the file name matches `executable-magicless-file-regexp' this will +;; search $PATH if the given interpreter isn't absolute, and then insert a +;; first line like `#! /bin/sh' or `#! /usr/local/bin/perl -f' and the file +;; will be made executable as soon as it's saved if it wasn't. ;; Would someone please explain clearly what this is to be used for? -- rms. |