* hl-line.el (hl-line): New face.
[bpt/emacs.git] / lisp / progmodes / idlw-shell.el
1 ;; idlw-shell.el --- run IDL as an inferior process of Emacs.
2 ;; Copyright (c) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
3 ;; Free Software Foundation
4
5 ;; Authors: J.D. Smith <jdsmith@as.arizona.edu>
6 ;; Carsten Dominik <dominik@astro.uva.nl>
7 ;; Chris Chase <chase@att.com>
8 ;; Maintainer: J.D. Smith <jdsmith@as.arizona.edu>
9 ;; Version: 6.0_em22
10 ;; Keywords: processes
11
12 ;; This file is part of GNU Emacs.
13
14 ;; GNU Emacs is free software; you can redistribute it and/or modify
15 ;; it under the terms of the GNU General Public License as published by
16 ;; the Free Software Foundation; either version 2, or (at your option)
17 ;; any later version.
18
19 ;; GNU Emacs is distributed in the hope that it will be useful,
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 ;; GNU General Public License for more details.
23
24 ;; You should have received a copy of the GNU General Public License
25 ;; along with GNU Emacs; see the file COPYING. If not, write to the
26 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
27 ;; Boston, MA 02110-1301, USA.
28
29 ;;; Commentary:
30 ;;
31 ;; This mode is for IDL version 5 or later. It should work on
32 ;; Emacs>20.3 or XEmacs>20.4.
33 ;;
34 ;; Runs IDL as an inferior process of Emacs, much like the emacs
35 ;; `shell' or `telnet' commands. Provides command history and
36 ;; searching. Provides debugging commands available in buffers
37 ;; visiting IDL procedure files, e.g., breakpoint setting, stepping,
38 ;; execution until a certain line, printing expressions under point,
39 ;; visual line pointer for current execution line, etc.
40 ;;
41 ;; Documentation should be available online with `M-x idlwave-info'.
42 ;;
43 ;; New versions of IDLWAVE, documentation, and more information
44 ;; available from:
45 ;; http://idlwave.org
46 ;;
47 ;; INSTALLATION:
48 ;; =============
49 ;;
50 ;; Follow the instructions in the INSTALL file of the distribution.
51 ;; In short, put this file on your load path and add the following
52 ;; lines to your .emacs file:
53 ;;
54 ;; (autoload 'idlwave-shell "idlw-shell" "IDLWAVE Shell" t)
55 ;;
56 ;;
57 ;; SOURCE
58 ;; ======
59 ;;
60 ;; The newest version of this file can be found on the maintainers
61 ;; web site.
62 ;;
63 ;; http://idlwave.org
64 ;;
65 ;; DOCUMENTATION
66 ;; =============
67 ;;
68 ;; IDLWAVE is documented online in info format.
69 ;; A printable version of the documentation is available from the
70 ;; maintainers webpage (see under SOURCE)
71 ;;
72 ;;
73 ;; KNOWN PROBLEMS
74 ;; ==============
75 ;;
76 ;; Under XEmacs the Debug menu in the shell does not display the
77 ;; keybindings in the prefix map. There bindings are available anyway - so
78 ;; it is a bug in XEmacs.
79 ;; The Debug menu in source buffers *does* display the bindings correctly.
80 ;;
81 ;;
82 ;; CUSTOMIZATION VARIABLES
83 ;; =======================
84 ;;
85 ;; IDLWAVE has customize support - so if you want to learn about
86 ;; the variables which control the behavior of the mode, use
87 ;; `M-x idlwave-customize'.
88 ;;
89 ;;--------------------------------------------------------------------------
90 ;;
91 \f
92 ;;; Code:
93
94 (require 'comint)
95 (require 'idlwave)
96
97 (eval-when-compile (require 'cl))
98
99 (defvar idlwave-shell-have-new-custom nil)
100 (eval-and-compile
101 ;; Kludge to allow `defcustom' for Emacs 19.
102 (condition-case () (require 'custom) (error nil))
103 (if (and (featurep 'custom)
104 (fboundp 'custom-declare-variable)
105 (fboundp 'defface))
106 ;; We've got what we needed
107 (setq idlwave-shell-have-new-custom t)
108 ;; We have the old or no custom-library, hack around it!
109 (defmacro defgroup (&rest args) nil)
110 (defmacro defcustom (var value doc &rest args)
111 `(defvar ,var ,value ,doc))))
112
113 ;;; Customizations: idlwave-shell group
114
115 ;; General/Misc. customizations
116 (defgroup idlwave-shell-general-setup nil
117 "General setup of the Shell interaction for IDLWAVE/Shell."
118 :prefix "idlwave-shell"
119 :group 'idlwave)
120
121 (defcustom idlwave-shell-prompt-pattern "^\r? ?IDL> "
122 "*Regexp to match IDL prompt at beginning of a line.
123 For example, \"^\r?IDL> \" or \"^\r?WAVE> \".
124 The \"^\r?\" is needed, to indicate the beginning of the line, with
125 optional return character (which IDL seems to output randomly).
126 This variable is used to initialize `comint-prompt-regexp' in the
127 process buffer.
128
129 This is a fine thing to set in your `.emacs' file."
130 :group 'idlwave-shell-general-setup
131 :type 'regexp)
132
133 (defcustom idlwave-shell-process-name "idl"
134 "*Name to be associated with the IDL process. The buffer for the
135 process output is made by surrounding this name with `*'s."
136 :group 'idlwave-shell-general-setup
137 :type 'string)
138
139 ;; (defcustom idlwave-shell-automatic-start...) See idlwave.el
140
141 (defcustom idlwave-shell-use-dedicated-window nil
142 "*Non-nil means, never replace the shell frame with another buffer."
143 :group 'idlwave-shell-general-setup
144 :type 'boolean)
145
146 (defcustom idlwave-shell-use-dedicated-frame nil
147 "*Non-nil means, IDLWAVE should use a special frame to display shell buffer."
148 :group 'idlwave-shell-general-setup
149 :type 'boolean)
150
151 (defcustom idlwave-shell-frame-parameters
152 '((height . 30) (unsplittable . nil))
153 "The frame parameters for a dedicated idlwave-shell frame.
154 See also `idlwave-shell-use-dedicated-frame'.
155 The default makes the frame splittable, so that completion works correctly."
156 :group 'idlwave-shell-general-setup
157 :type '(repeat
158 (cons symbol sexp)))
159
160 (defcustom idlwave-shell-raise-frame t
161 "*Non-nil means, `idlwave-shell' raises the frame showing the shell window."
162 :group 'idlwave-shell-general-setup
163 :type 'boolean)
164
165 (defcustom idlwave-shell-arrows-do-history t
166 "*Non-nil means UP and DOWN arrows move through command history.
167 This variable can have 3 values:
168 nil Arrows just move the cursor
169 t Arrows force the cursor back to the current command line and
170 walk the history
171 'cmdline When the cursor is in the current command line, arrows walk the
172 history. Everywhere else in the buffer, arrows move the cursor."
173 :group 'idlwave-shell-general-setup
174 :type '(choice
175 (const :tag "never" nil)
176 (const :tag "everywhere" t)
177 (const :tag "in command line only" cmdline)))
178
179 ;; FIXME: add comint-input-ring-size?
180
181 (defcustom idlwave-shell-use-toolbar t
182 "*Non-nil means, use the debugging toolbar in all IDL related buffers.
183 Starting the shell will then add the toolbar to all idlwave-mode buffers.
184 Exiting the shell will removed everywhere.
185 Available on XEmacs and on Emacs 21.x or later.
186 At any time you can toggle the display of the toolbar with
187 `C-c C-d C-t' (`idlwave-shell-toggle-toolbar')."
188 :group 'idlwave-shell-general-setup
189 :type 'boolean)
190
191 (defcustom idlwave-shell-temp-pro-prefix "/tmp/idltemp"
192 "*The prefix for temporary IDL files used when compiling regions.
193 It should be an absolute pathname.
194 The full temporary file name is obtained by using `make-temp-file'
195 so that the name will be unique among multiple Emacs processes."
196 :group 'idlwave-shell-general-setup
197 :type 'string)
198
199 (defvar idlwave-shell-fix-inserted-breaks nil
200 "*OBSOLETE VARIABLE, is no longer used.
201
202 The documentation of this variable used to be:
203 If non-nil then run `idlwave-shell-remove-breaks' to clean up IDL messages.")
204
205 (defcustom idlwave-shell-prefix-key "\C-c\C-d"
206 "*The prefix key for the debugging map `idlwave-shell-mode-prefix-map'.
207 This variable must already be set when idlwave-shell.el is loaded.
208 Setting it in the mode-hook is too late."
209 :group 'idlwave-shell-general-setup
210 :type 'string)
211
212 (defcustom idlwave-shell-activate-prefix-keybindings t
213 "Non-nil means, the debug commands will be bound to the prefix key.
214 The prefix key itself is given in the option `idlwave-shell-prefix-key'.
215 So by default setting a breakpoint will be on C-c C-d C-b."
216 :group 'idlwave-shell-general-setup
217 :type 'boolean)
218
219 (defcustom idlwave-shell-automatic-electric-debug 'breakpoint
220 "Enter the electric-debug minor mode automatically.
221 This occurs at a breakpoint or any other halt. The mode is exited
222 upon return to the main level. Can be set to 'breakpoint to enter
223 electric debug mode only when breakpoints are tripped."
224 :group 'idlwave-shell-general-setup
225 :type '(choice
226 (const :tag "never" nil)
227 (const :tag "always" t)
228 (const :tag "for breakpoints only" breakpoint)))
229
230 (defcustom idlwave-shell-electric-zap-to-file t
231 "When entering electric debug mode, select the window displaying the
232 file at which point is stopped. This takes point away from the shell
233 window, but is useful for stepping, etc."
234 :group 'idlwave-shell-general-setup
235 :type 'boolean)
236
237 ;; (defcustom idlwave-shell-debug-modifiers... See idlwave.el
238
239 (defvar idlwave-shell-activate-alt-keybindings nil
240 "Obsolete variable. See `idlwave-shell-debug-modifiers'.")
241
242 (defcustom idlwave-shell-use-truename nil
243 "*Non-nil means, use use `file-truename' when looking for buffers.
244 If this variable is non-nil, Emacs will use the function `file-truename' to
245 resolve symbolic links in the file paths printed by e.g., STOP commands.
246 This means, unvisited files will be loaded under their truename.
247 However, when a file is already visited under a different name, IDLWAVE will
248 reuse that buffer.
249 This option was once introduced in order to avoid multiple buffers visiting
250 the same file. However, IDLWAVE no longer makes this mistake, so it is safe
251 to set this option to nil."
252 :group 'idlwave-shell-general-setup
253 :type 'boolean)
254
255 (defcustom idlwave-shell-file-name-chars "~/A-Za-z0-9+:_.$#%={}\\-"
256 "The characters allowed in file names, as a string.
257 Used for file name completion. Must not contain `'', `,' and `\"'
258 because these are used as separators by IDL."
259 :group 'idlwave-shell-general-setup
260 :type 'string)
261
262 (defcustom idlwave-shell-mode-hook '()
263 "*Hook for customising `idlwave-shell-mode'."
264 :group 'idlwave-shell-general-setup
265 :type 'hook)
266
267 (defcustom idlwave-shell-graphics-window-size '(500 400)
268 "Size of IDL graphics windows popped up by special IDLWAVE command.
269 The command is `C-c C-d C-f' and accepts as a prefix the window nr.
270 A command like `WINDOW,N,xsize=XX,ysize=YY' is sent to IDL."
271 :group 'idlwave-shell-general-setup
272 :type '(list
273 (integer :tag "x size")
274 (integer :tag "y size")))
275
276
277 ;; Commands Sent to Shell... etc.
278 (defgroup idlwave-shell-command-setup nil
279 "Setup for command parameters of the Shell interaction for IDLWAVE."
280 :prefix "idlwave-shell"
281 :group 'idlwave)
282
283 (defcustom idlwave-shell-initial-commands "!more=0 & defsysv,'!ERROR_STATE',EXISTS=__e & if __e then begin & !ERROR_STATE.MSG_PREFIX=\"% \" & delvar,__e & endif"
284 "Initial commands, separated by newlines, to send to IDL.
285 This string is sent to the IDL process by `idlwave-shell-mode' which is
286 invoked by `idlwave-shell'."
287 :group 'idlwave-shell-command-setup
288 :type 'string)
289
290 (defcustom idlwave-shell-save-command-history t
291 "Non-nil means preserve command history between sessions.
292 The file `idlwave-shell-command-history-file' is used to save and restore
293 the history."
294 :group 'idlwave-shell-command-setup
295 :type 'boolean)
296
297 (defcustom idlwave-shell-command-history-file "idlwhist"
298 "The file in which the command history of the idlwave shell is saved.
299 In order to change the size of the history, see the variable
300 `comint-input-ring-size'.
301 The history is only saved if the variable `idlwave-shell-save-command-history'
302 is non-nil."
303 :group 'idlwave-shell-command-setup
304 :type 'file)
305
306 (defcustom idlwave-shell-show-commands
307 '(run misc breakpoint)
308 "*A list of command types to show output from in the shell.
309 Possibilities are 'run, 'debug, 'breakpoint, and 'misc. Unselected
310 types are not displayed in the shell. The type 'everything causes all
311 the copious shell traffic to be displayed."
312 :group 'idlwave-shell-command-setup
313 :type '(choice
314 (const everything)
315 (set :tag "Checklist" :greedy t
316 (const :tag "All .run and .compile commands" run)
317 (const :tag "All breakpoint commands" breakpoint)
318 (const :tag "All debug and stepping commands" debug)
319 (const :tag "Close, window, retall, etc. commands" misc))))
320
321 (defcustom idlwave-shell-max-print-length 200
322 "Maximum number of array elements to print when examining."
323 :group 'idlwave-shell-command-setup
324 :type 'integer)
325
326 (defcustom idlwave-shell-examine-alist
327 `(("Print" . ,(concat "idlwave_print_safe,___,"
328 (number-to-string
329 idlwave-shell-max-print-length)))
330 ("Help" . "help,___")
331 ("Structure Help" . "help,___,/STRUCTURE")
332 ("Dimensions" . "print,size(___,/DIMENSIONS)")
333 ("Type" . "print,size(___,/TNAME)")
334 ("N_Elements" . "print,n_elements(___)")
335 ("All Size Info" . "help,(__IWsz__=size(___,/STRUCTURE)),/STRUCTURE & print,__IWsz__.DIMENSIONS")
336 ("Ptr Valid" . "print,ptr_valid(___)")
337 ("Arg Present" . "print,arg_present(___)")
338 ("Widget Valid" . "print,widget_info(___,/VALID)")
339 ("Widget Geometry" . "help,widget_info(___,/GEOMETRY)"))
340 "Alist of special examine commands for popup selection.
341 The keys are used in the selection popup created by
342 `idlwave-shell-examine-select', and the corresponding value is sent as
343 a command to the shell, with special sequence `___' replaced by the
344 expression being examined."
345 :group 'idlwave-shell-command-setup
346 :type '(repeat
347 (cons
348 (string :tag "Label ")
349 (string :tag "Command"))))
350
351 (defvar idlwave-shell-print-expression-function nil
352 "*OBSOLETE VARIABLE, is no longer used.")
353
354 (defcustom idlwave-shell-separate-examine-output t
355 "*Non-nil mean, put output of examine commands in their own buffer."
356 :group 'idlwave-shell-command-setup
357 :type 'boolean)
358
359 (defcustom idlwave-shell-comint-settings
360 '((comint-scroll-to-bottom-on-input . t)
361 (comint-scroll-to-bottom-on-output . t)
362 (comint-scroll-show-maximum-output . nil)
363 (comint-prompt-read-only . t))
364
365 "Alist of special settings for the comint variables in the IDLWAVE Shell.
366 Each entry is a cons cell with the name of a variable and a value.
367 The function `idlwave-shell-mode' will make local variables out of each entry.
368 Changes to this variable will only be active when the shell buffer is
369 newly created."
370 :group 'idlwave-shell-command-setup
371 :type '(repeat
372 (cons variable sexp)))
373
374 (defcustom idlwave-shell-query-for-class t
375 "*Non-nil means query the shell for object class on object completions."
376 :group 'idlwave-shell-command-setup
377 :type 'boolean)
378
379 (defcustom idlwave-shell-use-input-mode-magic nil
380 "*Non-nil means, IDLWAVE should check for input mode spells in output.
381 The spells are strings printed by your IDL program and matched
382 by the regular expressions in `idlwave-shell-input-mode-spells'.
383 When these expressions match, IDLWAVE switches to character input mode and
384 back, respectively. See `idlwave-shell-input-mode-spells' for details."
385 :group 'idlwave-shell-command-setup
386 :type 'boolean)
387
388 (defcustom idlwave-shell-input-mode-spells
389 '("^<onechar>$" "^<chars>$" "^</chars>$")
390 "The three regular expressions which match the magic spells for input modes.
391
392 When the first regexp matches in the output stream of IDL, IDLWAVE
393 prompts for a single character and sends it immediately to IDL, similar
394 to the command \\[idlwave-shell-send-char].
395
396 When the second regexp matches, IDLWAVE switches to a blocking
397 single-character input mode. This is the same mode which can be entered
398 manually with \\[idlwave-shell-char-mode-loop].
399 This input mode exits when the third regexp matches in the output,
400 or when the IDL prompt is encountered.
401
402 The variable `idlwave-shell-use-input-mode-magic' must be non-nil to enable
403 scanning for these expressions. If the IDL program produces lots of
404 output, shell operation may be slowed down.
405
406 This mechanism is useful for correct interaction with the IDL function
407 GET_KBRD, because in normal operation IDLWAVE only sends \\n terminated
408 strings. Here is some example code which makes use of the default spells.
409
410 print,'<chars>' ; Make IDLWAVE switch to character mode
411 REPEAT BEGIN
412 A = GET_KBRD(1)
413 PRINT, BYTE(A)
414 ENDREP UNTIL A EQ 'q'
415 print,'</chars>' ; Make IDLWAVE switch back to line mode
416
417 print,'Quit the program, y or n?'
418 print,'<onechar>' ; Ask IDLWAVE to send one character
419 answer = GET_KBRD(1)
420
421 Since the IDLWAVE shell defines the system variable `!IDLWAVE_VERSION',
422 you could actually check if you are running under Emacs before printing
423 the magic strings. Here is a procedure which uses this.
424
425 Usage:
426 ======
427 idlwave_char_input ; Make IDLWAVE send one character
428 idlwave_char_input,/on ; Start the loop to send characters
429 idlwave_char_input,/off ; End the loop to send characters
430
431
432 pro idlwave_char_input,on=on,off=off
433 ;; Test if we are running under Emacs
434 defsysv,'!idlwave_version',exists=running_emacs
435 if running_emacs then begin
436 if keyword_set(on) then print,'<chars>' $
437 else if keyword_set(off) then print,'</chars>' $
438 else print,'<onechar>'
439 endif
440 end"
441 :group 'idlwave-shell-command-setup
442 :type '(list
443 (regexp :tag "One-char regexp")
444 (regexp :tag "Char-mode regexp")
445 (regexp :tag "Line-mode regexp")))
446
447 (defcustom idlwave-shell-breakpoint-popup-menu t
448 "*If non-nil, provide a menu on mouse-3 on breakpoint lines, and
449 popup help text on the line."
450 :group 'idlwave-shell-command-setup
451 :type 'boolean)
452
453 (defcustom idlwave-shell-reset-no-prompt nil
454 "If non-nil, skip the yes/no prompt when resetting the IDL session."
455 :group 'idlwave-shell-command-setup
456 :type 'boolean)
457
458 ;; Breakpoint Overlays etc
459 (defgroup idlwave-shell-highlighting-and-faces nil
460 "Highlighting and Faces used by the IDLWAVE Shell mode."
461 :prefix "idlwave-shell"
462 :group 'idlwave)
463
464 (defcustom idlwave-shell-mark-stop-line t
465 "*Non-nil means, mark the source code line where IDL is currently stopped.
466 Value decides about the method which is used to mark the line. Valid values
467 are:
468
469 nil Do not mark the line
470 'arrow Use the overlay arrow
471 'face Use `idlwave-shell-stop-line-face' to highlight the line.
472 t Use what IDLWAVE thinks is best. Will be a face where possible,
473 otherwise the overlay arrow.
474 The overlay-arrow has the disadvantage to hide the first chars of a line.
475 Since many people do not have the main block of IDL programs indented,
476 a face highlighting may be better.
477 In Emacs 21, the overlay arrow is displayed in a special area and never
478 hides any code, so setting this to 'arrow on Emacs 21 sounds like a good idea."
479 :group 'idlwave-shell-highlighting-and-faces
480 :type '(choice
481 (const :tag "No marking" nil)
482 (const :tag "Use overlay arrow" arrow)
483 (const :tag "Highlight with face" face)
484 (const :tag "Face or arrow." t)))
485
486 (defcustom idlwave-shell-overlay-arrow ">"
487 "*The overlay arrow to display at source lines where execution halts.
488 We use a single character by default, since the main block of IDL procedures
489 often has no indentation. Where possible, IDLWAVE will use overlays to
490 display the stop-lines. The arrow is only used on character-based terminals.
491 See also `idlwave-shell-use-overlay-arrow'."
492 :group 'idlwave-shell-highlighting-and-faces
493 :type 'string)
494
495 (defcustom idlwave-shell-stop-line-face 'highlight
496 "*The face for `idlwave-shell-stop-line-overlay'.
497 Allows you to choose the font, color and other properties for
498 line where IDL is stopped. See also `idlwave-shell-mark-stop-line'."
499 :group 'idlwave-shell-highlighting-and-faces
500 :type 'symbol)
501
502 (defcustom idlwave-shell-electric-stop-color "Violet"
503 "*The color for the default face or overlay arrow when stopped."
504 :group 'idlwave-shell-highlighting-and-faces
505 :type 'string)
506
507 (defcustom idlwave-shell-electric-stop-line-face
508 (prog1
509 (copy-face 'modeline 'idlwave-shell-electric-stop-line)
510 (set-face-background 'idlwave-shell-electric-stop-line
511 idlwave-shell-electric-stop-color)
512 (condition-case nil
513 (set-face-foreground 'idlwave-shell-electric-stop-line nil)
514 (error nil)))
515 "*The face for `idlwave-shell-stop-line-overlay' when in electric debug mode.
516 Allows you to choose the font, color and other properties for the line
517 where IDL is stopped, when in Electric Debug Mode."
518 :group 'idlwave-shell-highlighting-and-faces
519 :type 'symbol)
520
521 (defcustom idlwave-shell-mark-breakpoints t
522 "*Non-nil means, mark breakpoints in the source files.
523 Valid values are:
524 nil Do not mark breakpoints.
525 'face Highlight line with `idlwave-shell-breakpoint-face'.
526 'glyph Red dot at the beginning of line. If the display does not
527 support glyphs, will use 'face instead.
528 t Glyph when possible, otherwise face (same effect as 'glyph)."
529 :group 'idlwave-shell-highlighting-and-faces
530 :type '(choice
531 (const :tag "No marking" nil)
532 (const :tag "Highlight with face" face)
533 (const :tag "Display glyph (red dot)" glyph)
534 (const :tag "Glyph or face." t)))
535
536 (defvar idlwave-shell-use-breakpoint-glyph t
537 "Obsolete variable. See `idlwave-shell-mark-breakpoints.")
538
539 (defcustom idlwave-shell-breakpoint-face 'idlwave-shell-bp
540 "*The face for breakpoint lines in the source code.
541 Allows you to choose the font, color and other properties for
542 lines which have a breakpoint. See also `idlwave-shell-mark-breakpoints'."
543 :group 'idlwave-shell-highlighting-and-faces
544 :type 'symbol)
545
546 (if (not idlwave-shell-have-new-custom)
547 ;; Just copy the underline face to be on the safe side.
548 (copy-face 'underline 'idlwave-shell-bp)
549 ;; We have the new customize - use it to define a customizable face
550 (defface idlwave-shell-bp
551 '((((class color)) (:foreground "Black" :background "Pink"))
552 (t (:underline t)))
553 "Face for highlighting lines with breakpoints."
554 :group 'idlwave-shell-highlighting-and-faces))
555
556 (defcustom idlwave-shell-disabled-breakpoint-face
557 'idlwave-shell-disabled-bp
558 "*The face for disabled breakpoint lines in the source code.
559 Allows you to choose the font, color and other properties for
560 lines which have a breakpoint. See also `idlwave-shell-mark-breakpoints'."
561 :group 'idlwave-shell-highlighting-and-faces
562 :type 'symbol)
563
564 (if (not idlwave-shell-have-new-custom)
565 ;; Just copy the underline face to be on the safe side.
566 (copy-face 'underline 'idlwave-shell-disabled-bp)
567 ;; We have the new customize - use it to define a customizable face
568 (defface idlwave-shell-disabled-bp
569 '((((class color)) (:foreground "Black" :background "gray"))
570 (t (:underline t)))
571 "Face for highlighting lines with breakpoints."
572 :group 'idlwave-shell-highlighting-and-faces))
573
574
575 (defcustom idlwave-shell-expression-face 'secondary-selection
576 "*The face for `idlwave-shell-expression-overlay'.
577 Allows you to choose the font, color and other properties for
578 the expression printed by IDL."
579 :group 'idlwave-shell-highlighting-and-faces
580 :type 'symbol)
581
582 (defcustom idlwave-shell-output-face 'secondary-selection
583 "*The face for `idlwave-shell-output-overlay'.
584 Allows you to choose the font, color and other properties for
585 the expression output by IDL."
586 :group 'idlwave-shell-highlighting-and-faces
587 :type 'symbol)
588
589 ;;; End user customization variables
590
591 ;;; External variables
592 (defvar comint-last-input-start)
593 (defvar comint-last-input-end)
594
595 ;; Other variables
596 (defvar idlwave-shell-temp-pro-file nil
597 "Absolute pathname for temporary IDL file for compiling regions")
598
599 (defvar idlwave-shell-temp-rinfo-save-file nil
600 "Absolute pathname for temporary IDL file save file for routine_info.
601 This is used to speed up the reloading of the routine info procedure
602 before use by the shell.")
603
604 (defun idlwave-shell-temp-file (type)
605 "Return a temp file, creating it if necessary.
606
607 TYPE is either 'pro' or 'rinfo', and `idlwave-shell-temp-pro-file' or
608 `idlwave-shell-temp-rinfo-save-file' is set (respectively)."
609 (cond
610 ((eq type 'rinfo)
611 (or idlwave-shell-temp-rinfo-save-file
612 (setq idlwave-shell-temp-rinfo-save-file
613 (idlwave-shell-make-temp-file idlwave-shell-temp-pro-prefix))))
614 ((eq type 'pro)
615 (or idlwave-shell-temp-pro-file
616 (setq idlwave-shell-temp-pro-file
617 (idlwave-shell-make-temp-file idlwave-shell-temp-pro-prefix))))
618 (t (error "Wrong argument (idlwave-shell-temp-file): %s"
619 (symbol-name type)))))
620
621
622 (defun idlwave-shell-make-temp-file (prefix)
623 "Create a temporary file."
624 ; Hard coded make-temp-file for Emacs<21
625 (if (fboundp 'make-temp-file)
626 (make-temp-file prefix)
627 (let (file
628 (temp-file-dir (if (boundp 'temporary-file-directory)
629 temporary-file-directory
630 "/tmp")))
631 (while (condition-case ()
632 (progn
633 (setq file
634 (make-temp-name
635 (expand-file-name prefix temp-file-dir)))
636 (if (featurep 'xemacs)
637 (write-region "" nil file nil 'silent nil)
638 (write-region "" nil file nil 'silent nil 'excl))
639 nil)
640 (file-already-exists t))
641 ;; the file was somehow created by someone else between
642 ;; `make-temp-name' and `write-region', let's try again.
643 nil)
644 file)))
645
646
647 (defvar idlwave-shell-dirstack-query "cd,current=___cur & print,___cur"
648 "Command used by `idlwave-shell-resync-dirs' to query IDL for
649 the directory stack.")
650
651 (defvar idlwave-shell-path-query "print,'PATH:<'+transpose(expand_path(!PATH,/ARRAY))+'>' & print,'SYSDIR:<'+!dir+'>'"
652
653 "The command which gets !PATH and !DIR info from the shell.")
654
655 (defvar idlwave-shell-mode-line-info nil
656 "Additional info displayed in the mode line")
657
658 (defvar idlwave-shell-default-directory nil
659 "The default directory in the idlwave-shell buffer, of outside use.")
660
661 (defvar idlwave-shell-last-save-and-action-file nil
662 "The last file which was compiled with `idlwave-shell-save-and-...'.")
663
664 ;; Highlighting uses overlays. When necessary, require the emulation.
665 (if (not (fboundp 'make-overlay))
666 (condition-case nil
667 (require 'overlay)
668 (error nil)))
669
670 (defvar idlwave-shell-stop-line-overlay nil
671 "The overlay for where IDL is currently stopped.")
672 (defvar idlwave-shell-is-stopped nil)
673 (defvar idlwave-shell-expression-overlay nil
674 "The overlay for the examined expression.")
675 (defvar idlwave-shell-output-overlay nil
676 "The overlay for the last IDL output.")
677
678 ;; If these were already overlays, delete them. This probably means that we
679 ;; are reloading this file.
680 (if (overlayp idlwave-shell-stop-line-overlay)
681 (delete-overlay idlwave-shell-stop-line-overlay))
682 (if (overlayp idlwave-shell-expression-overlay)
683 (delete-overlay idlwave-shell-expression-overlay))
684 (if (overlayp idlwave-shell-output-overlay)
685 (delete-overlay idlwave-shell-output-overlay))
686
687 ;; Set to nil initially
688 (setq idlwave-shell-stop-line-overlay nil
689 idlwave-shell-expression-overlay nil
690 idlwave-shell-output-overlay nil)
691
692 ;; Define the shell stop overlay. When left nil, the arrow will be used.
693 (cond
694 ((or (null idlwave-shell-mark-stop-line)
695 (eq idlwave-shell-mark-stop-line 'arrow))
696 ;; Leave the overlay nil
697 nil)
698
699 ((eq idlwave-shell-mark-stop-line 'face)
700 ;; Try to use a face. If not possible, arrow will be used anyway
701 ;; So who can display faces?
702 (when (or (featurep 'xemacs) ; XEmacs can do also ttys
703 (fboundp 'tty-defined-colors) ; Emacs 21 as well
704 window-system) ; Window systems always
705 (progn
706 (setq idlwave-shell-stop-line-overlay (make-overlay 1 1))
707 (overlay-put idlwave-shell-stop-line-overlay
708 'face idlwave-shell-stop-line-face))))
709
710 (t
711 ;; IDLWAVE may decide. Will use a face on window systems, arrow elsewhere
712 (if window-system
713 (progn
714 (setq idlwave-shell-stop-line-overlay (make-overlay 1 1))
715 (overlay-put idlwave-shell-stop-line-overlay
716 'face idlwave-shell-stop-line-face)))))
717
718 ;; Now the expression and output overlays
719 (setq idlwave-shell-expression-overlay (make-overlay 1 1))
720 (overlay-put idlwave-shell-expression-overlay
721 'face idlwave-shell-expression-face)
722 (overlay-put idlwave-shell-expression-overlay
723 'priority 1)
724 (setq idlwave-shell-output-overlay (make-overlay 1 1))
725 (overlay-put idlwave-shell-output-overlay
726 'face idlwave-shell-output-face)
727
728 (copy-face idlwave-shell-stop-line-face
729 'idlwave-shell-pending-stop)
730 (copy-face idlwave-shell-electric-stop-line-face
731 'idlwave-shell-pending-electric-stop)
732 (set-face-background 'idlwave-shell-pending-stop "gray70")
733 (set-face-background 'idlwave-shell-pending-electric-stop "gray70")
734
735
736
737 (defvar idlwave-shell-bp-query "help,/breakpoints"
738 "Command to obtain list of breakpoints")
739
740 (defvar idlwave-shell-command-output nil
741 "String for accumulating current command output.")
742
743 (defvar idlwave-shell-post-command-hook nil
744 "Lisp list expression or function to run when an IDL command is finished.
745 The current command is finished when the IDL prompt is displayed.
746 This is evaluated if it is a list or called with funcall.")
747
748 (defvar idlwave-shell-sentinel-hook nil
749 "Hook run when the idl process exits.")
750
751 (defvar idlwave-shell-hide-output nil
752 "If non-nil the process output is not inserted into the output
753 buffer.")
754
755 (defvar idlwave-shell-show-if-error nil
756 "If non-nil the process output is inserted into the output buffer if
757 it contains an error message, even if hide-output is non-nil.")
758
759 (defvar idlwave-shell-accumulation nil
760 "Accumulate last line of output.")
761
762 (defvar idlwave-shell-command-line-to-execute nil)
763 (defvar idlwave-shell-cleanup-hook nil
764 "List of functions to do cleanup when the shell exits.")
765
766 (defvar idlwave-shell-pending-commands nil
767 "List of commands to be sent to IDL.
768 Each element of the list is list of \(CMD PCMD HIDE\), where CMD is a
769 string to be sent to IDL and PCMD is a post-command to be placed on
770 `idlwave-shell-post-command-hook'. If HIDE is non-nil, hide the output
771 from command CMD. PCMD and HIDE are optional.")
772
773 (defun idlwave-shell-buffer ()
774 "Name of buffer associated with IDL process.
775 The name of the buffer is made by surrounding `idlwave-shell-process-name
776 with `*'s."
777 (concat "*" idlwave-shell-process-name "*"))
778
779 (defvar idlwave-shell-ready nil
780 "If non-nil can send next command to IDL process.")
781
782 ;;; The following are the types of messages we attempt to catch to
783 ;;; resync our idea of where IDL execution currently is.
784 ;;;
785
786 (defvar idlwave-shell-halt-frame nil
787 "The frame associated with halt/breakpoint messages.")
788
789 (defvar idlwave-shell-step-frame nil
790 "The frame associated with step messages.")
791
792 (defvar idlwave-shell-trace-frame nil
793 "The frame associated with trace messages.")
794
795 (defconst idlwave-shell-halt-messages
796 '("^% Interrupted at:"
797 "^% Stepped to:"
798 "^% Skipped to:"
799 "^% Stop encountered:"
800 )
801 "*A list of regular expressions matching IDL messages.
802 These are the messages containing file and line information where
803 IDL is currently stopped.")
804
805
806 (defconst idlwave-shell-halt-messages-re
807 (mapconcat 'identity idlwave-shell-halt-messages "\\|")
808 "The regular expression computed from idlwave-shell-halt-messages")
809
810 (defconst idlwave-shell-trace-message-re
811 "^% At " ;; First line of a trace message
812 "*A regular expression matching IDL trace messages. These are the
813 messages containing file and line information of a current
814 traceback.")
815
816 (defconst idlwave-shell-step-messages
817 '("^% Stepped to:"
818 )
819 "*A list of regular expressions matching stepped execution messages.
820 These are IDL messages containing file and line information where
821 IDL has currently stepped.")
822
823 (defvar idlwave-shell-break-message "^% Breakpoint at:"
824 "*Regular expression matching an IDL breakpoint message line.")
825
826 (defconst idlwave-shell-electric-debug-help
827 " ==> IDLWAVE Electric Debug Mode Help <==
828
829 Break Point Setting and Clearing:
830 b Set breakpoint ([C-u b] for conditional, [C-n b] nth hit, etc.).
831 d Clear nearby breakpoint.
832 a Clear all breakpoints.
833 i Set breakpoint in routine named here.
834 j Set breakpoint at beginning of containing routine.
835 \\ Toggle breakpoint disable
836 ] Go to next breakpoint in file.
837 [ Go to previous breakpoint in file.
838
839 Stepping, Continuing, and the Stack:
840 s or SPACE Step, into function calls.
841 n Step, over function calls.
842 k Skip one statement.
843 m Continue to end of function.
844 o Continue past end of function.
845 u Continue to end of block.
846 h Continue to line at cursor position.
847 r Continue execution to next breakpoint, if any.
848 + or = Show higher level in calling stack.
849 - or _ Show lower level in calling stack.
850
851 Examining Expressions (with prefix for examining the region):
852 p Print expression near point or in region ([C-u p]).
853 ? Help on expression near point or in region ([C-u ?]).
854 x Examine expression near point or in region ([C-u x]) with
855 letter completion of the examine type.
856 e Prompt for an expression to print.
857
858 Miscellaneous:
859 q Quit - end debugging session and return to the Shell's main level.
860 v Turn Electric Debugging Mode off (C-c C-d C-v to return).
861 t Print a calling-level traceback in the shell.
862 z Reset IDL.
863 C-? Show this help menu.")
864
865 (defvar idlwave-shell-bp-alist)
866 ;(defvar idlwave-shell-post-command-output)
867 (defvar idlwave-shell-sources-alist)
868 (defvar idlwave-shell-menu-def)
869 (defvar idlwave-shell-mode-menu)
870 (defvar idlwave-shell-initial-commands)
871 (defvar idlwave-shell-syntax-error)
872 (defvar idlwave-shell-other-error)
873 (defvar idlwave-shell-error-buffer)
874 (defvar idlwave-shell-error-last)
875 (defvar idlwave-shell-bp-buffer)
876 (defvar idlwave-shell-sources-query)
877 (defvar idlwave-shell-mode-map)
878 (defvar idlwave-shell-calling-stack-index)
879 (defvar idlwave-shell-only-prompt-pattern nil)
880 (defvar tool-bar-map)
881
882 (defun idlwave-shell-mode ()
883 "Major mode for interacting with an inferior IDL process.
884
885 1. Shell Interaction
886 -----------------
887 RET after the end of the process' output sends the text from the
888 end of process to the end of the current line. RET before end of
889 process output copies the current line (except for the prompt) to the
890 end of the buffer.
891
892 Command history, searching of previous commands, command line
893 editing are available via the comint-mode key bindings, by default
894 mostly on the key `C-c'. Command history is also available with
895 the arrow keys UP and DOWN.
896
897 2. Completion
898 ----------
899 TAB and M-TAB do completion of IDL routines, classes and keywords -
900 similar to M-TAB in `idlwave-mode'. In executive commands and
901 strings, it completes file names. Abbreviations are also expanded
902 like in `idlwave-mode'.
903
904 3. Routine Info
905 ------------
906 `\\[idlwave-routine-info]' displays information about an IDL routine near point,
907 just like in `idlwave-mode'. The module used is the one at point or
908 the one whose argument list is being edited.
909 To update IDLWAVE's knowledge about compiled or edited modules, use
910 \\[idlwave-update-routine-info].
911 \\[idlwave-find-module] find the source of a module.
912 \\[idlwave-resolve] tells IDL to compile an unresolved module.
913 \\[idlwave-context-help] shows the online help on the item at
914 point, if online help has been installed.
915
916
917 4. Debugging
918 ---------
919 A complete set of commands for compiling and debugging IDL programs
920 is available from the menu. Also keybindings starting with a
921 `C-c C-d' prefix are available for most commands in the *idl* buffer
922 and also in source buffers. The best place to learn about the
923 keybindings is again the menu.
924
925 On Emacs versions where this is possible, a debugging toolbar is
926 installed.
927
928 When IDL is halted in the middle of a procedure, the corresponding
929 line of that procedure file is displayed with an overlay in another
930 window. Breakpoints are also highlighted in the source.
931
932 \\[idlwave-shell-resync-dirs] queries IDL in order to change Emacs current directory
933 to correspond to the IDL process current directory.
934
935 5. Expression Examination
936 ----------------------
937
938 Expressions near point can be examined with print,
939 \\[idlwave-shell-print] or \\[idlwave-shell-mouse-print] with the
940 mouse, help, \\[idlwave-shell-help-expression] or
941 \\[idlwave-shell-mouse-help] with the mouse, or with a
942 configureable set of custom examine commands using
943 \\[idlwave-shell-examine-select]. The mouse examine commands can
944 also work by click and drag, to select an expression for
945 examination.
946
947 6. Hooks
948 -----
949 Turning on `idlwave-shell-mode' runs `comint-mode-hook' and
950 `idlwave-shell-mode-hook' (in that order).
951
952 7. Documentation and Customization
953 -------------------------------
954 Info documentation for this package is available. Use \\[idlwave-info]
955 to display (complain to your sysadmin if that does not work).
956 For Postscript and HTML versions of the documentation, check IDLWAVE's
957 homepage at `http://idlwave.org'.
958 IDLWAVE has customize support - see the group `idlwave'.
959
960 8. Keybindings
961 -----------
962 \\{idlwave-shell-mode-map}"
963
964 (interactive)
965 (idlwave-setup) ; Make sure config files and paths, etc. are available.
966 (unless (file-name-absolute-p idlwave-shell-command-history-file)
967 (setq idlwave-shell-command-history-file
968 (expand-file-name idlwave-shell-command-history-file
969 idlwave-config-directory)))
970
971 ;; We don't do `kill-all-local-variables' here, because this is done by
972 ;; comint
973 (setq comint-prompt-regexp idlwave-shell-prompt-pattern)
974 (setq comint-process-echoes t)
975
976 ;; Can not use history expansion because "!" is used for system variables.
977 (setq comint-input-autoexpand nil)
978 ; (setq comint-input-ring-size 64)
979 (make-local-variable 'comint-completion-addsuffix)
980 (set (make-local-variable 'completion-ignore-case) t)
981 (setq comint-completion-addsuffix '("/" . ""))
982 (setq comint-input-ignoredups t)
983 (setq major-mode 'idlwave-shell-mode)
984 (setq mode-name "IDL-Shell")
985 (setq idlwave-shell-mode-line-info nil)
986 (setq mode-line-format
987 '(""
988 mode-line-modified
989 mode-line-buffer-identification
990 " "
991 global-mode-string
992 " %[("
993 mode-name
994 mode-line-process
995 minor-mode-alist
996 "%n"
997 ")%]-"
998 idlwave-shell-mode-line-info
999 "---"
1000 (line-number-mode "L%l--")
1001 (column-number-mode "C%c--")
1002 (-3 . "%p")
1003 "-%-"))
1004 ;; (make-local-variable 'idlwave-shell-bp-alist)
1005 (setq idlwave-shell-halt-frame nil
1006 idlwave-shell-trace-frame nil
1007 idlwave-shell-command-output nil
1008 idlwave-shell-step-frame nil)
1009 (idlwave-shell-display-line nil)
1010 (setq idlwave-shell-calling-stack-index 0)
1011 (setq idlwave-shell-only-prompt-pattern
1012 (concat "\\`[ \t\n]*"
1013 (substring idlwave-shell-prompt-pattern 1)
1014 "[ \t\n]*\\'"))
1015
1016 (when idlwave-shell-query-for-class
1017 (add-to-list (make-local-variable 'idlwave-determine-class-special)
1018 'idlwave-shell-get-object-class)
1019 (setq idlwave-store-inquired-class t))
1020
1021 ;; Make sure comint-last-input-end does not go to beginning of
1022 ;; buffer (in case there were other processes already in this buffer).
1023 (set-marker comint-last-input-end (point))
1024 (setq idlwave-idlwave_routine_info-compiled nil)
1025 (setq idlwave-shell-ready nil)
1026 (setq idlwave-shell-bp-alist nil)
1027 (idlwave-shell-update-bp-overlays) ; Throw away old overlays
1028 (setq idlwave-shell-sources-alist nil)
1029 (setq idlwave-shell-default-directory default-directory)
1030 (setq idlwave-shell-hide-output nil)
1031
1032 ;; NB: `make-local-hook' needed for older/alternative Emacs compatibility
1033 ;; (make-local-hook 'kill-buffer-hook)
1034 (add-hook 'kill-buffer-hook 'idlwave-shell-kill-shell-buffer-confirm
1035 nil 'local)
1036 (add-hook 'kill-buffer-hook 'idlwave-shell-delete-temp-files nil 'local)
1037 (add-hook 'kill-emacs-hook 'idlwave-shell-delete-temp-files)
1038 (use-local-map idlwave-shell-mode-map)
1039 (easy-menu-add idlwave-shell-mode-menu idlwave-shell-mode-map)
1040
1041 ;; Set the optional comint variables
1042 (when idlwave-shell-comint-settings
1043 (let ((list idlwave-shell-comint-settings) entry)
1044 (while (setq entry (pop list))
1045 (set (make-local-variable (car entry)) (cdr entry)))))
1046
1047
1048 (unless (memq 'comint-carriage-motion
1049 (default-value 'comint-output-filter-functions))
1050 ;; Strip those pesky ctrl-m's.
1051 (add-hook 'comint-output-filter-functions
1052 (lambda (string)
1053 (when (string-match "\r" string)
1054 (let ((pmark (process-mark (get-buffer-process
1055 (current-buffer)))))
1056 (save-excursion
1057 ;; bare CR -> delete preceding line
1058 (goto-char comint-last-output-start)
1059 (while (search-forward "\r" pmark t)
1060 (delete-region (point) (line-beginning-position)))))))
1061 'append 'local)
1062 (add-hook 'comint-output-filter-functions 'comint-strip-ctrl-m nil 'local))
1063
1064 ;; Python-mode, bundled with many Emacs installs, quite cavalierly
1065 ;; adds this function to the global default hook. It interferes
1066 ;; with overlay-arrows.
1067 (remove-hook 'comint-output-filter-functions 'py-pdbtrack-track-stack-file)
1068
1069
1070 ;; IDLWAVE syntax, and turn on abbreviations
1071 (setq local-abbrev-table idlwave-mode-abbrev-table)
1072 (set-syntax-table idlwave-mode-syntax-table)
1073 (set (make-local-variable 'comment-start) ";")
1074 (setq abbrev-mode t)
1075
1076 ;; NB: `make-local-hook' needed for older/alternative Emacs compatibility
1077 ;; make-local-hook 'post-command-hook)
1078 (add-hook 'post-command-hook 'idlwave-command-hook nil t)
1079
1080 ;; Read the command history?
1081 (when (and idlwave-shell-save-command-history
1082 (stringp idlwave-shell-command-history-file))
1083 (set (make-local-variable 'comint-input-ring-file-name)
1084 idlwave-shell-command-history-file)
1085 (if (file-regular-p idlwave-shell-command-history-file)
1086 (comint-read-input-ring)))
1087
1088 ;; Turn off the non-debug toolbar buttons (open,save,etc.)
1089 (set (make-local-variable 'tool-bar-map) nil)
1090
1091 ;; Run the hooks.
1092 (run-mode-hooks 'idlwave-shell-mode-hook)
1093 (idlwave-shell-send-command idlwave-shell-initial-commands nil 'hide)
1094 ;; Turn off IDL's ^d interpreting, and define a system
1095 ;; variable which knows the version of IDLWAVE
1096 (idlwave-shell-send-command
1097 (format "defsysv,'!idlwave_version','%s',1" idlwave-mode-version)
1098 nil 'hide)
1099 ;; Read the paths, and save if they changed
1100 (idlwave-shell-send-command idlwave-shell-path-query
1101 'idlwave-shell-get-path-info
1102 'hide))
1103
1104 (defvar idlwave-system-directory)
1105 (defun idlwave-shell-get-path-info (&optional no-write)
1106 "Get the path lists, writing to file unless NO-WRITE is set."
1107 (let* ((rpl (idlwave-shell-path-filter))
1108 (sysdir (car rpl))
1109 (dirs (cdr rpl))
1110 (old-path-alist idlwave-path-alist)
1111 (old-sys-dir idlwave-system-directory)
1112 path-changed sysdir-changed)
1113 (when sysdir
1114 (setq idlwave-system-directory sysdir)
1115 (if (setq sysdir-changed
1116 (not (string= idlwave-system-directory old-sys-dir)))
1117 (put 'idlwave-system-directory 'from-shell t)))
1118 ;; Preserve any existing flags
1119 (setq idlwave-path-alist
1120 (mapcar (lambda (x)
1121 (let ((old-entry (assoc x old-path-alist)))
1122 (if old-entry
1123 (cons x (cdr old-entry))
1124 (list x))))
1125 dirs))
1126 (if (setq path-changed (not (equal idlwave-path-alist old-path-alist)))
1127 (put 'idlwave-path-alist 'from-shell t))
1128 (if idlwave-path-alist
1129 (if (and (not no-write)
1130 idlwave-auto-write-paths
1131 (or sysdir-changed path-changed)
1132 (not idlwave-library-path))
1133 (idlwave-write-paths))
1134 ;; Fall back
1135 (setq idlwave-path-alist old-path-alist))))
1136
1137 (if (not (fboundp 'idl-shell))
1138 (fset 'idl-shell 'idlwave-shell))
1139
1140 (defvar idlwave-shell-idl-wframe nil
1141 "Frame for displaying the idl shell window.")
1142 (defvar idlwave-shell-display-wframe nil
1143 "Frame for displaying the idl source files.")
1144
1145 (defvar idlwave-shell-calling-stack-index 0)
1146 (defvar idlwave-shell-calling-stack-routine nil)
1147
1148 (defun idlwave-shell-source-frame ()
1149 "Return the frame to be used for source display."
1150 (if idlwave-shell-use-dedicated-frame
1151 ;; We want separate frames for source and shell
1152 (if (frame-live-p idlwave-shell-display-wframe)
1153 ;; The frame exists, so we use it.
1154 idlwave-shell-display-wframe
1155 ;; The frame does not exist. We use the current frame.
1156 ;; However, if the current is the shell frame, we make a new frame,
1157 ;; or recycle the first existing visible frame
1158 (setq idlwave-shell-display-wframe
1159 (if (eq (selected-frame) idlwave-shell-idl-wframe)
1160 (or
1161 (let ((flist (visible-frame-list))
1162 (frame (selected-frame)))
1163 (catch 'exit
1164 (while flist
1165 (if (not (eq (car flist)
1166 idlwave-shell-idl-wframe))
1167 (throw 'exit (car flist))
1168 (setq flist (cdr flist))))))
1169 (make-frame))
1170 (selected-frame))))))
1171
1172 (defun idlwave-shell-shell-frame ()
1173 "Return the frame to be used for the shell buffer."
1174 (if idlwave-shell-use-dedicated-frame
1175 ;; We want a dedicated frame
1176 (if (frame-live-p idlwave-shell-idl-wframe)
1177 ;; It does exist, so we use it.
1178 idlwave-shell-idl-wframe
1179 ;; It does not exist. Check if we have a source frame.
1180 (if (not (frame-live-p idlwave-shell-display-wframe))
1181 ;; We do not have a source frame, so we use this one.
1182 (setq idlwave-shell-display-wframe (selected-frame)))
1183 ;; Return a new frame
1184 (setq idlwave-shell-idl-wframe
1185 (make-frame idlwave-shell-frame-parameters)))))
1186
1187 ;;;###autoload
1188 (defun idlwave-shell (&optional arg quick)
1189 "Run an inferior IDL, with I/O through buffer `(idlwave-shell-buffer)'.
1190 If buffer exists but shell process is not running, start new IDL.
1191 If buffer exists and shell process is running, just switch to the buffer.
1192
1193 When called with a prefix ARG, or when `idlwave-shell-use-dedicated-frame'
1194 is non-nil, the shell buffer and the source buffers will be in
1195 separate frames.
1196
1197 The command to run comes from variable `idlwave-shell-explicit-file-name',
1198 with options taken from `idlwave-shell-command-line-options'.
1199
1200 The buffer is put in `idlwave-shell-mode', providing commands for sending
1201 input and controlling the IDL job. See help on `idlwave-shell-mode'.
1202 See also the variable `idlwave-shell-prompt-pattern'.
1203
1204 \(Type \\[describe-mode] in the shell buffer for a list of commands.)"
1205 (interactive "P")
1206 (if (eq arg 'quick)
1207 (progn
1208 (let ((idlwave-shell-use-dedicated-frame nil))
1209 (idlwave-shell nil)
1210 (delete-other-windows))
1211 (and idlwave-shell-use-dedicated-frame
1212 (setq idlwave-shell-idl-wframe (selected-frame)))
1213 (add-hook 'idlwave-shell-sentinel-hook
1214 'save-buffers-kill-emacs t))
1215
1216 ;; A non-nil arg means, we want a dedicated frame. This will last
1217 ;; for the current editing session.
1218 (if arg (setq idlwave-shell-use-dedicated-frame t))
1219 (if (equal arg '(16)) (setq idlwave-shell-use-dedicated-frame nil))
1220
1221 ;; Check if the process still exists. If not, create it.
1222 (unless (comint-check-proc (idlwave-shell-buffer))
1223 (let* ((prg (or idlwave-shell-explicit-file-name "idl"))
1224 (buf (apply 'make-comint
1225 idlwave-shell-process-name prg nil
1226 (if (stringp idlwave-shell-command-line-options)
1227 (idlwave-split-string
1228 idlwave-shell-command-line-options)
1229 idlwave-shell-command-line-options)))
1230 (process (get-buffer-process buf)))
1231 (setq idlwave-idlwave_routine_info-compiled nil)
1232 (set-process-filter process 'idlwave-shell-filter)
1233 (set-process-sentinel process 'idlwave-shell-sentinel)
1234 (set-buffer buf)
1235 (idlwave-shell-mode)))
1236 (let ((window (idlwave-display-buffer (idlwave-shell-buffer) nil
1237 (idlwave-shell-shell-frame)))
1238 (current-window (selected-window)))
1239 (select-window window)
1240 (goto-char (point-max))
1241 (if idlwave-shell-use-dedicated-window
1242 (set-window-dedicated-p window t))
1243 (select-window current-window)
1244 (if idlwave-shell-ready
1245 (raise-frame (window-frame window)))
1246 (if (eq (selected-frame) (window-frame window))
1247 (select-window window))))
1248 ;; Save the paths at the end, if they are from the Shell and new.
1249 (add-hook 'idlwave-shell-sentinel-hook
1250 (lambda ()
1251 (if (and
1252 idlwave-auto-write-paths
1253 idlwave-path-alist
1254 (not idlwave-library-path)
1255 (get 'idlwave-path-alist 'from-shell))
1256 (idlwave-write-paths)))))
1257
1258 (defun idlwave-shell-recenter-shell-window (&optional arg)
1259 "Run `idlwave-shell', but make sure the current window stays selected."
1260 (interactive "P")
1261 (let ((window (selected-window)))
1262 (idlwave-shell arg)
1263 (select-window window)))
1264
1265 (defun idlwave-shell-hide-p (type &optional list)
1266 "Whether to hide this type of command.
1267 Return either nil or 'hide."
1268 (let ((list (or list idlwave-shell-show-commands)))
1269 (if (listp list)
1270 (if (not (memq type list)) 'hide))))
1271
1272 (defun idlwave-shell-add-or-remove-show (type)
1273 "Add or remove a show command from the list."
1274 (if (listp idlwave-shell-show-commands)
1275 (setq idlwave-shell-show-commands
1276 (if (memq type idlwave-shell-show-commands)
1277 (delq type idlwave-shell-show-commands)
1278 (add-to-list'idlwave-shell-show-commands type)))
1279 (setq idlwave-shell-show-commands (list type))))
1280
1281
1282 (defun idlwave-shell-send-command (&optional cmd pcmd hide preempt
1283 show-if-error)
1284 "Send a command to IDL process.
1285
1286 \(CMD PCMD HIDE\) are placed at the end of `
1287 idlwave-shell-pending-commands'. If IDL is ready the first command,
1288 CMD, in `idlwave-shell-pending-commands' is sent to the IDL process.
1289
1290 If optional second argument PCMD is non-nil it will be placed on
1291 `idlwave-shell-post-command-hook' when CMD is executed.
1292
1293 If the optional third argument HIDE is non-nil, then hide output from
1294 CMD, unless it is the symbol 'mostly, in which case only output
1295 beginning with \"%\" is hidden, and all other output (i.e., the
1296 results of a PRINT command), is shown. This helps with, e.g.,
1297 stepping through code with output.
1298
1299 If optional fourth argument PREEMPT is non-nil CMD is put at front of
1300 `idlwave-shell-pending-commands'. If PREEMPT is 'wait, wait for all
1301 output to complete and the next prompt to arrive before returning
1302 \(useful if you need an answer now\). IDL is considered ready if the
1303 prompt is present and if `idlwave-shell-ready' is non-nil.
1304
1305 If SHOW-IF-ERROR is non-nil, show the output it it contains an error
1306 message, independent of what HIDE is set to."
1307
1308 ; (setq hide nil) ; FIXME: turn this on for debugging only
1309 ; (if (null cmd)
1310 ; (progn
1311 ; (message "SENDING Pending commands: %s"
1312 ; (prin1-to-string idlwave-shell-pending-commands)))
1313 ; (message "SENDING %s|||%s" cmd pcmd))
1314 (if (and (symbolp idlwave-shell-show-commands)
1315 (eq idlwave-shell-show-commands 'everything))
1316 (setq hide nil))
1317 (let ((save-buffer (current-buffer))
1318 buf proc)
1319 ;; Get or make the buffer and its process
1320 (if (or (not (setq buf (get-buffer (idlwave-shell-buffer))))
1321 (not (setq proc (get-buffer-process buf))))
1322 (if (not idlwave-shell-automatic-start)
1323 (error
1324 (substitute-command-keys
1325 "You need to first start an IDL shell with \\[idlwave-shell]"))
1326 (idlwave-shell-recenter-shell-window)
1327 (setq buf (get-buffer (idlwave-shell-buffer)))
1328 (if (or (not (setq buf (get-buffer (idlwave-shell-buffer))))
1329 (not (setq proc (get-buffer-process buf))))
1330 ;; Still nothing
1331 (error "Problem with autostarting IDL shell"))))
1332 (when (or cmd idlwave-shell-pending-commands)
1333 (set-buffer buf)
1334 ;; To make this easy, always push CMD onto pending commands
1335 (if cmd
1336 (setq idlwave-shell-pending-commands
1337 (if preempt
1338 ;; Put at front.
1339 (append (list (list cmd pcmd hide show-if-error))
1340 idlwave-shell-pending-commands)
1341 ;; Put at end.
1342 (append idlwave-shell-pending-commands
1343 (list (list cmd pcmd hide show-if-error))))))
1344 ;; Check if IDL ready
1345 (let ((save-point (point-marker)))
1346 (goto-char (process-mark proc))
1347 (if (and idlwave-shell-ready
1348 ;; Check for IDL prompt
1349 (prog2
1350 (forward-line 0)
1351 ;; (beginning-of-line) ; Changed for Emacs 21
1352 (looking-at idlwave-shell-prompt-pattern)
1353 (goto-char (process-mark proc))))
1354 ;; IDL ready for command, execute it
1355 (let* ((lcmd (car idlwave-shell-pending-commands))
1356 (cmd (car lcmd))
1357 (pcmd (nth 1 lcmd))
1358 (hide (nth 2 lcmd))
1359 (show-if-error (nth 3 lcmd)))
1360 ;; If this is an executive command, reset the stack pointer
1361 (if (eq (string-to-char cmd) ?.)
1362 (setq idlwave-shell-calling-stack-index 0))
1363 ;; Set post-command
1364 (setq idlwave-shell-post-command-hook pcmd)
1365 ;; Output hiding
1366 (setq idlwave-shell-hide-output hide)
1367 ;;Showing errors
1368 (setq idlwave-shell-show-if-error show-if-error)
1369 ;; Pop command
1370 (setq idlwave-shell-pending-commands
1371 (cdr idlwave-shell-pending-commands))
1372 ;; Send command for execution
1373 (set-marker comint-last-input-start (point))
1374 (set-marker comint-last-input-end (point))
1375 (comint-simple-send proc cmd)
1376 (setq idlwave-shell-ready nil)
1377 (if (equal preempt 'wait) ; Get all the output at once
1378 (while (not idlwave-shell-ready)
1379 (when (not (accept-process-output proc 6)) ; long wait
1380 (setq idlwave-shell-pending-commands nil)
1381 (error "Process timed out"))))))
1382 (goto-char save-point))
1383 (set-buffer save-buffer))))
1384
1385 (defun idlwave-shell-send-char (c &optional error)
1386 "Send one character to the shell, without a newline."
1387 (interactive "cChar to send to IDL: \np")
1388 (let ((errf (if error 'error 'message))
1389 buf proc)
1390 (if (or (not (setq buf (get-buffer (idlwave-shell-buffer))))
1391 (not (setq proc (get-buffer-process buf))))
1392 (funcall errf "Shell is not running"))
1393 (if (equal c ?\C-g)
1394 (funcall errf "Abort")
1395 (comint-send-string proc (char-to-string c)))))
1396
1397 (defvar idlwave-shell-char-mode-active)
1398 (defun idlwave-shell-input-mode-magic (string)
1399 "Check STRING for magic words and toggle character input mode.
1400 See also the variable `idlwave-shell-input-mode-spells'."
1401 (cond
1402 ((string-match (car idlwave-shell-input-mode-spells) string)
1403 (call-interactively 'idlwave-shell-send-char))
1404 ((and (boundp 'idlwave-shell-char-mode-active)
1405 (string-match (nth 2 idlwave-shell-input-mode-spells) string))
1406 (setq idlwave-shell-char-mode-active 'exit))
1407 ((string-match (nth 1 idlwave-shell-input-mode-spells) string)
1408 ;; Set a timer which will soon start the character loop
1409 (if (fboundp 'start-itimer)
1410 (start-itimer "IDLWAVE Char Mode" 'idlwave-shell-char-mode-loop 0.5
1411 nil nil t 'no-error)
1412 (run-at-time 0.5 nil 'idlwave-shell-char-mode-loop 'no-error)))))
1413
1414 (defvar keyboard-quit)
1415 (defun idlwave-shell-char-mode-loop (&optional no-error)
1416 "Enter a loop which accepts single characters and sends them to IDL.
1417 Characters are sent one by one, without newlines. The loop is blocking
1418 and intercepts all input events to Emacs. You can use this command
1419 to interact with the IDL command GET_KBRD.
1420 The loop can be aborted by typing `C-g'. The loop also exits automatically
1421 when the IDL prompt gets displayed again after the current IDL command."
1422 (interactive)
1423
1424 ;; First check if there is a shell waiting for input
1425 (let ((idlwave-shell-char-mode-active t)
1426 (errf (if no-error 'message 'error))
1427 buf proc c)
1428 (if (or (not (setq buf (get-buffer (idlwave-shell-buffer))))
1429 (not (setq proc (get-buffer-process buf))))
1430 (funcall errf "Shell is not running"))
1431 (if idlwave-shell-ready
1432 (funcall errf "No IDL program seems to be waiting for input"))
1433
1434 ;; OK, start the loop
1435 (message "Character mode on: Sending single chars (`C-g' to exit)")
1436 (message
1437 (catch 'exit
1438 (while t
1439 ;; Wait for input
1440 ;; FIXME: Is it too dangerous to inhibit quit here?
1441 (let ((inhibit-quit t))
1442 ;; We wait and check frequently if we should abort
1443 (while (sit-for 0.3)
1444 (and idlwave-shell-ready
1445 (throw 'exit "Character mode off (prompt displayed)"))
1446 (and (eq idlwave-shell-char-mode-active 'exit)
1447 (throw 'exit "Character mode off (closing spell incantation)")))
1448 ;; Interpret input as a character - ignore non-char input
1449 (condition-case nil
1450 (setq c (read-char))
1451 (error (ding) (throw 'exit "Character mode off")))
1452 (cond
1453 ((null c) ; Non-char event: ignore
1454 (ding))
1455 ((equal c ?\C-g) ; Abort the loop
1456 (setq keyboard-quit nil)
1457 (ding)
1458 (throw 'exit "Character mode off (keyboard quit)"))
1459 (t ; Send the character and continue the loop
1460 (comint-send-string proc (char-to-string c))))
1461 (and (eq idlwave-shell-char-mode-active 'exit)
1462 (throw 'exit "Single char loop exited"))))))))
1463
1464 (defun idlwave-shell-move-or-history (up &optional arg)
1465 "When in last line of process buffer, do `comint-previous-input'.
1466 Otherwise just move the line. Move down unless UP is non-nil."
1467 (let* ((proc-pos (marker-position
1468 (process-mark (get-buffer-process (current-buffer)))))
1469 (arg (or arg 1))
1470 (arg (if up arg (- arg))))
1471 (if (eq t idlwave-shell-arrows-do-history) (goto-char proc-pos))
1472 (if (and idlwave-shell-arrows-do-history
1473 (>= (1+ (save-excursion (end-of-line) (point))) proc-pos))
1474 (comint-previous-input arg)
1475 (previous-line arg))))
1476
1477 (defun idlwave-shell-up-or-history (&optional arg)
1478 "When in last line of process buffer, move to previous input.
1479 Otherwise just go up one line."
1480 (interactive "p")
1481 (idlwave-shell-move-or-history t arg))
1482
1483 (defun idlwave-shell-down-or-history (&optional arg)
1484 "When in last line of process buffer, move to next input.
1485 Otherwise just go down one line."
1486 (interactive "p")
1487 (idlwave-shell-move-or-history nil arg))
1488
1489 ;; Newer versions of comint.el changed the name of comint-filter to
1490 ;; comint-output-filter.
1491 (defun idlwave-shell-comint-filter (process string) nil)
1492 (if (fboundp 'comint-output-filter)
1493 (fset 'idlwave-shell-comint-filter (symbol-function 'comint-output-filter))
1494 (fset 'idlwave-shell-comint-filter (symbol-function 'comint-filter)))
1495
1496 (defun idlwave-shell-is-running ()
1497 "Return t if the shell process is running."
1498 (eq (process-status idlwave-shell-process-name) 'run))
1499
1500 (defun idlwave-shell-filter-hidden-output (output)
1501 "Filter hidden output, leaving the good stuff.
1502
1503 Remove everything to the first newline, and all lines with % in front
1504 of them, with optional follow-on lines starting with two spaces. This
1505 works well enough, since any print output typically arrives before
1506 error messages, etc."
1507 (setq output (substring output (string-match "\n" output)))
1508 (while (string-match "\\(\n\\|\\`\\)%.*\\(\n .*\\)*" output)
1509 (setq output (replace-match "" nil t output)))
1510 (unless
1511 (string-match idlwave-shell-only-prompt-pattern output)
1512 output))
1513
1514 (defvar idlwave-shell-hidden-output-buffer " *idlwave-shell-hidden-output*"
1515 "Buffer containing hidden output from IDL commands.")
1516 (defvar idlwave-shell-current-state nil)
1517
1518 (defun idlwave-shell-filter (proc string)
1519 "Watch for IDL prompt and filter incoming text.
1520 When the IDL prompt is received executes `idlwave-shell-post-command-hook'
1521 and then calls `idlwave-shell-send-command' for any pending commands."
1522 ;; We no longer do the cleanup here - this is done by the process sentinel
1523 (if (eq (process-status idlwave-shell-process-name) 'run)
1524 ;; OK, process is still running, so we can use it.
1525 (let ((data (match-data)) p full-output)
1526 (unwind-protect
1527 (progn
1528 ;; Ring the bell if necessary
1529 (while (setq p (string-match "\C-G" string))
1530 (ding)
1531 (aset string p ?\C-j ))
1532 (if idlwave-shell-hide-output
1533 (save-excursion
1534 (while (setq p (string-match "\C-M" string))
1535 (aset string p ?\ ))
1536 (set-buffer
1537 (get-buffer-create idlwave-shell-hidden-output-buffer))
1538 (goto-char (point-max))
1539 (insert string))
1540 (idlwave-shell-comint-filter proc string))
1541 ;; Watch for magic - need to accumulate the current line
1542 ;; since it may not be sent all at once.
1543 (if (string-match "\n" string)
1544 (progn
1545 (if idlwave-shell-use-input-mode-magic
1546 (idlwave-shell-input-mode-magic
1547 (concat idlwave-shell-accumulation string)))
1548 (setq idlwave-shell-accumulation
1549 (substring string
1550 (progn (string-match "\\(.*[\n\r]+\\)*"
1551 string)
1552 (match-end 0)))))
1553 (setq idlwave-shell-accumulation
1554 (concat idlwave-shell-accumulation string)))
1555
1556
1557 ;;; Test/Debug code
1558 ;(with-current-buffer
1559 ; (get-buffer-create "*idlwave-shell-output*")
1560 ; (goto-char (point-max))
1561 ; (insert "\nReceived STRING\n===>\n" string "\n<====\n"))
1562
1563 ;; Check for prompt in current accumulating output
1564 (when (setq idlwave-shell-ready
1565 (string-match idlwave-shell-prompt-pattern
1566 idlwave-shell-accumulation))
1567 ;; Gather the command output
1568 (if idlwave-shell-hide-output
1569 (save-excursion
1570 (set-buffer idlwave-shell-hidden-output-buffer)
1571 (setq full-output (buffer-string))
1572 (goto-char (point-max))
1573 (re-search-backward idlwave-shell-prompt-pattern nil t)
1574 (goto-char (match-end 0))
1575 (setq idlwave-shell-command-output
1576 (buffer-substring-no-properties (point-min) (point)))
1577 (delete-region (point-min) (point)))
1578 (setq idlwave-shell-command-output
1579 (with-current-buffer (process-buffer proc)
1580 (buffer-substring-no-properties
1581 (save-excursion
1582 (goto-char (process-mark proc))
1583 (forward-line 0) ; Emacs 21 (beginning-of-line nil)
1584 (point))
1585 comint-last-input-end))))
1586
1587 ;; Scan for state and do post commands - bracket
1588 ;; them with idlwave-shell-ready=nil since they may
1589 ;; call idlwave-shell-send-command themselves.
1590 (let ((idlwave-shell-ready nil))
1591 (idlwave-shell-scan-for-state)
1592 ;; Show the output in the shell if it contains an error
1593 (if idlwave-shell-hide-output
1594 (if (and idlwave-shell-show-if-error
1595 (eq idlwave-shell-current-state 'error))
1596 (idlwave-shell-comint-filter proc full-output)
1597 ;; If it's only *mostly* hidden, filter % lines,
1598 ;; and show anything that remains
1599 (if (eq idlwave-shell-hide-output 'mostly)
1600 (let ((filtered
1601 (idlwave-shell-filter-hidden-output
1602 full-output)))
1603 (if filtered
1604 (idlwave-shell-comint-filter
1605 proc filtered))))))
1606
1607 ;; Call the post-command hook
1608 (if (listp idlwave-shell-post-command-hook)
1609 (progn
1610 ;;(message "Calling list")
1611 ;;(prin1 idlwave-shell-post-command-hook)
1612 (eval idlwave-shell-post-command-hook))
1613 ;;(message "Calling command function")
1614 (funcall idlwave-shell-post-command-hook))
1615
1616 ;; Reset to default state for next command.
1617 ;; Also we do not want to find this prompt again.
1618 (setq idlwave-shell-accumulation nil
1619 idlwave-shell-command-output nil
1620 idlwave-shell-post-command-hook nil
1621 idlwave-shell-hide-output nil
1622 idlwave-shell-show-if-error nil))
1623 ;; Done with post command. Do pending command if
1624 ;; any.
1625 (idlwave-shell-send-command)))
1626 (store-match-data data)))))
1627
1628 (defun idlwave-shell-sentinel (process event)
1629 "The sentinel function for the IDLWAVE shell process."
1630 (let* ((buf (idlwave-shell-buffer))
1631 (win (get-buffer-window buf)))
1632 (when (get-buffer buf)
1633 (save-excursion
1634 (set-buffer (idlwave-shell-buffer))
1635 (goto-char (point-max))
1636 (insert (format "\n\n Process %s %s" process event))
1637 (if (and idlwave-shell-save-command-history
1638 (stringp idlwave-shell-command-history-file))
1639 (condition-case nil
1640 (comint-write-input-ring)
1641 (error nil)))))
1642
1643 (when (and (> (length (frame-list)) 1)
1644 (frame-live-p idlwave-shell-idl-wframe))
1645 (delete-frame idlwave-shell-idl-wframe)
1646 (setq idlwave-shell-idl-wframe nil
1647 idlwave-shell-display-wframe nil))
1648 (when (and (window-live-p win)
1649 (not (one-window-p 'nomini)))
1650 (delete-window win))
1651 (idlwave-shell-cleanup)
1652 ;; Run the hook, if possible in the shell buffer.
1653 (if (get-buffer buf)
1654 (save-excursion
1655 (set-buffer buf)
1656 (run-hooks 'idlwave-shell-sentinel-hook))
1657 (run-hooks 'idlwave-shell-sentinel-hook))))
1658
1659 (defvar idlwave-shell-error-buffer " *idlwave-shell-errors*"
1660 "Buffer containing syntax errors from IDL compilations.")
1661
1662 ;; FIXME: the following two variables do not currently allow line breaks
1663 ;; in module and file names. I am not sure if it will be necessary to
1664 ;; change this. Currently it seems to work the way it is.
1665 (defvar idlwave-shell-syntax-error
1666 "^% Syntax error.\\s-*\n\\s-*At:\\s-*\\(.*\\),\\s-*Line\\s-*\\(.*\\)"
1667 "A regular expression to match an IDL syntax error.
1668 The 1st pair matches the file name, the second pair matches the line
1669 number.")
1670
1671 (defvar idlwave-shell-other-error
1672 "^% .*\n\\s-*At:\\s-*\\(.*\\),\\s-*Line\\s-*\\(.*\\)"
1673 "A regular expression to match any IDL error.")
1674
1675 (defvar idlwave-shell-halting-error
1676 "^% .*\n\\([^%].*\n\\)*% Execution halted at:\\(\\s-*\\S-+\\s-*[0-9]+\\s-*.*\\)\n"
1677 "A regular expression to match errors which halt execution.")
1678
1679 (defvar idlwave-shell-cant-continue-error
1680 "^% Can't continue from this point.\n"
1681 "A regular expression to match errors stepping errors.")
1682
1683 (defvar idlwave-shell-file-line-message
1684 (concat
1685 "\\(" ; program name group (1)
1686 "\\$MAIN\\$\\|" ; main level routine
1687 "\\<[a-zA-Z][a-zA-Z0-9_$:]*" ; start with a letter followed by [..]
1688 "\\([ \t]*\n[ \t]*[a-zA-Z0-9_$:]+\\)*"; continuation lines program name (2)
1689 "\\)" ; end program name group (1)
1690 "[ \t\n]+" ; white space
1691 "\\(" ; line number group (3)
1692 "[0-9]+" ; the line number (the fix point)
1693 "\\([ \t]*\n[ \t]*[0-9]+\\)*" ; continuation lines number (4)
1694 "\\)" ; end line number group (3)
1695 "[ \t\n]+" ; white space
1696 "\\(" ; file name group (5)
1697 "[^ \t\n]+" ; file names can contain any non-white
1698 "\\([ \t]*\n[ \t]*[^ \t\n]+\\)*" ; continuation lines file name (6)
1699 "\\)" ; end line number group (5)
1700 )
1701 "*A regular expression to parse out the file name and line number.
1702 The 1st group should match the subroutine name.
1703 The 3rd group is the line number.
1704 The 5th group is the file name.
1705 All parts may contain linebreaks surrounded by spaces. This is important
1706 in IDL5 which inserts random linebreaks in long module and file names.")
1707
1708 (defvar idlwave-shell-electric-debug-mode) ; defined by easy-mmode
1709
1710 (defun idlwave-shell-scan-for-state ()
1711 "Scan for state info. Looks for messages in output from last IDL
1712 command indicating where IDL has stopped. The types of messages we are
1713 interested in are execution halted, stepped, breakpoint, interrupted
1714 at and trace messages. For breakpoint messages process any attached
1715 count or command parameters. Update the stop line if a message is
1716 found. The variable `idlwave-shell-current-state' is set to 'error,
1717 'halt, or 'breakpoint, which describes the status, or nil for none of
1718 the above."
1719 (let (trace)
1720 (cond
1721 ;; Make sure we have output
1722 ((not idlwave-shell-command-output))
1723
1724 ;; First Priority: Syntax and other errors
1725 ((or
1726 (string-match idlwave-shell-syntax-error
1727 idlwave-shell-command-output)
1728 (string-match idlwave-shell-other-error
1729 idlwave-shell-command-output))
1730 (with-current-buffer
1731 (get-buffer-create idlwave-shell-error-buffer)
1732 (erase-buffer)
1733 (insert idlwave-shell-command-output)
1734 (goto-char (point-min))
1735 (setq idlwave-shell-error-last (point)))
1736 (setq idlwave-shell-current-state 'error)
1737 (idlwave-shell-goto-next-error))
1738
1739 ;; Second Priority: Halting errors
1740 ((string-match idlwave-shell-halting-error
1741 idlwave-shell-command-output)
1742 ;; Grab the file and line state info.
1743 (setq idlwave-shell-calling-stack-index 0)
1744 (setq idlwave-shell-halt-frame
1745 (idlwave-shell-parse-line
1746 (substring idlwave-shell-command-output
1747 (match-beginning 2)))
1748 idlwave-shell-current-state 'error)
1749 (idlwave-shell-display-line (idlwave-shell-pc-frame)))
1750
1751 ;; Third Priority: Various types of innocuous HALT and
1752 ;; TRACEBACK messages.
1753 ((or (setq trace (string-match idlwave-shell-trace-message-re
1754 idlwave-shell-command-output))
1755 (string-match idlwave-shell-halt-messages-re
1756 idlwave-shell-command-output))
1757 ;; Grab the file and line state info.
1758 (setq idlwave-shell-calling-stack-index 0)
1759 (setq idlwave-shell-halt-frame
1760 (idlwave-shell-parse-line
1761 (substring idlwave-shell-command-output (match-end 0))))
1762 (setq idlwave-shell-current-state 'halt)
1763 ;; Don't debug trace messages
1764 (idlwave-shell-display-line
1765 (idlwave-shell-pc-frame) nil
1766 (if trace 'disable
1767 (if idlwave-shell-electric-debug-mode 'force))))
1768
1769 ;; Fourth Priority: Breakpoints
1770 ((string-match idlwave-shell-break-message
1771 idlwave-shell-command-output)
1772 (setq idlwave-shell-calling-stack-index 0)
1773 (setq idlwave-shell-halt-frame
1774 (idlwave-shell-parse-line
1775 (substring idlwave-shell-command-output (match-end 0))))
1776 ;; We used to count hits on breakpoints
1777 ;; this is no longer supported since IDL breakpoints
1778 ;; have learned counting.
1779 ;; Do breakpoint command processing
1780 (let ((bp (assoc
1781 (list
1782 (nth 0 idlwave-shell-halt-frame)
1783 (nth 1 idlwave-shell-halt-frame))
1784 idlwave-shell-bp-alist)))
1785 ;(message "Scanning with %s" bp)
1786 (if bp
1787 (let ((cmd (idlwave-shell-bp-get bp 'cmd)))
1788 (if cmd ;; Execute any breakpoint command
1789 (if (listp cmd) (eval cmd) (funcall cmd))))
1790 ;; A breakpoint that we did not know about - perhaps it was
1791 ;; set by the user... Let's update our list.
1792 (idlwave-shell-bp-query)))
1793 (setq idlwave-shell-current-state 'breakpoint)
1794 (idlwave-shell-display-line (idlwave-shell-pc-frame)))
1795
1796 ;; Last Priority: Can't Step errors
1797 ((string-match idlwave-shell-cant-continue-error
1798 idlwave-shell-command-output)
1799 (setq idlwave-shell-current-state 'breakpoint))
1800
1801 ;; Otherwise, no particular state
1802 (t (setq idlwave-shell-current-state nil)))))
1803
1804
1805 (defun idlwave-shell-parse-line (string &optional skip-main)
1806 "Parse IDL message for the subroutine, file name and line number."
1807 ;We need to work hard here to remove the stupid line breaks inserted by
1808 ;IDL5. These line breaks can be right in the middle of procedure
1809 ;or file names.
1810 ;It is very difficult to come up with a robust solution. This one seems
1811 ;to be pretty good though.
1812 ;
1813 ;Here is in what ways it improves over the previous solution:
1814 ;
1815 ;1. The procedure name can be split and will be restored.
1816 ;2. The number can be split. I have never seen this, but who knows.
1817 ;3. We do not require the `.pro' extension for files.
1818 ;
1819 ;This function can still break when the file name ends on an end line
1820 ;and the message line contains an additional line with garbage. Then
1821 ;the first part of that garbage will be added to the file name.
1822 ;However, the function checks the existence of the files with and
1823 ;without this last part - thus the function only breaks if file name
1824 ;plus garbage match an existing regular file. This is hopefully very
1825 ;unlikely.
1826 ;
1827 ;If optional arg SKIP-MAIN is non-nil, don't parse $MAIN$ routine stop
1828 ;statements.
1829
1830 (let (number procedure file)
1831 (when (and (not (if skip-main (string-match ":\\s-*\\$MAIN" string)))
1832 (string-match idlwave-shell-file-line-message string))
1833 (setq procedure (match-string 1 string)
1834 number (match-string 3 string)
1835 file (match-string 5 string))
1836
1837 ;; Repair the strings
1838 (setq procedure (idlwave-shell-repair-string procedure))
1839 (setq number (idlwave-shell-repair-string number))
1840 (setq file (idlwave-shell-repair-file-name file))
1841
1842 ;; If we have a file, return the frame list
1843 (if file
1844 (list (idlwave-shell-file-name file)
1845 (string-to-number number)
1846 procedure)
1847 ;; No success finding a file
1848 nil))))
1849
1850 (defun idlwave-shell-repair-string (string)
1851 "Repair a string by taking out all linebreaks. This is destructive!"
1852 (while (string-match "[ \t]*\n[ \t]*" string)
1853 (setq string (replace-match "" t t string)))
1854 string)
1855
1856 (defun idlwave-shell-repair-file-name (file)
1857 "Repair a file name string by taking out all linebreaks.
1858 The last line of STRING may be garbage - we check which one makes a valid
1859 file name."
1860 (let ((file1 "") (file2 "") (start 0))
1861 ;; We scan no further than to the next "^%" line
1862 (if (string-match "^%" file)
1863 (setq file (substring file 0 (match-beginning 0))))
1864 ;; Take out the line breaks
1865 (while (string-match "[ \t]*\n[ \t]*" file start)
1866 (setq file1 (concat file1 (substring file start (match-beginning 0)))
1867 start (match-end 0)))
1868 (setq file2 (concat file1 (substring file start)))
1869 (cond
1870 ((file-regular-p file2) file2)
1871 ((file-regular-p file1) file1)
1872 ;; If we cannot veryfy the existence of the file, we return the shorter
1873 ;; name. The idea behind this is that this may be a relative file name
1874 ;; and our idea about the current working directory may be wrong.
1875 ;; If it is a relative file name, it hopefully is short.
1876 ((not (string= "" file1)) file1)
1877 ((not (string= "" file2)) file2)
1878 (t nil))))
1879
1880 (defun idlwave-shell-cleanup ()
1881 "Do necessary cleanup for a terminated IDL process."
1882 (setq idlwave-shell-step-frame nil
1883 idlwave-shell-halt-frame nil
1884 idlwave-shell-pending-commands nil
1885 idlwave-shell-command-line-to-execute nil
1886 idlwave-shell-bp-alist nil
1887 idlwave-shell-calling-stack-index 0
1888 idlwave-idlwave_routine_info-compiled nil)
1889 (idlwave-shell-delete-temp-files)
1890 (idlwave-shell-display-line nil)
1891 (idlwave-shell-update-bp-overlays) ; kill old overlays
1892 (idlwave-shell-kill-buffer idlwave-shell-hidden-output-buffer)
1893 (idlwave-shell-kill-buffer idlwave-shell-bp-buffer)
1894 (idlwave-shell-kill-buffer idlwave-shell-error-buffer)
1895 ;; (idlwave-shell-kill-buffer (idlwave-shell-buffer))
1896 (and (get-buffer (idlwave-shell-buffer))
1897 (bury-buffer (get-buffer (idlwave-shell-buffer))))
1898 (run-hooks 'idlwave-shell-cleanup-hook))
1899
1900 (defun idlwave-shell-kill-buffer (buf)
1901 "Kill buffer BUF if it exists."
1902 (if (setq buf (get-buffer buf))
1903 (kill-buffer buf)))
1904
1905 (defun idlwave-shell-kill-shell-buffer-confirm ()
1906 (when (idlwave-shell-is-running)
1907 (ding)
1908 (unless (y-or-n-p "IDL shell is running. Are you sure you want to kill the buffer? ")
1909 (error "Abort"))
1910 (message "Killing buffer *idl* and the associated process")))
1911
1912 (defun idlwave-shell-window (n)
1913 "Issue a `window,N' command to IDL, with special window size.
1914 The size is given by `idlwave-shell-graphics-window-size'."
1915 (interactive "P")
1916 (let ((n (if n (prefix-numeric-value n) 0)))
1917 (idlwave-shell-send-command
1918 (apply 'format "window,%d,xs=%d,ys=%d"
1919 n idlwave-shell-graphics-window-size)
1920 nil (idlwave-shell-hide-p 'misc) nil t)))
1921
1922 (defun idlwave-shell-resync-dirs ()
1923 "Resync the buffer's idea of the current directory.
1924 This command queries IDL with the command bound to
1925 `idlwave-shell-dirstack-query', reads the output for the new
1926 directory."
1927 (interactive)
1928 (idlwave-shell-send-command idlwave-shell-dirstack-query
1929 'idlwave-shell-filter-directory
1930 'hide 'wait))
1931
1932 (defun idlwave-shell-retall (&optional arg)
1933 "Return from the entire calling stack.
1934 Also get rid of widget events in the queue."
1935 (interactive "P")
1936 (save-selected-window
1937 ;;if (widget_info(/MANAGED))[0] gt 0 then for i=0,n_elements(widget_info(/MANAGED))-1 do widget_control,(widget_info(/MANAGED))[i],/clear_events &
1938 (idlwave-shell-send-command "retall" nil
1939 (if (idlwave-shell-hide-p 'misc) 'mostly)
1940 nil t)
1941 (idlwave-shell-display-line nil)))
1942
1943 (defun idlwave-shell-closeall (&optional arg)
1944 "Close all open files."
1945 (interactive "P")
1946 (idlwave-shell-send-command "close,/all" nil
1947 (idlwave-shell-hide-p 'misc) nil t))
1948
1949 (defun idlwave-shell-quit (&optional arg)
1950 "Exit the idl process after confirmation.
1951 With prefix ARG, exit without confirmation."
1952 (interactive "P")
1953 (if (not (idlwave-shell-is-running))
1954 (error "Shell is not running")
1955 (if (or arg (y-or-n-p "Exit the IDLWAVE Shell? "))
1956 (condition-case nil
1957 (idlwave-shell-send-command "exit")
1958 (error nil)))))
1959
1960 (defun idlwave-shell-reset (&optional hidden)
1961 "Reset IDL. Return to main level and destroy the leftover variables.
1962 This issues the following commands:
1963 RETALL
1964 WIDGET_CONTROL,/RESET
1965 CLOSE, /ALL
1966 HEAP_GC, /VERBOSE"
1967 ;; OBJ_DESTROY, OBJ_VALID() FIXME: should this be added?
1968 (interactive "P")
1969 (when (or idlwave-shell-reset-no-prompt
1970 (yes-or-no-p "Really Reset IDL and discard current session? "))
1971 (message "Resetting IDL")
1972 (setq idlwave-shell-calling-stack-index 0)
1973 ;; Give widget exit handlers a chance
1974 (idlwave-shell-send-command "retall" nil hidden)
1975 (idlwave-shell-send-command "widget_control,/reset" nil hidden)
1976 (idlwave-shell-send-command "close,/all" nil hidden)
1977 ;; (idlwave-shell-send-command "obj_destroy, obj_valid()" nil hidden)
1978 (idlwave-shell-send-command "heap_gc,/verbose" nil hidden)
1979 (idlwave-shell-display-line nil)))
1980
1981 (defun idlwave-shell-path-filter ()
1982 ;; Convert the output of the path query into a list of directories
1983 (let ((path-string idlwave-shell-command-output)
1984 (case-fold-search t)
1985 (start 0)
1986 dirs sysdir)
1987 (while (string-match "^PATH:[ \t]*<\\(.*\\)>[ \t]*\n" path-string start)
1988 (push (match-string 1 path-string) dirs)
1989 (setq start (match-end 0)))
1990 (setq dirs (mapcar 'file-name-as-directory dirs))
1991 (if (string-match "^SYSDIR:[ \t]*<\\(.*\\)>[ \t]*\n" path-string)
1992 (setq sysdir (file-name-as-directory
1993 (match-string 1 path-string))))
1994 (cons sysdir (nreverse dirs))))
1995
1996 (defun idlwave-shell-routine-info-filter ()
1997 "Function which parses the special output from idlwave_routine_info.pro."
1998 (let ((text idlwave-shell-command-output)
1999 (start 0)
2000 sep sep-re file type spec specs name cs key keys class entry)
2001 ;; (message "GOT: %s" text) ;??????????????????????
2002 ;; Initialize variables
2003 (setq idlwave-compiled-routines nil
2004 idlwave-unresolved-routines nil)
2005 ;; Cut out the correct part of the output.
2006 (if (string-match
2007 "^>>>BEGIN OF IDLWAVE ROUTINE INFO (\"\\(.+\\)\" IS THE SEPARATOR.*"
2008 text)
2009 (setq sep (match-string 1 text)
2010 sep-re (concat (regexp-quote sep) " *")
2011 text (substring text (match-end 0)))
2012 ;; Set dummy values and kill the text
2013 (setq sep "@" sep-re "@ *" text "")
2014 (if idlwave-idlwave_routine_info-compiled
2015 (message
2016 "Routine Info warning: No match for BEGIN line in \n>>>\n%s\n<<<\n"
2017 idlwave-shell-command-output)))
2018 (if (string-match "^>>>END OF IDLWAVE ROUTINE INFO.*" text)
2019 (setq text (substring text 0 (match-beginning 0)))
2020 (if idlwave-idlwave_routine_info-compiled
2021 (message
2022 "Routine Info warning: No match for END line in \n>>>\n%s\n<<<\n"
2023 idlwave-shell-command-output)))
2024 ;; Match the output lines
2025 (while (string-match "^IDLWAVE-\\(PRO\\|FUN\\): \\(.*\\)" text start)
2026 (setq start (match-end 0))
2027 (setq type (match-string 1 text)
2028 spec (match-string 2 text)
2029 specs (idlwave-split-string spec sep-re)
2030 name (nth 0 specs)
2031 class (if (equal (nth 1 specs) "") nil (nth 1 specs))
2032 file (nth 2 specs)
2033 cs (nth 3 specs)
2034 key (nth 4 specs)
2035 keys (if (and (stringp key)
2036 (not (string-match "\\` *\\'" key)))
2037 (mapcar 'list
2038 (delete "" (idlwave-split-string key " +")))))
2039 (setq name (idlwave-sintern-routine-or-method name class t)
2040 class (idlwave-sintern-class class t)
2041 file (if (equal file "") nil file)
2042 keys (mapcar (lambda (x)
2043 (list (idlwave-sintern-keyword (car x) t))) keys))
2044
2045 ;; In the following ignore routines already defined in buffers,
2046 ;; assuming that if the buffer stuff differs, it is a "new"
2047 ;; version, not yet compiled, and should take precedence.
2048 ;; We could do the same for the library to avoid duplicates -
2049 ;; but I think frequently a user might have several versions of
2050 ;; the same function in different programs, and in this case the
2051 ;; compiled one will be the best guess of all versions.
2052 ;; Therefore, we leave duplicates of library routines in.
2053 (cond ((string= name "$MAIN$")) ; ignore this one
2054 ((and (string= type "PRO")
2055 ;; FIXME: is it OK to make the buffer routines dominate?
2056 (or t (null file)
2057 (not (idlwave-rinfo-assq name 'pro class
2058 idlwave-buffer-routines)))
2059 ;; FIXME: is it OK to make the library routines dominate?
2060 ;;(not (idlwave-rinfo-assq name 'pro class
2061 ;; idlwave-library-routines))
2062 )
2063 (setq entry (list name 'pro class
2064 (cons 'compiled
2065 (if file
2066 (list
2067 (file-name-nondirectory file)
2068 (idlwave-sintern-dir
2069 (file-name-directory file)))))
2070 cs (cons nil keys)))
2071 (if file
2072 (push entry idlwave-compiled-routines)
2073 (push entry idlwave-unresolved-routines)))
2074
2075 ((and (string= type "FUN")
2076 ;; FIXME: is it OK to make the buffer routines dominate?
2077 (or t (not file)
2078 (not (idlwave-rinfo-assq name 'fun class
2079 idlwave-buffer-routines)))
2080 ;; FIXME: is it OK to make the library routines dominate?
2081 ;; (not (idlwave-rinfo-assq name 'fun class
2082 ;; idlwave-library-routines))
2083 )
2084 (setq entry (list name 'fun class
2085 (cons 'compiled
2086 (if file
2087 (list
2088 (file-name-nondirectory file)
2089 (idlwave-sintern-dir
2090 (file-name-directory file)))))
2091 cs (cons nil keys)))
2092 (if file
2093 (push entry idlwave-compiled-routines)
2094 (push entry idlwave-unresolved-routines))))))
2095 ;; Reverse the definitions so that they are alphabetically sorted.
2096 (setq idlwave-compiled-routines (nreverse idlwave-compiled-routines)
2097 idlwave-unresolved-routines (nreverse idlwave-unresolved-routines)))
2098
2099 (defun idlwave-shell-filter-directory ()
2100 "Get the current directory from `idlwave-shell-command-output'.
2101 Change the default directory for the process buffer to concur."
2102 (save-excursion
2103 (set-buffer (idlwave-shell-buffer))
2104 (if (string-match ",___cur[\n\r]\\(\\S-*\\) *[\n\r]"
2105 idlwave-shell-command-output)
2106 (let ((dir (substring idlwave-shell-command-output
2107 (match-beginning 1) (match-end 1))))
2108 ; (message "Setting Emacs working dir to %s" dir)
2109 (setq idlwave-shell-default-directory dir)
2110 (setq default-directory (file-name-as-directory dir))))))
2111
2112 (defvar idlwave-shell-get-object-class nil)
2113 (defun idlwave-shell-get-object-class (apos)
2114 "Query the shell for the class of the object before point."
2115 (let ((bos (save-excursion (idlwave-start-of-substatement 'pre) (point)))
2116 (bol (save-excursion (forward-line 0) (point)))
2117 expression)
2118 (save-excursion
2119 (goto-char apos)
2120 (setq expression (buffer-substring
2121 (catch 'exit
2122 (while t
2123 (if (not (re-search-backward
2124 "[^][.A-Za-z0-9_() ]" bos t))
2125 (throw 'exit bos)) ;ran into bos
2126 (if (not (idlwave-is-pointer-dereference bol))
2127 (throw 'exit (1+ (point))))))
2128 apos)))
2129 (when (not (string= expression ""))
2130 (setq idlwave-shell-get-object-class nil)
2131 (idlwave-shell-send-command
2132 (concat "if obj_valid(" expression ") then print,obj_class("
2133 expression ")")
2134 'idlwave-shell-parse-object-class
2135 'hide 'wait)
2136 ;; If we don't know anything about the class, update shell routines
2137 (if (and idlwave-shell-get-object-class
2138 (not (assoc-string idlwave-shell-get-object-class
2139 (idlwave-class-alist) t)))
2140 (idlwave-shell-maybe-update-routine-info))
2141 idlwave-shell-get-object-class)))
2142
2143 (defun idlwave-shell-parse-object-class ()
2144 "Parse the output of the obj_class command."
2145 (let ((match "obj_class([^\n\r]+[\n\r ]"))
2146 (if (string-match (concat match "\\([A-Za-z_0-9]+\\) *[\n\r]\\("
2147 idlwave-shell-prompt-pattern "\\)")
2148 idlwave-shell-command-output)
2149 (setq idlwave-shell-get-object-class
2150 (match-string 1 idlwave-shell-command-output)))))
2151
2152 (defvar idlwave-sint-sysvars nil)
2153 (idlwave-new-sintern-type 'execcomm)
2154
2155 (defun idlwave-shell-complete (&optional arg)
2156 "Do completion in the idlwave-shell buffer.
2157 Calls `idlwave-shell-complete-filename' after some executive commands or
2158 in strings. Otherwise, calls `idlwave-complete' to complete modules and
2159 keywords."
2160 (interactive "P")
2161 (let (exec-cmd)
2162 (cond
2163 ((and
2164 (setq exec-cmd (idlwave-shell-executive-command))
2165 (cdr exec-cmd)
2166 (member (upcase (cdr exec-cmd))
2167 '(".R" ".RU" ".RUN" ".RN" ".RNE" ".RNEW"
2168 ".COM" ".COMP" ".COMPI" ".COMPIL" ".COMPILE")))
2169 ;; We are in a command line with an executive command
2170 (idlwave-shell-complete-filename))
2171
2172 ((car-safe exec-cmd)
2173 (setq idlwave-completion-help-info
2174 '(idlwave-shell-complete-execcomm-help))
2175 (idlwave-complete-in-buffer 'execcomm 'execcomm
2176 idlwave-executive-commands-alist nil
2177 "Select an executive command"
2178 "system variable"))
2179
2180 ((idlwave-shell-batch-command)
2181 (idlwave-shell-complete-filename))
2182
2183 ((idlwave-shell-shell-command)
2184 (idlwave-shell-complete-filename))
2185
2186 ((and (idlwave-shell-filename-string)
2187 (save-excursion
2188 (beginning-of-line)
2189 (let ((case-fold-search t))
2190 (not (looking-at ".*obj_new")))))
2191 (idlwave-shell-complete-filename))
2192
2193 (t
2194 ;; Default completion of modules and keywords
2195 (idlwave-complete arg)))))
2196
2197 ;; Get rid of opaque dynamic variable passing of link?
2198 (defvar link) ;dynamic variable
2199 (defun idlwave-shell-complete-execcomm-help (mode word)
2200 (let ((word (or (nth 1 idlwave-completion-help-info) word))
2201 (entry (assoc-string word idlwave-executive-commands-alist t)))
2202 (cond
2203 ((eq mode 'test)
2204 (and (stringp word) entry (cdr entry)))
2205 ((eq mode 'set)
2206 (if entry (setq link (cdr entry)))) ;; setting dynamic variable!!!
2207 (t (error "This should not happen")))))
2208
2209 (defun idlwave-shell-complete-filename (&optional arg)
2210 "Complete a file name at point if after a file name.
2211 We assume that we are after a file name when completing one of the
2212 args of an executive .run, .rnew or .compile."
2213 ;; CWD might have changed, resync, to set default directory
2214 (idlwave-shell-resync-dirs)
2215 (let ((comint-file-name-chars idlwave-shell-file-name-chars))
2216 (comint-dynamic-complete-as-filename)))
2217
2218 (defun idlwave-shell-executive-command ()
2219 "Return the name of the current executive command, if any."
2220 (save-excursion
2221 (idlwave-beginning-of-statement)
2222 (cons (looking-at "[ \t]*\\.")
2223 (if (looking-at "[ \t]*[.]\\([^ \t\n\r]+\\)[ \t]")
2224 (match-string 1)))))
2225
2226 (defun idlwave-shell-filename-string ()
2227 "Return t if in a string and after what could be a file name."
2228 (let ((limit (save-excursion (beginning-of-line) (point))))
2229 (save-excursion
2230 ;; Skip backwards over file name chars
2231 (skip-chars-backward idlwave-shell-file-name-chars limit)
2232 ;; Check of the next char is a string delimiter
2233 (memq (preceding-char) '(?\' ?\")))))
2234
2235 (defun idlwave-shell-batch-command ()
2236 "Returns t if we're in a batch command statement like @foo"
2237 (let ((limit (save-excursion (beginning-of-line) (point))))
2238 (save-excursion
2239 ;; Skip backwards over filename
2240 (skip-chars-backward idlwave-shell-file-name-chars limit)
2241 (skip-chars-backward " \t" limit)
2242 (and (eq (preceding-char) ?@) (not (idlwave-in-quote))))))
2243
2244 (defun idlwave-shell-shell-command ()
2245 "Returns t if we're in a shell command statement like $ls"
2246 (save-excursion
2247 (idlwave-beginning-of-statement)
2248 (looking-at "\\$")))
2249
2250 ;; Debugging Commands ------------------------------------------------------
2251
2252 (defun idlwave-shell-redisplay (&optional hide)
2253 "Tries to resync the display with where execution has stopped.
2254 Issues a \"help,/trace\" command followed by a call to
2255 `idlwave-shell-display-line'. Also updates the breakpoint
2256 overlays."
2257 (interactive)
2258 (setq idlwave-shell-calling-stack-index 0)
2259 (idlwave-shell-send-command
2260 "help,/trace"
2261 '(idlwave-shell-display-line
2262 (idlwave-shell-pc-frame))
2263 hide)
2264 (idlwave-shell-bp-query))
2265
2266 (defun idlwave-shell-display-level-in-calling-stack (&optional hide)
2267 (idlwave-shell-send-command
2268 "help,/trace"
2269 `(progn
2270 ;; scanning for the state will reset the stack level - restore it
2271 (setq idlwave-shell-calling-stack-index
2272 ,idlwave-shell-calling-stack-index)
2273 ;; parse the stack and visit the selected frame
2274 (idlwave-shell-parse-stack-and-display))
2275 hide))
2276
2277 (defun idlwave-shell-parse-stack-and-display ()
2278 (let* ((lines (delete "" (idlwave-split-string
2279 idlwave-shell-command-output "^%")))
2280 (stack (delq nil (mapcar 'idlwave-shell-parse-line lines)))
2281 (nmax (1- (length stack)))
2282 (nmin 0) message)
2283 (cond
2284 ((< nmax nmin)
2285 (setq idlwave-shell-calling-stack-index 0)
2286 (ding)
2287 (message "Problem with calling stack"))
2288 ((> idlwave-shell-calling-stack-index nmax)
2289 (ding)
2290 (setq idlwave-shell-calling-stack-index nmax
2291 message (format "%d is the highest calling stack level - can't go further up"
2292 (- nmax))))
2293 ((< idlwave-shell-calling-stack-index nmin)
2294 (ding)
2295 (setq idlwave-shell-calling-stack-index nmin
2296 message (format "%d is the current calling stack level - can't go further down"
2297 (- nmin)))))
2298 (setq idlwave-shell-calling-stack-routine
2299 (nth 2 (nth idlwave-shell-calling-stack-index stack)))
2300
2301 ;; force edebug for this frame if we're in that mode already
2302 (idlwave-shell-display-line
2303 (nth idlwave-shell-calling-stack-index stack) nil
2304 (if idlwave-shell-electric-debug-mode 'force))
2305 (message "%s" (or message
2306 (format "In routine %s (stack level %d)"
2307 idlwave-shell-calling-stack-routine
2308 (- idlwave-shell-calling-stack-index))))))
2309
2310 (defun idlwave-shell-stack-up ()
2311 "Display the source code one step up the calling stack."
2312 (interactive)
2313 (incf idlwave-shell-calling-stack-index)
2314 (idlwave-shell-display-level-in-calling-stack 'hide))
2315 (defun idlwave-shell-stack-down ()
2316 "Display the source code one step down the calling stack."
2317 (interactive)
2318 (decf idlwave-shell-calling-stack-index)
2319 (idlwave-shell-display-level-in-calling-stack 'hide))
2320
2321 (defun idlwave-shell-goto-frame (&optional frame)
2322 "Set buffer to FRAME with point at the frame line.
2323 If the optional argument FRAME is nil then idlwave-shell-pc-frame is
2324 used. Does nothing if the resulting frame is nil."
2325 (if frame ()
2326 (setq frame (idlwave-shell-pc-frame)))
2327 (cond
2328 (frame
2329 (set-buffer (idlwave-find-file-noselect (car frame) 'shell))
2330 (widen)
2331 (goto-line (nth 1 frame)))))
2332
2333 (defun idlwave-shell-pc-frame ()
2334 "Returns the frame for IDL execution."
2335 (and idlwave-shell-halt-frame
2336 (list (nth 0 idlwave-shell-halt-frame)
2337 (nth 1 idlwave-shell-halt-frame)
2338 (nth 2 idlwave-shell-halt-frame))))
2339
2340 (defun idlwave-shell-valid-frame (frame)
2341 "Check that frame is for an existing file."
2342 (file-readable-p (car frame)))
2343
2344 (defun idlwave-shell-stop-line-pending ()
2345 ;; Temporarily change the color of the stop line overlay
2346 (if idlwave-shell-stop-line-overlay
2347 (overlay-put idlwave-shell-stop-line-overlay 'face
2348 (if idlwave-shell-electric-debug-mode
2349 'idlwave-shell-pending-electric-stop
2350 'idlwave-shell-pending-stop))))
2351
2352 (defvar idlwave-shell-suppress-electric-debug nil)
2353 (defun idlwave-shell-display-line (frame &optional col debug)
2354 "display frame file in other window with overlay arrow.
2355
2356 frame is a list of file name, line number, and subroutine name. if
2357 frame is nil then remove overlay. if col is set, move point to that
2358 column in the line. if debug is non-nil, enable the electric debug
2359 mode. if it is 'disable, do not enable no matter what the setting of
2360 'idlwave-shell-automatic-electric-debug'. if it is 'force, enable no
2361 matter what the settings of that variable."
2362 (if (not frame)
2363 ;; remove stop-line overlay from old position
2364 (progn
2365 (setq overlay-arrow-string nil)
2366 (setq idlwave-shell-mode-line-info nil)
2367 (setq idlwave-shell-is-stopped nil)
2368 (if idlwave-shell-stop-line-overlay
2369 (delete-overlay idlwave-shell-stop-line-overlay))
2370 ;; turn off electric debug everywhere, if it's on
2371 (idlwave-shell-electric-debug-all-off))
2372 (if (not (idlwave-shell-valid-frame frame))
2373 ;; fixme: errors are dangerous in shell filters. but i think i
2374 ;; have never encountered this one.
2375 (error (concat "invalid frame - unable to access file: " (car frame)))
2376 ;;;
2377 ;;; buffer : the buffer to display a line in.
2378 ;;; select-shell: current buffer is the shell.
2379 ;;;
2380 (setq idlwave-shell-mode-line-info
2381 (if (nth 2 frame)
2382 (format "[%d:%s]"
2383 (- idlwave-shell-calling-stack-index)
2384 (nth 2 frame))))
2385 (let* ((buffer (idlwave-find-file-noselect (car frame) 'shell))
2386 (select-shell (equal (buffer-name) (idlwave-shell-buffer)))
2387 window pos electric)
2388
2389 ;; first make sure the shell window is visible
2390 (idlwave-display-buffer (idlwave-shell-buffer)
2391 nil (idlwave-shell-shell-frame))
2392
2393 ;; now display the buffer and remember which window it is.
2394 (setq window (idlwave-display-buffer buffer
2395 nil (idlwave-shell-source-frame)))
2396
2397 ;; enter the buffer and mark the line
2398 (save-excursion
2399 (set-buffer buffer)
2400 (save-restriction
2401 (widen)
2402 (goto-line (nth 1 frame))
2403 (forward-line 0)
2404 (setq pos (point))
2405 (setq idlwave-shell-is-stopped t)
2406
2407 (if idlwave-shell-stop-line-overlay
2408 (progn
2409 ;; restore face and move overlay
2410 (overlay-put idlwave-shell-stop-line-overlay 'face
2411 (if idlwave-shell-electric-debug-mode
2412 idlwave-shell-electric-stop-line-face
2413 idlwave-shell-stop-line-face))
2414 (move-overlay idlwave-shell-stop-line-overlay
2415 (point) (save-excursion (end-of-line) (point))
2416 (current-buffer)))
2417 ;; use the arrow instead, but only if marking is wanted.
2418 (if idlwave-shell-mark-stop-line
2419 (setq overlay-arrow-string idlwave-shell-overlay-arrow))
2420 (or overlay-arrow-position ; create the marker if necessary
2421 (setq overlay-arrow-position (make-marker)))
2422 (set-marker overlay-arrow-position (point) buffer)))
2423
2424 ;; if the point is outside the restriction, widen the buffer.
2425 (if (or (< pos (point-min)) (> pos (point-max)))
2426 (progn
2427 (widen)
2428 (goto-char pos)))
2429
2430 ;; if we have the column of the error, move the cursor there.
2431 (if col (move-to-column col))
2432 (setq pos (point))
2433
2434 ;; enter electric debug mode, if not prohibited and not in
2435 ;; it already
2436 (when (and (not idlwave-shell-electric-debug-mode)
2437 (or (eq debug 'force)
2438 (and
2439 (not (eq debug 'disable)) ;; explicitly disabled
2440 (or
2441 (eq idlwave-shell-automatic-electric-debug t)
2442 (and
2443 (eq idlwave-shell-automatic-electric-debug
2444 'breakpoint)
2445 (not (eq idlwave-shell-current-state 'error))))
2446 (not idlwave-shell-suppress-electric-debug))))
2447 (idlwave-shell-electric-debug-mode t))
2448 (setq electric idlwave-shell-electric-debug-mode))
2449
2450 ;; Make sure pos is really displayed in the window.
2451 (set-window-point window pos)
2452
2453 ;; If we came from the shell, go back there. Otherwise select
2454 ;; the window where the error/halt is displayed.
2455 (if (or (and idlwave-shell-electric-zap-to-file electric)
2456 (and (equal (buffer-name) (idlwave-shell-buffer))
2457 (not select-shell)))
2458 (select-window window))))))
2459
2460
2461 (defun idlwave-shell-step (arg)
2462 "Step one source line. If given prefix argument ARG, step ARG source lines."
2463 (interactive "p")
2464 (or (not arg) (< arg 1)
2465 (setq arg 1))
2466 (idlwave-shell-stop-line-pending)
2467 (idlwave-shell-send-command
2468 (concat ".s " (if (integerp arg) (int-to-string arg) arg))
2469 nil (if (idlwave-shell-hide-p 'debug) 'mostly) nil t))
2470
2471 (defun idlwave-shell-stepover (arg)
2472 "Stepover one source line.
2473 If given prefix argument ARG, step ARG source lines.
2474 Uses IDL's stepover executive command which does not enter called functions."
2475 (interactive "p")
2476 (or (not arg) (< arg 1)
2477 (setq arg 1))
2478 (idlwave-shell-stop-line-pending)
2479 (idlwave-shell-send-command
2480 (concat ".so " (if (integerp arg) (int-to-string arg) arg))
2481 nil (if (idlwave-shell-hide-p 'debug) 'mostly) nil t))
2482
2483 (defun idlwave-shell-break-here (&optional count cmd condition disabled
2484 no-show)
2485 "Set breakpoint at current line.
2486
2487 If Count is nil then an ordinary breakpoint is set. We treat a count
2488 of 1 as a temporary breakpoint using the ONCE keyword. Counts greater
2489 than 1 use the IDL AFTER=count keyword to break only after reaching
2490 the statement count times.
2491
2492 Optional argument CMD is a list or function to evaluate upon reaching
2493 the breakpoint. CONDITION is a break condition, and DISABLED, if
2494 non-nil disables the breakpoint"
2495 (interactive "P")
2496 (when (listp count)
2497 (if (equal (car count) 4)
2498 (setq condition (read-string "Break Condition: ")))
2499 (setq count nil))
2500 (idlwave-shell-set-bp
2501 ;; Create breakpoint
2502 (idlwave-shell-bp (idlwave-shell-current-frame)
2503 (list count cmd condition disabled)
2504 (idlwave-shell-current-module))
2505 no-show))
2506
2507 (defun idlwave-shell-set-bp-check (bp)
2508 "Check for failure to set breakpoint.
2509 This is run on `idlwave-shell-post-command-hook'.
2510 Offers to recompile the procedure if we failed. This usually fixes
2511 the problem with not being able to set the breakpoint."
2512 ;; Scan for message
2513 (if idlwave-shell-command-output
2514 (cond
2515 ((string-match "% BREAKPOINT: *Unable to find code"
2516 idlwave-shell-command-output)
2517 ;; Offer to recompile
2518 (if (progn
2519 (beep)
2520 (y-or-n-p
2521 (concat "Okay to recompile file "
2522 (idlwave-shell-bp-get bp 'file) "?")))
2523 ;; Recompile
2524 (progn
2525 ;; Clean up before retrying
2526 (idlwave-shell-command-failure)
2527 (idlwave-shell-send-command
2528 (concat ".run \"" (idlwave-shell-bp-get bp 'file) "\"") nil
2529 (if (idlwave-shell-hide-p 'run) 'mostly) nil t)
2530 ;; Try setting breakpoint again
2531 (idlwave-shell-set-bp bp))
2532 (beep)
2533 (message "Unable to set breakpoint.")
2534 (idlwave-shell-command-failure))
2535 nil)
2536
2537 ((string-match "% Syntax error" idlwave-shell-command-output)
2538 (message "Syntax error in condition.")
2539 (idlwave-shell-command-failure)
2540 nil)
2541
2542 (t 'okay))))
2543
2544 (defun idlwave-shell-command-failure ()
2545 "Do any necessary clean up when an IDL command fails.
2546 Call this from a function attached to `idlwave-shell-post-command-hook'
2547 that detects the failure of a command.
2548 For example, this is called from `idlwave-shell-set-bp-check' when a
2549 breakpoint can not be set."
2550 ;; Clear pending commands
2551 (setq idlwave-shell-pending-commands nil))
2552
2553 (defun idlwave-shell-cont (&optional no-show)
2554 "Continue executing."
2555 (interactive)
2556 (idlwave-shell-stop-line-pending)
2557 (idlwave-shell-send-command ".c" (unless no-show
2558 '(idlwave-shell-redisplay 'hide))
2559 (if (idlwave-shell-hide-p 'debug) 'mostly)
2560 nil t))
2561
2562 (defun idlwave-shell-go ()
2563 "Run .GO. This starts the main program of the last compiled file."
2564 (interactive)
2565 (idlwave-shell-stop-line-pending)
2566 (idlwave-shell-send-command ".go" '(idlwave-shell-redisplay 'hide)
2567 (if (idlwave-shell-hide-p 'debug) 'mostly)
2568 nil t))
2569
2570 (defun idlwave-shell-return ()
2571 "Run .RETURN (continue to next return, but stay in subprogram)."
2572 (interactive)
2573 (idlwave-shell-stop-line-pending)
2574 (idlwave-shell-send-command ".return" '(idlwave-shell-redisplay 'hide)
2575 (if (idlwave-shell-hide-p 'debug) 'mostly)
2576 nil t))
2577
2578 (defun idlwave-shell-skip ()
2579 "Run .SKIP (skip one line, then step)."
2580 (interactive)
2581 (idlwave-shell-stop-line-pending)
2582 (idlwave-shell-send-command ".skip" '(idlwave-shell-redisplay 'hide)
2583 (if (idlwave-shell-hide-p 'debug) 'mostly)
2584 nil t))
2585
2586 (defun idlwave-shell-clear-bp (bp)
2587 "Clear breakpoint BP.
2588 Clears in IDL and in `idlwave-shell-bp-alist'."
2589 (let ((index (idlwave-shell-bp-get bp)))
2590 (if index
2591 (progn
2592 (idlwave-shell-send-command
2593 (concat "breakpoint,/clear," (int-to-string index))
2594 nil (idlwave-shell-hide-p 'breakpoint) nil t)
2595 (idlwave-shell-bp-query)))))
2596
2597 (defun idlwave-shell-current-frame ()
2598 "Return a list containing the current file name and line point is in.
2599 If in the IDL shell buffer, returns `idlwave-shell-pc-frame'."
2600 (if (eq (current-buffer) (get-buffer (idlwave-shell-buffer)))
2601 ;; In IDL shell
2602 (idlwave-shell-pc-frame)
2603 ;; In source
2604 (list (idlwave-shell-file-name (buffer-file-name))
2605 (save-restriction
2606 (widen)
2607 (save-excursion
2608 (beginning-of-line)
2609 (1+ (count-lines 1 (point))))))))
2610
2611 (defun idlwave-shell-current-module ()
2612 "Return the name of the module for the current file.
2613 Returns nil if unable to obtain a module name."
2614 (if (eq (current-buffer) (get-buffer (idlwave-shell-buffer)))
2615 ;; In IDL shell
2616 (nth 2 idlwave-shell-halt-frame)
2617 ;; In pro file
2618 (save-restriction
2619 (widen)
2620 (save-excursion
2621 (if (idlwave-prev-index-position)
2622 (upcase (idlwave-unit-name)))))))
2623
2624 (defun idlwave-shell-clear-current-bp ()
2625 "Remove breakpoint at current line.
2626 This command can be called from the shell buffer if IDL is currently stopped
2627 at a breakpoint."
2628 (interactive)
2629 (let ((bp (idlwave-shell-find-current-bp)))
2630 (if bp (idlwave-shell-clear-bp bp))))
2631
2632
2633 (defun idlwave-shell-toggle-enable-current-bp (&optional bp force
2634 no-update)
2635 "Disable or enable current bp."
2636 (interactive)
2637 (let* ((bp (or bp (idlwave-shell-find-current-bp)))
2638 (disabled (idlwave-shell-bp-get bp 'disabled)))
2639 (cond ((eq force 'disable) (setq disabled nil))
2640 ((eq force 'enable) (setq disabled t)))
2641 (when bp
2642 (setf (nth 3 (cdr (cdr bp))) (not disabled))
2643 (idlwave-shell-send-command
2644 (concat "breakpoint,"
2645 (if disabled "/enable," "/disable,")
2646 (int-to-string (idlwave-shell-bp-get bp)))
2647 nil (idlwave-shell-hide-p 'breakpoint) nil t)
2648 (unless no-update (idlwave-shell-bp-query)))))
2649
2650 (defun idlwave-shell-enable-all-bp (&optional enable no-update bpl)
2651 "Disable all breakpoints we know about which need disabling.
2652 If ENABLE is non-nil, enable them instead."
2653 (let ((bpl (or bpl idlwave-shell-bp-alist)) disabled modified)
2654 (while bpl
2655 (setq disabled (idlwave-shell-bp-get (car bpl) 'disabled))
2656 (when (idlwave-xor (not disabled) (eq enable 'enable))
2657 (idlwave-shell-toggle-enable-current-bp
2658 (car bpl) (if (eq enable 'enable) 'enable 'disable) no-update)
2659 (push (car bpl) modified))
2660 (setq bpl (cdr bpl)))
2661 (unless no-update (idlwave-shell-bp-query))
2662 modified))
2663
2664 (defun idlwave-shell-to-here ()
2665 "Set a breakpoint with count 1 then continue."
2666 (interactive)
2667 ;; temporarily disable all other breakpoints
2668 (let ((disabled (idlwave-shell-enable-all-bp 'disable 'no-update)))
2669 (idlwave-shell-break-here 1 nil nil nil 'no-show)
2670 (idlwave-shell-cont 'no-show)
2671 (idlwave-shell-enable-all-bp 'enable 'no-update disabled))
2672 (idlwave-shell-redisplay)) ; sync up everything at the end
2673
2674 (defun idlwave-shell-break-this-module (&optional arg)
2675 (interactive "P")
2676 (save-excursion
2677 (idlwave-beginning-of-subprogram)
2678 (idlwave-shell-break-here arg)))
2679
2680 (defun idlwave-shell-break-in ()
2681 "Look for a module name near point and set a break point for it.
2682 The command looks for an identifier near point and sets a breakpoint
2683 for the first line of the corresponding module. If MODULE is `t', set
2684 in the current routine."
2685 (interactive)
2686 (let ((module (idlwave-fix-module-if-obj_new (idlwave-what-module))))
2687 (if module
2688 (progn
2689 (setq module (idlwave-make-full-name (nth 2 module) (car module)))
2690 (idlwave-shell-module-source-query module)
2691 (idlwave-shell-set-bp-in-module module))
2692 (error "No identifier at point"))))
2693
2694
2695 (defun idlwave-shell-set-bp-in-module (module)
2696 "Set breakpoint in module. Assumes that `idlwave-shell-sources-alist'
2697 contains an entry for that module."
2698 (let ((source-file (car-safe
2699 (cdr-safe
2700 (assoc (upcase module)
2701 idlwave-shell-sources-alist))))
2702 buf)
2703 (if (or (not source-file)
2704 (not (file-regular-p source-file))
2705 (not (setq buf
2706 (or (idlwave-get-buffer-visiting source-file)
2707 (find-file-noselect source-file)))))
2708 (progn
2709 (message "The source file for module %s is probably not compiled"
2710 module)
2711 (beep))
2712 (save-excursion
2713 (set-buffer buf)
2714 (save-excursion
2715 (goto-char (point-min))
2716 (let ((case-fold-search t))
2717 (if (re-search-forward
2718 (concat "^[ \t]*\\(pro\\|function\\)[ \t]+"
2719 (downcase module)
2720 "[ \t\n,]") nil t)
2721 (progn
2722 (goto-char (match-beginning 1))
2723 (message "Setting breakpoint for module %s" module)
2724 (idlwave-shell-break-here))
2725 (message "Cannot find module %s in file %s" module source-file)
2726 (beep))))))))
2727
2728 (defun idlwave-shell-up ()
2729 "Run to end of current block.
2730 Sets a breakpoint with count 1 at end of block, then continues."
2731 (interactive)
2732 (if (idlwave-shell-pc-frame)
2733 (save-excursion
2734 (idlwave-shell-goto-frame)
2735 ;; find end of subprogram
2736 (let ((eos (save-excursion
2737 (idlwave-beginning-of-subprogram)
2738 (idlwave-forward-block)
2739 (point))))
2740 (idlwave-backward-up-block -1)
2741 ;; move beyond end block line - IDL will not break there.
2742 ;; That is, you can put a breakpoint there but when IDL does
2743 ;; break it will report that it is at the next line.
2744 (idlwave-next-statement)
2745 (idlwave-end-of-statement)
2746 ;; Make sure we are not beyond subprogram
2747 (if (< (point) eos)
2748 ;; okay
2749 ()
2750 ;; Move back inside subprogram
2751 (goto-char eos)
2752 (idlwave-previous-statement))
2753 (idlwave-shell-to-here)))))
2754
2755 (defun idlwave-shell-out ()
2756 "Attempt to run until this procedure exits.
2757 Runs to the last statement and then steps 1 statement. Use the .out command."
2758 (interactive)
2759 (idlwave-shell-send-command ".o" nil
2760 (if (idlwave-shell-hide-p 'debug) 'mostly)
2761 nil t))
2762
2763 (defun idlwave-shell-goto-previous-bp ()
2764 "Move to the previous breakpoint in the buffer."
2765 (interactive)
2766 (idlwave-shell-move-to-bp -1))
2767 (defun idlwave-shell-goto-next-bp ()
2768 "Move to the next breakpoint in the buffer."
2769 (interactive)
2770 (idlwave-shell-move-to-bp 1))
2771
2772 (defun idlwave-shell-move-to-bp (dir)
2773 "Move to the next or previous breakpoint, depending on direction DIR."
2774 (let* ((frame (idlwave-shell-current-frame))
2775 (file (car frame))
2776 (orig-bp-line (nth 1 frame))
2777 (bp-alist idlwave-shell-bp-alist)
2778 (orig-func (if (> dir 0) '> '<))
2779 (closer-func (if (> dir 0) '< '>))
2780 bp got-bp bp-line cur-line)
2781 (while (setq bp (pop bp-alist))
2782 (when (string= file (car (car bp)))
2783 (setq got-bp 1)
2784 (setq cur-line (nth 1 (car bp)))
2785 (if (and
2786 (funcall orig-func cur-line orig-bp-line)
2787 (or (not bp-line) (funcall closer-func cur-line bp-line)))
2788 (setq bp-line cur-line))))
2789 (unless bp-line (error "No further breakpoints"))
2790 (goto-line bp-line)))
2791
2792 ;; Examine Commands ------------------------------------------------------
2793
2794 (defun idlwave-shell-help-expression (arg)
2795 "Print help on current expression. See `idlwave-shell-print'."
2796 (interactive "P")
2797 (idlwave-shell-print arg 'help))
2798
2799 (defmacro idlwave-shell-mouse-examine (help &optional ev)
2800 "Create a function for generic examination of expressions."
2801 `(lambda (event)
2802 "Expansion function for expression examination."
2803 (interactive "e")
2804 (let* ((drag-track (fboundp 'mouse-drag-track))
2805 (transient-mark-mode t)
2806 (zmacs-regions t)
2807 (tracker (if (featurep 'xemacs)
2808 (if (fboundp
2809 'default-mouse-track-event-is-with-button)
2810 'idlwave-xemacs-hack-mouse-track
2811 'mouse-track)
2812 ;; Emacs 22 no longer completes the drag with
2813 ;; mouse-drag-region, without an additional
2814 ;; event. mouse-drag-track does so.
2815 (if drag-track 'mouse-drag-track 'mouse-drag-region))))
2816 (funcall tracker event)
2817 (idlwave-shell-print (if (idlwave-region-active-p) '(4) nil)
2818 ,help ,ev))))
2819
2820 ;;; Begin terrible hack section -- XEmacs tests for button2 explicitly
2821 ;;; on drag events, calling drag-n-drop code if detected. Ughhh...
2822 (defun idlwave-default-mouse-track-event-is-with-button (event n)
2823 t)
2824
2825 (defun idlwave-xemacs-hack-mouse-track (event)
2826 (if (featurep 'xemacs)
2827 (let ((oldfunc (symbol-function
2828 'default-mouse-track-event-is-with-button)))
2829 (unwind-protect
2830 (progn
2831 (fset 'default-mouse-track-event-is-with-button
2832 'idlwave-default-mouse-track-event-is-with-button)
2833 (mouse-track event))
2834 (fset 'default-mouse-track-event-is-with-button oldfunc)))))
2835 ;;; End terrible hack section
2836
2837 (defun idlwave-shell-mouse-print (event)
2838 "Print value of variable at the mouse position, with `help'"
2839 (interactive "e")
2840 (funcall (idlwave-shell-mouse-examine nil) event))
2841
2842 (defun idlwave-shell-mouse-help (event)
2843 "Print value of variable at the mouse position, with `print'."
2844 (interactive "e")
2845 (funcall (idlwave-shell-mouse-examine 'help) event))
2846
2847 (defun idlwave-shell-examine-select (event)
2848 "Pop-up a list to select from for examining the expression"
2849 (interactive "e")
2850 (funcall (idlwave-shell-mouse-examine nil event) event))
2851
2852 (defmacro idlwave-shell-examine (help)
2853 "Create a function for key-driven expression examination."
2854 `(lambda ()
2855 (interactive)
2856 (idlwave-shell-print nil ,help)))
2857
2858 (defvar idlwave-shell-examine-label nil
2859 "Label to include with examine text if in a separate buffer.")
2860 (defvar idlwave-shell-examine-completion-list nil)
2861
2862 (defun idlwave-shell-print (arg &optional help ev complete-help-type)
2863 "Print current expression.
2864
2865 With HELP non-nil, show help on expression. If HELP is a string,
2866 the expression will be put in place of ___, e.g.:
2867
2868 print,size(___,/DIMENSIONS)
2869
2870 HELP can also be a cons cell ( NAME . STRING ) in which case NAME will
2871 be used to label the help print-out.
2872
2873 Otherwise, print is called on the expression.
2874
2875 An expression is an identifier plus 1 pair of matched parentheses
2876 directly following the identifier - an array or function call.
2877 Alternatively, an expression is the contents of any matched
2878 parentheses when the open parenthesis is not directly preceded by an
2879 identifier. If point is at the beginning or within an expression
2880 return the inner-most containing expression, otherwise, return the
2881 preceding expression.
2882
2883 With prefix arg, or if transient mode set and the region is defined,
2884 use the current region as the expression.
2885
2886 With double prefix arg ARG prompt for an expression.
2887
2888 If EV is a valid event passed, pop-up a list from
2889 idlw-shell-examine-alist from which to select the help command text.
2890 If instead COMPLETE-HELP-TYPE is non-nil, choose from
2891 idlw-shell-examine-alist via mini-buffer shortcut key."
2892 (interactive "P")
2893
2894 ;; For speed: assume the helper routine hasn't been lost, e.g. with
2895 ;; .FULL_RESET_SESSION. We'll recover if necessary
2896 (unless idlwave-idlwave_routine_info-compiled
2897 (idlwave-shell-compile-helper-routines))
2898 (save-excursion
2899 (let* ((process (get-buffer-process (current-buffer)))
2900 (process-mark (if process (process-mark process)))
2901 (stack-label
2902 (if (and (integerp idlwave-shell-calling-stack-index)
2903 (> idlwave-shell-calling-stack-index 0))
2904 (format " [-%d:%s]"
2905 idlwave-shell-calling-stack-index
2906 idlwave-shell-calling-stack-routine)))
2907 expr beg end cmd)
2908 (cond
2909 ((equal arg '(16))
2910 (setq expr (read-string "Expression: ")))
2911 ((and (or arg (idlwave-region-active-p))
2912 (< (- (region-end) (region-beginning)) 2000))
2913 (setq beg (region-beginning)
2914 end (region-end)))
2915 (t
2916 (idlwave-with-special-syntax
2917 ;; Move to beginning of current or previous expression
2918 (if (looking-at "\\<\\|(")
2919 ;; At beginning of expression, don't move backwards unless
2920 ;; this is at the end of an indentifier.
2921 (if (looking-at "\\>")
2922 (backward-sexp))
2923 (backward-sexp))
2924 (if (looking-at "\\>")
2925 ;; Move to beginning of identifier - must be an array or
2926 ;; function expression.
2927 (backward-sexp))
2928 ;; Move to end of expression
2929 (setq beg (point))
2930 (forward-sexp)
2931 (while (looking-at "\\>[[(]\\|\\.")
2932 ;; an array
2933 (forward-sexp))
2934 (setq end (point)))))
2935
2936 ;; Get expression, but first move the begin mark if a
2937 ;; process-mark is inside the region, to keep the overlay from
2938 ;; wandering in the Shell.
2939 (when (and beg end)
2940 (if (and process-mark (> process-mark beg) (< process-mark end))
2941 (setq beg (marker-position process-mark)))
2942 (setq expr (buffer-substring beg end)))
2943
2944 ;; Show the overlay(s) and attach any necessary hooks and filters
2945 (when (and beg end idlwave-shell-expression-overlay)
2946 (move-overlay idlwave-shell-expression-overlay beg end
2947 (current-buffer))
2948 (add-hook 'pre-command-hook
2949 'idlwave-shell-delete-expression-overlay))
2950 (add-hook 'pre-command-hook
2951 'idlwave-shell-delete-output-overlay)
2952
2953 ;; Remove empty or comment-only lines
2954 (while (string-match "\n[ \t]*\\(;.*\\)?\r*\n" expr)
2955 (setq expr (replace-match "\n" t t expr)))
2956 ;; Concatenate continuation lines
2957 (while (string-match "[ \t]*\\$[ \t]*\\(;.*\\)?\\(\n[ \t]*\\|$\\)" expr)
2958 (setq expr (replace-match "" t t expr)))
2959 ;; Remove final newline
2960 (if (string-match "\n[ \t\r]*\\'" expr)
2961 (setq expr (replace-match "" t t expr)))
2962
2963 (catch 'exit
2964 ;; Pop-up or complete on the examine selection list, if appropriate
2965 (if (or
2966 complete-help-type
2967 (and ev idlwave-shell-examine-alist)
2968 (consp help))
2969 (let ((help-cons
2970 (if (consp help) help
2971 (assoc
2972 ;; A cons from either a pop-up or mini-buffer completion
2973 (if complete-help-type
2974 (idlwave-one-key-select 'idlwave-shell-examine-alist
2975 "Examine with: " 1.5)
2976 ;; (idlwave-completing-read
2977 ;; "Examine with: "
2978 ;; idlwave-shell-examine-alist nil nil nil
2979 ;; 'idlwave-shell-examine-completion-list
2980 ;; "Print")
2981 (idlwave-popup-select
2982 ev
2983 (mapcar 'car idlwave-shell-examine-alist)
2984 "Examine with"))
2985 idlwave-shell-examine-alist))))
2986 (setq help (cdr help-cons))
2987 (if (null help) (throw 'exit nil))
2988 (if idlwave-shell-separate-examine-output
2989 (setq idlwave-shell-examine-label
2990 (concat
2991 (format "==>%s<==\n%s:" expr (car help-cons))
2992 stack-label "\n"))))
2993 ;; The regular help label (no popups, cons cells, etc.)
2994 (setq idlwave-shell-examine-label
2995 (concat
2996 (format "==>%s<==\n%s:" expr
2997 (cond ((null help) "print")
2998 ((stringp help) help)
2999 (t (symbol-name help))))
3000 stack-label "\n")))
3001
3002 ;; Send the command
3003 (if stack-label
3004 (setq expr (idlwave-retrieve-expression-from-level
3005 expr
3006 idlwave-shell-calling-stack-index)))
3007 (setq cmd (idlwave-shell-help-statement help expr))
3008 ;;(idlwave-shell-recenter-shell-window)
3009 (idlwave-shell-send-command
3010 cmd
3011 'idlwave-shell-check-compiled-and-display
3012 (if idlwave-shell-separate-examine-output 'hide))))))
3013
3014 (defvar idlwave-shell-examine-window-alist nil
3015 "Variable to hold the win/height pairs for all *Examine* windows.")
3016
3017 (defvar idlwave-shell-examine-map (make-sparse-keymap))
3018 (define-key idlwave-shell-examine-map "q" 'idlwave-shell-examine-display-quit)
3019 (define-key idlwave-shell-examine-map "c" 'idlwave-shell-examine-display-clear)
3020
3021
3022 (defun idlwave-shell-check-compiled-and-display ()
3023 "Check examine output for warning about undefined procedure/function."
3024 (if (string-match "% Attempt to call undefined" idlwave-shell-command-output)
3025 (idlwave-shell-compile-helper-routines))
3026 (if idlwave-shell-separate-examine-output
3027 (idlwave-shell-examine-display)
3028 (idlwave-shell-examine-highlight)))
3029
3030 (defun idlwave-shell-examine-display ()
3031 "View the examine command output in a separate buffer."
3032 (let (win cur-beg cur-end)
3033 (save-excursion
3034 (set-buffer (get-buffer-create "*Examine*"))
3035 (use-local-map idlwave-shell-examine-map)
3036 (setq buffer-read-only nil)
3037 (goto-char (point-max))
3038 (save-restriction
3039 (narrow-to-region (point) (point))
3040 (if (string-match "^% Syntax error." idlwave-shell-command-output)
3041 (insert "% Syntax error.\n")
3042 (insert idlwave-shell-command-output)
3043 ;; Just take the last bit between the prompts (if more than one).
3044 (let* ((end (or
3045 (re-search-backward idlwave-shell-prompt-pattern nil t)
3046 (point-max)))
3047 (beg (progn
3048 (goto-char
3049 (or (progn (if (re-search-backward
3050 idlwave-shell-prompt-pattern nil t)
3051 (match-end 0)))
3052 (point-min)))
3053 (re-search-forward "\n")))
3054 (str (buffer-substring beg end)))
3055 (delete-region (point-min) (point-max))
3056 (insert str)
3057 (if idlwave-shell-examine-label
3058 (progn (goto-char (point-min))
3059 (insert idlwave-shell-examine-label)
3060 (setq idlwave-shell-examine-label nil)))))
3061 (setq cur-beg (point-min)
3062 cur-end (point-max))
3063 (setq buffer-read-only t)
3064 (move-overlay idlwave-shell-output-overlay cur-beg cur-end
3065 (current-buffer))
3066
3067 ;; Look for the examine buffer in all windows. If one is
3068 ;; found in a frame all by itself, use that, otherwise, switch
3069 ;; to or create an examine window in this frame, and resize if
3070 ;; it's a newly created window
3071 (let* ((winlist (get-buffer-window-list "*Examine*" nil 'visible)))
3072 (setq win (idlwave-display-buffer
3073 "*Examine*"
3074 nil
3075 (let ((list winlist) thiswin)
3076 (catch 'exit
3077 (save-selected-window
3078 (while (setq thiswin (pop list))
3079 (select-window thiswin)
3080 (if (one-window-p)
3081 (throw 'exit (window-frame thiswin)))))))))
3082 (set-window-start win (point-min)) ; Ensure the point is visible.
3083 (save-selected-window
3084 (select-window win)
3085 (let ((elt (assoc win idlwave-shell-examine-window-alist)))
3086 (when (and (not (one-window-p))
3087 (or (not (memq win winlist)) ;a newly created window
3088 (eq (window-height) (cdr elt))))
3089 ;; Autosize it.
3090 (enlarge-window (- (/ (frame-height) 2)
3091 (window-height)))
3092 (shrink-window-if-larger-than-buffer)
3093 ;; Clean the window list of dead windows
3094 (setq idlwave-shell-examine-window-alist
3095 (delq nil
3096 (mapcar (lambda (x) (if (window-live-p (car x)) x))
3097 idlwave-shell-examine-window-alist)))
3098 ;; And add the new value.
3099 (if (setq elt (assoc win idlwave-shell-examine-window-alist))
3100 (setcdr elt (window-height))
3101 (add-to-list 'idlwave-shell-examine-window-alist
3102 (cons win (window-height)))))))))
3103 ;; Recenter for maximum output, after widened
3104 (save-selected-window
3105 (select-window win)
3106 (goto-char (point-max))
3107 (skip-chars-backward "\n")
3108 (recenter -1)))))
3109
3110 (defun idlwave-shell-examine-display-quit ()
3111 (interactive)
3112 (let ((win (selected-window)))
3113 (if (one-window-p)
3114 (delete-frame (window-frame win))
3115 (delete-window win))))
3116
3117 (defun idlwave-shell-examine-display-clear ()
3118 (interactive)
3119 (save-excursion
3120 (let ((buf (get-buffer "*Examine*")))
3121 (when (bufferp buf)
3122 (set-buffer buf)
3123 (setq buffer-read-only nil)
3124 (erase-buffer)
3125 (setq buffer-read-only t)))))
3126
3127 (defun idlwave-retrieve-expression-from-level (expr level)
3128 "Return IDL command to print the expression EXPR from stack level LEVEL.
3129
3130 It does not seem possible to evaluate an expression on a different
3131 level than the current. Therefore, this function retrieves variables
3132 by reference from other levels, and then includes that variable in
3133 place of the chosen one.
3134
3135 Since this function depends upon the undocumented IDL routine
3136 routine_names, there is no guarantee that this will work with future
3137 versions of IDL."
3138 (let ((fetch (- 0 level))
3139 (start 0)
3140 var fetch-start fetch-end pre post)
3141
3142 ;; FIXME: In the following we try to find the variables in expression
3143 ;; This is quite empirical - I don't know in what situations this will
3144 ;; break. We will look for identifiers and exclude cases where we
3145 ;; know it is not a variable. To distinguish array references from
3146 ;; function calls, we require that arrays use [] instead of ()
3147
3148 (while (string-match
3149 "\\(\\`\\|[^a-zA-Z0-9$_][ \t]*\\)\\([a-zA-Z][a-zA-Z0-9$_]*\\)\\([ \t]*[^a-zA-Z0-9$_]\\|\\'\\)" expr start)
3150 (setq var (match-string 2 expr)
3151 start (match-end 2)
3152 pre (substring expr 0 (match-beginning 2))
3153 post (substring expr (match-end 2)))
3154 (cond
3155 ((or
3156 ;; Exclude identifiers which are not variables
3157 (string-match ",[ \t$\n]*/\\'" pre) ;; a `/' KEYWORD
3158 (and (string-match "[,(][ \t\n]*\\'" pre)
3159 (string-match "\\`[ \t]*=" post)) ;; a `=' KEYWORD
3160 (string-match "\\`(" post) ;; a function
3161 (string-match "->[ \t]*\\'" pre) ;; a method
3162 (string-match "\\.\\'" pre))) ;; structure member
3163
3164 ;; Skip over strings
3165 ((and (string-match "\\([\"\']\\)[^\1]*$" pre)
3166 (string-match (concat "^[^" (match-string 1 pre) "]*"
3167 (match-string 1 pre)) post))
3168 (setq start (+ start (match-end 0))))
3169
3170
3171 ;; seems to be a variable - delimit its name
3172 (t
3173 (put-text-property start (- start (length var)) 'fetch t expr))))
3174
3175 (setq start 0)
3176 (while (setq fetch-start
3177 (next-single-property-change start 'fetch expr))
3178 (if (get-text-property start 'fetch expr) ; it's on in range
3179 (setq fetch-end fetch-start ;it's off in range
3180 fetch-start start)
3181 (setq fetch-end (next-single-property-change fetch-start 'fetch expr)))
3182 (unless fetch-end (setq fetch-end (length expr)))
3183 (remove-text-properties fetch-start fetch-end '(fetch) expr)
3184 (setq expr (concat (substring expr 0 fetch-start)
3185 (format "(routine_names('%s',fetch=%d))"
3186 (substring expr fetch-start fetch-end)
3187 fetch)
3188 (substring expr fetch-end)))
3189 (setq start fetch-end))
3190 (if (get-text-property 0 'fetch expr) ; Full expression, left over
3191 (setq expr (format "(routine_names('%s',fetch=%d))" expr fetch)))
3192 expr))
3193
3194
3195 (defun idlwave-shell-help-statement (help expr)
3196 "Construct a help statement for printing expression EXPR.
3197
3198 HELP can be non-nil for `help,', nil for 'print,' or any string into which
3199 to insert expression in place of the marker ___, e.g.: print,
3200 size(___,/DIMENSIONS)"
3201 (cond
3202 ((null help)
3203 (concat "idlwave_print_safe, " expr ","
3204 (number-to-string idlwave-shell-max-print-length)))
3205 ((stringp help)
3206 (if (string-match "\\(^\\|[^_]\\)\\(___\\)\\([^_]\\|$\\)" help)
3207 (concat (substring help 0 (match-beginning 2))
3208 expr
3209 (substring help (match-end 2)))))
3210 (t
3211 (concat "help, " expr))))
3212
3213
3214 (defun idlwave-shell-examine-highlight ()
3215 "Highlight the most recent IDL output."
3216 (let* ((buffer (get-buffer (idlwave-shell-buffer)))
3217 (process (get-buffer-process buffer))
3218 (process-mark (if process (process-mark process)))
3219 output-begin output-end)
3220 (save-excursion
3221 (set-buffer buffer)
3222 (goto-char process-mark)
3223 (beginning-of-line)
3224 (setq output-end (point))
3225 (re-search-backward idlwave-shell-prompt-pattern nil t)
3226 (beginning-of-line 2)
3227 (setq output-begin (point)))
3228
3229 ;; First make sure the shell window is visible
3230 (idlwave-display-buffer (idlwave-shell-buffer)
3231 nil (idlwave-shell-shell-frame))
3232 (if (and idlwave-shell-output-overlay process-mark)
3233 (move-overlay idlwave-shell-output-overlay
3234 output-begin output-end buffer))))
3235
3236 (defun idlwave-shell-delete-output-overlay ()
3237 (unless (or (eq this-command 'idlwave-shell-mouse-nop)
3238 (eq this-command 'handle-switch-frame))
3239 (condition-case nil
3240 (if idlwave-shell-output-overlay
3241 (delete-overlay idlwave-shell-output-overlay))
3242 (error nil))
3243 (remove-hook 'pre-command-hook 'idlwave-shell-delete-output-overlay)))
3244
3245 (defun idlwave-shell-delete-expression-overlay ()
3246 (unless (or (eq this-command 'idlwave-shell-mouse-nop)
3247 (eq this-command 'handle-switch-frame))
3248 (condition-case nil
3249 (if idlwave-shell-expression-overlay
3250 (delete-overlay idlwave-shell-expression-overlay))
3251 (error nil))
3252 (remove-hook 'pre-command-hook 'idlwave-shell-delete-expression-overlay)))
3253
3254 (defvar idlwave-shell-bp-alist nil
3255 "Alist of breakpoints.
3256 A breakpoint is a cons cell \(\(file line\) . \(\(index module\) data\)\)
3257
3258 The car is the `frame' for the breakpoint:
3259 file - full path file name.
3260 line - line number of breakpoint - integer.
3261
3262 The first element of the cdr is a list of internal IDL data:
3263 index - the index number of the breakpoint internal to IDL.
3264 module - the module for breakpoint internal to IDL.
3265
3266 Remaining elements of the cdr:
3267 data - Data associated with the breakpoint by idlwave-shell currently
3268 contains four items:
3269
3270 count - number of times to execute breakpoint. When count reaches 0
3271 the breakpoint is cleared and removed from the alist.
3272
3273 command - command to execute when breakpoint is reached, either a
3274 lisp function to be called with `funcall' with no arguments or a
3275 list to be evaluated with `eval'.
3276
3277 condition - any condition to apply to the breakpoint.
3278
3279 disabled - whether the bp is disabled")
3280
3281 (defun idlwave-shell-run-region (beg end &optional n)
3282 "Compile and run the region using the IDL process.
3283 Copies the region to a temporary file `idlwave-shell-temp-pro-file'
3284 and issues the IDL .run command for the file. Because the
3285 region is compiled and run as a main program there is no
3286 problem with begin-end blocks extending over multiple
3287 lines - which would be a problem if `idlwave-shell-evaluate-region'
3288 was used. An END statement is appended to the region if necessary.
3289
3290 If there is a prefix argument, display IDL process."
3291 (interactive "r\nP")
3292 (let ((oldbuf (current-buffer)))
3293 (save-excursion
3294 (set-buffer (idlwave-find-file-noselect
3295 (idlwave-shell-temp-file 'pro) 'tmp))
3296 (set (make-local-variable 'comment-start-skip) ";+[ \t]*")
3297 (set (make-local-variable 'comment-start) ";")
3298 (erase-buffer)
3299 (insert-buffer-substring oldbuf beg end)
3300 (if (not (save-excursion
3301 (idlwave-previous-statement)
3302 (idlwave-look-at "\\<end\\>")))
3303 (insert "\nend\n"))
3304 (save-buffer 0)))
3305 (idlwave-shell-send-command (concat ".run \""
3306 idlwave-shell-temp-pro-file "\"")
3307 nil
3308 (if (idlwave-shell-hide-p 'run) 'mostly)
3309 nil t)
3310 (if n
3311 (idlwave-display-buffer (idlwave-shell-buffer)
3312 nil (idlwave-shell-shell-frame))))
3313
3314 (defun idlwave-shell-evaluate-region (beg end &optional n)
3315 "Send region to the IDL process.
3316 If there is a prefix argument, display IDL process.
3317 Does not work for a region with multiline blocks - use
3318 `idlwave-shell-run-region' for this."
3319 (interactive "r\nP")
3320 (idlwave-shell-send-command (buffer-substring beg end))
3321 (if n
3322 (idlwave-display-buffer (idlwave-shell-buffer)
3323 nil (idlwave-shell-shell-frame))))
3324
3325 (defun idlwave-shell-delete-temp-files ()
3326 "Delete the temporary files and kill associated buffers."
3327 (if (stringp idlwave-shell-temp-pro-file)
3328 (condition-case nil
3329 (let ((buf (idlwave-get-buffer-visiting
3330 idlwave-shell-temp-pro-file)))
3331 (if (buffer-live-p buf)
3332 (kill-buffer buf))
3333 (delete-file idlwave-shell-temp-pro-file))
3334 (error nil)))
3335 (if (stringp idlwave-shell-temp-rinfo-save-file)
3336 (condition-case nil
3337 (delete-file idlwave-shell-temp-rinfo-save-file)
3338 (error nil))))
3339
3340 (defun idlwave-display-buffer (buf not-this-window-p &optional frame)
3341 (if (featurep 'xemacs)
3342 ;; The XEmacs version enforces the frame
3343 (display-buffer buf not-this-window-p frame)
3344 ;; For Emacs, we need to force the frame ourselves.
3345 (let ((this-frame (selected-frame)))
3346 (save-excursion ;; make sure we end up in the same buffer
3347 (if (frame-live-p frame)
3348 (select-frame frame))
3349 (if (eq this-frame (selected-frame))
3350 ;; same frame: use display buffer, to make sure the current
3351 ;; window stays.
3352 (display-buffer buf)
3353 ;; different frame
3354 (if (one-window-p)
3355 ;; only window: switch
3356 (progn
3357 (switch-to-buffer buf)
3358 (selected-window)) ; must return the window.
3359 ;; several windows - use display-buffer
3360 (display-buffer buf not-this-window-p)))))))
3361 ; (if (not (frame-live-p frame)) (setq frame nil))
3362 ; (display-buffer buf not-this-window-p frame))
3363
3364 (defvar idlwave-shell-bp-buffer " *idlwave-shell-bp*"
3365 "Scratch buffer for parsing IDL breakpoint lists and other stuff.")
3366
3367 (defun idlwave-shell-bp-query (&optional no-show)
3368 "Reconcile idlwave-shell's breakpoint list with IDL's.
3369 Queries IDL using the string in `idlwave-shell-bp-query'."
3370 (interactive)
3371 (idlwave-shell-send-command idlwave-shell-bp-query
3372 `(progn
3373 (idlwave-shell-filter-bp (quote ,no-show)))
3374 'hide))
3375
3376 (defun idlwave-shell-bp-get (bp &optional item)
3377 "Get a value for a breakpoint.
3378 BP has the form of elements in idlwave-shell-bp-alist. Optional
3379 second arg ITEM is the particular value to retrieve. ITEM can be
3380 'file, 'line, 'index, 'module, 'count, 'cmd, 'condition, 'disabled or
3381 'data. 'data returns a list of 'count, 'cmd and 'condition. Defaults
3382 to 'index."
3383 (cond
3384 ;; Frame
3385 ((eq item 'line) (nth 1 (car bp)))
3386 ((eq item 'file) (nth 0 (car bp)))
3387 ;; idlwave-shell breakpoint data
3388 ((eq item 'data) (cdr (cdr bp)))
3389 ((eq item 'count) (nth 0 (cdr (cdr bp))))
3390 ((eq item 'cmd) (nth 1 (cdr (cdr bp))))
3391 ((eq item 'condition) (nth 2 (cdr (cdr bp))))
3392 ((eq item 'disabled) (nth 3 (cdr (cdr bp))))
3393 ;; IDL breakpoint info
3394 ((eq item 'module) (nth 1 (car (cdr bp))))
3395 ;; index - default
3396 (t (nth 0 (car (cdr bp))))))
3397
3398 (defun idlwave-shell-filter-bp (&optional no-show)
3399 "Get the breakpoints from `idlwave-shell-command-output'. Create
3400 `idlwave-shell-bp-alist' updating breakpoint count and command data
3401 from previous breakpoint list. If NO-SHOW is set, don't update the
3402 breakpoint overlays."
3403 (save-excursion
3404 (set-buffer (get-buffer-create idlwave-shell-bp-buffer))
3405 (erase-buffer)
3406 (insert idlwave-shell-command-output)
3407 (goto-char (point-min))
3408 (let ((old-bp-alist idlwave-shell-bp-alist)
3409 ;; Searching the breakpoints
3410 ;; In IDL 5.5, the breakpoint reporting format changed.
3411 (bp-re54 "^[ \t]*\\([0-9]+\\)[ \t]+\\(\\S-+\\)?[ \t]+\\([0-9]+\\)[ \t]+\\(\\S-+\\)")
3412 (bp-re55
3413 (concat
3414 "^\\s-*\\([0-9]+\\)" ; 1 index
3415 "\\s-+\\([0-9]+\\)" ; 2 line number
3416 "\\s-+\\(Uncompiled\\|" ; 3-6 either uncompiled or routine name
3417 "\\(\\(Func=\\|Pro=\\)\\(\\$?[a-zA-Z][a-zA-Z0-9$_:]*\\$?\\)\\)\\)"
3418 "\\(\\s-*,\\s-*After=[0-9]+/\\([0-9]+\\)?\\)?" ; 7-8 After part
3419 "\\(\\s-*,\\s-*\\(BreakOnce\\)\\)?" ; 9-10 BreakOnce
3420 "\\(\\s-*,\\s-*\\(Condition='\\(.*\\)'\\)\n?\\)?" ; 11-13 Condition
3421 "\\(\\s-*,\\s-*\\(Disabled\\)\n?\\)?" ; 14-15 Disabled
3422 "\\s-+\\(\\S-+\\)")) ; 16 File name
3423 file line index module
3424 count condition disabled
3425 bp-re indmap)
3426 (setq idlwave-shell-bp-alist (list nil))
3427 ;; Search for either header type, and set the correct regexp
3428 (when (or
3429 (if (re-search-forward "^\\s-*Index.*\n\\s-*-" nil t)
3430 (setq bp-re bp-re54 ; versions <= 5.4
3431 indmap '(1 2 3 4))) ;index module line file
3432 (if (re-search-forward
3433 "^\\s-*Index\\s-*Line\\s-*Attributes\\s-*File" nil t)
3434 (setq bp-re bp-re55 ; versions >= 5.5
3435 indmap '(1 6 2 16)))) ; index module line file
3436 ;; There seems to be a breakpoint listing here, parse breakpoint lines.
3437 (while (re-search-forward bp-re nil t)
3438 (setq index (string-to-number (match-string (nth 0 indmap)))
3439 module (match-string (nth 1 indmap))
3440 line (string-to-number (match-string (nth 2 indmap)))
3441 file (idlwave-shell-file-name (match-string (nth 3 indmap))))
3442 (if (eq bp-re bp-re55)
3443 (setq count (if (match-string 10) 1
3444 (if (match-string 8)
3445 (string-to-number (match-string 8))))
3446 condition (match-string 13)
3447 disabled (not (null (match-string 15)))))
3448
3449 ;; Add the breakpoint info to the list
3450 (nconc idlwave-shell-bp-alist
3451 (list (cons (list file line)
3452 (list
3453 (list index module)
3454 ;; bp data: count, command, condition, disabled
3455 count nil condition disabled))))))
3456 (setq idlwave-shell-bp-alist (cdr idlwave-shell-bp-alist))
3457 ;; Update breakpoint data
3458 (if (eq bp-re bp-re54)
3459 (mapcar 'idlwave-shell-update-bp old-bp-alist)
3460 (mapcar 'idlwave-shell-update-bp-command-only old-bp-alist))))
3461 ;; Update the breakpoint overlays
3462 (unless no-show (idlwave-shell-update-bp-overlays))
3463 ;; Return the new list
3464 idlwave-shell-bp-alist)
3465
3466 (defun idlwave-shell-update-bp-command-only (bp)
3467 (idlwave-shell-update-bp bp t))
3468
3469 (defun idlwave-shell-update-bp (bp &optional command-only)
3470 "Update BP data in breakpoint list.
3471 If BP frame is in `idlwave-shell-bp-alist' updates the breakpoint data."
3472 (let ((match (assoc (car bp) idlwave-shell-bp-alist)))
3473 (if match
3474 (if command-only
3475 (setf (nth 1 (cdr (cdr match))) (nth 1 (cdr (cdr match))))
3476 (setcdr (cdr match) (cdr (cdr bp)))))))
3477
3478 (defun idlwave-shell-set-bp-data (bp data)
3479 "Set the data of BP to DATA."
3480 (setcdr (cdr bp) data))
3481
3482 (defun idlwave-shell-bp (frame &optional data module)
3483 "Create a breakpoint structure containing FRAME and DATA. Second
3484 and third args, DATA and MODULE, are optional. Returns a breakpoint
3485 of the format used in `idlwave-shell-bp-alist'. Can be used in commands
3486 attempting match a breakpoint in `idlwave-shell-bp-alist'."
3487 (cons frame (cons (list nil module) data)))
3488
3489 (defvar idlwave-shell-old-bp nil
3490 "List of breakpoints previous to setting a new breakpoint.")
3491
3492 (defun idlwave-shell-sources-bp (bp)
3493 "Check `idlwave-shell-sources-alist' for source of breakpoint using BP.
3494 If an equivalency is found, return the IDL internal source name.
3495 Otherwise return the filename in bp."
3496 (let*
3497 ((bp-file (idlwave-shell-bp-get bp 'file))
3498 (bp-module (idlwave-shell-bp-get bp 'module))
3499 (internal-file-list
3500 (if bp-module
3501 (cdr (assoc bp-module idlwave-shell-sources-alist)))))
3502 (if (and internal-file-list
3503 (equal bp-file (nth 0 internal-file-list)))
3504 (nth 1 internal-file-list)
3505 bp-file)))
3506
3507 (defun idlwave-shell-set-bp (bp &optional no-show)
3508 "Try to set a breakpoint BP.
3509 The breakpoint will be placed at the beginning of the statement on the
3510 line specified by BP or at the next IDL statement if that line is not
3511 a statement. Determines IDL's internal representation for the
3512 breakpoint, which may have occurred at a different line than
3513 specified. If NO-SHOW is non-nil, don't do any updating."
3514 ;; Get and save the old breakpoints
3515 (idlwave-shell-send-command
3516 idlwave-shell-bp-query
3517 `(progn
3518 (idlwave-shell-filter-bp (quote ,no-show))
3519 (setq idlwave-shell-old-bp idlwave-shell-bp-alist))
3520 'hide)
3521
3522 ;; Get sources for this routine in the sources list
3523 (idlwave-shell-module-source-query (idlwave-shell-bp-get bp 'module))
3524 (let*
3525 ((arg (idlwave-shell-bp-get bp 'count))
3526 (key (cond
3527 ((not (and arg (numberp arg))) "")
3528 ((= arg 1)
3529 ",/once")
3530 ((> arg 1)
3531 (format ",after=%d" arg))))
3532 (condition (idlwave-shell-bp-get bp 'condition))
3533 (disabled (idlwave-shell-bp-get bp 'disabled))
3534 (key (concat key
3535 (if condition (concat ",CONDITION=\"" condition "\""))))
3536 (key (concat key (if disabled ",/DISABLE")))
3537 (line (idlwave-shell-bp-get bp 'line)))
3538 (idlwave-shell-send-command
3539 (concat "breakpoint,'"
3540 (idlwave-shell-sources-bp bp) "',"
3541 (if (integerp line) (setq line (int-to-string line)))
3542 key)
3543 ;; Check for failure and adjust breakpoint to match IDL's list
3544 `(progn
3545 (if (idlwave-shell-set-bp-check (quote ,bp))
3546 (idlwave-shell-set-bp-adjust (quote ,bp) (quote ,no-show))))
3547 ;; hide output?
3548 (idlwave-shell-hide-p 'breakpoint)
3549 'preempt t)))
3550
3551 (defun idlwave-shell-set-bp-adjust (bp &optional no-show)
3552 "Find the breakpoint in IDL's internal list of breakpoints."
3553 (idlwave-shell-send-command
3554 idlwave-shell-bp-query
3555 `(progn
3556 (idlwave-shell-filter-bp 'no-show)
3557 (idlwave-shell-new-bp (quote ,bp))
3558 (unless (quote ,no-show)
3559 (idlwave-shell-update-bp-overlays)))
3560 'hide
3561 'preempt))
3562
3563 (defun idlwave-shell-find-bp (frame)
3564 "Return breakpoint from `idlwave-shell-bp-alist' for frame.
3565 Returns nil if frame not found."
3566 (assoc frame idlwave-shell-bp-alist))
3567
3568 (defun idlwave-shell-find-current-bp ()
3569 "Find breakpoint here, or at halt location."
3570 (let ((bp (idlwave-shell-find-bp (idlwave-shell-current-frame))))
3571 (when (not bp)
3572 ;; Try moving to beginning of halted-at statement
3573 (save-excursion
3574 (idlwave-shell-goto-frame)
3575 (idlwave-beginning-of-statement)
3576 (setq bp (idlwave-shell-find-bp (idlwave-shell-current-frame))))
3577 (unless bp
3578 (beep)
3579 (message "Cannot identify breakpoint for this line")))
3580 bp))
3581
3582 (defun idlwave-shell-new-bp (bp)
3583 "Find the new breakpoint in IDL's list and update with DATA.
3584 The actual line number for a breakpoint in IDL may be different than
3585 the line number used with the IDL breakpoint command.
3586 Looks for a new breakpoint index number in the list. This is
3587 considered the new breakpoint if the file name of frame matches."
3588 (let ((obp-index (mapcar 'idlwave-shell-bp-get idlwave-shell-old-bp))
3589 (bpl idlwave-shell-bp-alist))
3590 (while (and (member (idlwave-shell-bp-get (car bpl)) obp-index)
3591 (setq bpl (cdr bpl))))
3592 (if (and
3593 (not bpl)
3594 ;; No additional breakpoint.
3595 ;; Need to check if we are just replacing a breakpoint.
3596 (setq bpl (assoc (car bp) idlwave-shell-bp-alist)))
3597 (setq bpl (list bpl)))
3598 (if (and bpl
3599 (equal (idlwave-shell-bp-get (setq bpl (car bpl)) 'file)
3600 (idlwave-shell-bp-get bp 'file)))
3601 ;; Got the breakpoint - add count, command to it.
3602 ;; This updates `idlwave-shell-bp-alist' because a deep copy was
3603 ;; not done for bpl.
3604 (idlwave-shell-set-bp-data bpl (idlwave-shell-bp-get bp 'data))
3605 (beep)
3606 (message "Failed to identify breakpoint in IDL"))))
3607
3608 (defvar idlwave-shell-bp-overlays nil
3609 "Alist of overlays marking breakpoints")
3610 (defvar idlwave-shell-bp-glyph)
3611
3612 (defvar idlwave-shell-debug-line-map (make-sparse-keymap))
3613 (define-key idlwave-shell-debug-line-map
3614 (if (featurep 'xemacs) [button3] [mouse-3])
3615 'idlwave-shell-mouse-active-bp)
3616
3617 (defun idlwave-shell-update-bp-overlays ()
3618 "Update the overlays which mark breakpoints in the source code.
3619 Existing overlays are recycled, in order to minimize consumption."
3620 (when idlwave-shell-mark-breakpoints
3621 (let ((ov-alist (copy-alist idlwave-shell-bp-overlays))
3622 (bp-list idlwave-shell-bp-alist)
3623 (use-glyph (and (memq idlwave-shell-mark-breakpoints '(t glyph))
3624 idlwave-shell-bp-glyph))
3625 ov ov-list bp buf old-buffers win)
3626
3627 ;; Delete the old overlays from their buffers
3628 (if ov-alist
3629 (while (setq ov-list (pop ov-alist))
3630 (while (setq ov (pop (cdr ov-list)))
3631 (add-to-list 'old-buffers (overlay-buffer ov))
3632 (delete-overlay ov))))
3633
3634 (setq ov-alist idlwave-shell-bp-overlays
3635 idlwave-shell-bp-overlays
3636 (if idlwave-shell-bp-glyph
3637 (mapcar 'list (mapcar 'car idlwave-shell-bp-glyph))
3638 (list (list 'bp))))
3639 (while (setq bp (pop bp-list))
3640 (save-excursion
3641 (idlwave-shell-goto-frame (car bp))
3642 (let* ((end (progn (end-of-line 1) (point)))
3643 (beg (progn (beginning-of-line 1) (point)))
3644 (condition (idlwave-shell-bp-get bp 'condition))
3645 (count (idlwave-shell-bp-get bp 'count))
3646 (disabled (idlwave-shell-bp-get bp 'disabled))
3647 (type (if idlwave-shell-bp-glyph
3648 (cond
3649 (condition 'bp-cond )
3650 (count
3651 (cond
3652 ((<= count 0) 'bp)
3653 ((<= count 4)
3654 (intern
3655 (concat "bp-" (number-to-string count))))
3656 (t 'bp-n)))
3657 (t 'bp))
3658 'bp))
3659 (help-list
3660 (delq nil
3661 (list
3662 (if count
3663 (concat "after:" (int-to-string count)))
3664 (if condition
3665 (concat "condition:" condition))
3666 (if disabled "disabled"))))
3667 (help-text (concat
3668 "BP "
3669 (int-to-string (idlwave-shell-bp-get bp))
3670 (if help-list
3671 (concat
3672 " - "
3673 (mapconcat 'identity help-list ", ")))
3674 (if (and (not count) (not condition))
3675 " (use mouse-3 for breakpoint actions)")))
3676 (full-type (if disabled
3677 (intern (concat (symbol-name type)
3678 "-disabled"))
3679 type))
3680 (ov-existing (assq full-type ov-alist))
3681 (ov (or (and (cdr ov-existing)
3682 (pop (cdr ov-existing)))
3683 (idlwave-shell-make-new-bp-overlay type disabled)))
3684 match)
3685 (if idlwave-shell-breakpoint-popup-menu
3686 (overlay-put ov 'help-echo help-text))
3687 (move-overlay ov beg end)
3688 (if (setq match (assq full-type idlwave-shell-bp-overlays))
3689 (push ov (cdr match))
3690 (nconc idlwave-shell-bp-overlays
3691 (list (list full-type ov)))))
3692 ;; Take care of margins if using a glyph
3693 (when use-glyph
3694 (if old-buffers
3695 (setq old-buffers (delq (current-buffer) old-buffers)))
3696 (if (fboundp 'set-specifier) ;; XEmacs
3697 (set-specifier left-margin-width (cons (current-buffer) 2))
3698 (setq left-margin-width 2))
3699 (if (setq win (get-buffer-window (current-buffer) t))
3700 (set-window-buffer win (current-buffer))))))
3701 (if use-glyph
3702 (while (setq buf (pop old-buffers))
3703 (with-current-buffer buf
3704 (if (fboundp 'set-specifier) ;; XEmacs
3705 (set-specifier left-margin-width (cons (current-buffer) 0))
3706 (setq left-margin-width 0))
3707 (if (setq win (get-buffer-window buf t))
3708 (set-window-buffer win buf))))))))
3709
3710 (defun idlwave-shell-make-new-bp-overlay (&optional type disabled)
3711 "Make a new overlay for highlighting breakpoints.
3712
3713 This stuff is strongly dependant upon the version of Emacs. If TYPE
3714 is passed, make an overlay of that type ('bp or 'bp-cond, currently
3715 only for glyphs)."
3716 (let ((ov (make-overlay 1 1))
3717 (use-glyph (and (memq idlwave-shell-mark-breakpoints '(t glyph))
3718 idlwave-shell-bp-glyph))
3719 (type (or type 'bp))
3720 (face (if disabled
3721 idlwave-shell-disabled-breakpoint-face
3722 idlwave-shell-breakpoint-face)))
3723 (if (featurep 'xemacs)
3724 ;; This is XEmacs
3725 (progn
3726 (when idlwave-shell-breakpoint-popup-menu
3727 (set-extent-property ov 'mouse-face 'highlight)
3728 (set-extent-property ov 'keymap idlwave-shell-debug-line-map))
3729
3730 (cond
3731 ;; tty's cannot display glyphs
3732 ((eq (console-type) 'tty)
3733 (set-extent-property ov 'face face))
3734
3735 ;; use the glyph
3736 (use-glyph
3737 (let ((glyph (cdr (assq type idlwave-shell-bp-glyph))))
3738 (if disabled (setq glyph (car glyph)) (setq glyph (nth 1 glyph)))
3739 (set-extent-property ov 'begin-glyph glyph)
3740 (set-extent-property ov 'begin-glyph-layout 'outside-margin)))
3741
3742 ;; use the face
3743 (idlwave-shell-mark-breakpoints
3744 (set-extent-property ov 'face face))
3745
3746 ;; no marking
3747 (t nil))
3748 (set-extent-priority ov -1)) ; make stop line face prevail
3749 ;; This is Emacs
3750 (when idlwave-shell-breakpoint-popup-menu
3751 (overlay-put ov 'mouse-face 'highlight)
3752 (overlay-put ov 'keymap idlwave-shell-debug-line-map))
3753 (cond
3754 (window-system
3755 (if use-glyph
3756 (let ((image-props (cdr (assq type idlwave-shell-bp-glyph)))
3757 string)
3758
3759 (if disabled (setq image-props
3760 (append image-props
3761 (list :conversion 'disabled))))
3762 (setq string
3763 (propertize "@"
3764 'display
3765 (list (list 'margin 'left-margin)
3766 image-props)))
3767 (overlay-put ov 'before-string string))
3768 ;; just the face
3769 (overlay-put ov 'face face)))
3770
3771 ;; use a face
3772 (idlwave-shell-mark-breakpoints
3773 (overlay-put ov 'face face))
3774
3775 ;; No marking
3776 (t nil)))
3777 ov))
3778
3779 (defun idlwave-shell-mouse-active-bp (ev)
3780 "Does right-click mouse action on breakpoint lines."
3781 (interactive "e")
3782 (if ev (mouse-set-point ev))
3783 (let ((bp (idlwave-shell-find-bp (idlwave-shell-current-frame)))
3784 index condition count select cmd disabled)
3785 (unless bp
3786 (error "Breakpoint not found"))
3787 (setq index (int-to-string (idlwave-shell-bp-get bp))
3788 condition (idlwave-shell-bp-get bp 'condition)
3789 cmd (idlwave-shell-bp-get bp 'cmd)
3790 count (idlwave-shell-bp-get bp 'count)
3791 disabled (idlwave-shell-bp-get bp 'disabled))
3792 (setq select (idlwave-popup-select
3793 ev
3794 (delq nil
3795 (list (if disabled "Enable" "Disable")
3796 "Clear"
3797 "Clear All"
3798 (if condition "Remove Condition" "Add Condition")
3799 (if condition "Change Condition")
3800 (if count "Remove Repeat Count"
3801 "Add Repeat Count")
3802 (if count "Change Repeat Count")))
3803 (concat "BreakPoint " index)))
3804 (if select
3805 (cond
3806 ((string-equal select "Clear All")
3807 (idlwave-shell-clear-all-bp))
3808 ((string-equal select "Clear")
3809 (idlwave-shell-clear-current-bp))
3810 ((string-match "Condition" select)
3811 (idlwave-shell-break-here count cmd
3812 (if (or (not condition)
3813 (string-match "Change" select))
3814 (read-string "Break Condition: "))
3815 disabled))
3816 ((string-match "Count" select)
3817 (idlwave-shell-break-here (if (or (not count)
3818 (string-match "Change" select))
3819 (string-to-number
3820 (read-string "Break After Count: ")))
3821 cmd condition disabled))
3822 ((string-match "able$" select)
3823 (idlwave-shell-toggle-enable-current-bp))
3824 (t
3825 (message "Unimplemented: %s" select))))))
3826
3827 (defun idlwave-shell-edit-default-command-line (arg)
3828 "Edit the current execute command."
3829 (interactive "P")
3830 (setq idlwave-shell-command-line-to-execute
3831 (read-string "IDL> " idlwave-shell-command-line-to-execute)))
3832
3833 (defun idlwave-shell-execute-default-command-line (arg)
3834 "Execute a command line. On first use, ask for the command.
3835 Also with prefix arg, ask for the command. You can also use the command
3836 `idlwave-shell-edit-default-command-line' to edit the line."
3837 (interactive "P")
3838 (cond
3839 ((equal arg '(16))
3840 (setq idlwave-shell-command-line-to-execute nil))
3841 ((equal arg '(4))
3842 (setq idlwave-shell-command-line-to-execute
3843 (read-string "IDL> " idlwave-shell-command-line-to-execute))))
3844 (idlwave-shell-reset 'hidden)
3845 (idlwave-shell-send-command
3846 (or idlwave-shell-command-line-to-execute
3847 (with-current-buffer (idlwave-shell-buffer)
3848 (ring-ref comint-input-ring 0)))
3849 '(idlwave-shell-redisplay 'hide)))
3850
3851 (defun idlwave-shell-save-and-run ()
3852 "Save file and run it in IDL.
3853 Runs `save-buffer' and sends a '.RUN' command for the associated file to IDL.
3854 When called from the shell buffer, re-run the file which was last handled by
3855 one of the save-and-.. commands."
3856 (interactive)
3857 (idlwave-shell-save-and-action 'run))
3858
3859 (defun idlwave-shell-save-and-compile ()
3860 "Save file and run it in IDL.
3861 Runs `save-buffer' and sends '.COMPILE' command for the associated file to IDL.
3862 When called from the shell buffer, re-compile the file which was last handled by
3863 one of the save-and-.. commands."
3864 (interactive)
3865 (idlwave-shell-save-and-action 'compile))
3866
3867 (defun idlwave-shell-save-and-batch ()
3868 "Save file and batch it in IDL.
3869 Runs `save-buffer' and sends a '@file' command for the associated file to IDL.
3870 When called from the shell buffer, re-batch the file which was last handled by
3871 one of the save-and-.. commands."
3872 (interactive)
3873 (idlwave-shell-save-and-action 'batch))
3874
3875 (defun idlwave-shell-save-and-action (action)
3876 "Save file and compile it in IDL.
3877 Runs `save-buffer' and sends a '.RUN' command for the associated file to IDL.
3878 When called from the shell buffer, re-compile the file which was last
3879 handled by this command."
3880 ;; Remove the stop overlay.
3881 (if idlwave-shell-stop-line-overlay
3882 (delete-overlay idlwave-shell-stop-line-overlay))
3883 (if idlwave-shell-is-stopped
3884 (idlwave-shell-electric-debug-all-off))
3885 (setq idlwave-shell-is-stopped nil)
3886 (setq overlay-arrow-string nil)
3887 (let (buf)
3888 (cond
3889 ((eq major-mode 'idlwave-mode)
3890 (save-buffer)
3891 (setq idlwave-shell-last-save-and-action-file (buffer-file-name)))
3892 (idlwave-shell-last-save-and-action-file
3893 (if (setq buf (idlwave-get-buffer-visiting
3894 idlwave-shell-last-save-and-action-file))
3895 (save-excursion
3896 (set-buffer buf)
3897 (save-buffer))))
3898 (t (setq idlwave-shell-last-save-and-action-file
3899 (read-file-name "File: ")))))
3900 (if (file-regular-p idlwave-shell-last-save-and-action-file)
3901 (progn
3902 (idlwave-shell-send-command
3903 (concat (cond ((eq action 'run) ".run ")
3904 ((eq action 'compile) ".compile ")
3905 ((eq action 'batch) "@")
3906 (t (error "Unknown action %s" action)))
3907 "\""
3908 idlwave-shell-last-save-and-action-file
3909 "\"")
3910 `(idlwave-shell-maybe-update-routine-info nil
3911 ,idlwave-shell-last-save-and-action-file)
3912 (if (idlwave-shell-hide-p 'run) 'mostly) nil t)
3913 (idlwave-shell-bp-query))
3914 (let ((msg (format "No such file %s"
3915 idlwave-shell-last-save-and-action-file)))
3916 (setq idlwave-shell-last-save-and-action-file nil)
3917 (error msg))))
3918
3919 (defun idlwave-shell-maybe-update-routine-info (&optional wait file)
3920 "Update the routine info if the shell is not stopped at an error."
3921 (if (and (not idlwave-shell-is-stopped)
3922 (or (eq t idlwave-auto-routine-info-updates)
3923 (memq 'compile-buffer idlwave-auto-routine-info-updates))
3924 idlwave-query-shell-for-routine-info
3925 idlwave-routines)
3926 (idlwave-shell-update-routine-info t nil wait file)))
3927
3928 (defvar idlwave-shell-sources-query "help,/source,/full"
3929 "IDL command to obtain source files for compiled procedures.")
3930
3931 (defvar idlwave-shell-sources-alist nil
3932 "Alist of IDL procedure names and compiled source files.
3933 Elements of the alist have the form:
3934
3935 (module name . (source-file-truename idlwave-internal-filename)).")
3936
3937 (defun idlwave-shell-module-source-query (module)
3938 "Determine the source file for a given module."
3939 (if module
3940 (idlwave-shell-send-command
3941 (format "print,(routine_info('%s',/SOURCE)).PATH" module)
3942 `(idlwave-shell-module-source-filter ,module)
3943 'hide)))
3944
3945 (defun idlwave-shell-module-source-filter (module)
3946 "Get module source, and update idlwave-shell-sources-alist."
3947 (let ((old (assoc (upcase module) idlwave-shell-sources-alist))
3948 filename)
3949 (if (string-match "\.PATH *[\n\r]\\([^\r\n]+\\)[\n\r]"
3950 idlwave-shell-command-output)
3951 (setq filename (substring idlwave-shell-command-output
3952 (match-beginning 1) (match-end 1)))
3953 (error "No file matching module found."))
3954 (if old
3955 (setcdr old (list (idlwave-shell-file-name filename) filename))
3956 (setq idlwave-shell-sources-alist
3957 (append idlwave-shell-sources-alist
3958 (list (cons (upcase module)
3959 (list (idlwave-shell-file-name filename)
3960 filename))))))))
3961
3962 (defun idlwave-shell-sources-query ()
3963 "Determine source files for all IDL compiled procedures.
3964 Queries IDL using the string in `idlwave-shell-sources-query'."
3965 (interactive)
3966 (idlwave-shell-send-command idlwave-shell-sources-query
3967 'idlwave-shell-sources-filter
3968 'hide))
3969
3970 (defun idlwave-shell-sources-filter ()
3971 "Get source files from `idlwave-shell-sources-query' output.
3972 Create `idlwave-shell-sources-alist' consisting of
3973 list elements of the form:
3974 (module name . (source-file-truename idlwave-internal-filename))."
3975 (save-excursion
3976 (set-buffer (get-buffer-create idlwave-shell-bp-buffer))
3977 (erase-buffer)
3978 (insert idlwave-shell-command-output)
3979 (goto-char (point-min))
3980 (let (cpro cfun)
3981 (if (re-search-forward "Compiled Procedures:" nil t)
3982 (progn
3983 (forward-line) ; Skip $MAIN$
3984 (setq cpro (point))))
3985 (if (re-search-forward "Compiled Functions:" nil t)
3986 (progn
3987 (setq cfun (point))
3988 (setq idlwave-shell-sources-alist
3989 (append
3990 ;; compiled procedures
3991 (progn
3992 (beginning-of-line)
3993 (narrow-to-region cpro (point))
3994 (goto-char (point-min))
3995 (idlwave-shell-sources-grep))
3996 ;; compiled functions
3997 (progn
3998 (widen)
3999 (goto-char cfun)
4000 (idlwave-shell-sources-grep)))))))))
4001
4002 (defun idlwave-shell-sources-grep ()
4003 (save-excursion
4004 (let ((al (list nil)))
4005 (while (and
4006 (not (progn (forward-line) (eobp)))
4007 (re-search-forward
4008 "\\s-*\\(\\S-+\\)\\s-+\\(\\S-+\\)" nil t))
4009 (nconc al
4010 (list
4011 (cons
4012 (buffer-substring ; name
4013 (match-beginning 1) (match-end 1))
4014 (let ((internal-filename
4015 (buffer-substring ; source
4016 (match-beginning 2) (match-end 2))))
4017 (list
4018 (idlwave-shell-file-name internal-filename)
4019 internal-filename))
4020 ))))
4021 (cdr al))))
4022
4023 (defun idlwave-shell-clear-all-bp ()
4024 "Remove all breakpoints in IDL."
4025 (interactive)
4026 (idlwave-shell-send-command
4027 idlwave-shell-bp-query
4028 '(progn
4029 (idlwave-shell-filter-bp)
4030 (mapcar 'idlwave-shell-clear-bp idlwave-shell-bp-alist))
4031 'hide))
4032
4033 (defun idlwave-shell-list-all-bp ()
4034 "List all breakpoints in IDL."
4035 (interactive)
4036 (idlwave-shell-send-command
4037 idlwave-shell-bp-query))
4038
4039 (defvar idlwave-shell-error-last 0
4040 "Position of last syntax error in `idlwave-shell-error-buffer'.")
4041
4042 (defun idlwave-shell-goto-next-error ()
4043 "Move point to next IDL syntax error."
4044 (interactive)
4045 (let (frame col)
4046 (save-excursion
4047 (set-buffer idlwave-shell-error-buffer)
4048 (goto-char idlwave-shell-error-last)
4049 (if (or
4050 (re-search-forward idlwave-shell-syntax-error nil t)
4051 (re-search-forward idlwave-shell-other-error nil t))
4052 (progn
4053 (setq frame
4054 (list
4055 (save-match-data
4056 (idlwave-shell-file-name
4057 (buffer-substring (match-beginning 1 )
4058 (match-end 1))))
4059 (string-to-number
4060 (buffer-substring (match-beginning 2)
4061 (match-end 2)))))
4062 ;; Try to find the column of the error
4063 (save-excursion
4064 (setq col
4065 (if (re-search-backward "\\^" nil t)
4066 (current-column)
4067 0)))))
4068 (setq idlwave-shell-error-last (point)))
4069 (if frame
4070 (progn
4071 (idlwave-shell-display-line frame col 'disable))
4072 (beep)
4073 (message "No more errors."))))
4074
4075 (defun idlwave-shell-file-name (name)
4076 "If `idlwave-shell-use-truename' is non-nil, convert file name to true name.
4077 Otherwise, just expand the file name."
4078 (let ((def-dir (if (eq major-mode 'idlwave-shell-mode)
4079 default-directory
4080 idlwave-shell-default-directory)))
4081 (if idlwave-shell-use-truename
4082 (file-truename name def-dir)
4083 (expand-file-name name def-dir))))
4084
4085 ;; Keybindings ------------------------------------------------------------
4086
4087 (defvar idlwave-shell-mode-map (copy-keymap comint-mode-map)
4088 "Keymap for idlwave-mode.")
4089 (defvar idlwave-shell-electric-debug-mode-map (make-sparse-keymap))
4090 (defvar idlwave-shell-mode-prefix-map (make-sparse-keymap))
4091 (fset 'idlwave-shell-mode-prefix-map idlwave-shell-mode-prefix-map)
4092 (defvar idlwave-mode-prefix-map (make-sparse-keymap))
4093 (fset 'idlwave-mode-prefix-map idlwave-mode-prefix-map)
4094
4095 (defun idlwave-shell-define-key-both (key hook)
4096 "Define a key in both the shell and buffer mode maps."
4097 (define-key idlwave-mode-map key hook)
4098 (define-key idlwave-shell-mode-map key hook))
4099
4100 ;(define-key idlwave-shell-mode-map "\M-?" 'comint-dynamic-list-completions)
4101 ;(define-key idlwave-shell-mode-map "\t" 'comint-dynamic-complete)
4102 (define-key idlwave-shell-mode-map "\t" 'idlwave-shell-complete)
4103 (define-key idlwave-shell-mode-map "\M-\t" 'idlwave-shell-complete)
4104 (define-key idlwave-shell-mode-map "\C-c\C-s" 'idlwave-shell)
4105 (define-key idlwave-shell-mode-map "\C-c?" 'idlwave-routine-info)
4106 (define-key idlwave-shell-mode-map "\C-g" 'idlwave-keyboard-quit)
4107 (define-key idlwave-shell-mode-map "\M-?" 'idlwave-context-help)
4108 (define-key idlwave-shell-mode-map [(control meta ?\?)] 'idlwave-online-help)
4109 (define-key idlwave-shell-mode-map "\C-c\C-i" 'idlwave-update-routine-info)
4110 (define-key idlwave-shell-mode-map "\C-c\C-y" 'idlwave-shell-char-mode-loop)
4111 (define-key idlwave-shell-mode-map "\C-c\C-x" 'idlwave-shell-send-char)
4112 (define-key idlwave-shell-mode-map "\C-c=" 'idlwave-resolve)
4113 (define-key idlwave-shell-mode-map "\C-c\C-v" 'idlwave-find-module)
4114 (define-key idlwave-shell-mode-map "\C-c\C-k" 'idlwave-kill-autoloaded-buffers)
4115 (define-key idlwave-shell-mode-map idlwave-shell-prefix-key
4116 'idlwave-shell-debug-map)
4117 (define-key idlwave-shell-mode-map [(up)] 'idlwave-shell-up-or-history)
4118 (define-key idlwave-shell-mode-map [(down)] 'idlwave-shell-down-or-history)
4119 (define-key idlwave-mode-map "\C-c\C-y" 'idlwave-shell-char-mode-loop)
4120 (define-key idlwave-mode-map "\C-c\C-x" 'idlwave-shell-send-char)
4121
4122 ;; The mouse bindings for PRINT and HELP
4123 (idlwave-shell-define-key-both
4124 (if (featurep 'xemacs)
4125 [(shift button2)]
4126 [(shift down-mouse-2)])
4127 'idlwave-shell-mouse-print)
4128 (idlwave-shell-define-key-both
4129 (if (featurep 'xemacs)
4130 [(control meta button2)]
4131 [(control meta down-mouse-2)])
4132 'idlwave-shell-mouse-help)
4133 (idlwave-shell-define-key-both
4134 (if (featurep 'xemacs)
4135 [(control shift button2)]
4136 [(control shift down-mouse-2)])
4137 'idlwave-shell-examine-select)
4138 ;; Add this one from the idlwave-mode-map
4139 (define-key idlwave-shell-mode-map
4140 (if (featurep 'xemacs)
4141 [(shift button3)]
4142 [(shift mouse-3)])
4143 'idlwave-mouse-context-help)
4144
4145 ;; For Emacs, we need to turn off the button release events.
4146 (defun idlwave-shell-mouse-nop (event)
4147 (interactive "e"))
4148 (unless (featurep 'xemacs)
4149 (idlwave-shell-define-key-both
4150 [(shift mouse-2)] 'idlwave-shell-mouse-nop)
4151 (idlwave-shell-define-key-both
4152 [(shift control mouse-2)] 'idlwave-shell-mouse-nop)
4153 (idlwave-shell-define-key-both
4154 [(control meta mouse-2)] 'idlwave-shell-mouse-nop))
4155
4156
4157 ;; The following set of bindings is used to bind the debugging keys.
4158 ;; If `idlwave-shell-activate-prefix-keybindings' is non-nil, the
4159 ;; first key in the list gets bound the C-c C-d prefix map. If
4160 ;; `idlwave-shell-debug-modifiers' is non-nil, the second key in the
4161 ;; list gets bound with the specified modifiers in both
4162 ;; `idlwave-mode-map' and `idlwave-shell-mode-map'. The next list
4163 ;; item, if non-nil, means to bind this as a single key in the
4164 ;; electric-debug-mode-map.
4165 ;;
4166 ;; [C-c C-d]-binding debug-modifier-key command bind-electric-debug buf-only
4167 ;; Used keys: abcdef hijklmnopqrstuvwxyz
4168 ;; Unused keys: g
4169 (let* ((specs
4170 '(([(control ?b)] ?b idlwave-shell-break-here t t)
4171 ([(control ?i)] ?i idlwave-shell-break-in t t)
4172 ([(control ?j)] ?j idlwave-shell-break-this-module t t)
4173 ([(control ?d)] ?d idlwave-shell-clear-current-bp t)
4174 ([(control ?a)] ?a idlwave-shell-clear-all-bp t)
4175 ([(control ?\\)] ?\\ idlwave-shell-toggle-enable-current-bp t)
4176 ([(control ?s)] ?s idlwave-shell-step t)
4177 ([(control ?n)] ?n idlwave-shell-stepover t)
4178 ([(control ?k)] ?k idlwave-shell-skip t)
4179 ([(control ?u)] ?u idlwave-shell-up t)
4180 ([(control ?o)] ?o idlwave-shell-out t)
4181 ([(control ?m)] ?m idlwave-shell-return t)
4182 ([(control ?h)] ?h idlwave-shell-to-here t t)
4183 ([(control ?r)] ?r idlwave-shell-cont t)
4184 ([(control ?y)] ?y idlwave-shell-execute-default-command-line)
4185 ([(control ?z)] ?z idlwave-shell-reset t)
4186 ([(control ?q)] ?q idlwave-shell-quit)
4187 ([(control ?p)] ?p idlwave-shell-print t)
4188 ([( ??)] ?? idlwave-shell-help-expression t)
4189 ([(control ?v)] ?v idlwave-shell-toggle-electric-debug-mode t t)
4190 ([(control ?x)] ?x idlwave-shell-goto-next-error)
4191 ([(control ?c)] ?c idlwave-shell-save-and-run t)
4192 ([( ?@)] ?@ idlwave-shell-save-and-batch)
4193 ([(control ?e)] ?e idlwave-shell-run-region)
4194 ([(control ?w)] ?w idlwave-shell-resync-dirs)
4195 ([(control ?l)] ?l idlwave-shell-redisplay t)
4196 ([(control ?t)] ?t idlwave-shell-toggle-toolbar)
4197 ([(control up)] up idlwave-shell-stack-up)
4198 ([(control down)] down idlwave-shell-stack-down)
4199 ([( ?[)] ?[ idlwave-shell-goto-previous-bp t t)
4200 ([( ?])] ?] idlwave-shell-goto-next-bp t t)
4201 ([(control ?f)] ?f idlwave-shell-window)))
4202 (mod (cond ((and idlwave-shell-debug-modifiers
4203 (listp idlwave-shell-debug-modifiers)
4204 (not (equal '() idlwave-shell-debug-modifiers)))
4205 idlwave-shell-debug-modifiers)
4206 (idlwave-shell-activate-alt-keybindings
4207 '(alt))))
4208 (shift (memq 'shift mod))
4209 (mod-noshift (delete 'shift (copy-sequence mod)))
4210 s k1 c2 k2 cmd electric only-buffer cannotshift)
4211 (while (setq s (pop specs))
4212 (setq k1 (nth 0 s)
4213 c2 (nth 1 s)
4214 cmd (nth 2 s)
4215 electric (nth 3 s)
4216 only-buffer (nth 4 s)
4217 cannotshift (and shift (char-valid-p c2) (eq c2 (upcase c2))))
4218
4219 ;; The regular prefix keymap.
4220 (when (and idlwave-shell-activate-prefix-keybindings k1)
4221 (unless only-buffer
4222 (define-key idlwave-shell-mode-prefix-map k1 cmd))
4223 (define-key idlwave-mode-prefix-map k1 cmd))
4224 ;; The debug modifier map
4225 (when (and mod window-system)
4226 (if (char-or-string-p c2)
4227 (setq k2 (vector (append mod-noshift
4228 (list (if shift (upcase c2) c2)))))
4229 (setq k2 (vector (append mod (list c2)))))
4230 (unless cannotshift
4231 (define-key idlwave-mode-map k2 cmd)
4232 (unless only-buffer (define-key idlwave-shell-mode-map k2 cmd))))
4233 ;; The electric debug single-keystroke map
4234 (if (and electric (char-or-string-p c2))
4235 (define-key idlwave-shell-electric-debug-mode-map (char-to-string c2)
4236 cmd))))
4237
4238 ;; A few extras in the electric debug map
4239 (define-key idlwave-shell-electric-debug-mode-map " " 'idlwave-shell-step)
4240 (define-key idlwave-shell-electric-debug-mode-map "+" 'idlwave-shell-stack-up)
4241 (define-key idlwave-shell-electric-debug-mode-map "=" 'idlwave-shell-stack-up)
4242 (define-key idlwave-shell-electric-debug-mode-map "-"
4243 'idlwave-shell-stack-down)
4244 (define-key idlwave-shell-electric-debug-mode-map "_"
4245 'idlwave-shell-stack-down)
4246 (define-key idlwave-shell-electric-debug-mode-map "e"
4247 '(lambda () (interactive) (idlwave-shell-print '(16))))
4248 (define-key idlwave-shell-electric-debug-mode-map "q" 'idlwave-shell-retall)
4249 (define-key idlwave-shell-electric-debug-mode-map "t"
4250 '(lambda () (interactive) (idlwave-shell-send-command "help,/TRACE")))
4251 (define-key idlwave-shell-electric-debug-mode-map [(control ??)]
4252 'idlwave-shell-electric-debug-help)
4253 (define-key idlwave-shell-electric-debug-mode-map "x"
4254 '(lambda (arg) (interactive "P")
4255 (idlwave-shell-print arg nil nil t)))
4256
4257
4258 ; Enter the prefix map in two places.
4259 (fset 'idlwave-debug-map idlwave-mode-prefix-map)
4260 (fset 'idlwave-shell-debug-map idlwave-shell-mode-prefix-map)
4261
4262 ;; The Electric Debug Minor Mode --------------------------------------------
4263
4264 (defun idlwave-shell-toggle-electric-debug-mode ()
4265 "Toggle electric-debug-mode, suppressing re-entry into mode if turned off."
4266 (interactive)
4267 ;; If turning it off, make sure it stays off throughout the debug
4268 ;; session until we return or hit $MAIN$. Cancel this suppression
4269 ;; if it's explicitly turned on.
4270 (if idlwave-shell-electric-debug-mode
4271 (progn ;; Turn it off, and make sure it stays off.
4272 (setq idlwave-shell-suppress-electric-debug t)
4273 (idlwave-shell-electric-debug-mode 0))
4274 (setq idlwave-shell-suppress-electric-debug nil)
4275 (idlwave-shell-electric-debug-mode t)))
4276
4277 (defvar idlwave-shell-electric-debug-read-only)
4278 (defvar idlwave-shell-electric-debug-buffers nil)
4279
4280 (define-minor-mode idlwave-shell-electric-debug-mode
4281 "Toggle Electric Debug mode.
4282 With no argument, this command toggles the mode.
4283 Non-null prefix argument turns on the mode.
4284 Null prefix argument turns off the mode.
4285
4286 When Electric Debug mode is enabled, the many debugging commands are
4287 available as single key sequences."
4288 nil
4289 " *Debugging*"
4290 idlwave-shell-electric-debug-mode-map)
4291
4292 (add-hook
4293 'idlwave-shell-electric-debug-mode-on-hook
4294 (lambda ()
4295 (set (make-local-variable 'idlwave-shell-electric-debug-read-only)
4296 buffer-read-only)
4297 (setq buffer-read-only t)
4298 (add-to-list 'idlwave-shell-electric-debug-buffers (current-buffer))
4299 (if idlwave-shell-stop-line-overlay
4300 (overlay-put idlwave-shell-stop-line-overlay 'face
4301 idlwave-shell-electric-stop-line-face))
4302 (if (facep 'fringe)
4303 (set-face-foreground 'fringe idlwave-shell-electric-stop-color
4304 (selected-frame)))))
4305
4306 (add-hook
4307 'idlwave-shell-electric-debug-mode-off-hook
4308 (lambda ()
4309 ;; Return to previous read-only state
4310 (setq buffer-read-only (if (boundp 'idlwave-shell-electric-debug-read-only)
4311 idlwave-shell-electric-debug-read-only))
4312 (setq idlwave-shell-electric-debug-buffers
4313 (delq (current-buffer) idlwave-shell-electric-debug-buffers))
4314 (if idlwave-shell-stop-line-overlay
4315 (overlay-put idlwave-shell-stop-line-overlay 'face
4316 idlwave-shell-stop-line-face)
4317 (if (facep 'fringe)
4318 (set-face-foreground 'fringe (face-foreground 'default))))))
4319
4320 ;; easy-mmode defines electric-debug-mode for us, so we need to advise it.
4321 (defadvice idlwave-shell-electric-debug-mode (after print-enter activate)
4322 "Print out an entrance message"
4323 (when idlwave-shell-electric-debug-mode
4324 (message
4325 "Electric Debugging mode entered. Press [C-?] for help, [q] to quit"))
4326 (force-mode-line-update))
4327
4328 ;; Turn it off in all relevant buffers
4329 (defvar idlwave-shell-electric-debug-buffers nil)
4330 (defun idlwave-shell-electric-debug-all-off ()
4331 (setq idlwave-shell-suppress-electric-debug nil)
4332 (let ((buffers idlwave-shell-electric-debug-buffers)
4333 buf)
4334 (save-excursion
4335 (while (setq buf (pop buffers))
4336 (when (buffer-live-p buf)
4337 (set-buffer buf)
4338 (when (and (eq major-mode 'idlwave-mode)
4339 buffer-file-name
4340 idlwave-shell-electric-debug-mode)
4341 (idlwave-shell-electric-debug-mode 0))))))
4342 (setq idlwave-shell-electric-debug-buffers nil))
4343
4344 ;; Show the help text
4345 (defun idlwave-shell-electric-debug-help ()
4346 (interactive)
4347 (with-output-to-temp-buffer "*IDLWAVE Electric Debug Help*"
4348 (princ idlwave-shell-electric-debug-help))
4349 (let* ((current-window (selected-window))
4350 (window (get-buffer-window "*IDLWAVE Electric Debug Help*"))
4351 (window-lines (window-height window)))
4352 (select-window window)
4353 (enlarge-window (1+ (- (count-lines 1 (point-max)) window-lines)))
4354 (select-window current-window)))
4355
4356
4357 ;; The Menus --------------------------------------------------------------
4358 (defvar idlwave-shell-menu-def
4359 `("Debug"
4360 ["Electric Debug Mode"
4361 idlwave-shell-electric-debug-mode
4362 :style toggle :selected idlwave-shell-electric-debug-mode
4363 :included (eq major-mode 'idlwave-mode) :keys "C-c C-d C-v"]
4364 "--"
4365 ("Compile & Run"
4366 ["Save and .RUN" idlwave-shell-save-and-run
4367 (or (eq major-mode 'idlwave-mode)
4368 idlwave-shell-last-save-and-action-file)]
4369 ["Save and .COMPILE" idlwave-shell-save-and-compile
4370 (or (eq major-mode 'idlwave-mode)
4371 idlwave-shell-last-save-and-action-file)]
4372 ["Save and @Batch" idlwave-shell-save-and-batch
4373 (or (eq major-mode 'idlwave-mode)
4374 idlwave-shell-last-save-and-action-file)]
4375 "--"
4376 ["Goto Next Error" idlwave-shell-goto-next-error t]
4377 "--"
4378 ["Compile and Run Region" idlwave-shell-run-region
4379 (eq major-mode 'idlwave-mode)]
4380 ["Evaluate Region" idlwave-shell-evaluate-region
4381 (eq major-mode 'idlwave-mode)]
4382 "--"
4383 ["Execute Default Cmd" idlwave-shell-execute-default-command-line t]
4384 ["Edit Default Cmd" idlwave-shell-edit-default-command-line t])
4385 ("Breakpoints"
4386 ["Set Breakpoint" idlwave-shell-break-here
4387 :keys "C-c C-d C-b" :active (eq major-mode 'idlwave-mode)]
4388 ("Set Special Breakpoint"
4389 ["Set After Count Breakpoint"
4390 (progn
4391 (let ((count (string-to-number (read-string "Break after count: "))))
4392 (if (integerp count) (idlwave-shell-break-here count))))
4393 :active (eq major-mode 'idlwave-mode)]
4394 ["Set Condition Breakpoint"
4395 (idlwave-shell-break-here '(4))
4396 :active (eq major-mode 'idlwave-mode)])
4397 ["Break in Module" idlwave-shell-break-in
4398 :keys "C-c C-d C-i" :active (eq major-mode 'idlwave-mode)]
4399 ["Break in this Module" idlwave-shell-break-this-module
4400 :keys "C-c C-d C-j" :active (eq major-mode 'idlwave-mode)]
4401 ["Clear Breakpoint" idlwave-shell-clear-current-bp t]
4402 ["Clear All Breakpoints" idlwave-shell-clear-all-bp t]
4403 ["Disable/Enable Breakpoint" idlwave-shell-toggle-enable-current-bp t]
4404 ["Goto Previous Breakpoint" idlwave-shell-goto-previous-bp
4405 :keys "C-c C-d [" :active (eq major-mode 'idlwave-mode)]
4406 ["Goto Next Breakpoint" idlwave-shell-goto-next-bp
4407 :keys "C-c C-d ]" :active (eq major-mode 'idlwave-mode)]
4408 ["List All Breakpoints" idlwave-shell-list-all-bp t]
4409 ["Resync Breakpoints" idlwave-shell-bp-query t])
4410 ("Continue/Step"
4411 ["Step (into)" idlwave-shell-step t]
4412 ["Step (over)" idlwave-shell-stepover t]
4413 ["Skip One Statement" idlwave-shell-skip t]
4414 ["Continue" idlwave-shell-cont t]
4415 ["... to End of Block" idlwave-shell-up t]
4416 ["... to End of Subprog" idlwave-shell-return t]
4417 ["... to End of Subprog+1" idlwave-shell-out t]
4418 ["... to Here (Cursor Line)" idlwave-shell-to-here
4419 :keys "C-c C-d C-h" :active (eq major-mode 'idlwave-mode)])
4420 ("Examine Expressions"
4421 ["Print expression" idlwave-shell-print t]
4422 ["Help on expression" idlwave-shell-help-expression t]
4423 ("Examine nearby expression with"
4424 ,@(mapcar (lambda(x)
4425 `[ ,(car x) (idlwave-shell-print nil ',x) t ])
4426 idlwave-shell-examine-alist))
4427 ("Examine region with"
4428 ,@(mapcar (lambda(x)
4429 `[ ,(car x) (idlwave-shell-print '(4) ',x) t ])
4430 idlwave-shell-examine-alist)))
4431 ("Call Stack"
4432 ["Stack Up" idlwave-shell-stack-up t]
4433 ["Stack Down" idlwave-shell-stack-down t]
4434 "--"
4435 ["Redisplay and Sync" idlwave-shell-redisplay t])
4436 ("Show Commands"
4437 ["Everything" (if (eq idlwave-shell-show-commands 'everything)
4438 (progn
4439 (setq idlwave-shell-show-commands
4440 (get 'idlwave-shell-show-commands 'last-val))
4441 (put 'idlwave-shell-show-commands 'last-val nil))
4442 (put 'idlwave-shell-show-commands 'last-val
4443 idlwave-shell-show-commands)
4444 (setq idlwave-shell-show-commands 'everything))
4445 :style toggle :selected (and (not (listp idlwave-shell-show-commands))
4446 (eq idlwave-shell-show-commands
4447 'everything))]
4448 "--"
4449 ["Compiling Commands" (idlwave-shell-add-or-remove-show 'run)
4450 :style toggle
4451 :selected (not (idlwave-shell-hide-p
4452 'run
4453 (get 'idlwave-shell-show-commands 'last-val)))
4454 :active (not (eq idlwave-shell-show-commands 'everything))]
4455 ["Breakpoint Commands" (idlwave-shell-add-or-remove-show 'breakpoint)
4456 :style toggle
4457 :selected (not (idlwave-shell-hide-p
4458 'breakpoint
4459 (get 'idlwave-shell-show-commands 'last-val)))
4460 :active (not (eq idlwave-shell-show-commands 'everything))]
4461 ["Debug Commands" (idlwave-shell-add-or-remove-show 'debug)
4462 :style toggle
4463 :selected (not (idlwave-shell-hide-p
4464 'debug
4465 (get 'idlwave-shell-show-commands 'last-val)))
4466 :active (not (eq idlwave-shell-show-commands 'everything))]
4467 ["Miscellaneous Commands" (idlwave-shell-add-or-remove-show 'misc)
4468 :style toggle
4469 :selected (not (idlwave-shell-hide-p
4470 'misc
4471 (get 'idlwave-shell-show-commands 'last-val)))
4472 :active (not (eq idlwave-shell-show-commands 'everything))])
4473 ("Input Mode"
4474 ["Send one char" idlwave-shell-send-char t]
4475 ["Temporary Character Mode" idlwave-shell-char-mode-loop t]
4476 "--"
4477 ["Use Input Mode Magic"
4478 (setq idlwave-shell-use-input-mode-magic
4479 (not idlwave-shell-use-input-mode-magic))
4480 :style toggle :selected idlwave-shell-use-input-mode-magic])
4481 "--"
4482 ["Update Working Dir" idlwave-shell-resync-dirs t]
4483 ["Save Path Info"
4484 (idlwave-shell-send-command idlwave-shell-path-query
4485 'idlwave-shell-get-path-info
4486 'hide)
4487 t]
4488 ["Reset IDL" idlwave-shell-reset t]
4489 "--"
4490 ["Toggle Toolbar" idlwave-shell-toggle-toolbar t]
4491 ["Exit IDL" idlwave-shell-quit t]))
4492
4493 (if (or (featurep 'easymenu) (load "easymenu" t))
4494 (progn
4495 (easy-menu-define
4496 idlwave-mode-debug-menu idlwave-mode-map "IDL debugging menus"
4497 idlwave-shell-menu-def)
4498 (easy-menu-define
4499 idlwave-shell-mode-menu idlwave-shell-mode-map "IDL shell menus"
4500 idlwave-shell-menu-def)
4501 (save-excursion
4502 (mapcar (lambda (buf)
4503 (set-buffer buf)
4504 (if (eq major-mode 'idlwave-mode)
4505 (progn
4506 (easy-menu-remove idlwave-mode-debug-menu)
4507 (easy-menu-add idlwave-mode-debug-menu))))
4508 (buffer-list)))))
4509
4510 ;; The Breakpoint Glyph -------------------------------------------------------
4511
4512 (defvar idlwave-shell-bp-glyph nil
4513 "The glyphs to mark breakpoint lines in the source code.")
4514
4515 (let ((image-alist
4516 '((bp . "/* XPM */
4517 static char * file[] = {
4518 \"14 12 3 1\",
4519 \" c None s backgroundColor\",
4520 \". c #4B4B4B4B4B4B\",
4521 \"R c #FFFF00000000\",
4522 \" \",
4523 \" .... \",
4524 \" .RRRR. \",
4525 \" .RRRRRR. \",
4526 \" .RRRRRRRR. \",
4527 \" .RRRRRRRR. \",
4528 \" .RRRRRRRR. \",
4529 \" .RRRRRRRR. \",
4530 \" .RRRRRR. \",
4531 \" .RRRR. \",
4532 \" .... \",
4533 \" \"};")
4534 (bp-cond . "/* XPM */
4535 static char * file[] = {
4536 \"14 12 4 1\",
4537 \" c None s backgroundColor\",
4538 \". c #4B4B4B4B4B4B\",
4539 \"R c #FFFF00000000\",
4540 \"B c #000000000000\",
4541 \" \",
4542 \" .... \",
4543 \" .RRRR. \",
4544 \" .RRRRRR. \",
4545 \" .RRRRRRRR. \",
4546 \" .RRBBBBRR. \",
4547 \" .RRRRRRRR. \",
4548 \" .RRBBBBRR. \",
4549 \" .RRRRRR. \",
4550 \" .RRRR. \",
4551 \" .... \",
4552 \" \"};")
4553 (bp-1 . "/* XPM */
4554 static char * file[] = {
4555 \"14 12 4 1\",
4556 \" c None s backgroundColor\",
4557 \". c #4B4B4B4B4B4B\",
4558 \"X c #FFFF00000000\",
4559 \"o c #000000000000\",
4560 \" \",
4561 \" .... \",
4562 \" .XXXX. \",
4563 \" .XXooXX. \",
4564 \" .XXoooXXX. \",
4565 \" .XXXooXXX. \",
4566 \" .XXXooXXX. \",
4567 \" .XXooooXX. \",
4568 \" .XooooX. \",
4569 \" .XXXX. \",
4570 \" .... \",
4571 \" \"};")
4572 (bp-2 . "/* XPM */
4573 static char * file[] = {
4574 \"14 12 4 1\",
4575 \" c None s backgroundColor\",
4576 \". c #4B4B4B4B4B4B\",
4577 \"X c #FFFF00000000\",
4578 \"o c #000000000000\",
4579 \" \",
4580 \" .... \",
4581 \" .XXXX. \",
4582 \" .XoooXX. \",
4583 \" .XXoXooXX. \",
4584 \" .XXXXooXX. \",
4585 \" .XXXooXXX. \",
4586 \" .XXooXXXX. \",
4587 \" .XooooX. \",
4588 \" .XXXX. \",
4589 \" .... \",
4590 \" \"};")
4591 (bp-3 . "/* XPM */
4592 static char * file[] = {
4593 \"14 12 4 1\",
4594 \" c None s backgroundColor\",
4595 \". c #4B4B4B4B4B4B\",
4596 \"X c #FFFF00000000\",
4597 \"o c #000000000000\",
4598 \" \",
4599 \" .... \",
4600 \" .XXXX. \",
4601 \" .XoooXX. \",
4602 \" .XXXXooXX. \",
4603 \" .XXXooXXX. \",
4604 \" .XXXXooXX. \",
4605 \" .XXoXooXX. \",
4606 \" .XoooXX. \",
4607 \" .XXXX. \",
4608 \" .... \",
4609 \" \"};")
4610 (bp-4 . "/* XPM */
4611 static char * file[] = {
4612 \"14 12 4 1\",
4613 \" c None s backgroundColor\",
4614 \". c #4B4B4B4B4B4B\",
4615 \"X c #FFFF00000000\",
4616 \"o c #000000000000\",
4617 \" \",
4618 \" .... \",
4619 \" .XXXX. \",
4620 \" .XoXXoX. \",
4621 \" .XXoXXoXX. \",
4622 \" .XXooooXX. \",
4623 \" .XXXXooXX. \",
4624 \" .XXXXooXX. \",
4625 \" .XXXooX. \",
4626 \" .XXXX. \",
4627 \" .... \",
4628 \" \"};")
4629 (bp-n . "/* XPM */
4630 static char * file[] = {
4631 \"14 12 4 1\",
4632 \" c None s backgroundColor\",
4633 \". c #4B4B4B4B4B4B\",
4634 \"X c #FFFF00000000\",
4635 \"o c #000000000000\",
4636 \" \",
4637 \" .... \",
4638 \" .XXXX. \",
4639 \" .XXXXXX. \",
4640 \" .XXoXoXXX. \",
4641 \" .XXooXoXX. \",
4642 \" .XXoXXoXX. \",
4643 \" .XXoXXoXX. \",
4644 \" .XoXXoX. \",
4645 \" .XXXX. \",
4646 \" .... \",
4647 \" \"};"))) im-cons im)
4648
4649 (while (setq im-cons (pop image-alist))
4650 (setq im (cond ((and (featurep 'xemacs)
4651 (featurep 'xpm))
4652 (list
4653 (let ((data (cdr im-cons)))
4654 (string-match "#FFFF00000000" data)
4655 (setq data (replace-match "#8F8F8F8F8F8F" t t data))
4656 (make-glyph data))
4657 (make-glyph (cdr im-cons))))
4658 ((and (not (featurep 'xemacs))
4659 (fboundp 'image-type-available-p)
4660 (image-type-available-p 'xpm))
4661 (list 'image :type 'xpm :data (cdr im-cons)
4662 :ascent 'center))
4663 (t nil)))
4664 (if im (push (cons (car im-cons) im) idlwave-shell-bp-glyph))))
4665
4666 (provide 'idlw-shell)
4667 (provide 'idlwave-shell)
4668
4669 ;;; Load the toolbar when wanted by the user.
4670
4671 (autoload 'idlwave-toolbar-toggle "idlw-toolbar"
4672 "Toggle the IDLWAVE toolbar")
4673 (autoload 'idlwave-toolbar-add-everywhere "idlw-toolbar"
4674 "Add IDLWAVE toolbar")
4675 (defun idlwave-shell-toggle-toolbar ()
4676 "Toggle the display of the debugging toolbar."
4677 (interactive)
4678 (idlwave-toolbar-toggle))
4679
4680 (if idlwave-shell-use-toolbar
4681 (add-hook 'idlwave-shell-mode-hook 'idlwave-toolbar-add-everywhere))
4682
4683 ;; arch-tag: 20c2e8ce-0709-41d8-a5b6-bb039148440a
4684 ;;; idlw-shell.el ends here