From: Richard M. Stallman <rms@gnu.org>
Date: Thu, 10 Aug 1995 18:38:17 +0000 (+0000)
Subject: Comment change.
X-Git-Tag: emacs-19.34~3043
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7204084ebb1a2ae48539cb08935a65781fade48e;p=emacs.git

Comment change.
---

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.