view lisp/novice.el @ 106619:528f9cf7298f

Update dependencies in Makefile.in. (alloc.o): Depend on termhooks.h. (atimer.o): Depend on blockinput.h. (buffer.o): Depend on indent.h, keyboard.h, coding.h, keymap.h, and frame.h. (callint.o): Depend on systime.h, coding.h, and composite.h. (callproc.o): Depend on buffer.h. (casefiddle.o): Don't depend on charset.h. (casetab.o): Depend on character.h. (ccl.o): Depend on composite.h. (chartab.o): Depend on ccl.h. (cm.o): Depend on dispextern.h. (cmds.o): Depend on systime.h, coding.h, frame.h, and composite.h. (coding.o): Don't depend on $(INTERVALS_H). (composite.o): Don't depend on dispextern.h explicitly (it's in $(INTERVALS_H)). Depend on ccl.h. (data.o): Depend on systime.h, coding.h, composite.h, dispextern.h, font.h, and ccl.h. (dired.o): Depend on composite.h. (dispnew.o): Depend on coding.h. Don't depend explicitly on composite.h (it's in $(INTERVALS_H)). (doc.o): Depend on systime.h, coding.h, and composite.h. (editfns.o): Don't depend explicitly on dispextern.h. (emacs.o): Depend on frame.h and coding.h. (eval.o): Depend on coding.h, composite.h, and xterm.h. (fileio.o): Depend on frame.h and commands.h. Don't depend explicitly on dispextern.h. (filelock.o): Don't depend on epaths.h and charset.h. Depend on composite.h. (fns.o): Don't depend on termhooks.h. (font.o): Depend on buffer.h, composite.h, fontset.h, and xterm.h. (fontset.o): Depend on blockinput.h, atimer.h, systime.h, coding.h, $(INTERVALS_H), window.h, xterm.h. (frame.o): Depend on coding.h, composite.h, termhooks.h, and ccl.h. (fringe.o): Depend on blockinput.h, atimer.h, and systime.h. (ftfont.o): Depend on blockinput.h, atimer.h, systime.h, coding.h, fontset.h, ccl.h, and ftfont.h. (ftxfont.o): Depend on atimer.h, systime.h, fontset.h, and ccl.h. (gtkutil.o): Depend on dispextern.h and composite.h. (image.o): Depend on epaths.h, character.h, coding.h, composite.h, termhooks.h, and ccl.h. (indent.o): Depend on systime.h, coding.h, and $(INTERVALS_H). (intervals.o): Depend on systime.h and coding.h. (keyboard.o): Depend on composite.h and coding.h. (keymap.o): Depend on coding.h and frame.h. (lread.o): Depend on systime.h, frame.h, blockinput.h, and atimer.h. (macros.o): Depend on systime.h, coding.h, and composite.h. (menu.o): Depend on systime.h, coding.h, composite.h, window.h, and atimer.h. (minibuf.o): Depend on systime.h and coding.h. Don't depend on dispextern.h explicitly. (print.o): Depend on termhooks.h, coding.h, and ccl.h. Don't depend explicitly on dispextern.h and composite.h. (process.o): Depend on character.h, xgselect.h, and sysselect.h. (regex.o): Don't depend on charset.h. (scroll.o): Depend on systime.h, coding.h, composite.h, and window.h. (search.o): Don't depend explicitly on composite.h. (sound.o): Depend on atimer.h and systime.h. (syntax.o): Don't depend explicitly on composite.h. (sysdep.o): Depend on coding.h and composite.h. (term.o): Depend on xterm.h and buffer.h. (terminal.o): Depend on dispextern.h, composite.h, and systime.h. (textprop.o): Don't depend on dispextern.h explicitly. (undo.o): Depend on dispextern.h. (window.o): Depend on coding.h and termhooks.h. Don't depend on dispextern.h and composite.h explicitly. (xdisp.o): Depend on ccl.h. (xfaces.o): Depend on coding.h and ccl.h. (xfns.o): Depend on $(INTERVALS_H) and ccl.h. (xfont.o): Depend on atimer.h, systime.h, fontset.h, and ccl.h. (xftfont.o): Depend on atimer.h, systime.h, fontset.h, ccl.h, and ftfont.h. (xgselect.o): New dependency. (xmenu.o): Depend on composite.h, keymap.h, and sysselect.h. (xselect.o): Depend on keyboard.h, coding.h, and composite.h. (xsettings.o): Depend on dispextern.h, keyboard.h, systime.h, coding.h, composite.h, blockinput.h, atimer.h, and termopts.h. (xsmfns.o): Depend on frame.h and dispextern.h. (xterm.o): Depend on intervals.h, keymap.h, xgselect.h, and sysselect.h.

;;; novice.el --- handling of disabled commands ("novice mode") for Emacs

;; Copyright (C) 1985, 1986, 1987, 1994, 2001, 2002, 2003, 2004,
;;   2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.

;; Maintainer: FSF
;; Keywords: internal, help

;; This file is part of GNU Emacs.

;; GNU Emacs is free software: you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.

;;; Commentary:

;; This mode provides a hook which is, by default, attached to various
;; putatively dangerous commands in a (probably futile) attempt to
;; prevent lusers from shooting themselves in the feet.

;;; Code:

;; This function is called (by autoloading)
;; to handle any disabled command.
;; The command is found in this-command
;; and the keys are returned by (this-command-keys).

(eval-when-compile (require 'cl))

;;;###autoload
(defvar disabled-command-function 'disabled-command-function
  "Function to call to handle disabled commands.
If nil, the feature is disabled, i.e., all commands work normally.")

;;;###autoload
(define-obsolete-variable-alias 'disabled-command-hook 'disabled-command-function "22.1")

;; It is ok here to assume that this-command is a symbol
;; because we won't get called otherwise.
;;;###autoload
(defun disabled-command-function (&optional cmd keys)
  (unless cmd (setq cmd this-command))
  (unless keys (setq keys (this-command-keys)))
  (let (char)
    (save-window-excursion
      (help-setup-xref (list 'disabled-command-function cmd keys) nil)
      (with-output-to-temp-buffer "*Disabled Command*" ;; (help-buffer)
	 (if (or (eq (aref keys 0)
		     (if (stringp keys)
			 (aref "\M-x" 0)
		       ?\M-x))
		 (and (>= (length keys) 2)
		      (eq (aref keys 0) meta-prefix-char)
		      (eq (aref keys 1) ?x)))
	    (princ (format "You have invoked the disabled command %s.\n" cmd))
	   (princ (format "You have typed %s, invoking disabled command %s.\n"
			 (key-description keys) cmd)))
       ;; Print any special message saying why the command is disabled.
	(if (stringp (get cmd 'disabled))
	    (princ (get cmd 'disabled))
	 (princ "It is disabled because new users often find it confusing.\n")
	 (princ "Here's the first part of its description:\n\n")
	 ;; Keep only the first paragraph of the documentation.
          (with-current-buffer "*Disabled Command*" ;; standard-output
	   (goto-char (point-max))
	   (let ((start (point)))
	     (save-excursion
	       (princ (or (condition-case ()
			       (documentation cmd)
			    (error nil))
			  "<< not documented >>")))
	     (if (search-forward "\n\n" nil t)
		 (delete-region (match-beginning 0) (point-max)))
	     (goto-char (point-max))
	     (indent-rigidly start (point) 3))))
       (princ "\n\nDo you want to use this command anyway?\n\n")
       (princ "You can now type
y   to try it and enable it (no questions if you use it again).
n   to cancel--don't try the command, and it remains disabled.
SPC to try the command just this once, but leave it disabled.
!   to try it, and enable all disabled commands for this session only.")
        ;; Redundant since with-output-to-temp-buffer will do it anyway.
        ;; (with-current-buffer standard-output
        ;;   (help-mode))
        )
     (fit-window-to-buffer (get-buffer-window "*Disabled Command*"))
     (message "Type y, n, ! or SPC (the space bar): ")
     (let ((cursor-in-echo-area t))
       (while (progn (setq char (read-event))
		     (or (not (numberp char))
			 (not (memq (downcase char)
				    '(?! ?y ?n ?\s ?\C-g)))))
	 (ding)
	 (message "Please type y, n, ! or SPC (the space bar): "))))
    (setq char (downcase char))
    (case char
     (?\C-g (setq quit-flag t))
     (?! (setq disabled-command-function nil))
     (?y
	(if (and user-init-file
		 (not (string= "" user-init-file))
		 (y-or-n-p "Enable command for future editing sessions also? "))
	  (enable-command cmd)
	(put cmd 'disabled nil)))
     (?n nil)
     (t (call-interactively cmd)))))

(defun en/disable-command (command disable)
  (unless (commandp command)
    (error "Invalid command name `%s'" command))
  (put command 'disabled disable)
  (let ((init-file user-init-file)
	(default-init-file
	  (if (eq system-type 'ms-dos) "~/_emacs" "~/.emacs")))
    (unless init-file
      (if (or (file-exists-p default-init-file)
	      (and (eq system-type 'windows-nt)
		   (file-exists-p "~/_emacs")))
	  ;; Started with -q, i.e. the file containing
	  ;; enabled/disabled commands hasn't been read.  Saving
	  ;; settings there would overwrite other settings.
	  (error "Saving settings from \"emacs -q\" would overwrite existing customizations"))
      (setq init-file default-init-file)
      (if (and (not (file-exists-p init-file))
	       (eq system-type 'windows-nt)
	       (file-exists-p "~/_emacs"))
	  (setq init-file "~/_emacs")))
    (with-current-buffer (find-file-noselect
                          (substitute-in-file-name init-file))
      (goto-char (point-min))
      (if (search-forward (concat "(put '" (symbol-name command) " ") nil t)
	  (delete-region
	   (progn (beginning-of-line) (point))
	   (progn (forward-line 1) (point))))
      ;; Explicitly enable, in case this command is disabled by default
      ;; or in case the code we deleted was actually a comment.
      (goto-char (point-max))
      (unless (bolp) (newline))
      (insert "(put '" (symbol-name command) " 'disabled "
	      (symbol-name disable) ")\n")
      (save-buffer))))

;;;###autoload
(defun enable-command (command)
  "Allow COMMAND to be executed without special confirmation from now on.
COMMAND must be a symbol.
This command alters the user's .emacs file so that this will apply
to future sessions."
  (interactive "CEnable command: ")
  (en/disable-command command nil))

;;;###autoload
(defun disable-command (command)
  "Require special confirmation to execute COMMAND from now on.
COMMAND must be a symbol.
This command alters the user's .emacs file so that this will apply
to future sessions."
  (interactive "CDisable command: ")
  (en/disable-command command t))

(provide 'novice)

;; arch-tag: f83c0f96-497e-4db6-a430-8703716c6dd9
;;; novice.el ends here