Mercurial > emacs
view lisp/eshell/em-banner.el @ 45869:fb2ae7bd271d
(facemenu-map): Rename to Describe Text
to Describe Properties and use describe-text-properties.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Mon, 17 Jun 2002 16:14:37 +0000 |
parents | 67b464da13ec |
children | 695cf19ef79e d7ddb3e565de |
line wrap: on
line source
;;; em-banner.el --- sample module that displays a login banner ;; Copyright (C) 1999, 2000 Free Software Foundation ;; 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 2, 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; see the file COPYING. If not, write to the ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, ;; Boston, MA 02111-1307, USA. (provide 'em-banner) (eval-when-compile (require 'esh-maint)) (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) ;;; 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. ;;; 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) ;;; Code: (require 'esh-util) (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))) ;;; em-banner.el ends here