-;; expand.el --- minor mode to make abbreviations more usable.
+;;; expand.el --- make abbreviations more usable
-;; Copyright (C) 1995, 1996 Free Software Foundation, Inc.
+;; Copyright (C) 1995, 1996, 2002, 2003, 2004,
+;; 2005, 2006 Free Software Foundation, Inc.
;; Author: Frederic Lepied <Frederic.Lepied@sugix.frmug.org>
;; Maintainer: Frederic Lepied <Frederic.Lepied@sugix.frmug.org>
;; 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.
+;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+;; Boston, MA 02110-1301, USA.
;;; Commentary:
;;
;; This package defines abbrevs which expand into structured constructs
;; for certain languages. The construct is indented for you,
-;; and contains points for you to ;; fill in other text.
+;; and contains slots for you to fill in other text.
;; These abbrevs expand only at the end of a line and when not in a comment
;; or a string.
;; ("default" "default:\n\nbreak;" 10)
;; ("main" "int\nmain(int argc, char * argv[])\n{\n\n}\n" 37))
;; "Expansions for C mode")
-;;
-;; and enter Expand mode with the following hook :
+;;
+;; and enter Abbrev mode with the following hook :
;;
;; (add-hook 'c-mode-hook (function (lambda ()
;; (expand-add-abbrevs c-mode-abbrev-table c-expand-list)
-;; (expand-mode))))
+;; (abbrev-mode))))
;;
-;; you can also bind jump functions to some keys and init some post-process
-;; hooks :
+;; you can also init some post-process hooks :
;;
-;; (add-hook 'expand-mode-load-hook
+;; (add-hook 'expand-load-hook
;; (function
;; (lambda ()
;; (add-hook 'expand-expand-hook 'indent-according-to-mode)
-;; (add-hook 'expand-jump-hook 'indent-according-to-mode)
-;; (define-key expand-map '[(control tab)] 'expand-jump-to-next-mark)
-;; (define-key expand-map '[(control shift tab)] 'expand-jump-to-previous-mark))))
+;; (add-hook 'expand-jump-hook 'indent-according-to-mode))))
;;
;; Remarks:
;;
-;; Has been tested under emacs 19.28-19.34 and XEmacs 19.11.
;; Many thanks to Heddy Boubaker <boubaker@cenatls.cena.dgac.fr>,
;; Jerome Santini <santini@chambord.univ-orleans.fr>,
;; Jari Aalto <jaalto@tre.tele.nokia.fi>.
;;
-;; Please send me a word to give me your feeling about this mode or
+;; Please send me a word to give me your feeling about this feature or
;; to explain me how you use it (your expansions table for example) using
-;; the function expand-mode-submit-report.
+;; the function expand-submit-report.
+;;; Code:
\f
-;; Expand mode is not a replacement for abbrev it is just a layer above it.
-
;;; Constants:
-(defconst expand-mode-version "$Id: expand.el,v 1.1 1996/12/28 19:41:45 rms Exp rms $"
- "Version tag for expand.el.")
-
-(defconst expand-mode-help-address "expand-help@sugix.frmug.org"
- "Email address to send requests, comments or bug reports.")
-
-(defvar expand-mode nil
- "Status variable for Expand mode.")
-(make-variable-buffer-local 'expand-mode)
-
-(defvar expand-mode-name " Expand"
- "Name of mode displayed in the modeline for Expand mode.")
+(defgroup expand nil
+ "Make abbreviations more usable."
+ :group 'abbrev)
-(defvar expand-mode-hook nil
- "Hooks run when Expand mode is enabled.")
+(defcustom expand-load-hook nil
+ "Hooks run when `expand.el' is loaded."
+ :type 'hook
+ :group 'expand)
-(defvar expand-mode-load-hook nil
- "Hooks run when expand is loaded.")
+(defcustom expand-expand-hook nil
+ "Hooks run when an abbrev made by `expand-add-abbrevs' is expanded."
+ :type 'hook
+ :group 'expand)
-(defvar expand-expand-hook nil
- "Hooks run when expansion is done.")
-
-(defvar expand-jump-hook nil
- "Hooks run when jump to mark occurs.")
+(defcustom expand-jump-hook nil
+ "Hooks run by `expand-jump-to-previous-slot' and `expand-jump-to-next-slot'."
+ :type 'hook
+ :group 'expand)
;;; Samples:
"Loop var: "
"for(" str _ @ "=0; " str @ "; " str @ ") {" \n
@ _ \n
- "}" >
- )
+ "}" > \n)
(defconst expand-c-sample-expand-list
'(("if" "if () {\n \n} else {\n \n}" (5 10 21))
(concat
"(defmacro ()\n"
" \"\"\n"
- " (` \n"
+ " `( \n"
" ))")
(list 11 13 18 25))
)
"Expansions for Lisp mode. See `expand-add-abbrevs'.")
-
+
;; perl example from Jari Aalto <jaalto@tre.tele.nokia.fi>
(defconst expand-sample-perl-mode-expand-list
(list
;;; Code:
-;;;###autoload
-(defun expand-mode (&optional arg)
- "Toggle Expand mode.
-With argument ARG, turn Expand mode on if ARG is positive.
-In Expand mode, inserting an abbreviation at the end of a line
-causes it to expand and be replaced by its expansion."
- (interactive "P")
- (setq expand-mode (if (null arg) (not expand-mode)
- (> (prefix-numeric-value arg) 0)))
- (if expand-mode
- (progn
- (setq abbrev-mode nil)
- (run-hooks 'expand-mode-hook))))
-
-;;;###autoload
-(defvar expand-map (make-sparse-keymap)
- "Key map used in Expand mode.")
-
-(or (assq 'expand-mode minor-mode-alist)
- (setq minor-mode-alist (cons (list 'expand-mode expand-mode-name)
- minor-mode-alist)))
-
-(or (assq 'expand-mode minor-mode-map-alist)
- (setq minor-mode-map-alist (cons (cons 'expand-mode expand-map)
- minor-mode-map-alist)))
-
;;;###autoload
(defun expand-add-abbrevs (table abbrevs)
"Add a list of abbrev to abbrev table TABLE.
If ARG is a list of numbers, point is placed according to the first
member of the list, but you can visit the other specified positions
-cyclicaly with the functions `expand-jump-to-previous-mark' and
-`expand-jump-to-next-mark'.
+cyclicaly with the functions `expand-jump-to-previous-slot' and
+`expand-jump-to-next-slot'.
If ARG is omitted, point is placed at the end of the expanded text."
(nth 2 (car abbrevs)))
(expand-add-abbrevs table (cdr abbrevs))))
-(defvar expand-list nil "Temporary variable used by Expand mode.")
+(defvar expand-list nil "Temporary variable used by the Expand package.")
(defvar expand-pos nil
"If non nil, stores a vector containing markers to positions defined by the last expansion.
(put 'expand-abbrev-hook 'no-self-insert t)
(defun expand-abbrev-hook ()
"Abbrev hook used to do the expansion job of expand abbrevs.
-See `expand-add-abbrevs'."
+See `expand-add-abbrevs'. Value is non-nil if expansion was done."
;; Expand only at the end of a line if we are near a word that has
;; an abbrev built from expand-add-abbrev.
(if (and (eolp)
expand-pos (expand-list-to-markers expand-list)
expand-list nil)))
(run-hooks 'expand-expand-hook)
- t))))
- )
+ t)
+ nil))
+ nil))
(defun expand-do-expansion ()
(delete-backward-char (length last-abbrev-text))
(backward-word 1)
(buffer-substring p (point)))))
-(defun expand-jump-to-previous-mark ()
- "Move the cursor to previous mark created by the expansion."
+;;;###autoload
+(defun expand-jump-to-previous-slot ()
+ "Move the cursor to the previous slot in the last abbrev expansion.
+This is used only in conjunction with `expand-add-abbrevs'."
(interactive)
(if expand-pos
(progn
(goto-char (aref expand-pos expand-index))
(run-hooks 'expand-jump-hook))))
-(defun expand-jump-to-next-mark ()
- "Move the cursor to next mark created by the expansion."
+;;;###autoload
+(defun expand-jump-to-next-slot ()
+ "Move the cursor to the next slot in the last abbrev expansion.
+This is used only in conjunction with `expand-add-abbrevs'."
(interactive)
(if expand-pos
(progn
(goto-char (aref expand-pos expand-index))
(run-hooks 'expand-jump-hook))))
+;;;###autoload (define-key ctl-x-map "ap" 'expand-jump-to-previous-slot)
+;;;###autoload (define-key ctl-x-map "an" 'expand-jump-to-next-slot)
+
(defun expand-build-list (len l)
"Build a vector of offset positions from the list of positions."
(expand-clear-markers)
((nth 4 state) 'comment)
(t nil)))))
-(defun expand-mode-submit-report ()
- "Report a problem, a suggestion or a comment about Expand mode."
- (interactive)
- (require 'reporter)
- (reporter-submit-bug-report
- expand-mode-help-address
- (concat "expand.el " expand-mode-version)
- '(expand-mode-name
- expand-mode-hook
- expand-mode-load-hook
- expand-map
- )
- nil
- nil
- "Dear expand.el maintainer,"))
-
;; support functions to add marks to jump from outside function
(defun expand-list-to-markers (l)
(defun expand-skeleton-end-hook ()
(if skeleton-positions
(setq expand-list skeleton-positions)))
-
+
(add-hook 'skeleton-end-hook (function expand-skeleton-end-hook))
(provide 'expand)
;; run load hooks
-(run-hooks 'expand-mode-load-hook)
+(run-hooks 'expand-load-hook)
+;;; arch-tag: fee53e9e-30e3-4ef3-b191-9785e1f8e885
;;; expand.el ends here
HCoop / bpt / emacs.git / blobdiff