Mercurial > emacs
view lisp/eshell/em-banner.el @ 108851:cb093dac3d58
Merge from mainline.
author | Katsumi Yamaoka <yamaoka@jpl.org> |
---|---|
date | Fri, 28 May 2010 00:48:45 +0000 |
parents | 1d1d5d9bd884 |
children | f57f72bb4757 376148b31b5e |
line wrap: on
line source
;;; em-banner.el --- sample module that displays a login banner ;; Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, ;; 2008, 2009, 2010 Free Software Foundation, Inc. ;; Author: John Wiegley <johnw@gnu.org> ;; 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: ;; There is nothing to be done or configured in order to use this ;; module, other than to select it by customizing the variable ;; `eshell-modules-list'. It will then display a version information ;; message whenever Eshell is loaded. ;; ;; This code is only an example of a how to write a well-formed ;; extension module for Eshell. The better way to display login text ;; is to use the `eshell-script' module, and to echo the desired ;; strings from the user's `eshell-login-script' file. ;; ;; There is one configuration variable, which demonstrates how to ;; properly define a customization variable in an extension module. ;; In this case, it allows the user to change the string which ;; displays at login time. ;;; Code: (eval-when-compile (require 'cl) (require 'esh-mode) (require 'eshell)) (require 'esh-util) ;;;###autoload (eshell-defgroup eshell-banner nil "This sample module displays a welcome banner at login. It exists so that others wishing to create their own Eshell extension modules may have a simple template to begin with." :tag "Login banner" ;; :link '(info-link "(eshell)Login banner") :group 'eshell-module) ;;; User Variables: (defcustom eshell-banner-message "Welcome to the Emacs shell\n\n" "*The banner message to be displayed when Eshell is loaded. This can be any sexp, and should end with at least two newlines." :type 'sexp :group 'eshell-banner) (put 'eshell-banner-message 'risky-local-variable t) (defcustom eshell-banner-load-hook '(eshell-banner-initialize) "*A list of functions to run when `eshell-banner' is loaded." :type 'hook :group 'eshell-banner) (defun eshell-banner-initialize () "Output a welcome banner on initialization." ;; it's important to use `eshell-interactive-print' rather than ;; `insert', because `insert' doesn't know how to interact with the ;; I/O code used by Eshell (unless eshell-non-interactive-p (assert eshell-mode) (assert eshell-banner-message) (let ((msg (eval eshell-banner-message))) (assert msg) (eshell-interactive-print msg)))) (eshell-deftest banner banner-displayed "Startup banner is displayed at point-min" (assert eshell-banner-message) (let ((msg (eval eshell-banner-message))) (assert msg) (goto-char (point-min)) (looking-at msg))) (provide 'em-banner) ;; Local Variables: ;; generated-autoload-file: "esh-groups.el" ;; End: ;; arch-tag: e738b4ef-8671-42ae-a757-291779b92491 ;;; em-banner.el ends here