aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--lisp/progmodes/executable.el11
1 files changed, 7 insertions, 4 deletions
diff --git a/lisp/progmodes/executable.el b/lisp/progmodes/executable.el
index 3e92700da6..11dd54f1e7 100644
--- a/lisp/progmodes/executable.el
+++ b/lisp/progmodes/executable.el
@@ -21,15 +21,18 @@
;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
;;; Commentary:
+
+;; executable.el is used by certain major modes to insert a suitable
+;; #! line at the beginning of the file, if the file does not already
+;; have one.
+
;; 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.
+;; first line like `#! /bin/sh' or `#! /usr/local/bin/perl -f'.
+;; Also it makes the file executable as soon as it's saved, if it wasn't.
;;; Code: