Mercurial > emacs
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 |