;;; matlab.el --- major mode for MATLAB dot-m files ;; ;; Author: Matt Wette , ;; Eric M. Ludlam ;; Maintainer: Eric M. Ludlam ;; Created: 04 Jan 91 ;; Version: 2.3.1 ;; Keywords: MATLAB ;; ;; Copyright (C) 1997-2003 Eric M. Ludlam ;; Copyright (C) 1991-1997 Matthew R. Wette ;; ;; This program 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. ;; ;; This program 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, 675 Mass Ave, Cambridge, MA 02139, USA. ;; ;;; Commentary: ;; ;; This major mode for GNU Emacs provides support for editing MATLAB dot-m ;; files. It automatically indents for block structures, line continuations ;; (e.g., ...), and comments. ;; ;; Additional features include auto-fill including auto-additions of ;; ellipsis for commands, and even strings. Block/end construct ;; highlighting as you edit. Primitive code-verification and ;; identification. Templates and other code editing functions. ;; Advanced symbol completion. Code highlighting via font-lock. ;; There are many navigation commands that let you move across blocks ;; of code at different levels. ;; ;; Lastly, there is support for running MATLAB in an Emacs buffer, ;; with full shell history and debugger support (when used with the db ;; commands.) The shell can be used as an online help while editing ;; code, providing help on functions, variables, or running arbitrary ;; blocks of code from the buffer you are editing. ;;; Finding Updates: ;; ;; The latest stable version of matlab.el can be found on MATLAB Central: ;; ;; Catagory: ;; http://www.mathworks.com/matlabcentral/fileexchange/loadCategory.do?objectId=19&objectType=Category ;; This File ;; http://www.mathworks.com/matlabcentral/fileexchange/loadFile.do?objectId=104&objectType=file ;; ;; Older versions of matlab.el can be found in as matlab.el.1.10.1 ;; for emacsen that do not have the latest additional utilities such ;; as tempo and derived. ;;; Installation: ;; ;; Put the this file as "matlab.el" somewhere on your load path, then ;; add this to your .emacs or site-init.el file: ;; ;; (autoload 'matlab-mode "matlab" "Enter MATLAB mode." t) ;; (setq auto-mode-alist (cons '("\\.m\\'" . matlab-mode) auto-mode-alist)) ;; (autoload 'matlab-shell "matlab" "Interactive MATLAB mode." t) ;; ;; User Level customizations (You need not use them all): ;; (setq matlab-indent-function t) ; if you want function bodies indented ;; (setq matlab-verify-on-save-flag nil) ; turn off auto-verify on save ;; (defun my-matlab-mode-hook () ;; (setq fill-column 76)) ; where auto-fill should wrap ;; (add-hook 'matlab-mode-hook 'my-matlab-mode-hook) ;; (defun my-matlab-shell-mode-hook () ;; '()) ;; (add-hook 'matlab-shell-mode-hook 'my-matlab-shell-mode-hook) ;; ;; If you are using a version of MATLAB with the Desktop enabled, ;; you may need to add this: ;; ;; (setq matlab-shell-command-swithes '("-nojvm")) ;; ;; Please read the mode help for matlab-mode for additional ;; configuration options. ;; ;; Syntax highlighting: ;; To get font-lock try adding this for older emacsen: ;; (font-lock-mode 1) ;; Or for newer versions of Emacs: ;; (global-font-lock-mode t) ;; To get hilit19 support try adding: ;; (matlab-mode-hilit) ;; ;; This package requires easymenu, tempo, and derived. ;; This package will optionally use custom, shell, and gud. ;; This package supports language specific extensions in imenu, func-menu, ;; speedbar, font-lock, and hilit19. ;;; Mailing List: ;; ;; A mailing list has been set up where beta versions of matlab.el are ;; posted, and where comments, questions, bug reports, and answers to ;; questions can be sent. ;; ;; To subscribe send email to "lists@mathworks.com" with a body of: ;; "subscribe matlab-emacs" ;; to unsubscribe, send email with the body of: "unsubscribe matlab-emacs" ;;; Code: (require 'easymenu) (require 'tempo) (require 'derived) (defconst matlab-mode-version "2.3" "Current version of MATLAB mode.") ;; From custom web page for compatibility between versions of custom: (eval-and-compile (condition-case () (require 'custom) (error nil)) (if (and (featurep 'custom) (fboundp 'custom-declare-variable)) nil ;; We've got what we needed ;; We have the old custom-library, hack around it! (defmacro defgroup (&rest args) nil) (defmacro custom-add-option (&rest args) nil) (defmacro defface (&rest args) nil) (defmacro defcustom (var value doc &rest args) (` (defvar (, var) (, value) (, doc)))))) ;; compatibility (if (string-match "X[Ee]macs" emacs-version) (progn (defalias 'matlab-make-overlay 'make-extent) (defalias 'matlab-overlay-put 'set-extent-property) (defalias 'matlab-delete-overlay 'delete-extent) (defalias 'matlab-overlay-start 'extent-start) (defalias 'matlab-overlay-end 'extent-end) (defalias 'matlab-cancel-timer 'delete-itimer) (defun matlab-run-with-idle-timer (secs repeat function &rest args) (condition-case nil (apply 'start-itimer "matlab" function secs (if repeat secs nil) t t args) (error ;; If the above doesn't work, then try this old version of ;; start itimer. (start-itimer "matlab" function secs (if repeat secs nil))))) ) (defalias 'matlab-make-overlay 'make-overlay) (defalias 'matlab-overlay-put 'overlay-put) (defalias 'matlab-delete-overlay 'delete-overlay) (defalias 'matlab-overlay-start 'overlay-start) (defalias 'matlab-overlay-end 'overlay-end) (defalias 'matlab-cancel-timer 'cancel-timer) (defalias 'matlab-run-with-idle-timer 'run-with-idle-timer) ) (cond ((fboundp 'point-at-bol) (defalias 'matlab-point-at-bol 'point-at-bol) (defalias 'matlab-point-at-eol 'point-at-eol)) ;; Emacs 20.4 ((fboundp 'line-beginning-position) (defalias 'matlab-point-at-bol 'line-beginning-position) (defalias 'matlab-point-at-eol 'line-end-position)) (t (defmacro matlab-point-at-bol () (save-excursion (beginning-of-line) (point))) (defmacro matlab-point-at-eol () (save-excursion (end-of-line) (point))))) (defmacro matlab-run-in-matlab-mode-only (&rest body) "Execute BODY only if the active buffer is a MATLAB M-file buffer." `(if (eq major-mode 'matlab-mode) (progn ,@body) (error "This command works only in a MATLAB M-file buffer."))) (defun matlab-with-emacs-link () "Return non-nil if Emacs Link is running." (and (featurep 'matlab-eei) matlab-eei-process)) ;;; User-changeable variables ================================================= ;; Variables which the user can change (defgroup matlab nil "MATLAB mode." :prefix "matlab-" :group 'languages) (defcustom matlab-indent-level 2 "*The basic indentation amount in `matlab-mode'." :group 'matlab :type 'integer) (defcustom matlab-cont-level 4 "*Basic indentation after continuation if no other methods are found." :group 'matlab :type 'integer) (defcustom matlab-cont-requires-ellipsis t "*Specify if ellipses are required at the end of a line for continuation. Future versions of Matlab may not require ellipses ... , so a heuristic determining if there is to be continuation is used instead." :group 'matlab :type 'integer) (defcustom matlab-case-level '(1 . 1) "*How far to indent case/otherwise statements in a switch. This can be an integer, which is the distance to indent the CASE and OTHERWISE commands, and how far to indent commands appearing in CASE and OTHERWISE blocks. It can also be a cons cell which is of form (CASEINDENT . COMMANDINDENT) where CASEINDENT is the indentation of the CASE and OTHERWISE statements, and COMMANDINDENT is the indentation of commands appearing after the CASE or OTHERWISE command." :group 'matlab :type 'sexp) (defcustom matlab-indent-function nil "*If non-nil, indent body of function." :group 'matlab :type 'boolean) (defcustom matlab-indent-past-arg1-functions "[sg]et\\(_param\\)?\\|waitfor" "*Regex describing functions whose first arg is special. This specialness means that all following parameters which appear on continued lines should appear indented to line up with the second argument, not the first argument." :group 'matlab :type 'string) (defcustom matlab-arg1-max-indent-length 15 "*The maximum length to indent when indenting past arg1. If arg1 is exceptionally long, then only this number of characters will be indented beyond the open paren starting the parameter list.") (defcustom matlab-maximum-indents '(;; = is a convenience. Don't go too far (?= . (10 . 4)) ;; Fns should provide hard limits (?\( . 50) ;; Matrix/Cell arrays (?\[ . 20) (?\{ . 20)) "Alist of maximum indentations when lining up code. Each element is of the form (CHAR . INDENT) where char is a character the indent engine is using, and INDENT is the maximum indentation allowed. Indent could be of the form (MAXIMUM . INDENT), where MAXIMUM is the maximum allowed calculated indent, and INDENT is the amount to use if MAXIMUM is reached." :group 'matlab :type '(repeat (cons (character :tag "Open List Character") (sexp :tag "Number (max) or cons (max indent)")))) (defcustom matlab-handle-simulink t "*If true, add in a few simulink customizations. This variable's state is mostly useful when set at load time when simulink font lock keywords can be removed. This will handle additional cases as the need arrises." :group 'matlab :type 'boolean) (defcustom matlab-auto-fill t "*If true, set variable `auto-fill-function' to our function at startup." :group 'matlab :type 'boolean) (defcustom matlab-fill-fudge 10 "Number of characters around `fill-column' we can fudge filling. Basically, there are places that are very convenient to fill at, but might not be the closest fill spot, or occur after `fill-column'. If they occur within this fudge factor, we will use them. Also, if none of the above occur, and we find a symbol to break at, but an open paren (group) starts or ends within this fudge factor, move there to boost the amount of fill leverage we can get." :group 'matlab :type 'integer) (defcustom matlab-fill-fudge-hard-maximum 79 "The longest line allowed when auto-filling code. This overcomes situations where the `fill-column' plus the `matlab-fill-fudge' is greater than some hard desired limit." :group 'matlab :type 'integer) (defcustom matlab-elipsis-string "..." "Text used to perform continuation on code lines. This is used to generate and identify continuation lines.") (defcustom matlab-fill-code t "*If true, `auto-fill-mode' causes code lines to be automatically continued." :group 'matlab :type 'boolean) (defcustom matlab-fill-count-ellipsis-flag t "*Non-nil means to count the ellipsis when auto filling. This effectively shortens the `fill-column' by the length of `matlab-elipsis-string'.") (defcustom matlab-fill-strings-flag t "*Non-nil means that when auto-fill is on, strings are broken across lines. If `matlab-fill-count-ellipsis-flag' is non nil, this shortens the `fill-column' by the length of `matlab-elipsis-string'.") (defcustom matlab-comment-column 40 "*The goal comment column in `matlab-mode' buffers." :group 'matlab :type 'integer) (defcustom matlab-comment-anti-indent 0 "*Amount of anti-indentation to use for comments in relation to code." :group 'matlab :type 'integer) (defcustom matlab-comment-line-s "% " "*String to start comment on line by itself." :group 'matlab :type 'string) (defcustom matlab-comment-on-line-s "% " "*String to start comment on line with code." :group 'matlab :type 'string) (defcustom matlab-comment-region-s "% $$$ " "*String inserted by \\[matlab-comment-region] at start of each line in \ region." :group 'matlab :type 'string) (defcustom matlab-verify-on-save-flag t "*Non-nil means to verify M whenever we save a file." :group 'matlab :type 'boolean) (defcustom matlab-mode-verify-fix-functions '(matlab-mode-vf-functionname) "List of function symbols which perform a verification and fix to M code. Each function gets no arguments, and returns nothing. They can move point, but it will be restored for them." :group 'matlab :type '(repeat (choice :tag "Function: " '(matlab-mode-vf-functionname matlab-mode-vf-block-matches-forward matlab-mode-vf-block-matches-backward matlab-mode-vf-quietafy-buffer )))) (defcustom matlab-block-verify-max-buffer-size 50000 "*Largest buffer size allowed for block verification during save." :group 'matlab :type 'integer) (defcustom matlab-vers-on-startup t "*If non-nil, show the version number on startup." :group 'matlab :type 'boolean) (defcustom matlab-highlight-block-match-flag t "*Non-nil means to highlight the matching if/end/whatever. The highlighting only occurs when the cursor is on a block start or end keyword." :group 'matlab :type 'boolean) (defcustom matlab-show-periodic-code-details-flag nil "*Non-nil means to show code details in the minibuffer. This will only work if `matlab-highlight-block-match-flag' is non-nil." :group 'matlab :type 'boolean) (defcustom matlab-mode-hook nil "*List of functions to call on entry to MATLAB mode." :group 'matlab :type 'hook) (defcustom matlab-completion-technique 'complete "*How the `matlab-complete-symbol' interfaces with the user. Valid values are: 'increment - which means that new strings are tried with each successive call until all methods are exhausted. (Similar to `hippie-expand'.) 'complete - Which means that if there is no single completion, then all possibilities are displayed in a completion buffer." :group 'matlab :type '(radio (const :tag "Incremental completion (hippie-expand)." increment) (const :tag "Show completion buffer." complete))) ;; Load in the region we use for highlighting stuff. (if (and (featurep 'custom) (fboundp 'custom-declare-variable)) (let ((l-region-face (if (facep 'region) 'region 'zmacs-region))) ;; If we have custom, we can make our own special face like this (defface matlab-region-face (list (list t (list :background (face-background l-region-face) :foreground (face-foreground l-region-face)))) "*Face used to highlight a matlab region." :group 'matlab)) ;; If we do not, then we can fake it by copying 'region. (cond ((facep 'region) (copy-face 'region 'matlab-region-face)) (t (copy-face 'zmacs-region 'matlab-region-face)))) (defvar matlab-unterminated-string-face 'matlab-unterminated-string-face "Self reference for unterminated string face.") (defvar matlab-simulink-keyword-face 'matlab-simulink-keyword-face "Self reference for simulink keywords.") (defun matlab-font-lock-adjustments () "Make adjustments for font lock. If font lock is not loaded, lay in wait." (if (and (featurep 'custom) (fboundp 'custom-declare-variable)) (progn (defface matlab-unterminated-string-face (list (list t (list :background (face-background font-lock-string-face) :foreground (face-foreground font-lock-string-face) :underline t))) "*Face used to highlight unterminated strings." :group 'matlab) (defface matlab-simulink-keyword-face (list (list t (list :background (face-background font-lock-type-face) :foreground (face-foreground font-lock-type-face) :underline t))) "*Face used to highlight simulink specific functions.") ) ;; Now, lets make the unterminated string face (cond ((facep 'font-lock-string-face) (copy-face 'font-lock-string-face 'matlab-unterminated-string-face)) (t (make-face 'matlab-unterminated-string-face))) (set-face-underline-p 'matlab-unterminated-string-face t) ;; Now make some simulink faces (cond ((facep 'font-lock-type-face) (copy-face 'font-lock-type-face 'matlab-simulink-keyword-face)) (t (make-face 'matlab-simulink-keyword-face))) (set-face-underline-p 'matlab-simulink-keyword-face t) ) (remove-hook 'font-lock-mode-hook 'matlab-font-lock-adjustments)) ;; Make the adjustments for font lock after it's loaded. ;; I found that eval-after-load was unreliable. (if (featurep 'font-lock) (matlab-font-lock-adjustments) (add-hook 'font-lock-mode-hook 'matlab-font-lock-adjustments)) ;;; MATLAB mode variables ===================================================== (defvar matlab-tempo-tags nil "List of templates used in MATLAB mode.") ;; syntax table (defvar matlab-mode-syntax-table (let ((st (make-syntax-table (standard-syntax-table)))) (modify-syntax-entry ?_ "_" st) (modify-syntax-entry ?% "<" st) (modify-syntax-entry ?\n ">" st) (modify-syntax-entry ?\\ "." st) (modify-syntax-entry ?\t " " st) (modify-syntax-entry ?+ "." st) (modify-syntax-entry ?- "." st) (modify-syntax-entry ?* "." st) (modify-syntax-entry ?' "." st) (modify-syntax-entry ?/ "." st) (modify-syntax-entry ?= "." st) (modify-syntax-entry ?< "." st) (modify-syntax-entry ?> "." st) (modify-syntax-entry ?& "." st) (modify-syntax-entry ?| "." st) st) "The syntax table used in `matlab-mode' buffers.") (defvar matlab-mode-special-syntax-table (let ((st (copy-syntax-table matlab-mode-syntax-table))) ;; Make _ a part of words so we can skip them better (modify-syntax-entry ?_ "w" st) st) "The syntax table used when navigating blocks.") ;; abbrev table (defvar matlab-mode-abbrev-table nil "The abbrev table used in `matlab-mode' buffers.") (define-abbrev-table 'matlab-mode-abbrev-table ()) ;;; Keybindings =============================================================== (defvar matlab-help-map (let ((km (make-sparse-keymap))) (define-key km "r" 'matlab-shell-run-command) (define-key km "f" 'matlab-shell-describe-command) (define-key km "a" 'matlab-shell-apropos) (define-key km "v" 'matlab-shell-describe-variable) (define-key km "t" 'matlab-shell-topic-browser) km) "The help key map for `matlab-mode' and `matlab-shell-mode'.") (defvar matlab-insert-map (let ((km (make-sparse-keymap))) (define-key km "c" 'matlab-insert-next-case) (define-key km "e" 'matlab-insert-end-block) (define-key km "i" 'tempo-template-matlab-if) (define-key km "I" 'tempo-template-matlab-if-else) (define-key km "f" 'tempo-template-matlab-for) (define-key km "s" 'tempo-template-matlab-switch) (define-key km "t" 'tempo-template-matlab-try) (define-key km "w" 'tempo-template-matlab-while) (define-key km "F" 'tempo-template-matlab-function) (define-key km "'" 'matlab-stringify-region) ;; Not really inserts, but auto coding stuff (define-key km "\C-s" 'matlab-ispell-strings) (define-key km "\C-c" 'matlab-ispell-comments) km) "Keymap used for inserting simple texts based on context.") ;; mode map (defvar matlab-mode-map (let ((km (make-sparse-keymap))) (define-key km [return] 'matlab-return) (define-key km "\C-c;" 'matlab-comment-region) (define-key km "\C-c:" 'matlab-uncomment-region) (define-key km [(control c) return] 'matlab-comment-return) (define-key km [(control c) (control c)] matlab-insert-map) (define-key km [(control c) (control f)] 'matlab-fill-comment-line) (define-key km [(control c) (control j)] 'matlab-justify-line) (define-key km [(control c) (control q)] 'matlab-fill-region) (define-key km [(control c) (control s)] 'matlab-shell-save-and-go) (define-key km [(control c) (control r)] 'matlab-shell-run-region) (define-key km [(control c) (control t)] 'matlab-show-line-info) (define-key km [(control c) ?. ] 'matlab-find-file-on-path) (define-key km [(control h) (control m)] matlab-help-map) (define-key km [(control j)] 'matlab-linefeed) (define-key km "\M-\r" 'newline) (define-key km [(meta \;)] 'matlab-comment) (define-key km [(meta q)] 'matlab-fill-paragraph) (define-key km [(meta a)] 'matlab-beginning-of-command) (define-key km [(meta e)] 'matlab-end-of-command) (define-key km [(meta j)] 'matlab-comment-line-break-function) (define-key km [(meta s)] 'matlab-show-matlab-shell-buffer) (define-key km "\M-\t" 'matlab-complete-symbol) (define-key km [(meta control f)] 'matlab-forward-sexp) (define-key km [(meta control b)] 'matlab-backward-sexp) (define-key km [(meta control a)] 'matlab-beginning-of-defun) (define-key km [(meta control e)] 'matlab-end-of-defun) (if (string-match "XEmacs" emacs-version) (define-key km [(control meta button1)] 'matlab-find-file-click) (define-key km [(control meta mouse-2)] 'matlab-find-file-click)) (substitute-key-definition 'comment-region 'matlab-comment-region km) ; global-map ;torkel km) "The keymap used in `matlab-mode'.") ;;; Font locking keywords ===================================================== (defvar matlab-string-start-regexp "\\(^\\|[^]})a-zA-Z0-9_.']\\)" "Regexp used to represent the character before the string char '. The ' character has restrictions on what starts a string which is needed when attempting to understand the current context.") ;; To quote a quote, put two in a row, thus we need an anchored ;; first quote. In addition, we don't want to color strings in comments. (defvar matlab-string-end-regexp "[^'\n]*\\(''[^'\n]*\\)*'" "Regexp used to represent the character pattern for ending a string. The ' character can be used as a transpose, and can transpose transposes. Therefore, to end, we must check all that goop.") (defun matlab-font-lock-string-match-normal (limit) "When font locking strings, call this function for normal strings. Argument LIMIT is the maximum distance to scan." (matlab-font-lock-string-match-here (concat matlab-string-start-regexp "\\('" matlab-string-end-regexp "\\)" "\\([^']\\|$\\)") limit)) (defun matlab-font-lock-string-match-unterminated (limit) "When font locking strings, call this function for normal strings. Argument LIMIT is the maximum distance to scan." (matlab-font-lock-string-match-here (concat matlab-string-start-regexp "\\('[^'\n]*\\(''[^'\n]*\\)*\\)$") limit)) (defun matlab-font-lock-string-match-here (regex limit) "When font-locking strings, call this function to determine a match. Argument REGEX is the expression to scan for. Match 2 must be the string. Argument LIMIT is the maximum distance to scan." (let (e) (while (and (re-search-forward regex limit t) (progn ;; This gets us out of a comment after the string. (setq e (match-end 2)) (goto-char (match-beginning 2)) (prog1 (or (matlab-cursor-in-comment) (if (bolp) nil (save-excursion (forward-char -1) (matlab-cursor-in-string)))) (goto-char e)))) (setq e nil)) (if (not e) nil (goto-char e) t))) (defun matlab-font-lock-comment-match (limit) "When font-locking comments, call this function to determine a match. Argument LIMIT is the maximum distance to scan." (let (e) (while (and (re-search-forward "\\(%[^%\n]*\\)" limit t) (progn (setq e (match-end 1)) (member (get-text-property (match-beginning 0) 'face) '(font-lock-string-face matlab-unterminated-string-face)))) (setq e nil)) (if (not e) nil (goto-char e) t))) (defun matlab-find-unreachable-code (limit) "Find code that is if'd out with if(0), and mark it as a comment. The if(0) and else/end construct sould be highlighted differently. Argument LIMIT is the maximum distance to search." (if (and (< (point) limit) (re-search-forward "\\<\\(if\\>\\s-*(?\\s-*0\\s-*)?$\\)" limit t)) (let ((b1 (match-beginning 1)) (e1 (match-end 1)) (b2 nil) (e2 nil) (b3 nil) (e3 nil)) (goto-char b1) (condition-case nil (progn ;; Go forward over the matlab sexp. Include scanning ;; for ELSE since parts of the ELSE block are not ;; `commented out'. (matlab-forward-sexp t) (forward-word -1) ;; Is there an ELSE in this block? (if (looking-at (matlab-block-mid-re)) (progn (setq b3 (match-beginning 0) e3 (match-end 0)) ;; Now find the REAL end. (matlab-forward-sexp) (forward-word -1))) ;; End of block stuff (if (looking-at (matlab-block-end-re)) (progn (setq b2 (match-beginning 0) e2 (match-end 0)) ;; make sure something exists... (if (not b3) (setq b3 b2 e3 e2))) (error "Eh?")) ;; Ok, build up some match data. (set-match-data (list b1 e2 ;the real deal. b1 e1 ;if (0) b2 e2 ;end b3 e3 ;else (if applicable.) b1 e3)) ;body commented out. t) (error nil))))) (defcustom matlab-keyword-list '("global" "persistent" "for" "while" "if" "elseif" "else" "endfunction" "return" "break" "continue" "switch" "case" "otherwise" "try" "catch" "tic" "toc") "List of keywords for MATLAB used in highlighting. Customizing this variable is only useful if `regexp-opt' is available." :group 'matlab :type '(repeat (string :tag "Keyword: "))) (defcustom matlab-handle-graphics-list '("figure" "axes" "axis" "line" "surface" "patch" "text" "light" "image" "set" "get" "uicontrol" "uimenu" "uitoolbar" "uitoggletool" "uipushtool" "uicontext" "uicontextmenu" "setfont" "setcolor") "List of handle graphics functions used in highlighting. Customizing this variable is only useful if `regexp-opt' is available." :group 'matlab :type '(repeat (string :tag "HG Keyword: "))) (defcustom matlab-debug-list '("dbstop" "dbclear" "dbcont" "dbdown" "dbmex" "dbstack" "dbstatus" "dbstep" "dbtype" "dbup" "dbquit") "List of debug commands used in highlighting. Customizing this variable is only useful if `regexp-opt' is available." :group 'matlab :type '(repeat (string :tag "Debug Keyword: "))) ;; font-lock keywords (defvar matlab-font-lock-keywords (list ;; String quote chars are also used as transpose, but only if directly ;; after characters, numbers, underscores, or closing delimiters. '(matlab-font-lock-string-match-normal 2 font-lock-string-face) ;; A string with no termination is not currently highlighted. ;; This will show that the string needs some attention. '(matlab-font-lock-string-match-unterminated 2 matlab-unterminated-string-face) ;; Comments must occur after the string, that way we can check to see ;; if the comment start char has occurred inside our string. (EL) '(matlab-font-lock-comment-match 1 font-lock-comment-face) ;; Various pragmas should be in different colors. ;; I think pragmas are always lower case? '("%#\\([a-z]+\\)" (1 'bold prepend)) ;; General keywords (list (if (fboundp 'regexp-opt) (concat "\\<\\(" (regexp-opt matlab-keyword-list) "\\)\\>") ;; Original hard-coded value for pre Emacs 20.1 "\\<\\(break\\|ca\\(se\\|tch\\)\\|e\\(lse\\(\\|if\\)\\|ndfunction\\)\ \\|for\\|global\\|if\\|otherwise\\|return\\|switch\\|try\\|while\\|tic\\|toc\\)\\>") '(0 font-lock-keyword-face)) ;; The end keyword is only a keyword when not used as an array ;; dereferencing part. '("\\(^\\|[;,]\\)[ \t]*\\(end\\)\\b" 2 (if (matlab-valid-end-construct-p) font-lock-keyword-face nil)) ;; How about unreachable code? MUsT BE AFTER KEYWORDS in order to ;; get double-highlighting. '(matlab-find-unreachable-code (1 'underline prepend) ;if part (2 'underline prepend) ;end part (3 'underline prepend) ;else part (if applicable) (4 font-lock-comment-face prepend) ;commented out part. ) ;; The global keyword defines some variables. Mark them. '("^\\s-*global\\s-+" ("\\(\\w+\\)\\(\\s-*=[^,; \t\n]+\\|[, \t;]+\\|$\\)" nil nil (1 font-lock-variable-name-face))) ;; Handle graphics stuff (list (if (fboundp 'regexp-opt) (concat "\\<\\(" (regexp-opt matlab-handle-graphics-list) "\\)\\>") ;; The original regular expression for pre Emacs 20.1 "\\<\\(ax\\(es\\|is\\)\\|figure\\|get\\|image\\|li\\(ght\\|ne\\)\\|\ patch\\|s\\(et\\(\\|color\\|font\\)\\|urface\\)\\|text\\|\ ui\\(cont\\(ext\\(\\|menu\\)\\|rol\\)\\|menu\\|\ \\(toggle\\|push\\)tool\\|toolbar\\)\\)\\>") '(0 font-lock-type-face)) ) "Expressions to highlight in MATLAB mode.") (defvar matlab-gaudy-font-lock-keywords (append matlab-font-lock-keywords (list ;; defining a function, a (possibly empty) list of assigned variables, ;; function name, and an optional (possibly empty) list of input variables (list (concat "^\\s-*\\(function\\)\\>[ \t\n.]*" "\\(\\[[^]]*\\]\\|\\sw+\\)[ \t\n.]*" "=[ \t\n.]*\\(\\sw+\\)[ \t\n.]*" "\\(([^)]*)\\)?\\s-*\\([,;\n%]\\|$\\)") '(1 font-lock-keyword-face append) '(2 font-lock-variable-name-face append) '(3 font-lock-function-name-face append)) ;; defining a function, a function name, and an optional (possibly ;; empty) list of input variables (list (concat "^\\s-*\\(function\\)[ \t\n.]+" "\\(\\sw+\\)[ \t\n.]*" "\\(([^)]*)\\)?\\s-*\\([,;\n%]\\|$\\)") '(1 font-lock-keyword-face append) '(2 font-lock-function-name-face append)) ;; Anchor on the function keyword, highlight params (list (concat "^\\s-*function\\>[ \t\n.]*" "\\(\\(\\[[^]]*\\]\\|\\sw+\\)[ \t\n.]*=[ \t\n.]*\\)?" "\\sw+\\s-*(") '("\\s-*\\(\\sw+\\)\\s-*[,)]" nil nil (1 font-lock-variable-name-face))) ;; I like variables for FOR loops '("\\<\\(for\\)\\s-+\\(\\sw+\\)\\s-*=\\s-*\ \\(\\([^\n,;%(]+\\|([^\n%)]+)\\)+\\)" (1 font-lock-keyword-face) (2 font-lock-variable-name-face append) (3 font-lock-reference-face append)) ;; Items after a switch statements are cool '("\\<\\(case\\|switch\\)\\s-+\\({[^}\n]+}\\|[^,%\n]+\\)" (1 font-lock-keyword-face) (2 font-lock-reference-face)) ;; How about a few matlab constants such as pi, infinity, and sqrt(-1)? ;; The ^>> is in case I use this in an interactive mode someday '("\\<\\(eps\\|pi\\|inf\\|Inf\\|NaN\\|nan\\|ans\\|i\\|j\\|^>>\\)\\>" 1 font-lock-reference-face) '("\\<[0-9]\\.?\\(i\\|j\\)\\>" 1 font-lock-reference-face) ;; Define these as variables since this is about as close ;; as matlab gets to variables (list (concat "\\<" matlab-indent-past-arg1-functions "\\s-*") '("(\\s-*\\(\\w+\\)\\s-*\\(,\\|)\\)" nil nil (1 font-lock-variable-name-face))) )) "Expressions to highlight in MATLAB mode.") (defvar matlab-really-gaudy-font-lock-keywords (append matlab-gaudy-font-lock-keywords (list ;; Since it's a math language, how bout dem symbols? '("\\([<>~]=?\\|\\.[/*^']\\|==\\|\\\\|[-!^&|*+\\/~:]\\)" 1 font-lock-type-face) ;; How about references in the HELP text. (list (concat "^" matlab-comment-line-s "\\s-*" "\\(\\([A-Z]+\\s-*=\\s-+\\|\\[[^]]+]\\s-*=\\s-+\\|\\)" "\\([A-Z][0-9A-Z]+\\)\\(([^)\n]+)\\| \\)\\)") '(1 font-lock-reference-face prepend)) (list (concat "^" matlab-comment-line-s "\\s-*" "See also\\s-+") '("\\([A-Z][A-Z0-9]+\\)\\([,.]\\| and\\|$\\) *" nil nil (1 font-lock-reference-face prepend))) (list (concat "^" matlab-comment-line-s "\\s-*" "\\(\\$" "Revision" "[^\n$]+\\$\\)") '(1 font-lock-reference-face prepend)) ;; continuation ellipsis. '("[^.]\\(\\.\\.\\.+\\)\\([^\n]*\\)" (1 'underline) (2 font-lock-comment-face)) ;; How about debugging statements? ;;'("\\<\\(db\\sw+\\)\\>" 1 'bold) (list (if (fboundp 'regexp-opt) (concat "\\<\\(" (regexp-opt matlab-debug-list) "\\)\\>") ;; pre-regexp-opt days. "\\<\\(db\\(c\\(lear\\|ont\\)\\|down\\|mex\\|quit\\|\ st\\(a\\(ck\\|tus\\)\\|ep\\|op\\)\\|type\\|up\\)\\)\\>") '(0 'bold))) (if matlab-handle-simulink ;; Simulink functions, but only if the user wants it. (list (list (concat "\\<\\(\\([sg]et_param\\|sim\\([gs]et\\)?\\|" "\\(mld\\|ss\\)[A-Z]\\w+\\)\\|" "\\(new\\|open\\|close\\|save\\|find\\)_system\\|" "\\(add\\|delete\\|replace\\)_\\(block\\|line\\)\\|" "simulink\\|bd\\(root\\|close\\)" "\\)\\>") 1 matlab-simulink-keyword-face)) nil)) "Expressions to highlight in MATLAB mode.") (defvar matlab-shell-font-lock-keywords (list ;; How about Errors? '("^\\(Error in\\|Syntax error in\\)\\s-+==>\\s-+\\(.+\\)$" (1 font-lock-comment-face) (2 font-lock-string-face)) ;; and line numbers '("^\\(On line [0-9]+\\)" 1 font-lock-comment-face) ;; User beep things '("\\(\\?\\?\\?[^\n]+\\)" 1 font-lock-comment-face) ;; Useful user commands, but not useful programming constructs '("\\<\\(demo\\|whatsnew\\|info\\|subscribe\\|help\\|doc\\|lookfor\\|what\ \\|whos?\\|cd\\|clear\\|load\\|save\\|helpdesk\\|helpwin\\)\\>" 1 font-lock-keyword-face) ;; Various notices '(" M A T L A B " 0 'underline) '("All Rights Reserved" 0 'italic) '("\\((c)\\s-+Copyright[^\n]+\\)" 1 font-lock-comment-face) '("\\(Version\\)\\s-+\\([^\n]+\\)" (1 font-lock-function-name-face) (2 font-lock-variable-name-face)) ) "Additional keywords used by MATLAB when reporting errors in interactive\ mode.") ;; hilit19 patterns (defvar matlab-hilit19-patterns '( ("\\(^\\|[^%]\\)\\(%[ \t].*\\|%\\)$" 2 comment) ("\\(^\\|[;,]\\)[ \t]*\\(\ function\\|global\\|for\\|while\\|if\\|elseif\\|else\\|end\\(function\\)?\ \\|return\\|switch\\|case\\|otherwise\\|try\\|catch\\)\\b" 2 keyword))) ;; func-menu support for matlab (defvar fume-function-name-regexp-matlab "^\\s-*function\\>[ \t\n.]*\\(\\(\\[[^]]*\\]\\|\\sw+\\)[ \t\n.]*\ =\[ \t\n.]*\\)?\\([a-zA-Z0-9_]+\\)" "Expression to get matlab function/procedure names.") ;; "The connection between a mode and the regexp that matches function (if (boundp 'fume-function-name-regexp-alist) (add-to-list 'fume-function-name-regexp-alist '(matlab-mode . fume-function-name-regexp-matlab))) ;;; Specialised routine to find the next MATLAB function or subroutine. (defun fume-find-next-matlab-function-name (buffer) "Searches for the next matlab function in BUFFER." (fume-find-next-sexp buffer)) (if (boundp 'fume-function-name-regexp-alist) (add-to-list 'fume-find-function-name-method-alist '(matlab-mode . fume-find-next-matlab-function-name))) ;; Imenu support. Recycle the expression for fume since they are the ;; same, and this reduced code duplication. (defvar matlab-imenu-generic-expression `((nil ,fume-function-name-regexp-matlab 3)) "Expressions which find function headings in MATLAB M files.") ;;; MATLAB mode entry point ================================================== ;;;###autoload (defun matlab-mode () "MATLAB-mode is a major mode for editing MATLAB dot-m files. \\ Convenient editing commands are: \\[matlab-comment-region] - Comment/Uncomment out a region of code. \\[matlab-fill-comment-line] - Fill the current comment line. \\[matlab-fill-region] - Fill code and comments in region. \\[matlab-fill-paragraph] - Refill the current command or comment. \\[matlab-complete-symbol] - Symbol completion of matlab symbols\ based on the local syntax. Convenient navigation commands are: \\[matlab-beginning-of-command] - Move to the beginning of a command. \\[matlab-end-of-command] - Move to the end of a command. \\[matlab-beginning-of-defun] - Move to the beginning of a function. \\[matlab-end-of-defun] - Move do the end of a function. \\[matlab-forward-sexp] - Move forward over a syntactic block of code. \\[matlab-backward-sexp] - Move backwards over a syntactic block of code. Convenient template insertion commands: \\[tempo-template-matlab-function] - Insert a function definition. \\[tempo-template-matlab-if] - Insert an IF END block. \\[tempo-template-matlab-for] - Insert a FOR END block. \\[tempo-template-matlab-switch] - Insert a SWITCH END statement. \\[matlab-insert-next-case] - Insert the next CASE condition in a SWITCH. \\[matlab-insert-end-block] - Insert a matched END statement. With \ optional ARG, reindent. \\[matlab-stringify-region] - Convert plaintext in region to a string \ with correctly quoted chars. Variables: `matlab-indent-level' Level to indent blocks. `matlab-cont-level' Level to indent continuation lines. `matlab-cont-requires-ellipsis' Does your MATLAB support implied elipsis. `matlab-case-level' Level to unindent case statements. `matlab-indent-past-arg1-functions' Regexp of functions to indent past the first argument on continuation lines. `matlab-maximum-indents' List of maximum indents during lineups. `matlab-comment-column' Goal column for on-line comments. `fill-column' Column used in auto-fill. `matlab-indent-function' If non-nil, indents body of MATLAB functions. `matlab-return-function' Customize RET handling with this function `matlab-auto-fill' Non-nil, do auto-fill at startup `matlab-fill-code' Non-nil, auto-fill code. `matlab-fill-strings' Non-nil, auto-fill strings. `matlab-verify-on-save-flag' Non-nil, enable code checks on save `matlab-highlight-block-match-flag' Enable matching block begin/end keywords `matlab-vers-on-startup' If t, show version on start-up. `matlab-handle-simulink' If t, enable simulink keyword highlighting. All Key Bindings: \\{matlab-mode-map}" (interactive) (kill-all-local-variables) (use-local-map matlab-mode-map) (setq major-mode 'matlab-mode) (setq mode-name "MATLAB") (if (boundp 'whitespace-modes) (add-to-list 'whitespace-modes 'matlab-mode)) (setq local-abbrev-table matlab-mode-abbrev-table) (set-syntax-table matlab-mode-syntax-table) (setq indent-tabs-mode nil) (make-local-variable 'indent-line-function) (setq indent-line-function 'matlab-indent-line) (make-local-variable 'paragraph-start) (setq paragraph-start (concat "^$\\|" page-delimiter)) (make-local-variable 'paragraph-separate) (setq paragraph-separate paragraph-start) (make-local-variable 'paragraph-ignore-fill-prefix) (setq paragraph-ignore-fill-prefix t) (make-local-variable 'comment-start-skip) (setq comment-start-skip "%\\s-+") (make-local-variable 'comment-start) (setq comment-start "%") (make-local-variable 'comment-column) (setq comment-column matlab-comment-column) (make-local-variable 'comment-indent-function) (setq comment-indent-function 'matlab-comment-indent) (make-local-variable 'add-log-current-defun-function) (setq add-log-current-defun-function 'matlab-current-defun) (make-local-variable 'fill-column) (setq fill-column default-fill-column) (make-local-variable 'auto-fill-function) (if matlab-auto-fill (setq auto-fill-function 'matlab-auto-fill)) ;; Emacs 20 supports this variable. This lets users turn auto-fill ;; on and off and still get the right fill function. (make-local-variable 'normal-auto-fill-function) (setq normal-auto-fill-function 'matlab-auto-fill) (make-local-variable 'fill-prefix) (make-local-variable 'imenu-generic-expression) (setq imenu-generic-expression matlab-imenu-generic-expression) ;; Save hook for verifying src. This lets us change the name of ;; the function in `write-file' and have the change be saved. ;; It also lets us fix mistakes before a `save-and-go'. (make-local-variable 'write-contents-hooks) (add-hook 'write-contents-hooks 'matlab-mode-verify-fix-file-fn) ;; Tempo tags (make-local-variable 'tempo-local-tags) (setq tempo-local-tags (append matlab-tempo-tags tempo-local-tags)) ;; give each file it's own parameter history (make-local-variable 'matlab-shell-save-and-go-history) (make-local-variable 'font-lock-defaults) (setq font-lock-defaults '((matlab-font-lock-keywords matlab-gaudy-font-lock-keywords matlab-really-gaudy-font-lock-keywords ) t ; do not do string/comment highlighting nil ; keywords are case sensitive. ;; This puts _ as a word constituent, ;; simplifying our keywords significantly ((?_ . "w")))) (matlab-enable-block-highlighting 1) (if window-system (matlab-frame-init)) (run-hooks 'matlab-mode-hook) (if matlab-vers-on-startup (matlab-show-version))) ;;; Utilities ================================================================= (defun matlab-show-version () "Show the version number in the minibuffer." (interactive) (message "matlab-mode, version %s" matlab-mode-version)) (defun matlab-find-prev-line () "Recurse backwards until a code line is found." (if (= -1 (forward-line -1)) nil (if (or (matlab-ltype-empty) (matlab-ltype-comm-ignore)) (matlab-find-prev-line) t))) (defun matlab-prev-line () "Go to the previous line of code. Return nil if not found." (interactive) (let ((old-point (point))) (if (matlab-find-prev-line) t (goto-char old-point) nil))) (defun matlab-uniquafy-list (lst) "Return a list that is a subset of LST where all elements are unique." (let ((nlst nil)) (while lst (if (and (car lst) (not (member (car lst) nlst))) (setq nlst (cons (car lst) nlst))) (setq lst (cdr lst))) (nreverse nlst))) ; Aki Vehtari recommends this: (19.29 required) ;(require 'backquote) ;(defmacro matlab-navigation-syntax (&rest body) ; "Evaluate BODY with the matlab-mode-special-syntax-table" ; '(let ((oldsyntax (syntax-table))) ; (unwind-protect ; (progn ; (set-syntax-table matlab-mode-special-syntax-table) ; ,@body) ; (set-syntax-table oldsyntax)))) (defmacro matlab-navigation-syntax (&rest forms) "Set the current environment for syntax-navigation and execute FORMS." (list 'let '((oldsyntax (syntax-table)) (case-fold-search nil)) (list 'unwind-protect (list 'progn '(set-syntax-table matlab-mode-special-syntax-table) (cons 'progn forms)) '(set-syntax-table oldsyntax)))) (put 'matlab-navigation-syntax 'lisp-indent-function 0) (add-hook 'edebug-setup-hook (lambda () (def-edebug-spec matlab-navigation-syntax def-body))) (defun matlab-up-list (count &optional restrict) "Move forwards or backwards up a list by COUNT. Optional argument RESTRICT is where to restrict the search." ;; MATLAB syntax table has no disabling strings or comments. (let ((dir (if (> 0 count) -1 +1)) (origin (point)) (ms nil)) ;; Make count positive (setq count (* count dir)) (if (= dir -1) (while (/= count 0) ;; Search till we find an unstrung paren object. (setq ms (re-search-backward "\\s(\\|\\s)" restrict t)) (while (and (save-match-data (matlab-cursor-in-string-or-comment)) (setq ms (re-search-backward "\\s(\\|\\s)" restrict t)))) (if (not ms) (progn (goto-char origin) (error "Scan Error: List missmatch"))) ;; View it's match. (let ((s (match-string 0))) (if (string-match "\\s(" s) (setq count (1- count)) (setq count (1+ count))))) (error "Not implemented")) ms)) (defun matlab-valid-end-construct-p () "Return non-nil if the end after point terminates a block. Return nil if it is being used to dereference an array." (let ((p (point)) (err1 t)) (condition-case nil (save-restriction ;; Restrict navigation only to the current command line (save-excursion (matlab-beginning-of-command) (narrow-to-region (point) (progn ;;(matlab-end-of-command (point)) (end-of-line) (if (> p (point)) (progn (setq err1 nil) (error))) (point)))) (save-excursion ;; beginning of param list (matlab-up-list -1) ;; backup over the parens. If that fails (condition-case nil (progn (forward-sexp 1) ;; If we get here, the END is inside parens, which is not a ;; valid location for the END keyword. As such it is being ;; used to dereference array parameters nil) ;; This error means that we have an unterminated paren ;; block, so this end is currently invalid. (error nil)))) ;; an error means the list navigation failed, which also means we are ;; at the top-level (error err1)))) ;;; Regexps for MATLAB language =============================================== ;; "-pre" means "partial regular expression" ;; "-if" and "-no-if" means "[no] Indent Function" (defconst matlab-defun-regex "^\\s-*function[ \t.[]" "Regular expression defining the beginning of a MATLAB function.") (defconst matlab-block-beg-pre-if "function\\|for\\|while\\|if\\|switch\\|try\\|tic" "Keywords which mark the beginning of an indented block. Includes function.") (defconst matlab-block-beg-pre-no-if "for\\|while\\|if\\|switch\\|try\\|tic" "Keywords which mark the beginning of an indented block. Excludes function.") (defun matlab-block-beg-pre () "Partial regular expression to recognize MATLAB block-begin keywords." (if matlab-indent-function matlab-block-beg-pre-if matlab-block-beg-pre-no-if)) (defconst matlab-block-mid-pre "elseif\\|else\\|catch" "Partial regular expression to recognize MATLAB mid-block keywords.") (defconst matlab-block-end-pre-if "end\\(function\\)?\\|function\\|toc" "Partial regular expression to recognize MATLAB block-end keywords.") (defconst matlab-block-end-pre-no-if "end\\|toc" "Partial regular expression to recognize MATLAB block-end keywords.") (defun matlab-block-end-pre () "Partial regular expression to recognize MATLAB block-end keywords." (if matlab-indent-function matlab-block-end-pre-if matlab-block-end-pre-no-if)) ;; Not used. ;;(defconst matlab-other-pre ;; "function\\|return" ;; "Partial regular express to recognize MATLAB non-block keywords.") (defconst matlab-endless-blocks "case\\|otherwise" "Keywords which initialize new blocks, but don't have explicit ends. Thus, they are endless. A new case or otherwise will end a previous endless block, and and end will end this block, plus any outside normal blocks.") (defun matlab-block-re () "Regular expression for keywords which begin MATLAB blocks." (concat "\\(^\\|[;,]\\)\\s-*\\(" (matlab-block-beg-pre) "\\|" matlab-block-mid-pre "\\|" (matlab-block-end-pre) "\\|" matlab-endless-blocks "\\)\\b")) (defun matlab-block-scan-re () "Expression used to scan over matching pairs of begin/ends." (concat "\\(^\\|[;,]\\)\\s-*\\(" (matlab-block-beg-pre) "\\|" (matlab-block-end-pre) "\\)\\b")) (defun matlab-block-beg-re () "Expression used to find the beginning of a block." (concat "\\(" (matlab-block-beg-pre) "\\)")) (defun matlab-block-mid-re () "Expression used to find block center parts (like else)." (concat "\\(" matlab-block-mid-pre "\\)")) (defun matlab-block-end-re () "Expression used to end a block. Usually just `end'." (concat "\\(" (matlab-block-end-pre) "\\)")) (defun matlab-block-end-no-function-re () "Expression representing and end if functions are excluded." (concat "\\<\\(" matlab-block-end-pre-no-if "\\)\\>")) (defun matlab-endless-blocks-re () "Expression of block starters that do not have associated ends." (concat "\\(" matlab-endless-blocks "\\)")) (defun matlab-match-function-re () "Expression to match a function start line. There are no reliable numeric matches in this expression. Know that `match-end' of 0 is the end of the functin name." ;; old function was too unstable. ;;"\\(^function\\s-+\\)\\([^=\n]+=[ \t\n.]*\\)?\\(\\sw+\\)" (concat "\\(^\\s-*function\\b[ \t\n.]*\\)\\(\\(\\[[^]]*\\]\\|\\sw+\\)" "[ \t\n.]*=[ \t\n.]*\\)?\\(\\sw+\\)")) (defconst matlab-cline-start-skip "[ \t]*%[ \t]*" "*The regular expression for skipping comment start.") ;;; Lists for matlab keywords ================================================= (defvar matlab-keywords-solo '("break" "case" "else" "elseif" "end" "for" "function" "if" "tic" "toc" "otherwise" "profile" "switch" "while") "Keywords that appear on a line by themselves.") (defvar matlab-keywords-return '("acos" "acosh" "acot" "acoth" "acsch" "asech" "asin" "asinh" "atan" "atan2" "atanh" "cos" "cosh" "coth" "csc" "csch" "exp" "log" "log10" "log2" "sec" "sech" "sin" "sinh" "tanh" "abs" "sign" "sqrt" ) "List of MATLAB keywords that have return arguments. This list still needs lots of help.") (defvar matlab-keywords-boolean '("all" "any" "exist" "isempty" "isequal" "ishold" "isfinite" "isglobal" "isinf" "isletter" "islogical" "isnan" "isprime" "isreal" "isspace" "logical") "List of keywords that are typically used as boolean expressions.") (defvar matlab-core-properties '("ButtonDownFcn" "Children" "Clipping" "CreateFcn" "DeleteFcn" "BusyAction" "HandleVisibility" "HitTest" "Interruptible" "Parent" "Selected" "SelectionHighlight" "Tag" "Type" "UIContextMenu" "UserData" "Visible") "List of properties belonging to all HG objects.") (defvar matlab-property-lists '(("root" . ("CallbackObject" "Language" "CurrentFigure" "Diary" "DiaryFile" "Echo" "ErrorMessage" "Format" "FormatSpacing" "PointerLocation" "PointerWindow" "Profile" "ProfileFile" "ProfileCount" "ProfileInterval" "RecursionLimit" "ScreenDepth" "ScreenSize" "ShowHiddenHandles" "TerminalHideGraphCommand" "TerminalOneWindow" "TerminalDimensions" "TerminalProtocol" "TerminalShowGraphCommand" "Units" "AutomaticFileUpdates" )) ("axes" . ("AmbientLightColor" "Box" "CameraPosition" "CameraPositionMode" "CameraTarget" "CameraTargetMode" "CameraUpVector" "CameraUpVectorMode" "CameraViewAngle" "CameraViewAngleMode" "CLim" "CLimMode" "Color" "CurrentPoint" "ColorOrder" "DataAspectRatio" "DataAspectRatioMode" "DrawMode" "FontAngle" "FontName" "FontSize" "FontUnits" "FontWeight" "GridLineStyle" "Layer" "LineStyleOrder" "LineWidth" "NextPlot" "PlotBoxAspectRatio" "PlotBoxAspectRatioMode" "Projection" "Position" "TickLength" "TickDir" "TickDirMode" "Title" "Units" "View" "XColor" "XDir" "XGrid" "XLabel" "XAxisLocation" "XLim" "XLimMode" "XScale" "XTick" "XTickLabel" "XTickLabelMode" "XTickMode" "YColor" "YDir" "YGrid" "YLabel" "YAxisLocation" "YLim" "YLimMode" "YScale" "YTick" "YTickLabel" "YTickLabelMode" "YTickMode" "ZColor" "ZDir" "ZGrid" "ZLabel" "ZLim" "ZLimMode" "ZScale" "ZTick" "ZTickLabel" "ZTickLabelMode" "ZTickMode")) ("figure" . ("BackingStore" "CloseRequestFcn" "Color" "Colormap" "CurrentAxes" "CurrentCharacter" "CurrentObject" "CurrentPoint" "Dithermap" "DithermapMode" "FixedColors" "IntegerHandle" "InvertHardcopy" "KeyPressFcn" "MenuBar" "MinColormap" "Name" "NextPlot" "NumberTitle" "PaperUnits" "PaperOrientation" "PaperPosition" "PaperPositionMode" "PaperSize" "PaperType" "Pointer" "PointerShapeCData" "PointerShapeHotSpot" "Position" "Renderer" "RendererMode" "Resize" "ResizeFcn" "SelectionType" "ShareColors" "Units" "WindowButtonDownFcn" "WindowButtonMotionFcn" "WindowButtonUpFcn" "WindowStyle")) ("image" . ("CData" "CDataMapping" "EraseMode" "XData" "YData")) ("light" . ("Position" "Color" "Style")) ("line" . ("Color" "EraseMode" "LineStyle" "LineWidth" "Marker" "MarkerSize" "MarkerEdgeColor" "MarkerFaceColor" "XData" "YData" "ZData")) ("patch" . ("CData" "CDataMapping" "FaceVertexCData" "EdgeColor" "EraseMode" "FaceColor" "Faces" "LineStyle" "LineWidth" "Marker" "MarkerEdgeColor" "MarkerFaceColor" "MarkerSize" "Vertices" "XData" "YData" "ZData" "FaceLighting" "EdgeLighting" "BackFaceLighting" "AmbientStrength" "DiffuseStrength" "SpecularStrength" "SpecularExponent" "SpecularColorReflectance" "VertexNormals" "NormalMode")) ("surface" . ("CData" "CDataMapping" "EdgeColor" "EraseMode" "FaceColor" "LineStyle" "LineWidth" "Marker" "MarkerEdgeColor" "MarkerFaceColor" "MarkerSize" "MeshStyle" "XData" "YData" "ZData" "FaceLighting" "EdgeLighting" "BackFaceLighting" "AmbientStrength" "DiffuseStrength" "SpecularStrength" "SpecularExponent" "SpecularColorReflectance" "VertexNormals" "NormalMode")) ("text\\|title\\|xlabel\\|ylabel\\|zlabel" . ("Color" "EraseMode" "Editing" "Extent" "FontAngle" "FontName" "FontSize" "FontUnits" "FontWeight" "HorizontalAlignment" "Position" "Rotation" "String" "Units" "Interpreter" "VerticalAlignment")) ("uicontextmenu" . ("Callback")) ("uicontrol" . ("BackgroundColor" "Callback" "CData" "Enable" "Extent" "FontAngle" "FontName" "FontSize" "FontUnits" "FontWeight" "ForegroundColor" "HorizontalAlignment" "ListboxTop" "Max" "Min" "Position" "String" "Style" "SliderStep" "TooltipString" "Units" "Value")) ("uimenu" . ("Accelerator" "Callback" "Checked" "Enable" "ForegroundColor" "Label" "Position" "Separator")) ;; Flesh this out more later. ("uipushtool\\|uitoggletool\\|uitoolbar" . ("Cdata" "Callback" "Separator" "Visible")) ) "List of property lists on a per object type basis.") (defvar matlab-unknown-type-commands "[gs]et\\|findobj\\|waitfor" "Expression for commands that have unknown types.") (defun matlab-all-known-properties () "Return a list of all properties." (let ((lst matlab-core-properties) (tl matlab-property-lists)) (while tl (setq lst (append lst (cdr (car tl))) tl (cdr tl))) (matlab-uniquafy-list lst))) (defvar matlab-all-known-properties (matlab-all-known-properties) "List of all the known properties.") (defmacro matlab-property-function () "Regexp of all builtin functions that take property lists." '(let ((r matlab-unknown-type-commands) (tl matlab-property-lists)) (while tl (setq r (concat r "\\|" (car (car tl))) tl (cdr tl))) r)) ;;; Navigation =============================================================== (defvar matlab-scan-on-screen-only nil "When this is set to non-nil, then forward/backward sexp stops off screen. This is so the block highlighter doesn't gobble up lots of time when a block is not terminated.") (defun matlab-backward-sexp (&optional autoend noerror) "Go backwards one balanced set of MATLAB expressions. If optional AUTOEND, then pretend we are at an end. If optional NOERROR, then we return t on success, and nil on failure." (interactive "P") (matlab-navigation-syntax (if (and (not autoend) (save-excursion (backward-word 1) (or (not (and (looking-at (matlab-block-end-no-function-re)) (matlab-valid-end-construct-p))) (matlab-cursor-in-string-or-comment)))) ;; Go backwards one simple expression (forward-sexp -1) ;; otherwise go backwards recursively across balanced expressions ;; backup over our end (if (not autoend) (forward-word -1)) (let ((done nil) (start (point)) (returnme t)) (while (and (not done) (or (not matlab-scan-on-screen-only) (pos-visible-in-window-p))) (if (re-search-backward (matlab-block-scan-re) nil t) (progn (goto-char (match-beginning 2)) (if (looking-at (matlab-block-end-no-function-re)) (if (or (matlab-cursor-in-string-or-comment) (not (matlab-valid-end-construct-p))) nil ;; we must skip the expression and keep searching (forward-word 1) (matlab-backward-sexp)) (if (not (matlab-cursor-in-string-or-comment)) (setq done t)))) (goto-char start) (if noerror (setq returnme nil) (error "Unstarted END construct")))) returnme)))) (defun matlab-forward-sexp (&optional includeelse) "Go forward one balanced set of MATLAB expressions. Optional argument INCLUDEELSE will stop on ELSE if it matches the starting IF." (interactive "P") (matlab-navigation-syntax ;; skip over preceeding whitespace (skip-chars-forward " \t\n;") (if (or (not (looking-at (concat "\\(" (matlab-block-beg-pre) "\\|" (matlab-block-mid-re) "\\)\\>"))) (matlab-cursor-in-string-or-comment)) ;; Go forwards one simple expression (forward-sexp 1) ;; otherwise go forwards recursively across balanced expressions (forward-word 1) (let ((done nil) (s nil) (expr-scan (if includeelse (matlab-block-re) (matlab-block-scan-re))) (expr-look (matlab-block-beg-pre))) (while (and (not done) (setq s (re-search-forward expr-scan nil t)) (or (not matlab-scan-on-screen-only) (pos-visible-in-window-p))) (goto-char (match-beginning 2)) (if (looking-at expr-look) (if (matlab-cursor-in-string-or-comment) (forward-word 1) ;; we must skip the expression and keep searching ;; NEVER EVER call with value of INCLUDEELSE (matlab-forward-sexp)) (forward-word 1) (if (and (not (matlab-cursor-in-string-or-comment)) (matlab-valid-end-construct-p)) (setq done t)))) (if (not s) (error "Unterminated block")))))) (defun matlab-beginning-of-defun () "Go to the beginning of the current function." (interactive) (or (re-search-backward matlab-defun-regex nil t) (goto-char (point-min)))) (defun matlab-end-of-defun () "Go to the end of the current function." (interactive) (or (progn (if (looking-at matlab-defun-regex) (goto-char (match-end 0))) (if (re-search-forward matlab-defun-regex nil t) (progn (forward-line -1) t))) (goto-char (point-max)))) (defun matlab-current-defun () "Return the name of the current function." (save-excursion (matlab-beginning-of-defun) (if (looking-at (matlab-match-function-re)) (progn (goto-char (match-end 0)) (current-word))))) (defun matlab-beginning-of-command () "Go to the beginning of an M command. Travels across continuations." (interactive) (beginning-of-line) (let ((p nil) ;; This restriction is a wild guess where to end reverse ;; searching for array continuations. The reason is that ;; matlab up list is very slow, and most people would never ;; put a blank line in a matrix. Either way, it's worth the ;; trade off to speed this up for large files. ;; This list of keywords is NOT meant to be comprehensive. (r (save-excursion (re-search-backward "^\\s-*\\(%\\|if\\|else\\(if\\)\\|while\\|for\\|$\\)\\>" nil t)))) (while (and (or (save-excursion (and (matlab-prev-line) (matlab-lattr-cont))) (matlab-ltype-continued-comm) (setq p (matlab-lattr-array-cont r))) (save-excursion (beginning-of-line) (not (bobp)))) (if p (goto-char p) (matlab-prev-line)) (setq p nil)) (back-to-indentation))) (defun matlab-end-of-command (&optional beginning) "Go to the end of an M command. Optional BEGINNING is where the command starts from." (interactive) (while (and (or (matlab-lattr-cont) (save-excursion (forward-line 1) (and (not (eobp)) (or (matlab-ltype-continued-comm) (matlab-lattr-array-cont beginning))))) ;; This hack is a short circuit. If a user did not ;; correctly end a matrix, this will short-circuit ;; as soon as somethng that would never appear in a matrix ;; becomes visible. (not (save-excursion (beginning-of-line) (looking-at (matlab-block-scan-re))))) (forward-line 1)) (end-of-line)) ;;; Line types and attributes ================================================= (defun matlab-ltype-empty () ; blank line "Return t if current line is empty." (save-excursion (beginning-of-line) (looking-at "^[ \t]*$"))) (defun matlab-ltype-comm () ; comment line "Return t if current line is a MATLAB comment line." (save-excursion (beginning-of-line) (looking-at "[ \t]*%.*$"))) (defun matlab-ltype-comm-ignore () ; comment out a region line "Return t if current line is a MATLAB comment region line." (save-excursion (beginning-of-line) (looking-at (concat "[ \t]*" matlab-comment-region-s)))) (defun matlab-ltype-help-comm () "Return t if the current line is part of the MATLAB help comment." (save-excursion (if (not (matlab-ltype-comm)) nil (while (and (matlab-ltype-comm) (not (bobp)) (matlab-prev-line)) (beginning-of-line)) (matlab-ltype-function-definition)))) (defun matlab-ltype-endfunction-comm () "Return t if the current line is an ENDFUNCTION style comment." (save-excursion (if (not (matlab-ltype-comm)) nil (beginning-of-line) (if (looking-at "^[ \t]*%[ \t]*endfunction") t (while (and (or (matlab-ltype-comm) (matlab-ltype-empty)) (not (eobp))) (forward-line 1)) (matlab-ltype-function-definition))))) (defun matlab-ltype-continued-comm () "Return column of previous line's comment start, or nil." (save-excursion (beginning-of-line) (if (or (not (matlab-ltype-comm)) (bobp)) nil ;; We use forward-line and not matlab-prev-line because ;; we want blank lines to terminate this indentation method. (forward-line -1) (let ((col (matlab-lattr-comm))) (if col (progn (goto-char col) (current-column)) nil))))) (defun matlab-ltype-function-definition () "Return t if the current line is a function definition." (save-excursion (beginning-of-line) (looking-at matlab-defun-regex))) (defun matlab-ltype-code () ; line of code "Return t if current line is a MATLAB code line." (and (not (matlab-ltype-empty)) (not (matlab-ltype-comm)))) (defun matlab-lattr-comm () ; line has comment "Return t if current line contain a comment." (save-excursion (matlab-comment-on-line))) (defun matlab-lattr-implied-continuation () "Return non-nil if this line has implied continuation on the next. This is only useful for new versions of MATLAB where ... is optional." (when (not (matlab-lattr-comm)) (let ((imp nil)) (save-excursion (end-of-line) (skip-chars-backward " \t") ;; Test for oporator incompleteness. (setq imp (/= (point) ;; Careful, - means range in this expression. (progn (skip-chars-backward "-+=/*.^&~<>") (point)))) (if (not imp) ;; Test for argument list incompleteness (condition-case nil (progn (end-of-line) (matlab-up-list -1) (setq imp (looking-at "("))) (error nil))) ) imp))) (defun matlab-lattr-cont () ; line has continuation "Return non-nil if current line ends in ... and optional comment. If `matlab-cont-requires-ellipsis' is nil, then we need to apply a heuristic to determine if this line would use continuation based on what it ends with." (save-excursion (beginning-of-line) (or ;; Here, if the line ends in ..., then it is what we are supposed to do. (and (re-search-forward "[^ \t.][ \t]*\\.\\.+[ \t]*\\(%.*\\)?$" (matlab-point-at-eol) t) (progn (goto-char (match-beginning 0)) (not (matlab-cursor-in-comment)))) ;; If the line doesn't end in ..., but we have optional ..., then ;; use this annoying heuristic. (and (null matlab-cont-requires-ellipsis) (matlab-lattr-implied-continuation)) ))) (defun matlab-lattr-array-cont (&optional restrict) "Return non-nil if current line is in an array. If the entirety of the array is on this line, return nil. Optional option RESTRICT is the distrance to restrict the search." (condition-case nil (save-excursion (beginning-of-line) (matlab-up-list -1 restrict) (and (looking-at "[[{]") (point))) (error nil))) (defun matlab-lattr-array-end () "Return non-nil if the current line closes an array. by close, the first character is the end of an array." (save-excursion (back-to-indentation) (and (looking-at "[]}]") (matlab-lattr-array-cont)))) (defun matlab-lattr-block-cont (&optional eol) "Return a number representing the number of unterminated block constructs. This is any block, such as if, or for that doesn't have an END on this line. Optional EOL indicates a virtual end of line." (let ((v 0)) (save-excursion (beginning-of-line) (save-restriction (narrow-to-region (point) (or eol (matlab-point-at-eol))) (matlab-navigation-syntax (while (re-search-forward (concat "\\<" (matlab-block-beg-re) "\\>") nil t) (if (matlab-cursor-in-string-or-comment) ;; Do nothing nil ;; Increment counter, move to end. (setq v (1+ v)) (let ((p (point))) (forward-word -1) (condition-case nil (progn (matlab-forward-sexp) (setq v (1- v))) (error (goto-char p)))))) (if (= v 0) nil v)))))) (defun matlab-lattr-middle-block-cont () "Return the number of middle block continuations. This should be 1 or nil, and only true if the line starts with one of these special items." (save-excursion (back-to-indentation) (if (looking-at (concat (matlab-block-mid-re) "\\>")) (if (and (re-search-forward (matlab-block-end-pre) (matlab-point-at-eol) t) (matlab-valid-end-construct-p)) ;; If there is an END, we still need to return non-nil, ;; but the number value is a net of 0. 0 1) nil))) (defun matlab-lattr-endless-block-cont () "Return the number of middle block continuations. This should be 1 or nil, and only true if the line starts with one of these special items." (save-excursion (back-to-indentation) (if (looking-at (concat (matlab-endless-blocks-re) "\\>")) 1 nil))) (defun matlab-lattr-block-close () "Return the number of closing block constructs. (not used yet)." (let ((v 0)) (save-excursion (end-of-line) (save-restriction (narrow-to-region (matlab-point-at-bol) (point)) (while (and (re-search-backward (matlab-block-end-re) nil t) (matlab-valid-end-construct-p)) (setq v (1+ v)) (condition-case nil (progn (matlab-backward-sexp t) (setq v (1- v))) (error nil))) (if (= v 0) nil v))))) (defun matlab-lattr-local-end () "Return t if this line begins with an end construct." (save-excursion (back-to-indentation) (let ((matlab-indent-function nil)) (and (looking-at (concat "\\<" (matlab-block-end-re) "\\>")) (matlab-valid-end-construct-p))))) (defun matlab-lattr-semantics (&optional prefix) "Return the semantics of the current position. Values are nil 'solo, 'value, and 'boolean. Boolean is a subset of value. nil means there is no semantic content (ie, string or comment.) If optional PREFIX, then return 'solo if that is the only thing on the line." (cond ;((matlab-cursor-in-string-or-comment) ;nil) ((or (matlab-ltype-empty) (and prefix (save-excursion (beginning-of-line) (looking-at (concat "\\s-*" prefix "\\s-*$"))))) 'solo) ((save-excursion (matlab-beginning-of-command) (looking-at "\\s-*\\(if\\|elseif\\|while\\)\\>")) 'boolean) ((save-excursion (matlab-beginning-of-command) (looking-at (concat "\\s-*\\(" (matlab-property-function) "\\)\\>"))) 'property) (t 'value))) (defun matlab-function-called-at-point () "Return a string representing the function called nearby point." (save-excursion (beginning-of-line) (cond ((looking-at "\\s-*\\([a-zA-Z]\\w+\\)[^=][^=]") (match-string 1)) ((and (re-search-forward "=" (matlab-point-at-eol) t) (looking-at "\\s-*\\([a-zA-Z]\\w+\\)\\s-*[^=]")) (match-string 1)) (t nil)))) (defun matlab-cursor-in-string-or-comment () "Return t if the cursor is in a valid MATLAB comment or string." ;; comment and string depend on each other. Here is one test ;; that does both. (save-restriction (narrow-to-region (matlab-point-at-bol) (matlab-point-at-eol)) (let ((p (1+ (point))) (returnme nil) (sregex (concat matlab-string-start-regexp "'"))) (save-excursion (goto-char (point-min)) (while (and (re-search-forward (concat "'\\|%\\|" (regexp-quote matlab-elipsis-string)) nil t) (<= (point) p)) (if (or (= ?% (preceding-char)) (= ?. (preceding-char))) ;; Here we are in a comment for the rest of it. (progn (goto-char p) (setq returnme t)) ;; Here, we could be a string start, or transpose... (if (or (= (current-column) 1) (save-excursion (forward-char -2) (looking-at sregex))) ;; a valid string start, find the end (let ((f (re-search-forward matlab-string-end-regexp nil t))) (if f (setq returnme (> (point) p)) (setq returnme t))) ;; Ooops, a transpose, keep going. )))) returnme))) (defun matlab-cursor-in-comment () "Return t if the cursor is in a valid MATLAB comment." (save-match-data (save-restriction (narrow-to-region (matlab-point-at-bol) (matlab-point-at-eol)) (save-excursion (let ((prev-match nil)) (while (and (re-search-backward (concat "%\\|" (regexp-quote matlab-elipsis-string) "+") nil t) (not (matlab-cursor-in-string))) (setq prev-match (point))) (if (and prev-match (matlab-cursor-in-string)) (goto-char prev-match)) (and (looking-at (concat "%\\|" (regexp-quote matlab-elipsis-string))) (not (matlab-cursor-in-string)))))))) (defun matlab-cursor-in-string (&optional incomplete) "Return t if the cursor is in a valid MATLAB string. If the optional argument INCOMPLETE is non-nil, then return t if we are in what could be a an incomplete string." (let ((m (match-data)) (returnme nil)) (save-restriction (narrow-to-region (matlab-point-at-bol) (matlab-point-at-eol)) (let ((p (1+ (point))) (sregex (concat matlab-string-start-regexp "'")) (instring nil)) (save-excursion ;; Comment hunters need strings to not call the comment ;; identifiers. Thus, this routines must be savvy of comments ;; without recursing to them. (goto-char (point-min)) (while (or (and instring (looking-at "'")) (and (re-search-forward (concat "'\\|%\\|" (regexp-quote matlab-elipsis-string)) nil t) (<= (point) p) ;; Short circuit to fix this. (progn (setq instring nil) t))) ;; The next line emulates re-search-foward (if instring (goto-char (match-end 0))) (if (or (= ?% (preceding-char)) (= ?. (preceding-char))) ;; Here we are in a comment for the rest of it. ;; thus returnme is a force-false. (goto-char p) ;; Here, we could be in a string start, or transpose... (if (or (= (current-column) 1) instring (save-excursion (forward-char -2) (looking-at sregex))) ;; a valid string start, find the end (let ((f (re-search-forward matlab-string-end-regexp nil t))) (if (and (not f) incomplete) (setq returnme t) (setq returnme (> (point) p)) (setq instring t))) ;; Ooops, a transpose, keep going. )))))) (set-match-data m) returnme)) (defun matlab-comment-on-line () "Place the cursor on the beginning of a valid comment on this line. If there isn't one, then return nil, point otherwise." (interactive) (let ((eol (matlab-point-at-eol)) (p (point)) (signal-error-on-buffer-boundary nil)) (beginning-of-line) (while (and (re-search-forward "%" eol t) (save-excursion (forward-char -1) (matlab-cursor-in-string t)))) (if (not (bolp)) (forward-char -1)) (if (and (looking-at "%") (not (matlab-cursor-in-string t))) (point) (goto-char p) nil))) ;;; Indent functions ========================================================== (defun matlab-indent-line () "Indent a line in `matlab-mode'." (interactive) (let ((i (matlab-calc-indent)) (c (current-column))) (save-excursion (back-to-indentation) (if (= i (current-column)) nil (beginning-of-line) (delete-horizontal-space) (indent-to i)) ;; If line contains a comment, format it. (if () (if (matlab-lattr-comm) (matlab-comment)))) (if (<= c i) (move-to-column i)))) (defun matlab-calc-indent () "Return the appropriate indentation for this line as an integer." (interactive) (let* ((tli (save-excursion (matlab-beginning-of-command) (matlab-point-at-bol))) (ci (save-excursion (or (matlab-prev-line) (progn (beginning-of-line) (forward-line -1))) (matlab-beginning-of-command) (matlab-next-line-indentation))) (sem (matlab-calculate-indentation (if (>= ci tli) 0 ci)))) ;; simplistic (nth 1 sem))) (defun matlab-calculate-indentation (current-indentation) "Calculate out the indentation of the current line. Return a list of descriptions for this line. Return format is: '(TYPE DEPTHNUMBER) where TYPE is one of (comment, code, function, blockstart, blockmid, blockendless, blockend) DEPTHNUMBER is how many characters to indent this line. Argument CURRENT-INDENTATION is what the previous line thinks this line's indentation should be." (let ((ci current-indentation) (tmp nil)) (cond ;; COMMENTS ((matlab-ltype-comm) (cond ;; HELP COMMENT and COMMENT REGION ((or (matlab-ltype-help-comm) (matlab-ltype-comm-ignore)) (list 'comment-help 0)) ;; COMMENT Continued From Previous Line ((setq tmp (matlab-ltype-continued-comm)) (list 'comment tmp)) ;; END FUNCTION COMMENT ((matlab-ltype-endfunction-comm) (list 'comment-endfunction 0)) (t (list 'comment (+ ci matlab-comment-anti-indent))))) ;; FUNCTION DEFINITION ((matlab-ltype-function-definition) (list 'function 0)) ;; END keyword ((matlab-lattr-local-end) (list 'blockend (save-excursion (beginning-of-line) (condition-case nil (progn (matlab-backward-sexp t) (if (matlab-ltype-function-definition) (error "")) (forward-word 1) ;; skip this match when counting (+ (current-indentation) (* (1- (matlab-lattr-block-cont (point))) matlab-indent-level))) (error (error "Unmatched end")))))) ;; ELSE/CATCH keywords ((matlab-lattr-middle-block-cont) (let ((m (match-string 1))) (list 'blockmid (condition-case nil (save-excursion (beginning-of-line) (matlab-backward-sexp t) (if (matlab-ltype-function-definition) (error "")) (current-column)) (error (error "Unmatched %s" m)))))) ;; CASE/OTHERWISE keywords ((matlab-lattr-endless-block-cont) (list 'blockendless (condition-case nil (save-excursion (beginning-of-line) (matlab-backward-sexp t) (if (not (looking-at "switch\\>")) (error "")) (+ (current-column) (if (listp matlab-case-level) (car matlab-case-level) matlab-case-level))) (error (error "Unmatched case/otherwise part"))))) ;; End of a MATRIX ((matlab-lattr-array-end) (list 'array-end (save-excursion (back-to-indentation) (matlab-up-list -1) (let* ((fc (following-char)) (mi (assoc fc matlab-maximum-indents)) (max (if mi (if (listp (cdr mi)) (car (cdr mi)) (cdr mi)) nil)) (ind (if mi (if (listp (cdr mi)) (cdr (cdr mi)) (cdr mi)) nil))) ;; apply the maximum limits. (if (and ind (> (- (current-column) ci) max)) (1- ind) ; decor (current-column)))))) ;; Code lines ((save-excursion (beginning-of-line) (back-to-indentation) (= (point) (progn (matlab-beginning-of-command) (point)))) ;; This means we are at the beginning of a command structure. ;; Always match up against the previous line. (list 'code ci)) ;; Lines continued from previous statements. (t (list (if (matlab-ltype-empty) 'empty (if (matlab-lattr-array-cont) 'array-cont 'code)) (condition-case nil ;; Line up with opening paren/brace/bracket (let ((boc (save-excursion (matlab-beginning-of-command) (point)))) (save-excursion (beginning-of-line) (matlab-up-list -1) (if (> boc (point)) (error nil)) ;; Ok, it MIGHT be that we are in a program ;; statement, and this particular command is an HG ;; statement that would look better if the ;; following lines lined up AFTER the first ;; argument. Lets look. (let ((parendepth (current-column))) (cond ((and (= (following-char) ?\( ) (save-excursion (matlab-navigation-syntax (forward-word -1) (looking-at matlab-indent-past-arg1-functions))) (let ((start-paren (point))) (while (and (re-search-forward "," (matlab-point-at-eol) t) (save-excursion (matlab-up-list -1) (> (point) start-paren)))) (if (and (= (preceding-char) ?,) ;; Don't bother if we hit the EOL. (not (looking-at "\\s-*\\(\\.\\.\\.\\|$\\|)\\)"))) t (move-to-column parendepth) nil))) (skip-chars-forward " \t") (if (> (- (current-column) parendepth) matlab-arg1-max-indent-length) (+ parendepth matlab-arg1-max-indent-length) (current-column))) (t (let* ((fc (following-char)) (mi (assoc fc matlab-maximum-indents)) (max (if mi (if (listp (cdr mi)) (car (cdr mi)) (cdr mi)) nil)) (ind (if mi (if (listp (cdr mi)) (cdr (cdr mi)) (cdr mi)) nil))) (forward-char 1) (skip-chars-forward " \t") ;; If we are at the end of a line and ;; this open paren is there, then we ;; DONT want to indent to it. Use the ;; standard indent. (if (looking-at "\\.\\.\\.\\|$") ;; This could happen in another set ;; of matricies. Find a current ;; indentation based on the ;; previous line. (let ((cci (current-indentation))) (+ cci matlab-cont-level)) ;; apply the maximum limits. (if (and ind (> (- (current-column) ci) max)) (+ ci ind) (current-column))))))))) (error ;; Line up to an equals sign. (save-excursion (matlab-beginning-of-command) (while (and (re-search-forward "=" (matlab-point-at-eol) t) (matlab-cursor-in-string-or-comment))) (if (/= (preceding-char) ?=) (+ ci matlab-cont-level) (skip-chars-forward " \t") (let ((cc (current-column)) (mi (assoc ?= matlab-maximum-indents))) (if (looking-at "\\.\\.\\.\\|$") ;; In this case, the user obviously wants the ;; indentation to be somewhere else. (+ ci (cdr (cdr mi))) ;; If the indent delta is greater than the max, ;; use the max + currenti (if (and mi (> (- cc ci) (if (listp (cdr mi)) (car (cdr mi)) (cdr mi)))) (setq cc (+ ci (if (listp (cdr mi)) (cdr (cdr mi)) (cdr mi))))) cc)))))))) ))) (defun matlab-next-line-indentation () "Calculate the indentation for lines preceeding this command line." (let ((bc (matlab-lattr-block-cont)) (mc (matlab-lattr-middle-block-cont)) (ec (matlab-lattr-endless-block-cont)) (hc (and matlab-indent-function (matlab-ltype-help-comm))) (rc (and (/= 0 matlab-comment-anti-indent) (matlab-ltype-comm) (not (matlab-ltype-help-comm)) (not (matlab-ltype-continued-comm)) (not (matlab-ltype-endfunction-comm))))) (+ (current-indentation) (* matlab-indent-level (or bc 0)) (* matlab-indent-level (or mc 0)) (* (if (listp matlab-case-level) (cdr matlab-case-level) matlab-case-level) (or ec 0)) (if hc matlab-indent-level 0) (if rc (- 0 matlab-comment-anti-indent) 0) ))) ;;; The return key ============================================================ (defcustom matlab-return-function 'matlab-indent-end-before-ret "Function to handle return key. Must be one of: 'matlab-plain-ret 'matlab-indent-after-ret 'matlab-indent-end-before-ret 'matlab-indent-before-ret" :group 'matlab :type '(choice (function-item matlab-plain-ret) (function-item matlab-indent-after-ret) (function-item matlab-indent-end-before-ret) (function-item matlab-indent-before-ret))) (defun matlab-return () "Handle carriage return in `matlab-mode'." (interactive) (funcall matlab-return-function)) (defun matlab-plain-ret () "Vanilla new line." (interactive) (newline)) (defun matlab-indent-after-ret () "Indent after new line." (interactive) (newline) (matlab-indent-line)) (defun matlab-indent-end-before-ret () "Indent line if block end, start new line, and indent again." (interactive) (if (save-excursion (beginning-of-line) (looking-at (concat "^\\s-*\\(" (matlab-block-end-re) "\\|" (matlab-block-mid-re) "\\|" (matlab-endless-blocks-re) "\\)"))) (condition-case nil (matlab-indent-line) (error nil))) (newline) (matlab-indent-line)) (defun matlab-indent-before-ret () "Indent line, start new line, and indent again." (interactive) (matlab-indent-line) (newline) (matlab-indent-line)) (defun matlab-linefeed () "Handle line feed in `matlab-mode'. Has effect of `matlab-return' with (not matlab-indent-before-return)." (interactive) (matlab-indent-line) (newline) (matlab-indent-line)) (defun matlab-comment-return () "Handle carriage return for MATLAB comment line." (interactive) (cond ((matlab-ltype-comm) (matlab-set-comm-fill-prefix) (newline) (insert fill-prefix) (matlab-reset-fill-prefix) (matlab-indent-line)) ((matlab-lattr-comm) (newline) (indent-to comment-column) (insert matlab-comment-on-line-s)) (t (newline) (matlab-comment) (matlab-indent-line)))) (defun matlab-comm-from-prev () "If the previous line is a comment-line then set up a comment on this line." (save-excursion ;; If the previous line is a comment-line then set the fill prefix from ;; the previous line and fill this line. (if (and (= 0 (forward-line -1)) (matlab-ltype-comm)) (progn (matlab-set-comm-fill-prefix) (forward-line 1) (beginning-of-line) (delete-horizontal-space) (if (looking-at "%") (delete-char 1)) (delete-horizontal-space) (insert fill-prefix) (matlab-reset-fill-prefix))))) ;;; Comment management======================================================== (defun matlab-comment () "Add a comment to the current line." (interactive) (cond ((matlab-ltype-empty) ; empty line (matlab-comm-from-prev) (if (matlab-lattr-comm) (skip-chars-forward " \t%") (insert matlab-comment-line-s) (matlab-indent-line))) ((matlab-ltype-comm) ; comment line (matlab-comm-from-prev) (skip-chars-forward " \t%")) ((matlab-lattr-comm) ; code line w/ comment (beginning-of-line) (re-search-forward "[^%]%[ \t]") (forward-char -2) (if (> (current-column) comment-column) (delete-horizontal-space)) (if (< (current-column) comment-column) (indent-to comment-column)) (skip-chars-forward "% \t")) (t ; code line w/o comment (end-of-line) (re-search-backward "[^ \t\n^]" 0 t) (forward-char) (delete-horizontal-space) (if (< (current-column) comment-column) (indent-to comment-column) (insert " ")) (insert matlab-comment-on-line-s)))) (defun matlab-comment-line-break-function (&optional soft) "Break the current line, and if in a comment, continue it. Optional argument SOFT indicates that the newline is soft, and not hard." (interactive) (if (not (matlab-cursor-in-comment)) (matlab-return) ;; Will the below fn work in old emacsen? (if soft (insert-and-inherit ?\n) (newline 1)) (insert "% ") (matlab-indent-line) (end-of-line))) (defun matlab-comment-indent () "Indent a comment line in `matlab-mode'." (matlab-calc-indent)) (defun matlab-comment-region (beg-region end-region arg) "Comments every line in the region. Puts `matlab-comment-region-s' at the beginning of every line in the region. BEG-REGION and END-REGION are arguments which specify the region boundaries. With non-nil ARG, uncomments the region." (interactive "*r\nP") (let ((end-region-mark (make-marker)) (save-point (point-marker))) (set-marker end-region-mark end-region) (goto-char beg-region) (beginning-of-line) (if (not arg) ;comment the region (progn (insert matlab-comment-region-s) (while (and (= (forward-line 1) 0) (< (point) end-region-mark)) (insert matlab-comment-region-s))) (let ((com (regexp-quote matlab-comment-region-s))) ;uncomment the region (if (looking-at com) (delete-region (point) (match-end 0))) (while (and (= (forward-line 1) 0) (< (point) end-region-mark)) (if (looking-at com) (delete-region (point) (match-end 0)))))) (goto-char save-point) (set-marker end-region-mark nil) (set-marker save-point nil))) (defun matlab-uncomment-region (beg end) "Uncomment the current region if it is commented out. Argument BEG and END indicate the region to uncomment." (interactive "*r") (matlab-comment-region beg end t)) ;;; Filling =================================================================== (defun matlab-set-comm-fill-prefix () "Set the `fill-prefix' for the current (comment) line." (interactive) (if (matlab-lattr-comm) (setq fill-prefix (save-excursion (beginning-of-line) (let ((e (matlab-point-at-eol)) (pf nil)) (while (and (re-search-forward "%[ \t]*\\($$$ \\)?" e t) (matlab-cursor-in-string))) (setq pf (match-string 0)) (concat (make-string (- (current-column) (length pf)) ? ) pf)))))) (defun matlab-set-comm-fill-prefix-post-code () "Set the `fill-prefix' for the current post-code comment line." (interactive) (matlab-set-comm-fill-prefix)) (defun matlab-reset-fill-prefix () "Reset the `fill-prefix'." (setq fill-prefix nil)) (defun matlab-find-convenient-line-break () "For the current line, position the cursor where we want to break the line. Basically, spaces are best, then operators. Always less than `fill-column' unless we decide we can fudge the numbers. Return nil if this line should not be broken. This function will ONLY work on code." ;; First of all, if this is a continuation, then the user is ;; requesting that we don't mess with his stuff. (if (matlab-lattr-cont) nil (save-restriction (narrow-to-region (matlab-point-at-bol) (matlab-point-at-eol)) ;; get ourselves onto the fill-column. (move-to-column fill-column) (let ((pos nil) (orig (point))) (or ;; Next, if we have a trailing comment, use that. (progn (setq pos (or (matlab-lattr-comm) (matlab-point-at-bol))) (goto-char pos) (if (and (> (current-column) (- fill-column matlab-fill-fudge)) (< (current-column) (+ fill-column matlab-fill-fudge))) t (goto-char orig) nil)) ;; Now, lets find the nearest space (after or before fill column) (let* ((after (save-excursion (re-search-forward "[ \t]" nil t))) (before (save-excursion (re-search-backward "[ \t]" nil t))) (afterd (- (or after (matlab-point-at-eol)) (point))) (befored (- (point) (or before (matlab-point-at-bol))))) ;; Here, if "before" is actually the beginning of our ;; indentation, then this is most obiously a bad place to ;; break our lines. (if before (save-excursion (goto-char before) (if (<= (point) (save-excursion (back-to-indentation) (point))) (setq before nil)))) (cond ((and after (< afterd matlab-fill-fudge) (< afterd befored)) (goto-char after) t) ((and before (< befored matlab-fill-fudge) (< befored afterd)) (goto-char before) t) (t (goto-char orig) nil))) ;; Now, lets find the nearest backwards (progn (re-search-backward "\\(\\s-\\|\\s.\\)+" nil t) (while (and (looking-at "\\^\\|\\.\\|'") (re-search-backward "\\(\\s-\\|\\s.\\)+" nil t))) (if (or (not (looking-at "\\(\\s-\\|\\s.\\)+")) (<= (point) (save-excursion (back-to-indentation) (point)))) (progn ;; We failed in our mission to find anything, or fell ;; of the edge of the earth. If we are out of ;; bounds, lets try again. (goto-char orig) (if (re-search-backward "\\s.+" nil t) t nil)) ;; Ok, we have a good location to break. Check for column ;; and ref against nearest list ending to predict a possibly ;; better break point. (forward-char 1) (let ((okpos (current-column)) (startlst (save-excursion (condition-case nil (matlab-up-list -1) (error nil)) (if (save-excursion (forward-char -1) (looking-at "\\w")) (forward-word -1)) (current-column))) (endlst (save-excursion (condition-case nil (matlab-up-list 1) (error nil)) (current-column)))) ;; When evaluating list fudge factores, breaking on the ;; edge of a list, or at the beginning of a function ;; call can be more valuable than breaking on a symbol ;; of a mid-sized list. As such, allow double-fudge ;; for lists. (cond ;; First, pick the end of a list. ((and (< endlst matlab-fill-fudge-hard-maximum) (<= endlst (+ fill-column matlab-fill-fudge)) (or (<= (* matlab-fill-fudge 2) (- endlst okpos)) (<= endlst fill-column)) (save-excursion (move-to-column endlst) (not (looking-at "\\^")))) (move-to-column endlst) t) ;; Else, back up over this list and poke around ((>= (* 2 matlab-fill-fudge) (- okpos startlst)) (move-to-column startlst) t) ;; Oh well, just do this symbol. (t (move-to-column okpos) t))))) ;; Well, this just sucks (progn (goto-char orig) nil)))))) (defun matlab-auto-fill () "Do auto filling. Set variable `auto-fill-function' to this symbol to enable MATLAB style auto filling which will automatically insert `...' and the end of a line." (interactive) (let ((fill-prefix fill-prefix) ;; safe way of modifying fill-prefix. (fill-column (- fill-column (if matlab-fill-count-ellipsis-flag (save-excursion (move-to-column fill-column) (if (not (bobp)) (forward-char -1)) (if (matlab-cursor-in-string 'incomplete) 4 3)) 0)))) (if (> (current-column) fill-column) (cond ((matlab-ltype-comm-ignore) nil) ((or (matlab-ltype-comm) (and (save-excursion (move-to-column fill-column) (matlab-cursor-in-comment)) (matlab-lattr-comm))) ;; If the whole line is a comment, do this. (matlab-set-comm-fill-prefix) (do-auto-fill) (matlab-reset-fill-prefix)) ((and (matlab-ltype-code) (not (matlab-lattr-cont)) matlab-fill-code) ;; If we are on a code line, we ellipsify before we fill. (let ((m (make-marker))) (move-marker m (point)) (set-marker-insertion-type m t) (if (not (matlab-find-convenient-line-break)) nil (if (not (and (matlab-cursor-in-string 'incomplete) (save-excursion (forward-char -1) (matlab-cursor-in-string 'incomplete)))) (progn (delete-horizontal-space) (insert " " matlab-elipsis-string "\n") (matlab-indent-line)) (if matlab-fill-strings-flag (let ((pos (point)) (pos2 nil)) (while (and (re-search-backward "'" nil t) (progn (forward-char -1) (looking-at "''")))) (setq pos2 (point)) (if (not (looking-at "\\[")) (progn (skip-chars-backward " \t") (forward-char -1))) (if (looking-at "\\[") (goto-char pos) (goto-char pos2) (forward-char 1) (insert "[") (goto-char pos) (forward-char 1)) ;(delete-horizontal-space) (skip-chars-forward " \t") (insert "' " matlab-elipsis-string "\n") (matlab-indent-line) (insert "'") (save-excursion ;; Re scan forward for the end of the string. Add an end bracket ;; if there isn't one already. (while (and (re-search-forward "'" m t) (looking-at "''"))) (forward-char -1) (if (not (looking-at "'\\s-*]")) (progn (forward-char 1) (insert "]")))) )))) (goto-char m))) )))) (defun matlab-join-comment-lines () "Join current comment line to the next comment line." ;; New w/ V2.0: This used to join the previous line, but I could find ;; no editors that had a "join" that did that. I modified join to have ;; a behaviour I thought more inline with other editors. (interactive) (end-of-line) (if (looking-at "\n[ \t]*%") (replace-match " " t t nil) (error "No following comment to join with"))) (defun matlab-fill-region (beg-region end-region &optional justify-flag) "Fill the region between BEG-REGION and END-REGION. Non-nil JUSTIFY-FLAG means justify comment lines as well." (interactive "*r\nP") (let ((end-reg-mk (make-marker))) (set-marker end-reg-mk end-region) (goto-char beg-region) (beginning-of-line) (while (< (point) end-reg-mk) ;; This function must also leave the point at the end of the ;; justified line. (matlab-fill-paragraph justify-flag) (forward-line 1) (beginning-of-line)))) (defun matlab-fill-comment-line (&optional justify) "Fill the current comment line. With optional argument, JUSTIFY the comment as well." (interactive) (if (not (matlab-comment-on-line)) (error "No comment to fill")) (beginning-of-line) ;; First, find the beginning of this comment... (while (and (looking-at matlab-cline-start-skip) (not (bobp))) (forward-line -1) (beginning-of-line)) (if (not (looking-at matlab-cline-start-skip)) (forward-line 1)) ;; Now scan to the end of this comment so we have our outer bounds, ;; and narrow to that region. (save-restriction (narrow-to-region (point) (save-excursion (while (and (looking-at matlab-cline-start-skip) (not (save-excursion (end-of-line) (eobp)))) (forward-line 1) (beginning-of-line)) (if (not (looking-at matlab-cline-start-skip)) (forward-line -1)) (end-of-line) (point))) ;; Find the fill prefix... (matlab-comment-on-line) (looking-at "%[ \t]*") (let ((fill-prefix (concat (make-string (current-column) ? ) (match-string 0)))) (fill-region (point-min) (point-max) justify)))) (defun matlab-justify-line () "Delete space on end of line and justify." (interactive) (save-excursion (end-of-line) (delete-horizontal-space) (justify-current-line))) (defun matlab-fill-paragraph (arg) "When in a comment, fill the current paragraph. Paragraphs are always assumed to be in a comment. ARG is passed to `fill-paragraph' and will justify the text." (interactive "P") (cond ((or (matlab-ltype-comm) (and (matlab-cursor-in-comment) (not (matlab-lattr-cont)))) ;; We are in a comment, lets fill the paragraph with some ;; nice regular expressions. (let ((paragraph-separate "%[a-zA-Z]\\|%[ \t]*$\\|[ \t]*$") (paragraph-start "%[a-zA-Z]\\|%[ \t]*$\\|[ \t]*$") (paragraph-ignore-fill-prefix nil) (start (save-excursion (matlab-beginning-of-command) (point))) (end (save-excursion (matlab-end-of-command) (point))) (fill-prefix nil)) (matlab-set-comm-fill-prefix) (save-restriction ;; Ben North fixed to handle comment at the end of ;; a buffer. (narrow-to-region start (min (point-max) (+ end 1))) (fill-paragraph arg)))) ((matlab-ltype-code) ;; Ok, lets get the outer bounds of this command, then ;; completely refill it using the smart line breaking code. (save-restriction (narrow-to-region (save-excursion (matlab-beginning-of-command) (beginning-of-line) (point)) (save-excursion (matlab-end-of-command) (point))) ;; Remove all line breaks (goto-char (point-min)) (while (and (re-search-forward "$" nil t) (not (eobp))) (delete-horizontal-space) ;; Blow away continuation marks (if (matlab-lattr-cont) (progn (goto-char (match-beginning 0)) (forward-char 1) (delete-region (point) (matlab-point-at-eol)))) ;; Zap the CR (if (not (eobp)) (delete-char 1)) ;; Clean up whitespace (delete-horizontal-space) ;; Clean up trailing comments (if (and (looking-at "% *") (matlab-cursor-in-comment)) (progn (delete-char 1) (delete-horizontal-space))) (insert " ")) ;; Now fill till we are done (goto-char (point-max)) (while (or (> (current-column) (+ fill-column matlab-fill-fudge)) (> (current-column) matlab-fill-fudge-hard-maximum)) (if (= (point) (progn (matlab-auto-fill) (point))) (error "Fill algorith failed!")) (if arg (save-excursion (forward-line -1) (matlab-justify-line)))) (if arg (save-excursion (forward-line -1) (matlab-justify-line))))) (t (message "Paragraph Fill not supported in this context.")))) ;;; Semantic text insertion and management ==================================== (defun matlab-find-recent-variable-list (prefix) "Return a list of most recent variables starting with PREFIX as a string. Reverse searches for the following are done first: 1) Assignment 2) if|for|while|switch 3) global variables 4) function arguments. All elements are saved in a list, which is then uniqafied. If NEXT is non-nil, then the next element from the saved list is used. If the list is empty, then searches continue backwards through the code." (matlab-navigation-syntax (let* ((bounds (save-excursion (if (re-search-backward "^\\s-*function\\>" nil t) (match-beginning 0) (point-min)))) (syms (append (save-excursion (let ((lst nil)) (while (and (re-search-backward (concat "^\\s-*\\(" prefix "\\w+\\)\\s-*=") bounds t) (< (length lst) 10)) (setq lst (cons (match-string 1) lst))) (nreverse lst))) (save-excursion (let ((lst nil)) (while (and (re-search-backward (concat "\\<\\(" matlab-block-beg-pre-no-if "\\)\\s-+(?\\s-*\\(" prefix "\\w+\\)\\>") bounds t) (< (length lst) 10)) (setq lst (cons (match-string 2) lst))) (nreverse lst))) (save-excursion (if (re-search-backward "^\\s-*global\\s-+" bounds t) (let ((lst nil) m e) (goto-char (match-end 0)) (while (looking-at "\\(\\w+\\)\\([ \t]+\\|$\\)") (setq m (match-string 1) e (match-end 0)) (if (equal 0 (string-match prefix m)) (setq lst (cons m lst))) (goto-char e)) (nreverse lst)))) (save-excursion (if (and (re-search-backward "^\\s-*function\\>" bounds t) (re-search-forward "\\<\\(\\w+\\)(" (matlab-point-at-eol) t)) (let ((lst nil) m e) (while (looking-at "\\(\\w+\\)\\s-*[,)]\\s-*") (setq m (match-string 1) e (match-end 0)) (if (equal 0 (string-match prefix m)) (setq lst (cons m lst))) (goto-char e)) (nreverse lst)))))) (fl nil)) (while syms (if (car syms) (setq fl (cons (car syms) fl))) (setq syms (cdr syms))) (matlab-uniquafy-list (nreverse fl))))) (defvar matlab-most-recent-variable-list nil "Maintained by `matlab-find-recent-variable'.") (defun matlab-find-recent-variable (prefix &optional next) "Return the most recently used variable starting with PREFIX as a string. See `matlab-find-recent-variable-list' for details. In NEXT is non-nil, than continue through the list of elements." (if next (let ((next (car matlab-most-recent-variable-list))) (setq matlab-most-recent-variable-list (cdr matlab-most-recent-variable-list)) next) (let ((syms (matlab-find-recent-variable-list prefix)) (first nil)) (if (eq matlab-completion-technique 'complete) syms (setq first (car syms)) (setq matlab-most-recent-variable-list (cdr syms)) first)))) (defun matlab-find-user-functions-list (prefix) "Return a list of user defined functions that match PREFIX." (matlab-navigation-syntax (let ((syms (append (save-excursion (goto-char (point-min)) (let ((lst nil)) (while (re-search-forward "^\\s-*function\\>" nil t) (if (re-search-forward (concat "\\(" prefix "\\w+\\)\\s-*\\($\\|(\\)") (matlab-point-at-eol) t) (setq lst (cons (match-string 1) lst)))) (nreverse lst))) (let ((lst nil) (files (directory-files default-directory nil (concat "^" prefix "[a-zA-Z][a-zA-Z0-9_]+\\.m$")))) (while files (setq lst (cons (progn (string-match "\\.m" (car files)) (substring (car files) 0 (match-beginning 0))) lst) files (cdr files))) lst))) (fl nil)) (while syms (if (car syms) (setq fl (cons (car syms) fl))) (setq syms (cdr syms))) (matlab-uniquafy-list (nreverse fl))))) (defvar matlab-user-function-list nil "Maintained by `matlab-find-user-functions'.") (defun matlab-find-user-functions (prefix &optional next) "Return a user function that match PREFIX and return it. If optional argument NEXT is non-nil, then return the next found object." (if next (let ((next (car matlab-user-function-list))) (setq matlab-user-function-list (cdr matlab-user-function-list)) next) (let ((syms (matlab-find-user-functions-list prefix)) (first nil)) (if (eq matlab-completion-technique 'complete) syms (setq first (car syms)) (setq matlab-user-function-list (cdr syms)) first)))) (defvar matlab-generic-list-placeholder nil "Maintained by `matalb-generic-list-expand'. Holds sub-lists of symbols left to be expanded.") (defun matlab-generic-list-expand (list prefix &optional next) "Return an element from LIST that start with PREFIX. If optional NEXT argument is non nil, then the next element in the list is used. nil is returned if there are not matches." (if next (let ((next (car matlab-generic-list-placeholder))) (setq matlab-generic-list-placeholder (cdr matlab-generic-list-placeholder)) next) (let ((re (concat "^" (regexp-quote prefix))) (first nil) (fl nil)) (while list (if (string-match re (car list)) (setq fl (cons (car list) fl))) (setq list (cdr list))) (setq fl (nreverse fl)) (if (eq matlab-completion-technique 'complete) fl (setq first (car fl)) (setq matlab-generic-list-placeholder (cdr fl)) first)))) (defun matlab-solo-completions (prefix &optional next) "Return PREFIX matching elements for solo symbols. If NEXT then the next patch from the list is used." (matlab-generic-list-expand matlab-keywords-solo prefix next)) (defun matlab-value-completions (prefix &optional next) "Return PREFIX matching elements for value symbols. If NEXT then the next patch from the list is used." (matlab-generic-list-expand matlab-keywords-return prefix next)) (defun matlab-boolean-completions (prefix &optional next) "Return PREFIX matching elements for boolean symbols. If NEXT then the next patch from the list is used." (matlab-generic-list-expand matlab-keywords-boolean prefix next)) (defun matlab-property-completions (prefix &optional next) "Return PREFIX matching elements for property names in strings. If NEXT then the next property from the list is used." (let ((f (matlab-function-called-at-point)) (lst matlab-property-lists) (foundlst nil) (expandto nil)) ;; Look for this function. If it is a known function then we ;; can now use a subset of available properties! (while (and lst (not foundlst)) (if (string= (car (car lst)) f) (setq foundlst (cdr (car lst)))) (setq lst (cdr lst))) (if foundlst (setq foundlst (append foundlst matlab-core-properties)) (setq foundlst matlab-all-known-properties)) (setq expandto (matlab-generic-list-expand foundlst prefix next)) ;; This looks to see if we have a singular completion. If so, ;; then return it, and also append the "'" to the end. (cond ((and (listp expandto) (= (length expandto) 1)) (setq expandto (list (concat (car expandto) "'")))) ((stringp expandto) (setq expandto (concat expandto "'")))) expandto)) (defvar matlab-last-prefix nil "Maintained by `matlab-complete-symbol'. The prefix used for the first completion command.") (defvar matlab-last-semantic nil "Maintained by `matlab-complete-symbol'. The last type of semantic used while completing things.") (defvar matlab-completion-search-state nil "List of searching things we will be doing.") (defun matlab-complete-symbol (&optional arg) "Complete a partially typed symbol in a MATLAB mode buffer. If the previously entered command was also `matlab-complete-symbol' then undo the last completion, and find a new one. The types of symbols tried are based on the semantics of the current cursor position. There are two types of symbols. For example, if the cursor is in an if statement, boolean style functions and symbols are tried first. If the line is blank, then flow control, or high level functions are tried first. The completion technique is controlled with `matlab-completion-technique' It defaults to incremental completion described above. If a completion list is preferred, then change this to 'complete. If you just want a completion list once, then use the universal argument ARG to change it temporarily." (interactive "P") (matlab-navigation-syntax (let* ((prefix (if (and (not (eq last-command 'matlab-complete-symbol)) (member (preceding-char) '(? ?\t ?\n ?, ?\( ?\[ ?\'))) "" (buffer-substring-no-properties (save-excursion (forward-word -1) (point)) (point)))) (sem (matlab-lattr-semantics prefix)) (matlab-completion-technique (if arg (cond ((eq matlab-completion-technique 'complete) 'increment) (t 'complete)) matlab-completion-technique))) (if (not (eq last-command 'matlab-complete-symbol)) (setq matlab-last-prefix prefix matlab-last-semantic sem matlab-completion-search-state (cond ((eq sem 'solo) '(matlab-solo-completions matlab-find-user-functions matlab-find-recent-variable)) ((eq sem 'boolean) '(matlab-find-recent-variable matlab-boolean-completions matlab-find-user-functions matlab-value-completions)) ((eq sem 'value) '(matlab-find-recent-variable matlab-find-user-functions matlab-value-completions matlab-boolean-completions)) ((eq sem 'property) '(matlab-property-completions matlab-find-user-functions matlab-find-recent-variable matlab-value-completions)) (t '(matlab-find-recent-variable matlab-find-user-functions matlab-value-completions matlab-boolean-completions))))) (cond ((eq matlab-completion-technique 'increment) (let ((r nil) (donext (eq last-command 'matlab-complete-symbol))) (while (and (not r) matlab-completion-search-state) (message "Expand with %S" (car matlab-completion-search-state)) (setq r (funcall (car matlab-completion-search-state) matlab-last-prefix donext)) (if (not r) (setq matlab-completion-search-state (cdr matlab-completion-search-state) donext nil))) (delete-region (point) (progn (forward-char (- (length prefix))) (point))) (if r (insert r) (insert matlab-last-prefix) (message "No completions.")))) ((eq matlab-completion-technique 'complete) (let ((allsyms (apply 'append (mapcar (lambda (f) (funcall f prefix)) matlab-completion-search-state)))) (cond ((null allsyms) (message "No completions.") (ding)) ((= (length allsyms) 1) (delete-region (point) (progn (forward-char (- (length prefix))) (point))) (insert (car allsyms))) ((= (length allsyms) 0) (message "No completions.")) (t (let* ((al (mapcar (lambda (a) (list a)) allsyms)) (c (try-completion prefix al))) ;; This completion stuff lets us expand as much as is ;; available to us. When the completion is the prefix ;; then we want to display all the strings we've ;; encountered. (if (and (stringp c) (not (string= prefix c))) (progn (delete-region (point) (progn (forward-char (- (length prefix))) (point))) (insert c)) ;; `display-completion-list' does all the complex ;; ui work for us. (with-output-to-temp-buffer "*Completions*" (display-completion-list (matlab-uniquafy-list allsyms))))))))))))) (defun matlab-insert-end-block (&optional reindent) "Insert and END block based on the current syntax. Optional argument REINDENT indicates if the specified block should be re-indented." (interactive "P") (if (not (matlab-ltype-empty)) (progn (end-of-line) (insert "\n"))) (let ((valid t) (begin nil)) (save-excursion (condition-case nil (progn (matlab-backward-sexp t) (setq begin (point) valid (buffer-substring-no-properties (point) (save-excursion (re-search-forward "[\n,;.]" nil t) (point))))) (error (setq valid nil)))) (if (not valid) (error "No block to end") (insert "end") (if (stringp valid) (insert " % " valid)) (matlab-indent-line) (if reindent (indent-region begin (point) nil))))) (tempo-define-template "matlab-for" '("for " p "=" p "," > n> r> & "end" > %) "for" "Insert a MATLAB for statement" 'matlab-tempo-tags ) (tempo-define-template "matlab-while" '("while (" p ")," > n> r> & "end" > %) "while" "Insert a MATLAB while statement" 'matlab-tempo-tags ) (tempo-define-template "matlab-if" '("if " p > n r> "end" > n) "if" "Insert a MATLAB if statement" 'matlab-tempo-tags ) (tempo-define-template "matlab-if-else" '("if " p > n r> "else" > n "end" > n) "if" "Insert a MATLAB if statement" 'matlab-tempo-tags ) (tempo-define-template "matlab-try" '("try " > n r> "catch" > n p > n "end" > n) "try" "Insert a MATLAB try catch statement" 'matlab-tempo-tags ) (tempo-define-template "matlab-switch" '("switch " p > n "otherwise" > n r> "end" > n) "switch" "Insert a MATLAB switch statement with region in the otherwise clause." 'matlab-tempo-tags) (defun matlab-insert-next-case () "Insert a case statement inside this switch statement." (interactive) ;; First, make sure we are where we think we are. (let ((valid t)) (save-excursion (condition-case nil (progn (matlab-backward-sexp t) (setq valid (looking-at "switch"))) (error (setq valid nil)))) (if (not valid) (error "Not in a switch statement"))) (if (not (matlab-ltype-empty)) (progn (end-of-line) (insert "\n"))) (indent-to 0) (insert "case ") (matlab-indent-line)) (tempo-define-template "matlab-function" '("function " (P "output argument(s): " output t) ;; Insert brackets only if there is more than one output argument (if (string-match "," (tempo-lookup-named 'output)) '(l "[" (s output) "]") '(l (s output))) ;; Insert equal sign only if there is output argument(s) (if (= 0 (length (tempo-lookup-named 'output))) nil " = ") ;; The name of a function, as defined in the first line, should ;; be the same as the name of the file without .m extension (if (= 1 (count-lines 1 (point))) (tempo-save-named 'fname (file-name-nondirectory (file-name-sans-extension (buffer-file-name)))) '(l (P "function name: " fname t))) (tempo-lookup-named 'fname) "(" (P "input argument(s): ") ")" n "% " (upcase (tempo-lookup-named 'fname)) " - " (P "H1 line: ") n "% " p n) "function" "Insert a MATLAB function statement" 'matlab-tempo-tags ) (defun matlab-stringify-region (begin end) "Put MATLAB 's around region, and quote all quotes in the string. Stringification allows you to type in normal MATLAB code, mark it, and then turn it into a MATLAB string that will output exactly what's in the region. BEGIN and END mark the region to be stringified." (interactive "r") (save-excursion (goto-char begin) (if (re-search-forward "\n" end t) (error "You may only stringify regions that encompass less than one line")) (let ((m (make-marker))) (move-marker m end) (goto-char begin) (insert "'") (while (re-search-forward "'" m t) (insert "'")) (goto-char m) (insert "'")))) (defun matlab-ispell-strings-region (begin end) "Spell check valid strings in region with Ispell. Argument BEGIN and END mark the region boundary." (interactive "r") (require 'ispell) (save-excursion (goto-char begin) ;; Here we use the font lock function for finding strings. ;; Its cheap, fast, and accurate. (while (and (matlab-font-lock-string-match-normal end) (ispell-region (match-beginning 2) (match-end 2)))))) (defun matlab-ispell-strings () "Spell check valid strings in the current buffer with Ispell. Calls `matlab-ispell-strings-region'" (interactive) (matlab-ispell-strings-region (point-min) (point-max))) (defun matlab-ispell-comments (&optional arg) "Spell check comments in the current buffer with Ispell. Optional ARG means to only check the current comment." (interactive "P") (let ((beg (point-min)) (end (point-max))) (if (and arg (matlab-ltype-comm)) (setq beg (save-excursion (matlab-beginning-of-command) (point)) end (save-excursion (matlab-end-of-command) (point)))) (save-excursion (goto-char beg) (beginning-of-line) (while (and (matlab-font-lock-comment-match end) (ispell-region (match-beginning 1) (match-end 1))))))) (defun matlab-generate-latex () "Convert a MATLAB M file into a Latex document for printing. Author: Uwe Brauer oub@eucmos.sim.ucm.es Created: 14 Feb 2002" (interactive "*") (save-restriction (save-excursion (goto-char (point-min)) (insert "\\documentclass[12pt]{report}\n \\usepackage{listings} \\lstloadlanguages{Matlab} \\lstset{language=Matlab,keywordstyle=\\bfseries,labelstep=1,escapechar=\\#} \\begin{document} \\begin{lstlisting}{}") (newline) (goto-char (point-max)) (insert "\n\\end{lstlisting}\n\\end{document}") (widen))) (font-lock-mode nil) (LaTeX-mode) (font-lock-mode nil)) ;;; Block highlighting ======================================================== (defvar matlab-block-highlighter-timer nil "The timer representing the block highlighter.") (defun matlab-enable-block-highlighting (&optional arg) "Start or stop the block highlighter. Optional ARG is 1 to force enable, and -1 to disable. If ARG is nil, then highlighting is toggled." (interactive "P") (if (not (fboundp 'matlab-run-with-idle-timer)) (setq matlab-highlight-block-match-flag nil)) ;; Only do it if it's enabled. (if (not matlab-highlight-block-match-flag) nil ;; Use post command idle hook as a local hook to dissuade too much ;; cpu time while doing other things. ;;(make-local-hook 'post-command-hook) (if (not arg) (setq arg (if (member 'matlab-start-block-highlight-timer post-command-hook) -1 1))) (if (> arg 0) (add-hook 'post-command-hook 'matlab-start-block-highlight-timer) (remove-hook 'post-command-hook 'matlab-start-block-highlight-timer)))) (defvar matlab-block-highlight-overlay nil "The last highlighted overlay.") (make-variable-buffer-local 'matlab-block-highlight-overlay) (defvar matlab-block-highlight-timer nil "Last started timer.") (make-variable-buffer-local 'matlab-block-highlight-timer) (defun matlab-start-block-highlight-timer () "Set up a one-shot timer if we are in MATLAB mode." (if (eq major-mode 'matlab-mode) (progn (if matlab-block-highlight-overlay (unwind-protect (matlab-delete-overlay matlab-block-highlight-overlay) (setq matlab-block-highlight-overlay nil))) (if matlab-block-highlight-timer (unwind-protect (matlab-cancel-timer matlab-block-highlight-timer) (setq matlab-block-highlight-timer nil))) (setq matlab-block-highlight-timer (matlab-run-with-idle-timer 1 nil 'matlab-highlight-block-match (current-buffer)))))) (defun matlab-highlight-block-match (&optional buff-when-launched) "Highlight a matching block if available. BUFF-WHEN-LAUNCHED is the buffer that was active when the timer was set." (setq matlab-block-highlight-timer nil) (if (null buff-when-launched) ;; We were passed a null. This indicates an old version of XEmacs ;; so just turn the feature off (setq matlab-highlight-block-match-flag nil) ;; Only do neat stuff in the same buffer as the one we were ;; initialized from. (when (and buff-when-launched (eq buff-when-launched (current-buffer))) (let ((inhibit-quit nil) ;turn on G-g (matlab-scan-on-screen-only t)) (if matlab-show-periodic-code-details-flag (matlab-show-line-info)) (if (not (matlab-cursor-in-string-or-comment)) (save-excursion (if (or (bolp) (looking-at "\\s-") (save-excursion (forward-char -1) (looking-at "\\s-"))) nil (forward-word -1)) (if (and (looking-at (concat (matlab-block-beg-re) "\\>")) (not (looking-at "function"))) (progn ;; We scan forward... (matlab-forward-sexp) (backward-word 1) (if (not (looking-at matlab-block-end-pre-if)) nil ;(message "Unterminated block, or end off screen.") (setq matlab-block-highlight-overlay (matlab-make-overlay (point) (progn (forward-word 1) (point)) (current-buffer))) (matlab-overlay-put matlab-block-highlight-overlay 'face 'matlab-region-face))) (if (and (looking-at (concat (matlab-block-end-pre) "\\>")) (not (looking-at "function")) (matlab-valid-end-construct-p)) (progn ;; We scan backward (forward-word 1) (condition-case nil (progn (matlab-backward-sexp) (if (not (looking-at (matlab-block-beg-re))) nil ;(message "Unstarted block at cursor.") (setq matlab-block-highlight-overlay (matlab-make-overlay (point) (progn (forward-word 1) (point)) (current-buffer))) (matlab-overlay-put matlab-block-highlight-overlay 'face 'matlab-region-face))) (error (message "Unstarted block at cursor.")))) ;; do nothing )))))))) ;;; M Code verification & Auto-fix ============================================ (defun matlab-mode-verify-fix-file-fn () "Verify the current buffer from `write-contents-hooks'." (if matlab-verify-on-save-flag (matlab-mode-verify-fix-file (> (point-max) matlab-block-verify-max-buffer-size))) ;; Always return nil. nil) (defun matlab-mode-verify-fix-file (&optional fast) "Verify the current buffer satisfies all M things that might be useful. We will merely loop across a list of verifiers/fixers in `matlab-mode-verify-fix-functions'. If optional FAST is non-nil, do not perform usually lengthy checks." (interactive) (let ((p (point)) (l matlab-mode-verify-fix-functions)) (while l (funcall (car l) fast) (setq l (cdr l))) (goto-char p)) (if (interactive-p) (message "Done."))) ;; ;; Add more auto verify/fix functions here! ;; (defun matlab-mode-vf-functionname (&optional fast) "Verify/Fix the function name of this file. Optional argument FAST is ignored." (matlab-navigation-syntax (goto-char (point-min)) (while (and (or (matlab-ltype-empty) (matlab-ltype-comm)) (/= (matlab-point-at-eol) (point-max))) (forward-line 1)) (let ((func nil) (bn (file-name-sans-extension (file-name-nondirectory (buffer-file-name))))) (if (looking-at (matlab-match-function-re)) ;; The expression above creates too many numeric matches ;; to apply a known one to our function. We cheat by knowing that ;; match-end 0 is at the end of the function name. We can then go ;; backwards, and get the extents we need. Navigation syntax ;; lets us know that backward-word really covers the word. (let ((end (match-end 0)) (begin (progn (goto-char (match-end 0)) (forward-word -1) (point)))) (setq func (buffer-substring begin end)) (if (not (string= func bn)) (if (not (matlab-mode-highlight-ask begin end "Function and file names are different. Fix?")) nil (goto-char begin) (delete-region begin end) (insert bn)))))))) (defun matlab-mode-vf-block-matches-forward (&optional fast) "Verify/Fix unterminated (or un-ended) blocks. This only checks block regions like if/end. Optional argument FAST causes this check to be skipped." (goto-char (point-min)) (let ((go t) (expr (concat "\\<\\(" (matlab-block-beg-pre) "\\)\\>"))) (matlab-navigation-syntax (while (and (not fast) go (re-search-forward expr nil t)) (forward-word -1) ;back over the special word (let ((s (point))) (condition-case nil (if (and (not (matlab-cursor-in-string-or-comment)) (not (looking-at "function"))) (progn (matlab-forward-sexp) (forward-word -1) (if (not (looking-at (concat matlab-block-end-pre-no-if "\\>"))) (setq go nil))) (forward-word 1)) (error (setq go nil))) (if (and (not go) (goto-char s) (not (matlab-mode-highlight-ask (point) (save-excursion (forward-word 1) (point)) "Unterminated block. Continue anyway?"))) (error "Unterminated Block found!"))) (message "Block-check: %d%%" (/ (/ (* 100 (point)) (point-max)) 2)))))) (defun matlab-mode-vf-block-matches-backward (&optional fast) "Verify/fix unstarted (or dangling end) blocks. Optional argument FAST causes this check to be skipped." (goto-char (point-max)) (let ((go t) (expr (concat "\\<\\(" (matlab-block-end-no-function-re) "\\)\\>"))) (matlab-navigation-syntax (while (and (not fast) go (re-search-backward expr nil t)) (forward-word 1) (let ((s (point))) (condition-case nil (if (and (not (matlab-cursor-in-string-or-comment)) (matlab-valid-end-construct-p)) (matlab-backward-sexp) (backward-word 1)) (error (setq go nil))) (if (and (not go) (goto-char s) (not (matlab-mode-highlight-ask (point) (save-excursion (backward-word 1) (point)) "Unstarted block. Continue anyway?"))) (error "Unstarted Block found!"))) (message "Block-check: %d%%" (+ (/ (/ (* 100 (- (point-max) (point))) (point-max)) 2) 50)))))) ;;; Utility for verify/fix actions if you need to highlight ;; a section of the buffer for the user's approval. (defun matlab-mode-highlight-ask (begin end prompt) "Highlight from BEGIN to END while asking PROMPT as a yes-no question." (let ((mo (matlab-make-overlay begin end (current-buffer))) (ans nil)) (condition-case nil (progn (matlab-overlay-put mo 'face 'matlab-region-face) (setq ans (y-or-n-p prompt)) (matlab-delete-overlay mo)) (quit (matlab-delete-overlay mo) (error "Quit"))) ans)) ;;; Quietafy an M file to remove accidental display of ANS during a run. ;; Useful if you have random outputs and you don't know where they are from, ;; or before compiling to standalone where some functions now have outputs ;; that did not have outputs earlier. ;; ;; You probably don't want this as a default verify function (defun matlab-mode-vf-quietafy-buffer (&optional fast) "Find all commands that do not end in ;, and add one. This has the effect of removing any extraneous output that may not be desired. Optional argument FAST is not used." (interactive) (save-excursion (beginning-of-buffer) (let ((msgpos 0) (dir .2)) (while (not (save-excursion (end-of-line) (eobp))) (message (aref [ "Scanning o...." "Scanning .o..." "Scanning ..o.." "Scanning ...o." "Scanning ....o" ] (floor msgpos))) (setq msgpos (+ msgpos dir)) (if (or (> msgpos 5) (< msgpos 0)) (setq dir (- dir) msgpos (+ (* 2 dir) msgpos))) (matlab-end-of-command (point)) (if (matlab-cursor-in-comment) (progn (matlab-comment-on-line) (skip-chars-backward " \t"))) (if (and (not (= (preceding-char) ?\;)) (not (matlab-cursor-in-string t)) (not (save-excursion (beginning-of-line) (looking-at "\\s-*\\(function\\|for\\|while\\|try\\|catch\\|\ switch\\|otherwise\\|case\\|break\\|if\\|else\\|end\\|return\\|disp\\|\ $\\|%\\)")))) (let ((p (point))) (skip-chars-backward " \t") (if (/= p (point)) (progn (delete-region p (point)) (forward-line -1)) (if (matlab-mode-highlight-ask (point) (+ 1 (point)) "Add Semi colon here? ") (insert ";"))))) (forward-line 1)))) (message "Scanning .... done")) ;;; V19 stuff ================================================================= (defun matlab-mode-hilit () "Set up hilit19 support for `matlab-mode'." (interactive) (cond (window-system (setq hilit-mode-enable-list '(not text-mode) hilit-background-mode 'light hilit-inhibit-hooks nil hilit-inhibit-rebinding nil) (require 'hilit19) (hilit-set-mode-patterns 'matlab-mode matlab-hilit19-patterns)))) (defvar matlab-mode-menu-keymap nil "Keymap used in MATLAB mode to provide a menu.") (defun matlab-frame-init () "Initialize Emacs 19+ menu system." (interactive) ;; make a menu keymap (easy-menu-define matlab-mode-menu matlab-mode-map "MATLAB menu" '("MATLAB" ["Start MATLAB" matlab-shell (not (matlab-with-emacs-link)) ] ["Save and go" matlab-shell-save-and-go t] ["Run Region" matlab-shell-run-region t] ["Version" matlab-show-version t] "----" ["Find M file" matlab-find-file-on-path t] ("Auto Fix" ["Verify/Fix source" matlab-mode-verify-fix-file t] ["Spell check strings" matlab-ispell-strings t] ["Spell check comments" matlab-ispell-comments t] ["Quietafy source" matlab-mode-vf-quietafy-buffer t]) ("Navigate" ["Beginning of Command" matlab-beginning-of-command t] ["End of Command" matlab-end-of-command t] ["Forward Block" matlab-forward-sexp t] ["Backward Block" matlab-backward-sexp t] ["Beginning of Function" matlab-beginning-of-defun t] ["End of Function" matlab-end-of-defun t]) ("Format" ["Justify Line" matlab-justify-line t] ["Fill Region" matlab-fill-region t] ["Fill Comment Paragraph" matlab-fill-paragraph (save-excursion (matlab-comment-on-line))] ["Join Comment" matlab-join-comment-lines (save-excursion (matlab-comment-on-line))] ["Comment Region" matlab-comment-region t] ["Uncomment Region" matlab-uncomment-region t]) ("Insert" ["Complete Symbol" matlab-complete-symbol t] ["Comment" matlab-comment t] ["if end" tempo-template-matlab-if t] ["if else end" tempo-template-matlab-if-else t] ["for end" tempo-template-matlab-for t] ["switch otherwise end" tempo-template-matlab-switch t] ["Next case" matlab-insert-next-case t] ["try catch end" tempo-template-matlab-try t] ["while end" tempo-template-matlab-while t] ["End of block" matlab-insert-end-block t] ["Function" tempo-template-matlab-function t] ["Stringify Region" matlab-stringify-region t] ) ("Customize" ; ["Auto Fill Counts Elipsis" ; (lambda () (setq matlab-fill-count-ellipsis-flag ; (not matlab-fill-count-ellipsis-flag))) ; :style toggle :selected 'matlab-fill-count-ellipsis-flag] ["Indent Function Body" (setq matlab-indent-function (not matlab-indent-function)) :style toggle :selected matlab-indent-function] ["Verify File on Save" (setq matlab-verify-on-save-flag (not matlab-verify-on-save-flag)) :style toggle :selected matlab-verify-on-save-flag] ["Auto Fill does Code" (setq matlab-fill-code (not matlab-fill-code)) :style toggle :selected matlab-fill-code ] ["Periodic Code Details" (setq matlab-show-periodic-code-details-flag (not matlab-show-periodic-code-details-flag)) :style toggle :selected matlab-show-periodic-code-details-flag ] ["Highlight Matching Blocks" (matlab-enable-block-highlighting) :style toggle :selected (member 'matlab-start-block-highlight-timer post-command-hook) ] ["Customize" (customize-group 'matlab) (and (featurep 'custom) (fboundp 'custom-declare-variable)) ] ) "----" ["Run M Command" matlab-shell-run-command (matlab-shell-active-p)] ["Describe Command" matlab-shell-describe-command (matlab-shell-active-p)] ["Describe Variable" matlab-shell-describe-variable (matlab-shell-active-p)] ["Command Apropos" matlab-shell-apropos (matlab-shell-active-p)] ["Topic Browser" matlab-shell-topic-browser (matlab-shell-active-p)] )) (easy-menu-add matlab-mode-menu matlab-mode-map)) ;;; MATLAB shell ============================================================= (defgroup matlab-shell nil "MATLAB shell mode." :prefix "matlab-shell-" :group 'matlab) (defcustom matlab-shell-command "matlab" "*The name of the command to be run which will start the MATLAB process." :group 'matlab-shell :type 'string) (defcustom matlab-shell-command-switches '() "*Command line parameters run with `matlab-shell-command'." :group 'matlab-shell :type '(list :tag "Switch: ")) (defcus