Mercurial > octave

annotate etc/gdbinit @ 30920:47cbc69e66cd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
eliminate direct access to call stack from evaluator The call stack is an internal implementation detail of the evaluator. Direct access to it outside of the evlauator should not be needed. * pt-eval.h (tree_evaluator::get_call_stack): Delete.
author John W. Eaton <jwe@octave.org>
date Fri, 08 Apr 2022 15:19:22 -0400
parents 796f54d4ddbf
children 597f3ee61a48
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
1 ########################################################################
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
2 ##
30564
796f54d4ddbf update Octave Project Developers copyright for the new year
John W. Eaton <jwe@octave.org>
parents: 30030
diff changeset
3 ## Copyright (C) 2010-2022 The Octave Project Developers
27918
b442ec6dda5c use centralized file for copyright info for individual contributors
John W. Eaton <jwe@octave.org>
parents: 26376
diff changeset
4 ##
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
5 ## See the file COPYRIGHT.md in the top-level directory of this
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
6 ## distribution or <https://octave.org/copyright/>.
24537
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
7 ##
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
8 ## This file is part of Octave.
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
9 ##
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
10 ## Octave is free software: you can redistribute it and/or modify it
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
11 ## under the terms of the GNU General Public License as published by
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
12 ## the Free Software Foundation, either version 3 of the License, or
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
13 ## (at your option) any later version.
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
14 ##
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
15 ## Octave is distributed in the hope that it will be useful, but
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
16 ## WITHOUT ANY WARRANTY; without even the implied warranty of
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
17 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
18 ## GNU General Public License for more details.
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
19 ##
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
20 ## You should have received a copy of the GNU General Public License
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
21 ## along with Octave; see the file COPYING. If not, see
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
22 ## <https://www.gnu.org/licenses/>.
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
23 ##
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
24 ########################################################################
24537
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
25
11729ca6eb81 Add GPL license header to more Octave source files.
Rik <rik@octave.org>
parents: 23083
diff changeset
26 ############################################################
16602
2c11d7c6cc21 turn off gdb thread messages by default
John W. Eaton <jwe@octave.org>
parents: 13690
diff changeset
27 ## Disable the next line if you really need to see the
2c11d7c6cc21 turn off gdb thread messages by default
John W. Eaton <jwe@octave.org>
parents: 13690
diff changeset
28 ## thread create/exit messages.
2c11d7c6cc21 turn off gdb thread messages by default
John W. Eaton <jwe@octave.org>
parents: 13690
diff changeset
29
2c11d7c6cc21 turn off gdb thread messages by default
John W. Eaton <jwe@octave.org>
parents: 13690
diff changeset
30 set print thread-events off
2c11d7c6cc21 turn off gdb thread messages by default
John W. Eaton <jwe@octave.org>
parents: 13690
diff changeset
31
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
32 ## Helpful macros for debugging Octave.
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
33
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
34 ## Programming Note: Don't strip the trailing space from the lines that
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
35 ## end with '\ '. GDB strips spaces from the ends of the lines, so
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
36 ## these are required to preserve the whitespace.
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
37
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
38 ############################################################
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
39 ## Display a dim-vector object.
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
40
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
41 define display-dims
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
42 echo ndims: \
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
43 output $arg0.m_num_dims
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
44 echo \ndims: \
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
45 output *$arg0.m_dims@$arg0.m_num_dims
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
46 echo \n
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
47 dont-repeat
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
48 end
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
49
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
50 document display-dims
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
51 Usage: display-dims DIM_VECTOR
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
52 Display the contents of an Octave dimension vector.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
53 end
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
54
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
55 ############################################################
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
56 ## Display a dense array object.
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
57
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
58 define display-dense-array
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
59 echo array object: \
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
60 output $arg0
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
61 echo \ndimensions:\n
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
62 display-dims $arg0.m_dimensions
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
63 echo \nrep = \
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
64 output *$arg0.m_rep
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
65 echo \nrep.data = \
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
66 output *$arg0.m_rep.m_data@$arg0.m_rep.m_len
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
67 echo \nrep.slice_data = \
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
68 output *$arg0.m_slice_data@$arg0.m_slice_len
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
69 echo \n
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
70 dont-repeat
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
71 end
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
72
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
73 document display-dense-array
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
74 Usage: display-dense-array ARRAY
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
75 Display the contents of an ordinary, i.e., dense Octave array.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
76
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
77 See also [display-sparse-array] for showing the contents
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
78 of sparse Octave arrays.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
79 end
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
80
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
81 ############################################################
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
82 ## Display a sparse array object.
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
83
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
84 define display-sparse-array
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
85 echo sparse object: \
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
86 output $arg0
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
87 echo \ndimensions:\n
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
88 display-dims $arg0.m_dimensions
24845
578ebece3dc7 * etc/gdbinit: Fix syntax. (bug #53241)
John W. Eaton <jwe@octave.org>
parents: 24537
diff changeset
89 echo \nrep = \
30030
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
90 output *$arg0.m_rep
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
91 echo \nrep.data = \
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
92 output *$arg0.m_rep.m_data@$arg0.m_rep.m_nzmax
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
93 echo \nrep.ridx = \
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
94 output *$arg0.m_rep.m_ridx@$arg0.m_rep.m_nzmax
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
95 echo \nrep.cidx = \
06f4e4d986a1 * gdbinit: Update for new array data member names.
John W. Eaton <jwe@octave.org>
parents: 29358
diff changeset
96 output *$arg0.m_rep.m_cidx@($arg0.m_rep.m_ncols+1)
10360
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
97 echo \n
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
98 dont-repeat
9126d71f53aa add gdbinit file to sources
John W. Eaton <jwe@octave.org>
parents:
diff changeset
99 end
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
100
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
101 document display-sparse-array
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
102 Usage: display-sparse-array SPARSE_ARRAY
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
103 Display the contents of a sparse Octave array.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
104
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
105 See also [display-dense-array] for showing the contents
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
106 of ordinary Octave arrays.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
107 end
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
108
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
109 ############################################################
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
110
19593
446c46af4b42 strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents: 16602
diff changeset
111 ## Display Octave debugging stack
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
112
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
113 define show-octave-dbstack
13690
f0daeb0eab45 gdbinit: Fix declaration of new show-octave-dbstack macro
Rik <octave@nomad.inbox5.com>
parents: 13328
diff changeset
114 call show_octave_dbstack ()
13328
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
115 end
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
116
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
117 document show-octave-dbstack
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
118 Usage: show-octave-dbstack
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
119 Display the contents of the current Octave debugging stack.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
120
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
121 This is the function stack that the Octave interpreter is processing
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
122 and will be different from the C++ stack being debugged with gdb.
a2144dbc2f3a gdbinit: Add documentation for macros. Add alias for new show_octave_dbstack command.
Rik <octave@nomad.inbox5.com>
parents: 12733
diff changeset
123 end