comparison lisp/progmodes/gdb-ui.el @ 55400:1aaa031e318c

Improve/extend documentation strings. Fit first sentence on one line for apropos-command.
author Nick Roberts <nickrob@snap.net.nz>
date Thu, 06 May 2004 22:57:13 +0000
parents df2107598877
children e266c6d6bd7a
comparison
equal deleted inserted replaced
55399:5bf40b98f529 55400:1aaa031e318c
218 (list (concat "server interpreter mi \"-var-create - * " expr "\"\n") 218 (list (concat "server interpreter mi \"-var-create - * " expr "\"\n")
219 `(lambda () (gdb-var-create-handler ,expr)))))) 219 `(lambda () (gdb-var-create-handler ,expr))))))
220 (select-window (get-buffer-window gud-comint-buffer 'visible))) 220 (select-window (get-buffer-window gud-comint-buffer 'visible)))
221 221
222 (defun gdb-goto-info () 222 (defun gdb-goto-info ()
223 "Go to Emacs info node: GDB Graphical Interface."
223 (interactive) 224 (interactive)
224 (select-frame (make-frame)) 225 (select-frame (make-frame))
225 (require 'info) 226 (require 'info)
226 (Info-goto-node "(emacs)GDB Graphical Interface")) 227 (Info-goto-node "(emacs)GDB Graphical Interface"))
227 228
1115 (gdb-put-breakpoint-icon (eq flag ?y))))))))) 1116 (gdb-put-breakpoint-icon (eq flag ?y)))))))))
1116 (end-of-line))))) 1117 (end-of-line)))))
1117 (if (gdb-get-buffer 'gdb-assembler-buffer) (gdb-assembler-custom))) 1118 (if (gdb-get-buffer 'gdb-assembler-buffer) (gdb-assembler-custom)))
1118 1119
1119 (defun gdb-mouse-toggle-breakpoint (event) 1120 (defun gdb-mouse-toggle-breakpoint (event)
1120 "Toggle breakpoint with mouse click in left margin." 1121 "Toggle breakpoint in left fringe/margin with mouse click"
1121 (interactive "e") 1122 (interactive "e")
1122 (mouse-minibuffer-check event) 1123 (mouse-minibuffer-check event)
1123 (let ((posn (event-end event))) 1124 (let ((posn (event-end event)))
1124 (if (numberp (posn-point posn)) 1125 (if (numberp (posn-point posn))
1125 (with-selected-window (posn-window posn) 1126 (with-selected-window (posn-window posn)
1135 (defun gdb-breakpoints-buffer-name () 1136 (defun gdb-breakpoints-buffer-name ()
1136 (with-current-buffer gud-comint-buffer 1137 (with-current-buffer gud-comint-buffer
1137 (concat "*breakpoints of " (gdb-get-target-string) "*"))) 1138 (concat "*breakpoints of " (gdb-get-target-string) "*")))
1138 1139
1139 (defun gdb-display-breakpoints-buffer () 1140 (defun gdb-display-breakpoints-buffer ()
1141 "Display status of user-settable breakpoints."
1140 (interactive) 1142 (interactive)
1141 (gdb-display-buffer 1143 (gdb-display-buffer
1142 (gdb-get-create-buffer 'gdb-breakpoints-buffer))) 1144 (gdb-get-create-buffer 'gdb-breakpoints-buffer)))
1143 1145
1144 (defconst gdb-frame-parameters 1146 (defconst gdb-frame-parameters
1147 (tool-bar-lines . nil) 1149 (tool-bar-lines . nil)
1148 (menu-bar-lines . nil) 1150 (menu-bar-lines . nil)
1149 (minibuffer . nil))) 1151 (minibuffer . nil)))
1150 1152
1151 (defun gdb-frame-breakpoints-buffer () 1153 (defun gdb-frame-breakpoints-buffer ()
1154 "Display status of user-settable breakpoints in a new frame."
1152 (interactive) 1155 (interactive)
1153 (select-frame (make-frame gdb-frame-parameters)) 1156 (select-frame (make-frame gdb-frame-parameters))
1154 (switch-to-buffer (gdb-get-create-buffer 'gdb-breakpoints-buffer)) 1157 (switch-to-buffer (gdb-get-create-buffer 'gdb-breakpoints-buffer))
1155 (set-window-dedicated-p (selected-window) t)) 1158 (set-window-dedicated-p (selected-window) t))
1156 1159
1203 (error "Not recognized as break/watchpoint line") 1206 (error "Not recognized as break/watchpoint line")
1204 (gdb-enqueue-input 1207 (gdb-enqueue-input
1205 (list (concat "server delete " (match-string 1) "\n") 'ignore)))) 1208 (list (concat "server delete " (match-string 1) "\n") 'ignore))))
1206 1209
1207 (defun gdb-goto-breakpoint () 1210 (defun gdb-goto-breakpoint ()
1208 "Display the file in the source buffer at the breakpoint specified on the 1211 "Display the breakpoint location specified at current line."
1209 current line."
1210 (interactive) 1212 (interactive)
1211 (save-excursion 1213 (save-excursion
1212 (beginning-of-line 1) 1214 (beginning-of-line 1)
1213 (re-search-forward "in\\s-+\\S-+\\s-+at\\s-+" nil t) 1215 (re-search-forward "in\\s-+\\S-+\\s-+at\\s-+" nil t)
1214 (looking-at "\\(\\S-*\\):\\([0-9]+\\)")) 1216 (looking-at "\\(\\S-*\\):\\([0-9]+\\)"))
1223 (with-current-buffer buf 1225 (with-current-buffer buf
1224 (goto-line (string-to-number line)) 1226 (goto-line (string-to-number line))
1225 (set-window-point window (point)))))))) 1227 (set-window-point window (point))))))))
1226 1228
1227 (defun gdb-mouse-goto-breakpoint (event) 1229 (defun gdb-mouse-goto-breakpoint (event)
1228 "Display the file in the source buffer at the selected breakpoint." 1230 "Display the breakpoint location that you click on."
1229 (interactive "e") 1231 (interactive "e")
1230 (mouse-set-point event) 1232 (mouse-set-point event)
1231 (gdb-goto-breakpoint)) 1233 (gdb-goto-breakpoint))
1232 1234
1233 ;; 1235 ;;
1266 (defun gdb-stack-buffer-name () 1268 (defun gdb-stack-buffer-name ()
1267 (with-current-buffer gud-comint-buffer 1269 (with-current-buffer gud-comint-buffer
1268 (concat "*stack frames of " (gdb-get-target-string) "*"))) 1270 (concat "*stack frames of " (gdb-get-target-string) "*")))
1269 1271
1270 (defun gdb-display-stack-buffer () 1272 (defun gdb-display-stack-buffer ()
1273 "Display backtrace of current stack."
1271 (interactive) 1274 (interactive)
1272 (gdb-display-buffer 1275 (gdb-display-buffer
1273 (gdb-get-create-buffer 'gdb-stack-buffer))) 1276 (gdb-get-create-buffer 'gdb-stack-buffer)))
1274 1277
1275 (defun gdb-frame-stack-buffer () 1278 (defun gdb-frame-stack-buffer ()
1279 "Display backtrace of current stack in a new frame."
1276 (interactive) 1280 (interactive)
1277 (select-frame (make-frame gdb-frame-parameters)) 1281 (select-frame (make-frame gdb-frame-parameters))
1278 (switch-to-buffer (gdb-get-create-buffer 'gdb-stack-buffer)) 1282 (switch-to-buffer (gdb-get-create-buffer 'gdb-stack-buffer))
1279 (set-window-dedicated-p (selected-window) t)) 1283 (set-window-dedicated-p (selected-window) t))
1280 1284
1301 (let* ((pos (re-search-backward "^#\\([0-9]*\\)" nil t)) 1305 (let* ((pos (re-search-backward "^#\\([0-9]*\\)" nil t))
1302 (n (or (and pos (match-string-no-properties 1)) "0"))) 1306 (n (or (and pos (match-string-no-properties 1)) "0")))
1303 n))) 1307 n)))
1304 1308
1305 (defun gdb-frames-select () 1309 (defun gdb-frames-select ()
1306 "Make the frame on the current line become the current frame and display the 1310 "Select the frame and display the relevant source."
1307 source in the source buffer."
1308 (interactive) 1311 (interactive)
1309 (gdb-enqueue-input 1312 (gdb-enqueue-input
1310 (list (concat "server frame " (gdb-get-frame-number) "\n") 'ignore)) 1313 (list (concat "server frame " (gdb-get-frame-number) "\n") 'ignore))
1311 (gud-display-frame)) 1314 (gud-display-frame))
1312 1315
1313 (defun gdb-frames-mouse-select (event) 1316 (defun gdb-frames-mouse-select (event)
1314 "Make the selected frame become the current frame and display the source in 1317 "Select the frame you click on and display the relevant source."
1315 the source buffer."
1316 (interactive "e") 1318 (interactive "e")
1317 (mouse-set-point event) 1319 (mouse-set-point event)
1318 (gdb-frames-select)) 1320 (gdb-frames-select))
1319 1321
1320 ;; 1322 ;;
1343 (defun gdb-threads-buffer-name () 1345 (defun gdb-threads-buffer-name ()
1344 (with-current-buffer gud-comint-buffer 1346 (with-current-buffer gud-comint-buffer
1345 (concat "*threads of " (gdb-get-target-string) "*"))) 1347 (concat "*threads of " (gdb-get-target-string) "*")))
1346 1348
1347 (defun gdb-display-threads-buffer () 1349 (defun gdb-display-threads-buffer ()
1350 "Display IDs of currently known threads."
1348 (interactive) 1351 (interactive)
1349 (gdb-display-buffer 1352 (gdb-display-buffer
1350 (gdb-get-create-buffer 'gdb-threads-buffer))) 1353 (gdb-get-create-buffer 'gdb-threads-buffer)))
1351 1354
1352 (defun gdb-frame-threads-buffer () 1355 (defun gdb-frame-threads-buffer ()
1356 "Display IDs of currently known threads in a new frame."
1353 (interactive) 1357 (interactive)
1354 (select-frame (make-frame gdb-frame-parameters)) 1358 (select-frame (make-frame gdb-frame-parameters))
1355 (switch-to-buffer (gdb-get-create-buffer 'gdb-threads-buffer)) 1359 (switch-to-buffer (gdb-get-create-buffer 'gdb-threads-buffer))
1356 (set-window-dedicated-p (selected-window) t)) 1360 (set-window-dedicated-p (selected-window) t))
1357 1361
1376 (save-excursion 1380 (save-excursion
1377 (re-search-backward "^\\s-*\\([0-9]*\\)" nil t) 1381 (re-search-backward "^\\s-*\\([0-9]*\\)" nil t)
1378 (match-string-no-properties 1))) 1382 (match-string-no-properties 1)))
1379 1383
1380 (defun gdb-threads-select () 1384 (defun gdb-threads-select ()
1381 "Make the thread on the current line become the current thread and display the 1385 "Select the thread and display the relevant source."
1382 source in the source buffer."
1383 (interactive) 1386 (interactive)
1384 (gdb-enqueue-input 1387 (gdb-enqueue-input
1385 (list (concat "thread " (gdb-get-thread-number) "\n") 'ignore)) 1388 (list (concat "thread " (gdb-get-thread-number) "\n") 'ignore))
1386 (gud-display-frame)) 1389 (gud-display-frame))
1387 1390
1388 (defun gdb-threads-mouse-select (event) 1391 (defun gdb-threads-mouse-select (event)
1389 "Make the selected frame become the current frame and display the source in 1392 "Select the thread you click on and display the relevant source."
1390 the source buffer."
1391 (interactive "e") 1393 (interactive "e")
1392 (mouse-set-point event) 1394 (mouse-set-point event)
1393 (gdb-threads-select)) 1395 (gdb-threads-select))
1394 1396
1395 ;; 1397 ;;
1425 (defun gdb-registers-buffer-name () 1427 (defun gdb-registers-buffer-name ()
1426 (with-current-buffer gud-comint-buffer 1428 (with-current-buffer gud-comint-buffer
1427 (concat "*registers of " (gdb-get-target-string) "*"))) 1429 (concat "*registers of " (gdb-get-target-string) "*")))
1428 1430
1429 (defun gdb-display-registers-buffer () 1431 (defun gdb-display-registers-buffer ()
1432 "Display integer register contents."
1430 (interactive) 1433 (interactive)
1431 (gdb-display-buffer 1434 (gdb-display-buffer
1432 (gdb-get-create-buffer 'gdb-registers-buffer))) 1435 (gdb-get-create-buffer 'gdb-registers-buffer)))
1433 1436
1434 (defun gdb-frame-registers-buffer () 1437 (defun gdb-frame-registers-buffer ()
1438 "Display integer register contents in a new frame."
1435 (interactive) 1439 (interactive)
1436 (select-frame (make-frame gdb-frame-parameters)) 1440 (select-frame (make-frame gdb-frame-parameters))
1437 (switch-to-buffer (gdb-get-create-buffer 'gdb-registers-buffer)) 1441 (switch-to-buffer (gdb-get-create-buffer 'gdb-registers-buffer))
1438 (set-window-dedicated-p (selected-window) t)) 1442 (set-window-dedicated-p (selected-window) t))
1439 1443
1497 (defun gdb-locals-buffer-name () 1501 (defun gdb-locals-buffer-name ()
1498 (with-current-buffer gud-comint-buffer 1502 (with-current-buffer gud-comint-buffer
1499 (concat "*locals of " (gdb-get-target-string) "*"))) 1503 (concat "*locals of " (gdb-get-target-string) "*")))
1500 1504
1501 (defun gdb-display-locals-buffer () 1505 (defun gdb-display-locals-buffer ()
1506 "Display local variables of current stack and their values."
1502 (interactive) 1507 (interactive)
1503 (gdb-display-buffer 1508 (gdb-display-buffer
1504 (gdb-get-create-buffer 'gdb-locals-buffer))) 1509 (gdb-get-create-buffer 'gdb-locals-buffer)))
1505 1510
1506 (defun gdb-frame-locals-buffer () 1511 (defun gdb-frame-locals-buffer ()
1512 "Display local variables of current stack and their values in a new frame."
1507 (interactive) 1513 (interactive)
1508 (select-frame (make-frame gdb-frame-parameters)) 1514 (select-frame (make-frame gdb-frame-parameters))
1509 (switch-to-buffer (gdb-get-create-buffer 'gdb-locals-buffer)) 1515 (switch-to-buffer (gdb-get-create-buffer 'gdb-locals-buffer))
1510 (set-window-dedicated-p (selected-window) t)) 1516 (set-window-dedicated-p (selected-window) t))
1511 1517
1601 (menu-bar-make-toggle gdb-many-windows gdb-many-windows 1607 (menu-bar-make-toggle gdb-many-windows gdb-many-windows
1602 "Display other windows" "Many Windows %s" 1608 "Display other windows" "Many Windows %s"
1603 "Display locals, stack and breakpoint information"))) 1609 "Display locals, stack and breakpoint information")))
1604 1610
1605 (defun gdb-frame-gdb-buffer () 1611 (defun gdb-frame-gdb-buffer ()
1612 "Display GUD buffer in a new frame."
1606 (interactive) 1613 (interactive)
1607 (select-frame (make-frame gdb-frame-parameters)) 1614 (select-frame (make-frame gdb-frame-parameters))
1608 (switch-to-buffer (gdb-get-create-buffer 'gdba)) 1615 (switch-to-buffer (gdb-get-create-buffer 'gdba))
1609 (set-window-dedicated-p (selected-window) t)) 1616 (set-window-dedicated-p (selected-window) t))
1610 1617
1611 (defun gdb-display-gdb-buffer () 1618 (defun gdb-display-gdb-buffer ()
1619 "Display GUD buffer."
1612 (interactive) 1620 (interactive)
1613 (gdb-display-buffer 1621 (gdb-display-buffer
1614 (gdb-get-create-buffer 'gdba))) 1622 (gdb-get-create-buffer 'gdba)))
1615 1623
1616 (defvar gdb-main-file nil "Source file from which program execution begins.") 1624 (defvar gdb-main-file nil "Source file from which program execution begins.")
1617 1625
1618 (defun gdb-view-source-function () 1626 (defun gdb-view-source-function ()
1627 "Select source view."
1619 (interactive) 1628 (interactive)
1620 (if gdb-view-source 1629 (if gdb-view-source
1621 (gdb-display-buffer 1630 (gdb-display-buffer
1622 (if gud-last-last-frame 1631 (if gud-last-last-frame
1623 (gud-find-file (car gud-last-last-frame)) 1632 (gud-find-file (car gud-last-last-frame))
1624 (gud-find-file gdb-main-file)))) 1633 (gud-find-file gdb-main-file))))
1625 (setq gdb-selected-view 'source)) 1634 (setq gdb-selected-view 'source))
1626 1635
1627 (defun gdb-view-assembler() 1636 (defun gdb-view-assembler()
1637 "Select disassembly view."
1628 (interactive) 1638 (interactive)
1629 (gdb-display-buffer (gdb-get-create-buffer 'gdb-assembler-buffer)) 1639 (gdb-display-buffer (gdb-get-create-buffer 'gdb-assembler-buffer))
1630 (gdb-invalidate-assembler) 1640 (gdb-invalidate-assembler)
1631 (setq gdb-selected-view 'assembler)) 1641 (setq gdb-selected-view 'assembler))
1632 1642
1924 (defun gdb-assembler-buffer-name () 1934 (defun gdb-assembler-buffer-name ()
1925 (with-current-buffer gud-comint-buffer 1935 (with-current-buffer gud-comint-buffer
1926 (concat "*Machine Code " (gdb-get-target-string) "*"))) 1936 (concat "*Machine Code " (gdb-get-target-string) "*")))
1927 1937
1928 (defun gdb-display-assembler-buffer () 1938 (defun gdb-display-assembler-buffer ()
1939 "Display disassembly view."
1929 (interactive) 1940 (interactive)
1930 (gdb-display-buffer 1941 (gdb-display-buffer
1931 (gdb-get-create-buffer 'gdb-assembler-buffer))) 1942 (gdb-get-create-buffer 'gdb-assembler-buffer)))
1932 1943
1933 (defun gdb-frame-assembler-buffer () 1944 (defun gdb-frame-assembler-buffer ()
1945 "Display disassembly view in a new frame."
1934 (interactive) 1946 (interactive)
1935 (select-frame (make-frame gdb-frame-parameters)) 1947 (select-frame (make-frame gdb-frame-parameters))
1936 (switch-to-buffer (gdb-get-create-buffer 'gdb-assembler-buffer)) 1948 (switch-to-buffer (gdb-get-create-buffer 'gdb-assembler-buffer))
1937 (set-window-dedicated-p (selected-window) t)) 1949 (set-window-dedicated-p (selected-window) t))
1938 1950